jaku.sh 1.0.0

package/src/utils/finding.js

@@ -0,0 +1,67 @@
+import { nanoid } from 'nanoid';
+
+const SEVERITY_ORDER = ['critical', 'high', 'medium', 'low', 'info'];
+
+/**
+ * Creates a JAKU Finding object matching the manifest schema.
+ */
+export function createFinding({
+    module = 'qa',
+    title,
+    severity = 'info',
+    affected_surface,
+    description,
+    reproduction = [],
+    evidence = null,
+    remediation = '',
+    references = [],
+    status = 'open',
+}) {
+    const prefix = module.toUpperCase();
+    const shortId = nanoid(6);
+
+    return {
+        id: `JAKU-${prefix}-${shortId}`,
+        module,
+        title,
+        severity: severity.toLowerCase(),
+        affected_surface,
+        description,
+        reproduction: Array.isArray(reproduction) ? reproduction : [reproduction],
+        evidence,
+        remediation,
+        references,
+        status,
+        timestamp: new Date().toISOString(),
+    };
+}
+
+/**
+ * Sorts findings by severity (critical first).
+ */
+export function sortFindings(findings) {
+    return [...findings].sort((a, b) => {
+        return SEVERITY_ORDER.indexOf(a.severity) - SEVERITY_ORDER.indexOf(b.severity);
+    });
+}
+
+/**
+ * Filters findings by minimum severity threshold.
+ */
+export function filterBySeverity(findings, threshold = 'low') {
+    const thresholdIndex = SEVERITY_ORDER.indexOf(threshold);
+    return findings.filter(f => SEVERITY_ORDER.indexOf(f.severity) <= thresholdIndex);
+}
+
+/**
+ * Generates a summary count by severity.
+ */
+export function severitySummary(findings) {
+    const summary = { critical: 0, high: 0, medium: 0, low: 0, info: 0, total: findings.length };
+    for (const f of findings) {
+        if (summary[f.severity] !== undefined) summary[f.severity]++;
+    }
+    return summary;
+}
+
+export default { createFinding, sortFindings, filterBySeverity, severitySummary };

package/src/utils/logger.js

@@ -0,0 +1,50 @@
+import winston from 'winston';
+import path from 'path';
+import fs from 'fs';
+
+const LOG_DIR = path.join(process.cwd(), 'jaku-reports', 'logs');
+
+export function createLogger(options = {}) {
+  const { verbose = false, logDir = LOG_DIR } = options;
+
+  if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+  }
+
+  const logger = winston.createLogger({
+    level: verbose ? 'debug' : 'info',
+    format: winston.format.combine(
+      winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
+      winston.format.errors({ stack: true }),
+      winston.format.json()
+    ),
+    defaultMeta: { agent: 'JAKU' },
+    transports: [
+      new winston.transports.File({
+        filename: path.join(logDir, 'jaku-error.log'),
+        level: 'error',
+      }),
+      new winston.transports.File({
+        filename: path.join(logDir, 'jaku-audit.log'),
+      }),
+    ],
+  });
+
+  if (process.env.NODE_ENV !== 'production') {
+    logger.add(
+      new winston.transports.Console({
+        format: winston.format.combine(
+          winston.format.colorize(),
+          winston.format.printf(({ level, message, timestamp }) => {
+            return `${timestamp} [${level}]: ${message}`;
+          })
+        ),
+        silent: !verbose,
+      })
+    );
+  }
+
+  return logger;
+}
+
+export default createLogger;