feat(targets): add target-ladybug (Kuzu successor) by Copilot · Pull Request #95 · knitli/recoco

Copilot · 2026-03-13T20:24:43Z

Kuzu (property graph DB) was archived Oct 2025. Ladybug is its actively maintained fork with an identical Cypher API server interface. This adds target-ladybug as a first-class feature-gated target, mirroring the upstream CocoIndex PR #1487.

Changes

ops/targets/ladybug.rs — New file, adapted from kuzu.rs via mechanical Kuzu* → Ladybug* rename. Also fixes a pre-existing typo (cyper_builder → cypher_builder) and updates the doc URL to the LadybugDB GitHub repo.
ops/targets/mod.rs — Adds pub mod ladybug under #[cfg(feature = "target-ladybug")]; extends the pub mod shared any(...) guard.
prelude.rs — Extends the recoco_utils::http re-export guard to include target-ladybug.
ops/registration.rs — Registers LadybugFactory; reqwest_client is now created when either target-kuzu or target-ladybug is enabled. When both features are active, kuzu gets .clone() and ladybug gets the move to satisfy clippy::redundant_clone.
Cargo.toml — Adds target-ladybug = ["dep:reqwest", "recoco-utils/reqwest", "target-neo4j"] (identical deps to target-kuzu); includes it in all-targets and full bundles.

Usage

# Cargo.toml
recoco-core = { features = ["target-ladybug"] }

// Spec is structurally identical to Kuzu — just use "Ladybug" as the target kind
let spec = Spec {
    connection: AuthEntryReference::new("my_ladybug_conn"),
    mapping: GraphElementMapping { ... },
};

The target-kuzu feature remains available; deprecation is a follow-up concern per upstream guidance.

Original prompt

This section details on the original issue you should resolve

<issue_title>[Upstream-Sync] [FEATURE] Add Ladybug target (Kuzu successor) — upstream PR #1487</issue_title>
<issue_description>### Summary

Adapt the upstream new target from cocoindex-io/cocoindex#1487: add Ladybug as a new target-ladybug feature-gated graph database target in Recoco, replacing the archived Kuzu project.

Background

Kuzu (MIT-licensed property graph DB) was archived in October 2025.

Ladybug is its actively maintained fork with an identical Cypher API server interface.

Upstream PR knitli/recoco#1487 adds Ladybug as a first-class target, with a note to eventually retire the Kuzu target.

Recoco already has a full target-kuzu implementation in crates/recoco-core/src/ops/targets/kuzu.rs using the same API server-based thin-client approach.

What changes upstream?

New file: rust/cocoindex/src/ops/targets/ladybug.rs — a near-identical copy of kuzu.rs with all Kuzu* symbols renamed to Ladybug*

rust/cocoindex/src/ops/targets/mod.rs — adds pub mod ladybug

rust/cocoindex/src/ops/registration.rs — registers the Ladybug factory, cloning the reqwest_client

Action for Recoco
Create crates/recoco-core/src/ops/targets/ladybug.rs by adapting the upstream file. This is largely a mechanical rename of kuzu → ladybug, with one API callsite to verify (see note below).
Update crates/recoco-core/src/ops/targets/mod.rs to add:
#[cfg(feature = "target-ladybug")]
pub mod ladybug;
Also update the #[cfg(any(...))] guard on pub mod shared to include target-ladybug.
Update crates/recoco-core/Cargo.toml:

Add target-ladybug feature: target-ladybug = ["dep:reqwest", "recoco-utils/reqwest", "target-neo4j"] (same deps as target-kuzu)

Add target-ladybug to the all-targets and full bundles

Register the Ladybug factory in registration (wherever kuzu::register is called).

Decide on a deprecation or migration path for target-kuzu — upstream recommends retiring Kuzu in favour of Ladybug.
⚠️ API compatibility note

Recoco's kuzu.rs calls http::request(|| ...) (zero-arg closure), while the upstream ladybug.rs calls http::request(&self.reqwest_client, |client| ...) (two-arg form). Verify which signature recoco-utils/http currently exposes before copying the upstream code verbatim.

Recoco mapping

Upstream Recoco

rust/cocoindex/src/ops/targets/ladybug.rs crates/recoco-core/src/ops/targets/ladybug.rs

rust/cocoindex/src/ops/targets/mod.rs crates/recoco-core/src/ops/targets/mod.rs

rust/cocoindex/src/ops/registration.rs Registration module in recoco-core

Feature target-kuzu (upstream, to be deprecated) target-kuzu in Recoco (consider deprecation path)

References

Upstream PR: cocoindex-io/cocoindex#1487

Upstream ladybug.rs at merge commit: https://github.com/cocoindex-io/cocoindex/blob/1c5cf67587e7fe769f129b78f603956c9824061a/rust/cocoindex/src/ops/targets/ladybug.rs

Bootstrap tracking issue: #27</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes [Upstream-Sync] [FEATURE] Add Ladybug target (Kuzu successor) — upstream PR #1487 #52

📱 Kick off Copilot coding agent tasks wherever you are with GitHub Mobile, available on iOS and Android.

Co-authored-by: bashandbone <89049923+bashandbone@users.noreply.github.com>

cloudflare-workers-and-pages · 2026-03-13T20:26:34Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
❌ Deployment failed View logs	recoco-docs	`acdbfb6`	Mar 13 2026, 09:33 PM

…ature gates Co-authored-by: bashandbone <89049923+bashandbone@users.noreply.github.com>

Copilot

Pull request overview

Adds a new feature-gated target-ladybug graph-db target (Ladybug as Kuzu successor) and wires it into target modules, prelude exports, factory registration, and Cargo features.

Changes:

Introduces ops/targets/ladybug.rs implementing the Ladybug target.
Extends target module wiring/registration and shared gating to include target-ladybug.
Adds the target-ladybug Cargo feature and includes it in all-targets.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
crates/recoco-core/src/prelude.rs	Extends `recoco_utils::http` re-export gating to include `target-ladybug`.
crates/recoco-core/src/ops/targets/mod.rs	Adds `ladybug` module behind feature flag; includes it in shared target gating.
crates/recoco-core/src/ops/targets/ladybug.rs	New Ladybug target implementation (thin Cypher-over-HTTP client, setup/mutation logic).
crates/recoco-core/src/ops/registration.rs	Registers Ladybug factory and adjusts `reqwest::Client` construction/ownership across targets.
crates/recoco-core/Cargo.toml	Adds `target-ladybug` feature and includes it in `all-targets`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

crates/recoco-core/src/ops/targets/ladybug.rs

+            cypher.query_mut().push_str(
+                keys.iter()
+                    .chain(values.iter())
+                    .map(|(name, ladybug_type)| format!("{name} {ladybug_type}"))
+                    .join(", ")
+                    .as_str(),
+            );
+            match elem_type {
+                ElementType::Node(_) => {
+                    write!(
+                        cypher.query_mut(),
+                        ", {SELF_CONTAINED_TAG_FIELD_NAME} BOOL, PRIMARY KEY ({})",
+                        keys.iter().map(|(name, _)| name).join(", ")
+                    )?;


crates/recoco-core/src/ops/targets/ladybug.rs

+
+#[derive(Debug, Serialize, Deserialize)]
+pub struct Spec {
+    connection: spec::AuthEntryReference<ConnectionSpec>,
+    mapping: GraphElementMapping,
+}
+


bashandbone · 2026-03-13T21:26:32Z

@copilot apply changes based on the comments in this thread

… add serde-only doc comments Co-authored-by: bashandbone <89049923+bashandbone@users.noreply.github.com>

Copilot · 2026-03-13T21:33:31Z

@copilot apply changes based on the comments in this thread

Applied both review changes in acdbfb6:

Itertools .join() on iterators — replaced the two iterator .join(", ") calls (lines 251 and 259) with .collect::<Vec<_>>().join(", ") so there's no dependency on itertools::Itertools. The third .join() at line 147 was already on a Vec<String> (after .collect::<Result<Vec<_>>>()?) and used std, so it was left as-is.
Field visibility on ConnectionSpec / Spec — All other targets in this codebase (kuzu, neo4j, qdrant, postgres) use the same pattern of pub struct with private fields for serde-deserialized config types; making fields pub would diverge from that convention. Instead, added doc comments to both structs explicitly noting they are "serde-deserialized config-only types; populate via the auth-entry / YAML configuration rather than direct construction."

Initial plan

4c0dadd

Copilot AI assigned Copilot and bashandbone Mar 13, 2026

github-project-automation bot moved this to Backlog in Recoco v1.0.0 Mar 13, 2026

github-project-automation bot added this to Recoco v1.0.0 Mar 13, 2026

Copilot started work on behalf of bashandbone March 13, 2026 20:24 View session

feat: add target-ladybug feature (Kuzu successor)

fc37594

Co-authored-by: bashandbone <89049923+bashandbone@users.noreply.github.com>

feat: complete target-ladybug implementation with registration and fe…

b16ec51

…ature gates Co-authored-by: bashandbone <89049923+bashandbone@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] [Upstream-Sync] Add Ladybug target feature in Recoco~~ feat(targets): add target-ladybug (Kuzu successor) Mar 13, 2026

Copilot AI requested a review from bashandbone March 13, 2026 20:41

Copilot finished work on behalf of bashandbone March 13, 2026 20:41

bashandbone marked this pull request as ready for review March 13, 2026 21:09

Copilot AI review requested due to automatic review settings March 13, 2026 21:09

Copilot AI reviewed Mar 13, 2026

View reviewed changes

Copilot started reviewing on behalf of bashandbone March 13, 2026 21:16 View session

bashandbone removed this from Recoco v1.0.0 Mar 13, 2026

bashandbone added enhancement New feature or request upstream-sync Issues for syncing updates with our upstream (cocoindex-io/cocoindex) labels Mar 13, 2026

Copilot started work on behalf of bashandbone March 13, 2026 21:26 View session

fix(target-ladybug): replace itertools .join() with std collect+join,…

acdbfb6

… add serde-only doc comments Co-authored-by: bashandbone <89049923+bashandbone@users.noreply.github.com>

Copilot finished work on behalf of bashandbone March 13, 2026 21:33

bashandbone merged commit 348d96c into main Mar 16, 2026
7 of 8 checks passed

bashandbone deleted the copilot/add-ladybug-target-feature branch March 16, 2026 00:26

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(targets): add target-ladybug (Kuzu successor)#95

feat(targets): add target-ladybug (Kuzu successor)#95
bashandbone merged 4 commits intomainfrom
copilot/add-ladybug-target-feature

Copilot AI commented Mar 13, 2026 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages bot commented Mar 13, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

bashandbone commented Mar 13, 2026

Uh oh!

Copilot AI commented Mar 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Upstream	Recoco
`rust/cocoindex/src/ops/targets/ladybug.rs`	`crates/recoco-core/src/ops/targets/ladybug.rs`
`rust/cocoindex/src/ops/targets/mod.rs`	`crates/recoco-core/src/ops/targets/mod.rs`
`rust/cocoindex/src/ops/registration.rs`	Registration module in `recoco-core`
Feature `target-kuzu` (upstream, to be deprecated)	`target-kuzu` in Recoco (consider deprecation path)

Conversation

Copilot AI commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Usage

Background

What changes upstream?

Action for Recoco

⚠️ API compatibility note

Recoco mapping

References

Comments on the Issue (you are @copilot in this section)

Uh oh!

cloudflare-workers-and-pages bot commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Workers

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

bashandbone commented Mar 13, 2026

Uh oh!

Copilot AI commented Mar 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 13, 2026 •

edited

Loading

cloudflare-workers-and-pages bot commented Mar 13, 2026 •

edited

Loading