Expand description
Repository archetype detection and capability system
Archetypes provide internal capability detection for repositories. They detect what kind of content a repo contains and what features can be enabled for it.
§Design Philosophy
- Archetypes are internal - not user-facing CLI concepts
- Detection uses convention over configuration - no manifest files
- Archetypes are composable - a repo can match multiple
- Capabilities gate features - inference, query, training, etc.
§Capability Display Format
Capabilities are displayed as comma-separated IDs (e.g., infer,train,serve).
Available capabilities:
infer= run model inferencetrain= modify model weightsquery= SELECT from datawrite= INSERT/UPDATE dataserve= expose via APImanage= admin operationscontext= context-augmented generation
§Built-in Archetypes
| Archetype | Detects | Capabilities |
|---|---|---|
| HfModel | config.json + *.safetensors | INFER, TRAIN, SERVE |
| HfDataset | dataset_infos.json, *.parquet | QUERY, WRITE, SERVE |
| DuckDb | *.duckdb | QUERY, WRITE, SERVE |
| CagContext | context.json | CONTEXT |
Re-exports§
pub use capabilities::Capability;pub use capabilities::CapabilitySet;pub use capabilities::Context;pub use capabilities::Infer;pub use capabilities::Manage;pub use capabilities::Query;pub use capabilities::Serve;pub use capabilities::Train;pub use capabilities::Write;pub use domain::DetectionError;pub use domain::DetectionResult;pub use domain::Domain;pub use domain::SimpleDomain;
Modules§
- capabilities
- Type-safe capability system
- domain
- Domain trait and detection result types
Structs§
- Archetype
Registry - Registry for archetype detection with caching
- CagContext
Archetype - CAG Context archetype
- Detected
Archetypes - Cached archetype detection result
- Detected
Domains - Detected domains and their capabilities
- Duck
DbArchetype - DuckDB database archetype
- HfDataset
Archetype - HuggingFace Dataset archetype
- HfModel
Archetype - HuggingFace Model archetype
Traits§
- Repo
Archetype - Trait for repository archetype detection
Functions§
- builtin_
archetypes - Get all built-in archetypes
- global_
registry - Get the global archetype registry