@forgezero/agent 0.1.101 → 0.1.103

package/dist/agent-heartbeat.js

@@ -917,7 +917,7 @@ async function postSignedNode(options, path, body) {
 }
 
 // src/version.ts
-var VERSION3 = "0.1.101";
+var VERSION3 = "0.1.103";
 
 // src/agent-heartbeat.ts
 function readAgentHostMetrics() {

package/dist/bootstrap.d.ts

@@ -115,6 +115,10 @@ export interface PlatformBootstrapSecrets {
     backupS3Secret?: string;
     cloudflareTunnelToken?: string;
     cloudflareApiToken?: string;
+    githubClientSecret?: string;
+    /** One-line base64 form accepted by prompts/env; decoded before systemd sealing. */
+    githubPrivateKeyBase64?: string;
+    githubWebhookSecret?: string;
 }
 export interface EnrolledComputeBootstrapSecrets {
     enrolmentToken: string;
@@ -195,8 +199,8 @@ export declare const legacyBootstrapIdentityDigest: (config: BootstrapConfig) =>
 /**
  * Exact, reviewed identity migrations for an already-installed platform host.
  * This is deliberately not a generic "stored coordinates match" escape hatch:
- * only the development collector transition and the addition of reviewed
- * genesis attestation evidence are accepted.
+ * only the development collector transition, reviewed genesis evidence, and
+ * narrowly identified bootstrap-schema repairs are accepted.
  */
 export declare function approvedPlatformRepairIdentityDigests(config: PlatformBootstrapConfig): readonly string[];
 /** Exact prior-release identities accepted only while generation one is still unenrolled. */

package/dist/bootstrap.js

@@ -1386,7 +1386,7 @@ async function buildBootstrapBundle(input, exec = run) {
 }
 
 // src/bootstrap.ts
-import { createHash as createHash2, createHmac as createHmac2, randomBytes as randomBytes3 } from "crypto";
+import { createHash as createHash2, createHmac as createHmac2, createPrivateKey, randomBytes as randomBytes3 } from "crypto";
 import {
   chmodSync as chmodSync3,
   existsSync as existsSync5,
@@ -1420,7 +1420,7 @@ var UPDATE_RETRY_BASE_MS = 5 * 60000;
 var UPDATE_RETRY_MAX_MS = 24 * 60 * 60000;
 
 // src/version.ts
-var VERSION = "0.1.101";
+var VERSION = "0.1.103";
 
 // src/software.ts
 var PINNED_BUN_VERSION = "1.3.14";
@@ -3090,10 +3090,16 @@ var httpsOrigin = (name, raw) => {
 };
 var agentTelemetryOrigin = (raw) => raw === "http://127.0.0.1:4318" ? raw : httpsOrigin("agentOtlpEndpoint", raw);
 function validatePlatformInitialInventory(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).some((key) => !["metalHostname", "region", "computes", "attestation", "deployment"].includes(key)) || !/^[A-Za-z0-9][A-Za-z0-9.-]{1,252}$/.test(value.metalHostname) || !value.region || typeof value.region !== "object" || Array.isArray(value.region) || Object.keys(value.region).some((key) => !["key", "label", "country", "city", "confidentialCapable"].includes(key)) || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(value.region.key) || !/^[A-Z]{2}$/.test(value.region.country) || value.region.confidentialCapable !== true || !Array.isArray(value.computes)) {
+  if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).some((key) => !["metalHostname", "metalIdentity", "region", "computes", "attestation", "deployment"].includes(key)) || !/^[A-Za-z0-9][A-Za-z0-9.-]{1,252}$/.test(value.metalHostname) || !value.region || typeof value.region !== "object" || Array.isArray(value.region) || Object.keys(value.region).some((key) => !["key", "label", "country", "city", "confidentialCapable"].includes(key)) || !/^[a-z0-9][a-z0-9-]{0,62}$/.test(value.region.key) || !/^[A-Z]{2}$/.test(value.region.country) || value.region.confidentialCapable !== true || !Array.isArray(value.computes)) {
     throw new Error("initial platform inventory coordinates are invalid");
   }
   safeAtom("initialInventory.region.label", value.region.label);
+  if (value.metalIdentity !== undefined) {
+    const identity = value.metalIdentity;
+    if (!identity || typeof identity !== "object" || Array.isArray(identity) || Object.keys(identity).some((key) => !["nodeKey", "publicKeys"].includes(key)) || !/^[A-Za-z0-9_-]{43}$/.test(identity.nodeKey) || !identity.publicKeys || identity.publicKeys.ed25519 !== identity.nodeKey || !/^[A-Za-z0-9_-]{1,8192}$/.test(identity.publicKeys.mlDsa) || Object.keys(identity.publicKeys).some((key) => !["ed25519", "mlDsa"].includes(key))) {
+      throw new Error("initial platform Metal identity is invalid");
+    }
+  }
   if (value.region.city !== undefined)
     safeAtom("initialInventory.region.city", value.region.city);
   if (value.deployment !== undefined && (!value.deployment || typeof value.deployment !== "object" || Array.isArray(value.deployment) || Object.keys(value.deployment).some((key) => !["source", "branch", "revision", "bundleSha256"].includes(key)) || value.deployment.source !== "bootstrap-bundle" || !["dev", "main"].includes(value.deployment.branch) || !/^[a-f0-9]{40}$/.test(value.deployment.revision) || !/^[a-f0-9]{64}$/.test(value.deployment.bundleSha256)))
@@ -3128,6 +3134,7 @@ function validatePlatformInitialInventory(value) {
   }
   return {
     metalHostname: value.metalHostname,
+    ...value.metalIdentity ? { metalIdentity: structuredClone(value.metalIdentity) } : {},
     region: { ...value.region },
     computes: value.computes.map((compute, index) => ({
       ...computes[index],
@@ -3181,6 +3188,11 @@ function validatePlatformSharedEnvironment(input) {
   } else if (input.email !== undefined) {
     throw new Error("Bootstrap email provider must be smtp or jetemail.");
   }
+  if (input.githubApp) {
+    if (!/^(?:Iv1\.[A-Fa-f0-9]{16}|Ov23li[A-Za-z0-9]{14,})$/.test(input.githubApp.clientId) || !/^[1-9][0-9]{0,19}$/.test(input.githubApp.appId) || !/^[a-z0-9][a-z0-9-]{0,99}$/.test(input.githubApp.slug)) {
+      throw new Error("GitHub App client id, app id or slug is malformed.");
+    }
+  }
   boundedInteger("publicApiPort", input.publicApiPort, 1024, 65533);
   if (!Array.isArray(input.seedSyncMembers) || input.seedSyncMembers.length < 3 || input.seedSyncMembers.length > 64 || new Set(input.seedSyncMembers).size !== input.seedSyncMembers.length) {
     throw new Error("seedSyncMembers must contain 3 to 64 unique physical host identities.");
@@ -3311,6 +3323,9 @@ function renderPlatformSharedEnvironment(input) {
     FZ_REALTIME_WORKER_SCRIPT: value.realtime?.workerScriptName ?? "",
     FZ_REALTIME_ENDPOINT: value.realtime?.endpoint ?? "",
     FZ_REALTIME_PRODUCER: value.realtime?.producer ?? "",
+    FZ_GITHUB_CLIENT_ID: value.githubApp?.clientId ?? "",
+    FZ_GITHUB_APP_ID: value.githubApp?.appId ?? "",
+    FZ_GITHUB_APP_SLUG: value.githubApp?.slug ?? "",
     FZ_PLATFORM_INITIAL_INVENTORY: value.initialInventory ? JSON.stringify(value.initialInventory) : ""
   };
   return `# Generated by fz bootstrap platform. Non-secret coordinates only.
@@ -3322,6 +3337,9 @@ function platformApiCredentialSpecs(options) {
   const optional = [
     ["fz_smtp.password", options.emailProvider === "smtp"],
     ["fz_jetemail.apiKey", options.emailProvider === "jetemail"],
+    ["fz_github.clientSecret", options.githubApp],
+    ["fz_github.privateKey", options.githubApp],
+    ["fz_github.webhookSecret", options.githubApp],
     ["CF_API_TOKEN", options.cloudflareKv],
     ["CF_TUNNEL_TOKEN", options.cloudflareKv],
     ["REALTIME_PUBLISH_SECRET", options.realtime],
@@ -3717,7 +3735,17 @@ function validatePlatformBootstrapSecrets(config, input) {
   if (!input || typeof input !== "object" || Array.isArray(input))
     throw new Error("bootstrap credential input must be an object");
   const source = input;
-  const allowed = ["clusterBootstrapCode", "emailSecret", "enrolmentToken", "backupS3Secret", "cloudflareTunnelToken", "cloudflareApiToken"];
+  const allowed = [
+    "clusterBootstrapCode",
+    "emailSecret",
+    "enrolmentToken",
+    "backupS3Secret",
+    "cloudflareTunnelToken",
+    "cloudflareApiToken",
+    "githubClientSecret",
+    "githubPrivateKeyBase64",
+    "githubWebhookSecret"
+  ];
   const unknown = Object.keys(source).filter((key) => !allowed.includes(key));
   if (unknown.length)
     throw new Error(`bootstrap credential input contains unsupported field ${unknown[0]}`);
@@ -3727,6 +3755,9 @@ function validatePlatformBootstrapSecrets(config, input) {
   const backupS3Secret = typeof source.backupS3Secret === "string" ? source.backupS3Secret.trim() : undefined;
   const cloudflareTunnelToken = typeof source.cloudflareTunnelToken === "string" ? source.cloudflareTunnelToken.trim() : undefined;
   const cloudflareApiToken = typeof source.cloudflareApiToken === "string" ? source.cloudflareApiToken.trim() : undefined;
+  const githubClientSecret = typeof source.githubClientSecret === "string" ? source.githubClientSecret.trim() : undefined;
+  const githubPrivateKeyBase64 = typeof source.githubPrivateKeyBase64 === "string" ? source.githubPrivateKeyBase64.trim() : undefined;
+  const githubWebhookSecret = typeof source.githubWebhookSecret === "string" ? source.githubWebhookSecret.trim() : undefined;
   if (!/^[a-f0-9]{64}$/i.test(clusterBootstrapCode))
     throw new Error("cluster bootstrap code must contain exactly 64 hexadecimal characters");
   if (!emailSecret || emailSecret.length > 16384 || /[\r\n\0]/.test(emailSecret))
@@ -3746,12 +3777,29 @@ function validatePlatformBootstrapSecrets(config, input) {
   }
   if (cloudflareTunnelToken)
     validateCloudflareBootstrapSecretPair({ cloudflareTunnelToken, cloudflareApiToken });
+  const githubConfigured = Boolean(config.runtime.environment.githubApp);
+  if (githubConfigured !== Boolean(githubClientSecret && githubPrivateKeyBase64 && githubWebhookSecret)) {
+    throw new Error("GitHub App coordinates require client secret, private key and webhook secret together");
+  }
+  if (githubConfigured) {
+    if (githubClientSecret.length < 20 || githubClientSecret.length > 512 || /[\r\n\0]/.test(githubClientSecret) || githubWebhookSecret.length < 32 || githubWebhookSecret.length > 512 || /[\r\n\0]/.test(githubWebhookSecret)) {
+      throw new Error("GitHub App client or webhook secret is malformed");
+    }
+    try {
+      const pem = Buffer.from(githubPrivateKeyBase64, "base64").toString("utf8");
+      if (createPrivateKey(pem).asymmetricKeyType !== "rsa")
+        throw new Error("not RSA");
+    } catch {
+      throw new Error("GitHub App private key must be a base64-encoded RSA private key");
+    }
+  }
   return {
     clusterBootstrapCode,
     emailSecret,
     ...enrolmentToken ? { enrolmentToken } : {},
     ...backupS3Secret ? { backupS3Secret } : {},
-    ...cloudflareTunnelToken ? { cloudflareTunnelToken, cloudflareApiToken } : {}
+    ...cloudflareTunnelToken ? { cloudflareTunnelToken, cloudflareApiToken } : {},
+    ...githubConfigured ? { githubClientSecret, githubPrivateKeyBase64, githubWebhookSecret } : {}
   };
 }
 var platformBootstrapRunner = (config) => config.kind === "platform" && config.database.role === "master";
@@ -4303,6 +4351,17 @@ function approvedPlatformRepairIdentityDigests(config) {
     delete beforeAttestation.runtime.environment.initialInventory.attestation;
     prior.push(beforeAttestation);
   }
+  const metalIdentity = config.runtime.environment.initialInventory?.metalIdentity;
+  if (metalIdentity && config.enrolment.source === "genesis-derived") {
+    const beforeMetalIdentity = structuredClone(config);
+    delete beforeMetalIdentity.runtime.environment.initialInventory.metalIdentity;
+    prior.push(beforeMetalIdentity);
+  }
+  if (config.database.role === "joiner" && config.enrolment.source === "genesis-derived" && config.runtime.environment.custodianEmail) {
+    const beforeReplicaCustodianEmail = structuredClone(config);
+    delete beforeReplicaCustodianEmail.runtime.environment.custodianEmail;
+    prior.push(beforeReplicaCustodianEmail);
+  }
   const telemetryMigration = config.environment === "development" && config.telemetryEndpoint === LOCAL_DEBUG_OTEL_EXPORT && config.runtime.environment.agentOtlpEndpoint === "http://127.0.0.1:4318";
   if (telemetryMigration) {
     const beforeTelemetry = structuredClone(config);
@@ -4655,7 +4714,10 @@ async function applyBootstrap(input, host = localBootstrapHost(), secrets, depen
       enrolmentToken: checked4.enrolmentToken,
       backup: checked4.backupS3Secret,
       cloudflareTunnelToken: checked4.cloudflareTunnelToken,
-      cloudflareApiToken: checked4.cloudflareApiToken
+      cloudflareApiToken: checked4.cloudflareApiToken,
+      githubClientSecret: checked4.githubClientSecret,
+      githubPrivateKey: checked4.githubPrivateKeyBase64 ? Buffer.from(checked4.githubPrivateKeyBase64, "base64").toString("utf8") : undefined,
+      githubWebhookSecret: checked4.githubWebhookSecret
     };
   })() : undefined;
   const enrolledPrivate = config.kind === "enrolled-compute" ? validateEnrolledComputeBootstrapSecrets(config, secrets) : undefined;
@@ -4753,6 +4815,9 @@ async function applyBootstrap(input, host = localBootstrapHost(), secrets, depen
     const emailCredentialName = config.runtime.environment.email?.provider === "smtp" ? "fz_smtp.password" : config.runtime.environment.email?.provider === "jetemail" ? "fz_jetemail.apiKey" : undefined;
     for (const [name, source] of Object.entries({
       ...emailCredentialName ? { [emailCredentialName]: platformPrivate.email } : {},
+      "fz_github.clientSecret": platformPrivate.githubClientSecret,
+      "fz_github.privateKey": platformPrivate.githubPrivateKey,
+      "fz_github.webhookSecret": platformPrivate.githubWebhookSecret,
       "backup.s3.secretAccessKey": platformPrivate.backup
     })) {
       if (source) {
@@ -4769,6 +4834,7 @@ async function applyBootstrap(input, host = localBootstrapHost(), secrets, depen
     const credentials = platformApiCredentialSpecs({
       emailProvider: runtime.environment.email?.provider,
       cloudflareKv: cloudflareConfigured,
+      githubApp: Boolean(runtime.environment.githubApp),
       realtime: Boolean(runtime.environment.realtime)
     });
     const units = renderPlatformApiUnits({

package/dist/fz-agent.js

@@ -9496,7 +9496,7 @@ async function writeAndCloseProcessInput(input, value) {
 }
 
 // src/version.ts
-var VERSION2 = "0.1.101";
+var VERSION2 = "0.1.103";
 
 // src/ssh-bootstrap.ts
 class SshBootstrapError extends Error {