@anhcodo13/lattice 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,8 +1,41 @@
+interface BoundaryPolicy {
+    id: string;
+    description: string;
+    from: string[];
+    allow?: string[];
+    disallow?: string[];
+    severity: "info" | "warning" | "error";
+    recommendation?: string;
+}
+interface AnalysisConfig {
+    weights: Record<"architecture" | "imports" | "components" | "complexity", number>;
+    thresholds: {
+        maxFanIn: number;
+        maxFanOut: number;
+        maxChainDepth: number;
+        maxComponentLines: number;
+        maxJsxDepth: number;
+        maxComplexity: number;
+    };
+    policies: BoundaryPolicy[];
+    aliases: Record<string, string>;
+}
+
 type ProfileName = "next" | "vite-react" | "react";
+
+interface AssessmentPolicy {
+    architecture: {
+        minimumScore: number;
+        maximumErrors: number;
+        blockedRuleIds: string[];
+        analysis: AnalysisConfig;
+    };
+}
 interface VersionPolicy {
-    schemaVersion: 1;
+    schemaVersion: 2;
     policyVersion: string;
     profiles: Record<string, Record<string, string>>;
+    assessment?: AssessmentPolicy;
     source: string;
     sha256: string;
 }
@@ -11,6 +44,7 @@ interface GovernanceFinding {
     packageName: string;
     expected: string;
     declared?: string;
+    lockfileSpecifier?: string;
     locked?: string;
     reason: string;
 }
@@ -31,4 +65,87 @@ declare function loadPolicy(source: string): Promise<VersionPolicy>;
 
 declare function checkGovernance(options: CheckOptions): Promise<GovernanceResult>;
 
-export { type CheckOptions, type GovernanceFinding, type GovernanceResult, type ProfileName, type VersionPolicy, checkGovernance, loadPolicy };
+interface Finding {
+    ruleId: string;
+    category: "architecture" | "imports" | "components" | "complexity" | "routes";
+    severity: "info" | "warning" | "error";
+    file: string;
+    line: number;
+    evidence: string;
+    recommendation: string;
+}
+
+interface ScoreBreakdown {
+    score: number;
+    grade: string;
+    weightedDeduction: number;
+    maintenanceAdjustment: number;
+    criticalAdjustment: number;
+    categories: Array<{
+        id: string;
+        weight: number;
+        score: number;
+        deduction: number;
+        findingCount: number;
+    }>;
+}
+
+type Status = "pass" | "fail" | "incomplete";
+interface Domain {
+    status: Status;
+    issues: string[];
+}
+interface AssessmentReport {
+    schema: "urn:nklattice:governance-assessment:1";
+    generatedAt: string;
+    status: Status;
+    policy: {
+        version: string;
+        source: string;
+        sha256: string;
+    };
+    inventory: {
+        source: string;
+        sha256?: string;
+        expectedApps: number;
+        discoveredApps: number;
+    };
+    scope: {
+        domains: string[];
+        notEvaluated: string[];
+    };
+    issues: string[];
+    apps: Array<{
+        path: string;
+        profile: string;
+        status: Status;
+        domains: {
+            inventory: Domain;
+            dependencies: Domain & {
+                findings: GovernanceFinding[];
+            };
+            architecture: Domain & {
+                filesScanned: number;
+                localEdges: number;
+                score?: number;
+                grade?: string;
+                scoreBreakdown?: ScoreBreakdown;
+                errors: number;
+                findings: Finding[];
+                diagnostics: string[];
+            };
+        };
+    }>;
+}
+interface AssessOptions {
+    scanRoot: string;
+    workspaceRoot?: string;
+    inventory?: string;
+    expectedApps?: number;
+    outputDirectory?: string;
+    policy: VersionPolicy;
+}
+declare function renderAssessmentHtml(report: AssessmentReport): string;
+declare function assessGovernance(options: AssessOptions): Promise<AssessmentReport>;
+
+export { type AssessOptions, type AssessmentReport, type CheckOptions, type GovernanceFinding, type GovernanceResult, type ProfileName, type VersionPolicy, assessGovernance, checkGovernance, loadPolicy, renderAssessmentHtml };