[e-zz]

Summary

Draft WIP for #6 — writing parented block
trees in a single MCP upsertNodes batch.

upsertNodes block adds now accept an optional :parent-id, which may be:

• the unique temporary :id of another block add in the same batch
  (child-before-parent and multi-level nesting both work), or
• the stable uuid string of an existing ordinary visible block on the same page.

Same-page, same-call nesting is encoded through the importer's :build/children
recursion; existing parents use an explicit uuid lookup ref. Missing, duplicate,
cross-page, hidden, recycled, tag/property/pseudochild, self-referential and
cyclic parents are rejected before any transaction. dry-run performs no
transaction and returns planned uuids. The verified receipt ({:receipt true})
resolves temporary parent ids to generated block uuids and checks the actually
persisted parent via worker DB readback.

Inherited dependency scope (declared, not new in this branch)

This branch was isolated from the dirty priv checkout where issue6 was
developed. The parent-id slice is not separable from the following inherited
slices, which are carried here verbatim and not claimed as new work:

• issue8 read slice (tools.cljs / cli.cljs / worker handler / api export):
  get-block + read-upsert-blocks (receipt readback), entity serialization
  helpers, recycled-page gates and full-tree get-page-data
  (include-children? / max-blocks), plus their cli/tools tests.
• issue5 receipt base: opt-in :receipt option on upsert-nodes,
  mcp-upsert.cljs adapter, receipt tests in cli_test.cljs, and the
  db_core test-api registry lines.

Search is explicitly out of scope: the main checkout's in-flight
scoped-search change (search options on logseq.app.search) is NOT included.
The scoped tests below do not establish app-bridge search behavior; search verification remains outside this PR.

Tests (isolated worktree, recompiled from this branch)

clojure -M:test compile db-worker-node test
LOGSEQ_STABLE_IDENTS=1 node static/tests.js -n logseq.api.db-based.issue6-test
LOGSEQ_STABLE_IDENTS=1 node static/tests.js -n logseq.api.db-based.tools-test
LOGSEQ_STABLE_IDENTS=1 node static/tests.js -n logseq.api.db-based.cli-test
LOGSEQ_STABLE_IDENTS=1 node static/tests.js -n electron.mcp-server-test
clojure -M:clj-kondo --lint <issue6 files>

Suite	Result
logseq.api.db-based.issue6-test	10 tests / 41 assertions, 0 failures, 0 errors
logseq.api.db-based.tools-test	35 tests / 183 assertions, 0 failures, 0 errors
logseq.api.db-based.cli-test	18 tests / 67 assertions, 0 failures, 0 errors
electron.mcp-server-test	1 test / 3 assertions, 0 failures, 0 errors
clj-kondo (issue6 source + test files)	0 errors / 0 warnings

git diff --check clean. Compile: 0 warnings.

Unverified surfaces (Draft stays WIP)

• Desktop → MCP HTTP runtime chain (Electron main process → /mcp →
  logseq.cli.upsertNodes → worker)
• SQLite persistence after graph close/reopen
• Packaged CLI E2E
• Full repository test suite

Refs #6