@ssobig/writer-cli 0.2.0 → 0.2.1

package/README.md

@@ -22,14 +22,20 @@ CLI는 stdout에 JSON 문서 하나를 출력한다. 원고 변경은 `plan ->
 ```bash
 ssobig-writer version --check
 npm install --global @ssobig/writer-cli@latest
+ssobig-writer skills status --target <내-workspace>
+ssobig-writer skills update --target <내-workspace>
 
 ssobig-writer auth logout
 ssobig-writer agent purge
+ssobig-writer skills remove --target <내-workspace> --managed-only --dry-run
+ssobig-writer skills remove --target <내-workspace> --managed-only
 npm uninstall --global @ssobig/writer-cli
 ```
 
 0.2.0부터 npm `latest`보다 낮은 CLI의 서버 접속 명령은 실행 전에 `E_CLI_UPDATE_REQUIRED`로 중단된다. help, targeted `command-schema`, `version --check`, `doctor`, `skills *`, logout과 daemon 정리 명령은 업데이트 전에도 사용할 수 있다. 0.1.0 사용자는 위 npm 설치 명령을 다시 실행해 0.2.0 이상으로 전환해야 한다. registry가 일시적으로 응답하지 않으면 새 작업을 차단하지 않지만, 로컬 cache가 이미 더 높은 버전을 확인했다면 계속 업데이트를 요구한다.
 
+CLI를 업데이트한 뒤에는 각 작업공간에서 `skills status`를 확인하고, `missing`이면 `skills install`, `update-available`이면 `skills update`를 실행한다. 그다음 새 Codex 또는 Claude 작업을 열어 갱신된 프로젝트 로컬 스킬을 다시 탐색한다. CLI 설치는 작업공간을 자동 변경하지 않는다. ZIP 사용자는 다운로드 페이지에서 새 ZIP을 받아 그 안의 installer를 실행해야 하며, 보관 중인 예전 ZIP을 다시 실행하면 그 ZIP에 포함된 구버전이 재설치된다.
+
 `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/)에서 확인한다.

package/package.json

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

package/tools/writer-cli/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@ssobig/writer-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ssobig/writer-cli",
-      "version": "0.2.0",
+      "version": "0.2.1",
       "dependencies": {
         "@supabase/supabase-js": "2.110.9"
       },

package/tools/writer-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssobig/writer-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": true,
   "description": "Internal agent-safe CLI for SSOBIG WRITER manuscript and asset operations",
   "type": "commonjs",

package/tools/writer-cli/skills/ssobig-writer-cli/references/errors.md

@@ -1,6 +1,6 @@
 # Errors and boundaries
 
-- `E_CLI_UPDATE_REQUIRED`: install the indicated latest npm package, then retry. The original operation was not sent.
+- `E_CLI_UPDATE_REQUIRED`: the original operation was not sent. Follow the returned `installCommand` or download the newest ZIP from `downloadUrl`, then run the returned `skillCommands.status`. Use `skillCommands.install` when missing or `skillCommands.update` when `update-available`, and start a new agent task before retrying.
 - `E_CODE_CHANGE_REQUIRED`: hard boundary; do not use SQL or another client. Separate a code or migration task.
 - `E_CONFLICT`: authoritative data changed after the plan. Read again and create a new plan.
 - `E_AUTH_REQUIRED`, `E_AUTH_EXPIRED`, `E_AUTHORIZATION`: use the supported login flow or ask an authorized staff member; never handle tokens directly.

package/tools/writer-cli/skills/ssobig-writer-cli/references/install-auth.md

@@ -4,4 +4,16 @@ Use targeted help for `version`, `doctor`, `auth`, and `skills`. Install the npm
 
 Check `version --check` before long work. From CLI 0.2.0 onward, outdated server-access commands stop with `E_CLI_UPDATE_REQUIRED`; local help, schemas, diagnostics, logout, daemon cleanup, and skill management remain available. Registry outages fail open unless a cached newer version is already known.
 
+Follow this complete lifecycle whenever the CLI reports an update:
+
+1. Run `ssobig-writer version --check` and preserve its sanitized `registry.remediation` details. The equivalent `doctor` check exposes the same lifecycle as additive `remediationDetails`, while keeping its existing remediation string.
+2. Update npm installations with `npm install --global @ssobig/writer-cli@latest`. ZIP users must download the newest macOS or Windows ZIP from `https://writer.ssobig.com/cli-download` and run the installer inside that new ZIP. Re-running an old downloaded ZIP only reinstalls its bundled old version.
+3. Run `ssobig-writer skills status --target <workspace>` from the updated CLI.
+4. If the skill is missing, run `ssobig-writer skills install --target <workspace>`. If it reports `update-available`, run `ssobig-writer skills update --target <workspace>`. Do nothing when it reports `current`.
+5. Start a new Codex or Claude task so the agent reloads the updated project-local skill.
+
+Updating the global CLI never silently changes a workspace. Keep this explicit sequence so managed-file conflicts remain visible and user-modified files are not overwritten.
+
+Before uninstalling the CLI, preview project-local skill removal with `ssobig-writer skills remove --target <workspace> --managed-only --dry-run`. If the preview owns only the expected managed files, run it again without `--dry-run`, then uninstall the npm package. Never delete an entire `.agents/skills` or `.claude/skills` directory.
+
 Authentication uses the supported staff flow. Never request, print, persist, or transmit access tokens. Use `doctor` for sanitized installation, credential-store, network, update, and daemon-version diagnostics.

package/tools/writer-cli/src/diagnostics.cjs

@@ -6,6 +6,7 @@ const packageManifest = require("../package.json");
 const { createCredentialStorage, createWindowsDpapiStorage, inspectStoredSession } = require("./auth.cjs");
 const { probeDaemon } = require("./daemon-runner.cjs");
 const { computeSourceFingerprint } = require("./source-fingerprint.cjs");
+const { updateRemediation } = require("./update-remediation.cjs");
 
 const REGISTRY_URL = "https://registry.npmjs.org/@ssobig%2Fwriter-cli/latest";
 
@@ -86,7 +87,9 @@ async function versionReport(options = {}) {
     try {
       const latestVersion = await (options.fetchLatest || fetchLatestVersion)({ fetch: options.fetch, timeoutMs: options.timeoutMs });
       const comparison = compareSemver(latestVersion, currentVersion);
-      report.registry = { status: comparison !== null && comparison > 0 ? "update-available" : "current", latestVersion, updateAvailable: comparison !== null && comparison > 0, error: null };
+      const updateAvailable = comparison !== null && comparison > 0;
+      report.registry = { status: updateAvailable ? "update-available" : "current", latestVersion, updateAvailable, error: null };
+      if (updateAvailable) report.registry.remediation = updateRemediation();
     } catch (error) {
       report.registry = { status: "unavailable", latestVersion: null, updateAvailable: null, error: "npm registry에서 최신 버전을 확인하지 못했습니다." };
     }
@@ -94,8 +97,10 @@ async function versionReport(options = {}) {
   return Object.freeze(report);
 }
 
-function check(id, status, message, code = null, remediation = null) {
-  return Object.freeze({ id, status, code, message, remediation });
+function check(id, status, message, code = null, remediation = null, remediationDetails) {
+  const result = { id, status, code, message, remediation };
+  if (remediationDetails !== undefined) result.remediationDetails = remediationDetails;
+  return Object.freeze(result);
 }
 
 function overallStatus(checks) {
@@ -162,7 +167,7 @@ async function doctorReport(options = {}) {
     try {
       const currentVersion = String(options.currentVersion || packageManifest.version);
       const latestVersion = await (options.fetchLatest || fetchLatestVersion)({ fetch: options.fetch, timeoutMs: options.timeoutMs });
-      if (compareSemver(latestVersion, currentVersion) > 0) checks.push(check("cli-update", "error", `Writer CLI ${currentVersion}보다 최신 필수 버전 ${latestVersion}이 있습니다.`, "E_CLI_UPDATE_REQUIRED", "npm install --global @ssobig/writer-cli@latest"));
+      if (compareSemver(latestVersion, currentVersion) > 0) checks.push(check("cli-update", "error", `Writer CLI ${currentVersion}보다 최신 필수 버전 ${latestVersion}이 있습니다.`, "E_CLI_UPDATE_REQUIRED", "npm install --global @ssobig/writer-cli@latest", updateRemediation()));
       else checks.push(check("cli-update", "ok", `Writer CLI ${currentVersion}이 npm latest 기준 최신입니다.`));
     } catch (error) {
       checks.push(check("cli-update", "warning", "npm registry에서 최신 Writer CLI 버전을 확인하지 못했습니다.", "W_CLI_UPDATE_CHECK_UNAVAILABLE", "네트워크 연결 후 ssobig-writer version --check를 다시 실행해 주세요."));

package/tools/writer-cli/src/skill-manager.cjs

@@ -7,7 +7,7 @@ const packageManifest = require("../package.json");
 const { cliError } = require("./errors.cjs");
 
 const SKILL_NAME = "ssobig-writer-cli";
-const SKILL_VERSION = "0.2.0";
+const SKILL_VERSION = packageManifest.version;
 const MANIFEST_NAME = ".ssobig-writer-skill-manifest.json";
 const PAYLOAD_ROOT = path.resolve(__dirname, "../skills", SKILL_NAME);
 const PLATFORM_PATHS = Object.freeze({ codex: [".agents", "skills"], claude: [".claude", "skills"] });

package/tools/writer-cli/src/update-gate.cjs

@@ -7,13 +7,11 @@ const packageManifest = require("../package.json");
 const { resolveAgentPaths, ensurePrivateDirectory } = require("./agent-paths.cjs");
 const { compareSemver, fetchLatestVersion, parseSemver } = require("./diagnostics.cjs");
 const { cliError } = require("./errors.cjs");
+const { INSTALL_COMMAND, DOWNLOAD_URL, updateRemediation } = require("./update-remediation.cjs");
 
 const CACHE_FILE = "cli-version-check.json";
 const CACHE_VERSION = 1;
 const DEFAULT_TTL_MS = 5 * 60 * 1000;
-const INSTALL_COMMAND = "npm install --global @ssobig/writer-cli@latest";
-const DOWNLOAD_URL = "https://writer.ssobig.com/cli-download";
-
 function clock(options = {}) {
   const value = typeof options.now === "function" ? options.now() : Date.now();
   return value instanceof Date ? value.getTime() : Number(value);
@@ -58,8 +56,7 @@ function updateRequired(currentVersion, latestVersion, source) {
   throw cliError("E_CLI_UPDATE_REQUIRED", `Writer CLI ${currentVersion}은 최신 필수 버전 ${latestVersion}보다 낮아 서버 작업을 실행하지 않았습니다.`, {
     currentVersion,
     latestVersion,
-    installCommand: INSTALL_COMMAND,
-    downloadUrl: DOWNLOAD_URL,
+    ...updateRemediation(),
     source
   });
 }

package/tools/writer-cli/src/update-remediation.cjs

@@ -0,0 +1,25 @@
+"use strict";
+
+const INSTALL_COMMAND = "npm install --global @ssobig/writer-cli@latest";
+const DOWNLOAD_URL = "https://writer.ssobig.com/cli-download";
+const SKILL_COMMANDS = Object.freeze({
+  status: "ssobig-writer skills status --target <workspace>",
+  install: "ssobig-writer skills install --target <workspace>",
+  update: "ssobig-writer skills update --target <workspace>"
+});
+
+function updateRemediation() {
+  return Object.freeze({
+    installCommand: INSTALL_COMMAND,
+    downloadUrl: DOWNLOAD_URL,
+    skillCommands: SKILL_COMMANDS,
+    agentReloadRequired: true
+  });
+}
+
+module.exports = Object.freeze({
+  INSTALL_COMMAND,
+  DOWNLOAD_URL,
+  SKILL_COMMANDS,
+  updateRemediation
+});