pleaseai · amondnet · Jun 22, 2026 · Jun 22, 2026 · gemini-code-assist · Jun 22, 2026
diff --git a/.github/workflows/release-please.yml b/.github/workflows/release-please.yml
@@ -276,3 +276,35 @@ jobs:
           git push origin main
         env:
           GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
+
+  # Publish the `code-search-please` library crate to crates.io via Trusted
+  # Publishing (OIDC) — no CARGO_REGISTRY_TOKEN. Gated on the CRATES_IO_PUBLISH
+  # repo variable so it stays dormant until the one-time bootstrap is done:
+  # (1) claim the name with a manual `cargo publish` (crates.io TP can't be
+  # configured on a crate that doesn't exist yet), (2) add a GitHub Actions
+  # trusted publisher on crates.io (repo pleaseai/code-search, workflow
+  # release-please.yml), (3) set the repo variable CRATES_IO_PUBLISH=true.
+  # The CLI crate (code-search-please-cli) is a follow-up — it needs
+  # intra-workspace dependency-version management before it can publish.
+  publish-crate:
+    needs: [release-please]
+    if: ${{ needs.release-please.outputs.release_created && vars.CRATES_IO_PUBLISH == 'true' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout the released tag
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+        with:
+          ref: ${{ needs.release-please.outputs.tag_name }}
+          persist-credentials: false
+
+      - name: Authenticate to crates.io (Trusted Publishing)
+        uses: rust-lang/crates-io-auth-action@c6f97d42243bad5fab37ca0427f495c86d5b1a18 # v1.0.5
+        id: auth
+
+      - name: Publish code-search-please
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}
+        run: cargo publish -p code-search-please --locked
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -17,7 +17,9 @@ authors = ["csp maintainers"]
 # Planned dependency menu (ADR-0003 crate mapping). Member crates opt in
 # phase by phase with `<dep>.workspace = true`; listing here does not fetch.
 [workspace.dependencies]
-csp = { path = "crates/csp" }
+# Published as `code-search-please`; the `csp` key keeps `use csp::...` working
+# in member crates (the lib name stays `csp` via crates/csp `[lib]`).
+csp = { path = "crates/csp", package = "code-search-please" }
 model2vec-rs = "0.2"   # Phase 3 — dense embeddings (official MinishLab port)
 tree-sitter = "0.26"   # Phase 2 — AST chunking
 ignore = "0.4"         # Phase 3 — .gitignore / .cspignore file walking

diff --git a/crates/csp/Cargo.toml b/crates/csp/Cargo.toml
@@ -1,11 +1,23 @@
+# Published to crates.io as `code-search-please` because the short name `csp`
+# is already taken by an unrelated crate. The library name stays `csp` (see
+# `[lib]`), so downstream code still writes `use csp::...` — matching the README
+# example and the `@pleaseai/csp` npm package.
 [package]
-name = "csp"
+name = "code-search-please"
 description = "Hybrid code search for agents — core library (Rust rewrite of MinishLab/semble)."
 version.workspace = true
 edition.workspace = true
 license.workspace = true
 repository.workspace = true
 authors.workspace = true
+homepage = "https://github.com/pleaseai/code-search"
+documentation = "https://docs.rs/code-search-please"
+readme = "README.md"
+keywords = ["code-search", "search", "embeddings", "bm25", "agents"]
+categories = ["development-tools", "text-processing"]
+
+[lib]
+name = "csp"
 
 [dependencies]
 # Populated per the ADR-0003 migration phases.

diff --git a/crates/csp/README.md b/crates/csp/README.md
@@ -0,0 +1,38 @@
+# code-search-please (`csp`)
+
+Hybrid code search for agents — the core Rust library behind [`@pleaseai/csp`](https://github.com/pleaseai/code-search). A Rust rewrite of [MinishLab/semble](https://github.com/MinishLab/semble).
+
+> Published to crates.io as **`code-search-please`** (the short name `csp` was taken). The library name is `csp`, so you still write `use csp::...`.
+
+## Install
+
+```toml
+[dependencies]
+code-search-please = "0.1"
+```
+
+## Usage
+
+```rust
+use std::path::Path;
+use csp::indexing::index::{CspIndex, LoadOptions, QueryOptions};
+
+// Index a local directory and search it
+let index = CspIndex::from_path(Path::new("./my-project"), &LoadOptions::default())?;
+let results = index.search("save model to disk", &QueryOptions { top_k: Some(3), ..Default::default() });
+
+for r in &results {
+    println!("{}:{}-{}", r.chunk.file_path, r.chunk.start_line, r.chunk.end_line);
+}
+# Ok::<(), String>(())
-use std::path::Path;
-use csp::indexing::index::{CspIndex, LoadOptions, QueryOptions};
-
-// Index a local directory and search it
-let index = CspIndex::from_path(Path::new("./my-project"), &LoadOptions::default())?;
-let results = index.search("save model to disk", &QueryOptions { top_k: Some(3), ..Default::default() });
-
-for r in &results {
-    println!("{}:{}-{}", r.chunk.file_path, r.chunk.start_line, r.chunk.end_line);
-}
-# Ok::<(), String>(())
+# fn main() -> Result<(), String> {
+use std::path::Path;
+use csp::indexing::index::{CspIndex, LoadOptions, QueryOptions};
+
+// Index a local directory and search it
+// To make this example runnable, create a dummy directory first: `mkdir my-project`
+let index = CspIndex::from_path(Path::new("./my-project"), &LoadOptions::default())?;
+let results = index.search("save model to disk", &QueryOptions { top_k: Some(3), ..Default::default() });
+
+for r in &results {
+    println!("{}:{}-{}", r.chunk.file_path, r.chunk.start_line, r.chunk.end_line);
+}
+# Ok(())
+# }
-use std::path::Path;
-use csp::indexing::index::{CspIndex, LoadOptions, QueryOptions};
-
-// Index a local directory and search it
-let index = CspIndex::from_path(Path::new("./my-project"), &LoadOptions::default())?;
-let results = index.search("save model to disk", &QueryOptions { top_k: Some(3), ..Default::default() });
-
-for r in &results {
-    println!("{}:{}-{}", r.chunk.file_path, r.chunk.start_line, r.chunk.end_line);
-}
-# Ok::<(), String>(())
+# fn main() -> Result<(), String> {
+use std::path::Path;
+use csp::indexing::index::{CspIndex, LoadOptions, QueryOptions};
+
+// Index a local directory and search it
+// To make this example runnable, create a dummy directory first: `mkdir my-project`
+let index = CspIndex::from_path(Path::new("./my-project"), &LoadOptions::default())?;
+let results = index.search("save model to disk", &QueryOptions { top_k: Some(3), ..Default::default() });
+
+for r in &results {
+    println!("{}:{}-{}", r.chunk.file_path, r.chunk.start_line, r.chunk.end_line);
+}
+# Ok(())
+# }
+```
+
+Hybrid scoring combines Model2Vec dense embeddings with BM25, fused via Reciprocal Rank Fusion. Chunking is tree-sitter AST-based with a line-based fallback.
+
+## CLI / MCP
+
+The `csp` binary (CLI + MCP server) ships via npm (`bunx @pleaseai/csp`) and Homebrew. See the [repository README](https://github.com/pleaseai/code-search) for the full surface.
+
+## License
+
+MIT. This is a derivative work of [MinishLab/semble](https://github.com/MinishLab/semble); see the repository for credits and citation.