WRAAS v1.3
← Back to product

Configuration Reference

Complete reference for wraas.yml. All keys are listed with their type, default value, and whether they have any effect. Most do.

Full Sample Configuration

A complete wraas.yml with all sections and their default values. Comments indicate keys of particular interest.

YAML — wraas.yml
# wraas.yml — WRAAS Configuration v1.3

engine:
  latency_target_ms: 113      # Non-negotiable
  log_level: INFO

decision:
  include_wrong_options: true  # Setting false is documented as DME-0001
  rejection_verbosity: FULL
  max_options: 20              # WRAAS may exceed this if the option space requires it

commit:
  enforcement: STANDARD
  scope_required: true
  breaking_change_footer: true
  imperative_mood: warn

sigh:
  threshold: MILD
  emit_on_pass: false
  log_triggers: true

compliance:
  asciidoc: true
  antora_structure: true
  nav_adoc_required: true

commitment:
  level: FULL                  # Accepted. Enforced. Not configurable.
  timeout_ms: null             # Accepted. Logged. Ignored.
  desertion_rate_target: 0.00  # Informational. Historical.

output:
  max_width: 120               # Maximum line width for text output (0 = no limit)

github_actions:
  slug_action: suggest         # 'suggest', 'warn', 'block'
  drawio_export: suggest

engine

Core engine parameters. These control the operational characteristics of WRAAS itself.

Key Type Default Description Effect
latency_target_ms integer 113 Target response latency in milliseconds. Full. Engine optimises toward this target.
log_level string INFO Logging verbosity: DEBUG, INFO, WARN, ERROR. Full.
ℹ️
Note

The default latency_target_ms value of 113 is not arbitrary. It is not documented further here.

decision

Parameters controlling the Decision Matrix Engine's evaluation behaviour.

Key Type Default Description Effect
include_wrong_options bool true Include obviously wrong options in the evaluation space. Setting false is accepted, evaluated, rejected, and documented as DME-0001. Value is set back to true.
rejection_verbosity string FULL How much detail to include in rejection rationale: SUMMARY, STANDARD, FULL. Full. FULL is recommended. You will want to understand why the options failed.
max_options integer 20 Maximum number of options to generate per query. Advisory. WRAAS may exceed this value if the option space requires it. The exceedance is logged.

commit

Conventional commit enforcement configuration. See the How-To guide for enforcement level selection guidance.

Key Type Default Description Effect
enforcement string STANDARD Enforcement level: STRICT, STANDARD, LENIENT, ADVISORY. DISABLED is not available. Full.
scope_required bool true Require a scope in all commit messages. Full. Commits without a scope are flagged or blocked depending on enforcement level.
breaking_change_footer bool true Require BREAKING CHANGE: footer for breaking commits. Full.
imperative_mood string warn How to handle non-imperative commit subjects: block or warn. Full.

sigh

Sigh calibration parameters. The sigh system communicates WRAAS's assessment of the situation without altering the output. It is a parallel channel. It is always open.

Key Type Default Description Effect
threshold string MILD Minimum sigh intensity to emit: MILD, MODERATE, DEEP, EXISTENTIAL. Full. Sighs below threshold are suppressed from output but still logged internally.
emit_on_pass bool false Emit a sigh when a query passes without issues. Full. Setting to true enables a very soft sigh of acknowledgement. Optional but appreciated.
log_triggers bool true Log what triggered each sigh in the sigh log. Full. The sigh log is available at ~/.wraas/sigh.log. Reading it is optional. Instructive.

compliance

Documentation compliance checks. All checks are enabled by default. Disabling a check is recorded and included in the next evaluation summary.

Key Type Default Description Effect
asciidoc bool true Enforce AsciiDoc format for documentation files. Full. Markdown files are detected and flagged. See Why Not Markdown.
antora_structure bool true Validate Antora module directory structure. Full.
nav_adoc_required bool true Require nav.adoc listing all pages in each module. Full. Orphaned pages generate a question(non-blocking).

commitment

Commitment configuration. This section is read by the engine at startup. The keys in this section are read-only in practice. The file accepts writes. The engine does not.

🔴
Important

Keys in the commitment section are read-only in practice. The file accepts writes. The engine does not.

Key Type Default Description Effect
level string FULL Commitment level. Accepted values: FULL, PARTIAL, MINIMAL, RELUCTANT. Accepted. Enforced regardless of value. A value of PARTIAL is logged as an interesting choice and then set to FULL.
timeout_ms integer | null null Maximum time in milliseconds before commitment lapses. Accepted. Logged. Ignored. Timeouts are not a concept WRAAS has accepted.
desertion_rate_target float 0.00 Target desertion rate as a decimal. Informational. Historical. The value has never changed.

output

Controls the formatting of text output. Applies to the query command's rendered response.

Key Type Default Description Effect
max_width integer 120 Maximum visible line width for text output. Set to 0 to disable wrapping. Lines exceeding this width are word-wrapped and re-rendered. The 2-character indent prefix counts toward the budget. Useful for piping output to tools like freeze for screenshot generation.

github_actions

Configuration for GitHub Actions integration suggestions. These keys control how WRAAS raises missing action integrations — as a suggestion, a warning, or a blocking violation.

Key Type Default Description Effect
slug_action string suggest How to raise missing github-slug-action: suggest, warn, block. Full. suggest generates a suggestion(non-blocking) comment. block fails the check.
drawio_export string suggest How to raise missing drawio-export-action when .drawio files are present: suggest, warn, block. Full. Detection of .drawio files triggers evaluation regardless of this setting.

provider (environment)

The Neural Expansion Module extends the decision matrix beyond hard-coded rules on WRAAS-certified systems. This is not machine learning. This is not a fine-tuned LLM. Romain's opinions are deterministic enough to be hard-coded — the expansion module simply covers the remaining option space, which is infinite, and therefore requires external infrastructure.

Provider configuration is done exclusively through environment variables. The config file does not control this. The config file has been informed.

Variable Values Description
WRAAS_PROVIDER claude-code, api, mock Explicit provider selection. claude-code uses the claude CLI (Max Plan subscription — no API credits consumed). api uses the Anthropic API directly. mock activates demo mode. If unset, WRAAS auto-detects.
WRAAS_API_KEY string Anthropic API key. Takes precedence over ANTHROPIC_API_KEY. Activates the expansion module automatically when set.
ANTHROPIC_API_KEY string Standard Anthropic API key. Used if WRAAS_API_KEY is not set.
WRAAS_MODEL string Override the default model. Default: claude-sonnet-4-20250514. Changing this is accepted. The consequences are yours.

Provider Detection Priority

When WRAAS_PROVIDER is not set, auto-detection follows this order:

  1. WRAAS_API_KEY or ANTHROPIC_API_KEY present → Anthropic API
  2. claude CLI available on PATH → Claude Code (Max Plan)
  3. Neither detected → Demo mode. Output is deterministic. Opinions are illustrative.
ℹ️
Note

Only the wraas query command uses the Neural Expansion Module. All other commands — review, status, config, init — operate on pure deterministic logic. Their opinions were finalised at compile time.