@decohere/forge 0.0.1-dev.20 → 0.0.1-dev.20261105.46

package/es6/src/workspace.config.js

@@ -1,11 +1,20 @@
-import { WorkspaceDefaults as BaseDefaults } from "@decohere/mesh";
+import { WorkspaceDefaults as BaseDefaults } from "@decohere/workspace";
 import { BuildTargets } from "./types/build-target.type.js";
 export const Debug = {
     name: "debug",
     targets: [
         BuildTargets.es6
     ],
-    aliasPaths: true
+    aliasPaths: true,
+    // Fixtures are runtime inputs (often raw .ts / configs), not library sources.
+    ignore: [
+        "**/__fixtures__/**"
+    ],
+    copyFiles: [
+        "**/__fixtures__/**",
+        "**/.decohere.js",
+        "**/.decohere.*.js"
+    ]
 };
 export const Release = {
     name: "release",
@@ -15,11 +24,22 @@ export const Release = {
         BuildTargets.es6,
         BuildTargets.types
     ],
+    // Published output: no inline maps (they carry full source and build-machine paths).
+    sourceMaps: false,
+    // Tests and benchmarks are not shipped: they import dev-only packages (vitest, @swc/core).
     ignore: [
         "**/*.spec.ts",
         "**/*.test.ts",
+        "**/*.bench.ts",
         "tests/**",
-        "e2e/**"
+        "e2e/**",
+        "bench/**"
+    ],
+    // Sit next to emitted JS under es6/commonjs/types (import.meta.url).
+    // Do not put package.json here — that stays on workspace copyFiles (root only).
+    copyFiles: [
+        "**/webapi/devcontainer/templates/**",
+        "**/webapi/devcontainer/codebase-rag-mcp.ts"
     ]
 };
 /**
@@ -41,12 +61,13 @@ export const DefaultConfigurations = [
 ];
 export const WorkspaceDefaults = {
     ...BaseDefaults,
+    // Root-only files npm ships with the package. Globs that match nothing are fine.
     copyFiles: [
         "package.json",
+        "README.md",
+        "LICENSE*",
         "**/*.mjs"
     ],
     configurations: DefaultConfigurations,
     projects: undefined
 };
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZvcmdlL3NyYy93b3Jrc3BhY2UuY29uZmlnLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IFdvcmtzcGFjZURlZmF1bHRzIGFzIEJhc2VEZWZhdWx0cyB9IGZyb20gXCJAZGVjb2hlcmUvbWVzaFwiO1xuaW1wb3J0IHsgQnVpbGRUYXJnZXRzIH0gZnJvbSBcIi4vdHlwZXMvYnVpbGQtdGFyZ2V0LnR5cGUuanNcIjtcbmltcG9ydCB0eXBlIHsgRm9yZ2VDb25maWd1cmF0aW9uIH0gZnJvbSBcIi4vdHlwZXMvY29uZmlndXJhdGlvbi50eXBlLmpzXCI7XG5pbXBvcnQgdHlwZSB7IFdvcmtzcGFjZU9wdGlvbnMgfSBmcm9tIFwiLi90eXBlcy93b3Jrc3BhY2UtY29uZmlnLnR5cGUuanNcIjtcblxuZXhwb3J0IGNvbnN0IERlYnVnOiBGb3JnZUNvbmZpZ3VyYXRpb24gPSB7XG5cdG5hbWU6IFwiZGVidWdcIixcblx0dGFyZ2V0czogW0J1aWxkVGFyZ2V0cy5lczZdLFxuXHRhbGlhc1BhdGhzOiB0cnVlLFxufTtcblxuZXhwb3J0IGNvbnN0IFJlbGVhc2U6IEZvcmdlQ29uZmlndXJhdGlvbiA9IHtcblx0bmFtZTogXCJyZWxlYXNlXCIsXG5cdHBhY2s6IHRydWUsXG5cdHRhcmdldHM6IFtCdWlsZFRhcmdldHMuY29tbW9uanMsIEJ1aWxkVGFyZ2V0cy5lczYsIEJ1aWxkVGFyZ2V0cy50eXBlc10sXG5cdGlnbm9yZTogW1wiKiovKi5zcGVjLnRzXCIsIFwiKiovKi50ZXN0LnRzXCIsIFwidGVzdHMvKipcIiwgXCJlMmUvKipcIl0sXG59O1xuXG4vKipcbiAqIExpbmsgY29uZmlndXJhdGlvbjogdW5wYWNrZWQgSlMgKyBjby1sb2NhdGVkIHR5cGUgZGVjbGFyYXRpb25zLlxuICogSW50ZW5kZWQgZm9yIGBmb3JnZSBsaW5rYCDigJQgc3ltbGlua2VkIGludG8gYSBjb25zdW1lcidzIG5vZGVfbW9kdWxlcyBzbyB0aGF0XG4gKiBib3RoIHJ1bnRpbWUgcmVzb2x1dGlvbiBhbmQgVHlwZVNjcmlwdCBmaW5kIHRoZSBzYW1lIG91dHB1dCBkaXJlY3RvcnkuXG4gKi9cbmV4cG9ydCBjb25zdCBMaW5rOiBGb3JnZUNvbmZpZ3VyYXRpb24gPSB7XG5cdG5hbWU6IFwibGlua1wiLFxuXHRwYWNrOiB0cnVlLFxuXHR0YXJnZXRzOiBbQnVpbGRUYXJnZXRzLmVzNiwgQnVpbGRUYXJnZXRzLnR5cGVzXSxcbn07XG5cbmV4cG9ydCBjb25zdCBEZWZhdWx0Q29uZmlndXJhdGlvbnMgPSBbRGVidWcsIExpbmssIFJlbGVhc2VdO1xuXG5leHBvcnQgY29uc3QgV29ya3NwYWNlRGVmYXVsdHM6IFdvcmtzcGFjZU9wdGlvbnMgPSB7XG5cdC4uLkJhc2VEZWZhdWx0cyxcblx0Y29weUZpbGVzOiBbXCJwYWNrYWdlLmpzb25cIiwgXCIqKi8qLm1qc1wiXSxcblx0Y29uZmlndXJhdGlvbnM6IERlZmF1bHRDb25maWd1cmF0aW9ucyxcblx0cHJvamVjdHM6IHVuZGVmaW5lZCxcbn07XG4iXSwibmFtZXMiOlsiV29ya3NwYWNlRGVmYXVsdHMiLCJCYXNlRGVmYXVsdHMiLCJCdWlsZFRhcmdldHMiLCJEZWJ1ZyIsIm5hbWUiLCJ0YXJnZXRzIiwiZXM2IiwiYWxpYXNQYXRocyIsIlJlbGVhc2UiLCJwYWNrIiwiY29tbW9uanMiLCJ0eXBlcyIsImlnbm9yZSIsIkxpbmsiLCJEZWZhdWx0Q29uZmlndXJhdGlvbnMiLCJjb3B5RmlsZXMiLCJjb25maWd1cmF0aW9ucyIsInByb2plY3RzIiwidW5kZWZpbmVkIl0sIm1hcHBpbmdzIjoiQUFBQSxTQUFTQSxxQkFBcUJDLFlBQVksUUFBUSxpQkFBaUI7QUFDbkUsU0FBU0MsWUFBWSxRQUFRLCtCQUErQjtBQUk1RCxPQUFPLE1BQU1DLFFBQTRCO0lBQ3hDQyxNQUFNO0lBQ05DLFNBQVM7UUFBQ0gsYUFBYUksR0FBRztLQUFDO0lBQzNCQyxZQUFZO0FBQ2IsRUFBRTtBQUVGLE9BQU8sTUFBTUMsVUFBOEI7SUFDMUNKLE1BQU07SUFDTkssTUFBTTtJQUNOSixTQUFTO1FBQUNILGFBQWFRLFFBQVE7UUFBRVIsYUFBYUksR0FBRztRQUFFSixhQUFhUyxLQUFLO0tBQUM7SUFDdEVDLFFBQVE7UUFBQztRQUFnQjtRQUFnQjtRQUFZO0tBQVM7QUFDL0QsRUFBRTtBQUVGOzs7O0NBSUMsR0FDRCxPQUFPLE1BQU1DLE9BQTJCO0lBQ3ZDVCxNQUFNO0lBQ05LLE1BQU07SUFDTkosU0FBUztRQUFDSCxhQUFhSSxHQUFHO1FBQUVKLGFBQWFTLEtBQUs7S0FBQztBQUNoRCxFQUFFO0FBRUYsT0FBTyxNQUFNRyx3QkFBd0I7SUFBQ1g7SUFBT1U7SUFBTUw7Q0FBUSxDQUFDO0FBRTVELE9BQU8sTUFBTVIsb0JBQXNDO0lBQ2xELEdBQUdDLFlBQVk7SUFDZmMsV0FBVztRQUFDO1FBQWdCO0tBQVc7SUFDdkNDLGdCQUFnQkY7SUFDaEJHLFVBQVVDO0FBQ1gsRUFBRSJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/forge",
-  "version": "0.0.1-dev.20",
+  "version": "0.0.1-dev.20261105.46",
   "description": "TypeScript monorepo build system — zero config, fast compilation, streamlined developer workflow",
   "keywords": [
     "typescript",
@@ -10,6 +10,15 @@
     "swc",
     "decohere"
   ],
+  "homepage": "https://github.com/typesmiths/decohere/tree/main/projects/forge#readme",
+  "bugs": {
+    "url": "https://github.com/typesmiths/decohere/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/typesmiths/decohere.git",
+    "directory": "projects/forge"
+  },
   "license": "ISC",
   "author": "Typesmiths",
   "type": "module",
@@ -19,6 +28,11 @@
       "import": "./es6/src/index.js",
       "require": "./commonjs/src/index.js"
     },
+    "./transpile": {
+      "types": "./types/src/transpile/index.d.ts",
+      "import": "./es6/src/transpile/index.js",
+      "require": "./commonjs/src/transpile/index.js"
+    },
     "./vitest": {
       "types": "./types/src/vitest/index.d.ts",
       "import": "./es6/src/vitest/index.js",
@@ -29,14 +43,14 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/crucible": "0.0.1-dev.20",
-    "@decohere/mesh": "0.0.1-dev.20",
-    "@decohere/nexus": "0.0.1-dev.20",
-    "@decohere/scribe": "0.0.1-dev.20",
+    "@decohere/core": "0.0.1-dev.20261105.46",
+    "@decohere/crucible": "0.0.1-dev.20261105.46",
+    "@decohere/devkit": "0.0.1-dev.20261105.46",
+    "@decohere/scribe": "0.0.1-dev.20261105.46",
+    "@decohere/workspace": "0.0.1-dev.20261105.46",
     "@swc/core": "^1.11.11",
     "async": "^3.2.6",
     "parse-imports": "^2.2.1",
-    "rxjs": "^7.8.2",
     "typescript": "^6.0.3"
   },
   "devDependencies": {}

package/types/src/actions/build.action.d.ts

@@ -1,7 +1,7 @@
-import type { Project } from "@decohere/mesh";
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Project } from "@decohere/workspace";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import { FileWriterService } from "../services/file-writer.service.js";
 import type { TransformResponse } from "../types/transform-response.model.js";
 import { type Transformer } from "../types/transformer.type.js";

package/types/src/actions/clean.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type CleanOptions = {
     clean: boolean;
     configuration: string;

package/types/src/actions/commit.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type CommitFilesOptions = {
     configuration?: string;
     commit?: boolean;

package/types/src/actions/copy.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type CopyOptions = {
     copy: boolean;
     configuration: string;
@@ -10,5 +10,20 @@ export declare class Copy implements Action<CopyOptions> {
     private readonly workspace;
     constructor(workspace: Workspace);
     run: (options: CopyOptions) => Promise<ActionResponse>;
+    /**
+     * A package without a LICENSE of its own ships the workspace's, so a monorepo
+     * licensed once at the root still puts the license text in every tarball.
+     */
+    private copyWorkspaceLicense;
+    /**
+     * Packed builds emit JS under `<out>/<target>/` (e.g. `es6/`). Assets listed on
+     * the *configuration* `copyFiles` (not the workspace defaults) are also copied
+     * into each target so `import.meta.url` resolves them beside that JS.
+     *
+     * Workspace `copyFiles` (e.g. `package.json`) stay root-only — nesting a
+     * package manifest under `es6/` makes `npm install --install-links` drop the
+     * parent's `es6/` tree when packing `file:` deps.
+     */
+    private copyColocatedPackAssets;
     private copyFileToOut;
 }

package/types/src/actions/dependency-report.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import { DependencyResolver } from "../services/dependency-resolver.service.js";
 import type { DependencyWarning, DriftEntry } from "../types/dependency.types.js";
 type ReportOptions = {

package/types/src/actions/dependency-sync.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import { DependencyResolver } from "../services/dependency-resolver.service.js";
 import type { SyncprojectResult } from "../types/dependency.types.js";
 export type DependenciesOptions = {

package/types/src/actions/docker.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action, ResultStatus } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type DockerOptions = {
     configuration: string;
     dryRun?: boolean;
@@ -19,9 +19,20 @@ export declare class Docker implements Action<DockerOptions> {
     constructor(workspace: Workspace);
     run(options: DockerOptions): Promise<ActionResponse<DockerResponse>>;
     private getDockerProjects;
+    /**
+     * A Dockerfile that copies `.package/` needs `forge package` to have run. Fail before the
+     * build with that instruction rather than with Docker's "not found" from deep in a layer.
+     */
+    private assertPackaged;
     private buildProject;
     private interpolateBuildArgs;
+    /**
+     * Keep FORGE_DOCKER_EXTRA_TAGS_JSON scoped to this image so multi-image
+     * publishes do not stamp create:latest onto the app Dev Container (and vice versa).
+     */
+    private extraTagsForImage;
     private defaultImageName;
     private normalizeDockerRepository;
+    private normalizeProjectSlug;
     private parseJsonEnv;
 }

package/types/src/actions/index.d.ts

@@ -6,9 +6,12 @@ export * from "./dependency-report.action.js";
 export * from "./dependency-sync.action.js";
 export * from "./docker.action.js";
 export * from "./link.action.js";
+export * from "./package.action.js";
+export * from "./paths.action.js";
 export * from "./publish.action.js";
 export * from "./sync-lock-file.action.js";
 export * from "./tag.action.js";
+export * from "./typecheck.action.js";
 export * from "./unlink.action.js";
 export * from "./version.action.js";
 export * from "./watch.action.js";

package/types/src/actions/link.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import "../extensions/project.extensions.js";
 export declare const LINK_MANIFEST = ".forge-link.json";
 export type LinkOptions = {

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

@@ -0,0 +1,38 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { DependencyPinner } from "../packaging/dependency-pinner.service.js";
+import { ImportGraph } from "../packaging/import-graph.service.js";
+export type PackageOptions = {
+    /** Package name of one deployable. Omit to package every project that has a Dockerfile. */
+    project?: string;
+};
+export type PackageResponse = ResultStatus & {
+    projectName: string;
+    outDir: string;
+    workspacePackages: string[];
+    dependencies: Record<string, string>;
+    message: string;
+};
+/**
+ * Turns a deployable's release build into one self-contained folder that plain `node` runs:
+ * no symlinks, no workspace tooling. See ADR 0006.
+ */
+export declare class PackageDeployable implements Action<PackageOptions> {
+    #private;
+    private readonly workspace;
+    private readonly importGraph;
+    private readonly pinner;
+    private readonly npm;
+    constructor(workspace: Workspace, importGraph: ImportGraph, pinner: DependencyPinner);
+    run(options: PackageOptions): Promise<ActionResponse<PackageResponse>>;
+    /** The deployables to package, or the reason a named project cannot be one. */
+    private select;
+    private releaseProjects;
+    private packageProject;
+    private write;
+    /** Copies file contents, never links: a symlink in the output would break outside the image. */
+    private copyTree;
+    private writeJson;
+    private assertNoSymlinks;
+}

package/types/src/actions/paths.action.d.ts

@@ -0,0 +1,28 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+export declare const PATHS_FILE = "tsconfig.paths.json";
+export type PathsOptions = {
+    /** Fail if the file is missing or out of date, instead of writing it. */
+    check?: boolean;
+};
+export type PathsResponse = {
+    file: string;
+    changed: boolean;
+    succeeded: boolean;
+    error?: string;
+};
+/**
+ * Writes `tsconfig.paths.json`: tsconfig `paths` for every workspace package and the subpaths it
+ * exports, from the workspace aliases. Without `node_modules` links, `tsc` finds workspace
+ * packages only through `paths`; generating them keeps them in step with what Flux, the Vitest
+ * plugin and builds resolve. The root tsconfig extends the file.
+ */
+export declare class Paths implements Action<PathsOptions> {
+    #private;
+    private readonly workspace;
+    constructor(workspace: Workspace);
+    run(options: PathsOptions): Promise<ActionResponse<PathsResponse>>;
+    /** The file's content: convention and exported subpaths only, never the tsconfig's own paths. */
+    static render(workspace: Workspace): string;
+}

package/types/src/actions/publish.action.d.ts

@@ -1,7 +1,7 @@
-import type { Project } from "@decohere/mesh";
-import { Workspace } from "@decohere/mesh";
-import type { Action, ResultStatus } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Project } from "@decohere/workspace";
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type PublishOptions = {
     configuration: string;
     channel?: string;

package/types/src/actions/sync-lock-file.action.d.ts

@@ -1,5 +1,5 @@
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type SyncLockFileOptions = {
     sync?: boolean;
     dryRun?: boolean;

package/types/src/actions/tag.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type TagOptions = {
     prefix?: string;
     dryRun?: boolean;

package/types/src/actions/typecheck.action.d.ts

@@ -0,0 +1,14 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { TypeEmitter } from "../services/type-emitter.js";
+export type TypeCheckOptions = {
+    configuration: string;
+};
+export declare class TypeCheck implements Action<TypeCheckOptions> {
+    #private;
+    private readonly workspace;
+    private readonly typeEmitter;
+    constructor(workspace: Workspace, typeEmitter: TypeEmitter);
+    run: (options: TypeCheckOptions) => Promise<ActionResponse>;
+}

package/types/src/actions/unlink.action.d.ts

@@ -1,5 +1,5 @@
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type UnlinkOptions = {
     targetDir: string;
 };

package/types/src/actions/version.action.d.ts

@@ -1,7 +1,7 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action, ResultStatus } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
-import { type VersionType } from "@decohere/nexus/semver";
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { type VersionType } from "../semver/index.js";
 export type VersionResponse = ResultStatus & {
     name: string;
 };
@@ -11,6 +11,12 @@ export type VersionOptions = {
     releaseType?: VersionType;
     channel?: string;
     version?: string;
+    /** A CI run number: the version becomes `<base>-<channel>.<commit's UTC date>.<number>`. */
+    buildNumber?: string;
+    /** Copy the version from the built packages, failing if they don't all match. */
+    fromBuild?: boolean;
+    /** The build `fromBuild` reads. */
+    configuration?: string;
     dryRun?: boolean;
     commit?: boolean;
     message?: string;
@@ -23,6 +29,10 @@ export declare class Version implements Action<VersionOptions> {
     constructor(workspace: Workspace);
     run(options: VersionOptions): Promise<ActionResponse>;
     version(workspace: Workspace, options?: VersionOptions): Promise<ActionResponse<VersionResponse>>;
+    private resolveNextVersion;
+    private versionFromBuildNumber;
+    private versionFromBuild;
+    private readBuiltVersion;
     private resolveBaseVersion;
     private resolveVersionFromGitTag;
     /**

package/types/src/actions/watch.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type WatchOptions = {
     watch: boolean;
     configuration: string;

package/types/src/commands/build.command.d.ts

@@ -1,5 +1,5 @@
-import type { MergeOptions } from "@decohere/nexus/cli";
-import { CommandResponse, DecohereCommand } from "@decohere/nexus/cli";
+import type { MergeOptions } from "@decohere/devkit/cli";
+import { CommandResponse, DecohereCommand } from "@decohere/devkit/cli";
 import type { Build } from "../actions/build.action.js";
 import type { Clean } from "../actions/clean.action.js";
 import type { Copy } from "../actions/copy.action.js";
@@ -12,5 +12,6 @@ export type BuildActions = {
 };
 export declare class BuildCommand extends DecohereCommand<BuildActions> {
     constructor(name?: string);
+    runsUntilStopped(options: Record<string, unknown>): boolean;
     run: (actions: BuildActions, options: MergeOptions<BuildActions>) => Promise<CommandResponse<BuildActions>>;
 }

package/types/src/commands/dependency.command.d.ts

@@ -1,5 +1,5 @@
-import type { CommandHandler } from "@decohere/nexus/cli";
-import { DecohereCommand } from "@decohere/nexus/cli";
+import type { CommandHandler } from "@decohere/devkit/cli";
+import { DecohereCommand } from "@decohere/devkit/cli";
 export declare class DependencyCommand extends DecohereCommand {
     constructor(name?: string, handler?: CommandHandler);
 }

package/types/src/commands/docker.command.d.ts

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

package/types/src/commands/forge.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/devkit/cli";
+import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/devkit/cli";
 export declare class ForgeCommand extends DecohereCommand {
     constructor(commands: Record<string, CommandType>, handler: CommandHandler);
     run(_actions: Actions, _options: never): Promise<CommandResponse>;

package/types/src/commands/index.d.ts

@@ -3,6 +3,9 @@ export * from "./dependency.command.js";
 export * from "./docker.command.js";
 export * from "./forge.command.js";
 export * from "./link.command.js";
+export * from "./package.command.js";
+export * from "./paths.command.js";
 export * from "./publish.command.js";
 export * from "./tag.command.js";
+export * from "./typecheck.command.js";
 export * from "./version.command.js";

package/types/src/commands/link.command.d.ts

@@ -1,5 +1,5 @@
-import type { CommandHandler, MergeOptions } from "@decohere/nexus/cli";
-import { CommandResponse, DecohereCommand } from "@decohere/nexus/cli";
+import type { CommandHandler, MergeOptions } from "@decohere/devkit/cli";
+import { CommandResponse, DecohereCommand } from "@decohere/devkit/cli";
 import { Build } from "../actions/build.action.js";
 import { Clean } from "../actions/clean.action.js";
 import { Copy } from "../actions/copy.action.js";
@@ -19,6 +19,7 @@ type UnlinkActions = {
 export declare class LinkCommand extends DecohereCommand<LinkActions> {
     get actions(): (typeof Build | typeof Clean | typeof Copy | typeof Link | typeof Watch)[];
     constructor(name?: string);
+    runsUntilStopped(options: Record<string, unknown>): boolean;
     run: (actions: LinkActions, options: MergeOptions<LinkActions>) => Promise<CommandResponse<LinkActions>>;
 }
 export declare class UnlinkCommand extends DecohereCommand<UnlinkActions> {

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

@@ -0,0 +1,11 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { PackageDeployable } from "../actions/package.action.js";
+export declare class PackageCommand extends DecohereCommand {
+    get actions(): (typeof PackageDeployable)[];
+    constructor(name: string);
+    /**
+     * Commander passes the positional before the options; the CLI host reads only options,
+     * so the project name is stashed on them.
+     */
+    action(fn: (...args: any[]) => void | Promise<void>): this;
+}

package/types/src/commands/paths.command.d.ts

@@ -0,0 +1,6 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { Paths } from "../actions/paths.action.js";
+export declare class PathsCommand extends DecohereCommand {
+    get actions(): (typeof Paths)[];
+    constructor(name: string);
+}

package/types/src/commands/publish.command.d.ts

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

package/types/src/commands/tag.command.d.ts

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

package/types/src/commands/typecheck.command.d.ts

@@ -0,0 +1,6 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { TypeCheck } from "../actions/typecheck.action.js";
+export declare class TypeCheckCommand extends DecohereCommand {
+    get actions(): (typeof TypeCheck)[];
+    constructor(name: string);
+}

package/types/src/commands/version.command.d.ts

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/devkit/cli";
 import { SyncLockFile } from "../actions/sync-lock-file.action.js";
 import { Version } from "../actions/version.action.js";
 type VersionActions = {

package/types/src/create-workspace.d.ts

@@ -0,0 +1,7 @@
+import { type Workspace } from "@decohere/workspace";
+import type { WorkspaceFactoryOptions } from "@decohere/devkit/cli";
+/**
+ * The workspace every Decohere tool sees (forge, the flux CLI and `flux.run`): forge's
+ * defaults, the user's `.decohere.js`, and the root: `--root-dir`, else the current folder.
+ */
+export declare function createWorkspace(options?: WorkspaceFactoryOptions): Promise<Workspace>;

package/types/src/errors.d.ts

@@ -1,4 +1,4 @@
-export { WorkspaceConfigurationError } from "@decohere/mesh";
+export { WorkspaceConfigurationError } from "@decohere/workspace";
 export declare class ForgeError extends Error {
 }
 export declare function formatUnknownError(reason: unknown): string;

package/types/src/extensions/project.extensions.d.ts

@@ -1,7 +1,7 @@
-import { Project } from "@decohere/mesh";
+import { Project } from "@decohere/workspace";
 import type { ForgeConfiguration } from "../types/configuration.type.js";
 import { SwcConfig } from "../types/swc-config.type.js";
-declare module "@decohere/mesh" {
+declare module "@decohere/workspace" {
     interface Project {
         getForgeConfiguration(): ForgeConfiguration;
         getSwcConfig(): Promise<SwcConfig>;

package/types/src/factories/swc-config.factory.d.ts

@@ -1,4 +1,4 @@
-import type { FileEx } from "@decohere/nexus/io";
+import type { FileEx } from "@decohere/core/io";
 import type { Options } from "@swc/core";
 import type { TranspileTarget } from "../types/build-target.type.js";
 import type { SwcConfigOptions } from "../types/swc-config.type.js";
@@ -8,8 +8,9 @@ export declare class SwcConfigFactory {
      * Call once per (project, target) and then use createFileConfig() per file.
      */
     createBaseConfig(buildTarget: TranspileTarget, configOptions: SwcConfigOptions): Options;
-    /** Stamps a per-file filename onto a pre-built base config. */
+    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX. */
     createFileConfig(file: FileEx, baseConfig: Options): Options;
+    private static nonemptyPaths;
     /**
      * Validates SWC options against known causes of Rust/NAPI process crashes.
      * Throws a ForgeError with a descriptive message instead of letting the