sealtier

sealtier

sealtier は、Markdown ファイルのフォルダーを、お使いのマシン上だけで Open Knowledge Format（OKF）v0.2 のフロントマター階層（Bronze、Silver、Gold）に照らしてチェックします。ナレッジベースがどの階層に達しているか、次の階層に進むために各ファイルで不足しているフロントマター項目、文書を引き続き信頼できるかどうか、git の編集がその信頼性にどのような影響を与えたかを確認できます。読み取りのみを行います。スキャン時にどこにも書き込みは行わず、このパッケージのツールがネットワークに接続することもありません。

jidoseal-mcp サーバーの3つのローカルツールをクリーンルーム方式で再構築したものです。残りの2つのツールは再構築していません。1つは有料の Stripe Checkout セッション（決済ファネル）を作成し、もう1つは決定的な出力がベンダーのウェブサイトでのみ公開されている価格のため、公開情報から再現できないためです。

チェック内容

項目として認められるのは、実際の内容がある場合のみです。値のない title: はカウントされません。

階層	ファイルに必要な項目（値が設定されていること）
Bronze	type
Silver	Bronze + title、description、timestamp、owner
Gold	Silver + status、review_policy、reviewed_at、next_review_at

コーパスの階層は、最も低い階層のファイルに基づきます。カバレッジは、各階層に達しているファイルの割合です。不足している各項目には、AUTO（ツールが値を提案可能）または NEEDS-CLIENT（所有者のみが回答可能）の印が付きます。0～100のスコアは round（3つのカバレッジ値の平均） です。これは再構築した式であり、その旨を明示しています。元のツールは計算例（カバレッジが 66.7 / 33.3 / 33.3 の場合に44）を公開していますが、式は公開していません。この式を使うとその値を再現できます。Merkle ルートは、ファイル名順に並べた各ファイルの sha256 の16進ダイジェストを連結し、その結果に対して計算した sha256 の16進値です。こちらも再構築したものであり、その旨を明示しています。

外部への通信について：元のベンダーは、スキャンエンジンがネットワーク経由で何も送信しないと主張しています。これは独自のエンジンについてのベンダー自身の主張であり、独立した監査は行われていません。この再構築版は、動作をより容易に把握できます。HTTP クライアントをインポートせず、ソケットも開きません。また、jidoseal_changes が起動するプログラムは1つだけで、ローカルの git をトランスポート無効化設定（protocol.allow=never、GIT_NO_LAZY_FETCH=1）で実行します。

記録されている差異が1つあります。元のツールは、スキャンしたフォルダー内に .jidoseal/manifest.json と .jidoseal/progress.ndjson も書き込みます。この再構築版は読み取り専用で、何も書き込みません。

インストール

npx @reneturcios/sealtier jidoseal_scan '{"path":"/path/to/notes"}'

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/sealtier

コンテナーはデフォルトで MCP サーバーを起動します（下記参照）。CLI として使うには、CLI の引数を渡してください。

CLI

各コマンドは、引数を1つの JSON オブジェクトとして受け取り、JSON の結果を出力します。

# Tier a folder of Markdown files
sealtier jidoseal_scan '{"path":"~/notes"}'

# Trust verdict for one file, or every *.md in a folder
sealtier jidoseal_trust '{"path":"~/notes/policies/leave.md"}'

# What changed since HEAD, and what it did to trust
sealtier jidoseal_changes '{"path":"~/notes"}'
sealtier jidoseal_changes '{"path":"~/notes","ref":"v1.2"}'

sealtier --version

終了コード：成功時は 0、ツールを完了できない場合（フォルダーが見つからない、git status が失敗するなど、問題の内容がエラーに示されます）は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

1つの実行ファイルで、どちらの用途にも対応します。mcp サブコマンドを実行すると、stdio の MCP サーバーが起動します。

npx -y @reneturcios/sealtier mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "sealtier": {
      "command": "npx",
      "args": ["-y", "@reneturcios/sealtier", "mcp"]
    }
  }
}

ツール

ツール	入力	返される内容
jidoseal_scan	path（文字列、必須）— Markdown ファイルのフォルダー	コーパスのティア（最も低いティアのファイルに基づく）、ファイルごとのティアとpresentフィールド、ティアごとの不足項目リスト、ティアごとのカバレッジ、0～100のスコア、ファイルごとのsha256ハッシュ、Merkleルート、監査ID、ルーブリック。
jidoseal_trust	path（文字列、必須）— Markdown ファイル1つ、またはフォルダー	ファイルごとに、理由を含む判定stale／unverified／ok、OKFへの準拠状況（値が設定されたtype）、信頼ティア、status、古くなっているかどうか、which_0_2 — タイムスタンプが準拠するOKF v0.2のテキスト（stale_after、sources[].last_modified、またはusage_windowがUTCオフセット付きの日時の場合は2026-08-21。どちらの形式も受け付けます）。
jidoseal_changes	path（文字列、必須）— git作業ツリー、ref（文字列、任意、デフォルトはHEAD）	refと異なるすべての*.mdについて、フロントマターの変更、本文が変更されたかどうか、信頼への影響（テキストが変更されたのにverifiedが変更されていない検証済みドキュメント、verifiedまたはtypeの削除、generated.atが更新されていない、statusまたはstale_afterの変更）。

フロントマターの解析には、手作業で実装したYAMLの小さなサブセット（フラットな key: valueペア、引用符で囲まれた文字列、インラインリスト／マップ、1段階の インデント付きブロックマップとリスト）を使用します。このサブセットに含まれない フロントマターブロックは、ファイルごとにfrontmatter_ok: falseとして報告されます。そのファイルは手作業で修正するまで、どのティアにも到達せず、フィールド数にも含まれません。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network, fake git executor
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSEを参照してください。