Build production package flavors

[den-sq]

Closes #87.

Summary

• extend the release workflow to build core, plugins-cpu, and plugins-cuda package flavors across Linux, macOS, and Windows
• stage Neuroglancer plus CPU/CUDA Automatic Segmentation release artifacts into extra-resources/preinstalled-plugins for plugin package flavors
• add flavor-specific release artifact renaming and documentation for release inputs/local checks

Notes

• This PR is stacked on Use registry-backed server image in production packages #90 because it uses the registry-backed server packaging script.
• Runtime installation of bundled plugin folders is handled by Install bundled preinstalled plugins on startup #91.
• Plugin flavors expect release assets from Publish preinstallable neuroglancer plugin artifact neuroglancer-plugin#5 and Publish CPU and CUDA preinstallable plugin artifacts ouroboros_autoseg_plugin#34.

Validation

• node --check scripts/prepare-package-flavor.mjs
• node --check scripts/rename-release-artifacts.mjs
• npm run prepare:production-server
• OUROBOROS_PACKAGE_FLAVOR=core npm run prepare:package-flavor
• OUROBOROS_PACKAGE_FLAVOR=plugins-cpu OUROBOROS_PLUGIN_ARTIFACT_DIR=/tmp/ouroboros-package-artifacts OUROBOROS_NEUROGLANCER_PLUGIN_TAG=local OUROBOROS_AUTOSEG_PLUGIN_TAG=local npm run prepare:package-flavor
• OUROBOROS_PACKAGE_FLAVOR=plugins-cuda OUROBOROS_PLUGIN_ARTIFACT_DIR=/tmp/ouroboros-package-artifacts OUROBOROS_NEUROGLANCER_PLUGIN_TAG=local OUROBOROS_AUTOSEG_PLUGIN_TAG=local npm run prepare:package-flavor
• OUROBOROS_PACKAGE_FLAVOR=plugins-cuda npm run rename:release-artifacts
• npm run typecheck:node
• git diff --check

[tavateva]

Draft Promotion Review ✅ READY (after #90)

Reviewed against Draft Promotion Criteria.

Context: This PR addresses issue #87 (Build core-only, plugins CPU, and plugins CUDA production package flavors). Stacked on #90 — depends on registry-backed server preparation script.

Criterion Assessment

1. CI and mergeability: ✅ PASS — docs check green, mergeable
2. Issue Acceptance Criteria: ✅ PASS — All 5 criteria met:
   • ✅ Three flavors from one tag (workflow matrix: core / plugins-cpu / plugins-cuda)
   • ✅ Core-only has no bundled plugins (OUROBOROS_PACKAGE_FLAVOR=core skips plugin staging)
   • ✅ CPU plugin package includes neuroglancer + autoseg CPU (downloads CPU artifact, stages to extra-resources/preinstalled-plugins/)
   • ✅ CUDA plugin package includes neuroglancer + autoseg CUDA (downloads CUDA artifact with GPU reservation)
   • ✅ Artifact names distinguish flavors (rename-release-artifacts.mjs appends -core/-plugins-cpu/-plugins-cuda)
3. PR body Test Plan checkboxes: ✅ PASS — All verification items executed:
   • ✅ node --check for both new scripts
   • ✅ npm run prepare:production-server
   • ✅ All three flavors prepared locally (core, plugins-cpu, plugins-cuda)
   • ✅ npm run rename:release-artifacts
   • ✅ npm run typecheck:node
   • ✅ git diff --check
4. Tests run: ✅ PASS — Script validation, flavor preparation for all three variants, typecheck, git diff all reported
5. Scope: ✅ PASS — Flavor matrix + plugin artifact staging + artifact renaming; stacked on Use registry-backed server image in production packages #90
6. Regressions: ✅ PASS — CI green
7. Judgement calls: ✅ PASS — Flavor selection logic, artifact naming, and plugin resolution all documented in prepare-package-flavor.mjs and production-package-flavors.md

VERDICT: ✅ READY TO MERGE (after #90 merges)

Key Changes

• Workflow matrix: 3 flavors × 3 OS runners = 9 package variants per release
• scripts/prepare-package-flavor.mjs: Downloads plugin release artifacts, extracts to extra-resources/preinstalled-plugins/, validates package structure
• scripts/rename-release-artifacts.mjs: Appends flavor suffix to Electron Builder output artifacts
• documentation/docs/development/production-package-flavors.md: Documents flavor inputs, artifact names, and local testing

Flavor Behavior

• core: No plugins bundled
• plugins-cpu: Neuroglancer + auto-segmentation-<tag>-cpu.zip
• plugins-cuda: Neuroglancer + auto-segmentation-<tag>-cuda.zip (GPU reservation)

Dependencies

• Blocks: None (but stacked on Use registry-backed server image in production packages #90 for prepare:production-server script)
• Blocked by: Use registry-backed server image in production packages #90 must merge first
• Runtime dependency: Install bundled preinstalled plugins on startup #91 (preinstalled plugin installation logic)
• Artifact dependencies: neuroglancer-plugin#5, autoseg_plugin#34 (plugin release artifacts)

All 7 criteria satisfied. This PR closes issue #87 and is ready to merge after #90.