# TableGit：Git-native 表、行、Object 与事务机制的 SOURCE 依据
Date: 2026-10-09. Management marker: manager-language-TableGit-svg-source-20261009T1355Z.
Scope: isolated LRIGIT self-study illustration, not a runtime benchmark, main release, TableGit business edit, or previously blocked consumer/validator retry.

## Layer A — current official MCPGit operation contract, directly inspected
Service: LRIGIT lritpc, mcpgit.application.v7; catalog mcpgit.skills-kernel.v9, skill_version 2.3.0.
- table.author/worktree_table_transaction: main target commits directly; logical Topic uses isolated draft. Bare TableGit writes Git Objects/Trees without persistent worktree or index. expected_revision may remain a prior ancestor when disjoint rows advance; same-row expected_row_version and Object versions must match. A transaction UUID and optional idempotency key determine retry-safe operation identity.
- table.author/worktree_table_batch_transaction: operations across multiple tables on ONE selected TableGit target are atomic; any row conflict or commit/write failure leaves the batch unchanged. Canonical receipt is under .mcpgit/table-transactions.
- table.query/table_rows_get: exact committed revision/selected field projections for 1–100 keys, no fabricated global row count. table_query provides typed filtering, ordering and bounded pagination.
- replication/repo_sync_status: explicit fetched origin/main and ahead/behind are separate observations; no claim that local transaction commits automatically reach other hosts.
These are published contracts, not re-executed write tests in this stage.

## Layer B — Rust SOURCE observations, filesystem snapshot (not revision-pinned)
AWMCP read-only host-development/a_fs_read, concrete peer m4mac/ma, path /Users/youxianshi/code/mcpgit. No command execution, build, benchmarks, browser, or Git mutation on this host.
- Cargo.toml: Rust 2024 workspace includes crates/tablegit and crates/tablegit-sqlite-query, with git2/libgit2 dependency in the server package.
- crates/tablegit/src/lib.rs: layout::resolved_table_relative_path hashes logical table path under .mcpgit/tables; row_relative_path hashes row key into rows/<prefix>/<digest>.json; Row Object paths live under objects/<digest>/primary and objects/<digest>/named/<locator>. Receipt paths are separate.
- crates/tablegit/src/model.rs: explicit table field/row models, expected_row_version and row/Object operations.
- crates/tablegit/src/transaction.rs: opening comments explicitly say pure transaction planner, NO repository reads/locks/receipts/rollback/commits/cache management; those are MCPGit adapter concerns. Same-row version conflict is a planned outcome.
- crates/tablegit/src/index.rs: in-memory table indexes separate from row storage and locators.
- crates/tablegit-sqlite-query/src/lib.rs: read-only bounded SQLite composition over exact TableGit/search snapshots, not an authoritative SQLite write source.
No claim of an audited server-call graph or installed-commit parity is made from the unpinned file snapshot.

## Layer C — animated mechanism synthesis / explanatory inference
The six sections in tablegit/render_tablegit_scenes.py share one semantic stage table and emit desktop/mobile native SVG plus standard LRIGIT Shell page. A numbered table row, commit IDs, row_version values, and transaction keys in the art are illustrative, NOT read from the live repository. Scene line motion depicts state transitions; it does not replay real transactions. Text remains readable when paused or reduced motion is enabled.

The reasoning path is: (1) model Table/Row/Fields/owned Objects; (2) evaluate HEAD ancestry and Row version separately, show stale same-key rejection; (3) verify a one-target cross-table batch before one commit/ref update, or none on conflict; (4) reconcile unknown using the same transaction identity and actual receipts; (5) derive bounded queries and presentations from a fixed revision; (6) separately verify remote replication. A local commit is not cross-repo atomicity, a projection is not another fact authority, and a trap does not undo earlier successful commits.

## Open gates and ownership
Only research_domains/lrigit/tablegit/** and this new evidence note are owned by this SOURCE slice. Existing shared Shell/menu, former architecture and reader/player, previous G1 generated candidate and TableGit runtime/rows are unchanged. The original consumer/validator apply_patch refusal remains in force; G1 standalone QA fixture adoption/validator support and main/UI acceptance remain pending. No new implementation test, CDP/browser, MP4, or live TableGit mutation is executed here.
This SOURCE worktree is not proof of official hosted-site publication. Do not describe its branch push as main release or measured performance.