cc-agentic-framework 1.14.1

package/dist/lib/affected-modules.js

@@ -0,0 +1,283 @@
+/**
+ * Affected Modules Detection
+ *
+ * Detects which modules have been modified by analyzing git diff against
+ * a base branch (default: main). Used for:
+ * - Selective version bumping
+ * - Running affected tests only
+ *
+ * @module lib/affected-modules
+ */
+import { execSync } from 'child_process';
+/**
+ * Mapping of file path patterns to module IDs
+ *
+ * Order matters - more specific patterns should come first
+ */
+const FILE_TO_MODULE_MAPPING = [
+    // Module content files (most specific)
+    { pattern: /^framework\/modules\/backlog\//, moduleId: 'backlog' },
+    { pattern: /^framework\/modules\/jira\//, moduleId: 'jira' },
+    { pattern: /^framework\/modules\/confluence\//, moduleId: 'confluence' },
+    { pattern: /^framework\/modules\/coding\//, moduleId: 'coding' },
+    { pattern: /^framework\/modules\/reporting\//, moduleId: 'reporting' },
+    { pattern: /^framework\/modules\/writer\//, moduleId: 'writer' },
+    { pattern: /^framework\/modules\/planning\//, moduleId: 'planning' },
+    { pattern: /^framework\/modules\/core\//, moduleId: 'core' },
+    // CLI command implementations (map to their modules)
+    { pattern: /^framework\/cli\/src\/commands\/backlog\//, moduleId: 'backlog' },
+    { pattern: /^framework\/cli\/src\/commands\/writer\//, moduleId: 'writer' },
+    { pattern: /^framework\/cli\/src\/commands\/planning\//, moduleId: 'planning' },
+    { pattern: /^framework\/cli\/src\/commands\/confluence\//, moduleId: 'confluence' },
+    // CLI library implementations (map to their modules)
+    { pattern: /^framework\/cli\/src\/lib\/backlog\//, moduleId: 'backlog' },
+    { pattern: /^framework\/cli\/src\/lib\/jira\//, moduleId: 'jira' },
+    { pattern: /^framework\/cli\/src\/lib\/confluence\//, moduleId: 'confluence' },
+    { pattern: /^framework\/cli\/src\/lib\/planning\//, moduleId: 'planning' },
+    // Generic CLI files belong to core
+    { pattern: /^framework\/cli\//, moduleId: 'core' },
+    // AI directory files (skills, agents, context)
+    { pattern: /^ai\/skills\/.*backlog/, moduleId: 'backlog' },
+    { pattern: /^ai\/skills\/.*jira/, moduleId: 'jira' },
+    { pattern: /^ai\/skills\/.*confluence/, moduleId: 'confluence' },
+    { pattern: /^ai\/skills\/.*writer/, moduleId: 'writer' },
+    { pattern: /^ai\/agents\/.*backlog/, moduleId: 'backlog' },
+    { pattern: /^ai\/agents\/.*jira/, moduleId: 'jira' },
+    { pattern: /^ai\/agents\/.*confluence/, moduleId: 'confluence' },
+    { pattern: /^ai\/agents\/.*writer/, moduleId: 'writer' },
+    { pattern: /^ai\//, moduleId: 'core' },
+    // Deployed files
+    { pattern: /^\.claude\//, moduleId: 'core' },
+];
+/**
+ * Module to test pattern mapping
+ *
+ * Maps module IDs to Jest test path patterns (regex-compatible)
+ * These patterns are used with Jest's --testPathPatterns option
+ */
+export const MODULE_TEST_PATTERNS = {
+    backlog: [
+        'backlog', // Matches any test file with 'backlog' in path
+    ],
+    jira: [
+        'jira', // Matches any test file with 'jira' in path
+    ],
+    confluence: [
+        'confluence', // Matches any test file with 'confluence' in path
+    ],
+    writer: [
+        'writer', // Matches any test file with 'writer' in path
+    ],
+    planning: [
+        'planning', // Matches any test file with 'planning' in path
+    ],
+    coding: [
+    // Coding module has no specific tests yet
+    ],
+    reporting: [
+    // Reporting module has no specific tests yet
+    ],
+    core: [
+        // Core module tests - match directories that are framework infrastructure
+        'lib/__tests__',
+        'commands/__tests__',
+        'mcp/__tests__',
+        'schemas/__tests__',
+        'telemetry/__tests__',
+        'validation/__tests__',
+        'sdk/__tests__',
+        'build/__tests__',
+        'common/__tests__',
+        'unified-template-engine/__tests__',
+        'e2e/cli-commands',
+        'e2e/context-level-variants',
+        'e2e/init-wizard',
+    ],
+};
+/**
+ * Get changed files from git diff
+ *
+ * @param baseBranch - Base branch to compare against
+ * @param projectRoot - Project root path
+ * @param stagedOnly - Only include staged changes
+ * @returns Array of changed file paths (relative to project root)
+ */
+export function getChangedFiles(baseBranch = 'main', projectRoot = process.cwd(), stagedOnly = false) {
+    try {
+        let command;
+        if (stagedOnly) {
+            // Get only staged changes
+            command = 'git diff --cached --name-only';
+        }
+        else {
+            // Get all changes compared to base branch
+            // First, get the merge base to find common ancestor
+            const mergeBase = execSync(`git merge-base ${baseBranch} HEAD`, {
+                cwd: projectRoot,
+                encoding: 'utf-8',
+                timeout: 10000,
+            }).trim();
+            // Then get diff from merge base to HEAD plus any uncommitted changes
+            command = `git diff --name-only ${mergeBase} HEAD && git diff --name-only`;
+        }
+        const output = execSync(command, {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 10000,
+        }).trim();
+        if (!output) {
+            return [];
+        }
+        // Deduplicate and filter empty lines
+        const files = [...new Set(output.split('\n').filter(Boolean))];
+        return files;
+    }
+    catch (error) {
+        // If git command fails (not in repo, branch doesn't exist, etc.)
+        // Return empty array rather than throwing
+        if (error instanceof Error) {
+            const message = error.message.toLowerCase();
+            // Only warn if it's not a common "no changes" scenario
+            if (!message.includes('not a git repository') && !message.includes('unknown revision')) {
+                console.warn(`Warning: Could not get changed files: ${error.message}`);
+            }
+        }
+        return [];
+    }
+}
+/**
+ * Map a file path to its module ID
+ *
+ * @param filePath - Relative file path
+ * @returns Module ID or null if no match
+ */
+export function mapFileToModule(filePath) {
+    // Normalize path separators
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    for (const { pattern, moduleId } of FILE_TO_MODULE_MAPPING) {
+        if (pattern.test(normalizedPath)) {
+            return moduleId;
+        }
+    }
+    return null;
+}
+/**
+ * Detect affected modules from changed files
+ *
+ * @param options - Detection options
+ * @returns Result containing affected modules and metadata
+ */
+export function detectAffectedModules(options = {}) {
+    const { baseBranch = 'main', projectRoot = process.cwd(), stagedOnly = false, } = options;
+    const changedFiles = getChangedFiles(baseBranch, projectRoot, stagedOnly);
+    if (changedFiles.length === 0) {
+        return {
+            modules: [],
+            changedFiles: [],
+            baseBranch,
+            hasChanges: false,
+        };
+    }
+    // Group files by module
+    const moduleFilesMap = new Map();
+    for (const file of changedFiles) {
+        const moduleId = mapFileToModule(file);
+        if (moduleId) {
+            const existing = moduleFilesMap.get(moduleId) || [];
+            existing.push(file);
+            moduleFilesMap.set(moduleId, existing);
+        }
+    }
+    // Convert to array of AffectedModule
+    const modules = Array.from(moduleFilesMap.entries())
+        .map(([id, changedFiles]) => ({ id, changedFiles }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+    return {
+        modules,
+        changedFiles,
+        baseBranch,
+        hasChanges: true,
+    };
+}
+/**
+ * Get test patterns for affected modules
+ *
+ * @param moduleIds - Array of module IDs
+ * @returns Array of Jest test patterns
+ */
+export function getTestPatternsForModules(moduleIds) {
+    const patterns = [];
+    for (const moduleId of moduleIds) {
+        const modulePatterns = MODULE_TEST_PATTERNS[moduleId];
+        if (modulePatterns) {
+            patterns.push(...modulePatterns);
+        }
+    }
+    // Deduplicate patterns
+    return [...new Set(patterns)];
+}
+/**
+ * Build Jest command for running affected tests
+ *
+ * @param moduleIds - Array of affected module IDs
+ * @param additionalArgs - Additional Jest arguments
+ * @returns Jest command string or null if no tests to run
+ */
+export function buildJestCommand(moduleIds, additionalArgs = []) {
+    const patterns = getTestPatternsForModules(moduleIds);
+    if (patterns.length === 0) {
+        return null;
+    }
+    // Deduplicate and join with |
+    const uniquePatterns = [...new Set(patterns)];
+    const testPathPattern = uniquePatterns.join('|');
+    const args = [
+        'jest',
+        `--testPathPatterns="${testPathPattern}"`,
+        '--passWithNoTests',
+        ...additionalArgs,
+    ];
+    return `npx ${args.join(' ')}`;
+}
+/**
+ * Check if we're in a git repository
+ *
+ * @param projectRoot - Project root path
+ * @returns true if in a git repository
+ */
+export function isGitRepository(projectRoot = process.cwd()) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a branch exists
+ *
+ * @param branchName - Branch name to check
+ * @param projectRoot - Project root path
+ * @returns true if branch exists
+ */
+export function branchExists(branchName, projectRoot = process.cwd()) {
+    try {
+        execSync(`git rev-parse --verify ${branchName}`, {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=affected-modules.js.map

package/dist/lib/affected-modules.js.map

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

package/dist/lib/agent-generator.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Agent Generator Module
+ *
+ * Generates Claude Code custom agent JSON definitions from slim agent markdown files.
+ * These JSON files enable slim agents to be invoked as true subagents via the Task tool
+ * with their own subagent_type.
+ *
+ * Usage:
+ *     const generator = new AgentGenerator(projectRoot);
+ *     const results = await generator.generateAll();
+ *
+ * The generated JSON files are written to module source directories (framework/modules/{module}/agents/)
+ * alongside the markdown files. They are then deployed to .claude/agents/ by the sync command.
+ */
+/**
+ * Agent definition from agents.json registry
+ */
+export interface AgentDefinition {
+    id: string;
+    module: string;
+    file: string;
+    "essential-skills"?: string[];
+    "capability-needs"?: string[];
+    "available-skills"?: string[];
+    "context-category-needs"?: {
+        business?: "basic" | "advanced" | "expert";
+        technical?: "basic" | "advanced" | "expert";
+        process?: "basic" | "advanced" | "expert";
+    };
+    "context-files"?: string[];
+    "token-budget"?: number;
+    variant?: "full" | "slim";
+    "parent-agent"?: string;
+    "delegates-to"?: string[];
+    "deploy-to"?: "command" | "agent" | "both";
+}
+/**
+ * Claude Code custom agent JSON definition
+ */
+export interface CustomAgentDefinition {
+    $schema?: string;
+    name: string;
+    description: string;
+    model: "opus" | "sonnet" | "haiku";
+    instructions: string;
+    tools: string[];
+    skills?: string[];
+    context?: {
+        business?: "basic" | "advanced" | "expert";
+        technical?: "basic" | "advanced" | "expert";
+        process?: "basic" | "advanced" | "expert";
+    };
+    sourceAgent: string;
+    generated: string;
+}
+/**
+ * Result of generating a single agent
+ */
+export interface GenerationItem {
+    agentId: string;
+    sourcePath: string;
+    outputPath: string;
+    action: "created" | "updated" | "skipped" | "failed";
+    error?: string;
+}
+/**
+ * Generates Claude Code custom agent JSON definitions from slim agent markdown files.
+ *
+ * The generator:
+ * 1. Reads agents.json to find all slim agents
+ * 2. Parses each slim agent's markdown file
+ * 3. Extracts description, instructions, and metadata
+ * 4. Generates JSON matching custom-agent.schema.json
+ * 5. Writes JSON files alongside markdown sources
+ */
+export declare class AgentGenerator {
+    /** Default tools for slim agents */
+    private static readonly DEFAULT_TOOLS;
+    private readonly projectRoot;
+    /**
+     * Initialize the AgentGenerator.
+     *
+     * @param projectRoot - Absolute path to the project root directory
+     */
+    constructor(projectRoot: string);
+    /**
+     * Generate custom agent JSON files for all slim agents.
+     *
+     * @param options - Generation options
+     * @returns List of generation results
+     */
+    generateAll(options?: {
+        dryRun?: boolean;
+        force?: boolean;
+        agentId?: string;
+    }): Promise<GenerationItem[]>;
+    /**
+     * Generate custom agent JSON for a single slim agent.
+     *
+     * @param agent - Agent definition from registry
+     * @param options - Generation options
+     * @returns Generation result
+     */
+    private generateAgent;
+    /**
+     * Resolve the actual source path for an agent.
+     *
+     * The registry stores paths relative to project root, but we need the actual
+     * source file in framework/modules/{module}/agents/.
+     */
+    private resolveAgentSourcePath;
+    /**
+     * Parse markdown file with YAML frontmatter.
+     */
+    private parseMarkdown;
+    /**
+     * Build custom agent JSON definition from parsed markdown.
+     */
+    private buildCustomAgent;
+    /**
+     * Extract description from markdown body.
+     */
+    private extractDescription;
+    /**
+     * Generate condensed instructions for the custom agent.
+     */
+    private generateInstructions;
+    /**
+     * Extract a section from markdown body by heading.
+     */
+    private extractSection;
+    /**
+     * Condense a section by removing excessive whitespace and limiting length.
+     */
+    private condenseSection;
+}
+//# sourceMappingURL=agent-generator.d.ts.map

package/dist/lib/agent-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-generator.d.ts","sourceRoot":"","sources":["../../src/lib/agent-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,wBAAwB,CAAC,EAAE;QACzB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QAC3C,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QAC5C,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;KAC3C,CAAC;IACF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QAC3C,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QAC5C,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;KAC3C,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAuBD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,oCAAoC;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAUnC;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;OAIG;gBACS,WAAW,EAAE,MAAM;IAI/B;;;;;OAKG;IACG,WAAW,CACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO,CAAC,cAAc,EAAE,CAAC;IAgC5B;;;;;;OAMG;YACW,aAAa;IAoD3B;;;;;OAKG;YACW,sBAAsB;IAyBpC;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiE5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,eAAe;CAQxB"}