Skip to content

Add WIRE QL tools: ql-shared, wql CLI/TUI and desktop workbench - #119

Merged
jglanz merged 1 commit into
masterfrom
feature/wql-tools-and-app
Oct 13, 2026
Merged

jglanz merged 1 commit into
masterfrom
feature/wql-tools-and-app

Conversation

@jglanz

@jglanz jglanz commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

Summary

New WIRE QL packages — clients for a node's sysio::query_engine_plugin (POST /v1/query/execute):

  • @wireio/ql-shared — typed query client with server-side paging (limit / offset / timeout_ms, response schema 1.1), retry policy, exact value formatting, nine output formats (table, json, jsonl, csv, tsv, markdown, html, xml, raw), an antlr-ng parser generated from the engine's WireQuery.g4 (highlighting, diagnostics, formatting, completion), schema catalog, and profile / saved-query / history stores shared by every tool.
  • @wireio/ql-tool-cli — wql command line (wire-ql alias) and wire-ql-tui terminal workbench.
  • @wireio/ql-tool-app — private Electron desktop workbench: a utilityProcess query host, standard context isolation / sandbox / CSP, native menus, dialogs and theme, and AppImage / deb / dmg / nsis packaging. Launches add --no-sandbox only on hosts with no usable Chromium OS sandbox.

Shared changes:

  • The JSON-RPC 2.0 envelope (JsonRPCProtocol) and process signals move into cluster-tool-shared, and debugging-* now import them from there.
  • New scripts/check.mjs stages: package-root layout check, WQL type/schema drift check (scripts/generate-wql-types.mjs) and app-icon check (scripts/generate-ql-app-icons.mjs).

Dependencies

Docs

  • Each package has a README covering overview, installation, getting started, usage, configuration, development and troubleshooting.

🤖 Generated with Claude Code

@jglanz
jglanz force-pushed the feature/wql-tools-and-app branch 2 times, most recently from 7a5dadb to 5345c57 Compare October 12, 2026 17:52
- @wireio/ql-shared: typed query_engine_plugin client (server paging,
  response schema 1.1, retries), value formatting, nine output formats,
  antlr-ng grammar tooling, schema catalog, shared profile/history stores
- @wireio/ql-tool-cli: `wql` command line and `wire-ql-tui` terminal workbench
- @wireio/ql-tool-app: Electron workbench with a utilityProcess query host,
  standard context isolation/sandbox/CSP, native menus and packaging
- Promote the JSON-RPC 2.0 envelope and process signals into
  cluster-tool-shared; package-root layout check, WQL type and icon
  generators wired into scripts/check.mjs

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@jglanz
jglanz force-pushed the feature/wql-tools-and-app branch from 5345c57 to 434b302 Compare October 12, 2026 18:52
@jglanz
jglanz merged commit d10adc4 into master Oct 13, 2026
0 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant