@schemashift/core 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -297,6 +297,12 @@ declare class MigrationAuditLog {
      * Clear the audit log.
      */
     clear(): void;
+    /**
+     * Export a compliance report in SOC2 or HIPAA format.
+     */
+    exportComplianceReport(format: 'soc2' | 'hipaa'): string;
+    private generateSoc2Report;
+    private generateHipaaReport;
     private collectMetadata;
     private write;
     private hashContent;
@@ -457,8 +463,13 @@ interface ComplexityEstimate {
     warnings: ComplexityWarning[];
     riskAreas: string[];
 }
+interface DurationEstimate {
+    label: string;
+    rangeMinutes: [number, number];
+}
 declare class ComplexityEstimator {
     estimate(files: SourceFile[]): ComplexityEstimate;
+    estimateDuration(estimate: ComplexityEstimate): DurationEstimate;
     private calculateEffort;
 }
 
@@ -937,6 +948,11 @@ declare class IncrementalTracker {
         total: number;
         percent: number;
     } | null;
+    /**
+     * Get a canary batch — a percentage of remaining files, sorted simplest first.
+     * Used for phased rollouts where you migrate a small batch, verify, then continue.
+     */
+    getCanaryBatch(percent: number, fileSizes?: Map<string, number>): string[];
     clear(): void;
     private saveState;
 }
@@ -1012,11 +1028,13 @@ interface NotificationResult {
     statusCode?: number;
     error?: string;
 }
+type WebhookType = 'generic' | 'slack' | 'teams';
 interface WebhookConfig {
     url: string;
     events?: MigrationEventType[];
     headers?: Record<string, string>;
     secret?: string;
+    type?: WebhookType;
 }
 /**
  * Send migration event notifications via webhooks.
@@ -1032,6 +1050,16 @@ declare class WebhookNotifier {
      * Send an event to all matching webhooks.
      */
     send(event: MigrationEvent): Promise<NotificationResult[]>;
+    /**
+     * Format event as Slack Block Kit message.
+     */
+    formatSlackPayload(event: MigrationEvent): Record<string, unknown>;
+    /**
+     * Format event as Microsoft Teams Adaptive Card.
+     */
+    formatTeamsPayload(event: MigrationEvent): Record<string, unknown>;
+    private getEventEmoji;
+    private getEventTitle;
     /**
      * Send event to a single webhook endpoint.
      */
@@ -1124,6 +1152,56 @@ declare class PluginLoader {
     private validatePlugin;
 }
 
+interface VerificationSample {
+    name: string;
+    input: unknown;
+    expectedValid: boolean;
+}
+interface SchemaVerificationResult {
+    schemaName: string;
+    filePath: string;
+    totalSamples: number;
+    matchingSamples: number;
+    mismatches: VerificationMismatch[];
+    parityScore: number;
+}
+interface VerificationMismatch {
+    sampleName: string;
+    input: unknown;
+    sourceResult: {
+        valid: boolean;
+        error?: string;
+    };
+    targetResult: {
+        valid: boolean;
+        error?: string;
+    };
+}
+interface VerificationReport {
+    from: string;
+    to: string;
+    totalSchemas: number;
+    results: SchemaVerificationResult[];
+    overallParityScore: number;
+    timestamp: string;
+}
+/**
+ * Extracts schema definition names from source file text.
+ */
+declare function extractSchemaNames(sourceText: string): string[];
+/**
+ * Generates test samples based on detected schema patterns.
+ */
+declare function generateSamples(sourceText: string, schemaName: string, maxSamples: number): VerificationSample[];
+/**
+ * Creates a verification report comparing source and target schemas.
+ */
+declare function createVerificationReport(from: string, to: string, results: SchemaVerificationResult[]): VerificationReport;
+/**
+ * Format verification report for terminal output.
+ */
+declare function formatVerificationReport(report: VerificationReport): string;
+
 interface StandardSchemaInfo {
     detected: boolean;
     compatibleLibraries: Array<{
@@ -1228,4 +1306,4 @@ declare class TypeDedupDetector {
     private namesRelated;
 }
 
-export { type AnalysisResult, type ApprovalDecision, ApprovalManager, type ApprovalStatus, type ApprovalSummary, type AuditEntry, type AuditEntryMetadata, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CrossFieldPattern, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, DriftDetector, type DriftModification, type DriftResult, type DuplicateTypeCandidate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FixResult, type FixSummary, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GOVERNANCE_TEMPLATES, GovernanceEngine, GovernanceFixer, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceTemplate, type GovernanceViolation, type GraphExportOptions, GraphExporter, type GraphNode, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationEvent, type MigrationEventType, type MigrationReadiness, type MigrationRequest, type MigrationTemplate, type MigrationTemplateStep, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type NotificationResult, type PackageChange, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaFileSnapshot, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type SchemaSnapshot, StandardSchemaAdvisor, type StandardSchemaAdvisory, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VersionIssue, type WarningSuppressionRule, type WebhookConfig, WebhookNotifier, type WorkspaceManager, buildCallChain, computeParallelBatches, conditionalValidation, dependentFields, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, getAllMigrationTemplates, getGovernanceTemplate, getGovernanceTemplateNames, getGovernanceTemplatesByCategory, getMigrationTemplate, getMigrationTemplateNames, getMigrationTemplatesByCategory, isInsideComment, isInsideStringLiteral, loadConfig, mutuallyExclusive, parseCallChain, requireIf, requireOneOf, shouldSuppressWarning, startsWithBase, suggestCrossFieldPattern, transformMethodChain, validateConfig, validateMigrationTemplate };
+export { type AnalysisResult, type ApprovalDecision, ApprovalManager, type ApprovalStatus, type ApprovalSummary, type AuditEntry, type AuditEntryMetadata, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CrossFieldPattern, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, DriftDetector, type DriftModification, type DriftResult, type DuplicateTypeCandidate, type DurationEstimate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FixResult, type FixSummary, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GOVERNANCE_TEMPLATES, GovernanceEngine, GovernanceFixer, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceTemplate, type GovernanceViolation, type GraphExportOptions, GraphExporter, type GraphNode, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationEvent, type MigrationEventType, type MigrationReadiness, type MigrationRequest, type MigrationTemplate, type MigrationTemplateStep, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type NotificationResult, type PackageChange, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaFileSnapshot, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type SchemaSnapshot, type SchemaVerificationResult, StandardSchemaAdvisor, type StandardSchemaAdvisory, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VerificationMismatch, type VerificationReport, type VerificationSample, type VersionIssue, type WarningSuppressionRule, type WebhookConfig, WebhookNotifier, type WebhookType, type WorkspaceManager, buildCallChain, computeParallelBatches, conditionalValidation, createVerificationReport, dependentFields, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, extractSchemaNames, formatVerificationReport, generateSamples, getAllMigrationTemplates, getGovernanceTemplate, getGovernanceTemplateNames, getGovernanceTemplatesByCategory, getMigrationTemplate, getMigrationTemplateNames, getMigrationTemplatesByCategory, isInsideComment, isInsideStringLiteral, loadConfig, mutuallyExclusive, parseCallChain, requireIf, requireOneOf, shouldSuppressWarning, startsWithBase, suggestCrossFieldPattern, transformMethodChain, validateConfig, validateMigrationTemplate };

package/dist/index.d.ts

@@ -297,6 +297,12 @@ declare class MigrationAuditLog {
      * Clear the audit log.
      */
     clear(): void;
+    /**
+     * Export a compliance report in SOC2 or HIPAA format.
+     */
+    exportComplianceReport(format: 'soc2' | 'hipaa'): string;
+    private generateSoc2Report;
+    private generateHipaaReport;
     private collectMetadata;
     private write;
     private hashContent;
@@ -457,8 +463,13 @@ interface ComplexityEstimate {
     warnings: ComplexityWarning[];
     riskAreas: string[];
 }
+interface DurationEstimate {
+    label: string;
+    rangeMinutes: [number, number];
+}
 declare class ComplexityEstimator {
     estimate(files: SourceFile[]): ComplexityEstimate;
+    estimateDuration(estimate: ComplexityEstimate): DurationEstimate;
     private calculateEffort;
 }
 
@@ -937,6 +948,11 @@ declare class IncrementalTracker {
         total: number;
         percent: number;
     } | null;
+    /**
+     * Get a canary batch — a percentage of remaining files, sorted simplest first.
+     * Used for phased rollouts where you migrate a small batch, verify, then continue.
+     */
+    getCanaryBatch(percent: number, fileSizes?: Map<string, number>): string[];
     clear(): void;
     private saveState;
 }
@@ -1012,11 +1028,13 @@ interface NotificationResult {
     statusCode?: number;
     error?: string;
 }
+type WebhookType = 'generic' | 'slack' | 'teams';
 interface WebhookConfig {
     url: string;
     events?: MigrationEventType[];
     headers?: Record<string, string>;
     secret?: string;
+    type?: WebhookType;
 }
 /**
  * Send migration event notifications via webhooks.
@@ -1032,6 +1050,16 @@ declare class WebhookNotifier {
      * Send an event to all matching webhooks.
      */
     send(event: MigrationEvent): Promise<NotificationResult[]>;
+    /**
+     * Format event as Slack Block Kit message.
+     */
+    formatSlackPayload(event: MigrationEvent): Record<string, unknown>;
+    /**
+     * Format event as Microsoft Teams Adaptive Card.
+     */
+    formatTeamsPayload(event: MigrationEvent): Record<string, unknown>;
+    private getEventEmoji;
+    private getEventTitle;
     /**
      * Send event to a single webhook endpoint.
      */
@@ -1124,6 +1152,56 @@ declare class PluginLoader {
     private validatePlugin;
 }
 
+interface VerificationSample {
+    name: string;
+    input: unknown;
+    expectedValid: boolean;
+}
+interface SchemaVerificationResult {
+    schemaName: string;
+    filePath: string;
+    totalSamples: number;
+    matchingSamples: number;
+    mismatches: VerificationMismatch[];
+    parityScore: number;
+}
+interface VerificationMismatch {
+    sampleName: string;
+    input: unknown;
+    sourceResult: {
+        valid: boolean;
+        error?: string;
+    };
+    targetResult: {
+        valid: boolean;
+        error?: string;
+    };
+}
+interface VerificationReport {
+    from: string;
+    to: string;
+    totalSchemas: number;
+    results: SchemaVerificationResult[];
+    overallParityScore: number;
+    timestamp: string;
+}
+/**
+ * Extracts schema definition names from source file text.
+ */
+declare function extractSchemaNames(sourceText: string): string[];
+/**
+ * Generates test samples based on detected schema patterns.
+ */
+declare function generateSamples(sourceText: string, schemaName: string, maxSamples: number): VerificationSample[];
+/**
+ * Creates a verification report comparing source and target schemas.
+ */
+declare function createVerificationReport(from: string, to: string, results: SchemaVerificationResult[]): VerificationReport;
+/**
+ * Format verification report for terminal output.
+ */
+declare function formatVerificationReport(report: VerificationReport): string;
+
 interface StandardSchemaInfo {
     detected: boolean;
     compatibleLibraries: Array<{
@@ -1228,4 +1306,4 @@ declare class TypeDedupDetector {
     private namesRelated;
 }
 
-export { type AnalysisResult, type ApprovalDecision, ApprovalManager, type ApprovalStatus, type ApprovalSummary, type AuditEntry, type AuditEntryMetadata, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CrossFieldPattern, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, DriftDetector, type DriftModification, type DriftResult, type DuplicateTypeCandidate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FixResult, type FixSummary, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GOVERNANCE_TEMPLATES, GovernanceEngine, GovernanceFixer, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceTemplate, type GovernanceViolation, type GraphExportOptions, GraphExporter, type GraphNode, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationEvent, type MigrationEventType, type MigrationReadiness, type MigrationRequest, type MigrationTemplate, type MigrationTemplateStep, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type NotificationResult, type PackageChange, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaFileSnapshot, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type SchemaSnapshot, StandardSchemaAdvisor, type StandardSchemaAdvisory, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VersionIssue, type WarningSuppressionRule, type WebhookConfig, WebhookNotifier, type WorkspaceManager, buildCallChain, computeParallelBatches, conditionalValidation, dependentFields, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, getAllMigrationTemplates, getGovernanceTemplate, getGovernanceTemplateNames, getGovernanceTemplatesByCategory, getMigrationTemplate, getMigrationTemplateNames, getMigrationTemplatesByCategory, isInsideComment, isInsideStringLiteral, loadConfig, mutuallyExclusive, parseCallChain, requireIf, requireOneOf, shouldSuppressWarning, startsWithBase, suggestCrossFieldPattern, transformMethodChain, validateConfig, validateMigrationTemplate };
+export { type AnalysisResult, type ApprovalDecision, ApprovalManager, type ApprovalStatus, type ApprovalSummary, type AuditEntry, type AuditEntryMetadata, type AuditLog, type BehavioralAnalysisResult, type BehavioralCategory, type BehavioralWarning, BehavioralWarningAnalyzer, BundleEstimator, type BundleSizeEstimate, type CallChainInfo, type ChainResult, type ChainStep, type ChainStepResult, type ChainValidation, CompatibilityAnalyzer, type CompatibilityResult, type ComplexityEstimate, ComplexityEstimator, type ComplexityWarning, type CrossFieldPattern, type CustomRule, type DependencyGraphResult, type DetailedAnalysisResult, DetailedAnalyzer, DriftDetector, type DriftModification, type DriftResult, type DuplicateTypeCandidate, type DurationEstimate, EcosystemAnalyzer, type EcosystemIssue, type EcosystemReport, type EffortLevel, type FileComplexity, type FixResult, type FixSummary, type FormLibraryDetection, FormResolverMigrator, type FormResolverResult, GOVERNANCE_TEMPLATES, GovernanceEngine, GovernanceFixer, type GovernanceResult, type GovernanceRuleConfig, type GovernanceRuleFunction, type GovernanceTemplate, type GovernanceViolation, type GraphExportOptions, GraphExporter, type GraphNode, type IncrementalState, IncrementalTracker, type LibraryBundleInfo, type LibraryVersionInfo, type MethodCallInfo, MigrationAuditLog, MigrationChain, type MigrationEvent, type MigrationEventType, type MigrationReadiness, type MigrationRequest, type MigrationTemplate, type MigrationTemplateStep, type MonorepoInfo, type MonorepoPackage, MonorepoResolver, type NotificationResult, type PackageChange, type PackageUpdatePlan, PackageUpdater, type ParallelBatch, type PerformanceAnalysisResult, PerformanceAnalyzer, type PerformanceCategory, type PerformanceWarning, type PluginLoadResult, PluginLoader, type ScaffoldedTest, SchemaAnalyzer, type SchemaComplexity, SchemaDependencyResolver, type SchemaFileSnapshot, type SchemaInfo, type SchemaLibrary, type SchemaShiftConfig, type SchemaShiftPlugin, type SchemaSnapshot, type SchemaVerificationResult, StandardSchemaAdvisor, type StandardSchemaAdvisory, type StandardSchemaInfo, type TestScaffoldResult, TestScaffolder, TransformEngine, type TransformError, type TransformHandler, type TransformOptions, type TransformResult, TypeDedupDetector, type TypeDedupResult, type VerificationMismatch, type VerificationReport, type VerificationSample, type VersionIssue, type WarningSuppressionRule, type WebhookConfig, WebhookNotifier, type WebhookType, type WorkspaceManager, buildCallChain, computeParallelBatches, conditionalValidation, createVerificationReport, dependentFields, detectFormLibraries, detectSchemaLibrary, detectStandardSchema, extractSchemaNames, formatVerificationReport, generateSamples, getAllMigrationTemplates, getGovernanceTemplate, getGovernanceTemplateNames, getGovernanceTemplatesByCategory, getMigrationTemplate, getMigrationTemplateNames, getMigrationTemplatesByCategory, isInsideComment, isInsideStringLiteral, loadConfig, mutuallyExclusive, parseCallChain, requireIf, requireOneOf, shouldSuppressWarning, startsWithBase, suggestCrossFieldPattern, transformMethodChain, validateConfig, validateMigrationTemplate };