背景

Kyoto.rb Meetup OSS Gate（2026-08-29開催、初心者向けOSS貢献体験ワークショップ）に参加するにあたり、Notionの過去メモを起点に「興味がありそう・実体験があるOSS」を洗い出した。

調査した候補

Ruby系（関西Ruby会議09準備の実体験ベース）

• Doorkeeper: トークンがデフォルト平文保存（hash_token_secretsはオプトイン）という仕様に気づいた実績あり
• modelcontextprotocol/ruby-sdk: MCP::Tool DSLやcontent type実装を読み込んだ実績あり
• OmniAuth / Devise: CSRF・state検証やlockable/trackableマイグレーション要件の詰まりを把握済み

Salesforce / Slack-bot系

• n8n-nodes-base.slack: typeVersion: 2.7でworkflow activate時にCannot read properties of undefined (reading 'execute')エラーになる不具合を実際に踏んで確認（2.4なら問題なし）
• n8nのSalesforce Tool: $fromAIが空文字を返すとフィールドがクリアされる懸念（未検証）
• @kitalive/sfdx-plugin: Kitalive社製のSalesforce CLIプラグイン。MITライセンスのOSSだが、リポジトリ直下にLICENSEファイルが無い。Open issueは無し
• salesforcecli/cli: Issue機能が無効化されており、実issueはforcedotcom/cliに集約。MCP関連issueを2件確認
  • #3625: --assets nullでTypeError → 報告者本人がPR #472で対応中
  • #3624: mcp update --labelが保存されない → 生REST PUTでも再現するためプラットフォーム側バグの可能性が高い
• forcedotcom/sf-skills（旧sf-skills、Salesforce Agent Skills Library）: 946スター、Issue活発、Claude Code plugin対応。未着手の小粒issueが複数あり最有力候補
  • #320: 古いmodal-componentサンプルが、skill自身のドキュメントで非推奨としているlightning/modalを再実装している矛盾
  • #288: fetching-salesforce-docsスキルが記事本文を取得できていない不具合

salesforcecli/plugin-deploy-retrieve のコードリーディング

src/commands/project/retrieve/start.ts（v4.1.2）を読み、sf project retrieve startの内部構造を確認した。

• run()はCLIのオーケストレーション層で、実際のMetadata API呼び出しは@salesforce/source-deploy-retrieve（SDR）に委譲されている
• ComponentSet.retrieve() → MetadataApiRetrieve.start()（MetadataTransfer基底クラスのテンプレートメソッドパターンでpre()/checkStatus()/post()をディスパッチ）→ connection.metadata.retrieve() / checkRetrieveStatus() でSalesforce Metadata API（SOAP）を呼んでいることを、forcedotcom/[email protected]のsrc/client/metadataApiRetrieve.ts・metadataTransfer.tsで特定した

呼び出しフロー

sequenceDiagram
    participant Run as start.ts run()
    participant CS as ComponentSet
    participant MAR as MetadataApiRetrieve
    participant MT as MetadataTransfer(基底)
    participant Conn as connection.metadata (jsforce/SOAP)

    Run->>CS: retrieve(retrieveOpts)
    CS->>MAR: new MetadataApiRetrieve(options)
    CS->>MAR: start()
    Note over MAR,MT: start()はMetadataTransferから継承
    MAR->>MT: (継承) start()
    MT->>MAR: this.pre()
    MAR->>Conn: metadata.retrieve(requestBody)
    Note right of Conn: SOAP retrieve() 呼び出し
    Conn-->>MAR: AsyncResult(id)
    MAR-->>Run: mdapiRetrieve を返す

    Run->>MT: pollStatus()
    loop 完了まで
        MT->>MAR: this.checkStatus()
        MAR->>Conn: metadata.checkRetrieveStatus(id)
        Note right of Conn: SOAP ポーリング
        Conn-->>MAR: MetadataApiRetrieveStatus
    end
    MT->>MAR: this.post(status)
    MAR-->>MT: RetrieveResult
    MT-->>Run: retrieveResult

コードレビューで見つけた気になる点