Skip to content

feat(diff): semantic annotation for diff pipeline (D-017)#14

Merged
PresenceWith merged 2 commits intodevelopfrom
feat/semantic-sync
Mar 13, 2026
Merged

feat(diff): semantic annotation for diff pipeline (D-017)#14
PresenceWith merged 2 commits intodevelopfrom
feat/semantic-sync

Conversation

@PresenceWith
Copy link
Copy Markdown
Owner

Summary

  • diff.ts: detectVizType() (file-level, S-1) + enrichWithSemanticHints() (separated from computeDiff, S-4) — mindmap semantic hints (위계 변경/독립화/재분류/개념 추가·제거/재정의) + multi-moved grouping (S-2)
  • vync-translator.md: Read returns 4-field structured format (요약/의도/확신/제안) instead of one-line summary; interpretation guide with confidence levels
  • vync.md: Read procedure expanded with confidence-level behavior (높음→반영, 중간→확인, 낮음→간략 언급, S-3)
  • DECISIONS.md: D-017 implementation details (S-1~S-4) + D-018 (one file = one viz type)

Design Decisions

  • S-1: File-level viz type detection (D-018 prevents mixed canvases)
  • S-2: Only multi-moved grouping in Phase 1 (moved+modified deferred)
  • S-3: Low confidence → brief mention (safer than ignoring)
  • S-4: enrichWithSemanticHints() separated from computeDiff() (test isolation)

Test Plan

  • 15 new tests for detectVizType + enrichWithSemanticHints + formatted output
  • 16 existing computeDiff tests unchanged (S-4 verified)
  • 93 total tests pass (0 failures)
  • Manual: /vync read with mindmap node move → verify semantic hint in diff output
  • Manual: Translator returns 4-field structured response

🤖 Generated with Claude Code

PresenceWith and others added 2 commits March 13, 2026 19:02
Add visualization-type-aware semantic hints to structural diffs,
enabling the translator sub-agent to infer user intent more reliably.

- DiffChange.semanticHint field + VizType type
- detectVizType(): file-level viz type detection (S-1)
- enrichWithSemanticHints(): separated from computeDiff (S-4)
- Multi-moved grouping pattern detection (S-2)
- formatDiffResult includes hint lines (→ prefix)
- Translator Read returns 4-field structured format (요약/의도/확신/제안)
- vync.md Read procedure: confidence-level behavior guide (S-3)
- D-018: one file = one viz type policy

15 new tests (31 total diff tests), 93 total tests pass.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add Semantic Sync section to PLAN.md (SS.1-SS.10 checklist, all complete).
Update ARCHITECTURE.md diff test count (15→31, D-017 semantic hints).
Include semantic sync E2E test plan.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@PresenceWith PresenceWith merged commit c0aa6fe into develop Mar 13, 2026
1 check passed
@PresenceWith PresenceWith deleted the feat/semantic-sync branch March 13, 2026 16:06
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.

1 participant