LadybugDB openCypher
Designs and queries LadybugDB graphs with openCypher. Use for schemas, imports, query debugging, transactions, full-text search and Neo4j query adaptation, with local Python helpers.
LadybugDB openCypher
Workflow
-
Identify the database and its owner. Name the database path, the owning process and what is authorized: reads, writes or schema changes. A live read-write database is reached through the owning application's API: one process can hold several connections, but 2 processes cannot share read-write access. Documentation-only tasks need no runtime.
-
Check the runtime. Use the project's Python environment and run
<python> <skill-dir>/scripts/check_env.py --smoke(in memory only). The binding isladybug, pinned in requirements.txt; installing this skill does not install it. API reference covers setup, native-load failures and OpenClaw installation checks. -
Read the schema. Record node primary keys, relationship direction, properties and multiplicity. Keep parallel relationships and evidence IDs even when endpoints match. Neo4j differences and unexpected results: workflow patterns.
-
Query read-only. The helper defaults to engine-enforced read-only access:
text <python> <skill-dir>/scripts/run_cypher.py /path/to/graph.lbdb --command "MATCH (n:Paper) RETURN n.id LIMIT 10" --print-rowsBind values with
--paramsor--params-fileand validate identifiers separately; use--filefor reviewed multiline Cypher. Defaults: 30-second timeout, 256 MiB buffer, 20 preview rows per statement (--timeout-ms,--buffer-mib,--max-rows). Preview limits do not bound execution memory: use selective predicates, bounded traversals andLIMIT. Read-only database access does not restrict host files or network: reviewCOPY,LOAD,CALL, extensions and paths, and use trusted absolute import paths. -
Write only if authorized. Use
--write(--write --createfor a new database; it refuses existing paths), and put a batch insideBEGIN TRANSACTION; ...; COMMIT;; without it each statement commits separately, so inspect partial state before retrying. Never escalate after a read-only error. Follow the application's backup and migration procedure, and test engine upgrades and recovery on copies, never on the only database. -
Read back and report. Check properties, direction and identity of what you wrote, not just counts. The helper closes results, connections and databases on failure too. Helper tests use temporary databases.
Output
Database: <path, owning process>
Mode: read-only | write (authorized by <who>)
Statements: <n>, rows returned: <n>
Read-back: <properties, direction and identity checked, or "not applicable">
Limits: <unresolved limits, or "none">
Final check
- Was the owning process identified, and did only one process open the database read-write?
- Did every write use
--writeinside an authorization, with a batch insideBEGIN TRANSACTION; ...; COMMIT;? - Were writes read back for properties, direction and identity?
- Are the reported checks the ones actually run?
Community-maintained under MIT-0; based on trenza1ore/ladybug-opencypher.
Related skills
- Downloads
- 596All time
- Security audit
- Pass
- Last updated
- 2d ago
- Current version
- v1.1.8
- License
- MIT-0
