ansible-collection-dnd/README.md

rakestraw.dnd

An Ansible collection for installing and configuring the D&D transcript-processing pipeline on Ubuntu 26.04. The assembled pipeline role is available as rakestraw.dnd.pipeline and supports Ansible Core 2.18 or newer.

Release 0.1.0 contains the reviewed rakestraw.dnd_pipeline v0.1.0 snapshot and pins the Seriatim, Audita, Notarius, Scriptorium, and Narratio roles to their respective v0.1.0 releases.

The current development snapshot integrates Narratio v3.1.0, Notarius v0.8.1, Audita v2.0.1, and Scriptorium v0.15.0 through public standalone role pins. It includes the suite's Audita backend/profile configuration and Narratio and Notarius testing overlays. Narratio now selects the existing OpenRouter credential name for Scriptorium as well as Notarius; see the pipeline role's credential guidance for provisioning and retries. This does not replace or modify the published 0.1.0 release artifact. Review the pipeline role migration notes before upgrading inventory or application-owned manifests; this collection does not convert existing manifests. Seriatim remains v1.5.0.

Install release 0.1.0

Download the tagged compatibility manifest and install its exact standalone role and collection dependencies:

curl -fLO \
  https://gitea.maximumdirect.net/eric/ansible-collection-dnd/raw/tag/v0.1.0/requirements.yml
ansible-galaxy install -r requirements.yml

Then install the published collection artifact without resolving dependencies a second time:

ansible-galaxy collection install \
  https://gitea.maximumdirect.net/eric/ansible-collection-dnd/releases/download/v0.1.0/rakestraw-dnd-0.1.0.tar.gz \
  --no-deps

Build from source

Maintainers can build the collection into a temporary directory after installing requirements.yml:

build_dir=$(mktemp -d)
ansible-galaxy collection build --output-path "$build_dir"
ansible-galaxy collection install \
  "$build_dir/rakestraw-dnd-0.1.0.tar.gz" --no-deps

Use

---
- name: Install the D&D transcript-processing pipeline
  hosts: pipeline_hosts
  gather_facts: true
  roles:
    - role: rakestraw.dnd.pipeline
      vars:
        dnd_pipeline_whisperx_transcribe_url: https://whisperx.example/transcribe

Maintain the pipeline snapshot

ansible-role-dnd-pipeline is authoritative. Make and review role changes there, then import the reviewed commit; do not edit roles/pipeline directly. The selected commit or immutable tag must be pushed to the authoritative repository before collection assembly. Replace PUSHED_COMMIT_OR_TAG below with that remote revision.

Initial import:

pipeline_revision=PUSHED_COMMIT_OR_TAG
git subtree add --prefix=roles/pipeline \
  https://gitea.maximumdirect.net/eric/ansible-role-dnd-pipeline.git \
  "$pipeline_revision" --squash

Subsequent update:

pipeline_revision=PUSHED_COMMIT_OR_TAG
git subtree pull --prefix=roles/pipeline \
  https://gitea.maximumdirect.net/eric/ansible-role-dnd-pipeline.git \
  "$pipeline_revision" --squash