@dewtech/dare-cli 3.10.0 → 3.12.0

package/skills/dare-quality-telemetry/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@dewtech/dare-skill-quality-telemetry",
+  "version": "1.0.0",
+  "description": "dare-quality-telemetry — Quality metrics collection and regression detection for DARE projects",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "skill.yml"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.41",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "keywords": [
+    "dare",
+    "dare-method",
+    "dare-quality-telemetry",
+    "metrics",
+    "ci",
+    "quality",
+    "regression-detection"
+  ],
+  "author": "Wanderson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dewtech-technologies/dare-method.git",
+    "directory": "packages/skills/dare-quality-telemetry"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/skills/dare-quality-telemetry/regression.ts

@@ -0,0 +1,60 @@
+/**
+ * dare-quality-telemetry — regression detection
+ * Compares two ProjectMetricReports and returns a list of regressions.
+ * License: MIT
+ */
+
+import { ProjectMetricReport, RegressionResult } from './types.js';
+
+/**
+ * Detects regressions between a baseline and current report.
+ *
+ * A regression is defined as: a metric that was `pass: true` in the baseline
+ * but is now `pass: false` in the current report.
+ *
+ * Improvements (fail → pass) are not reported as regressions.
+ *
+ * @param baseline - The reference report (e.g., from the main branch).
+ * @param current  - The report from the current branch/build.
+ * @returns Array of RegressionResult for each regressed metric.
+ */
+export function detectRegressions(
+  baseline: ProjectMetricReport,
+  current: ProjectMetricReport
+): RegressionResult[] {
+  const regressions: RegressionResult[] = [];
+
+  // Build a lookup map for baseline metrics: skillName -> metricId -> pass
+  const baselineMap = new Map<string, boolean>();
+
+  for (const skillReport of baseline.skills) {
+    for (const metric of skillReport.metrics) {
+      const key = `${skillReport.skillName}::${metric.id}`;
+      baselineMap.set(key, metric.pass);
+    }
+  }
+
+  // Compare each current metric against the baseline
+  for (const skillReport of current.skills) {
+    for (const metric of skillReport.metrics) {
+      const key = `${skillReport.skillName}::${metric.id}`;
+      const baselinePass = baselineMap.get(key);
+
+      // Only report if we have a baseline value for this metric
+      if (baselinePass === undefined) continue;
+
+      const regressed = baselinePass === true && metric.pass === false;
+
+      regressions.push({
+        skill: skillReport.skillName,
+        metricId: metric.id,
+        baseline: baselinePass,
+        current: metric.pass,
+        regressed,
+      });
+    }
+  }
+
+  // Filter: only return actual regressions (pass → fail)
+  return regressions.filter((r) => r.regressed);
+}

package/skills/dare-quality-telemetry/reporter.ts

@@ -0,0 +1,132 @@
+/**
+ * dare-quality-telemetry — report formatters
+ * Formats ProjectMetricReport into ASCII table, JSON, and PR comment markdown.
+ * License: MIT
+ */
+
+import { ProjectMetricReport, RegressionResult } from './types.js';
+
+const PASS_ICON = '✅';
+const FAIL_ICON = '❌';
+
+/**
+ * Formats a ProjectMetricReport as an ASCII table.
+ *
+ * Example output:
+ * ┌─────────────────────────┬───────┬────────────────────────────────────────────────────┐
+ * │ Skill / Metric          │ Pass  │ Details                                            │
+ * ├─────────────────────────┼───────┼────────────────────────────────────────────────────┤
+ * │ dare-ax / M-01          │  ✅   │ All 5 required sections present in llms.txt        │
+ * ...
+ */
+export function formatTable(report: ProjectMetricReport): string {
+  const COL1 = 30;
+  const COL2 = 7;
+  const COL3 = 52;
+
+  const hr = `├${'─'.repeat(COL1 + 2)}┼${'─'.repeat(COL2 + 2)}┼${'─'.repeat(COL3 + 2)}┤`;
+  const top = `┌${'─'.repeat(COL1 + 2)}┬${'─'.repeat(COL2 + 2)}┬${'─'.repeat(COL3 + 2)}┐`;
+  const bot = `└${'─'.repeat(COL1 + 2)}┴${'─'.repeat(COL2 + 2)}┴${'─'.repeat(COL3 + 2)}┘`;
+
+  const pad = (str: string, width: number) =>
+    str.length >= width ? str.slice(0, width) : str + ' '.repeat(width - str.length);
+
+  const row = (c1: string, c2: string, c3: string) =>
+    `│ ${pad(c1, COL1)} │ ${pad(c2, COL2)} │ ${pad(c3, COL3)} │`;
+
+  const lines: string[] = [];
+  lines.push(top);
+  lines.push(row('Skill / Metric', 'Pass', 'Details'));
+
+  for (const skillReport of report.skills) {
+    lines.push(hr);
+    for (const metric of skillReport.metrics) {
+      const label = `${skillReport.skillName} / ${metric.id}`;
+      const icon = metric.pass ? PASS_ICON : FAIL_ICON;
+      const details = metric.details || metric.description;
+      lines.push(row(label, icon, details));
+    }
+  }
+
+  lines.push(hr);
+  lines.push(
+    row(
+      'OVERALL',
+      report.overall.allPass ? PASS_ICON : FAIL_ICON,
+      `${report.overall.score} metrics passed — commit: ${report.commit}`
+    )
+  );
+  lines.push(bot);
+
+  return lines.join('\n');
+}
+
+/**
+ * Formats a ProjectMetricReport as pretty-printed JSON.
+ */
+export function formatJSON(report: ProjectMetricReport): string {
+  return JSON.stringify(report, null, 2);
+}
+
+/**
+ * Formats a ProjectMetricReport as a GitHub PR comment in Markdown.
+ *
+ * Includes regression warnings if regressions are provided.
+ */
+export function formatPRComment(
+  report: ProjectMetricReport,
+  regressions: RegressionResult[] = []
+): string {
+  const overallIcon = report.overall.allPass ? PASS_ICON : FAIL_ICON;
+  const overallStatus = report.overall.allPass ? 'All metrics passing' : 'Some metrics failing';
+
+  const lines: string[] = [
+    `## DARE Quality Metrics ${overallIcon}`,
+    '',
+    `**Status:** ${overallStatus} — **${report.overall.score}** metrics passed`,
+    `**Commit:** \`${report.commit}\``,
+    `**Timestamp:** ${report.timestamp}`,
+    '',
+  ];
+
+  // Skill-by-skill breakdown
+  for (const skillReport of report.skills) {
+    const skillIcon = skillReport.summary.allPass ? PASS_ICON : FAIL_ICON;
+    lines.push(`### ${skillIcon} ${skillReport.skillName} (${skillReport.summary.score})`);
+    lines.push('');
+    lines.push('| Metric | Status | Details |');
+    lines.push('|--------|--------|---------|');
+
+    for (const metric of skillReport.metrics) {
+      const icon = metric.pass ? PASS_ICON : FAIL_ICON;
+      const details = (metric.details || metric.description).replace(/\|/g, '\\|');
+      lines.push(`| ${metric.id} | ${icon} | ${details} |`);
+    }
+    lines.push('');
+  }
+
+  // Regression warnings
+  if (regressions.length > 0) {
+    lines.push('---');
+    lines.push('');
+    lines.push(`### ⚠️ Regressions Detected (${regressions.length})`);
+    lines.push('');
+    lines.push('The following metrics regressed compared to the baseline:');
+    lines.push('');
+    lines.push('| Skill | Metric | Baseline | Current |');
+    lines.push('|-------|--------|----------|---------|');
+
+    for (const r of regressions) {
+      lines.push(
+        `| ${r.skill} | ${r.metricId} | ${r.baseline ? PASS_ICON : FAIL_ICON} | ${r.current ? PASS_ICON : FAIL_ICON} |`
+      );
+    }
+    lines.push('');
+  }
+
+  lines.push('---');
+  lines.push('');
+  lines.push('*Generated by [dare-quality-telemetry](https://github.com/dewtech-technologies/dare-method)*');
+
+  return lines.join('\n');
+}

package/skills/dare-quality-telemetry/skill.yml

@@ -0,0 +1,18 @@
+name: dare-quality-telemetry
+version: 1.0.0
+description: "Quality metrics collection and regression detection for DARE projects"
+author: Wanderson
+license: MIT
+dare_version: ">=3.0.0"
+dependencies:
+  dare-ax: ">=1.0.0"
+  dare-layered-design: ">=1.0.0"
+metrics:
+  - id: M-01
+    description: 100% of builds include metrics collection (skill installed = always true)
+  - id: M-02
+    description: 0 regressions go undetected (baseline file exists for comparison)
+  - id: M-03
+    description: Metrics history maintained (tmp/dare_metrics.json exists)
+  - id: M-04
+    description: GitHub Actions workflow exists (.github/workflows/dare-metrics.yml)