diff --git a/SPEC.md b/SPEC.md index 6fc4049..12355ff 100644 --- a/SPEC.md +++ b/SPEC.md @@ -452,10 +452,11 @@ Requirements: - Support configurable required fields via `fiona-settings.json` for different file types (e.g., `type: toc` files may have different requirements). - Report violations in AI-friendly format: file path, missing fields, and - line number (if frontmatter exists but is incomplete). + line number (if known). Violation messages use the format ` - `. + For frontmatter violations, line numbers are omitted as frontmatter is always + at the start of the file (line 1), so `1:1` prefix is redundant. - Handle files without frontmatter (report as missing all required fields). -- Handle files with malformed YAML frontmatter (report as parse error with - line number). +- Handle files with malformed YAML frontmatter (report as parse error). - Respect `.gitignore` and read-only zones (`personal/`, `raw/`). Acceptance criteria: diff --git a/src/mdoctor/fmlint.py b/src/mdoctor/fmlint.py index deb4046..0a9b4ca 100644 --- a/src/mdoctor/fmlint.py +++ b/src/mdoctor/fmlint.py @@ -69,37 +69,37 @@ VIOLATION_CODES = { "FML001": { "rule_name": "Frontmatter Parse Error", "description": "Failed to parse YAML frontmatter", - "message_template": "1:1 FML001 - {error}" + "message_template": "FML001 - {error}" }, "FML002": { "rule_name": "Missing Frontmatter", "description": "Markdown file is missing YAML frontmatter", - "message_template": "1:1 FML002 - No frontmatter found" + "message_template": "FML002 - No frontmatter found" }, "FML003": { "rule_name": "Missing Name Field", "description": "Required frontmatter field 'name' is missing", - "message_template": "1:1 FML003 - Missing required field: name" + "message_template": "FML003 - Missing required field: name" }, "FML004": { "rule_name": "Missing Description", "description": "SKILL.md files must have a description field in frontmatter", - "message_template": "1:1 FML004 - SKILL.md files must have a description field" + "message_template": "FML004 - SKILL.md files must have a description field" }, "FML005": { "rule_name": "Invalid Skill Name", "description": "Skill name must contain only lowercase letters, numbers, and hyphens (a-z, 0-9, -)", - "message_template": "1:1 FML005 - Skill name must contain only lowercase letters, numbers, and hyphens" + "message_template": "FML005 - Skill name must contain only lowercase letters, numbers, and hyphens" }, "FML006": { "rule_name": "Skill Name Mismatch", "description": "Skill name in frontmatter must match the parent folder name", - "message_template": "1:1 FML006 - Skill name must match parent folder name (expected: {expected}, got: {actual})" + "message_template": "FML006 - Skill name must match parent folder name (expected: {expected}, got: {actual})" }, "FML007": { "rule_name": "Missing Version Field", "description": "Required frontmatter field 'version' is missing", - "message_template": "1:1 FML007 - Missing required field: version" + "message_template": "FML007 - Missing required field: version" } }