feat: add moves

[tkgstrator]

Type

🤖 Generated by PR Agent at c346afb

['Enhancement', 'Documentation', 'Other']

Description

🤖 Generated by PR Agent at c346afb

• Moveモデルを追加し、指し手の処理を強化しました。
• TCSAフォーマットの改善により、指し手をより正確に解析できるようになりました。
• READMEに使用方法を追加し、ユーザーがライブラリを簡単に利用できるようにしました。

Walkthrough

	Relevant files
Enhancement	2 files tsca.ts TCSAフォーマットの改善と指し手処理の追加                                                                      src/format/tsca.ts Moveモデルを追加 chunk関数を追加 answerゲッターを追加し、Moveを使用して指し手を解析 recordゲッターを修正し、指し手を記録に追加 +58/-2    move.dto.ts Moveモデルの追加                                                                                              src/models/move.dto.ts Moveモデルを定義 指し手の開始位置、終了位置、昇格フラグを含む +14/-0
Documentation	1 files README.md READMEに使用方法を追加                                                                                      README.md 使用方法のセクションを追加 コード例を追加 +12/-0
Other	1 files package.json バージョン更新                                                                                                    package.json バージョンを0.0.3に更新 +1/-1

Summary

---

💡 PR-Agent usage:
Comment /help on the PR to get a list of all available PR-Agent tools and their descriptions

[github-actions]

PR Reviewer Guide 🔍

⏱️ Estimated effort to review: 4 🔵🔵🔵🔵⚪

🏅 Score: 85

🧪 PR contains tests

🔒 No security concerns identified

⚡ Key issues to review コードの可読性 chunk関数の実装が少し複雑で、コメントが不足しています。関数の目的や使用方法についての説明を追加すると、他の開発者が理解しやすくなります。 バリデーション Moveモデルのバリデーションが適切に行われているか確認する必要があります。特に、promoteフィールドの値が正しいかどうかのチェックが重要です。

[github-actions]

PR Code Suggestions ✨

Category	Suggestion	Score
Possible issue	Add input validation to the chunk function to prevent invalid sizes Ensure that the chunk function handles cases where the size parameter is zero or negative, as this could lead to unexpected behavior or infinite loops. src/format/tsca.ts [24-30] const chunk = <T>(arr: T[], size: number): T[][] => { + if (size <= 0) throw new Error("Size must be greater than zero"); const results: T[][] = [] for (let i = 0; i < arr.length; i += size) { results.push(arr.slice(i, i + size)) } return results } Suggestion importance[1-10]: 9 Why: This suggestion addresses a potential issue that could lead to runtime errors or infinite loops, making it a crucial improvement for robustness.	9
Possible bug	Add a fallback for object.answercsv to prevent errors when it is undefined Consider checking if object.answercsv is defined before calling split to avoid potential runtime errors. src/format/tsca.ts [82-84] return chunk( - object.answercsv + (object.answercsv || '') .split('_') .filter((value) => value.length > 0) ... Suggestion importance[1-10]: 8 Why: This suggestion helps prevent runtime errors by ensuring that object.answercsv is defined before using it, which is important for maintaining code stability.	8
Enhancement	Enhance validation for the promote property in the Move schema Consider adding a validation for the promote property to ensure it is a boolean before processing moves. src/models/move.dto.ts [13] -promote: z.boolean() +promote: z.boolean().refine(val => typeof val === 'boolean', { + message: "Promote must be a boolean" +}) Suggestion importance[1-10]: 7 Why: This enhancement improves the validation of the promote property, which is beneficial for data integrity, but it is not critical compared to other suggestions.	7
Best practice	Remove the explicit type declaration for record to allow TypeScript to infer the correct type Ensure that the record variable is properly typed to avoid potential type errors when using it later in the code. src/format/tsca.ts [119] -const record: TSRecord | Error = importCSA( +const record = importCSA( Record.parse({ ... Suggestion importance[1-10]: 5 Why: While this suggestion promotes best practices in type safety, removing the explicit type declaration may not significantly enhance the code's functionality or readability.	5