@decohere/flux 0.0.1-dev.19 → 0.0.1-dev.20261105.103

package/es6/src/index.js

@@ -1,4 +1,6 @@
+export { DeferredScriptRunner } from "./deferred-script-runner.js";
+export { flux } from "./flux.js";
 export { FluxModule } from "./flux.module.js";
-export { HotReloadServer } from "./hot-reload-server.js";
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZsdXgvc3JjL2luZGV4LnRzIl0sInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCB7IEZsdXhNb2R1bGUgfSBmcm9tIFwiLi9mbHV4Lm1vZHVsZS5qc1wiO1xuZXhwb3J0IHR5cGUgeyBIb3RSZWxvYWRTZXJ2ZXJPcHRpb25zIH0gZnJvbSBcIi4vaG90LXJlbG9hZC1zZXJ2ZXIuanNcIjtcbmV4cG9ydCB7IEhvdFJlbG9hZFNlcnZlciB9IGZyb20gXCIuL2hvdC1yZWxvYWQtc2VydmVyLmpzXCI7XG5leHBvcnQgdHlwZSB7IFNlcnZlT3B0aW9ucyB9IGZyb20gXCIuL3NlcnZlLmFjdGlvbi5qc1wiO1xuIl0sIm5hbWVzIjpbIkZsdXhNb2R1bGUiLCJIb3RSZWxvYWRTZXJ2ZXIiXSwibWFwcGluZ3MiOiJBQUFBLFNBQVNBLFVBQVUsUUFBUSxtQkFBbUI7QUFFOUMsU0FBU0MsZUFBZSxRQUFRLHlCQUF5QiJ9
+export { DEFAULT_REBOOT_DEBOUNCE_MS, HotReloadServer } from "./hot-reload-server.js";
+export { classifySliceProject, classifySliceProjects, normalizeSlicePrefix, projectsInSlice, projectsInSlices, resolveDeferScript } from "./slice-serve.js";
+export { SourceModuleLoader } from "./source-module-loader.js";

package/es6/src/rewrite-serve-specifier.js

@@ -0,0 +1,51 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { packageAliases, sourceExtensions } from "@decohere/workspace";
+/**
+ * Map a resolve-hook specifier to a versioned watched `.ts` file URL.
+ * Covers relative `.js` / `.ts` / extensionless imports, directory imports (`./models` is
+ * `./models/index.ts`), and bare workspace package names and subpaths. Flux compiles without
+ * SWC's own path resolution, so this is the only place imports are mapped to sources.
+ */ export function rewriteServeSpecifier(options) {
+    const { specifier, parentUrl, isWatchedTs, resolveBare, versionFileUrl } = options;
+    const relativeTs = resolveRelativeWatchedTs(specifier, parentUrl, isWatchedTs);
+    if (relativeTs != null) {
+        return versionFileUrl(pathToFileURL(relativeTs).toString());
+    }
+    const bareTarget = resolveBare(specifier);
+    const bareTs = bareTarget == null ? null : watchedTs(bareTarget, isWatchedTs);
+    if (bareTs != null) {
+        return versionFileUrl(pathToFileURL(bareTs).toString());
+    }
+    return null;
+}
+/**
+ * The watched source file a path names: itself, or the source its extension stands for (`.js` is
+ * `.ts` or `.tsx`, `.mjs` is `.mts`, `.cjs` is `.cts`, none adds `.ts` or `.tsx`), else the
+ * `index` source of the directory it names. A file wins over a directory of the same name.
+ */ function watchedTs(filePath, isWatchedTs) {
+    const withoutSlash = filePath.replace(/[/\\]+$/, "");
+    // The workspace alias lookup may have added `.ts` to a subpath that names a directory (`@lib/models`
+    // arrives as `…/models.ts`), so the directory is the path without any extension.
+    const directory = withoutSlash.replace(/\.([mc]?[jt]sx?)$/, "");
+    const candidates = [
+        ...sourceExtensions.candidates(withoutSlash),
+        ...sourceExtensions.candidates(directory),
+        ...sourceExtensions.candidates(path.join(directory, "index"))
+    ];
+    return candidates.find((candidate)=>isWatchedTs(candidate)) ?? null;
+}
+function resolveRelativeWatchedTs(specifier, parentUrl, isWatchedTs) {
+    if (packageAliases.isBareSpecifier(specifier)) return null;
+    if (!(specifier.startsWith(".") || specifier.startsWith("/"))) return null;
+    const parentClean = parentUrl.split("?")[0];
+    if (parentClean == null || parentClean === "") return null;
+    let resolved;
+    try {
+        resolved = new URL(specifier, parentClean);
+    } catch  {
+        return null;
+    }
+    if (resolved.protocol !== "file:") return null;
+    return watchedTs(fileURLToPath(resolved), isWatchedTs);
+}

package/es6/src/run.action.js

@@ -0,0 +1,37 @@
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+import { injectable } from "@decohere/crucible/decorators";
+import { Workspace } from "@decohere/workspace";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { scribe } from "@decohere/scribe";
+import { flux } from "./flux.js";
+export class RunAction {
+    workspace;
+    logger = scribe.logger(RunAction.name);
+    constructor(workspace){
+        this.workspace = workspace;
+    }
+    async run(options) {
+        this.logger.trace(`Running ${options.entry}`);
+        await flux.run(options.entry, {
+            configuration: options.configuration,
+            args: options.args,
+            workspace: this.workspace
+        });
+        return ActionResponse.Success(RunAction.name);
+    }
+}
+RunAction = _ts_decorate([
+    injectable(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof Workspace === "undefined" ? Object : Workspace
+    ])
+], RunAction);

package/es6/src/run.command.js

@@ -0,0 +1,55 @@
+import { ConfigurationOption, DecohereCommand } from "@decohere/devkit/cli";
+import { RunAction } from "./run.action.js";
+export class RunCommand extends DecohereCommand {
+    get actions() {
+        return [
+            RunAction
+        ];
+    }
+    constructor(name){
+        super(name);
+        this.description("Compile and run a TypeScript entry on the fly (no watch / HMR)");
+        this.argument("<entry>", "Path to the TypeScript entry file");
+        this.argument("[args...]", "Arguments forwarded to the entry after rewriting argv");
+        this.addOption(new ConfigurationOption("debug"));
+    }
+    /**
+	 * Commander passes positionals before options when `<entry> [args...]` is declared.
+	 * The CLI host ModuleFactory expects `(opts, cmd)` — normalize and stash entry/args on opts.
+	 */ action(fn) {
+        return super.action((...args)=>{
+            const cmd = args.at(-1);
+            const opts = args.at(-2);
+            const { entry, entryArgs } = normalizeRunPositionals(args.slice(0, -2));
+            cmd.setOptionValue("entry", entry);
+            cmd.setOptionValue("args", entryArgs);
+            return fn(opts, cmd);
+        });
+    }
+}
+/** Commander yields `[entry, args[]]` or sometimes a flat list depending on arity. */ function normalizeRunPositionals(positionals) {
+    if (positionals.length === 0) {
+        return {
+            entry: "",
+            entryArgs: []
+        };
+    }
+    const first = positionals[0];
+    if (typeof first !== "string" || first === "") {
+        return {
+            entry: "",
+            entryArgs: []
+        };
+    }
+    const second = positionals[1];
+    if (Array.isArray(second)) {
+        return {
+            entry: first,
+            entryArgs: second.filter((s)=>typeof s === "string")
+        };
+    }
+    return {
+        entry: first,
+        entryArgs: positionals.slice(1).filter((s)=>typeof s === "string" && s !== "")
+    };
+}

package/es6/src/serve.action.js

@@ -7,35 +7,99 @@ function _ts_decorate(decorators, target, key, desc) {
 function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
+import path from "node:path";
 import { injectable } from "@decohere/crucible/decorators";
-// biome-ignore lint/style/useImportType: <DI>
-import { Workspace } from "@decohere/mesh";
-import { ActionResponse } from "@decohere/nexus/cli";
-// biome-ignore lint/style/useImportType: <DI>
+import { Workspace } from "@decohere/workspace";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { scribe } from "@decohere/scribe";
+import { DeferredScriptRunner } from "./deferred-script-runner.js";
 import { HotReloadServer } from "./hot-reload-server.js";
+import { classifySliceProjects, resolveDeferScript } from "./slice-serve.js";
 export class ServeAction {
     server;
     workspace;
-    constructor(server, workspace){
+    deferredScripts;
+    logger = scribe.logger(ServeAction.name);
+    constructor(server, workspace, deferredScripts){
         this.server = server;
         this.workspace = workspace;
+        this.deferredScripts = deferredScripts;
     }
     async run(options) {
+        const slices = (options.slices ?? []).filter((s)=>s !== "");
+        if (slices.length > 0 && options.project != null) {
+            throw new Error("Use either directory slices or --project, not both");
+        }
+        if (slices.length > 0) {
+            return this.runSlices(options, slices);
+        }
         await this.server.start({
             workspace: this.workspace,
             buildConfig: options.configuration,
-            project: options.project
+            project: options.project,
+            rebootDebounceMs: options.rebootDebounceMs
         });
         return ActionResponse.Blocking(ServeAction.name);
     }
+    async runSlices(options, slices) {
+        const views = await this.toSliceViews(options.configuration);
+        const classified = classifySliceProjects(views, slices);
+        const label = slices.join(" ");
+        for (const skipped of classified.skip){
+            this.logger.info(`skipped ${skipped.projectDirectory} — library (no Flux entry / scripts)`);
+        }
+        if (classified.flux.length === 0 && classified.defer.length === 0) {
+            throw new Error(`No runnable projects in slice(s) "${label}" (need Flux main.ts apps and/or package scripts.dev/serve)`);
+        }
+        const workspaceRoot = path.resolve(this.workspace.rootDir ?? process.cwd());
+        for (const deferred of classified.defer){
+            const script = resolveDeferScript(deferred.scripts);
+            if (script == null) continue;
+            const project = this.findProject(options.configuration, deferred.name);
+            this.deferredScripts.start({
+                label: deferred.projectDirectory,
+                cwd: project.projectRoot,
+                script,
+                workspaceRoot
+            });
+        }
+        if (classified.flux.length > 0) {
+            await this.server.start({
+                workspace: this.workspace,
+                buildConfig: options.configuration,
+                projects: classified.flux.map((p)=>p.name),
+                rebootDebounceMs: options.rebootDebounceMs
+            });
+        }
+        return ActionResponse.Blocking(ServeAction.name);
+    }
+    async toSliceViews(configuration) {
+        const projects = this.workspace.getProjects(configuration);
+        return Promise.all(projects.map((project)=>this.toSliceView(project)));
+    }
+    async toSliceView(project) {
+        const pkg = await project.getPackageJson();
+        return {
+            name: project.name,
+            projectDirectory: project.projectDirectory.replaceAll("\\", "/"),
+            main: pkg.main ?? "src/index.ts",
+            scripts: pkg.scripts ?? {}
+        };
+    }
+    findProject(configuration, name) {
+        const found = this.workspace.getProjects(configuration).find((p)=>p.name === name);
+        if (found == null) {
+            throw new Error(`Project "${name}" not found in workspace`);
+        }
+        return found;
+    }
 }
 ServeAction = _ts_decorate([
     injectable(),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof HotReloadServer === "undefined" ? Object : HotReloadServer,
-        typeof Workspace === "undefined" ? Object : Workspace
+        typeof Workspace === "undefined" ? Object : Workspace,
+        typeof DeferredScriptRunner === "undefined" ? Object : DeferredScriptRunner
     ])
 ], ServeAction);
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZsdXgvc3JjL3NlcnZlLmFjdGlvbi50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBpbmplY3RhYmxlIH0gZnJvbSBcIkBkZWNvaGVyZS9jcnVjaWJsZS9kZWNvcmF0b3JzXCI7XG4vLyBiaW9tZS1pZ25vcmUgbGludC9zdHlsZS91c2VJbXBvcnRUeXBlOiA8REk+XG5pbXBvcnQgeyBXb3Jrc3BhY2UgfSBmcm9tIFwiQGRlY29oZXJlL21lc2hcIjtcbmltcG9ydCB7IHR5cGUgQWN0aW9uLCBBY3Rpb25SZXNwb25zZSB9IGZyb20gXCJAZGVjb2hlcmUvbmV4dXMvY2xpXCI7XG4vLyBiaW9tZS1pZ25vcmUgbGludC9zdHlsZS91c2VJbXBvcnRUeXBlOiA8REk+XG5pbXBvcnQgeyBIb3RSZWxvYWRTZXJ2ZXIgfSBmcm9tIFwiLi9ob3QtcmVsb2FkLXNlcnZlci5qc1wiO1xuXG5leHBvcnQgdHlwZSBTZXJ2ZU9wdGlvbnMgPSB7XG5cdGNvbmZpZ3VyYXRpb246IHN0cmluZztcblx0cHJvamVjdD86IHN0cmluZztcbn07XG5cbkBpbmplY3RhYmxlKClcbmV4cG9ydCBjbGFzcyBTZXJ2ZUFjdGlvbiBpbXBsZW1lbnRzIEFjdGlvbjxTZXJ2ZU9wdGlvbnM+IHtcblx0cHVibGljIGNvbnN0cnVjdG9yKFxuXHRcdHByaXZhdGUgcmVhZG9ubHkgc2VydmVyOiBIb3RSZWxvYWRTZXJ2ZXIsXG5cdFx0cHJpdmF0ZSByZWFkb25seSB3b3Jrc3BhY2U6IFdvcmtzcGFjZSxcblx0KSB7fVxuXG5cdHB1YmxpYyBhc3luYyBydW4ob3B0aW9uczogU2VydmVPcHRpb25zKTogUHJvbWlzZTxBY3Rpb25SZXNwb25zZT4ge1xuXHRcdGF3YWl0IHRoaXMuc2VydmVyLnN0YXJ0KHtcblx0XHRcdHdvcmtzcGFjZTogdGhpcy53b3Jrc3BhY2UsXG5cdFx0XHRidWlsZENvbmZpZzogb3B0aW9ucy5jb25maWd1cmF0aW9uLFxuXHRcdFx0cHJvamVjdDogb3B0aW9ucy5wcm9qZWN0LFxuXHRcdH0pO1xuXHRcdHJldHVybiBBY3Rpb25SZXNwb25zZS5CbG9ja2luZyhTZXJ2ZUFjdGlvbi5uYW1lKTtcblx0fVxufVxuIl0sIm5hbWVzIjpbImluamVjdGFibGUiLCJXb3Jrc3BhY2UiLCJBY3Rpb25SZXNwb25zZSIsIkhvdFJlbG9hZFNlcnZlciIsIlNlcnZlQWN0aW9uIiwic2VydmVyIiwid29ya3NwYWNlIiwicnVuIiwib3B0aW9ucyIsInN0YXJ0IiwiYnVpbGRDb25maWciLCJjb25maWd1cmF0aW9uIiwicHJvamVjdCIsIkJsb2NraW5nIiwibmFtZSJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7O0FBQUEsU0FBU0EsVUFBVSxRQUFRLGdDQUFnQztBQUMzRCw4Q0FBOEM7QUFDOUMsU0FBU0MsU0FBUyxRQUFRLGlCQUFpQjtBQUMzQyxTQUFzQkMsY0FBYyxRQUFRLHNCQUFzQjtBQUNsRSw4Q0FBOEM7QUFDOUMsU0FBU0MsZUFBZSxRQUFRLHlCQUF5QjtBQVF6RCxPQUFPLE1BQU1DOzs7SUFDWixZQUNDLEFBQWlCQyxNQUF1QixFQUN4QyxBQUFpQkMsU0FBb0IsQ0FDcEM7YUFGZ0JELFNBQUFBO2FBQ0FDLFlBQUFBO0lBQ2Y7SUFFSCxNQUFhQyxJQUFJQyxPQUFxQixFQUEyQjtRQUNoRSxNQUFNLElBQUksQ0FBQ0gsTUFBTSxDQUFDSSxLQUFLLENBQUM7WUFDdkJILFdBQVcsSUFBSSxDQUFDQSxTQUFTO1lBQ3pCSSxhQUFhRixRQUFRRyxhQUFhO1lBQ2xDQyxTQUFTSixRQUFRSSxPQUFPO1FBQ3pCO1FBQ0EsT0FBT1YsZUFBZVcsUUFBUSxDQUFDVCxZQUFZVSxJQUFJO0lBQ2hEO0FBQ0QifQ==

package/es6/src/serve.command.js

@@ -1,4 +1,5 @@
-import { ConfigurationOption, DecohereCommand, ProjectOption } from "@decohere/nexus/cli";
+import { ConfigurationOption, DecohereCommand, ProjectOption } from "@decohere/devkit/cli";
+import { DEFAULT_REBOOT_DEBOUNCE_MS, resolveRebootDebounceMs } from "./hot-reload-server.js";
 import { ServeAction } from "./serve.action.js";
 export class ServeCommand extends DecohereCommand {
     get actions() {
@@ -8,10 +9,40 @@ export class ServeCommand extends DecohereCommand {
     }
     constructor(name){
         super(name);
-        this.description("Serve a project in a workspace configuration");
+        this.description("Serve a project or directory slices (Flux apps in-process; foreign packages via package scripts)");
+        this.argument("[slices...]", "Module directories to serve (e.g. funding shell secmaster, or projects/funding)");
         this.addOption(new ConfigurationOption("debug"));
         this.addOption(new ProjectOption());
+        this.option("--reboot-debounce-ms <ms>", "Quiet window in milliseconds after the last affecting save before a reboot", (value)=>resolveRebootDebounceMs(Number(value)), DEFAULT_REBOOT_DEBOUNCE_MS);
     }
+    runsUntilStopped() {
+        return true;
+    }
+    /**
+	 * Commander passes positional args before options when `[slices...]` is declared.
+	 * The CLI host ModuleFactory expects `(opts, cmd)` — normalize here.
+	 */ action(fn) {
+        return super.action((...args)=>{
+            const cmd = args.at(-1);
+            const first = args[0];
+            const hasPositionalSlices = Array.isArray(first) || typeof first === "string" || first === undefined;
+            const opts = hasPositionalSlices ? args[1] : args[0];
+            const slices = normalizePositionalSlices(first);
+            if (slices.length > 0) {
+                cmd.setOptionValue("slices", slices);
+            }
+            return fn(opts, cmd);
+        });
+    }
+}
+function normalizePositionalSlices(first) {
+    if (Array.isArray(first)) {
+        return first.filter((s)=>typeof s === "string" && s !== "");
+    }
+    if (typeof first === "string" && first !== "") {
+        return [
+            first
+        ];
+    }
+    return [];
 }
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZsdXgvc3JjL3NlcnZlLmNvbW1hbmQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ29uZmlndXJhdGlvbk9wdGlvbiwgRGVjb2hlcmVDb21tYW5kLCBQcm9qZWN0T3B0aW9uIH0gZnJvbSBcIkBkZWNvaGVyZS9uZXh1cy9jbGlcIjtcbmltcG9ydCB7IFNlcnZlQWN0aW9uIH0gZnJvbSBcIi4vc2VydmUuYWN0aW9uLmpzXCI7XG5cbmV4cG9ydCBjbGFzcyBTZXJ2ZUNvbW1hbmQgZXh0ZW5kcyBEZWNvaGVyZUNvbW1hbmQge1xuXHRwdWJsaWMgb3ZlcnJpZGUgZ2V0IGFjdGlvbnMoKSB7XG5cdFx0cmV0dXJuIFtTZXJ2ZUFjdGlvbl07XG5cdH1cblxuXHRwdWJsaWMgY29uc3RydWN0b3IobmFtZTogc3RyaW5nKSB7XG5cdFx0c3VwZXIobmFtZSk7XG5cdFx0dGhpcy5kZXNjcmlwdGlvbihcIlNlcnZlIGEgcHJvamVjdCBpbiBhIHdvcmtzcGFjZSBjb25maWd1cmF0aW9uXCIpO1xuXHRcdHRoaXMuYWRkT3B0aW9uKG5ldyBDb25maWd1cmF0aW9uT3B0aW9uKFwiZGVidWdcIikpO1xuXHRcdHRoaXMuYWRkT3B0aW9uKG5ldyBQcm9qZWN0T3B0aW9uKCkpO1xuXHR9XG59XG4iXSwibmFtZXMiOlsiQ29uZmlndXJhdGlvbk9wdGlvbiIsIkRlY29oZXJlQ29tbWFuZCIsIlByb2plY3RPcHRpb24iLCJTZXJ2ZUFjdGlvbiIsIlNlcnZlQ29tbWFuZCIsImFjdGlvbnMiLCJuYW1lIiwiZGVzY3JpcHRpb24iLCJhZGRPcHRpb24iXSwibWFwcGluZ3MiOiJBQUFBLFNBQVNBLG1CQUFtQixFQUFFQyxlQUFlLEVBQUVDLGFBQWEsUUFBUSxzQkFBc0I7QUFDMUYsU0FBU0MsV0FBVyxRQUFRLG9CQUFvQjtBQUVoRCxPQUFPLE1BQU1DLHFCQUFxQkg7SUFDakMsSUFBb0JJLFVBQVU7UUFDN0IsT0FBTztZQUFDRjtTQUFZO0lBQ3JCO0lBRUEsWUFBbUJHLElBQVksQ0FBRTtRQUNoQyxLQUFLLENBQUNBO1FBQ04sSUFBSSxDQUFDQyxXQUFXLENBQUM7UUFDakIsSUFBSSxDQUFDQyxTQUFTLENBQUMsSUFBSVIsb0JBQW9CO1FBQ3ZDLElBQUksQ0FBQ1EsU0FBUyxDQUFDLElBQUlOO0lBQ3BCO0FBQ0QifQ==

package/es6/src/slice-serve.js

@@ -0,0 +1,105 @@
+/**
+ * Directory-slice helpers for `flux serve <dir>…` — classify workspace packages as
+ * Flux apps, Nixpacks-style script deferrals, or libraries to skip.
+ */ /** Preferred package scripts for foreign toolchains (Nixpacks-style). */ export const DEFER_SCRIPT_CANDIDATES = [
+    "dev",
+    "serve"
+];
+/**
+ * Normalize a CLI slice token to a `projects/…` prefix without a trailing slash.
+ * `funding` and `projects/funding` both become `projects/funding`.
+ */ export function normalizeSlicePrefix(slice) {
+    const trimmed = slice.replaceAll("\\", "/").replace(/\/+$/, "");
+    if (trimmed === "" || trimmed === ".") {
+        throw new Error("Slice directory must be a non-empty path");
+    }
+    if (trimmed === "projects" || trimmed.startsWith("projects/")) {
+        return trimmed;
+    }
+    return `projects/${trimmed}`;
+}
+/**
+ * True when `projectDirectory` belongs to the slice token.
+ *
+ * Matches:
+ * - nested: `projects/funding`, `projects/funding/api`
+ * - flat dotted package dirs: `projects/funding.web` for token `funding`
+ *
+ * Does not match siblings that only share a string prefix (`funding` vs `funding-fee.api`).
+ */ export function isUnderSlice(projectDirectory, slicePrefix) {
+    const dir = projectDirectory.replaceAll("\\", "/").replace(/\/+$/, "");
+    const prefix = slicePrefix.replaceAll("\\", "/").replace(/\/+$/, "");
+    if (dir === prefix || dir.startsWith(`${prefix}/`)) {
+        return true;
+    }
+    // Flat monorepo packages: projects/<module>.<role>
+    return dir.startsWith(`${prefix}.`);
+}
+export function projectsInSlice(projects, slice) {
+    const prefix = normalizeSlicePrefix(slice);
+    return projects.filter((p)=>isUnderSlice(p.projectDirectory, prefix));
+}
+/** Union of packages under any of the slice tokens (deduped by package name). */ export function projectsInSlices(projects, slices) {
+    const byName = new Map();
+    for (const slice of slices){
+        for (const project of projectsInSlice(projects, slice)){
+            byName.set(project.name, project);
+        }
+    }
+    return [
+        ...byName.values()
+    ];
+}
+/** Script invokes Flux (in-process serve stays on Flux, not deferred). */ export function isFluxOwnedScript(script) {
+    return /\bflux\b/i.test(script);
+}
+/**
+ * First Nixpacks-style serve script that is not Flux-owned.
+ * Prefers `dev`, then `serve`.
+ */ export function resolveDeferScript(scripts) {
+    for (const name of DEFER_SCRIPT_CANDIDATES){
+        const body = scripts[name];
+        if (body != null && body !== "" && !isFluxOwnedScript(body)) {
+            return name;
+        }
+    }
+    return undefined;
+}
+/** Convention: Flux Node apps use `main` ending in `main.ts` / `main.tsx`. */ export function isFluxAppMain(main) {
+    const normalized = main.replaceAll("\\", "/");
+    return /(^|\/)main\.tsx?$/.test(normalized);
+}
+/**
+ * Classify one package. Foreign serve scripts win over `main.ts` (Vite apps
+ * often have a main entry but must not be HMR-booted by Flux).
+ */ export function classifySliceProject(project) {
+    if (resolveDeferScript(project.scripts) != null) {
+        return "defer";
+    }
+    if (isFluxAppMain(project.main)) {
+        return "flux";
+    }
+    return "skip";
+}
+export function classifySliceProjects(projects, slices) {
+    const tokens = typeof slices === "string" ? [
+        slices
+    ] : [
+        ...slices
+    ];
+    const inSlice = projectsInSlices(projects, tokens);
+    const flux = [];
+    const defer = [];
+    const skip = [];
+    for (const project of inSlice){
+        const kind = classifySliceProject(project);
+        if (kind === "flux") flux.push(project);
+        else if (kind === "defer") defer.push(project);
+        else skip.push(project);
+    }
+    return {
+        flux,
+        defer,
+        skip
+    };
+}