PD-278 — Agent Developer — Module dip-config¶

Livrable¶

Fichier produit : src/modules/documents/config/dissemination.config.ts

Résumé¶

Configuration Joi centralisée pour toutes les bornes numériques du flux DIP (spec §5.5, §5.6). Validation stricte au démarrage avec rejet fail-fast — aucun clamping silencieux.

Conformité code contract¶

Invariants respectés¶

Forbidden respectés¶

Interface exportée : DisseminationConfig¶

export interface DisseminationConfig {
  minCopies: number;           // [2, 10], default 2
  maxPackageSize: number;      // [1, 100], default 100
  motifMaxLength: number;      // [0, 1024], default 1024
  slaTargetSealedToDipMs: number; // [200, 5000], default 2000
  slaTargetDipToSealedMs: number; // [200, 5000], default 1500
  slaHardTimeoutMs: number;    // [1000, 30000], default 5000
  rateLimitPerMinute: number;  // [1, 1000], default 60
  quotaPerDay: number;         // [1, 100000], default 1000
}

Variables d'environnement¶

Décisions architecturales¶

DA-01 : Pattern destruction.config.ts avec Number.parseInt(value, 10)¶

• Decision : Réutilisation du pattern destruction.config.ts (Map + Number.parseInt base 10 + Object.defineProperty)
• Rationale : Pattern établi et éprouvé dans le projet (PD-250, PD-279). Number.parseInt(v, 10) est plus robuste que Number(v) pour les entrées non numériques (ignore les suffixes).
• Alternatives considered : Pattern restitution.config.ts (plus simple, Number() direct), Injectable class pattern (integrity.config.ts)
• Trade-offs : Plus verbose que le pattern restitution mais plus robuste pour le parsing, et cohérent avec le fichier voisin destruction.config.ts qui a plus de paramètres similaires.

DA-02 : allowUnknown: true dans les options Joi¶

• Decision : Utiliser allowUnknown: true (comme restitution.config.ts) plutôt que allowUnknown: false (comme destruction.config.ts)
• Rationale : La config de dissemination est chargée dans un process.env contenant toutes les variables de l'application. allowUnknown: false rejetterait les variables d'autres modules (DATABASE_URL, REDIS_HOST, etc.) si passées directement. Le pattern restitution.config.ts utilise allowUnknown: true pour cette raison.
• Alternatives considered : allowUnknown: false avec extraction préalable des clés connues
• Trade-offs : allowUnknown: true ne valide pas la présence de variables inattendues, mais c'est acceptable car seules les clés DIP_* et SLA_* sont extraites.

Exports¶

Hypothèses¶

Aucune hypothèse supplémentaire. Toutes les bornes sont directement tirées de la spec §5.5 et §5.6.

Fichiers hors périmètre identifiés¶

Aucun fichier hors périmètre n'a nécessité de modification.

Matrice de couverture (tests suggérés)¶