Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# 👮‍♂️ CODEOWNERS
# This file defines the "God Mode" approvals.

# Global Owner (The Founder)
* @Carturo8

# Governance (Strict Control)
/.github/ @Carturo8

# Translations (The Council can review)
/es/ @Carturo8
13 changes: 13 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "monthly"
groups:
dependencies:
patterns:
- "*"
labels:
- "chore"
- "dependencies"
9 changes: 9 additions & 0 deletions .github/markdown-link-check-config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"ignorePatterns": [
{
"pattern": "^http://localhost"
}
],
"timeout": "20s",
"retryOn429": true
}
30 changes: 30 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
name: ⚡ CI - Quality Guard

on:
pull_request:
branches: [ "main", "develop" ]
push:
branches: [ "main", "develop" ]

permissions:
contents: read

jobs:
markdown-lint:
name: 📝 Lint Markdown
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4

- name: Check for Broken Links
uses: gaurav-nelson/github-action-markdown-link-check@v1
with:
use-quiet-mode: 'yes'
config-file: '.github/markdown-link-check-config.json'
folder-path: '.'

- name: Lint Markdown Structure
uses: DavidAnson/markdownlint-cli2-action@v16
with:
globs: "**/*.md"
33 changes: 33 additions & 0 deletions .github/workflows/scorecard.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
name: 🛡️ Security Scorecard

on:
branch_protection_rule:
schedule:
- cron: '00 0 * * 1'
push:
branches: [ "main" ]

permissions: read-all

jobs:
analysis:
name: Scorecard analysis
runs-on: ubuntu-latest
permissions:
security-events: write
id-token: write
contents: read
actions: read

steps:
- name: "Checkout code"
uses: actions/checkout@v4
with:
persist-credentials: false

- name: "Run analysis"
uses: ossf/scorecard-action@v2.3.1
with:
results_file: results.sarif
results_format: sarif
publish_results: true
23 changes: 23 additions & 0 deletions .github/workflows/stale.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: 🧹 Stale Bot (Housekeeper)

on:
schedule:
- cron: '30 1 * * *'

permissions:
issues: write
pull-requests: write

jobs:
stale:
runs-on: ubuntu-latest
steps:
- uses: actions/stale@v9
with:
stale-issue-message: 'This issue is stale because it has been open 60 days with no activity. Remove stale label or comment or this will be closed in 7 days.'
stale-pr-message: 'This PR is stale because it has been open 45 days with no activity.'
close-issue-message: 'This issue was closed because it has been stalled for 7 days with no activity.'
days-before-stale: 60
days-before-close: 7
days-before-pr-stale: 45
days-before-pr-close: 7
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1 +1 @@
governance/
interno/
14 changes: 14 additions & 0 deletions .markdownlint.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"default": true,
"MD013": false,
"MD026": {
"punctuation": ".,;!"
},
"MD033": false,
"MD041": false,
"MD030": false,
"MD001": false,
"MD042": false,
"MD022": false,
"MD032": false
}
3 changes: 3 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ We strictly adhere to a **modified GitFlow**.
* Example: `feature/add-pdf-compression`

### Other Branch Types

* `fix/` - For bug fixes.
* `hotfix/` - For critical production bugs (merges to main).
* `chore/` - Maintenance, dependencies, config.
Expand All @@ -33,6 +34,7 @@ We use **Conventional Commits**. Your commit messages must follow this structure
```

**Types:**

* `feat`: A new feature
* `fix`: A bug fix
* `docs`: Documentation only changes
Expand All @@ -53,6 +55,7 @@ We use **Conventional Commits**. Your commit messages must follow this structure
4. **Review**: Wait for approval from The Council or The Founder.

## 🚫 What We Reject

* Spaghetti code.
* Commits named "fix", "update", "wip".
* Secrets associated with code (API Keys, Credentials).
Expand Down
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,10 @@ Files located here are automatically applied to all repositories within the **Hl
* **Public Profile:** [profile/README.md](./profile/README.md) handles the landing page description.
* **Standards:** Stores `CONTRIBUTING`, `CODE_OF_CONDUCT`, and `SECURITY` policies.

## 🗺️ Navigation
* [Community Standards](./CONTRIBUTING.md)
* [Español (Documentación)](./es/profile/README.md)
* [Community Standards (Contributing)](./CONTRIBUTING.md)
* [Code of Conduct](./CODE_OF_CONDUCT.md)
* [Security Policy](./SECURITY.md)
* [Español (Documentación)](./es/README.md)

---
*Maintained by **The Founder**.*
2 changes: 2 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,13 @@ We only support the latest version of our utilities.
**DO NOT** report security vulnerabilities through public GitHub issues.

### The Protocol

1. **Direct Contact**: Email **The Founder** directly or open a **Security Advisory** in the repository (if enabled).
2. **Encryption**: If possible, encrypt your message.
3. **Embargo**: Do not disclose the issue publicly until we have issued a `hotfix`.

### Response

* We categorize vulnerabilities as **Threat Level: Giants** (Critical) or **Threat Level: Trolls** (Minor).
* You will receive an acknowledgment within 48 hours.
* Once fixed, you will be credited in the Hall of Valor (Release Notes).
Expand Down
23 changes: 13 additions & 10 deletions es/CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,19 +8,19 @@ En interés de fomentar un ambiente abierto y acogedor, nosotros como contribuye

Ejemplos de comportamiento que contribuyen a un ambiente positivo incluyen:

* Uso de lenguaje acogedor e inclusivo
* Ser respetuoso con diferentes puntos de vista y experiencias
* Aceptar elegantemente las críticas constructivas
* Enfocarse en lo que es mejor para la comunidad
* Mostrar empatía hacia otros miembros de la comunidad
* Uso de lenguaje acogedor e inclusivo
* Ser respetuoso con diferentes puntos de vista y experiencias
* Aceptar elegantemente las críticas constructivas
* Enfocarse en lo que es mejor para la comunidad
* Mostrar empatía hacia otros miembros de la comunidad

Ejemplos de comportamiento inaceptable por parte de los participantes incluyen:

* El uso de lenguaje o imágenes sexualizadas y atención o avances sexuales no deseados
* Troleo, comentarios insultantes/despectivos y ataques personales o políticos
* Acoso público o privado
* Publicar información privada de otros, como una dirección física o electrónica, sin permiso explícito
* Otra conducta que razonablemente podría considerarse inapropiada en un entorno profesional
* El uso de lenguaje o imágenes sexualizadas y atención o avances sexuales no deseados
* Troleo, comentarios insultantes/despectivos y ataques personales o políticos
* Acoso público o privado
* Publicar información privada de otros, como una dirección física o electrónica, sin permiso explícito
* Otra conducta que razonablemente podría considerarse inapropiada en un entorno profesional

## Protocolos

Expand All @@ -29,3 +29,6 @@ Ejemplos de comportamiento inaceptable por parte de los participantes incluyen:
## Cumplimiento

Instancias de comportamiento abusivo, acosador o inaceptable pueden ser reportadas contactando al equipo del proyecto. Todas las quejas serán revisadas e investigadas y resultarán en una respuesta que se considere necesaria y adecuada a las circunstancias. El equipo del proyecto está obligado a mantener la confidencialidad con respecto al reportante de un incidente.

---
**[English]** For the English version of this code, see: [CODE_OF_CONDUCT.md](../CODE_OF_CONDUCT.md)
3 changes: 3 additions & 0 deletions es/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,6 @@ Usamos **Conventional Commits**. Tus mensajes de commit deben seguir esta estruc
* Commits llamados "fix", "update", "wip".
* Secretos en el código (API Keys, Credenciales).
* Conducta irrespetuosa.

---
**[English]** For the English version of this guide, see: [CONTRIBUTING.md](../CONTRIBUTING.md)
4 changes: 3 additions & 1 deletion es/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,9 @@ Los archivos ubicados aquí se aplican automáticamente a todos los repositorios
* **Estándares:** Almacena políticas de `CONTRIBUTING`, `CODE_OF_CONDUCT`, y `SECURITY`.

## 🗺️ Navegación
* [Estándares Comunitarios](../es/CONTRIBUTING.md)
* [Estándares Comunitarios (Contribución)](./CONTRIBUTING.md)
* [Código de Conducta](./CODE_OF_CONDUCT.md)
* [Política de Seguridad](./SECURITY.md)
* [English (Documentation)](../README.md)

---
Expand Down
5 changes: 5 additions & 0 deletions es/SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,16 @@ Solo damos soporte a la última versión de nuestras utilidades.
**NO** reportes vulnerabilidades de seguridad a través de issues públicos de GitHub.

### El Protocolo

1. **Contacto Directo**: Envía un correo a **El Fundador** directamente o abre un **Aviso de Seguridad** en el repositorio (si está habilitado).
2. **Encriptación**: Si es posible, encripta tu mensaje.
3. **Embargo**: No divulgues el problema públicamente hasta que hayamos emitido un `hotfix`.

### Respuesta

* Categorizamos las vulnerabilidades como **Nivel de Amenaza: Gigantes** (Crítico) o **Nivel de Amenaza: Trolls** (Menor).
* Recibirás un acuse de recibo dentro de las 48 horas.
* Una vez solucionado, serás acreditado en el Salón del Valor (Notas de Lanzamiento).

---
**[English]** For the English version of this policy, see: [SECURITY.md](../SECURITY.md)
11 changes: 9 additions & 2 deletions es/profile/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Nuestro ecosistema está estrictamente limitado a **9 Servicios Interconectados*

| Reino | Estado | Designación | Función |
| :--- | :--- | :--- | :--- |
| **Vanaheim** | ✨ Activo | [`simulation-audio-generator`](https://github.com/Hlid-Systems/simulation-audio-generator) | **TTS e Inteligencia de Audio** |
| **Jotunheim** | 🔨 Activo | [`text-to-pdf-service`](https://github.com/Hlid-Systems/text-to-pdf-service) | **Transformador de Documentos y PDF** |
| **Vanaheim** | ✨ Activo | `simulation-audio-generator` | **TTS e Inteligencia de Audio** |
| **Jotunheim** | 🔨 Activo | `text-to-pdf-service` | **Transformador de Documentos y PDF** |
| **Midgard** | 🌫️ TBD | `[REDACTADO]` | *Oculto en la niebla* |
| **Muspelheim**| 🌫️ TBD | `[REDACTADO]` | *Oculto en la niebla* |
| **Niflheim** | 🌫️ TBD | `[REDACTADO]` | *Oculto en la niebla* |
Expand All @@ -34,22 +34,29 @@ Nuestro ecosistema está estrictamente limitado a **9 Servicios Interconectados*
---

### 🛠️ El Estándar Técnico

Somos **Agnósticos Tecnológicamente** e **Impulsados por IA**. No nos limitamos a un solo stack; empuñamos la herramienta correcta para el trabajo, amplificada por Inteligencia Artificial moderna.

* **Núcleo de Ingeniería:** GitFlow (Ramas estrictas), Conventional Commits, Protocolo de Anulación del Dueño.
* **Lenguajes:** Políglota (Python, Java, TypeScript, Lenguajes de Sistema).
* **Infraestructura:** Cloud-Native y Serverless.

### 🔒 Política de Seguridad

Tomamos la seguridad de nuestras utilidades muy en serio.

* **Sin Secretos:** Imponemos estrictamente el uso de variables de entorno.
* **Escaneo de Dependencias:** Verificaciones de vulnerabilidad automatizadas.
* **Reportes:** Si encuentras una vulnerabilidad, por favor abre un aviso privado o contacta directamente a El Consejo.

### ⚖️ Licencia

* **Utilidades Públicas:** Código Abierto (**Licencia MIT**) — Gratis para que la comunidad aprenda y use.
* **Datos Centrales:** Propietario (**Hlid Systems - Todos los derechos reservados**).

---
*"No solo encontramos el futuro; lo construimos."*
**[Equipo Hlid Systems]**

---
**[English]** English Version: [profile/README.md](../../profile/README.md)
3 changes: 3 additions & 0 deletions es/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,3 +24,6 @@
- [ ] He comentado mi código, particularmente en áreas difíciles de entender.
- [ ] He realizado los cambios correspondientes en la documentación.
- [ ] Mis cambios no generan nuevas advertencias.

---
<!-- [English] See English template: ../pull_request_template.md -->
11 changes: 9 additions & 2 deletions profile/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Our ecosystem is strictly scoped to **9 Interconnected Services**.

| Realm | Status | Designation | Function |
| :--- | :--- | :--- | :--- |
| **Vanaheim** | ✨ Active | [`simulation-audio-generator`](https://github.com/Hlid-Systems/simulation-audio-generator) | **TTS & Audio Intelligence** |
| **Jotunheim** | 🔨 Active | [`text-to-pdf-service`](https://github.com/Hlid-Systems/text-to-pdf-service) | **Document & PDF Transformer** |
| **Vanaheim** | ✨ Active | `simulation-audio-generator` | **TTS & Audio Intelligence** |
| **Jotunheim** | 🔨 Active | `text-to-pdf-service` | **Document & PDF Transformer** |
| **Midgard** | 🌫️ TBD | `[REDACTED]` | *Hidden in the mist* |
| **Muspelheim**| 🌫️ TBD | `[REDACTED]` | *Hidden in the mist* |
| **Niflheim** | 🌫️ TBD | `[REDACTED]` | *Hidden in the mist* |
Expand All @@ -34,22 +34,29 @@ Our ecosystem is strictly scoped to **9 Interconnected Services**.
---

### 🛠️ The Tech Standard

We are **Technology Agnostic** and **AI-Driven**. We do not limit ourselves to a single stack; we wield the right tool for the job, amplified by modern Artificial Intelligence.

* **Engineering Core:** GitFlow (Strict Branching), Conventional Commits, Owner-Override Protocol.
* **Languages:** Polyglot (Python, Java, TypeScript, System Languages).
* **Infrastructure:** Cloud-Native & Serverless.

### 🔒 Security Policy

We take the security of our utilities seriously.

* **No Secrets:** We strictly enforce environment variable usage.
* **Dependency Scanning:** Automated vulnerability checks.
* **Reporting:** If you find a vulnerability, please open a private advisory or contact The Council directly.

### ⚖️ License

* **Public Utilities:** Open Source (**MIT License**) — Free for the community to learn from and use.
* **Core Data:** Proprietary (**Hlid Systems - All Rights Reserved**).

---
*"We do not just find the future; we build it."*
**[Hlid Systems Team]**

---
**[Español]** Versión en Español: [es/profile/README.md](../es/profile/README.md)