Resonote

Nostr プロトコルを使ったメディアコメント同期システム。動画・音楽の再生位置にコメントを紐づけて共有。

NIP-73 (External Content IDs) + NIP-22 (Comments, kind:1111) + NIP-25 (Reactions, kind:7) を活用。

特徴

• 再生位置同期コメント — 再生中のメディアの位置を取得し、コメントにタイムスタンプを紐づけ
• 全体コメント — 再生位置に依存しない感想・レビューも投稿可能
• 返信スレッド — コメントへの返信 (NIP-10 スタイルの e タグ参照)、親の再生位置を継承、孤児リプライのプレースホルダー表示
• リアクション — コメントへのリアクション (NIP-25 kind:7)、カスタム絵文字対応
• 投稿削除 — 自分のコメント・リアクションを削除 (NIP-09 kind:5)
• フォロー & Web of Trust — NIP-02 フォローリストによるコメントフィルタリング (all / follows / WoT)
• リレー管理 — kind:10002 リレーリスト + kind:3 フォールバック + 設定 UI
• 通知フィード — 返信・リアクション・メンション・フォロー通知 + WoT フィルタ
• ブックマーク — kind:10003 + NIP-73 i タグ拡張
• ミュートリスト — kind:10000 (NIP-44 暗号化 + NIP-04 fallback)
• プロフィールページ — NIP-05 検証、フォロー一覧展開
• 共有モーダル — 時間付きリンクコピー + Nostr 投稿
• PWA — Service Worker + manifest.webmanifest
• i18n — 日本語 / 英語 (LanguageSwitcher ドロップダウン)
• ブラウザ拡張機能 — Chrome / Firefox 拡張 (Manifest V3) でサイドパネルからコメント

対応プラットフォーム

プラットフォーム	Web 埋め込み	拡張機能が必要
Spotify	✅
YouTube	✅
Vimeo	✅
SoundCloud	✅
Mixcloud	✅
Spreaker	✅
ニコニコ動画	✅
Podbean	✅
音声直 URL	✅
Podcast (RSS)	✅
Netflix		✅
Prime Video		✅
Disney+		✅
Apple Music		✅
Fountain.fm		✅
AbemaTV		✅
TVer		✅
U-NEXT		✅

対応 NIP

公開 claim は以下の canonical matrix に揃える。public はアプリから見える機能、public-interop は互換 fallback、internal / internal-only は runtime-governing な内部責務を表す。

「NIPs 完全準拠 (Scoped Complete Compliance)」の定義および外部プロジェクト（relay-session, NDK, strfry）との比較基準については docs/auftakt/spec.md を参照。

NIP	Target Level	Current Status	Canonical Owner	Proof / Test Anchor	Scope Notes
NIP-01	public	implemented (runtime-owned REQ/replay + EOSE/OK)	packages/runtime/src/relay-session.ts	packages/runtime/src/relay-session.contract.test.ts	Contract tests cover REQ routing/replay, backward EOSE completion, and publish OK acknowledgements. Runtime-governing internals as coordinator behavior only.
NIP-02	public	implemented	src/shared/browser/follows.svelte.ts	src/shared/browser/follows.test.ts src/features/follows/application/follow-actions.test.ts	public follow-list behavior。WoT filtering は kind:3 の上に載る Resonote behavior
NIP-04	public-interop	implemented (interop fallback only)	src/shared/browser/mute.svelte.ts	src/shared/browser/mute.test.ts	private mute-tag 復号の interop fallback。DM 全面対応は主張しない
NIP-05	public	implemented	src/shared/nostr/nip05.ts	src/shared/nostr/nip05.test.ts	profile verification only
NIP-07	public	implemented	src/shared/nostr/client.ts	src/shared/nostr/client-integration.test.ts	browser signer integration via window.nostr
NIP-09	public	implemented	packages/adapter-dexie/src/index.ts	packages/core/src/reconcile.contract.test.ts packages/adapter-dexie/src/materialization.contract.test.ts	package-owned tombstone verification と late-event suppression
NIP-10	public	implemented	src/features/comments/application/comment-actions.ts	src/features/comments/application/comment-actions.test.ts e2e/reply-thread.test.ts	reply threading と parent linkage
NIP-11	internal	implemented (runtime-only bounded support)	packages/runtime/src/relay-session.ts	packages/runtime/src/relay-session.contract.test.ts	runtime-only relay request-limit policy shapes shard queueing and reconnect replay. No public relay metadata surface and no broader NIP-11 discovery claim.
NIP-19	public	implemented	src/features/nip19-resolver/application/resolve-nip19-navigation.ts	src/shared/nostr/nip19-decode.test.ts src/features/nip19-resolver/application/resolve-nip19-navigation.test.ts e2e/nip19-routes.test.ts	standard npub / nprofile / note / nevent を公開対応。ncontent は Resonote-specific extension であり標準 NIP-19 claim には含めない
NIP-22	public	implemented	src/features/comments/application/comment-actions.ts	src/features/comments/application/comment-actions.test.ts	comment kind:1111 publish flow (event construction + publish path)
NIP-25	public	implemented	src/features/comments/application/comment-actions.ts	src/features/comments/application/comment-actions.test.ts	reaction kind:7 publish flow (event construction + publish path)
NIP-44	public	implemented	src/shared/browser/mute.svelte.ts	src/shared/browser/mute.test.ts	encrypted mute/private-tag path
NIP-65	public	implemented	src/shared/browser/relays.svelte.ts	src/shared/browser/relays-fetch.test.ts src/features/relays/application/relay-actions.test.ts	Read path is proven for kind:10002 consumption (created_at latest wins) with intended fallback to kind:3 only when kind:10002 yields no relay entries. Write path is separately proven by kind:10002 publish tests.
NIP-73	public	implemented	src/shared/content/*.ts	src/shared/content/providers.test.ts	canonical external content IDs via provider toNostrTag()
NIP-77	internal-only	implemented (internal-only)	packages/runtime/src/relay-repair.ts	packages/runtime/src/relay-repair.contract.test.ts packages/runtime/src/public-api.contract.test.ts	negentropy repair only。public/package root surfaces は leak-free を維持
NIP-B0	public	implemented	src/server/api/podcast.ts	src/server/api/podcast.test.ts	Resonote bookmark mapping / podcast resolution flow

前提条件

• Node.js >= 24.0.0 (Corepack 同梱)
• pnpm (corepack enable で有効化、バージョンは packageManager フィールドで自動管理)

corepack enable

セットアップ

pnpm install
pnpm run dev

Pages Functions (API) を使う場合:

# .dev.vars に SYSTEM_NOSTR_PRIVKEY を設定
pnpm run dev:full

コマンド

コマンド	説明
pnpm run dev	開発サーバー起動 (http://localhost:5173)
pnpm run dev:full	Vite + Cloudflare Pages Functions
pnpm run build	プロダクションビルド → .svelte-kit/cloudflare/
pnpm run preview	ビルド結果のプレビュー
pnpm run check	svelte-kit sync + 型チェック
pnpm run test:packages	package contract tests
pnpm run check:auftakt-migration	Auftakt retirement proof / guard
pnpm test	単体テスト実行
pnpm test:coverage	カバレッジ付きテスト
pnpm test:e2e	Playwright E2E テスト
pnpm run lint	ESLint
pnpm run format	Prettier フォーマット
pnpm run build:ext:chrome	Chrome 拡張機能ビルド → dist-extension/
pnpm run build:ext:firefox	Firefox 拡張機能ビルド → dist-extension/

技術スタック

• フレームワーク: SvelteKit (SPA モード, Svelte 5 runes)
• アダプタ: @sveltejs/adapter-cloudflare (SSR + API via hooks.server.ts)
• スタイリング: Tailwind CSS v4 (@tailwindcss/vite plugin)
• Nostr ランタイム: Auftakt runtime (@auftakt/core + @auftakt/resonote + @auftakt/adapter-dexie) — interop gateway 退役済み
• 認証: @konemono/nostr-login (init() + nlAuth DOM event)
• NIP ユーティリティ: @auftakt/core codec/signing helpers
• テスト: Vitest (単体) + Playwright (E2E)
• CI: GitHub Actions (format → lint → check → structure → migration proof → package contracts → test → E2E → build-extension)
• ホスティング: Cloudflare Pages
• API: Hono (src/server/api/, SvelteKit hooks.server.ts 経由)

アーキテクチャ

ディレクトリ構成

• src/app/ — app shell / bootstrap
• src/lib/ — presentational component と component-local helper のみ (src/lib/components/ のみ残存)
• src/shared/ — 公開 runtime boundary (browser / nostr / content / i18n / utils)
• src/features/ — feature slice (domain / application / infra / ui) — comments, content-resolution, notifications, profiles, bookmarks, follows, relays, mute, sharing, auth, playback, extension-bridge, nip19-resolver
• src/web/ — SvelteKit エントリーポイント (routes, app.html, app.css)
• src/extension/ — ブラウザ拡張機能 (Chrome/Firefox Manifest V3)
• src/server/ — サーバーサイド API (Hono ルート、ミドルウェア、ユーティリティ)

runtime ownership の基準

• src/shared/* は cross-feature な公開 runtime API
• src/features/* は業務ロジック、アプリケーション処理、view-model
• src/app/* は shell / bootstrap
• src/web/routes/* は thin facade
• src/lib/* は presentation / component-local helper のみ

新しい business logic や infra ownership は src/lib/* に追加しない。 route / component / feature / app は direct store import を避け、$shared/browser/* と $shared/i18n/* の公開面を使う。src/lib/stores/ は削除済み。

新機能の配置ガイド

• cross-feature な browser / nostr / content / utility は src/shared/*
• feature 固有の domain / application / view-model は src/features/<feature>/*
• app shell / bootstrap / session は src/app/*
• route は src/web/routes/* で facade に保つ
• component-local な描画補助だけを src/lib/components/*.ts / *.svelte.ts に置く

構造チェック

最低限、次を通す。

pnpm check
pnpm lint
pnpm test
pnpm check:structure
pnpm graph:imports:summary
pnpm perf:bundle:summary
rg -n '\$lib/stores/.*svelte|../stores/.*svelte' src --glob '!**/*.test.*'
rg -n '\$lib/i18n/(t|locales)\.js|\.\./i18n/(t|locales)\.js' src --glob '!**/*.test.*'

設計方針は CLAUDE.md の Architecture セクションを正とする。

検証コマンド

移行完了と現行 build 状態の確認では、少なくとも次を実行する。

pnpm run check:auftakt-migration -- --proof
pnpm run check:auftakt-migration -- --report consumers
pnpm run check:auftakt-semantic
pnpm run check:auftakt-complete
pnpm run test:packages
pnpm run check
pnpm run build

pnpm run check:auftakt-migration -- --proof および --report consumers が Auftakt retirement の authoritative machine-checkable gate。CI でも同じ proof を artifact として保存する。 より詳細な検証マトリクスについては docs/auftakt/spec.md を参照。

現時点の residual legacy dependency は production では 0。test-only では src/shared/nostr/user-relays.test.ts が退役予定 alias src/shared/nostr/user-relays.ts の回帰確認として残っている。

PR / CI 運用

• PR では .github/PULL_REQUEST_TEMPLATE.md に沿って、配置判断と構造チェックを残す
• ci.yml は import graph artifact と bundle profile artifact を出す
• 構造変更時は pnpm graph:imports:summary、UI / bundle 影響がある変更では pnpm perf:bundle:summary を確認する

性能確認

• pnpm perf:bundle:summary で build 後の raw / gzip サイズを確認する
• pnpm perf:bundle で詳細一覧を出せる
• CI の bundle-profile artifact に、最新 build の bundle summary と file list が残る

Playbook (dev only)

/playbook はコンポーネントの実験場・デモページ。import.meta.env.DEV でガードされており、開発サーバー (pnpm dev) でのみアクセス可能。staging / production ビルドでは 404 になる。

ContentProvider パターン

src/shared/content/types.ts で ContentProvider インターフェースを定義。 各プラットフォームがこのインターフェースを実装し、requiresExtension フラグで Web / 拡張機能の区別を制御。 toNostrTag() で NIP-73 i タグを生成。i タグ形式は platform:type:id で統一。

再生位置同期

1. 各プラットフォームの Widget API / IFrame API で再生位置を取得
2. コメント投稿時に ["position", "秒数"] タグを付与
3. コメント表示時に再生位置 ±30秒 のコメントを絞り込み、±5秒 以内をハイライト
4. タイムスタンプクリックでその位置にシーク

Podcast / Audio 解決

• NIP-B0 (kind:39701) ブックマークで URL→guid マッピング
• フィード解決時に全エピソードの署名済みブックマークを生成
• 音声直 URL: IndexedDB → Nostr d タグ検索 → API auto-discovery の 3 段フォールバック
• guid 解決時: SvelteKit replaceState ($app/navigation) で URL 書き換え + コメントマージ

ブラウザ拡張機能

src/extension/ に Chrome / Firefox 対応の Manifest V3 拡張機能を実装。 コンテンツスクリプトが各動画・音楽サイトの再生位置を取得し、サイドパネル内の Resonote アプリと postMessage で連携。

ライセンス

MIT