rule.json、rule lockfile、digest 検証済みの rulebook cache を読み取ります。この load は書き込み、network access、結果の cache をしないため、snapshot は常に disk 上の現在の設定を反映します。
snapshot には ready と degraded の 2 state だけがあります。このページでは、拒否された source で強制されなくなるものと、ready に戻す方法を含む完全な仕様を説明します。
設定 state
1 つの warning でも runtime は
degraded になります。error と warning の違いは state の重大度ではなく、source の扱いです。
- error は、drop された source を示します。その source はルールをまったく提供しません。
- warning は、有効なままで、拒否された部分だけを無視する source を示します。
degraded になります。
cc-safety-net status が出力する verdict は ready と degraded だけです。verdict は snapshot state から直接読み取ります。無効な Claude Code プラグインは verdict を変更しません。status は Not active の最初の項目として次を報告します。“plugin cc-safety-net@cc-marketplace is disabled in Claude Code; nothing is enforced in Claude Code until it is re-enabled. Other integrations are not affected.”無効な設定の動作
無効であることだけを理由に、無効な設定が通常の作業を拒否することはありません。無効な candidate は強制されませんが、エージェントを lock out することもありません。- 検証できない rule source は drop されます。そのルールは強制されなくなります。
- その他の検証済み scope は、引き続きルールを強制します。
- すべての組み込み保護は、すべての場合に適用されます。destructive-command rule、secret protection、policy-file protection、Git-metadata protection は rule configuration を読み取りません。
- 読み取れない
policy.jsonは保護的な既定値に戻るため、destructive-command protection と secret protection は有効なままです。
rule.json の読み取り、in-place edit、cc-safety-net rule sync の実行は通常の tool call であり、それぞれの内容に基づいて成功または失敗します。そのため、エージェント自身が設定を修復できます。
すべての state で保護されるものは、正式な user policy.json です。policy-file protection と Git-metadata protection は configuration snapshot の読み込み前に動作するため、壊れた設定の影響を受けません。ブロックされる正確な操作についてはポリシーを参照してください。
設定 fallback matrix
Error：source を drop
各 message は、拒否した file または source を示し、修復方法がある場合は
cc-safety-net rule sync の実行を指示します。
Warning：source は有効なまま
重複した rulebook name は決定的に解決されます。最初の claim が優先され、user scope を先に読み込むため、user scope の name が project の同名 rulebook を隠します。後の rulebook は、一部のルールを shadow するのではなく、何も提供しません。fatal error ではなく解決済みの状態であるため、他の scope が同じ name を使用しても、1 つの scope に対する
rule sync は成功します。
policy.json：salvage または保護的な既定値に置換
field-level salvage により、1 つの無効な field が、ファイルのその他の部分に設定された保護を drop することを防ぎます。保護的な既定値は、意図的に拒否が多くなる側へ倒れます。destructive-command protection と secret protection を強制的に有効にし、allow path と disabling override を drop します。field ごとの動作についてはポリシーを参照してください。
runtime は
policy.json を書き換えません。手動で修復するか、dashboard の repair action を使用してください。
ファイルに error がある間、dashboard form は salvage 済みの値ではなく完全な既定値を表示します。repair するまで保存できません。repair action は、認識された有効な設定を維持します。JSON を parse できない場合だけ、ファイル全体を既定値に置き換えます。
Transparent wrapper の coverage gap
transparent_wrappers は rulebook ではなく rule.json で宣言し、rule.json には lock も digest もありません。このため、次の 2 つの結果があります。
- drop された rulebook でも、その scope の wrapper は維持されます。
rule.json自体は読み取り可能なためです。 - 読み取れない
rule.jsonでは、その scope の wrapper が失われます。fallback に使える検証済み copy がないためです。analysis は、wrapper command の下にある protected command を確認しなくなります。
rule.json を修復してください。
Fail-closed case
“Fail closed” は runtime failure と analysis failure を正確に表し、その 1 つの tool call を拒否します。無効な設定の動作を表す言葉ではありません。
無効な設定は逆の動作です。rule source を drop し、
policy.json を salvage するか保護的な既定値に置き換え、作業を続けます。
Degraded-state の報告
rule configuration と
policy.json の両方を報告するコマンドは doctor だけです。各コマンドの option と終了動作についてはCLI コマンドを参照してください。
次の 2 つの構造上の制限があります。
Config warning:行と auditconfigFallbackflag は、snapshot の読み込み後に行った判定にのみ表示されます。policy-file と Git-metadata の拒否はその前に発生するため、どちらも含みません。- diagnostic は、拒否した file と condition の名前を示します。file の byte を copy しません。malformed config file 内のシークレットが message に再出力されることはありません。
見える failure と見えない failure
- drop された rule source は静かです。 拒否を追加せず削除するため、問題のない session では friction も signal もありません。rule configuration の変更後と upgrade 後には、意識して確認してください。
cc-safety-net statusを習慣にし、完全な report にはdoctorを使います。 - local rulebook の編集と未移行の legacy configuration はさらに静かです。 どちらも runtime diagnostic を発生させません。digest 検証済み cache は編集前の rulebook を強制し続け、legacy file は読み込まれません。
rule syncで編集を有効にし、rule verifyで legacy file を検出します。 - 無効な
policy.jsonは通常明らかです。 拒否された section は、両方の保護を有効化し、allow path と disabling override を drop する保護的な既定値に戻るため、設定より多くの拒否が発生します。 - 無効な
policy.jsonの静かな部分：無効なsafety.levelは暗黙にstandardに戻るため、paranoidの typo は preset を下げます。無効なsecret_protection.deny_paths項目と、既定値より上にルールを引き上げる per-rule override は修復されず破棄されます。 - passive な signal は status line marker だけです。
Config warning:行は無関係の拒否が発生した場合にのみ表示され、その他の surface はコマンドの実行または dashboard の表示を待ちます。
設定を復旧する
次の各コマンドは通常の tool call であるため、runtime が degraded の間もエージェントが sequence 全体を実行できます。各コマンドの完全な option と終了動作はCLI コマンドを参照してください。1
Verdict を確認する
ready または degraded と、Not active 内の diagnostic ごとの 1 行を出力します。無効な Claude Code プラグインは別の verdict ではなく、最初の Not active 項目として表示されます。これは情報だけを示すため、gate ではなく、負荷が低い日常的な check として使用します。2
完全な report を取得する
policy.json の両方を対象にする唯一のコマンドです。degraded runtime は config.runtime-degraded warning として表示され、finding の detail は拒否されたすべての source を示す完全な reason です。3
実際に有効なものを確認する
Issues と Warnings を一覧表示します。drop された source と一緒に失われたルールを確認します。policy に error がある場合だけ non-zero で終了します。warning だけの場合は Warnings に出力し、0 で終了します。4
Rule configuration を検証する
rule.json を schema に対して検証し、runtime load を再実行するため、guard と同じ問題を検出します。移行が必要な legacy file も検出します。1 つの write が発生する場合があります。有効な rule.json に $schema key がない場合は追加して Added $schema to <scope> config. と出力します。それ以外は変更しません。5
修復して再 sync する
Rule config synced. はその scope が正常であることを示します。verification は、sync 対象 scope だけを対象にします。6
policy.json を手動で修正する
runtime は
policy.json を書き換えません。diagnostic が示す field を自分で修正するか、dashboard の repair action を使用し、status を再実行します。完全な schema と既定値についてはポリシーを参照してください。status を再実行してください。runtime は次の tool call で reload するため、再起動は不要です。
Legacy inline rule を移行する
legacy inline config file（~/.cc-safety-net/config.json と .safety-net.json）は runtime で読み込まれず、runtime diagnostic も発生しません。その他は動作し続けますが、そのルールはまったく強制されず、snapshot は ready のままです。これは upgrade 後の代表的な silent degradation です。何も壊れず、これらのルールは何も保護せず、session 中は何も報告しません。cc-safety-net rule verify が、移行待ちの legacy file を検出します。
変換する legacy configuration があるプロジェクトから migration を実行します。
rule migrate は sync result を伝播します。移行後の scope に diagnostic が残る場合は、成功を報告せず、その diagnostic を報告します。移行済み file は書き込まれ、legacy file は維持されるため、報告された問題を修正して再実行できます。移行先の rulebook layout についてはカスタムルールを参照してください。
関連ページ
ポリシー
完全な
policy.json の仕様、既定値、field ごとの salvage。カスタムルール
Rulebook layout、source、lock と cache、override、transparent wrapper。
CLI コマンド
status、doctor、すべての rule subcommand の完全な option と終了動作。Audit log
判定の記録場所、entry schema、retention。