@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/operations/services/config-runtime.d.ts

@@ -1,558 +0,0 @@
-import type { RemoteTreeseedConfig } from '../../remote.js';
-import { TREESEED_ENVIRONMENT_SCOPES, type TreeseedEnvironmentValidation, validateTreeseedEnvironmentValues } from '../../platform/environment.js';
-import { resolveTreeseedBootstrapSelection, type TreeseedBootstrapSystem, type TreeseedDesiredUnit } from '../../reconcile/index.js';
-import { type TreeseedKeyAgentStatus } from './key-agent.js';
-export { TREESEED_MACHINE_KEY_PASSPHRASE_ENV, TreeseedKeyAgentError } from './key-agent.js';
-export declare const DEFAULT_TREESEED_API_BASE_URL = "https://api.treeseed.dev";
-export declare const DEFAULT_TEMPLATE_CATALOG_URL = "https://api.treeseed.dev/search/templates";
-export declare const TREESEED_TEMPLATE_CATALOG_URL_ENV = "TREESEED_TEMPLATE_CATALOG_URL";
-export declare const TREESEED_API_BASE_URL_ENV = "TREESEED_API_BASE_URL";
-export declare function inspectTreeseedPassphraseEnvDiagnostic(env?: NodeJS.ProcessEnv): {
-    envVar: string;
-    configured: boolean;
-    recommendedLaunch: string;
-};
-export declare function inspectTreeseedKeyAgentTransportDiagnostic(): Promise<{
-    socketPath: string;
-    pidPath: string;
-    socketPresent: boolean;
-    socketKind: "missing" | "socket" | "fifo" | "file" | "directory" | "other";
-    socketConnectable: boolean;
-    healthOk: boolean;
-    daemonPid: number | null;
-    lastError: string | null;
-}>;
-export declare function listDeprecatedTreeseedLocalEnvFiles(tenantRoot: any): string[];
-export declare function warnDeprecatedTreeseedLocalEnvFiles(tenantRoot: any, write?: (line: string) => void): string[];
-export declare function getTreeseedMachineConfigPaths(tenantRoot: any): {
-    configPath: string;
-    authPath: string;
-    keyPath: string;
-    legacyKeyPath: string;
-};
-export declare function withTreeseedKeyAgentAutopromptDisabled<T>(action: () => T): T;
-export declare function inspectTreeseedKeyAgentStatus(tenantRoot: any): TreeseedKeyAgentStatus;
-export declare function unlockTreeseedSecretSessionInteractive(tenantRoot: any): any;
-export declare function unlockTreeseedSecretSessionFromEnv(tenantRoot: any, options?: {}): any;
-export declare function unlockTreeseedSecretSessionWithPassphrase(tenantRoot: any, passphrase: any, options?: {}): any;
-export declare function ensureTreeseedSecretSessionForConfig({ tenantRoot, interactive, env, createIfMissing, allowMigration, promptForPassphrase, promptForNewPassphrase, }: {
-    tenantRoot: string;
-    interactive?: boolean;
-    env?: NodeJS.ProcessEnv;
-    createIfMissing?: boolean;
-    allowMigration?: boolean;
-    promptForPassphrase?: () => Promise<string> | string;
-    promptForNewPassphrase?: () => Promise<string> | string;
-}): Promise<TreeseedConfigSecretSessionBootstrap>;
-export declare function lockTreeseedSecretSession(tenantRoot: any): any;
-export declare function getTreeseedRemoteAuthPaths(tenantRoot: any): {
-    authPath: string;
-};
-export type TreeseedConfigScope = (typeof TREESEED_ENVIRONMENT_SCOPES)[number];
-export type TreeseedConfigEntrySnapshot = {
-    id: string;
-    label: string;
-    group: string;
-    cluster: string;
-    startupProfile: 'core' | 'optional' | 'advanced';
-    requirement: 'required' | 'conditional' | 'optional' | 'generated';
-    description: string;
-    howToGet: string;
-    sensitivity: 'secret' | 'plain' | 'derived';
-    targets: string[];
-    purposes: string[];
-    storage: 'shared' | 'scoped';
-    validation?: TreeseedEnvironmentValidation;
-    sourceRequirement?: string;
-    sourceHostType?: string | null;
-    sourceProvider?: string | null;
-    scope: TreeseedConfigScope;
-    sharedScopes: TreeseedConfigScope[];
-    required: boolean;
-    currentValue: string;
-    suggestedValue: string;
-    effectiveValue: string;
-};
-export type TreeseedCollectedConfigContext = {
-    tenantRoot: string;
-    scopes: TreeseedConfigScope[];
-    project: {
-        name: string;
-        slug: string;
-        siteUrl: string;
-    };
-    configPath: string;
-    keyPath: string;
-    entriesByScope: Record<TreeseedConfigScope, TreeseedConfigEntrySnapshot[]>;
-    valuesByScope: Record<TreeseedConfigScope, Record<string, string>>;
-    suggestedValuesByScope: Record<TreeseedConfigScope, Record<string, string>>;
-    configReadinessByScope: Record<TreeseedConfigScope, ReturnType<typeof createConfigReadiness>>;
-    validationByScope: Record<TreeseedConfigScope, ReturnType<typeof validateTreeseedEnvironmentValues>>;
-    sharedStorageMigrations: TreeseedSharedStorageMigrationNotice[];
-    registry: ReturnType<typeof collectTreeseedEnvironmentContext>;
-};
-export type TreeseedConfigSecretSessionBootstrap = {
-    status: TreeseedKeyAgentStatus;
-    createdWrappedKey: boolean;
-    migratedWrappedKey: boolean;
-    unlockSource: 'interactive' | 'env' | 'existing-session';
-};
-export type TreeseedConfigValueUpdate = {
-    scope: TreeseedConfigScope;
-    entryId: string;
-    value: string;
-    reused?: boolean;
-};
-export type TreeseedSharedStorageMigrationNotice = {
-    entryId: string;
-    label: string;
-    promotedFrom: TreeseedConfigScope;
-    consolidatedScopes: TreeseedConfigScope[];
-    hadConflicts: boolean;
-};
-export declare function createDefaultTreeseedMachineConfig({ tenantRoot, deployConfig, tenantConfig }: {
-    tenantRoot: any;
-    deployConfig: any;
-    tenantConfig: any;
-}): {
-    version: number;
-    project: {
-        tenantRoot: any;
-        tenantId: any;
-        slug: any;
-        name: any;
-        siteUrl: any;
-        overlayPath: string;
-    };
-    settings: {
-        sync: {
-            github: boolean;
-            cloudflare: boolean;
-        };
-        templates: {
-            catalogEndpoint: string;
-        };
-        remote: {
-            activeHostId: string;
-            executionMode: string;
-            hosts: {
-                id: string;
-                label: string;
-                baseUrl: string;
-                official: boolean;
-            }[];
-        };
-        services: {
-            railway: {
-                projectId: string;
-                projectName: string;
-                apiServiceId: string;
-                apiServiceName: string;
-            };
-        };
-    };
-    shared: {
-        values: {};
-        secrets: {};
-    };
-    environments: {
-        [k: string]: {
-            values: {};
-            secrets: {};
-        };
-    };
-};
-export declare function rotateTreeseedMachineKey(tenantRoot: any): {
-    keyPath: string;
-    rotated: boolean;
-};
-export declare function rotateTreeseedMachineKeyPassphrase(tenantRoot: any, passphrase: any): {
-    keyPath: string;
-    rotated: boolean;
-};
-export declare function migrateTreeseedMachineKeyToWrapped(tenantRoot: any, passphrase: any): {
-    keyPath: string;
-    migrated: boolean;
-    alreadyWrapped: boolean;
-};
-export declare function loadTreeseedRemoteAuthState(tenantRoot: any): {
-    version: number;
-    sessions: {
-        [k: string]: {
-            accessToken: string;
-            refreshToken: string;
-            expiresAt: any;
-            principal: any;
-        };
-    };
-};
-export declare function writeTreeseedRemoteAuthState(tenantRoot: any, state: any): void;
-export declare function setTreeseedRemoteSession(tenantRoot: any, { hostId, accessToken, refreshToken, expiresAt, principal }: {
-    hostId: any;
-    accessToken: any;
-    refreshToken: any;
-    expiresAt: any;
-    principal: any;
-}): {
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: any;
-    principal: any;
-};
-export declare function clearTreeseedRemoteSession(tenantRoot: any, hostId: any): {
-    version: number;
-    sessions: {
-        [k: string]: {
-            accessToken: string;
-            refreshToken: string;
-            expiresAt: any;
-            principal: any;
-        };
-    };
-};
-export declare function resolveTreeseedRemoteSession(tenantRoot: any, hostId: any): {
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: any;
-    principal: any;
-} | null;
-export declare function loadTreeseedMachineConfig(tenantRoot: any): any;
-export declare function writeTreeseedMachineConfig(tenantRoot: any, config: any): void;
-export declare function updateTreeseedDeployConfigFeatureToggles(tenantRoot: string, toggles: Partial<Record<'turnstile' | 'smtp', boolean>>): void;
-export declare function resolveTreeseedRemoteConfig(startRoot?: string, env?: NodeJS.ProcessEnv): RemoteTreeseedConfig;
-export declare function resolveTreeseedTemplateCatalogEndpoint(startRoot?: string, env?: NodeJS.ProcessEnv): string;
-export declare function resolveTreeseedTemplateCatalogCachePath(startRoot?: string): string;
-export declare function ensureTreeseedGitignoreEntries(tenantRoot: any): string;
-export declare function ensureTreeseedRailwayIgnoreEntries(tenantRoot: any): string;
-export type TreeseedRepairAction = {
-    id: string;
-    detail: string;
-};
-export declare function applyTreeseedSafeRepairs(tenantRoot: string): TreeseedRepairAction[];
-export declare function resolveTreeseedMachineEnvironmentValues(tenantRoot: any, scope: any, additionalKeys?: never[]): {};
-export declare function setTreeseedMachineEnvironmentValue(tenantRoot: any, scope: any, entry: any, value: any): any;
-export declare function collectTreeseedEnvironmentContext(tenantRoot: any): import("../../platform/environment.js").TreeseedResolvedEnvironmentRegistry;
-export declare function collectTreeseedConfigSeedValues(tenantRoot: any, scope: any, env?: NodeJS.ProcessEnv, valuesOverlay?: {}): any;
-export declare function resolveTreeseedLaunchEnvironment({ tenantRoot, scope, baseEnv, overrides, }: {
-    tenantRoot: string;
-    scope: TreeseedConfigScope;
-    baseEnv?: NodeJS.ProcessEnv;
-    overrides?: NodeJS.ProcessEnv;
-}): {
-    GH_TOKEN?: string;
-    GITHUB_TOKEN?: string;
-} & {
-    CLOUDFLARE_API_TOKEN?: string;
-    CLOUDFLARE_ACCOUNT_ID?: string;
-} & {
-    RAILWAY_API_TOKEN?: string;
-    RAILWAY_TOKEN?: string;
-} & {
-    DOCKERHUB_TOKEN?: string;
-    DOCKERHUB_USERNAME?: string;
-} & {
-    CODEX_API_KEY?: string;
-};
-export declare function formatTreeseedConfigEnvironmentReport({ tenantRoot, scope, env, revealSecrets }: {
-    tenantRoot: any;
-    scope: any;
-    env?: NodeJS.ProcessEnv | undefined;
-    revealSecrets?: boolean | undefined;
-}): string;
-export declare function applyTreeseedEnvironmentToProcess({ tenantRoot, scope, override }: {
-    tenantRoot: any;
-    scope: any;
-    override?: boolean | undefined;
-}): {};
-export declare function validateTreeseedCommandEnvironment({ tenantRoot, scope, purpose }: {
-    tenantRoot: any;
-    scope: any;
-    purpose: any;
-}): {
-    registry: import("../../platform/environment.js").TreeseedResolvedEnvironmentRegistry;
-    values: {
-        GH_TOKEN?: string;
-        GITHUB_TOKEN?: string;
-    } & {
-        CLOUDFLARE_API_TOKEN?: string;
-        CLOUDFLARE_ACCOUNT_ID?: string;
-    } & {
-        RAILWAY_API_TOKEN?: string;
-        RAILWAY_TOKEN?: string;
-    } & {
-        DOCKERHUB_TOKEN?: string;
-        DOCKERHUB_USERNAME?: string;
-    } & {
-        CODEX_API_KEY?: string;
-    };
-    validation: any;
-};
-export declare function assertTreeseedCommandEnvironment({ tenantRoot, scope, purpose }: {
-    tenantRoot: any;
-    scope: any;
-    purpose: any;
-}): {
-    registry: import("../../platform/environment.js").TreeseedResolvedEnvironmentRegistry;
-    values: {
-        GH_TOKEN?: string;
-        GITHUB_TOKEN?: string;
-    } & {
-        CLOUDFLARE_API_TOKEN?: string;
-        CLOUDFLARE_ACCOUNT_ID?: string;
-    } & {
-        RAILWAY_API_TOKEN?: string;
-        RAILWAY_TOKEN?: string;
-    } & {
-        DOCKERHUB_TOKEN?: string;
-        DOCKERHUB_USERNAME?: string;
-    } & {
-        CODEX_API_KEY?: string;
-    };
-    validation: any;
-};
-export declare function ensureTreeseedActVerificationTooling({ tenantRoot, installIfMissing, env, write }?: {
-    tenantRoot?: string | undefined;
-    installIfMissing?: boolean | undefined;
-    env?: NodeJS.ProcessEnv | undefined;
-}): {
-    githubCli: {
-        name: any;
-        available: any;
-        detail: any;
-    };
-    ghActExtension: {
-        name: any;
-        available: any;
-        detail: any;
-    };
-    dockerDaemon: {
-        name: any;
-        available: any;
-        detail: any;
-    };
-    wranglerCli: {
-        name: any;
-        available: any;
-        detail: any;
-    };
-    railwayCli: {
-        name: any;
-        available: any;
-        detail: any;
-    };
-    actVerificationReady: any;
-    remediation: string[];
-};
-export declare function checkTreeseedProviderConnections({ tenantRoot, scope, env, valuesOverlay }?: {
-    scope?: string | undefined;
-    env?: NodeJS.ProcessEnv | undefined;
-    valuesOverlay?: {} | undefined;
-}): Promise<{
-    scope: string;
-    ok: boolean;
-    checks: {
-        provider: any;
-        ready: any;
-        detail: any;
-    }[];
-    issues: any[];
-}>;
-export declare function formatTreeseedProviderConnectionReport(report: any): string;
-export declare function syncTreeseedGitHubEnvironment({ tenantRoot, scope, planOnly, repository: repositoryInput, valuesOverlay, entryIds, managedHostMode, execution, concurrency, onProgress, }: {
-    tenantRoot: string;
-    scope?: TreeseedConfigScope;
-    planOnly?: boolean;
-    repository?: string | null;
-    valuesOverlay?: Record<string, string | undefined>;
-    entryIds?: string[];
-    managedHostMode?: 'auto' | 'direct' | 'managed';
-    execution?: 'parallel' | 'sequential';
-    concurrency?: number;
-    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
-}): Promise<{
-    repository: string;
-    scope: "local" | "staging" | "prod";
-    environment: string;
-    secrets: {
-        name: string;
-        existed: boolean;
-    }[];
-    variables: {
-        name: string;
-        existed: boolean;
-    }[];
-} | {
-    secrets: Array<{
-        name: string;
-        existed: boolean;
-    }>;
-    variables: Array<{
-        name: string;
-        existed: boolean;
-    }>;
-    repository: string;
-    scope: "local" | "staging" | "prod";
-    environment: string;
-    credential: {
-        repository: string;
-        envName: string;
-        configured: boolean;
-        source: "repository" | "fallback" | "missing";
-        fallbackUsed: boolean;
-    };
-    entryIds: string[] | undefined;
-}>;
-export declare function syncTreeseedCloudflareEnvironment({ tenantRoot, scope, planOnly, valuesOverlay, entryIds, onProgress, }: {
-    tenantRoot: string;
-    scope?: TreeseedConfigScope;
-    planOnly?: boolean;
-    valuesOverlay?: Record<string, string | undefined>;
-    entryIds?: string[];
-    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
-}): {
-    scope: "local" | "staging" | "prod";
-    target: {
-        kind: string;
-        scope: string;
-    };
-    wranglerPath: string;
-    entryIds: string[] | undefined;
-    secrets: string[];
-    varsManagedByWranglerConfig: string[];
-};
-export declare function syncTreeseedRailwayEnvironment({ tenantRoot, scope, planOnly, valuesOverlay, entryIds, onProgress, }: {
-    tenantRoot: string;
-    scope?: TreeseedConfigScope;
-    planOnly?: boolean;
-    valuesOverlay?: Record<string, string | undefined>;
-    entryIds?: string[];
-    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
-}): Promise<{
-    scope: "local" | "staging" | "prod";
-    entryIds: string[] | undefined;
-    services: {
-        service: any;
-        instanceKey: any;
-        projectName: any;
-        serviceName: any;
-        serviceId: any;
-        rootDir: any;
-        baseUrl: any;
-        environmentName: string;
-        secrets: any;
-        variables: any;
-        planOnly: boolean;
-    }[];
-}>;
-export declare function initializeTreeseedPersistentEnvironment({ tenantRoot, scope, planOnly }?: {
-    scope?: string | undefined;
-    planOnly?: boolean | undefined;
-}): Promise<{
-    scope: string;
-    target: {
-        kind: string;
-        scope: string;
-    };
-    summary: {
-        target: import("../../reconcile/contracts.js").TreeseedReconcileTarget;
-        units: TreeseedDesiredUnit[];
-        plans: import("../../reconcile/contracts.js").TreeseedReconcilePlan[];
-        results: import("../../reconcile/contracts.js").TreeseedReconcileResult[];
-        state: import("../../reconcile/contracts.js").TreeseedReconcileStateRecord;
-        timings: import("../../timing.js").TreeseedTimingEntry[];
-    };
-    secrets: string[];
-}>;
-declare function createConfigReadiness(values: any, validation: any): {
-    github: {
-        configured: boolean;
-    };
-    cloudflare: {
-        configured: boolean;
-    };
-    railway: {
-        configured: boolean;
-    };
-    localDevelopment: {
-        configured: boolean;
-    };
-};
-export declare function configGroupRank(group: any): number;
-export declare function listRelevantTreeseedConfigEntries(registry: any, scope: TreeseedConfigScope): any;
-export declare function collectTreeseedConfigContext({ tenantRoot, scopes, env, }: {
-    tenantRoot: string;
-    scopes?: TreeseedConfigScope[];
-    env?: NodeJS.ProcessEnv;
-}): TreeseedCollectedConfigContext;
-export declare function applyTreeseedConfigValues({ tenantRoot, updates, applyLocalEnvironment, }: {
-    tenantRoot: string;
-    updates: TreeseedConfigValueUpdate[];
-    applyLocalEnvironment?: boolean;
-}): {
-    updated: {
-        scope: TreeseedConfigScope | "shared";
-        id: string;
-        reused: boolean;
-        cleared: boolean;
-    }[];
-    sharedStorageMigrations: TreeseedSharedStorageMigrationNotice[];
-};
-export declare function finalizeTreeseedConfig({ tenantRoot, scopes, sync, env, checkConnections, initializePersistent, systems, skipUnavailable, bootstrapExecution, onProgress, }: {
-    tenantRoot: string;
-    scopes?: TreeseedConfigScope[];
-    sync?: 'none' | 'github' | 'cloudflare' | 'railway' | 'all';
-    env?: NodeJS.ProcessEnv;
-    checkConnections?: boolean;
-    initializePersistent?: boolean;
-    systems?: TreeseedBootstrapSystem[] | TreeseedBootstrapSystem;
-    skipUnavailable?: boolean;
-    bootstrapExecution?: 'parallel' | 'sequential';
-    onProgress?: (message: string, stream?: 'stdout' | 'stderr') => void;
-}): Promise<{
-    scopes: ("local" | "staging" | "prod")[];
-    synced: Record<string, unknown>;
-    reconciled: Array<{
-        scope: TreeseedConfigScope;
-        target: string;
-        units: number;
-        actions: Array<{
-            unitId: string;
-            unitType: string;
-            provider: string;
-            action: string;
-            verified: boolean;
-            missing: string[];
-            drifted: string[];
-        }>;
-    }>;
-    deployed: Array<{
-        scope: TreeseedConfigScope;
-        branchBootstrap?: Record<string, unknown> | null;
-        result: Record<string, unknown>;
-    }>;
-    resourceInventoryByScope: Record<TreeseedConfigScope, Record<string, unknown>>;
-    connectionChecks: ReturnType<typeof checkTreeseedProviderConnections>[];
-    validationByScope: Record<TreeseedConfigScope, ReturnType<typeof validateTreeseedEnvironmentValues>>;
-    bootstrapSystemsByScope: Record<TreeseedConfigScope, ReturnType<typeof resolveTreeseedBootstrapSelection>>;
-    githubRepository: Record<string, unknown> | null;
-    readinessByScope: Record<TreeseedConfigScope, {
-        phase: string;
-        configured: boolean;
-        provisioned: boolean;
-        deployable: boolean;
-        blockers: string[];
-        warnings: string[];
-        checks: Record<string, unknown>;
-    }>;
-    bootstrapExecution: "parallel" | "sequential";
-}>;
-export declare function collectTreeseedPrintEnvReport({ tenantRoot, scope, env, revealSecrets, }: {
-    tenantRoot: string;
-    scope: TreeseedConfigScope;
-    env?: NodeJS.ProcessEnv;
-    revealSecrets?: boolean;
-}): {
-    scope: "local" | "staging" | "prod";
-    revealSecrets: boolean;
-    entries: any;
-};