@gitwand/core 1.6.0

package/dist/types.d.ts

@@ -0,0 +1,256 @@
+/**
+ * GitWand Core Types
+ *
+ * Représente les structures de données pour l'analyse
+ * et la résolution automatique de conflits Git.
+ */
+/** Les trois versions d'un fichier en conflit */
+export interface MergeInput {
+    /** Contenu de la version ancêtre commune (base) */
+    base: string;
+    /** Contenu de la branche courante (ours / current) */
+    ours: string;
+    /** Contenu de la branche entrante (theirs / incoming) */
+    theirs: string;
+    /** Chemin du fichier (pour le reporting) */
+    filePath: string;
+}
+/** Classification du type de conflit */
+export type ConflictType = "one_side_change" | "same_change" | "non_overlapping" | "whitespace_only" | "delete_no_change" | "generated_file" | "value_only_change" | "reorder_only" | "insertion_at_boundary" | "complex";
+/** Niveau de confiance discret (label seuil, utilisé dans les options) */
+export type Confidence = "certain" | "high" | "medium" | "low";
+/**
+ * Score de confiance composite pour la résolution automatique.
+ *
+ * Dimensions du score :
+ * - `typeClassification` : certitude du type détecté (0–100)
+ * - `dataRisk`           : risque de perte de données si résolution auto (0–100, 0 = sûr)
+ * - `scopeImpact`        : impact de la taille du changement (0–100, 0 = petit)
+ * - `fileFrequency`      : v1.4 — pénalité si le fichier a déjà des hunks complexes (0–100)
+ * - `baseAvailability`   : v1.4 — bonus si la base diff3/zdiff3 est disponible (0 ou 100)
+ *
+ * Formule v1.4 :
+ *   `score = typeClassification
+ *           − dataRisk        × 0.40
+ *           − scopeImpact     × 0.15
+ *           − fileFrequency   × 0.10
+ *           + baseAvailability × 0.05`
+ *
+ * Label dérivé :
+ * - score ≥ 92 → `"certain"`
+ * - score ≥ 68 → `"high"`
+ * - score ≥ 44 → `"medium"`
+ * - score <  44 → `"low"`
+ */
+export interface ConfidenceScore {
+    /** Score global normalisé 0–100 */
+    score: number;
+    /** Label seuil backward-compatible, dérivé du score */
+    label: Confidence;
+    /** Dimensions explicatives du score */
+    dimensions: {
+        /** Certitude de la classification du type de conflit (0–100) */
+        typeClassification: number;
+        /** Risque de corruption/perte de données (0–100, 0 = sans risque) */
+        dataRisk: number;
+        /** Impact de la taille du changement (0–100, 0 = petit) */
+        scopeImpact: number;
+        /**
+         * v1.4 — Pénalité "zone chaude" : nombre de hunks complexes déjà vus dans le même fichier.
+         * Réduit la confiance pour éviter la sur-résolution dans les fichiers très conflictuels.
+         * `fileFrequency = min(100, priorComplexHunksInFile × 20)`
+         */
+        fileFrequency: number;
+        /**
+         * v1.4 — Bonus de disponibilité de la base diff3/zdiff3.
+         * 100 si la base est disponible (diff3 ou zdiff3), 0 sinon (diff2).
+         */
+        baseAvailability: number;
+    };
+    /** Facteurs ayant augmenté le score (justifications de haute confiance) */
+    boosters: string[];
+    /** Facteurs ayant diminué le score (raisons de prudence) */
+    penalties: string[];
+}
+/** Une étape de l'évaluation de la classification */
+export interface TraceStep {
+    /** Type de conflit évalué à cette étape */
+    type: ConflictType;
+    /** Cette étape a-t-elle produit la classification finale ? */
+    passed: boolean;
+    /** Raison lisible — pourquoi ce type a été accepté ou rejeté */
+    reason: string;
+}
+/**
+ * Trace complète du raisonnement de classification d'un hunk.
+ *
+ * Exemple d'utilisation :
+ *   result.resolutions[0].hunk.trace.steps.forEach(s =>
+ *     console.log(`[${s.passed ? '✅' : '❌'}] ${s.type}: ${s.reason}`)
+ *   );
+ */
+export interface DecisionTrace {
+    /** Étapes d'évaluation dans l'ordre d'exécution */
+    steps: TraceStep[];
+    /** Type finalement sélectionné */
+    selected: ConflictType;
+    /** Résumé en une ligne lisible */
+    summary: string;
+    /** La base (diff3) était-elle disponible ? Conditionne les vérifications fines */
+    hasBase: boolean;
+}
+/**
+ * Input canonique pour la classification d'un hunk.
+ * Identique à RawConflict (défini dans parser.ts comme alias de ce type).
+ */
+export interface ClassifyInput {
+    oursLines: string[];
+    baseLines: string[];
+    theirsLines: string[];
+    startLine: number;
+    endLine: number;
+}
+/** Résultat complet de la classification d'un hunk */
+export interface ClassifyResult {
+    type: ConflictType;
+    confidence: ConfidenceScore;
+    explanation: string;
+    trace: DecisionTrace;
+}
+/**
+ * Interface implémentée par chaque pattern du registre.
+ *
+ * - `priority` : ordre d'évaluation (plus petit = testé en premier)
+ * - `requires` : diff3 (base disponible), diff2 (pas de base), both (toujours évalué)
+ * - `detect`   : vrai si le pattern s'applique à ce hunk
+ * - `confidence` : score composite quand le pattern a matché
+ * - `explanation` : texte lisible pour l'UI (mode explain)
+ * - `passReason` : raison dans la DecisionTrace quand passed=true
+ * - `failReason` : raison dans la DecisionTrace quand passed=false
+ */
+export interface PatternPlugin {
+    type: ConflictType;
+    priority: number;
+    requires: "diff3" | "diff2" | "both";
+    detect(h: ClassifyInput): boolean;
+    confidence(h: ClassifyInput): ConfidenceScore;
+    explanation(h: ClassifyInput): string;
+    passReason(h: ClassifyInput): string;
+    failReason(h: ClassifyInput): string;
+}
+/** Un bloc (hunk) de différence identifié */
+export interface ConflictHunk {
+    /** Lignes dans la version base */
+    baseLines: string[];
+    /** Lignes dans la version ours */
+    oursLines: string[];
+    /** Lignes dans la version theirs */
+    theirsLines: string[];
+    /** Numéro de ligne de début dans le fichier original (base) */
+    startLine: number;
+    /** Type de conflit détecté */
+    type: ConflictType;
+    /** Score de confiance composite pour la résolution automatique */
+    confidence: ConfidenceScore;
+    /** Explication lisible de la résolution (pour l'audit) */
+    explanation: string;
+    /** Trace de la décision de classification (Phase 7.1) */
+    trace: DecisionTrace;
+    /**
+     * v1.4 — Le conflit a-t-il été détecté en format zdiff3 ?
+     * zdiff3 (Git 2.35+) produit une section base tronquée aux seules lignes divergentes.
+     * Quand true, `baseAvailability` est fixé à 100 (même traitement que diff3).
+     */
+    zdiff3?: boolean;
+}
+/** Résultat de la résolution d'un seul hunk */
+export interface HunkResolution {
+    /** Le hunk d'origine */
+    hunk: ConflictHunk;
+    /** Les lignes résolues (null si non résolu) */
+    resolvedLines: string[] | null;
+    /** Est-ce que la résolution est automatique ? */
+    autoResolved: boolean;
+    /** Raison lisible de la résolution (ou du refus de résolution) */
+    resolutionReason: string;
+}
+/**
+ * Résultat de la validation du contenu fusionné.
+ * Détecte les problèmes résiduels après résolution.
+ */
+export interface ValidationResult {
+    /** Des marqueurs de conflit résiduels ont-ils été détectés ? */
+    hasResidualMarkers: boolean;
+    /** Marqueurs trouvés (exemples, pas la liste exhaustive) */
+    residualMarkerLines: number[];
+    /** Erreur de syntaxe pour les fichiers structurés (JSON) — null si valide ou non applicable */
+    syntaxError: string | null;
+    /** Le contenu fusionné est-il valide ? */
+    isValid: boolean;
+}
+/** Résultat complet de l'analyse et résolution d'un fichier */
+export interface MergeResult {
+    /** Chemin du fichier */
+    filePath: string;
+    /** Le fichier fusionné complet (null si des conflits restent) */
+    mergedContent: string | null;
+    /** Tous les hunks détectés */
+    hunks: ConflictHunk[];
+    /** Résolutions appliquées */
+    resolutions: HunkResolution[];
+    /** Statistiques */
+    stats: MergeStats;
+    /** Validation du contenu fusionné (Phase 7.2) */
+    validation: ValidationResult;
+}
+/** Statistiques de résolution */
+export interface MergeStats {
+    /** Nombre total de conflits détectés */
+    totalConflicts: number;
+    /** Nombre de conflits résolus automatiquement */
+    autoResolved: number;
+    /** Nombre de conflits restants (nécessitent intervention) */
+    remaining: number;
+    /** Répartition par type */
+    byType: Record<ConflictType, number>;
+}
+/** Options de configuration pour le moteur de résolution */
+export interface GitWandOptions {
+    /** Résoudre les conflits whitespace-only (défaut: true) */
+    resolveWhitespace?: boolean;
+    /** Résoudre les conflits d'imports non-overlapping (défaut: true) */
+    resolveNonOverlapping?: boolean;
+    /** Niveau de confiance minimum pour auto-résolution (défaut: "high") */
+    minConfidence?: Confidence;
+    /** Mode verbose pour le logging (défaut: false) */
+    verbose?: boolean;
+    /**
+     * Mode dry-run : classifier et tracer les hunks mais ne pas appliquer de résolution.
+     * Utile pour afficher le raisonnement sans toucher au fichier.
+     * (Phase 7.1 — explain-only mode)
+     */
+    explainOnly?: boolean;
+    /**
+     * Politique de résolution automatique (Phase 7.4).
+     * Contrôle les choix ambigus et le niveau d'agressivité.
+     * - "prefer-ours"   : choix ambigus → ours
+     * - "prefer-theirs" : choix ambigus → theirs (défaut du moteur)
+     * - "prefer-merge"  : résoudre le plus possible (minConfidence: medium)
+     * - "prefer-safety" : ne résoudre que l'évident (whitespace/value_only skippés)
+     * - "strict"        : seulement same_change, one_side_change, delete_no_change
+     */
+    policy?: import("./config.js").MergePolicy;
+    /**
+     * Overrides de politique par pattern glob (Phase 7.4).
+     * La clé est un pattern glob, la valeur une MergePolicy.
+     * Exemple : `{ "*.lock": "prefer-theirs", "src/**\/*.ts": "prefer-ours" }`
+     */
+    patternOverrides?: Record<string, import("./config.js").MergePolicy>;
+    /**
+     * Patterns glob de fichiers auto-générés (P2.4).
+     * S'ajoutent aux built-ins (lockfiles, bundles, `dist/`…) sans les remplacer.
+     * Exemple : `["src/**\/*.generated.ts", "*.pb.go", "api/openapi-client/**"]`.
+     */
+    generatedFiles?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * GitWand Core Types
+ *
+ * Représente les structures de données pour l'analyse
+ * et la résolution automatique de conflits Git.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@gitwand/core",
+  "version": "1.6.0",
+  "description": "GitWand core — automatic Git conflict resolution engine (powers @gitwand/cli, @gitwand/mcp, and the GitWand desktop app)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "git",
+    "merge",
+    "conflict",
+    "conflict-resolution",
+    "diff3",
+    "engine",
+    "gitwand"
+  ],
+  "homepage": "https://github.com/devlint/GitWand#conflict-resolution-engine",
+  "bugs": {
+    "url": "https://github.com/devlint/GitWand/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devlint/GitWand.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Laurent Guitton <lb.guitton@gmail.com>",
+  "dependencies": {
+    "smol-toml": "^1.3.0",
+    "yaml": "^2.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:bench": "vitest bench",
+    "clean": "rm -rf dist"
+  }
+}