1.1 Scaffold the monorepo

[goofmint]

Part of Phase 1 — Core skeleton (tasks.md Task 1.1).

Summary

Set up the Bun workspaces monorepo that every later task builds on: four packages, shared strict TypeScript config, ESLint, bun test wiring, and a minimal CLI entry point.

Details

• Initialize a Bun workspace with packages/api, packages/core, packages/builtin, packages/cli (names @tecode/api, @tecode/core, @tecode/builtin, @tecode/cli).
• Shared tsconfig with strict: true, consistent module/target settings for Bun.
• ESLint configured workspace-wide (the layering rule itself lands in Task 1.2).
• bun test runs across all packages from the repo root.
• packages/cli entry (src/main.ts) parses --version and prints the version, exits 0.

Completion requirements

• bun install at the root resolves all four workspace packages
• bun run packages/cli/src/main.ts --version prints a version and exits 0
• bun test at the root runs (with at least one placeholder test per package) and passes
• bun lint (or equivalent script) passes workspace-wide
• Directory layout matches design.md §2

References

• requirements.md: Req 1.2
• design.md: §2 (Repository and Package Layout)

Dependencies

None (first task).

[goofmint]

@coderabbitai make plan in Japanese

---

Generated by Claude Code

[coderabbitai]

Coding Plan

Summary

• ルートに package.json、共有 strict tsconfig、ESLint を用意し、Bun ワークスペースの土台を作ります。
• design.md §2 のツリーに一致する4パッケージを作り、依存方向（cli → core、core → api、builtin → api、api → 依存なし）を各 package.json に反映します。
• packages/cli/src/main.ts に --version のみを処理する最小エントリを実装します。
• 各パッケージにプレースホルダーテストを追加し、bun install、bun test、bun lint がルートから成功する状態にします。実サービス実装と no-restricted-imports ルールは後続タスクに委ねます。

Design Choices

Design Choice 1: CLI が出力するバージョンの取得元をどうするか

Options Considered:

1. packages/cli/package.json の version フィールドを読み込む。
2. ソースコード内にハードコードした定数を使う。

Chosen Option: 1

Rationale: package.json を単一の情報源とし、後続タスクでの重複と不整合を防ぎます。

💡 User Tips

Regenerate the plan with different choices with @coderabbitai <feedback>.

Implementation Steps

Phase 1: ワークスペースのルート構成

このフェーズはモノレポのルート設定を用意します。共有のビルド、Lint、テストの土台を作ります。すべての後続パッケージがこの設定を継承します。

Task 1: ルートの Bun ワークスペースを定義する

ルートの package.json を作り、ワークスペースを宣言します。

• ルートに package.json を作成します。private: true を設定します。workspaces に ["packages/*"] を設定します。
• ワークスペース全体で使う lint と test のスクリプトを定義します。test は bun test、lint は eslint を実行します。
• 開発依存として ESLint と TypeScript 型（@types/bun）を追加します。

Task 2: 共有の strict な TypeScript 設定を用意する

ルートに共有 tsconfig を作成します。全パッケージが継承します。

• ルートに tsconfig.json を作成します。strict: true を設定します。
• Bun 実行環境向けの一貫した設定を適用します。module: "Preserve"、moduleResolution: "bundler"、target: "ESNext"、types: ["bun"]、noEmit: true、skipLibCheck: true を含めます。
• 各パッケージの tsconfig.json はこのルート設定を extends で継承します。

Task 3: ワークスペース全体の ESLint を設定する

ESLint 設定をルートに用意します。レイヤリングルール自体は Task 1.2（tasks.md）に委ねます。

• ルートに ESLint 設定ファイルを作成します。TypeScript を対象にします。
• 基本ルールのみを有効にします。no-restricted-imports のレイヤリングルールはこの時点では追加しません。
• bun lint がルートから全パッケージのソースを対象に実行できることを確認します。

🤖 Prompt for AI agents

モノレポのルート設定を実装します。目的は、共有のビルド、Lint、テストの土台を作り、すべての後続パッケージがこの設定を継承できるようにすることです。

1. ルートの Bun ワークスペースを定義します。
- ルートに `package.json` を作成します。`private: true` を設定します。
- `workspaces` フィールドに `["packages/*"]` を設定します。
- `test` スクリプトを定義し、`bun test` を実行するようにします。
- `lint` スクリプトを定義し、`eslint` を実行するようにします。
- 開発依存として ESLint と `@types/bun` を追加します。

2. 共有の strict な TypeScript 設定を用意します。
- ルートに `tsconfig.json` を作成します。`strict: true` を設定します。
- 次の設定を含めます: `module: "Preserve"`、`moduleResolution: "bundler"`、`target:
"ESNext"`、`types: ["bun"]`、`noEmit: true`、`skipLibCheck: true`。
- 各パッケージの `tsconfig.json` はこのルート設定を `extends` で継承する構成にします。

3. ワークスペース全体の ESLint を設定します。
- ルートに ESLint 設定ファイルを作成します。TypeScript を対象にします。
- 基本ルールのみを有効にします。`no-restricted-imports` のレイヤリングルールはこの時点では追加しません。
- `bun lint` がルートから全パッケージのソースを対象に実行できることを確認します。

Phase 2: 各パッケージのスキャフォールド

このフェーズは design.md §2 のツリーに一致する4パッケージのディレクトリと manifest を作ります。依存方向を package.json に反映します。実装は入れず、最小の土台のみを用意します。

Task 1: `@tecode/api` パッケージを作成する

型定義のみのパッケージを用意します。ランタイム依存はゼロです。

• packages/api/ を作成します。package.json の name を @tecode/api にします。dependencies は空にします。
• packages/api/src/ を作成します。型定義の実体は Task 1.2（tasks.md）に委ねるため、最小のプレースホルダー export のみを置きます。
• ルートの共有 tsconfig を継承する tsconfig.json を追加します。

Task 2: `@tecode/core` パッケージを作成する

API を実装する土台を用意します。design.md §2 の内部 src/ 構造を作ります。

• packages/core/ を作成します。package.json の name を @tecode/core にします。@tecode/api を workspace:* で依存に追加します。
• design.md §2 に従い、src/host/、src/commands/、src/keymap/、src/buffer/、src/ui/、src/config/、src/api/ の各ディレクトリを作成します。各ディレクトリに最小のプレースホルダーを置きます。
• ルートの共有 tsconfig を継承する tsconfig.json を追加します。

Task 3: `@tecode/builtin` パッケージを作成する

バンドル拡張の土台を用意します。拡張ごとのサブディレクトリを作ります。

• packages/builtin/ を作成します。package.json の name を @tecode/builtin にします。@tecode/api のみを依存に追加します。@tecode/core は依存に追加しません。
• design.md §2 に従い、explorer/、editor-core/、command-palette/、themes-default/、languages-basic/、statusbar/、keybindings-editor/ の各ディレクトリを作成します。各ディレクトリに最小のプレースホルダーを置きます。
• ルートの共有 tsconfig を継承する tsconfig.json を追加します。

Task 4: `@tecode/cli` パッケージを作成する

配線とエントリの土台を用意します。core を import できる唯一のパッケージです。

• packages/cli/ を作成します。package.json の name を @tecode/cli にします。version フィールドを設定します。@tecode/core を workspace:* で依存に追加します。
• packages/cli/src/ を作成します。エントリの実体は Task 2.5 で追加します。
• ルートの共有 tsconfig を継承する tsconfig.json を追加します。

🤖 Prompt for AI agents

design.md §2 のツリーに一致する4パッケージのディレクトリと manifest を作成します。目的は、依存方向を package.json
に反映し、実装を含まない最小の土台を用意することです。

1. `@tecode/api` パッケージを作成します。
- `packages/api/` を作成します。`package.json` の `name` を `@tecode/api`
にします。`dependencies` は空にします。
- `packages/api/src/` を作成し、最小のプレースホルダー export のみを置きます。型定義の実体はこのフェーズでは実装しません。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

2. `@tecode/core` パッケージを作成します。
- `packages/core/` を作成します。`package.json` の `name` を `@tecode/core`
にします。`@tecode/api` を `workspace:*` で依存に追加します。
- design.md §2
に従い、`src/host/`、`src/commands/`、`src/keymap/`、`src/buffer/`、`src/ui/`、`src/config/`、`src/api/`
の各ディレクトリを作成し、各ディレクトリに最小のプレースホルダーを置きます。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

3. `@tecode/builtin` パッケージを作成します。
- `packages/builtin/` を作成します。`package.json` の `name` を `@tecode/builtin`
にします。`@tecode/api` のみを依存に追加します。`@tecode/core` は依存に追加しません。
- design.md §2
に従い、`explorer/`、`editor-core/`、`command-palette/`、`themes-default/`、`languages-basic/`、`statusbar/`、`keybindings-editor/`
の各ディレクトリを作成し、各ディレクトリに最小のプレースホルダーを置きます。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

4. `@tecode/cli` パッケージを作成します。
- `packages/cli/` を作成します。`package.json` の `name` を `@tecode/cli` にします。`version`
フィールドを設定します。`@tecode/core` を `workspace:*` で依存に追加します。
- `packages/cli/src/` を作成します。エントリの実体はこのフェーズでは追加しません。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

Phase 3: CLI エントリとプレースホルダーテスト

このフェーズは最小の CLI 動作を実装します。各パッケージにプレースホルダーテストを追加し、bun test がルートから通ることを確認します。

Task 1: CLI エントリを実装する

--version を処理する最小のエントリを作ります。起動やargvの完全な処理は Task 1.15（tasks.md）に委ねます。

• packages/cli/src/main.ts を作成します。
• --version 引数を検出します。--version がある場合はバージョンを出力し、終了コード 0 で終了します。
• バージョンは packages/cli/package.json の version から取得します。
• --version 以外の引数処理は追加しません。それらは後続タスクに委ねます。

Task 2: 各パッケージにプレースホルダーテストを追加する

bun test がルートから実行できることを確認します。

• 4パッケージそれぞれに最小のテストファイルを1つ追加します。各テストは常に成功する単純なアサーションを含めます。
• ルートで bun test を実行し、全パッケージのテストが検出されて成功することを確認します。
• ルートで bun lint を実行し、ワークスペース全体で Lint が成功することを確認します。

🤖 Prompt for AI agents

最小の CLI 動作を実装し、各パッケージにプレースホルダーテストを追加します。目的は、`bun test` がルートから成功する状態を確認することです。

1. CLI エントリを実装します。
- `packages/cli/src/main.ts` を作成します。
- `--version` 引数を検出する処理を実装します。`--version` がある場合はバージョンを出力し、終了コード 0 で終了します。
- バージョンは `packages/cli/package.json` の `version` フィールドから取得します。
- `--version` 以外の引数処理は追加しません。それらは後続タスクに委ねます。

2. 各パッケージにプレースホルダーテストを追加します。
-
4パッケージ（`@tecode/api`、`@tecode/core`、`@tecode/builtin`、`@tecode/cli`）それぞれに最小のテストファイルを1つ追加します。各テストは常に成功する単純なアサーションを含めます。
- ルートで `bun test` を実行し、全パッケージのテストが検出されて成功することを確認します。
- ルートで `bun lint` を実行し、ワークスペース全体で Lint が成功することを確認します。

Research

このリポジトリは design.md、requirements.md、tasks.md の仕様のみが存在する初期状態です。design.md §2 は packages/api、packages/core、packages/builtin、packages/cli の構成を定義します。

core のみ内部の src/ 構造（host、commands、keymap、buffer、ui、config、api）を持ちます。builtin は拡張ごとのサブディレクトリを持ちます。

依存方向は次のとおりです。

• cli → core
• core → api
• builtin → api（型のみ）
• api → 依存なし

本チケットはこの構成の土台を作る最初のタスクです。実際のサービス実装は Task 1.3 以降に委ねます。

---

🚀 Next Steps

🤖 All AI agent prompts combined

Task: 1

モノレポのルート設定を実装します。目的は、共有のビルド、Lint、テストの土台を作り、すべての後続パッケージがこの設定を継承できるようにすることです。

1. ルートの Bun ワークスペースを定義します。
- ルートに `package.json` を作成します。`private: true` を設定します。
- `workspaces` フィールドに `["packages/*"]` を設定します。
- `test` スクリプトを定義し、`bun test` を実行するようにします。
- `lint` スクリプトを定義し、`eslint` を実行するようにします。
- 開発依存として ESLint と `@types/bun` を追加します。

2. 共有の strict な TypeScript 設定を用意します。
- ルートに `tsconfig.json` を作成します。`strict: true` を設定します。
- 次の設定を含めます: `module: "Preserve"`、`moduleResolution: "bundler"`、`target:
"ESNext"`、`types: ["bun"]`、`noEmit: true`、`skipLibCheck: true`。
- 各パッケージの `tsconfig.json` はこのルート設定を `extends` で継承する構成にします。

3. ワークスペース全体の ESLint を設定します。
- ルートに ESLint 設定ファイルを作成します。TypeScript を対象にします。
- 基本ルールのみを有効にします。`no-restricted-imports` のレイヤリングルールはこの時点では追加しません。
- `bun lint` がルートから全パッケージのソースを対象に実行できることを確認します。
===============================================================================

Task: 2

design.md §2 のツリーに一致する4パッケージのディレクトリと manifest を作成します。目的は、依存方向を package.json
に反映し、実装を含まない最小の土台を用意することです。

1. `@tecode/api` パッケージを作成します。
- `packages/api/` を作成します。`package.json` の `name` を `@tecode/api`
にします。`dependencies` は空にします。
- `packages/api/src/` を作成し、最小のプレースホルダー export のみを置きます。型定義の実体はこのフェーズでは実装しません。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

2. `@tecode/core` パッケージを作成します。
- `packages/core/` を作成します。`package.json` の `name` を `@tecode/core`
にします。`@tecode/api` を `workspace:*` で依存に追加します。
- design.md §2
に従い、`src/host/`、`src/commands/`、`src/keymap/`、`src/buffer/`、`src/ui/`、`src/config/`、`src/api/`
の各ディレクトリを作成し、各ディレクトリに最小のプレースホルダーを置きます。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

3. `@tecode/builtin` パッケージを作成します。
- `packages/builtin/` を作成します。`package.json` の `name` を `@tecode/builtin`
にします。`@tecode/api` のみを依存に追加します。`@tecode/core` は依存に追加しません。
- design.md §2
に従い、`explorer/`、`editor-core/`、`command-palette/`、`themes-default/`、`languages-basic/`、`statusbar/`、`keybindings-editor/`
の各ディレクトリを作成し、各ディレクトリに最小のプレースホルダーを置きます。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。

4. `@tecode/cli` パッケージを作成します。
- `packages/cli/` を作成します。`package.json` の `name` を `@tecode/cli` にします。`version`
フィールドを設定します。`@tecode/core` を `workspace:*` で依存に追加します。
- `packages/cli/src/` を作成します。エントリの実体はこのフェーズでは追加しません。
- ルートの共有 `tsconfig` を継承する `tsconfig.json` を追加します。
===============================================================================

Task: 3

最小の CLI 動作を実装し、各パッケージにプレースホルダーテストを追加します。目的は、`bun test` がルートから成功する状態を確認することです。

1. CLI エントリを実装します。
- `packages/cli/src/main.ts` を作成します。
- `--version` 引数を検出する処理を実装します。`--version` がある場合はバージョンを出力し、終了コード 0 で終了します。
- バージョンは `packages/cli/package.json` の `version` フィールドから取得します。
- `--version` 以外の引数処理は追加しません。それらは後続タスクに委ねます。

2. 各パッケージにプレースホルダーテストを追加します。
-
4パッケージ（`@tecode/api`、`@tecode/core`、`@tecode/builtin`、`@tecode/cli`）それぞれに最小のテストファイルを1つ追加します。各テストは常に成功する単純なアサーションを含めます。
- ルートで `bun test` を実行し、全パッケージのテストが検出されて成功することを確認します。
- ルートで `bun lint` を実行し、ワークスペース全体で Lint が成功することを確認します。

💡 Iterate on the plan with: `@coderabbitai` <feedback>

Example Feedback
- `@coderabbitai` You can skip phase 3. Add a simple unit test case for phase 2.
- `@coderabbitai` For design choice 1 go ahead with option 3 and replan.

---