feat(shell): preload shared contracts and Electron boundary

packages/shell/AGENTS.md

@@ -0,0 +1,27 @@
+# packages/shell
+
+Follow the root `AGENTS.md` and `packages/AGENTS.md` first.
+
+This package owns Shell persistence contracts shared across artifact tooling
+and Shell runtime consumption.
+
+## Owns
+
+- The `./update` subpath: launcher payload pointers and
+  `runtime/attempt/handoff/cleanup` descriptor schemas.
+- The `./launch-context` subpath: transactional, leased local debug routing
+  shared by tools-pack and Shell startup.
+- Validation of those persisted descriptors.
+- Deterministic channel/namespace/version layout below an explicit root.
+
+## Does not own
+
+- Electron processes, argv protocols, target selection, fallback execution,
+  updater lifecycle, IPC, menus, or UI projection.
+- Artifact construction, release publication, installer behavior, or signing.
+- Standalone Closure selection, storage, or update policy.
+- Renderer-facing host capabilities.
+
+Keep serialized schema versions, filenames, and layout stable unless an
+explicit migration is designed and accepted across every producer and
+consumer.

packages/shell/esbuild.config.ts

@@ -0,0 +1,13 @@
+import { build } from "esbuild";
+
+await build({
+  bundle: true,
+  entryPoints: ["./src/launch-context/index.ts", "./src/update/index.ts"],
+  format: "esm",
+  outbase: "./src",
+  outdir: "./dist",
+  outExtension: { ".js": ".mjs" },
+  packages: "external",
+  platform: "node",
+  target: "node24",
+});

packages/shell/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@open-design/shell",
+  "version": "0.19.2",
+  "private": true,
+  "type": "module",
+  "description": "Shared Open Design Shell update persistence contract and deterministic layout.",
+  "exports": {
+    "./launch-context": {
+      "types": "./dist/launch-context/index.d.ts",
+      "default": "./dist/launch-context/index.mjs"
+    },
+    "./update": {
+      "types": "./dist/update/index.d.ts",
+      "default": "./dist/update/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsx ./esbuild.config.ts && tsc -p tsconfig.json --emitDeclarationOnly",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json --noEmit"
+  },
+  "dependencies": {
+    "@open-design/release": "workspace:*",
+    "@open-design/sidecar": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "24.12.2",
+    "esbuild": "0.28.0",
+    "tsx": "4.22.3",
+    "typescript": "6.0.3",
+    "vitest": "4.1.6"
+  },
+  "engines": {
+    "node": "~24"
+  }
+}