CLI

# Recommended — isolated, no venv juggling:
uv tool install aethis-cli

# Or, with pipx:
pipx install aethis-cli

# Or in a venv:
python -m venv .venv && source .venv/bin/activate
pip install aethis-cli

aethis decide \
  -b aethis/uk-fsm/child-eligibility \
  -i '{"child.age": 10, "child.school_type": "state_funded"}'

Decision:  eligible
Fields:    2 provided, 2 evaluated

aethis decide \
  -b aethis/uk-fsm/child-eligibility \
  -i '{"child.age": 10, "child.school_type": "independent"}' \
  --explain

Decision:  not_eligible

Explanation:
  school_type_check  FAIL — school_type must be state_funded (Regulation 3, Education Act 1996 s.512ZA)

# Inspect the fields a ruleset expects
aethis fields -b aethis/uk-fsm/child-eligibility

Fields for aethis/uk-fsm/child-eligibility

  child.age          Int     Age in whole years at start of academic year
  child.school_type  Enum    state_funded | independent | home_educated

# 1. Initialise a project (the wizard prompts for a name, runs sign-in, scaffolds)
mkdir my-rules && cd my-rules
aethis init

Initialised project in /Users/you/my-rules/.aethis/
  aethis.yaml         project config
  sources/            put your policy documents here
  guidance/hints.yaml guidance hints (optional)
  tests/scenarios.yaml test cases

# 2. Add source documents
cp policy.pdf .aethis/sources/
# or .md, .txt — any text format

# 3. Write test cases (see format below)
# 4. Generate rules
aethis generate

Uploading sources...   ✓  1 document
Uploading guidance...  ✓  0 hints
Triggering generation...
Polling...  ████████████████████  done (87s)

Ruleset generated: income_eligibility:20260416-f3a1b2c3

# 5. Run tests
aethis test

Running 4 test cases against income_eligibility:20260416-f3a1b2c3

  PASS  Below threshold — eligible
  PASS  Above threshold — not eligible
  FAIL  Edge case — at exact threshold
        Expected: eligible   Got: not_eligible
        Hint: the threshold condition may be using strict < rather than ≤

1 failure. Run `aethis generate` after adding guidance.

# 6. Add guidance and regenerate
#    Edit .aethis/guidance/hints.yaml (see format below), then re-run generate:
aethis generate && aethis test

Ruleset generated: income_eligibility:20260416-g4b2c3d4
Running 4 test cases...  4/4 passing ✓

# 7. Publish
aethis publish

Published: income_eligibility:20260416-g4b2c3d4 (v2)
Tests:     4/4 passing
Previous:  income_eligibility:20260416-f3a1b2c3 → deprecated

my-rules/
└── .aethis/
    ├── aethis.yaml          # project config
    ├── state.json           # tracked IDs — auto-updated, commit this
    ├── sources/             # policy documents (PDF, MD, TXT)
    ├── guidance/
    │   └── hints.yaml       # guidance hints
    └── tests/
        └── scenarios.yaml   # test cases

project: my-rules
api_key_env: AETHIS_API_KEY

hints:
  - process_type: rule_generation
    guidance_text: >
      The £30,000 threshold is inclusive — an applicant with exactly £30,000
      annual income qualifies. Use ≤ not <.

  - process_type: field_extraction
    guidance_text: >
      All income fields represent annual gross income in whole pounds sterling.
      Do not use monthly or weekly figures.

tests:
  - name: "Below threshold — eligible"
    inputs:
      applicant.annual_income: 25000
    expect:
      outcome: eligible

  - name: "Above threshold — not eligible"
    inputs:
      applicant.annual_income: 35000
    expect:
      outcome: not_eligible

  - name: "Exactly at threshold — eligible"
    inputs:
      applicant.annual_income: 30000
    expect:
      outcome: eligible

python3 -c "from datetime import date; print(date(2025,4,13).toordinal())"
# → 739354

aethis --install-completion zsh    # or bash, fish, powershell