swapit — 家庭有害物質インベントリ&交換エンジン は何をしますか?
このスキルの目的
swapit は、「家の中にプラスチックやBPAがたくさんあるはず」という漠然とした不安を、具体的で優先順位付けされた追跡可能な計画に変えます。ステートフルであるため、家庭のインベントリはディスク上に保存され、セッションをまたいで維持されます。ローカルファーストであり、有料サービスは不要で、明示的に(M3)コモンズにオプトインしない限り、デバイスの外にデータが出ることはありません。
1回の実行で以下が生成されます:
- 所有するアイテムのインベントリ。各アイテムには汎用のアイテムクラスがタグ付けされます。
- 実際の曝露を反映したアイテムごとのリスクスコア — 毎日高温で使用される傷ついたノンスティックフライパンは、ガレージの未開封のプラスチック製収納箱よりもはるかに高いスコアになります。
- 最も曝露を削減できる**「交換優先」リスト**(上位5%)。
- 交換追跡 — 選択した代替品、調達状況、チェックリスト、ブックマーク。
- 共有可能なHTMLレポート(M2では
swapit serveによるライブダッシュボードも可能)。
3つの領域(とプライバシーの不変条件)
| 領域 | 保持する内容 | 共有 |
|---|---|---|
| 1 · 知識 | 有害物質 → アイテムクラス → 代替品(汎用的、引用付きの事実) | 共有可能;キャッシュされ、(M3で)コモンズと同期 |
| 2 · インベントリ | あなたのアイテム、部屋、数量、ブランド、写真、交換、ブックマーク | 非公開 — デバイスの外に絶対に出ない |
| 3 · コモンズ (M3) | 共有知識グラフを豊かにする匿名化された貢献 | オプトイン、レビュー付き、汎用的な事実のみ |
プライバシーの不変条件(拘束力あり): 領域2のインベントリ(アイテム、部屋、数量、ブランド、写真、購入情報、場所)は、同期の境界を決して越えません。共有可能なのは領域1の汎用的な事実のみで、明示的なオプトインと確認可能な
swapit sync --dry-runを経由します。これは、クライアント側の許可リストシリアライザ(scripts/anonymize.py)とコモンズサーバー側のバックストップ、さらにすべての実際のインベントリアイテムがゲートによって拒否されることを確認するファズテストによって強制されます。禁止フィールドリスト:anonymize.CONTRIBUTION_FORBIDDEN(state.PRIVATE_FIELDSのインベントリ構造サブセット)。
データモデル
状態は ~/.config/swapit/ に保存されます($SWAPIT_HOME で上書き可能;$XDG_CONFIG_HOME を尊重します)。
~/.config/swapit/
├── knowledge/ hazards.jsonl · item-classes.jsonl · alternatives.jsonl · products.jsonl · procurement.jsonl
├── inventory/ events.jsonl(追記専用監査) · items.json · swaps.json · rooms.json · bookmarks.json
├── contributions/ queue.jsonl (M3)
├── sync/ config.json · sync-log.jsonl (M3)
└── photos/
ノードスキーマ(完全な引用付きデータセットは seed/*.jsonl を参照):
- hazard —
id · name · aliases · class · mechanism · exposure_routes · regulatory · severity(0-3) · evidence_strength · sources - item_class —
id · name · category · description · hazards[]{hazard_id, presence_likelihood, rationale} · detection_hints · sources - alternative —
id · name · replaces[] · material · rationale · tradeoffs · caveats · avoids_hazards · residual_concerns · sources - procurement_option(購入先、公開)—
id · alternative · item_class · retailer · region(ISO-3166-1 a2) · area · url · price_min · price_max · currency · as_of · availability · confidence · corroboration_count - item(非公開)—
id · name · item_class · room · quantity · brand · condition · usage{frequency, food_contact, heat, child_contact} · status · notes · photos - swap(非公開)—
id · item_id · chosen_alternative · procurement{status, cost, vendor} · checklist[] · bookmarks[]
リスクモデル
risk = severity × presence_likelihood × evidence × exposure_relevance × frequency × condition
- exposure_relevance は、アイテムの使用方法に応じて有害物質の経路を活性化します(食品接触+高温は経口/食品接触/高温の有害物質で最大になります;皮膚接触はパーソナルケア製品で重要;吸入は掃除用品/家具で重要;子供との接触は増幅されます)。
- アイテムスコア = 有害物質ごとのリスクのスケール合計 → 高 / 中 / 低 のバンドに分類。
- これが優先順位付けのインテリジェンスです — procurer の「支配的な故障モード」に類似:まず曝露の大部分を占める少数のアイテムを修正し、すべてのプラスチック製のものに対する罪悪リストを作るのではありません。
モード
| モード | 機能 |
|---|---|
init | 状態を作成し、シード知識グラフをロード |
add | 家庭アイテムを追加(名前、クラス、部屋、状態、使用方法)→ その評価を出力 |
assess | アイテムまたはアドホックなアイテムクラスを評価 → 有害物質 + リスク + 順位付き代替品 |
list | インベントリを一覧表示、--room/--band/--status/--class/--hazard でフィルタ、リスクでソート |
swap | 交換計画を作成/更新:代替品の選択、ステータス設定、チェックリスト、ブックマーク、コスト |
score | 家庭の曝露サマリー + 交換優先ランキング |
report | 自己完結型HTMLレポートを生成(カテゴリC) |
procure | procurerへの引き継ぎ概要 + 交換ターゲットに関する既知の購入先オファー(--region でフィルタ);見つけたオファー(--retailer/--url/--price-*)を公開コモンズに記録 |
knowledge | 知識グラフを閲覧/検索(list/search/show) |
rooms | 部屋を一覧表示/追加 |
selfheal | 知識エッジ + インベントリ参照 + 根拠を検証;エラーがあれば非ゼロで終了 |
serve | http://127.0.0.1:8731 でライブローカルダッシュボード — カンバンボード、チェックリスト、ブックマーク、ステータス;すべてのクリックが状態に書き戻される |
contribute | 匿名化された事実をキューに入れる — product / hazard(アイテムクラス→有害物質) / alternative / procurement(公開購入先オファー) / item-class(新しい分類ノード);ローカルに適用され、コモンズ用にゲートされる |
sync | 貢献キューをプッシュし、コミュニティ知識をプル(オプトイン);--dry-run で送信される内容を正確にプレビュー;--configure でエンドポイントを設定 |
典型的なフロー
swapit init
swapit add --name "古いテフロン鍋" --class nonstick-cookware --room kitchen \
--condition scratched --frequency daily --food-contact --heat
swapit score # 何を最初に交換すべきか
swapit swap itm_xxxx --to cast-iron-skillet --status sourcing --add-task "10インチのスキレットを購入"
swapit procure itm_xxxx # -> 概要を `procurer` スキルに引き継ぎ
swapit report --open # 共有可能なHTML
他のスキルとの連携
procurer—swapit procure <item>でニーズ(「3つのポリカーボネート製ボトルをガラス/ステンレスに交換」)と準備されたプロキュアラープロンプトを構築;プロキュアラーは引用付きの情報源と予算枠を返す。bookkeeping(P6) — 新規の耐久性のある有害物質/製品の発見(例:新たに特徴づけられたアイテムクラス)は、research/entities/にプロアクティブにファイルされ、後でコモンズに流せる。health— 個人の曝露コンテキスト。content-creation— グラフからの教育用投稿。
根拠の規律
シード知識は、権威ある機関(NIEHS、ATSDR/CDC、米国環境保護庁、米国食品医薬品局、ECHA/EU REACH、カリフォルニア州OEHHA Prop 65、WHO、EWG)のみを引用します。すべてのレコードは1つ以上の情報源を持ちます;verified: false はこれらが参照グレード(新しく取得したものではない)であることを示します — sourced pass(またはコモンズ)を実行してリフレッシュしてください。selfheal は、どのノードも引用を失った場合に失敗します。これは公衆衛生科学に基づいた消費者向けガイダンスであり、医学的または法的なアドバイスではありません。
リソース
scripts/swapit.py— CLIエントリポイント + コマンドハンドラscripts/state.py— 2領域状態レイヤー(PRIVATE_FIELDSが同期境界を定義)scripts/ops.py— 単一の状態変更書き込みパス(CLI + ダッシュボードで共有)scripts/knowledge.py— 知識グラフのロード + エッジ解決scripts/risk.py— 曝露リスクスコアリングエンジンscripts/report.py— 自己完結型HTMLレポートジェネレーター(カテゴリC)scripts/server.py—swapit serveライブダッシュボード(stdlib http.server、localhostのみ)scripts/anonymize.py— プライバシーゲート:許可リストの事実ビルダー + 禁止フィールドスキャンscripts/sync.py— コモンズ同期クライアント(キュー、--dry-runプレビュー、プッシュ/プル、マージ)scripts/selfheal.py— 整合性バリデーターtemplates/dashboard.html— ライブダッシュボード(インラインCSS/JS、カテゴリC)commons/— ネットワーク化されたコモンズ参照サーバー(FastAPI + SQLite;デプロイはゲート付き)seed/{hazards,item-classes,alternatives}.jsonl— 根拠のあるスターター知識tests/— リスク、知識、自己修復、CLI、プライバシー/匿名化、同期、レポート、サーバーのテスト
コラボレーション(コモンズ)
貢献は汎用的な事実のみです — swapit contribute product|hazard|alternative|procurement|item-class で匿名化された事実(公開製品→アイテムクラスマッピング、有害物質エッジの修正、代替品、購入先オファー、または新しい分類ノード)を構築し、ローカルに適用してキューに入れます。swapit sync --dry-run で送信される内容が正確に表示されます;swapit sync でキューをプッシュし、コミュニティ知識をプルします(--configure 後、オプトイン)。異なるユーザーからの同一の事実は、複製ではなく確証(コンテンツアドレス指定)します;コモンズは2人の異なる貢献者が確証した場合にのみ事実を提供します(corroboration >= 2)— モデレーションは確証ゲートであり、信頼度ゲートではありません。confidence は呼び出し元が提供するものであり、単独の提出者が自分自身で承認する可能性があるためです。プライバシーの不変条件は両方の側面(クライアント anonymize ゲート + サーバーバックストップ)で強制されます — インベントリは決して越境しません。
購入先(調達)コモンズ
procurement_option 事実は公開オファーです:region(ISO-3166-1 alpha-2)内の retailer によって販売される、より安全な alternative。オプションで url、price_min/price_max + currency + as_of、area、availability を含みます。これは (alternative, retailer, region) でコンテンツアドレス指定されます — 同じオファーはユーザー間で確証されます;異なる地域は異なる事実です(地理的スケール軸)。価格/URL/エリアは改良可能な市場データです:厳密に新しい as_of を持つ確証は、価格を前方にリフレッシュし、より新しいデータを後退させることはありません。プライバシーの境界は明確です — 公開オファーは retailer + price_* を使用し、決して非公開の vendor/cost(あなたがどこで購入し、いくら支払ったか)を使用しません(それらは領域2に残ります)。swapit procure <item> --region <CC> で既知のオファーを表示し、見つけた新しいオファーを記録します — 誰でも使用できる、オープンで詳細な、地理的にスコープされたデータセットを成長させます。
ロードマップ
- M1(出荷済み、0.1.0) — データモデル、シード知識、CLI、リスクエンジン、静的HTMLレポート、自己修復。
- M2(出荷済み、0.2.0) —
swapit serve:状態への読み書きが可能なライブローカルダッシュボード。 - M3(0.3.0) — 匿名化コラボレーション + ネットワーク化コモンズ(
commons/、FastAPI + SQLite)。許可リストシリアライゼーションとクライアント・サーバー両方のファズテストによってプライバシーの不変条件を強制。 - M4(このリリース、0.4.0) — 地理的にスケールされた調達コモンズ + 分類法の成長:
procurement_option(公開購入先、キーは(alternative, retailer, region)、前方のみの価格リフレッシュ)およびitem_class(確証ゲート付き分類法成長)の事実種別;procureがオファーを表示・記録;米国/コロンビア/ドイツ/英国のシードオファー;固定ベクトルによってロックされたクロス言語ハッシュパリティ。broomva.tech インフラへのライブデプロイは明示的な許可に依存(クレデンシャル/DNS);スキルはオフラインでも完全に機能します。