cc-agentic-framework 1.14.1

package/dist/commands/writer/create-character.js

@@ -0,0 +1,263 @@
+/**
+ * Writer Create Character Command
+ *
+ * CLI command for creating character profiles.
+ *
+ * Usage:
+ *   agentic-framework writer create-character --name elara --display-name "Elara Moonwhisper" --type main
+ *   agentic-framework writer create-character --name theron --role antagonist --dry-run
+ *
+ * @module commands/writer/create-character
+ */
+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 create-character command.
+ *
+ * @returns Commander command instance
+ */
+export function createCreateCharacterCommand() {
+    const command = new Command('create-character');
+    command
+        .description('Create a new character profile')
+        .option('-n, --name <name>', 'Character ID in kebab-case (e.g., "elara-moonwhisper")')
+        .option('-d, --display-name <displayName>', 'Character display name (defaults to name)')
+        .option('-t, --type <type>', 'Character type: main, supporting, minor', 'supporting')
+        .option('-r, --role <role>', 'Character role (e.g., "ally", "antagonist", "mentor")', 'ally')
+        .option('--dry-run', 'Preview what would be created without creating files', false)
+        .option('-p, --path <path>', 'Project root path', '.')
+        .action(async (cmdOptions) => {
+        try {
+            await runCreateCharacterCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Render template with variable substitution.
+ *
+ * @param content - Template content
+ * @param vars - Template variables
+ * @returns Rendered content
+ */
+function renderTemplate(content, vars) {
+    let result = content;
+    for (const [key, value] of Object.entries(vars)) {
+        const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+        result = result.replace(regex, value);
+    }
+    return result;
+}
+/**
+ * Run the create-character command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runCreateCharacterCommand(cmdOptions) {
+    const startTime = Date.now();
+    const { name, displayName, type = 'supporting', role = 'ally', dryRun, path: pathOption, } = cmdOptions;
+    // Validate required options
+    if (!name) {
+        throw new Error('Character name is required. Use --name <name> to specify it.');
+    }
+    // Validate name format
+    const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+    if (!namePattern.test(name)) {
+        throw new Error('Character name must be kebab-case: lowercase letters, numbers, and hyphens only');
+    }
+    if (name.length < 2 || name.length > 30) {
+        throw new Error('Character name must be 2-30 characters long');
+    }
+    // Validate type
+    const validTypes = ['main', 'supporting', 'minor'];
+    if (!validTypes.includes(type)) {
+        throw new Error(`Character type must be one of: ${validTypes.join(', ')}`);
+    }
+    // Use CliContext
+    const ctx = pathOption && pathOption !== '.'
+        ? await CliContext.create({ path: pathOption })
+        : await CliContext.require();
+    const projectRoot = ctx.projectRoot;
+    const charactersDir = path.join(projectRoot, 'characters');
+    // Ensure characters directory exists
+    if (!(await fs.pathExists(charactersDir))) {
+        throw new Error('Characters directory not found. Run "agentic-framework writer init" first.');
+    }
+    const characterFolder = path.join(charactersDir, name);
+    // Check if character exists
+    if (await fs.pathExists(characterFolder)) {
+        throw new Error(`Character already exists: ${characterFolder}`);
+    }
+    const characterDisplayName = displayName || name;
+    const currentDate = new Date().toISOString().split('T')[0];
+    // Load template
+    const templatePath = path.join(ctx.projectRoot, 'framework/modules/writer/skills/writer/writer-book-organization/templates/character.template.md');
+    let templateContent;
+    if (await fs.pathExists(templatePath)) {
+        templateContent = await fs.readFile(templatePath, 'utf-8');
+    }
+    else {
+        // Fallback inline template
+        templateContent = `---
+id: {{name}}
+name: "{{displayName}}"
+type: {{type}}
+role: {{role}}
+created: {{date}}
+status: active
+
+# Physical
+age:
+appearance: |
+  [Describe the character's physical appearance. Include:
+  - Build and height
+  - Hair and eye color
+  - Distinctive features
+  - Typical clothing or style
+  - Mannerisms or physical habits]
+
+# Personality
+traits:
+  - [Positive trait 1]
+  - [Negative trait 1]
+  - [Neutral trait 1]
+  - [Add 2-4 more traits]
+
+motivations:
+  - [Primary motivation - what drives this character?]
+  - [Secondary motivation]
+
+fears:
+  - [Primary fear - what does this character fear most?]
+  - [Secondary fear]
+
+# Voice
+speech-patterns:
+  internal: "[How does this character think?]"
+  dialogue: "[How does this character speak?]"
+
+voice-example: |
+  "[Provide an example of this character's dialogue that captures their voice.]"
+
+# Arc
+starting-state: |
+  [Describe this character's state at the beginning of the book.]
+
+character-arc: |
+  [Describe this character's intended development throughout the book.]
+---
+
+# {{displayName}}
+
+## Summary
+
+[Provide a 2-3 sentence summary of who this character is and their role in
+the story.]
+
+## Background
+
+[Provide the character's backstory and history. Include:
+- Where they came from
+- Significant past events that shaped them
+- Family and upbringing
+- How they arrived at their current situation
+- Relevant secrets or hidden information]
+
+## Relationships
+
+[Describe this character's key relationships with other characters.]
+
+**[Other Character Name]:**
+- Relationship type: [ally, enemy, mentor, student, rival, etc.]
+- Dynamic: [How do they interact? What's the emotional tone?]
+- History: [How did they meet? What's their shared past?]
+- Arc: [How will this relationship evolve?]
+
+## Skills and Abilities
+
+[What can this character do? Include:
+- Combat or physical skills
+- Magical or supernatural abilities
+- Knowledge and expertise
+- Social or interpersonal skills
+- Unique talents or gifts]
+
+## Weaknesses and Flaws
+
+[What are this character's limitations? Include:
+- Physical weaknesses
+- Emotional vulnerabilities
+- Knowledge gaps
+- Personality flaws
+- Fatal flaw (for main characters)]
+
+## Role in Story
+
+[Explain this character's narrative function. Include:
+- Plot role (how do they advance the story?)
+- Thematic role (what theme do they represent or explore?)
+- Relationship to protagonist
+- Key scenes or moments featuring this character]
+
+## Notes
+
+[Any additional notes for writing this character.]
+`;
+    }
+    // Render template
+    const vars = {
+        name: name,
+        displayName: characterDisplayName,
+        type: type,
+        role: role,
+        date: currentDate,
+    };
+    const characterContent = renderTemplate(templateContent, vars);
+    // Dry run
+    if (dryRun) {
+        console.log('\nDRY RUN - No files created\n');
+        console.log('Character Details:');
+        console.log(`  ID:           ${name}`);
+        console.log(`  Display Name: ${characterDisplayName}`);
+        console.log(`  Type:         ${type}`);
+        console.log(`  Role:         ${role}`);
+        console.log(`  Folder:       ${characterFolder}\n`);
+        console.log('Would create:');
+        console.log(`  ✓ ${characterFolder}/`);
+        console.log(`  ✓ ${characterFolder}/profile.md (${characterContent.length} bytes)\n`);
+        console.log('Next steps:');
+        console.log('  1. Remove --dry-run flag to create character');
+        console.log('  2. Edit profile.md to fill in character details');
+        console.log('  3. Reference character in scenes and chapters');
+        return;
+    }
+    // Create character folder and file
+    await fs.ensureDir(characterFolder);
+    const profileFile = path.join(characterFolder, 'profile.md');
+    await fs.writeFile(profileFile, characterContent, 'utf-8');
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('writer', 'create-character', { name, displayName: characterDisplayName, type, role, dryRun }, { character_id: name, path: characterFolder }, durationMs, true).catch(() => { });
+    // Output success
+    console.log('\nCharacter created successfully!\n');
+    console.log(`Character ID:   ${name}`);
+    console.log(`Display Name:   ${characterDisplayName}`);
+    console.log(`Type:           ${type}`);
+    console.log(`Role:           ${role}\n`);
+    console.log('Created:');
+    console.log(`  📁 ${characterFolder}`);
+    console.log(`  📄 ${profileFile}\n`);
+    console.log('Next steps:');
+    console.log('  1. Edit profile.md to fill in character background, appearance, and personality');
+    console.log('  2. Define character voice and speech patterns');
+    console.log('  3. Reference this character in scene POV and characters-present metadata\n');
+}
+//# sourceMappingURL=create-character.js.map

package/dist/commands/writer/create-character.js.map

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

package/dist/commands/writer/create-part.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Writer Create Part Command
+ *
+ * CLI command for creating new parts (story arcs) with auto-numbering.
+ *
+ * Usage:
+ *   agentic-framework writer create-part --name rising-action --title "Rising Action"
+ *   agentic-framework writer create-part --name climax --dry-run
+ *
+ * @module commands/writer/create-part
+ */
+import { Command } from 'commander';
+/**
+ * Create the create-part command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createCreatePartCommand(): Command;
+//# sourceMappingURL=create-part.d.ts.map

package/dist/commands/writer/create-part.d.ts.map

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

package/dist/commands/writer/create-part.js

@@ -0,0 +1,239 @@
+/**
+ * Writer Create Part Command
+ *
+ * CLI command for creating new parts (story arcs) with auto-numbering.
+ *
+ * Usage:
+ *   agentic-framework writer create-part --name rising-action --title "Rising Action"
+ *   agentic-framework writer create-part --name climax --dry-run
+ *
+ * @module commands/writer/create-part
+ */
+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 create-part command.
+ *
+ * @returns Commander command instance
+ */
+export function createCreatePartCommand() {
+    const command = new Command('create-part');
+    command
+        .description('Create a new part (story arc) with auto-numbering')
+        .option('-n, --name <name>', 'Part name in kebab-case (e.g., "rising-action")')
+        .option('-t, --title <title>', 'Part title (defaults to name)')
+        .option('--dry-run', 'Preview what would be created without creating files', false)
+        .option('-p, --path <path>', 'Project root path', '.')
+        .action(async (cmdOptions) => {
+        try {
+            await runCreatePartCommand(cmdOptions);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`\nError: ${errorMessage}\n`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/**
+ * Get next part number by scanning manuscript directory.
+ *
+ * @param manuscriptDir - Path to manuscript directory
+ * @returns Next available part number
+ */
+async function getNextPartNumber(manuscriptDir) {
+    if (!(await fs.pathExists(manuscriptDir))) {
+        return 1;
+    }
+    let maxNumber = 0;
+    const partPattern = /^part-(\d{3})-/;
+    const items = await fs.readdir(manuscriptDir);
+    for (const item of items) {
+        const itemPath = path.join(manuscriptDir, item);
+        const stat = await fs.stat(itemPath);
+        if (stat.isDirectory()) {
+            const match = partPattern.exec(item);
+            if (match) {
+                const number = parseInt(match[1], 10);
+                maxNumber = Math.max(maxNumber, number);
+            }
+        }
+    }
+    return maxNumber + 1;
+}
+/**
+ * Render template with variable substitution.
+ *
+ * @param content - Template content
+ * @param vars - Template variables
+ * @returns Rendered content
+ */
+function renderTemplate(content, vars) {
+    let result = content;
+    for (const [key, value] of Object.entries(vars)) {
+        const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+        result = result.replace(regex, value);
+    }
+    return result;
+}
+/**
+ * Run the create-part command.
+ *
+ * @param cmdOptions - Command options
+ */
+async function runCreatePartCommand(cmdOptions) {
+    const startTime = Date.now();
+    const { name, title, dryRun, path: pathOption, } = cmdOptions;
+    // Validate required options
+    if (!name) {
+        throw new Error('Part name is required. Use --name <name> to specify it.');
+    }
+    // Validate name format
+    const namePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+    if (!namePattern.test(name)) {
+        throw new Error('Part name must be kebab-case: lowercase letters, numbers, and hyphens only');
+    }
+    if (name.length < 3 || name.length > 40) {
+        throw new Error('Part name must be 3-40 characters long');
+    }
+    // Use CliContext
+    const ctx = pathOption && pathOption !== '.'
+        ? await CliContext.create({ path: pathOption })
+        : await CliContext.require();
+    const projectRoot = ctx.projectRoot;
+    const manuscriptDir = path.join(projectRoot, 'manuscript');
+    // Ensure manuscript directory exists
+    if (!(await fs.pathExists(manuscriptDir))) {
+        throw new Error('Manuscript directory not found. Run "agentic-framework writer init" first.');
+    }
+    // Get next part number
+    const partNumber = await getNextPartNumber(manuscriptDir);
+    const partNumberStr = partNumber.toString().padStart(3, '0');
+    const folderName = `part-${partNumberStr}-${name}`;
+    const partFolder = path.join(manuscriptDir, folderName);
+    // Check if folder exists
+    if (await fs.pathExists(partFolder)) {
+        throw new Error(`Part folder already exists: ${partFolder}`);
+    }
+    const partTitle = title || name;
+    const currentDate = new Date().toISOString().split('T')[0];
+    // Load template
+    const templatePath = path.join(ctx.projectRoot, 'framework/modules/writer/skills/writer/writer-book-organization/templates/part.template.md');
+    let templateContent;
+    if (await fs.pathExists(templatePath)) {
+        templateContent = await fs.readFile(templatePath, 'utf-8');
+    }
+    else {
+        // Fallback to inline template if file not found
+        templateContent = `---
+part-number: {{number}}
+title: "{{title}}"
+status: draft
+word-count: 0
+created: {{date}}
+summary: |
+  [Describe the main narrative arc of this part.]
+bullet-points:
+  - [First key event]
+  - [Second key event]
+  - [Third key event]
+prerequisites:
+  requires-parts: []
+  world-state:
+    time-elapsed: ""
+    location-shift: ""
+    political-state: ""
+establishes:
+  - [What plot point does this part establish?]
+  - [What character development occurs?]
+---
+
+# Part {{number}}: {{title}}
+
+## Arc Overview
+
+[Provide a detailed overview of this story arc. Explain the main narrative thread,
+the protagonist's journey during this part, and how it fits into the overall book
+structure. This should be 2-4 paragraphs.]
+
+## Chapters in This Part
+
+[This section will list chapters as they are created.]
+
+## Thematic Elements
+
+[What are the key themes explored in this part?]
+
+**Key Themes:**
+- [Theme 1]: [Brief explanation]
+- [Theme 2]: [Brief explanation]
+
+## Narrative Goals
+
+[What should be accomplished by the end of this part?]
+
+**Plot Goals:**
+- [Goal 1]
+- [Goal 2]
+
+**Character Goals:**
+- [What development should the protagonist achieve?]
+- [What relationships should evolve?]
+
+**World Goals:**
+- [What about the world should be revealed or changed?]
+
+## Notes
+
+[Any additional notes for writing this part.]
+`;
+    }
+    // Render template
+    const vars = {
+        number: partNumberStr,
+        title: partTitle,
+        name: name,
+        date: currentDate,
+    };
+    const partContent = renderTemplate(templateContent, vars);
+    // Dry run
+    if (dryRun) {
+        console.log('\nDRY RUN - No files created\n');
+        console.log('Part Details:');
+        console.log(`  Number: ${partNumberStr}`);
+        console.log(`  Name:   ${name}`);
+        console.log(`  Title:  ${partTitle}`);
+        console.log(`  Folder: ${partFolder}\n`);
+        console.log('Would create:');
+        console.log(`  ✓ ${partFolder}/`);
+        console.log(`  ✓ ${partFolder}/PART.md (${partContent.length} bytes)\n`);
+        console.log('Next steps:');
+        console.log('  1. Remove --dry-run flag to create part');
+        console.log('  2. Edit PART.md to define the story arc');
+        console.log('  3. Create chapters with: agentic-framework writer create-chapter');
+        return;
+    }
+    // Create part folder and file
+    await fs.ensureDir(partFolder);
+    const partFile = path.join(partFolder, 'PART.md');
+    await fs.writeFile(partFile, partContent, 'utf-8');
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('writer', 'create-part', { name, title: partTitle, dryRun }, { part_number: partNumberStr, path: partFolder }, durationMs, true).catch(() => { });
+    // Output success
+    console.log('\nPart created successfully!\n');
+    console.log(`Part Number: ${partNumberStr}`);
+    console.log(`Part Name:   ${name}`);
+    console.log(`Part Title:  ${partTitle}\n`);
+    console.log('Created:');
+    console.log(`  📁 ${partFolder}`);
+    console.log(`  📄 ${partFile}\n`);
+    console.log('Next steps:');
+    console.log('  1. Edit PART.md to define the story arc and narrative goals');
+    console.log(`  2. Create first chapter: agentic-framework writer create-chapter --part ${partNumberStr} --name opening\n`);
+}
+//# sourceMappingURL=create-part.js.map

package/dist/commands/writer/create-part.js.map

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

package/dist/commands/writer/create-scene.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Writer Create Scene Command
+ *
+ * CLI command for creating scenes within chapters.
+ *
+ * Usage:
+ *   agentic-framework writer create-scene --chapter 1.1 --name arrival --scene-type action
+ *   agentic-framework writer create-scene --chapter 1.2 --name conversation --dry-run
+ *
+ * @module commands/writer/create-scene
+ */
+import { Command } from 'commander';
+/**
+ * Create the create-scene command.
+ *
+ * @returns Commander command instance
+ */
+export declare function createCreateSceneCommand(): Command;
+//# sourceMappingURL=create-scene.d.ts.map

package/dist/commands/writer/create-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scene.d.ts","sourceRoot":"","sources":["../../../src/commands/writer/create-scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAuBlD"}