GHCP -- Walk: Ex1 Repo Orientation and Architecture Map

[neha-p6]

Summary

• Updated ai-track-docs/architecture.mmd from a placeholder to a fully mapped diagram: every node now includes its real repo path (components/main-chef-wrapper/main.go, cmd/root.go, commands/automate_config.go, etc.)
• Added three annotated flows: dependency flow (imports/registers), invocation flow (user entry points), and two data flows (CLI passthrough → Chef Infra Server; telemetry trigger → Automate HTTP POST via TLS)
• Added scripts/validate-diagram.sh: tries mmdc if installed, falls back to 6 grep-based syntax checks; exits non-zero on failure
• Added .github/workflows/validate-diagram.yml: installs @mermaid-js/mermaid-cli and runs the script on every PR that touches ai-track-docs/
• Plan: Inline above – map nodes → paths first, layer flows second, add CI validation last

Files/paths touched

• ai-track-docs/architecture.mmd
• scripts/validate-diagram.sh
• .github/workflows/validate-diagram.yml

Evidence

$ bash scripts/validate-diagram.sh
==> Validating .../ai-track-docs/architecture.mmd
==> mmdc not found – running lightweight syntax checks
  [PASS] graph directive present
  [PASS] at least one subgraph
  [PASS] at least one node label
  [PASS] at least one dependency arrow
  [PASS] at least one data-flow arrow
  [PASS] file path reference in node
==> Syntax checks PASSED

• Coverage: doc-only change; no source coverage delta

Risk & Rollback

• Risk: low (doc + script only, no source code changed)
• Rollback: git revert feda5260

Review Focus

• Confirm node labels correctly reflect actual file paths
• Run bash scripts/validate-diagram.sh locally to confirm green output
• Check .github/workflows/validate-diagram.yml path-filter triggers as expected

Track

• Level: Walk
• Exercise: Ex1