chore: add agent workflow seam (#778)

* chore: add agent workflow seam

* Fix agent workflow command coverage

* Simplify agent workflow build wrapper

* Manage renderer for agent workflow tests

* Prepare renderer before agent workflow tests

* Align renderer URL with test port

Author: justin808

.agents/agent-workflow.yml

@@ -0,0 +1,12 @@
+---
+base_branch: master
+follow_up_prefix: 'Follow-up:'
+review_gate: n/a
+approval_exempt: n/a
+coordination_backend: n/a
+changelog: n/a
+benchmark_labels: n/a
+merge_ledger: n/a
+ci_parity_environment: n/a
+hosted_ci_trigger: n/a
+ci_change_detector: n/a

.agents/bin/README.md

@@ -0,0 +1,18 @@
+# Agent Workflow Scripts
+
+<!-- Generated by shakacode/agent-workflows agent-workflow-seam-doctor --init. -->
+
+Standard entry points that portable agent-workflow skills call. A script that
+is absent means that capability is n/a in this repository.
+
+| Script | Purpose | This repo runs |
+| --- | --- | --- |
+| `setup` | Install dependencies | `bin/conductor-exec bin/setup --skip-server` |
+| `validate` | Pre-push gate | `bin/conductor-exec bin/rubocop` |
+| `test` | Run tests | `bin/conductor-exec bin/ci` |
+| `lint` | Lint / format | `bin/conductor-exec yarn lint:eslint` |
+| `build` | Build / type-check | generate React on Rails packs, build ReScript, then `bin/conductor-exec yarn build:test` |
+| `docs` | Docs checks | n/a |
+| `ci-detect` | CI change detector | n/a |
+
+Non-command policy lives in [`../agent-workflow.yml`](../agent-workflow.yml).

.agents/bin/build

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# Generated by shakacode/agent-workflows agent-workflow-seam-doctor --init.
+set -euo pipefail
+cd "$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
+
+exec bin/conductor-exec yarn build:test "$@"

.agents/bin/lint

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Generated by shakacode/agent-workflows agent-workflow-seam-doctor --init.
+set -euo pipefail
+cd "$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
+exec bin/conductor-exec yarn lint:eslint "$@"

.agents/bin/setup

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Generated by shakacode/agent-workflows agent-workflow-seam-doctor --init.
+set -euo pipefail
+cd "$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
+exec bin/conductor-exec bin/setup --skip-server "$@"

.agents/bin/test

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# Generated by shakacode/agent-workflows agent-workflow-seam-doctor --init.
+set -euo pipefail
+cd "$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
+
+renderer_port="${RENDERER_PORT:-3800}"
+if [[ -n "${RENDERER_PORT:-}" && -z "${RENDERER_URL:-}" ]]; then
+  export RENDERER_URL="http://localhost:$renderer_port"
+fi
+renderer_started=false
+renderer_pid=''
+
+cleanup_renderer() {
+  local status=$?
+
+  if [[ "$renderer_started" == true ]] && kill -0 "$renderer_pid" 2>/dev/null; then
+    kill "$renderer_pid" 2>/dev/null || true
+    wait "$renderer_pid" 2>/dev/null || true
+  fi
+
+  exit "$status"
+}
+
+trap cleanup_renderer EXIT
+
+bin/conductor-exec bin/setup --skip-server
+
+if nc -z localhost "$renderer_port" 2>/dev/null; then
+  echo "Reusing existing Node renderer on port $renderer_port."
+else
+  bin/conductor-exec node renderer/node-renderer.js &
+  renderer_pid=$!
+  renderer_started=true
+
+  echo "Waiting for Node renderer (PID $renderer_pid) on port $renderer_port..."
+  for _ in $(seq 1 30); do
+    if ! kill -0 "$renderer_pid" 2>/dev/null; then
+      echo "Node renderer exited unexpectedly (see output above)." >&2
+      exit 1
+    fi
+    if nc -z localhost "$renderer_port" 2>/dev/null; then
+      break
+    fi
+    sleep 1
+  done
+
+  if ! nc -z localhost "$renderer_port" 2>/dev/null; then
+    echo "Node renderer failed to start on port $renderer_port within 30 seconds (see output above)." >&2
+    exit 1
+  fi
+fi
+
+bin/conductor-exec bin/ci

.agents/bin/validate

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Generated by shakacode/agent-workflows agent-workflow-seam-doctor --init.
+set -euo pipefail
+cd "$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
+exec bin/conductor-exec bin/rubocop "$@"

.agents/trusted-github-actors.yml

@@ -0,0 +1,5 @@
+---
+trusted_users: []
+trusted_bots: []
+trusted_metadata_bots: []
+trusted_teams: []

AGENTS.md

@@ -58,3 +58,9 @@ bin/conductor-exec git commit -m "message"
 
 The wrapper uses `mise exec` when mise is available and falls back to direct execution
 for non-mise users.
+
+## Agent Workflow Configuration
+
+Portable shared skills resolve this repo's commands and policy through:
+- **Commands** — run `.agents/bin/<name>` (`setup`, `validate`, `test`, ...); see `.agents/bin/README.md`. A missing script means that capability is n/a here.
+- **Policy / config** — `.agents/agent-workflow.yml`.