create-takt-sdd 0.1.0 → 0.1.3

package/dist/cli.js

@@ -15,6 +15,8 @@ function parseArgs(argv) {
         dryRun: false,
         help: false,
         version: false,
+        tag: undefined,
+        withoutSkills: false,
     };
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
@@ -28,12 +30,24 @@ function parseArgs(argv) {
                 args.lang = value;
                 break;
             }
+            case "--tag": {
+                const value = argv[++i];
+                if (!value) {
+                    console.error('Error: --tag requires a value (e.g. "latest", "0.1.0")');
+                    process.exit(1);
+                }
+                args.tag = value;
+                break;
+            }
             case "--force":
                 args.force = true;
                 break;
             case "--dry-run":
                 args.dryRun = true;
                 break;
+            case "--without-skills":
+                args.withoutSkills = true;
+                break;
             case "-h":
             case "--help":
                 args.help = true;
@@ -65,6 +79,8 @@ async function main() {
         lang: args.lang,
         force: args.force,
         dryRun: args.dryRun,
+        tag: args.tag,
+        withoutSkills: args.withoutSkills,
         cwd: process.cwd(),
     });
 }

package/dist/generated/takt-ref.js

@@ -0,0 +1,2 @@
+// Auto-generated by scripts/embed-takt-ref.js — do not edit
+export const TAKT_REF_HASH = "78dead335de8ae6d5477eac82c581ce8273ccf35";

package/dist/i18n.js

@@ -1,5 +1,6 @@
 const en = {
     downloading: "Downloading takt-sdd...",
+    downloadingVersion: (tag) => `Downloading takt-sdd ${tag}...`,
     installing: "Installing pieces and facets to .takt/...",
     existsError: (cmd) => `.takt/ already exists. To overwrite, run:\n  ${cmd} --force`,
     complete: "Installation complete!",
@@ -9,29 +10,43 @@ const en = {
     taktNotFound: "Warning: takt is not installed. Install it first: https://github.com/nrslib/takt",
     tarNotFound: "Error: tar command is required.",
     archiveError: "Error: .takt/ not found in the downloaded archive.",
+    scriptsAdded: (count) => `Added ${count} npm scripts to package.json`,
+    scriptsSkipped: (keys) => `Skipped existing scripts: ${keys.join(", ")}`,
+    scriptsCreated: "Created package.json with npm scripts",
+    installingSkills: "Installing takt skills to .agent/skills/...",
+    skillInstalled: (name) => `Installed skill: ${name}`,
+    skillSymlinked: (name, target) => `Symlinked ${target}/${name} -> .agent/skills/${name}`,
+    downloadingTaktRefs: "Downloading takt builtins to references/takt/...",
+    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.",
     helpText: `Usage: npx create-takt-sdd [options]
 
 Options:
-  --lang <en|ja>  Message language (default: en)
-  --force         Overwrite existing .takt/ directory
-  --dry-run       Preview without writing files
-  -h, --help      Show this help
-  -v, --version   Show version`,
+  --tag <version>    Version to install ("latest", "0.2.0", default: installer version)
+  --lang <en|ja>     Message language (default: en)
+  --force            Overwrite existing .takt/ directory
+  --dry-run          Preview without writing files
+  --without-skills   Skip installing takt skills to .agent/skills/
+  -h, --help         Show this help
+  -v, --version      Show version`,
     usageExamples: `
   Installed to: .takt/
 
   Usage:
-    takt -w sdd -t "description of requirements"
+    npm run sdd -- "description of requirements"
 
   Run individual phases:
-    takt -w sdd-requirements -t "description of requirements"
-    takt -w sdd-design
-    takt -w sdd-tasks
-    takt -w sdd-impl
-    takt -w sdd-validate-impl`,
+    npm run sdd:requirements -- "description of requirements"
+    npm run sdd:design -- "feature={feature}"
+    npm run sdd:validate-design -- "feature={feature}"
+    npm run sdd:tasks -- "feature={feature}"
+    npm run sdd:impl -- "feature={feature}"
+    npm run sdd:validate-impl -- "feature={feature}"`,
 };
 const ja = {
     downloading: "takt-sdd をダウンロード中...",
+    downloadingVersion: (tag) => `takt-sdd ${tag} をダウンロード中...`,
     installing: ".takt/ にピースとファセットをインストール中...",
     existsError: (cmd) => `.takt/ が既に存在します。上書きするには以下を実行してください:\n  ${cmd} --force`,
     complete: "インストール完了!",
@@ -41,26 +56,39 @@ const ja = {
     taktNotFound: "警告: takt がインストールされていません。先にインストールしてください: https://github.com/nrslib/takt",
     tarNotFound: "エラー: tar コマンドが必要です。",
     archiveError: "エラー: ダウンロードしたアーカイブに .takt/ が見つかりません。",
+    scriptsAdded: (count) => `package.json に ${count} 個の npm scripts を追加しました`,
+    scriptsSkipped: (keys) => `既存のスクリプトをスキップしました: ${keys.join(", ")}`,
+    scriptsCreated: "npm scripts 付きの package.json を作成しました",
+    installingSkills: ".agent/skills/ に takt スキルをインストール中...",
+    skillInstalled: (name) => `スキルをインストールしました: ${name}`,
+    skillSymlinked: (name, target) => `シンボリックリンク作成: ${target}/${name} -> .agent/skills/${name}`,
+    downloadingTaktRefs: "references/takt/ に takt ビルトインをダウンロード中...",
+    taktRefsInstalled: "takt リファレンスをインストールしました（builtins, docs）",
+    taktRefsSkipped: "takt リファレンスは既に存在するためスキップしました",
+    taktRefsError: "警告: takt リファレンスのダウンロードに失敗しました。スキルがスタイルガイドを参照できない可能性があります。",
     helpText: `使い方: npx create-takt-sdd [オプション]
 
 オプション:
-  --lang <en|ja>  メッセージ言語 (デフォルト: en)
-  --force         既存の .takt/ を上書き
-  --dry-run       プレビューのみ（ファイル書き込みなし）
-  -h, --help      ヘルプを表示
-  -v, --version   バージョンを表示`,
+  --tag <version>    インストールするバージョン ("latest", "0.2.0", デフォルト: インストーラのバージョン)
+  --lang <en|ja>     メッセージ言語 (デフォルト: en)
+  --force            既存の .takt/ を上書き
+  --dry-run          プレビューのみ（ファイル書き込みなし）
+  --without-skills   takt スキルのインストールをスキップ
+  -h, --help         ヘルプを表示
+  -v, --version      バージョンを表示`,
     usageExamples: `
   インストール先: .takt/
 
   使い方:
-    takt -w sdd -t "要件の説明"
+    npm run sdd -- "要件の説明"
 
   各フェーズの個別実行:
-    takt -w sdd-requirements -t "要件の説明"
-    takt -w sdd-design
-    takt -w sdd-tasks
-    takt -w sdd-impl
-    takt -w sdd-validate-impl`,
+    npm run sdd:requirements -- "要件の説明"
+    npm run sdd:design -- "feature={feature}"
+    npm run sdd:validate-design -- "feature={feature}"
+    npm run sdd:tasks -- "feature={feature}"
+    npm run sdd:impl -- "feature={feature}"
+    npm run sdd:validate-impl -- "feature={feature}"`,
 };
 const messages = { en, ja };
 export function getMessages(lang) {

package/dist/install.js

@@ -1,13 +1,22 @@
 import { execSync } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, symlinkSync, statSync, writeFileSync } from "node:fs";
 import https from "node:https";
 import { createWriteStream } from "node:fs";
 import { mkdtempSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { join, relative } from "node:path";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { getMessages } from "./i18n.js";
+import { TAKT_REF_HASH } from "./generated/takt-ref.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function getInstallerVersion() {
+    const pkgPath = resolve(__dirname, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return pkg.version;
+}
 const REPO = "j5ik2o/takt-sdd";
-const BRANCH = "main";
+const TAKT_REPO = "nrslib/takt";
 const TARGET_DIR = ".takt";
 const FACET_DIRS = [
     "pieces",
@@ -17,6 +26,28 @@ const FACET_DIRS = [
     "knowledge",
     "output-contracts",
 ];
+const TAKT_SKILLS = [
+    "takt-analyze",
+    "takt-facet",
+    "takt-optimize",
+    "takt-piece",
+];
+const SKILL_SYMLINK_TARGETS = [
+    ".claude/skills",
+    ".codex/skills",
+];
+const SDD_SCRIPTS = {
+    "sdd": "takt --pipeline --skip-git --create-worktree no -w sdd -t",
+    "sdd:requirements": "takt --pipeline --skip-git --create-worktree no -w sdd-requirements -t",
+    "sdd:validate-gap": "takt --pipeline --skip-git --create-worktree no -w sdd-validate-gap -t",
+    "sdd:design": "takt --pipeline --skip-git --create-worktree no -w sdd-design -t",
+    "sdd:validate-design": "takt --pipeline --skip-git --create-worktree no -w sdd-validate-design -t",
+    "sdd:tasks": "takt --pipeline --skip-git --create-worktree no -w sdd-tasks -t",
+    "sdd:impl": "takt --pipeline --skip-git --create-worktree no -w sdd-impl -t",
+    "sdd:validate-impl": "takt --pipeline --skip-git --create-worktree no -w sdd-validate-impl -t",
+    "steering": "takt --pipeline --skip-git --create-worktree no -w steering -t",
+    "steering:custom": "takt --pipeline --skip-git --create-worktree no -w steering-custom -t",
+};
 function info(msg) {
     console.log(`\x1b[1;34m==>\x1b[0m ${msg}`);
 }
@@ -27,6 +58,50 @@ function errorExit(msg) {
     console.error(`\x1b[1;31m==>\x1b[0m ${msg}`);
     return process.exit(1);
 }
+function fetchJson(url) {
+    return new Promise((resolve, reject) => {
+        const request = (targetUrl) => {
+            https
+                .get(targetUrl, { headers: { "User-Agent": "create-takt-sdd" } }, (res) => {
+                if (res.statusCode === 301 || res.statusCode === 302) {
+                    const location = res.headers.location;
+                    if (location) {
+                        request(location);
+                        return;
+                    }
+                }
+                if (res.statusCode !== 200) {
+                    reject(new Error(`Fetch failed: HTTP ${res.statusCode}`));
+                    return;
+                }
+                let data = "";
+                res.on("data", (chunk) => { data += chunk.toString(); });
+                res.on("end", () => resolve(data));
+            })
+                .on("error", reject);
+        };
+        request(url);
+    });
+}
+async function fetchLatestTag() {
+    const data = await fetchJson(`https://api.github.com/repos/${REPO}/releases/latest`);
+    const release = JSON.parse(data);
+    const tagName = release.tag_name;
+    if (!tagName) {
+        throw new Error("No releases found");
+    }
+    return tagName;
+}
+function resolveTag(tagOption, installerVersion) {
+    if (tagOption === undefined) {
+        return `v${installerVersion}`;
+    }
+    if (tagOption === "latest") {
+        return fetchLatestTag();
+    }
+    // Accept both "v0.1.0" and "0.1.0"
+    return tagOption.startsWith("v") ? tagOption : `v${tagOption}`;
+}
 function download(url, dest) {
     return new Promise((resolve, reject) => {
         const file = createWriteStream(dest);
@@ -94,10 +169,14 @@ export async function install(options) {
     const tmpDir = mkdtempSync(join(tmpdir(), "takt-sdd-"));
     const archivePath = join(tmpDir, "archive.tar.gz");
     try {
-        const tarballUrl = `https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz`;
+        const installerVersion = getInstallerVersion();
+        const tag = await resolveTag(options.tag, installerVersion);
+        const version = tag.startsWith("v") ? tag.slice(1) : tag;
+        info(msg.downloadingVersion(tag));
+        const tarballUrl = `https://github.com/${REPO}/archive/refs/tags/${tag}.tar.gz`;
         await download(tarballUrl, archivePath);
         execSync(`tar -xzf "${archivePath}" -C "${tmpDir}"`, { stdio: "ignore" });
-        const extractedDir = join(tmpDir, `takt-sdd-${BRANCH}`);
+        const extractedDir = join(tmpDir, `takt-sdd-${version}`);
         const extractedTakt = join(extractedDir, ".takt");
         if (!existsSync(extractedTakt)) {
             errorExit(msg.archiveError);
@@ -106,16 +185,25 @@ export async function install(options) {
         if (options.dryRun) {
             info(msg.dryRunHeader);
             for (const dir of FACET_DIRS) {
-                const srcDir = join(extractedTakt, dir);
+                const srcDir = join(extractedTakt, options.lang, dir);
                 if (existsSync(srcDir)) {
-                    for (const file of collectFiles(srcDir, extractedTakt)) {
+                    for (const file of collectFiles(srcDir, join(extractedTakt, options.lang))) {
                         console.log(msg.dryRunItem(join(TARGET_DIR, file)));
                     }
                 }
             }
-            const gitignoreSrc = join(extractedTakt, ".gitignore");
-            if (existsSync(gitignoreSrc)) {
-                console.log(msg.dryRunItem(join(TARGET_DIR, ".gitignore")));
+            if (!options.withoutSkills) {
+                for (const skill of TAKT_SKILLS) {
+                    const skillSrc = join(extractedDir, ".agent", "skills", skill);
+                    if (existsSync(skillSrc)) {
+                        for (const file of collectFiles(skillSrc, join(extractedDir, ".agent", "skills"))) {
+                            console.log(msg.dryRunItem(join(".agent", "skills", file)));
+                        }
+                        for (const target of SKILL_SYMLINK_TARGETS) {
+                            console.log(msg.dryRunItem(`${target}/${skill} -> ../../.agent/skills/${skill}`));
+                        }
+                    }
+                }
             }
             console.log("");
             info(msg.dryRunSkipped);
@@ -125,7 +213,7 @@ export async function install(options) {
         info(msg.installing);
         mkdirSync(targetPath, { recursive: true });
         for (const dir of FACET_DIRS) {
-            const srcDir = join(extractedTakt, dir);
+            const srcDir = join(extractedTakt, options.lang, dir);
             if (existsSync(srcDir)) {
                 const destDir = join(targetPath, dir);
                 if (existsSync(destDir)) {
@@ -134,10 +222,116 @@ export async function install(options) {
                 cpSync(srcDir, destDir, { recursive: true });
             }
         }
-        // .gitignore
-        const gitignoreSrc = join(extractedTakt, ".gitignore");
-        if (existsSync(gitignoreSrc)) {
-            cpSync(gitignoreSrc, join(targetPath, ".gitignore"));
+        // .gitignore は takt が初回実行時に自動配置するため、インストーラでは生成しない
+        // takt スキルのインストール
+        const agentSkillsDir = join(options.cwd, ".agent", "skills");
+        const extractedSkillsDir = join(extractedDir, ".agent", "skills");
+        if (!options.withoutSkills && existsSync(extractedSkillsDir)) {
+            info(msg.installingSkills);
+            mkdirSync(agentSkillsDir, { recursive: true });
+            for (const skill of TAKT_SKILLS) {
+                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 });
+                info(msg.skillInstalled(skill));
+            }
+            // .claude/skills/ と .codex/skills/ にシンボリックリンクを作成
+            for (const target of SKILL_SYMLINK_TARGETS) {
+                const targetDir = join(options.cwd, target);
+                mkdirSync(targetDir, { recursive: true });
+                for (const skill of TAKT_SKILLS) {
+                    if (!existsSync(join(agentSkillsDir, skill)))
+                        continue;
+                    const linkPath = join(targetDir, skill);
+                    if (existsSync(linkPath)) {
+                        rmSync(linkPath, { recursive: true });
+                    }
+                    symlinkSync(`../../.agent/skills/${skill}`, linkPath);
+                    info(msg.skillSymlinked(skill, target));
+                }
+            }
+        }
+        // takt リファレンスのダウンロード（スキルが参照するbuiltins等）
+        if (!options.withoutSkills) {
+            const refsDir = join(options.cwd, "references", "takt");
+            if (!existsSync(join(refsDir, "builtins"))) {
+                info(msg.downloadingTaktRefs);
+                const taktTmpDir = mkdtempSync(join(tmpdir(), "takt-refs-"));
+                try {
+                    const taktArchive = join(taktTmpDir, "takt.tar.gz");
+                    const taktTarball = `https://github.com/${TAKT_REPO}/archive/${TAKT_REF_HASH}.tar.gz`;
+                    await download(taktTarball, taktArchive);
+                    execSync(`tar -xzf "${taktArchive}" -C "${taktTmpDir}"`, { stdio: "ignore" });
+                    // takt-{hash}/ ディレクトリを探す
+                    const taktExtracted = readdirSync(taktTmpDir).find((d) => d.startsWith("takt-") && statSync(join(taktTmpDir, d)).isDirectory());
+                    if (taktExtracted) {
+                        const taktRoot = join(taktTmpDir, taktExtracted);
+                        mkdirSync(refsDir, { recursive: true });
+                        // builtins/ をコピー
+                        const builtinsSrc = join(taktRoot, "builtins");
+                        if (existsSync(builtinsSrc)) {
+                            cpSync(builtinsSrc, join(refsDir, "builtins"), { recursive: true });
+                        }
+                        // 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"));
+                        }
+                        info(msg.taktRefsInstalled);
+                    }
+                    else {
+                        warn(msg.taktRefsError);
+                    }
+                }
+                catch {
+                    warn(msg.taktRefsError);
+                }
+                finally {
+                    rmSync(taktTmpDir, { recursive: true, force: true });
+                }
+            }
+            else {
+                info(msg.taktRefsSkipped);
+            }
+        }
+        // package.json に npm scripts を追加
+        const pkgPath = join(options.cwd, "package.json");
+        if (existsSync(pkgPath)) {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            const scripts = pkg.scripts ?? {};
+            const added = [];
+            const skipped = [];
+            for (const [key, value] of Object.entries(SDD_SCRIPTS)) {
+                if (scripts[key] !== undefined) {
+                    skipped.push(key);
+                }
+                else {
+                    scripts[key] = value;
+                    added.push(key);
+                }
+            }
+            pkg.scripts = scripts;
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+            if (added.length > 0) {
+                info(msg.scriptsAdded(added.length));
+            }
+            if (skipped.length > 0) {
+                warn(msg.scriptsSkipped(skipped));
+            }
+        }
+        else {
+            const pkg = {
+                private: true,
+                scripts: { ...SDD_SCRIPTS },
+            };
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+            info(msg.scriptsCreated);
         }
         info(msg.complete);
         console.log(msg.usageExamples);

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "create-takt-sdd",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Installer for takt-sdd: Spec-Driven Development workflow for takt",
   "type": "module",
   "bin": {
     "create-takt-sdd": "./dist/cli.js"
   },
   "scripts": {
-    "build": "tsc && node scripts/add-shebang.js",
+    "build": "node scripts/embed-takt-ref.js && tsc && node scripts/add-shebang.js",
     "prepare": "npm run build"
   },
   "keywords": [
@@ -21,7 +21,7 @@
     "type": "git",
     "url": "https://github.com/j5ik2o/takt-sdd"
   },
-  "license": "MIT",
+  "license": "(MIT OR Apache-2.0)",
   "engines": {
     "node": ">=18"
   },