cursor-sdd 1.0.3 → 1.0.5

package/README.md

@@ -8,7 +8,13 @@ Cursor IDE 向けの Spec-Driven Development (SDD) テンプレート、ルー
 npm install cursor-sdd
 ```
 
-インストール時に自動的にプロジェクトの `.cursor/` フォルダにファイルがコピーされます。
+インストール時に自動的にプロジェクトの `.cursor/` フォルダにファイルがコピーされます。対話可能な環境では「新規のPJを立ち上げる / 既存PJにアサインする」を選択できます。
+
+### モード指定
+
+- 対話プロンプト: `npm install cursor-sdd` 実行時に `new` / `assign` を選択
+- 非対話や CI: `npm install cursor-sdd --mode assign` または環境変数 `CURSOR_SDD_MODE=assign`
+- 省略時デフォルト: `new`
 
 ### 手動セットアップ
 
@@ -33,10 +39,18 @@ Cursor IDE で以下のコマンドが使えるようになります：
 | `/check-design` | 設計のレビュー |
 | `/difference-check` | 差分チェック |
 
+### `/init` の使い分け
+
+- **PJ全体を初期化**: `/init <プロジェクト説明>`
+- **個別画面/機能を初期化**: `/init --feature billing-history <画面の説明>`
+  - `--feature` / `-f` で指定したキーが `.cursor/<PJ名>/<feature>` ディレクトリとして作成されます
+  - 以降の `/requirements` などは `<PJ名>/<feature>` を引数に渡してください（例: `/requirements my-project/billing-history`）
+
 ## 含まれるファイル
 
 ```
 .cursor/
+├── (assign 用の内容をコピーする場合は assign/ 配下がコピーされます)
 ├── commands/          # Cursor コマンド定義
 │   ├── init.md
 │   ├── requirements.md
@@ -63,6 +77,8 @@ Cursor IDE で以下のコマンドが使えるようになります：
         ├── design.md
         ├── tasks.md
         └── research.md
+
+assign モード時に配布したいファイルはリポジトリ直下の `assign/` に配置してください（例: `assign/commands`, `assign/rules`, `assign/templates`）。
 ```
 
 ## ワークフロー
@@ -85,3 +101,4 @@ Cursor IDE で以下のコマンドが使えるようになります：
 MIT
 
 # cursor-sdd-package
+

package/assign/README.md

@@ -0,0 +1,9 @@
+# assign プロファイル
+
+既存プロジェクトにアサインする際のカスタム `.cursor` 一式をここに配置します。
+
+- `assign/commands` … アサイン時専用のコマンド定義
+- `assign/rules` … アサイン時専用のルール
+- `assign/templates` … アサイン時専用のテンプレート
+
+`npm install cursor-sdd --mode assign` あるいは対話選択で `assign` を選ぶと、このフォルダ配下が `.cursor/` にコピーされます。

package/assign/commands/README.md

@@ -0,0 +1,4 @@
+# assign/commands
+
+アサイン時専用の Cursor コマンド定義を置く場所です。
+既定の `/init` などとは別内容にしたい場合、このディレクトリを編集してください。

package/assign/rules/README.md

@@ -0,0 +1,3 @@
+# assign/rules
+
+アサイン時専用のルールを置く場所です。既存プロジェクトのガイドラインに合わせてここを編集してください。

package/assign/templates/README.md

@@ -0,0 +1,3 @@
+# assign/templates
+
+アサイン時専用のテンプレートを置く場所です。不要なら空のままでも構いません。

package/bin/setup.js

@@ -2,6 +2,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 
 const isAuto = process.argv.includes('--auto');
 const isForce = process.argv.includes('--force');
@@ -12,36 +13,34 @@ const packageRoot = path.resolve(__dirname, '..');
 // プロジェクトのルートを取得（node_modules の2つ上）
 function getProjectRoot() {
   let current = process.cwd();
-  
+
   // npm install 経由の場合は INIT_CWD を使用
   if (process.env.INIT_CWD) {
     return process.env.INIT_CWD;
   }
-  
+
   // node_modules から呼ばれた場合
   const nodeModulesIndex = __dirname.indexOf('node_modules');
   if (nodeModulesIndex !== -1) {
     return __dirname.substring(0, nodeModulesIndex);
   }
-  
+
   return current;
 }
 
 const projectRoot = getProjectRoot();
 const targetDir = path.join(projectRoot, '.cursor');
 
-const folders = ['templates', 'rules', 'commands'];
-
 function copyRecursive(src, dest) {
   if (!fs.existsSync(src)) return;
-  
+
   const stat = fs.statSync(src);
-  
+
   if (stat.isDirectory()) {
     if (!fs.existsSync(dest)) {
       fs.mkdirSync(dest, { recursive: true });
     }
-    
+
     for (const item of fs.readdirSync(src)) {
       copyRecursive(path.join(src, item), path.join(dest, item));
     }
@@ -56,24 +55,107 @@ function copyRecursive(src, dest) {
   }
 }
 
-function setup() {
+function getArgValue(flag) {
+  const idx = process.argv.indexOf(flag);
+  if (idx === -1) return null;
+  const next = process.argv[idx + 1];
+  if (!next || next.startsWith('-')) return null;
+  return next;
+}
+
+function normalizeMode(value) {
+  if (!value) return null;
+  const lower = value.toLowerCase();
+  if (lower === 'assign' || lower === 'a') return 'assign';
+  if (lower === 'new' || lower === 'n') return 'new';
+  return null;
+}
+
+function hasTTY() {
+  if (process.stdout.isTTY && process.stdin.isTTY) return true;
+  // npm install 時に stdin がパイプ扱いになる場合のため /dev/tty を確認
+  try {
+    fs.accessSync('/dev/tty', fs.constants.R_OK | fs.constants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function createTTYInterface() {
+  // stdin が非TTYでも /dev/tty を使って対話できるようにする
+  const input = process.stdin.isTTY
+    ? process.stdin
+    : (() => {
+      try {
+        return fs.createReadStream('/dev/tty');
+      } catch {
+        return process.stdin;
+      }
+    })();
+  const output = process.stdout; // 出力は常に標準出力に寄せる
+  return readline.createInterface({ input, output });
+}
+
+function shouldPromptForMode(explicitMode) {
+  return !explicitMode && hasTTY() && !process.env.CI;
+}
+
+async function askMode() {
+  const rl = createTTYInterface();
+  const answer = await new Promise((resolve) => {
+    rl.question('新規PJを立ち上げますか？既存PJにアサインしますか？ [n]ew/[a]ssign (default: new): ', resolve);
+  });
+  rl.close();
+  return normalizeMode(answer) || 'new';
+}
+
+function resolveMode() {
+  const explicitMode = normalizeMode(getArgValue('--mode') || process.env.CURSOR_SDD_MODE);
+  if (explicitMode) return Promise.resolve(explicitMode);
+  if (shouldPromptForMode(explicitMode)) {
+    return askMode();
+  }
+  return Promise.resolve('new');
+}
+
+function getFolders(sourceRoot) {
+  if (!fs.existsSync(sourceRoot)) return [];
+  return fs
+    .readdirSync(sourceRoot)
+    .filter((item) => fs.statSync(path.join(sourceRoot, item)).isDirectory());
+}
+
+function setup({ mode, sourceRoot, folders }) {
   console.log('\n🚀 Setting up Cursor SDD...\n');
-  console.log(`📁 Target: ${targetDir}\n`);
-  
+  console.log(`📁 Target: ${targetDir}`);
+  console.log(`🎚️  Mode: ${mode}\n`);
+
+  // 自動実行時は既存の .cursor がある場合スキップ
+  if (isAuto && fs.existsSync(targetDir) && !isForce) {
+    console.log('ℹ️  .cursor already exists. Run `npx cursor-sdd --force` to overwrite.');
+    process.exit(0);
+  }
+
   // .cursor ディレクトリを作成
   if (!fs.existsSync(targetDir)) {
     fs.mkdirSync(targetDir, { recursive: true });
   }
-  
+
+  if (!folders.length) {
+    console.log(`ℹ️  No folders to copy for mode: ${mode}.`);
+    return;
+  }
+
   // 各フォルダをコピー
   for (const folder of folders) {
-    const src = path.join(packageRoot, folder);
+    const src = path.join(sourceRoot, folder);
     const dest = path.join(targetDir, folder);
-    
+
     console.log(`📂 ${folder}/`);
     copyRecursive(src, dest);
   }
-  
+
   console.log('\n✨ Cursor SDD setup complete!\n');
   console.log('Available commands:');
   console.log('  /init         - Initialize project specs');
@@ -84,11 +166,14 @@ function setup() {
   console.log('  /status       - Check status\n');
 }
 
-// 自動実行時は既存の .cursor がある場合スキップ
-if (isAuto && fs.existsSync(targetDir) && !isForce) {
-  console.log('ℹ️  .cursor already exists. Run `npx cursor-sdd --force` to overwrite.');
-  process.exit(0);
-}
+(async () => {
+  const mode = await resolveMode();
+  const sourceRoot = mode === 'assign' ? path.join(packageRoot, 'assign') : packageRoot;
+  const folders = getFolders(sourceRoot);
 
-setup();
+  setup({ mode, sourceRoot, folders });
+})().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-sdd",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Cursor SDD (Spec-Driven Development) - AI-powered spec templates, rules and commands for Cursor IDE",
   "bin": {
     "cursor-sdd": "./bin/setup.js"
@@ -9,7 +9,8 @@
     "bin",
     "templates",
     "rules",
-    "commands"
+    "commands",
+    "assign"
   ],
   "scripts": {
     "postinstall": "node bin/setup.js --auto"

package/templates/specs/init.json

@@ -1,5 +1,10 @@
 {
+  "project_name": "{{PROJECT_NAME}}",
   "feature_name": "{{FEATURE_NAME}}",
+  "feature_key": "{{FEATURE_KEY}}",
+  "feature_path": "{{FEATURE_PATH}}",
+  "mode": "{{INIT_MODE}}",
+  "project_summary": "{{PROJECT_DESCRIPTION}}",
   "created_at": "{{TIMESTAMP}}",
   "updated_at": "{{TIMESTAMP}}",
   "language": "ja",