Module: RailsAiContext::Confidence

Defined in:
lib/rails_ai_context/confidence.rb

Overview

Confidence tags for AST introspection results. Shared across tools and introspectors without creating cross-layer dependencies.

VERIFIED: value the gem can assert with certainty - runtime-confirmed data, or a static literal the AST resolves deterministically (see for_node). STATIC: derived from source files without a booted app - trustworthy structure, not runtime-confirmed. INFERRED: heuristic - dynamic expressions, metaprogramming, or runtime-only constructs the AST cannot fully resolve. UNAVAILABLE: the data source is absent entirely; the reasoned form says why.

Constant Summary collapse

VERIFIED = 
"[VERIFIED]"
INFERRED = 
"[INFERRED]"
STATIC = 
"[STATIC]"
UNAVAILABLE = 
"[UNAVAILABLE]"

Class Method Summary collapse

Class Method Details

.for_node(node) ⇒ Object

Determine confidence level for a Prism call node's arguments. Returns VERIFIED if all arguments are static literals, INFERRED if any argument is a dynamic expression.



31
32
33
34
35
36
37
 
# File 'lib/rails_ai_context/confidence.rb', line 31

def self.for_node(node)
  args = node.arguments&.arguments
  return VERIFIED unless args

  static = args.all? { |a| static_node?(a) }
  static ? VERIFIED : INFERRED
end

.static_node?(node) ⇒ Boolean

Recursively check if a node is a static literal.

Returns:

  • (Boolean) 


40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/rails_ai_context/confidence.rb', line 40

def self.static_node?(node)
  case node
  when Prism::SymbolNode, Prism::StringNode, Prism::IntegerNode,
       Prism::FloatNode, Prism::TrueNode, Prism::FalseNode,
       Prism::NilNode, Prism::ConstantReadNode, Prism::ConstantPathNode
    true
  when Prism::ArrayNode
    node.elements.all? { |e| static_node?(e) }
  when Prism::HashNode
    node.elements.all? { |e| e.is_a?(Prism::AssocNode) && static_node?(e.key) && static_node?(e.value) }
  when Prism::KeywordHashNode
    node.elements.all? { |e| e.is_a?(Prism::AssocNode) && static_node?(e.key) && static_node?(e.value) }
  else
    false
  end
end

.unavailable(reason) ⇒ Object

Reasoned unavailability tag: "[UNAVAILABLE: requires a booted Rails app]". Reasons are collapsed to their first line so a raised exception message can be passed through without flooding the tag.



24
25
26
 
# File 'lib/rails_ai_context/confidence.rb', line 24

def self.unavailable(reason)
  "[UNAVAILABLE: #{reason.to_s.lines.first.to_s.strip}]"
end