cc-agentic-framework 1.14.1

package/dist/lib/unified-template-engine/validator.js

@@ -0,0 +1,217 @@
+/**
+ * Template Validator
+ *
+ * Validates template configurations and variables against schemas and rules.
+ */
+import AjvModule from 'ajv';
+// Ajv is exported as both default and named export
+const Ajv = AjvModule.default || AjvModule;
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const currentFilePath = fileURLToPath(import.meta.url);
+const currentDirPath = path.dirname(currentFilePath);
+/**
+ * Load the template schema for validation
+ */
+async function loadTemplateSchema() {
+    // Try multiple possible locations for the schema
+    const possiblePaths = [
+        // Relative to CLI dist
+        path.resolve(currentDirPath, '../../../../framework/modules/core/registries/schemas/template.schema.json'),
+        // Relative to CLI source
+        path.resolve(currentDirPath, '../../../../../modules/core/registries/schemas/template.schema.json'),
+        // In project root
+        path.resolve(process.cwd(), 'framework/modules/core/registries/schemas/template.schema.json'),
+    ];
+    for (const schemaPath of possiblePaths) {
+        if (await fs.pathExists(schemaPath)) {
+            return fs.readJSON(schemaPath);
+        }
+    }
+    throw new Error('Template schema not found');
+}
+/**
+ * Validate a template config against the schema
+ */
+export async function validateConfig(config) {
+    const errors = [];
+    const warnings = [];
+    // Check if it's a legacy config (no version field)
+    if (typeof config === 'object' && config !== null && !('version' in config)) {
+        warnings.push({
+            type: 'legacy_config',
+            message: 'Config is missing version field. Consider updating to v1.0 format.',
+        });
+        // Legacy configs are still valid, just warn
+    }
+    try {
+        const schema = await loadTemplateSchema();
+        const ajv = new Ajv({ allErrors: true, strict: false });
+        const validate = ajv.compile(schema);
+        const valid = validate(config);
+        if (!valid && validate.errors) {
+            for (const error of validate.errors) {
+                errors.push({
+                    type: 'schema_error',
+                    message: `${error.instancePath} ${error.message}`,
+                    expected: error.params ? JSON.stringify(error.params) : undefined,
+                });
+            }
+        }
+    }
+    catch (_schemaError) {
+        // Schema not found - do basic validation
+        if (typeof config !== 'object' || config === null) {
+            errors.push({
+                type: 'schema_error',
+                message: 'Config must be an object',
+            });
+        }
+        else if (!('templates' in config)) {
+            errors.push({
+                type: 'schema_error',
+                message: 'Config must have a templates property',
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate variables against template definition
+ */
+export function validateVariables(definition, variables) {
+    const errors = [];
+    const warnings = [];
+    // Check required variables
+    for (const required of definition.variables.required) {
+        if (!(required in variables) || variables[required] === undefined || variables[required] === '') {
+            errors.push({
+                type: 'missing_required',
+                variable: required,
+                message: `Missing required variable: ${required}`,
+            });
+        }
+    }
+    // Build set of allowed variables
+    const allowedVars = new Set([
+        ...definition.variables.required,
+        ...definition.variables.optional,
+        ...(definition.variables.computed || []),
+    ]);
+    // Check for unknown variables
+    for (const varName of Object.keys(variables)) {
+        if (!allowedVars.has(varName)) {
+            warnings.push({
+                type: 'unknown_variable',
+                variable: varName,
+                message: `Unknown variable provided: ${varName}`,
+            });
+        }
+    }
+    // Validate variable values against rules
+    if (definition.validation) {
+        for (const [varName, rules] of Object.entries(definition.validation)) {
+            const value = variables[varName];
+            if (value !== undefined) {
+                const validationErrors = validateVariableValue(varName, value, rules);
+                errors.push(...validationErrors);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate a single variable value against validation rules
+ */
+function validateVariableValue(varName, value, rules) {
+    const errors = [];
+    // Pattern validation
+    if (rules.pattern) {
+        try {
+            const regex = new RegExp(rules.pattern);
+            if (!regex.test(value)) {
+                errors.push({
+                    type: 'invalid_pattern',
+                    variable: varName,
+                    message: `Variable ${varName} does not match pattern: ${rules.pattern}`,
+                    expected: rules.pattern,
+                    actual: value,
+                });
+            }
+        }
+        catch {
+            // Invalid regex - skip validation
+        }
+    }
+    // Length validation
+    if (rules.minLength !== undefined && value.length < rules.minLength) {
+        errors.push({
+            type: 'invalid_length',
+            variable: varName,
+            message: `Variable ${varName} is too short (min: ${rules.minLength})`,
+            expected: `>= ${rules.minLength} characters`,
+            actual: `${value.length} characters`,
+        });
+    }
+    if (rules.maxLength !== undefined && value.length > rules.maxLength) {
+        errors.push({
+            type: 'invalid_length',
+            variable: varName,
+            message: `Variable ${varName} is too long (max: ${rules.maxLength})`,
+            expected: `<= ${rules.maxLength} characters`,
+            actual: `${value.length} characters`,
+        });
+    }
+    // Enum validation
+    if (rules.enum && !rules.enum.includes(value)) {
+        errors.push({
+            type: 'invalid_enum',
+            variable: varName,
+            message: `Variable ${varName} must be one of: ${rules.enum.join(', ')}`,
+            expected: rules.enum.join(' | '),
+            actual: value,
+        });
+    }
+    return errors;
+}
+/**
+ * Normalize a legacy config to v1.0 format
+ */
+export function normalizeLegacyConfig(legacy) {
+    const templates = {};
+    for (const [name, def] of Object.entries(legacy.templates)) {
+        templates[name] = {
+            output: def.output,
+            variables: {
+                required: def.variables.required,
+                optional: def.variables.optional || [],
+                computed: [],
+            },
+            defaults: def.defaults || {},
+        };
+    }
+    return {
+        version: '1.0',
+        templates,
+        autoNumbering: legacy.autoNumbering,
+    };
+}
+/**
+ * Check if config is legacy format
+ */
+export function isLegacyConfig(config) {
+    return (typeof config === 'object' &&
+        config !== null &&
+        'templates' in config &&
+        !('version' in config));
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/unified-template-engine/validator.js.map

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

package/dist/lib/validation/rules/plan-rules.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Plan Validation Rules
+ *
+ * TypeScript validation rules for plan content beyond JSON Schema validation.
+ * These rules enforce best practices and conventions for plan structure.
+ *
+ * @module lib/validation/rules/plan-rules
+ */
+import { ValidationIssue } from '../validation-report.js';
+/**
+ * Plan data structure
+ */
+export interface PlanData {
+    status?: string;
+    category?: string;
+    created?: string;
+    phases?: Phase[];
+    successCriteria?: string[];
+    riskLevel?: string;
+    estimatedHours?: number;
+    [key: string]: unknown;
+}
+/**
+ * Phase structure
+ */
+export interface Phase {
+    title: string;
+    goal: string;
+    deliverables: string[];
+    successMetrics?: string[];
+}
+/**
+ * Validate plan against custom rules
+ *
+ * @param data - Parsed plan frontmatter data
+ * @param filePath - Path to the PLAN.md file
+ * @returns Array of validation issues
+ */
+export declare function validatePlanRules(data: PlanData, filePath: string): ValidationIssue[];
+/**
+ * Validate plan markdown content (non-frontmatter content)
+ *
+ * @param content - Markdown content (without frontmatter)
+ * @param filePath - Path to the PLAN.md file
+ * @returns Array of validation issues
+ */
+export declare function validatePlanContent(content: string, filePath: string): ValidationIssue[];
+//# sourceMappingURL=plan-rules.d.ts.map

package/dist/lib/validation/rules/plan-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-rules.d.ts","sourceRoot":"","sources":["../../../../src/lib/validation/rules/plan-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EAIhB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAoCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAqKrF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAsExF"}

package/dist/lib/validation/rules/plan-rules.js

@@ -0,0 +1,152 @@
+/**
+ * Plan Validation Rules
+ *
+ * TypeScript validation rules for plan content beyond JSON Schema validation.
+ * These rules enforce best practices and conventions for plan structure.
+ *
+ * @module lib/validation/rules/plan-rules
+ */
+import { createWarning, createError, createInfo, } from '../validation-report.js';
+/**
+ * Action verbs that should start deliverables
+ */
+const ACTION_VERBS = [
+    'create',
+    'implement',
+    'design',
+    'build',
+    'develop',
+    'update',
+    'modify',
+    'refactor',
+    'add',
+    'remove',
+    'delete',
+    'migrate',
+    'fix',
+    'test',
+    'validate',
+    'document',
+    'write',
+    'setup',
+    'configure',
+    'install',
+    'deploy',
+    'integrate',
+    'optimize',
+    'improve',
+    'enhance',
+    'analyze',
+    'review',
+    'verify',
+];
+/**
+ * Validate plan against custom rules
+ *
+ * @param data - Parsed plan frontmatter data
+ * @param filePath - Path to the PLAN.md file
+ * @returns Array of validation issues
+ */
+export function validatePlanRules(data, filePath) {
+    const issues = [];
+    // Rule: Check if phases have success metrics
+    if (data.phases && data.phases.length > 0) {
+        data.phases.forEach((phase, index) => {
+            if (!phase.successMetrics || phase.successMetrics.length === 0) {
+                issues.push(createWarning('MISSING_SUCCESS_METRICS', `Phase ${index + 1} "${phase.title}" lacks success metrics`, `phases[${index}].successMetrics`, { file: filePath }, 'Add success metrics to define how to verify phase completion'));
+            }
+        });
+    }
+    // Rule: Deliverables should start with action verbs
+    if (data.phases && data.phases.length > 0) {
+        data.phases.forEach((phase, index) => {
+            phase.deliverables.forEach((deliverable, delIndex) => {
+                const firstWord = deliverable.trim().toLowerCase().split(/\s+/)[0];
+                if (!ACTION_VERBS.includes(firstWord)) {
+                    issues.push(createWarning('DELIVERABLE_NO_ACTION_VERB', `Deliverable "${deliverable}" should start with an action verb`, `phases[${index}].deliverables[${delIndex}]`, { file: filePath }, `Start with verbs like: ${ACTION_VERBS.slice(0, 10).join(', ')}, etc.`));
+                }
+            });
+        });
+    }
+    // Rule: Plan should have overall success criteria
+    if (!data.successCriteria || data.successCriteria.length === 0) {
+        issues.push(createWarning('MISSING_SUCCESS_CRITERIA', 'Plan lacks overall success criteria', 'successCriteria', { file: filePath }, 'Add success criteria to define when the entire plan is complete'));
+    }
+    // Rule: Plans should have risk level assessment
+    if (!data.riskLevel) {
+        issues.push(createInfo('MISSING_RISK_LEVEL', 'Plan does not specify risk level', 'riskLevel', { file: filePath }, 'Consider adding riskLevel: "low" | "medium" | "high" to frontmatter'));
+    }
+    // Rule: Plans should have time estimate
+    if (!data.estimatedHours) {
+        issues.push(createInfo('MISSING_TIME_ESTIMATE', 'Plan does not specify estimated hours', 'estimatedHours', { file: filePath }, 'Consider adding estimatedHours to help with planning'));
+    }
+    else if (data.estimatedHours < 3) {
+        issues.push(createWarning('INSUFFICIENT_COMPLEXITY', `Plan estimated at ${data.estimatedHours} hours (< 3 hours minimum)`, 'estimatedHours', { file: filePath }, 'Plans should be for complex tasks (3+ hours). Consider using TodoWrite for simpler tasks.'));
+    }
+    // Rule: Category should be lowercase kebab-case
+    if (data.category) {
+        const kebabCasePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+        if (!kebabCasePattern.test(data.category)) {
+            issues.push(createWarning('INVALID_CATEGORY_FORMAT', `Category "${data.category}" should be lowercase kebab-case`, 'category', { file: filePath }, 'Use format like: "framework", "backend", "frontend", "apm-r"'));
+        }
+    }
+    // Rule: Check for reasonable phase count
+    if (data.phases) {
+        if (data.phases.length < 3) {
+            issues.push(createWarning('TOO_FEW_PHASES', `Plan has only ${data.phases.length} phases (recommended: 3-5)`, 'phases', { file: filePath }, 'Break down the work into at least 3 distinct phases'));
+        }
+        else if (data.phases.length > 7) {
+            issues.push(createWarning('TOO_MANY_PHASES', `Plan has ${data.phases.length} phases (recommended: 3-5, max: 7)`, 'phases', { file: filePath }, 'Consider consolidating related phases to keep the plan manageable'));
+        }
+    }
+    // Rule: Phase titles should be concise
+    if (data.phases) {
+        data.phases.forEach((phase, index) => {
+            if (phase.title.length > 60) {
+                issues.push(createWarning('PHASE_TITLE_TOO_LONG', `Phase ${index + 1} title is too long (${phase.title.length} chars)`, `phases[${index}].title`, { file: filePath }, 'Keep phase titles concise (< 60 characters)'));
+            }
+        });
+    }
+    // Rule: Each phase should have multiple deliverables for substantial work
+    if (data.phases) {
+        data.phases.forEach((phase, index) => {
+            if (phase.deliverables.length === 1) {
+                issues.push(createInfo('SINGLE_DELIVERABLE_PHASE', `Phase ${index + 1} "${phase.title}" has only one deliverable`, `phases[${index}].deliverables`, { file: filePath }, 'Consider if this phase needs to be broken down further or combined with another phase'));
+            }
+        });
+    }
+    return issues;
+}
+/**
+ * Validate plan markdown content (non-frontmatter content)
+ *
+ * @param content - Markdown content (without frontmatter)
+ * @param filePath - Path to the PLAN.md file
+ * @returns Array of validation issues
+ */
+export function validatePlanContent(content, filePath) {
+    const issues = [];
+    // Rule: Plan should have a problem statement section
+    if (!content.includes('## Problem Statement')) {
+        issues.push(createError('MISSING_PROBLEM_STATEMENT', 'Plan is missing "## Problem Statement" section', undefined, { file: filePath }, 'Add a Problem Statement section explaining what problem this plan addresses'));
+    }
+    // Rule: Plan should have a solution overview section
+    if (!content.includes('## Solution Overview')) {
+        issues.push(createError('MISSING_SOLUTION_OVERVIEW', 'Plan is missing "## Solution Overview" section', undefined, { file: filePath }, 'Add a Solution Overview section explaining the high-level approach'));
+    }
+    // Rule: Plan should have a phases section
+    if (!content.includes('## Phases')) {
+        issues.push(createError('MISSING_PHASES_SECTION', 'Plan is missing "## Phases" section', undefined, { file: filePath }, 'Add a Phases section detailing the implementation phases'));
+    }
+    // Rule: Plan should have success criteria section
+    if (!content.includes('## Success Criteria')) {
+        issues.push(createWarning('MISSING_SUCCESS_CRITERIA_SECTION', 'Plan is missing "## Success Criteria" section', undefined, { file: filePath }, 'Add a Success Criteria section defining when the plan is complete'));
+    }
+    // Rule: Warn if content is too short (likely incomplete)
+    const minContentLength = 500;
+    if (content.trim().length < minContentLength) {
+        issues.push(createWarning('PLAN_TOO_SHORT', `Plan content is very short (${content.trim().length} chars, expected > ${minContentLength})`, undefined, { file: filePath }, 'Ensure the plan has sufficient detail in problem statement, solution, and phases'));
+    }
+    return issues;
+}
+//# sourceMappingURL=plan-rules.js.map

package/dist/lib/validation/rules/plan-rules.js.map

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

package/dist/lib/validation/rules/ticket-rules.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Ticket Validation Rules
+ *
+ * TypeScript validation rules for backlog tickets.
+ * Validates business logic beyond JSON Schema constraints.
+ *
+ * @module validation/rules/ticket-rules
+ */
+import { ValidationIssue } from '../validation-report.js';
+/**
+ * Ticket frontmatter data structure
+ */
+export interface TicketData {
+    documentType?: string;
+    title?: string;
+    description?: string;
+    milestone?: string | null;
+    priority?: string | null;
+    storyPoints?: number | null;
+    labels?: string[] | null;
+    createdDate?: string;
+    exportedDate?: string | null;
+    'jira-ticketId'?: string | null;
+    'jira-url'?: string | null;
+    'jira-parent'?: string | null;
+    'jira-related'?: string[] | null;
+    'jira-blocking'?: string[] | null;
+    'jira-blockedBy'?: string[] | null;
+    'jira-fixVersion'?: string | null;
+    'jira-internalNotes'?: string | null;
+    'framework-documentation'?: string | null;
+    'framework-milestone'?: string | null;
+    'framework-technicalGuides'?: string[] | null;
+    'framework-relatedLocal'?: string[] | null;
+}
+/**
+ * Validate ticket business rules
+ *
+ * @param data - Ticket frontmatter data
+ * @param content - Full markdown content
+ * @param filePath - Path to ticket file
+ * @returns Array of validation issues
+ */
+export declare function validateTicketRules(data: TicketData, content: string, filePath: string): ValidationIssue[];
+/**
+ * Validate cross-references in ticket content
+ *
+ * @param data - Ticket frontmatter data
+ * @param content - Full markdown content
+ * @param filePath - Path to ticket file
+ * @returns Array of validation issues
+ */
+export declare function validateTicketReferences(data: TicketData, content: string, filePath: string): ValidationIssue[];
+//# sourceMappingURL=ticket-rules.d.ts.map

package/dist/lib/validation/rules/ticket-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-rules.d.ts","sourceRoot":"","sources":["../../../../src/lib/validation/rules/ticket-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EAIhB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,2BAA2B,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9C,wBAAwB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,eAAe,EAAE,CAsOnB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,eAAe,EAAE,CAsCnB"}

package/dist/lib/validation/rules/ticket-rules.js

@@ -0,0 +1,136 @@
+/**
+ * Ticket Validation Rules
+ *
+ * TypeScript validation rules for backlog tickets.
+ * Validates business logic beyond JSON Schema constraints.
+ *
+ * @module validation/rules/ticket-rules
+ */
+import { createWarning, createError, createInfo, } from '../validation-report.js';
+/**
+ * Validate ticket business rules
+ *
+ * @param data - Ticket frontmatter data
+ * @param content - Full markdown content
+ * @param filePath - Path to ticket file
+ * @returns Array of validation issues
+ */
+export function validateTicketRules(data, content, filePath) {
+    const issues = [];
+    const location = { file: filePath };
+    // Rule: Story/Task must have acceptance criteria
+    if (data.documentType === 'story' || data.documentType === 'task') {
+        if (!content.includes('## Acceptance Criteria')) {
+            issues.push(createError('MISSING_ACCEPTANCE_CRITERIA', 'Stories and tasks must have ## Acceptance Criteria section', undefined, location, 'Add a ## Acceptance Criteria section with testable conditions'));
+        }
+        else {
+            // Check for "Verify" statements
+            const verifyCount = (content.match(/\*\s+\*\*Verify\*\*/gi) || []).length;
+            if (verifyCount < 3) {
+                issues.push(createWarning('INSUFFICIENT_ACCEPTANCE_CRITERIA', `Only ${verifyCount} acceptance criteria found, recommend 8-12`, 'Acceptance Criteria', location, 'Add more specific **Verify** points to ensure comprehensive testing'));
+            }
+        }
+    }
+    // Rule: Bug must have steps to reproduce
+    if (data.documentType === 'bug') {
+        if (!content.includes('## Steps to Reproduce') &&
+            !content.includes('**Steps to Reproduce:**')) {
+            issues.push(createError('MISSING_REPRODUCTION_STEPS', 'Bugs must include steps to reproduce', undefined, location, 'Add a **Steps to Reproduce:** section with numbered steps'));
+        }
+    }
+    // Rule: Epic should have business value or goals
+    if (data.documentType === 'epic') {
+        if (!content.includes('**Goals:**') && !content.includes('**Business Value:**')) {
+            issues.push(createWarning('MISSING_EPIC_GOALS', 'Epics should include Goals or Business Value section', undefined, location, 'Add **Goals:** or **Business Value:** to clarify epic purpose'));
+        }
+    }
+    // Rule: Title should not be too long
+    if (data.title && data.title.length > 100) {
+        issues.push(createWarning('TITLE_TOO_LONG', `Title is ${data.title.length} characters, recommend < 100`, 'title', location, 'Shorten the title to be more concise'));
+    }
+    // Rule: Description should have minimum content
+    if (data.description && data.description.length < 20) {
+        issues.push(createWarning('DESCRIPTION_TOO_SHORT', 'Description should be more detailed', 'description', location, 'Expand the description to provide better context'));
+    }
+    // Rule: Check for proper section structure
+    if (!content.includes('## Description')) {
+        issues.push(createError('MISSING_DESCRIPTION_SECTION', 'Ticket must have ## Description section', undefined, location, 'Add a ## Description section to the ticket body'));
+    }
+    // Rule: Check for AS/WANT/SO THAT pattern in stories/tasks
+    if (data.documentType === 'story' || data.documentType === 'task') {
+        const hasUserStory = content.includes('**AS**') &&
+            content.includes('**I WANT**') &&
+            content.includes('**SO THAT**');
+        if (!hasUserStory) {
+            issues.push(createWarning('MISSING_USER_STORY_FORMAT', 'Stories/tasks should include AS/WANT/SO THAT user story format', undefined, location, 'Add user story format: **AS** a [role], **I WANT** [goal], **SO THAT** [benefit]'));
+        }
+    }
+    // Rule: Exported tickets should have Jira URL
+    if (data['jira-ticketId'] && !data['jira-url']) {
+        issues.push(createError('MISSING_JIRA_URL', 'Ticket has jira-ticketId but missing jira-url', 'jira-url', location, 'Add the Jira URL for this exported ticket'));
+    }
+    // Rule: Exported tickets should have exportedDate
+    if (data['jira-ticketId'] && !data.exportedDate) {
+        issues.push(createWarning('MISSING_EXPORTED_DATE', 'Exported ticket missing exportedDate', 'exportedDate', location, 'Add the date when this ticket was exported to Jira'));
+    }
+    // Rule: Check for code snippets in content (anti-pattern)
+    const codeBlockCount = (content.match(/```/g) || []).length / 2;
+    if (codeBlockCount > 0) {
+        issues.push(createWarning('CODE_SNIPPETS_FOUND', `Found ${codeBlockCount} code block(s). Tickets should reference patterns, not include implementation`, undefined, location, 'Remove code snippets and use pattern references instead'));
+    }
+    // Rule: Story points should only be on stories/tasks
+    if (data.storyPoints && (data.documentType === 'epic' || data.documentType === 'bug')) {
+        issues.push(createWarning('INVALID_STORY_POINTS', `${data.documentType} should not have story points`, 'storyPoints', location, 'Remove storyPoints field or change documentType'));
+    }
+    // Rule: Check for proper section dividers
+    const dividerCount = (content.match(/^---$/gm) || []).length;
+    if (dividerCount < 2) {
+        issues.push(createInfo('MISSING_SECTION_DIVIDERS', 'Recommend using --- dividers between sections for better readability', undefined, location, 'Add --- after title and between major sections'));
+    }
+    // Rule: Labels should be lowercase kebab-case
+    if (data.labels && Array.isArray(data.labels)) {
+        for (const label of data.labels) {
+            if (!/^[a-z0-9-]+$/.test(label)) {
+                issues.push(createWarning('INVALID_LABEL_FORMAT', `Label "${label}" should be lowercase kebab-case`, 'labels', location, 'Use lowercase letters, numbers, and hyphens only'));
+            }
+        }
+    }
+    // Rule: Check content length
+    const lineCount = content.split('\n').length;
+    if (data.documentType === 'epic' && lineCount > 100) {
+        issues.push(createInfo('EPIC_TOO_LONG', `Epic has ${lineCount} lines, recommend 30-50 lines`, undefined, location, 'Consider breaking down into smaller epics or moving details to linked documentation'));
+    }
+    else if (lineCount > 150 && (data.documentType === 'story' || data.documentType === 'task')) {
+        issues.push(createInfo('TICKET_TOO_LONG', `Ticket has ${lineCount} lines, recommend 30-100 lines`, undefined, location, 'Consider breaking down into smaller tickets or moving details to documentation'));
+    }
+    return issues;
+}
+/**
+ * Validate cross-references in ticket content
+ *
+ * @param data - Ticket frontmatter data
+ * @param content - Full markdown content
+ * @param filePath - Path to ticket file
+ * @returns Array of validation issues
+ */
+export function validateTicketReferences(data, content, filePath) {
+    const issues = [];
+    const location = { file: filePath };
+    // Check for cross-repo references in body (should be in frontmatter only)
+    const crossRepoPattern = /@[a-z0-9-]+\/[^\s\]]+/gi;
+    const matches = content.match(crossRepoPattern);
+    if (matches && matches.length > 0) {
+        issues.push(createWarning('CROSS_REPO_IN_BODY', 'Cross-repo references (@repo/path) should be in frontmatter, not body', undefined, location, 'Move cross-repo references to framework-documentation field'));
+    }
+    // Validate Jira URLs format
+    const jiraUrlPattern = /\[([A-Z]+-\d+)\]\((https?:\/\/[^)]+)\)/g;
+    const jiraRefs = [...content.matchAll(jiraUrlPattern)];
+    for (const match of jiraRefs) {
+        const url = match[2];
+        if (!url.includes('atlassian.net/browse/')) {
+            issues.push(createWarning('INVALID_JIRA_URL', `Jira URL should use full Atlassian format: ${url}`, undefined, location, 'Use full URL format: https://<domain>.atlassian.net/browse/TICKET-ID'));
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=ticket-rules.js.map

package/dist/lib/validation/rules/ticket-rules.js.map

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