feat(dso-ojbb): implement --dryrun flag in dso-setup.sh (TDD GREEN)

Add --dryrun mode to scripts/dso-setup.sh. When invoked with --dryrun,
the script previews all planned actions without making filesystem changes.

- Pre-scan args loop to detect --dryrun (position-independent)
- Strip --dryrun from positional args before set -- processing
- Guard all 5 action blocks with DRYRUN check (shim copy, config write,
  pre-commit copy, ci.yml copy, pre-commit install, git init)
- Dryrun else branches print [dryrun] Would ... preview messages
- Print/show blocks (env guidance, next steps, optional deps) remain
  unconditional as specified
- All 26 tests pass (21 existing + 5 new dryrun tests)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: JoeOakhartNava

.tickets/.index.json

@@ -219,6 +219,13 @@
     "title": "Implementation planning tradeoffs",
     "type": "epic"
   },
+  "dso-gul1": {
+    "deps": [],
+    "priority": 3,
+    "status": "open",
+    "title": "Fix: exclude .worktree-blackboard.json timestamp churn from review diffs",
+    "type": "bug"
+  },
   "dso-hq8y": {
     "deps": [],
     "priority": 2,
@@ -277,6 +284,13 @@
     "title": "Retro skill should include an overall visual review",
     "type": "epic"
   },
+  "dso-meet": {
+    "deps": [],
+    "priority": 3,
+    "status": "open",
+    "title": "Fix: dso-setup.sh dryrun messages should reflect conditional copy logic (only if absent)",
+    "type": "bug"
+  },
   "dso-o8bw": {
     "deps": [],
     "priority": 1,
@@ -475,6 +489,13 @@
     "title": "As a DSO contributor, I can verify shim reliability via automated cross-context smoke test",
     "type": "story"
   },
+  "dso-yh8q": {
+    "deps": [],
+    "priority": 3,
+    "status": "open",
+    "title": "Fix: dso-setup.sh dryrun pre-commit message should check pre-commit availability",
+    "type": "bug"
+  },
   "dso-zc6s": {
     "deps": [
       "dso-60hd",

.tickets/.sync-state.json

@@ -227,6 +227,6 @@
     "jira_hash": "b2fcb1e44695c32874c75055e4b8c9e8",
     "last_synced": "2026-03-17T18:34:36Z"
   },
-  "last_sync_commit": "9339dafec863c3c76ecce611e84d269099ff1a53",
-  "last_pull_timestamp": "2026-03-18T16:21:09Z"
+  "last_sync_commit": "97483c86e09d1e7aeda3f7c78973648c0740747c",
+  "last_pull_timestamp": "2026-03-18T16:35:34Z"
 }

.tickets/dso-tisu.md

@@ -1,6 +1,6 @@
 ---
 id: dso-tisu
-status: open
+status: in_progress
 deps: [dso-yncv]
 links: []
 created: 2026-03-18T16:05:22Z
@@ -44,3 +44,33 @@ Implementation:
 - [ ] ruff check passes (exit 0)
   Verify: cd $(git rev-parse --show-toplevel) && ruff check scripts/*.py tests/**/*.py
 
+
+## Notes
+
+**2026-03-18T16:32:02Z**
+
+CHECKPOINT 1/6: Task context loaded ✓
+
+**2026-03-18T16:32:05Z**
+
+CHECKPOINT 2/6: Code patterns understood ✓
+
+**2026-03-18T16:32:24Z**
+
+CHECKPOINT 3/6: Tests written ✓ (already from TDD RED — confirmed 5 dryrun tests failing)
+
+**2026-03-18T16:32:50Z**
+
+CHECKPOINT 4/6: Implementation complete ✓
+
+**2026-03-18T16:33:11Z**
+
+CHECKPOINT 5/6: Validation passed ✓ — 26/26 tests pass, ruff clean
+
+**2026-03-18T16:33:37Z**
+
+CHECKPOINT 6/6: Done ✓ — All 5 AC verified: AC1 pass, AC2 pass, AC3 pass, AC4 pass, AC5 pass
+
+**2026-03-18T16:41:33Z**
+
+CHECKPOINT 6/6: Done ✓ — Files: scripts/dso-setup.sh. Tests: 26 passed, 0 failed. Review passed after fix (git init guard added).

.tickets/dso-yncv.md

@@ -1,6 +1,6 @@
 ---
 id: dso-yncv
-status: in_progress
+status: closed
 deps: []
 links: []
 created: 2026-03-18T16:05:03Z

.worktree-blackboard.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "batch_id": "batch-1773850609-82930",
-  "created_at": "2026-03-18T16:16:49Z",
+  "batch_id": "batch-1773851476-14182",
+  "created_at": "2026-03-18T16:31:16Z",
   "agents": []
 }

scripts/dso-setup.sh

@@ -86,41 +86,74 @@ detect_prerequisites() {
 
 _prereq_warnings=$(detect_prerequisites)
 
+# ── Parse --dryrun flag (position-independent) ────────────────────────────────
+DRYRUN=''
+_args_filtered=()
+for _arg in "$@"; do
+    if [[ "$_arg" == '--dryrun' ]]; then
+        DRYRUN=1
+    else
+        _args_filtered+=("$_arg")
+    fi
+done
+set -- "${_args_filtered[@]+"${_args_filtered[@]}"}"
+
 TARGET_REPO="${1:-$(git rev-parse --show-toplevel)}"
 PLUGIN_ROOT="${2:-$(cd "$(dirname "$0")/.." && pwd)}"
 
 # Ensure TARGET_REPO is a git repository so the dso shim can locate
 # workflow-config.conf via `git rev-parse --show-toplevel`.
 if ! git -C "$TARGET_REPO" rev-parse --show-toplevel >/dev/null 2>&1; then
-    git -C "$TARGET_REPO" init -q
+    if [[ -z "$DRYRUN" ]]; then
+        git -C "$TARGET_REPO" init -q
+    else
+        echo "[dryrun] Would run: git init -q in $TARGET_REPO"
+    fi
 fi
 
-mkdir -p "$TARGET_REPO/.claude/scripts/"
-cp "$PLUGIN_ROOT/templates/host-project/dso" "$TARGET_REPO/.claude/scripts/dso"
-chmod +x "$TARGET_REPO/.claude/scripts/dso"
+if [[ -z "$DRYRUN" ]]; then
+    mkdir -p "$TARGET_REPO/.claude/scripts/"
+    cp "$PLUGIN_ROOT/templates/host-project/dso" "$TARGET_REPO/.claude/scripts/dso"
+    chmod +x "$TARGET_REPO/.claude/scripts/dso"
+else
+    echo "[dryrun] Would copy $PLUGIN_ROOT/templates/host-project/dso -> $TARGET_REPO/.claude/scripts/dso (chmod +x)"
+fi
 
 CONFIG="$TARGET_REPO/workflow-config.conf"
-if grep -q '^dso\.plugin_root=' "$CONFIG" 2>/dev/null; then
-    # Update existing entry (idempotent)
-    sed -i.bak "s|^dso\.plugin_root=.*|dso.plugin_root=$PLUGIN_ROOT|" "$CONFIG" && rm -f "$CONFIG.bak"
+if [[ -z "$DRYRUN" ]]; then
+    if grep -q '^dso\.plugin_root=' "$CONFIG" 2>/dev/null; then
+        # Update existing entry (idempotent)
+        sed -i.bak "s|^dso\.plugin_root=.*|dso.plugin_root=$PLUGIN_ROOT|" "$CONFIG" && rm -f "$CONFIG.bak"
+    else
+        printf 'dso.plugin_root=%s\n' "$PLUGIN_ROOT" >> "$CONFIG"
+    fi
 else
-    printf 'dso.plugin_root=%s\n' "$PLUGIN_ROOT" >> "$CONFIG"
+    echo "[dryrun] Would write dso.plugin_root=$PLUGIN_ROOT to $CONFIG"
 fi
 
 # ── Copy example config files (only if absent — never overwrite) ──────────────
 TARGET_PRECOMMIT="$TARGET_REPO/.pre-commit-config.yaml"
-if [ ! -f "$TARGET_PRECOMMIT" ]; then
-    cp "$PLUGIN_ROOT/examples/pre-commit-config.example.yaml" "$TARGET_PRECOMMIT"
-fi
+if [[ -z "$DRYRUN" ]]; then
+    if [ ! -f "$TARGET_PRECOMMIT" ]; then
+        cp "$PLUGIN_ROOT/examples/pre-commit-config.example.yaml" "$TARGET_PRECOMMIT"
+    fi
 
-mkdir -p "$TARGET_REPO/.github/workflows"
-if [ ! -f "$TARGET_REPO/.github/workflows/ci.yml" ]; then
-    cp "$PLUGIN_ROOT/examples/ci.example.yml" "$TARGET_REPO/.github/workflows/ci.yml"
+    mkdir -p "$TARGET_REPO/.github/workflows"
+    if [ ! -f "$TARGET_REPO/.github/workflows/ci.yml" ]; then
+        cp "$PLUGIN_ROOT/examples/ci.example.yml" "$TARGET_REPO/.github/workflows/ci.yml"
+    fi
+else
+    echo "[dryrun] Would copy pre-commit-config.example.yaml -> $TARGET_PRECOMMIT"
+    echo "[dryrun] Would copy ci.example.yml -> $TARGET_REPO/.github/workflows/ci.yml"
 fi
 
 # ── Register pre-commit hooks (must come AFTER config copy) ───────────────────
-if command -v pre-commit >/dev/null 2>&1 && [ -f "$TARGET_PRECOMMIT" ]; then
-    (cd "$TARGET_REPO" && pre-commit install && pre-commit install --hook-type pre-push) || true
+if [[ -z "$DRYRUN" ]]; then
+    if command -v pre-commit >/dev/null 2>&1 && [ -f "$TARGET_PRECOMMIT" ]; then
+        (cd "$TARGET_REPO" && pre-commit install && pre-commit install --hook-type pre-push) || true
+    fi
+else
+    echo "[dryrun] Would run: pre-commit install && pre-commit install --hook-type pre-push"
 fi
 
 # ── Optional dependency detection (non-blocking) ──────────────────────────────