Context Packages — LeanCTX

Les Context Packages vous permettent de capturer les connaissances accumulées d'un projet — faits, structures de graphe, découvertes de session, pièges et patterns — dans un bundle portable et versionné. Exportez des packages pour vos coéquipiers, importez des connaissances de domaine depuis des bibliothèques partagées, ou chargez automatiquement les conventions du projet à chaque démarrage de session.

Couches de Package

Chaque package peut contenir une ou plusieurs couches. N'incluez que ce dont vous avez besoin — des faits de connaissance ciblés aux snapshots complets de projet.

Knowledge

Faits persistés, contraintes et connaissances de domaine extraits de votre projet.

Graph

Nœuds et arêtes du property graph capturant la structure du code, les dépendances et les relations d'appel.

Session

Découvertes et décisions de session issues des sessions de développement précédentes.

Patterns

Patterns de compression shell et règles de formatage de sortie adaptés à votre stack.

Gotchas

Pièges connus, cas limites et avertissements dont les agents doivent être informés.

Commandes CLI

Gérez les context packages entièrement depuis la ligne de commande. Toutes les opérations supportent la sortie JSON pour l'intégration CI/CD.

Command	Description
`lean-ctx pack create --name my-pkg --layers knowledge,graph`	Créer un package à partir du contexte du projet actuel
`lean-ctx pack list`	Lister tous les packages installés avec version et statut de chargement automatique
`lean-ctx pack info my-pkg`	Afficher les métadonnées, couches, statistiques et hash d'intégrité du package
`lean-ctx pack export my-pkg -o my-pkg.lctxpkg`	Exporter un package vers un fichier .lctxpkg portable pour le partage
`lean-ctx pack import my-pkg.lctxpkg`	Importer un package depuis un fichier .lctxpkg dans votre registre local
`lean-ctx pack install my-pkg`	Installer et fusionner le contexte du package dans le projet actuel
`lean-ctx pack remove my-pkg`	Supprimer un package du registre local
`lean-ctx pack auto-load my-pkg on`	Activer ou désactiver le chargement automatique au démarrage de session

Quick Start

# Create a package with knowledge and graph layers
lean-ctx pack create --name my-project-ctx --layers knowledge,graph

# Export for sharing
lean-ctx pack export my-project-ctx -o my-project-ctx.lctxpkg

# Teammate imports and installs
lean-ctx pack import my-project-ctx.lctxpkg
lean-ctx pack install my-project-ctx

# Enable auto-load for future sessions
lean-ctx pack auto-load my-project-ctx on

Chargement Automatique

Marquez les packages pour un chargement automatique. Lorsque ctx_overview s'exécute au démarrage de session, tous les packages avec chargement automatique activé sont fusionnés dans le contexte actif du projet — les faits de connaissance, les données de graphe et les pièges deviennent immédiatement disponibles.

$ lean-ctx pack auto-load my-pkg on

Intégrité & Sécurité

Chaque package inclut un hash de contenu SHA-256 calculé à partir de la sérialisation JSON canonique. Les opérations d'importation vérifient l'intégrité avant la fusion. Toutes les opérations de fichiers utilisent des écritures atomiques (tmp + renommage) pour prévenir la corruption.

$ lean-ctx pack info my-pkg

Intégration

Les faits de connaissance importés sont fusionnés avec plafonnement de confiance. Les nœuds et arêtes du graphe sont ajoutés au property graph. Les gotchas sont dédupliqués par identifiant. Les découvertes de session enrichissent l'historique. Tout s'intègre avec le pipeline LeanCTX existant.

Commencez à Empaqueter le Contexte

Installez LeanCTX et créez votre premier context package en moins d'une minute.

Démarrer →