feat(cli): add --init option and unify config filename to trbconfig.yml

yhk1038 · claude · yhk1038 · commit 941e6d1f3645 · 2025-12-13T11:38:13.000+09:00
- Add `trc --init` command to initialize new t-ruby projects - Creates trbconfig.yml configuration file - Creates src/ and build/ directories - Skips existing files/directories without overwriting - Unify config filename to `trbconfig.yml` across the entire codebase - Changed from `.trb.yml` in implementation - Changed from `trc.yaml` in documentation website - Updated 40+ files including: - Ruby implementation (lib/t_ruby/config.rb) - Tests (spec/t_ruby/config_spec.rb, spec/e2e/integration_spec.rb) - Documentation (CLAUDE.md, .claude/spec/README*.md) - Editor configs (nvim, vim, vscode) - Website docs (t-ruby.github.io) - Bump version to 0.0.8 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
diff --git a/.claude/spec/README.ja.md b/.claude/spec/README.ja.md
@@ -28,7 +28,7 @@ t-rubyはRuby上で動作する**オプショナル/段階的型レイヤー（O
 2. **段階的導入可能** — 部分的な`.trb`導入→プロジェクト全体への移行が可能です。
 3. **TypeScriptレベルのDX** — 型システム、インターフェース、ジェネリクス、ユニオン/インターセクション、推論をサポート；IDE親和的。
 4. **RBS互換性** — t-rubyはRBSスーパーセットを目指し、投影時はRBSスコープに簡素化されます。
-5. **Ruby文化の尊重** — YAMLベース設定（`.trb.yml`）；Ruby開発者に自然な文法。
+5. **Ruby文化の尊重** — YAMLベース設定（`trbconfig.yml`）；Ruby開発者に自然な文法。
 
 ---
 
@@ -40,7 +40,7 @@ t-rubyはRuby上で動作する**オプショナル/段階的型レイヤー（O
 | `.rb` | コンパイル済みRuby | Rubyランタイム用実行出力 |
 | `.rbs` | Rubyシグネチャ | RBSエコシステム連携、保守的な型投影 |
 | `.d.trb` | t-ruby宣言 | t-ruby高度な型を完全保存 |
-| `.trb.yml` | 設定ファイル | t-rubyコンパイル設定 |
+| `trbconfig.yml` | 設定ファイル | t-rubyコンパイル設定 |
 
 ---
 
diff --git a/.claude/spec/README.ko.md b/.claude/spec/README.ko.md
@@ -28,7 +28,7 @@ t-ruby는 Ruby 위에서 동작하는 **선택적 정적 타입 레이어(Option
 2. **점진적 도입 가능** — 부분적 `.trb` 도입 → 전체 프로젝트 전환이 가능합니다.
 3. **TypeScript 수준의 DX** — 타입 시스템, 인터페이스, 제네릭, 유니온/인터섹션, 추론 지원; IDE 친화적.
 4. **RBS 호환성** — t-ruby는 RBS 상위호환을 목표로 하며, 투영 시 RBS 범위로 단순화됩니다.
-5. **Ruby 문화 존중** — YAML 기반 설정 (`.trb.yml`); Ruby 개발자에게 자연스러운 문법.
+5. **Ruby 문화 존중** — YAML 기반 설정 (`trbconfig.yml`); Ruby 개발자에게 자연스러운 문법.
 
 ---
 
@@ -40,7 +40,7 @@ t-ruby는 Ruby 위에서 동작하는 **선택적 정적 타입 레이어(Option
 | `.rb` | 컴파일된 Ruby | Ruby 런타임용 실행 결과물 |
 | `.rbs` | Ruby 시그니처 | RBS 생태계 연동, 보수적 타입 투영 |
 | `.d.trb` | t-ruby 선언 | t-ruby 고급 타입 완전 보존 |
-| `.trb.yml` | 설정 파일 | t-ruby 컴파일 설정 |
+| `trbconfig.yml` | 설정 파일 | t-ruby 컴파일 설정 |
 
 ---
 
diff --git a/.claude/spec/README.md b/.claude/spec/README.md
@@ -28,7 +28,7 @@ The language maintains Ruby's syntax and spirit while introducing TypeScript's d
 2. **Gradual adoption** — Partial `.trb` adoption → full project migration is possible.
 3. **TypeScript-level DX** — Supports type system, interfaces, generics, unions/intersections, inference; IDE-friendly.
 4. **RBS compatibility** — t-ruby aims for RBS superset; types are simplified to RBS scope when projected.
-5. **Respects Ruby culture** — YAML-based config (`.trb.yml`); syntax feels natural to Ruby developers.
+5. **Respects Ruby culture** — YAML-based config (`trbconfig.yml`); syntax feels natural to Ruby developers.
 
 ---
 
@@ -40,7 +40,7 @@ The language maintains Ruby's syntax and spirit while introducing TypeScript's d
 | `.rb` | Compiled Ruby | Executable output for Ruby runtime |
 | `.rbs` | Ruby signature | RBS ecosystem integration, conservative type projection |
 | `.d.trb` | t-ruby declaration | Full t-ruby advanced types preserved |
-| `.trb.yml` | Config file | t-ruby compilation settings |
+| `trbconfig.yml` | Config file | t-ruby compilation settings |
 
 ---
 
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -18,7 +18,7 @@ t-ruby is an experimental typed layer for Ruby, inspired by TypeScript. It compi
 
 - **Source files:** `.trb` - t-ruby source code with type annotations
 - **Compiler:** `trc` - CLI tool that compiles t-ruby to Ruby
-- **Config:** `.trb.yml` - YAML-based project configuration
+- **Config:** `trbconfig.yml` - YAML-based project configuration
 - **Type erasure:** Type annotations are removed when compiling to `.rb`
 - **RBS compatibility:** t-ruby's type system is a superset of RBS; advanced types are simplified when projected to `.rbs`
 
diff --git a/docs/neovim/en/getting-started.md b/docs/neovim/en/getting-started.md
@@ -115,7 +115,7 @@ If you prefer coc.nvim, add to `:CocConfig`:
       "command": "trc",
       "args": ["--lsp"],
       "filetypes": ["truby"],
-      "rootPatterns": [".trb.yml", ".git/"]
+      "rootPatterns": ["trbconfig.yml", ".git/"]
     }
   }
 }
diff --git a/docs/neovim/ja/getting-started.md b/docs/neovim/ja/getting-started.md
@@ -115,7 +115,7 @@ coc.nvimを好む場合は、`:CocConfig`に追加：
       "command": "trc",
       "args": ["--lsp"],
       "filetypes": ["truby"],
-      "rootPatterns": [".trb.yml", ".git/"]
+      "rootPatterns": ["trbconfig.yml", ".git/"]
     }
   }
 }
diff --git a/docs/neovim/ko/getting-started.md b/docs/neovim/ko/getting-started.md
@@ -115,7 +115,7 @@ coc.nvim을 선호한다면 `:CocConfig`에 추가:
       "command": "trc",
       "args": ["--lsp"],
       "filetypes": ["truby"],
-      "rootPatterns": [".trb.yml", ".git/"]
+      "rootPatterns": ["trbconfig.yml", ".git/"]
     }
   }
 }
diff --git a/editors/README.md b/editors/README.md
@@ -123,7 +123,7 @@ Add the contents of `nvim/coc-settings.json` to your coc-settings:
       "command": "trc",
       "args": ["--lsp"],
       "filetypes": ["truby"],
-      "rootPatterns": [".trb.yml", ".git/"]
+      "rootPatterns": ["trbconfig.yml", ".git/"]
     }
   }
 }
diff --git a/editors/nvim/coc-settings.json b/editors/nvim/coc-settings.json
@@ -4,7 +4,7 @@
       "command": "trc",
       "args": ["--lsp"],
       "filetypes": ["truby"],
-      "rootPatterns": [".trb.yml", ".git/"],
+      "rootPatterns": ["trbconfig.yml", ".git/"],
       "initializationOptions": {},
       "settings": {}
     }
diff --git a/editors/nvim/lua/t-ruby-lsp.lua b/editors/nvim/lua/t-ruby-lsp.lua
@@ -9,7 +9,7 @@ M.config = {
     filetypes = { "truby", "trb" },
     root_dir = function(fname)
         local lspconfig = require("lspconfig")
-        return lspconfig.util.root_pattern(".trb.yml", ".git")(fname)
+        return lspconfig.util.root_pattern("trbconfig.yml", ".git")(fname)
             or lspconfig.util.find_git_ancestor(fname)
             or vim.fn.getcwd()
     end,
diff --git a/lib/stdlib_types/index.d.trb b/lib/stdlib_types/index.d.trb
@@ -132,7 +132,7 @@ type NilableBoolean = Boolean | nil
 # 1. Add the stdlib_types directory to your declaration search path
 # 2. Types will be automatically available for type checking
 #
-# Example .trb.yml configuration:
+# Example trbconfig.yml configuration:
 #
 #   paths:
 #     types:
diff --git a/lib/t_ruby/cli.rb b/lib/t_ruby/cli.rb
@@ -7,6 +7,7 @@ class CLI
 
       Usage:
         trc <file.trb>           Compile a .trb file to .rb
+        trc --init               Initialize a new t-ruby project
         trc --watch, -w          Watch input files and recompile on change
         trc --decl <file.trb>    Generate .d.trb declaration file
         trc --lsp                Start LSP server (for IDE integration)
@@ -15,6 +16,7 @@ class CLI
 
       Examples:
         trc hello.trb            Compile hello.trb to build/hello.rb
+        trc --init               Create trbconfig.yml and src/, build/ directories
         trc -w                   Watch all .trb files in current directory
         trc -w src/              Watch all .trb files in src/ directory
         trc --watch hello.trb    Watch specific file for changes
@@ -41,6 +43,11 @@ def run
         return
       end
 
+      if @args.include?("--init")
+        init_project
+        return
+      end
+
       if @args.include?("--lsp")
         start_lsp_server
         return
@@ -63,6 +70,66 @@ def run
 
     private
 
+    def init_project
+      config_file = "trbconfig.yml"
+      src_dir = "src"
+      build_dir = "build"
+
+      created = []
+      skipped = []
+
+      # Create trbconfig.yml
+      if File.exist?(config_file)
+        skipped << config_file
+      else
+        File.write(config_file, <<~YAML)
+          emit:
+            rb: true
+            rbs: false
+            dtrb: false
+
+          paths:
+            src: "./#{src_dir}"
+            out: "./#{build_dir}"
+
+          strict:
+            rbs_compat: true
+            null_safety: false
+            inference: basic
+        YAML
+        created << config_file
+      end
+
+      # Create src/ directory
+      if Dir.exist?(src_dir)
+        skipped << "#{src_dir}/"
+      else
+        Dir.mkdir(src_dir)
+        created << "#{src_dir}/"
+      end
+
+      # Create build/ directory
+      if Dir.exist?(build_dir)
+        skipped << "#{build_dir}/"
+      else
+        Dir.mkdir(build_dir)
+        created << "#{build_dir}/"
+      end
+
+      # Output results
+      if created.any?
+        puts "Created: #{created.join(', ')}"
+      end
+      if skipped.any?
+        puts "Skipped (already exists): #{skipped.join(', ')}"
+      end
+      if created.empty? && skipped.any?
+        puts "Project already initialized."
+      else
+        puts "t-ruby project initialized successfully!"
+      end
+    end
+
     def start_lsp_server
       server = LSPServer.new
       server.run
diff --git a/lib/t_ruby/config.rb b/lib/t_ruby/config.rb
@@ -43,8 +43,8 @@ def src_dir
     def load_config(config_path)
       if config_path && File.exist?(config_path)
         YAML.safe_load_file(config_path, permitted_classes: [Symbol])
-      elsif File.exist?(".trb.yml")
-        YAML.safe_load_file(".trb.yml", permitted_classes: [Symbol])
+      elsif File.exist?("trbconfig.yml")
+        YAML.safe_load_file("trbconfig.yml", permitted_classes: [Symbol])
       else
         DEFAULT_CONFIG.dup
       end
diff --git a/lib/t_ruby/version.rb b/lib/t_ruby/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TRuby
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end
diff --git a/spec/e2e/integration_spec.rb b/spec/e2e/integration_spec.rb
@@ -17,8 +17,8 @@
       lib_dir = File.join(tmpdir, "lib")
       FileUtils.mkdir_p(lib_dir)
 
-      # Create .trb.yml config to set output dir
-      File.write(File.join(tmpdir, ".trb.yml"), <<~YAML)
+      # Create trbconfig.yml config to set output dir
+      File.write(File.join(tmpdir, "trbconfig.yml"), <<~YAML)
         emit:
           rb: true
           rbs: false
@@ -75,7 +75,7 @@ def create_user(email: Email, name: String): User
       TRB
 
       # Compile all files with custom config
-      config = TRuby::Config.new(File.join(tmpdir, ".trb.yml"))
+      config = TRuby::Config.new(File.join(tmpdir, "trbconfig.yml"))
       compiler = TRuby::Compiler.new(config)
 
       trb_files = Dir.glob(File.join(lib_dir, "*.trb"))
@@ -92,8 +92,8 @@ def create_user(email: Email, name: String): User
       lib_dir = File.join(tmpdir, "lib")
       FileUtils.mkdir_p(lib_dir)
 
-      # Create .trb.yml config to set output dir
-      File.write(File.join(tmpdir, ".trb.yml"), <<~YAML)
+      # Create trbconfig.yml config to set output dir
+      File.write(File.join(tmpdir, "trbconfig.yml"), <<~YAML)
         emit:
           rb: true
           rbs: false
@@ -107,7 +107,7 @@ def create_user(email: Email, name: String): User
       file1 = File.join(lib_dir, "file1.trb")
       File.write(file1, "def hello(name: String): String\n  \"Hello, \#{name}\"\nend")
 
-      config = TRuby::Config.new(File.join(tmpdir, ".trb.yml"))
+      config = TRuby::Config.new(File.join(tmpdir, "trbconfig.yml"))
       compiler = TRuby::Compiler.new(config)
       ic = TRuby::IncrementalCompiler.new(compiler)
 
diff --git a/spec/t_ruby/cli_init_spec.rb b/spec/t_ruby/cli_init_spec.rb
@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "fileutils"
+
+describe TRuby::CLI do
+  describe "--init option" do
+    let(:tmpdir) { Dir.mktmpdir("trb_cli_init") }
+
+    after do
+      FileUtils.rm_rf(tmpdir)
+    end
+
+    it "creates trbconfig.yml file" do
+      Dir.chdir(tmpdir) do
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Created:.*trbconfig\.yml/).to_stdout
+
+        expect(File.exist?("trbconfig.yml")).to be true
+
+        config = YAML.safe_load_file("trbconfig.yml")
+        expect(config["emit"]["rb"]).to eq(true)
+        expect(config["emit"]["rbs"]).to eq(false)
+        expect(config["paths"]["src"]).to eq("./src")
+        expect(config["paths"]["out"]).to eq("./build")
+      end
+    end
+
+    it "creates src/ directory" do
+      Dir.chdir(tmpdir) do
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Created:.*src\//).to_stdout
+
+        expect(Dir.exist?("src")).to be true
+      end
+    end
+
+    it "creates build/ directory" do
+      Dir.chdir(tmpdir) do
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Created:.*build\//).to_stdout
+
+        expect(Dir.exist?("build")).to be true
+      end
+    end
+
+    it "does not overwrite existing trbconfig.yml" do
+      Dir.chdir(tmpdir) do
+        File.write("trbconfig.yml", "custom: config\n")
+
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Skipped.*trbconfig\.yml/).to_stdout
+
+        content = File.read("trbconfig.yml")
+        expect(content).to eq("custom: config\n")
+      end
+    end
+
+    it "does not fail if directories already exist" do
+      Dir.chdir(tmpdir) do
+        Dir.mkdir("src")
+        Dir.mkdir("build")
+
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Skipped.*src\//).to_stdout
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Skipped.*build\//).to_stdout
+      end
+    end
+
+    it "reports project already initialized when everything exists" do
+      Dir.chdir(tmpdir) do
+        File.write("trbconfig.yml", "emit:\n  rb: true\n")
+        Dir.mkdir("src")
+        Dir.mkdir("build")
+
+        expect { TRuby::CLI.run(["--init"]) }.to output(/Project already initialized/).to_stdout
+      end
+    end
+
+    it "shows success message when project is initialized" do
+      Dir.chdir(tmpdir) do
+        expect { TRuby::CLI.run(["--init"]) }.to output(/t-ruby project initialized successfully/).to_stdout
+      end
+    end
+  end
+end
diff --git a/spec/t_ruby/config_spec.rb b/spec/t_ruby/config_spec.rb
@@ -7,7 +7,7 @@
 describe TRuby::Config do
   describe "initialization with default config" do
     it "initializes with default configuration when no config file exists" do
-      # Use a temporary directory that doesn't have a .trb.yml
+      # Use a temporary directory that doesn't have a trbconfig.yml
       Dir.mktmpdir do |tmpdir|
         Dir.chdir(tmpdir) do
           config = TRuby::Config.new
@@ -75,10 +75,10 @@
       expect(config.out_dir).to eq("./build")
     end
 
-    it "loads .trb.yml from current directory if it exists" do
+    it "loads trbconfig.yml from current directory if it exists" do
       Dir.mktmpdir do |tmpdir|
         Dir.chdir(tmpdir) do
-          File.write(".trb.yml", <<~YAML)
+          File.write("trbconfig.yml", <<~YAML)
             emit:
               rb: false
               rbs: true
@@ -104,11 +104,11 @@
       end
     end
 
-    it "prefers explicitly passed config path over .trb.yml" do
+    it "prefers explicitly passed config path over trbconfig.yml" do
       Dir.mktmpdir do |tmpdir|
         Dir.chdir(tmpdir) do
-          # Create .trb.yml with one config
-          File.write(".trb.yml", <<~YAML)
+          # Create trbconfig.yml with one config
+          File.write("trbconfig.yml", <<~YAML)
             paths:
               out: ./default_build
           YAML

Original file line number	Diff line number	Diff line change
@@ -115,7 +115,7 @@ If you prefer coc.nvim, add to `:CocConfig`:
`115`	`115`	`"command": "trc",`
`116`	`116`	`"args": ["--lsp"],`
`117`	`117`	`"filetypes": ["truby"],`
`118`		`- "rootPatterns": [".trb.yml", ".git/"]`
	`118`	`+ "rootPatterns": ["trbconfig.yml", ".git/"]`
`119`	`119`	`}`
`120`	`120`	`}`
`121`	`121`	`}`
Original file line number	Diff line number	Diff line change
@@ -115,7 +115,7 @@ coc.nvimを好む場合は、`:CocConfig`に追加：
`115`	`115`	`"command": "trc",`
`116`	`116`	`"args": ["--lsp"],`
`117`	`117`	`"filetypes": ["truby"],`
`118`		`- "rootPatterns": [".trb.yml", ".git/"]`
	`118`	`+ "rootPatterns": ["trbconfig.yml", ".git/"]`
`119`	`119`	`}`
`120`	`120`	`}`
`121`	`121`	`}`
Original file line number	Diff line number	Diff line change
@@ -115,7 +115,7 @@ coc.nvim을 선호한다면 `:CocConfig`에 추가:
`115`	`115`	`"command": "trc",`
`116`	`116`	`"args": ["--lsp"],`
`117`	`117`	`"filetypes": ["truby"],`
`118`		`- "rootPatterns": [".trb.yml", ".git/"]`
	`118`	`+ "rootPatterns": ["trbconfig.yml", ".git/"]`
`119`	`119`	`}`
`120`	`120`	`}`
`121`	`121`	`}`
Original file line number	Diff line number	Diff line change
@@ -123,7 +123,7 @@ Add the contents of `nvim/coc-settings.json` to your coc-settings:
`123`	`123`	`"command": "trc",`
`124`	`124`	`"args": ["--lsp"],`
`125`	`125`	`"filetypes": ["truby"],`
`126`		`- "rootPatterns": [".trb.yml", ".git/"]`
	`126`	`+ "rootPatterns": ["trbconfig.yml", ".git/"]`
`127`	`127`	`}`
`128`	`128`	`}`
`129`	`129`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"command": "trc",`
`5`	`5`	`"args": ["--lsp"],`
`6`	`6`	`"filetypes": ["truby"],`
`7`		`- "rootPatterns": [".trb.yml", ".git/"],`
	`7`	`+ "rootPatterns": ["trbconfig.yml", ".git/"],`
`8`	`8`	`"initializationOptions": {},`
`9`	`9`	`"settings": {}`
`10`	`10`	`}`