@gulu9527/code-trust 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 type Severity = 'high' | 'medium' | 'low' | 'info';
 type RuleCategory = 'security' | 'logic' | 'structure' | 'style' | 'coverage';
 type TrustGrade = 'HIGH_TRUST' | 'REVIEW' | 'LOW_TRUST' | 'UNTRUSTED';
+type ScanMode = 'staged' | 'diff' | 'files' | 'changed';
+type ScanErrorType = 'rule-failure' | 'deleted-file' | 'unreadable-file' | 'missing-file-content' | 'unsupported-file-type';
 interface Issue {
     ruleId: string;
     severity: Severity;
@@ -12,20 +14,54 @@ interface Issue {
     suggestion?: string;
     codeSnippet?: string;
 }
+interface ReportIssue extends Issue {
+    fingerprint: string;
+    fingerprintVersion: string;
+}
 interface DimensionScore {
     score: number;
+    issues: ReportIssue[];
+}
+interface RuleFailure {
+    ruleId: string;
+    file: string;
+    message: string;
+}
+interface RuleRunResult {
     issues: Issue[];
+    rulesExecuted: number;
+    rulesFailed: number;
+    ruleFailures: RuleFailure[];
+}
+interface ScanError {
+    type: ScanErrorType;
+    message: string;
+    file?: string;
+    ruleId?: string;
+}
+interface ToolHealth {
+    rulesExecuted: number;
+    rulesFailed: number;
+    filesConsidered: number;
+    filesScanned: number;
+    filesExcluded: number;
+    filesSkipped: number;
+    scanErrors: ScanError[];
+    ruleFailures: RuleFailure[];
 }
 interface TrustReport {
+    schemaVersion: string;
     version: string;
     timestamp: string;
     commit?: string;
+    scanMode: ScanMode;
     overall: {
         score: number;
         grade: TrustGrade;
         filesScanned: number;
         issuesFound: number;
     };
+    toolHealth: ToolHealth;
     dimensions: {
         security: DimensionScore;
         logic: DimensionScore;
@@ -33,7 +69,7 @@ interface TrustReport {
         style: DimensionScore;
         coverage: DimensionScore;
     };
-    issues: Issue[];
+    issues: ReportIssue[];
 }
 interface DiffFile {
     filePath: string;
@@ -97,14 +133,27 @@ declare class ScanEngine {
     private ruleEngine;
     constructor(config: CodeTrustConfig, workDir?: string);
     scan(options: ScanOptions): Promise<TrustReport>;
+    private scanFile;
+    private getScanCandidates;
+    private getScanMode;
     private getDiffFiles;
+    private shouldIncludeFile;
+    private matchesPattern;
     private isTsJsFile;
+    private attachFingerprints;
+    private normalizeRelativePath;
     private groupByDimension;
 }
 
 declare function loadConfig(searchFrom?: string): Promise<CodeTrustConfig>;
 declare function generateDefaultConfig(): string;
 
+interface Fix {
+    /** Byte range in the original file content [startOffset, endOffset) */
+    range: [number, number];
+    /** Replacement text (empty string = delete) */
+    text: string;
+}
 interface Rule {
     id: string;
     category: RuleCategory;
@@ -112,6 +161,10 @@ interface Rule {
     title: string;
     description: string;
     check: (context: RuleContext) => Issue[];
+    /** Whether this rule supports auto-fix */
+    fixable?: boolean;
+    /** Generate a fix for a given issue. Returns null if unfixable. */
+    fix?: (context: RuleContext, issue: Issue) => Fix | null;
 }
 interface RuleContext {
     filePath: string;
@@ -127,6 +180,7 @@ declare class RuleEngine {
     private rules;
     constructor(config: CodeTrustConfig);
     run(context: RuleContext): Issue[];
+    runWithDiagnostics(context: RuleContext): RuleRunResult;
     getRules(): Rule[];
     listRules(): Array<{
         id: string;
@@ -150,7 +204,7 @@ declare class DiffParser {
     private parseHunks;
 }
 
-declare function calculateDimensionScore(issues: Issue[]): DimensionScore;
+declare function calculateDimensionScore(issues: ReportIssue[]): DimensionScore;
 declare function calculateOverallScore(dimensions: Record<RuleCategory, DimensionScore>, weights: DimensionWeights): number;
 declare function getGrade(score: number): TrustGrade;
 declare function getGradeEmoji(grade: TrustGrade): string;