cc-agentic-framework 1.14.1

package/dist/lib/backlog/validator.js

@@ -0,0 +1,285 @@
+/**
+ * Backlog Validator
+ *
+ * Validates all backlog tickets for completeness and cross-reference integrity.
+ *
+ * Checks:
+ * - YAML frontmatter completeness (required fields)
+ * - Cross-references (epic links, ticket dependencies)
+ * - Milestone codes exist
+ * - File naming conventions
+ * - Link validity
+ *
+ * @module backlog/validator
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { parseFrontmatter } from '../common/yaml-frontmatter.js';
+import { glob } from 'glob';
+/**
+ * Custom error for ticket validation failures
+ */
+export class TicketValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TicketValidationError';
+    }
+}
+/**
+ * Required YAML fields by document type
+ */
+const REQUIRED_FIELDS = {
+    story: ['documentType', 'title', 'description', 'createdDate'],
+    task: ['documentType', 'title', 'description', 'createdDate'],
+    bug: ['documentType', 'title', 'description', 'createdDate'],
+    spike: ['documentType', 'title', 'description', 'createdDate'],
+    epic: ['documentType', 'title', 'description', 'createdDate'],
+};
+/**
+ * Jira integration fields (should be present in exported tickets)
+ */
+const JIRA_FIELDS = [
+    'jira-ticketId',
+    'jira-url',
+    'jira-parent',
+    'jira-related',
+    'jira-blocking',
+    'jira-blockedBy',
+    'jira-fixVersion',
+    'jira-internalNotes',
+];
+/**
+ * Framework integration fields
+ */
+const FRAMEWORK_FIELDS = [
+    'framework-documentation',
+    'framework-milestone',
+    'framework-technicalGuides',
+    'framework-relatedLocal',
+];
+/**
+ * Valid milestone codes
+ */
+const VALID_MILESTONES = ['Nov2025', 'Jan2026', 'Feb2026', 'Mar2026'];
+/**
+ * Validation report tracking results
+ */
+export class ValidationReport {
+    valid = 0;
+    warnings = [];
+    errors = [];
+    /**
+     * Add a warning to the report
+     */
+    addWarning(filePath, message) {
+        this.warnings.push(`${filePath}: ${message}`);
+    }
+    /**
+     * Add an error to the report
+     */
+    addError(filePath, message) {
+        this.errors.push(`${filePath}: ${message}`);
+    }
+    /**
+     * Mark a ticket as valid
+     */
+    addValid() {
+        this.valid += 1;
+    }
+    /**
+     * Get formatted summary of validation results
+     */
+    getSummary() {
+        const total = this.valid + this.warnings.length + this.errors.length;
+        let summary = '';
+        summary += '='.repeat(60) + '\n';
+        summary += 'Validation Report\n';
+        summary += '='.repeat(60) + '\n';
+        summary += `Valid:    ${this.valid}/${total}\n`;
+        summary += `Warnings: ${this.warnings.length}/${total}\n`;
+        summary += `Errors:   ${this.errors.length}/${total}\n`;
+        if (this.warnings.length > 0) {
+            summary += '\nWarnings:\n';
+            for (const w of this.warnings) {
+                summary += `  ${w}\n`;
+            }
+        }
+        if (this.errors.length > 0) {
+            summary += '\nErrors:\n';
+            for (const e of this.errors) {
+                summary += `  ${e}\n`;
+            }
+        }
+        summary += '='.repeat(60) + '\n';
+        return summary;
+    }
+}
+/**
+ * Determine document type from filename or content
+ */
+function getDocumentType(filePath) {
+    const filename = path.basename(filePath).toUpperCase();
+    const docTypes = ['STORY', 'TASK', 'BUG', 'SPIKE', 'EPIC'];
+    for (const docType of docTypes) {
+        if (filename.includes(docType)) {
+            return docType.toLowerCase();
+        }
+    }
+    return null;
+}
+/**
+ * Validate a single ticket file
+ *
+ * @param filePath - Path to ticket file
+ * @param report - ValidationReport to track results
+ * @param basePath - Optional base path for relative path calculation
+ */
+export async function validateTicket(filePath, report, basePath) {
+    const relPath = basePath ? path.relative(basePath, filePath) : path.basename(filePath);
+    try {
+        // Read and parse file
+        const content = await fs.readFile(filePath, 'utf-8');
+        if (!content.startsWith('---')) {
+            report.addError(relPath, 'Failed to parse YAML frontmatter');
+            return;
+        }
+        let metadata;
+        try {
+            const parsed = parseFrontmatter(content);
+            metadata = parsed.data;
+        }
+        catch {
+            report.addError(relPath, 'Failed to parse YAML frontmatter');
+            return;
+        }
+        // Determine document type
+        let docType = getDocumentType(filePath);
+        if (!docType) {
+            report.addWarning(relPath, 'Could not determine document type from filename');
+            const rawDocType = metadata.documentType;
+            docType = typeof rawDocType === 'string' ? rawDocType.toLowerCase() : 'unknown';
+        }
+        // Check required fields
+        const required = (docType && docType in REQUIRED_FIELDS ? REQUIRED_FIELDS[docType] : null) || [];
+        for (const field of required) {
+            if (!metadata[field]) {
+                report.addError(relPath, `Missing required field: ${field}`);
+                return;
+            }
+        }
+        // Validate Jira integration fields (warnings only)
+        for (const field of JIRA_FIELDS) {
+            if (!metadata[field]) {
+                report.addWarning(relPath, `Missing Jira field (v10.1.1): ${field}`);
+            }
+        }
+        // Validate Framework integration fields (warnings only)
+        for (const field of FRAMEWORK_FIELDS) {
+            if (!metadata[field]) {
+                report.addWarning(relPath, `Missing Framework field (v10.1.1): ${field}`);
+            }
+        }
+        // Check if ticket has been exported to Jira
+        if (metadata['jira-ticketId']) {
+            if (!metadata['jira-url']) {
+                report.addWarning(relPath, 'Exported ticket missing jira-url');
+            }
+            if (!metadata['exportedDate']) {
+                report.addWarning(relPath, 'Exported ticket missing exportedDate');
+            }
+        }
+        // Validate milestone
+        if (metadata.milestone) {
+            const milestone = metadata.milestone;
+            if (typeof milestone !== 'string' || !VALID_MILESTONES.includes(milestone)) {
+                report.addWarning(relPath, `Unknown milestone: ${milestone}`);
+            }
+        }
+        // Validate jira-parent reference
+        if (metadata['jira-parent']) {
+            const jiraParent = metadata['jira-parent'];
+            if (typeof jiraParent !== 'string' || !jiraParent.startsWith('DAPM-')) {
+                report.addWarning(relPath, `Invalid jira-parent format: ${jiraParent}`);
+            }
+        }
+        // Validate jira-related, jira-blocking, jira-blockedBy arrays
+        for (const field of ['jira-related', 'jira-blocking', 'jira-blockedBy']) {
+            if (metadata[field]) {
+                const value = metadata[field];
+                if (!Array.isArray(value)) {
+                    report.addWarning(relPath, `${field} should be an array, got ${typeof value}`);
+                }
+            }
+        }
+        // Check file naming convention
+        const filename = path.basename(filePath);
+        if (!filename.includes('-') || !filename.endsWith('.md')) {
+            report.addWarning(relPath, 'File should be named [TYPE]-[title-kebab-case].md');
+        }
+        report.addValid();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        report.addError(relPath, `Failed to validate: ${errorMessage}`);
+    }
+}
+/**
+ * Validate all tickets in a backlog directory
+ *
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - Show detailed progress
+ * @returns ValidationReport with results
+ */
+export async function validateBacklog(backlogDir, verbose = false) {
+    if (!(await fs.pathExists(backlogDir))) {
+        throw new TicketValidationError(`Backlog directory not found: ${backlogDir}`);
+    }
+    const report = new ValidationReport();
+    if (verbose) {
+        console.log('Validating backlog tickets...\n');
+    }
+    // Scan all ticket types
+    const ticketTypes = ['stories', 'tasks', 'bugs', 'spikes'];
+    for (const ticketType of ticketTypes) {
+        const pattern = path.join(backlogDir, 'tickets', ticketType, '*.md');
+        const files = await glob(pattern, { absolute: true });
+        for (const filePath of files) {
+            if (filePath.endsWith('README.md')) {
+                continue;
+            }
+            if (verbose) {
+                console.log(`  Checking ${path.relative(backlogDir, filePath)}...`);
+            }
+            await validateTicket(filePath, report, backlogDir);
+        }
+    }
+    // Validate epics
+    const epicsPattern = path.join(backlogDir, 'epics', '*.md');
+    const epicFiles = await glob(epicsPattern, { absolute: true });
+    for (const filePath of epicFiles) {
+        if (filePath.endsWith('README.md')) {
+            continue;
+        }
+        if (verbose) {
+            console.log(`  Checking ${path.relative(backlogDir, filePath)}...`);
+        }
+        await validateTicket(filePath, report, backlogDir);
+    }
+    // Validate workflow tickets
+    const workflowFolders = ['Draft', 'ReadyToExport', 'Exported'];
+    for (const folder of workflowFolders) {
+        const pattern = path.join(backlogDir, '_workflow', folder, '*.md');
+        const files = await glob(pattern, { absolute: true });
+        for (const filePath of files) {
+            if (filePath.endsWith('README.md')) {
+                continue;
+            }
+            if (verbose) {
+                console.log(`  Checking ${path.relative(backlogDir, filePath)}...`);
+            }
+            await validateTicket(filePath, report, backlogDir);
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=validator.js.map

package/dist/lib/backlog/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/lib/backlog/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,eAAe,GAA6B;IAChD,KAAK,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC;IAC9D,IAAI,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC;IAC7D,GAAG,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC;IAC5D,KAAK,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC;IAC9D,IAAI,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC;CAC9D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,eAAe;IACf,UAAU;IACV,aAAa;IACb,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,oBAAoB;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAG;IACvB,yBAAyB;IACzB,qBAAqB;IACrB,2BAA2B;IAC3B,wBAAwB;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B,KAAK,GAAW,CAAC,CAAC;IAClB,QAAQ,GAAa,EAAE,CAAC;IACxB,MAAM,GAAa,EAAE,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,QAAgB,EAAE,OAAe;QAC1C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAe;QACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACrE,IAAI,OAAO,GAAG,EAAE,CAAC;QAEjB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACjC,OAAO,IAAI,qBAAqB,CAAC;QACjC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACjC,OAAO,IAAI,aAAa,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;QAChD,OAAO,IAAI,aAAa,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,KAAK,IAAI,CAAC;QAC1D,OAAO,IAAI,aAAa,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,IAAI,CAAC;QAExD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,eAAe,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,aAAa,CAAC;YACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC5B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QAEjC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,MAAwB,EACxB,QAAiB;IAEjB,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEvF,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,IAAI,QAAiC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,0BAA0B;QAC1B,IAAI,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,iDAAiD,CAAC,CAAC;YAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAC;YACzC,OAAO,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,CAAC;QAED,wBAAwB;QACxB,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjG,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,2BAA2B,KAAK,EAAE,CAAC,CAAC;gBAC7D,OAAO;YACT,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,iCAAiC,KAAK,EAAE,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,sCAAsC,KAAK,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,IAAI,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,sCAAsC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;YACrC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3E,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,sBAAsB,SAAS,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC3C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,+BAA+B,UAAU,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,8DAA8D;QAC9D,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,CAAC;YACxE,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1B,MAAM,CAAC,UAAU,CACf,OAAO,EACP,GAAG,KAAK,4BAA4B,OAAO,KAAK,EAAE,CACnD,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,mDAAmD,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,CAAC,QAAQ,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,UAAmB,KAAK;IAExB,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,qBAAqB,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAEtC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IAED,4BAA4B;IAC5B,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAC/D,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/boundary-validator.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Boundary Validator
+ *
+ * Validates separation between framework (publishable) and instance (deployed) zones.
+ *
+ * Rules:
+ * 1. Framework files must NOT reference instance paths (.claude/, .claude/, CLAUDE.md, routes.yml)
+ * 2. Instance files must NOT reference framework paths (framework/)
+ * 3. No hardcoded absolute paths (/Users/, /home/, C:\)
+ */
+export type Zone = 'framework' | 'instance';
+export type ReferenceType = 'markdown-link' | 'markdown-image' | 'json-path' | 'yaml-path' | 'ts-import' | 'absolute-path';
+export type ViolationRule = 'framework-to-instance' | 'instance-to-framework' | 'hardcoded-absolute';
+export interface PathReference {
+    sourceFile: string;
+    sourceZone: Zone;
+    line: number;
+    column: number;
+    referenceType: ReferenceType;
+    rawReference: string;
+    resolvedPath: string | null;
+    targetZone: Zone | null;
+}
+export interface BoundaryViolation {
+    reference: PathReference;
+    rule: ViolationRule;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface BoundaryValidationResult {
+    valid: boolean;
+    violations: BoundaryViolation[];
+    stats: {
+        filesScanned: number;
+        referencesChecked: number;
+        frameworkViolations: number;
+        instanceViolations: number;
+        absolutePathViolations: number;
+    };
+}
+export interface BoundaryValidatorOptions {
+    frameworkPath?: string;
+    instancePaths?: string[];
+    verbose?: boolean;
+}
+/**
+ * Main Boundary Validator class
+ */
+export declare class BoundaryValidator {
+    private projectRoot;
+    private extractor;
+    private frameworkPath;
+    private instancePaths;
+    constructor(projectRoot: string, options?: BoundaryValidatorOptions);
+    /**
+     * Classify which zone a file belongs to
+     */
+    classifyZone(filePath: string): Zone;
+    /**
+     * Get files to scan based on glob patterns
+     */
+    private getFilesToScan;
+    /**
+     * Extract all references from a file
+     */
+    private extractReferences;
+    /**
+     * Check if a path reference appears to be a documentation example.
+     *
+     * Documentation examples (in ANTI-PATTERNS.md, QUICK-REFERENCE.md, etc.)
+     * intentionally show absolute paths to teach correct MCP tool usage.
+     * These are not actual references and should not be flagged.
+     */
+    private isDocumentationExample;
+    /**
+     * Check if a reference violates boundary rules
+     */
+    private checkViolation;
+    /**
+     * Validate all files in the project for boundary violations
+     */
+    validateProject(): Promise<BoundaryValidationResult>;
+    /**
+     * Format violations as a human-readable report
+     */
+    formatReport(result: BoundaryValidationResult): string;
+}
+//# sourceMappingURL=boundary-validator.d.ts.map

package/dist/lib/boundary-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-validator.d.ts","sourceRoot":"","sources":["../../src/lib/boundary-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,MAAM,IAAI,GAAG,WAAW,GAAG,UAAU,CAAC;AAG5C,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,WAAW,GACX,eAAe,CAAC;AAGpB,MAAM,MAAM,aAAa,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,oBAAoB,CAAC;AAGzB,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAGD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAGD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAGD,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmRD;;GAEG;AACH,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,WAAW;IALrB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAW;gBAGtB,WAAW,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,wBAAwB;IAapC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAuBpC;;OAEG;YACW,cAAc;IAgB5B;;OAEG;YACW,iBAAiB;IA8B/B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyEtB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,wBAAwB,CAAC;IA4D1D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM;CAwCvD"}