fix: respect hierarchy.max-depth config setting (GH#995) (#997)

* fix: respect hierarchy.max-depth config setting (GH#995)

The hierarchy.max-depth config setting was being ignored because storage
implementations had the depth limit hardcoded to 3. This fix:

- Registers hierarchy.max-depth default (3) in config initialization
- Adds hierarchy.max-depth to yaml-only keys for config.yaml storage
- Updates SQLite and Memory storage to read max depth from config
- Adds validation to reject hierarchy.max-depth values < 1
- Adds tests for configurable hierarchy depth

Users can now set deeper hierarchies:
  bd config set hierarchy.max-depth 10

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* refactor: extract shared CheckHierarchyDepth function (GH#995)

- Extract duplicated depth-checking logic to types.CheckHierarchyDepth()
- Update sqlite and memory storage backends to use shared function
- Add t.Cleanup() for proper test isolation in sqlite test
- Add equivalent test coverage for memory storage backend
- Add comprehensive unit tests for CheckHierarchyDepth function

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

internal/storage/sqlite/child_id_test.go

@@ -5,6 +5,7 @@ import (
 	"os"
 	"testing"
 
+	"github.com/steveyegge/beads/internal/config"
 	"github.com/steveyegge/beads/internal/types"
 )
 
@@ -427,6 +428,81 @@ this is not json either
 	}
 }
 
+// TestGetNextChildID_ConfigurableMaxDepth tests that hierarchy.max-depth config is respected (GH#995)
+func TestGetNextChildID_ConfigurableMaxDepth(t *testing.T) {
+	// Initialize config for testing
+	if err := config.Initialize(); err != nil {
+		t.Fatalf("failed to initialize config: %v", err)
+	}
+
+	// Ensure config is reset even if test fails or panics
+	t.Cleanup(func() {
+		config.Set("hierarchy.max-depth", 3)
+	})
+
+	tmpFile := t.TempDir() + "/test.db"
+	defer os.Remove(tmpFile)
+	store := newTestStore(t, tmpFile)
+	defer store.Close()
+	ctx := context.Background()
+
+	// Create a chain of issues up to depth 3
+	issues := []struct {
+		id    string
+		title string
+	}{
+		{"bd-depth", "Root"},
+		{"bd-depth.1", "Level 1"},
+		{"bd-depth.1.1", "Level 2"},
+		{"bd-depth.1.1.1", "Level 3"},
+	}
+
+	for _, issue := range issues {
+		iss := &types.Issue{
+			ID:          issue.id,
+			Title:       issue.title,
+			Description: "Test issue",
+			Status:      types.StatusOpen,
+			Priority:    1,
+			IssueType:   types.TypeTask,
+		}
+		if err := store.CreateIssue(ctx, iss, "test"); err != nil {
+			t.Fatalf("failed to create issue %s: %v", issue.id, err)
+		}
+	}
+
+	// Test 1: With default max-depth (3), depth 4 should fail
+	config.Set("hierarchy.max-depth", 3)
+	_, err := store.GetNextChildID(ctx, "bd-depth.1.1.1")
+	if err == nil {
+		t.Errorf("expected error for depth 4 with max-depth=3, got nil")
+	}
+	if err != nil && err.Error() != "maximum hierarchy depth (3) exceeded for parent bd-depth.1.1.1" {
+		t.Errorf("unexpected error message: %v", err)
+	}
+
+	// Test 2: With max-depth=5, depth 4 should succeed
+	config.Set("hierarchy.max-depth", 5)
+	childID, err := store.GetNextChildID(ctx, "bd-depth.1.1.1")
+	if err != nil {
+		t.Errorf("depth 4 should be allowed with max-depth=5, got error: %v", err)
+	}
+	expectedID := "bd-depth.1.1.1.1"
+	if childID != expectedID {
+		t.Errorf("expected %s, got %s", expectedID, childID)
+	}
+
+	// Test 3: With max-depth=2, depth 3 should fail
+	config.Set("hierarchy.max-depth", 2)
+	_, err = store.GetNextChildID(ctx, "bd-depth.1.1")
+	if err == nil {
+		t.Errorf("expected error for depth 3 with max-depth=2, got nil")
+	}
+	if err != nil && err.Error() != "maximum hierarchy depth (2) exceeded for parent bd-depth.1.1" {
+		t.Errorf("unexpected error message: %v", err)
+	}
+}
+
 // TestGetNextChildID_ResurrectParentChain tests resurrection of deeply nested missing parents (bd-ar2.7)
 func TestGetNextChildID_ResurrectParentChain(t *testing.T) {
 	tmpDir := t.TempDir()

internal/storage/sqlite/hash_ids.go

@@ -4,7 +4,9 @@ import (
 	"context"
 	"database/sql"
 	"fmt"
-	"strings"
+
+	"github.com/steveyegge/beads/internal/config"
+	"github.com/steveyegge/beads/internal/types"
 )
 
 // getNextChildNumber atomically increments and returns the next child counter for a parent issue.
@@ -48,19 +50,18 @@ func (s *SQLiteStorage) GetNextChildID(ctx context.Context, parentID string) (st
 			return "", fmt.Errorf("parent issue %s does not exist and could not be resurrected from JSONL history", parentID)
 		}
 	}
-	
-	// Calculate current depth by counting dots
-	depth := strings.Count(parentID, ".")
-	if depth >= 3 {
-		return "", fmt.Errorf("maximum hierarchy depth (3) exceeded for parent %s", parentID)
+
+	// Check hierarchy depth limit (GH#995)
+	if err := types.CheckHierarchyDepth(parentID, config.GetInt("hierarchy.max-depth")); err != nil {
+		return "", err
 	}
-	
+
 	// Get next child number atomically
 	nextNum, err := s.getNextChildNumber(ctx, parentID)
 	if err != nil {
 		return "", err
 	}
-	
+
 	// Format as parentID.counter
 	childID := fmt.Sprintf("%s.%d", parentID, nextNum)
 	return childID, nil