Module: Ace::Task::Atoms::TaskFilePattern

Defined in:
lib/ace/task/atoms/task_file_pattern.rb

Overview

Glob patterns and matching logic for task spec files. Tasks use .s.md extension but exclude .idea.s.md (ideas). Subtask files are distinguished from primary files by their ID suffix.

Constant Summary collapse

SPEC_PATTERN =

Pattern matching all spec files

"*.s.md"
IDEA_PATTERN =

Pattern to exclude idea spec files

"*.idea.s.md"
SUBTASK_ID_REGEX =

Subtask ID pattern: parent ID + dot + single char (e.g., "8pp.t.q7w.a")

/^([0-9a-z]{3}\.[a-z]\.[0-9a-z]{3})\.([a-z0-9])$/

Class Method Summary collapse

Class Method Details

.extract_id_from_filename(filename) ⇒ String?

Extract the task ID from a spec filename. "8pp.t.q7w-fix-login.s.md" → "8pp.t.q7w" "8pp.t.q7w.a-setup-db.s.md" → "8pp.t.q7w.a"

Parameters:

  • filename (String) —

    Spec filename

Returns:

  • (String, nil) —

    Extracted ID or nil



56
57
58
59
60
61
62
63
64
 
# File 'lib/ace/task/atoms/task_file_pattern.rb', line 56

def self.extract_id_from_filename(filename)
  # Remove .s.md extension
  base = filename.sub(/\.s\.md$/, "")
  return nil if base == filename # No .s.md extension

  # Match task ID at start: "8pp.t.q7w" or "8pp.t.q7w.a"
  match = base.match(/^([0-9a-z]{3}\.[a-z]\.[0-9a-z]{3}(?:\.[a-z0-9])?)/)
  match&.[](1)
end

.primary_file?(filename, folder_id) ⇒ Boolean

Check if a spec file is the primary file for its containing folder. The primary file's ID prefix matches the folder's ID prefix exactly. Subtask files have an additional .{char} suffix.

Parameters:

  • filename (String) —

    Spec filename (e.g., "8pp.t.q7w-fix-login.s.md")

  • folder_id (String) —

    ID extracted from folder name (e.g., "8pp.t.q7w")

Returns:

  • (Boolean) 


26
27
28
29
30
31
32
33
34
35
 
# File 'lib/ace/task/atoms/task_file_pattern.rb', line 26

def self.primary_file?(filename, folder_id)
  return false if filename.end_with?(".idea.s.md")

  # Extract ID from filename: "8pp.t.q7w-fix-login.s.md" → "8pp.t.q7w"
  # or subtask: "8pp.t.q7w.a-setup-db.s.md" → "8pp.t.q7w.a"
  file_id = extract_id_from_filename(filename)
  return false unless file_id

  file_id == folder_id
end

.subtask_file?(filename) ⇒ Boolean

Check if a spec file is a subtask file.

Parameters:

  • filename (String) —

    Spec filename

Returns:

  • (Boolean) 


41
42
43
44
45
46
47
48
 
# File 'lib/ace/task/atoms/task_file_pattern.rb', line 41

def self.subtask_file?(filename)
  return false if filename.end_with?(".idea.s.md")

  file_id = extract_id_from_filename(filename)
  return false unless file_id

  file_id.match?(SUBTASK_ID_REGEX)
end