llm-wb 0.1.0-beta.0

package/scripts/00.chat/session-log/record-chat-commit/smoke-test.sh

@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.session-log.record-chat-commit.smoke-test
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: session-log
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Smoke test chat commit recording metrics and transcript discovery.
+#   portability:
+#     class: reusable
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.checklists.before-commit
+#     path: .agentic/00.chat/checklists/before-commit.md
+#   - id: chat.script.session-log.record-chat-commit.readme
+#     path: scripts/00.chat/session-log/record-chat-commit/README.md
+#   - id: chat.script.session-log.record-chat-commit
+#     path: scripts/00.chat/session-log/record-chat-commit/script.sh
+#   effects:
+#   - writes-files
+#   - branches
+#   - commits
+fail() {
+  echo "FAIL: $*" >&2
+  exit 1
+}
+
+SOURCE_ROOT="$(git rev-parse --show-toplevel)"
+TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/record-chat-commit-metrics-smoke.XXXXXX")"
+
+cleanup() {
+  rm -rf "$TMP_ROOT"
+}
+
+trap cleanup EXIT
+
+REPO="$TMP_ROOT/repo"
+SESSION_ID="2026-06-18-00-00-token-metrics"
+BRANCH="chat/${SESSION_ID}"
+LOG_FILE="commitLogs/2026/jun/18/${SESSION_ID}/README.md"
+
+mkdir -p "$REPO/scripts/00.chat/transcript/discover-codex-session-log" \
+  "$REPO/scripts/00.chat/metrics/estimate-chat-cost" \
+  "$REPO/scripts/00.chat/metrics/data" \
+  "$REPO/scripts/00.chat/session-log/record-chat-commit" \
+  "$REPO/scripts/00.chat/session-log/paths" \
+  "$REPO/${LOG_FILE%/README.md}"
+cp "$SOURCE_ROOT/scripts/00.chat/session-log/record-chat-commit/script.sh" \
+  "$REPO/scripts/00.chat/session-log/record-chat-commit/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/session-log/paths/lib.sh" \
+  "$REPO/scripts/00.chat/session-log/paths/lib.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/transcript/discover-codex-session-log/script.sh" \
+  "$REPO/scripts/00.chat/transcript/discover-codex-session-log/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/metrics/estimate-chat-cost/script.js" \
+  "$REPO/scripts/00.chat/metrics/estimate-chat-cost/script.js"
+cp "$SOURCE_ROOT/scripts/00.chat/metrics/data/chat-pricing.json" \
+  "$REPO/scripts/00.chat/metrics/data/chat-pricing.json"
+chmod +x "$REPO/scripts/00.chat/session-log/record-chat-commit/script.sh" \
+  "$REPO/scripts/00.chat/transcript/discover-codex-session-log/script.sh"
+
+cat > "$REPO/$LOG_FILE" <<EOF
+# Chat Session: token metrics
+
+<!-- agentic-session
+id: ${SESSION_ID}
+branch: ${BRANCH}
+raised_at_utc: 2026-06-18T00:00:00Z
+transcript_provider:
+transcript_path:
+transcript_bytes:
+transcript_source:
+latest_commit_at_utc:
+latest_commit_sha:
+chat_duration:
+estimated_tokens:
+estimated_chat_cost:
+estimated_chat_cost_basis:
+-->
+
+## Commits
+
+- None recorded yet.
+
+## Activity Log
+
+- None recorded yet.
+
+## Session Metrics
+
+Raised at UTC: 2026-06-18T00:00:00Z
+Latest commit at UTC:
+Latest commit SHA:
+Chat duration:
+Estimated tokens:
+Estimated chat cost:
+Estimated chat cost basis:
+EOF
+
+(
+  cd "$REPO"
+  git init -q
+  git config user.name "Smoke Test"
+  git config user.email "smoke@example.invalid"
+  git add .
+  git commit -q -m "initial"
+  git checkout -q -b "$BRANCH"
+)
+
+set +e
+(
+  cd "$REPO"
+  CODEX_HOME="$TMP_ROOT/empty-codex" \
+  CHAT_TRANSCRIPT_METRICS_MODE=strict \
+    bash scripts/00.chat/session-log/record-chat-commit/script.sh abc1234 "Test commit" "Missing token metric"
+) >/dev/null 2>"$TMP_ROOT/missing-metrics.err"
+MISSING_STATUS="$?"
+set -e
+
+if [ "$MISSING_STATUS" -eq 0 ]; then
+  fail "recording succeeded without chat transcript metrics"
+fi
+
+if ! grep -q "missing chat transcript metrics" "$TMP_ROOT/missing-metrics.err"; then
+  fail "missing metrics failure was not explained"
+fi
+
+(
+  cd "$REPO"
+  CODEX_HOME="$TMP_ROOT/empty-codex" \
+    bash scripts/00.chat/session-log/record-chat-commit/script.sh abc1234 "Test commit" "Portable unavailable token metric" >/dev/null
+)
+
+if grep -q '^estimated_tokens:' "$REPO/$LOG_FILE"; then
+  fail "legacy estimated_tokens metadata remained after recording"
+fi
+
+if ! grep -q '^estimated_chat_tokens: unavailable; transcript source not supplied by chat$' "$REPO/$LOG_FILE"; then
+  fail "portable missing transcript metric was not marked unavailable"
+fi
+
+if ! grep -q '^Estimated chat tokens: unavailable; transcript source not supplied by chat$' "$REPO/$LOG_FILE"; then
+  fail "visible portable missing transcript metric was not marked unavailable"
+fi
+
+if ! grep -q '^estimated_chat_cost: unavailable; estimated chat tokens are unavailable$' "$REPO/$LOG_FILE"; then
+  fail "missing-token escape did not mark estimated chat cost unavailable"
+fi
+
+CODEX_HOME_FIXTURE="$TMP_ROOT/codex-home"
+CODEX_SESSION_LOG="$CODEX_HOME_FIXTURE/sessions/2026/06/18/rollout-test.jsonl"
+mkdir -p "${CODEX_SESSION_LOG%/*}"
+cat > "$CODEX_SESSION_LOG" <<EOF
+{"type":"message","payload":"${SESSION_ID}"}
+{"type":"message","payload":"${BRANCH}"}
+{"type":"message","payload":"${LOG_FILE}"}
+EOF
+CODEX_SESSION_BYTES="$(wc -c < "$CODEX_SESSION_LOG" | tr -d ' ')"
+CODEX_SESSION_TOKENS="$(( (CODEX_SESSION_BYTES + 3) / 4 ))"
+
+(
+  cd "$REPO"
+  CODEX_HOME="$CODEX_HOME_FIXTURE" \
+  CHAT_TRANSCRIPT_PROVIDER=codex \
+    bash scripts/00.chat/session-log/record-chat-commit/script.sh cde4567 "Test commit 2" "Discovered Codex session metric" >/dev/null
+)
+
+if ! grep -q '^transcript_provider: codex$' "$REPO/$LOG_FILE"; then
+  fail "discovered Codex provider was not recorded"
+fi
+
+if ! grep -q "^transcript_path: ${CODEX_SESSION_LOG}$" "$REPO/$LOG_FILE"; then
+  fail "discovered Codex transcript path was not recorded"
+fi
+
+if ! grep -q "^estimated_chat_tokens: ${CODEX_SESSION_TOKENS} estimated from chat transcript bytes (${CODEX_SESSION_BYTES} bytes; source: codex path: ${CODEX_SESSION_LOG})$" "$REPO/$LOG_FILE"; then
+  fail "discovered Codex session byte metric was not recorded"
+fi
+
+if ! grep -q '^estimated_chat_cost: unavailable; no pricing profile selected$' "$REPO/$LOG_FILE"; then
+  fail "Codex transcript without explicit pricing profile did not leave cost unavailable"
+fi
+
+if ! grep -q '^estimated_chat_cost_basis: unavailable; set CHAT_COST_PROFILE or CHAT_COST_PRICING_FILE$' "$REPO/$LOG_FILE"; then
+  fail "Codex transcript without explicit pricing profile did not explain unavailable cost basis"
+fi
+
+if grep -q '^estimated_chat_cost_basis: profile=.*openai' "$REPO/$LOG_FILE"; then
+  fail "default Codex transcript cost used an OpenAI pricing profile"
+fi
+
+(
+  cd "$REPO"
+  CHAT_TRANSCRIPT_PROVIDER=manual \
+  CHAT_TRANSCRIPT_BYTES=4096 \
+  CHAT_TRANSCRIPT_SOURCE="smoke transcript fixture" \
+  CHAT_COST_PROFILE=openai-chat-latest-standard-conservative-output \
+    bash scripts/00.chat/session-log/record-chat-commit/script.sh def5678 "Test commit 3" "Transcript byte token metric" >/dev/null
+)
+
+if ! grep -q '^estimated_chat_tokens: 1024 estimated from chat transcript bytes (4096 bytes; source: smoke transcript fixture)$' "$REPO/$LOG_FILE"; then
+  fail "transcript-byte chat token metric was not recorded"
+fi
+
+if ! grep -q '^transcript_provider: manual$' "$REPO/$LOG_FILE"; then
+  fail "manual transcript provider was not recorded"
+fi
+
+if ! grep -q '^estimated_chat_cost: USD 0.0307 estimated from estimated_chat_tokens$' "$REPO/$LOG_FILE"; then
+  fail "explicit OpenAI chat cost profile did not record transcript-byte cost"
+fi
+
+if ! grep -q '^estimated_chat_cost_basis: profile=openai-chat-latest-standard-conservative-output; model=chat-latest;' "$REPO/$LOG_FILE"; then
+  fail "explicit OpenAI chat cost profile was not recorded in the cost basis"
+fi
+
+if grep -q 'estimated from session log' "$REPO/$LOG_FILE"; then
+  fail "session log size was used as a token source"
+fi
+
+echo "record chat commit metrics smoke test passed."

package/scripts/00.chat/session-log/record-main-refresh-conflict/README.md

@@ -0,0 +1,34 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.session-log.record-main-refresh-conflict.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: session-log
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain recording governed main-refresh conflict resolutions.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.workflows.chat-refresh-from-main
+    path: .agentic/00.chat/workflows/chat-refresh-from-main.md
+  - id: chat.script.session-log.record-main-refresh-conflict
+    path: scripts/00.chat/session-log/record-main-refresh-conflict/script.sh
+-->
+# Record Main Refresh Conflict
+
+`script.sh` appends a main-refresh conflict audit entry to the current chat
+session log.
+
+Use it after a refresh from `main` encounters a conflict and the conflict has
+been classified, resolved, stopped, or handed to a manual path. The entry names
+the conflicted path, conflict type, reason, resolution action, mode, preflight
+branch, preflight worktree, changed files, and checks.
+
+The script records evidence. It does not resolve conflicts, apply refreshes,
+merge branches, or push.
+

package/scripts/00.chat/session-log/record-main-refresh-conflict/script.sh

@@ -0,0 +1,239 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.session-log.record-main-refresh-conflict
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: refresh
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Record main-refresh conflict classification and resolution in the current
+#     chat log.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.workflows.chat-refresh-from-main
+#     path: .agentic/00.chat/workflows/chat-refresh-from-main.md
+#   - id: chat.standards.main-refresh-conflict-types
+#     path: .agentic/00.chat/standards/main-refresh-conflict-types.md
+#   effects:
+#   - writes-files
+
+# shellcheck source=../paths/lib.sh
+source "scripts/00.chat/session-log/paths/lib.sh"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  record-main-refresh-conflict.sh \
+    --path <conflicted-path> \
+    --type <conflict-type> \
+    --reason <classification-reason> \
+    --action <resolution-action> \
+    --mode <deterministic|skill-assisted|manual|stopped> \
+    --preflight-branch <branch> \
+    --preflight-worktree <path> \
+    [--files <changed-files-summary>] \
+    [--checks <checks-summary>]
+
+Records a main-refresh conflict classification and resolution audit entry in
+the current chat session log.
+EOF
+}
+
+CONFLICT_PATH=""
+CONFLICT_TYPE=""
+REASON=""
+ACTION=""
+MODE=""
+PREFLIGHT_BRANCH=""
+PREFLIGHT_WORKTREE=""
+FILES="pending"
+CHECKS="pending"
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --path)
+      CONFLICT_PATH="${2:-}"
+      shift 2
+      ;;
+    --type)
+      CONFLICT_TYPE="${2:-}"
+      shift 2
+      ;;
+    --reason)
+      REASON="${2:-}"
+      shift 2
+      ;;
+    --action)
+      ACTION="${2:-}"
+      shift 2
+      ;;
+    --mode)
+      MODE="${2:-}"
+      shift 2
+      ;;
+    --preflight-branch)
+      PREFLIGHT_BRANCH="${2:-}"
+      shift 2
+      ;;
+    --preflight-worktree)
+      PREFLIGHT_WORKTREE="${2:-}"
+      shift 2
+      ;;
+    --files)
+      FILES="${2:-}"
+      shift 2
+      ;;
+    --checks)
+      CHECKS="${2:-}"
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "ERROR: unknown argument: $1" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+for required in CONFLICT_PATH CONFLICT_TYPE REASON ACTION MODE PREFLIGHT_BRANCH PREFLIGHT_WORKTREE; do
+  if [ -z "${!required// }" ]; then
+    echo "ERROR: missing required value: ${required}" >&2
+    usage >&2
+    exit 2
+  fi
+done
+
+case "$MODE" in
+  deterministic|skill-assisted|manual|stopped)
+    ;;
+  *)
+    echo "ERROR: invalid mode: $MODE" >&2
+    echo "Expected deterministic, skill-assisted, manual, or stopped." >&2
+    exit 2
+    ;;
+esac
+
+BRANCH="$(git branch --show-current)"
+
+case "$BRANCH" in
+  chat/*|agentic/preflight/*)
+    ;;
+  *)
+    echo "ERROR: current branch is not a chat or preflight branch: $BRANCH" >&2
+    exit 1
+    ;;
+esac
+
+if ! SESSION_ID="$(chat_session_id_from_branch "$BRANCH" 2>/dev/null)"; then
+  if [ -z "${AGENTIC_SESSION_LOG:-}" ]; then
+    echo "ERROR: could not infer chat session from branch. Set AGENTIC_SESSION_LOG." >&2
+    exit 1
+  fi
+  LOG_FILE="$AGENTIC_SESSION_LOG"
+else
+  LOG_FILE="$(chat_log_file_for_session "$SESSION_ID")"
+fi
+
+if [ ! -f "$LOG_FILE" ]; then
+  echo "ERROR: missing chat log: $LOG_FILE" >&2
+  exit 1
+fi
+
+TIMESTAMP="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+insert_section_entry() {
+  local section="$1"
+  local entry="$2"
+  local tmp
+  local entry_tmp
+
+  tmp="$(mktemp)"
+  entry_tmp="$(mktemp)"
+  printf '%s\n' "$entry" > "$entry_tmp"
+
+  if awk -v section="$section" -v entry_path="$entry_tmp" '
+    BEGIN {
+      in_section = 0
+      inserted = 0
+      found = 0
+      entry = ""
+      while ((getline line < entry_path) > 0) {
+        entry = entry (entry == "" ? "" : "\n") line
+      }
+      close(entry_path)
+    }
+    $0 == section {
+      found = 1
+      in_section = 1
+      print
+      next
+    }
+    in_section && /^## / && inserted == 0 {
+      print ""
+      print entry
+      print ""
+      inserted = 1
+      in_section = 0
+    }
+    in_section && $0 == "- None recorded yet." {
+      next
+    }
+    {
+      print
+    }
+    END {
+      if (found == 0) {
+        print ""
+        print section
+        print ""
+        print entry
+      } else if (in_section == 1 && inserted == 0) {
+        print ""
+        print entry
+      }
+    }
+  ' "$LOG_FILE" > "$tmp"; then
+    mv "$tmp" "$LOG_FILE"
+  else
+    rm -f "$tmp"
+    rm -f "$entry_tmp"
+    return 1
+  fi
+
+  rm -f "$entry_tmp"
+}
+
+ENTRY="- Path: \`${CONFLICT_PATH}\`
+  Type: \`${CONFLICT_TYPE}\`
+  Mode: ${MODE}
+  Reason: ${REASON}
+  Action: ${ACTION}
+  Preflight branch: \`${PREFLIGHT_BRANCH}\`
+  Preflight worktree: \`${PREFLIGHT_WORKTREE}\`
+  Files changed by resolution: ${FILES}
+  Checks: ${CHECKS}"
+
+insert_section_entry "## Main Refresh Conflicts" "$ENTRY"
+insert_section_entry "## Activity Log" "### ${TIMESTAMP} - Main refresh conflict recorded
+
+Path: \`${CONFLICT_PATH}\`
+
+Type: \`${CONFLICT_TYPE}\`
+
+Mode: ${MODE}
+
+Action: ${ACTION}"
+
+echo "Recorded main refresh conflict: ${CONFLICT_PATH}"

package/scripts/00.chat/session-log/rename-current-chat-log-folder/README.md

@@ -0,0 +1,32 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.session-log.rename-current-chat-log-folder.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: session-log
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain renaming the current chat session log folder.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.workflows.chat-start
+    path: .agentic/00.chat/workflows/chat-start.md
+  - id: chat.script.session-log.rename-current-chat-log-folder
+    path: scripts/00.chat/session-log/rename-current-chat-log-folder/script.sh
+-->
+# Rename Current Chat Log Folder
+
+`script.sh` renames the current chat session log folder to a shorter human
+summary while preserving the existing branch name and session metadata.
+
+This is useful when an auto-generated session slug is too long or unclear. The
+session remains the same chat; only the log folder path changes.
+
+Because this writes files, it is approval-sensitive through the governed runner.
+It does not rename branches, rewrite commits, or change task ownership.
+

package/scripts/00.chat/session-log/rename-current-chat-log-folder/script.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.session-log.rename-current-chat-log-folder
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: session-log
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Rename the current chat session log folder while preserving metadata.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.workflows.chat-start
+#     path: .agentic/00.chat/workflows/chat-start.md
+#   - id: harness.standards.governed-script-permissions
+#   - id: harness.script.run-governed-script
+#     path: scripts/01.harness/run-governed-script.sh
+#   effects:
+#   - writes-files
+
+# shellcheck source=../paths/lib.sh
+source "scripts/00.chat/session-log/paths/lib.sh"
+
+usage() {
+  cat <<'EOF'
+Usage: rename-current-chat-log-folder.sh <short-summary>
+
+Renames the current chat session log folder to a shorter summary while keeping
+the branch name and session metadata stable.
+EOF
+}
+
+if [ $# -lt 1 ]; then
+  usage >&2
+  exit 2
+fi
+
+SUMMARY="$*"
+
+if [ -z "${SUMMARY// }" ]; then
+  echo "ERROR: provide a non-empty summary." >&2
+  exit 2
+fi
+
+BRANCH="$(git branch --show-current)"
+
+if ! SESSION_ID="$(chat_session_id_from_branch "$BRANCH")"; then
+  echo "ERROR: current branch is not a chat branch: $BRANCH" >&2
+  exit 1
+fi
+
+LOG_FILE="$(chat_log_file_for_session "$SESSION_ID")"
+
+if [ ! -f "$LOG_FILE" ]; then
+  echo "ERROR: missing chat log: $LOG_FILE" >&2
+  exit 1
+fi
+
+STAMP="${SESSION_ID:0:16}"
+SLUG="$(printf '%s' "$SUMMARY" \
+  | tr '[:upper:]' '[:lower:]' \
+  | sed -E 's/[^a-z0-9]+/-/g' \
+  | sed -E 's/^-+|-+$//g' \
+  | cut -c1-40)"
+
+if [ -z "$SLUG" ]; then
+  echo "ERROR: summary must contain at least one ASCII letter or number." >&2
+  exit 2
+fi
+
+CURRENT_DIR="${LOG_FILE%/README.md}"
+PARENT_DIR="${CURRENT_DIR%/*}"
+TARGET_DIR="${PARENT_DIR}/${STAMP}-${SLUG}"
+TARGET_FILE="${TARGET_DIR}/README.md"
+
+if [ "$CURRENT_DIR" = "$TARGET_DIR" ]; then
+  echo "Chat log folder already matches: $CURRENT_DIR"
+  exit 0
+fi
+
+if [ -e "$TARGET_DIR" ]; then
+  echo "ERROR: target commit log folder already exists: $TARGET_DIR" >&2
+  exit 1
+fi
+
+if git rev-parse --is-inside-work-tree >/dev/null 2>&1 \
+  && git ls-files --error-unmatch "$LOG_FILE" >/dev/null 2>&1; then
+  git mv "$CURRENT_DIR" "$TARGET_DIR"
+else
+  mv "$CURRENT_DIR" "$TARGET_DIR"
+fi
+
+tmp="$(mktemp)"
+awk -v stamp="$STAMP" -v slug="$SLUG" '
+  NR == 1 && /^# Chat Session:/ {
+    print "# Chat Session: " stamp " " slug
+    next
+  }
+  { print }
+' "$TARGET_FILE" > "$tmp"
+mv "$tmp" "$TARGET_FILE"
+
+echo "Renamed chat log folder:"
+echo "  from: $CURRENT_DIR"
+echo "  to:   $TARGET_DIR"

package/scripts/00.chat/session-log/update-chat-log/README.md

@@ -0,0 +1,32 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.session-log.update-chat-log.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: session-log
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain the internal structured chat log update helper.
+  portability:
+    class: internal
+    targets: []
+  used_by:
+  - id: chat.checklists.before-commit
+    path: .agentic/00.chat/checklists/before-commit.md
+  - id: chat.script.session-log.update-chat-log
+    path: scripts/00.chat/session-log/update-chat-log/script.sh
+-->
+# Update Chat Log
+
+`script.sh` is an internal helper for appending structured entries to the
+current chat session log.
+
+It supports entries for questions, issues, decisions, commit summaries, and ADR
+disposition. The helper keeps common log updates consistent so humans and
+future agents can scan session history without guessing which section to read.
+
+This script writes the current chat log only. It does not create commits,
+record transcript metrics, or decide whether an ADR is needed.
+