mega-framework 0.1.9 → 0.1.11

package/sample/multi/README.md

@@ -0,0 +1,54 @@
+# sample-multi — 한 프로세스 멀티앱 (vhost) 데모
+
+한 프로세스에 **두 앱**을 띄우고, `Host` 헤더로 라우팅(vhost, ADR-063)하며, **앱별 lock/bus 분리**(ADR-229)와
+ctx 없는 영역의 **cross-app 호출**(`getApp`, ADR-228)을 보여주는 최소 데모입니다.
+
+- **web** (`a.com`) — 앱 전용 lock(**redis**) + bus(NATS, prefix `web.`)
+- **admin** (`b.com`) — 앱별 설정 없음 → **글로벌 fallback** (lock=**memory**, bus prefix `glob.`)
+
+> 이 데모는 멀티앱 패턴(vhost·앱별 lock/bus·cross-app)에 집중한 **목적형 최소 앱 2개**입니다. 풀 기능
+> 데모는 단일앱 `sample/crud`(DB·캐시·잡·WS·ASP 등) / `sample/simple`(최소 E2E)을 보세요.
+
+## 실행
+
+```bash
+cd sample/multi
+cp .env.example .env          # REDIS_WEBLOCK_URL / NATS_EVENTS_URL 확인 (redis·nats 필요)
+npm install
+npm run dev
+```
+
+`/etc/hosts` 에 `a.com` / `b.com` 이 `127.0.0.1` 로 매핑돼 있어야 합니다(이미 설정돼 있다고 가정 — 없으면
+`.env.example` 안내 참고). 접속:
+
+| URL | 앱 | 무엇 |
+| --- | --- | --- |
+| http://a.com:3200/ | web | 셸 + 엔드포인트 안내 |
+| http://a.com:3200/whoami | web | lock=`redis`, bus=`nats` (앱 전용) |
+| http://a.com:3200/lock | web | redis 락으로 임계구역 실행 |
+| http://a.com:3200/emit | web | `web.order.created` 발행(admin 미수신) |
+| http://a.com:3200/cross | web | `getApp('admin').bus.emit('notice')` → admin 으로 cross-app |
+| http://b.com:3200/whoami | admin | lock=`memory`, bus=`nats`(글로벌) |
+| http://b.com:3200/received | admin | 글로벌 버스로 받은 이벤트 — web 의 cross-app `notice` 가 보임, `web.` 발행은 격리로 없음 |
+
+## 무엇을 보여주나
+
+- **vhost**: 한 포트(3200) 한 번 listen, `a.com`/`b.com` 이 다른 앱으로 라우팅. 같은 host 를 두 앱에 매핑하면
+  부팅 시 `config.host_collision` 로 fail-fast(ADR-067).
+- **앱별 lock 분리**: `a.com/whoami` 는 `redis`, `b.com/whoami` 는 `memory` — 같은 키여도 다른 manager 라 격리.
+- **앱별 bus prefix 격리**: web 의 `web.` 발행을 admin(`glob.`)이 못 받음.
+- **cross-app**: web 의 `/cross` 가 `getApp('admin').bus` 로 admin 의 글로벌 버스에 직접 발행 → `b.com/received` 에 도착.
+
+## 문제 해결 — `host.not_mounted`
+
+`{"error":{"code":"host.not_mounted"}}` 가 보이면 **다른 mega 앱이 그 포트를 점유**하고 있어, 이 앱이 listen 에
+실패하고 브라우저가 옛 서버를 때리는 것입니다(예: `sample/crud`가 3000 에서 도는 중). 확인·해결:
+
+```bash
+lsof -nP -iTCP:3200 -sTCP:LISTEN     # 누가 점유 중인지
+# → 옛 서버를 끄거나, PORT 를 비어있는 값으로 바꿔 실행: PORT=3201 npm run dev
+```
+
+이 앱은 점유된 포트면 `listen EADDRINUSE` 로 **명확히 실패**합니다 — 그 로그가 보이면 포트를 바꾸세요.
+
+자세한 설명은 프레임워크 가이드 `docs/guide/10-multi-app.md` 참고.

package/sample/multi/apps/admin/app.config.js

@@ -0,0 +1,24 @@
+// @ts-check
+/**
+ * apps/admin/app.config.js — `admin` 앱(b.com). **앱별 lock/bus 미지정** → 글로벌 fallback 을 쓴다(ADR-229):
+ *   - lock: 글로벌(memory) — web 의 redis 락과 격리(다른 manager).
+ *   - bus: 글로벌(NATS, prefix `glob.`) — web 의 `web.` 와 subject 공간이 갈린다.
+ * 멀티앱이라도 앱이 lock/bus 를 정의하지 않으면 종전처럼 글로벌을 그대로 쓴다(호환).
+ */
+export default {
+  name: 'admin',
+  hosts: ['b.com'],
+
+  views: { dir: 'apps/admin/views' },
+
+  // 정적 자산 — 데모 페이지의 클라이언트 JS(/static/js/admin.js)를 서빙(CSP script-src 'self' 호환).
+  staticAssets: { enabled: true, dir: 'apps/admin/public', prefix: '/static' },
+
+  // helmet CSP — 로컬 http 데모라 `upgrade-insecure-requests` 끄기(null). 안 끄면 브라우저가 https 로 강제
+  // 업그레이드해 연결 실패. useDefaults 라 나머지 보안 헤더는 유지(운영 https 에선 이 override 제거 권장).
+  helmet: {
+    contentSecurityPolicy: {
+      directives: { upgradeInsecureRequests: null },
+    },
+  },
+}

package/sample/multi/apps/admin/controllers/admin-controller.js

@@ -0,0 +1,42 @@
+// @ts-check
+/**
+ * AdminController — `admin` 앱(b.com) 컨트롤러. 앱별 lock/bus 미지정이라 **글로벌**(memory 락 + glob. 버스)을 쓴다.
+ *
+ * 첫 요청에서 글로벌 버스의 `>`(= glob.>)를 구독해 받은 이벤트를 링버퍼에 모은다. web 의 `/cross`
+ * (getApp('admin').bus.emit('notice'))가 보낸 cross-app 이벤트가 여기로 들어온다. web 의 `web.` 발행은
+ * prefix 가 달라 들어오지 않는다(격리).
+ */
+
+/** 수신 버퍼(워커별 인메모리). @type {any[]} */
+const received = []
+const MAX = 30
+let subscribed = false
+
+/** 글로벌 버스 1회 구독(워커별 멱등). @param {any} ctx @returns {Promise<void>} */
+async function ensureSubscribed(ctx) {
+  if (subscribed) return
+  subscribed = true
+  await ctx.bus.on('>', (/** @type {any} */ payload, /** @type {any} */ _meta, /** @type {any} */ subject) => {
+    received.push({ subject, payload, at: new Date().toISOString() })
+    if (received.length > MAX) received.shift()
+  })
+}
+
+export class AdminController {
+  /** GET / — 셸 페이지. @param {any} _req @param {any} _reply @param {any} ctx */
+  static async home(_req, _reply, ctx) {
+    await ensureSubscribed(ctx)
+    return ctx.render('index', { app: 'admin', host: 'b.com' })
+  }
+
+  /** GET /whoami — 글로벌 lock/bus driver. @param {any} _req @param {any} _reply @param {any} ctx */
+  static async whoami(_req, _reply, ctx) {
+    return { app: 'admin', lock: (await ctx.lock.stats()).driver, bus: (await ctx.bus.stats()).driver, pid: process.pid }
+  }
+
+  /** GET /received — 글로벌 버스(glob.>)로 받은 이벤트(web 의 cross-app 포함, web. 발행은 격리되어 없음). @param {any} _req @param {any} _reply @param {any} ctx */
+  static async received(_req, _reply, ctx) {
+    await ensureSubscribed(ctx)
+    return { app: 'admin', count: received.length, events: received.slice().reverse() }
+  }
+}

package/sample/multi/apps/admin/public/js/admin.js

@@ -0,0 +1,31 @@
+// @ts-check
+/* admin 앱 데모 — whoami / 수신 이벤트(received)를 fetch 해 인라인 표시 + 2초 자동 새로고침. */
+;(function () {
+  var out = document.getElementById('out')
+  function show(/** @type {any} */ obj) {
+    if (out) out.textContent = JSON.stringify(obj, null, 2)
+  }
+  function load(/** @type {string} */ url) {
+    fetch(url, { headers: { accept: 'application/json' } })
+      .then(function (res) {
+        return res.json()
+      })
+      .then(function (j) {
+        show(j && j.data != null ? j.data : j)
+      })
+      .catch(function (e) {
+        if (out) out.textContent = '오류: ' + e.message
+      })
+  }
+
+  var whoami = document.querySelector('button[data-get="/whoami"]')
+  if (whoami) whoami.addEventListener('click', function () { load('/whoami') })
+  var refresh = document.getElementById('refresh')
+  if (refresh) refresh.addEventListener('click', function () { load('/received') })
+
+  // 첫 로드 + 2초 폴링(탭 숨김 시 멈춤) — web 의 cross-app 이벤트가 도착하는 것을 실시간으로 본다.
+  load('/received')
+  setInterval(function () {
+    if (!document.hidden) load('/received')
+  }, 2000)
+})()

package/sample/multi/apps/admin/routes/pages.js

@@ -0,0 +1,11 @@
+// @ts-check
+/**
+ * apps/admin 라우트 — 자동 로딩. 글로벌 lock/bus(fallback) 사용 + cross-app 으로 받은 이벤트 표시.
+ */
+import { AdminController } from '../controllers/admin-controller.js'
+
+export default (/** @type {any} */ router) => {
+  router.http.get('/', AdminController.home)
+  router.http.get('/whoami', AdminController.whoami) // 글로벌 lock/bus driver 확인
+  router.http.get('/received', AdminController.received) // 글로벌 버스(glob.>)로 받은 이벤트 — web 의 cross-app 포함
+}

package/sample/multi/apps/admin/views/index.ejs

@@ -0,0 +1,33 @@
+<!doctype html>
+<html lang="ko">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>admin (b.com) — 멀티앱 데모</title>
+  <style>
+    body { font-family: system-ui, sans-serif; max-width: 760px; margin: 2rem auto; padding: 0 1rem; line-height: 1.6; }
+    code { background: #f3f3f3; padding: .1rem .3rem; border-radius: 3px; }
+    .tag { background: #6c757d; color: #fff; padding: .1rem .5rem; border-radius: 4px; font-size: .85rem; }
+    button { font: inherit; padding: .4rem .8rem; margin: .2rem .3rem .2rem 0; border: 1px solid #6c757d; background: #fff; color: #495057; border-radius: 6px; cursor: pointer; }
+    button:hover { background: #6c757d; color: #fff; }
+    .out { background: #f8f9fa; border: 1px solid #e3e6ea; border-radius: 6px; padding: .5rem .7rem; font-family: ui-monospace, monospace; font-size: .85rem; white-space: pre-wrap; min-height: 1.4rem; margin: .3rem 0; }
+    .desc { color: #555; font-size: .9rem; margin: .1rem 0 .3rem; }
+  </style>
+</head>
+<body>
+  <h1>admin 앱 <span class="tag">b.com</span></h1>
+  <p>이 앱은 <strong>앱별 lock/bus 설정이 없어 글로벌 fallback</strong>(lock=memory, bus prefix <code>glob.</code>)을
+     씁니다 (ADR-229). 같은 프로세스의 <code>web</code>(a.com)은 앱 전용 redis 락 + <code>web.</code> 버스를 씁니다.</p>
+
+  <div>
+    <button data-get="/whoami">whoami</button>
+    <button id="refresh">수신 이벤트 새로고침</button>
+  </div>
+  <div class="desc">이 앱의 lock/bus driver — memory / nats(glob.). 아래는 글로벌 버스로 받은 이벤트입니다.</div>
+  <div class="out" id="out"></div>
+  <p class="desc"><code>web</code> 의 <code>/cross</code>(getApp('admin').bus)가 보낸 <code>notice</code> 가 여기 들어옵니다(cross-app).
+     web 의 <code>web.</code> 발행은 prefix 격리로 들어오지 않습니다. web 앱은 <a href="http://a.com:3200/">a.com</a>.</p>
+
+  <script src="/static/js/admin.js"></script>
+</body>
+</html>

package/sample/multi/apps/web/app.config.js

@@ -0,0 +1,30 @@
+// @ts-check
+/**
+ * apps/web/app.config.js — `web` 앱(a.com). **앱 전용 lock/bus**(ADR-229)로 admin 과 분리한다.
+ *   - lock: redis(`webLock` 캐시) — admin 의 글로벌 memory 락과 다른 backend.
+ *   - bus: NATS, prefix `web.` — 글로벌 `glob.` 와 subject 공간이 갈려 격리된다(같은 NATS 공유).
+ */
+export default {
+  name: 'web',
+  hosts: ['a.com', 'localhost'],
+
+  views: { dir: 'apps/web/views' },
+
+  // 정적 자산 — 데모 페이지의 클라이언트 JS(/static/js/web.js)를 서빙(CSP script-src 'self' 호환).
+  staticAssets: { enabled: true, dir: 'apps/web/public', prefix: '/static' },
+
+  // helmet CSP — 로컬 http 데모라 `upgrade-insecure-requests` 를 끈다(null 로 디폴트 지시어 제거). 안 끄면
+  // 브라우저가 http://a.com:3200 을 https 로 강제 업그레이드해 (TLS 없음) 연결 실패한다. useDefaults 라 나머지
+  // 보안 헤더는 유지. (운영 https 배포에선 이 override 를 빼서 업그레이드를 다시 켜는 게 맞다.)
+  helmet: {
+    contentSecurityPolicy: {
+      directives: { upgradeInsecureRequests: null },
+    },
+  },
+
+  // 앱 전용 분산 락 — 글로벌(memory)과 달리 redis backend. lock.cache 는 글로벌 services.caches 키를 참조.
+  lock: { cache: 'webLock' },
+
+  // 앱 전용 버스 — 글로벌과 같은 NATS(`events`)지만 prefix 가 달라(web.) admin(glob.)과 격리된다.
+  bus: { nats: 'events', prefix: 'web.' },
+}

package/sample/multi/apps/web/controllers/web-controller.js

@@ -0,0 +1,45 @@
+// @ts-check
+/**
+ * WebController — `web` 앱(a.com) 컨트롤러(ADR-074: 베이스 없음, 정적 메서드만).
+ *
+ * 앱 전용 lock(redis)·bus(prefix `web.`)를 그대로 쓴다. `/cross` 는 `getApp('admin')`(ADR-228)로 다른 앱의
+ * 글로벌 버스에 이벤트를 보내는 cross-app 호출을 보여준다.
+ */
+import { getApp } from 'mega-framework'
+
+/** @param {number} ms @returns {Promise<void>} */
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+export class WebController {
+  /** GET / — 셸 페이지. @param {any} _req @param {any} _reply @param {any} ctx */
+  static async home(_req, _reply, ctx) {
+    return ctx.render('index', { app: 'web', host: 'a.com' })
+  }
+
+  /** GET /whoami — 이 앱이 보는 lock/bus driver(앱별 분리 확인용). @param {any} _req @param {any} _reply @param {any} ctx */
+  static async whoami(_req, _reply, ctx) {
+    return { app: 'web', lock: (await ctx.lock.stats()).driver, bus: (await ctx.bus.stats()).driver, pid: process.pid }
+  }
+
+  /** GET /lock — web 전용 redis 락으로 임계구역 실행. admin 의 같은 키와 격리된다(다른 manager). @param {any} _req @param {any} _reply @param {any} ctx */
+  static async lock(_req, _reply, ctx) {
+    const held = await ctx.lock.with('shared:key', { ttl: 3000, waitMs: 2000 }, async () => {
+      await sleep(50)
+      return process.pid
+    })
+    return { app: 'web', lockDriver: (await ctx.lock.stats()).driver, ranOnPid: held }
+  }
+
+  /** GET /emit — web. prefix 로 발행. admin(glob.)은 못 받는다(prefix 격리). @param {any} _req @param {any} _reply @param {any} ctx */
+  static async emit(_req, _reply, ctx) {
+    await ctx.bus.emit('order.created', { from: 'web', ts: Date.now() })
+    return { app: 'web', emitted: 'order.created', prefix: 'web.', note: 'admin(glob.)은 prefix 가 달라 수신하지 않습니다.' }
+  }
+
+  /** GET /cross — getApp('admin').bus 로 admin 의 글로벌 버스에 직접 발행(cross-app). @param {any} _req @param {any} _reply @param {any} _ctx */
+  static async cross(_req, _reply, _ctx) {
+    // getApp('admin').bus 는 admin 의 manager(글로벌, glob. prefix) — admin 의 구독자가 받는다.
+    await getApp('admin').bus.emit('notice', { from: 'web', message: 'hello admin', ts: Date.now() })
+    return { from: 'web', target: 'admin', sentVia: "getApp('admin').bus.emit('notice')", check: 'b.com/received' }
+  }
+}

package/sample/multi/apps/web/public/js/web.js

@@ -0,0 +1,24 @@
+// @ts-check
+/* web 앱 데모 — 버튼 클릭 시 엔드포인트를 fetch 해 결과를 페이지 안에 인라인 표시(JSON 페이지로 이동 안 함). */
+;(function () {
+  var buttons = document.querySelectorAll('button[data-get]')
+  for (var i = 0; i < buttons.length; i++) {
+    buttons[i].addEventListener('click', function (/** @type {any} */ ev) {
+      var url = ev.target.getAttribute('data-get')
+      var outId = 'out-' + url.slice(1) // /whoami → out-whoami
+      var out = document.getElementById(outId)
+      if (out) out.textContent = '실행 중…'
+      fetch(url, { headers: { accept: 'application/json' } })
+        .then(function (res) {
+          return res.json()
+        })
+        .then(function (j) {
+          var data = j && j.data != null ? j.data : j
+          if (out) out.textContent = JSON.stringify(data, null, 2)
+        })
+        .catch(function (e) {
+          if (out) out.textContent = '오류: ' + e.message
+        })
+    })
+  }
+})()

package/sample/multi/apps/web/routes/pages.js

@@ -0,0 +1,13 @@
+// @ts-check
+/**
+ * apps/web 라우트 — 자동 로딩(loadRoutes, ADR-157). 멀티앱·앱별 lock/bus·cross-app 시연(인증 없음 — 데모).
+ */
+import { WebController } from '../controllers/web-controller.js'
+
+export default (/** @type {any} */ router) => {
+  router.http.get('/', WebController.home) // 셸 페이지
+  router.http.get('/whoami', WebController.whoami) // 이 앱의 host·lock/bus driver
+  router.http.get('/lock', WebController.lock) // ctx.lock.with — web 전용 redis 락
+  router.http.get('/emit', WebController.emit) // ctx.bus.emit — web. prefix(admin 미수신)
+  router.http.get('/cross', WebController.cross) // getApp('admin').bus.emit — admin 의 글로벌 버스로 cross-app
+}

package/sample/multi/apps/web/views/index.ejs

@@ -0,0 +1,51 @@
+<!doctype html>
+<html lang="ko">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>web (a.com) — 멀티앱 데모</title>
+  <style>
+    body { font-family: system-ui, sans-serif; max-width: 760px; margin: 2rem auto; padding: 0 1rem; line-height: 1.6; }
+    code { background: #f3f3f3; padding: .1rem .3rem; border-radius: 3px; }
+    .tag { background: #0d6efd; color: #fff; padding: .1rem .5rem; border-radius: 4px; font-size: .85rem; }
+    button { font: inherit; padding: .4rem .8rem; margin: .2rem .3rem .2rem 0; border: 1px solid #0d6efd; background: #fff; color: #0d6efd; border-radius: 6px; cursor: pointer; }
+    button:hover { background: #0d6efd; color: #fff; }
+    .row { display: flex; gap: .8rem; align-items: flex-start; margin: .4rem 0; flex-wrap: wrap; }
+    .out { flex: 1; min-width: 280px; background: #f8f9fa; border: 1px solid #e3e6ea; border-radius: 6px; padding: .4rem .6rem; font-family: ui-monospace, monospace; font-size: .85rem; white-space: pre-wrap; min-height: 1.4rem; }
+    .desc { color: #555; font-size: .9rem; margin: .1rem 0 .3rem; }
+  </style>
+</head>
+<body>
+  <h1>web 앱 <span class="tag">a.com</span></h1>
+  <p>이 앱은 <strong>앱 전용 lock(redis) + bus(prefix <code>web.</code>)</strong>를 씁니다 (ADR-229). 같은 프로세스의
+     <code>admin</code>(b.com)은 글로벌 lock(memory)/bus(prefix <code>glob.</code>)를 씁니다. 한 포트를 <code>Host</code>
+     헤더로 나눠 라우팅합니다(vhost). 버튼을 누르면 결과가 아래에 바로 표시됩니다.</p>
+
+  <div class="row">
+    <button data-get="/whoami">whoami</button>
+    <div class="out" id="out-whoami"></div>
+  </div>
+  <div class="desc">이 앱이 보는 lock/bus driver — redis / nats (앱 전용).</div>
+
+  <div class="row">
+    <button data-get="/lock">lock 실행</button>
+    <div class="out" id="out-lock"></div>
+  </div>
+  <div class="desc">web 전용 redis 락으로 임계구역 실행 (<code>ctx.lock.with</code>).</div>
+
+  <div class="row">
+    <button data-get="/emit">emit (web.)</button>
+    <div class="out" id="out-emit"></div>
+  </div>
+  <div class="desc"><code>web.order.created</code> 발행 — admin(glob.)은 prefix 가 달라 받지 못합니다(격리).</div>
+
+  <div class="row">
+    <button data-get="/cross">cross-app</button>
+    <div class="out" id="out-cross"></div>
+  </div>
+  <div class="desc"><code>getApp('admin').bus.emit('notice')</code> → admin 의 글로벌 버스로 직접 전달. 결과는
+     <a href="http://b.com:3200/">b.com</a> 의 "수신 이벤트"에서 확인하세요.</div>
+
+  <script src="/static/js/web.js"></script>
+</body>
+</html>

package/sample/multi/mega.config.js

@@ -0,0 +1,42 @@
+// @ts-check
+/**
+ * sample/multi — 한 프로세스에 **두 앱**을 vhost 로 띄우는 멀티앱 데모 (ADR-063 vhost + ADR-229 앱별 lock/bus).
+ *
+ * - `web`(a.com): 앱 전용 lock(redis `webLock`) + 앱 전용 bus(NATS, prefix `web.`).
+ * - `admin`(b.com): 앱별 설정 없음 → **글로벌** lock(memory) + 글로벌 bus(NATS, prefix `glob.`)를 fallback 으로.
+ *
+ * 한 포트(3200) 한 번 listen, 요청은 `Host` 헤더로 앱에 라우팅된다. lock/bus 는 앱마다 다른 manager 라
+ * 같은 키여도 격리되고, `getApp('admin')` 으로 다른 앱의 자원을 cross-app 호출할 수 있다.
+ *
+ * Global-only 스코프(ADR-061): 활성 앱 whitelist·전역 services·server·logger. App-only 키는 apps/<name>/app.config.js.
+ */
+export default {
+  apps: ['web', 'admin'],
+
+  server: {
+    // 3200 디폴트 — sample/crud·sample/simple(둘 다 3000)과 겹치지 않게(같은 머신에서 동시에 띄울 수 있게).
+    // 포트가 이미 점유돼 있으면 boot 가 `listen EADDRINUSE` 로 실패한다(브라우저가 옛 서버를 때리는 혼동 방지).
+    port: Number(process.env.PORT ?? 3200),
+  },
+
+  // 전역 services — 앱들이 별명으로 참조(ADR-102). lock.cache/bus.nats 는 여기 키를 가리킨다.
+  services: {
+    caches: {
+      // web 앱 전용 분산 락 backend(redis). admin 은 이 cache 를 안 쓴다(글로벌 memory 락).
+      webLock: { driver: 'redis', url: process.env.REDIS_WEBLOCK_URL },
+    },
+    buses: {
+      // 두 앱이 공유하는 NATS. prefix 로 subject 공간을 나눠 격리한다(web. vs glob.).
+      events: { driver: 'nats', url: process.env.NATS_EVENTS_URL },
+    },
+  },
+
+  // 글로벌 bus(fallback) — admin 처럼 앱별 bus 미지정 앱이 쓴다. prefix 'glob.'.
+  // 글로벌 lock 은 생략 → 자동 폴백 memory(redis cache 미지정). admin 이 이 memory 락을 쓴다.
+  bus: { nats: 'events', prefix: 'glob.' },
+
+  logger: {
+    level: 'info',
+    sinks: [{ type: 'console', pretty: true }],
+  },
+}

package/sample/multi/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "sample-multi",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "dev": "NODE_ENV=development mega start",
+    "start": "NODE_ENV=production mega start",
+    "test": "mega test"
+  },
+  "dependencies": {
+    "mega-framework": "file:../.."
+  },
+  "devDependencies": {
+    "vitest": "^4.1.8"
+  }
+}

package/sample/simple/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
     "dev": "NODE_ENV=development mega start",
@@ -19,7 +19,7 @@
     "mega-framework": "file:../.."
   },
   "devDependencies": {
-    "concurrently": "^9.0.0",
+    "concurrently": "^10.0.3",
     "vitest": "^4.1.8"
   }
 }