create-einja-app 0.3.3 → 0.3.4

package/templates/default/.claude/skills/cli-package-specs/SKILL.md

@@ -117,6 +117,7 @@ description: "@einja/dev-cli と create-einja-app のビルド・テンプレー
 |--------|------------|----------|
 | `.envrc` | `.envrc` | env |
 | `.vscode/settings.json` | `.vscode/settings.json` | tools |
+| `package.json`（ルート） | `package.json` | root-config |
 
 ---
 
@@ -127,16 +128,16 @@ description: "@einja/dev-cli と create-einja-app のビルド・テンプレー
 **ファイル**: `packages/cli/src/lib/preset-update/file-copier.ts` L194-195
 
 ```typescript
-// skillsカテゴリの場合、einja-プレフィックスでフィルタリング
-const prefixFilter = mapping.category === "skills" ? "einja-" : undefined;
+// skillsカテゴリの場合、einja-/_einja-プレフィックスでフィルタリング
+const prefixFilter = mapping.category === "skills" ? ["einja-", "_einja-"] : undefined;
 ```
 
-`.claude/skills/` 配下のトップレベルディレクトリのうち、**`einja-` で始まるもののみ**が配布対象。
+`.claude/skills/` 配下のトップレベルディレクトリのうち、**`einja-` または `_einja-` で始まるもの**が配布対象。
 
-- **配布される**: `einja-project-overview/`, `einja-task-commit/`, `einja-skill-creator/` 等
-- **配布されない**: `cli-package-specs/`（このSkill自体）、その他 `einja-` プレフィックスなしのSkill
+- **配布される**: `einja-task-commit/`, `einja-skill-creator/`, `_einja-project-overview/` 等
+- **配布されない**: `cli-package-specs/`（このSkill自体）、その他プレフィックスなしのSkill
 
-`copy-presets.mjs` では個別列挙（L62-101）で同等の制御を実現している。
+`copy-presets.mjs` ではディレクトリを動的スキャンし、`einja-*` / `_einja-*` パターンにマッチするものを個別エントリとしてコピーする。
 
 ### 3.2 `_` プレフィックスフィルタ
 
@@ -205,6 +206,52 @@ const prefixFilter = mapping.category === "skills" ? "einja-" : undefined;
 | project-private に ID 必須 | `project_private_without_id` |
 | ID 重複禁止 | `duplicate_id` |
 
+### 4.5 JSON マージ仕様
+
+**実装**: `packages/cli/src/lib/sync/json-processor.ts`
+**設定**: `.einja-sync.json` の `jsonPaths` フィールド
+
+#### マージモード（ブラックリスト方式）
+
+| モード | 動作 | 用途 |
+|--------|------|------|
+| `managed` | テンプレート値で強制上書き | テンプレートが完全管理するセクション |
+| `project-private` | 完全除外（テンプレートから追加・更新しない） | プロジェクト固有のセクション |
+| デフォルト | base/local/templateの3方向マージ | 上記以外の全パス |
+
+#### ネスト指定
+
+パスはドット区切りでネスト指定可能。`deepMergeWithPaths` の再帰により
+各レベルで jsonPaths チェックが行われる。
+
+例: `"project-private": { "package.json": ["devDependencies.@types/node"] }`
+→ devDependencies 全体は3方向マージ、@types/node のみ除外
+
+#### 設定例
+
+```
+jsonPaths:
+  managed: { ".claude/settings.json": ["plansDirectory"] }
+  project-private: { "package.json": ["name", "version", "private", "workspaces"] }
+```
+
+→ plansDirectory はテンプレート強制上書き
+→ name, version 等は完全除外
+→ scripts, devDependencies 等は3方向マージ
+
+#### base スナップショット
+
+3方向マージには前回sync時のテンプレート内容（base）が必要。
+`.einja-sync.json` の各ファイルメタデータに `baseContent` として保存。
+初回sync（base なし）はローカル優先 + テンプレート新規キーのみ追加。
+
+#### コンフリクト
+
+両方が同じキーを異なる値に変更した場合:
+- ローカル値を保持（安全側）
+- コンソールに警告出力
+- `mergeJson` の戻り値 `conflicts` 配列で呼び出し元にも通知
+
 ---
 
 ## 5. `post-setup.ts` 処理フロー

package/templates/default/CLAUDE.md

@@ -136,7 +136,7 @@
 ## プロジェクト概要
 
 Turborepoモノレポ構成（pnpm workspaces）。詳細が必要な場合は以下のSkillを参照:
-- `einja-project-overview` - 構成、技術スタック、頻出コマンド
+- `_einja-project-overview` - 構成、技術スタック、頻出コマンド
 - `docs/einja/steering/development/coding-standards.md` - コーディング規約、インポートパス規約
 - `einja-infra-maintenance` - 開発環境セットアップ、サーバー管理
 
@@ -231,6 +231,19 @@ Turborepoモノレポ構成（pnpm workspaces）。詳細が必要な場合は
 
 このセクションはテンプレート生成時に除外され、CLIで他リポジトリにコピーされません。
 
+### Skill命名規則（配布制御）
+
+| 区分 | ディレクトリ名 | name フィールド | 配布 |
+|------|--------------|----------------|------|
+| ユーザー向け | `einja-{name}/` | `einja-{name}` | される |
+| インナー（内部参照用） | `_einja-{name}/` | `_einja-{name}` | される |
+| リポジトリ固有 | `{name}/` | `{name}` | されない |
+
+- Skill作成時は `einja-` プレフィックスをつける（配布対象にするため）
+- インナーSkill（他Skillから内部的に参照されるもの）はディレクトリ名に `_einja-` プレフィックスをつける
+- 配布しないリポジトリ固有Skillはプレフィックスをつけない
+- 配布制御は `copy-presets.mjs` がディレクトリ名の `einja-` / `_einja-` プレフィックスで自動判定する
+
 ### キーワードトリガー（専用Skill使用必須）
 
 以下のキーワードを検出したら、**即座に該当Skillを参照**すること：
@@ -240,6 +253,7 @@ Turborepoモノレポ構成（pnpm workspaces）。詳細が必要な場合は
 | `einja cli` `@einja/dev-cli` `create-einja-app` `公開` `リリース` `publish` `release` | `.claude/skills/einja-npm-release/SKILL.md` |
 | `インフラ` `環境変数管理` `Vercel` `Neon` `デプロイ設定` `GitHub Secrets` `環境セットアップ` `ローカルセットアップ` `ローカル環境` `セットアップ` `GitHub Actions` `CI/CD` `ワークフロー` | `.claude/skills/einja-infra-maintenance/SKILL.md` |
 | `Skill作るべき？` `Skill化` `skill-first` `Skill-first` | `.claude/skills/einja-skill-first/SKILL.md` |
+| `prebuild` `copy-presets` `generate-template` `preset:update` `presets/default` `CLAUDE.md.template` `ファイルマッピング` `マーカー仕様` `@einja:excluded` `@einja:managed` `@einja:project-private` `FileCopier` `ビルドパイプライン` `テンプレート仕様` | `.claude/skills/cli-package-specs/SKILL.md` |
 
 ### CLIパッケージの二重管理禁止
 
@@ -249,21 +263,20 @@ Turborepoモノレポ構成（pnpm workspaces）。詳細が必要な場合は
 |-----|---------|------|
 | `.claude/agents/einja/` | `presets/default/.claude/agents/einja/` | 単純コピー |
 | `.claude/commands/einja/` | `presets/default/.claude/commands/einja/` | 単純コピー |
-| `.claude/skills/einja-*/` | `presets/default/.claude/skills/einja-*/` | 単純コピー |
+| `.claude/skills/einja-*/` | `presets/default/.claude/skills/` | `einja-*` / `_einja-*` プレフィックスのディレクトリを自動スキャンしてコピー |
 | `.claude/hooks/einja/` | `presets/default/.claude/hooks/einja/` | 単純コピー |
 | `.claude/settings.json` | `presets/default/.claude/settings.json` | 単純コピー |
 | `.vscode/settings.json` | `presets/default/.vscode/settings.json` | 単純コピー |
 | `docs/einja/` (memory,cli除く) | `presets/default/docs/einja/` | 単純コピー（sync + init対象） |
 | `CLAUDE.md` | `presets/default/CLAUDE.md.template` | **変換生成** |
 | `scripts/` (`_`プレフィクス除く) | `presets/default/scripts/` | 単純コピー |
+| `package.json`（ルート） | `presets/default/package.json` | フルコピー |
 
 **コピー先のファイルは直接編集禁止**（ビルド時に上書きされる）
 
 ### パッケージビルド仕様（テンプレートリポジトリ限定）
 
-`@einja/dev-cli` と `create-einja-app` の2パッケージのビルド・テンプレート仕様については、以下のSkillを参照すること:
-
-`.claude/skills/cli-package-specs/SKILL.md`
+`@einja/dev-cli` と `create-einja-app` の2パッケージのビルド・テンプレート仕様は、上記キーワードトリガーにより `cli-package-specs` Skillが自動参照される。
 
 ### マネージドディレクトリの編集について（テンプレートリポジトリ限定）
 

package/templates/default/docs/plans/glistening-conjuring-cascade.md

@@ -0,0 +1,42 @@
+# Plan: npx コマンドの `@latest` 指定漏れを一括修正
+
+## Context
+
+`npx @einja/dev-cli` を `@latest` なしで実行すると、npxキャッシュの古いバージョンが使われる。`einja:einja-sync` コマンドでv0.1.0が使われてしまった。実行されるコマンド/スクリプト定義を修正する。
+
+## 修正対象
+
+### 1. `.claude/commands/einja/einja-sync.md` (6箇所)
+
+`npx --yes` で実行するコマンドに `@latest` を追加。`replace_all` で一括置換。
+
+| Before | After |
+|--------|-------|
+| `npx --yes @einja/dev-cli sync` (4箇所: 107,159,162,231行) | `npx --yes @einja/dev-cli@latest sync` |
+| `npx --yes create-einja-app sync` (2箇所: 110,165行) | `npx --yes create-einja-app@latest sync` |
+
+**修正しない箇所**: Step 1のCLI検出 (19,20行目) は `npx --no` のまま。目的が「CLIが利用可能か」の検出であり、バージョン不問で検出できる方が適切。実際のsync実行 (Step 3,4) では `--yes @latest` で最新版が使われる。
+
+### 2. `docs/einja/cli/preset.yaml` (2箇所)
+
+下流プロジェクトの `package.json` scripts に反映されるため修正必須。
+
+| 行 | Before | After |
+|----|--------|-------|
+| 127 | `"task:loop": "npx @einja/dev-cli task:loop"` | `"task:loop": "npx @einja/dev-cli@latest task:loop"` |
+| 128 | `"einja:sync": "npx @einja/dev-cli sync"` | `"einja:sync": "npx @einja/dev-cli@latest sync"` |
+
+## 修正不要
+
+| ファイル | 理由 |
+|---------|------|
+| `einja-sync.md` 19,20行 | Step 1のCLI検出。`--no` で検出目的のためバージョン不問 |
+| `package.json` (ルート) | 既に `@latest` 付き |
+| `create-einja-app/src/generators/post-setup.ts` | 既に `@latest` 付き |
+| README.md / docs/plans/ / docs/specs/ 等 | ドキュメント内の説明・例示。直接実行されるコマンドではない |
+
+## 検証
+
+1. grep で `einja-sync.md` 内の `npx --yes` 呼び出しに全て `@latest` が付いていることを確認
+2. `preset.yaml` のscripts定義に `@latest` が付いていることを確認
+3. `pnpm build` して `presets/default/` に変更が反映されることを確認