repo-native-alignment: Agent for Claude Code

/gen-extractor

Generate .oh/extractors/*.toml config files that teach RNA to detect Produces/Consumes edges for message brokers, event buses, and other boundary patterns.

Usage

/gen-extractor "detect Google Pub/Sub in Python — publisher.publish(topic_path) and subscriber.subscribe(subscription_path, callback)"
/gen-extractor "detect Redis pub/sub in Python — r.publish(channel, message) and r.subscribe(channel)"
/gen-extractor "detect RabbitMQ in Python — channel.basic_publish(exchange='', routing_key=topic, body=msg)"

Proactive mode — invoked without arguments: scans the repo for detected frameworks and flags gaps between what's detected and what's covered.

Config format

Every .oh/extractors/*.toml file must have this structure:

[meta]
name = "my-extractor"
applies_when = { language = "python", imports_contain = "some.library" }

[[boundaries]]
function_pattern = "client.publish"
arg_position = 0
edge_kind = "Produces"

[[boundaries]]
function_pattern = "client.subscribe"
arg_position = 0
edge_kind = "Consumes"

Fields:

• meta.name — kebab-case identifier, matches the filename without .toml
• meta.applies_when.language — exact language string as RNA stores it (e.g., "python", "go", "javascript", "typescript", "rust")
• meta.applies_when.imports_contain — substring that must appear in at least one Import node's body or name for this config to activate. Use the most specific stable prefix of the library path (e.g., "google.cloud.pubsub" matches google.cloud.pubsub_v1).
• boundaries[].function_pattern — substring of the call site to match, up to but NOT including (. RNA searches for function_pattern + "(" so "publisher.publish" matches publisher.publish( but not publisher.publish_to_dlq(.
• boundaries[].arg_position — zero-indexed position of the argument that holds the topic/channel name as a quoted string literal. Use 0 for the first argument, 1 for the second, etc. Both arg_position and topic_arg are accepted (aliases).
• boundaries[].edge_kind — "Produces" (this code publishes/sends to the channel) or "Consumes" (this code subscribes/receives from the channel).
• boundaries[].decorator — optional boolean, set true for decorator-based patterns (e.g., @bus.subscribe). Currently informational only — matching still uses body-text heuristics.