@ovrdev/cli 0.1.0-alpha.16

package/dist/core/config.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Where an env's secrets come from. All fields optional so it can be split across a
+ * top-level default (usually `projectId`) and per-workspace overrides (usually `env`).
+ */
+export type InfisicalSource = {
+    env?: string;
+    projectId?: string;
+    path?: string;
+    cwd?: string;
+};
+export type CloneMethod = "ssh" | "https";
+/**
+ * A declared repo. `remote` is normally an "org/repo" slug (host defaults to GitHub),
+ * expanded to ssh/https at clone time per the machine's cloneMethod. A full URL
+ * (git@… or https://…) is also accepted and used verbatim.
+ */
+export type RepoDecl = {
+    remote: string;
+    branch?: string;
+    /**
+     * An existing local checkout used IN PLACE (no clone, no worktree) — the norm for base
+     * repos: the folder the user already has. When set, this repo lives here regardless of the
+     * root. Only forks (which lack a path) materialize worktrees under the root.
+     */
+    path?: string;
+};
+/**
+ * A workspace = an environment-scoped stack. Forks mirror their base and store only
+ * overrides. Repos declared here are inherited through the fork chain.
+ */
+export type Workspace = {
+    base?: string;
+    branch?: string;
+    infisical?: InfisicalSource;
+    repos?: Record<string, RepoDecl>;
+    protected?: boolean;
+    overrides?: Record<string, unknown>;
+};
+/** Personal display preferences for the `ovr run` TUI (machine-local, never in the team slice). */
+export type TuiConfig = {
+    wrap?: boolean;
+    timestamps?: boolean;
+    tabWidth?: number;
+    pager?: string;
+    bufferLines?: number;
+    historyLines?: number;
+    throttleMs?: number;
+    layout?: "tabs" | "sidebar";
+    mouse?: boolean;
+    keys?: Record<string, string>;
+};
+export type GlobalConfig = {
+    root?: string;
+    active?: string;
+    defaultOrg?: string;
+    cloneMethod?: CloneMethod;
+    inferFromCwd?: boolean;
+    teamConfig?: string;
+    infisical?: InfisicalSource;
+    tui?: TuiConfig;
+    workspaces: Record<string, Workspace>;
+};
+/** The shareable slice of config: workspace/repo definitions + shared infisical default. */
+export type TeamConfig = {
+    infisical?: InfisicalSource;
+    workspaces?: Record<string, Workspace>;
+};
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_PATH: string;
+/** Empty by default — nothing exists until you add it. */
+export declare const DEFAULT_CONFIG: GlobalConfig;
+export declare function loadConfig(): GlobalConfig;
+export declare function saveConfig(cfg: GlobalConfig): void;
+/** Serialize the shareable team slice (kebab-case) for `config export`. */
+export declare function serializeTeam(cfg: GlobalConfig): string;
+/** Parse a shared team config (kebab-case on disk) into camelCase. */
+export declare function parseTeam(text: string): TeamConfig;
+export type RepoConflict = {
+    workspace: string;
+    repo: string;
+    local: RepoDecl;
+    incoming: RepoDecl;
+};
+export type MergeResult = {
+    added: string[];
+    updated: string[];
+    conflicts: RepoConflict[];
+};
+/**
+ * Deep-merge a team slice into the local config: new workspaces added; existing ones keep
+ * their local-only repos, gain the incoming's new repos, and take incoming scalar fields.
+ * A repo declared on both sides with differing values is returned as a conflict (left as
+ * the local value) for the caller to resolve.
+ */
+export declare function mergeTeam(cfg: GlobalConfig, team: TeamConfig): MergeResult;
+export declare function getWorkspace(cfg: GlobalConfig, name: string): Workspace;
+export declare const activeName: (cfg: GlobalConfig, override?: string) => string | undefined;
+export declare const DEFAULT_BRANCH = "main";
+export declare const DEFAULT_HOST = "github.com";
+export declare const DEFAULT_CLONE_METHOD: CloneMethod;
+/**
+ * Normalize a repo remote for storage. A bare name (no org, no URL) gets `defaultOrg`
+ * prepended when one is configured; with no default org it's kept as-is (the user should
+ * pass `org/repo`). Full slugs and URLs pass through untouched.
+ */
+export declare function normalizeRemote(remote: string, defaultOrg?: string): string;
+/** Expand a repo `remote` (slug or full URL) into a clone URL for the given method. */
+export declare function repoUrl(remote: string, method?: CloneMethod): string;
+/** Resolve a repo's in-place `path` to an absolute path (expands a leading `~`, else CWD-relative). */
+export declare function resolveRepoPath(p: string): string;
+/** The fork chain for a workspace, base-first (…grandparent, parent, self). Cycle-guarded. */
+export declare function forkChain(cfg: GlobalConfig, name: string): string[];
+/** The comparator used across workspace listings: protected first, then alphabetical. */
+export declare const workspaceOrder: (cfg: GlobalConfig) => (a: string, b: string) => number;
+/**
+ * Workspace names in fork-tree order: each root, then its descendants depth-first, every level
+ * ordered protected-first + alphabetical (cycle-guarded). The single source of truth for listing
+ * order, so `ovr ws ls` (tree) and `ovr ls --all` (blocks) never interleave differently.
+ */
+export declare function forkTreeOrder(cfg: GlobalConfig): string[];
+/** Effective repos for a workspace: inherited through the fork chain, child overrides. */
+export declare function resolveRepos(cfg: GlobalConfig, name: string): Record<string, RepoDecl>;
+/** A workspace's branch: its own, else inherited through forks, else "main". */
+export declare const resolveBranch: (cfg: GlobalConfig, name: string) => string;
+/** Effective infisical source: top-level defaults ← per-workspace, merged up the fork chain. */
+export declare function resolveInfisical(cfg: GlobalConfig, name: string): InfisicalSource;
+/** A workspace's env slug, from the merged infisical source. */
+export declare const resolveEnvSlug: (cfg: GlobalConfig, name: string) => string | undefined;
+/** A repo's effective branch: its own override, else the workspace's branch. */
+export declare const repoBranch: (cfg: GlobalConfig, workspace: string, decl: RepoDecl) => string;
+/**
+ * Infer the workspace + repo from the current directory, when it sits inside
+ * root/<workspace>/<repo>(/…). workspace must be a known workspace. Returns {} otherwise.
+ */
+export declare function inferContext(cfg: GlobalConfig, cwd?: string): {
+    workspace?: string;
+    repo?: string;
+};