mirror of https://github.com/prompt-security/clawsec.git synced 2026-06-13 05:28:02 +03:00

Files

T

David Abutbul b37162a33d feat(i18n): add multilingual wiki scaffolding, language switcher, and… (#212 )

* feat(i18n): add multilingual wiki scaffolding, language switcher, and translation QA pipeline

* docs(readme): adopt picoclaw-style multilingual link bar

* fix(i18n): repair localized index links and tighten partial-pair QA

* ci(i18n): fail on broken markdown links in README/wiki

* ci(i18n): add changed-files mode for markdown link checks

* i18n(de): use local Argos MT to fill untranslated German sections

* i18n(es,fr): fill untranslated sections via local Argos workflow

* i18n(ja): fill untranslated sections with scoped local Argos pass

* i18n(ko): fill untranslated sections with scoped local Argos pass

* fix(i18n): address review feedback

---------

Co-authored-by: David Abutbul <David.a@prompt.security>

2026-04-29 09:00:31 +03:00

6.8 KiB

Raw Blame History

Sinopsis

Propósito

ClawSec es un repositorio orientado a seguridad que combina un catálogo web público con habilidades de seguridad instalables para entornos OpenClaw, NanoClaw, Hermes y Picoclaw.
El codebase soporta tres rutas de entrega en paralelo: publicación de sitio estático, distribución de advisories firmados y empaquetado de releases por skill en GitHub.
Los usuarios principales son operadores de agentes, desarrolladores de skills y maintainers que ejecutan automatización de seguridad basada en CI.

Layout del repositorio

Puntos de entrada

Artefactos clave

| Artefacto | Producido por | Consumido por | Silencio. | advisories/feed.json | Poll NVD + workflows comunitarios | UI web, hook de clawsec-suite, instaladores. | | advisories/feed.json.sig | Pasos de firmado en workflow | Verificación de firma en tooling de suite/nanoclaw. | | public/skills/index.json | Workflow de deploy / script local | pages/SkillsCatalog.tsx y pages/SkillDetail.tsx. | | public/wiki/llms.txt + public/wiki/**/llms.txt | Script generador wiki + hooks de build | Exportes wiki para LLM enlazados desde la UI del wiki. | | public/checksums.json + public/checksums.sig | Workflow de deploy | Artefactos de integridad publicados para operadores y clientes runtime. | | release-assets/checksums.json | Workflow de release de skill | Consumidores de release que verifican integridad de zips. | | skills/*/skill.json | Autores de skills | Generación de catálogo del sitio, validadores y pipelines de release. |

Flujos clave

Desarrollo web local: npm install y luego npm run dev.
Preview local de datos de seguridad: ejecuta ./scripts/populate-local-skills.sh y ./scripts/populate-local-feed.sh antes de abrir /skills y /feed.
Quality gate pre-push: ejecuta ./scripts/prepare-to-push.sh (opcional --fix).
Ciclo de vida de skill: edita skills/<name>/, valida con python utils/validate_skill.py, y etiqueta <skill>-vX.Y.Z para disparar workflow de release.
Ciclo de advisories: el polling programado de NVD y la ingesta comunitaria por labels convergen en el mismo feed firmado.

Snippets de ejemplo

# UI local + datos locales poblados
npm install
./scripts/populate-local-skills.sh
./scripts/populate-local-feed.sh --days 120
npm run dev

# checks canónicos de TypeScript usados por CI
npx eslint . --ext .ts,.tsx,.js,.jsx,.mjs --max-warnings 0
npx tsc --noEmit
npm run build

Dónde empezar

Lee README.md para posicionamiento del producto y rutas de instalación.
Abre App.tsx y pages/ para entender el comportamiento de cara al usuario.
Abre skills/clawsec-suite/skill.json para entender el contrato de la suite y sus componentes embebidos.
Revisa .github/workflows/ci.yml, .github/workflows/pages-verify.yml, .github/workflows/skill-release.yml, .github/workflows/deploy-pages.yml y .github/workflows/wiki-sync.yml para el comportamiento productivo.

Cómo navegar

El comportamiento de UI está centrado en pages/; los wrappers visuales están en components/.
La lógica específica de cada skill está aislada por carpeta bajo skills/; cada carpeta incluye sus propios scripts/tests/docs.
El manejo de feeds aparece en tres capas: archivos feed del repositorio, updates de workflows y consumidores runtime (clawsec-suite/clawsec-nanoclaw).
Los quality gates operativos viven en scripts/ y en YAMLs de workflows.
Para trazas de generación y baseline de actualizaciones, empieza por wiki/GENERATION.md y luego ramifica hacia páginas de módulo.

Errores comunes

Usar tokens home literales (por ejemplo \$HOME) en variables de ruta puede disparar fallas de validación.
Solicitar JSON desde rutas SPA puede devolver HTML con status 200; las páginas lo tratan como estado vacío.
El modo bypass de feed no firmado (CLAWSEC_ALLOW_UNSIGNED_FEED=1) existe solo por compatibilidad de migración y no debe usarse en estado estable.
La automatización de release espera paridad de versión entre skill.json y frontmatter de SKILL.md.
Algunos scripts son POSIX-oriented; en Windows conviene PowerShell o WSL.

Notas de actualización

2026-04-27: Traducción inicial al español en wiki/es/ como fase 1.
2026-02-26: Layout actualizado para apuntar documentación operativa a wiki/ en lugar del directorio raíz docs/ (eliminado).

Referencias de código

README.md
README.es.md
package.json
App.tsx
index.tsx
pages/Home.tsx
pages/SkillsCatalog.tsx
pages/SkillDetail.tsx
pages/FeedSetup.tsx
scripts/prepare-to-push.sh
scripts/populate-local-feed.sh
scripts/populate-local-skills.sh
skills/clawsec-suite/skill.json
.github/workflows/ci.yml
.github/workflows/pages-verify.yml
.github/workflows/skill-release.yml
.github/workflows/deploy-pages.yml
.github/workflows/wiki-sync.yml

6.8 KiB Raw Blame History