@schnick371/devsteps-shared 1.1.0-next.4 → 2.0.0-next.1

package/dist/utils/normalize.test.js

@@ -1,101 +0,0 @@
-/**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
- * Licensed under the Apache License, Version 2.0
- *
- * Unit Tests for normalizeMarkdown utility
- *
- * Context: MCP clients (GitHub Copilot ≥ v1.0.0, Claude Code, etc.) transmit
- * multiline strings as literal escape sequences rather than real Unicode control
- * characters. normalizeMarkdown converts these safely at the ingestion boundary.
- *
- * @see BUG-056
- * @see TASK-270
- */
-import { describe, expect, it } from 'vitest';
-import { normalizeMarkdown } from './index.js';
-describe('normalizeMarkdown', () => {
-    // ── Core conversion ─────────────────────────────────────────────────────────
-    it('converts literal \\n sequences to real newlines', () => {
-        const input = 'line one\\nline two\\nline three';
-        const result = normalizeMarkdown(input);
-        expect(result).toBe('line one\nline two\nline three');
-        expect(result).toContain('\n');
-        expect(result).not.toContain('\\n');
-    });
-    it('converts literal \\t sequences to real tabs', () => {
-        const input = 'column1\\tcolumn2\\tcolumn3';
-        const result = normalizeMarkdown(input);
-        expect(result).toBe('column1\tcolumn2\tcolumn3');
-        expect(result).toContain('\t');
-        expect(result).not.toContain('\\t');
-    });
-    it('removes literal \\r sequences (stray CR from Windows \\r\\n literals)', () => {
-        const input = 'line one\\r\\nline two';
-        const result = normalizeMarkdown(input);
-        expect(result).toBe('line one\nline two');
-        expect(result).not.toContain('\\r');
-        expect(result).not.toContain('\r');
-    });
-    it('handles all escape sequences together', () => {
-        const input = 'Title\\n\\nParagraph one.\\n\\n- Item 1\\n- Item 2\\n\\n\\tIndented';
-        const result = normalizeMarkdown(input);
-        expect(result).toBe('Title\n\nParagraph one.\n\n- Item 1\n- Item 2\n\n\tIndented');
-    });
-    // ── Idempotency (fast path) ──────────────────────────────────────────────────
-    it('leaves strings with real newlines unchanged (fast path)', () => {
-        const input = 'line one\nline two\nline three';
-        const result = normalizeMarkdown(input);
-        expect(result).toBe(input);
-    });
-    it('is idempotent: calling twice on already-converted string returns same result', () => {
-        const original = 'line one\\nline two';
-        const once = normalizeMarkdown(original);
-        const twice = normalizeMarkdown(once);
-        expect(twice).toBe(once);
-    });
-    it('leaves strings with mixed real newlines and literal \\t unchanged (fast path)', () => {
-        const input = 'line one\nline two\\t still here';
-        const result = normalizeMarkdown(input);
-        // Real newline present → fast path, backslash-t preserved
-        expect(result).toBe(input);
-    });
-    // ── Edge cases ───────────────────────────────────────────────────────────────
-    it('returns empty string unchanged', () => {
-        expect(normalizeMarkdown('')).toBe('');
-    });
-    it('returns plain single-line string unchanged', () => {
-        const input = 'No escape sequences here.';
-        expect(normalizeMarkdown(input)).toBe(input);
-    });
-    it('handles markdown description with heading and list (typical MCP input)', () => {
-        // This is the real-world input that triggered BUG-056
-        const mcpInput = '## Implemented\\n\\n### Show-ServerLayoutEditor\\n- Build `nameToRoles` map before rendering table\\n- Rows with shared hostname → ForegroundColor Yellow + ⚠️ indicator\\n\\n### environment.ps1\\n- After saving: rebuild `$env.Nodes` PSCustomObject';
-        const result = normalizeMarkdown(mcpInput);
-        expect(result).toContain('## Implemented\n');
-        expect(result).toContain('### Show-ServerLayoutEditor\n');
-        expect(result).toContain('- Build `nameToRoles`');
-        expect(result).not.toContain('\\n');
-    });
-    it('handles default description template with real newlines (CLI usage)', () => {
-        // CLI users provide real newlines — must NOT be double-converted
-        const cliInput = '# My Story\n\n<!-- Add detailed description here -->\n';
-        const result = normalizeMarkdown(cliInput);
-        expect(result).toBe(cliInput);
-    });
-    it('handles string with only whitespace', () => {
-        expect(normalizeMarkdown('   ')).toBe('   ');
-        expect(normalizeMarkdown('\n')).toBe('\n'); // real newline → fast path
-    });
-    it('preserves Unicode characters correctly', () => {
-        const input = 'Emoji: ⚠️\\nArrow: →\\nUmlaut: äöü';
-        const result = normalizeMarkdown(input);
-        expect(result).toBe('Emoji: ⚠️\nArrow: →\nUmlaut: äöü');
-    });
-    // ── append_description use case ──────────────────────────────────────────────
-    it('normalizes text intended for append_description correctly', () => {
-        const appendContent = '\\n\\n## Added in v2\\n- New feature X\\n- Fixed issue Y';
-        const result = normalizeMarkdown(appendContent);
-        expect(result).toBe('\n\n## Added in v2\n- New feature X\n- Fixed issue Y');
-    });
-});
-//# sourceMappingURL=normalize.test.js.map

package/dist/utils/normalize.test.js.map

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