@underdogai/mesh-event-schemas 0.1.0

package/dist/templates.js

@@ -0,0 +1,493 @@
+/**
+ * Composite 템플릿 — 프리미티브 블록을 조합한 고수준 카드 빌더 (작성자 DX).
+ *
+ * 작성자는 매번 블록 트리를 손으로 쌓지 않고 templates.approval(...) 처럼 의도 단위로 만든다.
+ * registerTemplate() 로 작성자가 자기 템플릿을 등록할 수도 있다(클라이언트 릴리스 불필요 —
+ * 템플릿은 프리미티브로 "확장"되어 기존 렌더러가 그대로 그린다).
+ */
+import { buildUiCardContent } from "./events.js";
+const templateRegistry = new Map();
+export function registerTemplate(name, fn) {
+    templateRegistry.set(name, fn);
+}
+export function hasTemplate(name) {
+    return templateRegistry.has(name);
+}
+export function renderTemplate(name, params) {
+    const fn = templateRegistry.get(name);
+    if (!fn)
+        throw new Error(`Unknown template: ${name}`);
+    return fn(params);
+}
+function approval(p) {
+    const blocks = [{ type: "fields", items: p.fields }];
+    if (p.note)
+        blocks.push({ type: "input", name: "note", label: "Note", placeholder: "Optional" });
+    blocks.push({
+        type: "actions",
+        elements: [
+            {
+                type: "button",
+                action_id: "approve",
+                text: p.approveText ?? "Approve",
+                style: "primary",
+                ...(p.confirm ? { confirm: { title: "Approve", text: "Approve this?" } } : {}),
+            },
+            { type: "button", action_id: "reject", text: p.rejectText ?? "Reject", style: "danger" },
+        ],
+    });
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "Approval request",
+        context: p.context,
+        blocks,
+    });
+}
+/**
+ * 다단계 승인 카드 (HITL) — 0/N 승인 카운터(metric) + 순차 승인자 타임라인(steps) + 액션.
+ * approval.request/.decision 이벤트의 표시면. 승인자 status 가 done/active/error/todo 로 매핑되고
+ * approved/required 카운터가 진행도를 보여준다(색-only 회피: 숫자 병기).
+ */
+function multiApproval(p) {
+    const required = p.required ?? p.approvers.length;
+    const approved = p.approvers.filter((a) => a.status === "approved").length;
+    const rejected = p.approvers.some((a) => a.status === "rejected");
+    const blocks = [];
+    if (p.fields?.length)
+        blocks.push({ type: "fields", items: p.fields });
+    blocks.push({
+        type: "metric",
+        label: "Approvals",
+        value: `${approved}/${required}`,
+        tone: rejected ? "danger" : approved >= required ? "success" : "info",
+    });
+    blocks.push({
+        type: "steps",
+        items: p.approvers.map((a) => ({
+            label: a.name,
+            status: a.status === "approved"
+                ? "done"
+                : a.status === "rejected"
+                    ? "error"
+                    : a.status === "active"
+                        ? "active"
+                        : "todo",
+            note: a.note,
+        })),
+    });
+    if (p.note)
+        blocks.push({ type: "text", text: p.note, markdown: true });
+    const row = actionRow(p.actions ?? [
+        { action_id: "approve", text: "Approve", style: "primary" },
+        { action_id: "reject", text: "Reject", style: "danger" },
+    ]);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title ?? "Approval workflow",
+        fallback: p.title ?? `Approval ${approved}/${required}`,
+        state: p.state,
+        context: p.context,
+        blocks,
+    });
+}
+/** 작업 상태별 텍스트 라벨(색-only 회피 — 단계 note 에 병기). */
+const TASK_STATUS_LABEL = {
+    todo: "To do",
+    in_progress: "In progress",
+    blocked: "Blocked",
+    done: "Done",
+    cancelled: "Cancelled",
+};
+/**
+ * 작업 상태 → steps 블록 상태(done|active|todo|error) 매핑.
+ * blocked→error(빨강·주의 환기)·cancelled→todo(회색·비강조) — 둘은 색이 달라 구분되고, 정확한 상태는
+ * 단계 note 텍스트로 병기한다(steps 블록엔 상태 칩이 없어 색만으로 구분 금지 원칙을 텍스트로 충족).
+ */
+const TASK_STEP_STATUS = {
+    done: "done",
+    in_progress: "active",
+    blocked: "error",
+    todo: "todo",
+    cancelled: "todo",
+};
+/**
+ * 작업 진척 카드 (C층 프리미티브) — task.* 이벤트에서 파생한 TaskSummary 를 0/N metric + 전체 progress +
+ * 작업별 steps 로 렌더. 공정률·카운트는 모두 summary(데이터)에서 오고 카드는 손데이터를 만들지 않는다
+ * (done_when "진척도 실데이터"). 상태는 단계 note 에 텍스트로 병기(접근성). multiApproval(0/N)·checklist 와 동형.
+ */
+function taskList(p) {
+    const s = p.summary;
+    // 완료 카운터의 분모는 공정률과 같은 기준(cancelled 제외) — "1/4"와 25% 가 어긋나지 않게.
+    const countable = s.total - s.cancelled;
+    const blocks = [
+        {
+            type: "metric",
+            label: "Done",
+            value: `${s.done}/${countable}`,
+            tone: s.percent === 100 && countable > 0 ? "success" : s.byStatus.blocked > 0 ? "warning" : "info",
+        },
+        { type: "progress", value: s.percent, label: `${s.percent}% complete` },
+        {
+            type: "steps",
+            items: s.tasks.map((t) => {
+                // note = 상태 라벨(색-only 회피) + (진행 중이면 %) + 담당자 + 메모 — 한 줄 맥락.
+                const parts = [TASK_STATUS_LABEL[t.status]];
+                if (t.status === "in_progress" && t.progress != null)
+                    parts.push(`${t.progress}%`);
+                if (t.assignees?.length)
+                    parts.push(t.assignees.join(", "));
+                if (t.note)
+                    parts.push(t.note);
+                return { label: t.title, status: TASK_STEP_STATUS[t.status], note: parts.join(" · ") };
+            }),
+        },
+    ];
+    const row = actionRow(p.actions);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title ?? "Tasks",
+        // fallback 도 카드 metric 과 같은 분모(cancelled 제외)를 써 미지원 클라에서도 카운트가 일치한다.
+        fallback: p.title ?? `${s.done}/${countable} tasks done`,
+        state: p.state,
+        context: p.context,
+        blocks,
+    });
+}
+function wizard(p) {
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "Step-by-step form",
+        steps: p.steps,
+        blocks: [
+            {
+                type: "actions",
+                elements: [
+                    { type: "button", action_id: p.submitId ?? "submit", text: p.submitText ?? "Submit", style: "primary" },
+                ],
+            },
+        ],
+    });
+}
+function list(p) {
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "List",
+        blocks: [{ type: "table", columns: p.columns, rows: p.rows }],
+    });
+}
+function progress(p) {
+    const blocks = [{ type: "progress", value: p.value, label: p.label }];
+    if (p.steps)
+        blocks.push({ type: "steps", items: p.steps });
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "Progress",
+        state: p.state,
+        blocks,
+    });
+}
+/** 정보/조사 결과 카드 — (선택) badge + 키-값 fields + (선택) 메모 텍스트. */
+function info(p) {
+    const blocks = [];
+    if (p.badge)
+        blocks.push({ type: "badge", text: p.badge.text, tone: p.badge.tone });
+    blocks.push({ type: "fields", items: p.fields });
+    if (p.note)
+        blocks.push({ type: "text", text: p.note, markdown: true });
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "Info",
+        context: p.context,
+        blocks,
+    });
+}
+/** 문서/파일 카드 — 파일명·메타 fields + (선택) 요약 + 미리보기 액션. */
+function doc(p) {
+    const items = [{ label: "File", value: p.fileName, short: true }];
+    if (p.fileMeta)
+        items.push({ label: "Details", value: p.fileMeta, short: true });
+    const blocks = [{ type: "fields", items }];
+    if (p.summary)
+        blocks.push({ type: "text", text: p.summary });
+    blocks.push({
+        type: "actions",
+        elements: [{ type: "button", action_id: p.previewId ?? "preview", text: p.previewText ?? "Preview" }],
+    });
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? p.fileName,
+        context: p.context,
+        blocks,
+    });
+}
+/** 에이전트 실행 계획 카드 — progress + steps 타임라인 (Agent Plan). */
+function plan(p) {
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "Execution plan",
+        context: p.context,
+        blocks: [
+            // tone 미지정 → 기본 브랜드(보라) 채움. info 톤이 필요하면 호출부에서 지정. (DESIGN.md §5.5)
+            { type: "progress", value: p.value, label: p.label },
+            { type: "steps", items: p.steps },
+        ],
+    });
+}
+/** 단일 단계 입력 폼 카드 — 임의 입력 블록 + 제출 액션(마법사 wizard 와 달리 단일 화면). */
+function form(p) {
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title,
+        fallback: p.title ?? "Form",
+        context: p.context,
+        blocks: [
+            ...p.blocks,
+            {
+                type: "actions",
+                elements: [
+                    { type: "button", action_id: p.submitId ?? "submit", text: p.submitText ?? "Submit", style: "primary" },
+                ],
+            },
+        ],
+    });
+}
+/** 진척도·임팩트 스코어카드 — 공정률(progress) + 기준 체크리스트 + 임팩트 KPI(metric). */
+function scorecard(p) {
+    const blocks = [];
+    if (p.progress != null || p.progressLabel) {
+        blocks.push({ type: "progress", value: p.progress, label: p.progressLabel });
+    }
+    for (const m of p.metrics ?? []) {
+        blocks.push({ type: "metric", label: m.label, value: m.value, target: m.target, delta: m.delta, tone: m.tone });
+    }
+    if (p.criteria?.length) {
+        blocks.push({
+            type: "steps",
+            items: p.criteria.map((c) => ({ label: c.label, status: c.done ? "done" : "todo" })),
+        });
+    }
+    return buildUiCardContent({
+        card_id: p.card_id,
+        title: p.title ?? "Progress · Impact",
+        fallback: p.title ?? "Progress/Impact",
+        context: p.context,
+        blocks,
+    });
+}
+/** ActionDef[] → actions 블록(없으면 null). */
+function actionRow(actions) {
+    if (!actions?.length)
+        return null;
+    return {
+        type: "actions",
+        elements: actions.map((a) => ({ type: "button", action_id: a.action_id, text: a.text, style: a.style, value: a.value })),
+    };
+}
+/** 인물 카드 — 아바타 + 연락 fields + (선택) 엔티티 칩 + 액션. */
+function contactCard(p) {
+    const blocks = [{ type: "avatar", name: p.name, subtitle: p.role, status: p.status }];
+    if (p.fields?.length)
+        blocks.push({ type: "fields", items: p.fields });
+    if (p.ref)
+        blocks.push({ type: "entityRef", entity: p.ref.entity, label: p.ref.label, url: p.ref.url, tone: "info" });
+    const row = actionRow(p.actions);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? p.name, context: p.context, blocks });
+}
+/** AI 브리핑 카드 — 요약 + 포인트 + 출처 칩 + 액션. */
+function digest(p) {
+    const blocks = [{ type: "text", text: p.summary, markdown: true }];
+    if (p.points?.length)
+        blocks.push({ type: "text", text: p.points.map((pt) => `- ${pt}`).join("\n"), markdown: true });
+    if (p.sources?.length) {
+        blocks.push({ type: "context", elements: ["Sources"] });
+        for (const s of p.sources)
+            blocks.push({ type: "entityRef", entity: "source", label: s.label, url: s.url });
+    }
+    const row = actionRow(p.actions);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "Digest", context: p.context, blocks });
+}
+/** 인시던트 카드 — 심각도 콜아웃 + 메타 fields + 대응 steps + 액션. */
+function incident(p) {
+    const blocks = [
+        { type: "callout", tone: p.tone ?? "warning", title: p.severity ?? "Incident", text: p.summary ?? p.title ?? "Incident reported" },
+    ];
+    if (p.fields?.length)
+        blocks.push({ type: "fields", items: p.fields });
+    if (p.steps?.length)
+        blocks.push({ type: "steps", items: p.steps });
+    const row = actionRow(p.actions);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? p.severity ?? "Incident", context: p.context, blocks });
+}
+/** KPI 그리드 카드 — metric 묶음 + (선택) 추세 차트. */
+function kpiGrid(p) {
+    const blocks = p.metrics.map((m) => ({
+        type: "metric",
+        label: m.label,
+        value: m.value,
+        target: m.target,
+        delta: m.delta,
+        tone: m.tone,
+    }));
+    if (p.chart) {
+        blocks.push({ type: "chart", variant: p.chart.variant, data: p.chart.data, caption: p.chart.caption, unit: p.chart.unit });
+    }
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "KPIs", context: p.context, blocks });
+}
+/** 송장 카드 — 금액·기한 등 fields + (선택) 상태 배지 + 승인/반려 액션. */
+function invoice(p) {
+    const blocks = [];
+    if (p.status)
+        blocks.push({ type: "badge", text: p.status.label, tone: p.status.tone });
+    const items = [];
+    if (p.number)
+        items.push({ label: "Invoice", value: p.number, short: true });
+    if (p.vendor)
+        items.push({ label: "Vendor", value: p.vendor, short: true });
+    items.push({ label: "Amount", value: p.amount, short: true });
+    if (p.due)
+        items.push({ label: "Due", value: p.due, short: true });
+    blocks.push({ type: "fields", items });
+    const row = actionRow(p.actions ?? [
+        { action_id: "approve", text: "Approve", style: "primary" },
+        { action_id: "reject", text: "Reject", style: "danger" },
+    ]);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? `Invoice ${p.number ?? ""}`.trim(), context: p.context, blocks });
+}
+/** 견적 카드 — 라인아이템 table + (선택) 합계 metric + 액션. */
+function estimate(p) {
+    const blocks = [
+        { type: "table", columns: ["Item", "Qty", "Amount"], rows: p.lines.map((l) => [l.label, l.qty ?? "", l.amount]) },
+    ];
+    if (p.total)
+        blocks.push({ type: "metric", label: "Total", value: p.total, tone: "info" });
+    if (p.note)
+        blocks.push({ type: "text", text: p.note });
+    const row = actionRow(p.actions);
+    if (row)
+        blocks.push(row);
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "Estimate", context: p.context, blocks });
+}
+/** 비교 카드 — A vs B 표(첫 열=기준, 나머지=옵션 값). */
+function comparison(p) {
+    const blocks = [
+        { type: "table", columns: ["", ...p.options], rows: p.rows.map((r) => [r.label, ...r.values]) },
+    ];
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "Comparison", context: p.context, blocks });
+}
+/** 체크리스트 카드 — (선택) 담당 아바타 + 진행률 progress + 항목 steps(done/todo). */
+function checklist(p) {
+    const total = p.items.length;
+    const done = p.items.filter((i) => i.done).length;
+    const pct = total ? Math.round((done / total) * 100) : 0;
+    const blocks = [];
+    if (p.owner)
+        blocks.push({ type: "avatar", name: p.owner, subtitle: `Owner · ${done}/${total} done` });
+    blocks.push({ type: "progress", value: pct, label: `${done}/${total} complete` });
+    blocks.push({
+        type: "steps",
+        items: p.items.map((i) => ({ label: i.label, status: i.done ? "done" : "todo", note: i.note })),
+    });
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "Checklist", context: p.context, blocks });
+}
+/** 회의 카드 — 안건/일시 fields + 참석자 avatarGroup + (선택) 시간 후보 radio + 확정 액션. */
+function meeting(p) {
+    const blocks = [];
+    const items = [];
+    if (p.agenda)
+        items.push({ label: "Agenda", value: p.agenda });
+    if (p.when)
+        items.push({ label: "When", value: p.when, short: true });
+    if (p.duration)
+        items.push({ label: "Duration", value: p.duration, short: true });
+    if (items.length)
+        blocks.push({ type: "fields", items });
+    if (p.attendees?.length)
+        blocks.push({ type: "avatarGroup", label: "Attendees", people: p.attendees.map((a) => ({ name: a })) });
+    if (p.options?.length) {
+        blocks.push({ type: "radio", name: "slot", label: "Pick a slot", options: p.options, value: p.options[0]?.value });
+    }
+    blocks.push({
+        type: "actions",
+        elements: [{ type: "button", action_id: "confirm_schedule", text: p.confirmText ?? "Confirm time", style: "primary" }],
+    });
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "Meeting", context: p.context, blocks });
+}
+/** 오류 복구 카드 — danger 콜아웃 + (선택) 상세 code + Retry/Escalate 액션. */
+function errorRecovery(p) {
+    const blocks = [{ type: "callout", tone: "danger", title: p.title ?? "Something went wrong", text: p.message }];
+    if (p.detail)
+        blocks.push({ type: "code", code: p.detail });
+    blocks.push({
+        type: "actions",
+        elements: [
+            { type: "button", action_id: "retry", text: p.retryText ?? "Retry", style: "primary" },
+            { type: "button", action_id: "escalate", text: p.escalateText ?? "Escalate" },
+        ],
+    });
+    return buildUiCardContent({ card_id: p.card_id, title: p.title, fallback: p.title ?? "Error", context: p.context, blocks });
+}
+/** 내장 템플릿 모음 (타입드 SDK 진입점). */
+export const templates = {
+    approval,
+    multiApproval,
+    taskList,
+    wizard,
+    list,
+    progress,
+    info,
+    doc,
+    plan,
+    form,
+    scorecard,
+    contactCard,
+    digest,
+    incident,
+    kpiGrid,
+    invoice,
+    estimate,
+    comparison,
+    checklist,
+    meeting,
+    errorRecovery,
+};
+registerTemplate("approval", approval);
+registerTemplate("multiApproval", multiApproval);
+registerTemplate("taskList", taskList);
+registerTemplate("wizard", wizard);
+registerTemplate("list", list);
+registerTemplate("progress", progress);
+registerTemplate("info", info);
+registerTemplate("doc", doc);
+registerTemplate("plan", plan);
+registerTemplate("form", form);
+registerTemplate("scorecard", scorecard);
+registerTemplate("contactCard", contactCard);
+registerTemplate("digest", digest);
+registerTemplate("incident", incident);
+registerTemplate("kpiGrid", kpiGrid);
+registerTemplate("invoice", invoice);
+registerTemplate("estimate", estimate);
+registerTemplate("comparison", comparison);
+registerTemplate("checklist", checklist);
+registerTemplate("meeting", meeting);
+registerTemplate("errorRecovery", errorRecovery);
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@underdogai/mesh-event-schemas",
+  "version": "0.1.0",
+  "description": "@underdogai/mesh-app-sdk 가 쓰는 이벤트·UI 블록 스키마(zod) — 카드/서피스 와이어 포맷의 단일 진실 공급원.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "license": "MIT",
+  "author": "Underdog",
+  "keywords": [
+    "matrix",
+    "chatops",
+    "zod",
+    "schema",
+    "event-schema"
+  ],
+  "homepage": "https://chatops.theunderdog.ai/sdk-guide",
+  "repository": {
+    "type": "git",
+    "url": "https://forgejo.taildff74c.ts.net:3000/Underdog/ChatOps.git",
+    "directory": "packages/event-schemas"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/apppacks.ts

@@ -0,0 +1,90 @@
+/**
+ * App Pack 레지스트리 — 도메인 1개(CRM·Forgejo·프로젝트…)를 클라이언트에 가르치는 선언형 번들.
+ *
+ * 카드의 templateRegistry(templates.ts) / 블록의 registerBlock(ui-blocks)과 같은 "확장 봉합선"을,
+ * 룸 단위 셸 서피스로 일반화한 것이다. 룸이 선언한 바인딩(app)에 따라 클라이언트가 팩을 골라
+ * 컨텍스트 패널 등 서피스를 렌더한다. 새 SaaS 단위 = 새 팩(데이터) — 클라이언트 포크가 아니다.
+ *
+ * (panel + 선택 header/canvas 를 담는다. 사이드바 섹션 스펙은 후속. docs/extensibility.md §10)
+ *
+ * registerAppPack 은 등록 시점에 zod 로 검증한다 → 깨진/외부 공급 팩이 클라를 못 깨게(거부 + 경고).
+ */
+import { z } from "zod";
+import {
+  AgentDockSpecSchema,
+  CanvasSpecSchema,
+  CommandPaletteSpecSchema,
+  ComposerSpecSchema,
+  HeaderSpecSchema,
+  ModalSpecSchema,
+  ObjectMapSpecSchema,
+  PanelSpecSchema,
+  SidebarSectionSpecSchema,
+} from "./surfaces.js";
+
+/** App Pack 스키마 — 한 도메인의 셸 서피스(헤더·캔버스·패널) 전체를 선언형으로 기술. */
+export const AppPackSchema = z.object({
+  /** 룸 바인딩(org.corp.room.binding)의 app 키와 일치 */
+  app: z.string().min(1),
+  /** 사람이 읽는 이름 */
+  displayName: z.string().optional(),
+  /** 이 팩이 다루는 엔티티 타입(예: ["lead"], ["repo","pr","issue"]) */
+  entityTypes: z.string().array(),
+  /** 컨텍스트 패널 선언형 스펙 */
+  panel: PanelSpecSchema,
+  /** 룸 헤더(제목·메타·파이프라인) 선언형 스펙 */
+  header: HeaderSpecSchema.optional(),
+  /** 이벤트 캔버스(보드) 선언형 스펙 */
+  canvas: CanvasSpecSchema.optional(),
+  /** 우측 에이전트 도크(런 + 도메인 서비스) 선언형 스펙 — M3 셸 확장(패널 외 셸 영역 기여) */
+  dock: AgentDockSpecSchema.optional(),
+  /** 좌측 레일 사이드바 섹션(도메인 네비게이션) — M3 셸 확장. 팩이 여러 섹션을 기여. */
+  sidebar: SidebarSectionSpecSchema.array().optional(),
+  /** 컴포저(입력창) 어휘 — 슬래시 명령·퀵액션·@엔티티 자동완성. M3 셸 확장. */
+  composer: ComposerSpecSchema.optional(),
+  /** ⌘K 커맨드 팔레트 엔트리(도메인 액션) — M3 셸 확장. */
+  commandPalette: CommandPaletteSpecSchema.optional(),
+  /** 객체 맵 — 엔티티 관계 그래프("객체 맵" 탭/캔버스). M3 셸 확장. */
+  objectMap: ObjectMapSpecSchema.optional(),
+  /** 선언형 모달/시트(확인 다이얼로그) — 같은 id 의 셸 액션이 열고, 확인 시 confirm.action_id 발행. */
+  modals: ModalSpecSchema.array().optional(),
+});
+export type AppPack = z.infer<typeof AppPackSchema>;
+
+/** registerAppPack 결과 — 깨진 팩은 등록되지 않고 이슈를 돌려준다(호출측이 가시화). */
+export type AppPackRegistration =
+  | { ok: true; app: string }
+  | { ok: false; app: string; issues: string[] };
+
+const registry = new Map<string, AppPack>();
+
+/** 환경에 console 이 있으면 경고를 남긴다(이 패키지는 서버/클라/MCP 공용이라 직접 의존하지 않는다). */
+function warn(message: string): void {
+  const c = (globalThis as { console?: { warn?: (...args: unknown[]) => void } }).console;
+  c?.warn?.(message);
+}
+
+/**
+ * App Pack 을 검증 후 등록한다. 깨진 팩(잘못된 panel/header/canvas 등)은 거부 + 경고하고
+ * 등록하지 않는다 → 외부/작성자 공급 데이터가 클라를 깨지 못한다(graceful). 정상 in-repo 팩은 통과.
+ */
+export function registerAppPack(pack: AppPack): AppPackRegistration {
+  const parsed = AppPackSchema.safeParse(pack);
+  if (!parsed.success) {
+    const app = typeof (pack as { app?: unknown } | null)?.app === "string" ? (pack as { app: string }).app : "<unknown>";
+    const issues = parsed.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`);
+    warn(`[apppacks] 잘못된 App Pack 거부: ${app} — ${issues.join("; ")}`);
+    return { ok: false, app, issues };
+  }
+  registry.set(parsed.data.app, parsed.data);
+  return { ok: true, app: parsed.data.app };
+}
+export function getAppPack(app: string): AppPack | undefined {
+  return registry.get(app);
+}
+export function hasAppPack(app: string): boolean {
+  return registry.has(app);
+}
+export function listAppPacks(): AppPack[] {
+  return [...registry.values()];
+}