@rizom/ops 0.2.0-alpha.2 → 0.2.0-alpha.200

package/dist/load-registry.d.ts

@@ -13,6 +13,35 @@ export interface ResolvedCohort {
     brainVersionOverride?: string;
     presetOverride?: PilotPreset;
     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 ResolvedAtprotoConfig {
+    identifier: string;
+}
+export interface ResolvedPlaybooksConfig {
+    onboarding?: boolean | undefined;
+}
+export interface ResolvedSiteOverride {
+    package: string;
+    version: string;
+    theme?: string | undefined;
 }
 export interface ResolvedUserIdentity {
     handle: string;
@@ -21,9 +50,18 @@ export interface ResolvedUserIdentity {
     model: "rover";
     preset: PilotPreset;
     domain: string;
+    cloudflareZoneId?: string | undefined;
     contentRepo: string;
+    addOverride?: string[];
+    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 +78,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

@@ -5,6 +5,10 @@ export interface ParsedArgs {
         help?: boolean | undefined;
         version?: boolean | undefined;
         dryRun?: boolean | undefined;
+        pushTo?: string | undefined;
+        cohort?: string | undefined;
+        anchorId?: string | undefined;
+        handle?: string | undefined;
     };
 }
 export declare function parseArgs(argv: string[]): ParsedArgs;

package/dist/push-secrets.d.ts

@@ -0,0 +1,2 @@
+export { 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-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,6 +1,9 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
 import type { LoadPilotRegistryOptions } from "./load-registry";
+import { type LookupHost } from "./observed-status";
 import type { ParsedArgs } from "./parse-args";
-import { type RunCommand as SecretRunCommand } from "./secrets-push";
+import { type RunCommand as OpsRunCommand } from "./run-subprocess";
+import { type SshKeygen } from "./ssh-key-bootstrap";
 import type { UserRunner } from "./user-runner";
 export interface CommandResult {
     success: boolean;
@@ -10,6 +13,9 @@ 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;
+    bootstrapRunCommand?: OpsRunCommand | undefined;
+    sshKeygen?: SshKeygen | undefined;
 }
 export declare function runCommand(parsed: ParsedArgs, 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,8 +1,13 @@
-import { z } from "@brains/utils";
-export declare const presetSchema: z.ZodEnum<["core", "default", "pro"]>;
+import { z } from "@brains/utils/zod";
+export declare const presetSchema: z.ZodEnum<{
+    core: "core";
+    default: "default";
+    pro: "pro";
+}>;
 export declare const exactVersionSchema: z.ZodString;
 export declare const handleSchema: z.ZodString;
 export declare const secretNameSchema: z.ZodString;
+export declare const agePublicKeySchema: z.ZodString;
 export declare const pilotSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
     brainVersion: z.ZodString;
@@ -10,77 +15,76 @@ export declare const pilotSchema: z.ZodObject<{
     githubOrg: z.ZodString;
     contentRepoPrefix: z.ZodString;
     domainSuffix: z.ZodString;
-    preset: z.ZodEnum<["core", "default", "pro"]>;
+    preset: typeof presetSchema;
     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;
-    brainVersion: string;
-    model: "rover";
-    githubOrg: string;
-    contentRepoPrefix: string;
-    domainSuffix: string;
-    preset: "core" | "default" | "pro";
-    aiApiKey: string;
+    gitSyncToken: z.ZodString;
+    contentRepoAdminToken: z.ZodString;
+    agePublicKey: z.ZodString;
+}>;
+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 atprotoSchema: z.ZodObject<{
+    identifier: z.ZodString;
+}>;
+declare const siteOverrideSchema: z.ZodObject<{
+    package: z.ZodString;
+    version: typeof exactVersionSchema;
+    theme: z.ZodOptional<z.ZodString>;
+}>;
+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;
+    gitSyncTokenOverride: z.ZodOptional<z.ZodString>;
+    domainOverride: z.ZodOptional<z.ZodString>;
+    cloudflareZoneId: z.ZodOptional<z.ZodString>;
+    contentRepoOverride: z.ZodOptional<z.ZodString>;
+    addOverride: 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 declare const cohortSchema: z.ZodEffects<z.ZodObject<{
-    members: z.ZodArray<z.ZodString, "many">;
+export declare const cohortSchema: z.ZodObject<{
+    members: z.ZodArray<z.ZodString>;
     brainVersionOverride: z.ZodOptional<z.ZodString>;
-    presetOverride: z.ZodOptional<z.ZodEnum<["core", "default", "pro"]>>;
+    presetOverride: z.ZodOptional<typeof presetSchema>;
     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>;
 }>;
-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 PilotConfig = z.output<typeof pilotSchema>;
+export type PilotConfigInput = z.input<typeof pilotSchema>;
+export type UserConfig = z.output<typeof userSchema>;
+export type UserConfigInput = z.input<typeof userSchema>;
+export type CohortConfig = z.output<typeof cohortSchema>;
+export type CohortConfigInput = z.input<typeof cohortSchema>;
+export type PilotPreset = z.output<typeof presetSchema>;
+export {};

package/dist/secrets-encrypt.d.ts

@@ -0,0 +1,24 @@
+import { z } from "@brains/utils/zod";
+declare const encryptedUserSecretsSchema: z.ZodObject<{
+    gitSyncToken: z.ZodOptional<z.ZodString>;
+    discordBotToken: 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/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>;

package/dist/verify-user.d.ts

@@ -0,0 +1,19 @@
+import type { FetchLike } from "@brains/deploy-support/origin-ca";
+import { type ResolvedUser } from "./load-registry";
+export interface VerifyPilotUserOptions {
+    fetchImpl?: FetchLike;
+    logger?: (message: string) => void;
+}
+export interface FailedCheck {
+    name: string;
+    message: string;
+}
+export interface VerifyPilotUserResult {
+    handle: string;
+    preset: ResolvedUser["preset"];
+    domain: string;
+    contentRepo: string;
+    checks: string[];
+    failedChecks: FailedCheck[];
+}
+export declare function verifyPilotUser(rootDir: string, handle: string, options?: VerifyPilotUserOptions): Promise<VerifyPilotUserResult>;

package/package.json

@@ -1,65 +1,69 @@
 {
   "name": "@rizom/ops",
+  "version": "0.2.0-alpha.200",
   "description": "Operator CLI for managing private brain fleet registry repos",
-  "publishConfig": {
-    "access": "public"
+  "keywords": [
+    "brains",
+    "ops",
+    "cli",
+    "deploy",
+    "fleet",
+    "operator"
+  ],
+  "license": "Apache-2.0",
+  "author": "Yeehaa <yeehaa@rizom.ai> (https://rizom.ai)",
+  "bin": {
+    "brains-ops": "./dist/brains-ops.js"
+  },
+  "bugs": "https://github.com/rizom-ai/brains/issues",
+  "dependencies": {
+    "age-encryption": "^0.3.0"
+  },
+  "devDependencies": {
+    "@brains/deploy-support": "workspace:*",
+    "@brains/eslint-config": "workspace:*",
+    "@brains/typescript-config": "workspace:*",
+    "@brains/utils": "workspace:*",
+    "@types/bun": "^1.3.14",
+    "typescript": "^7.0.2"
+  },
+  "engines": {
+    "bun": ">=1.3.3"
   },
-  "version": "0.2.0-alpha.2",
-  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./deploy": {
-      "bun": "./dist/deploy.js",
       "types": "./dist/deploy.d.ts",
-      "import": "./dist/deploy.js"
+      "import": "./dist/deploy.js",
+      "bun": "./dist/deploy.js"
     }
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "brains-ops": "./dist/brains-ops.js"
-  },
   "files": [
     "dist",
     "templates"
   ],
-  "scripts": {
-    "build": "bun scripts/build.ts",
-    "prepublishOnly": "bun scripts/build.ts",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
-    "test": "bun test"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@brains/eslint-config": "workspace:*",
-    "@brains/typescript-config": "workspace:*",
-    "@brains/utils": "workspace:*",
-    "@types/bun": "latest",
-    "typescript": "^5.3.3"
+  "homepage": "https://github.com/rizom-ai/brains/tree/main/packages/brains-ops#readme",
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "access": "public"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/rizom-ai/brains.git",
     "directory": "packages/brains-ops"
   },
-  "license": "Apache-2.0",
-  "author": "Yeehaa <yeehaa@rizom.ai> (https://rizom.ai)",
-  "homepage": "https://github.com/rizom-ai/brains/tree/main/packages/brains-ops#readme",
-  "bugs": "https://github.com/rizom-ai/brains/issues",
-  "engines": {
-    "bun": ">=1.3.3"
+  "scripts": {
+    "build": "bun scripts/build.ts",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --max-warnings 0 --fix",
+    "prepublishOnly": "bun scripts/build.ts",
+    "test": "bun run build && bun test --timeout 20000",
+    "test:smoke": "bun run build && RUN_SMOKE_TESTS=1 bun test --timeout 60000",
+    "typecheck": "tsc --noEmit"
   },
-  "keywords": [
-    "brains",
-    "ops",
-    "cli",
-    "deploy",
-    "fleet",
-    "operator"
-  ]
+  "type": "module",
+  "types": "./dist/index.d.ts"
 }

package/templates/rover-pilot/.env.schema

@@ -4,21 +4,40 @@
 # ----------
 
 # AI provider
+# Shared GitHub secret by default; a per-user override may come from the decrypted
+# users/<handle>.secrets.yaml.age file at deploy time.
 # @required @sensitive
 AI_API_KEY=
 
 # Git sync
+# Comes from the decrypted users/<handle>.secrets.yaml.age file.
 # @required @sensitive
 GIT_SYNC_TOKEN=
 
-# MCP interface
+# Content repo administration
+# Local/operator secret only. Used by brains-ops to create missing GitHub repos;
+# do not deploy it into Rover runtime config.
 # @required @sensitive
-MCP_AUTH_TOKEN=
+CONTENT_REPO_ADMIN_TOKEN=
 
 # Discord (optional, per-user)
+# Comes from the decrypted users/<handle>.secrets.yaml.age file when enabled.
 # @sensitive
 DISCORD_BOT_TOKEN=
 
+# AT Protocol publishing/discovery (optional, per-user)
+# Comes from the decrypted users/<handle>.secrets.yaml.age file when configured.
+# @sensitive
+ATPROTO_APP_PASSWORD=
+
+# Setup email delivery (optional, shared)
+# Used when a user file declares setup.delivery: email.
+# @sensitive
+SETUP_EMAIL_API_KEY=
+
+# @sensitive
+SETUP_EMAIL_FROM=
+
 # ---- deploy/provision vars ----
 
 # @required @sensitive