# dagger

This directory contains the Nix package for a pinned dev build of `dagger`, the CLI for [Dagger](https://dagger.io).

Source: [`github.com/dagger/dagger`](https://github.com/dagger/dagger)

## Usage

```bash
dagger version
dagger --help
```

RSSBase uses Dagger's workspace/module config split:

- root [`../dagger.toml`](../dagger.toml) is the workspace config
- [`../application/dagger-module.toml`](../application/dagger-module.toml) is the application module config
- module code lives in [`../application/.dagger`](../application/.dagger)

From the repository root:

```bash
# Inspect workspace modules
dagger workspace
dagger installed

# List workspace entrypoints; currently this exposes the application module
dagger functions

# List and run checks declared with @check
dagger check --list
dagger check

# Build the production FrankenPHP image
dagger call application build-prod sync

# Validate Composer metadata
dagger call application composer-validate
```

Tip: set `DAGGER_NO_NAG=1` to hide the Dagger Cloud setup prompt in local runs:
```bash
DAGGER_NO_NAG=1 dagger call application php-version
```

## Updating

This package follows Dagger's dev-build endpoint, but pins a concrete commit and hashes for reproducibility.

Fetch the latest dev-build checksums:

```bash
curl -fsSL https://dl.dagger.io/dagger/main/head/checksums.txt
```

Then update `commit` and the platform hashes in `default.nix`.