From f8e7eb913b6f5ab4a4acbf463e4152a95963e3c7 Mon Sep 17 00:00:00 2001
From: weichen <weichen@local>
Date: Wed, 30 Sep 2026 03:15:58 +0000
Subject: [PATCH] Record the 2026-09-30 commit history migration

Why: the composition-wide message normalization rewrote ten repos; the
governed-migration rule requires bundle backups, archive refs, SHA maps, and
a recovery record in the process repo.
Evidence: per-repo commit counts and empty tree diffs captured during
execution; remote mains verified against local after force-push.
Impact: record-only; documents no product code. Also records the
multitenancy delivery defect (gitlinks pinning unpushed commits) and its
remediation.
Refs: Development-Guidelines 0.1.0-draft.7 multi-repo.md; Agent-System-Dev ef89fc8
---
 docs/records/2026-09-30-history-migration.md | 41 ++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/records/2026-09-30-history-migration.md

diff --git a/docs/records/2026-09-30-history-migration.md b/docs/records/2026-09-30-history-migration.md
new file mode 100644
index 0000000..4c50117
--- /dev/null
+++ b/docs/records/2026-09-30-history-migration.md
@@ -0,0 +1,41 @@
+# 2026-09-30 提交历史迁移记录（operation record）
+
+- 状态：已完成；执行者：weichen；授权：用户批准的全仓提交信息规范化（一次性历史迁移）
+- 规范依据：Development-Guidelines 0.1.0-draft.7 multi-repo.md「受控历史迁移例外」
+
+## 背景与决策
+
+提交格式升级为「英文祈使句主题行（≤100 列）+ Why/Evidence/Impact/Refs 四段 body」。用户明确选择全量改写既有历史而非仅向前生效；按新规范的安全网要求执行。
+
+## 执行与安全网
+
+1. 备份：各仓全量 bundle 存于迁移工作机 backups-2026-09-30/（<repo>-pre-rewrite.bundle）；远端归档引用 refs/rewrite-backup/pre-2026-09-30 指向改写前各仓 main。
+2. 工具：git-filter-repo 2.47.0，仅改 message（超长单行拆主题行+原文完整保留于 Details 段；多行消息不动）；作者/日期/树零变化。
+3. 校验：逐仓提交数一致、与备份 bundle 的树 diff 为空（父仓仅 gitlink 变化）；逐仓远端 main 与本地比对确认。
+4. 父仓：gitlink 同步重映射到子仓新 SHA，历史各提交保持可物化。
+
+## 迁移中发现并处置的交付缺陷
+
+父仓 a7617d4（多租户交付）的 4 个模块 gitlink 指向仅存在于本机子仓目录、从未推送远端的提交（core 019617e 等，共 9 条链），违反 multi-repo.md「依赖必须可从批准的远端获取」。处置：以 format-patch/am 将链重放到改写后子仓 main 并推送（消息同步规范化），父仓重映射钉住新 tip。该交付缺陷已按经验闭环流程另立 lesson。
+
+## 新旧 SHA 关键映射（tip 级）
+
+| 仓 | 旧 main | 新 main |
+|---|---|---|
+| Agent-Native | `292142ac1a8b125488794e9374faee2cb1c8c579` | `f735f18a73f9c34173fcf15a56f6afd0bdeac966` |
+| Agent-Squad | `5454f7485e7cf8b7ea7432b3c3c680da8a99056e` | `b6ff0ab55f4a41bc1d945610637b24e72a6c2b34` |
+| Agent-Intent | `7d9d505d6523ecbf3b103c64d766f463769f4015` | `ad447c55de7e0f0aee9daa2b0ed5680669184099` |
+| Error-Code-System | `dbeed2f1b67eb417ce089e7033a228578fbbeb03` | `dbeed2f1b67eb417ce089e7033a228578fbbeb03` |
+| Logging-System | `2c5716fdcffbc4696fc0371afc70f39c44174201` | `2c5716fdcffbc4696fc0371afc70f39c44174201` |
+| Agent-System-Core | `c7ae99b13c659e8ec60eeb91386804c7ea2d1e57` | `40f73ddcac560294bc3a2b34e545decbc9f0de2a` |
+| Agent-System-Backend | `7a4d34fc8e11cc73f9a1b9027c115fdd118fb956` | `8ae5b2334a478d2c456559045f182f70cd09752c` |
+| Agent-System-Frontend | `9b8572aa7348c257eabb8940e4682d0a9e13f6a4` | `0c7466ae1543a981eec63c5e85c34eba1562f90a` |
+| Agent-System-Documents | `e0c783b1724678f64c155a6463af5f3b2281fa2b` | `b1835113937979274809509e12b564fc5b98c0b9` |
+| Agent-System-Releases | `a3ec7430fc0f651a755576b2c45cf7e6fd2c657f` | `fed4ac83ea5f2cb244e58ad47796d938fa6face1` |
+| Agent-System-Dev（父仓） | `a7617d4cf024...` | `ef89fc8281761eb64413ad5fd9be68a0bd08755e` |
+
+全量提交级映射（filter-repo commit-map）留存于迁移工作机 backups-2026-09-30/mapping-*.txt；Releases 仓历史同步改写（fed4ac8 前为 a3ec743），其内容中引用的组件旧 SHA 以本记录为准对照。
+
+## 回退路径
+
+任一仓可从归档引用或 bundle 强推回旧历史，父仓 gitlink 复旧后重新物化；恢复须按 release-operations 记录 operation record。