@bloomreach/brxm-upgrade 0.1.1

package/dist/capture/entry-regeneration.d.ts

@@ -0,0 +1,29 @@
+import type { AIClient } from '../ai/types.js';
+import type { ManifestEntry } from '../planning/types.js';
+import type { CritiqueResult } from './critique-types.js';
+/**
+ * Builds a prompt instructing the AI to regenerate a manifest entry,
+ * incorporating the critique issues and original change document content.
+ *
+ * @param entry - The original manifest entry that needs regeneration
+ * @param changeDocContent - The original change document content
+ * @param critique - The critique result with issues and flags
+ * @returns A prompt string for the AI client
+ */
+export declare function buildRegenerationPrompt(entry: ManifestEntry, changeDocContent: string, critique: CritiqueResult): string;
+/**
+ * Uses an AI client to regenerate a manifest entry based on critique feedback.
+ * Handles both single-entry and split (array) responses, validates each result
+ * against the schema, and preserves the original jira_ticket.
+ *
+ * Falls back to returning the original entry if the AI response is unparseable
+ * or all generated entries fail validation.
+ *
+ * @param entry - The original manifest entry to regenerate
+ * @param changeDocContent - The original change document content
+ * @param critique - The critique result driving the regeneration
+ * @param aiClient - The AI client to use for generation
+ * @returns An array of validated ManifestEntry objects
+ */
+export declare function regenerateEntry(entry: ManifestEntry, changeDocContent: string, critique: CritiqueResult, aiClient: AIClient): Promise<ManifestEntry[]>;
+//# sourceMappingURL=entry-regeneration.d.ts.map

package/dist/capture/entry-regeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-regeneration.d.ts","sourceRoot":"","sources":["../../src/capture/entry-regeneration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,cAAc,GACvB,MAAM,CAqER;AA8BD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAwD1B"}

package/dist/capture/entry-regeneration.js

@@ -0,0 +1,164 @@
+import { validateManifestEntry } from './entry-validator.js';
+import { coerceArrayFields } from './entry-generator.js';
+/**
+ * Builds a prompt instructing the AI to regenerate a manifest entry,
+ * incorporating the critique issues and original change document content.
+ *
+ * @param entry - The original manifest entry that needs regeneration
+ * @param changeDocContent - The original change document content
+ * @param critique - The critique result with issues and flags
+ * @returns A prompt string for the AI client
+ */
+export function buildRegenerationPrompt(entry, changeDocContent, critique) {
+    const entryJson = JSON.stringify(entry, null, 2);
+    const issueLines = critique.issues
+        .map((issue, i) => {
+        return `${i + 1}. [${issue.severity.toUpperCase()}] ${issue.category}: ${issue.description}\n   Suggestion: ${issue.suggestion}`;
+    })
+        .join('\n');
+    let outputInstructions;
+    if (critique.shouldSplit) {
+        const splitHint = critique.suggestedSplits && critique.suggestedSplits.length > 0
+            ? `\n\nSuggested splits:\n${critique.suggestedSplits.map((s, i) => `${i + 1}. ${s}`).join('\n')}`
+            : '';
+        outputInstructions = `## Output Instructions
+
+The critique identified that this entry should be split into multiple focused entries.
+Return a JSON array (e.g. \`[]\`) of ManifestEntry objects — one per concern.${splitHint}
+
+Each entry in the array must be a complete, valid ManifestEntry object.`;
+    }
+    else {
+        outputInstructions = `## Output Instructions
+
+Return a single valid ManifestEntry JSON object (not an array) that addresses all the critique issues above.`;
+    }
+    const informationalInstruction = critique.shouldBeInformational
+        ? `\n\n## Informational Flag\n\nThis entry should be classified as informational: set \`"informational": true\` and include a concise \`"changelog_summary"\` field (one-line summary for the Platform Changes Summary).`
+        : '';
+    return `You are a software upgrade automation expert. Regenerate the following manifest entry to fix the quality issues identified by the critique.
+
+## Original Entry
+\`\`\`json
+${entryJson}
+\`\`\`
+
+## Original Change Document
+${changeDocContent}
+
+## Critique Issues
+${issueLines || 'No specific issues listed — improve overall quality.'}
+${informationalInstruction}
+
+## ManifestEntry Schema Reference
+
+- **id** (required): Lowercase kebab-case identifier, e.g. "cms-18384-jakarta-migration"
+- **description** (required): Human-readable description of the change
+- **type** (required): One of: namespace_migration, dependency_migration, maven_update, configuration_migration, api_migration, security_configuration, repository_migration, frontend_migration
+- **automatable** (required): One of: "true" (fully automatable with patterns), "partial" (AI-assisted), "false" (manual only)
+- **jira_ticket**: JIRA ticket reference (e.g. "CMS-18384")
+
+When automatable is "true":
+- **patterns** (required): Array of { match, replace } objects for find/replace
+- **file_globs** (required): Array of glob patterns for files to transform
+
+When automatable is "partial":
+- **detection_patterns** (required): Array of string patterns to detect if change applies
+- **ai_guidance** (required): Guidance text for AI-assisted migration
+
+When automatable is "false":
+- **manual_steps** (required): Array of step-by-step instructions
+
+Optional fields: doc_search_keywords, documentation_url, changelog_entry, depends_on, risk_level, informational, changelog_summary
+
+${outputInstructions}
+
+Respond with ONLY the JSON (object or array as instructed), no explanation or markdown fences.`;
+}
+/**
+ * Extracts JSON from AI response text, stripping optional markdown code fences.
+ *
+ * @param text - Raw AI response text
+ * @returns Cleaned JSON string
+ */
+function extractJson(text) {
+    const fenceMatch = /^\s*```(?:json)?\s*\n([\s\S]*?)\n\s*```\s*$/.exec(text);
+    if (fenceMatch?.[1]) {
+        return fenceMatch[1].trim();
+    }
+    return text.trim();
+}
+/**
+ * Sanitizes an entry id to conform to the schema pattern ^[a-z0-9-]+$.
+ *
+ * @param id - Raw id string from AI response
+ * @returns Sanitized lowercase kebab-case id
+ */
+function sanitizeId(id) {
+    return id
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Uses an AI client to regenerate a manifest entry based on critique feedback.
+ * Handles both single-entry and split (array) responses, validates each result
+ * against the schema, and preserves the original jira_ticket.
+ *
+ * Falls back to returning the original entry if the AI response is unparseable
+ * or all generated entries fail validation.
+ *
+ * @param entry - The original manifest entry to regenerate
+ * @param changeDocContent - The original change document content
+ * @param critique - The critique result driving the regeneration
+ * @param aiClient - The AI client to use for generation
+ * @returns An array of validated ManifestEntry objects
+ */
+export async function regenerateEntry(entry, changeDocContent, critique, aiClient) {
+    const prompt = buildRegenerationPrompt(entry, changeDocContent, critique);
+    const result = await aiClient.generate(prompt, {
+        maxTokens: 4096,
+        temperature: 0.3,
+    });
+    const jsonText = extractJson(result.text);
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch {
+        // Unparseable AI response — fall back to original entry
+        return [entry];
+    }
+    // Normalise to array regardless of whether AI returned one object or many
+    const candidates = Array.isArray(parsed) ? parsed : [parsed];
+    const validated = [];
+    for (const candidate of candidates) {
+        if (candidate === null || typeof candidate !== 'object') {
+            continue;
+        }
+        const record = candidate;
+        // Sanitize id
+        if (typeof record.id === 'string') {
+            record.id = sanitizeId(record.id);
+        }
+        // Always preserve jira_ticket from original entry
+        if (entry.jira_ticket) {
+            record.jira_ticket = entry.jira_ticket;
+        }
+        coerceArrayFields(record);
+        try {
+            validateManifestEntry(record);
+            validated.push(record);
+        }
+        catch {
+            // Entry failed schema validation — skip it
+        }
+    }
+    // If nothing validated, return the original entry unchanged
+    if (validated.length === 0) {
+        return [entry];
+    }
+    return validated;
+}
+//# sourceMappingURL=entry-regeneration.js.map

package/dist/capture/entry-regeneration.js.map

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

package/dist/capture/entry-validator.d.ts

@@ -0,0 +1,18 @@
+import type { ManifestEntry } from '../planning/types.js';
+/**
+ * Validates that a value is a valid ManifestEntry according to the JSON schema.
+ * Throws an Error with details if validation fails.
+ *
+ * @param entry - The value to validate
+ * @throws Error if the entry does not match the ManifestEntry schema
+ */
+export declare function validateManifestEntry(entry: unknown): asserts entry is ManifestEntry;
+/**
+ * Returns an array of validation error messages for a ManifestEntry candidate.
+ * Returns an empty array if the entry is valid.
+ *
+ * @param entry - The value to validate
+ * @returns Array of human-readable error strings
+ */
+export declare function getEntryValidationErrors(entry: unknown): string[];
+//# sourceMappingURL=entry-validator.d.ts.map

package/dist/capture/entry-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-validator.d.ts","sourceRoot":"","sources":["../../src/capture/entry-validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAiB1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAQpF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CASjE"}

package/dist/capture/entry-validator.js

@@ -0,0 +1,47 @@
+import AjvModule from 'ajv';
+import { createRequire } from 'node:module';
+const Ajv = AjvModule.default ?? AjvModule;
+const esmRequire = createRequire(import.meta.url);
+const manifestSchema = esmRequire('../manifests/schema.json');
+// Build a standalone entry schema from the definitions
+const entrySchema = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    ...manifestSchema['definitions']['ManifestEntry'],
+    definitions: manifestSchema['definitions'],
+};
+const ajv = new Ajv({ allErrors: true, verbose: true });
+const validate = ajv.compile(entrySchema);
+/**
+ * Validates that a value is a valid ManifestEntry according to the JSON schema.
+ * Throws an Error with details if validation fails.
+ *
+ * @param entry - The value to validate
+ * @throws Error if the entry does not match the ManifestEntry schema
+ */
+export function validateManifestEntry(entry) {
+    const valid = validate(entry);
+    if (!valid) {
+        const errors = validate.errors
+            ?.map((e) => `${e.instancePath || 'entry'} ${e.message ?? 'validation failed'}`)
+            .join('; ');
+        throw new Error(`Invalid manifest entry: ${errors}`);
+    }
+}
+/**
+ * Returns an array of validation error messages for a ManifestEntry candidate.
+ * Returns an empty array if the entry is valid.
+ *
+ * @param entry - The value to validate
+ * @returns Array of human-readable error strings
+ */
+export function getEntryValidationErrors(entry) {
+    validate(entry);
+    if (!validate.errors) {
+        return [];
+    }
+    return validate.errors.map((e) => {
+        const path = e.instancePath || 'entry';
+        return `${path}: ${e.message ?? 'validation failed'}`;
+    });
+}
+//# sourceMappingURL=entry-validator.js.map

package/dist/capture/entry-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-validator.js","sourceRoot":"","sources":["../../src/capture/entry-validator.ts"],"names":[],"mappings":"AAAA,OAAO,SAAsD,MAAM,KAAK,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC;AAE3C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,cAAc,GAAG,UAAU,CAAC,0BAA0B,CAA4B,CAAC;AAEzF,uDAAuD;AACvD,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,yCAAyC;IAClD,GAAI,cAAc,CAAC,aAAa,CAA6B,CAAC,eAAe,CAA4B;IACzG,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC;CAC3C,CAAC;AAEF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,MAAM,QAAQ,GAAoC,GAAG,CAAC,OAAO,CAAgB,WAAW,CAAC,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM;YAC5B,EAAE,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;aAC5F,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,OAAO,CAAC;QACvC,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/capture/heuristics.d.ts

@@ -0,0 +1,30 @@
+import type { ManifestEntry } from '../planning/types.js';
+/**
+ * Result of a single heuristic check applied to a manifest entry.
+ */
+export interface HeuristicFix {
+    /** Identifier for the check that fired (e.g. 'binary_file_globs') */
+    check: string;
+    /** Human-readable description of what was found and (if auto-fixed) what changed */
+    description: string;
+    /** Whether the entry was mutated in place to resolve the issue */
+    autoFixed: boolean;
+}
+/**
+ * Applies a set of fast, non-AI heuristic checks to a manifest entry.
+ * The entry is mutated in place when an auto-fix is applied.
+ *
+ * Checks performed:
+ * 1. Binary file globs — removed automatically
+ * 2. Catch-all globs mixed with specific globs — catch-alls removed automatically
+ * 3. Short detection patterns (< 4 chars) when longer ones exist — removed automatically
+ * 4. Invalid regex in /pattern/ wrapped detection_patterns — flagged, not fixed
+ * 5. Missing isRegex on TransformPatterns with regex metacharacters — flagged, not fixed
+ * 6. Missing changelog_summary when informational is true — derived automatically
+ * 7. Invalid informational_category enum value — removed automatically
+ *
+ * @param entry - The manifest entry to check and potentially mutate
+ * @returns Array of HeuristicFix records describing every issue found
+ */
+export declare function applyHeuristicFixes(entry: ManifestEntry): HeuristicFix[];
+//# sourceMappingURL=heuristics.d.ts.map

package/dist/capture/heuristics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heuristics.d.ts","sourceRoot":"","sources":["../../src/capture/heuristics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;CACpB;AA+BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,EAAE,CAYxE"}

package/dist/capture/heuristics.js

@@ -0,0 +1,223 @@
+/**
+ * Binary file extensions whose globs should never appear in file_globs because
+ * automated text-transform patterns cannot act on binary content.
+ */
+const BINARY_EXTENSIONS = new Set([
+    'jpg', 'jpeg', 'png', 'gif', 'bmp', 'ico', 'svg',
+    'jar', 'class', 'war', 'ear',
+    'zip', 'gz', 'tar',
+    'pdf', 'doc', 'docx', 'xls', 'xlsx',
+]);
+/**
+ * Glob patterns that match any file of a given extension — treated as catch-alls.
+ * A lone catch-all is acceptable; one mixed with specific globs is not.
+ */
+const CATCH_ALL_GLOB_PATTERN = /^\*\*\/\*\.[a-zA-Z0-9]+$/;
+/**
+ * Regex metacharacter sequences that indicate a `match` string is likely intended
+ * as a regex but may be missing `isRegex: true`.
+ */
+const REGEX_META_SEQUENCES = [
+    '\\s', '\\d', '\\w', '\\b',
+    '.*',
+    '[^',
+    '\\+', '\\{', '\\}',
+    '(?', '(?:', '(?=', '(?!',
+];
+/**
+ * Applies a set of fast, non-AI heuristic checks to a manifest entry.
+ * The entry is mutated in place when an auto-fix is applied.
+ *
+ * Checks performed:
+ * 1. Binary file globs — removed automatically
+ * 2. Catch-all globs mixed with specific globs — catch-alls removed automatically
+ * 3. Short detection patterns (< 4 chars) when longer ones exist — removed automatically
+ * 4. Invalid regex in /pattern/ wrapped detection_patterns — flagged, not fixed
+ * 5. Missing isRegex on TransformPatterns with regex metacharacters — flagged, not fixed
+ * 6. Missing changelog_summary when informational is true — derived automatically
+ * 7. Invalid informational_category enum value — removed automatically
+ *
+ * @param entry - The manifest entry to check and potentially mutate
+ * @returns Array of HeuristicFix records describing every issue found
+ */
+export function applyHeuristicFixes(entry) {
+    const fixes = [];
+    fixes.push(...checkBinaryFileGlobs(entry));
+    fixes.push(...checkCatchAllGlobs(entry));
+    fixes.push(...checkShortDetectionPatterns(entry));
+    fixes.push(...checkInvalidRegexPatterns(entry));
+    fixes.push(...checkMissingIsRegex(entry));
+    fixes.push(...checkMissingChangelogSummary(entry));
+    fixes.push(...checkInvalidInformationalCategory(entry));
+    return fixes;
+}
+// ---------------------------------------------------------------------------
+// Check 1 – Binary file globs
+// ---------------------------------------------------------------------------
+function checkBinaryFileGlobs(entry) {
+    if (!entry.file_globs || entry.file_globs.length === 0)
+        return [];
+    const removed = [];
+    const filtered = entry.file_globs.filter(glob => {
+        const ext = extractExtension(glob);
+        if (ext !== null && BINARY_EXTENSIONS.has(ext)) {
+            removed.push(glob);
+            return false;
+        }
+        return true;
+    });
+    if (removed.length === 0)
+        return [];
+    // Don't leave file_globs empty — warn instead of removing when all globs are binary
+    if (filtered.length === 0) {
+        return [{
+                check: 'binary_file_globs',
+                description: `All file globs are binary (${removed.join(', ')}) — kept unchanged to avoid empty file_globs`,
+                autoFixed: false,
+            }];
+    }
+    entry.file_globs = filtered;
+    return [{
+            check: 'binary_file_globs',
+            description: `Removed ${removed.length} binary file glob(s): ${removed.join(', ')}`,
+            autoFixed: true,
+        }];
+}
+/** Extracts the lowercase extension from a glob like **\/*.jpg → 'jpg', or null. */
+function extractExtension(glob) {
+    const match = /\.([a-zA-Z0-9]+)$/.exec(glob);
+    return match ? match[1].toLowerCase() : null;
+}
+// ---------------------------------------------------------------------------
+// Check 2 – Catch-all globs
+// ---------------------------------------------------------------------------
+function checkCatchAllGlobs(entry) {
+    if (!entry.file_globs || entry.file_globs.length === 0)
+        return [];
+    const catchAlls = entry.file_globs.filter(g => CATCH_ALL_GLOB_PATTERN.test(g));
+    const specifics = entry.file_globs.filter(g => !CATCH_ALL_GLOB_PATTERN.test(g));
+    // Only act when there is a mix of specific and catch-all globs
+    if (catchAlls.length === 0 || specifics.length === 0)
+        return [];
+    entry.file_globs = specifics;
+    return [{
+            check: 'catch_all_globs',
+            description: `Removed ${catchAlls.length} catch-all glob(s) (${catchAlls.join(', ')}) because specific globs are present`,
+            autoFixed: true,
+        }];
+}
+// ---------------------------------------------------------------------------
+// Check 3 – Short detection patterns
+// ---------------------------------------------------------------------------
+function checkShortDetectionPatterns(entry) {
+    if (!entry.detection_patterns || entry.detection_patterns.length === 0)
+        return [];
+    const SHORT_MIN_LENGTH = 4;
+    const short = entry.detection_patterns.filter(p => p.length < SHORT_MIN_LENGTH);
+    const longer = entry.detection_patterns.filter(p => p.length >= SHORT_MIN_LENGTH);
+    // Only remove if there are longer patterns to fall back on
+    if (short.length === 0 || longer.length === 0)
+        return [];
+    entry.detection_patterns = longer;
+    return [{
+            check: 'short_detection_patterns',
+            description: `Removed ${short.length} detection pattern(s) shorter than ${SHORT_MIN_LENGTH} chars: ${short.map(p => JSON.stringify(p)).join(', ')}`,
+            autoFixed: true,
+        }];
+}
+// ---------------------------------------------------------------------------
+// Check 4 – Invalid regex in /pattern/ wrapped detection_patterns
+// ---------------------------------------------------------------------------
+function checkInvalidRegexPatterns(entry) {
+    if (!entry.detection_patterns || entry.detection_patterns.length === 0)
+        return [];
+    const fixes = [];
+    for (const pattern of entry.detection_patterns) {
+        // Only inspect patterns explicitly wrapped as /regex/
+        if (!pattern.startsWith('/') || !pattern.endsWith('/') || pattern.length < 3)
+            continue;
+        const inner = pattern.slice(1, -1);
+        try {
+            new RegExp(inner);
+        }
+        catch {
+            fixes.push({
+                check: 'invalid_regex_pattern',
+                description: `Detection pattern ${JSON.stringify(pattern)} is wrapped as a regex but is not valid: ${inner}`,
+                autoFixed: false,
+            });
+        }
+    }
+    return fixes;
+}
+// ---------------------------------------------------------------------------
+// Check 5 – Missing isRegex on TransformPatterns
+// ---------------------------------------------------------------------------
+function checkMissingIsRegex(entry) {
+    if (!entry.patterns || entry.patterns.length === 0)
+        return [];
+    const fixes = [];
+    for (const pattern of entry.patterns) {
+        if (pattern.isRegex !== undefined)
+            continue;
+        const looksLikeRegex = REGEX_META_SEQUENCES.some(seq => pattern.match.includes(seq));
+        if (looksLikeRegex) {
+            fixes.push({
+                check: 'missing_is_regex',
+                description: `TransformPattern match ${JSON.stringify(pattern.match)} contains regex metacharacters but isRegex is not set`,
+                autoFixed: false,
+            });
+        }
+    }
+    return fixes;
+}
+// ---------------------------------------------------------------------------
+// Check 6 – Missing changelog_summary when informational is true
+// ---------------------------------------------------------------------------
+/**
+ * The JSON schema requires changelog_summary when informational is true.
+ * If the AI omitted it, derive one from changelog_entry or description
+ * (truncated to a single sentence).
+ */
+function checkMissingChangelogSummary(entry) {
+    if (!entry.informational || entry.changelog_summary)
+        return [];
+    const source = entry.changelog_entry ?? entry.description;
+    // Take the first sentence (up to first period followed by space or end)
+    const firstSentence = source.replace(/\.\s[\s\S]*$/, '').trim();
+    // Cap at 200 chars
+    entry.changelog_summary = firstSentence.length > 200
+        ? firstSentence.slice(0, 197) + '...'
+        : firstSentence;
+    return [{
+            check: 'missing_changelog_summary',
+            description: `Derived changelog_summary from ${entry.changelog_entry ? 'changelog_entry' : 'description'} (required when informational is true)`,
+            autoFixed: true,
+        }];
+}
+// ---------------------------------------------------------------------------
+// Check 7 – Invalid informational_category enum value
+// ---------------------------------------------------------------------------
+const VALID_INFORMATIONAL_CATEGORIES = new Set([
+    'security', 'performance', 'ui_ux', 'internal_cleanup', 'configuration',
+]);
+/**
+ * The schema restricts informational_category to a fixed enum. The AI
+ * sometimes invents values like "api_change" or "new_feature". Since
+ * the field is optional (falls back to a mapping from entry type),
+ * removing invalid values is safe.
+ */
+function checkInvalidInformationalCategory(entry) {
+    if (!entry.informational_category)
+        return [];
+    if (VALID_INFORMATIONAL_CATEGORIES.has(entry.informational_category))
+        return [];
+    const removed = entry.informational_category;
+    delete entry.informational_category;
+    return [{
+            check: 'invalid_informational_category',
+            description: `Removed invalid informational_category "${removed}" (allowed: ${[...VALID_INFORMATIONAL_CATEGORIES].join(', ')})`,
+            autoFixed: true,
+        }];
+}
+//# sourceMappingURL=heuristics.js.map

package/dist/capture/heuristics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heuristics.js","sourceRoot":"","sources":["../../src/capture/heuristics.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAChD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;IAC5B,KAAK,EAAE,IAAI,EAAE,KAAK;IAClB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CACpC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAC1B,IAAI;IACJ,IAAI;IACJ,KAAK,EAAE,KAAK,EAAE,KAAK;IACnB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,GAAG,iCAAiC,CAAC,KAAK,CAAC,CAAC,CAAC;IAExD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,SAAS,oBAAoB,CAAC,KAAoB;IAChD,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QAC9C,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,GAAG,KAAK,IAAI,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,oFAAoF;IACpF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC;gBACN,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C;gBAC3G,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC;IAE5B,OAAO,CAAC;YACN,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,WAAW,OAAO,CAAC,MAAM,yBAAyB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACnF,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,SAAS,kBAAkB,CAAC,KAAoB;IAC9C,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElE,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,+DAA+D;IAC/D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhE,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;IAE7B,OAAO,CAAC;YACN,KAAK,EAAE,iBAAiB;YACxB,WAAW,EAAE,WAAW,SAAS,CAAC,MAAM,uBAAuB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC;YACzH,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,SAAS,2BAA2B,CAAC,KAAoB;IACvD,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElF,MAAM,gBAAgB,GAAG,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,gBAAgB,CAAC,CAAC;IAElF,2DAA2D;IAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzD,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC;IAElC,OAAO,CAAC;YACN,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,WAAW,KAAK,CAAC,MAAM,sCAAsC,gBAAgB,WAAW,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACnJ,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,SAAS,yBAAyB,CAAC,KAAoB;IACrD,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElF,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC/C,sDAAsD;QACtD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAEvF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,uBAAuB;gBAC9B,WAAW,EAAE,qBAAqB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,4CAA4C,KAAK,EAAE;gBAC5G,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAE9E,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE9D,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,SAAS;QAE5C,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACrF,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,kBAAkB;gBACzB,WAAW,EAAE,0BAA0B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,uDAAuD;gBAC3H,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,4BAA4B,CAAC,KAAoB;IACxD,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,iBAAiB;QAAE,OAAO,EAAE,CAAC;IAE/D,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,WAAW,CAAC;IAC1D,wEAAwE;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,mBAAmB;IACnB,KAAK,CAAC,iBAAiB,GAAG,aAAa,CAAC,MAAM,GAAG,GAAG;QAClD,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;QACrC,CAAC,CAAC,aAAa,CAAC;IAElB,OAAO,CAAC;YACN,KAAK,EAAE,2BAA2B;YAClC,WAAW,EAAE,kCAAkC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,wCAAwC;YAChJ,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC;IAC7C,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,eAAe;CACxE,CAAC,CAAC;AAEH;;;;;GAKG;AACH,SAAS,iCAAiC,CAAC,KAAoB;IAC7D,IAAI,CAAC,KAAK,CAAC,sBAAsB;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,8BAA8B,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhF,MAAM,OAAO,GAAG,KAAK,CAAC,sBAAsB,CAAC;IAC7C,OAAO,KAAK,CAAC,sBAAsB,CAAC;IAEpC,OAAO,CAAC;YACN,KAAK,EAAE,gCAAgC;YACvC,WAAW,EAAE,2CAA2C,OAAO,eAAe,CAAC,GAAG,8BAA8B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC/H,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/capture/index.d.ts

@@ -0,0 +1,7 @@
+export type { ChangeDocMetadata, AIContextTags, ChangeDocument, ConflictCheckResult, ReviewDecision, ReviewResult, LogChangeSummary, LogChangeOptions, FinalizeOptions, } from './types.js';
+export { scanChangeDocuments, parseChangeDocument, extractMetadata, extractContextTags, } from './change-scanner.js';
+export { checkConflict, resolveConflict, } from './conflict-resolver.js';
+export { generateManifestEntry, buildEntryPrompt, } from './entry-generator.js';
+export { validateManifestEntry, getEntryValidationErrors, } from './entry-validator.js';
+export { ReviewFlow } from './review-flow.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/capture/index.js

@@ -0,0 +1,11 @@
+// Change scanning
+export { scanChangeDocuments, parseChangeDocument, extractMetadata, extractContextTags, } from './change-scanner.js';
+// Conflict resolution
+export { checkConflict, resolveConflict, } from './conflict-resolver.js';
+// Entry generation
+export { generateManifestEntry, buildEntryPrompt, } from './entry-generator.js';
+// Entry validation
+export { validateManifestEntry, getEntryValidationErrors, } from './entry-validator.js';
+// Review flow
+export { ReviewFlow } from './review-flow.js';
+//# sourceMappingURL=index.js.map

package/dist/capture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAaA,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/capture/quality-report.d.ts

@@ -0,0 +1,19 @@
+import type { QARecord } from './critique-types.js';
+/**
+ * Generates a markdown quality report for the QA pipeline run against a single
+ * manifest version.
+ *
+ * Sections produced (conditional sections are omitted when empty):
+ * 1. Header with version and date
+ * 2. Summary table with key metrics
+ * 3. Informational Reclassifications (if any)
+ * 4. Entries Regenerated (if any), with full critique issue details
+ * 5. Warnings (needs_improvement entries not regenerated, if any)
+ * 6. Heuristic Fixes (if any)
+ *
+ * @param version - The manifest version string (e.g. "16.7.0")
+ * @param records - All QARecord objects produced by the pipeline
+ * @returns A markdown-formatted quality report string
+ */
+export declare function generateQualityReport(version: string, records: QARecord[]): string;
+//# sourceMappingURL=quality-report.d.ts.map

package/dist/capture/quality-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-report.d.ts","sourceRoot":"","sources":["../../src/capture/quality-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,qBAAqB,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CA8BlF"}