@rizom/ops 0.2.0-alpha.3 → 0.2.0-alpha.300

package/dist/legacy-pilot-migration.d.ts

@@ -0,0 +1,11 @@
+import { type CohortConfig, type PilotConfig } from "./schema";
+/** Offline-only conversion. Active desired-state loading never calls this. */
+export declare function migrateLegacyPilotConfig(input: unknown): PilotConfig;
+/** Offline-only cohort conversion. */
+export declare function migrateLegacyCohortConfig(input: unknown): CohortConfig;
+/** Offline-only YAML rewrite that retains comments while changing the schema. */
+export declare function migrateLegacyPilotYaml(input: string): string;
+/** Offline-only cohort rewrite that retains comments while changing selection. */
+export declare function migrateLegacyCohortYaml(input: string): string;
+export declare function renderPilotConfig(config: PilotConfig): string;
+export declare function renderCohortConfig(config: CohortConfig): string;

package/dist/load-registry.d.ts

@@ -1,4 +1,4 @@
-import { type PilotConfig, type PilotPreset } from "./schema";
+import { type PilotConfig, type CanonicalBundleId } from "./schema";
 export type ExternalStatus = "unknown" | "ready" | "failed";
 export type SnapshotStatus = "present" | "missing";
 export interface ObservedUserStatus {
@@ -11,19 +11,89 @@ export interface ResolvedCohort {
     id: string;
     members: string[];
     brainVersionOverride?: string;
-    presetOverride?: PilotPreset;
+    bundlesOverride?: CanonicalBundleId[];
+    addOverride?: string[];
+    removeOverride?: string[];
     aiApiKeyOverride?: string;
+    gitSyncTokenOverride?: string;
+}
+export interface ResolvedAnchorProfileSocialLink {
+    platform: "github" | "instagram" | "linkedin" | "email" | "website";
+    url: string;
+    label?: string;
+}
+export interface ResolvedAnchorProfile {
+    name: string;
+    description?: string;
+    website?: string;
+    email?: string;
+    story?: string;
+    socialLinks?: ResolvedAnchorProfileSocialLink[];
+}
+export interface ResolvedSetupDelivery {
+    delivery: "email";
+    email: string;
+}
+export interface ResolvedAtprotoJetstreamConfig {
+    enabled?: boolean | undefined;
+    endpoint?: string | undefined;
+    replayWindowSeconds?: number | undefined;
+    denyDids?: string[] | undefined;
+    denyDomains?: string[] | undefined;
+    skillKeywords?: string[] | undefined;
+    queueLimit?: number | undefined;
+    concurrency?: number | undefined;
+    perDidCooldownSeconds?: number | undefined;
+    fetchBudgetPerMinute?: number | undefined;
+    newAgentsPerHour?: number | undefined;
+    pendingCandidateCeiling?: number | undefined;
+    staleCandidateRetentionDays?: number | undefined;
+    requestTimeoutMs?: number | undefined;
+    maxResponseBytes?: number | undefined;
+    maxRedirects?: number | undefined;
+    retryAttempts?: number | undefined;
+    heartbeatIntervalHours?: number | undefined;
+}
+export interface ResolvedAtprotoConfig {
+    identifier: string;
+    /** Owner account DID served at /.well-known/atproto-did for handle verification. */
+    accountDid?: string | undefined;
+    /** Whether this account publishes the canonical ai.rizom.brain.* schemas. */
+    lexiconAuthority?: boolean | undefined;
+    /** Per-brain bounded Jetstream canary configuration. */
+    jetstream?: ResolvedAtprotoJetstreamConfig | undefined;
+}
+export interface ResolvedPlaybooksConfig {
+    onboarding?: boolean | undefined;
+}
+export interface ResolvedSiteOverride {
+    package: string;
+    version: string;
+    theme?: string | undefined;
+    themeVersion?: string | undefined;
 }
 export interface ResolvedUserIdentity {
     handle: string;
     cohort: string;
     brainVersion: string;
-    model: "rover";
-    preset: PilotPreset;
+    bundles: CanonicalBundleId[];
+    add: string[];
+    remove: string[];
     domain: string;
+    cloudflareZoneId?: string | undefined;
     contentRepo: string;
+    profileKind?: string | undefined;
+    embeddingEnabled?: boolean | undefined;
+    topicExtractionEnabled?: boolean | undefined;
+    siteOverride?: ResolvedSiteOverride;
     discordEnabled: boolean;
+    discordAnchorUserId?: string;
     effectiveAiApiKey: string;
+    effectiveGitSyncToken: string;
+    setup?: ResolvedSetupDelivery;
+    atproto?: ResolvedAtprotoConfig;
+    playbooks?: ResolvedPlaybooksConfig;
+    anchorProfile: ResolvedAnchorProfile;
     snapshotStatus: SnapshotStatus;
 }
 export interface ResolvedUser extends ResolvedUserIdentity {
@@ -40,7 +110,4 @@ export interface PilotRegistry {
     cohorts: ResolvedCohort[];
     users: ResolvedUser[];
 }
-declare class PilotRegistryError extends Error {
-}
 export declare function loadPilotRegistry(rootDir: string, options?: LoadPilotRegistryOptions): Promise<PilotRegistry>;
-export { PilotRegistryError };

package/dist/observed-status.d.ts

@@ -0,0 +1,12 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
+import type { ObservedUserStatus, ResolvedUserIdentity } from "./load-registry";
+export interface LookupResult {
+    address: string;
+    family: number;
+}
+export type LookupHost = (hostname: string) => Promise<LookupResult>;
+export interface CreateObservedStatusResolverOptions {
+    fetchImpl?: FetchLike;
+    lookupHost?: LookupHost;
+}
+export declare function createObservedStatusResolver(options?: CreateObservedStatusResolverOptions): (user: ResolvedUserIdentity) => Promise<ObservedUserStatus>;

package/dist/onboard-user.d.ts

@@ -1,2 +1,2 @@
-import { type UserRunner } from "./reconcile-lib";
-export declare function onboardUser(rootDir: string, handle: string, runner?: UserRunner): Promise<void>;
+import { type UserRunner, type ContentRepoSyncOptions } from "./reconcile-lib";
+export declare function onboardUser(rootDir: string, handle: string, runner?: UserRunner, contentRepoOptions?: ContentRepoSyncOptions): Promise<void>;

package/dist/origin-ca.d.ts

@@ -0,0 +1 @@
+export { createOriginCertificateRequest, generateOriginKeyPair, issueCloudflareOriginCertificate, setCloudflareZoneSslStrict, type CloudflareOriginCaResult, type FetchLike, type OriginCertificateRequest, type OriginKeyPair, } from "@brains/deploy-support/origin-ca";

package/dist/parse-args.d.ts

@@ -1,10 +1,3 @@
-export interface ParsedArgs {
-    command: string;
-    args: string[];
-    flags: {
-        help?: boolean | undefined;
-        version?: boolean | undefined;
-        dryRun?: boolean | undefined;
-    };
-}
+import { type ParsedCliArgs } from "@brains/deploy-support/cli-kit";
+export type ParsedArgs = ParsedCliArgs;
 export declare function parseArgs(argv: string[]): ParsedArgs;

package/dist/preview-domain.d.ts

@@ -0,0 +1,9 @@
+export interface PreviewDomainOptions {
+    sharedDomain?: string | undefined;
+}
+/**
+ * Public operator-facing wrapper around the runtime's preview-domain rule.
+ * Keeping deploy resolution on this function prevents DNS, proxy, and runtime
+ * metadata from drifting onto different host shapes.
+ */
+export declare function derivePreviewDomain(domain: string, options?: PreviewDomainOptions): string;

package/dist/push-secrets.d.ts

@@ -0,0 +1,2 @@
+export { logKeyGroup, logMissingSecrets, pushSecretsToBackend, type PushSecretsOptions, type SecretPair, } from "@brains/deploy-support/push-secrets";
+export { normalizePushTarget } from "@brains/deploy-support/push-target";

package/dist/push-target.d.ts

@@ -0,0 +1 @@
+export { normalizePushTarget, type PushTarget, } from "@brains/deploy-support/push-target";

package/dist/reconcile-all.d.ts

@@ -1,2 +1,2 @@
-import { type UserRunner } from "./reconcile-lib";
-export declare function reconcileAll(rootDir: string, runner?: UserRunner): Promise<void>;
+import { type UserRunner, type ContentRepoSyncOptions } from "./reconcile-lib";
+export declare function reconcileAll(rootDir: string, runner?: UserRunner, contentRepoOptions?: ContentRepoSyncOptions): Promise<void>;

package/dist/reconcile-cohort.d.ts

@@ -1,2 +1,2 @@
-import { type UserRunner } from "./reconcile-lib";
-export declare function reconcileCohort(rootDir: string, cohortId: string, runner?: UserRunner): Promise<void>;
+import { type UserRunner, type ContentRepoSyncOptions } from "./reconcile-lib";
+export declare function reconcileCohort(rootDir: string, cohortId: string, runner?: UserRunner, contentRepoOptions?: ContentRepoSyncOptions): Promise<void>;

package/dist/reconcile-dry-run.d.ts

@@ -0,0 +1,9 @@
+export interface ReconcileDryRunResult {
+    firstPassChangedFiles: string[];
+    secondPassChangedFiles: string[];
+}
+/**
+ * Reconcile an isolated copy twice with external content-repo access disabled.
+ * The source repository is never written.
+ */
+export declare function dryRunReconcileAll(rootDir: string): Promise<ReconcileDryRunResult>;

package/dist/reconcile-lib.d.ts

@@ -1,7 +1,9 @@
+import { type ContentRepoSyncOptions } from "./content-repo";
 import { type PilotRegistry, type ResolvedUser } from "./load-registry";
 import type { UserRunner } from "./user-runner";
-export type { UserRunResult, UserRunner } from "./user-runner";
-export declare function runUsers(rootDir: string, registry: PilotRegistry, users: ResolvedUser[], runner?: UserRunner): Promise<void>;
+export type { ContentRepoSyncOptions } from "./content-repo";
+export type { ContentRepoFile, UserRunResult, UserRunner } from "./user-runner";
+export declare function runUsers(rootDir: string, registry: PilotRegistry, users: ResolvedUser[], runner?: UserRunner, contentRepoOptions?: ContentRepoSyncOptions): Promise<void>;
 export declare function findUser(rootDir: string, handle: string): Promise<{
     registry: PilotRegistry;
     user: ResolvedUser;

package/dist/run-command.d.ts

@@ -1,7 +1,11 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
+import { type CommandDefinition, type FlagDefinitions, type ParsedCliArgs } from "@brains/deploy-support/cli-kit";
 import type { LoadPilotRegistryOptions } from "./load-registry";
-import type { ParsedArgs } from "./parse-args";
-import { type RunCommand as SecretRunCommand } from "./secrets-push";
+import { type LookupHost } from "./observed-status";
+import { type RunCommand as OpsRunCommand } from "./run-subprocess";
+import { type SshKeygen } from "./ssh-key-bootstrap";
 import type { UserRunner } from "./user-runner";
+import type { cleanupDirectorySyncStress, runDeployedDirectorySyncStress, verifyDirectorySyncStressAccess } from "./directory-sync-stress-system";
 export interface CommandResult {
     success: boolean;
     message?: string;
@@ -10,6 +14,17 @@ export interface CommandDependencies extends LoadPilotRegistryOptions {
     runner?: UserRunner;
     env?: NodeJS.ProcessEnv | undefined;
     logger?: ((message: string) => void) | undefined;
-    secretRunCommand?: SecretRunCommand | undefined;
+    fetchImpl?: FetchLike | undefined;
+    lookupHost?: LookupHost | undefined;
+    verificationRetryAttempts?: number | undefined;
+    verificationRetryDelayMs?: number | undefined;
+    sleep?: ((delayMs: number) => Promise<void>) | undefined;
+    bootstrapRunCommand?: OpsRunCommand | undefined;
+    sshKeygen?: SshKeygen | undefined;
+    directorySyncStressRunner?: typeof runDeployedDirectorySyncStress | undefined;
+    directorySyncStressAccessRunner?: typeof verifyDirectorySyncStressAccess | undefined;
+    directorySyncStressCleanupRunner?: typeof cleanupDirectorySyncStress | undefined;
 }
-export declare function runCommand(parsed: ParsedArgs, dependencies?: CommandDependencies): Promise<CommandResult>;
+export declare const globalFlags: FlagDefinitions;
+export declare const commands: readonly CommandDefinition<CommandDependencies, CommandResult>[];
+export declare function runCommand(parsed: ParsedCliArgs, dependencies?: CommandDependencies): Promise<CommandResult>;

package/dist/run-subprocess.d.ts

@@ -0,0 +1 @@
+export { runSubprocess, type RunCommand, } from "@brains/deploy-support/run-subprocess";

package/dist/schema.d.ts

@@ -1,86 +1,135 @@
-import { z } from "@brains/utils";
-export declare const presetSchema: z.ZodEnum<["core", "default", "pro"]>;
+import { z } from "@brains/utils/zod";
 export declare const exactVersionSchema: z.ZodString;
 export declare const handleSchema: z.ZodString;
 export declare const secretNameSchema: z.ZodString;
-export declare const pilotSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    brainVersion: z.ZodString;
-    model: z.ZodLiteral<"rover">;
-    githubOrg: z.ZodString;
-    contentRepoPrefix: z.ZodString;
-    domainSuffix: z.ZodString;
-    preset: z.ZodEnum<["core", "default", "pro"]>;
-    aiApiKey: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    schemaVersion: 1;
-    brainVersion: string;
-    model: "rover";
-    githubOrg: string;
-    contentRepoPrefix: string;
-    domainSuffix: string;
-    preset: "core" | "default" | "pro";
-    aiApiKey: string;
-}, {
-    schemaVersion: 1;
+export declare const agePublicKeySchema: z.ZodString;
+export declare const canonicalBundleIdSchema: z.ZodEnum<{
+    core: "core";
+    site: "site";
+    publishing: "publishing";
+    team: "team";
+}>;
+export type CanonicalBundleId = z.output<typeof canonicalBundleIdSchema>;
+/**
+ * The profile kinds the runtime's profile plugin registers. A user config
+ * selecting anything else composes a brain that fails at boot, so reject it
+ * at parse time. Kept in lockstep with @brains/profile BUILT_IN_PROFILE_KINDS
+ * by a test. Collective/organization brains use "organization".
+ */
+export declare const PROFILE_KINDS: readonly ["professional", "team", "organization"];
+export declare const profileKindSchema: z.ZodEnum<{
+    professional: "professional";
+    team: "team";
+    organization: "organization";
+}>;
+export interface PilotConfig {
     brainVersion: string;
-    model: "rover";
+    bundles: CanonicalBundleId[];
+    add?: string[] | undefined;
+    remove?: string[] | undefined;
     githubOrg: string;
     contentRepoPrefix: string;
     domainSuffix: string;
-    preset: "core" | "default" | "pro";
     aiApiKey: string;
+    gitSyncToken: string;
+    contentRepoAdminToken: string;
+    agePublicKey: string;
+}
+export interface SiteOverrideConfig {
+    package: string;
+    version: string;
+    theme?: string | undefined;
+    themeVersion?: string | undefined;
+}
+export interface CohortConfig {
+    members: string[];
+    brainVersionOverride?: string | undefined;
+    bundlesOverride?: CanonicalBundleId[] | undefined;
+    addOverride?: string[] | undefined;
+    removeOverride?: string[] | undefined;
+    aiApiKeyOverride?: string | undefined;
+    gitSyncTokenOverride?: string | undefined;
+}
+/** Sole active desired-state contract for the canonical brain. */
+export declare const pilotSchema: z.ZodType<PilotConfig>;
+export declare const cohortSchema: z.ZodType<CohortConfig>;
+declare const anchorProfileSocialLinkSchema: z.ZodObject<{
+    platform: z.ZodEnum<{
+        github: "github";
+        instagram: "instagram";
+        linkedin: "linkedin";
+        email: "email";
+        website: "website";
+    }>;
+    url: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}>;
+declare const anchorProfileSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    website: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    story: z.ZodOptional<z.ZodString>;
+    socialLinks: z.ZodOptional<z.ZodArray<typeof anchorProfileSocialLinkSchema>>;
+}>;
+declare const setupDeliverySchema: z.ZodObject<{
+    delivery: z.ZodLiteral<"email">;
+    email: z.ZodString;
+}>;
+declare const atprotoJetstreamSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    replayWindowSeconds: z.ZodOptional<z.ZodNumber>;
+    denyDids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    denyDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    skillKeywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    queueLimit: z.ZodOptional<z.ZodNumber>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
+    perDidCooldownSeconds: z.ZodOptional<z.ZodNumber>;
+    fetchBudgetPerMinute: z.ZodOptional<z.ZodNumber>;
+    newAgentsPerHour: z.ZodOptional<z.ZodNumber>;
+    pendingCandidateCeiling: z.ZodOptional<z.ZodNumber>;
+    staleCandidateRetentionDays: z.ZodOptional<z.ZodNumber>;
+    requestTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxResponseBytes: z.ZodOptional<z.ZodNumber>;
+    maxRedirects: z.ZodOptional<z.ZodNumber>;
+    retryAttempts: z.ZodOptional<z.ZodNumber>;
+    heartbeatIntervalHours: z.ZodOptional<z.ZodNumber>;
+}>;
+declare const atprotoSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    accountDid: z.ZodOptional<z.ZodString>;
+    lexiconAuthority: z.ZodOptional<z.ZodBoolean>;
+    jetstream: z.ZodOptional<typeof atprotoJetstreamSchema>;
+}>;
+export declare const siteOverrideSchema: z.ZodType<SiteOverrideConfig>;
+declare const playbooksSchema: z.ZodObject<{
+    onboarding: z.ZodOptional<z.ZodBoolean>;
 }>;
 export declare const userSchema: z.ZodObject<{
     handle: z.ZodString;
     discord: z.ZodObject<{
         enabled: z.ZodBoolean;
-    }, "strict", z.ZodTypeAny, {
-        enabled: boolean;
-    }, {
-        enabled: boolean;
+        anchorUserId: z.ZodOptional<z.ZodString>;
     }>;
     aiApiKeyOverride: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    handle: string;
-    discord: {
-        enabled: boolean;
-    };
-    aiApiKeyOverride?: string | undefined;
-}, {
-    handle: string;
-    discord: {
-        enabled: boolean;
-    };
-    aiApiKeyOverride?: string | undefined;
-}>;
-export declare const cohortSchema: z.ZodEffects<z.ZodObject<{
-    members: z.ZodArray<z.ZodString, "many">;
-    brainVersionOverride: z.ZodOptional<z.ZodString>;
-    presetOverride: z.ZodOptional<z.ZodEnum<["core", "default", "pro"]>>;
-    aiApiKeyOverride: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    members: string[];
-    aiApiKeyOverride?: string | undefined;
-    brainVersionOverride?: string | undefined;
-    presetOverride?: "core" | "default" | "pro" | undefined;
-}, {
-    members: string[];
-    aiApiKeyOverride?: string | undefined;
-    brainVersionOverride?: string | undefined;
-    presetOverride?: "core" | "default" | "pro" | undefined;
-}>, {
-    members: string[];
-    aiApiKeyOverride?: string | undefined;
-    brainVersionOverride?: string | undefined;
-    presetOverride?: "core" | "default" | "pro" | undefined;
-}, {
-    members: string[];
-    aiApiKeyOverride?: string | undefined;
-    brainVersionOverride?: string | undefined;
-    presetOverride?: "core" | "default" | "pro" | undefined;
+    gitSyncTokenOverride: z.ZodOptional<z.ZodString>;
+    domainOverride: z.ZodOptional<z.ZodString>;
+    cloudflareZoneId: z.ZodOptional<z.ZodString>;
+    contentRepoOverride: z.ZodOptional<z.ZodString>;
+    profileKind: z.ZodOptional<typeof profileKindSchema>;
+    embeddingEnabled: z.ZodOptional<z.ZodBoolean>;
+    topicExtractionEnabled: z.ZodOptional<z.ZodBoolean>;
+    addOverride: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    removeOverride: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    siteOverride: z.ZodOptional<typeof siteOverrideSchema>;
+    setup: z.ZodOptional<typeof setupDeliverySchema>;
+    atproto: z.ZodOptional<typeof atprotoSchema>;
+    playbooks: z.ZodOptional<typeof playbooksSchema>;
+    anchorProfile: z.ZodOptional<typeof anchorProfileSchema>;
 }>;
-export type PilotConfig = z.infer<typeof pilotSchema>;
-export type UserConfig = z.infer<typeof userSchema>;
-export type CohortConfig = z.infer<typeof cohortSchema>;
-export type PilotPreset = z.infer<typeof presetSchema>;
+export type PilotConfigInput = z.input<typeof pilotSchema>;
+export type UserConfig = z.output<typeof userSchema>;
+export type UserConfigInput = z.input<typeof userSchema>;
+export type CohortConfigInput = z.input<typeof cohortSchema>;
+export {};

package/dist/secrets-encrypt.d.ts

@@ -0,0 +1,26 @@
+import { z } from "@brains/utils/zod";
+declare const encryptedUserSecretsSchema: z.ZodObject<{
+    gitSyncToken: z.ZodOptional<z.ZodString>;
+    discordBotToken: z.ZodOptional<z.ZodString>;
+    discordPublicKey: z.ZodOptional<z.ZodString>;
+    discordApplicationId: z.ZodOptional<z.ZodString>;
+    aiApiKey: z.ZodOptional<z.ZodString>;
+    atprotoAppPassword: z.ZodOptional<z.ZodString>;
+    certificatePem: z.ZodOptional<z.ZodString>;
+    privateKeyPem: z.ZodOptional<z.ZodString>;
+}>;
+export type EncryptedUserSecrets = z.output<typeof encryptedUserSecretsSchema>;
+export interface SecretsEncryptOptions {
+    env?: NodeJS.ProcessEnv | undefined;
+    logger?: ((message: string) => void) | undefined;
+    dryRun?: boolean | undefined;
+}
+export interface SecretsEncryptResult {
+    encryptedPath: string;
+    plaintextPath: string;
+    deletedPlaintext: boolean;
+    encryptedKeys: Array<keyof EncryptedUserSecrets>;
+    dryRun?: boolean | undefined;
+}
+export declare function encryptPilotSecrets(rootDir: string, handle: string, options?: SecretsEncryptOptions): Promise<SecretsEncryptResult>;
+export {};

package/dist/secrets-push.d.ts

@@ -1,3 +1,4 @@
+import { type RunCommand } from "./run-subprocess";
 export interface SecretsPushOptions {
     env?: NodeJS.ProcessEnv | undefined;
     logger?: ((message: string) => void) | undefined;
@@ -9,8 +10,4 @@ export interface SecretsPushResult {
     skippedKeys: string[];
     dryRun?: boolean | undefined;
 }
-export type RunCommand = (command: string, args: string[], options?: {
-    stdin?: string;
-    env?: NodeJS.ProcessEnv;
-}) => Promise<void>;
-export declare function pushPilotSecrets(rootDir: string, handle: string, options?: SecretsPushOptions): Promise<SecretsPushResult>;
+export declare function pushPilotSecrets(rootDir: string, options?: SecretsPushOptions): Promise<SecretsPushResult>;

package/dist/ssh-key-bootstrap.d.ts

@@ -0,0 +1 @@
+export { bootstrapSshKey as bootstrapPilotSshKey, runSshKeyBootstrap as runPilotSshKeyBootstrap, type SshKeyBootstrapOptions, type SshKeyBootstrapResult, type SshKeygen, } from "@brains/deploy-support/ssh-key-bootstrap";

package/dist/stage-legacy-crossover.d.ts

@@ -0,0 +1,20 @@
+import { type SiteOverrideConfig } from "./schema";
+export interface StagedCrossover {
+    outputDir: string;
+    changedFiles: string[];
+}
+interface ReviewedSitePinManifest {
+    sites: Record<string, SiteOverrideConfig>;
+}
+export type ReviewedSitePins = ReviewedSitePinManifest["sites"];
+export interface StageLegacyCrossoverOptions {
+    sitePins?: ReviewedSitePins | undefined;
+}
+export declare function parseReviewedSitePins(input: string): ReviewedSitePins;
+export declare function loadReviewedSitePins(filePath: string): Promise<ReviewedSitePins>;
+/**
+ * Build a complete review copy without mutating the source repository.
+ * This is offline migration tooling; active desired-state loading is canonical-only.
+ */
+export declare function stageLegacyCrossover(sourceDir: string, outputDir: string, options?: StageLegacyCrossoverOptions): Promise<StagedCrossover>;
+export {};

package/dist/stress-command.d.ts

@@ -0,0 +1,14 @@
+export interface StressCommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    stdin?: string;
+}
+export interface StressCommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export type StressCommandRunner = (command: string, args: readonly string[], options?: StressCommandOptions) => Promise<StressCommandResult>;
+export declare const runStressCommand: StressCommandRunner;
+export declare function requireCommand(runner: StressCommandRunner, command: string, args: readonly string[], options?: StressCommandOptions): Promise<StressCommandResult>;
+export declare function commandError(command: string, args: readonly string[], result: StressCommandResult): Error;

package/dist/stress-git-checkout.d.ts

@@ -0,0 +1,21 @@
+import { type StressCommandResult, type StressCommandRunner } from "./stress-command";
+/**
+ * Git operations against one content-repo checkout, executed through a
+ * stress command runner with token-bearing credentials.
+ */
+export declare class GitCheckout {
+    #private;
+    readonly dir: string;
+    constructor(runner: StressCommandRunner, dir: string, token: string);
+    /** Clone `repository`'s main branch into `dir` and pin it to origin/main. */
+    static clone(runner: StressCommandRunner, repository: string, dir: string, token: string): Promise<GitCheckout>;
+    run(args: readonly string[], required?: boolean): Promise<StressCommandResult>;
+    output(args: readonly string[]): Promise<string>;
+    sync(hardReset?: boolean): Promise<void>;
+    /** Stage everything and commit as the ops identity. */
+    commitAll(message: string): Promise<void>;
+    pushMainWithRebase(): Promise<void>;
+    /** Delete every remote stress backup branch; returns the deleted names. */
+    pruneStressBackupBranches(): Promise<string[]>;
+    private environment;
+}

package/dist/stress-health-monitor.d.ts

@@ -0,0 +1,46 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
+import { type StressHealthSample, type StressRuntimeSample } from "./directory-sync-stress";
+export interface HealthPayload {
+    version: string;
+    entities: number;
+    entityCounts: {
+        entityType: string;
+        count: number;
+    }[];
+}
+export declare function noteCount(payload: HealthPayload): number;
+export interface StressHealthMonitorOptions {
+    domain: string;
+    fetchImpl: FetchLike;
+    now: () => Date;
+    sleep: (milliseconds: number) => Promise<void>;
+    /** Take one runtime sample (e.g. docker stats over SSH), if available. */
+    sampleRuntime: () => Promise<StressRuntimeSample | undefined>;
+}
+/**
+ * Samples deployment health and runtime resource usage during a stress run,
+ * and answers entity-baseline waits against the operational health endpoint.
+ */
+export declare class StressHealthMonitor {
+    #private;
+    constructor(options: StressHealthMonitorOptions);
+    /** ISO timestamp of the most recent start() call. */
+    get startedAt(): string;
+    /** The first sampling failure since start(), if any. */
+    get error(): unknown;
+    get healthSamples(): readonly StressHealthSample[];
+    get runtimeSamples(): readonly StressRuntimeSample[];
+    /** Health samples between start() and markGateEnd() (or now). */
+    gateHealthSamples(): StressHealthSample[];
+    /** Exclude samples taken after this point from the gate window. */
+    markGateEnd(): void;
+    /** Probe optional health endpoints and add responsive ones to the loop. */
+    discoverEndpoints(): Promise<void>;
+    start(): void;
+    /** Stop sampling and wait for the loops; a loop error stays on `error`. */
+    stop(): Promise<void>;
+    waitForHealthSnapshot(timeoutMs: number): Promise<HealthPayload | undefined>;
+    waitForEntityBaseline(expectedNotes: number | undefined, expectedEntities: number | undefined, timeoutMs: number): Promise<HealthPayload | undefined>;
+    waitForStableEntityBaseline(expectedNotes: number | undefined, expectedEntities: number | undefined, timeoutMs: number): Promise<HealthPayload | undefined>;
+    fetchHealthPayload(): Promise<HealthPayload | undefined>;
+}

package/dist/upgrade.d.ts

@@ -0,0 +1,10 @@
+export type UpgradeExec = (command: string[], cwd: string) => Promise<void>;
+export interface UpgradeOptions {
+    exec?: UpgradeExec | undefined;
+    version?: string | undefined;
+}
+export interface UpgradeResult {
+    from: string;
+    to: string;
+}
+export declare function upgradePilotRepo(rootDir: string, options?: UpgradeOptions): Promise<UpgradeResult>;

package/dist/user-add.d.ts

@@ -0,0 +1,15 @@
+export interface AddPilotUserOptions {
+    cohort: string;
+    anchorId?: string | undefined;
+}
+export interface AddPilotUserResult {
+    handle: string;
+    cohort: string;
+    userPath: string;
+    secretsTemplatePath: string;
+    cohortPath: string;
+    createdUser: boolean;
+    createdSecretsTemplate: boolean;
+    addedToCohort: boolean;
+}
+export declare function addPilotUser(rootDir: string, handle: string, options: AddPilotUserOptions): Promise<AddPilotUserResult>;

package/dist/user-runner.d.ts

@@ -1,6 +1,11 @@
 import type { ResolvedUser } from "./load-registry";
+export interface ContentRepoFile {
+    path: string;
+    content: string;
+}
 export interface UserRunResult {
     brainYaml?: string;
     envFile?: string;
+    contentRepoFiles?: ContentRepoFile[];
 }
 export type UserRunner = (user: ResolvedUser) => Promise<UserRunResult | void>;