Genesys Archivist

Genesys Cloud Architect フローと、それらが依存するすべてのリソースをキャプチャし、そのキャプチャからビジネスおよび技術ドキュメントを生成します。

2つのコンシューマー、2つの保証:

Archivist はその移行サーバーを構築しません。そのサーバーが消費するデータ契約を保証します。

ステータス

実装前。 フェーズ 0 は未実行です。設計と計画は完了しています。本番コードはまだ存在しません。

アーキテクチャを1段落で

明確な境界線で分離された2つのステージ。ステージ 1（キャプチャ） は Genesys と通信する唯一のコードです。あらゆるタイプのすべてのフローを発見し、定義を取得し、リソース参照グラフを閉包まで辿り、バイナリアセットをダウンロードし、不変のコンテンツハッシュ化されたキャプチャバンドルを封印します。ステージ 2（ドキュメント） はソケットを開きません。バンドルを読み取り、Markdown、SVG ダイアグラム、PDF を生成し、中間に AI ナレーションを挟みます。したがって、ドキュメントの再レンダリングには Genesys API 呼び出しが一切かからず、バンドルは使い捨てのキャッシュではなく公開された契約です。

flowchart TD
    A["AI client"] -->|MCP STDIO| B["MCP adapter"]
    C["archivist CLI"] --> D["Application service"]
    B --> D
    D --> E["Genesys source provider"]
    E --> F["Genesys Cloud"]
    D --> G["Capture bundle (sealed, immutable)"]
    G --> H["Normalize, analyze, document"]
    H --> I["Markdown + diagrams + PDF"]
    G --> J["Future migration server"]

はじめに

npm install
npm run verify        # format + lint + typecheck + test + schema validation

次に、以下の順序で読んでください:

1. CLAUDE.md — ここでコードを書こうとしているすべての人（人間またはエージェント）向けのオリエンテーション。

2. AGENTS.md — 交渉の余地のない境界。違反はリリースブロッカーです。

3. 設計仕様書 — 何をなぜ構築するのか。セクション 2 に、以下の番号付きブループリントドキュメントからの逸脱点が列挙されています。

4. プラン 1: 基盤 — Genesys アクセスを必要としない、タスクごとの TDD タスク12件。

5. フェーズ 0 スパイク — 他のすべてをアンブロックする go/no-go ゲート。

フェーズ 0 は go/no-go ゲート

Genesys アダプターを構築する前に、非本番組織に対して、読み取り専用の OAuth クライアントがページとディビジョンにわたって必要なすべてのフロータイプを列挙できること、ソースパスが公開済みフローを忠実にロードおよびエクスポートできること、プロンプト音声が読み取り専用でダウンロードできること、そして変更権限が不要であることを証明します。スパイク10件、キル基準12件。docs/spikes/ を参照してください。

4つのソースパスが競合しています — Platform API、Archy CLI、Architect Scripting SDK、手動 YAML。どれが勝つかは仮定ではなく、実証的な結果です。

リポジトリ構成

apps/cli               archivist CLI
apps/mcp-server        genesys-archivist MCP STDIO server
packages/domain        contracts and DTOs. Pure: no I/O, no SDK types
packages/application   use cases, run state machines, policy
packages/composition   the one place adapters are wired to interfaces
packages/...           adapters, capture, analysis, documentation, rendering, narrative
schemas/               versioned JSON Schema contracts
fixtures/              sanitized test fixtures. Never real customer configuration
docs/                  blueprint, design spec, plans, ADRs, spikes

依存関係の方向は慣習ではなく ESLint によって強制されます。domain は何もインポートせず、application は domain のみをインポートし、apps/* は薄いままです。

絶対にコミットしない

bundles/、derived/、documentation/、spike-evidence/、または任意の .wav / .mp3。キャプチャバンドルは restricted に分類されます。エンドポイント URL、DID、ルーティングロジック、顧客の PII を含む可能性のあるデータテーブルの行、プロンプト音声が含まれているためです。これらが追跡されている場合、CI はビルドを失敗させます。

用語

対象は Genesys Cloud CX であり、IVR オーサリング製品は Architect です。

フローには flowId やバージョンなどの識別子があります。キュー、プロンプト、データアクション、スケジュール、再利用可能なフローにも識別子があります。これらは秘密の API キーではありません。 Genesys OAuth の client_id と client_secret は統合を認証するものであり、関与する唯一の秘密情報です。このツールは隠された秘密を列挙したり、OAuth クライアントシークレットを復元したり、パスワードをスクレイピングしたり、Genesys の権限をバイパスしたりすることは決してありません。

最初の本番リリースの非目標

• Genesys フローの編集、公開、削除、インポート

• 顧客の秘密情報の復元または列挙

• ライブの発信者データ、録音、文字起こし、過去の実行データの読み取り

• キャプチャデータに対するクエリまたは Q&A ツール

• リモート HTTP ホスティング、git/PR 自動化、スケジューリングデーモン

• 設定から推測できないビジネス意図の主張

ブループリントドキュメント

元の引き継ぎ資料。設計仕様書が上書きしない限り、依然として適用されます。