ops: cut over local NGR MCP to soft-start feedback

[lipluscodex]

目的

baseline-aware snapshot evaluation v2のdevelopment / holdout全8 gate支持に基づき、local Codex NGR MCPを現行q3/s1からsoft-start r0.25 / confirmation decay r0.5 / sibling normalization 1.0へ可逆にcutoverする。

前提

• soft-start mechanics merge: f392eae888dc975d885c25e7d137a57bf8763d5f。
• baseline-aware freeze merge: d73d115348e3e166f38445f74c6072829d4fe847。
• observed support merge: bac9705eaf3de607b70ec3310d9f51cd7ec83d04。development / holdoutとも支持、8/8 hard gate pass。
• 現在のMCP commandは C:\Users\smile\Codex\neuron-graph-rag\.venv\Scripts\python.exe を使い、checkoutはissue-89-v3-slot-1-captureでsoft-start config fieldを持たない。
• 現在のlive configはq3/s1。source databaseは C:\Users\smile\.codex\data\neuron-graph-rag\knowledge.db。

Cutover

• merged mainのexact commitを指す専用local deployment checkout / environmentを作り、既存issue-89 worktreeを変更しない。
• optional MCP dependencyを含む環境を同期し、EngineConfigとCLIがsoft-start flagsを受理することを確認する。
• C:\Users\smile\.codex\config.toml のNGR MCP blockだけを更新する。
  • command: 専用deployment environmentのPython
  • remove: --relation-feedback-evidence-quorum 3
  • keep: --sibling-feedback-normalization 1.0
  • add: --soft-start-feedback-reinforcement
  • add: --soft-start-feedback-ratio 0.25
  • add: --confirmation-decay-ratio 0.5
• config edit前にtimestamp付きbackupを作り、他のserver / marketplace / user設定を変更しない。

Verification

• configをTOMLとしてparseし、NGR blockのcommand / args exact matchを確認する。
• source databaseは起動テストに使わず、temporary databaseまたはregistered snapshot cloneでMCP startup / tools/list / effective config provenanceを確認する。
• verificationの前後でsource database container hashを比較し、不変を確認する。
• new runtimeでsoft-start field active、search surface relation、q3 hard quorum無効、sibling ratio 1.0を確認する。
• 既存Codex MCP processはhot reloadを仮定せず、config反映は次回MCP process restart / Codex session restart境界として報告する。

制約

• source databaseのnode / edge / trace / feedback / outcomeを検証目的で変更しない。
• issue-89 worktree、frozen evaluation artifact、private snapshotを変更しない。
• library default、repository source、GitHub releaseを変更しない。
• config全体を再生成せず、NGR blockの最小差分だけを適用する。

完了条件

• exact merged runtimeでsoft-start CLI / MCP smoke pass。
• config backupと最小cutover差分を保存。
• source DB hash前後一致。
• 次回process restart後に有効になるconfigを機械検証し、rollback方法を記録。

Related

• eval: observe baseline-aware soft-start snapshot comparison #108 / PR eval: record baseline-aware soft-start observations #109 - baseline-aware support result
• eval: make soft-start snapshot comparison baseline-aware #106 / PR eval: freeze baseline-aware soft-start comparison #107 - result-free freeze
• feat: add soft-start feedback reinforcement #100 / PR feat: add soft-start feedback reinforcement #103 - soft-start mechanics

[lipluscodex]

Lay: local NGR MCPのsoft-start cutoverを完了しました。

Evidence

• deployment checkout: detached exact bac9705eaf3de607b70ec3310d9f51cd7ec83d04
• runtime command: C:\Users\smile\Codex\workspace\deployments\neuron-graph-rag\.venv\Scripts\python.exe -m neuron_graph_rag_mcp
• config: NGR blockのcommand / args 2行だけを変更し、TOML parse、他block同一、command存在、args exactを確認
• effective feedback config: evidence quorum 1（q3 flag削除）、sibling normalization 1.0、soft-start有効、provisional ratio 0.25、confirmation decay 0.5
• separate temporary DBのstdio smoke: startup、search / record_source_use / record_outcome、soft-start tool descriptions、relation search surface、effective config provenanceを確認
• mechanics smoke: first used provisional update、first confirmed multiplier 0.75、confirmed時のsibling normalizationを確認
• source DB container SHA-256: 90c664d345aab9a9ccf36943b5b503cf98e9588577db0e7ccd4f07b27cb33fe0
• source DB read-only logical backup file SHA-256（前後）: 003f24478f8d18dd34ab6aee5d939202d116f195ac8db33c29e38ab7e0f456d1
• source DB logical dump SHA-256（前後）: c3a824e2a61f41a4089f82697a14fc19e5f72ff877dc3efca67b4fe88663eb6f
• source DB、deployment checkout、既存issue-89 checkoutは不変。既存Codex MCP processはkill / restartしていない

config backup:
C:\Users\smile\.codex\config.toml.backup-20260821-105927

• backup SHA-256: 7d6ede1ab61ffefa379fb83253b617279c1e751cb077378b769a132004969f11
• cutover後config SHA-256: 61cfe89ba57f4676935ae0900109617ca5cb92f752db3fd53758cd11617a0c56

反映境界

現在動作中のCodex MCP processにはhot reloadしていません。新configは次回MCP process restartまたはCodex session restartで有効になります。

Rollback

次のPowerShellでbyte-identical backupを戻し、その後MCP processまたはCodex sessionをrestartします。

Copy-Item -LiteralPath 'C:\Users\smile\.codex\config.toml.backup-20260821-105927' -Destination 'C:\Users\smile\.codex\config.toml' -Force

[lipluscodex]

Lin: 親レビュー PASS。Issue本文のcutover / verification / constraints / 完了条件に対し、評価済みexact commitへのdetached clean deployment、NGR block 2行だけの差分、TOML exact parse、temporary DBでのstdio MCPとmechanics smoke、source DBの前後不変、次回process restartという反映境界、byte-identical backupによるrollbackを確認しました。既存MCP processとissue-89 checkoutは変更していません。