aristo-core 0.8.3

Aristo SDK core: shared types, .aristo/index.toml schema, B5b verification, language registry.
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

//! Auth — Aretta credential resolution + on-disk persistence + (soon)
//! the GitHub OAuth login flow.
//!
//! ## Scope
//!
//! This module is foundational SDK infrastructure: anything in aristo
//! that calls into the Aretta proxy uses it. **It is intentionally NOT
//! a submodule of any feature** (canon, verify, telemetry, ...) so
//! cross-feature consumers don't have to reach into a sibling
//! feature's namespace.
//!
//! ## Layout
//!
//! - [`token`] — the [`Token`] newtype with `Debug` redaction.
//! - [`store`] — credentials-file atomic I/O, one entry per server.
//!   Honors `$XDG_CONFIG_HOME`; `0600` perms on Unix.
//! - [`mod@resolve`] — env pair → the stored entry for the server.
//!   Returns [`ResolvedCreds`] or [`AuthError`].
//! - [`error`] — [`AuthError`] variants (`NoToken`, `Invalid`,
//!   `Malformed`).
//!
//! - `server` — [`ServerUrl`] plus the login-server and data-plane
//!   resolvers.
//! - `oauth` — GitHub OAuth code-exchange against the proxy's
//!   `/auth/cli-token` endpoint.
//! - `git` — auto-derive `repo_full_name` from a workspace's
//!   `.git/config`.
//!
//! ## Test pattern
//!
//! Every public function has a `_with` injection variant for testing.
//! The workspace forbids `unsafe_code`, which `std::env::set_var`
//! requires; tests pass explicit env-var + home-dir overrides instead
//! of mutating process state.

pub mod error;
pub mod git;
pub mod oauth;
pub mod org_repos;
pub mod resolve;
pub mod server;
pub mod store;
pub mod token;

pub use error::{login_command, AuthError, EntrySummary};
pub use git::derive_repo_full_name;
pub use oauth::{oauth_exchange, oauth_start, CliTokenResponse, GitHubUser, OAuthInit};
pub use org_repos::{fetch_org_repos, repo_segment_for, OrgRepo, ORG_REPOS_PATH};
pub use resolve::{resolve_full, resolve_full_with, ResolvedCreds, ENV_VAR, SERVER_ENV_VAR};
pub use server::{data_plane_base, login_server, LoginServerSource, ServerUrl};
pub use store::{
    clear, clear_with, config_dir, credentials_path, load_store, load_store_with, save_full,
    save_store, save_store_with, upsert_entry, upsert_entry_with, CredentialEntry, CredentialStore,
    CredentialsRecord, UpsertOutcome, UpsertReport, CREDENTIALS_FILENAME,
};
pub use token::Token;