@gaonjs/cli 0.30.0 → 0.31.0

package/dist/commands/test.js

@@ -155,8 +155,14 @@ export async function runTestCommand(args = [], opts = {}) {
         cmd = vitestBin;
         spawnArgs = ['run', ...passthrough];
     }
+    // 결정 130: 테스트 프로세스에 스트림 네임스페이스 접두를 주입해 잡·이벤트
+    // NATS 스트림을 개발 스택과 격리한다(규칙 10 · DB `<db>_test` 와 대칭). 접두가
+    // 붙으면 테스트가 쓰는 스트림/subject 가 `GAON_TEST_JOBS`·`test.gaon.jobs.>` 로
+    // 갈려, 개발용 `gaon work` 가 떠 있어도 서로 잡을 훔치지 않는다. 사용자가 이미
+    // 값을 세팅했으면 존중한다(고급 · 다중 테스트 컨텍스트 분리).
+    const testEnv = { ...process.env, GAON_STREAM_PREFIX: process.env.GAON_STREAM_PREFIX ?? 'test' };
     if (json) {
-        process.stdout.write(JSON.stringify({ kind: 'starting', cmd, args: spawnArgs, scope }) + '\n');
+        process.stdout.write(JSON.stringify({ kind: 'starting', cmd, args: spawnArgs, scope, streamPrefix: testEnv.GAON_STREAM_PREFIX }) + '\n');
     }
     else {
         process.stdout.write(`  gaon test · ${cmd} ${spawnArgs.join(' ')} (scope=${scope})\n`);
@@ -164,7 +170,7 @@ export async function runTestCommand(args = [], opts = {}) {
     const exitCode = await new Promise((resolvePromise) => {
         const child = spawn(cmd, spawnArgs, {
             cwd,
-            env: process.env,
+            env: testEnv,
             // vitest 컬러 출력·리포터를 그대로 보여주기 위해 stdio 를 상속한다.
             stdio: 'inherit',
         });

package/dist/templates/project/agents/async.md.tpl

@@ -86,6 +86,10 @@ await SendWelcomeMail.at(someDate, user.id) // 특정 시각 실행
   `curve`(백오프 곡선 ms) · `jitter` · `concurrency`.
 - **실패** — 재시도를 소진하면 DLQ 로 간다. `gaon jobs list --failed` ·
   `gaon jobs retry <id>` 로 조회·재적재한다.
+- **실행 컨텍스트(결정 129)** — `gaon work` 는 `gaon serve` 와 **같은 도메인
+  배선**(DB 커넥션 · 메일)을 태운다. 그래서 잡 핸들러에서 모델 조회(`User.find`),
+  `Mail.deliver`, `broadcast`, 다른 잡 `.later()` 를 웹 컨트롤러에서와 똑같이 쓴다
+  — 워커라서 못 쓰는 배터리는 없다.
 - 기본 백오프 곡선은 `[1s, 5s, 30s, 5m, 1h]` + 지터 0.2, 재시도 3
   (총 4시도) — §7 · 벤치마크로 확정된 값.
 

package/dist/templates/project/agents/frontend.md.tpl

@@ -361,8 +361,11 @@ async function runSearch(q: string) {
   **method-override** 가 잡는다(결정 89).
 - **채널 구독은 `useChannel()`** — 실시간 클라이언트는 `gaonjs/vue` 의
   `useChannel(name, opts)` 가 정본(결정 87). `new WebSocket` 을 손으로 짜면
-  URL(`/gaon/ws/<채널>`)·봉투(`{ t:'msg', data }`)·라이프사이클을 재구현하다
-  틀린다(`agents/realtime.md` §4). 구독 래핑은 컴포저블에.
+  URL(`/gaon/ws/<채널>`)·봉투(`{ t:'msg', data }`)·라이프사이클·**자동 재연결**을
+  재구현하다 틀린다(`agents/realtime.md` §4). 구독 래핑은 컴포저블에. 소켓이 끊기면
+  useChannel 이 지수 백오프로 **자동 재접속**하고 프레즌스를 재동기한다(결정 128 · 기본
+  켬 · `status='reconnecting'` · `onReconnect` 로 놓친 데이터 따라잡기 · 미인가 4401 은
+  재연결 안 함). 손 WebSocket 재연결 루프를 짜지 말 것.
 - **레이아웃을 shared 에 두지 않는다** — 앱별이 정상(UI 킷 §8 은 예외 — 성격
   중립 순수 UI 라 `shared/components/ui` 프로젝트당 한 벌 · 결정 105).
 - **UI 킷은 `@shared/components/ui/…` 로 import** — `../../../shared/...` 같은 깊은

package/dist/templates/project/agents/realtime.md.tpl

@@ -144,6 +144,7 @@ export function useRoom(roomId: number) {
     params: { room: roomId },
     onMessage: (data) => { /* 서버가 broadcast/send 한 데이터 */ },
     onPresence: (delta) => { /* 접속자 join/leave */ },
+    onReconnect: () => { /* 재연결됨 — 놓친 데이터를 Inertia partial reload 로 따라잡기 */ },
   })
   return { messages, status, send }
 }
@@ -153,8 +154,18 @@ export function useRoom(roomId: number) {
   정답 경로). 날 페이로드를 직접 보내면 서버가 안 흘린다.
 - **받기** — `msg` 프레임은 `messages` 에 축적 + `onMessage` 호출, `presence` 는
   `onPresence`. 그 외는 `onFrame`.
+- **자동 재연결(결정 128 · 기본 켬)** — 소켓이 끊기면(서버 재시작·네트워크 blip)
+  useChannel 이 **지수 백오프**(1s·2s·5s·10s · 이후 10s 반복 · 지터)로 자동 재접속한다.
+  새 소켓은 서버가 다시 인가하고 프레즌스 스냅샷을 다시 밀어주므로 접속자 목록이
+  재동기된다(`messages` 는 유지 · 놓친 이벤트 리플레이는 범위 밖). `status` 는
+  `'connecting' | 'open' | 'reconnecting' | 'closed'` 로, 드롭 후 `'reconnecting'`,
+  성공하면 `'open'`. **재연결 성공 시 `onReconnect` 콜백**으로 놓친 데이터를 따라잡는다
+  (Inertia partial reload). **미인가(4401 close · authorize 거부·세션 만료)면 재연결하지
+  않고 `'closed'`** — 서버 다운(재시도)과 인가 거부(포기)를 close code 로 가른다. 끄려면
+  `reconnect: false`, 튜닝은 `reconnect: { curveMs, maxDelayMs, maxAttempts }`. 언마운트·
+  수동 `close()` = 의도적 종료라 재연결하지 않는다.
 - **탈출구** — 표준 WebSocket 이 필요하면 `new WebSocket('<프리픽스>/gaon/ws/<채널명>')`
-  을 직접 쓸 수 있다(봉투·라이프사이클을 스스로 책임진다). 기본 경로는 `useChannel`.
+  을 직접 쓸 수 있다(봉투·라이프사이클·재연결을 스스로 책임진다). 기본 경로는 `useChannel`.
 
 ### 5. 허브 프로세스 (`gaon hub`)
 

package/dist/templates/project/agents/testing.md.tpl

@@ -15,13 +15,19 @@
 테스트만 다른 DB 로 돌리는 것은 자기모순이며, 방언 차이 버그가
 테스트를 통과해 운영에서 터지는 구멍이었다.
 
-- 테스트 전에 compose 로 DB · NATS 를 띄우고, **테스트 전용
-  데이터베이스**(truncate 격리 · 결정 111) + **테스트 전용 스트림
-  프리픽스**를 쓴다.
+- 테스트 전에 compose 로 DB · NATS 를 띄운다. `gaon test` 가 **테스트 전용
+  데이터베이스**(`<db>_test` · truncate 격리 · 결정 111) 와 **테스트 전용 NATS
+  스트림 네임스페이스**(`GAON_STREAM_PREFIX` · 결정 130) 를 **자동으로** 격리한다.
 - `gaon test` 가 테스트 전용 데이터베이스(`<db>_test`)를 **자동 준비**한다
   — 없으면 만들고(CREATE DATABASE) 마이그레이션까지 적용한 뒤 vitest 를
   돌린다. 스캐폴드 `test/setup.ts` 가 그 DB 에 붙고(`connectTestDatabase`)
   매 테스트 뒤 전 테이블을 비운다(`truncateAll`). 아래 §5 참고.
+- `gaon test` 가 잡·이벤트 NATS 스트림도 **자동 격리**한다(결정 130) —
+  테스트 프로세스에 `GAON_STREAM_PREFIX` 를 주입해 스트림·subject 가
+  `GAON_TEST_JOBS`·`test.gaon.jobs.>` 로 갈린다. 그래서 개발용 `gaon work` 가
+  떠 있어도 테스트 잡을 훔치지 않고, 테스트가 남긴 잡을 개발 워커가 처리하지도
+  않는다 — **테스트 전에 워커를 내릴 필요가 없다.** (직접 `vitest` 로 돌리면 이
+  격리가 없어 개발 스택과 섞이니 `gaon test` 를 쓴다.)
 - SQLite 는 Docker 가 불가능한 환경의 폴백으로만 남고 공식 경로가
   아니다.
 
@@ -170,8 +176,10 @@ hidden 값은 **서버 코드에서는 여전히 읽힌다**(직렬화 경계에
 - **`expect(true).toBe(true)` 류 무의미 단언 금지** — 실 인프라에
   접속하지 않는 통합 테스트는 §9 위반으로 판정된다.
 - **NATS·DB 목업 금지** — `vi.mock` 으로 전송을 막으면 검증이 무효.
-- **테스트 격리** — 공유 큐 이름을 쓰면 병렬 테스트가 서로의 잡을
-  소비한다. 큐·스트림 프리픽스를 테스트 전용으로.
+- **테스트 격리는 `gaon test` 가 해 준다(결정 130)** — 잡·이벤트 스트림을
+  테스트 네임스페이스(`GAON_STREAM_PREFIX`)로 자동 격리하므로, 개발용 `gaon work`
+  와 나란히 돌려도 서로의 잡을 소비하지 않는다. 직접 `vitest` 로 돌리면 이 격리가
+  없으니(개발 스택 공유) `gaon test` 를 쓴다.
 - **워커 정리** — 직접 `runWorker` 를 쓰면 테스트 종료 전 `stop()` 을
   보장하라 (`expectJobProcessed` 는 자동 정리).
 - **직렬화 테스트가 직접 행만 봄** — hidden 검증을 `Model.create()` 결과
@@ -185,5 +193,6 @@ hidden 값은 **서버 코드에서는 여전히 읽힌다**(직렬화 경계에
 | 결정 42 | 비동기 테스트 헬퍼 `expectJobProcessed` (`gaonjs/testing`) |
 | 결정 122 | 직렬화 경계 테스트는 관계 경유 hidden 을 반드시 포함(재귀 no-leak 단언) |
 | 결정 111 | `gaon test` 테스트 DB 자동 준비 + `connectTestDatabase`·`truncateAll` 격리(truncate · service COMMIT 실측) |
+| 결정 130 | `gaon test` 가 NATS 스트림도 자동 격리(`GAON_STREAM_PREFIX` → `GAON_TEST_JOBS`·`test.gaon.jobs.>`) — 개발 워커 병행 시 잡 누출 방지(규칙 10 이행) |
 | §9 (v0.15) | 실 인프라 필수 · 목업/인메모리 금지 |
 | 결정 32 | 잡 발행 위치 자유 — publish 함수가 서비스 경유여도 검증 대상 |

package/dist/work.js

@@ -11,7 +11,8 @@
  */
 import { hostname } from 'node:os';
 import { connectNats, runWork } from '@gaonjs/async';
-import { createDb } from '@gaonjs/data';
+import { createDb, registerConnection, hasConnection, getConnection } from '@gaonjs/data';
+import { loadGaonConfig, wireDomain } from '@gaonjs/config';
 import { loadDomain } from './domain.js';
 /** DB URL 에서 어댑터를 추정한다(postgres·mysql). */
 function dbConfigFromUrl(url) {
@@ -69,12 +70,23 @@ export async function runWorkCommand(opts = {}) {
         }
     };
     const nats = await connectNats({ servers: opts.natsUrl, name: `work@${id}` });
-    let db;
+    // 도메인 배터리 배선(결정 129) — 잡 핸들러가 모델을 읽고(registerConnection)
+    // 메일을 보내려면(configureMailer) work 도 serve 와 같은 도메인 배선을 태워야
+    // 한다. serve 는 wireGaon → wireDomain, work 은 여기서 직접 wireDomain 을
+    // 호출한다. 이 배선이 없으면 잡에서 모델 조회·메일 발송이 운영 워커에서만
+    // 조용히 깨진다(gaon dev 는 serve 프로세스가 대신 배선해 가려짐).
+    const config = await loadGaonConfig(root);
+    const domainWiring = await wireDomain(config, root);
+    // 아웃박스 릴레이·모델 읽기용 main 커넥션. gaon.config 에 db.main 이 있으면
+    // wireDomain 이 이미 등록했다. config 없이 env(DATABASE_URL)만 있는 프로젝트는
+    // 여기서 관례로 보강 등록해 잡의 모델 읽기와 릴레이가 함께 동작하게 한다.
     // 스캐폴드 .env 관례(DATABASE_URL)를 정본으로 · GAON_DATABASE_URL 은 하위호환.
-    // serve(config 경유 DATABASE_URL)와 work 가 같은 env 를 보게 한다.
     const dbUrl = opts.databaseUrl ?? process.env.DATABASE_URL ?? process.env.GAON_DATABASE_URL;
-    if (dbUrl)
-        db = createDb(dbConfigFromUrl(dbUrl));
+    if (!hasConnection('main') && dbUrl) {
+        const cfg = dbConfigFromUrl(dbUrl);
+        registerConnection('main', createDb(cfg), cfg.adapter);
+    }
+    const db = hasConnection('main') ? getConnection('main') : undefined;
     const domain = await loadDomain(root);
     // 로드된 도메인 자산 요약(파일=등록 관측용). 잡·리스너·메일 수를 노출한다.
     if (json) {
@@ -99,8 +111,7 @@ export async function runWorkCommand(opts = {}) {
         });
     }
     catch (err) {
-        if (db)
-            await db.destroy().catch(() => { });
+        await domainWiring.closeDomain().catch(() => { });
         await nats.close();
         throw err;
     }
@@ -110,8 +121,7 @@ export async function runWorkCommand(opts = {}) {
             signals.off('SIGTERM', stop);
             void (async () => {
                 await work.stop();
-                if (db)
-                    await db.destroy().catch(() => { });
+                await domainWiring.closeDomain().catch(() => { });
                 await nats.close();
                 if (json)
                     process.stdout.write(JSON.stringify({ kind: 'stopped' }) + '\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaonjs/cli",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Gaon CLI 구현: 제너레이터·스캐폴딩·로드맵 출력 (M1 스텁)",
   "type": "module",
   "license": "MIT",
@@ -27,12 +27,12 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "typescript": "^5.9.0",
     "vite": "^7.0.0",
-    "@gaonjs/config": "0.9.2",
-    "@gaonjs/core": "0.2.1",
-    "@gaonjs/web": "0.13.0",
+    "@gaonjs/async": "0.8.0",
+    "@gaonjs/config": "0.10.0",
     "@gaonjs/data": "0.13.1",
+    "@gaonjs/core": "0.2.1",
     "@gaonjs/mail": "0.1.3",
-    "@gaonjs/async": "0.7.0"
+    "@gaonjs/web": "0.13.1"
   },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json && node -e \"require('fs').cpSync('src/templates','dist/templates',{recursive:true})\""