vaspera 2.5.0

package/dist/certification/badge.js

@@ -0,0 +1,155 @@
+/**
+ * Certification Badge Generation
+ *
+ * Generates SVG badges for certification status that can be embedded
+ * in README files or displayed on dashboards.
+ *
+ * @module certification/badge
+ */
+/**
+ * Color palette for certification levels
+ */
+const LEVEL_COLORS = {
+    CERTIFIED: "#22c55e", // Green
+    APPROVED: "#eab308", // Yellow
+    REVIEW_REQUIRED: "#f97316", // Orange
+    BLOCKED: "#ef4444", // Red
+};
+/**
+ * Human-readable labels for certification levels
+ */
+const LEVEL_LABELS = {
+    CERTIFIED: "Certified",
+    APPROVED: "Approved",
+    REVIEW_REQUIRED: "Review Required",
+    BLOCKED: "Blocked",
+};
+/**
+ * Default color for unknown levels
+ */
+const DEFAULT_COLOR = "#6b7280"; // Gray
+/**
+ * Badge dimensions
+ */
+const BADGE_HEIGHT = 20;
+const LABEL_WIDTH = 80;
+const VALUE_WIDTH = 120;
+const TOTAL_WIDTH = LABEL_WIDTH + VALUE_WIDTH;
+/**
+ * Generate an SVG certification badge.
+ *
+ * Creates a shields.io-style badge showing certification level and score.
+ *
+ * @param level - The certification level
+ * @param score - The overall score (0-100)
+ * @returns SVG string that can be saved to a file or embedded in markdown
+ *
+ * @example
+ * ```typescript
+ * const svg = generateBadgeSvg("APPROVED", 85);
+ * // Returns SVG showing "certification | Approved 85/100"
+ * ```
+ */
+export function generateBadgeSvg(level, score) {
+    const color = LEVEL_COLORS[level] || DEFAULT_COLOR;
+    const label = LEVEL_LABELS[level] || level;
+    const scoreText = `${Math.round(score)}/100`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="${TOTAL_WIDTH}" height="${BADGE_HEIGHT}" role="img" aria-label="certification: ${label} ${scoreText}">
+  <title>certification: ${label} ${scoreText}</title>
+  <linearGradient id="s" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="r">
+    <rect width="${TOTAL_WIDTH}" height="${BADGE_HEIGHT}" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#r)">
+    <rect width="${LABEL_WIDTH}" height="${BADGE_HEIGHT}" fill="#555"/>
+    <rect x="${LABEL_WIDTH}" width="${VALUE_WIDTH}" height="${BADGE_HEIGHT}" fill="${color}"/>
+    <rect width="${TOTAL_WIDTH}" height="${BADGE_HEIGHT}" fill="url(#s)"/>
+  </g>
+  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="11">
+    <text aria-hidden="true" x="${LABEL_WIDTH / 2}" y="15" fill="#010101" fill-opacity=".3">certification</text>
+    <text x="${LABEL_WIDTH / 2}" y="14">certification</text>
+    <text aria-hidden="true" x="${LABEL_WIDTH + VALUE_WIDTH / 2}" y="15" fill="#010101" fill-opacity=".3">${label} ${scoreText}</text>
+    <text x="${LABEL_WIDTH + VALUE_WIDTH / 2}" y="14">${label} ${scoreText}</text>
+  </g>
+</svg>`;
+}
+/**
+ * Generate a simple text badge for markdown.
+ *
+ * @param level - The certification level
+ * @param score - The overall score (0-100)
+ * @returns Markdown badge text
+ *
+ * @example
+ * ```typescript
+ * const badge = generateTextBadge("APPROVED", 85);
+ * // Returns: "![Certification: Approved](https://img.shields.io/badge/certification-Approved%2085%2F100-eab308)"
+ * ```
+ */
+export function generateTextBadge(level, score) {
+    const color = LEVEL_COLORS[level]?.replace("#", "") || "gray";
+    const label = encodeURIComponent(LEVEL_LABELS[level] || level);
+    const scoreText = encodeURIComponent(`${Math.round(score)}/100`);
+    return `![Certification: ${LEVEL_LABELS[level] || level}](https://img.shields.io/badge/certification-${label}%20${scoreText}-${color})`;
+}
+/**
+ * Generate a compact score-only badge.
+ *
+ * @param score - The overall score (0-100)
+ * @returns SVG string for score badge
+ */
+export function generateScoreBadgeSvg(score) {
+    const roundedScore = Math.round(score);
+    // Determine color based on score
+    let color;
+    if (roundedScore >= 90) {
+        color = LEVEL_COLORS.CERTIFIED;
+    }
+    else if (roundedScore >= 70) {
+        color = LEVEL_COLORS.APPROVED;
+    }
+    else if (roundedScore >= 40) {
+        color = LEVEL_COLORS.REVIEW_REQUIRED;
+    }
+    else {
+        color = LEVEL_COLORS.BLOCKED;
+    }
+    const width = 90;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${BADGE_HEIGHT}" role="img" aria-label="score: ${roundedScore}">
+  <title>score: ${roundedScore}</title>
+  <linearGradient id="s" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="r">
+    <rect width="${width}" height="${BADGE_HEIGHT}" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#r)">
+    <rect width="45" height="${BADGE_HEIGHT}" fill="#555"/>
+    <rect x="45" width="45" height="${BADGE_HEIGHT}" fill="${color}"/>
+    <rect width="${width}" height="${BADGE_HEIGHT}" fill="url(#s)"/>
+  </g>
+  <g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="11">
+    <text aria-hidden="true" x="22" y="15" fill="#010101" fill-opacity=".3">score</text>
+    <text x="22" y="14">score</text>
+    <text aria-hidden="true" x="67" y="15" fill="#010101" fill-opacity=".3">${roundedScore}/100</text>
+    <text x="67" y="14">${roundedScore}/100</text>
+  </g>
+</svg>`;
+}
+/**
+ * Generate badge markdown for embedding in README.
+ *
+ * @param level - The certification level
+ * @param score - The overall score (0-100)
+ * @param badgePath - Relative path to the badge SVG file
+ * @returns Markdown string for embedding the badge
+ */
+export function generateBadgeMarkdown(level, score, badgePath = "./certification-badge.svg") {
+    const label = LEVEL_LABELS[level] || level;
+    return `[![Certification: ${label} ${Math.round(score)}/100](${badgePath})](./CERTIFICATION.md)`;
+}
+//# sourceMappingURL=badge.js.map

package/dist/certification/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../src/certification/badge.ts"],"names":[],"mappings":"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"}

package/dist/certification/cache.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Incremental Certification Caching
+ *
+ * Tracks file hashes to enable incremental certification. Instead of re-auditing
+ * the entire codebase, only changed files are analyzed in subsequent runs.
+ *
+ * Cache structure:
+ * ```
+ * .vaspera/certifications/{cert-id}/cache.json
+ * ```
+ *
+ * @module certification/cache
+ */
+/**
+ * Hash information for a single file
+ */
+export interface FileHash {
+    /** Relative path from project root */
+    path: string;
+    /** SHA-256 hash of file contents */
+    hash: string;
+    /** ISO timestamp of when this file was last checked */
+    lastChecked: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Certification cache containing file hashes
+ */
+export interface CertificationCache {
+    /** Cache format version for future compatibility */
+    version: 1;
+    /** Combined hash of all project files */
+    projectHash: string;
+    /** Timestamp when cache was created */
+    createdAt: string;
+    /** Timestamp when cache was last updated */
+    updatedAt: string;
+    /** Individual file hashes */
+    files: FileHash[];
+}
+/**
+ * Result of comparing current files against cache
+ */
+export interface CacheComparison {
+    /** Files that have changed since last certification */
+    changed: string[];
+    /** Files that are new since last certification */
+    added: string[];
+    /** Files that were removed since last certification */
+    removed: string[];
+    /** Files that are unchanged */
+    unchanged: string[];
+    /** Whether the cache is valid and can be used */
+    cacheValid: boolean;
+}
+/**
+ * Compute SHA-256 hash of a file
+ *
+ * @param filePath - Absolute path to the file
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function hashFile(filePath: string): Promise<string>;
+/**
+ * Compute a combined hash of multiple file hashes
+ *
+ * @param hashes - Array of file hashes to combine
+ * @returns Hex-encoded SHA-256 hash of all files
+ */
+export declare function computeProjectHash(hashes: FileHash[]): string;
+/**
+ * Generate file hashes for all relevant files in a project
+ *
+ * @param projectPath - Absolute path to project root
+ * @returns Array of file hashes
+ */
+export declare function generateFileHashes(projectPath: string): Promise<FileHash[]>;
+/**
+ * Load certification cache from disk
+ *
+ * @param certDir - Certification directory path
+ * @returns Cache object or null if not found/invalid
+ */
+export declare function loadCache(certDir: string): Promise<CertificationCache | null>;
+/**
+ * Save certification cache to disk
+ *
+ * @param certDir - Certification directory path
+ * @param cache - Cache object to save
+ */
+export declare function saveCache(certDir: string, cache: CertificationCache): Promise<void>;
+/**
+ * Create a new cache from current project state
+ *
+ * @param projectPath - Absolute path to project root
+ * @returns New certification cache
+ */
+export declare function createCache(projectPath: string): Promise<CertificationCache>;
+/**
+ * Compare current project state against a cached state
+ *
+ * @param projectPath - Absolute path to project root
+ * @param cache - Previous certification cache
+ * @returns Comparison result showing what changed
+ */
+export declare function compareWithCache(projectPath: string, cache: CertificationCache): Promise<CacheComparison>;
+/**
+ * Get list of files that need re-auditing based on cache comparison
+ *
+ * @param comparison - Result of cache comparison
+ * @returns Array of file paths that need to be re-audited
+ */
+export declare function getFilesToAudit(comparison: CacheComparison): string[];
+/**
+ * Check if incremental audit is possible (cache exists and is valid structure)
+ *
+ * @param certDir - Certification directory path
+ * @returns Whether incremental audit can be performed
+ */
+export declare function canUseIncrementalAudit(certDir: string): Promise<boolean>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/certification/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/certification/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,EAAE,CAAC,CAAC;IACX,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;CACrB;AA2BD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAQ7D;AAgED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA0BjF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgBnF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CASzF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYlF;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,eAAe,CAAC,CA8C1B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,EAAE,CAErE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9E"}

package/dist/certification/cache.js

@@ -0,0 +1,275 @@
+/**
+ * Incremental Certification Caching
+ *
+ * Tracks file hashes to enable incremental certification. Instead of re-auditing
+ * the entire codebase, only changed files are analyzed in subsequent runs.
+ *
+ * Cache structure:
+ * ```
+ * .vaspera/certifications/{cert-id}/cache.json
+ * ```
+ *
+ * @module certification/cache
+ */
+import { createHash } from "crypto";
+import { readFile, writeFile, readdir, stat } from "fs/promises";
+import { join, relative } from "path";
+import { logger } from "../logger.js";
+/**
+ * Default file patterns to include in hashing
+ */
+const DEFAULT_INCLUDE_PATTERNS = [
+    /\.(ts|tsx|js|jsx|mjs|cjs)$/,
+    /\.(json)$/,
+    /\.(sql)$/,
+    /\.(env\.example)$/,
+];
+/**
+ * Patterns to exclude from hashing
+ */
+const EXCLUDE_PATTERNS = [
+    /node_modules/,
+    /\.git/,
+    /dist/,
+    /build/,
+    /coverage/,
+    /\.vaspera/,
+    /\.next/,
+    /\.turbo/,
+    /\.cache/,
+];
+/**
+ * Compute SHA-256 hash of a file
+ *
+ * @param filePath - Absolute path to the file
+ * @returns Hex-encoded SHA-256 hash
+ */
+export async function hashFile(filePath) {
+    const content = await readFile(filePath);
+    return createHash("sha256").update(content).digest("hex");
+}
+/**
+ * Compute a combined hash of multiple file hashes
+ *
+ * @param hashes - Array of file hashes to combine
+ * @returns Hex-encoded SHA-256 hash of all files
+ */
+export function computeProjectHash(hashes) {
+    const combined = hashes
+        .slice()
+        .sort((a, b) => a.path.localeCompare(b.path))
+        .map((f) => `${f.path}:${f.hash}`)
+        .join("\n");
+    return createHash("sha256").update(combined).digest("hex");
+}
+/**
+ * Check if a file path should be included in hashing
+ */
+function shouldIncludeFile(filePath) {
+    // Check exclusions first
+    for (const pattern of EXCLUDE_PATTERNS) {
+        if (pattern.test(filePath)) {
+            return false;
+        }
+    }
+    // Check inclusions
+    for (const pattern of DEFAULT_INCLUDE_PATTERNS) {
+        if (pattern.test(filePath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Recursively scan a directory for hashable files
+ *
+ * @param dirPath - Directory to scan
+ * @param projectRoot - Project root for relative paths
+ * @returns Array of absolute file paths
+ */
+async function scanDirectory(dirPath, projectRoot) {
+    const files = [];
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dirPath, entry.name);
+            const relativePath = relative(projectRoot, fullPath);
+            // Skip excluded directories
+            let skip = false;
+            for (const pattern of EXCLUDE_PATTERNS) {
+                if (pattern.test(relativePath)) {
+                    skip = true;
+                    break;
+                }
+            }
+            if (skip)
+                continue;
+            if (entry.isDirectory()) {
+                const subFiles = await scanDirectory(fullPath, projectRoot);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile() && shouldIncludeFile(entry.name)) {
+                files.push(fullPath);
+            }
+        }
+    }
+    catch (error) {
+        logger.warn("cache.scan_error", { dir: dirPath, error: String(error) });
+    }
+    return files;
+}
+/**
+ * Generate file hashes for all relevant files in a project
+ *
+ * @param projectPath - Absolute path to project root
+ * @returns Array of file hashes
+ */
+export async function generateFileHashes(projectPath) {
+    const filePaths = await scanDirectory(projectPath, projectPath);
+    const hashes = [];
+    const now = new Date().toISOString();
+    for (const filePath of filePaths) {
+        try {
+            const [hash, stats] = await Promise.all([hashFile(filePath), stat(filePath)]);
+            hashes.push({
+                path: relative(projectPath, filePath),
+                hash,
+                lastChecked: now,
+                size: stats.size,
+            });
+        }
+        catch (error) {
+            logger.warn("cache.hash_error", { file: filePath, error: String(error) });
+        }
+    }
+    logger.debug("cache.hashes_generated", {
+        project: projectPath,
+        fileCount: hashes.length,
+    });
+    return hashes;
+}
+/**
+ * Load certification cache from disk
+ *
+ * @param certDir - Certification directory path
+ * @returns Cache object or null if not found/invalid
+ */
+export async function loadCache(certDir) {
+    try {
+        const cachePath = join(certDir, "cache.json");
+        const content = await readFile(cachePath, "utf-8");
+        const cache = JSON.parse(content);
+        // Validate cache version
+        if (cache.version !== 1) {
+            logger.warn("cache.version_mismatch", { expected: 1, got: cache.version });
+            return null;
+        }
+        return cache;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save certification cache to disk
+ *
+ * @param certDir - Certification directory path
+ * @param cache - Cache object to save
+ */
+export async function saveCache(certDir, cache) {
+    const cachePath = join(certDir, "cache.json");
+    await writeFile(cachePath, JSON.stringify(cache, null, 2), "utf-8");
+    logger.debug("cache.saved", {
+        certDir,
+        fileCount: cache.files.length,
+        projectHash: cache.projectHash.slice(0, 12),
+    });
+}
+/**
+ * Create a new cache from current project state
+ *
+ * @param projectPath - Absolute path to project root
+ * @returns New certification cache
+ */
+export async function createCache(projectPath) {
+    const files = await generateFileHashes(projectPath);
+    const projectHash = computeProjectHash(files);
+    const now = new Date().toISOString();
+    return {
+        version: 1,
+        projectHash,
+        createdAt: now,
+        updatedAt: now,
+        files,
+    };
+}
+/**
+ * Compare current project state against a cached state
+ *
+ * @param projectPath - Absolute path to project root
+ * @param cache - Previous certification cache
+ * @returns Comparison result showing what changed
+ */
+export async function compareWithCache(projectPath, cache) {
+    const currentHashes = await generateFileHashes(projectPath);
+    const oldHashMap = new Map(cache.files.map((f) => [f.path, f.hash]));
+    const newHashMap = new Map(currentHashes.map((f) => [f.path, f.hash]));
+    const changed = [];
+    const added = [];
+    const removed = [];
+    const unchanged = [];
+    // Check current files against cache
+    for (const file of currentHashes) {
+        const oldHash = oldHashMap.get(file.path);
+        if (oldHash === undefined) {
+            added.push(file.path);
+        }
+        else if (oldHash !== file.hash) {
+            changed.push(file.path);
+        }
+        else {
+            unchanged.push(file.path);
+        }
+    }
+    // Check for removed files
+    for (const oldFile of cache.files) {
+        if (!newHashMap.has(oldFile.path)) {
+            removed.push(oldFile.path);
+        }
+    }
+    const cacheValid = changed.length === 0 && added.length === 0 && removed.length === 0;
+    logger.info("cache.compared", {
+        changed: changed.length,
+        added: added.length,
+        removed: removed.length,
+        unchanged: unchanged.length,
+        cacheValid,
+    });
+    return {
+        changed,
+        added,
+        removed,
+        unchanged,
+        cacheValid,
+    };
+}
+/**
+ * Get list of files that need re-auditing based on cache comparison
+ *
+ * @param comparison - Result of cache comparison
+ * @returns Array of file paths that need to be re-audited
+ */
+export function getFilesToAudit(comparison) {
+    return [...comparison.changed, ...comparison.added];
+}
+/**
+ * Check if incremental audit is possible (cache exists and is valid structure)
+ *
+ * @param certDir - Certification directory path
+ * @returns Whether incremental audit can be performed
+ */
+export async function canUseIncrementalAudit(certDir) {
+    const cache = await loadCache(certDir);
+    return cache !== null && cache.version === 1 && cache.files.length > 0;
+}
+//# sourceMappingURL=cache.js.map

package/dist/certification/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/certification/cache.ts"],"names":[],"mappings":"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"}

package/dist/certification/cache.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for certification cache module
+ */
+export {};
+//# sourceMappingURL=cache.test.d.ts.map

package/dist/certification/cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../../src/certification/cache.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}