Commands

init

Initialize a xtraq project with a tracked `.xtraqconfig` snapshot and minimal `.env` secrets. Bootstraps a `.env` file (or updates an existing one) with the generator connection string and logging toggles only, and writes a tracked `.xtraqconfig` snapshot for every non-sensitive default.

Usage

xtraq init [options]

Options

Flag	Description	Tracked Setting	Notes
`-p, --project-path <project-path>`	Target directory (defaults CWD)	n/a	Directory must exist or will be created (no parent fallback)
`-n, --namespace <name>`	Root namespace	`Namespace`	Optional override – CLI resolves automatically when omitted
`-c, --connection <cs>`	Snapshot connection string	`XTRAQ_GENERATOR_DB`	Stored in `.env`; use least-privilege account
`-s, --schemas <list>`	Comma separated allow-list	`BuildSchemas`	Example: `core,identity`
`-f, --force`	Overwrite existing `.env`	n/a	Recreates from template and refreshes `.xtraqconfig`
`-h, --help`	Show help	n/a

Behavior Contract

{
  "command": "init",
  "idempotent": true,
  "writes": [".env", ".env.example", ".xtraqconfig"],
  "reads": [".env", ".env.example"],
  "exitCodes": { "0": "Success", "2": "WriteFailure" },
  "sideEffects": ["Preserves unknown XTRAQ_* keys and updates provided values"]
}

Examples

# Minimal non-interactive initialization
xtraq init --connection "Server=.;Database=AppDb;Trusted_Connection=True;TrustServerCertificate=True;"

# Allow-list schemas and force recreate .env
xtraq init -n Acme.Product.Data -c "Server=.;Database=AppDb;Trusted_Connection=True;" -s core,identity --force

Notes