@libar-dev/architect 1.0.0-pre.3

package/dist/utils/id-utils.js

@@ -0,0 +1,51 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern PatternIdGenerator
+ * @architect-status completed
+ * @architect-used-by DocExtractor, GherkinExtractor
+ *
+ * ## Pattern ID Generator - Deterministic ID Generation
+ *
+ * Generates unique, deterministic pattern IDs based on file path and line number.
+ * Uses MD5 hashing to produce stable 8-character identifiers.
+ *
+ * ### When to Use
+ *
+ * - When extracting patterns from TypeScript or Gherkin files
+ * - When needing stable IDs that survive re-extraction
+ * - When correlating patterns across multiple extraction runs
+ *
+ * ### Key Concepts
+ *
+ * - **Deterministic**: Same file + line always produces same ID
+ * - **Collision-resistant**: MD5 hash provides adequate uniqueness for pattern counts
+ * - **Human-friendly prefix**: `pattern-` prefix aids debugging and identification
+ */
+import * as crypto from 'crypto';
+/**
+ * Generate a deterministic pattern ID from file path and line number
+ *
+ * Creates a unique identifier based on the combination of file path and
+ * starting line number. The same inputs will always produce the same output,
+ * making pattern IDs stable across multiple extraction runs.
+ *
+ * @param filePath - Relative file path (e.g., 'src/utils.ts')
+ * @param line - Line number where the pattern starts
+ * @returns Pattern ID in format 'pattern-{8-char-hash}'
+ *
+ * @example
+ * ```typescript
+ * const id1 = generatePatternId('src/utils.ts', 42);
+ * const id2 = generatePatternId('src/utils.ts', 42);
+ *
+ * console.log(id1 === id2); // true (deterministic)
+ * console.log(id1); // 'pattern-a1b2c3d4'
+ * ```
+ */
+export function generatePatternId(filePath, line) {
+    const input = `${filePath}:${line}`;
+    const hash = crypto.createHash('md5').update(input).digest('hex').slice(0, 8);
+    return `pattern-${hash}`;
+}
+//# sourceMappingURL=id-utils.js.map

package/dist/utils/id-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-utils.js","sourceRoot":"","sources":["../../src/utils/id-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAY;IAC9D,MAAM,KAAK,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,WAAW,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern UtilsModule
+ * @architect-status completed
+ * @architect-uses StringUtilities, CollectionUtilities
+ *
+ * ## UtilsModule - Shared Utilities Barrel Export
+ *
+ * Common helper functions used across the Architect package.
+ * Provides text transformation and collection manipulation utilities.
+ *
+ * ### When to Use
+ *
+ * - Use when importing utility functions from the package
+ * - Use for consistent text slugification or collection grouping
+ */
+export { slugify, toKebabCase, camelCaseToTitleCase, normalizeLineEndings, } from './string-utils.js';
+export { groupBy } from './collection-utils.js';
+export { generatePatternId } from './id-utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,OAAO,EACP,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern UtilsModule
+ * @architect-status completed
+ * @architect-uses StringUtilities, CollectionUtilities
+ *
+ * ## UtilsModule - Shared Utilities Barrel Export
+ *
+ * Common helper functions used across the Architect package.
+ * Provides text transformation and collection manipulation utilities.
+ *
+ * ### When to Use
+ *
+ * - Use when importing utility functions from the package
+ * - Use for consistent text slugification or collection grouping
+ */
+export { slugify, toKebabCase, camelCaseToTitleCase, normalizeLineEndings, } from './string-utils.js';
+export { groupBy } from './collection-utils.js';
+export { generatePatternId } from './id-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,OAAO,EACP,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/utils/string-utils.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern StringUtilities
+ * @architect-status completed
+ * @architect-used-by DocExtractor, SectionRenderer
+ *
+ * ## StringUtilities - Text Transformation Functions
+ *
+ * Provides shared utilities for string manipulation used across the Architect package,
+ * including slugification for URLs/filenames and Markdown formatting cleanup.
+ *
+ * ### When to Use
+ *
+ * - Use `slugify()` when generating URL-safe identifiers for HTML anchors or filenames
+ * - Use when normalizing text for consistent formatting across generated docs
+ */
+/**
+ * Convert a string to a URL/filename-safe slug (lowercase, alphanumeric, hyphens)
+ *
+ * Transforms text into a normalized format suitable for:
+ * - HTML anchor IDs
+ * - Filenames
+ * - URL slugs
+ *
+ * **Note:** Non-ASCII characters (including Unicode) are removed, not transliterated.
+ * For example, `"hello-日本語"` becomes `"hello"`.
+ *
+ * @param text - Input text to slugify
+ * @returns Slug string (lowercase, alphanumeric with hyphens)
+ *
+ * @example
+ * ```typescript
+ * slugify('User Authentication');    // 'user-authentication'
+ * slugify('Create User (v2)');       // 'create-user-v2'
+ * slugify('---test---');             // 'test'
+ * slugify('Hello  World!');          // 'hello-world'
+ * slugify('UPPER_CASE_TEXT');        // 'upper-case-text'
+ * ```
+ */
+export declare function slugify(text: string): string;
+/**
+ * Convert CamelCase or PascalCase text to kebab-case with proper word separation
+ *
+ * Handles various naming conventions:
+ * - PascalCase: `DeciderPattern` → `decider-pattern`
+ * - Mixed case: `BddTestingInfrastructure` → `bdd-testing-infrastructure`
+ * - Consecutive uppercase: `APIEndpoint` → `api-endpoint`
+ * - Numbers: `OAuth2Flow` → `o-auth-2-flow`
+ * - Already kebab-case: `already-kebab` → `already-kebab`
+ *
+ * **Note:** Unlike `slugify()`, this function properly splits CamelCase words
+ * instead of just lowercasing them together.
+ *
+ * @param text - Input text (CamelCase, PascalCase, or mixed)
+ * @returns kebab-case string
+ *
+ * @example
+ * ```typescript
+ * toKebabCase('DeciderPattern');               // 'decider-pattern'
+ * toKebabCase('BddTestingInfrastructure');     // 'bdd-testing-infrastructure'
+ * toKebabCase('APIEndpoint');                  // 'api-endpoint'
+ * toKebabCase('OAuth2Flow');                   // 'o-auth-2-flow'
+ * toKebabCase('DCB');                          // 'dcb'
+ * toKebabCase('ProcessGuardLinter');           // 'process-guard-linter'
+ * toKebabCase('already-kebab');                // 'already-kebab'
+ * toKebabCase('Pattern (v2)');                 // 'pattern-v2'
+ * ```
+ */
+export declare function toKebabCase(text: string): string;
+/**
+ * Convert PascalCase or camelCase text to UPPER-KEBAB-CASE
+ *
+ * This is useful for generating constant-style identifiers or
+ * documentation file names that use uppercase conventions.
+ *
+ * @param text - Input text in PascalCase or camelCase
+ * @returns UPPER-KEBAB-CASE string
+ *
+ * @example
+ * ```typescript
+ * toUpperKebabCase('ProcessGuard');           // 'PROCESS-GUARD'
+ * toUpperKebabCase('DecisionDocCodec');       // 'DECISION-DOC-CODEC'
+ * toUpperKebabCase('OAuth2Flow');             // 'O-AUTH-2-FLOW'
+ * ```
+ */
+export declare function toUpperKebabCase(text: string): string;
+/**
+ * Convert CamelCase or PascalCase text to "Title Case" with spaces
+ *
+ * Handles various naming conventions:
+ * - PascalCase: `RemainingWorkEnhancement` → `Remaining Work Enhancement`
+ * - Acronyms: `HTTPServer` → `HTTP Server`
+ * - Mixed: `OAuth2Client` → `OAuth2 Client`
+ * - kebab-case: `remaining-work` → `remaining work`
+ * - Known acronyms: `DoDValidator` → `DoD Validator` (not `Do D Validator`)
+ *
+ * @param text - Input text in CamelCase, PascalCase, or kebab-case
+ * @returns Human-readable title case string
+ *
+ * @example
+ * ```typescript
+ * camelCaseToTitleCase('RemainingWorkEnhancement'); // 'Remaining Work Enhancement'
+ * camelCaseToTitleCase('HTTPServer');                // 'HTTP Server'
+ * camelCaseToTitleCase('OAuth2Client');              // 'OAuth2 Client'
+ * camelCaseToTitleCase('XMLParser');                 // 'XML Parser'
+ * camelCaseToTitleCase('parseJSON');                 // 'parse JSON'
+ * camelCaseToTitleCase('DoDValidator');              // 'DoD Validator'
+ * camelCaseToTitleCase('TypeScriptAST');             // 'TypeScript AST'
+ * ```
+ */
+export declare function camelCaseToTitleCase(text: string): string;
+/**
+ * Normalize line endings from Windows CRLF to Unix LF.
+ *
+ * Used when processing text that may have been created on Windows systems
+ * or transferred through systems that preserve Windows line endings.
+ *
+ * @param text - Text that may contain CRLF line endings
+ * @returns Text with all CRLF sequences replaced by LF
+ *
+ * @example
+ * ```typescript
+ * normalizeLineEndings('line1\r\nline2\r\n'); // 'line1\nline2\n'
+ * normalizeLineEndings('already\nunix\n');    // 'already\nunix\n'
+ * ```
+ */
+export declare function normalizeLineEndings(text: string): string;
+/**
+ * Extract the first sentence from a text string.
+ *
+ * Finds sentence-ending punctuation (.!?) followed by whitespace + uppercase
+ * (new sentence) or end of string. Handles periods in file extensions correctly.
+ *
+ * @param text - Input text
+ * @returns First sentence, or full trimmed text if no sentence boundary found
+ */
+export declare function extractFirstSentenceRaw(text: string): string;
+/**
+ * Extract a compact description preserving Problem/Solution structure.
+ *
+ * If the text uses `**Problem:**` / `**Solution:**` markers, extracts the
+ * first sentence from each section and combines them. Otherwise falls back
+ * to extractFirstSentence() behavior.
+ *
+ * @param text - Description text, possibly with Problem/Solution structure
+ * @returns Compact description preserving both halves if structured
+ */
+export declare function extractDescription(text: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAqDD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoDzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAavD"}

package/dist/utils/string-utils.js

@@ -0,0 +1,281 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern StringUtilities
+ * @architect-status completed
+ * @architect-used-by DocExtractor, SectionRenderer
+ *
+ * ## StringUtilities - Text Transformation Functions
+ *
+ * Provides shared utilities for string manipulation used across the Architect package,
+ * including slugification for URLs/filenames and Markdown formatting cleanup.
+ *
+ * ### When to Use
+ *
+ * - Use `slugify()` when generating URL-safe identifiers for HTML anchors or filenames
+ * - Use when normalizing text for consistent formatting across generated docs
+ */
+/**
+ * Convert a string to a URL/filename-safe slug (lowercase, alphanumeric, hyphens)
+ *
+ * Transforms text into a normalized format suitable for:
+ * - HTML anchor IDs
+ * - Filenames
+ * - URL slugs
+ *
+ * **Note:** Non-ASCII characters (including Unicode) are removed, not transliterated.
+ * For example, `"hello-日本語"` becomes `"hello"`.
+ *
+ * @param text - Input text to slugify
+ * @returns Slug string (lowercase, alphanumeric with hyphens)
+ *
+ * @example
+ * ```typescript
+ * slugify('User Authentication');    // 'user-authentication'
+ * slugify('Create User (v2)');       // 'create-user-v2'
+ * slugify('---test---');             // 'test'
+ * slugify('Hello  World!');          // 'hello-world'
+ * slugify('UPPER_CASE_TEXT');        // 'upper-case-text'
+ * ```
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Convert CamelCase or PascalCase text to kebab-case with proper word separation
+ *
+ * Handles various naming conventions:
+ * - PascalCase: `DeciderPattern` → `decider-pattern`
+ * - Mixed case: `BddTestingInfrastructure` → `bdd-testing-infrastructure`
+ * - Consecutive uppercase: `APIEndpoint` → `api-endpoint`
+ * - Numbers: `OAuth2Flow` → `o-auth-2-flow`
+ * - Already kebab-case: `already-kebab` → `already-kebab`
+ *
+ * **Note:** Unlike `slugify()`, this function properly splits CamelCase words
+ * instead of just lowercasing them together.
+ *
+ * @param text - Input text (CamelCase, PascalCase, or mixed)
+ * @returns kebab-case string
+ *
+ * @example
+ * ```typescript
+ * toKebabCase('DeciderPattern');               // 'decider-pattern'
+ * toKebabCase('BddTestingInfrastructure');     // 'bdd-testing-infrastructure'
+ * toKebabCase('APIEndpoint');                  // 'api-endpoint'
+ * toKebabCase('OAuth2Flow');                   // 'o-auth-2-flow'
+ * toKebabCase('DCB');                          // 'dcb'
+ * toKebabCase('ProcessGuardLinter');           // 'process-guard-linter'
+ * toKebabCase('already-kebab');                // 'already-kebab'
+ * toKebabCase('Pattern (v2)');                 // 'pattern-v2'
+ * ```
+ */
+export function toKebabCase(text) {
+    return (text
+        // Insert hyphen between lowercase/digit and uppercase: camelCase → camel-Case
+        .replace(/([a-z\d])([A-Z])/g, '$1-$2')
+        // Insert hyphen between consecutive uppercase and uppercase+lowercase: HTTPServer → HTTP-Server
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
+        // Insert hyphen between letter and digit: Auth2 → Auth-2
+        .replace(/([a-zA-Z])(\d)/g, '$1-$2')
+        // Convert to lowercase
+        .toLowerCase()
+        // Replace any non-alphanumeric characters with hyphens
+        .replace(/[^a-z0-9]+/g, '-')
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, ''));
+}
+/**
+ * Convert PascalCase or camelCase text to UPPER-KEBAB-CASE
+ *
+ * This is useful for generating constant-style identifiers or
+ * documentation file names that use uppercase conventions.
+ *
+ * @param text - Input text in PascalCase or camelCase
+ * @returns UPPER-KEBAB-CASE string
+ *
+ * @example
+ * ```typescript
+ * toUpperKebabCase('ProcessGuard');           // 'PROCESS-GUARD'
+ * toUpperKebabCase('DecisionDocCodec');       // 'DECISION-DOC-CODEC'
+ * toUpperKebabCase('OAuth2Flow');             // 'O-AUTH-2-FLOW'
+ * ```
+ */
+export function toUpperKebabCase(text) {
+    return toKebabCase(text).toUpperCase();
+}
+/**
+ * Known acronyms that should not be split during case conversion.
+ *
+ * These terms are protected with placeholders before regex processing,
+ * then restored afterward to preserve their correct formatting.
+ *
+ * IMPORTANT: Sorted by length (longest first) to ensure longer acronyms
+ * are matched before shorter ones they might contain.
+ * e.g., "TypeScript" must be matched before "AST" in "TypeScriptAST"
+ */
+const KNOWN_ACRONYMS = [
+    // Multi-word technical terms (longest first)
+    'JavaScript', // 10 chars
+    'TypeScript', // 10 chars
+    'WebSocket', // 9 chars
+    'GraphQL', // 7 chars
+    'Gherkin', // 7 chars
+    'RegExp', // 6 chars
+    'GitHub', // 6 chars
+    // 5-char acronyms
+    'HTTPS',
+    'OAuth',
+    // 4-char acronyms
+    'JSON',
+    'HTML',
+    'HTTP',
+    'UUID',
+    'REST',
+    'CRUD',
+    // 3-char acronyms
+    'DoD', // Definition of Done
+    'PRD', // Product Requirements Document
+    'API',
+    'CLI',
+    'AST',
+    'DOM',
+    'URL',
+    'XML',
+    'CSS',
+    'SQL',
+    'JWT',
+    'NPM',
+    'ESM',
+    'CJS',
+    'SSO',
+    'MCP',
+    'LLM',
+    'RAG',
+    'ADR',
+];
+/**
+ * Convert CamelCase or PascalCase text to "Title Case" with spaces
+ *
+ * Handles various naming conventions:
+ * - PascalCase: `RemainingWorkEnhancement` → `Remaining Work Enhancement`
+ * - Acronyms: `HTTPServer` → `HTTP Server`
+ * - Mixed: `OAuth2Client` → `OAuth2 Client`
+ * - kebab-case: `remaining-work` → `remaining work`
+ * - Known acronyms: `DoDValidator` → `DoD Validator` (not `Do D Validator`)
+ *
+ * @param text - Input text in CamelCase, PascalCase, or kebab-case
+ * @returns Human-readable title case string
+ *
+ * @example
+ * ```typescript
+ * camelCaseToTitleCase('RemainingWorkEnhancement'); // 'Remaining Work Enhancement'
+ * camelCaseToTitleCase('HTTPServer');                // 'HTTP Server'
+ * camelCaseToTitleCase('OAuth2Client');              // 'OAuth2 Client'
+ * camelCaseToTitleCase('XMLParser');                 // 'XML Parser'
+ * camelCaseToTitleCase('parseJSON');                 // 'parse JSON'
+ * camelCaseToTitleCase('DoDValidator');              // 'DoD Validator'
+ * camelCaseToTitleCase('TypeScriptAST');             // 'TypeScript AST'
+ * ```
+ */
+export function camelCaseToTitleCase(text) {
+    // Step 1: Protect known acronyms with placeholders
+    // Add space marker after placeholder when followed by uppercase (word boundary)
+    let result = text;
+    const placeholders = [];
+    for (const acronym of KNOWN_ACRONYMS) {
+        // Case-sensitive match for acronyms
+        if (result.includes(acronym)) {
+            const placeholder = `__ACRONYM_${placeholders.length}__`;
+            placeholders.push({ placeholder, acronym });
+            const escapedAcronym = acronym.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            // Replace acronym with placeholder:
+            // 1. When preceded by lowercase and followed by uppercase: add spaces both sides
+            result = result.replace(new RegExp('([a-z])' + escapedAcronym + '([A-Z])', 'g'), '$1 ' + placeholder + ' $2');
+            // 2. When followed by uppercase only: add space after
+            result = result.replace(new RegExp(escapedAcronym + '([A-Z])', 'g'), placeholder + ' $1');
+            // 2b. When followed by digit: add space after (PDR006 → PDR 006)
+            result = result.replace(new RegExp(escapedAcronym + '(\\d)', 'g'), placeholder + ' $1');
+            // 3. When preceded by lowercase only: add space before
+            result = result.replace(new RegExp('([a-z])' + escapedAcronym + '(?![A-Za-z])', 'g'), '$1 ' + placeholder);
+            // 4. Standalone occurrences (start of string, or between non-letters)
+            result = result.replace(new RegExp('(?<![A-Za-z])' + escapedAcronym + '(?![A-Za-z])', 'g'), placeholder);
+        }
+    }
+    // Step 2: Apply standard CamelCase splitting
+    result = result
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2') // HTTPServer → HTTP Server
+        .replace(/([a-z\d])([A-Z])/g, '$1 $2') // camelCase → camel Case
+        .replace(/([A-Z]+)(\d)/g, '$1 $2') // V2 → V 2 (only when followed by digit)
+        .replace(/(\d)([A-Z])/g, '$1 $2') // 006T → 006 T (digit-to-uppercase)
+        .replace(/(\d)(__ACRONYM_\d+__)/g, '$1 $2') // 006__ACRONYM__ → 006 __ACRONYM__
+        .replace(/-/g, ' ') // kebab-case → kebab case
+        .trim();
+    // Step 3: Restore acronyms from placeholders
+    for (const { placeholder, acronym } of placeholders) {
+        result = result.split(placeholder).join(acronym);
+    }
+    return result;
+}
+/**
+ * Normalize line endings from Windows CRLF to Unix LF.
+ *
+ * Used when processing text that may have been created on Windows systems
+ * or transferred through systems that preserve Windows line endings.
+ *
+ * @param text - Text that may contain CRLF line endings
+ * @returns Text with all CRLF sequences replaced by LF
+ *
+ * @example
+ * ```typescript
+ * normalizeLineEndings('line1\r\nline2\r\n'); // 'line1\nline2\n'
+ * normalizeLineEndings('already\nunix\n');    // 'already\nunix\n'
+ * ```
+ */
+export function normalizeLineEndings(text) {
+    return text.replace(/\r\n/g, '\n');
+}
+/**
+ * Extract the first sentence from a text string.
+ *
+ * Finds sentence-ending punctuation (.!?) followed by whitespace + uppercase
+ * (new sentence) or end of string. Handles periods in file extensions correctly.
+ *
+ * @param text - Input text
+ * @returns First sentence, or full trimmed text if no sentence boundary found
+ */
+export function extractFirstSentenceRaw(text) {
+    if (!text)
+        return '';
+    const sentenceEndPattern = /[.!?](?=\s+[A-Z]|\s*$)/;
+    const match = sentenceEndPattern.exec(text);
+    if (match) {
+        return text.slice(0, match.index + 1).trim();
+    }
+    return text.trim();
+}
+/**
+ * Extract a compact description preserving Problem/Solution structure.
+ *
+ * If the text uses `**Problem:**` / `**Solution:**` markers, extracts the
+ * first sentence from each section and combines them. Otherwise falls back
+ * to extractFirstSentence() behavior.
+ *
+ * @param text - Description text, possibly with Problem/Solution structure
+ * @returns Compact description preserving both halves if structured
+ */
+export function extractDescription(text) {
+    if (!text)
+        return '';
+    const problemMatch = /\*\*Problem:\*\*\s*([\s\S]+?)(?=\*\*Solution:\*\*|$)/.exec(text);
+    const solutionMatch = /\*\*Solution:\*\*\s*([\s\S]+?)(?=\n\s*\*\*[A-Z]|\n\n\s*\n|$)/.exec(text);
+    if (problemMatch?.[1] !== undefined && solutionMatch?.[1] !== undefined) {
+        const problem = extractFirstSentenceRaw(problemMatch[1].trim());
+        const solution = extractFirstSentenceRaw(solutionMatch[1].trim());
+        return `Problem: ${problem} Solution: ${solution}`;
+    }
+    return extractFirstSentenceRaw(text);
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/utils/string-utils.js.map

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