# Codebase Context

## Purpose
Rhedyn is a small static site generator/asset pipeline. It reads a config file,
runs tasks (optionally in parallel per step), and writes outputs to `opts.outDir`
with caching based on file hashes and state access.

## Entry Point and Flow
- `src/index.js` is the CLI entrypoint. It loads config (user or defaults),
  then iterates through steps in `tasks`, running each task group in parallel.
- `src/lib.js` owns config loading, task expansion (file/state), caching, and
  the task runner that calls action functions.

## Configuration (current shape)
- `src/defaults.js` exports `tasks` and `opts` used by `src/index.js`.
- Tasks are objects (or arrays of objects for parallelism) with:
  - `jobConfig` for file/state selection, expansion, output paths, and caching
  - `actionConfig` for action-specific options
  - `action` function and a `name`
- Global config under `opts` controls output/cache dirs, logging, and site meta.

## Task Expansion
- File-based tasks expand input files via glob patterns (`readFilesByGlob`),
  driven by `jobConfig.inputFiles`.
- State-based tasks expand via selectors into `meta.resources`, with optional
  pagination and auto-built output paths from `jobConfig` settings.
- Tasks can opt out of expansion (`expand: false`) to run once with aggregated
  inputs.

## Caching
- `src/cache.js` stores cache files per job. Cache keys are based on job IDs,
  file hashes, and accessed state paths.
- `createTrackedObject` wraps state/config so accessed properties are tracked
  and used as cache dependencies.

## Actions
- `src/actions/` contains built-ins:
  - `compileSass`, `renderMarkdownToHtml`, `renderTemplate`,
    `renderMarkdownWithTemplate`, `optimiseSvg`, `copy`, `imageToWebP`,
    `generateFavicons`, `generateTaxonomy`.
- Actions receive `{ config, jobConfig, meta }` and return
  `{ detail, paths, deps, ref }`. The `config` value maps to `actionConfig`.
- Returned `ref` results are exposed via `meta.resources` for later tasks.

## Utilities
- `src/util/*` provides filesystem helpers, path manipulation, and simple
  object/state utilities.
- `src/logging.js` formats log output and implements log levels.