@gulu9527/code-trust 0.2.1 → 0.3.1

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,75 @@ interface Issue {
     suggestion?: string;
     codeSnippet?: string;
 }
+type IssueLifecycleStatus = 'new' | 'existing';
+interface ReportIssue extends Issue {
+    fingerprint: string;
+    fingerprintVersion: string;
+    lifecycle?: IssueLifecycleStatus;
+}
+interface FixedIssue {
+    ruleId: string;
+    severity: Severity;
+    category: RuleCategory;
+    file: string;
+    startLine: number;
+    endLine: number;
+    message: string;
+    fingerprint: string;
+    fingerprintVersion?: string;
+}
+interface LifecycleSummary {
+    newIssues: number;
+    existingIssues: number;
+    fixedIssues: number;
+    baselineUsed: boolean;
+    baselineCommit?: string;
+    baselineTimestamp?: 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 +90,9 @@ interface TrustReport {
         style: DimensionScore;
         coverage: DimensionScore;
     };
-    issues: Issue[];
+    issues: ReportIssue[];
+    lifecycle?: LifecycleSummary;
+    fixedIssues?: FixedIssue[];
 }
 interface DiffFile {
     filePath: string;
@@ -55,6 +114,7 @@ interface ScanOptions {
     diff?: string;
     files?: string[];
     minScore?: number;
+    baseline?: string;
     format?: 'terminal' | 'json' | 'html';
 }
 
@@ -97,8 +157,29 @@ declare class ScanEngine {
     private ruleEngine;
     constructor(config: CodeTrustConfig, workDir?: string);
     scan(options: ScanOptions): Promise<TrustReport>;
+    private scanFile;
+    private createSkippedResult;
+    private createErrorResult;
+    private readFileContent;
+    private extractAddedLines;
+    private runStructureAnalysis;
+    private getScanCandidates;
+    private getScanMode;
     private getDiffFiles;
+    private shouldIncludeFile;
+    private matchesPattern;
     private isTsJsFile;
+    private attachFingerprints;
+    private normalizeRelativePath;
+    private loadBaseline;
+    private parseBaselineIssues;
+    private parseBaselineIssue;
+    private isValidBaselineIssue;
+    private attachLifecycle;
+    private getFixedIssues;
+    private buildLifecycleSummary;
+    private isSeverity;
+    private isRuleCategory;
     private groupByDimension;
 }
 
@@ -137,6 +218,7 @@ declare class RuleEngine {
     private rules;
     constructor(config: CodeTrustConfig);
     run(context: RuleContext): Issue[];
+    runWithDiagnostics(context: RuleContext): RuleRunResult;
     getRules(): Rule[];
     listRules(): Array<{
         id: string;
@@ -152,6 +234,11 @@ declare class DiffParser {
     getStagedFiles(): Promise<DiffFile[]>;
     getDiffFromRef(ref: string): Promise<DiffFile[]>;
     getChangedFiles(): Promise<DiffFile[]>;
+    /**
+     * Merge two sets of diff files, deduplicating by file path.
+     * When a file appears in both, merge their hunks and combine stats.
+     */
+    private mergeDiffFiles;
     getLastCommitDiff(): Promise<DiffFile[]>;
     getCurrentCommitHash(): Promise<string | undefined>;
     getFileContent(filePath: string): Promise<string | undefined>;
@@ -160,7 +247,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;