flex-md 4.2.0 → 4.2.1

package/README.md

@@ -564,6 +564,38 @@ if (status === 'validated' || status === 'fixed') {
 2. **Type Enforcement**: Lists and Tables are automatically converted to JSON arrays and objects.
 3. **Single Source of Truth**: Use the same spec to guide the LLM AND parse its response.
 
+## Advanced AI Features (via NX-MD-Parser 1.4.0)
+
+Flex-MD utilizes the full power of `nx-md-parser` v1.4.0, providing enterprise-grade AI transformation capabilities.
+
+### 🤖 Multi-Algorithm Fuzzy Matching
+The engine uses a weighted combination of four powerful algorithms to find the best match for your headings and keys:
+- **Jaro-Winkler**: Character-level similarity (40%)
+- **Jaccard Tokens**: Token-based similarity (30%)
+- **Dice Coefficient**: N-gram similarity (20%)
+- **Levenshtein Ratio**: Edit distance (10%)
+
+### 🧠 Machine Learning (Learn Aliases)
+You can let the system learn from your data to improve matching over time.
+
+```typescript
+import { learnAliasesFromTransformations } from 'flex-md';
+
+const learningResult = learnAliasesFromTransformations([
+  {
+    input: { "Projct Name": "Test" },
+    output: { title: "Test" },
+    schema: yourSchema
+  }
+]);
+// System now knows "Projct Name" is an alias for "title"
+```
+
+### ⚙️ Intelligent Auto-Fixing
+- **Typo Correction**: Automatically fixes property name typos.
+- **Structural Repair**: Restructures flat objects into nested schemas.
+- **Smart Conversion**: Automatically handles `string -> number`, `string -> boolean`, and wrapper types.
+
 ## Spec Memory: Remember & Recall
 
 Flex-MD includes an in-memory storage feature that allows you to "remember" an Output Format Spec and later reuse it by a unique `recallId`. This is especially useful for maintaining state within a single execution environment.

package/dist/pipeline/kind.js

@@ -2,8 +2,11 @@ import { isIssuesEnvelopeCheck } from "../md/parse.js";
 export function detectResponseKind(text, spec) {
     const issuesResult = isIssuesEnvelopeCheck(text);
     const hasIssues = issuesResult.isIssuesEnvelope;
+    // Use more robust detection: check for both #+ Name and ===Name
     const hasSections = spec.sections.some(s => {
-        const rx = new RegExp(`^#+\\s+${s.name}`, "im");
+        // Escape special chars in name but match case-insensitively and with flexible whitespace
+        const escapedName = s.name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const rx = new RegExp(`^((?:#{1,6}\\s+${escapedName})|(?:===${escapedName}))\\s*$`, "im");
         return rx.test(text);
     });
     const isRawJson = /^\s*(\{|\[)/.test(text.trim()) && /\s*(\}|\])$/.test(text.trim());

package/dist/validate/validate.js

@@ -248,13 +248,21 @@ export function validateMarkdownAgainstOfs(input, spec, level, policyOverride) {
             }
         }
     }
+    // Compute detectedKind more robustly: if we found more than zero sections, it's at least sectioned
+    let detectedKind = "markdown";
+    if (level >= 2) {
+        detectedKind = fencesAll.length > 0 ? "fenced" : (parsed.length > 0 ? "sectioned" : "markdown");
+    }
+    else {
+        detectedKind = parsed.length > 0 ? "sectioned" : "markdown";
+    }
     const ok = !issues.some(i => i.severity === "error");
     return {
         ok,
         level,
         issues,
         stats: {
-            detectedKind: level >= 2 ? (fencesAll.length ? "fenced" : "markdown") : (parsed.length ? "sectioned" : "markdown"),
+            detectedKind,
             sectionCount: occurrences.size,
             missingRequired,
             duplicates,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flex-md",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "Parse and stringify FlexMD: semi-structured Markdown with three powerful layers - Frames, Output Format Spec (OFS), and Detection/Extraction.",
   "license": "MIT",
   "author": "",