@decohere/flux 0.0.1-dev.115 → 0.0.1-dev.116

package/README.md

@@ -2,13 +2,13 @@
 
 In-process TypeScript load for Node.js ESM apps — either one-shot (`flux run`) or hot-reload serve (`flux serve`).
 
-Use Flux when you want to run source `.ts` directly. Flux transpiles with the **Forge** SWC compiler and maps imports to source with path aliases Mesh builds dynamically from the workspace (`package.json` `name` → source `main`). Do not use Flux as a browser bundler, a worker-thread HMR, or a production process manager.
+Use Flux when you want to run source `.ts` directly. Flux transpiles with the **Forge** SWC compiler and maps imports to source with path aliases the workspace package builds dynamically from the workspace (`package.json` `name` → source `main`). Do not use Flux as a browser bundler, a worker-thread HMR, or a production process manager.
 
-Point Flux at a tree of TypeScript packages (`package.json` at each project root). [Mesh](../mesh/README.md) is how that tree is deduced — you do not run Flux against Mesh. Layout and glob overrides: [Mesh — workspace layout](../mesh/README.md#workspace-layout).
+Point Flux at a tree of TypeScript packages (`package.json` at each project root). [`@decohere/workspace`](../workspace/README.md) is how that tree is deduced — you do not run Flux against the workspace package. Layout and glob overrides: [the workspace package — workspace layout](../workspace/README.md#workspace-layout).
 
 This package is the Flux API. You use it through the `flux` CLI (`flux run` / `flux serve`), not by importing `@decohere/flux` from application code. The [Programmatic API](#programmatic-api) is only for embedding Flux in another tool.
 
-Related: [Mesh](../mesh/README.md) (package discovery), [Forge](../forge/README.md) (SWC + debug aliases). The `flux` command ships in `@decohere/cli`.
+Related: [`@decohere/workspace`](../workspace/README.md) (package discovery), [Forge](../forge/README.md) (SWC + debug aliases). The `flux` command ships in `@decohere/cli`.
 
 ## When to use
 
@@ -49,7 +49,7 @@ Scaffolded apps already depend on `@decohere/cli` — use those scripts (`pnpm d
 
 ## CLI
 
-Host options (`--config-file`, `--log-level`) are parsed before the subcommand. `--config-file` (default `.decohere.js` if present) is optional Mesh config for package discovery. Omit it to use [Mesh defaults](../mesh/README.md#workspace-layout).
+Host options (`--config-file`, `--log-level`) are parsed before the subcommand. `--config-file` (default `.decohere.js` if present) is optional workspace config for package discovery. Omit it to use [workspace defaults](../workspace/README.md#workspace-layout).
 
 ### `flux run` — one-shot script
 
@@ -119,7 +119,7 @@ flux serve --reboot-debounce-ms 500
 
 | | What it does |
 |---|---|
-| `flux serve` | Boots the first discovered project (Mesh lists packages by `package.json` `name`, A→Z). |
+| `flux serve` | Boots the first discovered project (the workspace package lists packages by `package.json` `name`, A→Z). |
 | `--project my-api` | Boots that package by name. |
 | `--reboot-debounce-ms 500` | Same serve, but waits 500ms after the last save before rebooting (default 250ms). |
 
@@ -160,13 +160,13 @@ So keep the default. An agent's saves in one go land inside it, and its one-at-a
 
 The `export default { async [Symbol.asyncDispose]() { … } }` in the server example above is that contract. Close servers, pools, and timers there — not in a `process.on("SIGINT")` handler Flux does not own.
 
-**Cortex APIs** scaffold `export default app`. `App.dispose` disposes the Crucible root container, then Scribe. Constructed services that implement `Symbol.asyncDispose` (or `Symbol.dispose`) are torn down automatically — including the HTTP provider. Background work (timers, feeds, pollers) belongs in a [hosted service](../cortex/README.md#hosted-services): its signal is aborted and it is stopped on every reboot, so nothing keeps running into the next one. Put teardown on the service; do not wrap the default export, and do not keep workers in globals across reboots.
+**HTTP APIs** scaffold `export default app`. `App.dispose` disposes the root DI container, then Scribe. Constructed services that implement `Symbol.asyncDispose` (or `Symbol.dispose`) are torn down automatically — including the HTTP provider. Background work (timers, feeds, pollers) belongs in a [hosted service](../http/README.md#hosted-services): its signal is aborted and it is stopped on every reboot, so nothing keeps running into the next one. Put teardown on the service; do not wrap the default export, and do not keep workers in globals across reboots.
 
 Flux clears its reference to the object *before* calling dispose, so a failed boot cannot dispose the same instance twice.
 
 ## Directory slice (`flux serve <token>…`)
 
-A slice is a path token. Flux keeps Mesh packages whose directory sits under that token, then [classifies](#classification-convention) each one. `flux serve shop` and `flux serve projects/shop` are the same token.
+A slice is a path token. Flux keeps workspace packages whose directory sits under that token, then [classifies](#classification-convention) each one. `flux serve shop` and `flux serve projects/shop` are the same token.
 
 Example workspace (every leaf directory here has its own `package.json`):
 
@@ -240,7 +240,7 @@ Only source files (`.ts`) that a served entry imports trigger a reboot.
 
 **Memory grows over a long session.** Each reboot imports changed modules under a new `?version=` URL, and Node's ES module cache never releases the old versions. That's fine for a working day; if a session runs for days with thousands of reboots, restart it.
 
-Flux uses **Forge’s compiler**, with one SWC config per project built once per run. SWC leaves imports as written; Flux's resolve hook maps each one to its TypeScript source: `@scope/pkg` and `@scope/pkg/sub` through the Mesh aliases (and tsconfig `paths`), `./file.js` and `./file` to `file.ts` or `file.tsx`, `./file.mjs` to `file.mts`, `./file.cjs` to `file.cts` (which runs as CommonJS), and `./dir` to `dir/index.ts`. Doing it in one place, instead of in SWC (`jsc.paths`, `resolveFully`) and again in the hook, made loading about 20% faster once Node and SWC are warm (`pnpm bench flux-load`, #513). Before Node imports an entry, Flux compiles it and the files it imports, following their imports out from the entry, in parallel on SWC's thread pool (#661). The load hook is synchronous and would otherwise compile one file at a time; files the app never imports, such as tests, are not compiled. A file that fails to compile there is compiled again when Node loads it, and that load fails with the file's name, as before. That is a debug rule so you can edit a library and hit HMR without a pre-build or `node_modules` workspace symlink. Release still resolves through real `node_modules` (published `exports` / `main`).
+Flux uses **Forge’s compiler**, with one SWC config per project built once per run. SWC leaves imports as written; Flux's resolve hook maps each one to its TypeScript source: `@scope/pkg` and `@scope/pkg/sub` through the the workspace package aliases (and tsconfig `paths`), `./file.js` and `./file` to `file.ts` or `file.tsx`, `./file.mjs` to `file.mts`, `./file.cjs` to `file.cts` (which runs as CommonJS), and `./dir` to `dir/index.ts`. Doing it in one place, instead of in SWC (`jsc.paths`, `resolveFully`) and again in the hook, made loading about 20% faster once Node and SWC are warm (`pnpm bench flux-load`, #513). Before Node imports an entry, Flux compiles it and the files it imports, following their imports out from the entry, in parallel on SWC's thread pool (#661). The load hook is synchronous and would otherwise compile one file at a time; files the app never imports, such as tests, are not compiled. A file that fails to compile there is compiled again when Node loads it, and that load fails with the file's name, as before. That is a debug rule so you can edit a library and hit HMR without a pre-build or `node_modules` workspace symlink. Release still resolves through real `node_modules` (published `exports` / `main`).
 
 Why aliases, and a tree of where a symlink misses `src/index.ts`: [Forge — debug path aliases](../forge/README.md#debug-path-aliases-not-node_modules-links).
 
@@ -266,7 +266,7 @@ server.on("reboot", () => {}); // after dispose + boot attempt for affected entr
 await server.dispose();
 ```
 
-`configuration` is the Mesh/Forge configuration **name** (`debug`, `release`, …), matching `--configuration`. Defaults to `debug`. Pass `workspace` in tests to skip `WorkspaceFactory`.
+`configuration` is the workspace configuration **name** (`debug`, `release`, …), matching `--configuration`. Defaults to `debug`. Pass `workspace` in tests to skip `WorkspaceFactory`.
 
 `flux.run` keeps Node ESM hooks registered for the process so the imported graph can still load `.ts`. Do not dispose the loader after a successful run.
 

package/commonjs/src/deferred-script-runner.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "DeferredScriptRunner", {
 });
 const _nodechild_process = require("node:child_process");
 const _decorators = require("@decohere/crucible/decorators");
-const _interop = require("@decohere/nexus/interop");
+const _interop = require("@decohere/core/interop");
 const _scribe = require("@decohere/scribe");
 function _ts_decorate(decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;

package/commonjs/src/flux.command.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "FluxCommand", {
         return FluxCommand;
     }
 });
-const _cli = require("@decohere/nexus/cli");
+const _cli = require("@decohere/core/cli");
 const _runcommand = require("./run.command.js");
 const _servecommand = require("./serve.command.js");
 class FluxCommand extends _cli.DecohereCommand {

package/commonjs/src/flux.module.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "FluxModule", {
     }
 });
 const _forge = require("@decohere/forge");
-const _cli = require("@decohere/nexus/cli");
+const _cli = require("@decohere/core/cli");
 const _deferredscriptrunner = require("./deferred-script-runner.js");
 const _fluxcommand = require("./flux.command.js");
 const _hotreloadserver = require("./hot-reload-server.js");

package/commonjs/src/hot-reload-server.js

@@ -27,8 +27,8 @@ _export(exports, {
 });
 const _nodeevents = require("node:events");
 const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
-const _io = require("@decohere/nexus/io");
-const _system = require("@decohere/nexus/system");
+const _io = require("@decohere/core/io");
+const _system = require("@decohere/core/system");
 const _scribe = require("@decohere/scribe");
 const _sourcemoduleloader = require("./source-module-loader.js");
 function _interop_require_default(obj) {

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

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "rewriteServeSpecifier", {
 });
 const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
 const _nodeurl = require("node:url");
-const _mesh = require("@decohere/mesh");
+const _workspace = require("@decohere/workspace");
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -35,18 +35,18 @@ function rewriteServeSpecifier(options) {
  * `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(/[/\\]+$/, "");
-    // Mesh's alias lookup may have added `.ts` to a subpath that names a directory (`@lib/models`
+    // 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 = [
-        ..._mesh.sourceExtensions.candidates(withoutSlash),
-        ..._mesh.sourceExtensions.candidates(directory),
-        ..._mesh.sourceExtensions.candidates(_nodepath.default.join(directory, "index"))
+        ..._workspace.sourceExtensions.candidates(withoutSlash),
+        ..._workspace.sourceExtensions.candidates(directory),
+        ..._workspace.sourceExtensions.candidates(_nodepath.default.join(directory, "index"))
     ];
     return candidates.find((candidate)=>isWatchedTs(candidate)) ?? null;
 }
 function resolveRelativeWatchedTs(specifier, parentUrl, isWatchedTs) {
-    if (_mesh.packageAliases.isBareSpecifier(specifier)) return null;
+    if (_workspace.packageAliases.isBareSpecifier(specifier)) return null;
     if (!(specifier.startsWith(".") || specifier.startsWith("/"))) return null;
     const parentClean = parentUrl.split("?")[0];
     if (parentClean == null || parentClean === "") return null;

package/commonjs/src/run.action.js

@@ -9,8 +9,8 @@ Object.defineProperty(exports, "RunAction", {
     }
 });
 const _decorators = require("@decohere/crucible/decorators");
-const _mesh = require("@decohere/mesh");
-const _cli = require("@decohere/nexus/cli");
+const _workspace = require("@decohere/workspace");
+const _cli = require("@decohere/core/cli");
 const _scribe = require("@decohere/scribe");
 const _flux = require("./flux.js");
 function _ts_decorate(decorators, target, key, desc) {
@@ -42,6 +42,6 @@ RunAction = _ts_decorate([
     (0, _decorators.injectable)(),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
-        typeof _mesh.Workspace === "undefined" ? Object : _mesh.Workspace
+        typeof _workspace.Workspace === "undefined" ? Object : _workspace.Workspace
     ])
 ], RunAction);

package/commonjs/src/run.command.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "RunCommand", {
         return RunCommand;
     }
 });
-const _cli = require("@decohere/nexus/cli");
+const _cli = require("@decohere/core/cli");
 const _runaction = require("./run.action.js");
 class RunCommand extends _cli.DecohereCommand {
     get actions() {

package/commonjs/src/serve.action.js

@@ -10,8 +10,8 @@ Object.defineProperty(exports, "ServeAction", {
 });
 const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
 const _decorators = require("@decohere/crucible/decorators");
-const _mesh = require("@decohere/mesh");
-const _cli = require("@decohere/nexus/cli");
+const _workspace = require("@decohere/workspace");
+const _cli = require("@decohere/core/cli");
 const _scribe = require("@decohere/scribe");
 const _deferredscriptrunner = require("./deferred-script-runner.js");
 const _hotreloadserver = require("./hot-reload-server.js");
@@ -114,7 +114,7 @@ ServeAction = _ts_decorate([
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof _hotreloadserver.HotReloadServer === "undefined" ? Object : _hotreloadserver.HotReloadServer,
-        typeof _mesh.Workspace === "undefined" ? Object : _mesh.Workspace,
+        typeof _workspace.Workspace === "undefined" ? Object : _workspace.Workspace,
         typeof _deferredscriptrunner.DeferredScriptRunner === "undefined" ? Object : _deferredscriptrunner.DeferredScriptRunner
     ])
 ], ServeAction);

package/commonjs/src/serve.command.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "ServeCommand", {
         return ServeCommand;
     }
 });
-const _cli = require("@decohere/nexus/cli");
+const _cli = require("@decohere/core/cli");
 const _hotreloadserver = require("./hot-reload-server.js");
 const _serveaction = require("./serve.action.js");
 class ServeCommand extends _cli.DecohereCommand {

package/commonjs/src/slice-serve.js

@@ -1,5 +1,5 @@
 /**
- * Directory-slice helpers for `flux serve <dir>…` — classify Mesh packages as
+ * Directory-slice helpers for `flux serve <dir>…` — classify workspace packages as
  * Flux apps, Nixpacks-style script deferrals, or libraries to skip.
  */ "use strict";
 Object.defineProperty(exports, "__esModule", {

package/commonjs/src/source-module-loader.js

@@ -14,8 +14,8 @@ const _nodepath = /*#__PURE__*/ _interop_require_default(require("node:path"));
 const _nodeurl = require("node:url");
 const _decorators = require("@decohere/crucible/decorators");
 const _forge = require("@decohere/forge");
-const _mesh = require("@decohere/mesh");
-const _io = require("@decohere/nexus/io");
+const _workspace = require("@decohere/workspace");
+const _io = require("@decohere/core/io");
 const _scribe = require("@decohere/scribe");
 const _rewriteservespecifier = require("./rewrite-serve-specifier.js");
 const _staticimports = require("./static-imports.js");
@@ -138,7 +138,7 @@ class SourceModuleLoader {
                     specifier,
                     parentUrl,
                     isWatchedTs: (filePath)=>this.fileInfoMap.has(filePath),
-                    resolveBare: (bare)=>_mesh.packageAliases.resolvePath(bare, this.aliasPaths, this.aliasBaseUrl),
+                    resolveBare: (bare)=>_workspace.packageAliases.resolvePath(bare, this.aliasPaths, this.aliasBaseUrl),
                     versionFileUrl: this.versionFileUrl
                 }) ?? specifier;
                 const result = next(rewritten, context);
@@ -251,7 +251,7 @@ class SourceModuleLoader {
             specifier,
             parentUrl,
             isWatchedTs: (filePath)=>this.fileInfoMap.has(filePath),
-            resolveBare: (bare)=>_mesh.packageAliases.resolvePath(bare, this.aliasPaths, this.aliasBaseUrl),
+            resolveBare: (bare)=>_workspace.packageAliases.resolvePath(bare, this.aliasPaths, this.aliasBaseUrl),
             versionFileUrl: (fileUrl)=>fileUrl
         });
         return url == null ? null : (0, _nodeurl.fileURLToPath)(url);
@@ -259,11 +259,11 @@ class SourceModuleLoader {
     loadTs(url) {
         if (!url.startsWith("file:")) return null;
         // fileURLToPath, not URL.pathname: decodes %20 and gives Windows paths, so files
-        // whose path has a space still match Mesh's list (#511).
+        // whose path has a space still match the workspace's package list (#511).
         const cleanPath = (0, _nodeurl.fileURLToPath)(url);
         const fileInfo = this.fileInfoMap.get(cleanPath);
         if (fileInfo == null) return null;
-        const format = _mesh.sourceExtensions.isCommonJs(cleanPath) ? "commonjs" : "module";
+        const format = _workspace.sourceExtensions.isCommonJs(cleanPath) ? "commonjs" : "module";
         const cached = this.transpileCache.get(cleanPath);
         if (cached != null) return {
             source: cached,
@@ -337,7 +337,7 @@ class SourceModuleLoader {
 	 * directory indexes), so SWC does not resolve them a second time against the disk.
 	 */ swcConfigFor(project, fullPath) {
         const config = this.esModuleConfigFor(project);
-        if (!_mesh.sourceExtensions.isCommonJs(fullPath)) return config;
+        if (!_workspace.sourceExtensions.isCommonJs(fullPath)) return config;
         // `.cts` is CommonJS: Node loads it with `require` semantics, so SWC emits CommonJS (#518).
         // Kept per project, like the ES module options, so the disk cache hashes them once.
         const cached = this.commonJsConfigs.get(project);

package/es6/src/deferred-script-runner.js

@@ -6,7 +6,7 @@ function _ts_decorate(decorators, target, key, desc) {
 }
 import { spawn } from "node:child_process";
 import { injectable } from "@decohere/crucible/decorators";
-import { detectPackageManager, packageManagerFromString } from "@decohere/nexus/interop";
+import { detectPackageManager, packageManagerFromString } from "@decohere/core/interop";
 import { scribe } from "@decohere/scribe";
 export class DeferredScriptRunner {
     logger = scribe.logger(DeferredScriptRunner.name);

package/es6/src/flux.command.js

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/core/cli";
 import { RunCommand } from "./run.command.js";
 import { ServeCommand } from "./serve.command.js";
 export class FluxCommand extends DecohereCommand {

package/es6/src/flux.module.js

@@ -1,5 +1,5 @@
 import { createWorkspace } from "@decohere/forge";
-import { ModuleManifest } from "@decohere/nexus/cli";
+import { ModuleManifest } from "@decohere/core/cli";
 import { DeferredScriptRunner } from "./deferred-script-runner.js";
 import { FluxCommand } from "./flux.command.js";
 import { HotReloadServer } from "./hot-reload-server.js";

package/es6/src/hot-reload-server.js

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
 import path from "node:path";
-import { io } from "@decohere/nexus/io";
-import { debounce } from "@decohere/nexus/system";
+import { io } from "@decohere/core/io";
+import { debounce } from "@decohere/core/system";
 import { scribe } from "@decohere/scribe";
 import { SourceModuleLoader } from "./source-module-loader.js";
 const currentFilePath = io.fileUrlToPath(import.meta.url);

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

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { packageAliases, sourceExtensions } from "@decohere/mesh";
+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
@@ -25,7 +25,7 @@ import { packageAliases, sourceExtensions } from "@decohere/mesh";
  * `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(/[/\\]+$/, "");
-    // Mesh's alias lookup may have added `.ts` to a subpath that names a directory (`@lib/models`
+    // 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 = [

package/es6/src/run.action.js

@@ -8,8 +8,8 @@ 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/mesh";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import { ActionResponse } from "@decohere/core/cli";
 import { scribe } from "@decohere/scribe";
 import { flux } from "./flux.js";
 export class RunAction {

package/es6/src/run.command.js

@@ -1,4 +1,4 @@
-import { ConfigurationOption, DecohereCommand } from "@decohere/nexus/cli";
+import { ConfigurationOption, DecohereCommand } from "@decohere/core/cli";
 import { RunAction } from "./run.action.js";
 export class RunCommand extends DecohereCommand {
     get actions() {

package/es6/src/serve.action.js

@@ -9,8 +9,8 @@ function _ts_metadata(k, v) {
 }
 import path from "node:path";
 import { injectable } from "@decohere/crucible/decorators";
-import { Workspace } from "@decohere/mesh";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import { ActionResponse } from "@decohere/core/cli";
 import { scribe } from "@decohere/scribe";
 import { DeferredScriptRunner } from "./deferred-script-runner.js";
 import { HotReloadServer } from "./hot-reload-server.js";

package/es6/src/serve.command.js

@@ -1,4 +1,4 @@
-import { ConfigurationOption, DecohereCommand, ProjectOption } from "@decohere/nexus/cli";
+import { ConfigurationOption, DecohereCommand, ProjectOption } from "@decohere/core/cli";
 import { DEFAULT_REBOOT_DEBOUNCE_MS, resolveRebootDebounceMs } from "./hot-reload-server.js";
 import { ServeAction } from "./serve.action.js";
 export class ServeCommand extends DecohereCommand {

package/es6/src/slice-serve.js

@@ -1,5 +1,5 @@
 /**
- * Directory-slice helpers for `flux serve <dir>…` — classify Mesh packages as
+ * 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",

package/es6/src/source-module-loader.js

@@ -10,8 +10,8 @@ import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { injectable } from "@decohere/crucible/decorators";
 import { BuildTargets, createWorkspace, SwcTranspiler } from "@decohere/forge";
-import { packageAliases, sourceExtensions } from "@decohere/mesh";
-import { FileEx, io } from "@decohere/nexus/io";
+import { packageAliases, sourceExtensions } from "@decohere/workspace";
+import { FileEx, io } from "@decohere/core/io";
 import { scribe } from "@decohere/scribe";
 import { rewriteServeSpecifier } from "./rewrite-serve-specifier.js";
 import { staticImports } from "./static-imports.js";
@@ -203,7 +203,7 @@ export class SourceModuleLoader {
     loadTs(url) {
         if (!url.startsWith("file:")) return null;
         // fileURLToPath, not URL.pathname: decodes %20 and gives Windows paths, so files
-        // whose path has a space still match Mesh's list (#511).
+        // whose path has a space still match the workspace's package list (#511).
         const cleanPath = fileURLToPath(url);
         const fileInfo = this.fileInfoMap.get(cleanPath);
         if (fileInfo == null) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/flux",
-  "version": "0.0.1-dev.115",
+  "version": "0.0.1-dev.116",
   "description": "Hot module reload server for Node.js ESM applications",
   "keywords": [
     "typescript",
@@ -25,11 +25,11 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/crucible": "0.0.1-dev.115",
-    "@decohere/forge": "0.0.1-dev.115",
-    "@decohere/mesh": "0.0.1-dev.115",
-    "@decohere/nexus": "0.0.1-dev.115",
-    "@decohere/scribe": "0.0.1-dev.115",
+    "@decohere/core": "0.0.1-dev.116",
+    "@decohere/crucible": "0.0.1-dev.116",
+    "@decohere/forge": "0.0.1-dev.116",
+    "@decohere/scribe": "0.0.1-dev.116",
+    "@decohere/workspace": "0.0.1-dev.116",
     "commander": "^13.1.0",
     "rxjs": "^7.8.2"
   },

package/types/src/flux.command.d.ts

@@ -1,5 +1,5 @@
-import type { Actions } from "@decohere/nexus/cli";
-import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/nexus/cli";
+import type { Actions } from "@decohere/core/cli";
+import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/core/cli";
 export declare class FluxCommand extends DecohereCommand {
     constructor(commands: Record<string, CommandType>, handler: CommandHandler);
     run(_actions: Actions, _options: never): Promise<CommandResponse>;

package/types/src/flux.d.ts

@@ -1,7 +1,7 @@
-import type { Workspace } from "@decohere/mesh";
+import type { Workspace } from "@decohere/workspace";
 import { HotReloadServer } from "./hot-reload-server.js";
 export type FluxRunOptions = {
-    /** Mesh/Forge configuration name. Defaults to `debug` (`--configuration`). */
+    /** Workspace configuration name. Defaults to `debug` (`--configuration`). */
     configuration?: string;
     /** Arguments forwarded to the entry (bin-style `process.argv.slice(2)`). */
     args?: string[];
@@ -12,7 +12,7 @@ export type FluxRunOptions = {
     workspace?: Workspace;
 };
 export type FluxServeOptions = {
-    /** Mesh/Forge configuration name. Defaults to `debug` (`--configuration`). */
+    /** Workspace configuration name. Defaults to `debug` (`--configuration`). */
     configuration?: string;
     /** Name of the project to serve. Defaults to the first project in the workspace. */
     project?: string;

package/types/src/flux.module.d.ts

@@ -1,6 +1,6 @@
-import type { WorkspaceFactoryOptions } from "@decohere/nexus/cli";
-import { ModuleManifest } from "@decohere/nexus/cli";
-import type { ContainerBuilder } from "@decohere/nexus/composition";
+import type { WorkspaceFactoryOptions } from "@decohere/core/cli";
+import { ModuleManifest } from "@decohere/core/cli";
+import type { ContainerBuilder } from "@decohere/core/composition";
 import { FluxCommand } from "./flux.command.js";
 import { RunAction } from "./run.action.js";
 import { ServeAction } from "./serve.action.js";
@@ -12,5 +12,5 @@ export declare class FluxModule extends ModuleManifest {
         run: typeof RunAction;
     };
     registerServices(builder: ContainerBuilder): void;
-    createWorkspace(options: WorkspaceFactoryOptions): Promise<import("@decohere/mesh").Workspace>;
+    createWorkspace(options: WorkspaceFactoryOptions): Promise<import("@decohere/workspace").Workspace>;
 }

package/types/src/hot-reload-server.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import type { Workspace } from "@decohere/mesh";
+import type { Workspace } from "@decohere/workspace";
 /** Default quiet window before a file-change reboot. */
 export declare const DEFAULT_REBOOT_DEBOUNCE_MS = 250;
 export declare function resolveRebootDebounceMs(value: number | undefined): number;

package/types/src/run.action.d.ts

@@ -1,5 +1,5 @@
-import { Workspace } from "@decohere/mesh";
-import { type Action, ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import { type Action, ActionResponse } from "@decohere/core/cli";
 export type RunOptions = {
     /** Absolute or cwd-relative path to a `.ts` entry file. */
     entry: string;

package/types/src/run.command.d.ts

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/core/cli";
 import { RunAction } from "./run.action.js";
 export declare class RunCommand extends DecohereCommand {
     get actions(): (typeof RunAction)[];

package/types/src/serve.action.d.ts

@@ -1,5 +1,5 @@
-import { Workspace } from "@decohere/mesh";
-import { type Action, ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import { type Action, ActionResponse } from "@decohere/core/cli";
 import { DeferredScriptRunner } from "./deferred-script-runner.js";
 import { HotReloadServer } from "./hot-reload-server.js";
 export type ServeOptions = {

package/types/src/serve.command.d.ts

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/core/cli";
 import { ServeAction } from "./serve.action.js";
 export declare class ServeCommand extends DecohereCommand {
     get actions(): (typeof ServeAction)[];

package/types/src/slice-serve.d.ts

@@ -1,5 +1,5 @@
 /**
- * Directory-slice helpers for `flux serve <dir>…` — classify Mesh packages as
+ * Directory-slice helpers for `flux serve <dir>…` — classify workspace packages as
  * Flux apps, Nixpacks-style script deferrals, or libraries to skip.
  */
 export type SliceProjectView = {

package/types/src/source-module-loader.d.ts

@@ -1,5 +1,5 @@
 import type { ResolveFnOutput } from "node:module";
-import type { Project, Workspace } from "@decohere/mesh";
+import type { Project, Workspace } from "@decohere/workspace";
 export interface SourceModuleLoaderOptions {
     /** Build configuration name. */
     buildConfig: string;