@donartcha/openlag 0.1.0

package/scripts/lint/lint-rules.ts

@@ -0,0 +1,174 @@
+import { LintIssue, LintProfile } from './lint-types.js';
+import { OpenLagData, ParsedArtifact, ParsedRelation, ParseError } from '../core/parser.js';
+import { ArtifactRegistry } from '../../src/core/registry/ArtifactRegistry.js';
+import { RelationRegistry } from '../../src/core/registry/RelationRegistry.js';
+
+export function runLintRules(data: OpenLagData, profile: LintProfile): LintIssue[] {
+  const issues: LintIssue[] = [];
+
+  const getSeverity = (rule: keyof LintProfile, artifactStatus?: string) => {
+      let severity = profile[rule];
+      if (!severity || severity === 'off') return 'off';
+      
+      // Downgrade severities based on drafting status
+      if (artifactStatus === 'draft') {
+          if (rule !== 'brokenRelation' && rule !== 'invalidYaml' && rule !== 'duplicateId') {
+              severity = 'info';
+          }
+      } else if (artifactStatus === 'in_progress') {
+          if (rule !== 'brokenRelation' && rule !== 'invalidYaml' && rule !== 'duplicateId') {
+              if (severity === 'error') severity = 'warning';
+          }
+      }
+      return severity;
+  };
+
+  const addIssue = (rule: keyof LintProfile, message: string, file?: string, artifactId?: string, artifactStatus?: string) => {
+    const severity = getSeverity(rule, artifactStatus);
+    if (severity && severity !== 'off') {
+      issues.push({ severity, rule, message, file, artifactId });
+    }
+  };
+
+  // 1. Invalid YAML
+  for (const error of data.errors) {
+    addIssue('invalidYaml', error.message, error.file);
+  }
+
+  // Build ID map
+  const artifactMap = new Map<string, ParsedArtifact[]>();
+  for (const artifact of data.artifacts) {
+    const list = artifactMap.get(artifact.id) || [];
+    list.push(artifact);
+    artifactMap.set(artifact.id, list);
+  }
+
+  // 2. Duplicate IDs
+  for (const [id, artifacts] of artifactMap.entries()) {
+    if (artifacts.length > 1) {
+      addIssue('duplicateId', `${id} appears in ${artifacts.length} files`, artifacts[0].file, id);
+    }
+  }
+
+  // 3. Artifact type and minimal fields
+  for (const artifact of data.artifacts) {
+    if (!ArtifactRegistry.isValid(artifact.type)) {
+      addIssue('invalidArtifactType', `Invalid artifact type: ${artifact.type}`, artifact.file, artifact.id, artifact.status);
+    }
+    if (!artifact.type || !artifact.title) {
+        addIssue('missingRequiredFields', `Artifact missing type or title`, artifact.file, artifact.id, artifact.status);
+    }
+  }
+
+  // Compute relation maps
+  const targets = new Set(data.artifacts.map(a => a.id));
+  const implementationsByReq = new Map<string, ParsedRelation[]>();
+  const testsByReq = new Map<string, ParsedRelation[]>();
+  const reqsByCode = new Map<string, ParsedRelation[]>();
+  const reqsByTest = new Map<string, ParsedRelation[]>();
+
+  for (const relation of data.relations) {
+    if (!RelationRegistry.isValid(relation.type)) {
+       addIssue('invalidRelationType', `Invalid relation type: ${relation.type}`, relation.file, relation.from);
+    }
+    
+    // 4. Broken relations
+    if (!targets.has(relation.to)) {
+      addIssue('brokenRelation', `${relation.from} -> ${relation.to} target does not exist`, relation.file, relation.from);
+    }
+
+    // Populate relation graphs for rules
+    if (relation.type === 'IMPLEMENTS') {
+        const list = implementationsByReq.get(relation.to) || [];
+        list.push(relation);
+        implementationsByReq.set(relation.to, list);
+
+        const listCode = reqsByCode.get(relation.from) || [];
+        listCode.push(relation);
+        reqsByCode.set(relation.from, listCode);
+    }
+    
+    if (relation.type === 'TESTS' || relation.type === 'VALIDATES') {
+        const list = testsByReq.get(relation.to) || [];
+        list.push(relation);
+        testsByReq.set(relation.to, list);
+
+        const listTest = reqsByTest.get(relation.from) || [];
+        listTest.push(relation);
+        reqsByTest.set(relation.from, listTest);
+    }
+  }
+
+  // Rule functions per artifact
+  for (const artifact of data.artifacts) {
+    const isDraft = artifact.status === 'draft';
+    const isClosed = artifact.status === 'closed';
+    const isDeprecated = artifact.status === 'deprecated';
+
+    if (isDeprecated) continue; // Skip rules for deprecated except broken relations (already checked above)
+
+    if (artifact.type === 'REQUIREMENT') {
+        const hasImplementation = implementationsByReq.has(artifact.id);
+        const hasTest = testsByReq.has(artifact.id);
+
+        if (!hasImplementation) {
+             addIssue('requirementWithoutImplementation', `${artifact.id} lacks implementation`, artifact.file, artifact.id, artifact.status);
+        }
+        
+        if (!hasTest) {
+             addIssue('requirementWithoutTest', `${artifact.id} has no tests linked`, artifact.file, artifact.id, artifact.status);
+        }
+    }
+
+    if (artifact.type === 'CODE_ENTITY') {
+        const hasReq = reqsByCode.has(artifact.id);
+        if (!hasReq) {
+            addIssue('codeWithoutRequirement', `${artifact.id} has no requirement associated`, artifact.file, artifact.id, artifact.status);
+        }
+    }
+
+    if (artifact.type === 'TEST') {
+        const hasReq = reqsByTest.has(artifact.id);
+        if (!hasReq) {
+            addIssue('orphanArtifact', `${artifact.id} is a test without associated requirement`, artifact.file, artifact.id, artifact.status);
+        }
+    }
+
+    if (isClosed) {
+        const outgoing = data.relations.filter(r => r.from === artifact.id);
+        for (const rel of outgoing) {
+             const targetArts = artifactMap.get(rel.to);
+             if (targetArts && targetArts[0]) {
+                 const targetStatus = targetArts[0].status;
+                 if (targetStatus === 'draft' || targetStatus === 'in_progress') {
+                     // Check relation rules: RELATES_TO, DOCUMENTS, JUSTIFIES don't break closed state
+                     if (rel.type !== 'RELATES_TO' && rel.type !== 'DOCUMENTS' && rel.type !== 'JUSTIFIES') {
+                         addIssue('closedArtifactWithPendingRelations', `${artifact.id} is closed but links to ${targetStatus} artifact ${rel.to} via ${rel.type}`, artifact.file, artifact.id, artifact.status);
+                     }
+                 }
+             }
+        }
+        
+        if (!artifact.ownership || Object.keys(artifact.ownership).length === 0) {
+            addIssue('missingOwnership', `${artifact.id} is closed but has no ownership defined`, artifact.file, artifact.id, artifact.status);
+        }
+    }
+    
+    if (artifact.type === 'API' && (!artifact.ownership || Object.keys(artifact.ownership).length === 0)) {
+        addIssue('missingOwnership', `API ${artifact.id} should have ownership defined`, artifact.file, artifact.id, artifact.status);
+    }
+    
+    // Check layer semantics
+    if (artifact.layer === 'BUSINESS') {
+        const outgoing = data.relations.filter(r => r.from === artifact.id);
+        for (const rel of outgoing) {
+            const relSemantics = rel.category;
+            if (relSemantics === 'OPERATIONAL') {
+                addIssue('invalidLayerRelation', `Business layer artifact ${artifact.id} should not have OPERATIONAL relations (${rel.type})`, artifact.file, artifact.id, artifact.status);
+            }
+        }
+    }
+  }
+
+  return issues;
+}

package/scripts/lint/lint-types.ts

@@ -0,0 +1,43 @@
+export type LintSeverity = 'error' | 'warning' | 'info' | 'off';
+
+export interface LintIssue {
+  severity: LintSeverity;
+  rule: string;
+  artifactId?: string;
+  message: string;
+  file?: string;
+}
+
+export interface LintSummary {
+  errors: number;
+  warnings: number;
+  info: number;
+}
+
+export interface LintReport {
+  profile: string;
+  summary: LintSummary;
+  issues: LintIssue[];
+}
+
+export interface LintProfile {
+  duplicateId: LintSeverity;
+  invalidYaml: LintSeverity;
+  brokenRelation: LintSeverity;
+  missingRequiredFields: LintSeverity;
+  requirementWithoutImplementation: LintSeverity;
+  requirementWithoutTest: LintSeverity;
+  codeWithoutRequirement: LintSeverity;
+  closedArtifactWithPendingRelations: LintSeverity;
+  orphanArtifact: LintSeverity;
+  invalidRelationType: LintSeverity;
+  invalidArtifactType: LintSeverity;
+  invalidLayerRelation?: LintSeverity;
+  missingOwnership?: LintSeverity;
+}
+
+export interface LintConfig {
+  defaultProfile: string;
+  failOnWarnings: boolean;
+  profiles: Record<string, Partial<LintProfile>>;
+}

package/src/App.tsx

@@ -0,0 +1,164 @@
+import React, { useEffect } from 'react';
+import { useStore } from './store';
+import { GraphView } from './components/GraphView';
+import { DocumentationView } from './components/DocumentationView';
+import { ImpactView } from './components/ImpactView';
+import { OrphansView } from './components/OrphansView';
+import { GuideView } from './components/GuideView';
+import { SettingsView } from './components/SettingsView';
+import { Network, FileText, GitPullRequest, Settings, Database, AlertCircle, BookOpen } from 'lucide-react';
+
+export default function App() {
+  const { 
+    initializeStore, 
+    versions, 
+    currentVersionId, 
+    setVersion,
+    activeView,
+    setView,
+    isLoading,
+    systemVersions
+  } = useStore();
+
+  useEffect(() => {
+    initializeStore();
+  }, [initializeStore]);
+
+  return (
+    <div className="flex h-screen w-screen overflow-hidden bg-[#0a0a0a] text-[#e0e0e0] font-sans selection:bg-emerald-500/30 print-block">
+      {/* Sidebar Nav */}
+      <nav className="w-16 flex flex-col items-center py-6 bg-[#0c0c0c] text-white/40 border-r border-white/10 shrink-0">
+        <div className="w-8 h-8 bg-white flex items-center justify-center rounded-sm mb-8">
+          <div className="w-4 h-4 border-2 border-black rotate-45"></div>
+        </div>
+        
+        <div className="flex flex-col gap-6 w-full items-center">
+          <button 
+            onClick={() => setView('graph')}
+            className={`transition-all hover:text-white hover:opacity-100 ${activeView === 'graph' ? 'text-white opacity-100' : 'opacity-40'}`}
+            title="Graph View"
+          >
+            <Network size={20} strokeWidth={1.5} />
+          </button>
+          <button 
+             onClick={() => setView('docs')}
+             className={`transition-all hover:text-white hover:opacity-100 ${activeView === 'docs' ? 'text-white opacity-100' : 'opacity-40'}`}
+             title="Documentation Engine"
+          >
+            <FileText size={20} strokeWidth={1.5} />
+          </button>
+          <button 
+             onClick={() => setView('impact')}
+             className={`transition-all hover:text-white hover:opacity-100 ${activeView === 'impact' ? 'text-white opacity-100' : 'opacity-40'}`}
+             title="Impact Analysis"
+          >
+            <GitPullRequest size={20} strokeWidth={1.5} />
+          </button>
+          <button 
+             onClick={() => setView('orphans')}
+             className={`transition-all hover:text-white hover:opacity-100 ${activeView === 'orphans' ? 'text-red-400 opacity-100' : 'opacity-40'}`}
+             title="Traceability GAPs"
+          >
+            <AlertCircle size={20} strokeWidth={1.5} />
+          </button>
+          <button 
+             onClick={() => setView('guide')}
+             className={`transition-all hover:text-white hover:opacity-100 ${activeView === 'guide' ? 'text-amber-400 opacity-100' : 'opacity-40'}`}
+             title="Usage Guide"
+          >
+            <BookOpen size={20} strokeWidth={1.5} />
+          </button>
+        </div>
+
+        <div className="mt-auto">
+          <button 
+            onClick={() => setView('settings')}
+            className={`transition-all hover:text-white hover:opacity-100 ${activeView === 'settings' ? 'text-white opacity-100' : 'opacity-40'}`}
+            title="Settings"
+          >
+            <Settings size={20} strokeWidth={1.5} />
+          </button>
+        </div>
+      </nav>
+
+      {/* Main Content Area */}
+      <div className="flex-1 flex flex-col min-w-0">
+        
+        {/* Top Header */}
+        <header className="h-16 bg-[#0f0f0f] border-b border-white/10 flex items-center px-8 justify-between shrink-0 z-10">
+          <div className="font-serif text-xl italic tracking-tight flex items-center gap-2">
+            OpenLAG <span className="text-xs font-mono opacity-50 ml-2 not-italic">| Lifecycle Engine</span>
+          </div>
+
+          <div className="flex items-center gap-6">
+            <div className="flex items-center gap-3">
+              <div className="flex flex-col items-end">
+                <span className="text-[10px] opacity-40 uppercase tracking-widest">Doc Snapshot</span>
+              </div>
+              <select 
+                value={currentVersionId || ''} 
+                onChange={(e) => setVersion(e.target.value)}
+                className="bg-[#0c0c0c] border border-white/20 text-xs font-mono text-emerald-400 rounded-sm px-3 py-1.5 outline-none cursor-pointer hover:bg-white/5 transition-colors focus:border-emerald-400"
+              >
+                {versions.map(v => (
+                  <option key={v.id} value={v.id} className="bg-[#0c0c0c] text-white">
+                    {v.name} ({new Date(v.timestamp).toLocaleDateString()})
+                  </option>
+                ))}
+              </select>
+            </div>
+
+            <div className="h-6 w-[1px] bg-white/10" />
+
+            <div className="flex items-center gap-3 group relative">
+              <div className="p-2 bg-emerald-500/10 rounded-full border border-emerald-500/20">
+                <Database size={14} className="text-emerald-400" />
+              </div>
+              <div className="flex flex-col">
+                <span className="text-[10px] opacity-40 uppercase tracking-widest leading-none">System State</span>
+                <div className="flex items-center gap-2 mt-1">
+                  <span className="text-[10px] text-white/80 font-bold tracking-tight">
+                    {systemVersions.length} Components Active
+                  </span>
+                  <div className="w-1.5 h-1.5 bg-emerald-500 rounded-full animate-pulse shadow-[0_0_8px_rgba(16,185,129,0.5)]" />
+                </div>
+              </div>
+              
+              {/* Tooltip on hover */}
+              <div className="absolute top-full right-0 mt-2 w-64 bg-[#0f0f0f] border border-white/10 p-4 rounded-sm shadow-2xl opacity-0 group-hover:opacity-100 transition-opacity pointer-events-none z-50">
+                <div className="text-[9px] uppercase tracking-widest text-[#888] font-bold mb-3 border-b border-white/5 pb-2">Active Inventory</div>
+                <div className="space-y-2">
+                  {systemVersions.map(sv => (
+                    <div key={sv.id} className="flex justify-between items-center text-[10px]">
+                      <span className="text-white/60">{sv.component}</span>
+                      <span className="font-mono text-emerald-500/60">{sv.version}</span>
+                    </div>
+                  ))}
+                  {systemVersions.length === 0 && (
+                    <div className="text-white/20 italic">No system components logged.</div>
+                  )}
+                </div>
+              </div>
+            </div>
+          </div>
+        </header>
+
+        {/* View Renderer */}
+        <main className="flex-1 relative overflow-hidden">
+          {isLoading && !currentVersionId ? (
+            <div className="absolute inset-0 flex items-center justify-center bg-white/50 backdrop-blur-sm z-50">
+              <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-600"></div>
+            </div>
+          ) : null}
+
+          {activeView === 'graph' && <GraphView />}
+          {activeView === 'docs' && <DocumentationView />}
+          {activeView === 'impact' && <ImpactView />}
+          {activeView === 'orphans' && <OrphansView />}
+          {activeView === 'guide' && <GuideView />}
+          {activeView === 'settings' && <SettingsView />}
+        </main>
+      </div>
+    </div>
+  );
+}