Skip to content

Releases

v0.3.4

Choose a tag to compare

@github-actions github-actions released this 18 Nov 13:54
Immutable release. Only release title and notes can be modified.

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-exists only answers for paths inside the folders you
    configured (vault, node folders, workspaces, cache and config folders) and for
    .yaml / .yml files under your home folder. Anything else, including a path
    with a NUL byte, is a 422.
  • The editor setting (nodes_editor) can only be set from the app to a known
    editor, such as code, cursor, zed, subl, gedit, kate or open,
    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, uv or zsum command, without -c.
  • Any other program can still be set by editing config.toml yourself.
  • Saving an API key no longer sends the key back in the response; it comes back
    masked, as on GET /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 return 404.

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 missing index.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, honouring Retry-After) instead of a single retry after one second.
  • First-run setup reports a vault set through AKMS_GLOBAL_VAULT.

Releases

  • SHA256SUMS.txt no longer lists itself, so sha256sum -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/scan takes an optional {"ignore": [paths]} body;
    unknown fields are a 422.
  • scripts/release.sh tags origin/main by 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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 15:22
Immutable release. Only release title and notes can be modified.

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 which config.toml to 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.yaml when 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 /picker link opens the Picker again.

For developers

  • POST /api/assistant/discover/search validates its body and returns
    provider_errors.
  • The picker sub-app's routes are listed in /openapi.json (tag akms-picker)
    and use the standard error envelope.
  • /api/graph/refresh/stream is a POST (it was a GET, so a plain link could
    start a rebuild). /api/graph/status timestamps are UTC.
  • /api/zsum/test returns a 502 zsum_test_failed error when the test fails.
  • The unimplemented POST /api/learn/export stub 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

Choose a tag to compare

@github-actions github-actions released this 17 Nov 13:30
Immutable release. Only release title and notes can be modified.

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

Choose a tag to compare

@github-actions github-actions released this 16 Nov 20:02
Immutable release. Only release title and notes can be modified.

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 .deb differ.
  • 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

Choose a tag to compare

@github-actions github-actions released this 16 Nov 09:53

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
    and compmech-reference-pack at 0.4.0,
  • mechdsl-core and algo2code at 0.2.1,
  • zotero-summarizer at 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 override config.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.md lists every Python, JavaScript and Rust package the
    app ships, with its license and the license texts those packages include. The
    installers carry it next to LICENSE.

Known limitations

  • The binaries are not notarized (macOS) or code-signed (Windows). Verify a
    download against the published SHA256SUMS.txt.
  • MechDSL verify needs taichi, which is not bundled; install it from the
    MechDSL overview page in the app.