llm-wb 0.1.0-beta.0

package/scripts/00.chat/startup/resolve-current-chat-session/smoke-test.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.startup.resolve-current-chat-session.smoke-test
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: startup
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Smoke test startup resolution for missing and existing chat sessions.
+#   portability:
+#     class: reusable
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.script.startup.resolve-current-chat-session.readme
+#     path: scripts/00.chat/startup/resolve-current-chat-session/README.md
+#   effects:
+#   - writes-files
+#   - branches
+#   - worktrees
+#   - commits
+
+fail() {
+  echo "FAIL: $*" >&2
+  exit 1
+}
+
+SOURCE_ROOT="$(git rev-parse --show-toplevel)"
+TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/resolve-current-chat-session-smoke.XXXXXX")"
+
+cleanup() {
+  rm -rf "$TMP_ROOT"
+}
+
+trap cleanup EXIT
+
+REPO="$TMP_ROOT/repo"
+mkdir -p "$REPO"
+git -C "$REPO" init --quiet --initial-branch=main
+
+mkdir -p \
+  "$REPO/scripts/00.chat/command/dispatcher" \
+  "$REPO/scripts/00.chat/command/new" \
+  "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches" \
+  "$REPO/scripts/00.chat/session-log/paths" \
+  "$REPO/scripts/00.chat/session-log/read-current-chat-log" \
+  "$REPO/scripts/00.chat/startup/auto-start-missing-session" \
+  "$REPO/scripts/00.chat/startup/resolve-current-chat-session" \
+  "$REPO/scripts/00.chat/startup/start-chat-session" \
+  "$REPO/scripts/00.chat/startup/start-new-chat" \
+  "$REPO/scripts/00.chat/worktree/ensure-chat-worktree" \
+  "$REPO/scripts/00.chat/worktree/open-window" \
+  "$REPO/scripts/00.chat/worktree/paths"
+
+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/worktree/paths/lib.sh" "$REPO/scripts/00.chat/worktree/paths/lib.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/session-log/read-current-chat-log/script.sh" "$REPO/scripts/00.chat/session-log/read-current-chat-log/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/startup/resolve-current-chat-session/script.sh" "$REPO/scripts/00.chat/startup/resolve-current-chat-session/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/startup/auto-start-missing-session/script.sh" "$REPO/scripts/00.chat/startup/auto-start-missing-session/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/command/dispatcher/script.sh" "$REPO/scripts/00.chat/command/dispatcher/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/command/new/script.sh" "$REPO/scripts/00.chat/command/new/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/startup/start-new-chat/script.sh" "$REPO/scripts/00.chat/startup/start-new-chat/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/startup/start-chat-session/script.sh" "$REPO/scripts/00.chat/startup/start-chat-session/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/worktree/ensure-chat-worktree/script.sh" "$REPO/scripts/00.chat/worktree/ensure-chat-worktree/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/worktree/open-window/script.sh" "$REPO/scripts/00.chat/worktree/open-window/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/git/cleanup-empty-chat-branches/script.sh" "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches/script.sh"
+chmod +x \
+  "$REPO/scripts/00.chat/session-log/read-current-chat-log/script.sh" \
+  "$REPO/scripts/00.chat/startup/resolve-current-chat-session/script.sh" \
+  "$REPO/scripts/00.chat/startup/auto-start-missing-session/script.sh" \
+  "$REPO/scripts/00.chat/command/dispatcher/script.sh" \
+  "$REPO/scripts/00.chat/command/new/script.sh" \
+  "$REPO/scripts/00.chat/startup/start-new-chat/script.sh" \
+  "$REPO/scripts/00.chat/startup/start-chat-session/script.sh" \
+  "$REPO/scripts/00.chat/worktree/ensure-chat-worktree/script.sh" \
+  "$REPO/scripts/00.chat/worktree/open-window/script.sh" \
+  "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches/script.sh"
+
+printf 'base\n' > "$REPO/README.md"
+git -C "$REPO" add README.md scripts
+git -C "$REPO" -c user.name='Smoke Test' -c user.email='smoke@example.invalid' commit --quiet -m 'base'
+
+AGENTIC_CHAT_WORKTREE_ROOT="$TMP_ROOT/worktrees" \
+CHAT_CLEANUP_EMPTY_BRANCHES=skip \
+CHAT_COPY_PROMPT=skip \
+CHAT_OPEN_WORKTREE_WINDOW=skip \
+  bash -c 'cd "$1" && shift && "$@"' sh "$REPO" \
+    bash scripts/00.chat/startup/resolve-current-chat-session/script.sh "use the existing chat start process" \
+    >"$TMP_ROOT/resolve-missing.out"
+
+grep -q 'Created branch: chat/' "$TMP_ROOT/resolve-missing.out" \
+  || fail "resolver did not auto-start a missing root-main session"
+grep -q 'Task: use the existing chat start process' "$TMP_ROOT/resolve-missing.out" \
+  || fail "resolver did not pass the opening prompt to auto-start"
+
+chat_branch="$(git -C "$REPO" branch --format='%(refname:short)' | grep '^chat/' | head -n 1)"
+worktree_path="$(
+  git -C "$REPO" worktree list --porcelain \
+    | awk -v branch="refs/heads/${chat_branch}" '
+      /^worktree / { path = substr($0, 10) }
+      /^branch / && substr($0, 8) == branch { print path }
+    '
+)"
+
+if [ -z "$worktree_path" ]; then
+  fail "resolver-created chat branch did not have a worktree"
+fi
+
+branch_count_before="$(git -C "$REPO" branch --format='%(refname:short)' | grep -c '^chat/')"
+
+bash -c 'cd "$1" && shift && "$@"' sh "$worktree_path" \
+  bash scripts/00.chat/startup/resolve-current-chat-session/script.sh "ignored because metadata exists" \
+  >"$TMP_ROOT/resolve-existing.out"
+
+grep -q '^task: use the existing chat start process$' "$TMP_ROOT/resolve-existing.out" \
+  || fail "resolver did not return existing session metadata"
+grep -q '^chat_lifecycle_workflow: .agentic/00.chat/workflows/chat-start.md$' "$TMP_ROOT/resolve-existing.out" \
+  || fail "resolver existing-session metadata did not include chat lifecycle workflow"
+
+branch_count_after="$(git -C "$REPO" branch --format='%(refname:short)' | grep -c '^chat/')"
+if [ "$branch_count_after" != "$branch_count_before" ]; then
+  fail "resolver created another chat branch despite existing metadata"
+fi
+
+echo "resolve current chat session smoke test passed."

package/scripts/00.chat/startup/start-chat-session/README.md

@@ -0,0 +1,197 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.startup.start-chat-session.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: startup
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain how the chat session startup engine creates branches, logs, prompts,
+    and worktrees.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.script.startup.start-chat-session
+    path: scripts/00.chat/startup/start-chat-session/script.sh
+  - id: harness.architecture.adr.0017-organize-scripts-by-owner-domain-and-capability
+-->
+# Start Chat Session
+
+`script.sh` is the chat startup engine. It turns a short task summary into the
+working environment for one governed agent conversation: a `chat/*` branch, a
+chat-owned worktree, a session log, and a first prompt for the next agent.
+
+The important idea is that a chat is treated as a small, auditable unit of work.
+Startup does the bookkeeping before the agent begins editing so the work has a
+known branch, location, lifecycle workflow, and history from the first turn.
+
+## Mental Model
+
+The root worktree is the integration console. It is where finished chat work can
+be reviewed, merged, and coordinated.
+
+Each chat gets its own branch and sibling worktree. That keeps task edits away
+from the integration console and away from other active chats. If several chats
+are open at once, each one has a physical directory and branch that belong to
+that conversation.
+
+The session log is the chat's durable memory. It records the task, branch,
+worktree, lifecycle workflow, latest context-packet references, commits,
+unresolved questions, decisions, conflicts, and metrics. The harness uses that
+file as the first source of truth when a chat resumes.
+
+The first prompt is the handoff packet. It tells the next agent the exact branch,
+worktree, chat lifecycle workflow, context-packet continuity fields, and
+dirty-state handling rule. It also makes
+the startup boundary explicit: branch, worktree, and session-log bootstrap has
+already happened, while task edits remain read-only until the user grants write
+permission. That prevents a new agent from guessing where it should work or
+which chat lifecycle workflow governs the conversation. Prompt-level layer,
+mode, workflow, and corpus routing uses the current request, repo assistant
+instructions, and any repo-provided context router if one exists, not durable
+chat startup metadata.
+
+## Inputs
+
+- Task summary: the human description of the work. It can be passed as command
+  arguments, or entered interactively when the script prompts for it.
+- `.agentic/env.local`: optional local environment values for this checkout.
+- `CHAT_COPY_PROMPT`: controls terminal first-prompt handoff. The default is
+  `copy`, which tries the clipboard first and prints the prompt as a fallback.
+  Use `skip` to print only.
+- `CHAT_CLEANUP_EMPTY_BRANCHES`: controls startup cleanup. The default is
+  `apply`, which removes empty abandoned chat branches through the governed
+  cleanup script. Use `dry-run` to inspect only, or `skip` when startup should
+  not clean empty chat branches.
+
+## Terminal Handoff And IDE Integrations
+
+The startup script always builds a first prompt. That prompt is a portable
+session packet for terminal-based startup: it contains the task, session log,
+chat worktree, chat lifecycle workflow, latest context-packet continuity fields,
+and dirty-worktree stop response.
+
+`CHAT_COPY_PROMPT` only controls how that terminal packet is handed to a human:
+copy it to the clipboard, or print it in the terminal. It is a terminal
+convenience, not the startup contract.
+
+IDE extensions and app integrations should not depend on clipboard behavior.
+They should use the startup data directly:
+
+- task summary
+- session log path
+- chat worktree path
+- chat lifecycle workflow
+- latest context packet id
+- latest context packet routing summary
+- starting worktree status
+
+That keeps the durable startup model the same while allowing different surfaces
+to present or pass the session packet in their own way.
+
+## Flow
+
+1. Validate the task summary.
+
+   Startup rejects an empty task or the placeholder `new chat` because the
+   summary becomes the session identity. A useful summary makes the branch,
+   folder, and log readable later.
+
+2. Create the session id and branch name.
+
+   The script combines a timestamp with a slug from the task summary. That gives
+   each chat a stable id and creates a branch name like
+   `chat/2026-06-19-20-27-move-chat-session-startup-engine`.
+
+3. Record chat lifecycle metadata.
+
+   Startup records the chat lifecycle workflow and initializes latest
+   context-packet fields. It does not classify the whole chat into a task layer,
+   mode, or workflow. The consuming agent should use the current request, repo
+   assistant instructions, and any repo-provided context router for prompt-level
+   routing context.
+
+4. Capture the starting worktree state.
+
+   Startup records whether the current worktree was clean or dirty. If it was
+   dirty, the first prompt tells the next agent to stop and ask for confirmation
+   before doing more discovery. That protects existing uncommitted work.
+
+5. Create the branch and chat-owned worktree.
+
+   The branch starts from `main` when available. If `main` does not exist, the
+   script falls back to the current branch so the harness can still bootstrap in
+   a new or unusual repo. The sibling worktree is where the chat should edit
+   files.
+
+6. Write the session log.
+
+   The log is created at
+   `commitLogs/<year>/<month>/<day>/<session>/README.md` inside the new
+   worktree. It starts with machine-readable session metadata and human-readable
+   sections for activity, decisions, issues, commits, conflicts, and metrics.
+
+7. Offer a chat worktree window.
+
+   Startup does not open a VS Code window by default. Set
+   `CHAT_OPEN_WORKTREE_WINDOW=open` to opt into opening the new chat worktree.
+   The explicit `chat:open-window` command remains available after startup.
+
+8. Print or copy the first prompt for terminal use.
+
+   The prompt is the bridge from startup automation into the next agent turn. It
+  names the task, session log, worktree, chat lifecycle workflow, context-packet
+  continuity fields, startup bootstrap boundary, and the dirty-worktree stop
+  response. Terminal startup can copy or print it. IDE and app integrations
+  should treat those fields as structured startup data rather than depending on
+  clipboard behavior.
+
+9. Clean empty chat branches.
+
+   Startup can run the empty-chat-branch cleanup script after creating the new
+   session. This keeps abandoned zero-commit chat branches from accumulating
+   while still routing cleanup through a governed script.
+
+10. Stage the session log in the chat worktree.
+
+   The log is staged so the first real task commit can include the session
+   record if appropriate. The root worktree is left alone.
+
+## What This Does Not Do
+
+- It does not push anything.
+- It does not merge the chat branch.
+- It does not grant task write permission to the agent.
+- It does not decide that dirty root work is safe to ignore.
+- It does not classify the whole chat into one task layer, mode, or workflow.
+- It does not replace prompt-level routing from assistant instructions or a
+  repo-provided context router.
+
+## Typical Result
+
+After a successful run, expect:
+
+- a new `chat/*` branch
+- a sibling chat worktree
+- a staged session log inside that worktree
+- a first prompt printed or copied for the next agent
+- no VS Code window unless `CHAT_OPEN_WORKTREE_WINDOW=open` is set
+- the original root worktree still on its original branch
+
+## Smoke Test
+
+`smoke-test.sh` creates a throwaway Git repo and runs startup there. It verifies
+that startup leaves the root repo on `main`, creates a separate chat worktree,
+stages the session log in that chat worktree, records chat lifecycle metadata,
+skips opening a VS Code window by default, and falls back to printed terminal
+handoff when clipboard copy fails.
+
+## Compatibility
+
+The old request-initialization entrypoint
+`scripts/shared/chat/request-initialization/start-chat-session.sh` was retired
+after smoke fixtures and downstream references moved to this canonical script.

package/scripts/00.chat/startup/start-chat-session/script.sh

@@ -0,0 +1,330 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.startup.start-chat-session
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: startup
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Create chat branch, session log, prompt, and chat-owned worktree.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.script.startup.start-new-chat
+#     path: scripts/00.chat/startup/start-new-chat/script.sh
+#   - id: chat.workflows.chat-start
+#     path: .agentic/00.chat/workflows/chat-start.md
+#   effects:
+#   - branches
+#   - worktrees
+#   - writes-files
+#   - stages-files
+AGENTIC_ENV_FILE=".agentic/env.local"
+
+# shellcheck source=../../session-log/paths/lib.sh
+source "scripts/00.chat/session-log/paths/lib.sh"
+# shellcheck source=../../worktree/paths/lib.sh
+source "scripts/00.chat/worktree/paths/lib.sh"
+
+CHAT_CLEANUP_EMPTY_BRANCHES_WAS_SET="no"
+CHAT_CLEANUP_EMPTY_BRANCHES_SHELL_VALUE="${CHAT_CLEANUP_EMPTY_BRANCHES:-}"
+
+if [ "${CHAT_CLEANUP_EMPTY_BRANCHES+x}" = "x" ]; then
+  CHAT_CLEANUP_EMPTY_BRANCHES_WAS_SET="yes"
+fi
+
+if [ -f "$AGENTIC_ENV_FILE" ]; then
+  set -a
+  # shellcheck disable=SC1090
+  source "$AGENTIC_ENV_FILE"
+  set +a
+fi
+
+if [ "$CHAT_CLEANUP_EMPTY_BRANCHES_WAS_SET" = "yes" ]; then
+  CHAT_CLEANUP_EMPTY_BRANCHES="$CHAT_CLEANUP_EMPTY_BRANCHES_SHELL_VALUE"
+fi
+
+OUTPUT_FORMAT="text"
+
+case "${1:-}" in
+  --json)
+    OUTPUT_FORMAT="json"
+    shift
+    ;;
+esac
+
+if [ $# -gt 0 ]; then
+  QUESTION="$*"
+else
+  read -r -p "Short task summary: " QUESTION
+fi
+
+if [ -z "${QUESTION// }" ] || [ "$QUESTION" = "new chat" ]; then
+  echo "ERROR: Provide a meaningful task summary."
+  echo "Example: add tenant auth guard"
+  exit 1
+fi
+
+STAMP="$(date +"%Y-%m-%d-%H-%M")"
+RAISED_AT_UTC="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
+SLUG="$(echo "$QUESTION" \
+  | tr '[:upper:]' '[:lower:]' \
+  | sed -E 's/[^a-z0-9]+/-/g' \
+  | sed -E 's/^-+|-+$//g' \
+  | cut -c1-60)"
+
+BRANCH="chat/${STAMP}-${SLUG}"
+LOG_DIR="$(chat_log_grouped_dir_for_session "${STAMP}-${SLUG}")"
+LOG_FILE="${LOG_DIR}/README.md"
+REPO_ROOT="$(chat_worktree_repo_root)"
+WORKTREE_PATH="$(chat_worktree_path_for_branch "$REPO_ROOT" "$BRANCH")"
+BASE_BRANCH="main"
+CHAT_LIFECYCLE_WORKFLOW=".agentic/00.chat/workflows/chat-start.md"
+
+if ! git show-ref --verify --quiet "refs/heads/${BASE_BRANCH}"; then
+  BASE_BRANCH="$(git branch --show-current)"
+fi
+
+if [ -z "${BASE_BRANCH// }" ]; then
+  echo "ERROR: could not determine a base branch for the chat branch." >&2
+  exit 1
+fi
+
+if [ -n "$(git status --porcelain)" ]; then
+  WORKTREE_STATUS="dirty"
+else
+  WORKTREE_STATUS="clean"
+fi
+
+if [ "$OUTPUT_FORMAT" = "text" ]; then
+  git status --short
+fi
+
+git branch "$BRANCH" "$BASE_BRANCH"
+mkdir -p "${WORKTREE_PATH%/*}"
+git worktree add --quiet "$WORKTREE_PATH" "$BRANCH"
+
+mkdir -p "$WORKTREE_PATH/$LOG_DIR"
+
+cat > "$WORKTREE_PATH/$LOG_FILE" <<EOF
+# Chat Session: ${STAMP} ${SLUG}
+
+<!-- agentic-session
+id: ${STAMP}-${SLUG}
+task: ${QUESTION}
+branch: ${BRANCH}
+worktree: ${WORKTREE_PATH}
+chat_lifecycle_workflow: ${CHAT_LIFECYCLE_WORKFLOW}
+status: ready
+raised_at_utc: ${RAISED_AT_UTC}
+transcript_provider:
+transcript_path:
+transcript_bytes:
+transcript_source:
+latest_context_packet_id:
+latest_context_packet_routing_summary:
+latest_context_packet_at_utc:
+latest_commit_at_utc:
+latest_commit_sha:
+chat_duration:
+estimated_chat_tokens:
+estimated_chat_cost:
+estimated_chat_cost_basis:
+-->
+
+## Initial Intent
+
+${QUESTION}
+
+## Session Log
+
+- Session started.
+- Branch created.
+- Chat-owned worktree created.
+- Commit log initialized.
+
+## Questions Asked
+
+- None recorded yet.
+
+## Issues Raised
+
+- None recorded yet.
+
+## Decisions Made
+
+- None recorded yet.
+
+## Activity Log
+
+### ${RAISED_AT_UTC} - Session started
+
+Initial intent: ${QUESTION}
+
+## Commits
+
+- None recorded yet.
+
+## Main Refresh Conflicts
+
+- None recorded yet.
+
+## ADR Disposition
+
+ADR needed: unknown
+ADR path:
+Reason:
+
+## Session Metrics
+
+Raised at UTC: ${RAISED_AT_UTC}
+Latest commit at UTC:
+Latest commit SHA:
+Chat duration:
+Estimated chat tokens:
+Estimated chat cost:
+Estimated chat cost basis:
+
+## Notes
+
+- None recorded yet.
+EOF
+
+if [ "$OUTPUT_FORMAT" = "text" ]; then
+  echo "Created branch: $BRANCH"
+  echo "Created log: $LOG_FILE"
+  echo "Created worktree: $WORKTREE_PATH"
+fi
+
+if [ "$OUTPUT_FORMAT" = "text" ]; then
+  CHAT_OPEN_WORKTREE_WINDOW="${CHAT_OPEN_WORKTREE_WINDOW:-skip}" \
+    bash scripts/00.chat/worktree/open-window/script.sh "$WORKTREE_PATH"
+fi
+
+FIRST_PROMPT="Task: ${QUESTION}
+Session log: ${LOG_FILE}
+Chat worktree: ${WORKTREE_PATH}
+Chat lifecycle workflow: ${CHAT_LIFECYCLE_WORKFLOW}
+Latest context packet id:
+Latest context packet routing summary:
+Bootstrap worktree status: ${WORKTREE_STATUS}
+
+If Bootstrap worktree status is dirty, reply exactly:
+Blocked: dirty worktree. Confirm proceed?
+
+Before that response, do not read workflows or run git status/dirty checks.
+
+Governed startup bootstrap has already created this chat branch, worktree, and session log.
+Default mode after startup bootstrap: read-only until I grant write permission in this chat.
+For task writes or commit-boundary work, use the chat worktree above and follow the current workflow gates.
+For prompt-level routing, use the current user request, this repo's assistant instructions, and any repo-provided context router if one exists. Do not assign the whole chat a durable layer, mode, or workflow.
+Do not commit without my explicit approval."
+
+emit_json_packet() {
+  node - \
+    "$QUESTION" \
+    "$LOG_FILE" \
+    "$WORKTREE_PATH" \
+    "$CHAT_LIFECYCLE_WORKFLOW" \
+    "$WORKTREE_STATUS" \
+    "$FIRST_PROMPT" <<'NODE'
+const [
+  task,
+  sessionLog,
+  chatWorktree,
+  chatLifecycleWorkflow,
+  bootstrapWorktreeStatus,
+  firstPrompt
+] = process.argv.slice(2);
+
+const packet = {
+  schema: 'llm-workbench/startup-packet/v1',
+  task,
+  session_log: sessionLog,
+  chat_worktree: chatWorktree,
+  chat_lifecycle_workflow: chatLifecycleWorkflow,
+  latest_context_packet_id: '',
+  latest_context_packet_routing_summary: '',
+  bootstrap_worktree_status: bootstrapWorktreeStatus,
+  first_prompt: firstPrompt
+};
+
+process.stdout.write(`${JSON.stringify(packet, null, 2)}\n`);
+NODE
+}
+
+print_first_prompt() {
+  echo
+  echo "Paste this into Codex / Claude / Mistral:"
+  echo "$FIRST_PROMPT"
+}
+
+copy_first_prompt_with_retry() {
+  local label="$1"
+  shift
+
+  local attempt=1
+  while [ "$attempt" -le 2 ]; do
+    if printf '%s' "$FIRST_PROMPT" | "$@"; then
+      echo "Copied first agent prompt to clipboard."
+      return 0
+    fi
+
+    if [ "$attempt" -lt 2 ]; then
+      echo "Clipboard copy via ${label} failed; retrying..." >&2
+      sleep 1
+    fi
+
+    attempt=$((attempt + 1))
+  done
+
+  echo "WARNING: Clipboard copy via ${label} failed; printing prompt instead." >&2
+  return 1
+}
+
+if [ "$OUTPUT_FORMAT" = "json" ]; then
+  git -C "$WORKTREE_PATH" add "$LOG_FILE"
+  emit_json_packet
+  exit 0
+fi
+
+if [ "${CHAT_COPY_PROMPT:-copy}" = "skip" ]; then
+  print_first_prompt
+elif command -v clip.exe >/dev/null 2>&1; then
+  copy_first_prompt_with_retry "clip.exe" clip.exe || print_first_prompt
+elif command -v pbcopy >/dev/null 2>&1; then
+  copy_first_prompt_with_retry "pbcopy" pbcopy || print_first_prompt
+elif command -v xclip >/dev/null 2>&1; then
+  copy_first_prompt_with_retry "xclip" xclip -selection clipboard || print_first_prompt
+else
+  print_first_prompt
+fi
+
+case "${CHAT_CLEANUP_EMPTY_BRANCHES:-apply}" in
+  apply)
+    echo "Cleaning up empty chat branches..."
+    bash scripts/00.chat/git/cleanup-empty-chat-branches/script.sh --apply
+    ;;
+  dry-run)
+    echo "Previewing empty chat branch cleanup..."
+    bash scripts/00.chat/git/cleanup-empty-chat-branches/script.sh --dry-run
+    ;;
+  0|false|no|skip)
+    echo "Skipping empty chat branch cleanup."
+    ;;
+  *)
+    echo "ERROR: invalid CHAT_CLEANUP_EMPTY_BRANCHES value: ${CHAT_CLEANUP_EMPTY_BRANCHES}" >&2
+    echo "Use apply, dry-run, skip, 0, false, or no." >&2
+    exit 2
+    ;;
+esac
+
+git -C "$WORKTREE_PATH" add "$LOG_FILE"