v2.10.0 — Trunk-Based Architecture on master & Next-Gen AI Pipeline Hardening (2026-11-15)
This release marks the architectural migration of Awesome-Kubernetes from a two-branch GitFlow model (develop → master) to Trunk-Based Development (master as the single canonical trunk), alongside metadata-driven AI model selection, async critical asset auditing, and deduplicated CI/CD orchestration.
🏗️ Why Trunk-Based Development?
- Eliminates Scheduled Cron & Code Skew: GitHub Actions
schedule:crons always execute workflow YAML and checked-out code from the default branch (master). Consolidating ontomasterprevents subtle split-brain drift betweendevelopworkflow edits and scheduled production automation. - Zero Promotion Ceremony: Removes automated
develop → masterpromotion PR jobs (04.1,09) anddevelop ↔ masterartifact divergence while preserving PR Guardian + Markdown Linter quality gates on short-livedfeat/*/fix/*pull requests. - Single Source of Truth: Retired
origin/developcleanly after verifying zero unmerged commits (git log origin/master..origin/developempty).
🔄 Changed — CI/CD Workflows, Automation & Governance
- All 16 Workflows Retargeted to
master:- Updated
01.1,02.1,02.2,03.1,03.2,03.3,04.1,04.2,05.1,07.2,08.1,08.2, and09to check out, push, lint, target PRs against, and clean upmaster. - Updated
07.1.pr_guardian.ymlcomments andsrc/gitops_manager.py(default_branch_name = "master"),src/pr_guardian.py, andsrc/rss_generator.pyreferences to align with the single-trunk model. - Hardened
03.2.agentic_v2_ai.yml(workflow_run.branches: [master]),08.1.cleanup_merged_branches.yml(explicitpermissions, anchored exclusion regexorigin/(master|main|gh-pages|HEAD)$, andgit merge-base --is-ancestorverification), and09.weekly_digest.yml(git rebase --abortcleanup on push retry).
- Updated
- Deploy Storm Prevention & Deduplicated Pages Deployment (
06.1. Final Portal Deploy):- Scoped
on.push(master) to site-affecting paths (docs/**,v2-docs/**,mkdocs.yml,v2-mkdocs.yml,requirements.txt,.github/workflows/06.deploy_final.yml). - Added
on.workflow_runtriggers for04.1. V2 Publisherand09. Weekly Intelligence Digestonmaster, gated by aprecheckjob that skips skipped upstreampublish-v2jobs and deduplicates againstmasterhead_shaso[skip ci]bot publishes deploy exactly once.
- Scoped
- Removed Obsolete Promotion Steps: Dropped
Create or Update Promotion PR to Masterfrom04.1. V2 Publisherand09. Weekly Intelligence Digest. - Documentation & System Mandates Updated: Updated
CLAUDE.md,GEMINI.md(Mandates 18 & 48 + Learning Diary),src/ai_prompts/system_mandates.json(60mandates ingested),README.md(including §9.3 architecture Mermaid graph), andCHANGELOG.md.
✨ Added — AI Model Discovery, Async Critical Asset Monitor & Video Hub
- Metadata-Driven, Version-First Gemini Model Selector (
src/gemini_utils.py,tests/test_gemini_model_selector.py):- Replaced closed-world keyword allowlists and flat additive scoring with API metadata classification (
classify_model_metadata) and lexicographic tuple ranking (select_models_for_task). - Automatically adopts
gemini-4-hydrogen(fast),gemini-4-carbon/gemini-4-argon(frontier), API-described tiers, compound speed modifiers (ultra-fast,ultra-lite), unversioned alias handling (is_evergreen), and unseen future naming schemes (GEMINI_FAST_MODEL/GEMINI_PRO_MODELoverrides supported), with non-sticky fallback recovery after transient API errors.
- Replaced closed-world keyword allowlists and flat additive scoring with API metadata classification (
- Async Critical Asset Monitor (
src/critical_asset_monitor.py,tests/test_critical_asset_monitor.py,08.2.critical_asset_monitor.yml):- Extracted inline script logic into a per-host-throttled
httpx.AsyncClientauditor with backoff and GET confirmation, backed byinventory_manager(load_inventory/save_inventory), preservingreview_requireditems while recoveringoffline/deadentries and keepingdata/inventory.sqlanddata/inventory.yamlsynchronized.
- Extracted inline script logic into a per-host-throttled
- Pipeline Deduplication & Video Hub Hardening (
03.2→03.3→04.1,src/v2_video_portal.py):- Prevented overlapping duplicate runs across downstream
workflow_runtriggers via commit/job precheck deduplication and expanded Video Hub playlists (Enterprise AI, Agents & Agentic SRE,DevOps, IaC, and SRE,NVIDIA Kubernetes Engine (NVKE), andNVIDIA NVKR).
- Prevented overlapping duplicate runs across downstream
✅ Verification & Quality Gates
- PR #619 Quality Checks:
07.1. PR Guardian AI&07.2. Markdown Linterpassed before merge intomaster. - Live Trunk Execution on
master:05.1. README Automated Syncpassed onmasterpush (43710319580)07.2. Markdown Linterpassed onmasterpush (43710319582)08.1. Branch Lifecycle Cleanuppassed viaworkflow_dispatch --ref master(43710358938)06.1. Final Portal Deploy(precheck+Build Dual Versions+Deploy to GitHub Pages) passed onmaster(43710319597)
- Automated Test & Schema Suite:
10/10unit tests passing (tests/test_gemini_model_selector.py,tests/test_critical_asset_monitor.py),safety_readme.py(15/15),pre_commit_schema_check.py(0errors), all16GitHub Actions YAMLs valid, and V1 + V2 MkDocs builds green.