Professional Documentation

import {
  detectProject,
  runDiagnostics,
  runScoring,
  runAutoFix,
  generateSBOM,
} from "@waiyat/devops";

// 1. Detect project metadata & stack
const project = detectProject(process.cwd());
console.log(
  `Stack: ${project.languages.join(", ")} | Frameworks: ${project.frameworks.join(", ")}`
);

// 2. Run diagnostics across all categories
const report = runDiagnostics(process.cwd(), project);
console.log(`Preflight Score: ${report.score}/100 [Ready: ${report.overallReady}]`);
console.log(
  `Summary: ${report.passedCount} passed, ${report.warnCount} warnings, ${report.errorCount} errors`
);

// 3. Compute weighted health score via Scoring layer
const score = runScoring(process.cwd(), project);
console.log(
  `Weighted Score: ${score.overall}/100 | Categories: ${JSON.stringify(score.categories)}`
);

// 4. Generate CycloneDX v1.5 SBOM
const sbom = generateSBOM(process.cwd(), project);
console.log(`Indexed ${sbom.components.length} packages in CycloneDX v1.5`);

// 5. Auto-heal repository issues
const fixResult = runAutoFix({ dryRun: true, rootDir: process.cwd() });
console.log(`Actions to apply: ${fixResult.actions.length}`);

name: CI Quality Gate

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  ci:
    uses: Waiyat/devops/.github/workflows/reusable-ci.yml@main
    with:
      node-version: '22'
      package-manager: 'pnpm'
      run-build: true
      run-test: true
      run-audit: true

  security:
    needs: [ci]
    uses: Waiyat/devops/.github/workflows/reusable-security.yml@main