codesyncer 3.0.0 → 3.1.0

package/dist/utils/template-upgrader.js

@@ -0,0 +1,249 @@
+"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.backupFile = backupFile;
+exports.upgradeTemplate = upgradeTemplate;
+exports.upgradeTemplates = upgradeTemplates;
+exports.extractVarsFromFile = extractVarsFromFile;
+exports.getTemplateVarsFromContext = getTemplateVarsFromContext;
+exports.formatUpgradeSummary = formatUpgradeSummary;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const template_loader_1 = require("./template-loader");
+/**
+ * Create a backup of a file before upgrading
+ *
+ * @param filePath - Path to the file to backup
+ * @returns Path to the backup file
+ */
+async function backupFile(filePath) {
+    const dir = path.dirname(filePath);
+    const fileName = path.basename(filePath);
+    const today = new Date().toISOString().split('T')[0];
+    const backupFileName = `${fileName}.backup.${today}`;
+    const backupPath = path.join(dir, backupFileName);
+    // If backup already exists today, add a numeric suffix
+    let finalBackupPath = backupPath;
+    let counter = 1;
+    while (await fs.pathExists(finalBackupPath)) {
+        finalBackupPath = path.join(dir, `${fileName}.backup.${today}.${counter}`);
+        counter++;
+    }
+    await fs.copy(filePath, finalBackupPath);
+    return finalBackupPath;
+}
+/**
+ * Upgrade a single template file
+ *
+ * @param templateStatus - Template status from version check
+ * @param options - Upgrade options
+ * @returns Promise resolving to UpgradeResult
+ */
+async function upgradeTemplate(templateStatus, options) {
+    const { file, templateName } = templateStatus;
+    const { lang, vars, dryRun } = options;
+    try {
+        // Skip if dry run
+        if (dryRun) {
+            return {
+                success: true,
+                file,
+                backupPath: `${file}.backup.${new Date().toISOString().split('T')[0]} (dry run)`,
+            };
+        }
+        // Backup existing file
+        let backupPath;
+        if (await fs.pathExists(file)) {
+            backupPath = await backupFile(file);
+        }
+        // Load and render new template
+        const template = await (0, template_loader_1.loadTemplate)(templateName, lang);
+        const content = (0, template_loader_1.replaceTemplateVars)(template, vars);
+        // Write the upgraded template
+        await fs.writeFile(file, content, 'utf-8');
+        return {
+            success: true,
+            file,
+            backupPath,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            file,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Upgrade multiple templates
+ *
+ * @param templates - Array of template statuses to upgrade
+ * @param options - Upgrade options
+ * @returns Promise resolving to array of UpgradeResults
+ */
+async function upgradeTemplates(templates, options) {
+    const results = [];
+    for (const template of templates) {
+        const result = await upgradeTemplate(template, options);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Extract variables from existing file for re-use during upgrade
+ *
+ * @param filePath - Path to existing file
+ * @returns Record of extracted variables
+ */
+async function extractVarsFromFile(filePath) {
+    const vars = {};
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Extract project name
+        const projectNameMatch = content.match(/\*\*(?:프로젝트명|Project Name)\*\*:\s*([^\n]+)/);
+        if (projectNameMatch) {
+            vars['PROJECT_NAME'] = projectNameMatch[1].trim();
+            vars['프로젝트명'] = projectNameMatch[1].trim();
+        }
+        // Extract tech stack
+        const techStackMatch = content.match(/\*\*(?:기술 스택|Tech Stack)\*\*:\s*([^\n]+)/);
+        if (techStackMatch) {
+            vars['TECH_STACK'] = techStackMatch[1].trim();
+            vars['기술 스택'] = techStackMatch[1].trim();
+        }
+        // Extract project type
+        const projectTypeMatch = content.match(/\*\*(?:프로젝트 타입|Project Type)\*\*:\s*([^\n]+)/);
+        if (projectTypeMatch) {
+            vars['PROJECT_TYPE'] = projectTypeMatch[1].trim();
+            vars['프로젝트 타입'] = projectTypeMatch[1].trim();
+        }
+        // Extract GitHub username
+        const githubMatch = content.match(/github\.com\/([^/\s]+)/i);
+        if (githubMatch) {
+            vars['GITHUB_USERNAME'] = githubMatch[1];
+        }
+    }
+    catch (error) {
+        // Ignore extraction errors
+    }
+    return vars;
+}
+/**
+ * Get template variables from .claude directory context
+ *
+ * @param claudeDir - Path to .claude directory
+ * @param lang - Language to use
+ * @returns Record of template variables
+ */
+async function getTemplateVarsFromContext(claudeDir, lang) {
+    const vars = {};
+    // Try to extract from CLAUDE.md first
+    const claudeMdPath = path.join(claudeDir, 'CLAUDE.md');
+    if (await fs.pathExists(claudeMdPath)) {
+        const extracted = await extractVarsFromFile(claudeMdPath);
+        Object.assign(vars, extracted);
+    }
+    // Default values if not found
+    const projectDir = path.dirname(claudeDir);
+    if (!vars['PROJECT_NAME']) {
+        vars['PROJECT_NAME'] = path.basename(projectDir);
+        vars['프로젝트명'] = path.basename(projectDir);
+    }
+    if (!vars['TECH_STACK']) {
+        vars['TECH_STACK'] = 'TypeScript';
+        vars['기술 스택'] = 'TypeScript';
+    }
+    if (!vars['GITHUB_USERNAME']) {
+        vars['GITHUB_USERNAME'] = 'your-username';
+    }
+    // Add date
+    const today = new Date().toISOString().split('T')[0];
+    vars['TODAY'] = today;
+    vars['오늘 날짜'] = today;
+    return vars;
+}
+/**
+ * Format upgrade summary for display
+ *
+ * @param results - Array of upgrade results
+ * @param lang - Language for messages
+ * @returns Formatted summary string
+ */
+function formatUpgradeSummary(results, lang) {
+    const successful = results.filter((r) => r.success);
+    const failed = results.filter((r) => !r.success);
+    const lines = [];
+    if (lang === 'ko') {
+        if (successful.length > 0) {
+            lines.push(`✅ ${successful.length}개 파일 업그레이드 완료:`);
+            successful.forEach((r) => {
+                const fileName = path.basename(r.file);
+                lines.push(`   • ${fileName}`);
+                if (r.backupPath) {
+                    lines.push(`     백업: ${path.basename(r.backupPath)}`);
+                }
+            });
+        }
+        if (failed.length > 0) {
+            lines.push(`❌ ${failed.length}개 파일 업그레이드 실패:`);
+            failed.forEach((r) => {
+                const fileName = path.basename(r.file);
+                lines.push(`   • ${fileName}: ${r.error}`);
+            });
+        }
+    }
+    else {
+        if (successful.length > 0) {
+            lines.push(`✅ ${successful.length} file(s) upgraded:`);
+            successful.forEach((r) => {
+                const fileName = path.basename(r.file);
+                lines.push(`   • ${fileName}`);
+                if (r.backupPath) {
+                    lines.push(`     Backup: ${path.basename(r.backupPath)}`);
+                }
+            });
+        }
+        if (failed.length > 0) {
+            lines.push(`❌ ${failed.length} file(s) failed:`);
+            failed.forEach((r) => {
+                const fileName = path.basename(r.file);
+                lines.push(`   • ${fileName}: ${r.error}`);
+            });
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=template-upgrader.js.map

package/dist/utils/template-upgrader.js.map

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

package/dist/utils/template-version.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Mapping of .claude file names to template names
+ */
+export declare const TEMPLATE_FILE_MAP: Record<string, string>;
+/**
+ * Template status information for upgrade checks
+ */
+export interface TemplateStatus {
+    file: string;
+    templateName: string;
+    currentVersion: string | null;
+    latestVersion: string;
+    isOutdated: boolean;
+}
+/**
+ * Extract template version from file content
+ *
+ * @param content - File content to extract version from
+ * @returns Version string or null if not found
+ */
+export declare function extractTemplateVersion(content: string): string | null;
+/**
+ * Compare two semantic versions
+ *
+ * @param v1 - First version string (e.g., "3.0.0")
+ * @param v2 - Second version string (e.g., "3.0.1")
+ * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if a file's template version is outdated compared to current package version
+ *
+ * @param filePath - Path to the file to check
+ * @returns Promise resolving to TemplateStatus
+ */
+export declare function checkTemplateVersion(filePath: string): Promise<TemplateStatus>;
+/**
+ * Scan a .claude directory for template files and check their versions
+ *
+ * @param claudeDir - Path to the .claude directory
+ * @returns Promise resolving to array of TemplateStatus objects
+ */
+export declare function scanTemplateVersions(claudeDir: string): Promise<TemplateStatus[]>;
+/**
+ * Get all outdated templates from a .claude directory
+ *
+ * @param claudeDir - Path to the .claude directory
+ * @returns Promise resolving to array of outdated TemplateStatus objects
+ */
+export declare function getOutdatedTemplates(claudeDir: string): Promise<TemplateStatus[]>;
+/**
+ * Check if any templates in a .claude directory need upgrading
+ *
+ * @param claudeDir - Path to the .claude directory
+ * @returns Promise resolving to boolean
+ */
+export declare function hasOutdatedTemplates(claudeDir: string): Promise<boolean>;
+/**
+ * Get the current package version (for display purposes)
+ *
+ * @returns Current package version string
+ */
+export declare function getCurrentVersion(): string;
+//# sourceMappingURL=template-version.d.ts.map

package/dist/utils/template-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-version.d.ts","sourceRoot":"","sources":["../../src/utils/template-version.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAa9D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8BpF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAavF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAGvF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/utils/template-version.js

@@ -0,0 +1,177 @@
+"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.TEMPLATE_FILE_MAP = void 0;
+exports.extractTemplateVersion = extractTemplateVersion;
+exports.compareVersions = compareVersions;
+exports.checkTemplateVersion = checkTemplateVersion;
+exports.scanTemplateVersions = scanTemplateVersions;
+exports.getOutdatedTemplates = getOutdatedTemplates;
+exports.hasOutdatedTemplates = hasOutdatedTemplates;
+exports.getCurrentVersion = getCurrentVersion;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const version_1 = require("./version");
+/**
+ * Template version extraction and comparison utilities
+ *
+ * @codesyncer-context Supports template upgrade feature in update command
+ * @codesyncer-decision [2026-01-17] Using HTML comment format for version metadata
+ */
+/**
+ * Version metadata regex pattern
+ * Matches: <!-- codesyncer-version: X.Y.Z -->
+ */
+const VERSION_PATTERN = /<!--\s*codesyncer-version:\s*([\d.]+)\s*-->/;
+/**
+ * Mapping of .claude file names to template names
+ */
+exports.TEMPLATE_FILE_MAP = {
+    'CLAUDE.md': 'claude',
+    'ARCHITECTURE.md': 'architecture',
+    'COMMENT_GUIDE.md': 'comment_guide',
+    'DECISIONS.md': 'decisions',
+};
+/**
+ * Extract template version from file content
+ *
+ * @param content - File content to extract version from
+ * @returns Version string or null if not found
+ */
+function extractTemplateVersion(content) {
+    const match = content.match(VERSION_PATTERN);
+    return match ? match[1] : null;
+}
+/**
+ * Compare two semantic versions
+ *
+ * @param v1 - First version string (e.g., "3.0.0")
+ * @param v2 - Second version string (e.g., "3.0.1")
+ * @returns -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+ */
+function compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+        const p1 = parts1[i] || 0;
+        const p2 = parts2[i] || 0;
+        if (p1 < p2)
+            return -1;
+        if (p1 > p2)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Check if a file's template version is outdated compared to current package version
+ *
+ * @param filePath - Path to the file to check
+ * @returns Promise resolving to TemplateStatus
+ */
+async function checkTemplateVersion(filePath) {
+    const fileName = path.basename(filePath);
+    const templateName = exports.TEMPLATE_FILE_MAP[fileName] || fileName.toLowerCase().replace('.md', '');
+    let currentVersion = null;
+    let isOutdated = false;
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        currentVersion = extractTemplateVersion(content);
+        if (currentVersion) {
+            isOutdated = compareVersions(currentVersion, version_1.VERSION) < 0;
+        }
+        else {
+            // No version found means it's from before versioning was added
+            // Consider it outdated
+            isOutdated = true;
+        }
+    }
+    catch (error) {
+        // File doesn't exist or can't be read
+        isOutdated = false;
+    }
+    return {
+        file: filePath,
+        templateName,
+        currentVersion,
+        latestVersion: version_1.VERSION,
+        isOutdated,
+    };
+}
+/**
+ * Scan a .claude directory for template files and check their versions
+ *
+ * @param claudeDir - Path to the .claude directory
+ * @returns Promise resolving to array of TemplateStatus objects
+ */
+async function scanTemplateVersions(claudeDir) {
+    const results = [];
+    for (const fileName of Object.keys(exports.TEMPLATE_FILE_MAP)) {
+        const filePath = path.join(claudeDir, fileName);
+        if (await fs.pathExists(filePath)) {
+            const status = await checkTemplateVersion(filePath);
+            results.push(status);
+        }
+    }
+    return results;
+}
+/**
+ * Get all outdated templates from a .claude directory
+ *
+ * @param claudeDir - Path to the .claude directory
+ * @returns Promise resolving to array of outdated TemplateStatus objects
+ */
+async function getOutdatedTemplates(claudeDir) {
+    const allTemplates = await scanTemplateVersions(claudeDir);
+    return allTemplates.filter((t) => t.isOutdated);
+}
+/**
+ * Check if any templates in a .claude directory need upgrading
+ *
+ * @param claudeDir - Path to the .claude directory
+ * @returns Promise resolving to boolean
+ */
+async function hasOutdatedTemplates(claudeDir) {
+    const outdated = await getOutdatedTemplates(claudeDir);
+    return outdated.length > 0;
+}
+/**
+ * Get the current package version (for display purposes)
+ *
+ * @returns Current package version string
+ */
+function getCurrentVersion() {
+    return version_1.VERSION;
+}
+//# sourceMappingURL=template-version.js.map

package/dist/utils/template-version.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesyncer",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Claude forgets everything when the session ends. CodeSyncer makes it remember.",
   "keywords": [
     "ai-collaboration",

package/src/templates/en/architecture.md

@@ -145,3 +145,5 @@ No API endpoints discovered.
 ---
 
 *This document is auto-generated and managed by CodeSyncer.*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/claude.md

@@ -279,3 +279,5 @@ grep -r "@codesyncer-rule" ./
 ---
 
 *This collaboration system is open source. Suggest improvements at [CodeSyncer GitHub](https://github.com/bitjaru/codesyncer)!*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/comment_guide.md

@@ -580,3 +580,5 @@ After writing code:
 **Last Updated**: [TODAY]
 
 *Comments are the documentation. Record all context in code.*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/decisions.md

@@ -225,3 +225,5 @@ grep "@codesyncer-decision" src/services/PaymentService.ts
 **Last Updated**: [TODAY]
 
 *All important decisions are permanently recorded. This is your team's knowledge asset.*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/master.md

@@ -177,3 +177,5 @@ Both formats work identically, so use whichever you prefer!
 
 *CodeSyncer - Persistent context, controlled inference, live architecture sync for Claude Code*
 *Currently Supported: Claude Code | Coming Soon: Cursor, GitHub Copilot, Continue.dev*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/root_claude.md

@@ -239,3 +239,5 @@ grep -r "payment" ./*/
 ---
 
 *CodeSyncer is open source: https://github.com/bitjaru/codesyncer*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/setup_guide.md

@@ -313,3 +313,5 @@ Setup is successful when:
 ---
 
 *This setup guide is generated by CodeSyncer CLI. For issues or improvements, visit: https://github.com/bitjaru/codesyncer*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/setup_guide_monorepo.md

@@ -330,3 +330,5 @@ Setup is successful when:
 ---
 
 *This setup guide is generated by CodeSyncer CLI. For issues or improvements, visit: https://github.com/bitjaru/codesyncer*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/en/setup_guide_single.md

@@ -322,3 +322,5 @@ rm .claude/SETUP_GUIDE.md
 ---
 
 *This setup guide is generated by CodeSyncer CLI. For issues or improvements, visit: https://github.com/bitjaru/codesyncer*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/architecture.md

@@ -145,3 +145,5 @@
 ---
 
 *이 문서는 CodeSyncer에 의해 자동 생성 및 관리됩니다.*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/claude.md

@@ -279,3 +279,5 @@ grep -r "@codesyncer-rule" ./
 ---
 
 *이 협업 시스템은 오픈소스입니다. 개선 아이디어는 [CodeSyncer GitHub](https://github.com/bitjaru/codesyncer)에서 제안해주세요!*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/comment_guide.md

@@ -580,3 +580,5 @@ ARCHITECTURE.md에 자동 집계:
 **마지막 업데이트**: [TODAY]
 
 *주석이 곧 문서입니다. 모든 컨텍스트를 코드에 기록하세요.*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/decisions.md

@@ -225,3 +225,5 @@ grep "@codesyncer-decision" src/services/PaymentService.ts
 **마지막 업데이트**: [TODAY]
 
 *모든 중요한 의사결정이 영구 기록됩니다. 팀의 지식 자산입니다.*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/master.md

@@ -177,3 +177,5 @@ CodeSyncer는 두 가지 태그 형식을 모두 지원합니다:
 
 *CodeSyncer - 영구 컨텍스트, 추론 통제, 실시간 아키텍처 동기화 for Claude Code*
 *현재 지원: Claude Code | 향후 지원 예정: Cursor, GitHub Copilot, Continue.dev*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/root_claude.md

@@ -239,3 +239,5 @@ grep -r "결제" ./*/
 ---
 
 *CodeSyncer는 오픈소스입니다: https://github.com/bitjaru/codesyncer*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/setup_guide.md

@@ -313,3 +313,5 @@ CodeSyncer 사용 준비 완료!
 ---
 
 *이 설정 가이드는 CodeSyncer CLI에 의해 생성됩니다. 문제나 개선사항은 https://github.com/bitjaru/codesyncer 방문*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/setup_guide_monorepo.md

@@ -330,3 +330,5 @@ CodeSyncer 사용 준비 완료!
 ---
 
 *이 설정 가이드는 CodeSyncer CLI에 의해 생성됩니다. 문제나 개선사항은 https://github.com/bitjaru/codesyncer 방문*
+
+<!-- codesyncer-version: 3.1.0 -->

package/src/templates/ko/setup_guide_single.md

@@ -322,3 +322,5 @@ rm .claude/SETUP_GUIDE.md
 ---
 
 *이 설정 가이드는 CodeSyncer CLI에 의해 생성됩니다. 문제나 개선사항은 https://github.com/bitjaru/codesyncer 방문*
+
+<!-- codesyncer-version: 3.1.0 -->