@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/sops/compliance-checker.d.ts

@@ -0,0 +1,83 @@
+/**
+ * SOP Compliance Checker
+ *
+ * Checks project artifacts against AI-SDLC SOP requirements
+ * and determines compliance status.
+ *
+ * @module sops/compliance-checker
+ */
+import { SOPAssessment, SOPCategory } from './types.js';
+/**
+ * Compliance check options
+ */
+export interface ComplianceCheckOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Documentation path relative to project root */
+    docsPath?: string;
+    /** SOPs to check (default: all applicable) */
+    sopIds?: string[];
+    /** Categories to include */
+    categories?: SOPCategory[];
+    /** Whether to perform deep analysis */
+    deepAnalysis?: boolean;
+    /** Assessor name */
+    assessor?: string;
+    /** Custom artifact patterns */
+    artifactPatterns?: Record<string, string[]>;
+}
+/**
+ * Evidence item found during checking
+ */
+export interface EvidenceItem {
+    /** Requirement ID this evidence supports */
+    requirementId: string;
+    /** File path where evidence was found */
+    filePath: string;
+    /** Type of evidence */
+    type: 'document' | 'code' | 'test' | 'config' | 'artifact';
+    /** Description of the evidence */
+    description: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Relevant excerpt from file */
+    excerpt?: string;
+}
+/**
+ * Result of a compliance check
+ */
+export interface ComplianceCheckResult {
+    /** Whether check completed successfully */
+    success: boolean;
+    /** Project name */
+    projectName: string;
+    /** Check timestamp */
+    checkedAt: Date;
+    /** Assessments by SOP */
+    assessments: SOPAssessment[];
+    /** Evidence found */
+    evidence: EvidenceItem[];
+    /** Overall compliance score */
+    overallScore: number;
+    /** Summary by category */
+    categoryScores: Record<SOPCategory, number>;
+    /** Errors encountered */
+    errors: string[];
+}
+/**
+ * Check compliance for a project against AI-SDLC SOPs
+ */
+export declare function checkCompliance(options: ComplianceCheckOptions): Promise<ComplianceCheckResult>;
+/**
+ * Quick check for a specific SOP
+ */
+export declare function checkSOPCompliance(sopId: string, projectRoot: string, docsPath?: string): Promise<SOPAssessment | null>;
+/**
+ * Check if project meets minimum compliance threshold
+ */
+export declare function meetsMinimumCompliance(projectRoot: string, threshold?: number, categories?: SOPCategory[]): Promise<{
+    meets: boolean;
+    score: number;
+    gaps: string[];
+}>;
+//# sourceMappingURL=compliance-checker.d.ts.map

package/dist/sops/compliance-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-checker.d.ts","sourceRoot":"","sources":["../../src/sops/compliance-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,aAAa,EAGb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAE3B,uCAAuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE3D,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,SAAS,EAAE,IAAI,CAAC;IAEhB,yBAAyB;IACzB,WAAW,EAAE,aAAa,EAAE,CAAC;IAE7B,qBAAqB;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE5C,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA4CD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAkFhC;AAsaD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAe,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ/B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAW,EACtB,UAAU,CAAC,EAAE,WAAW,EAAE,GACzB,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAe5D"}

package/dist/sops/compliance-checker.js

@@ -0,0 +1,399 @@
+import { existsSync, statSync, readFileSync } from "fs";
+import { basename, join, extname } from "path";
+import { ComplianceStatus, IRBStatus, SOPCategory, SOPPriority } from "./types.js";
+import { getSOPById, getSOPsByCategory, getAllSOPs } from "./registry.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("compliance-checker");
+const DEFAULT_ARTIFACT_PATTERNS = {
+  // Documentation artifacts
+  "requirements": ["requirements.md", "requirements.txt", "REQUIREMENTS.md", "specs/", "requirements/"],
+  "architecture": ["ARCHITECTURE.md", "architecture/", "design/", "ADR-*.md", "adr/"],
+  "testing": ["tests/", "__tests__/", "test/", "*.test.ts", "*.spec.ts", "jest.config.*", "vitest.config.*"],
+  "security": ["SECURITY.md", "security/", ".snyk", "security-policy.md"],
+  "ethics": ["ETHICS.md", "ethics/", "AI-ETHICS.md", "bias-assessment.md"],
+  "changelog": ["CHANGELOG.md", "HISTORY.md", "releases/"],
+  "readme": ["README.md", "README.txt", "readme.md"],
+  "license": ["LICENSE", "LICENSE.md", "LICENSE.txt"],
+  "contributing": ["CONTRIBUTING.md", "CONTRIBUTORS.md"],
+  "code-of-conduct": ["CODE_OF_CONDUCT.md"],
+  "ci-cd": [".github/workflows/", ".gitlab-ci.yml", "Jenkinsfile", ".circleci/"],
+  "docker": ["Dockerfile", "docker-compose.yml", ".dockerignore"],
+  "monitoring": ["monitoring/", "observability/", "metrics/", "prometheus.yml"],
+  "validation": ["validation/", "schemas/", "*.schema.json", "zod/", "yup/"],
+  "config-management": [".env.example", "config/", "settings/", "*.config.js", "*.config.ts"],
+  "data-management": ["data/", "datasets/", "migrations/", "seeds/"],
+  "model-cards": ["MODEL_CARD.md", "model-card.md", "model-cards/"],
+  "api-docs": ["openapi.yaml", "swagger.json", "api/", "API.md"],
+  "privacy": ["PRIVACY.md", "privacy-policy.md", "data-protection.md"]
+};
+async function checkCompliance(options) {
+  const {
+    projectRoot,
+    docsPath = "docs",
+    sopIds,
+    categories,
+    deepAnalysis = false,
+    assessor = "automated",
+    artifactPatterns = DEFAULT_ARTIFACT_PATTERNS
+  } = options;
+  logger.info("Starting compliance check", { projectRoot, docsPath });
+  const result = {
+    success: true,
+    projectName: basename(projectRoot),
+    checkedAt: /* @__PURE__ */ new Date(),
+    assessments: [],
+    evidence: [],
+    overallScore: 0,
+    categoryScores: {},
+    errors: []
+  };
+  try {
+    let sopsToCheck = [];
+    if (sopIds && sopIds.length > 0) {
+      for (const id of sopIds) {
+        const sop = getSOPById(id);
+        if (sop) {
+          sopsToCheck.push(sop);
+        } else {
+          result.errors.push(`SOP not found: ${id}`);
+        }
+      }
+    } else if (categories && categories.length > 0) {
+      for (const category of categories) {
+        sopsToCheck.push(...getSOPsByCategory(category));
+      }
+    } else {
+      sopsToCheck = getAllSOPs();
+    }
+    const projectArtifacts = scanProjectArtifacts(projectRoot, docsPath, artifactPatterns);
+    logger.debug("Found project artifacts", { count: projectArtifacts.size });
+    for (const sop of sopsToCheck) {
+      const assessment = await assessSOP(
+        sop,
+        projectRoot,
+        docsPath,
+        projectArtifacts,
+        result.evidence,
+        deepAnalysis,
+        assessor
+      );
+      result.assessments.push(assessment);
+    }
+    calculateScores(result);
+    logger.info("Compliance check complete", {
+      overallScore: result.overallScore,
+      assessments: result.assessments.length,
+      evidence: result.evidence.length
+    });
+  } catch (error) {
+    result.success = false;
+    result.errors.push(String(error));
+    logger.error(`Compliance check failed: ${String(error)}`);
+  }
+  return result;
+}
+function scanProjectArtifacts(projectRoot, docsPath, patterns) {
+  const artifacts = /* @__PURE__ */ new Map();
+  for (const [category, filePatterns] of Object.entries(patterns)) {
+    const found = [];
+    for (const pattern of filePatterns) {
+      const rootPath = join(projectRoot, pattern);
+      if (existsSync(rootPath)) {
+        found.push(rootPath);
+      }
+      const docsFullPath = join(projectRoot, docsPath, pattern);
+      if (existsSync(docsFullPath)) {
+        found.push(docsFullPath);
+      }
+    }
+    if (found.length > 0) {
+      artifacts.set(category, found);
+    }
+  }
+  return artifacts;
+}
+async function assessSOP(sop, projectRoot, docsPath, projectArtifacts, evidenceList, deepAnalysis, assessor) {
+  const requirementsMet = [];
+  const requirementsGaps = [];
+  const evidence = {};
+  for (const requirement of sop.requirements) {
+    const { met, evidenceFound } = checkRequirement(
+      requirement,
+      projectRoot,
+      docsPath,
+      projectArtifacts,
+      deepAnalysis
+    );
+    if (met) {
+      requirementsMet.push(requirement.id);
+      if (evidenceFound) {
+        evidence[requirement.id] = evidenceFound.filePath;
+        evidenceList.push(evidenceFound);
+      }
+    } else {
+      requirementsGaps.push(requirement.id);
+    }
+  }
+  const totalRequirements = sop.requirements.length;
+  const mandatoryRequirements = sop.requirements.filter((r) => r.mandatory);
+  const mandatoryMet = mandatoryRequirements.filter((r) => requirementsMet.includes(r.id));
+  let score = 0;
+  if (totalRequirements > 0) {
+    const mandatoryWeight = 0.7;
+    const optionalWeight = 0.3;
+    const mandatoryScore = mandatoryRequirements.length > 0 ? mandatoryMet.length / mandatoryRequirements.length * 100 : 100;
+    const optionalRequirements = sop.requirements.filter((r) => !r.mandatory);
+    const optionalMet = optionalRequirements.filter((r) => requirementsMet.includes(r.id));
+    const optionalScore = optionalRequirements.length > 0 ? optionalMet.length / optionalRequirements.length * 100 : 100;
+    score = Math.round(mandatoryScore * mandatoryWeight + optionalScore * optionalWeight);
+  }
+  let status;
+  if (score >= 90) {
+    status = ComplianceStatus.COMPLIANT;
+  } else if (score >= 50) {
+    status = ComplianceStatus.PARTIAL;
+  } else if (score > 0) {
+    status = ComplianceStatus.NON_COMPLIANT;
+  } else {
+    status = ComplianceStatus.PENDING;
+  }
+  let irbStatus = IRBStatus.NOT_REQUIRED;
+  if (sop.irbTypicallyRequired) {
+    irbStatus = IRBStatus.PENDING;
+    const irbArtifacts = projectArtifacts.get("ethics") || [];
+    if (irbArtifacts.length > 0) {
+      irbStatus = IRBStatus.IN_REVIEW;
+    }
+  }
+  return {
+    sopId: sop.id,
+    status,
+    score,
+    requirementsMet,
+    requirementsGaps,
+    evidence,
+    irbStatus,
+    assessedAt: /* @__PURE__ */ new Date(),
+    assessedBy: assessor,
+    notes: `Automated assessment: ${requirementsMet.length}/${totalRequirements} requirements met`
+  };
+}
+function checkRequirement(requirement, projectRoot, docsPath, projectArtifacts, deepAnalysis) {
+  for (const artifactType of requirement.artifacts || []) {
+    const artifacts = projectArtifacts.get(artifactType);
+    if (artifacts && artifacts.length > 0) {
+      const evidenceItem = {
+        requirementId: requirement.id,
+        filePath: artifacts[0],
+        type: categorizeArtifact(artifacts[0]),
+        description: `Found ${artifactType} artifact: ${basename(artifacts[0])}`,
+        confidence: 0.8
+      };
+      if (deepAnalysis) {
+        const contentMatch = checkContentForRequirement(artifacts[0], requirement);
+        if (contentMatch) {
+          evidenceItem.confidence = 0.95;
+          evidenceItem.excerpt = contentMatch;
+        }
+      }
+      return { met: true, evidenceFound: evidenceItem };
+    }
+  }
+  switch (requirement.verification) {
+    case "document":
+      return checkDocumentEvidence(requirement, projectRoot, docsPath, projectArtifacts, deepAnalysis);
+    case "test":
+      return checkTestEvidence(requirement, projectRoot, projectArtifacts);
+    case "automated":
+      return checkAutomatedEvidence(requirement, projectRoot, projectArtifacts);
+    case "review":
+    case "audit":
+      return { met: false };
+    default:
+      return { met: false };
+  }
+}
+function checkDocumentEvidence(requirement, projectRoot, docsPath, projectArtifacts, deepAnalysis) {
+  const docPatterns = ["readme", "requirements", "architecture", "api-docs"];
+  for (const pattern of docPatterns) {
+    const artifacts = projectArtifacts.get(pattern);
+    if (artifacts && artifacts.length > 0) {
+      for (const artifact of artifacts) {
+        if (deepAnalysis) {
+          const contentMatch = checkContentForRequirement(artifact, requirement);
+          if (contentMatch) {
+            return {
+              met: true,
+              evidenceFound: {
+                requirementId: requirement.id,
+                filePath: artifact,
+                type: "document",
+                description: `Found documentation evidence in ${basename(artifact)}`,
+                confidence: 0.85,
+                excerpt: contentMatch
+              }
+            };
+          }
+        }
+      }
+    }
+  }
+  return { met: false };
+}
+function checkTestEvidence(requirement, projectRoot, projectArtifacts) {
+  const testArtifacts = projectArtifacts.get("testing");
+  if (testArtifacts && testArtifacts.length > 0) {
+    return {
+      met: true,
+      evidenceFound: {
+        requirementId: requirement.id,
+        filePath: testArtifacts[0],
+        type: "test",
+        description: `Test infrastructure found: ${basename(testArtifacts[0])}`,
+        confidence: 0.7
+      }
+    };
+  }
+  return { met: false };
+}
+function checkAutomatedEvidence(requirement, projectRoot, projectArtifacts) {
+  const ciArtifacts = projectArtifacts.get("ci-cd");
+  if (ciArtifacts && ciArtifacts.length > 0) {
+    return {
+      met: true,
+      evidenceFound: {
+        requirementId: requirement.id,
+        filePath: ciArtifacts[0],
+        type: "config",
+        description: `CI/CD configuration found: ${basename(ciArtifacts[0])}`,
+        confidence: 0.75
+      }
+    };
+  }
+  return { met: false };
+}
+function checkContentForRequirement(filePath, requirement) {
+  try {
+    const stat = statSync(filePath);
+    if (stat.isDirectory()) return null;
+    const ext = extname(filePath).toLowerCase();
+    const textExtensions = [".md", ".txt", ".ts", ".js", ".json", ".yaml", ".yml", ".html", ".rst"];
+    if (!textExtensions.includes(ext)) return null;
+    const content = readFileSync(filePath, "utf-8");
+    const lowerContent = content.toLowerCase();
+    const lowerDesc = requirement.description.toLowerCase();
+    const keywords = lowerDesc.split(/\s+/).filter((w) => w.length > 4);
+    let matchCount = 0;
+    let matchedLine = "";
+    for (const keyword of keywords) {
+      if (lowerContent.includes(keyword)) {
+        matchCount++;
+        const lines = content.split("\n");
+        for (const line of lines) {
+          if (line.toLowerCase().includes(keyword) && line.length < 200) {
+            matchedLine = line.trim();
+            break;
+          }
+        }
+      }
+    }
+    if (matchCount >= keywords.length * 0.3 && matchedLine) {
+      return matchedLine;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function categorizeArtifact(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  const name = basename(filePath).toLowerCase();
+  if ([".md", ".txt", ".rst", ".html"].includes(ext)) {
+    return "document";
+  }
+  if ([".ts", ".js", ".py", ".java", ".go", ".rs"].includes(ext)) {
+    if (name.includes("test") || name.includes("spec")) {
+      return "test";
+    }
+    return "code";
+  }
+  if ([".json", ".yaml", ".yml", ".toml", ".ini"].includes(ext)) {
+    return "config";
+  }
+  return "artifact";
+}
+function calculateScores(result) {
+  if (result.assessments.length === 0) {
+    result.overallScore = 0;
+    return;
+  }
+  const categoryTotals = {
+    [SOPCategory.PROGRAM_MANAGEMENT]: { sum: 0, count: 0 },
+    [SOPCategory.OPERATIONS]: { sum: 0, count: 0 },
+    [SOPCategory.DEVELOPMENT]: { sum: 0, count: 0 },
+    [SOPCategory.GOVERNANCE]: { sum: 0, count: 0 },
+    [SOPCategory.QUALITY]: { sum: 0, count: 0 }
+  };
+  for (const assessment of result.assessments) {
+    const sop = getSOPById(assessment.sopId);
+    if (sop) {
+      categoryTotals[sop.category].sum += assessment.score;
+      categoryTotals[sop.category].count += 1;
+    }
+  }
+  for (const category of Object.values(SOPCategory)) {
+    const totals = categoryTotals[category];
+    result.categoryScores[category] = totals.count > 0 ? Math.round(totals.sum / totals.count) : 0;
+  }
+  let weightedSum = 0;
+  let totalWeight = 0;
+  for (const assessment of result.assessments) {
+    const sop = getSOPById(assessment.sopId);
+    if (sop) {
+      const weight = getPriorityWeight(sop.priority);
+      weightedSum += assessment.score * weight;
+      totalWeight += weight;
+    }
+  }
+  result.overallScore = totalWeight > 0 ? Math.round(weightedSum / totalWeight) : 0;
+}
+function getPriorityWeight(priority) {
+  switch (priority) {
+    case SOPPriority.CRITICAL:
+      return 4;
+    case SOPPriority.HIGH:
+      return 3;
+    case SOPPriority.MEDIUM:
+      return 2;
+    case SOPPriority.LOW:
+      return 1;
+    default:
+      return 1;
+  }
+}
+async function checkSOPCompliance(sopId, projectRoot, docsPath = "docs") {
+  const result = await checkCompliance({
+    projectRoot,
+    docsPath,
+    sopIds: [sopId]
+  });
+  return result.assessments[0] || null;
+}
+async function meetsMinimumCompliance(projectRoot, threshold = 50, categories) {
+  const result = await checkCompliance({
+    projectRoot,
+    categories
+  });
+  const gaps = result.assessments.filter((a) => a.score < threshold).map((a) => a.sopId);
+  return {
+    meets: result.overallScore >= threshold,
+    score: result.overallScore,
+    gaps
+  };
+}
+export {
+  checkCompliance,
+  checkSOPCompliance,
+  meetsMinimumCompliance
+};
+//# sourceMappingURL=compliance-checker.js.map

package/dist/sops/compliance-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance-checker.js","sources":["../../src/sops/compliance-checker.ts"],"sourcesContent":["/**\n * SOP Compliance Checker\n *\n * Checks project artifacts against AI-SDLC SOP requirements\n * and determines compliance status.\n *\n * @module sops/compliance-checker\n */\n\nimport { existsSync, readdirSync, readFileSync, statSync } from 'fs';\nimport { join, basename, extname } from 'path';\nimport {\n  SOPDefinition,\n  SOPRequirement,\n  SOPAssessment,\n  ComplianceStatus,\n  IRBStatus,\n  SOPCategory,\n  SOPPriority,\n} from './types.js';\nimport { getSOPById, getSOPsByCategory, getAllSOPs } from './registry.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst logger = createLogger('compliance-checker');\n\n/**\n * Compliance check options\n */\nexport interface ComplianceCheckOptions {\n  /** Project root directory */\n  projectRoot: string;\n\n  /** Documentation path relative to project root */\n  docsPath?: string;\n\n  /** SOPs to check (default: all applicable) */\n  sopIds?: string[];\n\n  /** Categories to include */\n  categories?: SOPCategory[];\n\n  /** Whether to perform deep analysis */\n  deepAnalysis?: boolean;\n\n  /** Assessor name */\n  assessor?: string;\n\n  /** Custom artifact patterns */\n  artifactPatterns?: Record<string, string[]>;\n}\n\n/**\n * Evidence item found during checking\n */\nexport interface EvidenceItem {\n  /** Requirement ID this evidence supports */\n  requirementId: string;\n\n  /** File path where evidence was found */\n  filePath: string;\n\n  /** Type of evidence */\n  type: 'document' | 'code' | 'test' | 'config' | 'artifact';\n\n  /** Description of the evidence */\n  description: string;\n\n  /** Confidence score (0-1) */\n  confidence: number;\n\n  /** Relevant excerpt from file */\n  excerpt?: string;\n}\n\n/**\n * Result of a compliance check\n */\nexport interface ComplianceCheckResult {\n  /** Whether check completed successfully */\n  success: boolean;\n\n  /** Project name */\n  projectName: string;\n\n  /** Check timestamp */\n  checkedAt: Date;\n\n  /** Assessments by SOP */\n  assessments: SOPAssessment[];\n\n  /** Evidence found */\n  evidence: EvidenceItem[];\n\n  /** Overall compliance score */\n  overallScore: number;\n\n  /** Summary by category */\n  categoryScores: Record<SOPCategory, number>;\n\n  /** Errors encountered */\n  errors: string[];\n}\n\n/**\n * Default artifact patterns for detecting compliance evidence\n */\nconst DEFAULT_ARTIFACT_PATTERNS: Record<string, string[]> = {\n  // Documentation artifacts\n  'requirements': ['requirements.md', 'requirements.txt', 'REQUIREMENTS.md', 'specs/', 'requirements/'],\n  'architecture': ['ARCHITECTURE.md', 'architecture/', 'design/', 'ADR-*.md', 'adr/'],\n  'testing': ['tests/', '__tests__/', 'test/', '*.test.ts', '*.spec.ts', 'jest.config.*', 'vitest.config.*'],\n  'security': ['SECURITY.md', 'security/', '.snyk', 'security-policy.md'],\n  'ethics': ['ETHICS.md', 'ethics/', 'AI-ETHICS.md', 'bias-assessment.md'],\n  'changelog': ['CHANGELOG.md', 'HISTORY.md', 'releases/'],\n  'readme': ['README.md', 'README.txt', 'readme.md'],\n  'license': ['LICENSE', 'LICENSE.md', 'LICENSE.txt'],\n  'contributing': ['CONTRIBUTING.md', 'CONTRIBUTORS.md'],\n  'code-of-conduct': ['CODE_OF_CONDUCT.md'],\n  'ci-cd': ['.github/workflows/', '.gitlab-ci.yml', 'Jenkinsfile', '.circleci/'],\n  'docker': ['Dockerfile', 'docker-compose.yml', '.dockerignore'],\n  'monitoring': ['monitoring/', 'observability/', 'metrics/', 'prometheus.yml'],\n  'validation': ['validation/', 'schemas/', '*.schema.json', 'zod/', 'yup/'],\n  'config-management': ['.env.example', 'config/', 'settings/', '*.config.js', '*.config.ts'],\n  'data-management': ['data/', 'datasets/', 'migrations/', 'seeds/'],\n  'model-cards': ['MODEL_CARD.md', 'model-card.md', 'model-cards/'],\n  'api-docs': ['openapi.yaml', 'swagger.json', 'api/', 'API.md'],\n  'privacy': ['PRIVACY.md', 'privacy-policy.md', 'data-protection.md'],\n};\n\n/**\n * Keyword patterns for detecting compliance in content\n */\nconst COMPLIANCE_KEYWORDS: Record<string, string[]> = {\n  'requirements-definition': ['requirement', 'specification', 'user story', 'acceptance criteria', 'functional', 'non-functional'],\n  'risk-assessment': ['risk', 'mitigation', 'threat', 'vulnerability', 'impact', 'likelihood'],\n  'testing': ['test', 'coverage', 'unit test', 'integration test', 'e2e', 'regression'],\n  'security': ['authentication', 'authorization', 'encryption', 'secure', 'vulnerability', 'audit'],\n  'ethics': ['bias', 'fairness', 'ethical', 'responsible', 'transparency', 'accountability'],\n  'monitoring': ['monitor', 'alert', 'metric', 'observability', 'logging', 'tracing'],\n  'documentation': ['document', 'guide', 'manual', 'tutorial', 'reference'],\n  'validation': ['validate', 'verify', 'check', 'assert', 'schema', 'constraint'],\n  'privacy': ['privacy', 'gdpr', 'pii', 'data protection', 'consent', 'anonymization'],\n  'governance': ['governance', 'policy', 'procedure', 'standard', 'compliance', 'audit'],\n};\n\n/**\n * Check compliance for a project against AI-SDLC SOPs\n */\nexport async function checkCompliance(\n  options: ComplianceCheckOptions\n): Promise<ComplianceCheckResult> {\n  const {\n    projectRoot,\n    docsPath = 'docs',\n    sopIds,\n    categories,\n    deepAnalysis = false,\n    assessor = 'automated',\n    artifactPatterns = DEFAULT_ARTIFACT_PATTERNS,\n  } = options;\n\n  logger.info('Starting compliance check', { projectRoot, docsPath });\n\n  const result: ComplianceCheckResult = {\n    success: true,\n    projectName: basename(projectRoot),\n    checkedAt: new Date(),\n    assessments: [],\n    evidence: [],\n    overallScore: 0,\n    categoryScores: {} as Record<SOPCategory, number>,\n    errors: [],\n  };\n\n  try {\n    // Determine which SOPs to check\n    let sopsToCheck: SOPDefinition[] = [];\n\n    if (sopIds && sopIds.length > 0) {\n      // Check specific SOPs\n      for (const id of sopIds) {\n        const sop = getSOPById(id);\n        if (sop) {\n          sopsToCheck.push(sop);\n        } else {\n          result.errors.push(`SOP not found: ${id}`);\n        }\n      }\n    } else if (categories && categories.length > 0) {\n      // Check SOPs in specified categories\n      for (const category of categories) {\n        sopsToCheck.push(...getSOPsByCategory(category));\n      }\n    } else {\n      // Check all SOPs\n      sopsToCheck = getAllSOPs();\n    }\n\n    // Scan project for artifacts\n    const projectArtifacts = scanProjectArtifacts(projectRoot, docsPath, artifactPatterns);\n    logger.debug('Found project artifacts', { count: projectArtifacts.size });\n\n    // Check each SOP\n    for (const sop of sopsToCheck) {\n      const assessment = await assessSOP(\n        sop,\n        projectRoot,\n        docsPath,\n        projectArtifacts,\n        result.evidence,\n        deepAnalysis,\n        assessor\n      );\n      result.assessments.push(assessment);\n    }\n\n    // Calculate scores\n    calculateScores(result);\n\n    logger.info('Compliance check complete', {\n      overallScore: result.overallScore,\n      assessments: result.assessments.length,\n      evidence: result.evidence.length,\n    });\n\n  } catch (error) {\n    result.success = false;\n    result.errors.push(String(error));\n    logger.error(`Compliance check failed: ${String(error)}`);\n  }\n\n  return result;\n}\n\n/**\n * Scan project for artifacts that may indicate compliance\n */\nfunction scanProjectArtifacts(\n  projectRoot: string,\n  docsPath: string,\n  patterns: Record<string, string[]>\n): Map<string, string[]> {\n  const artifacts = new Map<string, string[]>();\n\n  for (const [category, filePatterns] of Object.entries(patterns)) {\n    const found: string[] = [];\n\n    for (const pattern of filePatterns) {\n      // Check in project root\n      const rootPath = join(projectRoot, pattern);\n      if (existsSync(rootPath)) {\n        found.push(rootPath);\n      }\n\n      // Check in docs path\n      const docsFullPath = join(projectRoot, docsPath, pattern);\n      if (existsSync(docsFullPath)) {\n        found.push(docsFullPath);\n      }\n    }\n\n    if (found.length > 0) {\n      artifacts.set(category, found);\n    }\n  }\n\n  return artifacts;\n}\n\n/**\n * Assess a single SOP against project\n */\nasync function assessSOP(\n  sop: SOPDefinition,\n  projectRoot: string,\n  docsPath: string,\n  projectArtifacts: Map<string, string[]>,\n  evidenceList: EvidenceItem[],\n  deepAnalysis: boolean,\n  assessor: string\n): Promise<SOPAssessment> {\n  const requirementsMet: string[] = [];\n  const requirementsGaps: string[] = [];\n  const evidence: Record<string, string> = {};\n\n  // Check each requirement\n  for (const requirement of sop.requirements) {\n    const { met, evidenceFound } = checkRequirement(\n      requirement,\n      projectRoot,\n      docsPath,\n      projectArtifacts,\n      deepAnalysis\n    );\n\n    if (met) {\n      requirementsMet.push(requirement.id);\n      if (evidenceFound) {\n        evidence[requirement.id] = evidenceFound.filePath;\n        evidenceList.push(evidenceFound);\n      }\n    } else {\n      requirementsGaps.push(requirement.id);\n    }\n  }\n\n  // Calculate score\n  const totalRequirements = sop.requirements.length;\n  const mandatoryRequirements = sop.requirements.filter(r => r.mandatory);\n  const mandatoryMet = mandatoryRequirements.filter(r => requirementsMet.includes(r.id));\n\n  let score = 0;\n  if (totalRequirements > 0) {\n    // Weight mandatory requirements more heavily\n    const mandatoryWeight = 0.7;\n    const optionalWeight = 0.3;\n\n    const mandatoryScore = mandatoryRequirements.length > 0\n      ? (mandatoryMet.length / mandatoryRequirements.length) * 100\n      : 100;\n\n    const optionalRequirements = sop.requirements.filter(r => !r.mandatory);\n    const optionalMet = optionalRequirements.filter(r => requirementsMet.includes(r.id));\n    const optionalScore = optionalRequirements.length > 0\n      ? (optionalMet.length / optionalRequirements.length) * 100\n      : 100;\n\n    score = Math.round(mandatoryScore * mandatoryWeight + optionalScore * optionalWeight);\n  }\n\n  // Determine status\n  let status: ComplianceStatus;\n  if (score >= 90) {\n    status = ComplianceStatus.COMPLIANT;\n  } else if (score >= 50) {\n    status = ComplianceStatus.PARTIAL;\n  } else if (score > 0) {\n    status = ComplianceStatus.NON_COMPLIANT;\n  } else {\n    status = ComplianceStatus.PENDING;\n  }\n\n  // Determine IRB status\n  let irbStatus: IRBStatus = IRBStatus.NOT_REQUIRED;\n  if (sop.irbTypicallyRequired) {\n    irbStatus = IRBStatus.PENDING;\n    // Check for IRB approval artifacts\n    const irbArtifacts = projectArtifacts.get('ethics') || [];\n    if (irbArtifacts.length > 0) {\n      irbStatus = IRBStatus.IN_REVIEW;\n    }\n  }\n\n  return {\n    sopId: sop.id,\n    status,\n    score,\n    requirementsMet,\n    requirementsGaps,\n    evidence,\n    irbStatus,\n    assessedAt: new Date(),\n    assessedBy: assessor,\n    notes: `Automated assessment: ${requirementsMet.length}/${totalRequirements} requirements met`,\n  };\n}\n\n/**\n * Check if a specific requirement is met\n */\nfunction checkRequirement(\n  requirement: SOPRequirement,\n  projectRoot: string,\n  docsPath: string,\n  projectArtifacts: Map<string, string[]>,\n  deepAnalysis: boolean\n): { met: boolean; evidenceFound?: EvidenceItem } {\n  // Check for artifacts that match the requirement\n  for (const artifactType of requirement.artifacts || []) {\n    const artifacts = projectArtifacts.get(artifactType);\n    if (artifacts && artifacts.length > 0) {\n      // Found matching artifact\n      const evidenceItem: EvidenceItem = {\n        requirementId: requirement.id,\n        filePath: artifacts[0],\n        type: categorizeArtifact(artifacts[0]),\n        description: `Found ${artifactType} artifact: ${basename(artifacts[0])}`,\n        confidence: 0.8,\n      };\n\n      // Deep analysis: check content for keywords\n      if (deepAnalysis) {\n        const contentMatch = checkContentForRequirement(artifacts[0], requirement);\n        if (contentMatch) {\n          evidenceItem.confidence = 0.95;\n          evidenceItem.excerpt = contentMatch;\n        }\n      }\n\n      return { met: true, evidenceFound: evidenceItem };\n    }\n  }\n\n  // Check based on verification method\n  switch (requirement.verification) {\n    case 'document':\n      return checkDocumentEvidence(requirement, projectRoot, docsPath, projectArtifacts, deepAnalysis);\n    case 'test':\n      return checkTestEvidence(requirement, projectRoot, projectArtifacts);\n    case 'automated':\n      return checkAutomatedEvidence(requirement, projectRoot, projectArtifacts);\n    case 'review':\n    case 'audit':\n      // These require manual verification\n      return { met: false };\n    default:\n      return { met: false };\n  }\n}\n\n/**\n * Check for document-based evidence\n */\nfunction checkDocumentEvidence(\n  requirement: SOPRequirement,\n  projectRoot: string,\n  docsPath: string,\n  projectArtifacts: Map<string, string[]>,\n  deepAnalysis: boolean\n): { met: boolean; evidenceFound?: EvidenceItem } {\n  // Look for documentation files\n  const docPatterns = ['readme', 'requirements', 'architecture', 'api-docs'];\n\n  for (const pattern of docPatterns) {\n    const artifacts = projectArtifacts.get(pattern);\n    if (artifacts && artifacts.length > 0) {\n      for (const artifact of artifacts) {\n        if (deepAnalysis) {\n          const contentMatch = checkContentForRequirement(artifact, requirement);\n          if (contentMatch) {\n            return {\n              met: true,\n              evidenceFound: {\n                requirementId: requirement.id,\n                filePath: artifact,\n                type: 'document',\n                description: `Found documentation evidence in ${basename(artifact)}`,\n                confidence: 0.85,\n                excerpt: contentMatch,\n              },\n            };\n          }\n        }\n      }\n    }\n  }\n\n  return { met: false };\n}\n\n/**\n * Check for test-based evidence\n */\nfunction checkTestEvidence(\n  requirement: SOPRequirement,\n  projectRoot: string,\n  projectArtifacts: Map<string, string[]>\n): { met: boolean; evidenceFound?: EvidenceItem } {\n  const testArtifacts = projectArtifacts.get('testing');\n\n  if (testArtifacts && testArtifacts.length > 0) {\n    return {\n      met: true,\n      evidenceFound: {\n        requirementId: requirement.id,\n        filePath: testArtifacts[0],\n        type: 'test',\n        description: `Test infrastructure found: ${basename(testArtifacts[0])}`,\n        confidence: 0.7,\n      },\n    };\n  }\n\n  return { met: false };\n}\n\n/**\n * Check for automated/CI evidence\n */\nfunction checkAutomatedEvidence(\n  requirement: SOPRequirement,\n  projectRoot: string,\n  projectArtifacts: Map<string, string[]>\n): { met: boolean; evidenceFound?: EvidenceItem } {\n  const ciArtifacts = projectArtifacts.get('ci-cd');\n\n  if (ciArtifacts && ciArtifacts.length > 0) {\n    return {\n      met: true,\n      evidenceFound: {\n        requirementId: requirement.id,\n        filePath: ciArtifacts[0],\n        type: 'config',\n        description: `CI/CD configuration found: ${basename(ciArtifacts[0])}`,\n        confidence: 0.75,\n      },\n    };\n  }\n\n  return { met: false };\n}\n\n/**\n * Check file content for requirement keywords\n */\nfunction checkContentForRequirement(\n  filePath: string,\n  requirement: SOPRequirement\n): string | null {\n  try {\n    const stat = statSync(filePath);\n    if (stat.isDirectory()) return null;\n\n    // Only check text files\n    const ext = extname(filePath).toLowerCase();\n    const textExtensions = ['.md', '.txt', '.ts', '.js', '.json', '.yaml', '.yml', '.html', '.rst'];\n    if (!textExtensions.includes(ext)) return null;\n\n    const content = readFileSync(filePath, 'utf-8');\n    const lowerContent = content.toLowerCase();\n    const lowerDesc = requirement.description.toLowerCase();\n\n    // Check for keywords from requirement description\n    const keywords = lowerDesc.split(/\\s+/).filter(w => w.length > 4);\n    let matchCount = 0;\n    let matchedLine = '';\n\n    for (const keyword of keywords) {\n      if (lowerContent.includes(keyword)) {\n        matchCount++;\n        // Find the line containing this keyword\n        const lines = content.split('\\n');\n        for (const line of lines) {\n          if (line.toLowerCase().includes(keyword) && line.length < 200) {\n            matchedLine = line.trim();\n            break;\n          }\n        }\n      }\n    }\n\n    // If at least 30% of keywords match, consider it evidence\n    if (matchCount >= keywords.length * 0.3 && matchedLine) {\n      return matchedLine;\n    }\n\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Categorize an artifact by its type\n */\nfunction categorizeArtifact(filePath: string): 'document' | 'code' | 'test' | 'config' | 'artifact' {\n  const ext = extname(filePath).toLowerCase();\n  const name = basename(filePath).toLowerCase();\n\n  if (['.md', '.txt', '.rst', '.html'].includes(ext)) {\n    return 'document';\n  }\n  if (['.ts', '.js', '.py', '.java', '.go', '.rs'].includes(ext)) {\n    if (name.includes('test') || name.includes('spec')) {\n      return 'test';\n    }\n    return 'code';\n  }\n  if (['.json', '.yaml', '.yml', '.toml', '.ini'].includes(ext)) {\n    return 'config';\n  }\n  return 'artifact';\n}\n\n/**\n * Calculate overall scores from assessments\n */\nfunction calculateScores(result: ComplianceCheckResult): void {\n  if (result.assessments.length === 0) {\n    result.overallScore = 0;\n    return;\n  }\n\n  // Calculate category scores\n  const categoryTotals: Record<SOPCategory, { sum: number; count: number }> = {\n    [SOPCategory.PROGRAM_MANAGEMENT]: { sum: 0, count: 0 },\n    [SOPCategory.OPERATIONS]: { sum: 0, count: 0 },\n    [SOPCategory.DEVELOPMENT]: { sum: 0, count: 0 },\n    [SOPCategory.GOVERNANCE]: { sum: 0, count: 0 },\n    [SOPCategory.QUALITY]: { sum: 0, count: 0 },\n  };\n\n  for (const assessment of result.assessments) {\n    const sop = getSOPById(assessment.sopId);\n    if (sop) {\n      categoryTotals[sop.category].sum += assessment.score;\n      categoryTotals[sop.category].count += 1;\n    }\n  }\n\n  // Calculate category averages\n  for (const category of Object.values(SOPCategory)) {\n    const totals = categoryTotals[category];\n    result.categoryScores[category] = totals.count > 0\n      ? Math.round(totals.sum / totals.count)\n      : 0;\n  }\n\n  // Calculate overall score (weighted by priority)\n  let weightedSum = 0;\n  let totalWeight = 0;\n\n  for (const assessment of result.assessments) {\n    const sop = getSOPById(assessment.sopId);\n    if (sop) {\n      const weight = getPriorityWeight(sop.priority);\n      weightedSum += assessment.score * weight;\n      totalWeight += weight;\n    }\n  }\n\n  result.overallScore = totalWeight > 0\n    ? Math.round(weightedSum / totalWeight)\n    : 0;\n}\n\n/**\n * Get weight for priority level\n */\nfunction getPriorityWeight(priority: SOPPriority): number {\n  switch (priority) {\n    case SOPPriority.CRITICAL:\n      return 4;\n    case SOPPriority.HIGH:\n      return 3;\n    case SOPPriority.MEDIUM:\n      return 2;\n    case SOPPriority.LOW:\n      return 1;\n    default:\n      return 1;\n  }\n}\n\n/**\n * Quick check for a specific SOP\n */\nexport async function checkSOPCompliance(\n  sopId: string,\n  projectRoot: string,\n  docsPath: string = 'docs'\n): Promise<SOPAssessment | null> {\n  const result = await checkCompliance({\n    projectRoot,\n    docsPath,\n    sopIds: [sopId],\n  });\n\n  return result.assessments[0] || null;\n}\n\n/**\n * Check if project meets minimum compliance threshold\n */\nexport async function meetsMinimumCompliance(\n  projectRoot: string,\n  threshold: number = 50,\n  categories?: SOPCategory[]\n): Promise<{ meets: boolean; score: number; gaps: string[] }> {\n  const result = await checkCompliance({\n    projectRoot,\n    categories,\n  });\n\n  const gaps = result.assessments\n    .filter(a => a.score < threshold)\n    .map(a => a.sopId);\n\n  return {\n    meets: result.overallScore >= threshold,\n    score: result.overallScore,\n    gaps,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/sops/gap-analyzer.d.ts

@@ -0,0 +1,124 @@
+/**
+ * SOP Gap Analyzer
+ *
+ * Analyzes compliance gaps and generates remediation recommendations.
+ *
+ * @module sops/gap-analyzer
+ */
+import { ComplianceGap, SOPPriority, SOPCategory } from './types.js';
+import { ComplianceCheckResult } from './compliance-checker.js';
+/**
+ * Gap analysis options
+ */
+export interface GapAnalysisOptions {
+    /** Minimum score threshold to consider compliant */
+    complianceThreshold?: number;
+    /** Include SOPs with partial compliance */
+    includePartial?: boolean;
+    /** Filter by priority */
+    minPriority?: SOPPriority;
+    /** Filter by category */
+    categories?: SOPCategory[];
+    /** Generate remediation plans */
+    generateRemediation?: boolean;
+}
+/**
+ * Gap analysis result
+ */
+export interface GapAnalysisResult {
+    /** All identified gaps */
+    gaps: ComplianceGap[];
+    /** Gaps grouped by priority */
+    byPriority: Record<SOPPriority, ComplianceGap[]>;
+    /** Gaps grouped by category */
+    byCategory: Record<SOPCategory, ComplianceGap[]>;
+    /** Total gap count */
+    totalGaps: number;
+    /** Critical gaps that need immediate attention */
+    criticalGaps: ComplianceGap[];
+    /** Summary statistics */
+    summary: GapSummary;
+    /** Remediation roadmap */
+    roadmap?: RemediationRoadmap;
+}
+/**
+ * Gap summary statistics
+ */
+export interface GapSummary {
+    /** Total requirements checked */
+    totalRequirements: number;
+    /** Requirements met */
+    requirementsMet: number;
+    /** Requirements with gaps */
+    requirementsGaps: number;
+    /** Compliance percentage */
+    compliancePercentage: number;
+    /** Effort estimate (total) */
+    totalEffort: {
+        low: number;
+        medium: number;
+        high: number;
+    };
+    /** Estimated remediation complexity */
+    overallComplexity: 'low' | 'medium' | 'high';
+}
+/**
+ * Remediation roadmap
+ */
+export interface RemediationRoadmap {
+    /** Phases of remediation */
+    phases: RemediationPhase[];
+    /** Quick wins (low effort, high impact) */
+    quickWins: ComplianceGap[];
+    /** Dependencies between gaps */
+    dependencies: GapDependency[];
+}
+/**
+ * Remediation phase
+ */
+export interface RemediationPhase {
+    /** Phase number */
+    phase: number;
+    /** Phase name */
+    name: string;
+    /** Gaps to address in this phase */
+    gaps: ComplianceGap[];
+    /** Focus area */
+    focus: string;
+    /** Expected effort */
+    effort: 'low' | 'medium' | 'high';
+}
+/**
+ * Gap dependency
+ */
+export interface GapDependency {
+    /** Gap that depends on another */
+    gapId: string;
+    /** Gap that must be addressed first */
+    dependsOn: string;
+    /** Reason for dependency */
+    reason: string;
+}
+/**
+ * Analyze compliance gaps from check results
+ */
+export declare function analyzeGaps(checkResult: ComplianceCheckResult, options?: GapAnalysisOptions): GapAnalysisResult;
+/**
+ * Get gaps for a specific SOP
+ */
+export declare function getGapsForSOP(analysisResult: GapAnalysisResult, sopId: string): ComplianceGap[];
+/**
+ * Get high-impact quick wins
+ */
+export declare function getQuickWins(analysisResult: GapAnalysisResult): ComplianceGap[];
+/**
+ * Calculate remediation progress
+ */
+export declare function calculateProgress(gaps: ComplianceGap[]): {
+    total: number;
+    resolved: number;
+    inProgress: number;
+    open: number;
+    percentage: number;
+};
+//# sourceMappingURL=gap-analyzer.d.ts.map