mega-framework 0.1.0

package/sample/crud/apps/main/views/upload/index.ejs

@@ -0,0 +1,79 @@
+<% layout('layouts/main') %>
+<%
+  function fmt(d) { return new Date(d).toLocaleString('ko-KR', { hour12: false, timeZone: 'Asia/Seoul' }) }
+  function kb(b) { return (Number(b) / 1024).toFixed(1) + ' KB' }
+%>
+
+<div class="mb-4">
+  <h1 class="h3 mb-1"><%= t('upload_title', { defaultValue: '파일 업로드' }) %></h1>
+  <p class="text-body-secondary small mb-0"><%= t('upload_subtitle', { defaultValue: 'multipart 업로드를 프로젝트 폴더에 저장하고 메타·다운로드 링크를 보여줍니다.' }) %></p>
+</div>
+
+<div class="row g-3">
+  <div class="col-lg-5">
+    <div class="card h-100">
+      <div class="card-body">
+        <h2 class="h5 card-title"><%= t('upload_form_title', { defaultValue: '업로드' }) %></h2>
+        <p class="card-text text-body-secondary small"><%= t('upload_form_desc', { defaultValue: '이미지·PDF·텍스트 파일을 올립니다 (MIME·크기·개수 게이트).' }) %></p>
+        <form id="up-form" data-csrf="<%= csrfToken %>">
+          <div class="mb-3">
+            <label class="form-label small mb-1" for="up-file"><%= t('upload_file_label', { defaultValue: '파일 선택' }) %></label>
+            <input type="file" class="form-control form-control-sm" id="up-file" name="file" multiple accept="image/*,application/pdf,text/plain" />
+            <div class="form-text small"><%= t('upload_constraints', { defaultValue: '허용: 이미지/PDF/텍스트 · 최대 5MB · 한 번에 3개까지' }) %></div>
+          </div>
+          <div class="alert alert-light border small py-2 mb-3">
+            <%= t('upload_dir_hint', { defaultValue: '저장 위치(프로젝트 루트 기준):' }) %> <code><%= uploadDir %>/</code>
+          </div>
+          <button type="submit" class="btn btn-primary btn-sm" id="up-submit">
+            <span class="spinner-border spinner-border-sm d-none" id="up-spinner" role="status" aria-hidden="true"></span>
+            <%= t('upload_submit', { defaultValue: '업로드' }) %>
+          </button>
+        </form>
+        <div class="alert alert-danger small mt-3 mb-0 d-none" id="up-error">
+          <strong><%= t('upload_error', { defaultValue: '업로드 실패:' }) %></strong> <span id="up-error-detail"></span>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div class="col-lg-7">
+    <div class="card h-100">
+      <div class="card-body">
+        <h2 class="h5 card-title"><%= t('upload_recent_title', { defaultValue: '최근 업로드' }) %></h2>
+        <p class="card-text text-body-secondary small"><%= t('upload_recent_desc', { defaultValue: '저장된 파일의 메타데이터입니다 (파일명 클릭 시 다운로드).' }) %></p>
+        <% if (snap.recent.length === 0) { %>
+          <p class="text-body-secondary small mb-0"><%= t('upload_recent_empty', { defaultValue: '아직 업로드한 파일이 없습니다.' }) %></p>
+        <% } else { %>
+          <div class="table-responsive">
+            <table class="table table-sm align-middle mb-0">
+              <thead>
+                <tr>
+                  <th scope="col"><%= t('upload_recent_at', { defaultValue: '시각' }) %></th>
+                  <th scope="col"><%= t('upload_recent_name', { defaultValue: '파일명' }) %></th>
+                  <th scope="col"><%= t('upload_recent_path', { defaultValue: '저장 경로' }) %></th>
+                  <th scope="col"><%= t('upload_recent_mime', { defaultValue: 'MIME' }) %></th>
+                  <th scope="col" class="text-end"><%= t('upload_recent_size', { defaultValue: '크기' }) %></th>
+                </tr>
+              </thead>
+              <tbody>
+                <% snap.recent.forEach(function (e) { %>
+                  <tr>
+                    <td class="font-monospace small"><%= fmt(e.at) %></td>
+                    <td class="small text-break">
+                      <a href="/demo/upload/file/<%= encodeURIComponent(e.filename) %>"><%= e.filename %></a>
+                    </td>
+                    <td class="font-monospace small text-break"><%= e.path || '—' %></td>
+                    <td><span class="badge text-bg-light"><code><%= e.mimetype %></code></span></td>
+                    <td class="text-end font-monospace small"><%= kb(e.bytes) %></td>
+                  </tr>
+                <% }) %>
+              </tbody>
+            </table>
+          </div>
+        <% } %>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script src="/static/js/upload-demo.js"></script>

package/sample/crud/apps/main/views/users/edit.ejs

@@ -0,0 +1,48 @@
+<% layout('layouts/main') %>
+
+<div class="row justify-content-center">
+  <div class="col-lg-6">
+    <h1 class="h3 mb-4"><%= t('edit_title', '사용자 수정') %> <span class="text-body-secondary">#<%= values.id %></span></h1>
+
+    <% if (typeof error !== 'undefined' && error) { %>
+      <div class="alert alert-danger" role="alert"><%= error %></div>
+    <% } %>
+
+    <form method="post" action="/admin/users/<%= values.id %>" novalidate>
+      <input type="hidden" name="_csrf" value="<%= csrfToken %>" />
+
+      <div class="mb-3">
+        <label for="name" class="form-label"><%= t('field_name', '이름') %></label>
+        <input
+          type="text"
+          class="form-control <%= invalid && invalid.name ? 'is-invalid' : '' %>"
+          id="name"
+          name="name"
+          value="<%= values && values.name ? values.name : '' %>"
+          placeholder="<%= t('field_name_ph', '예: 홍길동') %>"
+          required
+        />
+        <div class="invalid-feedback"><%= t('field_name_required', '이름을 입력하세요.') %></div>
+      </div>
+
+      <div class="mb-4">
+        <label for="email" class="form-label"><%= t('field_email', '이메일') %></label>
+        <input
+          type="email"
+          class="form-control <%= invalid && invalid.email ? 'is-invalid' : '' %>"
+          id="email"
+          name="email"
+          value="<%= values && values.email ? values.email : '' %>"
+          placeholder="<%= t('field_email_ph', '예: hong@example.com') %>"
+          required
+        />
+        <div class="invalid-feedback"><%= t('field_email_required', '올바른 이메일을 입력하세요.') %></div>
+      </div>
+
+      <div class="d-flex gap-2">
+        <button type="submit" class="btn btn-primary"><%= t('btn_save', '저장') %></button>
+        <a href="/admin/users" class="btn btn-outline-secondary"><%= t('btn_cancel', '취소') %></a>
+      </div>
+    </form>
+  </div>
+</div>

package/sample/crud/apps/main/views/users/list.ejs

@@ -0,0 +1,81 @@
+<% layout('layouts/main') %>
+
+<div class="d-flex flex-wrap align-items-center justify-content-between gap-2 mb-4">
+  <h1 class="h3 mb-0"><%= t('users_title', '사용자 목록') %></h1>
+  <a href="/admin/users/new" class="btn btn-primary">+ <%= t('users_new', '사용자 추가') %></a>
+</div>
+
+<% if (typeof notice !== 'undefined' && notice) { %>
+  <div class="alert alert-success alert-dismissible fade show" role="alert">
+    <%= notice %>
+    <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="close"></button>
+  </div>
+<% } %>
+
+<% if (!users || users.length === 0) { %>
+  <div class="text-center text-body-secondary py-5">
+    <div class="display-4 mb-3">📭</div>
+    <p class="mb-3"><%= t('users_empty', '아직 사용자가 없습니다.') %></p>
+    <a href="/admin/users/new" class="btn btn-outline-primary"><%= t('users_new', '사용자 추가') %></a>
+  </div>
+<% } else { %>
+  <div class="table-responsive">
+    <table class="table table-striped table-hover align-middle">
+      <thead>
+        <tr>
+          <th scope="col" class="text-end" style="width: 5rem"><%= t('col_id', 'ID') %></th>
+          <th scope="col"><%= t('col_name', '이름') %></th>
+          <th scope="col"><%= t('col_email', '이메일') %></th>
+          <th scope="col"><%= t('col_created', '생성일') %></th>
+          <th scope="col" class="text-end"><%= t('col_actions', '관리') %></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% users.forEach(function (u) { %>
+          <tr>
+            <td class="text-end text-body-secondary"><%= u.id %></td>
+            <td class="fw-medium"><%= u.name %></td>
+            <td><%= u.email %></td>
+            <td class="text-body-secondary small"><%= u.created_at %></td>
+            <td class="text-end text-nowrap">
+              <a href="/admin/users/<%= u.id %>/edit" class="btn btn-sm btn-outline-secondary"><%= t('action_edit', '수정') %></a>
+              <button
+                type="button"
+                class="btn btn-sm btn-outline-danger"
+                data-bs-toggle="modal"
+                data-bs-target="#deleteModal"
+                data-action="/admin/users/<%= u.id %>/delete"
+                data-name="<%= u.name %>"
+              >
+                <%= t('action_delete', '삭제') %>
+              </button>
+            </td>
+          </tr>
+        <% }) %>
+      </tbody>
+    </table>
+  </div>
+<% } %>
+
+<%# 삭제 확인 모달 — 한 개를 재사용. 클릭된 행의 data-action/data-name 으로 app.js 가 form·문구를 채운다
+    (show.bs.modal). 인라인 스크립트는 CSP(script-src 'self')에 막히므로 wiring 은 app.js(외부)에 둔다. %>
+<div class="modal fade" id="deleteModal" tabindex="-1" aria-labelledby="deleteModalLabel" aria-hidden="true">
+  <div class="modal-dialog modal-dialog-centered">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title" id="deleteModalLabel"><%= t('delete_confirm_title', '삭제 확인') %></h5>
+        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="close"></button>
+      </div>
+      <div class="modal-body">
+        <%= t('delete_confirm_body', '정말 삭제할까요?') %> <strong id="deleteModalName"></strong>
+      </div>
+      <div class="modal-footer">
+        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal"><%= t('delete_confirm_cancel', '취소') %></button>
+        <form id="deleteForm" method="post" class="d-inline">
+          <input type="hidden" name="_csrf" value="<%= csrfToken %>" />
+          <button type="submit" class="btn btn-danger"><%= t('delete_confirm_ok', '삭제') %></button>
+        </form>
+      </div>
+    </div>
+  </div>
+</div>

package/sample/crud/apps/main/views/users/new.ejs

@@ -0,0 +1,48 @@
+<% layout('layouts/main') %>
+
+<div class="row justify-content-center">
+  <div class="col-lg-6">
+    <h1 class="h3 mb-4"><%= t('new_title', '사용자 추가') %></h1>
+
+    <% if (typeof error !== 'undefined' && error) { %>
+      <div class="alert alert-danger" role="alert"><%= error %></div>
+    <% } %>
+
+    <form method="post" action="/admin/users" novalidate>
+      <input type="hidden" name="_csrf" value="<%= csrfToken %>" />
+
+      <div class="mb-3">
+        <label for="name" class="form-label"><%= t('field_name', '이름') %></label>
+        <input
+          type="text"
+          class="form-control <%= invalid && invalid.name ? 'is-invalid' : '' %>"
+          id="name"
+          name="name"
+          value="<%= values && values.name ? values.name : '' %>"
+          placeholder="<%= t('field_name_ph', '예: 홍길동') %>"
+          required
+        />
+        <div class="invalid-feedback"><%= t('field_name_required', '이름을 입력하세요.') %></div>
+      </div>
+
+      <div class="mb-4">
+        <label for="email" class="form-label"><%= t('field_email', '이메일') %></label>
+        <input
+          type="email"
+          class="form-control <%= invalid && invalid.email ? 'is-invalid' : '' %>"
+          id="email"
+          name="email"
+          value="<%= values && values.email ? values.email : '' %>"
+          placeholder="<%= t('field_email_ph', '예: hong@example.com') %>"
+          required
+        />
+        <div class="invalid-feedback"><%= t('field_email_required', '올바른 이메일을 입력하세요.') %></div>
+      </div>
+
+      <div class="d-flex gap-2">
+        <button type="submit" class="btn btn-primary"><%= t('btn_create', '생성') %></button>
+        <a href="/admin/users" class="btn btn-outline-secondary"><%= t('btn_cancel', '취소') %></a>
+      </div>
+    </form>
+  </div>
+</div>

package/sample/crud/apps/main/views/worker/index.ejs

@@ -0,0 +1,70 @@
+<% layout('layouts/main') %>
+
+<div class="mb-4">
+  <h1 class="h3 mb-1"><%= t('worker_title', { defaultValue: 'CPU 워커 데모 (MegaWorker)' }) %></h1>
+  <p class="text-body-secondary small mb-0"><%= t('worker_subtitle', { defaultValue: 'SHA-256 N회 반복 같은 CPU-bound 작업을 worker_threads 풀에서 돌립니다. 계산 도중에도 서버가 다른 요청에 즉시 응답하는지(메인 스레드 non-block) 하트비트로 확인합니다.' }) %></p>
+</div>
+
+<div class="row g-3">
+  <div class="col-lg-6">
+    <div class="card h-100">
+      <div class="card-body d-flex flex-column">
+        <h2 class="h5 card-title"><%= t('worker_run_title', { defaultValue: '해시 계산 실행' }) %></h2>
+        <p class="card-text text-body-secondary small"><%= t('worker_run_desc', { defaultValue: '반복 횟수만큼 SHA-256 을 체인 해시합니다. 메인 스레드가 아니라 워커 스레드에서 돕니다.' }) %></p>
+        <div class="mb-3">
+          <label for="wd-rounds" class="form-label small"><%= t('worker_rounds_label', { defaultValue: '반복 횟수' }) %></label>
+          <input type="number" class="form-control form-control-sm" id="wd-rounds" value="<%= defaultRounds %>" min="100000" max="20000000" step="100000" />
+        </div>
+        <div class="d-flex align-items-center gap-2">
+          <button type="button" class="btn btn-primary btn-sm" id="wd-run">
+            <span class="spinner-border spinner-border-sm d-none" id="wd-spinner" role="status" aria-hidden="true"></span>
+            <span id="wd-run-label"><%= t('worker_run_btn', { defaultValue: '워커에서 실행' }) %></span>
+          </button>
+          <span class="text-body-secondary small">
+            <%= t('worker_pool_mode', { defaultValue: '모드' }) %>: <code><%= pool.mode %></code> · <%= t('worker_pool_size', { defaultValue: '풀 크기' }) %>: <code><%= pool.poolSize %></code>
+          </span>
+        </div>
+
+        <div class="alert alert-danger mt-3 d-none small" id="wd-error" role="alert">
+          <%= t('worker_error', { defaultValue: '실행 실패:' }) %> <span id="wd-error-detail" class="font-monospace"></span>
+        </div>
+
+        <div class="mt-auto pt-3">
+          <div class="border rounded p-3 bg-body-tertiary d-none" id="wd-result">
+            <div class="d-flex justify-content-between"><span class="text-body-secondary small"><%= t('worker_result_rounds', { defaultValue: '반복 횟수' }) %></span><span class="font-monospace" id="wd-rounds-out">—</span></div>
+            <div class="d-flex justify-content-between"><span class="text-body-secondary small"><%= t('worker_result_ms', { defaultValue: '소요 시간' }) %></span><span class="font-monospace" id="wd-ms-out">—</span></div>
+            <div class="mt-2 text-body-secondary small"><%= t('worker_result_digest', { defaultValue: '최종 해시' }) %></div>
+            <div class="font-monospace text-break small" id="wd-digest-out">—</div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div class="col-lg-6">
+    <div class="card h-100">
+      <div class="card-body d-flex flex-column">
+        <h2 class="h5 card-title"><%= t('worker_heartbeat_title', { defaultValue: '메인 스레드 하트비트' }) %></h2>
+        <p class="card-text text-body-secondary small"><%= t('worker_heartbeat_desc', { defaultValue: '1초마다 서버에 ping 을 보냅니다. 워커가 계산하는 동안에도 이 지연이 작게 유지되면 메인 스레드가 안 막힌 것입니다.' }) %></p>
+        <div class="d-flex gap-4 mt-2">
+          <div>
+            <div class="display-6 fw-bold" id="wd-ping-count">0</div>
+            <div class="text-body-secondary small"><%= t('worker_heartbeat_count', { defaultValue: 'ping 횟수' }) %></div>
+          </div>
+          <div>
+            <div class="display-6 fw-bold"><span id="wd-ping-latency">—</span><span class="fs-6 text-body-secondary">ms</span></div>
+            <div class="text-body-secondary small"><%= t('worker_heartbeat_latency', { defaultValue: '최근 왕복 지연' }) %></div>
+          </div>
+        </div>
+        <div class="mt-2 text-body-secondary small">
+          <%= t('worker_heartbeat_last', { defaultValue: '마지막 ping' }) %>: <span class="font-monospace" id="wd-ping-time">—</span>
+        </div>
+        <div class="mt-auto pt-3">
+          <div class="alert alert-info small mb-0"><%= t('worker_heartbeat_proof', { defaultValue: '계산을 메인 스레드에서 했다면 이 ping 들이 계산이 끝날 때까지 통째로 멈춥니다. 워커 스레드라 멈추지 않습니다.' }) %></div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script src="/static/js/worker-demo.js"></script>

package/sample/crud/apps/main/views/ws/index.ejs

@@ -0,0 +1,62 @@
+<% layout('layouts/main') %>
+
+<div class="mb-4 d-flex align-items-start justify-content-between flex-wrap gap-2">
+  <div>
+    <h1 class="h3 mb-1"><%= t('ws_title', { defaultValue: '실시간 채팅 (WebSocket + ASP)' }) %></h1>
+    <p class="text-body-secondary small mb-0"><%= t('ws_subtitle', { defaultValue: 'WASM MegaSocket 으로 /ws/chat 에 접속합니다. 메시지는 ASP 로 암호화(E: 프레임)되어 브라우저에서 직접 암복호화되고, 서버는 채널 전체에 broadcast 합니다.' }) %></p>
+  </div>
+  <div class="text-end">
+    <span class="badge text-bg-success" title="<%= t('ws_asp_badge_title', { defaultValue: '모든 메시지가 AES-256-GCM(E: 프레임)으로 암호화되어 송수신됩니다.' }) %>">🔒 <%= t('ws_asp_badge', { defaultValue: 'ASP 암호화' }) %></span>
+    <div class="text-body-secondary small mt-1"><code>E:</code> AES-256-GCM · WASM</div>
+  </div>
+</div>
+
+<%# 루트 컨테이너 — data 속성으로 ws 경로·ASP 시크릿·번역 템플릿을 외부 모듈(ws-chat.js)에 전달.
+    CSP(script-src 'self')라 인라인 주입 불가 → data 속성 + 외부 ESM 스크립트. %>
+<div
+  id="chat-root"
+  class="card"
+  data-ws-path="<%= wsPath %>"
+  data-asp-secret="<%= aspSecret %>"
+  data-me="<%= currentUser ? currentUser.name : '' %>"
+  data-t-status-connecting="<%= t('ws_status_connecting', { defaultValue: '연결 중…' }) %>"
+  data-t-status-open="<%= t('ws_status_open', { defaultValue: '연결됨' }) %>"
+  data-t-status-closed="<%= t('ws_status_closed', { defaultValue: '연결 끊김' }) %>"
+  data-t-status-error="<%= t('ws_status_error', { defaultValue: '오류' }) %>"
+  data-t-online="<%= t('ws_online', { defaultValue: '접속자 {n}명' }) %>"
+  data-t-join="<%= t('ws_presence_join', { defaultValue: '{user} 님이 입장했습니다.' }) %>"
+  data-t-leave="<%= t('ws_presence_leave', { defaultValue: '{user} 님이 퇴장했습니다.' }) %>"
+>
+  <div class="card-header d-flex align-items-center justify-content-between">
+    <span class="d-flex align-items-center gap-2">
+      <span id="chat-status-dot" class="d-inline-block rounded-circle bg-secondary" style="width: 0.6rem; height: 0.6rem"></span>
+      <span id="chat-status" class="small text-body-secondary"><%= t('ws_status_connecting', { defaultValue: '연결 중…' }) %></span>
+      <%# 클러스터 워커 PID — 같은 명단·메시지가 서로 다른 워커에 닿는지 눈으로 확인(cluster broadcast 실증). %>
+      <span id="chat-worker" class="badge text-bg-secondary font-monospace" style="display: none"></span>
+    </span>
+    <span id="chat-online" class="badge text-bg-light" data-bs-toggle="tooltip" title=""></span>
+  </div>
+
+  <%# 메시지 목록 — JS 가 textContent 로만 채운다(XSS 방지: 사용자 입력을 innerHTML 로 넣지 않음). %>
+  <div id="chat-messages" class="list-group list-group-flush overflow-auto" style="height: 22rem" aria-live="polite">
+    <div data-empty class="list-group-item text-body-secondary small text-center py-5"><%= t('ws_empty', { defaultValue: '아직 메시지가 없습니다. 첫 메시지를 보내보세요.' }) %></div>
+  </div>
+
+  <div class="card-footer">
+    <form id="chat-form" class="d-flex gap-2" autocomplete="off">
+      <input
+        id="chat-input"
+        type="text"
+        class="form-control"
+        maxlength="500"
+        placeholder="<%= t('ws_input_placeholder', { defaultValue: '메시지를 입력하세요…' }) %>"
+        aria-label="<%= t('ws_input_placeholder', { defaultValue: '메시지를 입력하세요…' }) %>"
+        disabled
+      />
+      <button id="chat-send" type="submit" class="btn btn-primary" disabled><%= t('ws_send', { defaultValue: '보내기' }) %></button>
+    </form>
+    <div class="text-body-secondary small mt-2"><%= t('ws_encrypted_note', { defaultValue: '메시지는 ASP(AES-256-GCM) E: 프레임으로 암호화되어 전송됩니다.' }) %></div>
+  </div>
+</div>
+
+<script type="module" src="/static/js/ws-chat.js"></script>

package/sample/crud/apps/main/workers/hash-worker.js

@@ -0,0 +1,17 @@
+// @ts-check
+import { MegaWorker } from 'mega-framework'
+
+/**
+ * HashWorker — /demo/worker CPU 격리 워커 풀(ADR-124). `config.workers` 로 등록하면 `mega start`(boot)가
+ * `ctx.workers['hash']` 에 배선한다. 호출: `ctx.workers['hash'].run('sha256Loop', { input, rounds })`.
+ *
+ * SHA-256 N회 반복 같은 CPU-bound 작업을 메인 스레드 대신 worker_threads 풀에서 돌려, 계산 중에도 HTTP
+ * 이벤트 루프가 다른 요청에 즉시 응답하게 한다(메인 스레드 non-block 시연). 작업 로직은 `static taskFile`
+ * 모듈의 named export 함수다(worker_threads 경계 제약, ADR-124).
+ */
+export class HashWorker extends MegaWorker {
+  static name = 'hash'
+  static taskFile = 'apps/main/workers/hash.task.js'
+  static mode = 'thread'
+  static poolSize = 2
+}

package/sample/crud/apps/main/workers/hash.task.js

@@ -0,0 +1,22 @@
+// @ts-check
+/**
+ * HashWorker 의 작업 함수 모듈(= `static taskFile`, ADR-124). worker_threads 경계는 함수·클로저를 못 넘기므로
+ * 작업 로직은 이 별도 파일에 named export 한 async 함수로 두고, 워커가 로드해 `run(taskName, args)` 의
+ * taskName 으로 디스패치한다. node:crypto 만 쓰는 순수 CPU 작업이라 추가 의존성이 없다.
+ */
+import { createHash } from 'node:crypto'
+
+/**
+ * SHA-256 을 N회 반복 체인 해시한다(이전 출력이 다음 입력) — 의도적 CPU-bound 작업. 이 루프는 워커 스레드에서
+ * 돌아 메인 스레드(HTTP 이벤트 루프)를 막지 않는다.
+ * @param {{ input?: string, rounds?: number }} task - 워커 경계를 넘는 직렬화 가능한 데이터만.
+ * @returns {Promise<{ digest: string, rounds: number }>} 최종 해시 + 반복 횟수.
+ */
+export async function sha256Loop(task) {
+  const rounds = typeof task.rounds === 'number' && task.rounds > 0 ? Math.floor(task.rounds) : 1_000_000
+  let digest = String(task.input ?? 'mega')
+  for (let i = 0; i < rounds; i++) {
+    digest = createHash('sha256').update(digest).digest('hex')
+  }
+  return { digest, rounds }
+}

package/sample/crud/ecosystem.config.cjs

@@ -0,0 +1,9 @@
+// PM2 ecosystem — server / scheduler / worker 프로세스 정의.
+// 사용: pm2 start ecosystem.config.cjs  (PM2 는 별도 설치: npm i -g pm2)
+module.exports = {
+  apps: [
+    { name: 'sample-crud-server', script: 'node_modules/.bin/mega', args: 'start', instances: 1, autorestart: true },
+    { name: 'sample-crud-scheduler', script: 'node_modules/.bin/mega', args: 'scheduler', instances: 1, autorestart: true },
+    { name: 'sample-crud-worker', script: 'node_modules/.bin/mega', args: 'worker', instances: 2, autorestart: true },
+  ],
+}

package/sample/crud/mega.config.js

@@ -0,0 +1,105 @@
+// @ts-check
+/**
+ * mega.config.js — Global-only 스코프(ADR-061). 전역 자원(databases)·서버·관측성만 둔다.
+ * App-only 키(databases 별명 등)는 apps/<name>/app.config.js 로.
+ */
+import { CronCounterSchedule } from './apps/main/schedules/cron-counter-schedule.js'
+import { EmailJob } from './apps/main/jobs/email-job.js'
+import { HashWorker } from './apps/main/workers/hash-worker.js'
+
+export default {
+  apps: ['main'],
+
+  server: {
+    // listen 포트 — PORT 환경변수 또는 `mega start --port N`(CLI 우선). per ADR-146.
+    port: Number(process.env.PORT ?? 3000),
+    // 세션 쿠키 HMAC 서명 시크릿(global 스코프, ADR-129). boot 이 앱에 주입한다. .env 의 SESSION_SECRET.
+    sessionSecret: process.env.SESSION_SECRET,
+  },
+
+  // ASP(Application-layer Secure Protocol) masterSecret — global 스코프 시크릿(ADR-127, scope-registry).
+  // boot 의 composeAspConfig 가 이 masterSecret 과 앱 스코프의 옵트인 범위(app.config.js 의
+  // asp.websocket.namespaces)를 합성해 앱에 주입한다. /ws/chat 의 E:/P: 프레임 키 유도에 쓰인다.
+  // ASP 는 클라이언트(WASM MegaSocket)도 같은 secret 으로 키를 유도하는 공유-키 구조라, 데모 페이지가
+  // 이 값을 브라우저에 주입한다 — 그래서 운영 secret 과 분리된 데모 전용 값을 .env 의 ASP_MASTER_SECRET 에 둔다.
+  asp: {
+    masterSecret: process.env.ASP_MASTER_SECRET,
+  },
+
+  // 전역 어댑터(ADR-102/106/109) — globalKey 로 선언, 앱은 app.config.js 의 별명으로 참조.
+  services: {
+    databases: {
+      // DB 'primary' — 모델(static adapter='primary')·마이그레이션 러너(mega migrate)·ctx.db('db') 공유 인스턴스.
+      primary: {
+        driver: 'postgres',
+        url: process.env.DATABASE_URL,
+      },
+      // DB 'mongo' — Document DB 어댑터(ADR-108). notes 데모 컬렉션(Note 모델 static adapter='mongo')의 공유
+      // 인스턴스. url path 의 dbName(mega_test)을 어댑터가 추출한다. .env 의 MONGO_URL(authSource=admin).
+      mongo: {
+        driver: 'mongodb',
+        url: process.env.MONGO_URL,
+      },
+    },
+    caches: {
+      // redis 캐시 'rate' — brute-force(ctx.bruteForce, ADR-049/130)의 원자적 INCR 백엔드. .env 의 REDIS_RATE_URL(db 2).
+      rate: {
+        driver: 'redis',
+        url: process.env.REDIS_RATE_URL,
+      },
+      // redis 캐시 'demo' — /demo/redis 데모(방문 카운터 INCR/EXPIRE + 쿼리 결과 캐시 GET/SET/TTL/DEL)와
+      // /demo/cron 카운터·이력, /demo/jobs 처리 이벤트의 백엔드. 세션(db0)·rate(db2)와 키 충돌을 피하려 별도
+      // 논리 DB(db1)를 쓴다. 용도별 키 네임스페이스(demo:redis:* / demo:cron:* / demo:jobs:*)로 구분한다.
+      demo: {
+        driver: 'redis',
+        url: process.env.REDIS_DEMO_URL,
+      },
+      // redis 캐시 'lock' — 분산 락(redlock, locks.main)이 참조하는 Redis 연결(ADR-113). redlock 은 자체 연결을
+      // 열지 않고 등록된 Redis 캐시 어댑터를 빌려 쓴다. 락 키(mega:schedule:*)를 데모 데이터와 분리하려 별도 db(3).
+      lock: {
+        driver: 'redis',
+        url: process.env.REDIS_LOCK_URL,
+      },
+    },
+    // NATS 버스 'jobs' — 잡 큐(EmailJob, ADR-119)의 JetStream 백엔드. producer(웹)는 ctx.bus('jobs').native(nc)로
+    // enqueue, consumer(`mega worker`)는 같은 버스로 소비한다. .env 의 NATS_JOBS_URL.
+    buses: {
+      jobs: {
+        driver: 'nats',
+        url: process.env.NATS_JOBS_URL,
+      },
+    },
+    // 분산 락 'main' — redlock(ADR-113). caches.lock(Redis) 을 빌려 단일 노드 redlock 을 구성한다. /demo/cron
+    // 스케줄(CronCounterSchedule.static lock)의 클러스터 중복방지(leader election)에 쓰인다.
+    locks: {
+      main: {
+        driver: 'redlock',
+        redis: 'lock',
+      },
+    },
+  },
+
+  // 정기 작업(ADR-028/118) — `mega scheduler` 프로세스가 등록·실행한다(config.schedules, ADR-123).
+  schedules: [CronCounterSchedule],
+
+  // 영속 잡(ADR-028/119) — `mega worker` 프로세스(ecosystem instances:2)가 소비한다(config.jobs, ADR-123).
+  jobs: [EmailJob],
+
+  // CPU 워커 풀(ADR-124) — `mega start`(boot)가 ctx.workers['hash'] 로 배선한다(config.workers).
+  workers: [HashWorker],
+
+  // pino 로깅(ADR-023/141) — console sink, dev pretty. redact 로 민감필드를 sink 출력 전 메인스레드에서
+  // 마스킹한다(token/password/secret/authorization). /demo/logs 데모가 이 마스킹을 시연한다(ADR-163).
+  logger: {
+    level: 'debug',
+    sinks: [{ type: 'console', pretty: true }],
+    redact: ['*.password', '*.token', '*.secret', '*.authorization', 'password', 'token', 'secret'],
+  },
+
+  // 운영 관측성(ADR-072/131) — Prometheus /metrics 옵트인, loopback allowList.
+  health: {
+    exposeMetrics: true,
+    metricsPath: '/metrics',
+    metricsAllowList: ['127.0.0.1', '::1'],
+  },
+}