@valentia-ai-skills/framework 2.0.7 → 2.0.9

package/bin/code-audit-config.mjs

@@ -0,0 +1,323 @@
+const DOCUMENT_DEFINITIONS = [
+  {
+    documentType: 'overview',
+    label: 'Overview',
+    category: 'overview',
+    tabLabel: 'Overview',
+    fileNames: ['CODE_AUDIT_OVERVIEW.md', 'OVERVIEW.md'],
+  },
+  {
+    documentType: 'security',
+    label: 'Security',
+    category: 'audit-report',
+    tabLabel: 'Security',
+    fileNames: ['SECURITY_AUDIT.md'],
+    scoreKey: 'security',
+    weight: 20,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'error_handling',
+    label: 'Error Handling',
+    category: 'audit-report',
+    tabLabel: 'Error Handling',
+    fileNames: ['ERROR_HANDLING.md'],
+    scoreKey: 'error_handling',
+    weight: 12,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'correctness',
+    label: 'Correctness',
+    category: 'audit-report',
+    tabLabel: 'Correctness',
+    fileNames: ['CORRECTNESS.md'],
+    scoreKey: 'correctness',
+    weight: 12,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'crash_risk',
+    label: 'Crash Risk',
+    category: 'audit-report',
+    tabLabel: 'Crash Risk',
+    fileNames: ['CRASH_RISK.md'],
+    scoreKey: 'crash_risk',
+    weight: 10,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'code_quality',
+    label: 'Code Quality',
+    category: 'audit-report',
+    tabLabel: 'Code Quality',
+    fileNames: ['CODE_QUALITY.md'],
+    scoreKey: 'code_quality',
+    weight: 8,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'standards',
+    label: 'Standards',
+    category: 'audit-report',
+    tabLabel: 'Standards',
+    fileNames: ['STANDARDS.md'],
+    scoreKey: 'standards',
+    weight: 8,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'performance',
+    label: 'Performance',
+    category: 'audit-report',
+    tabLabel: 'Performance',
+    fileNames: ['PERFORMANCE.md'],
+    scoreKey: 'performance',
+    weight: 7,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'maintainability',
+    label: 'Maintainability',
+    category: 'audit-report',
+    tabLabel: 'Maintainability',
+    fileNames: ['MAINTAINABILITY.md'],
+    scoreKey: 'maintainability',
+    weight: 7,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'dependency_health',
+    label: 'Dependencies',
+    category: 'audit-report',
+    tabLabel: 'Dependencies',
+    fileNames: ['DEPENDENCY_HEALTH.md'],
+    scoreKey: 'dependency_health',
+    weight: 5,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'accessibility',
+    label: 'Accessibility',
+    category: 'audit-report',
+    tabLabel: 'Accessibility',
+    fileNames: ['ACCESSIBILITY.md'],
+    scoreKey: 'accessibility',
+    weight: 4,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'test_coverage',
+    label: 'Tests',
+    category: 'audit-report',
+    tabLabel: 'Tests',
+    fileNames: ['TEST_COVERAGE.md'],
+    scoreKey: 'test_coverage',
+    weight: 4,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'architecture',
+    label: 'Architecture',
+    category: 'audit-report',
+    tabLabel: 'Architecture',
+    fileNames: ['ARCHITECTURE.md'],
+    scoreKey: 'architecture',
+    weight: 3,
+    includeInDashboard: true,
+  },
+  {
+    documentType: 'framework_review',
+    label: 'Framework',
+    category: 'audit-report',
+    tabLabel: 'Framework',
+    fileNames: ['FRAMEWORK_REVIEW.md'],
+    scoreKey: 'framework_review',
+    weight: 0,
+    includeInDashboard: false,
+  },
+  {
+    documentType: 'remediation_plan',
+    label: 'Remediation',
+    category: 'plan',
+    tabLabel: 'Remediation',
+    fileNames: ['REMEDIATION_PLAN.md'],
+  },
+  {
+    documentType: 'manifest',
+    label: 'Manifest',
+    category: 'meta',
+    tabLabel: 'Manifest',
+    fileNames: ['manifest.json'],
+  },
+  {
+    documentType: 'diagram',
+    label: 'Diagram',
+    category: 'diagram',
+    tabLabel: 'Diagrams',
+    fileNames: [],
+  },
+]
+
+export const CODE_AUDIT_DOCUMENTS = DOCUMENT_DEFINITIONS
+
+export const CODE_AUDIT_SEVERITIES = ['critical', 'high', 'medium', 'low']
+
+export const CODE_AUDIT_STATUS_OPTIONS = [
+  'uploaded',
+  'reviewed',
+  'action_required',
+  'resolved',
+]
+
+export const CODE_AUDIT_SCORE_BANDS = [
+  {
+    grade: 'A',
+    min: 90,
+    label: 'Excellent',
+    chartColor: '#22c55e',
+    barClass: 'bg-success',
+    textClass: 'text-success',
+    borderClass: 'border-success/30',
+  },
+  {
+    grade: 'B',
+    min: 75,
+    label: 'Strong',
+    chartColor: '#3b82f6',
+    barClass: 'bg-blue-500',
+    textClass: 'text-blue-400',
+    borderClass: 'border-blue-500/30',
+  },
+  {
+    grade: 'C',
+    min: 60,
+    label: 'Needs Work',
+    chartColor: '#eab308',
+    barClass: 'bg-warning',
+    textClass: 'text-warning',
+    borderClass: 'border-warning/30',
+  },
+  {
+    grade: 'D',
+    min: 40,
+    label: 'Action Required',
+    chartColor: '#f97316',
+    barClass: 'bg-orange-500',
+    textClass: 'text-orange-400',
+    borderClass: 'border-orange-500/30',
+  },
+  {
+    grade: 'F',
+    min: 0,
+    label: 'Critical',
+    chartColor: '#ef4444',
+    barClass: 'bg-danger',
+    textClass: 'text-danger',
+    borderClass: 'border-danger/30',
+  },
+]
+
+export const CODE_AUDIT_SEVERITY_STYLES = {
+  critical: {
+    badgeClass: 'bg-danger/15 text-danger border border-danger/30',
+    cardClass: 'bg-danger/5 border-danger/30',
+    label: 'Critical',
+  },
+  high: {
+    badgeClass: 'bg-orange-500/15 text-orange-300 border border-orange-500/30',
+    cardClass: 'bg-orange-500/5 border-orange-500/30',
+    label: 'High',
+  },
+  medium: {
+    badgeClass: 'bg-warning/15 text-warning border border-warning/30',
+    cardClass: 'bg-warning/5 border-warning/30',
+    label: 'Medium',
+  },
+  low: {
+    badgeClass: 'bg-surface-elevated text-text-secondary border border-border',
+    cardClass: 'bg-surface-elevated border-border',
+    label: 'Low',
+  },
+}
+
+export const CODE_AUDIT_DOCUMENT_MAP = Object.fromEntries(
+  CODE_AUDIT_DOCUMENTS.map((definition, index) => [
+    definition.documentType,
+    { ...definition, order: index },
+  ]),
+)
+
+const FILE_NAME_MAP = {}
+for (const definition of CODE_AUDIT_DOCUMENTS) {
+  for (const fileName of definition.fileNames) {
+    FILE_NAME_MAP[fileName.toLowerCase()] = definition.documentType
+  }
+}
+
+export function slugifyCodeAuditValue(value) {
+  return String(value || '')
+    .trim()
+    .toLowerCase()
+    .replace(/\.[^.]+$/, '')
+    .replace(/[^a-z0-9]+/g, '_')
+    .replace(/^_+|_+$/g, '')
+}
+
+export function titleizeCodeAuditValue(value) {
+  return String(value || '')
+    .replace(/\.[^.]+$/, '')
+    .replace(/[_-]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .replace(/\b\w/g, (char) => char.toUpperCase())
+}
+
+export function normalizeCodeAuditDocumentType(value) {
+  const normalized = slugifyCodeAuditValue(value)
+  return normalized || 'document'
+}
+
+export function inferCodeAuditDocumentType(fileName) {
+  const normalizedFileName = String(fileName || '').trim().toLowerCase()
+  if (!normalizedFileName) return 'document'
+
+  if (FILE_NAME_MAP[normalizedFileName]) {
+    return FILE_NAME_MAP[normalizedFileName]
+  }
+
+  if (/\.(mmd|mermaid)$/i.test(normalizedFileName)) {
+    return 'diagram'
+  }
+
+  return normalizeCodeAuditDocumentType(normalizedFileName)
+}
+
+export function getCodeAuditDocumentConfig(documentType) {
+  return CODE_AUDIT_DOCUMENT_MAP[normalizeCodeAuditDocumentType(documentType)] || null
+}
+
+export function inferCodeAuditDocumentCategory(documentType) {
+  return getCodeAuditDocumentConfig(documentType)?.category || 'meta'
+}
+
+export function getCodeAuditScoreBand(score) {
+  const numericScore = Number(score ?? 0)
+  return CODE_AUDIT_SCORE_BANDS.find((band) => numericScore >= band.min) || CODE_AUDIT_SCORE_BANDS[CODE_AUDIT_SCORE_BANDS.length - 1]
+}
+
+export function gradeFromCodeAuditScore(score) {
+  return getCodeAuditScoreBand(score).grade
+}
+
+export function statusFromCodeAuditGrade(grade) {
+  return grade === 'D' || grade === 'F' ? 'action_required' : 'uploaded'
+}
+
+export function getCodeAuditDashboardDefinitions() {
+  return CODE_AUDIT_DOCUMENTS.filter((definition) => definition.includeInDashboard)
+}
+
+export function getCodeAuditTabDefinitions() {
+  return CODE_AUDIT_DOCUMENTS.filter((definition) => definition.documentType !== 'manifest' && definition.documentType !== 'diagram')
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentia-ai-skills/framework",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "description": "AI development skills framework centralized coding standards, security patterns, and SOPs for AI-assisted development. Works with Claude Code, Cursor, Copilot, Windsurf, and any AI coding tool.",
   "keywords": [
     "ai-skills",

package/skills/global/aisupportapp-project-architecture/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/project-architecture
 description: Auto-generated project-architecture for aisupportapp. Created by project-scanner.
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-29
+last_reviewed: 2026-04-02
 ---
 
 ---

package/skills/global/aisupportapp-project-conventions/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/project-conventions
 description: Auto-generated project-conventions for aisupportapp. Created by project-scanner.
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-29
+last_reviewed: 2026-04-02
 ---
 
 ---

package/skills/global/aisupportapp-project-workflows/SKILL.md

@@ -3,7 +3,7 @@ name: aisupportapp/project-workflows
 description: Auto-generated project-workflows for aisupportapp. Created by project-scanner.
 version: 1.0.0
 scope: project
-last_reviewed: 2026-03-29
+last_reviewed: 2026-04-02
 ---
 
 ---

package/skills/global/api-design/SKILL.md

@@ -3,7 +3,7 @@ name: api-design
 description: No description
 version: 1.0.0
 scope: global
-last_reviewed: 2026-03-29
+last_reviewed: 2026-04-02
 ---
 
 ---

package/skills/global/appointment-oas-app/SKILL.md

@@ -3,7 +3,7 @@ name: appointment-oas-app
 description: No description
 version: 1.0.1
 scope: global
-last_reviewed: 2026-03-29
+last_reviewed: 2026-04-02
 ---
 
 ---