@morit/cli 1.1.0 → 1.2.0

package/README.md

@@ -12,13 +12,15 @@ npx -y @morit/cli login
 npx -y @morit/cli plugin setup . --id com.example.study --name "Study" --publisher example
 npx -y @morit/cli plugin add .
 npx -y @morit/cli plugin validate .
+npx -y @morit/cli plugin preview . --output ./dist/preview.html
 npx -y @morit/cli plugin build .
 npx -y @morit/cli plugin deploy . --visibility private
 ```
 
-CLI에 별도 `plugin preview` 명령은 없습니다. UI preview는 `@morit/cli/sdk`의
-`previewProjectDirectory`, `@morit/plugin-mcp`의 `morit_project_preview`, 또는 저장소 도구인
-`python tools/morit_plugin.py preview <directory>`를 사용합니다.
+`plugin preview`는 validate된 Runtime v2 화면을 script-free HTML로 렌더링하고 light/dark 토글을
+제공합니다. Node SDK의 `previewProjectDirectory`, `@morit/plugin-mcp`의
+`morit_project_preview`, 저장소 도구 `python tools/morit_plugin.py preview <directory>`도 같은
+계약을 사용합니다.
 
 전체 명령은 `npx -y @morit/cli --help`에서 확인하고 자동화에서는 `--json`을 사용합니다.
 

package/assets/docs/README.md

@@ -28,15 +28,16 @@ npx -y @morit/cli plugin setup . \
   --name "Study" \
   --publisher example
 npx -y @morit/cli plugin validate .
+npx -y @morit/cli plugin preview . --output ./dist/preview.html
 npx -y @morit/cli plugin build .
 npx -y @morit/cli login
 npx -y @morit/cli plugin add .
 npx -y @morit/cli plugin deploy . --visibility private
 ```
 
-화면 preview는 Local/Remote Plugin MCP의 `morit_project_preview` 또는 저장소 도구
-`python tools/morit_plugin.py preview <project>`를 사용합니다. preview HTML은 구조를 점검하는
-보조 수단이며, 실제 Host 렌더링과 사용자 흐름은 앱에서 따로 확인해야 합니다.
+같은 safe renderer는 공식 CLI, Local/Remote Plugin MCP의 `morit_project_preview`, 저장소 도구
+`python tools/morit_plugin.py preview <project>`에서 사용합니다. preview의 라이트·다크 전환으로
+계약과 배치를 확인하고, 실제 Flutter focus·navigation·Tool 흐름은 앱에서도 확인합니다.
 
 ## 개발 순서별 인덱스
 
@@ -65,31 +66,32 @@ npx -y @morit/cli plugin deploy . --visibility private
 
 13. [Tool, Skill, Search, Slash Command](tool-and-skill.md) — capability와 runtime adapter
 14. [권한, 설정, 저장소, 알림](permissions-and-data.md) — 최소 권한과 Host action
-15. [외부 서비스 인증과 Cloud Secrets](authentication.md) — OAuth, API key, 비밀 값 경계
-16. [AI Skill과 파일 산출물](ai-skill-and-docx-workflow.md) — 실제 파일을 반환하는 완료 흐름
+15. [Plugin Local Storage와 AI 접근](plugin-storage.md) — namespace, CRUD, migration, 격리, AI Tool
+16. [외부 서비스 인증과 Cloud Secrets](authentication.md) — OAuth, API key, 비밀 값 경계
+17. [AI Skill과 파일 산출물](ai-skill-and-docx-workflow.md) — 실제 파일을 반환하는 완료 흐름
 
 ### 5. 플랫폼
 
-17. [Android, iOS, Desktop 호환](platform-compatibility.md) — 현재 지원 범위와 이식 원칙
+18. [Android, iOS, Desktop 호환](platform-compatibility.md) — 현재 지원 범위와 이식 원칙
 
 ### 6. 검증과 배포
 
-18. [공식 CLI 개발 흐름](local-cli.md) — setup, sync, build, deploy
-19. [패키징과 테스트](packaging-and-testing.md) — 서명, 무결성, 테스트 층
-20. [오류 해결](troubleshooting.md) — validate, preview, build, 설치, 실행 오류 구분
-21. [예제 검증 방법과 확인 경계](verification.md) — 자동·live·실기기 검증의 차이
+19. [공식 CLI 개발 흐름](local-cli.md) — setup, sync, preview, build, deploy
+20. [패키징과 테스트](packaging-and-testing.md) — 서명, 무결성, 테스트 층
+21. [오류 해결](troubleshooting.md) — validate, preview, build, 설치, 실행 오류 구분
+22. [예제 검증 방법과 확인 경계](verification.md) — 자동·live·실기기 검증의 차이
 
 ### 7. SDK, MCP, API
 
-22. [CLI와 AI 에이전트 MCP](sdk-and-mcp.md) — Codex·Claude 등 로컬/원격 연결
-23. [원격 Plugin MCP](remote-mcp.md) — Cloud Project를 다루는 Tool 계약
-24. [수명주기와 HTTP API](lifecycle-and-api.md) — Host API와 설치·실행 상태
+23. [CLI와 AI 에이전트 MCP](sdk-and-mcp.md) — Codex·Claude 등 로컬/원격 연결
+24. [원격 Plugin MCP](remote-mcp.md) — Cloud Project를 다루는 Tool 계약
+25. [수명주기와 HTTP API](lifecycle-and-api.md) — Host API와 설치·실행 상태
 
 ### 8. 실제 예제
 
-25. [학교 생활 플러그인](examples-school-life.md) — 공개 NEIS를 사용하는 학생용 경험
-26. [학교 생활 개인정보 처리](school-life-privacy.md) — 저장·전송·삭제 범위
-27. [Notion 플러그인](examples-notion.md) — OAuth Connection과 실제 문서 검색
+26. [학교 생활 플러그인](examples-school-life.md) — 공개 NEIS와 AI 할 일을 사용하는 학생용 경험
+27. [학교 생활 개인정보 처리](school-life-privacy.md) — 저장·전송·삭제 범위
+28. [Notion 플러그인](examples-notion.md) — OAuth Connection과 실제 문서 검색
 
 ## 문서가 배포되는 위치
 

package/assets/docs/ai-response-and-timeline.md

@@ -54,6 +54,18 @@ Response point도 일반 Runtime v2와 같은 node, theme, app bar, navigation,
 화면 mount 시 외부 요청을 반복하지 않습니다. 후속 refresh나 사용자가 누른 action에만 추가
 capability를 호출합니다.
 
+## 실시간 구조화 응답
+
+Morit AI 오케스트레이터는 Tool·Skill 실행 전후 같은 `(message, plugin, instance, capability)` 응답을
+upsert합니다. `data.__morit_response.state`는 `loading`, `partial`, `completed`, `failed` 중 하나이며
+`retryable`이 true인 실패는 해당 메시지의 재생성으로 복구할 수 있습니다. 텍스트 delta는 별도로
+계속 스트리밍되므로 UI가 실패해도 텍스트 답변은 유지됩니다.
+
+Plugin이 `point: "response"` UI를 선언하면 그 Runtime v2를 사용합니다. 선언하지 않은 Tool·Skill
+결과도 Host가 같은 검증기를 통해 `metric`, `progress`, `list`, `timeline`, `calendar`, `chart`,
+`table`, `empty` 조합으로 안전하게 표시합니다. 차트는 `bar`, `line`, `donut`, `scatter`를 지원합니다.
+알 수 없는 shape은 실행하거나 추측하지 않고 summary와 텍스트 fallback을 남깁니다.
+
 ## 한 container의 정보 순서
 
 1. 결과를 설명하는 짧은 제목 또는 summary
@@ -123,3 +135,16 @@ Code Interpreter가 파일을 만들었다면 sandbox 내부 경로만 답변에
 가짜 링크를 생성하지 않습니다.
 
 파일 생성 완료 조건은 [AI Skill과 파일 산출물](ai-skill-and-docx-workflow.md)에 정리되어 있습니다.
+
+## 이미지 artifact
+
+`image_generation`·`image_edit`의 PNG/JPEG/GIF/WebP artifact는 생성 중 placeholder에서 완료 후 답변
+내 inline 이미지로 바뀝니다. 여러 장은 gallery로 넘기며 원본 비율을 유지한 contain 렌더링,
+전체 화면 `InteractiveViewer`, 다운로드, Android 공유를 제공합니다. 대화 재진입 때도 저장된
+`ai_tool_executions.result_summary.artifacts`를 다시 사용합니다.
+
+Artifact URL은 conversation·execution·attachment 소유권을 확인한 뒤 5분 signed URL로 만들며 만료나
+일시 실패 시 새 URL을 받아 두 번 시도합니다. 앱은 redirect를 따르지 않고 HTTPS(개발 loopback 제외),
+MIME, magic byte, 실제 decode, 24 MiB, 4096 px, 16 MP를 확인합니다. SVG와 외부 실행 형식은 inline으로
+열지 않고 기존 파일 카드로 fallback합니다. Plugin response의 URL 이미지는 앱이 직접 요청하지 않고
+기존 인증 Host proxy와 `network` grant를 거치며 실패 시 이미지 단위 재시도를 제공합니다.

package/assets/docs/components.md

@@ -137,11 +137,58 @@ action에는 반드시 `label`, 일반 `icon` node에는 `semantic_label`을 함
 | `list` | 일반 항목 반복 | `source`, `empty_text`, `limit`, `dense` | item template child 정확히 하나 |
 | `timeline` | 시간 순서 사건 | `source`, `empty_text`, `limit` | item template child 정확히 하나 |
 | `calendar` | 날짜별 데이터 | `source`, `date_key`, `title_key`, `state_key` | source 필수 |
-| `chart` | 수치 비교·추세 | `source`, `chart_type`, `x_key`, `y_key`, `show_legend` | `bar`, `line`, `donut` |
+| `chart` | 수치 비교·추세·분포 | `source`, `chart_type`, `x_key`, `y_key`, `show_legend` | `bar`, `line`, `donut`, `scatter` |
+| `table` | 행·열 구조 데이터 | `source`, `empty_text`, `limit`, `dense` | 최대 6열, 가로 스크롤 |
 
 반복 template 안에서는 `{{item.title}}`처럼 `item` binding을 사용합니다. 큰 목록을 한 번에 렌더링하지
 말고 capability에서 페이지나 기간을 나눕니다.
 
+## 공통 UX 프리셋
+
+프리셋은 새 실행 타입이 아니라 검증된 primitive 조합입니다. 그래서 Preview와 Flutter Host가 같은
+node를 렌더링하고 기존 플러그인도 별도 migration 없이 사용합니다.
+
+| 프리셋 | 조합 | Host가 맡는 상태 |
+|---|---|---|
+| 목록·검색 | `field` + `button` + `list`/`timeline` | source별 loading/error/retry, 빈 목록 |
+| 상세 | `app_bar` + `section` + `card`/`metric` | route back, stale response 차단 |
+| 폼 | `form` + `field`/`select`/`switch` + submit `button` | focus, keyboard, disabled feedback |
+| 설정 | `section` + persisted controls | state 복원, permission/connection 관리 링크 |
+| 빈 상태 | `empty` + 다음 행동 `button` | 의미 있는 title/supporting/icon |
+| 반응형 dashboard | `grid.min_item_width` + `row.stack_at` + adaptive navigation | bar/rail/drawer 전환 |
+
+목록·검색의 최소 tree:
+
+```json
+{
+  "type": "column",
+  "props": {"spacing": 12},
+  "children": [
+    {"type": "field", "props": {"state_key": "query", "label": "검색", "placeholder": "검색어"}},
+    {
+      "type": "button",
+      "props": {"label": "찾기", "icon": "search"},
+      "action": {"type": "invoke", "capability": "com.example.search", "query": "{{state.query}}", "arguments": {}, "store": "results"}
+    },
+    {
+      "type": "list",
+      "props": {"source": "data.results.data.items", "empty_text": "검색 결과가 없어요.", "limit": 50},
+      "children": [
+        {"type": "card", "props": {"title": "{{item.title}}", "subtitle": "{{item.summary}}"}}
+      ]
+    }
+  ]
+}
+```
+
+권한 요청, 연결 필요, 첫 loading, capability error와 retry는 플러그인이 비슷한 경고 카드를 다시
+만들지 않고 Host 공통 상태를 사용합니다. Plugin 상세의 권한/Connection 화면으로 이동한 뒤 같은
+route state와 persisted control을 복원합니다. 데이터가 정상적으로 비었을 때만 `empty` 또는
+`empty_text`를 사용하며 오류를 빈 목록으로 숨기지 않습니다.
+
+모든 프리셋은 light/dark, 320px 폭, tablet/desktop 폭, 큰 글자에서 확인합니다. node별 tooltip,
+semantic label, 최소 탭 영역과 색 이외의 상태 표시는 Host Material 3 규칙을 따릅니다.
+
 ## 공통 크기·정렬·접근성 props
 
 - 크기: `width`, `height`, `min_width`, `max_width`, `min_height`, `max_height`

package/assets/docs/design-tokens-responsive.md

@@ -8,15 +8,30 @@ Runtime v2는 기본적으로 Morit의 Material 3 theme를 사용합니다. 플
 ```json
 {
   "theme": {
-    "color_scheme": {
-      "primary": "#315DA8",
-      "on_primary": "#FFFFFF",
-      "primary_container": "#D9E2FF",
-      "on_primary_container": "#001A41"
-    },
     "radius": 18,
     "spacing": 12,
-    "density": "standard"
+    "density": "standard",
+    "surface": {"elevation": 1},
+    "border": {"width": 1},
+    "icon": {"size": 22},
+    "typography": {"scale": 1.0, "body_weight": 400, "title_weight": 700},
+    "states": {"disabled_opacity": 0.38},
+    "light": {
+      "color_scheme": {
+        "primary": "#315DA8",
+        "on_primary": "#FFFFFF",
+        "surface": "#F9F9FF",
+        "on_surface": "#1A1B20"
+      }
+    },
+    "dark": {
+      "color_scheme": {
+        "primary": "#AFC6FF",
+        "on_primary": "#002F66",
+        "surface": "#111318",
+        "on_surface": "#E2E2E9"
+      }
+    }
   }
 }
 ```
@@ -25,9 +40,17 @@ Runtime v2는 기본적으로 Morit의 Material 3 theme를 사용합니다. 플
 - `spacing`: 0~32
 - `density`: `compact`, `standard`, `comfortable`
 - `color_scheme`: Material role과 `#RRGGBB` 또는 `#AARRGGBB`
-
-누락한 role은 Host theme가 채웁니다. 대비가 확인된 작은 palette만 override하고 모든 role을 임의로
-복제하지 않습니다.
+- `typography`: `scale` 0.8~1.4, body/title weight 100~900
+- `surface`: `color`, `container_color`, `elevation` 0~24
+- `border`: `color`, `width` 0~8, `radius` 0~64
+- `icon`: `color`, `size` 12~64
+- `states`: `disabled_opacity` 0.2~0.8, `selected_color`, `focus_color`
+- `light`, `dark`: 위 필드의 mode별 partial override
+
+최상위 base → 현재 mode variant → Host Material 3 theme 순서로 병합됩니다. 누락한 role은 Host가
+채우므로 기존 플러그인은 선언을 추가하지 않아도 앱의 라이트·다크 모드를 따릅니다. 명백히 같은
+literal 전경/배경은 validate 오류이며 계산 가능한 4.5:1 미만 조합은 경고입니다. 대비가 확인된 작은
+palette만 override하고 모든 role을 임의로 복제하지 않습니다.
 
 ## 색상 token
 

package/assets/docs/docs-index.json

@@ -46,6 +46,7 @@
       "documents": [
         { "file": "tool-and-skill.md", "slug": "tool-and-skill", "title": "Tool, Skill, Search, Slash Command" },
         { "file": "permissions-and-data.md", "slug": "permissions-settings-notifications", "title": "권한, 설정, 저장소, 알림" },
+        { "file": "plugin-storage.md", "slug": "plugin-storage", "title": "Plugin Local Storage와 AI 접근" },
         { "file": "authentication.md", "slug": "authentication", "title": "외부 서비스 인증과 Cloud Secrets" },
         { "file": "ai-skill-and-docx-workflow.md", "slug": "ai-skill-artifacts", "title": "AI Skill과 파일 산출물" }
       ]

package/assets/docs/examples-school-life.md

@@ -2,7 +2,7 @@
 
 위치: `examples/plugins/school-life/`
 
-학교 생활 1.4.0은 하드코딩 시간표나 테스트용 JSON을 사용하지 않습니다. 학교명을
+학교 생활 1.5.0은 하드코딩 시간표나 테스트용 JSON을 사용하지 않습니다. 학교명을
 [NEIS 공개 API](https://open.neis.go.kr/)의 `schoolInfo`에서 찾고, 학교 종류에 맞는
 시간표 API와 `SchoolSchedule`, `mealServiceDietInfo`를 호출합니다. 선택한 학교·학년·반과
 알림 설정은 사용자와 Plugin Instance 범위의 저장소에 격리합니다.
@@ -21,6 +21,8 @@
 | 다음 학교일 알림 | `school_life.schedule.reminder` |
 | 6시간 자동 확인·중복 방지 브리핑 | background refresh/briefing |
 | 빠른 명령 | `/school`, `/meal`, `/timetable` |
+| AI와 공유하는 학교 할 일 | `tasks` namespace와 표준 Storage CRUD Tool |
+| 라이트·다크 화면 | Host theme 상속 + mode별 최소 색 override |
 
 기간 조회는 시간표·일정·급식 API를 각각 한 번씩 병렬 호출하고 날짜별로 묶으므로 7일
 화면이 날짜마다 네트워크를 반복하지 않습니다. 급식의 숫자 알레르기 코드는 19개 표준
@@ -29,13 +31,13 @@
 ## 설치와 첫 설정
 
 ```text
-examples/plugins/school-life/dist/school-life-1.4.0.mplg
-크기 262758 bytes
-SHA-256 f246d3abff4eac85e1a991d8f436c5381b394858843c95d6d4d88620a1b760b7
+examples/plugins/school-life/dist/school-life-1.5.0.mplg
+크기 263184 bytes
+SHA-256 3b6397ca1ef26833fe842087b0ecf5f05621bd45f9d80b8a422b6547c060f603
 ```
 
 1. Morit 플러그인 관리에서 위 `.mplg`를 선택합니다.
-2. `network`, `storage`, `notifications`, `background` 권한을 허용합니다.
+2. `network`, `storage`, `ai_storage`, `notifications`, `background` 권한을 허용합니다.
 3. 학교 이름을 검색하고 후보에서 정확한 학교를 고릅니다.
 4. 학년·반, 알림 시각(기본 07:30), 아침 브리핑 사용 여부를 저장합니다.
 5. 홈의 `학교 생활`, `오늘`, `이번 주`, `급식` 화면을 사용합니다.
@@ -49,12 +51,14 @@ AI 예:
 - `오늘 수업 순서와 급식 알려줘`
 - `내일 알레르기 5번 메뉴가 있어?`
 - `이번 주 학사일정과 수업량을 정리해줘`
+- `이번 주 학교 할 일에 과학 보고서 추가해줘`
+- `학교 할 일 중 끝낸 과제를 완료 처리해줘`
 - `/timetable 내일`
 - `/meal 앞으로 7일`
 
 ## 개인정보와 실패 처리
 
-- 저장: 공개 학교 식별자, 학년·반, 알림 시각/사용 여부
+- 저장: 공개 학교 식별자, 학년·반, 알림 시각/사용 여부, 사용자가 AI에 요청한 학교 할 일
 - 미수집: 학생 이름, 학번, 성적, NEIS 로그인 정보
 - 외부 전송: 공개 조회 조건만 NEIS에 전달
 - 삭제: profile, background lease/state, host-action outbox를 사용자 범위에서 purge
@@ -65,7 +69,8 @@ AI 예:
 
 `backend/archive_processing/test_plugin_examples.py`는 서명 package 설치, 권한 전 상태,
 학교 연결, 단일 날짜와 7일 조회, 알레르기/영양 변환, 검색, rich 알림, 자동 브리핑 중복
-방지, 재시작 복원, actor 격리, disable/delete purge를 고정된 공식 response contract로
+방지, Storage CRUD/AI 권한, 재시작 복원, actor·Instance 격리, migration, disable/delete purge를
+고정된 공식 response contract로
 검증합니다.
 
 배포 전에는 [예제 검증 방법](verification.md)에 따라 실제 NEIS 네트워크로 공개 시간표·학사일정·

package/assets/docs/getting-started.md

@@ -47,7 +47,7 @@ revision만 있으며 인증 정보는 들어가지 않습니다.
   "description": "오늘 할 일을 정리합니다.",
   "publisher": "example",
   "version": "1.0.0",
-  "min_morit_version": "1.7.6",
+  "min_morit_version": "1.7.8",
   "max_morit_version": "1.999.999",
   "permissions": [],
   "capabilities": [

package/assets/docs/lifecycle-and-api.md

@@ -47,6 +47,7 @@ Raw install content type은 `application/vnd.morit.plugin+zip`, 최대 2 MiB입
 | GET | `/v1/plugin-instances` | default/child Instance 목록 |
 | GET | `/v1/plugin-instances/{instance_id}` | Instance 상태·Connection·dependency |
 | PATCH | `/v1/plugin-instances/{instance_id}` | 이름, enabled, permission, settings 변경 |
+| DELETE | `/v1/plugin-instances/{instance_id}/storage` | 해당 Instance의 Local Storage 초기화 |
 | DELETE | `/v1/plugin-instances/{instance_id}` | Instance와 descendant 정리용 API |
 | GET | `/v1/plugins/{plugin_id}` | plugin ID 기준 설치 상세 |
 | PATCH | `/v1/plugins/{plugin_id}` | 호환용 default 설치 설정 |
@@ -123,6 +124,11 @@ notification key와 storage action은 idempotent하게 처리합니다.
 package 응답은 attachment `Content-Disposition`을 사용합니다. 삭제 시 `purge_data`와 manifest
 `data_policy`를 적용하되 credential, OAuth state, pending Host action은 항상 별도 보안 정리를 거칩니다.
 
+Storage 초기화는 actor가 소유한 정확한 Instance만 대상으로 하며 같은 Installation의 다른 Instance와
+다른 사용자 데이터는 건드리지 않습니다. `data_policy: retain`은 uninstall/reinstall에만 적용되고
+사용자가 명시적으로 초기화하면 즉시 삭제됩니다. 자세한 수명주기는
+[Plugin Local Storage와 AI 접근](plugin-storage.md)을 참고하세요.
+
 Asset API는 활성화된 사용자 소유 설치가 UI Runtime v2에서 실제 참조한 이미지에만 접근할 수
 있습니다. Host는 저장 package의 hash·signature·manifest를 다시 확인하고 확장자와 PNG/JPEG/GIF/WebP
 magic byte, 실제 이미지 포맷을 검사합니다. package asset과 원격 이미지에 공통으로 가로·세로 각각
@@ -144,6 +150,11 @@ Host는 공개 HTTPS만 허용하고 DNS/IP SSRF 검사를 거치며 redirect를
 `413`, 지원하지 않거나 손상된 이미지는 `415`, upstream 실패는 `502`, Host network 경계 미설정은
 `503`으로 구분합니다. 소유하지 않은 Instance는 상세 정보를 노출하지 않습니다.
 
+AI 생성/분석 artifact는 별도 소유권 경계인
+`GET /v1/ai/conversations/{conversation_id}/code-executions/{execution_id}/artifacts/{attachment_id}/access`
+에서만 signed URL을 발급합니다. 완료된 `python_code`, `image_generation`, `image_edit` 실행의 저장된
+artifact manifest와 attachment 행이 모두 일치해야 하며 다른 대화·실행의 attachment ID는 404입니다.
+
 ## 앱 시작 복구
 
 시작할 때 DB Installation과 content-addressed package store를 함께 점검합니다.

package/assets/docs/local-cli.md

@@ -35,13 +35,14 @@ Ed25519 key로 자동 서명합니다. key는 기본적으로 사용자 홈의 `
 보호해 저장하고 source나 `.mplg`에 private key를 넣지 않습니다. build 결과를 같은 과정에서 다시
 열어 signature와 package 구조를 확인합니다.
 
-UI preview는 현재 CLI subcommand가 아니라 SDK/MCP 기능입니다.
-
 ```bash
+npx -y @morit/cli plugin preview . --output ./dist/preview.html
 python tools/morit_plugin.py preview . --output ./dist/preview.html
 ```
 
-또는 Local/Remote MCP의 `morit_project_preview`를 사용합니다.
+두 명령과 Local/Remote MCP의 `morit_project_preview`는 같은 검증 계약을 사용합니다. 결과는 script를
+실행하지 않는 safe HTML이며 light/dark 토글을 포함합니다. 실제 Flutter route·focus·Tool 실행은
+서명 package를 앱에 설치해 확인합니다.
 
 ## 3. 로그인
 

package/assets/docs/manifest.md

@@ -20,7 +20,7 @@
   "privacy_policy_url": "https://example.com/privacy",
   "publisher": "example",
   "version": "1.0.0",
-  "min_morit_version": "1.7.6",
+  "min_morit_version": "1.7.8",
   "max_morit_version": "1.999.999",
   "permissions": ["network", "credentials"],
   "capabilities": [
@@ -78,6 +78,28 @@ Manifest `permissions`는 플러그인이 요청할 수 있는 최대 범위입
 
 credential, OAuth state, pending notification은 두 정책과 무관하게 보안 수명주기에 따라 정리됩니다.
 
+### Local Storage
+
+새 저장소는 schema 2에서 명시적으로 선언합니다.
+
+```json
+{
+  "permissions": ["storage", "ai_storage"],
+  "storage": {
+    "version": 1,
+    "namespaces": [
+      {"id": "default", "max_bytes": 131072, "ai_access": "read"},
+      {"id": "tasks", "max_bytes": 262144, "ai_access": "read_write"}
+    ],
+    "migrations": []
+  }
+}
+```
+
+`ai_access`가 `read` 또는 `read_write`인 namespace가 있으면 `ai_storage` 권한이 필수입니다.
+namespace, quota, migration과 표준 CRUD Tool은 [Plugin Local Storage와 AI 접근](plugin-storage.md)을
+참고하세요.
+
 ## Capability
 
 ```json

package/assets/docs/packaging-and-testing.md

@@ -71,10 +71,12 @@ Connector, source entrypoint, dependency를 검사합니다.
 ### 2. Preview
 
 ```bash
+npx -y @morit/cli plugin preview . --output ./dist/preview.html
 python tools/morit_plugin.py preview . --output ./dist/preview.html
 ```
 
-정보 구조와 compiled manifest를 점검합니다. 실제 Flutter renderer 성공을 대신하지 않습니다.
+정보 구조와 compiled manifest, light/dark partial theme를 점검합니다. 실제 Flutter renderer 성공을
+대신하지 않습니다.
 
 ### 3. Package reopen
 
@@ -98,6 +100,10 @@ python tools/morit_plugin.py verify ./dist/plugin.mplg
 - local file 설치
 - 활성화와 권한 허용·거부
 - 화면 loading·empty·error·retry
+- 시스템/라이트/다크 전환과 기존 theme 없는 package 호환
+- Storage CRUD·검색·즉시 UI 갱신, AI read/read_write 권한
+- 사용자·Installation·Instance·namespace 격리와 quota/revision/generation 충돌
+- Storage migration, reset, purge/retain uninstall/reinstall
 - 동일 package 재설치와 version update
 - OAuth 여러 Connection과 재연결
 - notification 실제 표시
@@ -105,7 +111,7 @@ python tools/morit_plugin.py verify ./dist/plugin.mplg
 
 ### 6. 회귀 검사
 
-SDK, Python Host, Local MCP, Remote MCP가 같은 contract를 반환하고 같은 fixture를 허용·거부하는지
+SDK, Python Host, Flutter schema, Local MCP, Remote MCP가 같은 contract를 반환하고 같은 fixture를 허용·거부하는지
 확인합니다. 문서 예제 JSON도 source 검증 과정에서 실행해 구현과 함께 변경합니다.
 
 ## 실패 시 원칙

package/assets/docs/permissions-and-data.md

@@ -14,6 +14,7 @@
 | `background` | Host scheduler에서 자동 실행 |
 | `account_read` | 필요한 계정 기본 정보 읽기 |
 | `storage` | 플러그인 전용 데이터 저장 |
+| `ai_storage` | AI가 선언된 namespace를 표준 CRUD Tool로 읽거나 변경 |
 | `credentials` | Credential/Connection 사용 |
 
 Manifest는 요청 가능한 최대 권한, capability와 UI extension은 실제 필요한 부분집합을 선언합니다.
@@ -41,15 +42,20 @@ Settings는 default Instance에 저장되는 작은 사용자 환경설정입니
 Settings 전체는 32 KiB 이하입니다. UI state의 client 저장 경계는 더 작을 수 있으므로 화면에 필요한
 최소 key만 유지합니다.
 
-## Plugin storage
+## Plugin Local Storage
 
-`storage`는 사용자·Installation/default Instance namespace로 격리됩니다. package가 업데이트되어도
-같은 Instance의 정상 데이터는 유지할 수 있지만 generation이 바뀐 오래된 실행은 새 상태를 쓰지
-못합니다.
+`storage`는 사용자·Installation·Instance·namespace로 격리됩니다. 문자열, 숫자, boolean, JSON과
+목록을 저장하며 package가 업데이트되어도 정책에 따라 유지됩니다. generation이 바뀐 오래된 실행은
+새 상태를 쓸 수 없습니다.
 
 삭제 시 `data_policy`가 일반 storage의 `purge` 또는 `retain`을 정합니다. credential, OAuth state,
 pending Host action은 별도 보안 수명주기를 따르며 일반 storage retention으로 보존하지 않습니다.
 
+`ai_storage`는 설치/설정에서 한 번 허용한 뒤 매 CRUD 승인을 반복하지 않습니다. 그래도 Host는
+현재 사용자·활성 Instance·허용 namespace와 `read`/`read_write` 범위를 매 호출 확인합니다.
+Manifest, CRUD 인자, quota, migration, 오류와 초기화는
+[Plugin Local Storage와 AI 접근](plugin-storage.md)을 참고하세요.
+
 ## Network
 
 외부 통신은 `http_json`, `mcp_http`, 지원되는 Host adapter를 통과합니다.
@@ -86,7 +92,13 @@ Capability 결과의 `data.host_actions`는 Host가 서버에서 다시 확인
   "at_millis": 1786640400000,
   "category": "reminder",
   "visibility": "private",
-  "silent": false
+  "silent": false,
+  "actions": [
+    {"id": "done", "type": "check", "label": "완료", "capability": "school_life.task.complete", "arguments": {"task_id": "42"}},
+    {"id": "later", "type": "snooze", "label": "10분 후", "minutes": 10},
+    {"id": "open", "type": "open_plugin", "label": "학교 생활", "target": "school_life.dashboard"},
+    {"id": "reply", "type": "reply", "label": "답장", "capability": "school_life.task.reply", "arguments": {"task_id": "42"}}
+  ]
 }
 ```
 
@@ -100,6 +112,12 @@ Capability 결과의 `data.host_actions`는 Host가 서버에서 다시 확인
 `big_text` 2,000자입니다. `category`는 `general`, `reminder`, `progress`, `status`,
 `visibility`는 `private`, `public`, `secret`입니다. 예약은 현재부터 최대 366일 안입니다.
 
+알림당 action은 최대 4개이며 `check`, `capability`, `snooze`, `open_plugin`, `reply`를 지원합니다.
+check/custom/reply는 현재 Instance에 선언된 Tool·Skill capability만 실행하고, 클릭 순간 enabled,
+generation, permission, Connection을 다시 검사합니다. reply text는 Host가 제한된 argument로만 넣습니다.
+event token과 action ID로 중복 클릭을 제거하고 성공한 event만 ACK합니다. capability가 Storage를
+변경하면 같은 storage revision 신호로 열린 UI를 갱신합니다.
+
 progress:
 
 ```json