npm - @donartcha/openlag - Versions diffs - 0.1.4 → 0.1.6 - Mend

@donartcha/openlag 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

package/dist/index.html CHANGED Viewed

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>My OpenLAG Project | OpenLAG</title>
     <meta name="description" content="Living Architecture documentation for my system." />
-    <script type="module" crossorigin src="/assets/index-wflyqKCW.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-D02phRy3.css">
+    <script type="module" crossorigin src="/assets/index-BxBZmqgf.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-BhnK9sdD.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@donartcha/openlag",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Architecture as Code traceability graph generator",
   "type": "module",
   "license": "MPL-2.0",

package/scripts/cli/init.ts CHANGED Viewed

@@ -85,8 +85,8 @@ export async function initProject(projectName?: string, projectDesc?: string, in
       content: `relation: IMPLEMENTS
 description: "Conecta implementación con necesidad funcional/técnica."
 category: TRACEABILITY
-allowedFrom: [CODE_ENTITY, COMPONENT, API, DATABASE_ENTITY, SYSTEM_VERSION]
-allowedTo: [REQUIREMENT, FEATURE, EPIC, DESIGN, USE_CASE, BUSINESS_RULE]
+allowedFrom: [CODE_ENTITY]
+allowedTo: [REQUIREMENT, FEATURE, BUG, API]
 multiplicity:
   from: many
   to: many
@@ -98,8 +98,8 @@ validation:
       content: `relation: TESTS
 description: "Conecta tests con comportamiento validado."
 category: TRACEABILITY
-allowedFrom: [TEST_CASE, TEST]
-allowedTo: [REQUIREMENT, FEATURE, EPIC, CODE_ENTITY, COMPONENT, API, DATABASE_ENTITY, BUG, INCIDENT]
+allowedFrom: [TEST_CASE]
+allowedTo: [CODE_ENTITY, REQUIREMENT, FEATURE, BUG, USE_CASE]
 multiplicity:
   from: many
   to: many
@@ -111,8 +111,8 @@ validation:
       content: `relation: REFINES
 description: "Descompone artefactos en otros más concretos."
 category: TRACEABILITY
-allowedFrom: [FEATURE, REQUIREMENT, BUG, RISK, DESIGN]
-allowedTo: [EPIC, FEATURE, PROJECT, BUSINESS_RULE, REQUIREMENT, DESIGN]
+allowedFrom: [EPIC, FEATURE, REQUIREMENT]
+allowedTo: [EPIC, FEATURE, REQUIREMENT]
 multiplicity:
   from: many
   to: many
@@ -124,8 +124,8 @@ validation:
       content: `relation: FIXES
 description: "Conecta correcciones con bugs o incidentes."
 category: TRACEABILITY
-allowedFrom: [CHANGE, CODE_ENTITY, COMPONENT, SYSTEM_VERSION]
-allowedTo: [BUG, INCIDENT, RISK]
+allowedFrom: [CODE_ENTITY, CHANGE, DECISION]
+allowedTo: [BUG, INCIDENT]
 multiplicity:
   from: many
   to: many
@@ -137,8 +137,8 @@ validation:
       content: `relation: DOCUMENTS
 description: "Conecta documentación con el artefacto descrito."
 category: SEMANTIC
-allowedFrom: [DOCUMENTATION, GLOSSARY_TERM]
-allowedTo: [PROJECT, EPIC, FEATURE, REQUIREMENT, BUSINESS_RULE, USE_CASE, DESIGN, DECISION, CODE_ENTITY, TEST_CASE, CHANGE, BUG, RISK, GLOSSARY_TERM, COMPONENT, API, DATABASE_ENTITY, TEST, DOCUMENTATION, INCIDENT, INFRASTRUCTURE, DEPLOYMENT, MONITORING, MAINTENANCE, SYSTEM_VERSION, VERSION]
+allowedFrom: [DOCUMENTATION]
+allowedTo: [PROJECT, EPIC, FEATURE, REQUIREMENT, BUSINESS_RULE, USE_CASE, DESIGN, DECISION, CODE_ENTITY, TEST_CASE, CHANGE, BUG, RISK, GLOSSARY_TERM, COMPONENT, API, DATABASE_ENTITY, DOCUMENTATION, INCIDENT, INFRASTRUCTURE, DEPLOYMENT, MONITORING, MAINTENANCE, SYSTEM_VERSION, VERSION, LIBRARY, ENVIRONMENT, CHECK, PROCESS, PIPELINE]
 multiplicity:
   from: many
   to: many
@@ -150,8 +150,8 @@ validation:
       content: `relation: JUSTIFIES
 description: "Conecta decisiones con aquello que justifican."
 category: SEMANTIC
-allowedFrom: [DECISION, BUSINESS_RULE, DOCUMENTATION, RISK]
-allowedTo: [DESIGN, REQUIREMENT, FEATURE, EPIC, PROJECT, CODE_ENTITY, COMPONENT, INFRASTRUCTURE, DEPLOYMENT, MAINTENANCE]
+allowedFrom: [DECISION]
+allowedTo: [DESIGN, REQUIREMENT, FEATURE, CODE_ENTITY, COMPONENT]
 multiplicity:
   from: many
   to: many
@@ -251,7 +251,7 @@ validation:
 description: "Averías o rupturas confirmadas."
 category: OPERATIONAL
 allowedFrom: [CHANGE, CODE_ENTITY, COMPONENT, SYSTEM_VERSION]
-allowedTo: [TEST_CASE, TEST, API, COMPONENT, REQUIREMENT, FEATURE]
+allowedTo: [TEST_CASE, API, COMPONENT, REQUIREMENT, FEATURE]
 multiplicity:
   from: many
   to: many
@@ -348,8 +348,8 @@ description: |
       type: RELATES_TO
       rationale: "No encaja con USES o DEPENDS_ON debido al contexto X."
 category: SEMANTIC
-allowedFrom: [PROJECT, EPIC, FEATURE, REQUIREMENT, BUSINESS_RULE, USE_CASE, DESIGN, DECISION, CODE_ENTITY, TEST_CASE, CHANGE, BUG, RISK, GLOSSARY_TERM, COMPONENT, API, DATABASE_ENTITY, TEST, DOCUMENTATION, INCIDENT, INFRASTRUCTURE, DEPLOYMENT, MONITORING, MAINTENANCE, SYSTEM_VERSION, VERSION]
-allowedTo: [PROJECT, EPIC, FEATURE, REQUIREMENT, BUSINESS_RULE, USE_CASE, DESIGN, DECISION, CODE_ENTITY, TEST_CASE, CHANGE, BUG, RISK, GLOSSARY_TERM, COMPONENT, API, DATABASE_ENTITY, TEST, DOCUMENTATION, INCIDENT, INFRASTRUCTURE, DEPLOYMENT, MONITORING, MAINTENANCE, SYSTEM_VERSION, VERSION]
+allowedFrom: [PROJECT, EPIC, FEATURE, REQUIREMENT, BUSINESS_RULE, USE_CASE, DESIGN, DECISION, CODE_ENTITY, TEST_CASE, CHANGE, BUG, RISK, GLOSSARY_TERM, COMPONENT, API, DATABASE_ENTITY, DOCUMENTATION, INCIDENT, INFRASTRUCTURE, DEPLOYMENT, MONITORING, MAINTENANCE, SYSTEM_VERSION, VERSION, LIBRARY, ENVIRONMENT, CHECK, PROCESS, PIPELINE]
+allowedTo: [PROJECT, EPIC, FEATURE, REQUIREMENT, BUSINESS_RULE, USE_CASE, DESIGN, DECISION, CODE_ENTITY, TEST_CASE, CHANGE, BUG, RISK, GLOSSARY_TERM, COMPONENT, API, DATABASE_ENTITY, DOCUMENTATION, INCIDENT, INFRASTRUCTURE, DEPLOYMENT, MONITORING, MAINTENANCE, SYSTEM_VERSION, VERSION, LIBRARY, ENVIRONMENT, CHECK, PROCESS, PIPELINE]
 multiplicity:
   from: many
   to: many

package/scripts/lint/lint-rules.ts CHANGED Viewed

@@ -127,7 +127,7 @@ export function runLintRules(data: OpenLagData, profile: LintProfile): LintIssue
         }
     }
-    if (artifact.type === 'TEST') {
+    if (artifact.type === 'TEST_CASE') {
         const hasReq = reqsByTest.has(artifact.id);
         if (!hasReq) {
             addIssue('orphanArtifact', `${artifact.id} is a test without associated requirement`, artifact.file, artifact.id, artifact.status);

package/src/components/DocumentationView.tsx CHANGED Viewed

@@ -1,16 +1,22 @@
 import React, { useMemo, useState, useEffect } from 'react';
 import { useStore } from '../store';
 import { Artifact } from '../types';
+import { getArtifactLayer, getArtifactOwner, getArtifactTeam } from '../utils/artifactUtils';
 import { Layers, FileText, FileCode2, ShieldCheck, ChevronRight, Search, GitPullRequest, Repeat, Box, Rocket, Activity, Wrench, Trash2, AlertCircle, Printer, Milestone, Bookmark, BookOpen } from 'lucide-react';
 import { MarkdownRenderer } from './MarkdownRenderer';
 const OwnershipBadge = ({ artifact }: { artifact: Artifact }) => {
-    if (!artifact.layer && !artifact.ownership?.owner && !artifact.ownership?.team) return null;
+    const { fullGraph } = useStore();
+    const computedLayer = getArtifactLayer(artifact);
+    const computedOwner = getArtifactOwner(artifact, fullGraph);
+    const computedTeam = getArtifactTeam(artifact, fullGraph);
+    if (!computedLayer && !computedOwner && !computedTeam) return null;
     return (
         <div className="flex gap-2 mb-3 mt-1 pointer-events-none">
-            {artifact.layer && <span className="text-[9px] text-purple-400 border border-purple-400/20 bg-purple-400/5 px-1.5 py-0.5 rounded-sm font-mono tracking-tighter">LAYER: {artifact.layer}</span>}
-            {artifact.ownership?.owner && <span className="text-[9px] text-blue-400 border border-blue-400/20 bg-blue-400/5 px-1.5 py-0.5 rounded-sm font-mono tracking-tighter">OWNER: {artifact.ownership?.owner}</span>}
-            {artifact.ownership?.team && <span className="text-[9px] text-emerald-400 border border-emerald-400/20 bg-emerald-400/5 px-1.5 py-0.5 rounded-sm font-mono tracking-tighter">TEAM: {artifact.ownership?.team}</span>}
+            {computedLayer && <span className="text-[9px] text-purple-400 border border-purple-400/20 bg-purple-400/5 px-1.5 py-0.5 rounded-sm font-mono tracking-tighter">LAYER: {computedLayer}</span>}
+            {computedOwner && <span className="text-[9px] text-blue-400 border border-blue-400/20 bg-blue-400/5 px-1.5 py-0.5 rounded-sm font-mono tracking-tighter">OWNER: {computedOwner}</span>}
+            {computedTeam && <span className="text-[9px] text-emerald-400 border border-emerald-400/20 bg-emerald-400/5 px-1.5 py-0.5 rounded-sm font-mono tracking-tighter">TEAM: {computedTeam}</span>}
         </div>
     );
 };
@@ -20,15 +26,12 @@ const PHASES = [
   { id: 'req', title: 'Requirements / Analysis', icon: FileText, types: ['REQUIREMENT', 'USE_CASE'] },
   { id: 'design', title: 'Architecture & Design', icon: Layers, types: ['DESIGN', 'COMPONENT', 'API', 'DATABASE_ENTITY'] },
   { id: 'dev', title: 'Development', icon: FileCode2, types: ['CODE_ENTITY', 'LIBRARY', 'ENVIRONMENT'] },
-  { id: 'review', title: 'Code Review', icon: GitPullRequest, types: ['CODE_ENTITY'] },
-  { id: 'ci', title: 'Continuous Integration', icon: Repeat, types: ['INFRASTRUCTURE', 'PIPELINE'] },
-  { id: 'verif', title: 'Testing / QA', icon: ShieldCheck, types: ['TEST', 'TEST_CASE', 'CHECK', 'BUG'] },
-  { id: 'build', title: 'Build / Packaging', icon: Box, types: ['INFRASTRUCTURE'] },
+  { id: 'ci', title: 'Continuous Integration / Build', icon: Repeat, types: ['PIPELINE', 'INFRASTRUCTURE'] },
+  { id: 'verif', title: 'Testing / QA', icon: ShieldCheck, types: ['TEST_CASE', 'CHECK', 'BUG'] },
   { id: 'deploy', title: 'Deployment', icon: Rocket, types: ['DEPLOYMENT'] },
   { id: 'monitor', title: 'Monitoring & Feedback', icon: Activity, types: ['MONITORING', 'INCIDENT'] },
   { id: 'docs', title: 'Documentation', icon: BookOpen, types: ['DOCUMENTATION'] },
   { id: 'maint', title: 'Maintenance / Refactoring', icon: Wrench, types: ['MAINTENANCE'] },
-  { id: 'retire', title: 'Retirement / Replacement', icon: Trash2, types: ['MAINTENANCE'] },
   { id: 'versions', title: 'Releases & Versions', icon: Milestone, types: ['VERSION', 'SYSTEM_VERSION', 'CHANGE'] },
 ];
@@ -53,9 +56,9 @@ export const DocumentationView: React.FC = () => {
   const filterOptions = useMemo(() => {
      if (!graph || !graph.artifacts) return { layers: [], owners: [], teams: [] };
-     const layers = Array.from(new Set(graph.artifacts.map(a => a.layer).filter(Boolean))) as string[];
-     const owners = Array.from(new Set(graph.artifacts.map(a => a.ownership?.owner).filter(Boolean))) as string[];
-     const teams = Array.from(new Set(graph.artifacts.map(a => a.ownership?.team).filter(Boolean))) as string[];
+     const layers = Array.from(new Set(graph.artifacts.map(a => getArtifactLayer(a)).filter(Boolean))) as string[];
+     const owners = Array.from(new Set(graph.artifacts.map(a => getArtifactOwner(a, graph)).filter(Boolean))) as string[];
+     const teams = Array.from(new Set(graph.artifacts.map(a => getArtifactTeam(a, graph)).filter(Boolean))) as string[];
      return { layers, owners, teams };
   }, [graph]);
@@ -133,9 +136,12 @@ export const DocumentationView: React.FC = () => {
     const filterByLayerAndOwnership = (list: Artifact[] = []) => {
         return list.filter(a => {
-            if (filterLayer !== 'ALL' && a.layer !== filterLayer) return false;
-            if (filterOwner !== 'ALL' && a.ownership?.owner !== filterOwner) return false;
-            if (filterTeam !== 'ALL' && a.ownership?.team !== filterTeam) return false;
+            const computedLayer = getArtifactLayer(a);
+            const computedOwner = getArtifactOwner(a, graph);
+            const computedTeam = getArtifactTeam(a, graph);
+            if (filterLayer !== 'ALL' && computedLayer !== filterLayer) return false;
+            if (filterOwner !== 'ALL' && computedOwner !== filterOwner) return false;
+            if (filterTeam !== 'ALL' && computedTeam !== filterTeam) return false;
             return true;
         });
     };
@@ -155,31 +161,8 @@ export const DocumentationView: React.FC = () => {
         (filteredGroups[type] || [])
       );
-      if (phase.id === 'dev') {
-        filteredArtifactsInPhase = filteredArtifactsInPhase.filter(a => a.subType !== 'Review');
-      } else if (phase.id === 'review') {
-        filteredArtifactsInPhase = filteredArtifactsInPhase.filter(a => a.subType === 'Review');
-      } else if (phase.id === 'ci') {
-        filteredArtifactsInPhase = filteredArtifactsInPhase.filter(a => a.type === 'PIPELINE' || (a.type === 'INFRASTRUCTURE' && a.subType?.includes('CI')));
-      } else if (phase.id === 'build') {
-        filteredArtifactsInPhase = filteredArtifactsInPhase.filter(a => a.type === 'INFRASTRUCTURE' && (a.subType === 'Build' || a.subType === 'Package'));
-      } else if (phase.id === 'maint') {
-        filteredArtifactsInPhase = filteredArtifactsInPhase.filter(a => a.type === 'MAINTENANCE' && a.subType !== 'Retirement');
-      } else if (phase.id === 'retire') {
-        filteredArtifactsInPhase = filteredArtifactsInPhase.filter(a => a.type === 'MAINTENANCE' && a.subType === 'Retirement');
-      }
       const subTypes = Array.from(new Set(filteredArtifactsInPhase.map(a => a.subType).filter(Boolean))) as string[];
-      if (phase.id === 'design' && (filteredGroups['COMPONENT'] || []).length > 0) {
-          const compSubTypes = Array.from(new Set((filteredGroups['COMPONENT'] || []).map(a => a.subType).filter(Boolean))) as string[];
-          for (const s of compSubTypes) {
-              if (!subTypes.includes(s)) subTypes.push(s);
-          }
-          if (compSubTypes.length === 0 && !subTypes.includes('Component')) {
-              subTypes.push('Component');
-          }
-      }
       return {
          ...phase,
          count: filteredArtifactsInPhase.length,
@@ -486,26 +469,8 @@ export const DocumentationView: React.FC = () => {
                 let phaseArtifacts = phase.types.flatMap(type => filteredGroups[type] || []);
-                if (phase.id === 'dev') {
-                    phaseArtifacts = phaseArtifacts.filter(a => a.subType !== 'Review');
-                } else if (phase.id === 'review') {
-                    phaseArtifacts = phaseArtifacts.filter(a => a.subType === 'Review');
-                } else if (phase.id === 'ci') {
-                    phaseArtifacts = phaseArtifacts.filter(a => a.type === 'PIPELINE' || (a.type === 'INFRASTRUCTURE' && a.subType?.includes('CI')));
-                } else if (phase.id === 'build') {
-                    phaseArtifacts = phaseArtifacts.filter(a => a.type === 'INFRASTRUCTURE' && (a.subType === 'Build' || a.subType === 'Package'));
-                } else if (phase.id === 'maint') {
-                    phaseArtifacts = phaseArtifacts.filter(a => a.type === 'MAINTENANCE' && a.subType !== 'Retirement');
-                } else if (phase.id === 'retire') {
-                    phaseArtifacts = phaseArtifacts.filter(a => a.type === 'MAINTENANCE' && a.subType === 'Retirement');
-                }
                 if (selectedSubType) {
-                    if (selectedSubType === 'Component') {
-                      phaseArtifacts = phaseArtifacts.filter(a => a.type === 'COMPONENT' && !a.subType);
-                    } else {
-                      phaseArtifacts = phaseArtifacts.filter(a => a.subType === selectedSubType);
-                    }
+                    phaseArtifacts = phaseArtifacts.filter(a => a.subType === selectedSubType);
                 }
                 if (!shouldShow(phaseArtifacts.length > 0)) return null;
@@ -513,7 +478,7 @@ export const DocumentationView: React.FC = () => {
                 return (
                     <section key={phase.id} className="mb-16">
-                        <h2 className="text-[10px] uppercase tracking-widest text-white/40 mb-6 bg-white/5 p-3 border-l-2 border-white/20">
+                        <h2 className="text-xl font-serif text-white mb-6 p-4 bg-white/5 border-l-4 border-emerald-500/50">
                             {idx + 1}. {phase.title}
                         </h2>
                         {phaseArtifacts.length === 0 && (
@@ -521,30 +486,66 @@ export const DocumentationView: React.FC = () => {
                                 No active artifacts for this phase.
                             </p>
                         )}
-                        <div className="space-y-4">
-                            {phaseArtifacts.map((artifact) => (
-                              <div key={artifact.id} id={artifact.id} className="mb-6 bg-[#0c0c0c] border border-white/10 p-5 pl-6 border-l-[3px] border-l-emerald-500/50 hover:bg-white/[0.02] transition-colors relative group">
-                                <h3 className="font-serif text-lg text-white flex items-center gap-4 flex-wrap mb-4">
-                                  <button
-                                    onClick={() => setSelectedArtifact(artifact.id)}
-                                    className={`text-[10px] font-mono bg-black px-2 py-1 border border-white/5 uppercase tracking-widest transition-colors hover:border-emerald-500/50 ${selectedArtifactId === artifact.id ? 'text-emerald-400 border-emerald-500/50' : 'text-white/40'}`}
-                                  >
-                                      {artifact.id}
-                                  </button>
-                                  {artifact.subType && <span className="text-[10px] font-sans bg-white/5 text-white/60 px-2 py-1 border border-white/10 uppercase tracking-widest">{artifact.subType}</span>}
-                                  {orphanArtifactIds.has(artifact.id) && (
-                                    <span className="text-[10px] bg-red-500/10 text-red-400 px-2 py-1 border border-red-500/20 uppercase tracking-widest flex items-center gap-1">
-                                      <AlertCircle size={10} />
-                                      Traceability Gap
-                                    </span>
-                                  )}
-                                  <span>{artifact.title}</span>
-                                  {artifact.version && <span className="ml-auto text-xs font-mono text-emerald-400 border border-emerald-500/30 bg-emerald-500/10 px-2 py-1 rounded">v{artifact.version}</span>}
-                                </h3>
-                                <OwnershipBadge artifact={artifact} />
-                                <MarkdownRenderer content={artifact.description} />
-                              </div>
-                            ))}
+                        <div className="space-y-12">
+                            {(() => {
+                                // Extract and group artifacts by subType
+                                const groupedBySubType: Record<string, Artifact[]> = {};
+                                const noSubTypeArtifacts: Artifact[] = [];
+                                phaseArtifacts.forEach(a => {
+                                    if (a.subType) {
+                                        if (!groupedBySubType[a.subType]) groupedBySubType[a.subType] = [];
+                                        groupedBySubType[a.subType].push(a);
+                                    } else {
+                                        noSubTypeArtifacts.push(a);
+                                    }
+                                });
+                                const renderArtifacts = (artifactsToRender: Artifact[]) => (
+                                    <div className="space-y-6">
+                                        {artifactsToRender.map(artifact => (
+                                          <div key={artifact.id} id={artifact.id} className="bg-[#0c0c0c] border border-white/10 p-5 pl-6 border-l-[3px] border-l-emerald-500/50 hover:bg-white/[0.02] transition-colors relative group print-block-break-inside-avoid">
+                                            <h3 className="font-serif text-lg text-white flex items-center gap-4 flex-wrap mb-4">
+                                              <button
+                                                onClick={() => setSelectedArtifact(artifact.id)}
+                                                className={`text-[10px] font-mono bg-black px-2 py-1 border border-white/5 uppercase tracking-widest transition-colors hover:border-emerald-500/50 ${selectedArtifactId === artifact.id ? 'text-emerald-400 border-emerald-500/50' : 'text-white/40'}`}
+                                              >
+                                                  {artifact.id}
+                                              </button>
+                                              {artifact.subType && <span className="text-[10px] font-sans bg-white/5 text-white/60 px-2 py-1 border border-white/10 uppercase tracking-widest">{artifact.subType}</span>}
+                                              {orphanArtifactIds.has(artifact.id) && (
+                                                <span className="text-[10px] bg-red-500/10 text-red-400 px-2 py-1 border border-red-500/20 uppercase tracking-widest flex items-center gap-1">
+                                                  <AlertCircle size={10} />
+                                                  Traceability Gap
+                                                </span>
+                                              )}
+                                              <span>{artifact.title}</span>
+                                              {artifact.version && <span className="ml-auto text-xs font-mono text-emerald-400 border border-emerald-500/30 bg-emerald-500/10 px-2 py-1 rounded">v{artifact.version}</span>}
+                                            </h3>
+                                            <OwnershipBadge artifact={artifact} />
+                                            <MarkdownRenderer content={artifact.description} />
+                                          </div>
+                                        ))}
+                                    </div>
+                                );
+                                return (
+                                    <>
+                                        {noSubTypeArtifacts.length > 0 && renderArtifacts(noSubTypeArtifacts)}
+                                        {Object.entries(groupedBySubType)
+                                            .sort(([a], [b]) => a.localeCompare(b))
+                                            .map(([subType, stArtifacts]) => (
+                                            <div key={subType} className="mt-8">
+                                                <h3 className="text-xs uppercase tracking-widest text-emerald-400/80 mb-4 flex items-center gap-2">
+                                                    <Layers size={14} />
+                                                    {subType}
+                                                </h3>
+                                                {renderArtifacts(stArtifacts)}
+                                            </div>
+                                        ))}
+                                    </>
+                                );
+                            })()}
                         </div>
                     </section>
                 );

package/src/components/GraphView.tsx CHANGED Viewed

@@ -6,15 +6,16 @@ import Markdown from 'react-markdown';
 import '@xyflow/react/dist/style.css';
 import { useStore } from '../store';
 import { ArtifactType } from '../types';
+import { getArtifactLayer, getArtifactOwner, getArtifactTeam } from '../utils/artifactUtils';
 const typeColors: Record<ArtifactType, string> = {
   REQUIREMENT: 'text-blue-400 border-blue-400',
   USE_CASE: 'text-indigo-400 border-indigo-400',
   DESIGN: 'text-purple-400 border-purple-400',
-  COMPONENT: 'text-amber-400 border-amber-400',
-  CODE_ENTITY: 'text-emerald-400 border-emerald-400',
-  TEST: 'text-rose-400 border-rose-400',
-  DOCUMENTATION: 'text-slate-400 border-slate-400',
+  COMPONENT: 'text-amber-400 border-amber-400',
+  CODE_ENTITY: 'text-emerald-400 border-emerald-400',
+  TEST: 'text-rose-400 border-rose-400',
+  DOCUMENTATION: 'text-slate-400 border-slate-400',
   INCIDENT: 'text-red-400 border-red-400',
   INFRASTRUCTURE: 'text-cyan-400 border-cyan-400',
   DEPLOYMENT: 'text-sky-400 border-sky-400',
@@ -311,9 +312,12 @@ const GraphFlow: React.FC = () => {
         isConnectedToSelected = connectedNodes.has(a.id);
       }
-      const isFilteredOut = (filterLayer !== 'ALL' && a.layer !== filterLayer) ||
-                            (filterOwner !== 'ALL' && a.ownership?.owner !== filterOwner) ||
-                            (filterTeam !== 'ALL' && a.ownership?.team !== filterTeam);
+      const computedLayer = getArtifactLayer(a);
+      const computedOwner = getArtifactOwner(a, fullGraph);
+      const computedTeam = getArtifactTeam(a, fullGraph);
+      const isFilteredOut = (filterLayer !== 'ALL' && computedLayer !== filterLayer) ||
+                            (filterOwner !== 'ALL' && computedOwner !== filterOwner) ||
+                            (filterTeam !== 'ALL' && computedTeam !== filterTeam);
       const isDimmed = isFilteredOut || (selectedArtifactId !== null && !isSelected && !isConnectedToSelected);
       const isOrphan = orphanIds.has(a.id);
@@ -334,9 +338,16 @@ const GraphFlow: React.FC = () => {
       const sourceNode = graph.artifacts.find(a => a.id === r.from);
       const targetNode = graph.artifacts.find(a => a.id === r.to);
-      const isFilteredOut = (filterLayer !== 'ALL' && (sourceNode?.layer !== filterLayer || targetNode?.layer !== filterLayer)) ||
-                            (filterOwner !== 'ALL' && (sourceNode?.ownership?.owner !== filterOwner || targetNode?.ownership?.owner !== filterOwner)) ||
-                            (filterTeam !== 'ALL' && (sourceNode?.ownership?.team !== filterTeam || targetNode?.ownership?.team !== filterTeam));
+      const sourceLayer = sourceNode ? getArtifactLayer(sourceNode) : undefined;
+      const targetLayer = targetNode ? getArtifactLayer(targetNode) : undefined;
+      const sourceOwner = sourceNode ? getArtifactOwner(sourceNode, fullGraph) : undefined;
+      const targetOwner = targetNode ? getArtifactOwner(targetNode, fullGraph) : undefined;
+      const sourceTeam = sourceNode ? getArtifactTeam(sourceNode, fullGraph) : undefined;
+      const targetTeam = targetNode ? getArtifactTeam(targetNode, fullGraph) : undefined;
+      const isFilteredOut = (filterLayer !== 'ALL' && (sourceLayer !== filterLayer || targetLayer !== filterLayer)) ||
+                            (filterOwner !== 'ALL' && (sourceOwner !== filterOwner || targetOwner !== filterOwner)) ||
+                            (filterTeam !== 'ALL' && (sourceTeam !== filterTeam || targetTeam !== filterTeam));
       const isDimmed = isFilteredOut || (selectedArtifactId !== null && !isConnectedToSelected);
@@ -549,4 +560,5 @@ export const GraphView: React.FC = () => {
       <GraphFlow />
     </ReactFlowProvider>
   );
-};
+};

package/src/components/GuideView.tsx CHANGED Viewed

@@ -39,7 +39,7 @@ export const GuideView: React.FC = () => {
             refactor: { label: "REFACTOR", desc: "Code restructurings without changing external behavior." },
             adaptation: { label: "ADAPTATION", desc: "Changes to adjust to new environmental/integration constraints." },
             frontmatter: "Official Markdown Format",
-            frontmatterDesc: "Each artifact requires a YAML frontmatter. Mandatory fields: id, type, status, title.",
+            frontmatterDesc: "Each artifact requires a YAML frontmatter. Mandatory: id, type, status, title. Optional: subType (for taxonomic classification).",
             statusFlow: "Lifecycle Status Flow",
             statusFlowDesc: "Evolution of artifacts. The system tolerates missing relations in 'draft', but expects full traceability in 'closed'.",
             versions: "Project & System Versions",
@@ -93,7 +93,7 @@ export const GuideView: React.FC = () => {
             refactor: { label: "REFACTOR", desc: "Reestructuraciones sin alterar el comportamiento externo." },
             adaptation: { label: "ADAPTATION", desc: "Ajustes para nuevas integraciones o restricciones del entorno." },
             frontmatter: "Formato Oficial Markdown",
-            frontmatterDesc: "Cada artefacto requiere un YAML frontmatter. Campos obligatorios: id, type, status, title.",
+            frontmatterDesc: "Cada artefacto requiere un YAML frontmatter. Campos obligatorios: id, type, status, title. Opcional: subType (clasificación taxonómica).",
             statusFlow: "Estados y Ciclo de Vida",
             statusFlowDesc: "En estado 'draft' se permiten huérfanos, pero en 'closed' se exige trazabilidad completa.",
             versions: "Versiones del Sistema y Proyecto",
@@ -173,7 +173,7 @@ export const GuideView: React.FC = () => {
                             <h3 className="text-sm font-bold text-white/80 mb-2 uppercase tracking-widest">{c.implementationLayer}</h3>
                             <p className="text-[11px] text-white/40 leading-relaxed mb-4">{c.implementationLayerDesc}</p>
                             <div className="flex flex-wrap gap-2">
-                                {['CODE_ENTITY', 'TEST_CASE', 'DATABASE_ENTITY', 'CHANGE', 'BUG', 'RISK', 'TEST'].map(t => (
+                                {['CODE_ENTITY', 'TEST_CASE', 'DATABASE_ENTITY', 'CHANGE', 'BUG', 'RISK'].map(t => (
                                     <span key={t} className="text-[9px] bg-white/5 px-1.5 py-0.5 rounded text-white/60">{t}</span>
                                 ))}
                             </div>
@@ -306,6 +306,7 @@ export const GuideView: React.FC = () => {
 {`---
 id: REQ-001
 type: REQUIREMENT
+subType: SYSTEM
 status: draft
 layer: BUSINESS
 title: Generar graph-data.json
@@ -452,6 +453,7 @@ We will use JWT tokens for authentication...`}
 {`---
 id: CODE-auth-service
 type: CODE_ENTITY
+subType: Microservice
 status: in_progress
 layer: IMPLEMENTATION
 title: AuthService.ts

package/src/components/ImpactView.tsx CHANGED Viewed

@@ -2,6 +2,7 @@ import React, { useState, useMemo, useEffect } from 'react';
 import { useStore } from '../store';
 import { Activity, ArrowRight, GitCommit, Search, ShieldAlert, Zap } from 'lucide-react';
 import { Artifact } from '../types';
+import { getArtifactLayer, getArtifactOwner, getArtifactTeam } from '../utils/artifactUtils';
 export const ImpactView: React.FC = () => {
   const { changes, versions, fullGraph: graph, systemVersions, globalFilters, setGlobalFilter } = useStore();
@@ -20,9 +21,9 @@ export const ImpactView: React.FC = () => {
   const filterOptions = useMemo(() => {
      if (!graph || !graph.artifacts) return { layers: [], owners: [], teams: [] };
-     const layers = Array.from(new Set(graph.artifacts.map(a => a.layer).filter(Boolean))) as string[];
-     const owners = Array.from(new Set(graph.artifacts.map(a => a.ownership?.owner).filter(Boolean))) as string[];
-     const teams = Array.from(new Set(graph.artifacts.map(a => a.ownership?.team).filter(Boolean))) as string[];
+     const layers = Array.from(new Set(graph.artifacts.map(a => getArtifactLayer(a)).filter(Boolean))) as string[];
+     const owners = Array.from(new Set(graph.artifacts.map(a => getArtifactOwner(a, graph)).filter(Boolean))) as string[];
+     const teams = Array.from(new Set(graph.artifacts.map(a => getArtifactTeam(a, graph)).filter(Boolean))) as string[];
      return { layers, owners, teams };
   }, [graph]);
@@ -42,9 +43,12 @@ export const ImpactView: React.FC = () => {
       const affectedLayerTeamOwner = (c.affects || []).some(id => {
          const artifact = graph?.artifacts.find(a => a.id === id);
          if (!artifact) return false;
-         const matchesLayer = filterLayer === 'ALL' || artifact.layer === filterLayer;
-         const matchesOwner = filterOwner === 'ALL' || artifact.ownership?.owner === filterOwner;
-         const matchesTeam = filterTeam === 'ALL' || artifact.ownership?.team === filterTeam;
+         const computedLayer = getArtifactLayer(artifact);
+         const computedOwner = getArtifactOwner(artifact, graph);
+         const computedTeam = getArtifactTeam(artifact, graph);
+         const matchesLayer = filterLayer === 'ALL' || computedLayer === filterLayer;
+         const matchesOwner = filterOwner === 'ALL' || computedOwner === filterOwner;
+         const matchesTeam = filterTeam === 'ALL' || computedTeam === filterTeam;
          return matchesLayer && matchesOwner && matchesTeam;
       });

package/src/components/OrphansView.tsx CHANGED Viewed

@@ -1,6 +1,7 @@
 import React, { useMemo, useState } from 'react';
 import { useStore } from '../store';
 import { ArtifactType } from '../types';
+import { getArtifactLayer, getArtifactOwner, getArtifactTeam } from '../utils/artifactUtils';
 import { AlertCircle, Search, Trash2, ChevronRight, FileText, ExternalLink, ShieldAlert, AlertTriangle, Info, Download } from 'lucide-react';
 import { generateGapsReport, downloadTextFile } from '../lib/reportUtils';
@@ -72,10 +73,13 @@ export const OrphansView: React.FC = () => {
     const filteredGaps = useMemo(() => {
         return gaps.filter(gap => {
             const art = gap.artifact;
+            const computedLayer = getArtifactLayer(art);
+            const computedOwner = getArtifactOwner(art, graph);
+            const computedTeam = getArtifactTeam(art, graph);
-            if (filterLayer !== 'ALL' && art.layer !== filterLayer) return false;
-            if (filterOwner !== 'ALL' && art.ownership?.owner !== filterOwner) return false;
-            if (filterTeam !== 'ALL' && art.ownership?.team !== filterTeam) return false;
+            if (filterLayer !== 'ALL' && computedLayer !== filterLayer) return false;
+            if (filterOwner !== 'ALL' && computedOwner !== filterOwner) return false;
+            if (filterTeam !== 'ALL' && computedTeam !== filterTeam) return false;
             if (selectedArtifactId && art.id !== selectedArtifactId) return false;
@@ -95,7 +99,7 @@ export const OrphansView: React.FC = () => {
         // Match the grouped keys in DocumentationView
         return [
             'REQUIREMENT', 'USE_CASE', 'DESIGN', 'COMPONENT',
-            'CODE_ENTITY', 'TEST', 'DOCUMENTATION', 'INCIDENT',
+            'CODE_ENTITY', 'TEST_CASE', 'DOCUMENTATION', 'INCIDENT',
             'INFRASTRUCTURE', 'DEPLOYMENT', 'MONITORING', 'MAINTENANCE'
         ];
     }, []);
@@ -357,4 +361,3 @@ export const OrphansView: React.FC = () => {
         </div>
     );
 };

package/src/core/semantic/artifact-layers.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { ArtifactType, ArtifactLayer } from '../../types.js';
-export const LayerInferenceRules: Record<ArtifactType, ArtifactLayer> = {
+export const LayerInferenceRules: Partial<Record<ArtifactType, ArtifactLayer>> = {
   PROJECT: 'BUSINESS',
   EPIC: 'BUSINESS',
   FEATURE: 'BUSINESS',
@@ -16,7 +16,6 @@ export const LayerInferenceRules: Record<ArtifactType, ArtifactLayer> = {
   CODE_ENTITY: 'IMPLEMENTATION',
   DATABASE_ENTITY: 'IMPLEMENTATION',
   TEST_CASE: 'IMPLEMENTATION',
-  TEST: 'IMPLEMENTATION',
   CHANGE: 'IMPLEMENTATION',
   BUG: 'IMPLEMENTATION',
   RISK: 'IMPLEMENTATION',