{
  "metadata_version": 1,
  "version": "0.9.6a",
  "channel": "stable",
  "codename": "Handshake",
  "released": "2026-09-16",
  "artifact": "canectic-0.9.6a.zip",
  "sha256": "11b9bb4c6f8687aa411b06a508d8b8074668072ed16319b3d2b722db070cac2e",
  "delta": false,
  "base": null,
  "base_artifact": null,
  "min_upgrade_from": "0.9.0a",
  "node_min": "22.0.0",
  "migrations": [
    "0001-menu-layout",
    "0002-msgid-tuple-split",
    "0003-qwk-conference-blocks",
    "0004-settings-provenance",
    "0005-refresh-stale-version"
  ],
  "steps": [
    {
      "id": "fix-msgids",
      "description": "Split legacy full-string MSGIDs into the msg_id / msg_orig_addr columns",
      "automatic": false,
      "applies_when": "the settings marker msgid_tuple_split_completed_at is unset and per-area message tables exist",
      "command": "node src/tools/maintenance.js --fix-msgids"
    },
    {
      "id": "pm2-reregister",
      "description": "Re-register the pm2 apps so the pinned child interpreter takes effect",
      "automatic": false,
      "applies_when": "the BBS is managed by pm2",
      "command": "pm2 delete all && pm2 start ecosystem.config.cjs && pm2 save"
    },
    {
      "id": "systemd-wrapper",
      "description": "Route the systemd unit through the Node-resolving wrapper instead of a baked-in Node path",
      "automatic": false,
      "applies_when": "the BBS boots from a systemd unit generated by pm2 startup",
      "command": "install -m 755 setup/canectic-pm2.sh ~/.local/bin/canectic-pm2"
    },
    {
      "id": "db-encoding",
      "description": "Check whether the database is SQL_ASCII and convert it to UTF8",
      "automatic": false,
      "applies_when": "the database was created before this release by create_pg_db_user.sh",
      "command": "setup/convert_db_encoding.sh --preflight-only"
    }
  ],
  "notices": [
    {
      "level": "warning",
      "text": "Node 22 or later is now required and Node 26 is the tested target. better-sqlite3 v13 is the first release built on N-API, and its engines range sets the floor. nvm is the recommended way to manage this."
    },
    {
      "level": "warning",
      "text": "npm 12, which ships with Node 26, will not run dependency install scripts unless the package is allowlisted. package.json approves bcrypt, node-pty, @serialport/bindings-cpp and better-sqlite3, pinned to version. Without the allowlist, password hashing, door games and DOS doors over socat fail at runtime rather than at install time."
    },
    {
      "level": "warning",
      "text": "allow_netmail_relay is deprecated and ignored. Relay is now netmail_relay_mode, taking off, nodelist or on, and every upgrade lands on nodelist regardless of what the old boolean said. Read docs/sysop/NETMAIL_RELAY.md before choosing on, which is considerably broader than it reads."
    },
    {
      "level": "info",
      "text": "Upgrading the host OS: read docs/sysop/OS_UPGRADE.md first. An Ubuntu release upgrade installs a new PostgreSQL major but does not migrate the data, and can silently remove build-essential."
    }
  ],
  "files": 956,
  "bytes": 24504372,
  "full_files": 956,
  "full_bytes": 24504372,
  "notes": null
}
