fix(context): properly detect frontmatter and markdown sections

- Frontmatter must start at beginning of file (not mid-file ---)
- Detect both h1 (#) and h2 (##) headers as sections
- Fix type mismatch in sections slice ([]interface{} not []map)

Author: garyblankenship

internal/cli/context.go

@@ -85,8 +85,8 @@ func LintContext(rootPath string, quiet bool, verbose bool) (*LintSummary, error
 }
 
 // parseMarkdownSections parses markdown content into sections
-func parseMarkdownSections(content string) []map[string]interface{} {
-	var sections []map[string]interface{}
+func parseMarkdownSections(content string) []interface{} {
+	var sections []interface{}
 
 	// This is a simplified parser - in practice, would use a proper markdown parser
 	lines := []string{}
@@ -102,8 +102,19 @@ func parseMarkdownSections(content string) []map[string]interface{} {
 	for _, line := range lines {
 		line = strings.TrimSpace(line)
 
-		if strings.HasPrefix(line, "# ") {
-			// New section found
+		// Detect markdown headers (# or ##)
+		if strings.HasPrefix(line, "## ") {
+			// New h2 section found
+			if inSection {
+				sections = append(sections, currentSection)
+			}
+			currentSection = map[string]interface{}{
+				"heading": strings.TrimPrefix(line, "## "),
+				"content": "",
+			}
+			inSection = true
+		} else if strings.HasPrefix(line, "# ") {
+			// New h1 section found
 			if inSection {
 				sections = append(sections, currentSection)
 			}

internal/frontend/parser.go

@@ -12,12 +12,23 @@ type Frontmatter struct {
 	Body  string
 }
 
-// ParseYAMLFrontmatter extracts YAML frontmatter from markdown content
+// ParseYAMLFrontmatter extracts YAML frontmatter from markdown content.
+// Frontmatter must start at the beginning of the file with "---".
 func ParseYAMLFrontmatter(content string) (*Frontmatter, error) {
+	// Frontmatter must start at the very beginning of the file
+	trimmed := strings.TrimLeft(content, " \t")
+	if !strings.HasPrefix(trimmed, "---") {
+		// No frontmatter - return content as body
+		return &Frontmatter{
+			Data: make(map[string]interface{}),
+			Body: content,
+		}, nil
+	}
+
 	// Split content by ---
 	parts := strings.SplitN(content, "---", 3)
 
-	// If we have less than 3 parts, there's no frontmatter
+	// If we have less than 3 parts, there's no closing ---
 	if len(parts) < 3 {
 		return &Frontmatter{
 			Data: make(map[string]interface{}),