Repository navigation
feat: I3097 P02 debug metadata schema and neutrality #3099
Description
Parent feature epic: #3097. Phase P02, class design-bearing, owner ac-dev-rust-v5, dependency P01 (must be merged to main before branching).
Situation and intended result
Expose the optional metadata schema while keeping effective debug absent until derivation activates. Diagnostic data must not change event, gap, adoption or semantic revision behavior.
Approved specification and scope
Canonical D:/0_repos/AgentsCommander_iac/.ac/plans/3097-id-hash-debug/p02-v3-metadata-schema.md, SHA256 A5DDCDC2336FACE9C3A4B7113AD31A5D03987B605FB347231A060053A306DACB.
Parent plan-v3 SHA256 B86F5DC6F3813AF551FD1055953829DC0493936AD82EAE1BAF05DA8D1520351E; exact-set consensus in consensus-round3-v3.json.
Only src-tauri/src/config/settings.rs and src-tauri/src/commands/config.rs. Tolerant optional string-array wire/decode; exact snake-case key; explicit assignments. Exclude new debug from existing semantic comparisons and exact raw agent/cell revision locations, preserving existing id_hash/unknown-field behavior. Clear supplied debug on effective refresh; physical writers remain hash-only until P03. Extend bounded existing schema/projection/event fixtures. No new hash computation, runtime command or transport adapter.
Acceptance and verification
Standalone valid arrays roundtrip; malformed debug does not reject valid real configuration; real-field errors remain. New metadata alone does not change profile events/gap/adoption/identity projection; unknown nested values and existing hashes retain sensitivity. Intermediate main remains shippable.
Shipper from authorized repo: all-target cargo check; serial locked --lib filters id_hash, settings_draft_events, issue_3047, derived_agent_id_binding_projection, profile_identity_2450; positive counts and green results. Full commands, roots, structural proof and exact-head CI gate in canonical phase. Child-only closure; no packaged build/install/release/version.
Activity
Merge pull request #3106 from mblua/feature/3099-id-hash-debug-schema
mblua commentedon Oct 18, 2026
Delivered P02 through merged PR #3106. Issue #3099 is closed; epic #3097 remains open for P03/P04.
Standalone base-agent/profile-cell records now support tolerant optional
id_hash_debugstring arrays and exact snake-case serialization. Diagnostic values stay neutral to comparisons/events/identity projections; effective refreshes clear supplied metadata in this phase. Derivation and physical persistence remain P03 work. Existing hash/preimage functions and physical writers are unchanged.Reviewed/tested head:
1d10fbcf2a1882b9a0a1d940b96ed9c684ec1908, treef60598cad7b69b36f32c81c884ae6b4eddaa647f. Locked all-target check and formatting passed; five library filters plus three layering guards passed 70 selected tests, with possible overlap. Complete PRE/FINAL SCC sets/counts and 1,211 module arcs matched; 96,449-byte records matched the committed baseline. Rust Grinch returnedCODE_AND_PROOF_REVIEW_PASS.CI run 39099527179 succeeded on that exact head. Actual tier
run_number=3413 full=falseexplains all seven skipped groups; all 13 executed rollup checks succeeded and all 14 configured required contexts were mapped. The unrelated incoming Telegram delta was independently reviewed and recorded on the PR, preserving the valid CI result without another run.Merge/main:
103ecbdfed5c6a3b2c6a8d54f441fb127e3ff6bf, treefd168626d47b12654ed99343c93c15d19af47bbf. The complete merged tree was verified: both P02 files match the tested feature blobs; every other path matches incoming mainee7ff1706f941cf3a5c2041340ad5dae9ab00fbe. Local main equals origin/main and is clean; the feature branch was removed. No distributable build, installation, release or version change was requested.Canonical phase:
plans/3097-id-hash-debug/p02-v3-metadata-schema.md, SHA256A5DDCDC2336FACE9C3A4B7113AD31A5D03987B605FB347231A060053A306DACB. Evidence and immutable receipts are under the room'sroom-shared/e2432-id-hash/id-hash-debug/execution/P02/.