@decencia/ch-cli 1.3.6 → 1.4.0

package/dist/commands/check.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerCheckCommand(program: Command): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0EpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiH3D"}

package/dist/commands/check.js

@@ -0,0 +1,189 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCheckCommand = registerCheckCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const output_1 = require("../output");
+const skill_meta_1 = require("../skill-meta");
+const PKG_NAME = '@decencia/ch-cli';
+function readCliVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+        return pkg.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+// Query npm registry for the latest published version. Returns null when the
+// registry is unreachable (offline / blocked) so the caller can pass non-blocking.
+function fetchLatestVersion() {
+    try {
+        const out = (0, child_process_1.execSync)(`npm view ${PKG_NAME} version`, {
+            encoding: 'utf-8',
+            timeout: 20000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return out.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+// Skills bundled with this package (skill/<name>/SKILL.md).
+function listBundledSkills() {
+    const root = path.join(__dirname, '..', '..', 'skill');
+    if (!fs.existsSync(root))
+        return [];
+    return fs
+        .readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && fs.existsSync(path.join(root, e.name, 'SKILL.md')))
+        .map((e) => e.name);
+}
+function parseFrontmatterVersion(file) {
+    try {
+        const lines = fs.readFileSync(file, 'utf-8').split(/\r?\n/);
+        if (lines[0].trim() !== '---')
+            return null;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i].trim() === '---')
+                break;
+            const m = /^version:\s*(.+?)\s*$/.exec(lines[i]);
+            if (m)
+                return m[1].trim();
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return null;
+}
+// Compare two dotted versions. Returns 1 / 0 / -1.
+function cmpSemver(a, b) {
+    const pa = a.split('.').map((n) => parseInt(n, 10) || 0);
+    const pb = b.split('.').map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        const d = (pa[i] || 0) - (pb[i] || 0);
+        if (d !== 0)
+            return d > 0 ? 1 : -1;
+    }
+    return 0;
+}
+function registerCheckCommand(program) {
+    program
+        .command('check')
+        .description('CLI·스킬이 최신 버전인지 검사 (구버전이면 exit code 1)')
+        .action((_opts, cmd) => {
+        const json = !!cmd.optsWithGlobals().json;
+        const cliVersion = readCliVersion();
+        const latest = fetchLatestVersion();
+        // Offline / registry unreachable → non-blocking pass with a warning.
+        if (latest === null) {
+            if (json) {
+                console.log(JSON.stringify({ ok: true, networkOk: false, cliVersion, latestVersion: null }, null, 2));
+            }
+            else {
+                (0, output_1.printWarning)('최신 버전을 확인할 수 없습니다 (네트워크/npm 접근 불가). 버전 검사를 건너뜁니다.');
+                (0, output_1.printInfo)(`현재 CLI: ${cliVersion}`);
+            }
+            return; // exit 0
+        }
+        const cliOutdated = cmpSemver(cliVersion, latest) < 0;
+        const skillsRoot = path.join(os.homedir(), '.claude', 'skills');
+        const missingSkills = [];
+        const staleSkills = [];
+        for (const name of listBundledSkills()) {
+            const installed = path.join(skillsRoot, name, 'SKILL.md');
+            if (!fs.existsSync(installed)) {
+                missingSkills.push(name);
+                continue;
+            }
+            const v = parseFrontmatterVersion(installed);
+            if (v === null || cmpSemver(v, latest) < 0) {
+                staleSkills.push({ name, version: v });
+            }
+        }
+        // Superseded v1 skills still present on disk → agents could load them.
+        const deprecatedPresent = skill_meta_1.DEPRECATED_SKILLS.filter((name) => fs.existsSync(path.join(skillsRoot, name, 'SKILL.md')));
+        const ok = !cliOutdated &&
+            missingSkills.length === 0 &&
+            staleSkills.length === 0 &&
+            deprecatedPresent.length === 0;
+        if (json) {
+            console.log(JSON.stringify({
+                ok,
+                networkOk: true,
+                cliVersion,
+                latestVersion: latest,
+                cliOutdated,
+                missingSkills,
+                staleSkills,
+                deprecatedPresent,
+            }, null, 2));
+            if (!ok)
+                process.exit(1);
+            return;
+        }
+        if (ok) {
+            (0, output_1.printSuccess)(`최신 상태입니다. (CLI ${cliVersion}, 스킬 ${listBundledSkills().length}개 모두 최신)`);
+            return;
+        }
+        (0, output_1.printError)(`구버전이 감지되었습니다. npm 최신 버전: ${latest}`);
+        if (cliOutdated) {
+            (0, output_1.printWarning)(`• CLI 구버전 (현재 ${cliVersion} → 최신 ${latest})`);
+            (0, output_1.printInfo)('  → npm install -g @decencia/ch-cli@latest');
+        }
+        if (missingSkills.length > 0) {
+            (0, output_1.printWarning)(`• 미설치 스킬 ${missingSkills.length}개: ${missingSkills.join(', ')}`);
+        }
+        if (staleSkills.length > 0) {
+            (0, output_1.printWarning)(`• 구버전 스킬 ${staleSkills.length}개: ` +
+                staleSkills.map((s) => `${s.name}(${s.version || '없음'})`).join(', '));
+        }
+        if (deprecatedPresent.length > 0) {
+            (0, output_1.printWarning)(`• 폐기된 v1 스킬 잔존 ${deprecatedPresent.length}개: ${deprecatedPresent.join(', ')}`);
+        }
+        if (missingSkills.length > 0 ||
+            staleSkills.length > 0 ||
+            deprecatedPresent.length > 0) {
+            (0, output_1.printInfo)('  → (CLI 최신화 후) ch setup-skill');
+        }
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/setup-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-skill.d.ts","sourceRoot":"","sources":["../../src/commands/setup-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBhE"}
+{"version":3,"file":"setup-skill.d.ts","sourceRoot":"","sources":["../../src/commands/setup-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8DhE"}

package/dist/commands/setup-skill.js

@@ -38,24 +38,61 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const output_1 = require("../output");
+const skill_meta_1 = require("../skill-meta");
 function registerSetupSkillCommand(program) {
     program
         .command('setup-skill')
-        .description('Claude Code 스킬을 ~/.claude/skills/에 설치')
+        .description('소통채널 Claude Code 스킬 전체를 ~/.claude/skills/에 설치/갱신')
         .action(() => {
-        const srcPath = path.join(__dirname, '..', '..', 'skill', 'SKILL.md');
-        const destDir = path.join(os.homedir(), '.claude', 'skills', '2t-decencia-channel-cli');
-        const destPath = path.join(destDir, 'SKILL.md');
+        // dist/commands/setup-skill.js -> ../../skill (package root)
+        const skillRoot = path.join(__dirname, '..', '..', 'skill');
+        const destRoot = path.join(os.homedir(), '.claude', 'skills');
         try {
-            if (!fs.existsSync(srcPath)) {
-                (0, output_1.printError)(`패키지 내 SKILL.md를 찾을 수 없습니다: ${srcPath}`);
+            if (!fs.existsSync(skillRoot)) {
+                (0, output_1.printError)(`패키지 내 skill 디렉토리를 찾을 수 없습니다: ${skillRoot}`);
                 return;
             }
-            if (!fs.existsSync(destDir)) {
-                fs.mkdirSync(destDir, { recursive: true });
+            const dirs = fs
+                .readdirSync(skillRoot, { withFileTypes: true })
+                .filter((e) => e.isDirectory());
+            if (dirs.length === 0) {
+                (0, output_1.printError)(`설치할 스킬이 없습니다: ${skillRoot}`);
+                return;
+            }
+            const installed = [];
+            for (const dir of dirs) {
+                const src = path.join(skillRoot, dir.name, 'SKILL.md');
+                if (!fs.existsSync(src))
+                    continue;
+                const destDir = path.join(destRoot, dir.name);
+                if (!fs.existsSync(destDir)) {
+                    fs.mkdirSync(destDir, { recursive: true });
+                }
+                fs.copyFileSync(src, path.join(destDir, 'SKILL.md'));
+                installed.push(dir.name);
+            }
+            (0, output_1.printSuccess)(`Claude Code 스킬 ${installed.length}개를 설치/갱신했습니다 → ~/.claude/skills/`);
+            for (const name of installed) {
+                (0, output_1.printInfo)(`  • ${name}`);
+            }
+            // Remove superseded v1 skills so agents never load a stale version.
+            const installedSet = new Set(installed);
+            const removed = [];
+            for (const name of skill_meta_1.DEPRECATED_SKILLS) {
+                if (installedSet.has(name))
+                    continue; // never remove something we just installed
+                const dir = path.join(destRoot, name);
+                if (fs.existsSync(dir)) {
+                    fs.rmSync(dir, { recursive: true, force: true });
+                    removed.push(name);
+                }
+            }
+            if (removed.length > 0) {
+                (0, output_1.printWarning)(`구버전(deprecated) 스킬 ${removed.length}개를 제거했습니다:`);
+                for (const name of removed) {
+                    (0, output_1.printInfo)(`  - ${name}`);
+                }
             }
-            fs.copyFileSync(srcPath, destPath);
-            (0, output_1.printSuccess)(`Claude Code 스킬이 설치되었습니다: ~/.claude/skills/2t-decencia-channel-cli/SKILL.md`);
         }
         catch (err) {
             (0, output_1.printError)(`스킬 설치 중 오류가 발생했습니다: ${err.message}`);

package/dist/commands/setup-skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-skill.js","sourceRoot":"","sources":["../../src/commands/setup-skill.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,8DAyBC;AA9BD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,sCAAqD;AAErD,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC;QACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,IAAA,mBAAU,EAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAED,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnC,IAAA,qBAAY,EAAC,4EAA4E,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAA,mBAAU,EAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"setup-skill.js","sourceRoot":"","sources":["../../src/commands/setup-skill.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -54,6 +54,7 @@ const backup_1 = require("./commands/backup");
 const notifications_1 = require("./commands/notifications");
 const dashboard_1 = require("./commands/dashboard");
 const setup_skill_1 = require("./commands/setup-skill");
+const check_1 = require("./commands/check");
 // Read version from package.json
 function getVersion() {
     try {
@@ -95,6 +96,7 @@ program
 (0, notifications_1.registerNotificationsCommand)(program);
 (0, dashboard_1.registerDashboardCommand)(program);
 (0, setup_skill_1.registerSetupSkillCommand)(program);
+(0, check_1.registerCheckCommand)(program);
 // Parse and execute
 program.parseAsync(process.argv).catch((err) => {
     console.error(err);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yCAAoC;AACpC,2CAA6B;AAC7B,uCAAyB;AAEzB,0CAAsD;AACtD,0CAAsD;AACtD,kDAA8D;AAC9D,4CAAwD;AACxD,gDAA4D;AAC5D,wCAAoD;AACpD,wCAAoD;AACpD,kDAA8D;AAC9D,gDAA4D;AAC5D,sDAAiE;AACjE,wCAAoD;AACpD,oDAA+D;AAC/D,oDAA+D;AAC/D,8CAA0D;AAE1D,4DAAwE;AACxE,oDAAgE;AAChE,wDAAmE;AAEnE,iCAAiC;AACjC,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC;KAC/C,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC;KAChC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC;KACtC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;KAC9B,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;KAChD,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;KAC/B,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC;KACnC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAEtC,+BAA+B;AAC/B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;AAC7B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;AAC7B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;AAC9B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAE/B,IAAA,4CAA4B,EAAC,OAAO,CAAC,CAAC;AACtC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,uCAAyB,EAAC,OAAO,CAAC,CAAC;AAEnC,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yCAAoC;AACpC,2CAA6B;AAC7B,uCAAyB;AAEzB,0CAAsD;AACtD,0CAAsD;AACtD,kDAA8D;AAC9D,4CAAwD;AACxD,gDAA4D;AAC5D,wCAAoD;AACpD,wCAAoD;AACpD,kDAA8D;AAC9D,gDAA4D;AAC5D,sDAAiE;AACjE,wCAAoD;AACpD,oDAA+D;AAC/D,oDAA+D;AAC/D,8CAA0D;AAE1D,4DAAwE;AACxE,oDAAgE;AAChE,wDAAmE;AACnE,4CAAwD;AAExD,iCAAiC;AACjC,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC;KAC/C,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC;KAChC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC;KACtC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;KAC9B,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;KAChD,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;KAC/B,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC;KACnC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAEtC,+BAA+B;AAC/B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;AAC7B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;AAC7B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;AAC9B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAE/B,IAAA,4CAA4B,EAAC,OAAO,CAAC,CAAC;AACtC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,uCAAyB,EAAC,OAAO,CAAC,CAAC;AACnC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;AAE9B,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/skill-meta.d.ts

@@ -0,0 +1,2 @@
+export declare const DEPRECATED_SKILLS: string[];
+//# sourceMappingURL=skill-meta.d.ts.map

package/dist/skill-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-meta.d.ts","sourceRoot":"","sources":["../src/skill-meta.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAOrC,CAAC"}

package/dist/skill-meta.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEPRECATED_SKILLS = void 0;
+// Skills that were superseded by their *-v2 counterparts. They are NOT bundled
+// with the package; setup-skill removes them and check flags them if present,
+// so agents never load a stale v1 skill.
+exports.DEPRECATED_SKILLS = [
+    '2t-decencia-channel-cli',
+    '2t-decencia-channel-db-schema',
+    '2t-decencia-channel-prd',
+    '2t-decencia-channel-spec',
+    '2t-decencia-channel-sprint-builder',
+    '2t-decencia-channel-sqa',
+];
+//# sourceMappingURL=skill-meta.js.map

package/dist/skill-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-meta.js","sourceRoot":"","sources":["../src/skill-meta.ts"],"names":[],"mappings":";;;AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,yCAAyC;AAC5B,QAAA,iBAAiB,GAAa;IACzC,yBAAyB;IACzB,+BAA+B;IAC/B,yBAAyB;IACzB,0BAA0B;IAC1B,oCAAoC;IACpC,yBAAyB;CAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decencia/ch-cli",
-  "version": "1.3.6",
+  "version": "1.4.0",
   "description": "Decencia Communication Channel CLI",
   "main": "dist/index.js",
   "bin": {
@@ -11,9 +11,10 @@
     "skill/"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "node scripts/sync-skill-version.js && tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "sync-skill-version": "node scripts/sync-skill-version.js",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/skill/2t-decencia-channel-change-manager/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: 2t-decencia-channel-change-manager
+description: 기존 소통채널 프로젝트의 기능 추가/수정을 사용자와 대화로 명확화 → 전파 스킬로 연관 PRD/spec/DB/SQA 일괄 갱신 → 변경으로 생긴 새 할일을 GitHub 이슈로 발행하는 오케스트레이터 스킬. (1)대화로 변경 내용 확정 → (2)[게이트] 영향 범위 확인 후 전파 적용 → (3)[게이트] 할일 목록 확인 후 이슈 발행. "이 기능 바꿀래"·"기획 수정"·"이거 추가해줘(기존 프로젝트)" 류 요청 시.
+allowed-tools: Bash(ch:*) Bash(git:*) Bash(gh:*) Read Write
+version: 1.4.0
+---
+
+<!-- ch-version-gate -->
+## ⚠️ 시작 전 필수 — 버전 게이트 (생략 금지)
+
+이 스킬로 **어떤 작업이든 수행하기 전에 가장 먼저** 아래를 실행한다:
+
+```bash
+ch check
+```
+
+- exit code 0(통과)이 **아니면 즉시 중단**한다. 출력에 안내된 업데이트 명령(`npm install -g @decencia/ch-cli@latest` 또는 `ch setup-skill`)을 사용자에게 전달하고, 갱신이 끝나기 전까지 **이 스킬의 어떤 단계도 진행하지 않는다.**
+- `ch`가 미설치/미인증이어도 먼저 `ch check`를 시도한다. (네트워크 불가 시 ch check는 통과시키되 경고를 남긴다.)
+
+구버전 스킬·CLI 사용을 막기 위한 게이트다. 건너뛰지 말 것.
+
+
+# 2t-decencia-channel-change-manager — 기존 기획 변경 관리
+
+기존 프로젝트의 **기능 추가/수정**을 사용자와 대화로 명확화하고, **연관 문서 전체를 동기화**한 뒤, 변경으로 새로 생긴 **할일을 GitHub 이슈로 발행**한다.
+이 스킬은 **오케스트레이터**다 — 영향 분석·문서 갱신은 `2t-decencia-channel-change-propagation-v2`에, 이슈 발행은 `2t-decencia-channel-github-issue`에 위임하고(중복 작성 금지), 흐름·승인 게이트만 책임진다.
+
+> 짝꿍: 신규 세팅은 [[2t-decencia-channel-project-bootstrap]], 변경 관리는 이 스킬. 발행된 이슈는 issue-coder → pr-merger로 흘러간다.
+
+## 핵심 원칙
+- **게이트 2개** — 외부 가시·파괴적(기존 문서 수정/외부 이슈) 작업이므로 사용자 확인 후 진행.
+  - ① **전파 적용 전**: 무엇이 어떻게 바뀌는지(영향 범위)를 보여주고 승인받는다.
+  - ② **이슈 발행 전**: 발행할 이슈 목록을 보여주고 승인받는다.
+- 위임: 전파→`2t-decencia-channel-change-propagation-v2`, 이슈→`2t-decencia-channel-github-issue`, 업로드→`2t-decencia-channel-cli-v2`. (전파 스킬이 내부적으로 spec/db-schema/sqa-v2를 활용)
+
+## Use when
+- "이 기능 바꿀 건데 영향 가는 곳 다 고쳐줘", "기획 수정", "기존 프로젝트에 이거 추가해줘", 명세·DB·SQA 정합성이 어긋난 의심이 들 때.
+
+---
+
+## 0. 대상 프로젝트 확정
+- cwd(또는 상위)의 `.ch-project`에서 `projectId` 확보. 없으면 사용자에게 묻는다.
+- 인증 확인: `ch auth status`, (이슈 발행 대비) `gh auth status`. 미인증이면 안내 후 중단.
+
+## 1. 변경 내용 명확화 (대화형)
+- 사용자와 **대화로 좁힌다**: **추가(feat) vs 수정(fix)** 구분, 구체적으로 무엇을·왜, 대상 기능/화면/spec.
+- 모호하면 한 번에 단정하지 말고 계속 질문. "현재 X → Y로 바꾼다" 수준까지 또렷하게.
+
+## 2. 영향 전파 (게이트 ①)
+*(변경 내용 확정 후)*
+- `2t-decencia-channel-change-propagation-v2`로 **영향 분석**: 이 변경이 닿는 PRD·spec(ui·logic·dbTableRefs·tasks)·db-schema/db-tables·SQA·workStatus를 빠짐없이 식별.
+- → **[게이트] 영향 범위를 사용자에게 제시하고 확인받는다** (어떤 문서가 어떻게 바뀌는지 요약). 승인 전에는 문서를 건드리지 않는다.
+- 승인되면 전파 스킬 절차대로 **연관 문서를 순차 갱신**. `spec.dbTableRefs` ↔ `dbTable.relatedSpecIds` 양방향 동기화 유지.
+
+## 3. 할일 → GitHub 이슈 (게이트 ②)
+*(전파 적용 후)*
+- 변경으로 **새로 생기거나 바뀐 할일**을 처리 단위로 정리한다 — 전파가 식별한 처리 항목 + 추가/변경된 `spec.tasks`. (구현이 필요 없는 순수 문서 정합은 이슈로 만들지 않는다)
+- → **[게이트] 발행할 이슈 목록(제목·유형·관련 specid)을 사용자에게 보여주고 확인받는다.** (github-issue 스킬은 멱등성/중복방지를 안 하므로, 여기서 확인이 안전장치)
+- 승인되면 `2t-decencia-channel-github-issue`로 발행: **추가=feat / 수정=fix**, 결함이면 bug. 관련 specid 백링크·완료조건 자동.
+- 발행된 이슈 URL을 모아 보고하고, **issue-coder로 이어진다**고 안내.
+
+---
+
+## 업로드/CLI 주의 (공통)
+- 모든 문서 갱신은 `2t-decencia-channel-cli-v2`(=`ch` CLI) 경유.
+- ⚠️ content는 **마크다운**(HTML 아님) + **CRLF 정제**(`tr -d '\r'`). PowerShell 인자 분리 실패 시 Bash 도구로 우회.
+- spec 필드는 **단수+복수 동시 저장**(device/devices 등) 규칙 유지(미준수 시 웹 빈 칼럼).
+- `ch specs get`/`--json` 조회가 Windows에서 빈 출력이면 PowerShell `Out-File` + forward-slash 경로로 우회.
+- 이슈 본문은 `--body-file`(LF) 사용 — 따옴표/줄바꿈/한글 안전.
+
+## 경계
+- **PR·머지·이슈 close는 하지 않는다** — 이슈 발행까지가 이 스킬의 끝(이후는 issue-coder/pr-merger/사람).
+- 두 게이트 모두 사용자 승인 없이는 넘어가지 않는다. 수정 요청이면 해당 단계 반복.