feat: initial public release (MAESTRO)

2026-06-03 05:08:00 +00:00
commit f5c7666f6b
823 changed files with 184150 additions and 0 deletions
@@ -0,0 +1,43 @@
+# UpdateDashboardWidget
+
+ユーザーの個人ダッシュボード (Side Info Panel) の Markdown widget を upsert するツール。
+
+## いつ使う
+
+- ユーザーから「ダッシュボードにメモして」「news タブを更新して」などと頼まれたとき
+- 長期的に残したい情報 (ニュース要約、TODO、参照リンク) を残すよう指示されたとき
+- 1 タスク内の一時メモには使わない (それは task のコメントに書く)
+
+## 引数
+
+| name | required | 説明 |
+|---|---|---|
+| `slug` | yes | Widget の安定 ID。kebab-case (`memo`, `news`, `todo`)、32 文字以内 |
+| `content` | yes | Markdown 本文。64KB まで |
+| `title` | 新規 slug では必須 | 表示タイトル。既存 slug を更新するときは省略可（既存タイトル維持） |
+| `mode` | optional | `replace` (default) または `append` |
+
+## 挙動
+
+- 同じユーザーの `slug` が既に存在 → 更新
+- 存在しない → 新規作成 (title 必須)
+- `mode='append'` → 既存 content の末尾に `\n\n` 区切りで追記
+
+## ワークフロー例
+
+「最新のテック関連ニュースを news タブにまとめておいて」:
+
+1. `WebFetch` などでニュースを収集
+2. Markdown でまとめて
+3. `UpdateDashboardWidget({ slug: "news", title: "ニュース", content: "<markdown>" })` を呼ぶ
+4. ユーザーには「ダッシュボードの news タブに反映しました」と返す
+
+## gotcha
+
+- `slug` は user スコープでユニーク。他ユーザーの slug と衝突は起きない
+- 書き込み先は実行中タスクの owner の dashboard。共有タスクでも他人の dashboard には書かない
+- 1 度書いた slug の title は更新できない (新しいタイトルにしたい場合は UI から行うか、新 slug を切る)
+- 64KB を超える content は失敗する → 古いログを切り詰めるか、append ではなく replace でローテーション
+
+## 関連
+