絶対パスチェッカー

目的

実装コード内に絶対パス（特にHOMEディレクトリを含むパス）が存在しないことを担保し、ポータビリティを確保する。

トリガー条件

以下のトピックについて議論・作業する際に自動的に実行:

•テストの実装・修正
•リファクタリング
•ポータビリティの改善
•ディレクトリ構造・階層の変更

実施手順

1. 絶対パスの検索

実装ファイル（.ts, .js）内で以下のパターンを検索:

bash

# HOME ディレクトリベースの絶対パス
grep -r "/Users/" --include="*.ts" --include="*.js" .
grep -r "/home/" --include="*.ts" --include="*.js" .

# ルートからの絶対パス（設定ファイル以外）
grep -r '"/[a-z]' --include="*.ts" --include="*.js" .

2. 検出結果の判断

検出されたパスが以下のどれに該当するか判断:

種類	対応
実装コード内のリテラル	相対化が必要
テスト結果・ログ出力	許容（ただし、テストの期待値には含めない）
設定ファイルのデフォルト値	環境変数や相対パスに置換
ドキュメント・コメント内の例	許容

3. 相対パスへの変換

優先順位

•
既存の変数を使用: プロジェクトで定義済みの変数があれば使う
- •例: baseDir, projectRoot, Deno.cwd() など

•

import.meta を使用 (Deno/ESM の場合):

typescript

const __dirname = new URL(".", import.meta.url).pathname;
const configPath = join(__dirname, "../config.json");

•

相対パスリテラル:

typescript

// Before
const path = "/Users/dev/project/data/file.txt";

// After
const path = "./data/file.txt";

4. テストの実行

修正後は必ずテストを実行して動作確認:

bash

deno task test

注意事項

•$HOME や ~ を含むパスも絶対パスと同様に扱う
•環境変数から取得したパス（Deno.env.get("HOME") など）は許容
•パスの結合には join() や resolve() を使用し、文字列連結は避ける