Skip to content

PlantCraft 0.5.1

Choose a tag to compare

@jonathanwvd jonathanwvd released this 30 Oct 17:31
7ff3057

PlantCraft 0.5.1 (2026-10-30)

Maintenance release after the 0.5.0 launch: new look, the plantcraft name everywhere, a clear contribution path, faster Historian reads, bounded View memory and a working install on macOS with Docker Desktop. No new apps.

Changed

  • New look: the PC valve logo and Steel Blue. The mark is now the
    letters P and C drawn as a control valve on a process line; the brand colour moves from
    #0A66D0 to Steel Blue #2E5A88 (#3D78B6 on dark), across buttons, links, selection, focus
    and the sidebar accent. App tiles keep their hues, toned toward the new blue, with dark values
    that hold on black. New app marks: Analytics (two connected blocks), Models (a distillation
    column), Desk (console with the day's checklist), Alarms (a bell without the limit line),
    Historian (the data cylinder without the time axis), Documents (a page without the
    magnifier). The family image no longer shows the plant simulator, which is not an app. New
    brand/ folder with PNG logos and the LinkedIn avatar and banner.

Added

  • "Talk to us" in the public demo. A visit shows a small button at the bottom right on every
    page, the apps included, that opens the site's contact form in a new tab
    (PLANTCRAFT_PUBLIC_DEMO_CONTACT_URL, an https address; deploy/cloud/vm.sh points it at
    plantcraft.io/#talk, which opens the form at once). The page after a visit ends offers it
    too. Without the setting nothing shows.

  • The public demo starts the same for every visitor. A visit starts
    with the newest 20 notifications unread and the rest read, whatever the live plant added, and
    the seed leaves the newest message of 4 conversations unread (the Messages badge shows 4).
    Opening a conversation is now the visit's own read mark, like every other mark since the
    check and favorites: before, it marked the shared demo account, so the next visitor found
    everything read.

  • Tables and pages on a phone (fine pass 2026-10-28, ui 0.86.0). A table column can be left
    out on a phone (DataColumn.phone: "hide"), cells are tighter there, a number and its unit
    never split, and a header actions cell keeps the header's rule. Overview widgets stacked on a
    phone are as tall as what they show (no empty desktop row under a short list; CardGrid
    phoneHeight). Page tabs that scroll sideways fade at the edge with more tabs and keep the
    active one in view. System health and Backups leave their secondary columns out on a phone; a
    state, a size and a backup's name stay on one line.

  • Check, seen or not, favorites. A notification gets a check (done) in its
    row, in the quick-access panel, when it is open and on the page it opens (a small bar on the
    action or the alarm); one button turns it seen and not seen again. A conversation and an
    assistant chat can be marked unread until opened; the three take a star, favorites first.
    PUT /api/me/marks. On the public demo each visit marks for itself only.

Changed

  • The platform's Python package is plantcraft. The folder at the root of
    the repository, every import and python -m plantcraft.<module> follow the product's name, and
    the distribution is plantcraft. processcraft still runs: the console script, and inside the
    images python -m processcraft.<module> (plantcraft/legacy.py), so an older install.sh, a
    rollback to 0.5.0 and the Backups page keep driving every version's installer image. Image and
    service names, data folders, the app id, cookies and stored ids are unchanged.

  • Contributing is one clear path. The README leads with how the suite fits together and how
    to contribute (commands moved to docs/development.md). Issue forms for a bug, an idea, a
    question and a change to the core; .github/labels.yml is the label set a workflow keeps on the
    repository; docs/maintainers.md is how issues and pull requests are answered, and a Claude
    Code skill (.claude/skills/review-contribution) checks whether a pull request fits. The
    agent rules and module pages are written for any contributor: no dated notes, no internal
    codes, and STATUS and devlog pages start fresh (the CHANGELOG is the record).

  • Analytics says what it is: scheduled monitors, diagnostics and KPIs for signals and control
    loops, in its card, the guides and the site. The name stays.

  • Turn the assistant on in four steps. docs/assistant.md opens with them (it is off until an
    administrator connects a model), linked from the README and the install guide; the public
    demo's assistant says so too.

  • Architecture in pictures and the zones of a contribution. docs/architecture.md opens with
    the suite in one diagram, how the apps talk (one sticky valve) and what is core and what is open;
    CONTRIBUTING.md says when an issue comes first. The Zones check (dev/pr-zones) shows a pull
    request's zones on its run page and holds a fork's core change to an agreed issue.

Fixed

  • The Historian answers raw reads about four times faster. Writing the time of every value
    one by one was 79 % of a raw read of millisecond samples (a day of the demo's 167 plant
    signals: 3.1 s, now 0.85 s). plantcraft-sdk writes sub-second times for a whole series at
    once, with the same text as before. With ten methods reading at once, Analytics' round went
    from 30 to 16 s.

  • A new install on macOS or Windows starts. On a Docker Desktop bind mount several
    PlantCraft processes wrote a new database at once and corrupted it ("database disk image is
    malformed"): file locks do not hold between processes there. PlantCraft now runs one process
    wherever SQLite cannot use WAL, whatever PLANTCRAFT_WORKERS says. Building a release works
    with python3 only (macOS) in every app's Makefile too.

  • View no longer runs out of memory with many viewers. Its short cache kept expired
    diagram data until it held 4,096 entries; on the public demo View reached its 2 GiB limit and
    was stopped (2026-10-29). Expired data now leaves at once, and viewers asking for the same
    data together share one read.

  • The old name is gone from what people type and download. The command
    is plantcraft (processcraft still works), release files are
    plantcraft-<version>-linux-<arch>-bundle.tar.gz, ssh-keygen checks them as
    release@plantcraft (same key; a signature does not carry the name), the update page names
    every app with its current name (Analytics, View, Historian, Simulator) and the user guides say
    Analytics and View where they still said Link and Dashboards. The site's chat knows the former
    names. The Python package, images, services and data ids keep processcraft, so installations
    and their data do not change.

  • Running from source says which Python to use (#10). The demo from source is tested on
    Python 3.12 and 3.13, and on 3.15 asyncua, the OPC UA library, fails to read, so signals show
    no values. The README and the install guide now say 3.12 or 3.13 (the Simulator needs 3.12),
    and run_opcua_demo.py warns on a newer Python. Thanks to the reporter of #10.

  • Analytics rounds no longer fail with "PlantCraft could not be reached: timed out" (demo,
    2026-10-29, SDK 0.78.0).
    A loop round reads a day of every loop's signals; while the
    Historian served other long reads, the round's read waited its turn in the Historian's read
    budget (up to 30 s) longer than the SDK client's 15 s, so the client asked again while its
    first read still ran, three times, and the round failed (22 times in 8 h on the demo, "failed"
    in the Queue). The SDK's series reads now wait 90 s (SERIES_TIMEOUT, other calls keep 15 s)
    and PlantCraft waits 75 s for the Historian (HISTCRAFT_TIMEOUT_SECONDS, was 40 s), longer
    than the budget wait plus the Historian's own 30 s read limit.

  • Public demo, found by testing it online (2026-10-27). The maintenance and manager guides
    opened "Report not found": the demo's visitor joins the Instrumentation and control group,
    which View's Control loops folder is shown to. The demo's four calculated signals are made
    again (their formulas named the Simulator's tags without CPM.Loops.). The visit's clock sits
    at the bottom (it covered Desk's greeting, and on a phone the tour's buttons); the guide's
    card no longer overflows with a long role name. An IPv6 visitor's places are counted by its
    /64, not by each device. Desk's Unread messages shows a reference by its name, not
    #[name](action:9).

  • The site's chat gives OpenAI's reasoning models room to think (empty answers came back as
    "cannot answer right now"), asks once more when the model fails, logs why, and answers
    Portuguese in Brazilian Portuguese.

Downloads

Bundle For Size SHA-256
plantcraft-0.5.1-linux-amd64-bundle.tar.gz most servers 2,028,246,573 bytes (1.9 GiB) 23a020279a8fdbed35441626e412750663405f23bdee0ea955ed800b52586ba4
plantcraft-0.5.1-linux-arm64-bundle.tar.gz ARM servers and Apple silicon 1,977,122,823 bytes (1.8 GiB) 63c5eab031cce434ada7d69826c183678c8abe02dd51822161e26b788ce587ca

Each bundle comes with its .sha256 and .sha256.sig. docs/install.md explains how to check them with ssh-keygen as release@plantcraft (OpenSSH fingerprint SHA256:9l/yDgR8/Pzel1pncxrXz2IGCIhFirKpDT78tO49fG8).

Upgrading

Run ./install.sh from the new bundle. Data, settings and accounts are kept, and the previous version stays available for rollback (./install.sh --rollback).

Each app's own changes are in its CHANGELOG.md under apps/.