# Table: `host_aliases`

Stores aliases for canonical hosts. Aliases are retained after retirement for audit and collision prevention.

## Columns

| Column | Type | Null | Default | Notes |

|--------|------|------|---------|-------|

| `alias_name` | `TEXT` | no | none | Alias DNS name or short alias. |

| `host_fqdn` | `TEXT` | no | none | Target host. References `hosts(fqdn)`. |

| `alias_kind` | `TEXT` | no | `'declared'` | `declared`, `derived`, or `derived-vhost`. |

| `status` | `TEXT` | no | `'active'` | Alias lifecycle state. |

| `is_dns_published` | `INTEGER` | no | `1` | Whether this alias should appear in generated DNS exports. |

| `created_at` | `TEXT` | no | none | ISO UTC creation timestamp. |

| `retired_at` | `TEXT` | yes | `NULL` | ISO UTC retirement timestamp. |

| `notes` | `TEXT` | no | `''` | Operator notes. |

## Keys And Indexes

- Primary key: `(alias_name, host_fqdn)`

- Unique partial index: `idx_host_aliases_active_name` on `alias_name` where `status = 'active'`

- Lookup index: `idx_host_aliases_host_status` on `(host_fqdn, status)`

## Relationships

- `host_fqdn` references `hosts(fqdn)` with `ON UPDATE CASCADE ON DELETE RESTRICT`

## Rules

- A retired alias is not deleted; `status` changes to `retired` and `is_dns_published` is set to `0`.

- One active alias can point to only one host.

- Derived short names such as `baobab` are persisted with `alias_kind = 'derived'`.

- Derived vhost short names such as `pmx.baobab` are persisted with `alias_kind = 'derived-vhost'`.

## Definition

```sql

CREATE TABLE IF NOT EXISTS host_aliases (

    alias_name TEXT NOT NULL,

    host_fqdn TEXT NOT NULL,

    alias_kind TEXT NOT NULL DEFAULT 'declared',

    status TEXT NOT NULL DEFAULT 'active',

    is_dns_published INTEGER NOT NULL DEFAULT 1,

    created_at TEXT NOT NULL,

    retired_at TEXT,

    notes TEXT NOT NULL DEFAULT '',

    PRIMARY KEY (alias_name, host_fqdn),

    FOREIGN KEY (host_fqdn) REFERENCES hosts(fqdn) ON UPDATE CASCADE ON DELETE RESTRICT

);

CREATE UNIQUE INDEX IF NOT EXISTS idx_host_aliases_active_name

ON host_aliases(alias_name)

WHERE status = 'active';

CREATE INDEX IF NOT EXISTS idx_host_aliases_host_status

ON host_aliases(host_fqdn, status);

```