cc-agentic-framework 1.14.1

package/dist/mcp/tools/jira.js

@@ -0,0 +1,206 @@
+/**
+ * Jira MCP Tools
+ *
+ * MCP tool wrappers for Jira CLI commands.
+ * Provides ticket export and bidirectional sync capabilities.
+ *
+ * @module mcp/tools/jira
+ */
+import { z } from 'zod';
+import { defineTool } from '../tool-registry.js';
+import { successResult, errorResult, ErrorCodes } from '../types.js';
+import { createExportCommand } from '../../commands/jira/export.js';
+import { createSyncCommand } from '../../commands/jira/sync.js';
+import { captureOutput } from '../result-formatter.js';
+/**
+ * Execute a Commander command with arguments
+ */
+async function executeCommanderCommand(command, args) {
+    await command.parseAsync(args, { from: 'user' });
+}
+// ============================================================================
+// Tool 1: Export to Jira
+// ============================================================================
+const ExportSchema = z.object({
+    file: z
+        .string()
+        .optional()
+        .describe('Path to ticket file (omit for batch export)'),
+    dryRun: z
+        .boolean()
+        .default(false)
+        .describe('Validate without creating/updating tickets'),
+    batch: z
+        .boolean()
+        .default(false)
+        .describe('Batch mode: process multiple tickets'),
+    delay: z
+        .number()
+        .default(2000)
+        .describe('Delay between tickets in batch mode (milliseconds)'),
+    forceCreate: z
+        .boolean()
+        .default(false)
+        .describe('Force CREATE mode (override auto-detection)'),
+    forceUpdate: z
+        .boolean()
+        .default(false)
+        .describe('Force UPDATE mode (override auto-detection)'),
+    path: z
+        .string()
+        .default('./backlog')
+        .describe('Base path to backlog directory'),
+    env: z
+        .string()
+        .default('.env')
+        .describe('Path to .env file with Jira credentials'),
+    verbose: z
+        .boolean()
+        .default(false)
+        .describe('Show detailed progress and logging'),
+});
+export const jiraExportTool = defineTool('agentic_jira_export', 'Export tickets to Jira (CREATE or UPDATE mode)', ExportSchema, async (args) => {
+    try {
+        // Validate conflicting flags
+        if (args.forceCreate && args.forceUpdate) {
+            return errorResult(ErrorCodes.INVALID_ARGUMENTS, 'Cannot use both forceCreate and forceUpdate simultaneously', 'Choose one mode or let the tool auto-detect');
+        }
+        const command = createExportCommand();
+        const commandArgs = [];
+        if (args.file) {
+            commandArgs.push(args.file);
+        }
+        if (args.dryRun) {
+            commandArgs.push('--dry-run');
+        }
+        if (args.batch) {
+            commandArgs.push('--batch');
+        }
+        if (args.delay !== 2000) {
+            commandArgs.push('--delay', args.delay.toString());
+        }
+        if (args.forceCreate) {
+            commandArgs.push('--force-create');
+        }
+        if (args.forceUpdate) {
+            commandArgs.push('--force-update');
+        }
+        if (args.path && args.path !== './backlog') {
+            commandArgs.push('--path', args.path);
+        }
+        if (args.env && args.env !== '.env') {
+            commandArgs.push('--env', args.env);
+        }
+        if (args.verbose) {
+            commandArgs.push('--verbose');
+        }
+        const { output } = await captureOutput(() => executeCommanderCommand(command, commandArgs), { stripColors: true });
+        if (output.exitCode !== undefined && output.exitCode !== 0) {
+            return errorResult(ErrorCodes.COMMAND_FAILED, 'Failed to export tickets to Jira', 'Check the output for export errors. Ensure Jira credentials are set in .env file', { output: output.output });
+        }
+        return successResult({
+            file: args.file,
+            batch: args.batch,
+            forceCreate: args.forceCreate,
+            forceUpdate: args.forceUpdate,
+            dryRun: args.dryRun,
+        }, args.dryRun
+            ? 'Export validation successful'
+            : 'Tickets exported to Jira successfully', output.output);
+    }
+    catch (error) {
+        return errorResult(ErrorCodes.COMMAND_FAILED, error instanceof Error ? error.message : String(error), 'Ensure JIRA_BASE_URL, JIRA_EMAIL, and JIRA_API_TOKEN are set in .env file');
+    }
+});
+// ============================================================================
+// Tool 2: Bidirectional Sync
+// ============================================================================
+const SyncSchema = z.object({
+    fromFile: z
+        .string()
+        .optional()
+        .describe('Sync local file to Jira (CREATE or UPDATE)'),
+    fromJira: z
+        .string()
+        .optional()
+        .describe('Sync Jira ticket to local file (DOWNLOAD)'),
+    dryRun: z
+        .boolean()
+        .default(false)
+        .describe('Preview changes without syncing'),
+    force: z
+        .boolean()
+        .default(false)
+        .describe('Force sync without conflict check'),
+    output: z
+        .string()
+        .optional()
+        .describe('Output path for fromJira mode'),
+    env: z
+        .string()
+        .default('.env')
+        .describe('Path to .env file with Jira credentials'),
+    verbose: z
+        .boolean()
+        .default(false)
+        .describe('Show detailed progress and logging'),
+});
+export const jiraSyncTool = defineTool('agentic_jira_sync', 'Bidirectional sync between local tickets and Jira', SyncSchema, async (args) => {
+    try {
+        // Validate mutually exclusive options
+        if (args.fromFile && args.fromJira) {
+            return errorResult(ErrorCodes.INVALID_ARGUMENTS, 'Cannot use both fromFile and fromJira simultaneously', 'Choose one sync direction');
+        }
+        if (!args.fromFile && !args.fromJira) {
+            return errorResult(ErrorCodes.INVALID_ARGUMENTS, 'Must specify either fromFile or fromJira', 'Provide one sync direction');
+        }
+        if (args.fromJira && !args.output) {
+            return errorResult(ErrorCodes.INVALID_ARGUMENTS, 'fromJira requires output path to specify destination file', 'Provide output parameter with destination file path');
+        }
+        const command = createSyncCommand();
+        const commandArgs = [];
+        if (args.fromFile) {
+            commandArgs.push('--from-file', args.fromFile);
+        }
+        if (args.fromJira) {
+            commandArgs.push('--from-jira', args.fromJira);
+        }
+        if (args.output) {
+            commandArgs.push('--output', args.output);
+        }
+        if (args.dryRun) {
+            commandArgs.push('--dry-run');
+        }
+        if (args.force) {
+            commandArgs.push('--force');
+        }
+        if (args.env && args.env !== '.env') {
+            commandArgs.push('--env', args.env);
+        }
+        if (args.verbose) {
+            commandArgs.push('--verbose');
+        }
+        const { output } = await captureOutput(() => executeCommanderCommand(command, commandArgs), { stripColors: true });
+        if (output.exitCode !== undefined && output.exitCode !== 0) {
+            return errorResult(ErrorCodes.COMMAND_FAILED, 'Sync failed', 'Check the output for sync errors or conflicts. Use force option to override conflict detection', { output: output.output });
+        }
+        const direction = args.fromFile ? 'Local → Jira' : 'Jira → Local';
+        return successResult({
+            direction,
+            source: args.fromFile || args.fromJira,
+            destination: args.output,
+            dryRun: args.dryRun,
+            force: args.force,
+        }, args.dryRun
+            ? `Sync preview successful (${direction})`
+            : `Sync successful (${direction})`, output.output);
+    }
+    catch (error) {
+        return errorResult(ErrorCodes.COMMAND_FAILED, error instanceof Error ? error.message : String(error), 'Ensure JIRA_BASE_URL, JIRA_EMAIL, and JIRA_API_TOKEN are set in .env file');
+    }
+});
+// ============================================================================
+// Export all Jira tools
+// ============================================================================
+export const jiraTools = [jiraExportTool, jiraSyncTool];
+//# sourceMappingURL=jira.js.map

package/dist/mcp/tools/jira.js.map

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

package/dist/mcp/tools/planning.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Planning MCP Tools
+ *
+ * MCP tools for plan management:
+ * - Create plan folders with auto-numbering
+ * - Validate plan structure and content
+ *
+ * @module mcp/tools/planning
+ */
+/**
+ * agentic_planning_create tool
+ */
+export declare const planningCreateTool: import("../types.js").MCPTool;
+/**
+ * agentic_planning_validate tool
+ */
+export declare const planningValidateTool: import("../types.js").MCPTool;
+/**
+ * Export all planning tools
+ */
+export declare const planningTools: import("../types.js").MCPTool[];
+//# sourceMappingURL=planning.d.ts.map

package/dist/mcp/tools/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/planning.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH;;GAEG;AACH,eAAO,MAAM,kBAAkB,+BA4C9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,+BA+GhC,CAAC;AA6IF;;GAEG;AACH,eAAO,MAAM,aAAa,iCAGzB,CAAC"}

package/dist/mcp/tools/planning.js

@@ -0,0 +1,264 @@
+/**
+ * Planning MCP Tools
+ *
+ * MCP tools for plan management:
+ * - Create plan folders with auto-numbering
+ * - Validate plan structure and content
+ *
+ * @module mcp/tools/planning
+ */
+import { z } from 'zod';
+import { defineTool } from '../tool-registry.js';
+import { successResult, errorResult, ErrorCodes } from '../types.js';
+import { createPlan } from '../../lib/planning/plan-creator.js';
+import { CliContext } from '../../lib/cli-context.js';
+import fs from 'fs-extra';
+import path from 'path';
+import fg from 'fast-glob';
+import matter from 'gray-matter';
+import { validateWithSchema } from '../../lib/validation/schema-validator.js';
+import { formatReport, mergeReports, } from '../../lib/validation/validation-report.js';
+import { validatePlanRules, validatePlanContent, } from '../../lib/validation/rules/plan-rules.js';
+/**
+ * Schema for planning create-plan tool
+ */
+const CreatePlanSchema = z.object({
+    name: z.string().describe('Plan name in kebab-case (e.g., "my-plan-name")'),
+    category: z.string().default('framework').describe('Plan category (e.g., "framework", "apm-r")'),
+    dryRun: z.boolean().optional().describe('Preview what would be created without creating files'),
+    path: z.string().default('.').describe('Project root path'),
+});
+/**
+ * Schema for planning validate-plan tool
+ */
+const ValidatePlanSchema = z.object({
+    path: z.string().default('.').describe('Path to plan file or folder (searches for PLAN.md files)'),
+    strict: z.boolean().optional().describe('Exit with error code on warnings (not just errors)'),
+});
+/**
+ * agentic_planning_create tool
+ */
+export const planningCreateTool = defineTool('agentic_planning_create', 'Create a new plan folder with auto-numbering and templates', CreatePlanSchema, async (args) => {
+    try {
+        const { name, category, dryRun, path: pathOption } = args;
+        // Use CliContext for project detection and path resolution
+        const ctx = pathOption && pathOption !== '.'
+            ? await CliContext.create({ path: pathOption })
+            : await CliContext.require();
+        // Get plans directory from path resolver
+        const plansDir = ctx.paths.getPlanPath(category);
+        // Create the plan using project root from context
+        const result = await createPlan(name, category, ctx.projectRoot, dryRun || false, plansDir);
+        if (!result.success) {
+            return errorResult(ErrorCodes.COMMAND_FAILED, result.message);
+        }
+        return successResult({
+            planId: result.planId,
+            planPath: result.planPath,
+            category,
+            dryRun: dryRun || false,
+        }, result.message);
+    }
+    catch (error) {
+        return errorResult(ErrorCodes.COMMAND_FAILED, error instanceof Error ? error.message : 'Unknown error', undefined, error);
+    }
+});
+/**
+ * agentic_planning_validate tool
+ */
+export const planningValidateTool = defineTool('agentic_planning_validate', 'Validate plan structure and content against schema and best practices', ValidatePlanSchema, async (args) => {
+    try {
+        const { path: searchPath, strict } = args;
+        // Use CliContext to get project root for schema resolution
+        let projectRoot;
+        try {
+            const ctx = await CliContext.create();
+            projectRoot = ctx.projectRoot;
+        }
+        catch {
+            projectRoot = process.cwd();
+        }
+        // Resolve search path
+        const resolvedPath = path.resolve(searchPath);
+        // Check if path exists
+        if (!(await fs.pathExists(resolvedPath))) {
+            return errorResult(ErrorCodes.FILE_NOT_FOUND, `Path does not exist: ${resolvedPath}`);
+        }
+        // Find PLAN.md files
+        const planFiles = await findPlanFiles(resolvedPath);
+        if (planFiles.length === 0) {
+            return successResult({ plansValidated: 0 }, 'No PLAN.md files found', 'No PLAN.md files found in the specified path');
+        }
+        // Get schema path
+        const schemaPath = await getSchemaPath(projectRoot);
+        if (!schemaPath) {
+            return errorResult(ErrorCodes.FILE_NOT_FOUND, 'Plan schema not found', 'Expected at framework/modules/planning/schemas/plan.schema.json');
+        }
+        // Validate each plan file
+        const allReports = [];
+        for (const planFile of planFiles) {
+            const report = await validatePlanFile(planFile, schemaPath);
+            allReports.push(report);
+        }
+        // Merge all reports
+        const finalReport = mergeReports(...allReports);
+        // Determine validation result
+        const hasErrors = finalReport.summary.errors > 0;
+        const hasWarnings = finalReport.summary.warnings > 0;
+        const isValid = finalReport.valid && finalReport.issues.length === 0;
+        if (isValid) {
+            return successResult({
+                valid: true,
+                plansValidated: planFiles.length,
+                errors: 0,
+                warnings: 0,
+            }, 'All plans passed validation with no issues', formatReport(finalReport));
+        }
+        if (hasErrors || (strict && hasWarnings)) {
+            return errorResult(ErrorCodes.VALIDATION_FAILED, hasErrors ? 'Validation failed with errors' : 'Validation failed with warnings (strict mode)', undefined, {
+                plansValidated: planFiles.length,
+                errors: finalReport.summary.errors,
+                warnings: finalReport.summary.warnings,
+                report: formatReport(finalReport),
+            });
+        }
+        return successResult({
+            valid: true,
+            plansValidated: planFiles.length,
+            errors: finalReport.summary.errors,
+            warnings: finalReport.summary.warnings,
+        }, 'Validation passed with warnings', formatReport(finalReport));
+    }
+    catch (error) {
+        return errorResult(ErrorCodes.COMMAND_FAILED, error instanceof Error ? error.message : 'Unknown error', undefined, error);
+    }
+});
+/**
+ * Find all PLAN.md files in the given path
+ */
+async function findPlanFiles(searchPath) {
+    const stat = await fs.stat(searchPath);
+    if (stat.isFile()) {
+        // If it's a file, check if it's PLAN.md
+        if (path.basename(searchPath) === 'PLAN.md') {
+            return [searchPath];
+        }
+        throw new Error(`Specified file is not PLAN.md: ${searchPath}`);
+    }
+    // If it's a directory, search for all PLAN.md files
+    const planFiles = await fg('**/PLAN.md', {
+        cwd: searchPath,
+        absolute: true,
+        ignore: ['**/node_modules/**', '**/.git/**', '**/dist/**'],
+    });
+    return planFiles;
+}
+/**
+ * Get path to plan schema file
+ */
+async function getSchemaPath(projectRoot) {
+    const possiblePaths = [
+        path.join(projectRoot, 'framework/modules/planning/schemas/plan.schema.json'),
+        path.join(projectRoot, '../modules/planning/schemas/plan.schema.json'),
+        path.join(projectRoot, '../../modules/planning/schemas/plan.schema.json'),
+    ];
+    for (const schemaPath of possiblePaths) {
+        if (await fs.pathExists(schemaPath)) {
+            return schemaPath;
+        }
+    }
+    return null;
+}
+/**
+ * Normalize frontmatter data by converting Date objects to ISO date strings
+ */
+function normalizeFrontmatter(data) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (value instanceof Date) {
+            result[key] = value.toISOString().split('T')[0];
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map((item) => item && typeof item === 'object' && !(item instanceof Date)
+                ? normalizeFrontmatter(item)
+                : item instanceof Date
+                    ? item.toISOString().split('T')[0]
+                    : item);
+        }
+        else if (value && typeof value === 'object') {
+            result[key] = normalizeFrontmatter(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Validate a single plan file
+ */
+async function validatePlanFile(planFile, schemaPath) {
+    try {
+        // Read and parse the plan file
+        const fileContent = await fs.readFile(planFile, 'utf-8');
+        const parsed = matter(fileContent);
+        // Normalize frontmatter: convert Date objects to ISO date strings
+        const frontmatter = normalizeFrontmatter(parsed.data);
+        const content = parsed.content;
+        // Validate frontmatter against schema
+        const schemaReport = await validateWithSchema(frontmatter, schemaPath);
+        // Fix schema report locations: replace schema path with the actual plan file path
+        schemaReport.issues = schemaReport.issues.map((issue) => ({
+            ...issue,
+            location: { file: planFile, ...(issue.location?.line ? { line: issue.location.line } : {}) },
+        }));
+        // Apply custom validation rules to frontmatter
+        const rulesIssues = validatePlanRules(frontmatter, planFile);
+        const rulesReport = {
+            valid: rulesIssues.filter((i) => i.severity === 'error').length === 0,
+            issues: rulesIssues,
+            summary: {
+                errors: rulesIssues.filter((i) => i.severity === 'error').length,
+                warnings: rulesIssues.filter((i) => i.severity === 'warning').length,
+                info: rulesIssues.filter((i) => i.severity === 'info').length,
+            },
+        };
+        // Validate markdown content
+        const contentIssues = validatePlanContent(content, planFile);
+        const contentReport = {
+            valid: contentIssues.filter((i) => i.severity === 'error').length === 0,
+            issues: contentIssues,
+            summary: {
+                errors: contentIssues.filter((i) => i.severity === 'error').length,
+                warnings: contentIssues.filter((i) => i.severity === 'warning').length,
+                info: contentIssues.filter((i) => i.severity === 'info').length,
+            },
+        };
+        // Merge all reports
+        return mergeReports(schemaReport, rulesReport, contentReport);
+    }
+    catch (error) {
+        // Return error report if file can't be read/parsed
+        return {
+            valid: false,
+            issues: [
+                {
+                    severity: 'error',
+                    code: 'FILE_READ_ERROR',
+                    message: `Failed to read or parse plan file: ${error instanceof Error ? error.message : String(error)}`,
+                    location: { file: planFile },
+                    suggestion: 'Ensure the file exists and contains valid YAML frontmatter',
+                },
+            ],
+            summary: { errors: 1, warnings: 0, info: 0 },
+        };
+    }
+}
+/**
+ * Export all planning tools
+ */
+export const planningTools = [
+    planningCreateTool,
+    planningValidateTool,
+];
+//# sourceMappingURL=planning.js.map

package/dist/mcp/tools/planning.js.map

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

package/dist/mcp/tools/skill.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Skill MCP Tools
+ *
+ * MCP tools for managing skills: deploy, list, remove, info, pull.
+ *
+ * @module mcp/tools/skill
+ */
+/**
+ * Tool: agentic_skill_deploy
+ *
+ * Deploy skill to global ~/.claude/skills/
+ */
+export declare const skillDeployTool: import("../types.js").MCPTool;
+/**
+ * Tool: agentic_skill_list
+ *
+ * List skills (project or global)
+ */
+export declare const skillListTool: import("../types.js").MCPTool;
+/**
+ * Tool: agentic_skill_remove
+ *
+ * Remove skill from global ~/.claude/skills/
+ */
+export declare const skillRemoveTool: import("../types.js").MCPTool;
+/**
+ * Tool: agentic_skill_info
+ *
+ * Show skill details
+ */
+export declare const skillInfoTool: import("../types.js").MCPTool;
+/**
+ * Tool: agentic_skill_pull
+ *
+ * Pull skill from global ~/.claude/skills/ into project
+ */
+export declare const skillPullTool: import("../types.js").MCPTool;
+/**
+ * Export all skill tools
+ */
+export declare const skillTools: import("../types.js").MCPTool[];
+//# sourceMappingURL=skill.d.ts.map

package/dist/mcp/tools/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/skill.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+LH;;;;GAIG;AACH,eAAO,MAAM,eAAe,+BA0K3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,+BA+HzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,+BAoD3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,+BA6HzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,+BAwGzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,iCAMtB,CAAC"}