@decohere/cli 0.0.1-dev.125 → 0.0.1-dev.5

package/README.md

@@ -0,0 +1 @@
+Placeholder package for npm trusted-publisher setup. Ignore this version; CI publishes the real CLI.

package/package.json

@@ -1,54 +1,14 @@
 {
   "name": "@decohere/cli",
-  "version": "0.0.1-dev.125",
-  "description": "CLI for the Decohere toolchain — build, serve, publish, and manage TypeScript monorepos",
-  "keywords": [
-    "typescript",
-    "cli",
-    "monorepo",
-    "build",
-    "decohere"
-  ],
-  "homepage": "https://github.com/typesmiths/decohere/tree/main/projects/cli#readme",
-  "bugs": {
-    "url": "https://github.com/typesmiths/decohere/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/typesmiths/decohere.git",
-    "directory": "projects/cli"
-  },
+  "version": "0.0.1-dev.5",
+  "description": "Bootstrap placeholder so trusted publishing can be configured. Real artifacts ship from CI.",
   "license": "ISC",
   "author": "Typesmiths",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./types/src/index.d.ts",
-      "import": "./es6/src/index.js",
-      "require": "./commonjs/src/index.js"
-    }
-  },
-  "bin": {
-    "decohere": "./es6/src/cli.js",
-    "forge": "./es6/src/forge.js",
-    "flux": "./es6/src/flux.js"
-  },
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "dependencies": {
-    "@decohere/core": "0.0.1-dev.125",
-    "@decohere/create": "0.0.1-dev.125",
-    "@decohere/crucible": "0.0.1-dev.125",
-    "@decohere/devkit": "0.0.1-dev.125",
-    "@decohere/flux": "0.0.1-dev.125",
-    "@decohere/forge": "0.0.1-dev.125",
-    "@decohere/scaffold": "0.0.1-dev.125",
-    "@decohere/scribe": "0.0.1-dev.125",
-    "@decohere/scribe-pino": "0.0.1-dev.125",
-    "@decohere/workspace": "0.0.1-dev.125",
-    "commander": "^13.1.0",
-    "pino-pretty": "^13.1.3"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/typesmiths/decohere.git"
   },
-  "devDependencies": {}
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/LICENSE

@@ -1,15 +0,0 @@
-ISC License
-
-Copyright (c) 2025-2026 Typesmiths
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/commonjs/src/cli.js

@@ -1,31 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-require("./logger.setup.js");
-const _scribe = require("@decohere/scribe");
-const _loglevel = require("./log-level.js");
-const _product = require("./product.js");
-const configIndex = process.argv.indexOf("--config-file");
-const configFile = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
-const logLevelIndex = process.argv.indexOf("--log-level");
-const logLevel = logLevelIndex !== -1 ? process.argv[logLevelIndex + 1] : undefined;
-_scribe.scribe.withPinoPretty({
-    logLevel: (0, _loglevel.cliLogLevel)(logLevel),
-    when: "always"
-});
-const logger = _scribe.scribe.logger("@decohere/cli");
-const app = await _product.productCli.create({
-    configFile,
-    logLevel
-});
-let exitCode = 0;
-try {
-    await app.run();
-} catch (err) {
-    logger.error(err);
-    exitCode = 1;
-} finally{
-    _scribe.scribe.flush(()=>process.exit(exitCode));
-}

package/commonjs/src/flux.js

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-require("./logger.setup.js");
-const _flux = require("@decohere/flux");
-const _scribe = require("@decohere/scribe");
-const _loglevel = require("./log-level.js");
-const _rootmodule = require("./root.module.js");
-const configIndex = process.argv.indexOf("--config-file");
-const configFile = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
-const logLevelIndex = process.argv.indexOf("--log-level");
-const logLevel = logLevelIndex !== -1 ? process.argv[logLevelIndex + 1] : undefined;
-_scribe.scribe.withPinoPretty({
-    logLevel: (0, _loglevel.cliLogLevel)(logLevel),
-    when: "always"
-});
-const logger = _scribe.scribe.logger("@decohere/cli");
-const app = await _rootmodule.RootModule.create([
-    _flux.FluxModule
-], {
-    configFile,
-    logLevel
-});
-try {
-    // Route directly to the flux module — users invoke as `flux serve`, not `flux flux serve`
-    logger.trace("running flux");
-    await app.run([
-        "flux",
-        ...process.argv.slice(2)
-    ]);
-    // Don't force an exit: let the script's pending work (timers, open handles) finish, like
-    // `node script.js` does (#504).
-    _scribe.scribe.flush();
-} catch (err) {
-    logger.error(err);
-    _scribe.scribe.flush(()=>process.exit(1));
-}

package/commonjs/src/forge.js

@@ -1,38 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-require("./logger.setup.js");
-const _forge = require("@decohere/forge");
-const _scribe = require("@decohere/scribe");
-const _loglevel = require("./log-level.js");
-const _rootmodule = require("./root.module.js");
-const configIndex = process.argv.indexOf("--config-file");
-const configFile = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
-const logLevelIndex = process.argv.indexOf("--log-level");
-const logLevel = logLevelIndex !== -1 ? process.argv[logLevelIndex + 1] : undefined;
-_scribe.scribe.withPinoPretty({
-    logLevel: (0, _loglevel.cliLogLevel)(logLevel),
-    when: "always"
-});
-const logger = _scribe.scribe.logger("@decohere/cli");
-const app = await _rootmodule.RootModule.create([
-    _forge.ForgeModule
-], {
-    configFile,
-    logLevel
-});
-let exitCode = 0;
-try {
-    // Route directly to the forge module — users invoke as `forge build`, not `forge forge build`
-    await app.run([
-        "forge",
-        ...process.argv.slice(2)
-    ]);
-} catch (err) {
-    logger.error("Error running forge", err);
-    exitCode = 1;
-} finally{
-    _scribe.scribe.flush(()=>process.exit(exitCode));
-}

package/commonjs/src/log-level.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "cliLogLevel", {
-    enumerable: true,
-    get: function() {
-        return cliLogLevel;
-    }
-});
-const _scribe = require("@decohere/scribe");
-function cliLogLevel(flag) {
-    return (0, _scribe.resolveLogLevel)(flag) ?? (process.env.FORGE_TRACE != null ? "trace" : _scribe.DefaultLogLevel);
-}

package/commonjs/src/logger.setup.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-require("@decohere/scribe-pino");
-require("pino-pretty");

package/commonjs/src/module.factory.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "ModuleFactory", {
-    enumerable: true,
-    get: function() {
-        return ModuleFactory;
-    }
-});
-const _crucible = require("@decohere/crucible");
-class ModuleFactory {
-    static create(module, onResponse, config) {
-        const moduleConfig = config?.[module.id];
-        const actions = {
-            ...module.actions,
-            ...moduleConfig?.actions
-        };
-        const commands = {
-            ...module.commands,
-            ...moduleConfig?.commands
-        };
-        const workspaceOptions = {
-            configFile: config?.configFile,
-            rootDir: config?.rootDir
-        };
-        let container;
-        const handler = async (_optionVals, program)=>{
-            const commandOptions = program.optsWithGlobals();
-            container = await buildContainer(module, actions, workspaceOptions);
-            const resolved = resolveActions(container, actions);
-            const response = await program.run(resolved, commandOptions);
-            onResponse(module.id, response);
-        };
-        const command = new module.command(commands, handler);
-        command.name(module.id);
-        return {
-            id: module.id,
-            command,
-            dispose: ()=>container?.[Symbol.dispose](),
-            asyncDispose: ()=>container?.[Symbol.asyncDispose]()
-        };
-    }
-}
-async function buildContainer(module, actions, workspaceOptions) {
-    const builder = new _crucible.ServiceContainerBuilder();
-    const workspace = await module.createWorkspace(workspaceOptions ?? {});
-    if (workspace !== null) {
-        builder.registerSingleton(workspace.constructor, workspace);
-    }
-    module.registerServices(builder);
-    for (const ActionClass of Object.values(actions)){
-        builder.registerSingleton(ActionClass);
-    }
-    return builder.build();
-}
-function resolveActions(container, actions) {
-    return Object.fromEntries(Object.entries(actions).map(([key, ActionClass])=>[
-            key,
-            container.resolve(ActionClass)
-        ]));
-}

package/commonjs/src/product.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "productCli", {
-    enumerable: true,
-    get: function() {
-        return productCli;
-    }
-});
-const _flux = require("@decohere/flux");
-const _forge = require("@decohere/forge");
-const _rootmodule = require("./root.module.js");
-const _scaffoldhost = require("./scaffold-host.js");
-const modules = [
-    _forge.ForgeModule,
-    _flux.FluxModule,
-    _scaffoldhost.HostCreateModule,
-    _scaffoldhost.HostAddModule,
-    _scaffoldhost.HostAuth0Module
-];
-function create(options) {
-    return _rootmodule.RootModule.create(modules, options);
-}
-const productCli = {
-    create,
-    modules
-};

package/commonjs/src/root.command.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "RootCommand", {
-    enumerable: true,
-    get: function() {
-        return RootCommand;
-    }
-});
-const _workspace = require("@decohere/workspace");
-const _cli = require("@decohere/devkit/cli");
-const _commander = require("commander");
-class RootCommand extends _cli.DecohereCommand {
-    #configFile;
-    constructor(modules, configFile){
-        super();
-        this.#configFile = configFile;
-        this.addOption(new _cli.ConfigFileOption());
-        this.addOption(new _cli.LogLevelOption());
-        this.addOption(new _cli.EnvFileOption());
-        this.addOption(new _cli.EnvFileIfExistsOption());
-        // Explicit opt-in: nothing reads a .env file unless the command line names one.
-        this.hook("preAction", (command)=>{
-            const { envFile, envFileIfExists } = command.opts();
-            if (envFile) process.loadEnvFile(envFile);
-            if (envFileIfExists) loadEnvFileIfExists(envFileIfExists);
-        });
-        for (const mod of modules){
-            this.addCommand(mod.command);
-        }
-    }
-    async parseAsync(argv, options) {
-        if (argv?.includes("--version") || argv?.includes("-V")) {
-            const workspace = await _workspace.WorkspaceFactory.create({
-                configFile: this.#configFile
-            });
-            const version = await workspace.getVersion() ?? "unknown";
-            process.stdout.write(`${version}\n`);
-            throw new _commander.CommanderError(0, "commander.version", version);
-        }
-        return super.parseAsync(argv, options);
-    }
-}
-function loadEnvFileIfExists(path) {
-    try {
-        process.loadEnvFile(path);
-    } catch (err) {
-        if (err.code !== "ENOENT") throw err;
-    }
-}

package/commonjs/src/root.module.js

@@ -1,132 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "RootModule", {
-    enumerable: true,
-    get: function() {
-        return RootModule;
-    }
-});
-const _workspace = require("@decohere/workspace");
-const _cli = require("@decohere/devkit/cli");
-const _diagnostics = require("@decohere/devkit/diagnostics");
-const _commander = require("commander");
-const _modulefactory = require("./module.factory.js");
-const _rootcommand = require("./root.command.js");
-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);
-}
-class RootModule {
-    static async create(moduleTypes, options) {
-        const userConfig = await _workspace.UserConfigFactory.getUserConfig(options?.configFile);
-        return new RootModule(moduleTypes, {
-            ...userConfig,
-            configFile: options?.configFile,
-            rootDir: options?.rootDir
-        });
-    }
-    #command;
-    #modules;
-    #lastResponse = {};
-    #stop;
-    constructor(manifestClasses, config){
-        const modules = manifestClasses.map((ManifestClass)=>{
-            const manifest = new ManifestClass();
-            return _modulefactory.ModuleFactory.create(manifest, this.onResponse, config);
-        });
-        this.#modules = modules;
-        this.#command = new _rootcommand.RootCommand(modules, config.configFile);
-        // Before the command runs, not after it returns: a stop signal while `flux serve` boots
-        // (`docker stop` during start-up) is held for the shutdown below instead of killing the
-        // process before anything is disposed.
-        this.#command.hook("preAction", (_root, actionCommand)=>{
-            if (actionCommand instanceof _cli.DecohereCommand && actionCommand.runsUntilStopped(actionCommand.opts())) {
-                this.#stop ??= stopSignal();
-            }
-        });
-    }
-    onResponse = (_moduleId, response)=>{
-        this.#lastResponse = response;
-    };
-    async run(argv) {
-        try {
-            await this.#command.parseAsync(argv, argv ? {
-                from: "user"
-            } : undefined);
-            if (this.isBlocking(this.#lastResponse)) {
-                this.#stop ??= stopSignal();
-                await this.#stop.received;
-            }
-            return this.#lastResponse;
-        } catch (error) {
-            if (this.isCommanderHelpOrVersion(error)) {
-                return _cli.CommandResponse.help();
-            }
-            throw error;
-        } finally{
-            this.#stop?.dispose();
-            this.#stop = undefined;
-            await this[Symbol.asyncDispose]();
-        }
-    }
-    get commands() {
-        return this.#command.commands;
-    }
-    [Symbol.dispose]() {
-        for (const mod of this.#modules){
-            mod.dispose?.();
-        }
-    }
-    async [Symbol.asyncDispose]() {
-        for (const mod of this.#modules){
-            await mod.asyncDispose?.();
-        }
-    }
-    isBlocking(response) {
-        return Object.values(response).some((r)=>r?.blocking === true);
-    }
-    isCommanderHelpOrVersion(error) {
-        const isCommanderError = error instanceof _commander.CommanderError;
-        const helpCodes = [
-            "commander.helpDisplayed",
-            "commander.version",
-            "commander.help"
-        ];
-        return isCommanderError && helpCodes.includes(error.code);
-    }
-}
-RootModule = _ts_decorate([
-    _diagnostics.Trace,
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        Object,
-        typeof Record === "undefined" ? Object : Record
-    ])
-], RootModule);
-function stopSignal() {
-    let onSignal = ()=>{};
-    const received = new Promise((resolve)=>{
-        onSignal = resolve;
-    });
-    const stop = ()=>{
-        dispose();
-        onSignal();
-    };
-    const dispose = ()=>{
-        process.off("SIGINT", stop);
-        process.off("SIGTERM", stop);
-    };
-    process.once("SIGINT", stop);
-    process.once("SIGTERM", stop);
-    return {
-        received,
-        dispose
-    };
-}

package/commonjs/src/scaffold-host.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get HostAddModule () {
-        return HostAddModule;
-    },
-    get HostAuth0Module () {
-        return HostAuth0Module;
-    },
-    get HostCreateModule () {
-        return HostCreateModule;
-    }
-});
-const _create = require("@decohere/create");
-const _decorators = require("@decohere/crucible/decorators");
-const _scaffold = require("@decohere/scaffold");
-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;
-}
-class HostWebapiAction extends _scaffold.WebapiAction {
-    async run(options) {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            (0, _create.runInBuilder)((0, _create.containerArgvFromHost)(process.argv));
-        }
-        return super.run(options);
-    }
-}
-HostWebapiAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], HostWebapiAction);
-class HostAddApiAction extends _scaffold.AddApiAction {
-    async run(options) {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            (0, _create.runInBuilder)((0, _create.containerArgvFromHost)(process.argv));
-        }
-        return super.run(options);
-    }
-}
-HostAddApiAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], HostAddApiAction);
-class HostCreateModule extends _scaffold.CreateModule {
-    actions = {
-        webapi: HostWebapiAction
-    };
-}
-class HostAddModule extends _scaffold.AddModule {
-    actions = {
-        api: HostAddApiAction
-    };
-}
-class HostAuth0LoginAction extends _scaffold.Auth0LoginAction {
-    async run() {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            (0, _create.runInBuilder)((0, _create.containerArgvFromHost)(process.argv));
-        }
-        return super.run();
-    }
-}
-HostAuth0LoginAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], HostAuth0LoginAction);
-class HostAuth0ConfigureAction extends _scaffold.Auth0ConfigureAction {
-    async run(options) {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            (0, _create.runInBuilder)((0, _create.containerArgvFromHost)(process.argv));
-        }
-        return super.run(options);
-    }
-}
-HostAuth0ConfigureAction = _ts_decorate([
-    (0, _decorators.injectable)()
-], HostAuth0ConfigureAction);
-class HostAuth0Module extends _scaffold.Auth0Module {
-    actions = {
-        login: HostAuth0LoginAction,
-        configure: HostAuth0ConfigureAction
-    };
-}

package/es6/src/cli.js

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-import "./logger.setup.js";
-import { scribe } from "@decohere/scribe";
-import { cliLogLevel } from "./log-level.js";
-import { productCli } from "./product.js";
-const configIndex = process.argv.indexOf("--config-file");
-const configFile = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
-const logLevelIndex = process.argv.indexOf("--log-level");
-const logLevel = logLevelIndex !== -1 ? process.argv[logLevelIndex + 1] : undefined;
-scribe.withPinoPretty({
-    logLevel: cliLogLevel(logLevel),
-    when: "always"
-});
-const logger = scribe.logger("@decohere/cli");
-const app = await productCli.create({
-    configFile,
-    logLevel
-});
-let exitCode = 0;
-try {
-    await app.run();
-} catch (err) {
-    logger.error(err);
-    exitCode = 1;
-} finally{
-    scribe.flush(()=>process.exit(exitCode));
-}

package/es6/src/flux.js

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-import "./logger.setup.js";
-import { FluxModule } from "@decohere/flux";
-import { scribe } from "@decohere/scribe";
-import { cliLogLevel } from "./log-level.js";
-import { RootModule } from "./root.module.js";
-const configIndex = process.argv.indexOf("--config-file");
-const configFile = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
-const logLevelIndex = process.argv.indexOf("--log-level");
-const logLevel = logLevelIndex !== -1 ? process.argv[logLevelIndex + 1] : undefined;
-scribe.withPinoPretty({
-    logLevel: cliLogLevel(logLevel),
-    when: "always"
-});
-const logger = scribe.logger("@decohere/cli");
-const app = await RootModule.create([
-    FluxModule
-], {
-    configFile,
-    logLevel
-});
-try {
-    // Route directly to the flux module — users invoke as `flux serve`, not `flux flux serve`
-    logger.trace("running flux");
-    await app.run([
-        "flux",
-        ...process.argv.slice(2)
-    ]);
-    // Don't force an exit: let the script's pending work (timers, open handles) finish, like
-    // `node script.js` does (#504).
-    scribe.flush();
-} catch (err) {
-    logger.error(err);
-    scribe.flush(()=>process.exit(1));
-}

package/es6/src/forge.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-import "./logger.setup.js";
-import { ForgeModule } from "@decohere/forge";
-import { scribe } from "@decohere/scribe";
-import { cliLogLevel } from "./log-level.js";
-import { RootModule } from "./root.module.js";
-const configIndex = process.argv.indexOf("--config-file");
-const configFile = configIndex !== -1 ? process.argv[configIndex + 1] : undefined;
-const logLevelIndex = process.argv.indexOf("--log-level");
-const logLevel = logLevelIndex !== -1 ? process.argv[logLevelIndex + 1] : undefined;
-scribe.withPinoPretty({
-    logLevel: cliLogLevel(logLevel),
-    when: "always"
-});
-const logger = scribe.logger("@decohere/cli");
-const app = await RootModule.create([
-    ForgeModule
-], {
-    configFile,
-    logLevel
-});
-let exitCode = 0;
-try {
-    // Route directly to the forge module — users invoke as `forge build`, not `forge forge build`
-    await app.run([
-        "forge",
-        ...process.argv.slice(2)
-    ]);
-} catch (err) {
-    logger.error("Error running forge", err);
-    exitCode = 1;
-} finally{
-    scribe.flush(()=>process.exit(exitCode));
-}

package/es6/src/log-level.js

@@ -1,7 +0,0 @@
-import { DefaultLogLevel, resolveLogLevel } from "@decohere/scribe";
-/**
- * The level a bin logs at: `--log-level`, then a level from the environment, then `trace` when
- * FORGE_TRACE is set (so `@trace` timings show), then scribe's default.
- */ export function cliLogLevel(flag) {
-    return resolveLogLevel(flag) ?? (process.env.FORGE_TRACE != null ? "trace" : DefaultLogLevel);
-}

package/es6/src/logger.setup.js

@@ -1,2 +0,0 @@
-import "@decohere/scribe-pino";
-import "pino-pretty";

package/es6/src/module.factory.js

@@ -1,56 +0,0 @@
-import { ServiceContainerBuilder } from "@decohere/crucible";
-/**
- * Wires a ModuleManifest into a fully functional ApplicationModule.
- * Handles DI container setup, action registration/resolution, and
- * forwarding the command response to the caller.
- */ export class ModuleFactory {
-    static create(module, onResponse, config) {
-        const moduleConfig = config?.[module.id];
-        const actions = {
-            ...module.actions,
-            ...moduleConfig?.actions
-        };
-        const commands = {
-            ...module.commands,
-            ...moduleConfig?.commands
-        };
-        const workspaceOptions = {
-            configFile: config?.configFile,
-            rootDir: config?.rootDir
-        };
-        let container;
-        const handler = async (_optionVals, program)=>{
-            const commandOptions = program.optsWithGlobals();
-            container = await buildContainer(module, actions, workspaceOptions);
-            const resolved = resolveActions(container, actions);
-            const response = await program.run(resolved, commandOptions);
-            onResponse(module.id, response);
-        };
-        const command = new module.command(commands, handler);
-        command.name(module.id);
-        return {
-            id: module.id,
-            command,
-            dispose: ()=>container?.[Symbol.dispose](),
-            asyncDispose: ()=>container?.[Symbol.asyncDispose]()
-        };
-    }
-}
-async function buildContainer(module, actions, workspaceOptions) {
-    const builder = new ServiceContainerBuilder();
-    const workspace = await module.createWorkspace(workspaceOptions ?? {});
-    if (workspace !== null) {
-        builder.registerSingleton(workspace.constructor, workspace);
-    }
-    module.registerServices(builder);
-    for (const ActionClass of Object.values(actions)){
-        builder.registerSingleton(ActionClass);
-    }
-    return builder.build();
-}
-function resolveActions(container, actions) {
-    return Object.fromEntries(Object.entries(actions).map(([key, ActionClass])=>[
-            key,
-            container.resolve(ActionClass)
-        ]));
-}

package/es6/src/product.js

@@ -1,18 +0,0 @@
-import { FluxModule } from "@decohere/flux";
-import { ForgeModule } from "@decohere/forge";
-import { RootModule } from "./root.module.js";
-import { HostAddModule, HostAuth0Module, HostCreateModule } from "./scaffold-host.js";
-const modules = [
-    ForgeModule,
-    FluxModule,
-    HostCreateModule,
-    HostAddModule,
-    HostAuth0Module
-];
-function create(options) {
-    return RootModule.create(modules, options);
-}
-/** Shipped `decohere` bin — forge, flux, create, add, auth0. */ export const productCli = {
-    create,
-    modules
-};

package/es6/src/root.command.js

@@ -1,41 +0,0 @@
-import { WorkspaceFactory } from "@decohere/workspace";
-import { ConfigFileOption, DecohereCommand, EnvFileIfExistsOption, EnvFileOption, LogLevelOption } from "@decohere/devkit/cli";
-import { CommanderError } from "commander";
-export class RootCommand extends DecohereCommand {
-    #configFile;
-    constructor(modules, configFile){
-        super();
-        this.#configFile = configFile;
-        this.addOption(new ConfigFileOption());
-        this.addOption(new LogLevelOption());
-        this.addOption(new EnvFileOption());
-        this.addOption(new EnvFileIfExistsOption());
-        // Explicit opt-in: nothing reads a .env file unless the command line names one.
-        this.hook("preAction", (command)=>{
-            const { envFile, envFileIfExists } = command.opts();
-            if (envFile) process.loadEnvFile(envFile);
-            if (envFileIfExists) loadEnvFileIfExists(envFileIfExists);
-        });
-        for (const mod of modules){
-            this.addCommand(mod.command);
-        }
-    }
-    async parseAsync(argv, options) {
-        if (argv?.includes("--version") || argv?.includes("-V")) {
-            const workspace = await WorkspaceFactory.create({
-                configFile: this.#configFile
-            });
-            const version = await workspace.getVersion() ?? "unknown";
-            process.stdout.write(`${version}\n`);
-            throw new CommanderError(0, "commander.version", version);
-        }
-        return super.parseAsync(argv, options);
-    }
-}
-function loadEnvFileIfExists(path) {
-    try {
-        process.loadEnvFile(path);
-    } catch (err) {
-        if (err.code !== "ENOENT") throw err;
-    }
-}

package/es6/src/root.module.js

@@ -1,122 +0,0 @@
-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 { UserConfigFactory } from "@decohere/workspace";
-import { CommandResponse, DecohereCommand } from "@decohere/devkit/cli";
-import { Trace } from "@decohere/devkit/diagnostics";
-import { CommanderError } from "commander";
-import { ModuleFactory } from "./module.factory.js";
-import { RootCommand } from "./root.command.js";
-export class RootModule {
-    static async create(moduleTypes, options) {
-        const userConfig = await UserConfigFactory.getUserConfig(options?.configFile);
-        return new RootModule(moduleTypes, {
-            ...userConfig,
-            configFile: options?.configFile,
-            rootDir: options?.rootDir
-        });
-    }
-    #command;
-    #modules;
-    #lastResponse = {};
-    #stop;
-    constructor(manifestClasses, config){
-        const modules = manifestClasses.map((ManifestClass)=>{
-            const manifest = new ManifestClass();
-            return ModuleFactory.create(manifest, this.onResponse, config);
-        });
-        this.#modules = modules;
-        this.#command = new RootCommand(modules, config.configFile);
-        // Before the command runs, not after it returns: a stop signal while `flux serve` boots
-        // (`docker stop` during start-up) is held for the shutdown below instead of killing the
-        // process before anything is disposed.
-        this.#command.hook("preAction", (_root, actionCommand)=>{
-            if (actionCommand instanceof DecohereCommand && actionCommand.runsUntilStopped(actionCommand.opts())) {
-                this.#stop ??= stopSignal();
-            }
-        });
-    }
-    onResponse = (_moduleId, response)=>{
-        this.#lastResponse = response;
-    };
-    async run(argv) {
-        try {
-            await this.#command.parseAsync(argv, argv ? {
-                from: "user"
-            } : undefined);
-            if (this.isBlocking(this.#lastResponse)) {
-                this.#stop ??= stopSignal();
-                await this.#stop.received;
-            }
-            return this.#lastResponse;
-        } catch (error) {
-            if (this.isCommanderHelpOrVersion(error)) {
-                return CommandResponse.help();
-            }
-            throw error;
-        } finally{
-            this.#stop?.dispose();
-            this.#stop = undefined;
-            await this[Symbol.asyncDispose]();
-        }
-    }
-    get commands() {
-        return this.#command.commands;
-    }
-    [Symbol.dispose]() {
-        for (const mod of this.#modules){
-            mod.dispose?.();
-        }
-    }
-    async [Symbol.asyncDispose]() {
-        for (const mod of this.#modules){
-            await mod.asyncDispose?.();
-        }
-    }
-    isBlocking(response) {
-        return Object.values(response).some((r)=>r?.blocking === true);
-    }
-    isCommanderHelpOrVersion(error) {
-        const isCommanderError = error instanceof CommanderError;
-        const helpCodes = [
-            "commander.helpDisplayed",
-            "commander.version",
-            "commander.help"
-        ];
-        return isCommanderError && helpCodes.includes(error.code);
-    }
-}
-RootModule = _ts_decorate([
-    Trace,
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        Object,
-        typeof Record === "undefined" ? Object : Record
-    ])
-], RootModule);
-function stopSignal() {
-    let onSignal = ()=>{};
-    const received = new Promise((resolve)=>{
-        onSignal = resolve;
-    });
-    const stop = ()=>{
-        dispose();
-        onSignal();
-    };
-    const dispose = ()=>{
-        process.off("SIGINT", stop);
-        process.off("SIGTERM", stop);
-    };
-    process.once("SIGINT", stop);
-    process.once("SIGTERM", stop);
-    return {
-        received,
-        dispose
-    };
-}

package/es6/src/scaffold-host.js

@@ -1,69 +0,0 @@
-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;
-}
-import { containerArgvFromHost, runInBuilder } from "@decohere/create";
-import { injectable } from "@decohere/crucible/decorators";
-import { AddApiAction, AddModule, Auth0ConfigureAction, Auth0LoginAction, Auth0Module, CreateModule, WebapiAction } from "@decohere/scaffold";
-class HostWebapiAction extends WebapiAction {
-    async run(options) {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            runInBuilder(containerArgvFromHost(process.argv));
-        }
-        return super.run(options);
-    }
-}
-HostWebapiAction = _ts_decorate([
-    injectable()
-], HostWebapiAction);
-class HostAddApiAction extends AddApiAction {
-    async run(options) {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            runInBuilder(containerArgvFromHost(process.argv));
-        }
-        return super.run(options);
-    }
-}
-HostAddApiAction = _ts_decorate([
-    injectable()
-], HostAddApiAction);
-/** Host `decohere create` — Docker-delegates unless already inside the builder image. */ export class HostCreateModule extends CreateModule {
-    actions = {
-        webapi: HostWebapiAction
-    };
-}
-/** Host `decohere add` — Docker-delegates unless already inside the builder image. */ export class HostAddModule extends AddModule {
-    actions = {
-        api: HostAddApiAction
-    };
-}
-class HostAuth0LoginAction extends Auth0LoginAction {
-    async run() {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            runInBuilder(containerArgvFromHost(process.argv));
-        }
-        return super.run();
-    }
-}
-HostAuth0LoginAction = _ts_decorate([
-    injectable()
-], HostAuth0LoginAction);
-class HostAuth0ConfigureAction extends Auth0ConfigureAction {
-    async run(options) {
-        if (process.env.DECOHERE_BUILDER !== "1") {
-            runInBuilder(containerArgvFromHost(process.argv));
-        }
-        return super.run(options);
-    }
-}
-HostAuth0ConfigureAction = _ts_decorate([
-    injectable()
-], HostAuth0ConfigureAction);
-/** Host `decohere auth0` — Docker-delegates unless already inside the builder image. */ export class HostAuth0Module extends Auth0Module {
-    actions = {
-        login: HostAuth0LoginAction,
-        configure: HostAuth0ConfigureAction
-    };
-}

package/tests/__fixtures__/hmr-slice/projects/mod/web/write-marker.mjs

@@ -1,6 +0,0 @@
-import { writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-writeFileSync(join(dirname(fileURLToPath(import.meta.url)), "deferred.marker"), "1");
-setInterval(() => {}, 60_000);

package/types/src/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import "./logger.setup.js";

package/types/src/flux.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import "./logger.setup.js";

package/types/src/forge.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import "./logger.setup.js";

package/types/src/log-level.d.ts

@@ -1,5 +0,0 @@
-/**
- * The level a bin logs at: `--log-level`, then a level from the environment, then `trace` when
- * FORGE_TRACE is set (so `@trace` timings show), then scribe's default.
- */
-export declare function cliLogLevel(flag?: string): string;

package/types/src/logger.setup.d.ts

@@ -1,2 +0,0 @@
-import "@decohere/scribe-pino";
-import "pino-pretty";

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

@@ -1,9 +0,0 @@
-import type { ApplicationModule, CommandResponse, ModuleManifest } from "@decohere/devkit/cli";
-/**
- * Wires a ModuleManifest into a fully functional ApplicationModule.
- * Handles DI container setup, action registration/resolution, and
- * forwarding the command response to the caller.
- */
-export declare class ModuleFactory {
-    static create(module: ModuleManifest, onResponse: (moduleId: string, response: CommandResponse) => void, config?: Record<string, unknown>): ApplicationModule;
-}

package/types/src/product.d.ts

@@ -1,15 +0,0 @@
-import { FluxModule } from "@decohere/flux";
-import { ForgeModule } from "@decohere/forge";
-import { RootModule } from "./root.module.js";
-import { HostAddModule, HostAuth0Module, HostCreateModule } from "./scaffold-host.js";
-declare function create(options?: {
-    configFile?: string;
-    logLevel?: string;
-    rootDir?: string;
-}): Promise<RootModule>;
-/** Shipped `decohere` bin — forge, flux, create, add, auth0. */
-export declare const productCli: {
-    create: typeof create;
-    modules: readonly [typeof ForgeModule, typeof FluxModule, typeof HostCreateModule, typeof HostAddModule, typeof HostAuth0Module];
-};
-export {};

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

@@ -1,7 +0,0 @@
-import { type ApplicationModule, DecohereCommand } from "@decohere/devkit/cli";
-import { type ParseOptions } from "commander";
-export declare class RootCommand extends DecohereCommand {
-    #private;
-    constructor(modules: ApplicationModule[], configFile?: string);
-    parseAsync(argv?: readonly string[], options?: ParseOptions): Promise<this>;
-}

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

@@ -1,20 +0,0 @@
-import type { Actions, ModuleManifest } from "@decohere/devkit/cli";
-import { CommandResponse } from "@decohere/devkit/cli";
-import type { Constructable } from "@decohere/core/reflection";
-import type { Command } from "commander";
-export declare class RootModule {
-    #private;
-    static create(moduleTypes: readonly Constructable<ModuleManifest>[], options?: {
-        configFile?: string;
-        logLevel?: string;
-        rootDir?: string;
-    }): Promise<RootModule>;
-    private constructor();
-    private onResponse;
-    run<TActions extends Actions>(argv?: string[]): Promise<CommandResponse<TActions>>;
-    get commands(): Command[];
-    [Symbol.dispose](): void;
-    [Symbol.asyncDispose](): Promise<void>;
-    private isBlocking;
-    private isCommanderHelpOrVersion;
-}

package/types/src/scaffold-host.d.ts

@@ -1,34 +0,0 @@
-import type { ActionResponse } from "@decohere/devkit/cli";
-import { AddApiAction, type AddApiOptions, AddModule, Auth0ConfigureAction, type Auth0ConfigureOptions, Auth0LoginAction, Auth0Module, CreateModule, WebapiAction, type WebapiOptions } from "@decohere/scaffold";
-declare class HostWebapiAction extends WebapiAction {
-    run(options: WebapiOptions): Promise<ActionResponse>;
-}
-declare class HostAddApiAction extends AddApiAction {
-    run(options: AddApiOptions): Promise<ActionResponse>;
-}
-/** Host `decohere create` — Docker-delegates unless already inside the builder image. */
-export declare class HostCreateModule extends CreateModule {
-    readonly actions: {
-        webapi: typeof HostWebapiAction;
-    };
-}
-/** Host `decohere add` — Docker-delegates unless already inside the builder image. */
-export declare class HostAddModule extends AddModule {
-    readonly actions: {
-        api: typeof HostAddApiAction;
-    };
-}
-declare class HostAuth0LoginAction extends Auth0LoginAction {
-    run(): Promise<ActionResponse>;
-}
-declare class HostAuth0ConfigureAction extends Auth0ConfigureAction {
-    run(options: Auth0ConfigureOptions): Promise<ActionResponse>;
-}
-/** Host `decohere auth0` — Docker-delegates unless already inside the builder image. */
-export declare class HostAuth0Module extends Auth0Module {
-    readonly actions: {
-        login: typeof HostAuth0LoginAction;
-        configure: typeof HostAuth0ConfigureAction;
-    };
-}
-export {};