kreeader-dev

A Wails desktop app — an n8n / node-red style node-graph editor for defining how kreeader-server handles a book's journey from metadata → panes, end to end. It generalizes kreeader-server's existing graphs system into a visual builder where every kreeader-server capability is a node, paths are drawn and tested live, and the exact function path is import/exportable JSON that later gets implemented into code.

Goals (the spec, verbatim intent)

1. Nodes for every kreeader-server book-handling function — barcode decode, GCD lookup, ComicVine / Metron / ISBN, cover pHash, the code registry, pane detection, etc.
2. Draw the discovery + data-usage path end to end, and test it live.
3. Add new nodes without recompiling — node definitions are JSON loaded at runtime from nodes/.
4. WYSIWYG interface builder — bind sliders, toggles, input boxes, and selection boxes to node inputs; the same graph can render those controls as a real UI panel.
5. Build the panebench UI and backend from a graph.
6. Import/export the exact function paths as JSON.
7. DB lookups for both Postgres (kreeader metadata) and GCD (the sqlite dump).
8. API calls for anything kreeader-server exposes — it acts as an API client for kreeader-server, using the same Dex device-auth flow panebench uses.
9. Ship a pair of importable files: graphs/metadata-lookup.kdev.json (includes the current panebench UI, editable) and graphs/pane-detection.kdev.json (the current pane-detection flow).

Architecture

kreeader-dev/
  main.go              Wails entry
  app.go               Wails-bound backend: registry, executor, client, auth, DB
  serverclient.go      kreeader-server HTTP client (from panebench)
  pairing.go           Dex device-auth flow (from panebench)
  registry.go          loads node definitions from nodes/*.json (dynamic)
  executor.go          runs a graph DAG, node by node
  nodekinds/           built-in node implementations (api, db-postgres, db-gcd, transform, ui)
  kreeader-server/     git submodule (source of truth for endpoints + packages)
  nodes/               *.json node definitions (add nodes here, no recompile)
  graphs/              importable graph files (metadata-lookup, pane-detection)
  frontend/dist/       hand-authored UI: LiteGraph node editor + WYSIWYG builder

Node model (.kdev.json)

A graph is {nodes:[...], links:[...], ui:[...]}. A node references a node definition (by type) from nodes/. A definition declares inputs, outputs, params (each with a control: slider/toggle/input/select and a bindsTo node-input), and a kind:

• api — call a kreeader-server endpoint (method + path template + auth).
• db.postgres — parameterized SQL against the kreeader Postgres.
• db.gcd — query against the GCD sqlite dump.
• transform — pure data reshaping (jq-ish / template).
• ui.control — a WYSIWYG control whose value feeds a downstream input.
• ui.panel — groups controls into a rendered UI (this is how panebench's UI is expressed).
• output — render/inspect a result.

Nodes are executed in the Go backend so the same path can run headless later when "implemented into code".

Status

Under active construction (Ralph loop). See git log for incremental progress.