archi-semantic-core

@cda/archi-semantic-core es la librería fundacional del ecosistema CDA: lee los archivos de modelo .archimate nativos de Archi y expone su semántica a través de un ArchiModel pequeño y tipado.

¿Qué es?

Un analizador TypeScript del formato nativo .archimate utilizado por el editor de escritorio Archi — tanto la variante de XML plano como la de archivo zip. Sin reinterpretación, sin normalización con pérdida: un modelo significa lo que la herramienta de modelado almacenó.

¿Por qué usarla?

Porque sus pipelines, reglas de gobernanza y herramientas necesitan la arquitectura como datos tipados y validados en lugar de un formato de archivo cerrado. El principio central de CDA es la fidelidad por encima de la conveniencia — la API preserva la semántica nativa y documenta sus límites con honestidad.

Instale

npm install @cda/archi-semantic-core

Requisitos: Node.js ^20 || ^22 || >=24, solo ESM. Los tipos de TypeScript están incluidos en el paquete; no se necesita ningún @types/* aparte. Consulte Instalación.

Véala funcionando

Analice un modelo, lea sus elementos y valídelo en pocas líneas:

import { parseArchiModel, validateArchiModel } from '@cda/archi-semantic-core';

const model = parseArchiModel(xmlText);
const { valid, errors } = validateArchiModel(model);

model.elements.map((e) => e.type); // ["BusinessActor", ...]

Ejecute el recorrido completo en unos cinco minutos: Inicio rápido.

Tareas comunes

• Analice su primer modelo — un ejemplo completo mínimo.
• Crear índices de búsqueda — acceso eficiente a elementos y relaciones.
• Análisis de impacto — recorra las relaciones desde un elemento.
• Validación estructural en CI — condicione pipelines a la integridad del modelo.
• Trabajo con modelos grandes — características y límites de rendimiento.

Referencia técnica

• Referencia de API — funciones y tipos, generados desde el paquete npm publicado.
• Matriz de compatibilidad — cobertura verificada de Archi/ArchiMate®.
• Limitaciones conocidas — lo que esta librería deliberadamente no hace.

Salud del proyecto

• Versión: v0.4.2 · Licencia: MIT
• Estado: estable (según la hoja de ruta)
• Node.js: ^20.0.0 || ^22.0.0 || >=24.0.0 · Formato de módulo: solo ESM
• TypeScript: tipos incluidos en el paquete
• npm: @cda/archi-semantic-core · publicado con procedencia OIDC
• Fuente: Continuous-DrivenArchitecture/archi-semantic-core
• Lanzamientos: Changelog

Contribuya

Los informes de errores con reproducciones mínimas de .archimate, fixtures y pruebas son las contribuciones más valiosas. Siga el archivo CONTRIBUTING del repositorio: archi-semantic-core.