litvc 1.0.1

Lit - The agentic-first distributed version control system. A complete Git replacement designed for AI agents first and humans second.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

//! # Lit — The Agentic-First Distributed Version Control System
//!
//! Lit is a complete Git replacement written in Rust, designed for AI agents first and humans
//! second. Every command emits structured JSON by default with typed error codes, merge conflicts
//! as structured objects, and native MCP/REST API integration.
//!
//! ## Key Features
//!
//! - **Structured output**: All commands return typed JSON responses via [`response`] types
//! - **Post-quantum cryptography**: SHA3-512 + BLAKE3 hashing, ML-DSA signatures, AES-256-GCM encryption
//! - **MCP server**: JSON-RPC 2.0 tool server with 30 tools via [`commands::mcp_serve`]
//! - **Machine-readable ontology**: Full command/type discovery via [`ontology`]
//! - **Typed errors**: [`errors::LitError`] with error codes, user messages, and remediation hints
//!
//! ## Usage
//!
//! ```no_run
//! use lit::commands;
//! use lit::ontology;
//!
//! // Generate the full JSON Schema for agent SDK integration
//! let schema = ontology::generate_schemas();
//!
//! // Get the machine-readable ontology
//! let ont = ontology::get_ontology();
//! ```

/// VCS command implementations (init, add, commit, status, diff, merge, etc.)
pub mod commands;
/// Hierarchical configuration (repo-local → user global → env vars)
pub mod config;
/// Core VCS primitives: objects (blob, tree, commit, tag), refs, and repo discovery
pub mod core;
/// Post-quantum cryptographic operations: hashing, signing, encryption, key management
pub mod crypto;
/// Typed error system with machine-readable error codes and remediation hints
pub mod errors;
/// Output formatting (JSON, human-readable, MessagePack)
pub mod formatter;
/// Network transport layer: HTTPS, SSH, lit:// protocol, air-gap enforcement
pub mod network;
/// Machine-readable ontology and JSON Schema generation for agent discovery
pub mod ontology;
/// Typed response structs for all 42+ CLI commands
pub mod response;
/// Object store and index (staging area) persistence
pub mod storage;

// Re-export CLI types that are used by commands
#[derive(Clone, Debug)]
pub enum RemoteCommands {
    Add { name: String, url: String },
    Remove { name: String },
    List { verbose: bool },
}

#[derive(Clone, Debug)]
pub enum ConfigCommands {
    Show,
    Get { key: String },
    Set { key: String, value: String },
}

#[derive(Clone, Debug)]
pub enum StashCommands {
    Push { message: Option<String> },
    Pop,
    Apply { index: Option<usize> },
    List,
    Drop { index: Option<usize> },
}

#[derive(Clone, Debug)]
pub enum BisectCommands {
    Start,
    Good { commit: String },
    Bad { commit: String },
    Reset,
}

#[derive(Clone, Debug)]
pub enum TxCommands {
    Begin,
    Commit,
    Rollback,
}

#[derive(Clone, Debug)]
pub enum SwarmCommands {
    Register {
        agent_id: String,
    },
    List,
    LeaseAcquire {
        agent_id: String,
        path: String,
        duration: u64,
    },
    LeaseRelease {
        agent_id: String,
        path: String,
    },
    LeaseList,
}

#[derive(Clone, Debug)]
pub enum LfsCommands {
    Track { patterns: Vec<String> },
    Migrate { threshold: Option<u64> },
}