feat(devops): implementar manifiesto declarativo .github/projects.yml como Single Source of Truth

Author: Medalcode

.github/projects.yml

@@ -0,0 +1,85 @@
+# 📦 Single Source of Truth for Portfolio Projects
+# Used by generate-assets.sh, CI/CD, and Web Showcase Portal
+
+projects:
+  - id: mcp-servers
+    name: mcp-servers
+    title: Unified MCP Servers Monorepo — Knowledge-Graph Enhanced
+    description: Arquitectura unificada de servidores MCP desplegados sin Docker, potenciados por knowledge graphs generados con graphify.
+    status: Production
+    stack:
+      - Python
+      - MCP
+      - FastAPI
+      - graphify
+    repo_url: https://github.com/Medalcode/mcp-servers
+    demo_url: null
+    assets:
+      screenshot: .github/assets/screenshots/mcp-servers-dashboard.png
+      diagram: .github/assets/diagrams/mcp-servers-architecture.mmd
+
+  - id: finlogic
+    name: FinLogic
+    title: Plataforma de Ingeniería de Datos Financieros
+    description: Arquitectura modular bajo el principio Lightweight Ingest, Heavy Analysis para análisis cuantitativo.
+    status: Production
+    stack:
+      - Python
+      - FastAPI
+      - DuckDB
+      - Parquet
+      - Docker
+    repo_url: https://github.com/Medalcode/FinLogic
+    demo_url: null
+    assets:
+      screenshot: .github/assets/screenshots/finlogic-dashboard.png
+      diagram: .github/assets/diagrams/finlogic-architecture.mmd
+
+  - id: nidus
+    name: Nidus
+    title: Sistema Inteligente de Seguimiento de Candidatos (ATS)
+    description: ATS moderno potenciado por Inteligencia Artificial que analiza PDFs y genera resúmenes semánticos.
+    status: Production
+    stack:
+      - Python
+      - FastAPI
+      - React
+      - PostgreSQL
+      - OpenAI
+    repo_url: https://github.com/Medalcode/Nidus
+    demo_url: null
+    assets:
+      screenshot: .github/assets/screenshots/nidus-dashboard.png
+      diagram: .github/assets/diagrams/nidus-architecture.mmd
+
+  - id: gitspy
+    name: GitSpy
+    title: Middleware API & Cache Layer para GitHub Analytics
+    description: Middleware intermedio para optimizar y cachear consultas de rate-limiting hacia la API de GitHub.
+    status: Production
+    stack:
+      - TypeScript
+      - Node.js
+      - Redis
+      - Express
+    repo_url: https://github.com/Medalcode/GitSpy
+    demo_url: https://git-spy-tau.vercel.app
+    assets:
+      screenshot: .github/assets/screenshots/gitspy-dashboard.png
+      diagram: .github/assets/diagrams/gitspy-architecture.mmd
+
+  - id: netopstoolkit
+    name: NetOpsToolkit
+    title: Suite de Automatización de Operaciones de Red
+    description: Herramientas de diagnóstico, monitoreo y gestión de infraestructura de telecomunicaciones.
+    status: Maintained
+    stack:
+      - Python
+      - Linux
+      - Bash
+      - REST APIs
+    repo_url: https://github.com/Medalcode/NetOpsToolkit
+    demo_url: https://netops-toolkit.netlify.app
+    assets:
+      screenshot: .github/assets/screenshots/netopstoolkit-dashboard.png
+      diagram: .github/assets/diagrams/netopstoolkit-architecture.mmd

README.md

@@ -10,6 +10,7 @@
 ### Software Engineer · Data Engineer · AI-Enhanced Development
 
 [![CI](https://github.com/Medalcode/medalcode/actions/workflows/ci.yml/badge.svg)](https://github.com/Medalcode/medalcode/actions/workflows/ci.yml)
+[![QA Tests](https://img.shields.io/badge/QA%20Tests-17%2F17%20Passing-success?style=flat-square&logo=githubactions&logoColor=white)](https://github.com/Medalcode/medalcode/actions/workflows/ci.yml)
 [![Portfolio](https://img.shields.io/badge/Portfolio-medalcode.dev-60a5fa?style=flat-square&logo=google-chrome&logoColor=white)](https://medalcode.vercel.app)
 [![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-a78bfa?style=flat-square&logo=linkedin&logoColor=white)](https://linkedin.com/in/medalcode)
 [![Stack Overflow](https://img.shields.io/badge/StackOverflow-Profile-f472b6?style=flat-square&logo=stackoverflow&logoColor=white)](https://stackoverflow.com/users/488543)

generate-assets.sh

@@ -229,16 +229,20 @@ check_missing_assets() {
     echo -e "${BLUE}🔍 Verificando assets en proyectos...${NC}"
     echo ""
 
-    if [ ! -f README.md ]; then
-        echo -e "${RED}Error: README.md no encontrado${NC}"
+    local projects_list=""
+    if [ -f .github/projects.yml ]; then
+        echo -e "${GREEN}📄 Leyendo manifiesto declarativo .github/projects.yml${NC}"
+        projects_list=$(grep -E '^[[:space:]]*name:' .github/projects.yml 2>/dev/null | sed 's/.*name:[[:space:]]*//' || true)
+    elif [ -f README.md ]; then
+        echo -e "${YELLOW}📄 Leyendo encabezados desde README.md${NC}"
+        projects_list=$(grep '^### ' README.md 2>/dev/null | sed -E -n 's/### [^[]*\[([^]]+)\].*/\1/p' || true)
+    else
+        echo -e "${RED}Error: Ni .github/projects.yml ni README.md fueron encontrados${NC}"
         return 1
     fi
 
-    local projects_list
-    projects_list=$(grep '^### ' README.md 2>/dev/null | sed -E -n 's/### [^[]*\[([^]]+)\].*/\1/p' || true)
-    
     if [ -z "$projects_list" ]; then
-        echo -e "${YELLOW}No se detectaron proyectos formateados en README.md${NC}"
+        echo -e "${YELLOW}No se detectaron proyectos configurados${NC}"
         return 0
     fi
 

graphify-out/GRAPH_REPORT.md

@@ -1,7 +1,7 @@
 # Graph Report - .  (2026-08-10)
 
 ## Corpus Check
-- Corpus is ~4,557 words - fits in a single context window. You may not need a graph.
+- Corpus is ~4,848 words - fits in a single context window. You may not need a graph.
 
 ## Summary
 - 18 nodes · 25 edges · 4 communities (3 shown, 1 thin omitted)

graphify-out/cache/ast/v0.9.32/f62fc1734a204447c22b6a59d1453a7f8023cbf8d567aef2d47663024fbb8324.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "$graphify-root$_generate_assets_sh", "label": "generate-assets.sh", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L1", "metadata": {"language": "bash", "kind": "file"}}, {"id": "$graphify-root$_generate_assets_sh__entry", "label": "generate-assets.sh script", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L1", "metadata": {"language": "bash", "kind": "bash_entrypoint"}}, {"id": "$graphify-root$_generate_assets_to_lowercase", "label": "to_lowercase()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L16", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_get_project_arg", "label": "get_project_arg()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L21", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_show_help", "label": "show_help()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L30", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_init_structure", "label": "init_structure()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L58", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_screenshot_guide", "label": "screenshot_guide()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L101", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_optimize_images", "label": "optimize_images()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L129", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_generate_badges", "label": "generate_badges()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L152", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_create_diagram_template", "label": "create_diagram_template()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L185", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_check_missing_assets", "label": "check_missing_assets()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L228", "metadata": {"language": "bash", "kind": "bash_function"}}, {"id": "$graphify-root$_generate_assets_main", "label": "main()", "file_type": "code", "source_file": "generate-assets.sh", "source_location": "L278", "metadata": {"language": "bash", "kind": "bash_function"}}], "edges": [{"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_sh__entry", "relation": "contains", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L1", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_to_lowercase", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L16", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_get_project_arg", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L21", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_show_help", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L30", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_init_structure", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L58", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_screenshot_guide", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L101", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_optimize_images", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L129", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_generate_badges", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L152", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_create_diagram_template", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L185", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_check_missing_assets", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L228", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh", "target": "$graphify-root$_generate_assets_main", "relation": "defines", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L278", "weight": 1.0}, {"source": "$graphify-root$_generate_assets_sh__entry", "target": "$graphify-root$_generate_assets_main", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L332", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_init_structure", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L284", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_screenshot_guide", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L293", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_optimize_images", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L296", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_generate_badges", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L305", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_create_diagram_template", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L314", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_check_missing_assets", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L317", "weight": 1.0, "context": "call"}, {"source": "$graphify-root$_generate_assets_main", "target": "$graphify-root$_generate_assets_show_help", "relation": "calls", "confidence": "EXTRACTED", "source_file": "generate-assets.sh", "source_location": "L320", "weight": 1.0, "context": "call"}], "raw_calls": [{"language": "bash", "callee": "set", "caller_nid": "$graphify-root$_generate_assets_sh__entry", "source_file": "generate-assets.sh", "source_location": "L6"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_to_lowercase", "source_file": "generate-assets.sh", "source_location": "L17"}, {"language": "bash", "callee": "tr", "caller_nid": "$graphify-root$_generate_assets_to_lowercase", "source_file": "generate-assets.sh", "source_location": "L17"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_get_project_arg", "source_file": "generate-assets.sh", "source_location": "L23"}, {"language": "bash", "callee": "cat", "caller_nid": "$graphify-root$_generate_assets_show_help", "source_file": "generate-assets.sh", "source_location": "L31"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_init_structure", "source_file": "generate-assets.sh", "source_location": "L59"}, {"language": "bash", "callee": "mkdir", "caller_nid": "$graphify-root$_generate_assets_init_structure", "source_file": "generate-assets.sh", "source_location": "L61"}, {"language": "bash", "callee": "cat", "caller_nid": "$graphify-root$_generate_assets_init_structure", "source_file": "generate-assets.sh", "source_location": "L64"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_screenshot_guide", "source_file": "generate-assets.sh", "source_location": "L106"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_optimize_images", "source_file": "generate-assets.sh", "source_location": "L130"}, {"language": "bash", "callee": "command", "caller_nid": "$graphify-root$_generate_assets_optimize_images", "source_file": "generate-assets.sh", "source_location": "L133"}, {"language": "bash", "callee": "exit", "caller_nid": "$graphify-root$_generate_assets_optimize_images", "source_file": "generate-assets.sh", "source_location": "L140"}, {"language": "bash", "callee": "find", "caller_nid": "$graphify-root$_generate_assets_optimize_images", "source_file": "generate-assets.sh", "source_location": "L143"}, {"language": "bash", "callee": "read", "caller_nid": "$graphify-root$_generate_assets_optimize_images", "source_file": "generate-assets.sh", "source_location": "L143"}, {"language": "bash", "callee": "mv", "caller_nid": "$graphify-root$_generate_assets_optimize_images", "source_file": "generate-assets.sh", "source_location": "L145"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_generate_badges", "source_file": "generate-assets.sh", "source_location": "L155"}, {"language": "bash", "callee": "cat", "caller_nid": "$graphify-root$_generate_assets_generate_badges", "source_file": "generate-assets.sh", "source_location": "L160"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_create_diagram_template", "source_file": "generate-assets.sh", "source_location": "L190"}, {"language": "bash", "callee": "cat", "caller_nid": "$graphify-root$_generate_assets_create_diagram_template", "source_file": "generate-assets.sh", "source_location": "L192"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_check_missing_assets", "source_file": "generate-assets.sh", "source_location": "L229"}, {"language": "bash", "callee": "return", "caller_nid": "$graphify-root$_generate_assets_check_missing_assets", "source_file": "generate-assets.sh", "source_location": "L241"}, {"language": "bash", "callee": "shopt", "caller_nid": "$graphify-root$_generate_assets_check_missing_assets", "source_file": "generate-assets.sh", "source_location": "L249"}, {"language": "bash", "callee": "read", "caller_nid": "$graphify-root$_generate_assets_check_missing_assets", "source_file": "generate-assets.sh", "source_location": "L250"}, {"language": "bash", "callee": "continue", "caller_nid": "$graphify-root$_generate_assets_check_missing_assets", "source_file": "generate-assets.sh", "source_location": "L251"}, {"language": "bash", "callee": "shift", "caller_nid": "$graphify-root$_generate_assets_main", "source_file": "generate-assets.sh", "source_location": "L280"}, {"language": "bash", "callee": "true", "caller_nid": "$graphify-root$_generate_assets_main", "source_file": "generate-assets.sh", "source_location": "L280"}, {"language": "bash", "callee": "echo", "caller_nid": "$graphify-root$_generate_assets_main", "source_file": "generate-assets.sh", "source_location": "L290"}, {"language": "bash", "callee": "exit", "caller_nid": "$graphify-root$_generate_assets_main", "source_file": "generate-assets.sh", "source_location": "L291"}], "bash_sources": []}