Knowledge Field

観測 + Proposal-first actions / text・JSON・Sixel・Kitty・ANSI TUI

Knowledge Fieldは、Local Project KnowledgeとGlobal MURASAME Knowledgeを同じ観測モデルへ置きつつ、出所・権限・信頼状態を混ぜないための設計です。現行コードで利用できるのは、murasame kg scope によるread-onlyのtext / JSON垂直スライスとTUIです。

--tuiによる全画面表示は実装済みです。Sixel/Kitty対応端末では画像層を使い、非対応端末ではANSI/Unicodeへフォールバックします。Galaxy / Cluster / Cardの3段階、回転・ズーム・深度、アニメーション停止、reasoning pulseを操作できます。通常ターンのReasoning/Evidence read-only overlayと、confidence / freshness / usage / contradiction / reasoning relevanceの観測metricsを表示します。操作は既定ではread-onlyです。

コマンド

murasame kg scope [projectId]
  --local-db <path>
  --global-db <path>
  --local-project <id>
  --global-project <id>
  --query <text>
  --node <id>
  --reasoning-node <id1,id2>
  --bridge semantic|lexical
  --depth <1..25>
  --limit <1..200>
  --json
  --tui
  --actions   # TUIでI/C/Xを有効化(Y確認が必要)

既定のLocal Projectは引数の projectId(省略時は blog)、Global Projectは global です。Global DBが解決できない場合はエラーで書き換えず、warningsを付けたLocal-only表示になります。

murasame kg neighbors <projectId> <nodeId> --depth 2 --limit 60 --tui
murasame kg path <projectId> <fromNodeId> <toNodeId> --tui
murasame kg reachable <projectId> <fromNodeId> <toNodeId> --json
murasame kg field-action <projectId> request.json --json

現在のread-only契約

DB操作

SQLiteはreadonlyで開き、既存StoreのnodesOf・edgesOf・neighborsなどの読み取り操作だけを使います。

状態変更

既定のScope表示はProposal作成、approve、reject、Node / Edgeの更新、Card作成、LocalへのImportを行いません。明示した--actionsまたはfield-actionだけが、Y確認後にIMPORT/CREATEのpending ProposalまたはIGNOREのLedgerを作ります。

範囲

表示件数と近傍深度はboundedです。rejected Nodeは表示対象から外れます。

再現性

並び順はcodepoint比較で決定し、JSONにgeneratedAtなどの揮発値を含めません。

Bridgeの意味

LocalとGlobalの表示対象Node間だけで、既定はローカル nomic-embed のcosine similarityからsemantic bridgeを選びます。--bridge lexical、またはembedding runtime unavailable時は、決定的なToken Overlapへfallbackします。Bridgeのmetrics / visualWeightはscoreと両端Nodeの観測値から表示強度を計算するもので、意味的な確率・同一概念・因果関係の証明ではありません。Bridgeが表示されても、確定知識へ自動昇格することはありません。

{
  "localProject": "blog",
  "globalProject": "global",
  "nodes": [{
    "layer": "local",
    "status": "proposed",
    "provenance": "project-kg",
    "verification": "unverified",
    "confidence": 0.5,
    "metrics": { "freshness": 0.92, "usage": 0.31, "contradiction": 0, "reasoningRelevance": 1 },
    "distance": 0,
    "selected": true
  }],
  "bridges": [{
    "reason": "embedding:nomic-embed",
    "relation": "related",
    "metrics": { "confidence": 0.66, "freshness": 0.84, "usage": 0.21, "contradiction": 0, "reasoningRelevance": 1 },
    "visualWeight": 0.61
  }],
  "bridgeMode": "semantic",
  "bridgeModel": "nomic-embed",
  "bridgeThreshold": 0.55,
  "warnings": [],
  "stats": {}
}

JSON Snapshotの主なフィールド

フィールド	内容
`nodes`	layer、kind、name、summary、status、provenance、verification、confidence、metrics、distance、selected
`bridges`	localId、globalId、score、reason、relation、sourceLabel、metrics、visualWeight
`relations`	同一Knowledge圏内のsourceId、targetId、relation、confidence。neighbors/path TUIの構造線に使う
`warnings`	Global DBがない場合などの読み取り上の注意
`stats`	Local / Globalの件数、Bridge件数、depth、limit、閾値
`bridgeMode / bridgeModel / bridgeThreshold`	semantic(nomic-embed)またはheuristic fallbackと、その閾値
`reasoningNodeIds / reasoningRefs`	明示ID、または通常ターンのquery/Card/Verification refからread-onlyで解決されたpulse対象

操作と未実装範囲

Bridgeは既定ではembedding cosineによる意味近接です。runtime unavailable時は決定的Token Overlapへfallbackします。metrics / visualWeightはboundedな表示値であり、意味的な確率・因果関係・確定知識の証明ではありません。
Galaxy / Cluster / Cardの投影、回転、ズーム、深度、pulseはSixel/KittyとANSI/Unicodeで同じsnapshotから描画します。通常ターンのreasoning.nodesはCtrl+GのLive Fieldへ自動連動し、Graphへの書き込みは行いません。
OPEN、IMPORT、CREATE、IGNOREはProposal-firstです。Globalへの無確認共有、Cardのverified昇格、confirmed Graphの自動上書きは行いません。
外部Graph DBの実データプレーン、Knowledge Packの配信、完全自動Provisioningは別導入契約です。

通常ターンのReasoning / Evidence表示とField metricsは観測専用です。書き込みが必要な場合は、明示的なaction request、Evidence、Y確認、Human Reviewという境界を通します。

Marketing: Knowledge Fieldの位置づけ →