Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 12 Pull Requests 4 Actions 6 Packages Projects Releases Wiki Activity

[gemma-4-multimodal] Multimodal Documentation Synthesis #1488

Open
Rockachopa wants to merge 1 commits from gemma4-worker-20260409-105326-1483 into main
pull from: gemma4-worker-20260409-105326-1483
merge into: Rockachopa:main
Conversation 0 Commits 1 Files Changed 1 +267
Rockachopa commented 2026-04-09 14:53:44 +00:00
Owner
Copy Link

Architecture Drift Detector

Closes: #1483

Summary

Adds a tool to detect drift between architecture diagrams and the actual codebase, using multimodal vision analysis on diagrams and code scanning on the source tree.

What's Added

scripts/doc_drift_detector.py

  • ArchitectureDriftDetector class — scans codebase for components
  • Supports Python, JavaScript/TypeScript, YAML, and shell scripts
  • Extracts component names, imports, and lines of code
  • Vision analysis prompt generation for diagram parsing
  • Drift detection comparing diagram components against code
  • Confidence scoring based on match rate
  • JSON and human-readable output modes

Usage

# Analyze a diagram and cross-reference with code
python scripts/doc_drift_detector.py --diagram docs/architecture.png --src src/

# Generate codebase-only report
python scripts/doc_drift_detector.py --report

# JSON output for CI integration
python scripts/doc_drift_detector.py --report --json
## Architecture Drift Detector **Closes:** #1483 ### Summary Adds a tool to detect drift between architecture diagrams and the actual codebase, using multimodal vision analysis on diagrams and code scanning on the source tree. ### What's Added **`scripts/doc_drift_detector.py`** - `ArchitectureDriftDetector` class — scans codebase for components - Supports Python, JavaScript/TypeScript, YAML, and shell scripts - Extracts component names, imports, and lines of code - Vision analysis prompt generation for diagram parsing - Drift detection comparing diagram components against code - Confidence scoring based on match rate - JSON and human-readable output modes ### Usage ```bash # Analyze a diagram and cross-reference with code python scripts/doc_drift_detector.py --diagram docs/architecture.png --src src/ # Generate codebase-only report python scripts/doc_drift_detector.py --report # JSON output for CI integration python scripts/doc_drift_detector.py --report --json ```
Rockachopa added 1 commit 2026-04-09 14:53:45 +00:00
feat: add architecture drift detector for multimodal doc synthesis
Some checks are pending
Tests / lint (pull_request) Waiting to run
Details
Tests / test (pull_request) Blocked by required conditions
Details
909bd0ec0d 
Cross-references architecture diagrams with codebase to find drift:
- Scans Python, JS/TS, YAML, shell scripts
- Extracts component names, imports, LOC
- Compares diagram components against code
- Generates drift reports with confidence scoring
- Vision analysis prompts for diagram parsing

Relates to #1483
Some checks are pending
Tests / lint (pull_request) Waiting to run
Details
Tests / test (pull_request) Blocked by required conditions
Details
This pull request can be merged automatically.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin gemma4-worker-20260409-105326-1483:gemma4-worker-20260409-105326-1483
git checkout gemma4-worker-20260409-105326-1483
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok kimi manus perplexity Rockachopa
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#1488
Delete Branch "gemma4-worker-20260409-105326-1483"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?