From d394ced20ffef84f87b4676c6eafd3e00c065baa Mon Sep 17 00:00:00 2001
From: Scrum4Me Agent <30029041+madhura68@users.noreply.github.com>
Date: Fri, 8 May 2026 12:38:02 +0200
Subject: [PATCH] ST-cmowjelb1: Parser: bestand-relatieve regel + hint-detectie
 in YAMLParseError-tak
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Voeg `hint?: string` toe aan PlanParseError type
- Bereken bestand-relatief regelnummer (yamlLine + 1 voor de openings-`---`)
- Detecteer markdown-patronen (numbered/bullet lijst) op de offending regel
- Zet Nederlandstalige hint bij markdown-match
- Render hint als "Tip: …" onder het foutbericht in IdeaMdEditor
---
 components/ideas/idea-md-editor.tsx |  5 +++++
 lib/idea-plan-parser.ts             | 23 ++++++++++++++++-------
 2 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/components/ideas/idea-md-editor.tsx b/components/ideas/idea-md-editor.tsx
index 1d7c46e..01488a6 100644
--- a/components/ideas/idea-md-editor.tsx
+++ b/components/ideas/idea-md-editor.tsx
@@ -123,6 +123,11 @@ export function IdeaMdEditor({ ideaId, kind, initialValue, onCancel }: Props) {
               <li key={i}>
                 {err.line ? `Regel ${err.line}: ` : ''}
                 {err.message}
+                {err.hint && (
+                  <span className="block mt-0.5 text-status-blocked/80">
+                    Tip: {err.hint}
+                  </span>
+                )}
               </li>
             ))}
           </ul>
diff --git a/lib/idea-plan-parser.ts b/lib/idea-plan-parser.ts
index 02b968b..b8202b9 100644
--- a/lib/idea-plan-parser.ts
+++ b/lib/idea-plan-parser.ts
@@ -13,7 +13,7 @@ import {
   type IdeaPlanFrontmatter,
 } from '@/lib/schemas/idea'
 
-export type PlanParseError = { line?: number; message: string }
+export type PlanParseError = { line?: number; message: string; hint?: string }
 
 export type PlanParseResult =
   | { ok: true; plan: IdeaPlanFrontmatter; body: string }
@@ -43,14 +43,23 @@ export function parsePlanMd(md: string): PlanParseResult {
     parsed = parseYaml(frontmatterRaw)
   } catch (err) {
     if (err instanceof YAMLParseError) {
+      const yamlLine = err.linePos?.[0]?.line
+      const fileLine = yamlLine != null ? yamlLine + 1 : undefined
+      const offendingLine =
+        yamlLine != null
+          ? frontmatterRaw.split(/\r?\n/)[(yamlLine ?? 1) - 1]
+          : undefined
+      const isMarkdown =
+        offendingLine != null &&
+        (/^\s*\d+\.\s+\*\*/.test(offendingLine) ||
+          /^\s*[-*]\s+\*\*/.test(offendingLine) ||
+          /^\s*\d+\..*:/.test(offendingLine))
+      const hint = isMarkdown
+        ? 'Lijkt op markdown-content (genummerde of opsommingslijst) binnen YAML-frontmatter. Verplaats deze regels naar na de afsluitende `---`, of zet ze in een `description: |` blok.'
+        : undefined
       return {
         ok: false,
-        errors: [
-          {
-            line: err.linePos?.[0]?.line,
-            message: err.message,
-          },
-        ],
+        errors: [{ line: fileLine, message: err.message, hint }],
       }
     }
     return {