Skip to content

docs: phase 14 audit cluster B2 (Phase 14+ → 15+ unification + anchor links + outlook + mapper symmetry counts)#312

Merged
ozzy-3 merged 1 commit into
mainfrom
docs/phase-14-audit-cluster-b2
May 31, 2026
Merged

docs: phase 14 audit cluster B2 (Phase 14+ → 15+ unification + anchor links + outlook + mapper symmetry counts)#312
ozzy-3 merged 1 commit into
mainfrom
docs/phase-14-audit-cluster-b2

Conversation

@ozzy-3
Copy link
Copy Markdown
Contributor

@ozzy-3 ozzy-3 commented May 31, 2026

Summary

Phase 14 (epic #292) closeout 後の docs 反映漏れ audit cluster B2 (#307)。Phase 13 audit cluster B (#291) と同型で 4 sub-cluster (B2-a/b/c/d) を一括是正。

B2-a: Phase 14+ → Phase 15+ 統一 (forecast 表現のみ、historical narrative は preserve)

  • README.md / README.ja.md / AGENTS.md / docs/architecture.md / docs/repository-structure.md / docs/secretary-agent.md (5 箇所) / docs/google-workspace-setup.md
  • 「Phase 13 まで」「Phase 12 ではホスト側」等の時系列を「Phase 14 まで」に更新
  • docs/phase-12-plan.md / docs/phase-13-plan.md / docs/decisions-log.md の Phase 12/13 当時の forecast narrative は historical record として preserve

B2-b: anchor link 修正 (3 箇所)

  • phase-14-plan.md#1-decisions-snapshot#1-確定済み事項 (GitHub auto-slug 整合、docs/upgrading.md:461 の正しい使い方に揃え)
  • docs/upgrading.md L380 / L434, docs/google-workspace-setup.md L8

B2-c: docs/architecture.md L575 Phase 13 row outlook の Phase 14 反映

Drive Comments / Suggestions / 画像 OCR / multi-account / Drive files.watch / Gmail / Calendar push を Phase 15+ 表記に統一し、Drive files.watch + Gmail users.watch + Calendar events.watch を grouping (decisions-log §32 と整合)。

B2-d: mapper symmetry 数値 drift 是正 (実装 14 ケース vs docs「6+4=10」)

実態は tests/unit/connectors/test_mapper_symmetry.pyCalendar 6 + Mail 8 = 14 ケース (Issue body の「Pair 1 Calendar 7 + Pair 2 Mail 7」は誤りで、実関数 enumeration で確認)。

  • SECURITY.md / docs/secretary-agent.md §6.3.1 / docs/google-workspace-setup.md (2 箇所) / docs/decisions-log.md §32 / tests/integration/test_phase14_google_mail_calendar_lifecycle.py docstring

Test plan

  • uv run ruff check pass
  • uv run ruff format --check pass
  • uv run pytest tests/unit/connectors/test_mapper_symmetry.py tests/integration/test_phase14_google_mail_calendar_lifecycle.py = 19 passed
  • rg "Phase 14\+" で残存 hit は全て historical narrative (phase-12-plan.md / phase-13-plan.md / decisions-log.md / adr/0010 の Phase 13 当時の記述) のみであることを確認
  • phase-14-plan.md#1-確定済み事項 anchor が実 heading ## 1. 確定済み事項 (L15) と整合

Closes #307

…r links + outlook + mapper symmetry counts)

Phase 14 (epic #292) closeout 後の docs 反映漏れ audit cluster B2 (#307)。
Phase 13 audit cluster B (#291) と同型で、Phase 14+ forecast 表現を Phase 15+ に統一し、
phase-14-plan.md anchor link 切れ、architecture.md L575 Phase 13 row outlook の Phase 14 反映、
mapper symmetry の数値 drift を一括是正。

- B2-a: Phase 14+ -> Phase 15+ 統一 (forecast 表現のみ、historical narrative は preserve)
  - README.md / README.ja.md / AGENTS.md / docs/architecture.md / docs/repository-structure.md
    / docs/secretary-agent.md / docs/google-workspace-setup.md
  - 「Phase 13 まで」「Phase 12 ではホスト側」等の時系列を「Phase 14 まで」に更新
- B2-b: anchor link 修正 (3 箇所)
  - phase-14-plan.md#1-decisions-snapshot -> #1-確定済み事項 (GitHub auto-slug 整合)
  - docs/upgrading.md L380 / L434, docs/google-workspace-setup.md L8
- B2-c: docs/architecture.md L575 Phase 13 row outlook の Phase 14 反映
  - Drive Comments / Suggestions / 画像 OCR / multi-account / Drive files.watch / Gmail / Calendar push を
    Phase 15+ 表記に統一、push 系を grouping
- B2-d: mapper symmetry 数値 drift 是正 (実装 14 ケース vs docs「6+4=10」)
  - 実態 = Calendar 6 + Mail 8 = 14 ケース (tests/unit/connectors/test_mapper_symmetry.py)
  - SECURITY.md / docs/secretary-agent.md / docs/google-workspace-setup.md
    / docs/decisions-log.md / tests/integration/test_phase14_google_mail_calendar_lifecycle.py docstring

Refs: #307
@ozzy-3
Copy link
Copy Markdown
Contributor Author

ozzy-3 commented May 31, 2026

Quick self-review (Phase 3 pass 1)

Docs-only PR + 1 test docstring (assertion message text only). 19 unit/integration tests pass.

Findings

Axis Critical Warning Info
correctness 0 0 0
consistency 0 0 0
security 0 0 0
tests 0 0 0

Verification

  • Phase 14+ → 15+ substitutions limited to forecast text; historical narrative in phase-12-plan.md / phase-13-plan.md / decisions-log.md / adr/0010-connector-contract.md preserved as Phase 13/14 era records
  • anchor phase-14-plan.md#1-確定済み事項 matches actual heading ## 1. 確定済み事項 at L15
  • mapper symmetry count 14 = tests/unit/connectors/test_mapper_symmetry.py test function enumeration (6 Calendar + 8 Mail). Issue body's "7+7" was incorrect; PR uses actual implementation count
  • B2-c outlook column refactor in docs/architecture.md L575 aligns with decisions-log.md §32 Phase 15+ outlook re-evaluation

merge-ready.

@ozzy-3 ozzy-3 merged commit 02667d7 into main May 31, 2026
3 checks passed
@ozzy-3 ozzy-3 deleted the docs/phase-14-audit-cluster-b2 branch May 31, 2026 16:54
ozzy-3 pushed a commit that referenced this pull request May 31, 2026
🤖 I have created a release *beep* *boop*
---


## [0.2.6](v0.2.5...v0.2.6)
(2026-05-31)


### Added

* **connectors/google_calendar:** events api sync token + master event
mapper + override + cursor + fallback (Phase 14 G4)
([#301](#301))
([a4cefab](a4cefab))
* **connectors/google_mail:** gmail api history + message mapper +
cursor + fallback
([#303](#303))
([3c621c1](3c621c1))


### Changed

* **connectors/google_auth:** shared OAuth foundation + 3-scope
expansion (Phase 14 G2)
([#300](#300))
([bd74191](bd74191))


### Documentation

* **adr,plan:** adr-0010 + 0014 amendments + phase-14-plan (Gmail +
Google Calendar)
([#298](#298))
([f5d43c8](f5d43c8))
* phase 14 audit cluster B2 (Phase 14+ → 15+ unification + anchor links
+ outlook + mapper symmetry counts)
([#312](#312))
([02667d7](02667d7)),
closes [#307](#307)
* phase 14 audit cluster C (operator-facing docs vs code drift)
([#310](#310))
([bfefa82](bfefa82))
* phase 14 closeout (docs + e2e + status lines + phase-13 forecast
realign) ([#304](#304))
([ab0b792](ab0b792))
* **skills:** phase 14 audit cluster B1 (SKILL.md vocabulary 反映漏れ修正)
([#311](#311))
([16504fc](16504fc))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Phase 14 audit cluster B2: Phase 14+ → Phase 15+ 統一 batch + anchor link + outlook 整理

1 participant