feat: define Seriatim role contract

meta/argument_specs.yml

@@ -0,0 +1,58 @@
+---
+argument_specs:
+  main:
+    short_description: Install the Seriatim transcript processor from source
+    options:
+      seriatim_version:
+        type: str
+        required: true
+        description: Release identity expected from the installed binary.
+      seriatim_repository_url:
+        type: str
+        required: true
+        description: Git repository containing Seriatim source.
+      seriatim_source_ref:
+        type: str
+        required: true
+        description: Git tag, branch, or commit to check out.
+      seriatim_build_version:
+        type: str
+        required: true
+        description: Version value injected into build metadata.
+      seriatim_source_dir:
+        type: path
+        required: true
+        description: Fully managed source checkout path.
+      seriatim_binary_path:
+        type: path
+        required: true
+        description: Installed executable path.
+      seriatim_build_state_dir:
+        type: path
+        required: true
+        description: Sidecar directory holding successful build state.
+      seriatim_manage_build_dependencies:
+        type: bool
+        required: true
+        description: Whether to install Git and Go.
+      seriatim_go_snap_channel:
+        type: str
+        required: true
+        description: Go Snap channel to install.
+      seriatim_go_binary:
+        type: path
+        required: true
+        description: Go executable used for discovery and builds.
+      seriatim_go_build_flags:
+        type: list
+        elements: str
+        required: true
+        description: Ordered arguments passed to go build before ldflags.
+      seriatim_go_ldflags:
+        type: str
+        required: true
+        description: Linker flags passed to go build as one argument.
+      seriatim_go_package:
+        type: str
+        required: true
+        description: Go package built from the source checkout.

meta/main.yml

@@ -0,0 +1,17 @@
+---
+galaxy_info:
+  role_name: seriatim
+  namespace: rakestraw
+  author: Eric Rakestraw
+  description: Install the Seriatim transcript processor from source
+  license: BSD-3-Clause
+  min_ansible_version: "2.18"
+  platforms:
+    - name: Ubuntu
+      versions:
+        - resolute
+  galaxy_tags:
+    - seriatim
+    - transcript
+    - processing
+dependencies: []