Skip to content

docs: document qt_remote_plain modules and runtime - #93

Draft
dlipicar wants to merge 3 commits into
masterfrom
codex/qt-remote-plain-tutorial
Draft

dlipicar wants to merge 3 commits into
masterfrom
codex/qt-remote-plain-tutorial

Conversation

@dlipicar

@dlipicar dlipicar commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

This updates the developer guide for the new qt_remote_plain module transport and the Qt-free logoscore/liblogos runtime. It documents supported module shapes, the compatibility role of logos_host_qt, local-IPC scope, migration guidance, native concurrency behavior, and the remaining places where Qt is expected.

Companion documentation for logos-protocol#96, logos-module-builder#258, logos-liblogos#222, and logos-logoscore-cli#141.

Validation:

  • Examples and terminology were checked against the implemented metadata, host selection, staged publication, bounded native concurrency, and CLI behavior.

@github-actions

github-actions Bot commented Sep 22, 2026 •

Copy link
Copy Markdown

📊 Tutorial execution reports

Rendered tutorial alongside the commands actually run and their output (updated each run, commit 5937677):

All reports for this PR

Pages can take a minute to update after the run finishes.

Each claim checked against the code at the head of the qt_remote_plain
series:

- tcp and tcp_ssl are served, not rejected. A daemon adds listeners with
  --module-transport, and a network client presents a token issued with
  `logoscore issue-token`; the boot token works on the local socket only.
  The flag and token commands join the reference tables.
- The discovery sidecar is lib/<name>_plugin.metadata.json, keyed by the
  module name, not <main>.metadata.json.
- A multi plain module has no pending marker: logos_host_plain runs up to
  max_workers calls at once, and a single one runs them in arrival order
  on one thread, not on an event loop.
- Basecamp ships only the Qt host, so it cannot run a plain module yet.
- Plain requires type "core" (the builder refuses UI types), and "core"
  is refused as a module name.
- Hosts are found through LOGOS_HOST_PLAIN_PATH and LOGOS_HOST_PATH,
  beside the executable, or in <modules dir>/../bin; a module without a
  current sidecar is read with logos_host_qt --inspect.
- name()/version()/lidl() are answered without constructing the impl.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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