docs: update docs and test behavior for --pre

cmd/dbc/completions/dbc.fish

@@ -75,7 +75,7 @@ complete -f -c dbc -n '__fish_dbc_using_subcommand search' -s h -d 'Help'
 complete -f -c dbc -n '__fish_dbc_using_subcommand search' -l help -d 'Help'
 complete -f -c dbc -n '__fish_dbc_using_subcommand search' -s v -d 'Verbose'
 complete -f -c dbc -n '__fish_dbc_using_subcommand search' -l json -d 'Print output as JSON instead of plaintext'
-complete -f -c dbc -n '__fish_dbc_using_subcommand search' -l pre -d 'Include pre-release drivers and versions (hidden by default)'
+complete -f -c dbc -n '__fish_dbc_using_subcommand search' -l pre -d 'Include pre-release drivers and versions (hidden by default unless already installed)'
 
 # remove subcommand
 complete -f -c dbc -n '__fish_dbc_using_subcommand remove' -s h -d 'Help'

cmd/dbc/completions/dbc.zsh

@@ -124,7 +124,7 @@ function _dbc_search_completions {
         '(-h)--help[Help]' \
         '-v[verbose]' \
         '--json[Print output as JSON instead of plaintext]' \
-        '--pre[Include pre-release drivers and versions (hidden by default)]' \
+        '--pre[Include pre-release drivers and versions (hidden by default unless already installed)]' \
         ':search term: '
 }
 

cmd/dbc/search.go

@@ -40,7 +40,7 @@ type SearchCmd struct {
 	Verbose bool           `arg:"-v" help:"Enable verbose output"`
 	Json    bool           `help:"Print output as JSON instead of plaintext"`
 	Pattern *regexp.Regexp `arg:"positional" help:"Pattern to search for"`
-	Pre     bool           `arg:"--pre" help:"Include pre-release drivers and versions (hidden by default)"`
+	Pre     bool           `arg:"--pre" help:"Include pre-release drivers and versions (hidden by default unless already installed)"`
 }
 
 func (s SearchCmd) GetModelCustom(baseModel baseModel) tea.Model {

cmd/dbc/search_test.go

@@ -210,6 +210,43 @@ func (suite *SubcommandTestSuite) TestSearchCmdWithInstalledPre() {
 			"test-driver-docs-url         This is manifest-only with its docs_url key set                                                                                   ", suite.runCmd(m))
 }
 
+func (suite *SubcommandTestSuite) TestSearchCmdVerboseWithInstalledPre() {
+	m := InstallCmd{Driver: "test-driver-only-pre", Level: config.ConfigEnv, Pre: true}.
+		GetModelCustom(baseModel{getDriverRegistry: getTestDriverRegistry, downloadPkg: downloadTestPkg})
+	suite.runCmd(m)
+
+	// Verbose search WITHOUT --pre: installed pre-release driver should still appear
+	m = SearchCmd{Verbose: true}.GetModelCustom(
+		baseModel{getDriverRegistry: getTestDriverRegistry,
+			downloadPkg: downloadTestPkg})
+	out := suite.runCmd(m)
+
+	suite.Contains(out, "test-driver-only-pre")
+	suite.Contains(out, "Test Driver Only Prerelease")
+	suite.Contains(out, "Installed Versions:")
+	suite.Contains(out, "0.9.0-alpha.1")
+	suite.Contains(out, "test-driver-1")
+	suite.Contains(out, "test-driver-2")
+}
+
+func (suite *SubcommandTestSuite) TestSearchCmdWithInstalledPreJSON() {
+	m := InstallCmd{Driver: "test-driver-only-pre", Level: config.ConfigEnv, Pre: true}.
+		GetModelCustom(baseModel{getDriverRegistry: getTestDriverRegistry, downloadPkg: downloadTestPkg})
+	suite.runCmd(m)
+
+	// JSON search WITHOUT --pre: installed pre-release driver should still appear
+	m = SearchCmd{Json: true}.GetModelCustom(
+		baseModel{getDriverRegistry: getTestDriverRegistry,
+			downloadPkg: downloadTestPkg})
+	out := suite.runCmd(m)
+
+	suite.Contains(out, `"test-driver-only-pre"`)
+	suite.Contains(out, `"installed"`)
+	suite.Contains(out, `0.9.0-alpha.1`)
+	suite.Contains(out, `"test-driver-1"`)
+	suite.Contains(out, `"test-driver-2"`)
+}
+
 func (suite *SubcommandTestSuite) TestSearchCmdPartialRegistryFailure() {
 	// Test that search command handles partial registry failure gracefully
 	// (one registry succeeds, another fails - returns both drivers and error)

docs/guides/finding_drivers.md

@@ -208,7 +208,7 @@ $ dbc search --pre
 
 Without `--pre`, `dbc search` will:
 
-- Hide drivers that have exclusively pre-release versions (no stable versions)
+- Hide drivers that have exclusively pre-release versions (no stable versions), unless the driver is already installed
 - Exclude pre-release versions from the available versions list
 
 With `--pre`, `dbc search` will:

docs/reference/cli.md

@@ -73,7 +73,7 @@ $ dbc search [PATTERN]
 
 `--pre` {{ since_version('v0.2.0') }}
 
-:   Include pre-release drivers and versions (hidden by default)
+:   Include pre-release drivers and versions (hidden by default unless already installed)
 
 `--verbose`, `-v`