Repository navigation
Releases
v0.3.4
Logic-Loom v0.3.4
Fixes from the v0.3.3 retest: tighter checks on the local API, Ctrl-K on Home,
a quieter backdrop logo, and release checksums that verify. No settings change
is needed to update, unless you set a custom editor or zsum command from the
Settings page (see below).
Security and API
GET /api/app/path-existsonly answers for paths inside the folders you
configured (vault, node folders, workspaces, cache and config folders) and for
.yaml/.ymlfiles under your home folder. Anything else, including a path
with a NUL byte, is a422.- The editor setting (
nodes_editor) can only be set from the app to a known
editor, such ascode,cursor,zed,subl,gedit,kateoropen,
with plain flags like--wait. Flags that make an editor run commands
(vim -c,emacs --eval, ...) are refused. - The zsum command (
zsum_python_cmd) can only be set from the app to a
Python,uvorzsumcommand, without-c. - Any other program can still be set by editing
config.tomlyourself. - Saving an API key no longer sends the key back in the response; it comes back
masked, as onGET /api/app/config. - Saving a prompt variant checks its filename the same way Validate does.
- Hidden vault files and folders (
.github,.obsidian, dot-files) can't be
read or listed by typing their path either: they return404.
Fixes
- Ctrl-K / ⌘K opens search on Home too, not only inside a mode.
- Home has a card for every mode. MechDSL, Failure Memory and Records are tagged
"optional", since they need an extra install or a config entry. - The backdrop logo is a small mark in the bottom-right corner by default, and
Home no longer shows a second, overlapping banner. The Logo switch still
offers the full logo. - zsum ▸ Collections explains how to build a library (Skeleton or Full Run) and
which cache folder it reads, instead of reporting a missingindex.json. - When OpenAlex or Semantic Scholar rate-limits a request (
429), Discover and
related-paper walks wait and retry with growing, randomized delays (up to 3
times, honouringRetry-After) instead of a single retry after one second. - First-run setup reports a vault set through
AKMS_GLOBAL_VAULT.
Releases
SHA256SUMS.txtno longer lists itself, sosha256sum -c SHA256SUMS.txt
passes. Releases v0.3.0 to v0.3.3 still have the self-listing line; see
Known issues.
For developers
POST /api/graph/issues/scantakes an optional{"ignore": [paths]}body;
unknown fields are a422.scripts/release.shtagsorigin/mainby default and no longer mentions a
source-repository token.- CI and release workflows use the Node 24 versions of their GitHub Actions.
v0.3.3
Logic-Loom v0.3.3
The rest of the v0.3.1 QA pass: screens that left you stuck, features that ran
but showed the wrong thing, API fixes and a round of polish. No settings change
is needed to update.
No more dead ends
- When a mode is not set up (AKMS, MechDSL, Failure Memory, Records), its setup
message now appears inside the app, with the mode switcher and side menu still
on screen. Before, the message replaced the whole window and the only way out
was restarting the app. - The Failure Memory and Records setup messages have a Copy snippet button and
show whichconfig.tomlto paste it into. - "Find related papers" on the Assistant overview opens a batch's Related tab
instead of an empty page. - A batch's Runs tab lists the workflow runs made from it.
- AKMS ▸ Nodes only offers View in Graph for nodes that are in the graph.
- zsum ▸ Collections explains what to do when there is nothing to show yet.
- Learn history is kept when you reload the window.
Features that now show the right thing
- The Picker lists every batch. Batches created in the app, including the
starter batch, were missing from AKMS ▸ Picker. They are all listed now, and
new or changed batches appear without restarting. - The vault preview renders LaTeX math and shows nested frontmatter as readable
text instead of[object Object]. - A graph rebuild that stops for review names the files involved and how to fix,
ignore or skip them. - zsum ▸ Settings can create a starter
zsum.config.yamlwhen none exists. - The vault tree hides hidden files and folders (
.github,.gitignore, ...). - First-run setup accepts a vault path set in
LOGIC_LOOM_VAULT_PATH. - Prompt Preview shows the resolved prompts. It always came back empty
before. Validate also works on the built-in prompts.
Clearer messages
- Discover shows a note when OpenAlex or Semantic Scholar is rate-limiting or
not answering, instead of quietly returning fewer results. A rate-limited
request is retried once. - Testing a provider in Assistant ▸ Settings explains a failure (for example a
Semantic Scholar rate limit) and what to do about it. - "bbt-path-unset" now reads "Zotero is not connected", with the setting to fix.
- Open in Editor says which program it used, or why nothing could open.
- An empty prompt preview in the Run dialog says why no variants were chosen.
- MechDSL ▸ Overview labels each backend as Ready or Not installed.
- Buttons that need input first say so when you hover over them.
Look and feel
- The window title and icon are Logic-Loom's own, and the Linux packages carry a
description. - A Logo switch in the top bar dims, hides or restores the backdrop logo. It
is dimmed by default. - Dark mode has more contrast for secondary text and borders.
- The Discover search box wraps long queries.
- Ctrl-K / ⌘K opens search reliably, also with Caps Lock on, and a cleared
or changed query no longer shows old results. - The old
/pickerlink opens the Picker again.
For developers
POST /api/assistant/discover/searchvalidates its body and returns
provider_errors.- The picker sub-app's routes are listed in
/openapi.json(tagakms-picker)
and use the standard error envelope. /api/graph/refresh/streamis aPOST(it was aGET, so a plain link could
start a rebuild)./api/graph/statustimestamps are UTC./api/zsum/testreturns a502 zsum_test_failederror when the test fails.- The unimplemented
POST /api/learn/exportstub is removed. - The "picker mount skipped" warning at startup is now an info message; it is
only a warning if the picker still can't mount after the workspace exists.
v0.3.2
Logic-Loom v0.3.2
A security and reliability release. Every v0.3.x user should update: the
local API that the app runs could be reached by web pages and other programs
on the same computer.
The local API now requires a per-launch token
The app talks to its Python sidecar over a port on 127.0.0.1. Until now that
API had no authentication. Any program on the computer could call it, and so
could a web page, through a technique called DNS rebinding. A page that did so
could read your settings, write files through the prompt library, and change
the editor command that "Open in Editor" runs.
From this release the desktop app creates a random token at each launch. The
sidecar refuses every request that does not carry it, and every request that
does not address it by a loopback name (127.0.0.1, localhost or [::1]).
Nothing changes in how you use the app.
If you run the sidecar on its own for development, see
Developer setup for the matching environment variables.
Hardened inputs and secrets
- Prompt-library and workflow ids can no longer name a file outside the library.
- "Open in Editor" and the node file viewer only work on files in your node
folders, vault and the shipped node library. - Saved API keys are never sent back to the app window. Settings show a saved key
as dots; type over it to replace it, or empty the field to remove it. - The editor and zsum Python commands must name a program that exists.
- Error responses no longer include server tracebacks, and malformed requests
get a clear 4xx error instead of a server error.
No more leftover background processes
If the app crashed or was force-quit, its sidecar could keep running in the
background. The sidecar now exits on its own whenever the app goes away, on every
platform. On Windows, closing the app also stops the helper processes the
installer's launcher starts.
Launching Logic-Loom a second time now brings the open window forward instead of
starting a second copy that would share the same settings and batches.
Windows: the app can reach its API again
On Windows the v0.3.1 sidecar stopped right after it started, so the app could
not load its data. It now keeps serving on every platform.
Documentation
- Install links to the page that has the installers, and
shows how to check a download on Linux, macOS and Windows. - LLM providers explains how saved keys are shown.
- Architecture describes the token check and
how the sidecar follows the app's lifetime.
v0.3.1
Logic-Loom v0.3.1
A rebuild of v0.3.0 whose Linux packages run on current long-term-support
distributions. The app itself is unchanged.
Linux packages run on Ubuntu 22.04 and later
The v0.3.0 Linux packages were built on the newest GitHub runner, so they were
linked against glibc 2.43 and refused to start on anything older, including
Ubuntu 24.04 (glibc 2.39) and Debian 13 (glibc 2.41). The Linux build now runs
on Ubuntu 22.04, and the release fails if anything it ships needs a glibc newer
than 2.35. The packages run on Ubuntu 22.04 or later, Debian 12 or later, and
distributions of the same age.
The build also checks that the AppImage carries its own WebKitGTK, so it runs
where the distribution's WebKitGTK is missing or cannot be installed. The
.deb still uses the distribution's libwebkit2gtk-4.1-0.
macOS and Windows packages are rebuilt from the same source with no changes.
Documentation
- Install lists the Linux requirements and how the
AppImage and the.debdiffer. - Developer setup
shows how to run Logic-Loom from source in a browser, without the installer or
WebKitGTK. - Known issues has a Linux section.
v0.3.0
Logic-Loom v0.3.0
The first release whose source is public. The app now runs on AKMS 0.4,
installs every Python subsystem from PyPI, and adds a Records mode. It also
carries everything prepared as v0.2.1, which was never tagged.
Runs on AKMS 0.4, with nothing vendored
Logic-Loom used to carry source snapshots of AKMS, MechDSL and
zotero-summarizer and build from them. All three are now ordinary dependencies
installed from PyPI at the versions the lockfile records:
akms,akms-learn,akms-nodes-gen,akms-failure-memory,akms-records
andcompmech-reference-packat 0.4.0,mechdsl-coreandalgo2codeat 0.2.1,zotero-summarizerat 1.0.0.
The packaged app bundles all of them. Earlier binaries left Failure Memory out
of the frozen sidecar and shipped agent assets from an older AKMS; this one
reads the bundled skills, agents, commands and hooks from the installed AKMS
package, so the assets always match the AKMS version in the binary.
No AKMS or zotero-summarizer checkout needed
The Picker, Nodes, Batches and Graph tabs no longer need an AKMS source
checkout, and the zsum pipeline no longer needs a zotero-summarizer one. The
akms_repo, zsum_repo and logic_loom_root settings are optional overrides
for development and default to unset. First-run setup and Settings treat them
as optional.
New: Records mode
A sixth mode, Records, browses akms-records stores: an overview, a record
browser, the schemas in use, and a graph of how records relate. It is read-only
and opens only the stores you list under [[records_stores]] in the
configuration. akms-records is experimental upstream.
Failure Memory
The Failure Memory workspace follows AKMS 0.4: the mirror exporter that used to
be a separate tool is built in, so refresh in operator mode needs nothing
extra installed.
Fixes
LOGIC_LOOM_*environment variables now overrideconfig.toml, as
documented.- The graph cache is keyed correctly when no AKMS checkout is configured.
- The batch picker mounts without an AKMS source checkout.
Security and repository hygiene
- Dependency upgrades clear 30 known advisories in transitive packages
(anyio, cryptography, filelock, fsspec, multidict, pydantic-settings, pypdf,
starlette, urllib3). - The repository now has a license file (MIT), a security policy, contributor
documentation, dependency and code scanning, and Dependabot. THIRD_PARTY_NOTICES.mdlists every Python, JavaScript and Rust package the
app ships, with its license and the license texts those packages include. The
installers carry it next toLICENSE.
Known limitations
- The binaries are not notarized (macOS) or code-signed (Windows). Verify a
download against the publishedSHA256SUMS.txt. - MechDSL
verifyneeds taichi, which is not bundled; install it from the
MechDSL overview page in the app.