refactor: address code review findings and bump to beta.5

- Extract shared executeBatch<T>() in batch-operations.ts (264→127 lines)
- Extract pool initialization logic to pool-initialization.ts (332→225 lines)
- Extract batch handler from taglib-worker.ts (257→143 lines)
- Remove stale build-dual.sh reference in setup-dev-env.sh
- Bump version to 1.0.0-beta.5
- Fix CHANGELOG accuracy
- Install beads git hooks

Author: CharlesWiltgen

.githooks/post-checkout

@@ -0,0 +1,23 @@
+#!/usr/bin/env sh
+# bd-shim v1
+# bd-hooks-version: 0.49.6
+#
+# bd (beads) post-checkout hook - thin shim
+#
+# This shim delegates to 'bd hook post-checkout' which contains
+# the actual hook logic. This pattern ensures hook behavior is always
+# in sync with the installed bd version - no manual updates needed.
+#
+# The 'bd hook' command (singular) supports:
+# - Guard against frequent firing (only imports if JSONL changed)
+# - Per-worktree state tracking
+# - Dolt branch-then-merge pattern
+# - Hook chaining configuration
+
+# Check if bd is available
+if ! command -v bd >/dev/null 2>&1; then
+    # Silently skip - post-checkout is called frequently
+    exit 0
+fi
+
+exec bd hook post-checkout "$@"

.githooks/post-merge

@@ -1,64 +1,24 @@
-#!/bin/sh
+#!/usr/bin/env sh
+# bd-shim v1
+# bd-hooks-version: 0.49.6
 #
-# bd (beads) post-merge hook (chained)
+# bd (beads) post-merge hook - thin shim
 #
-# This hook chains bd functionality with your existing post-merge hook.
-
-# Run existing hook first
-if [ -x "" ]; then
-    "" "$@"
-    EXIT_CODE=$?
-    if [ $EXIT_CODE -ne 0 ]; then
-        exit $EXIT_CODE
-    fi
-fi
+# This shim delegates to 'bd hook post-merge' which contains
+# the actual hook logic. This pattern ensures hook behavior is always
+# in sync with the installed bd version - no manual updates needed.
+#
+# The 'bd hook' command (singular) supports:
+# - Branch-then-merge pattern for Dolt (cell-level conflict resolution)
+# - Per-worktree state tracking
+# - Hook chaining configuration
 
 # Check if bd is available
 if ! command -v bd >/dev/null 2>&1; then
-    echo "Warning: bd command not found, skipping post-merge import" >&2
-    exit 0
-fi
-
-# Check if we're in a bd workspace
-# For worktrees, .beads is in the main repository root, not the worktree
-BEADS_DIR=""
-if git rev-parse --git-dir >/dev/null 2>&1; then
-    # Check if we're in a worktree
-    if [ "$(git rev-parse --git-dir)" != "$(git rev-parse --git-common-dir)" ]; then
-        # Worktree: .beads is in main repo root
-        MAIN_REPO_ROOT="$(git rev-parse --git-common-dir)"
-        MAIN_REPO_ROOT="$(dirname "$MAIN_REPO_ROOT")"
-        if [ -d "$MAIN_REPO_ROOT/.beads" ]; then
-            BEADS_DIR="$MAIN_REPO_ROOT/.beads"
-        fi
-    else
-        # Regular repo: check current directory
-        if [ -d .beads ]; then
-            BEADS_DIR=".beads"
-        fi
-    fi
-fi
-
-if [ -z "$BEADS_DIR" ]; then
+    echo "Warning: bd command not found in PATH, skipping post-merge hook" >&2
+    echo "  Install bd: brew install beads" >&2
+    echo "  Or add bd to your PATH" >&2
     exit 0
 fi
 
-# Skip for Dolt backend (uses its own sync mechanism, not JSONL import)
-if [ -f "$BEADS_DIR/metadata.json" ]; then
-    if grep -q '"backend"[[:space:]]*:[[:space:]]*"dolt"' "$BEADS_DIR/metadata.json" 2>/dev/null; then
-        exit 0
-    fi
-fi
-
-# Check if issues.jsonl exists and was updated
-if [ ! -f "$BEADS_DIR/issues.jsonl" ]; then
-    exit 0
-fi
-
-# Import the updated JSONL
-if ! bd import -i "$BEADS_DIR/issues.jsonl" >/dev/null 2>&1; then
-    echo "Warning: Failed to import bd changes after merge" >&2
-    echo "Run 'bd import -i $BEADS_DIR/issues.jsonl' manually to see the error" >&2
-fi
-
-exit 0
+exec bd hook post-merge "$@"

.githooks/pre-commit

@@ -1,73 +1,24 @@
-#!/bin/sh
+#!/usr/bin/env sh
+# bd-shim v1
+# bd-hooks-version: 0.49.6
 #
-# bd (beads) pre-commit hook (chained)
+# bd (beads) pre-commit hook - thin shim
 #
-# This hook chains bd functionality with your existing pre-commit hook.
-
-# Run existing hook first
-if [ -x "/Users/Charles/Projects/taglib-wasm/.githooks/pre-commit.old" ]; then
-    "/Users/Charles/Projects/taglib-wasm/.githooks/pre-commit.old" "$@"
-    EXIT_CODE=$?
-    if [ $EXIT_CODE -ne 0 ]; then
-        exit $EXIT_CODE
-    fi
-fi
+# This shim delegates to 'bd hook pre-commit' which contains
+# the actual hook logic. This pattern ensures hook behavior is always
+# in sync with the installed bd version - no manual updates needed.
+#
+# The 'bd hook' command (singular) supports:
+# - Per-worktree export state tracking
+# - Dolt branch-then-merge pattern for cell-level conflict resolution
+# - Hook chaining configuration
 
 # Check if bd is available
 if ! command -v bd >/dev/null 2>&1; then
-    echo "Warning: bd command not found, skipping pre-commit flush" >&2
-    exit 0
-fi
-
-# Check if we're in a bd workspace
-# For worktrees, .beads is in the main repository root, not the worktree
-BEADS_DIR=""
-if git rev-parse --git-dir >/dev/null 2>&1; then
-    # Check if we're in a worktree
-    if [ "$(git rev-parse --git-dir)" != "$(git rev-parse --git-common-dir)" ]; then
-        # Worktree: .beads is in main repo root
-        MAIN_REPO_ROOT="$(git rev-parse --git-common-dir)"
-        MAIN_REPO_ROOT="$(dirname "$MAIN_REPO_ROOT")"
-        if [ -d "$MAIN_REPO_ROOT/.beads" ]; then
-            BEADS_DIR="$MAIN_REPO_ROOT/.beads"
-        fi
-    else
-        # Regular repo: check current directory
-        if [ -d .beads ]; then
-            BEADS_DIR=".beads"
-        fi
-    fi
-fi
-
-if [ -z "$BEADS_DIR" ]; then
+    echo "Warning: bd command not found in PATH, skipping pre-commit hook" >&2
+    echo "  Install bd: brew install beads" >&2
+    echo "  Or add bd to your PATH" >&2
     exit 0
 fi
 
-# Skip for Dolt backend (uses its own sync mechanism, not JSONL)
-if [ -f "$BEADS_DIR/metadata.json" ]; then
-    if grep -q '"backend"[[:space:]]*:[[:space:]]*"dolt"' "$BEADS_DIR/metadata.json" 2>/dev/null; then
-        exit 0
-    fi
-fi
-
-# Flush pending changes to JSONL
-if ! bd sync --flush-only >/dev/null 2>&1; then
-    echo "Error: Failed to flush bd changes to storage" >&2
-    echo "Run 'bd sync --flush-only' manually to diagnose" >&2
-    exit 1
-fi
-
-# If the JSONL file was modified, stage it
-# For worktrees, the JSONL is in the main repo's working tree, not the worktree,
-# so we can't use git add. Skip this step for worktrees.
-if [ -f "$BEADS_DIR/issues.jsonl" ]; then
-    if [ "$(git rev-parse --git-dir)" = "$(git rev-parse --git-common-dir)" ]; then
-        # Regular repo: file is in the working tree, safe to add
-        git add "$BEADS_DIR/issues.jsonl" 2>/dev/null || true
-    fi
-    # For worktrees: .beads is in the main repo's working tree, not this worktree
-    # Git rejects adding files outside the worktree, so we skip it.
-    # The main repo will see the changes on the next pull/sync.
-fi
-
-exit 0
+exec bd hook pre-commit "$@"

.githooks/pre-push

@@ -0,0 +1,19 @@
+#!/usr/bin/env sh
+# bd-shim v1
+# bd-hooks-version: 0.49.6
+#
+# bd (beads) pre-push hook - thin shim
+#
+# This shim delegates to 'bd hooks run pre-push' which contains
+# the actual hook logic. This pattern ensures hook behavior is always
+# in sync with the installed bd version - no manual updates needed.
+
+# Check if bd is available
+if ! command -v bd >/dev/null 2>&1; then
+    echo "Warning: bd command not found in PATH, skipping pre-push hook" >&2
+    echo "  Install bd: brew install beads" >&2
+    echo "  Or add bd to your PATH" >&2
+    exit 0
+fi
+
+exec bd hooks run pre-push "$@"

.githooks/prepare-commit-msg

@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+# bd-shim v1
+# bd-hooks-version: 0.48.0
+#
+# bd (beads) prepare-commit-msg hook - thin shim
+#
+# This shim delegates to 'bd hooks run prepare-commit-msg' which contains
+# the actual hook logic. This pattern ensures hook behavior is always
+# in sync with the installed bd version - no manual updates needed.
+#
+# Arguments:
+#   $1 = path to the commit message file
+#   $2 = source of commit message (message, template, merge, squash, commit)
+#   $3 = commit SHA-1 (if -c, -C, or --amend)
+
+# Check if bd is available
+if ! command -v bd >/dev/null 2>&1; then
+    echo "Warning: bd command not found in PATH, skipping prepare-commit-msg hook" >&2
+    echo "  Install bd: brew install beads" >&2
+    echo "  Or add bd to your PATH" >&2
+    exit 0
+fi
+
+exec bd hooks run prepare-commit-msg "$@"

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 1.0.0
+## 1.0.0-beta.5
 
 ### Breaking Changes
 
@@ -28,6 +28,7 @@
 ### Internal
 
 - Migrated all tests to BDD syntax (135 tests passing)
-- Split 10 oversized source files into directory modules (all under 250 lines)
+- Split 10 oversized source files into directory modules
+- Deduplicated batch operation scaffolding with shared `executeBatch` helper
 - Removed stale build scripts and migration guides
 - Updated SonarCloud configuration

build/setup-dev-env.sh

@@ -305,18 +305,15 @@ echo "━━━━━━━━━━━━━━━━━━━━━━━━
 echo ""
 echo "Next steps:"
 echo ""
-echo "1. Build both targets:"
-echo -e "   ${CYAN}./build/build-dual.sh${NC}"
-echo ""
-echo "2. Build Emscripten only:"
+echo "1. Build Emscripten:"
 echo -e "   ${CYAN}./build/build-emscripten.sh${NC}"
 echo ""
-echo "3. Build WASI only:"
+echo "2. Build WASI:"
 echo -e "   ${CYAN}source ./build/wasi-env.sh${NC}"
 echo -e "   ${CYAN}./build/build-wasi.sh${NC}"
 echo ""
-echo "4. Run tests:"
-echo -e "   ${CYAN}npm test${NC}          # Node.js tests"
+echo "3. Run tests:"
+echo -e "   ${CYAN}deno task test${NC}"
 echo -e "   ${CYAN}deno task test${NC}    # Deno tests"
 echo -e "   ${CYAN}bun test${NC}          # Bun tests"
 echo ""

deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@charlesw/taglib-wasm",
-  "version": "1.0.0",
+  "version": "1.0.0-beta.5",
   "description": "TagLib-Wasm is the universal tagging library for TypeScript/JavaScript platforms: Browsers, Node.js, Deno, Bun, Cloudflare Workers, and Electron apps",
   "license": "MIT",
   "nodeModulesDir": "auto",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "taglib-wasm",
-  "version": "1.0.0",
+  "version": "1.0.0-beta.5",
   "description": "TagLib-Wasm is the universal tagging library for TypeScript/JavaScript platforms: Browsers, Node.js, Deno, Bun, Cloudflare Workers, and Electron apps",
   "type": "module",
   "main": "dist/index.js",

sonar-project.properties

@@ -5,7 +5,7 @@
 sonar.projectKey=CharlesWiltgen_taglib-wasm
 sonar.organization=charles-wiltgen
 sonar.projectName=taglib-wasm
-sonar.projectVersion=1.0.0
+sonar.projectVersion=1.0.0-beta.5
 
 # Source code configuration
 sonar.sources=src,index.ts,mod.ts,simple.ts,workers.ts