Signal Foundry
ドキュメント
サポート 戻る
ドキュメントユースケースAPI リファレンスリリースノート

すべてのリリースノート

最近の更新2026
変更履歴

最近の更新

CLI、Skills、API、データソース、課金・クレジットまわりの変更を、社内AIと人間が同じ前提で追えるようにまとめます。

2026年5月19日

CLI auth show の credential 表示を整理しました

2026年5月19日に、OAuth token を API key preview として表示しないようにし、credential type と preview を分けました。

sf auth show --json の認証状態表示を整理しました。

これまで通常の OAuth login を使っている場合でも、実際には OAuth access token の preview が effectiveApiKeyPreview に出ていました。動作上の問題はありませんでしたが、API key を使っているように見えて紛らわしい状態でした。

変わったこと

  • OAuth login の場合は effectiveCredentialType: "oauth_access_token" を返します
  • 実際に使われる credential は effectiveCredentialPreview に出します
  • effectiveApiKeyPreview は、本当に API key が有効な場合だけ値を返します

OAuth login の通常状態では、次のようになります。

{
  "authMode": "oauth",
  "effectiveCredentialType": "oauth_access_token",
  "effectiveCredentialPreview": "eyJhbG...abcd",
  "effectiveApiKeyPreview": null,
  "oauth": {
    "tokenAvailable": true,
    "tokenStore": "keychain"
  }
}

CLI onboarding の通常導線は引き続き sf login --base-url https://signal-foundry.app です。API key は直接 API や backend job 用の secret store で管理してください。

2026年5月18日

公開 docs の初回導線を整理しました

2026年5月18日に、公開 docs の入口を install、quick start、company_id、data provenance に絞り、不要な回遊を減らしました。

公開 docs の初回導線を、Signal Foundry を最短で試すためのページに絞りました。agent が読む /llms.txt と、人が読む Getting Started / Quick Start / install 手順も同じ方向に揃えています。

主な更新

  • Getting Started に agent-native workflow の図を追加しました
  • install-sf-cli を GitHub Release artifact、Homebrew、winget の現行導線に整理しました
  • quick-start を初回成功に絞り、余分な分岐を減らしました
  • company_id と data provenance の説明を CLI first に寄せました
  • draft 化した旧 docs は canonical page へ redirect するようにしました
  • Authentication / Billing / API / Claude Code workflow の文言を、公開ユーザー向けに読みやすく整理しました
  • docs tree の parent 処理と、未ログイン docs 表示時の useUser query error を修正しました

確認済み

  • pnpm run docs:qa:strict
  • pnpm typecheck
  • pnpm lint:fix
  • pnpm format:fix
  • git diff --check
  • desktop / mobile の rendered screenshot smoke

Features 配下にはまだ重複が残る可能性があります。次の docs cleanup では、機能説明ページと workflow ページの役割をさらに整理します。

2026年5月18日

WorkOS 移行後の team pages と actions を安定化しました

2026年5月18日に、team settings、members、billing、invitation actions を WorkOS/AuthKit 前提の明示的な権限チェックへ寄せました。

2026年5月17日

CLI 0.3.10 で readiness と data health を公開しました

2026年5月17日に、CLI 0.3.10、production readiness smoke、data health、agent skill corpus を公開しました。

2026年5月12日

CLI 0.2.21 で Canny smoke の contract 不整合を修正しました

2026年5月12日に、CLI 0.2.21 として company column、List column、observations search、sales-list の Canny smoke 指摘を修正しました。

2026年5月12日

CLI 0.2.22 で fresh-user smoke の使い始め friction を修正しました

2026年5月12日に、CLI 0.2.22 として column registry、source review、sales-list gate、read JSON contract を改善しました。

2026年5月12日

CLI 0.3.0 で Company / List / Column / Import 起点に整理しました

2026年5月12日に、Signal Foundry CLI、docs、agent skill を Company / List / Column / Import の object-first workflow に整理しました。

2026年5月12日

CLI 0.3.3 で List save と会社名検索のつまずきを直しました

2026年5月12日に、空の List preview が保存コマンドを出さないようにし、株式会社などの会社種別を含む検索語の扱いを改善しました。

2026年5月12日

CLI 0.3.4 で大量ドッグフードのつまずきを直しました

2026年5月12日に、広い地域 List preview、saved List column 実行、append 系 help の recovery を改善しました。

2026年5月12日

CLI 0.3.5 で Canny feedback の再現ケースを直しました

2026年5月12日に、domain company search、List preview actions、saved List row count、Column no-op、Import candidate evidence を改善しました。

2026年5月12日

CLI 0.3.6 で 1社調査の next action をさらに絞りました

2026年5月12日に、1社調査に見える List preview が Company workflow だけに戻るようにしました。

2026年5月10日

CLI 0.2.19 で agent 向け JSON contract と会社特定を強化しました

2026年5月10日に、CLI 0.2.19 として list/source/job の agent handoff、会社 identity、filing compare の入力検証を改善しました。

2026年5月4日

CLI の検索・クレジット表示・column課金を改善しました

2026年5月4日に、Canny feedback をもとに CLI 0.2.18 向けの JSON contract と website column 課金境界を改善しました。

2026年5月4日

Team-only workspace flow と billing 導線を整理

2026年5月4日に、サインアップ後の team workspace 作成、team billing、API key / List / credit の通常スコープを揃えました。

2026年5月3日

Agent がリスト保存と source 救済を迷わず進められるようになりました

2026年5月3日に、Signal Foundry CLI と agent skill を更新し、非上場企業や持ち込みCSVからの保存済み List 作成、sales-list 保存への接続を強化しました。

2026年5月3日

Business understanding の次アクションが明確になりました

2026年5月3日に、会社理解・営業ターゲティングの前に、実行できるコマンドとブロック中の追加調査を分けて確認できるようにしました。

2026年5月3日

Feedback送信で長文エラーが分かりやすくなりました

2026年5月3日に、CLI から Canny feedback を送る際、details が長すぎる場合は送信前に理由を返すようにしました。

2026年5月3日

Business understanding の計画情報を再利用しやすくしました

2026年5月3日に、CLI / Skills が返す business understanding の計画情報を、次の agent セッションで扱いやすくしました。

2026年5月3日

保存済みリストの営業利用と agent handoff を改善しました

2026年5月3日に、保存済みリストへ website / evidence / why now を一貫して出し、agent が次の調査へ進みやすい contract に揃えました。

2026年5月2日

Discovery run と release 運用を整理

2026年5月2日に、自然文の会社リスト探索を run_id で復元・絞り込み・保存できる導線と、CLI / changelog / release / billing の運用を整理しました。

2026年4月29日

Agent-native workspace、CLI 0.2.4、source import、credit billing を整理

2026年4月29日に、Signal Foundry の agent 向け実行面、持ち込み source、List column、Free/Pro/Credit Pack、ドキュメント IA をまとめて更新しました。

2026年4月23日

Contact form と heavy search の hardening

2026年4月23日

MCP の env raw tools を opt-in に変更

2026年4月23日に、MCP server の env raw read/write を既定無効へ変更し、secret 露出を縮小しました。

2026年4月17日

公開ドキュメントを Signal Foundry 向けに全面更新

2026年4月17日に、公開 docs を旧サンプル文面から Signal Foundry の実装・運用に沿った内容へ全面更新しました。

2026年4月16日

company-centric API と filing compare を整理

2026年4月16日に、Signal Foundry API の company-centric 導線を整理し、EDINET filing compare endpoint を追加しました。

2026年4月16日

CLI に auth init を追加し、agent handoff を短縮

2026年4月16日に `sf auth init` を追加し、Claude Code / Codex 向けの handoff を 1 コマンドで始められるようにしました。

2026年4月16日

personal account から API キーを管理可能に

2026年4月16日に、個人アカウントの settings 配下から Signal Foundry API キーを発行・失効・ローテーションできるようにしました。

2026年4月16日

production domain を API キー前提へ移行

2026年4月16日に、`signal-foundry.app` の internal no-key access を閉じ、本番ドメインを API キー前提の運用へ切り替えました。

2026年4月16日

チーム API キー画面に usage summary を追加

2026年4月16日に、チーム settings の API キー画面で直近30日の request 数、レスポンス量、最終利用、endpoint breakdown を確認できるようにしました。

このページの内容

2026年5月19日2026年5月18日2026年5月18日2026年5月17日2026年5月12日2026年5月12日2026年5月12日2026年5月12日2026年5月12日2026年5月12日2026年5月12日2026年5月10日2026年5月4日
2026年5月4日
2026年5月3日
2026年5月3日
2026年5月3日
2026年5月3日
2026年5月3日
2026年5月2日
2026年4月29日
2026年4月23日
2026年4月23日
2026年4月17日
2026年4月16日
2026年4月16日
2026年4月16日
2026年4月16日
2026年4月16日

WorkOS/AuthKit 移行後に、team workspace の一部画面が Supabase JWT / RLS 前提のまま残っていました。これにより、production の team settings、members、billing で PGRST301 系のエラーが出る可能性がありました。

主な更新

  • team settings、members、billing の server reads を、service role + explicit membership / permission check に変更しました
  • billing checkout / portal action は、permission、customer、provider config、seat count を明示的に検証するようにしました
  • invitation delete / role update / renew / accept を admin client 経由に寄せました
  • member remove / role update / ownership transfer を WorkOS session 前提の明示的チェックへ変更しました
  • team image upload と roles provider も、client-side Supabase read/write に依存しない形へ寄せました

体験の変化

team workspace は、認証 identity と Supabase RLS の暗黙一致に頼らず、アプリ側で membership と permission を確認してから操作します。WorkOS session でログインしているユーザーでも、settings / members / billing の読み書きが team scope と合うようになりました。

確認済み

  • pnpm typecheck
  • pnpm lint:fix
  • pnpm format:fix
  • pnpm run docs:qa
  • pnpm --filter @kit/team-accounts typecheck
  • git diff --check

残っている確認は、production deploy 後のログイン済み smoke と Vercel error log 確認です。

CLI 0.3.10 では、Signal Foundry を「agent が安全に使える会社データ workspace」として確認するための readiness gate を追加しました。

主な更新

  • sf readiness live --json を追加し、Import、saved List、Column、Export、credit 上限付き write path を同じ smoke で確認できるようにしました
  • sf data health --json を追加し、company、registry、EDINET、observation、Import、List の主要カバレッジを確認できるようにしました
  • bundled signal-foundry-agent skill の prompt corpus と object-first workflow を更新しました
  • unsupported / weak / needs_human の List preview では save action を出さず、agent が空結果を成功扱いしないようにしました
  • sf data capabilities --json、Company、List、Column、Import を起点にする docs / skill / CLI help を揃えました

確認済み

  • CLI 0.3.10 は GitHub Release artifact と SHA256SUMS で公開済みです
  • https://signal-foundry.app/releases/cli/latest.json は 0.3.10 を返します
  • production readiness は artifact / paid-write case を含めて 51/51 passed です
  • production sf data health --json は主要 count / coverage metrics を返します

更新方法

macOS / Linux:

brew upgrade sf
sf version --json

Windows:

winget は Microsoft moderation / catalog publish 後に使えます。公開前は GitHub Release artifact を使ってください。

winget search --id Nexaflow.SignalFoundry --source winget
winget upgrade --id Nexaflow.SignalFoundry
sf version --json

Bundled skill も更新する場合:

sf agent install --target codex --force
sf agent install --target claude-code --force

Homebrew と winget は convenience channel です。winget は catalog 反映まで遅れることがあります。特定 version を固定する場合や Windows で winget が未公開の場合は、GitHub Release artifact と SHA256SUMS を使ってください。

Canny の追加 smoke feedback をもとに、agent がそのまま実行しやすい JSON contract に揃えました。

主な更新

  • sf company column get <companyId> website_presence --json が HTML fallback ではなく JSON を返すようになりました
  • sf list column add ... --execute --max-credits 0 --json で、既存データ再利用のゼロクレジット実行が通るようになりました
  • unsupported な List column は 500 internal_error ではなく 400 unsupported_column_key として返ります
  • sf list show、sf companies search、sf agent install は未知の flag を network request 前に止めます
  • sf observations search HubSpot --market-segment prime --json のような vendor 短縮検索は website technographics evidence に向くようになりました
  • EDINET 系 observations search は、補助 evidence path が失敗しても取得済みの JSON 結果と warning を返すようになりました
  • 売りたい を含む sales intent は registry text search に流さず、clarification gate に戻します

体験の変化

agent は Canny に挙がった元コマンドをそのまま試して、HTML fallback や generic 500 ではなく typed JSON response を読めます。sales-list 系は、条件が曖昧なまま保存や課金導線へ進まず、先に確認すべき質問を返します。

sf company column get jpx_7203 website_presence --json
sf observations search HubSpot --market-segment prime --limit 20 --json
sf list plan "兵庫県の建設業向けに生成AI研修を売りたい" --json

Canny の fresh-user smoke feedback をもとに、初回利用時に agent が迷いやすい contract を補正しました。

変わったこと

  • sf data capabilities --json に column_registry を追加
  • read 系 JSON に ok / command / status の既定値を補完
  • sf source review --json の row に status / input / original_row / candidates を追加
  • sf job sales-list で 売りたい などの sales-intent を保存前に needs_human gate へ戻す
  • funding / news 条件を弱い website evidence ではなく unsupported capability gap として返す

Agent への影響

agent は sf data capabilities --json の column_registry を読めば、対応 column key と次に実行する command を確認できます。sales-list は buyer / product / pain or signal が曖昧なまま保存済み List を作らず、先に確認質問を返します。

Signal Foundry CLI の主要導線を、内部処理名ではなくユーザーが扱う object から始められる形に整理しました。

変わったこと

  • sf company search で会社を探す
  • sf list create / refine / save / show / export で候補作成から保存、確認、書き出しまで進める
  • sf list column add で List に調査列を追加する
  • sf import csv / resolve / rows / select / save で持ち込み CSV を Import として扱う
  • 公開 docs、CLI help、llms.txt、bundled agent skill を同じ言葉と順序に揃える

Agent への影響

agent は、まず sf --help、sf data capabilities --json、bundled signal-foundry-agent skill を見れば、Company / List / Column / Import のどこから始めるべきか判断できます。

旧 source 系の処理は内部互換として残していますが、通常のユーザー導線では sf import ... を使います。

CLI 0.3.3 では、agent やユーザーが docs / skill / --help からコピーして実行する List workflow の細部を修正しました。

変わったこと

  • 0件の List preview では、保存できない sf list save ... --max-credits 0 を action に出さない
  • sf list save は、返却された action に含まれる場合の --max-credits 0 を受け付ける
  • 株式会社 や 合同会社 などの会社種別を検索語から外す時、株式 のような中途半端な語を残さない
  • README、公開 docs、bundled agent skill、sf list save --help の説明を揃える

確認すること

List preview の JSON では、まず actions を見てください。save action がない場合は、保存ではなく sf list refine <listId> "<追加条件>" --json で条件を変えます。

CLI 0.3.4 では、公開 CLI を使って大量の user-flow を流した結果に基づき、ユーザーが docs / skill / --help から自然に辿る箇所を直しました。

変わったこと

  • 広い都道府県 / 市区町村の List preview が、不要な表示名 sort で詰まりにくくなりました
  • saved List の追加 Column 実行は、canonical な column cell を保存し、List row の JSONB を全件更新しない形にしました
  • sf list append --help、sf list rows add --help、sf list import --help、sf import append --help が親 help へ落ちず、Import workflow を案内します
  • direct append 未提供の command は、JSON usage_error と sf import csv -> resolve -> save の recovery を返します

確認すること

会社 row を後から足したい場合、既存 List に直接 append するのではなく、新しい Import として取り込み、resolve 後に新しい saved List として保存してください。追加 Column は従来どおり sf list column add <listId> <columnKey> --estimate --json から始めます。

CLI 0.3.5 では、Canny に追加された feedback を実際の公開 CLI workflow として再現し、agent が actions / gaps / row_count をそのまま信じて進められるように直しました。

変わったこと

  • domain での sf company search が、Import resolver と同じ候補集合に近づくよう domain の brand label も見るようになりました
  • sf company profile の JSON に object: "company_profile" を返すようにしました
  • theme-heavy な List preview には、保存前に使う sf observations search "<theme>" --source edinet --limit 5 --json action を返します
  • 1社調査に見える List query は保存 action を出さず、sf company search に戻します
  • saved List の list show は page size ではなく保存済み List の row count を返します
  • 対象行がない website_url Column execute は no-op としてすぐ完了します
  • Import の multiple-candidate rows は display name / match fields に加え、match evidence も返します

確認すること

List preview は、返ってきた actions を上から見て進めてください。save action がない場合は保存せず、evidence review、company search、または refine に戻ります。

CLI 0.3.6 では、0.3.5 の公開 smoke で見つけた List preview action の余分な候補を削りました。

変わったこと

  • 東京都 港区 OpenAI Japan のような 1社調査に見える query は、sf company search "<company>" --json に戻します
  • この場合は、theme evidence 用の sf observations search action を同時に出しません

確認すること

List preview の actions に save がない場合は、保存せず、返ってきた Company workflow に戻ってください。

CLI 0.2.19 では、agent が曖昧な会社名や List / source / job の戻り値を扱う時に、推測で進まず確認しやすい contract に揃えました。

主な更新

  • sf companies identity <query> --json を追加し、会社名、ブランド名、証券コード、domain stem から短い identity card を返すようにしました
  • sf list show --json に stable な rows[] と meta.returned_rows を追加しました
  • sf source resolve --json に non-null の run.*_count と resolution.*_count を追加しました
  • sf job company-research --execute --json の主要 handoff fields を top-level に展開しました
  • sf filing show/compare の list flag 入力を CLI 側で検証し、空白区切りの誤指定を network request 前に止めるようにしました
  • max_credits_exceeded は rate_limit ではなく budget_limit として返るようにしました

体験の変化

KEYENCE や 株式会社スタンダード のように候補が曖昧になりやすい検索では、agent はすぐに List 作成や調査へ進まず、companies identity で候補と根拠を確認できます。

List / source / company-research の JSON は、agent が必要な件数や evidence を安定して読める shape に寄せています。古い companies[] などの互換 field は残しているため、既存 workflow はそのまま動きます。

sf companies identity KEYENCE --json
sf list show <listId> --json
sf source resolve <sourceId> --execute --max-credits 100 --json
sf job company-research 7203 --execute --json

Canny に寄せられた dogfood feedback をもとに、agent が判断しやすい CLI contract と課金境界に揃えました。

主な更新

  • sf credits summary --json に summary.remaining_credits、summary.available_credits、summary.reserved_credits、summary.used_credits を追加
  • sf observations search --technology generative_ai|genai|llm|ai_agent を EDINET theme alias として解決
  • sf data capabilities --json と sf observations search --help に technology alias の候補を追加
  • website column は found row だけ credit を使うように保護し、not_found / no_data / skipped は課金対象外に固定

体験の変化

credits summary は利用履歴だけでなく、現在の残高 snapshot も同じ response で確認できます。observations search --technology generative_ai は、生成AI の EDINET evidence search に展開され、alias の適用状況は meta.technology_aliases で確認できます。

website column は、結果が見つかった row だけが credit 対象です。事前に sf list column add --estimate --json で対象件数を確認してから、--execute --max-credits で実行してください。

sf credits summary --json
sf observations search --industry 情報・通信業 --technology generative_ai --json
sf list column add <listId> website_presence --estimate --json

Signal Foundry の通常利用単位を team workspace に揃えました。1 人で使う場合も、owner だけの team workspace が API key、List、usage、billing、credit grant の account scope になります。

主な更新

  • サインアップ画面の copy を team workspace 前提に整理
  • 初回 team workspace 作成画面に、1 人利用でも team が account scope になることを明記
  • 個人 billing の checkout / portal 実装導線を外し、/home/billing は既存 team billing か team 作成へ誘導
  • team billing 画面に課金単位が team であることを表示
  • account selector から重複 team 作成につながる導線を外し、通常利用では 1 owner 1 team に寄せる
  • create_team_account を retry-safe にし、二重 submit 時は既存 owner team を再利用
  • hosted-dev seed と Lightpanda smoke を team workspace routes に合わせて更新

運用上の整理

個人 account は認証 identity と初期設定のために残りますが、契約・credit・receipt・共有 API key の通常スコープにはしません。公開 docs でも、API key は team workspace settings から発行する手順に揃えています。

Lightpanda smoke は、team home、team lists、settings、list detail を対象にしました。Next streaming navigation が安定しない settings subroutes は、build、typecheck、DB test、Playwright E2E 側で補完します。

Signal Foundry CLI と bundled agent skill を更新し、agent が company search、source import、sales-list の間を迷わず進められるようにしました。

主な更新

  • sf list create --company-id ... で、検索・確認済みの会社をそのまま saved List に保存
  • source map で company_id を明示指定できるようにし、汎用 company_id 列は自動確定しない安全な扱いに変更
  • not_found / unresolved / invalid の source row でも、確認済み company_id があれば source select で手動接続
  • sf job sales-list --execute --save で、候補発見から List 作成、rationale 保存、list show handoff まで接続
  • saved List rows が current rows を読み、件数と row payload の不整合を減らすように改善
  • signal-foundry-agent skill の冒頭に Agent Quick Route を追加

体験の変化

これまでは、companies search で見つけた非上場企業や、CSV resolve で not_found になった行を saved List へ接続する導線が弱く、agent が途中で手動判断に戻りがちでした。

今後は、確認済みの company_id を軸に保存済み List へ固定できます。

sf companies search LayerX --json
sf list create --company-id <companyId> --name "確認済み非上場候補" --json

持ち込み CSV でも、汎用 company_id は CRM 側 ID の可能性があるため自動確定せず、Signal Foundry の会社 ID だと確認できた時だけ明示的に接続します。

sf source map <sourceId> --entity company --column company_id=sf_company_id --json
sf source review <sourceId> --status not_found --json
sf source select <sourceId> --row <sourceRowId> --company <companyId> --max-credits 1 --json
sf list create --from-source <sourceId> --name "展示会リード" --json

営業候補探索も、発見して終わりではなく、保存・根拠メモ・List 確認までつながります。

sf job sales-list "生成AIやAIエージェントに関する根拠がある上場SaaS企業" \
  --execute \
  --save \
  --account-id <uuid> \
  --json

agent が skill を開いた時点で、会社調査、条件付きリスト、確認済み会社の保存、CSV 救済、sales-list 保存、website / employee columns のどれに進むべきかを判断しやすくなっています。

sf job business-understanding の artifact に、coverage、research insertion、credit explanation、command contracts を追加しました。

これにより、agent は「今すぐ実行してよい Signal Foundry の local command」と「まだ実行してはいけない external research」を分けて扱えます。

主な更新

  • coverage_review で、既存データと local route の到達範囲を確認
  • research_insertion_plan で、追加調査を入れる条件を明示
  • credit_explanation で、何を見たか、何を skip したか、credit risk を説明
  • safe_next_commands と blocked_next_command_contracts で、次コマンドの runnable / blocked を分離
  • 外部検索は、local route 後の明示 gap、--allow-external-research、--max-credits、list_id が揃うまで runnable にしない

体験の変化

これまでは、会社理解のあとに agent が company research、list plan、observations search、external research のどれへ進むべきかを文脈で判断していました。

今後は artifact の command contract を読むだけで、次の行動が分かります。

sf job business-understanding "兵庫県の建設業向けに生成AI研修を売りたい" \
  --buyer 情シス \
  --product 生成AI研修 \
  --pain 業務効率化 \
  --allow-external-research \
  --max-credits 3 \
  --execute \
  --json

この例では、sf list plan ... や sf observations search ... は安全な次コマンドとして返り、外部検索は sf list column add <listId> website_presence --estimate ... の blocked contract として返ります。

検索体験としては、agent がいきなり web search や外部調査に飛ぶのではなく、まず Signal Foundry 内の company memory / observations / saved list を使い、足りない根拠が明確になった時だけ credit-bounded に外部調査へ進めるようになりました。

sf feedback create で長い feedback details を送った時のエラーを改善しました。

主な更新

  • details は送信前に 10..5000 文字で検証
  • 長すぎる場合は Canny に投稿せず、CLI が usage error として理由を表示
  • help に inline / file-based details の文字数境界を明記

体験の変化

これまでは、details が長すぎると production API から generic な 400 が返り、agent が原因を判断しづらい状態でした。

今後は、raw transcript をそのまま送らず、再現手順・期待値・実際の結果・影響だけに要約するよう CLI が明確に促します。

sf feedback create "list workspace issue" \
  --kind bug \
  --surface list.workspace \
  --details-file ./feedback-summary.md \
  --json

sf job business-understanding --execute --json が返す計画情報を、次の agent セッションで参照しやすくしました。

UI は job を実行しません。どの確認が残っているか、どの次コマンドに進めるかを agent が判断しやすくします。

主な更新

  • open gaps、runnable / blocked command 数を整理
  • status、scenario、query、coverage status、credit risk、readiness を返却
  • safe_next_commands を読み取り専用の command block として表示
  • blocked command の requires、blocks、next step を返却
  • E2E smoke で API key 作成、CLI 実行、計画情報の返却を確認

体験の変化

これまでは agent が business understanding を実行しても、次に何を確認すべきかを読み取りづらい状態でした。

今後は JSON contract として揃うため、別の Codex / Claude Code セッションでも、どの gap が残っているか、どのコマンドは実行してよいかを見て再開できます。

sf job business-understanding "兵庫県の建設業向けに生成AI研修を売りたい" \
  --buyer 情シス \
  --product 生成AI研修 \
  --pain 業務効率化 \
  --execute \
  --json

保存済み List を、agent が作って終わりではなく、営業リストとしてそのまま確認・共有しやすい形に寄せました。

主な更新

  • has_website で候補化した会社の website URL / domain を、保存済み List row に引き継ぐように改善
  • CSV export に why_now_reasons、top evidence の source / date / URL を追加
  • Website column の結果を sf list show / CSV / agent skill で追いやすく整理
  • sf job business-understanding に targeting_context、evidence_strategy、list_strategy を追加
  • sf list plan で売上上限やグロース市場を扱いやすくし、HubSpot / Pardot 導入企業探索のような未対応条件は unsupported として明示

体験の変化

これまでは、estimate 時点では「公式サイトあり」と見えても、保存済み List や CSV では URL / domain が空になり、website column へ進めないケースがありました。

今回の更新後は、保存済み List row が website / evidence / column の受け皿になります。agent は sf list show で状態を確認し、必要なら sf list column add、sf list export へ進めます。

sf list show <listId> --json
sf list column add <listId> website_presence --estimate --json
sf list export <listId> --format csv --output ./list.csv --json

Signal Foundry の会社リスト探索を、単発の検索ではなく run として扱えるようにしました。Codex / Claude Code から「その中で神戸市だけ」「Webサイトがある会社だけ」のような追加条件が来たとき、元の query を作り直さず、直前の run_id から復元・絞り込み・保存できます。

主な更新

  • sf discovery show <runId> で直前の discovery run を復元
  • sf discovery refine <runId> "<追加条件>" で会話の続きとして条件を追加
  • sf discovery materialize <runId> --execute --max-credits <n> で run_id のまま saved List に保存
  • saved List に絞った後の追加情報を column add として整理
  • sf job business-understanding <query> で、会社理解・競合調査・営業ターゲット・pricing targeting の前提を structured output として固定
  • CLI package changelog、product changelog、GitHub Release、Linear、Stripe billing docs の source of truth を整理

体験の変化

これまでは agent が estimate_id を拾い、追加条件を自然文で再構成していました。今後は run_experience.safe_next_commands を読み、show / refine / materialize / column add / export のどれに進むかを選びます。

また、ターゲット list を作る前に business_understanding_brief.open_gaps を確認できるようになりました。曖昧な「この会社」「競合を見たい」「pricing の提案先を探したい」のような依頼は、company / product / buyer / user job / pain の不足を先に出し、条件が揃った時だけ company research や list plan へ進みます。

sf list estimate "兵庫県の建設業でWebサイトがある会社" --json
sf discovery refine <runId> "神戸市だけ" --json
sf discovery materialize <runId> --name "神戸市の建設業" --execute --max-credits 100 --json
sf list column add <listId> website_presence --estimate --json
sf list column add <listId> website_presence --execute --max-credits 50 --json
sf job business-understanding "2024年に値上げした会社のpricing提案先を探したい" --product 価格改定支援 --buyer 経営企画 --pain 値上げ --execute --json

検索体験としては、検索して終わり ではなく、条件を足しながら保存できる workspace に近づいています。

Signal Foundry の中心体験を Skills route. CLI executes. JSON contracts verify. UI reads. Docs support recovery. に寄せました。UI は見る場所、CLI と Skills は実行場所、JSON contract は agent が検証する場所です。

主な更新

  • sf data capabilities --json と sf list plan --json を agent の入口として整理
  • sf source import / inspect / map / resolve と sf list create --from-source を持ち込み CSV の正規導線に追加
  • sf list column add website_presence --estimate / --execute を List Workspace の追加情報導線として整理
  • sf feedback create を Canny-backed な社内 feedback inbox として追加
  • CLI の npm 版を 0.2.4 前提にし、sf version --json --check-update で更新確認できるように整理
  • Free / Pro / Credit Pack / Campaign credit grant の説明と sf credits balance をユーザー向けに整理
  • docs IA を Devin 風の header / tabs / sidebar / page toc / mobile navigation に寄せ、/docs は Quick Start にリダイレクト

credit boundary

preview、estimate、candidate preview、CSV import / inspect / map、export、feedback は無料です。credit を使うのは、Signal Foundry が価値ある row / column / evidence を作る実行です。

  • source resolve --execute: matched row だけ Basic credit
  • list materialize --execute: saved List row ごとに Basic credit
  • list column add --execute: found row だけ column credit

agent が迷わないための順番

sf version --json --check-update
sf auth show --json
sf data capabilities --json
sf list plan "<query>" --json
sf list estimate "<supported query>" --json

unsupported / weak な条件は 0 件扱いにせず、needs_human として人間に確認する方針です。

  • public contact form に honeypot を追加
  • contact form の HTML email で user input を escape
  • API key request の companies / observations/search に tighter guardrail を追加
  • observations/search response に scan_limit_requested を追加

MCP server の kit_env_raw_read / kit_env_raw_write は、2026年4月23日から既定で公開しない形に変更しました。

変更点

  • kit_env_raw_read
  • kit_env_raw_write

は常時登録されず、MCP server 起動前に KIT_MCP_ENABLE_UNSAFE_ENV_TOOLS=true を明示したときだけ登録されます。

また、kit_env_read も secret 値は redaction されます。

影響

  • 既存の MCP client や prompt が raw env tools の常時存在を前提にしている場合、そのままでは動きません
  • 通常運用では opt-in せずに起動するのが正しい使い方です

対応

  • local の完全信頼環境だけで raw env tools を使う
  • 既存 prompt は KIT_MCP_ENABLE_UNSAFE_ENV_TOOLS=true 前提かどうかを明示する
  • secret の確認だけが目的なら kit_env_read の redacted 表示を使う

公開ドキュメントを全面更新しました。これまで残っていた旧サンプル文面を削除し、現在の Signal Foundry に合わせて内容を組み直しています。

変更した内容

  • getting-started を CLI / API キー前提に更新
  • authentication を API キー運用中心に更新
  • database を company-centric data model 前提に更新
  • features を companies / profile / observations / filings / compare 中心に更新
  • billing を current status ベースの説明へ更新

あわせて更新したもの

  • apps/web/README.md
  • 公開 blog 記事
  • 公開 changelog 記事

ドキュメントの入口は、引き続き /docs です。

API の主要導線を整理し、companies -> profile -> observations -> filings -> compare で読める形に寄せました。

追加・整理した endpoint

  • GET /api/signal-foundry/companies
  • GET /api/signal-foundry/companies/{companyId}/profile
  • GET /api/signal-foundry/companies/{companyId}/filings
  • GET /api/signal-foundry/companies/{companyId}/filings/{filingId}
  • GET /api/signal-foundry/companies/{companyId}/filings/{filingId}/compare
  • POST /api/signal-foundry/observations/search

compare でできること

  • 直前 comparable filing の自動解決
  • summary metrics の比較
  • section diff の比較

compare は useful な機能ですが、product core は引き続き point-first です。まず profile と observations を厚くし、その上で compare を使う前提は変えていません。

CLI の初期設定を短縮しました。これにより、base URL と API キーの保存を 1 コマンドで済ませられます。

新しい初期化コマンド

pnpm -s sf auth init --base-url https://signal-foundry.app --api-key <YOUR_API_KEY>

あわせて改善した点

  • pnpm -s sf ... --json を agent 向けの正本に統一
  • quickstart を API キー手渡し前提に整理
  • 空の config path を安全に扱うよう hardening

これにより、Claude Code / Codex での最短導線は次の 3 手になりました。

  1. auth init
  2. companies search
  3. company profile

これまで team settings 側に寄っていた API キー導線を、personal account 側にも追加しました。

できること

  • API キー作成
  • ワンタイム表示
  • revoke
  • rotate

入口

  • /home/settings/api-keys

個人アカウントでもチームアカウントでも、Signal Foundry を同じ運用感で扱えるように揃えています。

本番ドメインのアクセス方針を整理しました。https://signal-foundry.app では、API キーなしの internal access を前提にしない運用へ移行しています。

変更点

  • production で SIGNAL_FOUNDRY_INTERNAL_API_ENABLED=false
  • no-key request は 404
  • API キー付き request は production でも通るよう route guard を修正

あわせて入ったもの

  • 基本 rate limit
  • invalid / revoked / rotated / expired API key の明示的な拒否
  • meta.auth_mode = api_key

これにより、本番利用の前提がより明確になりました。agent や CLI は API キー前提で接続してください。

チーム向け API キー画面に usage summary を追加しました。これにより、キーを配るだけでなく、どう使われているかも同じ画面で追えます。

表示するもの

  • request count
  • endpoint count
  • response bytes
  • last request at
  • endpoint breakdown

権限

チームアカウントでの閲覧・操作には settings.manage が必要です。

現時点では billing period 概念までは入れておらず、直近 30 日の運用確認に焦点を当てています。