GitHub リポジトリ · 投稿者 TransmuteLabs

catalyst-probes

Name: catalyst-probes
Author: TransmuteLabs

# catalyst-probes

TransmuteLabs@TransmuteLabs

TransmuteLabs/Catalyst/tree/main/plugins/catalyst-probes

翻訳済み

この mod について

一つの hooks モジュールが相談エンジンと決定的なフォーム判定を提供します。相談者とフォーム規則は probes.toml に設定し、起動方法と相談者の契約は NOTES.md に記載します。

Form boundary

リダイレクト、tee、列挙された writer は判定対象です。インタープリター内の記録は対象外です。

writer は cp、mv、install、dd of=、インプレース sed と perl、truncate、強制シンボリック ln です。対象は静的に決定できなければなりません。動的な対象語や不明な作業ディレクトリは警告になります。コマンドモデルは bash と zsh の見え方を合わせ、shell スナップショット、静的代入、glob 候補、パイプライン状態の変形を含みます。

書き込みは例外が出ても実行後に判定します。ただし log_only の候補 fan-out は post-judgment を飛ばします（form-post-skipped-fanout）。拒否クラスは元のファイル、リンク、存在しない状態と比較して復元します。指紋が変わるか利用できない場合、親パスが付け替えられた場合は復元を止めて警告します。復元は新しいリンクの参照先ではなくパスオブジェクトを置き換えます。ロールバック警告は元の記録に追加します。

対象ごとのバックアップ資格は F とその対象の A1–A3/C1 です。全ての適用クラスが log_only ならバックアップも復元もせず、共有予算を消費しません。準備中に親がなくても構いませんが、復元では保存した祖先と新しいディレクトリチェーンを確認します。復元後はプラットフォーム固有の宛先フラグとファイル指紋またはリンク表記を確認します。

1 回の呼び出しのバックアップ予算は 4 MiB 判定しきい値の 8 倍です。超過すると実行前に拒否します。

モジュールのバージョンは 0.1.55 です。1 回の配布でモジュールを先に、canon を後に届けます。必須 canon キーがなければフォーム判定を黙って無効にせず F を明示します。検証とテストはインストール済みプラグインを有効化しません。

インストール

まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。

claude plugin marketplace add TransmuteLabs/Catalyst
claude plugin install catalyst-probes

原文 / README

catalyst-probes

One hooks module provides the consultation engine and deterministic form judge. Consultants and form rules are configured in probes.toml; arming and the consultant contract are documented in NOTES.md.

Form boundary

судятся перенаправления, tee и перечисленные писатели; записи внутри интерпретаторов — вне суда

The listed writers are cp, mv, install, dd of=, in-place sed and perl, truncate, and forced symbolic ln. Targets must be statically determinable. Dynamic target words and unknown working directories are named warnings. The command model covers the union of bash and zsh views, including shell snapshots, static assignments, glob candidates, and pipeline state variants.

Writes are judged after execution, including when execution throws, except that candidate fan-out under log_only skips post-judgment (form-post-skipped-fanout). Refusing classes use compare-and-restore of the original file/link/absent state; changed or unavailable fingerprints and retargeted parent paths prevent restoration and produce named warnings. Restoration replaces the path object, not the contents of a new link's referent. Rollback warnings augment the original record without replacing its refusal. Backup eligibility is computed per target: F plus that target's A1–A3/C1. All applicable classes set to log_only means no backup and no restoration for that target; its bytes do not consume the shared backup budget. Missing parents are allowed during preparation, but restoration checks the saved ancestor and new directory chain. Restoration uses platform-specific destination flags and checks the resulting file fingerprint or link spelling after replacement. The backup budget is 8 times the 4 MiB judgment threshold per call: превышение объёма бэкапа отказывает вызов до исполнения.

The module version is 0.1.55. Deliver the module first and its canon second, in one delivery step. Missing required canon keys give an explicit F rather than silently disabling form judgment. Validation/tests do not activate the installed plugin.

作品情報

作者: TransmuteLabs
用途: 開発・デバッグ
掲載日: 2026年10月4日
ソース更新日: 2026年10月4日
スター数: 3
権限の足跡: L3
回閲覧: 0

claude-code-pluginconsultationfilesystem-guardform-judgehooksl3-networkneeds-human-reviewrollback

この作品を報告あなたの作品ですか？所有者確認へ

スポンサー

掲載は週 $10 から

権限の足跡 L3

権限の足跡

自動スキャンの結果です。インストール前にソースを確認してください。レベルは機能を示すもので、安全認証ではありません。

コマンド実行
ファイル読み取り
ファイル書き込み
環境変数
モデル呼び出し
プロンプト送信
ツール呼び出しの介入
ツール登録

検出箇所を見る（107）

コマンド実行・行372 行plugins/catalyst-probes/hooks/register.tsconst m = QUOTA_RECOVERY_RX.exec(s)

コマンド実行・行590 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_TEMPORAL_RX.exec(before)) !== null) {

コマンド実行・行618 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_STRONG_RX.exec(t)) !== null) {

コマンド実行・行622 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_AMBIGUOUS_RX.exec(t)) !== null) {

コマンド実行・行628 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_TOO_LONG_RX.exec(t)) !== null) {

コマンド実行・行640 行plugins/catalyst-probes/hooks/register.tswhile ((sm = REFUSAL_SIZE_FREE_SUBJECT_RX.exec(t)) !== null) {

コマンド実行・行681 行plugins/catalyst-probes/hooks/register.tsconst w = REFUSAL_WRAP_STATUS_RX.exec(text)

コマンド実行・行694 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_TOO_LONG_RX.exec(p)) !== null) {

コマンド実行・行705 行plugins/catalyst-probes/hooks/register.tswhile ((sm = REFUSAL_SIZE_FREE_SUBJECT_RX.exec(p)) !== null) {

コマンド実行・行722 行plugins/catalyst-probes/hooks/register.tsconst w = REFUSAL_WRAP_STATUS_RX.exec(text)

コマンド実行・行735 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_STRONG_RX.exec(p)) !== null) {

コマンド実行・行739 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_AMBIGUOUS_RX.exec(p)) !== null) {

コマンド実行・行928 行plugins/catalyst-probes/hooks/register.tsconst m = RX_RESETS.exec(String(line || ""))

コマンド実行・行998 行plugins/catalyst-probes/hooks/register.tsconst st = REFUSAL_WRAP_STATUS_RX.exec(text)

コマンド実行・行1439 行plugins/catalyst-probes/hooks/register.tsconst m = /^"([\s\S]*)"\s*(?:#.*)?$/.exec(s)

コマンド実行・行1443 行plugins/catalyst-probes/hooks/register.tsconst m = /^'([\s\S]*)'\s*(?:#.*)?$/.exec(s)

コマンド実行・行1447 行plugins/catalyst-probes/hooks/register.tsconst m = /^\[([\s\S]*)\]\s*(?:#.*)?$/.exec(s)

コマンド実行・行1467 行plugins/catalyst-probes/hooks/register.tsconst m = /^\{([\s\S]*)\}\s*(?:#.*)?$/.exec(s)

コマンド実行・行1475 行plugins/catalyst-probes/hooks/register.tsconst kv = /^(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_.-]+))\s*=\s*([\s\S]*)$/.exec(el)

コマンド実行・行1547 行plugins/catalyst-probes/hooks/register.tsconst aa = /^\[\[(.+)\]\]$/.exec(s)

コマンド実行・行1549 行plugins/catalyst-probes/hooks/register.tsconst sec = /^\[(.+)\]$/.exec(s)

コマンド実行・行1553 行plugins/catalyst-probes/hooks/register.tsconst kv = /^(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_.-]+))\s*=\s*([\s\S]*)$/.exec(s)

コマンド実行・行1879 行plugins/catalyst-probes/hooks/register.tsconst m = re.exec(first)

コマンド実行・行1883 行plugins/catalyst-probes/hooks/register.tsconst mm = re.exec(lines[i].trim())

ファイル読み取り・行1996 行plugins/catalyst-probes/hooks/register.tsconst v = await $.fs.read(path)

ファイル書き込み・行2034 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(jpath + ".shard." + safe, line)

ファイル書き込み・行2397 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(

環境変数・行2487 行plugins/catalyst-probes/hooks/register.tstry { cwd = String(await $.env.get("PWD") || "").trim() } catch (x) { cwd = ""; noteLost("cwd-env-read", x, $) }

コマンド実行・行3680 行plugins/catalyst-probes/hooks/register.tsconst w = (/^[^\s<>|;&()]*/.exec(tx.slice(q, e)) as RegExpExecArray)[0]

環境変数・行3845 行plugins/catalyst-probes/hooks/register.tstry { JUDGE_CARRIER = await $.env.get("CLAUDE_JUDGE_CARRIER") } catch (x) { unreadable.push("CLAUDE_JUDGE_CARRIER") }

環境変数・行3847 行plugins/catalyst-probes/hooks/register.tstry { JUDGE = await $.env.get("CLAUDE_JUDGE") } catch (x) { unreadable.push("CLAUDE_JUDGE") }

環境変数・行3849 行plugins/catalyst-probes/hooks/register.tstry { JUDGE_MODEL = await $.env.get("CLAUDE_JUDGE_MODEL") } catch (x) { unreadable.push("CLAUDE_JUDGE_MODEL") }

環境変数・行3851 行plugins/catalyst-probes/hooks/register.tstry { JUDGE_PROMPT = await $.env.get("CLAUDE_JUDGE_PROMPT") } catch (x) { unreadable.push("CLAUDE_JUDGE_PROMPT") }

環境変数・行3853 行plugins/catalyst-probes/hooks/register.ts

try { JUDGE_TIMEOUT = await $.env.get("CLAUDE_JUDGE_TIMEOUT_MS") } catch (x) { unreadable.push("CLAUDE_JUDGE_TIMEOUT_MS") }

環境変数・行3855 行plugins/catalyst-probes/hooks/register.tstry { FORM_CARRIER = await $.env.get("CLAUDE_FORM_CARRIER") } catch (x) { unreadable.push("CLAUDE_FORM_CARRIER") }

環境変数・行3857 行plugins/catalyst-probes/hooks/register.tstry { FORM = await $.env.get("CLAUDE_FORM") } catch (x) { unreadable.push("CLAUDE_FORM") }

環境変数・行3859 行plugins/catalyst-probes/hooks/register.tstry { IDLE_CARRIER = await $.env.get("CLAUDE_IDLE_CARRIER") } catch (x) { unreadable.push("CLAUDE_IDLE_CARRIER") }

環境変数・行3861 行plugins/catalyst-probes/hooks/register.tstry { IDLE = await $.env.get("CLAUDE_IDLE") } catch (x) { unreadable.push("CLAUDE_IDLE") }

環境変数・行3863 行plugins/catalyst-probes/hooks/register.tstry { PROBES = await $.env.get("CLAUDE_PROBES") } catch (x) { unreadable.push("CLAUDE_PROBES") }

環境変数・行3865 行plugins/catalyst-probes/hooks/register.tstry { PROMPTS = await $.env.get("CLAUDE_PROMPTS") } catch (x) { unreadable.push("CLAUDE_PROMPTS") }

環境変数・行3867 行plugins/catalyst-probes/hooks/register.tstry { PROBES_DIR = await $.env.get("CLAUDE_PROBES_DIR") } catch (x) { unreadable.push("CLAUDE_PROBES_DIR") }

環境変数・行3869 行plugins/catalyst-probes/hooks/register.tstry { CONFIG_DIR = await $.env.get("CLAUDE_CONFIG_DIR") } catch (x) { unreadable.push("CLAUDE_CONFIG_DIR") }

環境変数・行3871 行plugins/catalyst-probes/hooks/register.tstry { HOME = await $.env.get("HOME") } catch (x) { unreadable.push("HOME") }

環境変数・行3873 行plugins/catalyst-probes/hooks/register.tstry { PWD = await $.env.get("PWD") } catch (x) { unreadable.push("PWD") }

環境変数・行3875 行plugins/catalyst-probes/hooks/register.ts

try { ROUTING_TABLE = await $.env.get("CATALYST_ROUTING_TABLE") } catch (x) { unreadable.push("CATALYST_ROUTING_TABLE") }

コマンド実行・行4239 行plugins/catalyst-probes/hooks/register.tswhile ((mm = rx.exec(prompt)) && att.length < atn) {

ファイル書き込み・行4384 行plugins/catalyst-probes/hooks/register.tstry { await $.fs.write(recPath, JSON.stringify(Object.assign({}, rec, { inflight: true }))) } catch (x) {

モデル呼び出し・行4439 行plugins/catalyst-probes/hooks/register.tsconst ans = readComplete(await raceDeadline($, $.model.complete(arg), tmo, used, rec, "probe-rung-late"))

ファイル書き込み・行4577 行plugins/catalyst-probes/hooks/register.tstry { await $.fs.write(recPath, JSON.stringify(rec)) } catch (x) { noteLost("judge-record", x, $) }

ファイル書き込み・行4596 行plugins/catalyst-probes/hooks/register.tsif (cfg.record !== false) await $.fs.write(recPath, JSON.stringify(rec))

コマンド実行・行5093 行plugins/catalyst-probes/hooks/register.tsconst m = /^(?:[\s({!]+|(?:then|do|else|elif|if|while|until|time)(?=\s)|[A-Za-z_][A-Za-z0-9_]*=\S*(?=\s))/.exec(r)

コマンド実行・行5101 行plugins/catalyst-probes/hooks/register.tsconst w = (/^[^\s<>|;&()]*/.exec(cmdHead(seg)) as RegExpExecArray)[0]

コマンド実行・行5177 行plugins/catalyst-probes/hooks/register.tsconst rd = /^(?:\d*)?(?:&>>!?|&>!?|>>!?|>\||>!|>&|>|<<<|<<-?|<&|<)/.exec(tx.slice(p, hi))

コマンド実行・行5196 行plugins/catalyst-probes/hooks/register.tsconst m = /^\$(?:\{[A-Za-z_][A-Za-z0-9_]*\}|[A-Za-z_][A-Za-z0-9_]*)/.exec(tx.slice(p))

ファイル読み取り・行5391 行plugins/catalyst-probes/hooks/register.tstry { entries = await $.fs.list(dir) } catch (x) {

コマンド実行・行5407 行plugins/catalyst-probes/hooks/register.tsconst m = /^alias -- ([^=\s]+)=(.*)$/.exec(line)

ファイル読み取り・行5539 行plugins/catalyst-probes/hooks/register.ts

try { entries = await $.fs.list(dir || "/") } catch (x) { if (!fleetEnoent(x)) noteLost("form-target-list", x, $); continue }

ファイル読み取り・行5620 行plugins/catalyst-probes/hooks/register.ts

try { isDir = (await $.fs.stat(formResolve(dest.text, home, view.cwd))).kind === "dir" } catch (x) { if (!fleetEnoent(x)) noteLost("form-writer-stat", x, $) }

コマンド実行・行5637 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/usr/bin/readlink", path], { timeoutMs: 5000 })

コマンド実行・行5642 行plugins/catalyst-probes/hooks/register.tsconst platform = await $.process.run(["/usr/bin/uname", "-s"], { timeoutMs: 5000 })

ファイル読み取り・行5649 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(formParent(path), { resolve: true })

ファイル読み取り・行5658 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(ancestor, { resolve: true })

ファイル読み取り・行5673 行plugins/catalyst-probes/hooks/register.tsconst ancestor = await $.fs.stat(path, { resolve: true })

ファイル読み取り・行5677 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(path)

ファイル読み取り・行5715 行plugins/catalyst-probes/hooks/register.tsif (!stat) try { stat = await $.fs.stat(path) } catch (x) {

ファイル読み取り・行5719 行plugins/catalyst-probes/hooks/register.tstry { resolved = await $.fs.stat(path, { resolve: true }) } catch (x) { return null }

コマンド実行・行5726 行plugins/catalyst-probes/hooks/register.ts

const result = await $.process.run(linux ? ["/usr/bin/sha256sum", "--", path] : ["/usr/bin/shasum", "-a", "256", "--", path], { timeoutMs: 5000 })

ファイル読み取り・行5732 行plugins/catalyst-probes/hooks/register.tsconst bytes = knownBytes === undefined ? await $.fs.read(path, { as: "bytes" }) : { base64: knownBytes }

コマンド実行・行5743 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/bin/rm", "-f", "--", saved.path], { timeoutMs: 5000 })

コマンド実行・行5751 行plugins/catalyst-probes/hooks/register.tsconst copied = await $.process.run(["/bin/cp", state.copyFlag!, "--", saved.backup, temp], { timeoutMs: 5000 })

ファイル読み取り・行5754 行plugins/catalyst-probes/hooks/register.tstry { current = await $.fs.stat(saved.path) } catch (x) { if (!fleetEnoent(x)) throw x }

コマンド実行・行5758 行plugins/catalyst-probes/hooks/register.tsconst moved = await $.process.run(["/bin/mv", "-f", destinationFlag, "--", temp, saved.path], { timeoutMs: 5000 })

ファイル読み取り・行5760 行plugins/catalyst-probes/hooks/register.tsconst restored = await $.fs.stat(saved.path)

ファイル読み取り・行5762 行plugins/catalyst-probes/hooks/register.tsconst resolved = await $.fs.stat(saved.path, { resolve: true })

コマンド実行・行5771 行plugins/catalyst-probes/hooks/register.tsconst removed = await $.process.run(["/bin/rm", "-f", "--", path], { timeoutMs: 5000 })

ファイル読み取り・行5780 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(target.path)

ファイル読み取り・行5793 行plugins/catalyst-probes/hooks/register.tstry { stat = await $.fs.stat(target.path, { resolve: true }) } catch (x) { if (!fleetEnoent(x)) throw x }

ファイル読み取り・行5801 行plugins/catalyst-probes/hooks/register.tstry { stat = await $.fs.stat(copyFrom, { resolve: true }) } catch (x) { if (fleetEnoent(x)) stat = null; else throw x }

コマンド実行・行5811 行plugins/catalyst-probes/hooks/register.tsconst made = await $.process.run(["/bin/mkdir", "-p", "-m", "700", "--", dir], { timeoutMs: 5000 })

コマンド実行・行5813 行plugins/catalyst-probes/hooks/register.tsconst privateDir = await $.process.run(["/bin/chmod", "700", "--", dir], { timeoutMs: 5000 })

コマンド実行・行5819 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/bin/cp", state.copyFlag!, "--", copyFrom, saved.backup], { timeoutMs: 5000 })

コマンド実行・行5830 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/bin/rm", "-f", "--", saved.backup], { timeoutMs: 5000 })

ファイル読み取り・行5849 行plugins/catalyst-probes/hooks/register.tstry { stat = await $.fs.stat(target.path) } catch (x) {

ファイル読み取り・行5856 行plugins/catalyst-probes/hooks/register.tsconst raw = await $.fs.read(target.path, { as: "bytes" })

ファイル読み取り・行5861 行plugins/catalyst-probes/hooks/register.tsconst after = await $.fs.stat(target.path)

ファイル読み取り・行5904 行plugins/catalyst-probes/hooks/register.tsconst resolved = await $.fs.stat(target.path, { resolve: true })

ファイル読み取り・行5905 行plugins/catalyst-probes/hooks/register.tsconst referentStat = await $.fs.stat(saved.referent)

ファイル読み取り・行5946 行plugins/catalyst-probes/hooks/register.tstry { current = await $.fs.stat(saved.path) } catch (x) { if (!fleetEnoent(x)) throw x }

コマンド実行・行5949 行plugins/catalyst-probes/hooks/register.ts

const linked = await $.process.run(["/bin/ln", "-s", "-f", destinationFlag, "--", saved.link!, saved.path], { timeoutMs: 5000 })

ファイル読み取り・行5951 行plugins/catalyst-probes/hooks/register.tsconst restored = await $.fs.stat(saved.path)

ファイル書き込み・行6145 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(recPath, JSON.stringify(record))

ファイル書き込み・行6146 行plugins/catalyst-probes/hooks/register.ts} else await $.fs.write(recPath, JSON.stringify(formRec))

ファイル書き込み・行6537 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(fleetDir(world) + "/" + fleetSafe(sid) + ".json", JSON.stringify(rec))

ファイル読み取り・行6555 行plugins/catalyst-probes/hooks/register.tstry { ents = await $.fs.list(dir) } catch (x) {

ファイル読み取り・行6585 行plugins/catalyst-probes/hooks/register.tstry { await $.fs.stat(path) } catch (x) { gone = fleetEnoent(x) }

コマンド実行・行6598 行plugins/catalyst-probes/hooks/register.tsconst pr = await $.process.run(["/bin/rm", "-f", path], { timeoutMs: 5000 })

プロンプト送信・行7168 行plugins/catalyst-probes/hooks/register.tsPromise.resolve().then(() => $.prompt.submit({ text })).then(

ツール呼び出しの介入・行7516 行plugins/catalyst-probes/hooks/register.tsif (!(await probeFiltered($, packed.world, p, "not-main", "tool.call", now, n))) {

ツール呼び出しの介入・行7696 行plugins/catalyst-probes/hooks/register.tsconst ev = snapEvent($, e, "tool.call")

ファイル書き込み・行7945 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(modRecPath(world, p.id, ev), JSON.stringify({

ファイル書き込み・行7961 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(modRecPath(world, p.id, ev), JSON.stringify({

ツール登録・行8110 行plugins/catalyst-probes/hooks/register.ts

await $.tool.register({ name: FLEET_TOOL, description: FLEET_TOOL_DESCRIPTION, inputSchema: { type: "object", properties: {} } })

ツール呼び出しの介入・行8224 行plugins/catalyst-probes/hooks/register.tson("tool.call", async ($: any, e: any, next: any) => {

ツール呼び出しの介入・行8277 行plugins/catalyst-probes/hooks/register.ts.catch(($: any, e: any, next: any) => decisiveFailClosed($, "tool.call", e, next))

環境変数・行8580 行plugins/catalyst-probes/hooks/register.ts

try { stallRaw = await $.env.get("CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS") } catch (x) { stallRaw = undefined; noteLost("failover-stall-env", x, $) }

コマンド実行・行9044 行plugins/catalyst-probes/hooks/register.tsconst pr = await $.process.run(["/bin/sleep", sp.arg], { timeoutMs: sp.limit })

コマンド実行・行9473 行plugins/catalyst-probes/hooks/register.tsran = await $.process.run(["/bin/sleep", sp.arg], { timeoutMs: sp.limit })

catalyst-probes

この mod について

Form boundary

インストール

catalyst-probes

Form boundary

関連作品

thimble-cc-mod

taxi-blackbox

flaky-memory