@tablation/crew 0.83.0 → 0.84.0

package/dist/cli.js

@@ -34,6 +34,29 @@ function doctorBaseReport(r, base, health) {
   }
 }
 
+// src/periscopes.ts
+import { lookup } from "dns/promises";
+function periscopeRoutes(cfg) {
+  return cfg.routes.filter((r) => r.enabled && r.hostPeriscopes).map((r) => r.route);
+}
+function periscopeSummary(cfg) {
+  const routes = periscopeRoutes(cfg);
+  const limits = `max ${cfg.ship.maxPeriscopes}, idle ${cfg.ship.periscopeIdleMinutes} min`;
+  if (routes.length === 0) return `off (no enabled route sets hostPeriscopes: true; ${limits})`;
+  return `ON for ${routes.join(", ")} (host ${cfg.ship.previewHost ?? "NOT SET (ship.previewHost)"}, ${limits})`;
+}
+async function previewHostProblem(cfg, resolve6 = (h) => lookup(h)) {
+  if (periscopeRoutes(cfg).length === 0) return void 0;
+  const host = cfg.ship.previewHost;
+  if (!host) return "ship.previewHost is not set \u2014 a route hosts periscopes, so Passengers have no host to be sent to";
+  try {
+    await resolve6(host);
+  } catch {
+    return `ship.previewHost "${host}" does not resolve from this machine`;
+  }
+  return void 0;
+}
+
 // src/config.ts
 import { readFileSync as readFileSync8, existsSync as existsSync7 } from "fs";
 import { resolve, dirname as dirname3, isAbsolute, join as join9, basename as basename3 } from "path";
@@ -2034,6 +2057,8 @@ var ROLE_LABEL = {
 };
 var ConfigError = class extends Error {
 };
+var DEFAULT_MAX_PERISCOPES = 3;
+var DEFAULT_PERISCOPE_IDLE_MINUTES = 120;
 function parseCloneScheme(v) {
   if (v === void 0 || v === null || v === "") return void 0;
   if (v === "ssh" || v === "https") return v;
@@ -2065,7 +2090,10 @@ var SHIP_KEYS = /* @__PURE__ */ new Set([
   "relayHttpPort",
   "relayPublicDomain",
   "passengerImage",
-  "cloneScheme"
+  "cloneScheme",
+  "previewHost",
+  "maxPeriscopes",
+  "periscopeIdleMinutes"
 ]);
 var ROUTE_KEYS = /* @__PURE__ */ new Set([
   "route",
@@ -2088,6 +2116,7 @@ var ROUTE_KEYS = /* @__PURE__ */ new Set([
   "resolved",
   "promptSet",
   "hostPassengers",
+  "hostPeriscopes",
   "toolchain"
 ]);
 function parseWorktreeName(v, where, file) {
@@ -2399,6 +2428,14 @@ Create the first of those:
   if (!Number.isInteger(streamRetentionDays) || streamRetentionDays < 1) {
     missing.add(`ship.streamRetentionDays must be a positive integer (got "${shipRaw.streamRetentionDays}")`);
   }
+  const maxPeriscopes = shipRaw.maxPeriscopes === void 0 ? DEFAULT_MAX_PERISCOPES : Number(shipRaw.maxPeriscopes);
+  if (!Number.isInteger(maxPeriscopes) || maxPeriscopes < 1) {
+    missing.add(`ship.maxPeriscopes must be a positive integer (got "${shipRaw.maxPeriscopes}")`);
+  }
+  const periscopeIdleMinutes = shipRaw.periscopeIdleMinutes === void 0 ? DEFAULT_PERISCOPE_IDLE_MINUTES : Number(shipRaw.periscopeIdleMinutes);
+  if (!Number.isInteger(periscopeIdleMinutes) || periscopeIdleMinutes < 1) {
+    missing.add(`ship.periscopeIdleMinutes must be a positive integer (got "${shipRaw.periscopeIdleMinutes}")`);
+  }
   const eventsRotateBytes = shipRaw.eventsRotateBytes === void 0 ? DEFAULT_EVENTS_ROTATE_BYTES : Number(shipRaw.eventsRotateBytes);
   if (!Number.isInteger(eventsRotateBytes) || eventsRotateBytes < 1) {
     missing.add(`ship.eventsRotateBytes must be a positive integer (got "${shipRaw.eventsRotateBytes}")`);
@@ -2468,7 +2505,10 @@ Create the first of those:
       relayHttpPort: shipRaw.relayHttpPort !== void 0 ? Number(shipRaw.relayHttpPort) : 443,
       relayPublicDomain: shipRaw.relayPublicDomain ? String(shipRaw.relayPublicDomain) : void 0,
       passengerImage: shipRaw.passengerImage ? String(shipRaw.passengerImage) : void 0,
-      cloneScheme: parseCloneScheme(shipRaw.cloneScheme)
+      cloneScheme: parseCloneScheme(shipRaw.cloneScheme),
+      previewHost: shipRaw.previewHost ? String(shipRaw.previewHost).trim() || void 0 : void 0,
+      maxPeriscopes,
+      periscopeIdleMinutes
     },
     routes,
     crewHome,
@@ -2569,6 +2609,9 @@ function parseOneRoute(c, where, file, base, stateDir, raw, missing, crewHome, t
     missing.add(`${where}.toolchain "${toolchain}" is not defined in ship.toolchains (have: ${[...toolchainNames].join(", ")})`);
   }
   const route = missing.req(c?.route, `${where}.route`);
+  if (c?.hostPeriscopes === true && c?.hostPassengers !== true) {
+    missing.add(`${where} (route "${route}") sets hostPeriscopes: true without hostPassengers: true \u2014 a Passenger must be able to board before they can open a periscope`);
+  }
   const routeParts = route ? route.split("/") : [];
   const routeWellFormed = routeParts.length === 2 && routeParts.every(Boolean);
   if (route && !routeWellFormed) {
@@ -2643,7 +2686,8 @@ function parseOneRoute(c, where, file, base, stateDir, raw, missing, crewHome, t
     },
     release: parseReleaseOverride(c?.release, where, file),
     branch: parseBranchOverride(c?.branch, where, file),
-    hostPassengers: c?.hostPassengers === true
+    hostPassengers: c?.hostPassengers === true,
+    hostPeriscopes: c?.hostPeriscopes === true
   };
   const resolvedFile = routeWellFormed ? readResolvedFile(stateDir, route) : void 0;
   result.resolved = parseResolved(resolvedFile ?? c?.resolved, missing, where);
@@ -7762,7 +7806,7 @@ function skillMarkerNames(text) {
   }
   return names;
 }
-function expandSkillMarkers(text, lookup, opts = {}) {
+function expandSkillMarkers(text, lookup2, opts = {}) {
   const maxDepth = opts.maxDepth ?? MAX_INCLUDE_DEPTH;
   const maxBytes = opts.maxBytes ?? MAX_INCLUDED_BYTES;
   const warnings = [];
@@ -7778,7 +7822,7 @@ function expandSkillMarkers(text, lookup, opts = {}) {
       warnings.push(`skill include "${name}" left literal: nested deeper than ${maxDepth} levels`);
       return literal;
     }
-    const body = lookup(name);
+    const body = lookup2(name);
     if (body === void 0) throw new SkillIncludeError(`no skill named "${name}" for the include ${literal}`);
     const trimmed = body.replace(/^\n+/, "").replace(/\n+$/, "");
     const bytes = Buffer.byteLength(trimmed, "utf8");
@@ -20385,6 +20429,7 @@ Signed in as ${result.identity.email} \u2014 minted an API key in workspace "${r
         platform: cfg.ship.platform,
         machineId,
         hostPassengers: firstRun?.answers.hostPassengers ?? existingRoute?.hostPassengers === true,
+        hostPeriscopes: existingRoute?.hostPeriscopes === true,
         sshPublicKey,
         lastSyncedName: (r) => readSyncedName(resolvedPathFor(cfg.ship.stateDir, r))
       };
@@ -21848,6 +21893,7 @@ ${owed.map((l) => `  ${l}
         `ship:       ${cfg.ship.name} (${cfg.ship.platform})
 route:      ${route.route} -> ${route.dir}
 enabled:    ${route.enabled}
+periscopes: ${periscopeSummary(cfg)}
 crew:       ${state.isPaused() ? "paused" : "active"}
 release:    ${state.releaseSkipReason() ? "paused" : "active"}
 watermark:  ${state.watermark()}
@@ -21965,6 +22011,8 @@ watermark:  ${state.watermark()}
           }
         }
         for (const message of roleCapWarnings(cfg.ship)) problems.push({ severity: "note", kind: "role_cap_above_ship_cap", message });
+        const previewProblem2 = await previewHostProblem(cfg);
+        if (previewProblem2) problems.push({ severity: "blocker", kind: "preview_host", message: previewProblem2 });
         problems.push(...attentionProblems(openShipAttention(state), problems));
         if (problems.some((p) => p.severity === "blocker")) process.exitCode = 1;
         process.stdout.write(`${JSON.stringify({ offline: flag("offline"), pushAuth, tools: toolRows, problems, passed }, null, 2)}
@@ -21978,6 +22026,14 @@ routes:            ${cfg.routes.map((c) => c.route).join(", ")}
       );
       for (const w of roleCapWarnings(cfg.ship)) process.stdout.write(`role concurrency: WARN ${w}
 `);
+      process.stdout.write(`periscopes:        ${periscopeSummary(cfg)}
+`);
+      const previewProblem = await previewHostProblem(cfg);
+      if (previewProblem) {
+        process.stdout.write(`                   BLOCKER ${previewProblem}
+`);
+        process.exitCode = 1;
+      }
       try {
         const evFile = eventFileFor(cfg.ship.stateDir);
         const evSize = existsSync35(evFile) ? statSync10(evFile).size : 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tablation/crew",
-  "version": "0.83.0",
+  "version": "0.84.0",
   "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
   "type": "module",
   "license": "MIT",