Module: Ace::Assign::Atoms::AssignFrontmatterParser

Defined in:

lib/ace/assign/atoms/assign_frontmatter_parser.rb

Overview

Pure function: extracts and validates ‘assign:` block from markdown frontmatter.

Takes a raw YAML frontmatter hash (already parsed from a .s.md or .wf.md file), extracts the ‘assign:` block, validates fields, and returns a structured result.

No file I/O — reuses existing frontmatter extraction from StepFileParser or ace-support-markdown.

Examples:

frontmatter = { "id" => "v.0.9.0+task.148", "status" => "in-progress",
                 "assign" => { "goal" => "implement-with-pr", "variables" => { "taskref" => "148" } } }
result = AssignFrontmatterParser.parse(frontmatter)
result[:config][:goal]  # => "implement-with-pr"
result[:valid]          # => true

Constant Summary

VALID_FIELDS =

%w[goal variables hints sub-steps context parent].freeze

VALID_HINT_ACTIONS =

%w[include skip].freeze

VALID_CONTEXTS =

%w[fork].freeze

Class Method Summary

• .parse(frontmatter) ⇒ Hash

  Parse and validate the assign: block from frontmatter.

Class Method Details

.parse(frontmatter) ⇒ Hash

Parse and validate the assign: block from frontmatter.

Parameters:

• frontmatter (Hash) —

  Full frontmatter hash from any .s.md or .wf.md file

Returns:

• (Hash) —

  { config: Hash|nil, valid: Boolean, errors: Array<String> }

# File 'lib/ace/assign/atoms/assign_frontmatter_parser.rb', line 28

def self.parse(frontmatter)
  return {config: nil, valid: true, errors: []} if frontmatter.nil? || !frontmatter.is_a?(Hash)

  assign_block = frontmatter["assign"]
  return {config: nil, valid: true, errors: []} if assign_block.nil?

  errors = validate(assign_block)
  return {config: nil, valid: false, errors: errors} if errors.any?

  config = extract_config(assign_block)
  {config: config, valid: true, errors: []}
end