@takagaki/cortex-decisions-viewer 0.4.79 → 0.4.80

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/render.js +16 -2
  2. package/package.json +1 -1
package/dist/render.js CHANGED
@@ -4498,8 +4498,19 @@ ${capabilityState.toString()}
4498
4498
  "figma": {
4499
4499
  icon: "🎨",
4500
4500
  title: "Figma のトークン",
4501
- desc: "デザインの画面インベントリを毎晩同期するために使います。",
4502
- how: "Figma Settings → Security → Personal access tokens で発行(file_content:read があれば足ります)",
4501
+ desc: "デザインの画面インベントリと、Figma に付いたコメント(指摘)を毎晩同期するために使います。",
4502
+ // **必要なスコープは実装が叩くAPIから決まる。** sync-designs
4503
+ // GET /v1/files/{key} → file_content:read(画面インベントリ)
4504
+ // GET /v1/files/{key}/comments → file_comments:read(指摘の同期)
4505
+ // の2本だけを呼ぶ。**片方だけだと、もう片方が静かに入ってこない**——
4506
+ // 特に file_comments:read の欠落は「同期は緑なのに指摘だけ増えない」という
4507
+ // 気づきにくい壊れ方をする(コメント同期は後から足した機能で、この案内が追随していなかった)。
4508
+ // 書き込み権限は1つも要らない。files:read(非推奨・広範)は選ばせないこと。
4509
+ how: "Figma → Settings → Security → Personal access tokens で発行。スコープは file_content:read と file_comments:read の2つにチェックを入れてください(どちらも読み取りのみ・書き込み権限は要りません)",
4510
+ // **スコープが正しくても、招待が無いと読めない。** トークンは「そのアカウントが
4511
+ // 見られるファイル」しか読めないので、招待漏れは 404 になる。権限の問題に見えないため
4512
+ // 現場で切り分けに時間がかかる(実際に踏んだ)。入力欄の隣に書いておく。
4513
+ note: "発行したアカウントを、対象の Figma ファイルに閲覧者として招待しておいてください(招待が無いとトークンが正しくても読めません)。",
4503
4514
  },
4504
4515
  "backlog": {
4505
4516
  icon: "📋",
@@ -4639,6 +4650,9 @@ ${capabilityState.toString()}
4639
4650
  ])
4640
4651
  : null,
4641
4652
  el("p", { class: "sec-how", text: meta.how }),
4653
+ // **鍵の作り方に付随する注意(招待漏れ等)。** 発行手順(how)とは別に出す——
4654
+ // 「トークンは正しいのに読めない」は権限の問題に見えないので、切り分けに時間がかかる。
4655
+ meta.note ? el("p", { class: "sec-how", text: meta.note }) : null,
4642
4656
  meta.selfServe ? el("p", { class: "sec-how", text: meta.selfServe.note }) : null,
4643
4657
  input,
4644
4658
  // **扱いの説明はカードに持たせる。** 節の見出しの下に置いていたときは、
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@takagaki/cortex-decisions-viewer",
3
- "version": "0.4.79",
3
+ "version": "0.4.80",
4
4
  "description": "Cortexの意思決定記録(Decisions/*.md)を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,