casebrief

casebrief

長く雑然としたサポートチケットのスレッドを、人が対応できる形に整理します。casebrief は、CaseMargin チケット推論サービス用の小さなクライアントです。チケットの生テキストを渡すと、ケースの構造化された概要（問題は何か、すでに試したこととその結果、重要な背景情報）か、チケットが L2 にエスカレーションできるほど十分に完成しているかを示す準備状況スコアが返されます。十分でない場合は、不足している情報も示します。

マシンの外部に送信されるのは、渡したチケットのテキストだけです。応答はサービスが返したとおりに返されます。処理の過程で切り詰めたり、名前を変更したり、要約したりすることはありません。

設定

次の 2 つの環境変数でクライアントを制御します。

• CASEMARGIN_API_KEY（任意） — 設定すると、すべてのリクエストで Authorization: Bearer <key> として送信されます。未設定でもエラーにはなりません。その場合、概要の生成は匿名の IP 単位の利用枠で実行され、エスカレーションの確認は無料です。
• CASEMARGIN_API_URL（任意） — API のベース URL です。デフォルトは https://casemargin.com/api です（再構成した値です。下記の「エンドポイントの出典」を参照）。

キーに関する安全規則は 1 つです。ベース URL がループバック（localhost、127.0.0.1、::1）以外の非 https オリジンで、キーが設定されている場合、すべてのツールは refusing to send CASEMARGIN_API_KEY over a non-https origin を返してリクエストを行いません。そのため、キーが平文で送信されることはありません。ローカル開発サーバーなど、http のループバックベース URL は許可されます。この再構築版では、チェックは起動時ではなく呼び出しごとに実行されます。そのため、サーバー自体は起動します。これは意図的に明記された、オリジナルからの相違点です。

ツール

• generate_case_brief — チケットスレッドから構造化された概要を生成します。quick_scan（評価、次のステップ、ステータス）、full_brief（現在の問題、実施した対応とその結果、重要な背景情報）、metadata（入力の長さ、概要の長さ、圧縮率）が含まれます。ticket_content は 10～50,000 文字の文字列である必要があります。
• check_escalation_readiness — チケットを L2 にエスカレーションできる状態かを確認します。0～100 の overall_score、readiness 判定、スコア付きの 5 つの dimensions（問題の明確さ、トラブルシューティングの証拠、ビジネスへの影響、次の対応、請求の正当性。それぞれスコアと注記を含みます）、L2 が尋ねる可能性の高い質問（predicted_l2_questions）、チケットにまだ不足している情報（missing_items）を返します。ticket_content は 10～20,000 文字の文字列である必要があります。

長さの検証はリクエストの前に行われ、ツールに応じて ticket_content must be a string of 10 to 50000 characters または ticket_content must be a string of 10 to 20000 characters で失敗します。上流から 2xx 以外の応答が返された場合は casemargin error: HTTP <status>、API に接続できない場合は casemargin unreachable で失敗します。

エンドポイントの出典

オリジナルのサービスの README では、環境変数名、ヘッダーを使ったキーの指定方法、長さの上限と下限、上記の拒否ルールが定められていますが、デフォルトのベース URL と 2 つのリクエストパスは定められていません。これら 3 つは再構成したものであり、その旨を明記しています。

• デフォルトのベース URL https://casemargin.com/api — 再構成した値です。
• POST <base>/case-brief、JSON ボディ {"ticket_content": "..."} — 再構成したものです（generate_case_brief で使用）。
• POST <base>/escalation-readiness、同じ形式のボディ — 再構成したものです（check_escalation_readiness で使用）。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドです。

npx @reneturcios/casebrief generate_case_brief '{"ticket_content":"Customer reports the export fails since Tuesday..."}'
npx @reneturcios/casebrief check_escalation_readiness '{"ticket_content":"Customer reports the export fails since Tuesday..."}'
npx @reneturcios/casebrief --version

出力はツールの結果テキストです（成功時は上流の JSON）。終了コード：成功時は 0、実行時エラー（検証エラー、拒否、上流の失敗を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/casebrief mcp

MCP クライアントの設定（キーは任意です。キーがある場合は、クライアントの環境変数を通じて指定してください）。

{
  "mcpServers": {
    "casebrief": {
      "command": "npx",
      "args": ["-y", "@reneturcios/casebrief", "mcp"],
      "env": {
        "CASEMARGIN_API_KEY": "<your key>"
      }
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/casebrief
docker run --rm ghcr.io/cloudcorprecords/casebrief generate_case_brief '{"ticket_content":"Customer reports the export fails since Tuesday..."}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios