Notariumドキュメント
ドキュメントのバージョン: latest

ノートの種類

すべてのノートにはクラスがある。クラスは、そのノートがどこで見えるか、どうインデックスされるかを決める。クラスは frontmatter に手で書き込める自由入力のラベルではない。ノートの保存場所からシステムが推論し、自動的に適用するポリシーの束だ。APIレスポンスでは、クラスは読み取り専用の値になる。

クラスはポリシーの束

各クラスの背後にはポリシーの束がある — それぞれについて可否が決まっている。ノートがインデックスされるか、グラフ・フィード・ツリー・ユーザー向け検索に現れるか、エージェントの recall から利用できるか、バージョン管理されるか、レプリケーションされるか。要点はこうだ。可視性は一か所でチェックされるのであって、すべてのクエリに忘れず付け足さなければならないフィルタで判定するのではない。「結果から隠す」と「インデックスから除外する」は別物であり、Notarium がこの二つを取り違えることはない。

ノートの同一性は notarium-id であって、パスではない。だから、移動やリネームをしてもクラスがひそかに変わったり、インデックスが壊れたりすることはない。

クラスのレジストリ

クラスステータス可視性
user-doc稼働中どこでも見える。ツリー、フィード、グラフ、検索。すべてのユーザーコンテンツのデフォルト。
agent-memory稼働中インデックスされ、エージェントの recall から利用できるが、ユーザー向けの画面からは隠されている。所有者には別セクションとして見える。
attachmentポリシーを持つ添付ファイルは一人前のデータだが、知識としてはインデックスされない。検索対象になるのは .md ファイルだけだ。
derivedポリシーを持つ再生成可能な成果物(プレビュー、レンダー)。インデックスには入らない。
profile稼働中ノートを検索・閲覧するあらゆる場所から隠されている。Settings → Profile と、start_session でエージェントに渡す経路からのみ到達できる。

あなたが実際に扱う二つのクラス

実際には、二つのクラスがアクティブなまま、内容を溜め続けていく。

user-doc — あなたのノート。デフォルトのクラスで、ツリーの中で自由に整理でき、検索・グラフ・フィードに供給される。人がエディタを通じて、そしてエージェントが create_note を通じて書き込むのは、まさにここだ。

agent-memory — エージェントのメモリ。これは読める形のノートであって、隠しストアではない。エージェントはカテゴリごとに一つのファイルへ観察を追記していくのであって、細切れのマイクロファイルを量産するわけではない。メモリは専用のサービスフォルダ .notarium/memory/ に置かれるので、あなたのツリーに混ざらず、あなたのフォルダとぶつからない。

メモリはあなたに見えるが、エージェントのものだ

あなたはメモリの内容を読み、編集し、削除できる — それがコンテキストに紛れ込んだかもしれないものを監査し、制御する手段だ(履歴を見れば、誰が何を書いたかがわかる)。ただし、あなたはメモリを再編成しない。レイアウトはエージェントのものだ(カテゴリのフラットな集合と派生インデックス)。移動は技術的には安全だが、再編成の禁止はプロダクト上の決定であり、メモリのモデルを予測可能に保つためのものだ。

メモリのインデックスは派生物だ。各メモリファイルの summary フィールドから組み立てられ、全体を再スキャンして作り直される。これは start_session で即座にロードされる一方、ファイル本体は recall を通じて必要に応じて取り込まれる。詳しくはエージェントメモリを参照。

profile —「あなたについて」

プロフィールノート専用のクラス。あなたについて人が書いたコンテンツ(エージェントではなく、あなた自身が書いたもの)だ。ノートを検索・閲覧するあらゆる場所から隠されており、到達経路は二つだけ — Settings → Profile を通じてと、start_session が識別子でエージェントのコンテキストへロードすることによって。これはエージェントのメモリではなく、あなたがキュレーションするコンテキストカードだ。

クラスは保存場所から推論され、システムが設定する — エージェントはフォルダもクラスも選ばない。これが分離とアドレッシングにどうつながるかは、スペースとプロジェクトを参照。