cc-agentic-framework 1.14.1

package/dist/lib/jira/wiki-converter.js

@@ -0,0 +1,245 @@
+/**
+ * WikiConverter - Converts Markdown to Jira Wiki Markup
+ *
+ * Migrated from: modules/jira/src/jira/export_to_jira.py (MarkdownToJiraConverter)
+ *
+ * Conversion Rules:
+ * - Headers: # → h1., ## → h2., ### → h3.
+ * - Bold: **text** → *text*
+ * - Italic: _text_ → _text_ (preserved)
+ * - Inline code: `code` → {{code}}
+ * - Code blocks: ```lang → {code:lang}, ``` → {code}
+ * - Links: [text](url) → [text|url]
+ * - Lists: - item → * item, 1. item → # item
+ *
+ * Optional cleanup (matching Python implementation):
+ * - Remove title (first h1 heading)
+ * - Remove horizontal rules (---)
+ * - Remove metadata lines
+ * - Convert bold labels to h3 headings
+ */
+export class WikiConverter {
+    /**
+     * Convert markdown to Jira wiki markup
+     *
+     * @param markdown - Markdown text to convert
+     * @param options - Optional cleanup and conversion options
+     * @returns Jira wiki markup text
+     */
+    convert(markdown, options = {}) {
+        if (!markdown) {
+            return '';
+        }
+        let jira = markdown;
+        // Apply optional cleanup operations (in order from Python implementation)
+        if (options.removeTitle) {
+            jira = this.removeTitle(jira);
+        }
+        if (options.removeHorizontalRules) {
+            jira = this.removeHorizontalRules(jira);
+        }
+        if (options.removeMetadataLine) {
+            jira = this.removeMetadataLine(jira);
+        }
+        if (options.removeDescriptionHeading) {
+            jira = this.removeDescriptionHeading(jira);
+        }
+        if (options.removeAcceptanceCriteria) {
+            jira = this.removeAcceptanceCriteria(jira);
+        }
+        // Only trim if we did cleanup operations (preserve formatting for basic conversions)
+        const didCleanup = options.removeTitle || options.removeHorizontalRules ||
+            options.removeMetadataLine || options.removeDescriptionHeading ||
+            options.removeAcceptanceCriteria;
+        if (didCleanup) {
+            jira = jira.trim();
+        }
+        // Convert bold labels to h3 headings (must be done before header conversion)
+        if (options.convertBoldLabelsToHeadings) {
+            jira = this.convertBoldLabelsToHeadings(jira);
+        }
+        // Apply core markdown to wiki conversions
+        // Order matters: code blocks first to protect their content, then inline code
+        jira = this.convertCodeBlocks(jira);
+        jira = this.convertHeaders(jira);
+        jira = this.convertBold(jira);
+        jira = this.convertLinks(jira);
+        jira = this.convertInlineCode(jira);
+        jira = this.convertLists(jira);
+        // Trim only newlines, preserve leading/trailing spaces on single lines
+        return jira.replace(/^\n+|\n+$/g, '');
+    }
+    /**
+     * Remove title (first h1 heading)
+     */
+    removeTitle(text) {
+        // Remove first h1 heading line
+        return text.replace(/^# .+$\n*/m, '');
+    }
+    /**
+     * Remove horizontal rules (---)
+     */
+    removeHorizontalRules(text) {
+        return text.replace(/^---+$\n*/gm, '');
+    }
+    /**
+     * Remove metadata line (Type: Task | Status: Ready For Review | Priority: P1 | Effort: 5 points)
+     */
+    removeMetadataLine(text) {
+        return text.replace(/^\*\*Type:\*\*.*?(?=\n|$)/gm, '');
+    }
+    /**
+     * Remove "Description" heading (Jira provides this section already)
+     */
+    removeDescriptionHeading(text) {
+        return text.replace(/^## Description\s*$\n*/gim, '');
+    }
+    /**
+     * Remove Acceptance Criteria section (from ## Acceptance Criteria to end or next ##)
+     */
+    removeAcceptanceCriteria(text) {
+        return text.replace(/## Acceptance Criteria.*?(?=\n##|\n*$)/gs, '');
+    }
+    /**
+     * Convert section headers formatted as bold to h3 headings
+     *
+     * Examples:
+     * - **Context:** → h3. Context
+     * - **Requirements:** → h3. Requirements
+     * - **Technical Notes:** → h3. Technical Notes
+     */
+    convertBoldLabelsToHeadings(text) {
+        return text.replace(/^\*\*([^*:]+):\*\*\s*$/gm, 'h3. $1');
+    }
+    /**
+     * Convert markdown headers to Jira wiki headers
+     *
+     * - # Header → h1. Header
+     * - ## Header → h2. Header
+     * - ### Header → h3. Header
+     */
+    convertHeaders(text) {
+        let result = text;
+        // Convert headers (order matters: ### before ## before #)
+        result = result.replace(/^### (.+)$/gm, 'h3. $1');
+        result = result.replace(/^## (.+)$/gm, 'h2. $1');
+        result = result.replace(/^# (.+)$/gm, 'h1. $1');
+        return result;
+    }
+    /**
+     * Convert bold formatting from markdown to Jira wiki
+     *
+     * - **text** → *text*
+     * - ***text*** → *text* (multiple asterisks normalized)
+     *
+     * Note: Jira uses single asterisk for bold, not double
+     */
+    convertBold(text) {
+        // Handle multiple asterisks (***text*** → *text*)
+        let result = text.replace(/\*\*\*([^*]+)\*\*\*/g, '*$1*');
+        // Convert double asterisks to single (Jira bold format)
+        result = result.replace(/\*\*([^*]+)\*\*/g, '*$1*');
+        return result;
+    }
+    /**
+     * Convert links from markdown to Jira wiki format
+     *
+     * - [text](url) → [text|url]
+     *
+     * Note: Uses non-greedy matching to handle nested brackets
+     */
+    convertLinks(text) {
+        // Match [text](url) where text can contain brackets
+        // Use a more sophisticated approach to handle nested brackets
+        return text.replace(/\[(.+?)\]\(([^)]+)\)/g, '[$1|$2]');
+    }
+    /**
+     * Convert fenced code blocks to Jira wiki format
+     *
+     * - ```language → {code:language}
+     * - ``` → {code}
+     * - Closing ``` → {code}
+     */
+    convertCodeBlocks(text) {
+        let result = text;
+        // Convert opening fence with language hint
+        result = result.replace(/```(\w+)\n/g, '{code:$1}\n');
+        // Convert opening fence without language
+        result = result.replace(/```\n/g, '{code}\n');
+        // Convert closing fence
+        result = result.replace(/```/g, '{code}');
+        return result;
+    }
+    /**
+     * Convert inline code from markdown to Jira wiki format
+     *
+     * - `code` → {{code}}
+     *
+     * Note: Code blocks are converted first, so backticks inside {code}...{code}
+     * blocks are protected from conversion
+     */
+    convertInlineCode(text) {
+        // Split by code blocks to avoid converting backticks inside them
+        const codeBlockPattern = /\{code[^}]*\}[\s\S]*?\{code\}/g;
+        const parts = [];
+        let lastIndex = 0;
+        let match;
+        // Find all code blocks
+        while ((match = codeBlockPattern.exec(text)) !== null) {
+            // Add text before code block
+            if (match.index > lastIndex) {
+                parts.push({ text: text.substring(lastIndex, match.index), isCodeBlock: false });
+            }
+            // Add code block (preserve as-is)
+            parts.push({ text: match[0], isCodeBlock: true });
+            lastIndex = match.index + match[0].length;
+        }
+        // Add remaining text
+        if (lastIndex < text.length) {
+            parts.push({ text: text.substring(lastIndex), isCodeBlock: false });
+        }
+        // If no code blocks found, process entire text
+        if (parts.length === 0) {
+            return text.replace(/`([^`]+)`/g, '{{$1}}');
+        }
+        // Convert inline code only in non-code-block parts
+        return parts
+            .map(part => {
+            if (part.isCodeBlock) {
+                return part.text; // Preserve code blocks
+            }
+            return part.text.replace(/`([^`]+)`/g, '{{$1}}');
+        })
+            .join('');
+    }
+    /**
+     * Convert lists from markdown to Jira wiki format
+     *
+     * - Unordered: - item → * item
+     * - Ordered: 1. item → # item
+     *
+     * Preserves indentation for nested lists
+     */
+    convertLists(text) {
+        let result = text;
+        // Convert unordered lists (- to *)
+        // Preserve leading whitespace for nested lists
+        result = result.replace(/^(\s*)- /gm, '$1* ');
+        // Convert ordered lists (1. to #, 2. to #, etc.)
+        // Preserve leading whitespace for nested lists
+        result = result.replace(/^(\s*)\d+\. /gm, '$1# ');
+        return result;
+    }
+}
+/**
+ * Convenience function to convert markdown to Jira wiki markup
+ *
+ * @param markdown - Markdown text to convert
+ * @param options - Optional conversion options
+ * @returns Jira wiki markup text
+ */
+export function convertMarkdownToJiraWiki(markdown, options) {
+    const converter = new WikiConverter();
+    return converter.convert(markdown, options);
+}
+//# sourceMappingURL=wiki-converter.js.map

package/dist/lib/jira/wiki-converter.js.map

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

package/dist/lib/link-transformer.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Link Transformer Module
+ *
+ * Transforms relative markdown links to absolute paths when syncing agents/skills
+ * to deployment folders. This ensures links remain valid regardless of where the
+ * deployed files are accessed from.
+ *
+ * Usage:
+ *     const transformer = new LinkTransformer("/path/to/framework");
+ *     const transformedContent = await transformer.transformFile(sourcePath, targetPath);
+ *
+ * Link Type Handling:
+ *     - {project} placeholders
+ *       → Replace with actual project root path
+ *     - Framework files (.claude/registries/*.json, .claude/context/*.md, etc.)
+ *       → Transform to absolute path using framework root
+ *     - Internal files (./EXAMPLES.md, ./STANDARDS.md)
+ *       → Preserve as-is (same directory)
+ *     - External URLs (http://, https://)
+ *       → Preserve as-is
+ *     - Anchor-only links (#section)
+ *       → Preserve as-is
+ *     - Images (.png, .jpg, .gif, .svg, .webp)
+ *       → Preserve as-is
+ *     - Combined links (file.md#section)
+ *       → Transform path, preserve anchor, rejoin
+ */
+/**
+ * Transforms markdown links from relative to absolute paths.
+ *
+ * This class handles the transformation of relative markdown links to absolute
+ * paths based on a framework root directory. It intelligently preserves certain
+ * link types (internal files, URLs, anchors, images) while transforming
+ * framework file references.
+ */
+export declare class LinkTransformer {
+    /** Placeholder for project root in source files - replaced during sync */
+    private static readonly PROJECT_PLACEHOLDER;
+    /** Framework file patterns that should be transformed to absolute paths */
+    private static readonly FRAMEWORK_FILE_PATTERNS;
+    /** Image file extensions to preserve as-is */
+    private static readonly IMAGE_EXTENSIONS;
+    /** Markdown link pattern: [text](path) or [text](path#anchor) */
+    private static readonly LINK_PATTERN;
+    private readonly frameworkRoot;
+    private readonly projectRoot;
+    /**
+     * Initialize the LinkTransformer.
+     *
+     * @param frameworkRoot - Absolute path to the framework source directory (where modules are)
+     * @param projectRoot - Absolute path to the project root (where deployed files go).
+     *                      If not provided, defaults to frameworkRoot for backward compatibility.
+     * @throws {Error} If framework_root is empty, doesn't exist, or is not a directory
+     */
+    constructor(frameworkRoot: string, projectRoot?: string);
+    /**
+     * Transform all links in a markdown file.
+     *
+     * Reads the source file, transforms all markdown links according to the
+     * transformation rules, and returns the transformed content.
+     *
+     * @param sourcePath - Path to the source markdown file
+     * @param targetPath - Path where the file will be deployed (used for context)
+     * @returns Transformed markdown content with absolute links where appropriate
+     * @throws {Error} If source_path does not exist or is not a file
+     */
+    transformFile(sourcePath: string, _targetPath: string): Promise<string>;
+    /**
+     * Transform content string directly (useful for testing).
+     *
+     * @param content - Markdown content to transform
+     * @param sourcePath - Path to the source file (for resolving relative links)
+     * @returns Transformed markdown content
+     */
+    transformContent(content: string, sourcePath: string): string;
+    /**
+     * Replace {project} placeholders with actual project root path.
+     *
+     * This allows source files to use portable placeholders like:
+     *   [agents.json]({project}/.claude/registries/agents.json)
+     *
+     * Which get transformed to actual paths during sync:
+     *   [agents.json](/path/to/project/.claude/registries/agents.json)
+     *
+     * @param content - Content with potential {project} placeholders
+     * @returns Content with placeholders replaced by actual project root
+     */
+    private replaceProjectPlaceholders;
+    /**
+     * Transform a single link path.
+     *
+     * Determines the link type and applies the appropriate transformation:
+     * - External URLs: preserved as-is
+     * - Anchor-only: preserved as-is
+     * - Images: preserved as-is
+     * - Internal files (./...): preserved as-is
+     * - Placeholder paths (url, path, file, etc.): preserved as-is
+     * - Framework files: transformed to absolute paths
+     *
+     * @param linkPath - The link path to transform
+     * @param sourceFile - The source file containing the link
+     * @returns Transformed link path
+     */
+    private transformLink;
+    /**
+     * Check if a resolved path is a framework file that should be transformed.
+     *
+     * Framework files include:
+     * - .claude/registries/*.json
+     * - .claude/context/**\/*.md
+     * - .claude/framework/**\/*.md
+     * - .claude/commands/**\/*.md
+     * - .claude/skills/**\/*.md
+     * - .claude/plans/**\/*.md
+     * - README.md, CLAUDE.md, routes.yml
+     * - backlog/**\/*.md
+     * - confluence/**\/*.md
+     *
+     * @param resolvedPath - Absolute path to check
+     * @returns True if this is a framework file, False otherwise
+     */
+    private isFrameworkFile;
+    /**
+     * Check if a link is an internal file (starts with ./).
+     *
+     * Internal files are in the same directory as the source file and should
+     * be preserved as-is.
+     *
+     * @param linkPath - Link path to check
+     * @returns True if this is an internal file link, False otherwise
+     */
+    private isInternalFile;
+    /**
+     * Check if a link is a placeholder path used in documentation examples.
+     *
+     * Placeholder paths are generic examples like 'url', 'path', 'file', etc.
+     * that appear in markdown syntax examples and should be preserved as-is.
+     *
+     * @param linkPath - Link path to check
+     * @returns True if this is a placeholder path, False otherwise
+     */
+    private isPlaceholderPath;
+    /**
+     * Check if a link is an external URL.
+     *
+     * External URLs start with http:// or https:// and should be preserved as-is.
+     *
+     * @param linkPath - Link path to check
+     * @returns True if this is an external URL, False otherwise
+     */
+    private isExternalUrl;
+    /**
+     * Check if a link is an image file.
+     *
+     * Image files have extensions like .png, .jpg, .gif, etc. and should be
+     * preserved as-is.
+     *
+     * @param linkPath - Link path to check
+     * @returns True if this is an image link, False otherwise
+     */
+    private isImageLink;
+    /**
+     * Resolve a relative path to an absolute path.
+     *
+     * Handles relative paths like:
+     * - ../registry.yml
+     * - ../context/business-advanced.md
+     * - ../../README.md
+     *
+     * @param linkPath - Relative link path
+     * @param fromDir - Directory containing the source file
+     * @returns Resolved absolute path
+     */
+    private resolveRelativePath;
+}
+//# sourceMappingURL=link-transformer.d.ts.map

package/dist/lib/link-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-transformer.d.ts","sourceRoot":"","sources":["../../src/lib/link-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAe;IAE1D,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAY7C;IAEF,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAOrC;IAEH,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAElE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;;;OAOG;gBACS,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAkBvD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB7E;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAqB7D;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,0BAA0B;IAQlC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,aAAa;IAqFrB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,eAAe;IA2BvB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;CAS5B"}