fix(website): uglyURLs on main, update documentation

[alex-dna-tech]

Description

Completes the website's migration from the Jekyll-era docs layout to the Hugo content/en tree. The docs site previously shipped pages from two parallel trees (docs/.md plus docs/overview//index.md and docs/index.md symlinks), which produced duplicate URLs and broken links. This change collapses everything to a single canonical tree, switches cross-references from .html to .md/index.md targets, drops the old vanity-redirect machinery, and updates the docs wayfinding tests to the new layout.
What changed

• Drop Jekyll vanity redirects (37c5da9) — remove scripts/add-aliases.py, scripts/data/vanity.yaml, and the stale about page; fix the remaining .html links on the main page for uglyURLs mode.
• Fix contributing paths (08e2603) — CONTRIBUTING.md and the contributing docs now point at the real post-migration file locations instead of Jekyll-era paths.
• Dedupe duplicate pages (db247da) — every doc title resolves to one canonical page. Keeps directory-index pages with bundled images, drops draft copies, removes the docs/index.md/docs/examples/index.md symlinks, and standardizes on _index.md for section landings.
• Merge the duplicate tree (2250d78) — moves pages out of docs/overview/ into the canonical docs locations, deletes the now-empty overview tree, and consolidates the ADRs under docs/project/architecture/.
• Fix links + tests (2dcb452) — replaces all Jekyll-era .html cross-links with .md/index.md targets across the docs, fixes relative paths for pages moved into Hugo bundles, restores the ADR files, and updates the internal/harness/zero-to-hero-ci/docs_test.go wayfinding tests to the content/en/docs layout.
• Realign CLI docs test (bf03da1) — cmd/micro/first_agent_walkthrough_test.go now expects the new .md guide links in the docs and translates .md → .html when comparing against the first-agent CLI output (which still emits .html breadcrumbs), keeping README/website/CLI breadcrumbs aligned.

Net effect

112 files changed across upstream/master..origin/master: +498 / −5022, almost entirely website docs, scripts, and the two docs-wayfinding test suites.

Testing

• go build ./...
• go test ./cmd/micro/... (first-agent walkthrough contract)
• go test ./internal/harness/zero-to-hero-ci/... (docs wayfinding, guide chains, canonical trail)
• make docs-wayfinding

[alex-dna-tech]

Duplicate frontmatter titles in internal/website/content/en/

Duplicate Title	File 1	File 2
Agent Guardrails	blog/news/agent-guardrails.md	docs/guides/agent-guardrails.md
AI Integration	docs/ai-integration.md	docs/overview/ai-integration/index.md
Architecture	docs/architecture.md	docs/overview/architecture/index.md
Architecture Decision Records	docs/architecture/index.md	docs/project/architecture/_index.md
Broker	docs/broker.md	docs/interfaces/broker/index.md
Configuration	docs/config.md	docs/overview/config/index.md
Contributing	docs/contributing.md	docs/guides/contributing.md, docs/project/contributing.md
Documentation	docs/_index.md	docs/index.md
Examples	docs/examples/_index.md	docs/examples/index.md
Getting Started	docs/getting-started.md	docs/overview/getting-started/index.md
Hello Service	docs/examples/hello-service.md	docs/examples/learn-by-examples/hello-service.md
Observability	docs/observability.md	docs/overview/observability/index.md
Performance Considerations	docs/overview/performance.md	docs/performance.md
Plugins	docs/interfaces/plugins.md	docs/plugins.md
Pub/Sub with NATS Broker	docs/examples/learn-by-examples/pubsub-nats.md	docs/examples/pubsub-nats.md
Quick Start	docs/guides/quickstart.md	docs/quickstart.md
Registry	docs/interfaces/registry/index.md	docs/registry.md
Roadmap	docs/project/roadmap.md	docs/roadmap.md
Service Discovery with Consul	docs/examples/learn-by-examples/registry-consul.md	docs/examples/registry-consul.md
Store	docs/interfaces/store.md	docs/store.md
Summary: Reflection Removal Evaluation	docs/overview/REFLECTION-EVALUATION-SUMMARY.md	docs/REFLECTION-EVALUATION-SUMMARY.md
TLS Security Update - Important Information	docs/overview/TLS_SECURITY_UPDATE.md	docs/TLS_SECURITY_UPDATE.md
Transport	docs/interfaces/transport/index.md	docs/transport.md

All paths are relative to internal/website/content/en/. 23 duplicated titles across 47 files (Contributing has 3 copies).

[alex-dna-tech]

What It Does: Hugo uses index.md for single pages containing bundled resources, and _index.md for parent section pages that list multiple subpages.

Why People Use It: It organizes content clearly, separating standalone pages with media resources from directory-style parent pages that aggregate and list other child content.

HOW TO USE IT

Most Common Syntax: Create an index.md for a single content bundle or a _index.md for a section listing page within your content directory.

COMMON USE CASES

For Creating a Standalone Page with Media Resources: content/blog-post/index.md
For Creating a Parent Section Listing Subpages: content/blog/_index.md
For Processing and Resizing Page-Bundled Images: {{ (.Resources.Get "image.jpg").Resize "600x webp" }}

MOST IMPORTANT AND USED OPTIONS AND FEATURES

• index.md: Defines a leaf bundle (single page) which allows you to store associated assets like images and documents directly alongside the markdown file for easy processing.
• _index.md: Defines a branch bundle (parent page) which enables you to add front matter, content, and templates for listing and organizing multiple subpages.
• Page Resources: Allows index.md to manipulate bundled assets, such as converting images to WebP format and resizing them dynamically within your templates.

[alex-dna-tech]

@asim ready to review