create-takt-sdd 0.4.0 → 0.6.0

package/dist/i18n.js

@@ -2,8 +2,10 @@ const en = {
     downloading: "Downloading takt-sdd...",
     downloadingVersion: (tag) => `Downloading takt-sdd ${tag}...`,
     installing: "Installing pieces and facets to .takt/...",
+    updating: "Updating takt-sdd...",
     existsError: (cmd) => `.takt/ already exists. To overwrite, run:\n  ${cmd} --force`,
     complete: "Installation complete!",
+    updateComplete: "Update complete!",
     dryRunHeader: "[dry-run] The following files would be installed:",
     dryRunItem: (path) => `  ${path}`,
     dryRunSkipped: "[dry-run] No files were written.",
@@ -13,6 +15,7 @@ const en = {
     scriptsSkipped: (keys) => `Skipped existing scripts: ${keys.join(", ")}`,
     scriptsCreated: "Created package.json with npm scripts and devDependencies",
     depsAdded: (keys) => `Added devDependencies: ${keys.join(", ")}`,
+    depsUpdated: (keys) => `Updated devDependencies: ${keys.join(", ")}`,
     installingSkills: "Installing takt skills to .agent/skills/...",
     skillInstalled: (name) => `Installed skill: ${name}`,
     skillSymlinked: (name, target) => `Symlinked ${target}/${name} -> .agent/skills/${name}`,
@@ -20,12 +23,16 @@ const en = {
     taktRefsInstalled: "Installed takt references (builtins, docs)",
     taktRefsSkipped: "Takt references already exist, skipping",
     taktRefsError: "Warning: Failed to download takt references. Skills may not find style guides.",
+    fileAdded: (path) => `Added: ${path}`,
+    fileUpdated: (path) => `Updated: ${path}`,
+    fileSkippedCustomized: (path) => `Skipped (customized): ${path}`,
+    manifestCreated: "Created install manifest",
     helpText: `Usage: npx create-takt-sdd [options]
 
 Options:
   --tag <version>    Version to install ("latest", "0.2.0", default: installer version)
   --lang <en|ja>     Message language (default: en)
-  --force            Overwrite existing .takt/ directory
+  --force            Overwrite existing .takt/ directory (ignored if manifest exists)
   --dry-run          Preview without writing files
   --without-skills   Skip installing takt skills to .agent/skills/
   --refs-path <path> Path for takt references (default: references/takt)
@@ -49,8 +56,10 @@ const ja = {
     downloading: "takt-sdd をダウンロード中...",
     downloadingVersion: (tag) => `takt-sdd ${tag} をダウンロード中...`,
     installing: ".takt/ にピースとファセットをインストール中...",
+    updating: "takt-sdd をアップデート中...",
     existsError: (cmd) => `.takt/ が既に存在します。上書きするには以下を実行してください:\n  ${cmd} --force`,
     complete: "インストール完了!",
+    updateComplete: "アップデート完了!",
     dryRunHeader: "[dry-run] 以下のファイルがインストールされます:",
     dryRunItem: (path) => `  ${path}`,
     dryRunSkipped: "[dry-run] ファイルは書き込まれませんでした。",
@@ -60,6 +69,7 @@ const ja = {
     scriptsSkipped: (keys) => `既存のスクリプトをスキップしました: ${keys.join(", ")}`,
     scriptsCreated: "npm scripts と devDependencies 付きの package.json を作成しました",
     depsAdded: (keys) => `devDependencies を追加しました: ${keys.join(", ")}`,
+    depsUpdated: (keys) => `devDependencies を更新しました: ${keys.join(", ")}`,
     installingSkills: ".agent/skills/ に takt スキルをインストール中...",
     skillInstalled: (name) => `スキルをインストールしました: ${name}`,
     skillSymlinked: (name, target) => `シンボリックリンク作成: ${target}/${name} -> .agent/skills/${name}`,
@@ -67,12 +77,16 @@ const ja = {
     taktRefsInstalled: "takt リファレンスをインストールしました（builtins, docs）",
     taktRefsSkipped: "takt リファレンスは既に存在するためスキップしました",
     taktRefsError: "警告: takt リファレンスのダウンロードに失敗しました。スキルがスタイルガイドを参照できない可能性があります。",
+    fileAdded: (path) => `追加: ${path}`,
+    fileUpdated: (path) => `更新: ${path}`,
+    fileSkippedCustomized: (path) => `スキップ（カスタマイズ済み）: ${path}`,
+    manifestCreated: "インストールマニフェストを作成しました",
     helpText: `使い方: npx create-takt-sdd [オプション]
 
 オプション:
   --tag <version>    インストールするバージョン ("latest", "0.2.0", デフォルト: インストーラのバージョン)
   --lang <en|ja>     メッセージ言語 (デフォルト: en)
-  --force            既存の .takt/ を上書き
+  --force            既存の .takt/ を上書き（マニフェストがある場合は無視）
   --dry-run          プレビューのみ（ファイル書き込みなし）
   --without-skills   takt スキルのインストールをスキップ
   --refs-path <path> takt リファレンスのパス（デフォルト: references/takt）

package/dist/install.js

@@ -1,4 +1,5 @@
 import { execSync } from "node:child_process";
+import { createHash } from "node:crypto";
 import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, symlinkSync, statSync, writeFileSync } from "node:fs";
 import https from "node:https";
 import { createWriteStream } from "node:fs";
@@ -144,9 +145,68 @@ function collectFiles(dir, base) {
     }
     return results;
 }
+const MANIFEST_FILE = ".manifest.json";
+function computeFileHash(filePath) {
+    const content = readFileSync(filePath);
+    return createHash("sha256").update(content).digest("hex");
+}
+function loadManifest(manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(manifestPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function syncDirectory(srcDir, destDir, srcBase, destBase, manifest, msg, cwd) {
+    const files = {};
+    if (!existsSync(srcDir))
+        return { files };
+    const srcFiles = collectFiles(srcDir, srcBase);
+    for (const relFile of srcFiles) {
+        const srcPath = join(srcBase, relFile);
+        const destPath = join(destBase, relFile);
+        const manifestKey = relative(cwd, destPath).split("\\").join("/");
+        const srcHash = computeFileHash(srcPath);
+        files[manifestKey] = srcHash;
+        if (!existsSync(destPath)) {
+            // New file — copy
+            mkdirSync(dirname(destPath), { recursive: true });
+            cpSync(srcPath, destPath);
+            info(msg.fileAdded(manifestKey));
+        }
+        else if (manifest !== null) {
+            const recordedHash = manifest.files[manifestKey];
+            if (recordedHash === undefined) {
+                // File exists but not in manifest (pre-manifest environment)
+                warn(msg.fileSkippedCustomized(manifestKey));
+            }
+            else {
+                const currentHash = computeFileHash(destPath);
+                if (currentHash === recordedHash) {
+                    // User has not modified — safe to overwrite
+                    cpSync(srcPath, destPath);
+                    info(msg.fileUpdated(manifestKey));
+                }
+                else {
+                    // User has customized — skip
+                    warn(msg.fileSkippedCustomized(manifestKey));
+                }
+            }
+        }
+        else {
+            // No manifest, fresh install or force — overwrite
+            cpSync(srcPath, destPath);
+        }
+    }
+    return { files };
+}
 export async function install(options) {
     const msg = getMessages(options.lang);
     const targetPath = join(options.cwd, TARGET_DIR);
+    const manifestPath = join(targetPath, MANIFEST_FILE);
     // tar の存在チェック
     try {
         execSync("which tar", { stdio: "ignore" });
@@ -154,8 +214,11 @@ export async function install(options) {
     catch {
         errorExit(msg.tarNotFound);
     }
-    // 既存ディレクトリチェック
-    if (existsSync(join(targetPath, "pieces")) && !options.force) {
+    // マニフェスト読み込み＆モード判定
+    const manifest = loadManifest(manifestPath);
+    const isUpdate = manifest !== null;
+    const piecesExist = existsSync(join(targetPath, "pieces"));
+    if (!isUpdate && piecesExist && !options.force) {
         errorExit(msg.existsError("npx create-takt-sdd"));
     }
     // ダウンロード
@@ -208,17 +271,19 @@ export async function install(options) {
             info(msg.dryRunSkipped);
             return;
         }
-        // インストール
-        info(msg.installing);
+        // インストール / アップデート
+        info(isUpdate ? msg.updating : msg.installing);
         mkdirSync(targetPath, { recursive: true });
+        const allFiles = {};
         for (const dir of FACET_DIRS) {
             const srcDir = join(extractedTakt, options.lang, dir);
             if (existsSync(srcDir)) {
                 const destDir = join(targetPath, dir);
-                if (existsSync(destDir)) {
+                if (!isUpdate && existsSync(destDir)) {
                     rmSync(destDir, { recursive: true });
                 }
-                cpSync(srcDir, destDir, { recursive: true });
+                const result = syncDirectory(srcDir, destDir, join(extractedTakt, options.lang), targetPath, isUpdate ? manifest : null, msg, options.cwd);
+                Object.assign(allFiles, result.files);
             }
         }
         // .gitignore は takt が初回実行時に自動配置するため、インストーラでは生成しない
@@ -232,20 +297,20 @@ export async function install(options) {
                 const skillSrc = join(extractedSkillsDir, skill);
                 if (!existsSync(skillSrc))
                     continue;
-                const skillDest = join(agentSkillsDir, skill);
-                if (existsSync(skillDest)) {
-                    rmSync(skillDest, { recursive: true });
-                }
-                cpSync(skillSrc, skillDest, { recursive: true });
+                // Prepare a temp copy with language selection applied
+                const skillTmp = join(tmpDir, "skill-prep", skill);
+                if (existsSync(skillTmp))
+                    rmSync(skillTmp, { recursive: true });
+                cpSync(skillSrc, skillTmp, { recursive: true });
                 // Select SKILL.md based on language
-                const skillLangMd = join(skillDest, `SKILL.${options.lang}.md`);
-                const skillMdPath = join(skillDest, "SKILL.md");
+                const skillLangMd = join(skillTmp, `SKILL.${options.lang}.md`);
+                const skillMdPath = join(skillTmp, "SKILL.md");
                 if (existsSync(skillLangMd)) {
                     cpSync(skillLangMd, skillMdPath);
                 }
-                // Remove language-specific SKILL files
+                // Remove language-specific SKILL files from temp
                 for (const l of ["ja", "en"]) {
-                    const langFile = join(skillDest, `SKILL.${l}.md`);
+                    const langFile = join(skillTmp, `SKILL.${l}.md`);
                     if (existsSync(langFile)) {
                         rmSync(langFile);
                     }
@@ -258,6 +323,12 @@ export async function install(options) {
                         writeFileSync(skillMdPath, updated, "utf-8");
                     }
                 }
+                const skillDest = join(agentSkillsDir, skill);
+                if (!isUpdate && existsSync(skillDest)) {
+                    rmSync(skillDest, { recursive: true });
+                }
+                const result = syncDirectory(skillTmp, skillDest, skillTmp, skillDest, isUpdate ? manifest : null, msg, options.cwd);
+                Object.assign(allFiles, result.files);
                 info(msg.skillInstalled(skill));
             }
             // .claude/skills/ と .codex/skills/ にシンボリックリンクを作成
@@ -279,7 +350,10 @@ export async function install(options) {
         // takt リファレンスのダウンロード（スキルが参照するbuiltins等）
         if (!options.withoutSkills) {
             const refsDir = join(options.cwd, options.refsPath);
-            if (!existsSync(join(refsDir, "builtins"))) {
+            const needsRefDownload = isUpdate
+                ? manifest.taktRefHash !== TAKT_REF_HASH
+                : !existsSync(join(refsDir, "builtins"));
+            if (needsRefDownload) {
                 info(msg.downloadingTaktRefs(options.refsPath));
                 const taktTmpDir = mkdtempSync(join(tmpdir(), "takt-refs-"));
                 try {
@@ -292,16 +366,45 @@ export async function install(options) {
                     if (taktExtracted) {
                         const taktRoot = join(taktTmpDir, taktExtracted);
                         mkdirSync(refsDir, { recursive: true });
-                        // builtins/ をコピー
+                        // builtins/ を syncDirectory でコピー
                         const builtinsSrc = join(taktRoot, "builtins");
                         if (existsSync(builtinsSrc)) {
-                            cpSync(builtinsSrc, join(refsDir, "builtins"), { recursive: true });
+                            const builtinsDest = join(refsDir, "builtins");
+                            const result = syncDirectory(builtinsSrc, builtinsDest, builtinsSrc, builtinsDest, isUpdate ? manifest : null, msg, options.cwd);
+                            Object.assign(allFiles, result.files);
                         }
                         // docs/faceted-prompting.ja.md をコピー
                         const fpSrc = join(taktRoot, "docs", "faceted-prompting.ja.md");
                         if (existsSync(fpSrc)) {
-                            mkdirSync(join(refsDir, "docs"), { recursive: true });
-                            cpSync(fpSrc, join(refsDir, "docs", "faceted-prompting.ja.md"));
+                            const docsDir = join(refsDir, "docs");
+                            mkdirSync(docsDir, { recursive: true });
+                            const fpDest = join(docsDir, "faceted-prompting.ja.md");
+                            const fpKey = relative(options.cwd, fpDest).split("\\").join("/");
+                            const fpHash = computeFileHash(fpSrc);
+                            if (!existsSync(fpDest)) {
+                                cpSync(fpSrc, fpDest);
+                                info(msg.fileAdded(fpKey));
+                            }
+                            else if (isUpdate) {
+                                const recordedHash = manifest.files[fpKey];
+                                if (recordedHash === undefined) {
+                                    warn(msg.fileSkippedCustomized(fpKey));
+                                }
+                                else {
+                                    const currentHash = computeFileHash(fpDest);
+                                    if (currentHash === recordedHash) {
+                                        cpSync(fpSrc, fpDest);
+                                        info(msg.fileUpdated(fpKey));
+                                    }
+                                    else {
+                                        warn(msg.fileSkippedCustomized(fpKey));
+                                    }
+                                }
+                            }
+                            else {
+                                cpSync(fpSrc, fpDest);
+                            }
+                            allFiles[fpKey] = fpHash;
                         }
                         info(msg.taktRefsInstalled);
                     }
@@ -318,6 +421,14 @@ export async function install(options) {
             }
             else {
                 info(msg.taktRefsSkipped);
+                // Preserve existing file hashes from manifest for refs
+                if (isUpdate) {
+                    for (const [key, hash] of Object.entries(manifest.files)) {
+                        if (key.startsWith(options.refsPath)) {
+                            allFiles[key] = hash;
+                        }
+                    }
+                }
             }
         }
         // アーカイブの package.json から devDependencies を取得
@@ -349,11 +460,16 @@ export async function install(options) {
             pkg.scripts = scripts;
             const devDeps = pkg.devDependencies ?? {};
             const depsAdded = [];
+            const depsUpdatedKeys = [];
             for (const [key, value] of Object.entries(sddDevDependencies)) {
                 if (devDeps[key] === undefined) {
                     devDeps[key] = value;
                     depsAdded.push(key);
                 }
+                else if (devDeps[key] !== value) {
+                    devDeps[key] = value;
+                    depsUpdatedKeys.push(key);
+                }
             }
             pkg.devDependencies = devDeps;
             writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
@@ -366,6 +482,9 @@ export async function install(options) {
             if (depsAdded.length > 0) {
                 info(msg.depsAdded(depsAdded));
             }
+            if (depsUpdatedKeys.length > 0) {
+                info(msg.depsUpdated(depsUpdatedKeys));
+            }
         }
         else {
             const pkg = {
@@ -376,7 +495,17 @@ export async function install(options) {
             writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
             info(msg.scriptsCreated);
         }
-        info(msg.complete);
+        // マニフェスト書き込み
+        const newManifest = {
+            version: version,
+            installedAt: new Date().toISOString(),
+            lang: options.lang,
+            taktRefHash: TAKT_REF_HASH,
+            files: allFiles,
+        };
+        writeFileSync(manifestPath, JSON.stringify(newManifest, null, 2) + "\n", "utf-8");
+        info(msg.manifestCreated);
+        info(isUpdate ? msg.updateComplete : msg.complete);
         console.log(msg.usageExamples);
         console.log("");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-takt-sdd",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Installer for takt-sdd: Spec-Driven Development workflow for takt",
   "type": "module",
   "bin": {