@intentius/chant-lexicon-fly 0.108.0 → 0.109.0

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "8f71bff123f2fccbba8eeee8d5c2d0f714ba05bb4331cef3d854446ca1f4ab44",
+    "manifest.json": "52b5947746f6de511466da05f6c850977890d2be72a890bc4eff35002acdeae0",
     "meta.json": "273f2a523b66f08ca91642dba2592c44765ab59ddf7329998884a0b08c6c3f24",
     "types/index.d.ts": "2f01714e1aa5f5695d68416e143f281584efb84457138c93825fea34e2f3fa0a",
     "rules/guest-sizing.ts": "bc749d218df8f3cc3d8fbe388205ae96e6b204ae0d6d77e8bf82cb936cc53ff6",
@@ -15,5 +15,5 @@
     "skills/chant-fly-ops.md": "44102f1fdf611b9262c04457258990e44026e83f9e5b19ae86b69322f3a37620",
     "skills/chant-fly-sprites.md": "3d100680422151b58d082c3a7b30a286edfc52faa4887995c9ad5553873bab95"
   },
-  "composite": "2fc9c462b6392223634f1904b610f3554cfa8dd1be6c4c1bfe2293bd615a10f2"
+  "composite": "7569d9ceb0231354bb9b0143f8386ca3f0100cada16c3768324ca7335d1036dd"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "fly",
-  "version": "0.108.0",
+  "version": "0.109.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Fly"
 }

package/dist/op/activities/box-services.d.ts

@@ -12,7 +12,7 @@
 /** One declared service, as the declaration states it (core's `BoxService`, less its pointer). */
 export interface BoxServiceDeclaration {
     name: string;
-    /** As written: `${VAR}` references are expanded by {@link expandServiceCommand}. */
+    /** As written: split into argv and `${VAR}`-expanded by {@link serviceCommandArgv}. */
     cmd: string;
     needs: string[];
     httpPort: number | null;
@@ -28,6 +28,16 @@ export declare function boxServices(cwd?: string): Promise<BoxServiceDeclaration
  * empty path in it. Pure.
  */
 export declare function expandServiceCommand(name: string, cmd: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * A service's command as the supervisor runs it: the executable and its
+ * arguments. The declared `cmd` is split on whitespace, with no quoting or
+ * other shell syntax (a command that needs it belongs in a script), and each
+ * word is then expanded by {@link expandServiceCommand}, so a variable whose
+ * value has a space stays one word. sprite-env takes the arguments as one
+ * comma-separated `--args`, so an argument with a comma in it is refused
+ * here rather than split there. Pure.
+ */
+export declare function serviceCommandArgv(name: string, cmd: string, env?: NodeJS.ProcessEnv): string[];
 /**
  * The services in an order each one's `needs` come before it, and in file
  * order otherwise. The list is one the declaration reader accepted, so every

package/dist/op/activities/box-services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"box-services.d.ts","sourceRoot":"","sources":["../../../src/op/activities/box-services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kGAAkG;AAClG,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,0FAA0F;AAC1F,wBAAsB,WAAW,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAiBvF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAM5G;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAe9G"}
+{"version":3,"file":"box-services.d.ts","sourceRoot":"","sources":["../../../src/op/activities/box-services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kGAAkG;AAClG,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,0FAA0F;AAC1F,wBAAsB,WAAW,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAiBvF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAM5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAS5G;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAe9G"}

package/dist/op/activities/index.d.ts

@@ -24,7 +24,7 @@ export type { DeclaredSpriteService, SpriteServicesObserveArgs, SpriteServicesOb
 export { spriteWriteFile, spriteReadFile, spriteListDir, spriteRemove, spriteFsUrl, defaultSpritesRawHttp, } from "./sprite-fs.js";
 export type { SpritesRawHttp, SpriteWriteFileArgs, SpriteReadFileArgs, SpriteReadFileResult, SpriteListDirArgs, SpriteDirEntry, SpriteRemoveArgs, } from "./sprite-fs.js";
 export { spriteApplyNetworkPolicy, spriteApplyServices, validateNetworkRules, networkRulesEqual, validateServices, serviceConfigEqual, parseServiceDefinitions, listedServiceDiffers, spriteEnvCreateArgs, } from "./sprite-config.js";
-export { boxServices, expandServiceCommand, inStartOrder } from "./box-services.js";
+export { boxServices, expandServiceCommand, inStartOrder, serviceCommandArgv } from "./box-services.js";
 export type { BoxServiceDeclaration } from "./box-services.js";
 export type { NetworkRule, SpriteApplyNetworkPolicyArgs, SpriteApplyNetworkPolicyResult, ServiceSpec, SpriteApplyServicesArgs, SpriteApplyServicesResult, ServiceApplyAction, ListedService, } from "./sprite-config.js";
 export { spriteTaskCreate, spriteTaskRefresh, spriteTaskRelease, spriteTasksUrl, spriteTaskUrl, } from "./sprite-tasks.js";

package/dist/op/activities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"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"}

package/dist/op/activities/sprite-config.d.ts

@@ -81,13 +81,19 @@ export interface SpriteApplyServicesArgs {
     start?: boolean;
     /** Without `id`: restart each applied service that was already converged. Default: false. */
     restart?: boolean;
+    /**
+     * Without `id` and without `only`: delete each service the supervisor has
+     * that the box block does not declare (an `optional` one is declared), so a
+     * service dropped from the block stops running. Default: true.
+     */
+    prune?: boolean;
     /** Without `id`: the `sprite-env` binary. Default: the one on PATH, else /.sprite/bin/sprite-env. */
     spriteEnv?: string;
     endpoint?: string;
     token?: string;
 }
 /** What an apply through sprite-env did to one service (#2880). */
-export type ServiceApplyAction = "created" | "replaced" | "restarted" | "started" | "left";
+export type ServiceApplyAction = "created" | "replaced" | "restarted" | "started" | "left" | "deleted";
 export interface SpriteApplyServicesResult {
     /** Names that were created or updated (converged services are skipped). */
     applied: string[];
@@ -96,7 +102,7 @@ export interface SpriteApplyServicesResult {
     /**
      * Without `id`: each service applied, in the order it was applied, with
      * what the apply did to it (#2880). `left` is a converged service that was
-     * not restarted or started.
+     * not restarted or started, `deleted` one the block does not declare (`prune`).
      */
     services?: {
         name: string;
@@ -137,6 +143,15 @@ export interface ListedService {
 export declare function parseServiceDefinitions(text: string): ListedService[];
 /** Whether a listed service differs from the declared one in `cmd`, `needs` or `httpPort`. A field the listing does not carry is not compared. Pure. */
 export declare function listedServiceDiffers(listed: ListedService, declared: BoxServiceDeclaration, cmd: string): string | null;
-/** The arguments of `sprite-env services create` for a declared service. Pure. */
-export declare function spriteEnvCreateArgs(s: BoxServiceDeclaration, cmd: string): string[];
+/**
+ * The arguments of `sprite-env services create` for a declared service.
+ * `argv` is the command from {@link serviceCommandArgv}: its first word is
+ * `--cmd`, the rest `--args` (comma-separated), as sprite-env and upstream
+ * Sprites take them; neither runs `--cmd` through a shell. A string is split
+ * on whitespace. With a `duration`, sprite-env streams the service's output
+ * for that long and fails the create if the service exits in it, so
+ * `--no-stream` (which returns as soon as the service is defined) is passed
+ * only without one. Pure.
+ */
+export declare function spriteEnvCreateArgs(s: BoxServiceDeclaration, argv: string | readonly string[]): string[];
 //# sourceMappingURL=sprite-config.d.ts.map

package/dist/op/activities/sprite-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprite-config.d.ts","sourceRoot":"","sources":["../../../src/op/activities/sprite-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAmD,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE7G,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAezF,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAS/D;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAG7E;AAKD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,4BAA4B,EAClC,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,GAAE,WAA4C,GACjD,OAAO,CAAC,8BAA8B,CAAC,CAiBzC;AAID,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,sJAAsJ;IACtJ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,4JAA4J;IAC5J,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oIAAoI;IACpI,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,yBAAyB;IACxC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,EAAE,CAAC;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CA0BlE;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAW5F;AAkBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,uBAAuB,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAOpC;AAgDD,2GAA2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAsCrE;AAED,wJAAwJ;AACxJ,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvH;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYnF"}
+{"version":3,"file":"sprite-config.d.ts","sourceRoot":"","sources":["../../../src/op/activities/sprite-config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-fly",
-  "version": "0.108.0",
+  "version": "0.109.0",
   "type": "module",
   "files": [
     "src/",
@@ -69,7 +69,7 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.108.0",
+    "@intentius/chant": "^0.109.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },

package/src/op/activities/box-services.ts

@@ -13,7 +13,7 @@
 /** One declared service, as the declaration states it (core's `BoxService`, less its pointer). */
 export interface BoxServiceDeclaration {
   name: string;
-  /** As written: `${VAR}` references are expanded by {@link expandServiceCommand}. */
+  /** As written: split into argv and `${VAR}`-expanded by {@link serviceCommandArgv}. */
   cmd: string;
   needs: string[];
   httpPort: number | null;
@@ -55,6 +55,26 @@ export function expandServiceCommand(name: string, cmd: string, env: NodeJS.Proc
   });
 }
 
+/**
+ * A service's command as the supervisor runs it: the executable and its
+ * arguments. The declared `cmd` is split on whitespace, with no quoting or
+ * other shell syntax (a command that needs it belongs in a script), and each
+ * word is then expanded by {@link expandServiceCommand}, so a variable whose
+ * value has a space stays one word. sprite-env takes the arguments as one
+ * comma-separated `--args`, so an argument with a comma in it is refused
+ * here rather than split there. Pure.
+ */
+export function serviceCommandArgv(name: string, cmd: string, env: NodeJS.ProcessEnv = process.env): string[] {
+  const words = cmd.trim().split(/\s+/).filter((w) => w !== "");
+  if (words.length === 0) throw new Error(`service ${name}'s cmd is empty`);
+  const argv = words.map((w) => expandServiceCommand(name, w, env));
+  const comma = argv.slice(1).find((a) => a.includes(","));
+  if (comma !== undefined) {
+    throw new Error(`service ${name}'s cmd has the argument ${JSON.stringify(comma)}, and sprite-env's --args is comma-separated, so it can't carry a comma; run the command from a script`);
+  }
+  return argv;
+}
+
 /**
  * The services in an order each one's `needs` come before it, and in file
  * order otherwise. The list is one the declaration reader accepted, so every

package/src/op/activities/index.ts

@@ -231,7 +231,7 @@ export {
   spriteEnvCreateArgs,
 } from "./sprite-config";
 // A box's declared services (#2880), read from its box block with `box: true`.
-export { boxServices, expandServiceCommand, inStartOrder } from "./box-services";
+export { boxServices, expandServiceCommand, inStartOrder, serviceCommandArgv } from "./box-services";
 export type { BoxServiceDeclaration } from "./box-services";
 export type {
   NetworkRule,

package/src/op/activities/sprite-box-services.test.ts

@@ -23,7 +23,7 @@ import { convergeTick } from "@intentius/chant/op/activities";
 import { readConvergeLedger } from "@intentius/chant/lifecycle/converge-ledger";
 import { spriteApplyServices, listedServiceDiffers, parseServiceDefinitions, spriteEnvCreateArgs } from "./sprite-config";
 import { spriteServiceRestart, spriteServicesObserve } from "./sprite-service-converge";
-import { expandServiceCommand } from "./box-services";
+import { expandServiceCommand, serviceCommandArgv } from "./box-services";
 import { spriteServicesObserve as observeStep, spriteServiceRestart as restartStep } from "../builders";
 
 let root: string;
@@ -48,23 +48,29 @@ const fail = (m) => { console.error("sprite-env: " + m); process.exit(1); };
 if (verb === "list") {
   const out = readdirSync(dir).filter((f) => f.endsWith(".json")).sort().map((f) => {
     const s = JSON.parse(readFileSync(join(dir, f), "utf8"));
-    return { name: s.name, cmd: s.cmd, args: [], needs: s.needs, http_port: s.httpPort, state: { name: s.name, status: s.status } };
+    return { name: s.name, cmd: s.cmd, args: s.args, needs: s.needs, http_port: s.httpPort, state: { name: s.name, status: s.status } };
   });
   console.log(JSON.stringify(out));
 } else if (verb === "create") {
   if (existsSync(file(name))) fail("service " + name + " already exists");
-  const s = { name, cmd: null, needs: [], httpPort: 0, status: "running" };
+  const s = { name, cmd: null, args: [], needs: [], httpPort: 0, status: "running" };
   for (let i = 0; i < rest.length; i++) {
     const a = rest[i];
     if (a === "--no-stream") continue;
     const v = rest[++i];
     if (a === "--cmd") s.cmd = v;
+    else if (a === "--args") s.args = v.split(",");
     else if (a === "--needs") s.needs = v.split(",");
     else if (a === "--http-port") s.httpPort = Number(v);
     else if (a === "--duration") s.duration = v;
     else fail("unknown option " + a);
   }
   for (const n of s.needs) if (!existsSync(file(n))) fail("service " + name + " needs " + n + ", which does not exist");
+  if (s.httpPort > 0) {
+    for (const f of readdirSync(dir).filter((f) => f.endsWith(".json"))) {
+      if (JSON.parse(readFileSync(join(dir, f), "utf8")).httpPort > 0) fail("another service already has an HTTP port configured (409)");
+    }
+  }
   writeFileSync(file(name), JSON.stringify(s));
 } else if (verb === "delete") {
   if (!existsSync(file(name))) fail("no service " + name);
@@ -195,13 +201,22 @@ describe("the sprite-env listing and create line (#2880)", () => {
     expect(listedServiceDiffers({ name: "door", status: "running", cmd: "/h/d.sh", needs: [], httpPort: 8080 }, declared, "/h/d.sh")).toMatch(/^needs/);
     expect(listedServiceDiffers({ name: "door", status: "running", cmd: "/h/d.sh", needs: ["hud"], httpPort: null }, declared, "/h/d.sh")).toMatch(/^httpPort/);
     expect(listedServiceDiffers({ name: "door", status: "running" }, declared, "/h/d.sh")).toBeNull();
-    expect(spriteEnvCreateArgs({ ...declared, duration: "2s" }, "/h/d.sh")).toEqual(["services", "create", "door", "--cmd", "/h/d.sh", "--needs", "hud", "--http-port", "8080", "--duration", "2s", "--no-stream"]);
+    expect(spriteEnvCreateArgs({ ...declared, duration: "2s" }, "/h/d.sh")).toEqual(["services", "create", "door", "--cmd", "/h/d.sh", "--needs", "hud", "--http-port", "8080", "--duration", "2s"]);
+    expect(spriteEnvCreateArgs(declared, ["node", "/h/preview.mjs", "--port", "5173"])).toEqual(["services", "create", "door", "--cmd", "node", "--args", "/h/preview.mjs,--port,5173", "--needs", "hud", "--http-port", "8080", "--no-stream"]);
   });
 
   test("${VAR} expands from the environment, and an unset one fails naming it", () => {
     expect(expandServiceCommand("app", "${HOME}/box/run.sh --port ${PORT}", { HOME: "/home/sprite", PORT: "5173" })).toBe("/home/sprite/box/run.sh --port 5173");
     expect(() => expandServiceCommand("app", "${NOPE}/run.sh", {})).toThrow("service app's cmd names ${NOPE}, which is not set in this process's environment");
   });
+
+  test("a cmd with arguments splits on whitespace into the executable and its arguments, expanding each word (sandpit#6)", () => {
+    expect(serviceCommandArgv("app", "node ${HOME}/box/app/steward/preview.mjs", { HOME: "/home/sprite" })).toEqual(["node", "/home/sprite/box/app/steward/preview.mjs"]);
+    expect(serviceCommandArgv("app", "  npm   --prefix app start ", {})).toEqual(["npm", "--prefix", "app", "start"]);
+    expect(serviceCommandArgv("app", "${BIN} --root ${ROOT}", { BIN: "/opt/x", ROOT: "/a b" })).toEqual(["/opt/x", "--root", "/a b"]);
+    expect(() => serviceCommandArgv("app", "node a.js --hosts a,b", {})).toThrow('service app\'s cmd has the argument "a,b"');
+    expect(() => serviceCommandArgv("app", "   ", {})).toThrow("service app's cmd is empty");
+  });
 });
 
 describe("spriteApplyServices({ box: true }) through sprite-env (#2880)", () => {
@@ -212,8 +227,8 @@ describe("spriteApplyServices({ box: true }) through sprite-env (#2880)", () =>
     expect(first.services).toEqual([{ name: "app", action: "created" }, { name: "hud", action: "created" }]);
     expect(first).toMatchObject({ applied: ["app", "hud"], started: [] });
     expect(takeCalls()).toEqual([
-      "services create app --cmd /home/sprite/box/run-app.sh --duration 3s --no-stream",
-      "services create hud --cmd /home/sprite/box/run-daemon.sh --needs app --http-port 8080 --duration 3s --no-stream",
+      "services create app --cmd /home/sprite/box/run-app.sh --duration 3s",
+      "services create hud --cmd /home/sprite/box/run-daemon.sh --needs app --http-port 8080 --duration 3s",
     ]);
 
     const second = await spriteApplyServices({ box: true, start: true });
@@ -224,10 +239,80 @@ describe("spriteApplyServices({ box: true }) through sprite-env (#2880)", () =>
     declare([SERVICES()[0], { ...SERVICES()[1], cmd: "${BOX_HOME}/run-hud.sh" }, SERVICES()[2]]);
     const third = await spriteApplyServices({ box: true, start: true });
     expect(third.services).toEqual([{ name: "app", action: "left" }, { name: "hud", action: "replaced" }]);
-    expect(takeCalls()).toEqual(["services delete hud", "services create hud --cmd /home/sprite/box/run-hud.sh --needs app --http-port 8080 --duration 3s --no-stream"]);
+    expect(takeCalls()).toEqual(["services delete hud", "services create hud --cmd /home/sprite/box/run-hud.sh --needs app --http-port 8080 --duration 3s"]);
     expect((listed().get("hud") as { cmd: string }).cmd).toBe("/home/sprite/box/run-hud.sh");
   });
 
+  test("a cmd with arguments goes to sprite-env as --cmd and --args, and the listing it makes reads back as converged (sandpit#6)", async () => {
+    declare([{ name: "app", cmd: "node ${BOX_HOME}/preview.mjs --port 5173", duration: "3s", health: health("app") }]);
+    rmSync(join(state, "app.json"), { force: true });
+    takeCalls();
+    // hud, from the earlier tests, is not declared here, so the apply deletes it.
+    expect((await spriteApplyServices({ box: true })).services).toEqual([{ name: "hud", action: "deleted" }, { name: "app", action: "created" }]);
+    expect(takeCalls()).toEqual(["services delete hud", "services create app --cmd node --args /home/sprite/box/preview.mjs,--port,5173 --duration 3s"]);
+    expect(listed().get("app")).toMatchObject({ cmd: "node", args: ["/home/sprite/box/preview.mjs", "--port", "5173"] });
+    expect((await spriteApplyServices({ box: true })).services).toEqual([{ name: "app", action: "left" }]);
+    expect(takeCalls()).toEqual([]);
+    rmSync(join(state, "app.json"), { force: true });
+    declare(SERVICES());
+  });
+
+  test("a moved httpPort is let go by its old holder before the new holder is defined with it", async () => {
+    await spriteApplyServices({ box: true });
+    takeCalls();
+    // app comes first in start order, so without the release app would be
+    // defined with the port while hud still holds it, and the supervisor refuses that.
+    const { httpPort: _moved, ...hudWithoutPort } = SERVICES()[1];
+    declare([{ ...SERVICES()[0], httpPort: 8080 }, hudWithoutPort, SERVICES()[2]]);
+    const moved = await spriteApplyServices({ box: true });
+    expect(moved.services).toEqual([{ name: "app", action: "replaced" }, { name: "hud", action: "replaced" }]);
+    expect(takeCalls()).toEqual([
+      "services delete hud",
+      "services create hud --cmd /home/sprite/box/run-daemon.sh --needs app --duration 3s",
+      "services delete app",
+      "services create app --cmd /home/sprite/box/run-app.sh --http-port 8080 --duration 3s",
+    ]);
+    expect((listed().get("app") as { http_port: number }).http_port).toBe(8080);
+    expect((listed().get("hud") as { http_port: number }).http_port).toBe(0);
+
+    // And back again: app lets go first this time.
+    declare(SERVICES());
+    expect((await spriteApplyServices({ box: true })).services).toEqual([{ name: "app", action: "replaced" }, { name: "hud", action: "replaced" }]);
+    expect(takeCalls()).toEqual([
+      "services delete app",
+      "services create app --cmd /home/sprite/box/run-app.sh --duration 3s",
+      "services delete hud",
+      "services create hud --cmd /home/sprite/box/run-daemon.sh --needs app --http-port 8080 --duration 3s",
+    ]);
+  });
+
+  test("a full apply deletes the services the block does not declare, dependants first; only and prune: false leave them", async () => {
+    await spriteApplyServices({ box: true });
+    // Two services nobody declared, one needing the other, and an optional one that is declared.
+    const extra = (name: string, needs: string[]) =>
+      writeFileSync(join(state, `${name}.json`), JSON.stringify({ name, cmd: `/x/${name}.sh`, args: [], needs, httpPort: 0, status: "running" }));
+    extra("old-db", []);
+    extra("old-api", ["old-db"]);
+    extra("site", []);
+    takeCalls();
+
+    expect((await spriteApplyServices({ box: true, only: ["app"] })).services).toEqual([{ name: "app", action: "left" }]);
+    expect((await spriteApplyServices({ box: true, prune: false })).services).toEqual([{ name: "app", action: "left" }, { name: "hud", action: "left" }]);
+    expect(takeCalls()).toEqual([]);
+
+    const pruned = await spriteApplyServices({ box: true });
+    expect(pruned.services).toEqual([
+      { name: "old-api", action: "deleted" },
+      { name: "old-db", action: "deleted" },
+      { name: "app", action: "left" },
+      { name: "hud", action: "left" },
+    ]);
+    expect(pruned.applied).toEqual([]);
+    expect(takeCalls()).toEqual(["services delete old-api", "services delete old-db"]);
+    expect([...listed().keys()].sort()).toEqual(["app", "hud", "site"]);
+    rmSync(join(state, "site.json"));
+  });
+
   test("start starts a defined service that is stopped; without start it is left", async () => {
     await spriteApplyServices({ box: true });
     setStatus("app", "stopped");

package/src/op/activities/sprite-config.ts

@@ -24,7 +24,7 @@
 
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { expandServiceCommand, inStartOrder, boxServices, type BoxServiceDeclaration } from "./box-services";
+import { serviceCommandArgv, inStartOrder, boxServices, type BoxServiceDeclaration } from "./box-services";
 import { findSpriteEnv } from "./sprite-service-converge";
 import { resolveSpritesEndpoint, defaultSpritesHttp, type SpritesHttp } from "./sprites";
 import { logProgress } from "./progress";
@@ -144,6 +144,12 @@ export interface SpriteApplyServicesArgs {
   start?: boolean;
   /** Without `id`: restart each applied service that was already converged. Default: false. */
   restart?: boolean;
+  /**
+   * Without `id` and without `only`: delete each service the supervisor has
+   * that the box block does not declare (an `optional` one is declared), so a
+   * service dropped from the block stops running. Default: true.
+   */
+  prune?: boolean;
   /** Without `id`: the `sprite-env` binary. Default: the one on PATH, else /.sprite/bin/sprite-env. */
   spriteEnv?: string;
   endpoint?: string;
@@ -151,7 +157,7 @@ export interface SpriteApplyServicesArgs {
 }
 
 /** What an apply through sprite-env did to one service (#2880). */
-export type ServiceApplyAction = "created" | "replaced" | "restarted" | "started" | "left";
+export type ServiceApplyAction = "created" | "replaced" | "restarted" | "started" | "left" | "deleted";
 
 export interface SpriteApplyServicesResult {
   /** Names that were created or updated (converged services are skipped). */
@@ -161,7 +167,7 @@ export interface SpriteApplyServicesResult {
   /**
    * Without `id`: each service applied, in the order it was applied, with
    * what the apply did to it (#2880). `left` is a converged service that was
-   * not restarted or started.
+   * not restarted or started, `deleted` one the block does not declare (`prune`).
    */
   services?: { name: string; action: ServiceApplyAction }[];
 }
@@ -363,18 +369,28 @@ export function listedServiceDiffers(listed: ListedService, declared: BoxService
   return null;
 }
 
-/** The arguments of `sprite-env services create` for a declared service. Pure. */
-export function spriteEnvCreateArgs(s: BoxServiceDeclaration, cmd: string): string[] {
+/**
+ * The arguments of `sprite-env services create` for a declared service.
+ * `argv` is the command from {@link serviceCommandArgv}: its first word is
+ * `--cmd`, the rest `--args` (comma-separated), as sprite-env and upstream
+ * Sprites take them; neither runs `--cmd` through a shell. A string is split
+ * on whitespace. With a `duration`, sprite-env streams the service's output
+ * for that long and fails the create if the service exits in it, so
+ * `--no-stream` (which returns as soon as the service is defined) is passed
+ * only without one. Pure.
+ */
+export function spriteEnvCreateArgs(s: BoxServiceDeclaration, argv: string | readonly string[]): string[] {
+  const [cmd, ...rest] = typeof argv === "string" ? argv.trim().split(/\s+/) : argv;
   return [
     "services",
     "create",
     s.name,
     "--cmd",
     cmd,
+    ...(rest.length > 0 ? ["--args", rest.join(",")] : []),
     ...(s.needs.length > 0 ? ["--needs", s.needs.join(",")] : []),
     ...(s.httpPort !== null ? ["--http-port", String(s.httpPort)] : []),
-    ...(s.duration !== null ? ["--duration", s.duration] : []),
-    "--no-stream",
+    ...(s.duration !== null ? ["--duration", s.duration] : ["--no-stream"]),
   ];
 }
 
@@ -400,7 +416,7 @@ async function applyThroughSpriteEnv(args: SpriteApplyServicesArgs, signal?: Abo
   const only = args.only ? new Set(args.only) : null;
   const targets = inStartOrder(declared).filter((s) => (only ? only.has(s.name) : !s.optional));
   // Expand every command before changing anything, so a missing variable fails the step with nothing half-applied.
-  const commands = new Map(targets.map((s) => [s.name, expandServiceCommand(s.name, s.cmd)]));
+  const commands = new Map(targets.map((s) => [s.name, serviceCommandArgv(s.name, s.cmd)]));
 
   const bin = findSpriteEnv(args.spriteEnv);
   if (!bin) throw new Error("spriteApplyServices: no sprite-env on PATH or in /.sprite/bin, and no sprite id to reach the Sprites API with");
@@ -414,12 +430,52 @@ async function applyThroughSpriteEnv(args: SpriteApplyServicesArgs, signal?: Abo
   };
   const live = new Map(parseServiceDefinitions(await spriteEnv(["services", "list"])).map((s) => [s.name, s]));
 
+  // A full apply leaves the supervisor with the declared services only: one
+  // the block no longer declares is deleted, before anything is defined, so
+  // the HTTP port or a name it held is free. Dependants go before what they need.
   const services: { name: string; action: ServiceApplyAction }[] = [];
+  if (!only && args.prune !== false) {
+    const undeclared = new Set([...live.keys()].filter((n) => !names.has(n)));
+    while (undeclared.size > 0) {
+      const needed = new Set([...undeclared].flatMap((n) => live.get(n)?.needs ?? []));
+      const next = [...undeclared].sort().find((n) => !needed.has(n)) ?? [...undeclared].sort()[0];
+      await spriteEnv(["services", "delete", next]);
+      logProgress(`services: deleted ${next}, which the box block does not declare`);
+      services.push({ name: next, action: "deleted" });
+      undeclared.delete(next);
+      live.delete(next);
+    }
+  }
+
+  // The supervisor gives one service the HTTP port and refuses a second holder
+  // (409) while the first still has it. So a service whose listed port is not
+  // the declared one is replaced first, before any service is defined with a
+  // port: when the port moves from one service to another, the old holder has
+  // let go of it by the time the new one asks. One whose declared needs are not
+  // all defined yet can't be created early and waits for its turn below.
+  const released = new Set<string>();
   for (const s of targets) {
-    const cmd = commands.get(s.name)!;
+    const cur = live.get(s.name);
+    if (!cur || cur.httpPort === undefined || cur.httpPort === null || cur.httpPort === s.httpPort) continue;
+    if (!s.needs.every((n) => live.has(n))) continue;
+    const argv = commands.get(s.name)!;
+    const why = listedServiceDiffers(cur, s, argv.join(" "));
+    await spriteEnv(["services", "delete", s.name]);
+    await spriteEnv(spriteEnvCreateArgs(s, argv));
+    logProgress(`services: replaced ${s.name} (${why}) first, to free the HTTP port`);
+    released.add(s.name);
+  }
+
+  for (const s of targets) {
+    if (released.has(s.name)) {
+      services.push({ name: s.name, action: "replaced" });
+      continue;
+    }
+    const argv = commands.get(s.name)!;
+    const cmd = argv.join(" ");
     const cur = live.get(s.name);
     if (!cur) {
-      await spriteEnv(spriteEnvCreateArgs(s, cmd));
+      await spriteEnv(spriteEnvCreateArgs(s, argv));
       logProgress(`services: created ${s.name}`);
       services.push({ name: s.name, action: "created" });
       continue;
@@ -427,7 +483,7 @@ async function applyThroughSpriteEnv(args: SpriteApplyServicesArgs, signal?: Abo
     const why = listedServiceDiffers(cur, s, cmd);
     if (why) {
       await spriteEnv(["services", "delete", s.name]);
-      await spriteEnv(spriteEnvCreateArgs(s, cmd));
+      await spriteEnv(spriteEnvCreateArgs(s, argv));
       logProgress(`services: replaced ${s.name} (${why})`);
       services.push({ name: s.name, action: "replaced" });
       continue;
@@ -452,6 +508,7 @@ async function applyThroughSpriteEnv(args: SpriteApplyServicesArgs, signal?: Abo
     }
   }
   const applied = services.filter((e) => e.action === "created" || e.action === "replaced").map((e) => e.name);
-  logProgress(`services: applied ${applied.length}/${targets.length} through sprite-env, started ${started.length}`);
+  const deleted = services.filter((e) => e.action === "deleted").length;
+  logProgress(`services: applied ${applied.length}/${targets.length} through sprite-env, started ${started.length}${deleted > 0 ? `, deleted ${deleted}` : ""}`);
   return { applied, started, services };
 }