@rizom/ops 0.2.0-alpha.254 → 0.2.0-alpha.256

package/dist/directory-sync-stress-system.d.ts

@@ -0,0 +1,63 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
+import { type DirectorySyncStressPhase, type DirectorySyncStressProfile, type DirectorySyncStressReport, type StressRuntimeSample } from "./directory-sync-stress";
+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 interface DeployedDirectorySyncStressOptions {
+    rootDir: string;
+    handle: string;
+    profile: DirectorySyncStressProfile;
+    confirmation: string;
+    artifactsDir?: string;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+    commandRunner?: StressCommandRunner;
+    logger?: (message: string) => void;
+    now?: () => Date;
+    sleep?: (milliseconds: number) => Promise<void>;
+}
+export interface CleanupDirectorySyncStressOptions {
+    rootDir: string;
+    handle: string;
+    confirmation: string;
+    artifactsDir?: string;
+    env?: NodeJS.ProcessEnv;
+    commandRunner?: StressCommandRunner;
+    logger?: (message: string) => void;
+    now?: () => Date;
+}
+export interface DeployedDirectorySyncStressResult {
+    runId: string;
+    artifactsDir: string;
+    target: {
+        handle: string;
+        domain: string;
+        contentRepo: string;
+    };
+    startedAt: string;
+    completedAt: string;
+    report: DirectorySyncStressReport;
+}
+export interface CleanupDirectorySyncStressResult {
+    success: boolean;
+    artifactsDir: string;
+    probesRemoved: number;
+    probesRemaining: number;
+    backupBranchesDeleted: string[];
+    cleanupCommit?: string;
+}
+export declare function runDeployedDirectorySyncStress(options: DeployedDirectorySyncStressOptions): Promise<DeployedDirectorySyncStressResult>;
+export declare function cleanupDirectorySyncStress(options: CleanupDirectorySyncStressOptions): Promise<CleanupDirectorySyncStressResult>;
+export declare function applyDirectorySyncStressPhase(checkoutDir: string, phase: DirectorySyncStressPhase): Promise<void>;
+export declare function listProbeFiles(checkoutDir: string): Promise<string[]>;
+export declare function removeProbeFiles(checkoutDir: string): Promise<number>;
+export declare function parseStressRuntimeSample(output: string, timestamp: string): StressRuntimeSample | undefined;
+export declare const runStressCommand: StressCommandRunner;

package/dist/directory-sync-stress.d.ts

@@ -0,0 +1,105 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
+import { z } from "@brains/utils/zod";
+export type DirectorySyncStressProfile = "regression" | "load" | "stress";
+export type DirectorySyncStressOperation = "add" | "update" | "rename" | "delete";
+export interface DirectorySyncStressPhase {
+    id: string;
+    operation: DirectorySyncStressOperation;
+    count: number;
+    targetProbeCount: number;
+    settleMs: number;
+}
+export interface DirectorySyncStressPlan {
+    profile: DirectorySyncStressProfile;
+    maximumProbeCount: number;
+    phases: DirectorySyncStressPhase[];
+}
+export interface StressBaseline {
+    entities: number;
+    notes: number;
+    version: string;
+}
+export interface StressHealthSample {
+    timestamp: string;
+    endpoint: string;
+    status: number;
+    durationMs: number;
+    ok: boolean;
+    error?: string | undefined;
+}
+export interface StressRuntimeSample {
+    timestamp: string;
+    cpuPercent: number;
+    memoryPercent: number;
+    pids: number;
+}
+export interface StressPhaseResult {
+    id: string;
+    operation: DirectorySyncStressOperation;
+    count: number;
+    success: boolean;
+    commitLatencyMs?: number | undefined;
+    persistenceLatencyMs?: number | undefined;
+    error?: string | undefined;
+}
+export interface StressCleanupResult {
+    success: boolean;
+    probesRemaining: number;
+    finalEntities?: number | undefined;
+    finalNotes?: number | undefined;
+    contentTreeRestored?: boolean | undefined;
+    error?: string | undefined;
+}
+export interface StressContainerState {
+    status: string;
+    restartCount: number;
+    oomKilled: boolean;
+}
+export interface StressMetrics {
+    health: StressHealthSample[];
+    runtime: StressRuntimeSample[];
+    container?: StressContainerState | undefined;
+}
+export interface DirectorySyncStressReport {
+    profile: DirectorySyncStressProfile;
+    success: boolean;
+    baseline: StressBaseline;
+    phases: StressPhaseResult[];
+    cleanup: StressCleanupResult;
+    metrics: StressMetrics;
+    failure?: string | undefined;
+}
+export declare const directorySyncStressProfileSchema: z.ZodType<DirectorySyncStressProfile>;
+export declare const directorySyncStressOperationSchema: z.ZodType<DirectorySyncStressOperation>;
+export declare const directorySyncStressPhaseSchema: z.ZodType<DirectorySyncStressPhase>;
+export declare const directorySyncStressPlanSchema: z.ZodType<DirectorySyncStressPlan>;
+export declare const stressBaselineSchema: z.ZodType<StressBaseline>;
+export declare const stressHealthSampleSchema: z.ZodType<StressHealthSample>;
+export declare const stressRuntimeSampleSchema: z.ZodType<StressRuntimeSample>;
+export declare const stressPhaseResultSchema: z.ZodType<StressPhaseResult>;
+export declare const stressCleanupResultSchema: z.ZodType<StressCleanupResult>;
+export declare const stressMetricsSchema: z.ZodType<StressMetrics>;
+export declare const directorySyncStressReportSchema: z.ZodType<DirectorySyncStressReport>;
+export interface DirectorySyncStressTarget {
+    handle: string;
+    domain: string;
+    contentRepo: string;
+    confirmation: string;
+}
+export interface DirectorySyncStressDriver {
+    prepare(plan: DirectorySyncStressPlan): Promise<StressBaseline>;
+    startMonitoring(): Promise<void>;
+    executePhase(phase: DirectorySyncStressPhase, baseline: StressBaseline): Promise<StressPhaseResult>;
+    cleanup(baseline: StressBaseline): Promise<StressCleanupResult>;
+    stopMonitoring(): Promise<StressMetrics>;
+}
+export declare function resolveDirectorySyncStressPlan(profile: DirectorySyncStressProfile): DirectorySyncStressPlan;
+export declare function assertDirectorySyncStressTarget(target: DirectorySyncStressTarget): void;
+export interface SampleStressHealthOptions {
+    fetchImpl?: FetchLike;
+    now?: () => Date;
+    timeoutMs?: number;
+}
+export declare function sampleStressHealth(url: string, options?: SampleStressHealthOptions): Promise<StressHealthSample>;
+export declare function runDirectorySyncStressPlan(plan: DirectorySyncStressPlan, driver: DirectorySyncStressDriver): Promise<DirectorySyncStressReport>;
+export declare function stressMetricsFailure(metrics: StressMetrics): string | undefined;

package/dist/index.d.ts

@@ -14,5 +14,7 @@ export { bootstrapPilotOriginCertificate, runPilotCertBootstrap, } from "./cert-
 export { encryptPilotSecrets } from "./secrets-encrypt";
 export { pushPilotSecrets } from "./secrets-push";
 export { verifyPilotUser } from "./verify-user";
+export { assertDirectorySyncStressTarget, directorySyncStressPlanSchema, directorySyncStressProfileSchema, directorySyncStressReportSchema, resolveDirectorySyncStressPlan, runDirectorySyncStressPlan, sampleStressHealth, stressMetricsFailure, type DirectorySyncStressDriver, type DirectorySyncStressPhase, type DirectorySyncStressPlan, type DirectorySyncStressProfile, type DirectorySyncStressReport, } from "./directory-sync-stress";
+export { cleanupDirectorySyncStress, runDeployedDirectorySyncStress, type CleanupDirectorySyncStressOptions, type CleanupDirectorySyncStressResult, type DeployedDirectorySyncStressOptions, type DeployedDirectorySyncStressResult, } from "./directory-sync-stress-system";
 export { runCommand, type CommandResult } from "./run-command";
 export { pilotSchema, cohortSchema, canonicalBundleIdSchema, type PilotConfig, type CohortConfig, } from "./schema";