Class: Ace::Docs::Organisms::Validator

Inherits:
Object
  • Object
show all
Defined in:
lib/ace/docs/organisms/validator.rb

Overview

Validates documents against their declared rules

Instance Method Summary collapse

Constructor Details

#initialize(registry) ⇒ Validator

Returns a new instance of Validator.



8
9
10
# File 'lib/ace/docs/organisms/validator.rb', line 8

def initialize(registry)
  @registry = registry
end

Instance Method Details

#validate_document(document, syntax: true, semantic: false) ⇒ Hash

Validate a document against rules

Parameters:

  • document (Document)

    Document to validate

  • syntax (Boolean) (defaults to: true)

    Run syntax validation

  • semantic (Boolean) (defaults to: false)

    Run semantic validation

Returns:

  • (Hash)

    Validation results



17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# File 'lib/ace/docs/organisms/validator.rb', line 17

def validate_document(document, syntax: true, semantic: false)
  errors = []
  warnings = []

  # Check frontmatter validity
  if !document.managed?
    errors << "Missing required frontmatter fields"
  end

  # Check max lines rule
  if document.max_lines
    line_count = document.content.lines.count
    if line_count > document.max_lines
      errors << "Exceeds max lines: #{line_count}/#{document.max_lines}"
    end
  end

  # Check required sections
  if document.required_sections.any?
    missing_sections = check_sections(document)
    if missing_sections.any?
      errors << "Missing required sections: #{missing_sections.join(", ")}"
    end
  end

  # Syntax validation (would delegate to external linters)
  if syntax
    syntax_results = validate_syntax(document)
    errors.concat(syntax_results[:errors])
    warnings.concat(syntax_results[:warnings])
  end

  # Semantic validation (would use LLM)
  if semantic
    semantic_results = validate_semantic(document)
    errors.concat(semantic_results[:errors])
    warnings.concat(semantic_results[:warnings])
  end

  {
    valid: errors.empty?,
    errors: errors,
    warnings: warnings
  }
end