/gaia-config-test

user-facing
Category:
Configuration
Lifecycle phase:
4 -- Implementation
Arguments:
[--tier <1|2|3>] [--placement <local|ci-pre-merge|ci-post-merge|deployment|post-deploy>]

What it does

/gaia-config-test edits the test_execution section of .gaia/config/project-config.yaml. The test_execution section maps the three test tiers (tier_1, tier_2, tier_3) to pipeline placements (local, ci-pre-merge, ci-post-merge, deployment, post-deploy). The editor preserves all YAML comments and formatting outside the edited section. Every edit goes through a diff preview and confirmation gate before writing.

When to use it

  • You need to add, remove, or modify entries in the test_execution configuration section.
  • You set up a new project and need to configure the test_execution section.

Prerequisites

  • project-config.yaml must exist. Run /gaia-init to create one if missing.

How to invoke

/gaia-config-test
/gaia-config-test --tier 1
/gaia-config-test --tier 2 --placement ci-pre-merge

What it does step by step

  1. Locate project-config.yaml Resolves the configuration file path.
  2. Extract the test_execution section Reads the current test_execution block. If the section is missing, offers to scaffold a default.
  3. Present edit menu Shows the current test_execution configuration and an operation menu (add, remove, edit, view, exit).
  4. Apply operation Collects the new values and validates them. Placement values must be one of: local, ci-pre-merge, ci-post-merge, deployment, post-deploy.
  5. Diff preview and confirmation Shows a unified diff of what will change. You must confirm before anything is written.
  6. Write back Writes only the modified section, preserving all other content byte-for-byte.
  7. Suggest validation Recommends running /gaia-config-validate to confirm the file still passes schema validation.

Inputs

InputSourceDescriptionExample
--tierArgument (optional)Tier to edit (1, 2, or 3)./gaia-config-test --tier 1
--placementArgument (optional)Placement value: local, ci-pre-merge, ci-post-merge, deployment, or post-deploy./gaia-config-test --placement local

Outputs

OutputLocationDescription
Updated test_execution section.gaia/config/project-config.yamlThe modified test_execution configuration.

Example session

> /gaia-config-test

Current test_execution configuration:
  tier_1:
    placement: local
    runner: vitest

Operations: [s] set key  [r] remove key  [v] view  [x] exit
> s

Key: e2e.adapter
Value: playwright-e2e

Diff preview:
  test_execution:
    tier_1:
      placement: local
      runner: vitest
  + e2e:
  +   adapter: playwright-e2e

Apply this edit? [y/n]
> y

Test_execution section updated. Run /gaia-config-validate to verify.

What to run next

Troubleshooting

test_execution section not found

The section does not exist in your config file. The command offers to scaffold a default: 

test_execution:
  tier_1:
    placement: local
  tier_2:
    placement: ci-pre-merge
  tier_3:
    placement: ci-post-merge

Edit cancelled

You chose not to apply the edit. The file remains unchanged.