@ssobig/writer-cli 0.2.2 → 0.3.2

package/README.md

@@ -17,12 +17,27 @@ ssobig-writer project list
 
 CLI는 stdout에 JSON 문서 하나를 출력한다. 원고 변경은 `plan -> 사람 검토 -> apply -> authoritative read-back` 절차만 사용하며, 범용 SQL이나 직접 table update를 제공하지 않는다.
 
+작품 구성 화면의 등록된 선택 Component 추가·사용 여부와 선택 속성도 같은 절차로 변경할 수 있다.
+
+```bash
+ssobig-writer component plan-add --project <slug> --template ssobig.timeline --out .ssobig-writer/component-add.plan.json
+ssobig-writer apply .ssobig-writer/component-add.plan.json --receipt .ssobig-writer/component-add.receipt.json
+
+ssobig-writer component plan-set-active --project <slug> --instance timeline --active false --out .ssobig-writer/component-archive.plan.json
+ssobig-writer component plan-set-field --project <slug> --instance clues --field image --enabled false --out .ssobig-writer/field.plan.json
+```
+
+patch·spec·plan·receipt는 기밀 원고를 포함할 수 있으므로 ignored `.ssobig-writer/` 또는 private 경로에 보관하고 커밋하지 않는다.
+
+plan에서 대상, 보존할 data, 생성·제거될 View·binding 또는 `enabledOptionalFields` 변경을 먼저 검토해야 한다. 사용 안 함은 data를 삭제하지 않고 보관하며, 필수·내부·미등록 Component와 필수·미등록 속성 및 임의 구성 변경은 허용하지 않는다.
+
 ## 업데이트와 제거
 
 ```bash
 ssobig-writer version --check
 npm install --global @ssobig/writer-cli@latest
 ssobig-writer skills status --target <내-workspace>
+# status가 missing이면 install, update-available이면 update, current이면 추가 작업 없음
 ssobig-writer skills update --target <내-workspace>
 
 ssobig-writer auth logout
@@ -39,3 +54,7 @@ CLI를 업데이트한 뒤에는 각 작업공간에서 `skills status`를 확
 `doctor`는 설치·최신 버전·credential session 존재·Auth health·실행 backend 버전을 읽기 전용으로 진단하고 token, 이메일, 원고 값을 출력하지 않는다. macOS 세션은 Keychain에 저장되고 private Unix daemon을 사용한다. Windows 세션은 현재 Windows 사용자만 해독할 수 있도록 DPAPI CurrentUser로 보호되며 CLI는 background daemon 대신 in-process backend를 자동 사용한다. 따라서 Windows에서는 `agent start`와 `agent stop`이 지원되지 않는다.
 
 상세 설치, 업데이트, 삭제 방법은 [SSOBIG WRITER 운영 가이드](https://writer.ssobig.com/)에서 확인한다.
+
+## 작업별 안내
+
+설치된 `ssobig-writer-cli` 스킬은 필요한 참조만 선택한다. 패키지 안에서도 [조회와 검색](tools/writer-cli/skills/ssobig-writer-cli/references/read-search.md), [변경 계획](tools/writer-cli/skills/ssobig-writer-cli/references/projects-components.md), [추리 보드와 spec](tools/writer-cli/skills/ssobig-writer-cli/references/investigation-board.md), [오류 복구](tools/writer-cli/skills/ssobig-writer-cli/references/errors.md)를 읽을 수 있다.

package/asset-repository.js

@@ -30,18 +30,23 @@
     if (typeof options.putLocalAsset !== "function") throw new TypeError("에셋 복원에는 putLocalAsset 함수가 필요합니다.");
     const queue = buildAssetRestorePlan(manifest);
     const restoredLocalAssetIds = [];
+    const retainedLocalAssetIds = [];
     const concurrency = Math.max(1, Number(options.concurrency || 6));
     const workers = Array.from({ length: Math.min(concurrency, queue.length) }, async () => {
       while (queue.length) {
         const entry = queue.shift();
+        if (typeof options.isLocalAssetCurrent === "function" && await options.isLocalAssetCurrent(entry)) {
+          retainedLocalAssetIds.push(entry.localAssetId);
+          continue;
+        }
         const blob = await options.downloadAsset(entry);
         if (!blob) continue;
-        await options.putLocalAsset(entry.localAssetId, blob);
+        await options.putLocalAsset(entry.localAssetId, blob, entry);
         restoredLocalAssetIds.push(entry.localAssetId);
       }
     });
     await Promise.all(workers);
-    return { clearLocalAssetIds: [], restoredLocalAssetIds };
+    return { clearLocalAssetIds: [], restoredLocalAssetIds, retainedLocalAssetIds };
   }
 
   async function defaultContentHash(blob) {

package/config.js

@@ -9,6 +9,7 @@
     supabaseUrl: "https://tlyioijsopxeegzfjlqe.supabase.co",
     supabaseKey: "sb_publishable_AdEHgXPGJ2gKGVAjb7RYSg_YzUuT6jB",
     assetBucket: "ssobig-writer-assets",
-    staffDomain: "ssobig.com"
+    staffDomain: "ssobig.com",
+    sentryDsn: "https://d9d4a549fafe2f35be1827e5097ea7e8@o4505765760204800.ingest.us.sentry.io/4511998281449472"
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssobig/writer-cli",
-  "version": "0.2.2",
+  "version": "0.3.2",
   "description": "Official agent CLI for SSOBIG WRITER",
   "type": "commonjs",
   "license": "UNLICENSED",

package/templates/mystery-v1/authoring-view-preference.js

@@ -8,6 +8,7 @@
   const STORAGE_KEY = "somi-workbench-authoring-view";
   const DEFAULT_VIEW = "preview";
   const VIEWS = Object.freeze(["input", "preview"]);
+  const STORAGE_VERSION = 1;
 
   function normalize(value) {
     return VIEWS.includes(value) ? value : DEFAULT_VIEW;
@@ -18,17 +19,33 @@
     catch (_) { return null; }
   }
 
-  function read(storage = deviceStorage()) {
-    try { return normalize(storage?.getItem(STORAGE_KEY)); }
+  function parseStoredValue(value) {
+    if (VIEWS.includes(value)) return { fallback: value, views: {} };
+    try {
+      const parsed = JSON.parse(value || "null");
+      if (parsed?.version !== STORAGE_VERSION || !parsed.views || typeof parsed.views !== "object" || Array.isArray(parsed.views)) return { fallback: DEFAULT_VIEW, views: {} };
+      return { fallback: normalize(parsed.fallback), views: { ...parsed.views } };
+    } catch (_) { return { fallback: DEFAULT_VIEW, views: {} }; }
+  }
+
+  function read(scope, storage = deviceStorage()) {
+    try {
+      const stored = parseStoredValue(storage?.getItem(STORAGE_KEY));
+      return normalize(stored.views[String(scope || "")] || stored.fallback);
+    }
     catch (_) { return DEFAULT_VIEW; }
   }
 
-  function write(view, storage = deviceStorage()) {
+  function write(scope, view, storage = deviceStorage()) {
     const normalized = normalize(view);
-    try { storage?.setItem(STORAGE_KEY, normalized); }
+    try {
+      const stored = parseStoredValue(storage?.getItem(STORAGE_KEY));
+      stored.views[String(scope || "")] = normalized;
+      storage?.setItem(STORAGE_KEY, JSON.stringify({ version: STORAGE_VERSION, fallback: stored.fallback, views: stored.views }));
+    }
     catch (_) { /* 기기 저장소를 사용할 수 없어도 현재 화면 전환은 유지한다. */ }
     return normalized;
   }
 
-  return Object.freeze({ STORAGE_KEY, DEFAULT_VIEW, VIEWS, normalize, read, write });
+  return Object.freeze({ STORAGE_KEY, STORAGE_VERSION, DEFAULT_VIEW, VIEWS, normalize, read, write });
 });

package/templates/mystery-v1/character-perspective-preview.js

@@ -6,9 +6,9 @@
   "use strict";
 
   const CARD_ORDER = Object.freeze([
-    Object.freeze({ key: "progress", label: "진행", templateId: "ssobig.progress" }),
-    Object.freeze({ key: "common", label: "공통정보", templateId: "ssobig.common" }),
-    Object.freeze({ key: "character", label: "캐릭터", templateId: "ssobig.character" })
+    Object.freeze({ key: "progress", label: "진행 순서", templateId: "ssobig.progress" }),
+    Object.freeze({ key: "common", label: "공통 문서", templateId: "ssobig.common" }),
+    Object.freeze({ key: "character", label: "캐릭터별 문서", templateId: "ssobig.character" })
   ]);
 
   function characters(instance, data) {