llm-wb 0.1.0-beta.0

package/scripts/00.chat/command/dispatcher/smoke-test.sh

@@ -0,0 +1,168 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.command.dispatcher.smoke-test
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: validation
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Smoke test the chat command dispatcher and chat subcommands.
+#   portability:
+#     class: reusable
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.commands.readme
+#     path: .agentic/00.chat/commands/README.md
+#   - id: chat.workflows.bootstrap-chat-workbench-repo
+#     path: .agentic/00.chat/workflows/bootstrap-chat-workbench-repo.md
+#   - id: chat.script.command.dispatcher.readme
+#     path: scripts/00.chat/command/dispatcher/README.md
+#   effects:
+#   - branches
+#   - worktrees
+#   - writes-files
+
+fail() {
+  echo "FAIL: $*" >&2
+  exit 1
+}
+
+SOURCE_ROOT="$(git rev-parse --show-toplevel)"
+TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/chat-command-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/closeout/build-closeout-prompt" \
+  "$REPO/scripts/00.chat/command/close" \
+  "$REPO/scripts/00.chat/command/dispatcher" \
+  "$REPO/scripts/00.chat/command/new" \
+  "$REPO/scripts/00.chat/command/open-window" \
+  "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches" \
+  "$REPO/scripts/00.chat/session-log/paths" \
+  "$REPO/scripts/00.chat/startup/auto-start-missing-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/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/command/close/script.sh" "$REPO/scripts/00.chat/command/close/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/command/open-window/script.sh" "$REPO/scripts/00.chat/command/open-window/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/worktree/paths/lib.sh" "$REPO/scripts/00.chat/worktree/paths/lib.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/startup/start-chat-session/script.sh" "$REPO/scripts/00.chat/startup/start-chat-session/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/closeout/build-closeout-prompt/script.sh" "$REPO/scripts/00.chat/closeout/build-closeout-prompt/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/git/cleanup-empty-chat-branches/script.sh" "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches/script.sh"
+chmod +x "$REPO/scripts/00.chat/closeout/build-closeout-prompt/script.sh" "$REPO/scripts/00.chat/command/dispatcher/script.sh" "$REPO/scripts/00.chat/command/new/script.sh" "$REPO/scripts/00.chat/command/close/script.sh" "$REPO/scripts/00.chat/command/open-window/script.sh" "$REPO/scripts/00.chat/startup/auto-start-missing-session/script.sh" "$REPO/scripts/00.chat/startup/start-chat-session/script.sh" "$REPO/scripts/00.chat/startup/start-new-chat/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"
+chmod 0644 "$REPO/scripts/00.chat/command/new/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'
+
+CHAT_COPY_PROMPT=skip \
+  bash -c 'cd "$1" && shift && "$@"' sh "$REPO" \
+    bash scripts/00.chat/command/dispatcher/script.sh list \
+    >"$TMP_ROOT/list.out"
+
+grep -q '^  new$' "$TMP_ROOT/list.out" || fail "new command was not listed"
+grep -q '^  close$' "$TMP_ROOT/list.out" || fail "close command was not listed"
+grep -q '^  open-window$' "$TMP_ROOT/list.out" || fail "open-window command was not listed"
+
+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/command/dispatcher/script.sh new "test command-created session" \
+    >"$TMP_ROOT/new.out"
+
+grep -q 'Created branch: chat/' "$TMP_ROOT/new.out" || fail "new command did not create a chat branch"
+grep -q 'Paste this into Codex / Claude / Mistral:' "$TMP_ROOT/new.out" || fail "new command did not print first prompt"
+
+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/auto-start-missing-session/script.sh "test opening prompt session" \
+    >"$TMP_ROOT/auto-start.out"
+
+grep -q 'Created branch: chat/' "$TMP_ROOT/auto-start.out" || fail "auto-start did not create a chat branch"
+grep -q 'Task: test opening prompt session' "$TMP_ROOT/auto-start.out" || fail "auto-start did not use opening prompt as task"
+
+if CHAT_COPY_PROMPT=skip \
+  bash -c 'cd "$1" && shift && "$@"' sh "$REPO" \
+    bash scripts/00.chat/startup/auto-start-missing-session/script.sh new \
+    >"$TMP_ROOT/bare-new.out"; then
+  fail "bare new auto-start unexpectedly succeeded"
+fi
+
+grep -Fxq 'What should the new chat be about?' "$TMP_ROOT/bare-new.out" || fail "bare new did not ask for a task summary"
+
+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 "new command did not create a chat worktree"
+fi
+
+FAKE_BIN="$TMP_ROOT/fake-bin"
+mkdir -p "$FAKE_BIN"
+cat > "$FAKE_BIN/code" <<'EOF'
+#!/usr/bin/env bash
+printf '%s\n' "$*" > "$CODE_ARGS_FILE"
+EOF
+chmod +x "$FAKE_BIN/code"
+
+CODE_ARGS_FILE="$TMP_ROOT/code-args.out" \
+PATH="$FAKE_BIN:$PATH" \
+  bash -c 'cd "$1" && shift && "$@"' sh "$worktree_path" \
+    bash scripts/00.chat/command/dispatcher/script.sh open window \
+    >"$TMP_ROOT/open-window.out"
+
+grep -q '^Opened VS Code window: ' "$TMP_ROOT/open-window.out" \
+  || fail "open window command did not report opened worktree"
+grep -q -- '^--new-window ' "$TMP_ROOT/code-args.out" \
+  || fail "open window command did not call code with the chat worktree"
+
+CHAT_COPY_PROMPT=skip \
+  bash -c 'cd "$1" && shift && "$@"' sh "$worktree_path" \
+    bash scripts/00.chat/command/dispatcher/script.sh close \
+    >"$TMP_ROOT/close.out"
+
+grep -q 'Workflow: .agentic/00.chat/workflows/chat-promote-to-main.md' "$TMP_ROOT/close.out" \
+  || fail "close command did not route to promote workflow"
+grep -q 'Ask for explicit approval before creating any task commit.' "$TMP_ROOT/close.out" \
+  || fail "close command did not preserve commit approval boundary"
+grep -q 'Do not push to origin unless I explicitly approve a separate push.' "$TMP_ROOT/close.out" \
+  || fail "close command did not preserve push approval boundary"
+
+echo "chat command smoke test passed."

package/scripts/00.chat/command/new/README.md

@@ -0,0 +1,32 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.command.new.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: command
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain the public chat new-session command entrypoint.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.script.command.new
+    path: scripts/00.chat/command/new/script.sh
+-->
+# New Command
+
+`script.sh` is the canonical entrypoint for the public `chat:new` command. It
+delegates to `scripts/00.chat/startup/start-new-chat/script.sh`.
+
+The command keeps the public interface small: humans ask for a new chat, and
+startup owns branch creation, worktree creation, session-log initialization,
+chat lifecycle metadata, and terminal handoff. Prompt-level routing and context
+selection are resolved later from the current request, repo assistant
+instructions, and any repo-provided context router if one exists.
+
+This command can create branches, worktrees, and session-log files through the
+startup engine.

package/scripts/00.chat/command/new/script.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.command.new
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: command
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Dispatch the public chat new-session command to the startup capability.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.script.command.dispatcher
+#     path: scripts/00.chat/command/dispatcher/script.sh
+#   effects:
+#   - branches
+#   - stages-files
+#   - worktrees
+#   - writes-files
+
+exec bash scripts/00.chat/startup/start-new-chat/script.sh "$@"

package/scripts/00.chat/command/open-window/README.md

@@ -0,0 +1,38 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.command.open-window.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: command
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain the public chat open-window command entrypoint.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.script.command.open-window
+    path: scripts/00.chat/command/open-window/script.sh
+-->
+# Open Window Command
+
+`script.sh` is the canonical entrypoint for opening the current chat-owned
+worktree in a new VS Code window.
+
+Run it as:
+
+```bash
+npm run chat -- open window
+```
+
+The hyphenated form also works:
+
+```bash
+npm run chat -- open-window
+```
+
+When run outside a chat branch, pass either a chat worktree path or a session-log
+`README.md` path.

package/scripts/00.chat/command/open-window/script.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.command.open-window
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: command
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Dispatch the public chat open-window command to the worktree window capability.
+#   portability:
+#     class: required
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.script.command.dispatcher
+#     path: scripts/00.chat/command/dispatcher/script.sh
+#   effects:
+#   - read-only
+
+exec bash scripts/00.chat/worktree/open-window/script.sh "$@"

package/scripts/00.chat/command/package-scripts/README.md

@@ -0,0 +1,34 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.command.package-scripts.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: command
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain validation for package.json chat command scripts.
+  portability:
+    class: reusable
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.script.command.package-scripts.smoke-test
+    path: scripts/00.chat/command/package-scripts/smoke-test.sh
+  - id: chat.workflows.bootstrap-chat-workbench-repo
+    path: .agentic/00.chat/workflows/bootstrap-chat-workbench-repo.md
+-->
+# Package Scripts
+
+This capability validates the public `package.json` `chat:*` command surface in
+a throwaway repository.
+
+The smoke test proves that package scripts can find their canonical
+`scripts/00.chat/...` implementations after bootstrap. That matters for a
+standalone workbench repo because outside engineers should not need to know the
+internal folder layout before trying the harness.
+
+This is validation tooling only; it is not a runtime command used during normal
+chat work.
+

package/scripts/00.chat/command/package-scripts/smoke-test.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# agentic-artifact:
+#   schema: agentic-artifact/v2
+#   id: chat.script.command.package-scripts.smoke-test
+#   version: 1
+#   status: active
+#   layer: 00.chat
+#   domain: validation
+#   disciplines:
+#   - agentic
+#   kind: script
+#   purpose: Smoke test package.json chat command scripts against a throwaway repo.
+#   portability:
+#     class: reusable
+#     targets:
+#     - llm-workbench
+#   used_by:
+#   - id: chat.workflows.bootstrap-chat-workbench-repo
+#     path: .agentic/00.chat/workflows/bootstrap-chat-workbench-repo.md
+#   - id: chat.script.bootstrap.audit-chat-bootstrap-file-set
+#     path: scripts/00.chat/bootstrap/audit-chat-bootstrap-file-set/script.sh
+#   effects:
+#   - writes-files
+
+fail() {
+  echo "FAIL: $*" >&2
+  exit 1
+}
+
+SOURCE_ROOT="$(git rev-parse --show-toplevel)"
+TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/chat-package-scripts-smoke.XXXXXX")"
+
+cleanup() {
+  rm -rf "$TMP_ROOT"
+}
+
+trap cleanup EXIT
+
+REPO="$TMP_ROOT/repo"
+mkdir -p \
+  "$REPO/scripts/00.chat/closeout/build-closeout-prompt" \
+  "$REPO/scripts/00.chat/command/close" \
+  "$REPO/scripts/00.chat/command/dispatcher" \
+  "$REPO/scripts/00.chat/command/new" \
+  "$REPO/scripts/00.chat/command/open-window" \
+  "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches" \
+  "$REPO/scripts/00.chat/reporting/generate-commit-log-summary" \
+  "$REPO/scripts/00.chat/reporting/report-chat-workspaces" \
+  "$REPO/scripts/00.chat/session-log/paths" \
+  "$REPO/scripts/00.chat/startup/start-new-chat" \
+  "$REPO/scripts/00.chat/worktree/open-window" \
+  "$REPO/scripts/00.chat/worktree/paths" \
+  "$REPO/commitLogs/2026/jun/19/test-chat"
+
+git -C "$REPO" init --quiet --initial-branch=main
+
+cp "$SOURCE_ROOT/package.json" "$REPO/package.json"
+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/command/close/script.sh" "$REPO/scripts/00.chat/command/close/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/command/open-window/script.sh" "$REPO/scripts/00.chat/command/open-window/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/reporting/generate-commit-log-summary/script.sh" "$REPO/scripts/00.chat/reporting/generate-commit-log-summary/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/reporting/report-chat-workspaces/script.sh" "$REPO/scripts/00.chat/reporting/report-chat-workspaces/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/worktree/paths/lib.sh" "$REPO/scripts/00.chat/worktree/paths/lib.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/startup/start-new-chat/script.sh" "$REPO/scripts/00.chat/startup/start-new-chat/script.sh"
+cp "$SOURCE_ROOT/scripts/00.chat/closeout/build-closeout-prompt/script.sh" "$REPO/scripts/00.chat/closeout/build-closeout-prompt/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/closeout/build-closeout-prompt/script.sh" \
+  "$REPO/scripts/00.chat/command/dispatcher/script.sh" \
+  "$REPO/scripts/00.chat/command/new/script.sh" \
+  "$REPO/scripts/00.chat/command/close/script.sh" \
+  "$REPO/scripts/00.chat/command/open-window/script.sh" \
+  "$REPO/scripts/00.chat/reporting/generate-commit-log-summary/script.sh" \
+  "$REPO/scripts/00.chat/reporting/report-chat-workspaces/script.sh" \
+  "$REPO/scripts/00.chat/worktree/open-window/script.sh" \
+  "$REPO/scripts/00.chat/startup/start-new-chat/script.sh" \
+  "$REPO/scripts/00.chat/git/cleanup-empty-chat-branches/script.sh"
+
+cat > "$REPO/commitLogs/2026/jun/19/test-chat/README.md" <<'EOF'
+# Chat Session: test-chat
+
+<!-- agentic-session
+id: test-chat
+chat_duration: 10s
+estimated_chat_tokens: 20 tokens
+estimated_chat_cost: USD 0.0006 estimated from estimated_chat_tokens
+-->
+EOF
+
+git -C "$REPO" add package.json scripts commitLogs
+git -C "$REPO" -c user.name='Smoke Test' -c user.email='smoke@example.invalid' commit --quiet -m 'fixture'
+
+(
+  cd "$REPO"
+  npm run --silent chat:list > "$TMP_ROOT/list.out"
+  npm run --silent chat:commit-log-summary > "$TMP_ROOT/summary.out"
+  npm run --silent chat:cleanup-empty-branches -- --dry-run > "$TMP_ROOT/cleanup.out"
+  CHAT_OPEN_WORKTREE_WINDOW=skip npm run --silent chat:open-window -- "$REPO" > "$TMP_ROOT/open-window.out"
+)
+
+grep -q '^  close$' "$TMP_ROOT/list.out" || fail "chat:list did not list close"
+grep -q '^  new$' "$TMP_ROOT/list.out" || fail "chat:list did not list new"
+grep -q '^  open-window$' "$TMP_ROOT/list.out" || fail "chat:list did not list open-window"
+grep -q '| Total | USD 0.0006 |' "$TMP_ROOT/summary.out" || fail "chat:commit-log-summary did not delegate"
+grep -q 'Mode: dry-run' "$TMP_ROOT/cleanup.out" || fail "chat:cleanup-empty-branches did not delegate"
+grep -q '^Skipping VS Code window open: ' "$TMP_ROOT/open-window.out" || fail "chat:open-window did not delegate"
+
+echo "chat package scripts smoke test passed."

package/scripts/00.chat/git/README.md

@@ -0,0 +1,30 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.git.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: git
+  disciplines:
+  - agentic
+  kind: script-domain-readme
+  purpose: Explain chat-owned Git maintenance scripts.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.workflows.chat-cleanup
+    path: .agentic/00.chat/workflows/chat-cleanup.md
+  - id: chat.script.git.cleanup-empty-chat-branches.readme
+    path: scripts/00.chat/git/cleanup-empty-chat-branches/README.md
+-->
+# Git Scripts
+
+Git scripts in this domain handle chat-owned Git maintenance. They are not
+general-purpose Git wrappers. They exist only where chat lifecycle behavior
+needs deterministic branch or log handling.
+
+Destructive behavior must be explicit and governed. Scripts should default to
+inspection or dry-run when deletion is possible.
+

package/scripts/00.chat/git/cleanup-empty-chat-branches/README.md

@@ -0,0 +1,36 @@
+<!-- agentic-artifact:
+  schema: agentic-artifact/v2
+  id: chat.script.git.cleanup-empty-chat-branches.readme
+  version: 1
+  status: active
+  layer: 00.chat
+  domain: git
+  disciplines:
+  - agentic
+  kind: capability-readme
+  purpose: Explain empty chat branch and session-log cleanup.
+  portability:
+    class: required
+    targets:
+    - llm-workbench
+  used_by:
+  - id: chat.workflows.chat-cleanup
+    path: .agentic/00.chat/workflows/chat-cleanup.md
+  - id: chat.script.git.cleanup-empty-chat-branches
+    path: scripts/00.chat/git/cleanup-empty-chat-branches/script.sh
+-->
+# Cleanup Empty Chat Branches
+
+`script.sh` finds `chat/*` branches with no commits beyond the base branch and
+optionally removes them with their matching empty session logs.
+
+Dry-run is the default. Use `--apply` only when deletion is explicitly approved.
+The script never deletes the current branch and skips branches that are checked
+out in any worktree.
+
+A session log is deleted only when it belongs to the empty branch and contains
+no recorded commits or retention marker. That protects real chat evidence while
+allowing abandoned zero-work sessions to be cleaned up.
+
+`smoke-test.sh` exercises the branch and log safety rules in a throwaway repo.
+