groove-utilities-memory-promises

groove-utilities-memory-promises

$ARGUMENTS が指定されている場合はそのテキストを約束の内容として使用します。指定されていない場合は、次のフラグを使用します。

• --list：未解決の約束をすべて表示します
• --resolve <N>：約束 N を解決済みとしてマークします

成果

セッション中に先送りした項目を忘れる前に記録するか、既存の未解決の約束を確認して解決します。

受け入れ基準

• 新しい約束が日付と任意のコンテキストとともに記録される
• --list ですべての未解決の約束が明確に番号付きで表示される
• --resolve N で約束 N が解決済みとしてマークされる

タスクのバックエンド

.groove/index.md から tasks.backend を読み取ります。約束は、設定されたバックエンドでタスクとして管理されます。タスクのバックエンドが設定されていない場合（tasks.backend: none）、先に /groove-utilities-task-install を実行するようユーザーに伝えてください。

約束は、共有の「Groove Memory」マイルストーン → 「Promises」エピックの階層下にタスクとして保存されます。これにより、約束が整理され、メインの作業タスクリストに混在しなくなります。

親階層を確保する

操作を行う前に、親エピックを検索するか作成します。

1. 「Groove Memory」マイルストーンを検索または作成します。
   • beans list -t milestone --search "Groove Memory" -q — 出力が空でなければ最初の ID を使用します。空の場合は beans create "Groove Memory" -t milestone を実行し、新しい ID を取得します。
2. そのマイルストーンの下に「Promises」エピックを検索または作成します。
   • beans list -t epic --parent <milestone-id> --search "Promises" -q — 出力が空でなければ最初の ID を使用します。空の場合は beans create "Promises" -t epic --parent <milestone-id> を実行し、新しい ID を取得します。

すべての約束タスクの <parent-id> として Promises エピックの ID を使用します。

--list

1. <parent-id> を解決します（上記を参照）。
2. beans list --parent <parent-id> -s todo -t task
3. 番号付きリストとして表示します。形式：1. [<id>] <title> — 番号は --resolve N 用、角括弧内は beans ID です。
4. 空の場合は、"No open promises." と出力します。

--resolve <N>

1. <parent-id> を解決し、beans list --parent <parent-id> -s todo -t task を実行します。
2. N 番目の項目を検索します。見つからない場合は、"No open promise #N" と出力して終了します。
3. beans update <id> -s completed
4. 次のメッセージで確認します："Promise #N resolved."

デフォルト — 約束を追加する

1. <parent-id> を解決します（上記を参照）。
2. $ARGUMENTS が指定されている場合はそこから約束のテキストを取得します。指定されていない場合は、"What's being deferred?" と尋ねます。
3. 任意で "Any context? (enter to skip)" と尋ねます。
4. beans create "<text>" -t task --parent <parent-id> -s todo -p deferred
5. コンテキストが指定された場合は、beans update <id> -d "<context>" を実行します。
6. 次のメッセージで確認します："Promise captured: [] "

制約

• 呼び出しのたびに、最初に .groove/index.md から tasks.backend を読み取ります。
• 設定済みのタスクバックエンドが必要です。tasks.backend: none の場合は、ユーザーにインストールを促します。
• ユーザーの確認なしに約束を自動で記録してはいけません。必ず明示的な確認を行います。
• マイルストーン／エピックの親階層は冪等にします。作成前に必ず確認し、重複して作成してはいけません。
• 未解決には -s todo、解決済みには -s completed、現在進行中の作業ではないことを示すには -p deferred を使用します。
• すべての約束を自動で解決してはいけません。ユーザーが --resolve-all を求めない限り、一度に 1 件ずつ解決します。
• --resolve-all では、実行前に "Resolve all N open promises?" と確認する必要があります。