Skip to content

maxforge v0.6.0

Choose a tag to compare

View all tags
@2bbb 2bbb released this 13 Oct 17:48
· 14 commits to main since this release
v0.6.0
da926b8

Breaking change: one object, Max-owned HTTP control

Create one maxforge object to start a loopback-only HTTP service shared by all patches in that Max process. The complete package bundles the matching native external and service. It uses Node supplied by Max: no standalone Node runtime, MCP server, broker, or node.script helper object is required.

The old maxforge.sync/MCP connection is removed. Replace the complete Max package with Max closed; do not replace only the external binary. Use maxforge-live for setup, scoped legacy-skill migration, discovery, and live editing.

Install the Max package

Requires Max 9 with its bundled Node 20 or newer. Download maxforge-v0.6.0.zip and maxforge-v0.6.0.zip.sha256 from this release. On macOS verify with shasum -a 256 -c maxforge-v0.6.0.zip.sha256, then extract the ZIP and place the entire maxforge folder in ~/Documents/Max 9/Packages/. On Windows use the corresponding Documents/Max 9/Packages directory. Back up an existing package outside Max search paths before replacement.

The ZIP contains macOS Universal (arm64 + x86_64) and Windows x64 externals. The macOS external is Developer ID signed and the exact ZIP is Apple-notarized. Matching assets are attached automatically after the release build finishes.

Install agent skills

npx skills add bbb-max-externals/maxforge --skill maxforge-live --global
# Optional offline DSL authoring:
npx skills add bbb-max-externals/maxforge --skill maxforge --global

Ask the agent to set up maxforge using maxforge-live. Installing a skill installs instructions only; package installation and removal of the obsolete maxforge-mcp skill happen through the explicitly requested setup workflow.

Included improvements

  • API discovery and patch listing with stable patch IDs, loaded external version, and compatibility checks.
  • Prepared-change receipts, retained source references, compact edits, and live-edit history.
  • Upstream semantic object identities and consecutive port-range wiring.
  • Save As path handling and numeric UI default geometry aligned with Max 9.
  • Numeric display-value changes no longer block editing after save/reopen.

Verification and limits

  • 411 automated tests, test typechecking, installed npm-package verification, and object-catalog audit passed.
  • macOS and Windows native CI builds and protocol tests passed.
  • Real macOS Max testing covers singleton/multiple-patch registration, native/service version alignment, edit acknowledgement and baseline verification, Save As, close/reopen, and retained identity/revision/wiring.
  • Windows host runtime testing was not performed. Saving requires an authorized Max installation.
  • Without an explicit project config, service state is scoped to the current Max process; retain the complete DSL when restarting Max.

The optional npm CLI is separate from this Max package and is not required for HTTP control.

Assets 4
Loading