@wairon/cli 5.1.1-dev.16 → 5.1.1-dev.17

package/dist/cli/index.js

@@ -65,7 +65,7 @@ var init_defaults = __esm({
       copilot: ".github/prompts",
       codex: ".codex/agents"
     };
-    WAIRON_VERSION = "5.1.1-dev.16";
+    WAIRON_VERSION = "5.1.1-dev.17";
     GITHUB_REPO = "SYW-Apps/Waffle-AIron";
     SUPPORTED_ALIASES = ["wai"];
     SCAN_EXCLUDE_DIRS = /* @__PURE__ */ new Set([
@@ -382,10 +382,10 @@ ${GUIDE_MARKER_END}
   fs4.writeFileSync(filePath, newContent, "utf-8");
 }
 function stripGuideSection(content) {
-  const start = content.indexOf(GUIDE_MARKER_START);
+  const start2 = content.indexOf(GUIDE_MARKER_START);
   const end = content.indexOf(GUIDE_MARKER_END);
-  if (start === -1 || end === -1) return content;
-  return content.slice(0, start) + content.slice(end + GUIDE_MARKER_END.length);
+  if (start2 === -1 || end === -1) return content;
+  return content.slice(0, start2) + content.slice(end + GUIDE_MARKER_END.length);
 }
 function writeRootGuideDelegator(projectRoot2, targetType) {
   if (targetType === "claude") {
@@ -1118,7 +1118,7 @@ function defaultNarrativeDetail(component) {
   if (componentType === "Portal" || componentType === "Observer" || componentType === "Adapter") {
     return "calls-only";
   }
-  if (componentType === "Store" || componentType === "Index" || componentType === "Registry") {
+  if (componentType === "Store" || componentType === "Index" || componentType === "Query" || componentType === "Registry") {
     return "intent";
   }
   return "full";
@@ -1151,7 +1151,7 @@ function implementationSourceFiles(impl) {
   for (const method2 of impl.methods ?? []) add(method2.sourcePath);
   return files;
 }
-var import_zod7, SpecIdSchema, SpecStatusSchema, BoundaryItemSchema, RequirementItemSchema, DatabaseSpecSchema, DiagramConfigSchema, SURFACE_AUDIENCES, SurfaceAudienceSchema, SystemPublicInterfaceSchema, SystemSpecSchema, PublicInterfaceTypeSchema, PublicInterfaceSchema, TrustedLinkSchema, LintAllowSchema, LintConfigSchema, ExtDataSchema, LifecycleEntrypointSchema, SubsystemSpecSchema, ComponentTypeSchema, PATTERN_TYPES, PortalTypeSchema, DispatchBindingSchema, DurabilitySchema, PatternRefSchema, EventBindingSchema, ExternalLinkTypeSchema, ExternalLinkSchema, PortalAuthSchemeSchema, PortalAuthSchema, ComponentSpecSchema, HttpMethodSchema, TransportSchema, EndpointSchema, SEMANTIC_GUARANTEES, GuaranteeSchema, MethodParamSchema, FindingDeclarationSchema, MethodSignatureSchema, INTENT_FLOOR_MIN_CHARS, InterfaceSpecSchema, NarrativeStepTypeSchema, LoopKindSchema, SwitchCaseSchema, CatchClauseSchema, ParallelBranchSchema, NarrativeStepSchema, NarrativeDetailSchema, ConformanceTierSchema, MethodImplementationSchema, ImplementationSpecSchema, TypeKindSchema, TypeFieldSchema, TypeMethodSchema, InvariantSchema, TypeSpecSchema, SurfaceOriginSchema, SurfaceTypeDefSchema, SurfaceContractEntrySchema, SurfaceSnapshotSchema, NamedOpenApiSpecSchema, GroupSpecSchema;
+var import_zod7, SpecIdSchema, SpecStatusSchema, BoundaryItemSchema, RequirementItemSchema, DatabaseSpecSchema, DiagramConfigSchema, SURFACE_AUDIENCES, SurfaceAudienceSchema, SystemPublicInterfaceSchema, SystemSpecSchema, PublicInterfaceTypeSchema, PublicInterfaceSchema, TrustedLinkSchema, LintAllowSchema, LintConfigSchema, ExtDataSchema, LifecycleEntrypointSchema, SubsystemSpecSchema, ComponentTypeSchema, PATTERN_TYPES, PortalTypeSchema, DispatchBindingSchema, DurabilitySchema, DependencyClassSchema, PatternRefSchema, EventBindingSchema, ExternalLinkTypeSchema, ExternalLinkSchema, PortalAuthSchemeSchema, PortalAuthSchema, ComponentSpecSchema, HttpMethodSchema, TransportSchema, EndpointSchema, SEMANTIC_GUARANTEES, GuaranteeSchema, MethodParamSchema, FindingDeclarationSchema, MethodSignatureSchema, INTENT_FLOOR_MIN_CHARS, InterfaceSpecSchema, NarrativeStepTypeSchema, LoopKindSchema, SwitchCaseSchema, CatchClauseSchema, ParallelBranchSchema, NarrativeStepSchema, NarrativeDetailSchema, ConformanceTierSchema, MethodImplementationSchema, ImplementationSpecSchema, TypeKindSchema, TypeFieldSchema, TypeMethodSchema, InvariantSchema, TypeSpecSchema, SurfaceOriginSchema, SurfaceTypeDefSchema, SurfaceContractEntrySchema, SurfaceSnapshotSchema, NamedOpenApiSpecSchema, GroupSpecSchema;
 var init_specs = __esm({
   "src/models/specs.ts"() {
     "use strict";
@@ -1317,21 +1317,27 @@ var init_specs = __esm({
       "Actor",
       "Store",
       "Index",
+      "Query",
+      // Repository member for computed reads over its Store
       "Registry",
       "Adapter",
       "Observer",
-      "Specialist",
       "View",
       // Pure presenter/UI component
       // Patterns (compositions of blocks)
       "Repository",
-      "Gateway",
       "FeatureComponent",
       // Logic Hook + View Presenter pattern
-      "RouterComponent"
+      "RouterComponent",
       // Switch/routing component pattern
+      // Retired stereotypes: still parsed so a tree using them loads and the
+      // rules can report them (STEREOTYPE_RETIRED), never authored new
+      "Specialist",
+      // logic is an Orchestrator with a dependencyClass
+      "Gateway"
+      // a gateway is a Portal with the gateway variant
     ]);
-    PATTERN_TYPES = /* @__PURE__ */ new Set(["Repository", "Gateway", "FeatureComponent", "RouterComponent"]);
+    PATTERN_TYPES = /* @__PURE__ */ new Set(["Repository", "FeatureComponent", "RouterComponent"]);
     PortalTypeSchema = import_zod7.z.enum(["HTTP_API", "gRPC", "GraphQL", "MessageBus", "CLI", "NamedPipe", "IPC", "Custom"]);
     DispatchBindingSchema = import_zod7.z.object({
       /** Capability name exactly as dispatched at runtime (e.g. "shadow_module.get"). */
@@ -1344,6 +1350,7 @@ var init_specs = __esm({
       description: import_zod7.z.string().optional()
     });
     DurabilitySchema = import_zod7.z.enum(["ram-projection", "durable", "read-through", "cache"]);
+    DependencyClassSchema = import_zod7.z.enum(["pure", "read"]);
     PatternRefSchema = import_zod7.z.object({
       id: import_zod7.z.string(),
       version: import_zod7.z.string().optional()
@@ -1398,6 +1405,8 @@ var init_specs = __esm({
       dispatch: import_zod7.z.array(DispatchBindingSchema).optional(),
       /** Store-only: whether held state survives restart (see DurabilitySchema). */
       durability: DurabilitySchema.optional(),
+      /** Orchestrator-only: what the logic may depend on; unset means a workflow (see DependencyClassSchema). */
+      dependencyClass: DependencyClassSchema.optional(),
       /** Topics this component publishes to (see EventBindingSchema). */
       emits: import_zod7.z.array(EventBindingSchema).optional(),
       /** Topics this component consumes (see EventBindingSchema) — typical on Observers. */
@@ -1488,9 +1497,10 @@ var init_specs = __esm({
       }).optional(),
       /**
        * The finding codes this method can report, each with its default severity
-       * and summary (see FindingDeclarationSchema). Each declared code must appear
-       * as a string literal in the method's source file (UNREALIZED_FINDING). A
-       * code is declared once per method.
+       * and summary (see FindingDeclarationSchema). Each declared code must be
+       * anchored in the method's source file as a string literal or a
+       * property-access name (UNREALIZED_FINDING). A code is declared once per
+       * method.
        */
       findings: import_zod7.z.array(FindingDeclarationSchema).superRefine((findings, ctx) => {
         const seen = /* @__PURE__ */ new Set();
@@ -6493,9 +6503,9 @@ var init_integration_conformance = __esm({
           if (impl.simPath) adopted.add(comp.subsystem);
         }
         const isTechBoundary = (compId) => (implsByComponent.get(compId) ?? []).some((i) => (i.technologies ?? []).length > 0);
-        const reachFrom = (start) => {
-          const seen = /* @__PURE__ */ new Set([start]);
-          const stack = [start];
+        const reachFrom = (start2) => {
+          const seen = /* @__PURE__ */ new Set([start2]);
+          const stack = [start2];
           while (stack.length) {
             const from = stack.pop();
             const facts = factsByPath.get(from);
@@ -8878,14 +8888,14 @@ function buildExcalidrawScene(model, L) {
     const src = rectById[edge.from], tgt = rectById[edge.to];
     if (!a || !b || !src || !tgt) return;
     const leftToRight = b.x >= a.x + a.w;
-    const start = leftToRight ? { x: a.x + a.w, y: a.y + a.h / 2 } : { x: a.x, y: a.y + a.h / 2 };
+    const start2 = leftToRight ? { x: a.x + a.w, y: a.y + a.h / 2 } : { x: a.x, y: a.y + a.h / 2 };
     const end = leftToRight ? { x: b.x, y: b.y + b.h / 2 } : { x: b.x + b.w, y: b.y + b.h / 2 };
     const id = "edge-" + edgeN++;
-    const arrow = base(id, "arrow", { x: start.x, y: start.y, w: Math.abs(end.x - start.x), h: Math.abs(end.y - start.y) });
+    const arrow = base(id, "arrow", { x: start2.x, y: start2.y, w: Math.abs(end.x - start2.x), h: Math.abs(end.y - start2.y) });
     arrow.roundness = { type: 2 };
     arrow.strokeColor = edge.cross ? "#c26767" : "#8d97a5";
     arrow.strokeWidth = edge.cross ? 2 : 1;
-    arrow.points = [[0, 0], [end.x - start.x, end.y - start.y]];
+    arrow.points = [[0, 0], [end.x - start2.x, end.y - start2.y]];
     arrow.lastCommittedPoint = null;
     arrow.startBinding = { elementId: src.id, focus: 0, gap: 4 };
     arrow.endBinding = { elementId: tgt.id, focus: 0, gap: 4 };
@@ -14556,28 +14566,52 @@ var init_domains = __esm({
 function globalVariantsDir() {
   return process.env.WAIRON_VARIANTS_DIR ?? path16.join(os5.homedir(), ".wairon", "variants");
 }
-function readVariantsDir(dir) {
+function builtinVariantsDir() {
+  const candidates = [
+    path16.resolve(__dirname, "..", "templates", "variants"),
+    // src/core & dist/cli
+    path16.resolve(__dirname, "templates", "variants")
+    // dist (library entry)
+  ];
+  return candidates.find((dir) => fs12.existsSync(dir)) ?? candidates[0];
+}
+function projectVariantsDir() {
+  return path16.join(getProjectRoot(), ".wai", "variants");
+}
+function variantFiles(dir) {
   let entries;
   try {
     entries = fs12.readdirSync(dir, { withFileTypes: true });
   } catch {
     return [];
   }
+  return entries.filter((e) => e.isFile() && /\.ya?ml$/i.test(e.name)).sort((a, b) => a.name.localeCompare(b.name)).map((e) => path16.join(dir, e.name));
+}
+function parseVariants(raw) {
+  if (raw == null) return [];
+  return (Array.isArray(raw) ? raw : [raw]).map((item) => VariantDefSchema.parse(item));
+}
+function reportSkippedFile(file, err) {
+  console.error(`[variants] skipped "${file}": ${err instanceof Error ? err.message : String(err)}`);
+}
+function readVariantsDir(dir) {
   const out = [];
-  for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    if (!e.isFile() || !/\.ya?ml$/i.test(e.name)) continue;
-    const full = path16.join(dir, e.name);
+  for (const file of variantFiles(dir)) {
     try {
-      const raw = readYamlFile(full);
-      if (raw == null) continue;
-      const items = Array.isArray(raw) ? raw : [raw];
-      for (const item of items) out.push(VariantDefSchema.parse(item));
+      out.push(...parseVariants(readYamlFile(file)));
     } catch (err) {
-      console.error(`[variants] skipped "${full}": ${err instanceof Error ? err.message : String(err)}`);
+      reportSkippedFile(file, err);
     }
   }
   return out;
 }
+function mergeById(...layers) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const layer of layers) {
+    for (const v of layer) byId.set(v.id, v);
+  }
+  return [...byId.values()];
+}
 function resolveVariantGuidance(component, allComponents, variantsById) {
   if (!component.variant) return null;
   const def = variantsById.get(component.variant);
@@ -14611,10 +14645,11 @@ function composeVariantGuidance(comps, allComponents, variantsById) {
 }
 function loadProjectVariants() {
   try {
-    const byId = /* @__PURE__ */ new Map();
-    for (const v of readVariantsDir(globalVariantsDir())) byId.set(v.id, v);
-    for (const v of readVariantsDir(path16.join(getProjectRoot(), ".wai", "variants"))) byId.set(v.id, v);
-    return [...byId.values()];
+    return mergeById(
+      readVariantsDir(builtinVariantsDir()),
+      readVariantsDir(globalVariantsDir()),
+      readVariantsDir(projectVariantsDir())
+    );
   } catch {
     return [];
   }
@@ -14632,7 +14667,7 @@ var init_variants = __esm({
     VariantDefSchema = import_zod10.z.object({
       /** Variant id referenced by a component's `variant` (e.g. "publisher", "org/external-config-adapter"). */
       id: import_zod10.z.string().min(1),
-      /** The core stereotype this variant specializes — authoritative for generic semantics (Adapter, Specialist, …). */
+      /** The core stereotype this variant specializes — authoritative for generic semantics (Adapter, Orchestrator, …). */
       base: import_zod10.z.string().min(1),
       /** How to implement a component of this variant — the recipe the implementer follows and reuses across same-variant components. */
       guidance: import_zod10.z.string().min(1),
@@ -16417,10 +16452,10 @@ var require_node = __commonJS({
       0
     ]);
     var clim = new u8([16, 17, 18, 0, 8, 7, 9, 6, 10, 5, 11, 4, 12, 3, 13, 2, 14, 1, 15]);
-    var freb = function(eb, start) {
+    var freb = function(eb, start2) {
       var b = new u16(31);
       for (var i2 = 0; i2 < 31; ++i2) {
-        b[i2] = start += 1 << eb[i2 - 1];
+        b[i2] = start2 += 1 << eb[i2 - 1];
       }
       var r = new i32(b[30]);
       for (var i2 = 1; i2 < 30; ++i2) {
@@ -24815,7 +24850,7 @@ NOTICE:
     name: import_zod11.z.string().describe("Human-readable display name"),
     description: import_zod11.z.string().describe("Responsibility / internal architecture details"),
     subsystem: import_zod11.z.string().describe("The L1 subsystem ID this component belongs to"),
-    componentType: import_zod11.z.enum(["Portal", "Orchestrator", "Supervisor", "Actor", "Store", "Index", "Registry", "Adapter", "Observer", "Specialist", "Repository", "Gateway"]).describe("The building block, or pattern (Repository/Gateway)"),
+    componentType: import_zod11.z.enum(["Portal", "Orchestrator", "Supervisor", "Actor", "Store", "Index", "Query", "Registry", "Adapter", "Observer", "Repository"]).describe("The building block, or the pattern Repository. Specialist and Gateway are retired and cannot be authored: logic is an Orchestrator with a dependencyClass, a gateway is a Portal with the gateway variant"),
     owns: import_zod11.z.array(import_zod11.z.string()).optional().describe("Member block ids privately owned by this component (patterns only)"),
     dependsOn: import_zod11.z.array(import_zod11.z.string()).optional().describe("IDs of other components this collaborates with (facades or standalone blocks)"),
     portalType: import_zod11.z.enum(["HTTP_API", "gRPC", "GraphQL", "MessageBus", "CLI", "NamedPipe", "IPC", "Custom"]).optional().describe("Portal-only, and expected on every Portal. OMIT IT on any other componentType \u2014 passing it there is refused at the write (UNEXPECTED_PORTAL_FIELD), nothing is saved."),
@@ -24827,6 +24862,7 @@ NOTICE:
       description: import_zod11.z.string().optional()
     })).optional().describe("Portal-only: capability \u2192 component.method dispatch table for generic-handle portals. Gives the reachability walker real edges and is validated against target interfaces (UNSERVED_CAPABILITY)."),
     durability: import_zod11.z.enum(["ram-projection", "durable", "read-through", "cache"]).optional().describe("Store-only \u2014 OMIT IT on any other componentType, where it is refused at the write (DURABILITY_ON_NON_STORE) and nothing is saved. Every Store should declare one (MISSING_DURABILITY): durable = persisted RAM projection (hydration read-back from a lifecycle init entrypoint required \u2014 MISSING_HYDRATION); read-through = persisted with no RAM copy (every read is the read-back, hydration exempt); ram-projection = rebuilt not restored; cache = evictable loss-safe memo state."),
+    dependencyClass: import_zod11.z.enum(["pure", "read"]).optional().describe("Orchestrator-only \u2014 OMIT IT on any other componentType, where it is refused at the write (DEPENDENCY_CLASS_ON_NON_ORCHESTRATOR) and nothing is saved. Declares what logic may depend on, enforced as a Store's durability is (DEPENDENCY_CLASS_VIOLATION): pure = depends only on pure Orchestrators (a computation over the values it is handed, e.g. an arbiter or codec); read = also on read Orchestrators, Repositories, Indexes and Adapters, never calling their write methods; unset = a workflow."),
     emits: import_zod11.z.array(import_zod11.z.object({
       topic: import_zod11.z.string().describe("Topic/channel name exactly as used on the bus"),
       event: import_zod11.z.string().optional().describe("Optional event name within the topic (informational; pairing is by topic)"),
@@ -24844,10 +24880,10 @@ NOTICE:
     server,
     "sdd_add_component",
     {
-      description: `Add an L2 Component under a subsystem. componentType is a building block (Portal, Orchestrator, Supervisor, Actor, Store, Index, Registry, Adapter, Observer, Specialist) or a pattern (Repository, Gateway). Patterns set "owns" (their private member blocks); all components set "dependsOn" (collaborators \u2014 facades or standalone blocks). Held/persisted state (configs, permissions, sessions, caches): model the Repository recipe \u2014 a Store + Registry (write) + Index (read) owned by a Repository facade consumers depend on; a deliberately standalone Store is the sanctioned lightweight form (workflow-layer consumers + lint.allow on UNOWNED_STORE). Never hold state as fields inside an Orchestrator/Specialist because a Store link was refused. Re-running it on an existing id RE-AUTHORS it: the fields above are replaced (an omitted array is CLEARED), while lint.allow, a Portal's auth, variant, patterns and externalLinks are carried forward \u2014 edit those with sdd_update_spec.`,
+      description: `Add an L2 Component under a subsystem. componentType is a building block (Portal, Orchestrator, Supervisor, Actor, Store, Index, Query, Registry, Adapter, Observer) or the pattern Repository. Specialist and Gateway are retired (STEREOTYPE_RETIRED) and cannot be authored: logic is an Orchestrator with a dependencyClass (pure | read; unset = a workflow), and a gateway is a Portal with the gateway variant (set variant with sdd_update_spec). Patterns set "owns" (their private member blocks); all components set "dependsOn" (collaborators \u2014 facades or standalone blocks). Held/persisted state (configs, permissions, sessions, caches): model the Repository recipe \u2014 a Store + Registry (write) + Index (read), plus a Query for computed reads over the Store, owned by a Repository facade consumers depend on; a deliberately standalone Store is the sanctioned lightweight form (workflow-layer consumers + lint.allow on UNOWNED_STORE). Never hold state as fields inside an Orchestrator because a Store link was refused. Re-running it on an existing id RE-AUTHORS it: the fields above are replaced (an omitted array is CLEARED), while lint.allow, a Portal's auth, variant, patterns and externalLinks are carried forward \u2014 edit those with sdd_update_spec.`,
       inputSchema: componentInput
     },
-    ({ id, name, description, subsystem, componentType, owns, dependsOn, portalType, basePath, dispatch, durability, emits, subscribesTo, ext }) => {
+    ({ id, name, description, subsystem, componentType, owns, dependsOn, portalType, basePath, dispatch, durability, dependencyClass, emits, subscribesTo, ext }) => {
       try {
         const { loadSubsystemSpec: loadSubsystemSpec2, loadComponentSpec: loadComponentSpec2 } = requireSpecs();
         const sub = loadSubsystemSpec2(subsystem);
@@ -24865,6 +24901,7 @@ NOTICE:
           ...basePath ? { basePath } : {},
           ...dispatch ? { dispatch } : {},
           ...durability ? { durability } : {},
+          ...dependencyClass ? { dependencyClass } : {},
           ...emits ? { emits } : {},
           ...subscribesTo ? { subscribesTo } : {},
           ...ext ? { ext } : {},
@@ -24916,7 +24953,7 @@ NOTICE:
       code: import_zod11.z.string().describe("UPPER_SNAKE finding code, unique within the method; a pack's codes carry the pack prefix (<PACK>_<CODE>)"),
       severity: import_zod11.z.enum(["error", "warning"]).describe("Default severity, before project severity overrides and draft-context downgrades"),
       summary: import_zod11.z.string().describe("One line saying what the finding means")
-    })).optional().describe("The finding codes this method can report, each with its default severity and summary. Each declared code must appear as a string literal in the method's source file (UNREALIZED_FINDING). A code is declared once per method; sdd_update_spec upserts and deletes findings by code."),
+    })).optional().describe("The finding codes this method can report, each with its default severity and summary. Each declared code must be anchored in the method's source file, as a string literal or a property-access name (UNREALIZED_FINDING). A code is declared once per method; sdd_update_spec upserts and deletes findings by code."),
     ext: import_zod11.z.record(import_zod11.z.unknown()).optional().describe("Opaque pack/tool extension data for this method (namespaced keys) \u2014 preserved verbatim")
   };
   const interfaceMethodInputFields = Object.keys(interfaceMethodShape);
@@ -24932,7 +24969,7 @@ NOTICE:
     server,
     "sdd_define_interface",
     {
-      description: "Define an L3 Contract / Interface with method signatures for a component. Prefer supplying structured `params` per method \u2014 they are the authoritative source for type checking (the free-form signature string then becomes display-only and is never heuristically parsed). A method declares the finding codes it reports in `findings` ({code, severity, summary}); each code must appear as a string literal in the method's source file. Re-defining an existing id REPLACES the method list: a method left out of the input is REMOVED (and reported); spec-level lint/ext and each method's endpoint binding are carried forward.",
+      description: "Define an L3 Contract / Interface with method signatures for a component. Prefer supplying structured `params` per method \u2014 they are the authoritative source for type checking (the free-form signature string then becomes display-only and is never heuristically parsed). A method declares the finding codes it reports in `findings` ({code, severity, summary}); each code must be anchored in the method's source file, as a string literal or a property-access name (UNREALIZED_FINDING). Re-defining an existing id REPLACES the method list: a method left out of the input is REMOVED (and reported); spec-level lint/ext and each method's endpoint binding are carried forward.",
       inputSchema: interfaceInput
     },
     ({ id, name, description, component, methods }) => {
@@ -27566,14 +27603,14 @@ var http = __toESM(require("http"));
 var https = __toESM(require("https"));
 init_defaults();
 function downloadFile(url, dest) {
-  return new Promise((resolve31, reject) => {
+  return new Promise((resolve32, reject) => {
     const file = fs23.createWriteStream(dest);
     const get4 = url.startsWith("https://") ? https.get : http.get;
     get4(url, { headers: { "User-Agent": `wairon/${WAIRON_VERSION}` }, agent: false }, (res) => {
       if (res.statusCode === 301 || res.statusCode === 302) {
         file.close();
         res.destroy();
-        downloadFile(res.headers.location, dest).then(resolve31).catch(reject);
+        downloadFile(res.headers.location, dest).then(resolve32).catch(reject);
         return;
       }
       if (res.statusCode !== 200) {
@@ -27585,7 +27622,7 @@ function downloadFile(url, dest) {
       res.pipe(file);
       file.on("finish", () => {
         res.destroy();
-        file.close(() => resolve31());
+        file.close(() => resolve32());
       });
       file.on("error", (err) => {
         res.destroy();
@@ -27762,7 +27799,7 @@ function releaseChannelLabel(tag) {
   return version.slice(dash + 1).replace(/\.\d+$/, "") || "stable";
 }
 function fetchReleases(repo) {
-  return new Promise((resolve31, reject) => {
+  return new Promise((resolve32, reject) => {
     const url = `https://api.github.com/repos/${repo}/releases?per_page=100`;
     const options = {
       headers: {
@@ -27782,7 +27819,7 @@ function fetchReleases(repo) {
           return;
         }
         try {
-          resolve31(JSON.parse(data));
+          resolve32(JSON.parse(data));
         } catch {
           reject(new Error("Failed to parse GitHub API response"));
         }
@@ -27957,7 +27994,7 @@ async function filteredCheckbox(config) {
     32,
     Math.max(...items.map((i) => i.label.length))
   );
-  return new Promise((resolve31) => {
+  return new Promise((resolve32) => {
     const checked = /* @__PURE__ */ new Set();
     let cursor = 0;
     let filterIdx = 0;
@@ -28024,7 +28061,7 @@ async function filteredCheckbox(config) {
       );
       teardown();
       const result = items.filter((_, idx) => checked.has(idx)).map((i) => i.value);
-      resolve31(result);
+      resolve32(result);
     }
     function abort() {
       process.stdout.write("\n");
@@ -36181,7 +36218,7 @@ async function awaitApproval(cfg, credential, requestId, timeoutSeconds) {
   let current2 = req;
   while (current2.status === "pending" && Date.now() < deadline) {
     const remaining = deadline - Date.now();
-    await new Promise((resolve31) => setTimeout(resolve31, Math.min(AWAIT_POLL_INTERVAL_MS, remaining)));
+    await new Promise((resolve32) => setTimeout(resolve32, Math.min(AWAIT_POLL_INTERVAL_MS, remaining)));
     expirePendingApprovals(cfg.dataDir, (/* @__PURE__ */ new Date()).toISOString());
     current2 = getApprovalRequestById(cfg.dataDir, requestId) ?? current2;
   }
@@ -41431,6 +41468,52 @@ function serveSharedDownload(cfg, token, kind, req, res) {
   res.end(result.content);
 }
 
+// src/server/backup-schedule.ts
+var TICK_MS = 6e4;
+var timer;
+function sweep(config) {
+  try {
+    runPeriodicGitSync(config);
+  } catch (err) {
+    console.error("[git-sync] project sweep failed: " + (err instanceof Error ? err.message : String(err)));
+  }
+  try {
+    runPeriodicBackingSync(config);
+  } catch (err) {
+    console.error("[git-backing] backing sweep failed: " + (err instanceof Error ? err.message : String(err)));
+  }
+}
+function start(config) {
+  if (timer) clearInterval(timer);
+  timer = setInterval(() => sweep(config), TICK_MS);
+  timer.unref();
+}
+function stop() {
+  if (timer) {
+    clearInterval(timer);
+    timer = void 0;
+  }
+}
+
+// src/server/instance-bootstrap.ts
+var DEV_UNIT_ID = "local";
+function bootstrapInstance(cfg) {
+  ensureInstanceIdentity(cfg.dataDir);
+  if (cfg.devMode && !getOrganizationUnit(cfg.dataDir, DEV_UNIT_ID)) {
+    const system = { userId: "system", kind: "service", issuer: "local" };
+    createUnit(cfg.dataDir, {
+      id: DEV_UNIT_ID,
+      name: "Local Development",
+      kind: "team",
+      slug: DEV_UNIT_ID,
+      // a root unit's qualified id IS its slug
+      status: "active",
+      createdAt: "",
+      createdBy: system
+    });
+  }
+}
+
 // src/server/http.ts
 var MAX_BODY_BYTES = 8 * 1024 * 1024;
 var PayloadTooLargeError = class extends Error {
@@ -41855,23 +41938,6 @@ async function routeAdmin(cfg, req, res) {
     sendJson(res, 400, { error: err instanceof Error ? err.message : String(err) });
   }
 }
-var DEV_UNIT_ID = "local";
-function initHostInstance(cfg) {
-  ensureInstanceIdentity(cfg.dataDir);
-  if (cfg.devMode && !getOrganizationUnit(cfg.dataDir, DEV_UNIT_ID)) {
-    const system = { userId: "system", kind: "service", issuer: "local" };
-    createUnit(cfg.dataDir, {
-      id: DEV_UNIT_ID,
-      name: "Local Development",
-      kind: "team",
-      slug: DEV_UNIT_ID,
-      // a root unit's qualified id IS its slug
-      status: "active",
-      createdAt: "",
-      createdBy: system
-    });
-  }
-}
 function warnIfDataDirUnmigrated(cfg) {
   try {
     const report2 = migratePermissionModel(cfg.dataDir, false);
@@ -41906,7 +41972,7 @@ function startHostServer(cfg) {
       );
     }
   }
-  initHostInstance(cfg);
+  bootstrapInstance(cfg);
   warnIfDataDirUnmigrated(cfg);
   const dataServer = http2.createServer((req, res) => routeData(cfg, req, res));
   const adminServer = http2.createServer((req, res) => {
@@ -41917,23 +41983,10 @@ function startHostServer(cfg) {
   });
   dataServer.listen(cfg.port, cfg.host);
   adminServer.listen(cfg.adminPort, cfg.adminHost);
-  const GIT_SYNC_TICK_MS = 6e4;
-  const gitSyncTimer = setInterval(() => {
-    try {
-      runPeriodicGitSync(cfg);
-    } catch (err) {
-      console.error("[git-sync] project sweep failed: " + (err instanceof Error ? err.message : String(err)));
-    }
-    try {
-      runPeriodicBackingSync(cfg);
-    } catch (err) {
-      console.error("[git-backing] backing sweep failed: " + (err instanceof Error ? err.message : String(err)));
-    }
-  }, GIT_SYNC_TICK_MS);
-  gitSyncTimer.unref();
+  start(cfg);
   return {
     close() {
-      clearInterval(gitSyncTimer);
+      stop();
       getRealtimeHub().closeAll();
       dataServer.close();
       adminServer.close();
@@ -42494,11 +42547,11 @@ async function runServe(options = {}) {
   logger.info(`  data dir:    ${import_chalk17.default.gray(cfg.dataDir)}`);
   logger.blank();
   logger.info("Press Ctrl+C to stop.");
-  await new Promise((resolve31) => {
+  await new Promise((resolve32) => {
     const shutdown = () => {
       logger.info("Shutting down\u2026");
       handle.close();
-      resolve31();
+      resolve32();
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
@@ -42563,11 +42616,11 @@ async function runDev(options = {}) {
   logger.blank();
   logger.info("An agent edits specs; refresh the page to see the live graph. Press Ctrl+C to stop.");
   if (options.open) openBrowser(url);
-  await new Promise((resolve31) => {
+  await new Promise((resolve32) => {
     const shutdown = () => {
       logger.info("Shutting down\u2026");
       handle.close();
-      resolve31();
+      resolve32();
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);