@treeseed/cli 0.6.1 → 0.6.3

package/dist/cli/handlers/config.js

@@ -17,6 +17,13 @@ function normalizeConfigScopes(value) {
   }
   return ["local", "staging", "prod"].filter((scope) => requested.includes(scope));
 }
+function normalizeBootstrapSystems(system, systems) {
+  const values = [
+    ...Array.isArray(system) ? system.map(String) : typeof system === "string" ? [system] : [],
+    ...typeof systems === "string" ? systems.split(",") : Array.isArray(systems) ? systems.flatMap((value) => String(value).split(",")) : []
+  ].map((value) => value.trim()).filter(Boolean);
+  return values.length > 0 ? values : void 0;
+}
 function formatPrintEnvReports(payload) {
   const lines = [];
   for (const report of payload.reports ?? []) {
@@ -110,6 +117,8 @@ function renderConfigResult(commandName, result) {
   const configContext = payload.context;
   const configReadiness = configContext?.configReadinessByScope?.local ?? {};
   const readinessByScope = payload.result?.readinessByScope ?? {};
+  const bootstrapSystemsByScope = payload.result?.bootstrapSystemsByScope ?? payload.bootstrapSystemsByScope ?? {};
+  const skippedSystems = Object.values(bootstrapSystemsByScope).flatMap((entry) => Array.isArray(entry?.skipped) ? entry.skipped : []);
   const resourceInventoryByScope = payload.result?.resourceInventoryByScope ?? payload.resourceInventoryByScope ?? {};
   const secretSession = payload.secretSession;
   const sharedStorageMigrations = payload.result?.sharedStorageMigrations;
@@ -122,6 +131,8 @@ function renderConfigResult(commandName, result) {
       { label: "Mode", value: payload.mode },
       { label: "Scopes", value: Array.isArray(payload.scopes) ? payload.scopes.join(", ") : "(none)" },
       { label: "Sync", value: payload.sync ?? "all" },
+      { label: "Bootstrap systems", value: Object.values(bootstrapSystemsByScope).flatMap((entry) => entry?.runnable ?? []).filter((value, index, all) => all.indexOf(value) === index).join(", ") || "(none)" },
+      { label: "Skipped systems", value: skippedSystems.map((entry) => entry.system).filter((value, index, all) => all.indexOf(value) === index).join(", ") || "(none)" },
       { label: "Safe repairs", value: Array.isArray(payload.repairs) ? payload.repairs.length : 0 },
       { label: "Machine config", value: payload.configPath },
       { label: "Machine key", value: payload.keyPath },
@@ -169,6 +180,7 @@ const handleConfig = async (invocation, context) => {
     });
     const scopes = normalizeConfigScopes(invocation.args.environment);
     const sync = invocation.args.sync;
+    const systems = normalizeBootstrapSystems(invocation.args.system, invocation.args.systems);
     const interactive = context.outputFormat !== "json" && context.interactiveUi !== false && process.stdin.isTTY && process.stdout.isTTY;
     const nonInteractive = invocation.args.nonInteractive === true || context.outputFormat === "json";
     const operationalMode = invocation.args.printEnvOnly === true || invocation.args.rotateMachineKey === true || invocation.args.connectMarket === true || invocation.args.bootstrap === true;
@@ -245,6 +257,9 @@ const handleConfig = async (invocation, context) => {
       context.write("Applying config updates, validating environments, and syncing managed providers...", "stdout");
       const result2 = await workflow.config({
         environment: scopes,
+        systems,
+        skipUnavailable: invocation.args.skipUnavailable === true ? true : void 0,
+        bootstrapExecution: invocation.args.bootstrapSequential === true ? "sequential" : "parallel",
         sync,
         printEnv: invocation.args.printEnv === true,
         showSecrets: invocation.args.showSecrets === true,
@@ -256,6 +271,9 @@ const handleConfig = async (invocation, context) => {
     }
     const result = await workflow.config({
       environment: invocation.args.environment,
+      systems,
+      skipUnavailable: invocation.args.skipUnavailable === true ? true : void 0,
+      bootstrapExecution: invocation.args.bootstrapSequential === true ? "sequential" : "parallel",
       sync,
       bootstrap: invocation.args.bootstrap === true,
       preflight: invocation.args.preflight === true,

package/dist/cli/help.js

@@ -197,7 +197,8 @@ function buildTreeseedHelpView(commandName) {
       lines: [
         "Workspace-only commands must be run inside a Treeseed workspace; the CLI resolves the project root from ancestor directories when possible.",
         "Help text is generated from the CLI command registry.",
-        "Use --json on supported workflow and utility commands when an AI agent or script needs machine-readable output."
+        "Use --json on supported workflow and utility commands when an AI agent or script needs machine-readable output.",
+        "Use --no-color, NO_COLOR, or TREESEED_NO_COLOR=1 to disable CLI color output globally."
       ]
     });
     return {

package/dist/cli/operations-registry.js

@@ -703,6 +703,10 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "environment", flags: "--environment <scope>", description: "Select all environments or limit configuration to local, staging, or prod. Defaults to all.", kind: "enum", repeatable: true, values: ["all", "local", "staging", "prod"] },
       { name: "sync", flags: "--sync <mode>", description: "Sync hosted secrets/variables to GitHub, Cloudflare, Railway, or all providers. Defaults to all.", kind: "enum", values: ["none", "github", "cloudflare", "railway", "all"] },
       { name: "bootstrap", flags: "--bootstrap", description: "Skip the editor and run platform reconciliation/bootstrap from the currently saved required values.", kind: "boolean" },
+      { name: "system", flags: "--system <system>", description: "Limit bootstrap to a system group. Repeatable. Values: all, github, data, web, api, agents.", kind: "enum", repeatable: true, values: ["all", "github", "data", "web", "api", "agents"] },
+      { name: "systems", flags: "--systems <systems>", description: "Comma-separated bootstrap system groups. Values: all, github, data, web, api, agents.", kind: "string" },
+      { name: "skipUnavailable", flags: "--skip-unavailable", description: "Skip selected bootstrap systems whose required provider credentials are not configured.", kind: "boolean" },
+      { name: "bootstrapSequential", flags: "--bootstrap-sequential", description: "Run bootstrap DAG tasks sequentially for ordered debugging logs.", kind: "boolean" },
       { name: "preflight", flags: "--preflight", description: "Inspect bootstrap verification readiness and planned checks without mutating provider resources.", kind: "boolean" },
       { name: "nonInteractive", flags: "--non-interactive", description: "Apply resolved values without opening the interactive UI. Required for non-TTY automation unless using an operational mode such as --print-env-only.", kind: "boolean" },
       { name: "installMissingTooling", flags: "--install-missing-tooling", description: "Install missing config verification tooling such as `gh-act` during the run instead of only reporting it.", kind: "boolean" },
@@ -721,7 +725,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
       { name: "rotateRunnerToken", flags: "--rotate-runner-token", description: "Rotate the project runner credential while pairing the local hybrid repo.", kind: "boolean" },
       { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
     ],
-    examples: ["treeseed config", "treeseed config --full --mouse", "treeseed config --environment all", "treeseed config --environment staging --bootstrap", "treeseed config --environment staging --bootstrap --preflight", "treeseed config --environment local --sync none", "treeseed config --environment local --sync none --non-interactive", "treeseed config --environment staging --print-env-only --show-secrets", "treeseed config --rotate-machine-key", "treeseed config --connect-market --market-project-id kc_proj_123"],
+    examples: ["treeseed config", "treeseed config --full --mouse", "treeseed config --environment all", "treeseed config --environment staging --bootstrap", "treeseed config --environment staging --bootstrap --system web", "treeseed config --environment staging --bootstrap --preflight", "treeseed config --environment local --sync none", "treeseed config --environment local --sync none --non-interactive", "treeseed config --environment staging --print-env-only --show-secrets", "treeseed config --rotate-machine-key", "treeseed config --connect-market --market-project-id kc_proj_123"],
     notes: ["Does not create branch preview deployments. Use `treeseed switch <branch> --preview` for that."],
     help: {
       workflowPosition: "configure runtime",
@@ -748,6 +752,7 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
         example("treeseed config --full", "Open the advanced editor directly", "Skip the startup wizard and go straight to the full configuration surface."),
         example("treeseed config --full --mouse", "Opt into mouse capture for the editor", "Keep the keyboard-first defaults unless you explicitly want click and wheel interaction inside the config UI."),
         example("treeseed config --environment staging --bootstrap", "Bootstrap infrastructure from saved config", "Skip the editor and run reconciliation/bootstrap when the required values are already configured."),
+        example("treeseed config --environment staging --bootstrap --system web", "Bootstrap only the hosted hub", "Provision data and web systems while leaving optional API and agent Railway services alone."),
         example("treeseed config --environment staging --bootstrap --preflight", "Inspect bootstrap verification readiness", "Show the resolved units, verification capabilities, and planned reconcile actions without mutating provider resources."),
         example("treeseed config --environment local --sync none", "Edit local values without provider sync", "Limit the session to local values and avoid hosted synchronization while iterating locally."),
         example("treeseed config --environment local --sync none --non-interactive", "Apply deterministic local config in automation", "Use the resolved current and suggested values without opening the interactive UI."),
@@ -761,6 +766,10 @@ const CLI_COMMAND_OVERLAYS = /* @__PURE__ */ new Map([
         detail("--environment <scope>", "Filter configuration to `all`, `local`, `staging`, or `prod`."),
         detail("--sync <mode>", "Choose which provider surfaces should receive synchronized values after local updates are applied."),
         detail("--bootstrap", "Skip the editor and run the reconcile/bootstrap path from the values already stored in machine config."),
+        detail("--system <system>", "Limit bootstrap to a stable system group. Repeat it to select multiple groups."),
+        detail("--systems <systems>", "Comma-separated form of --system for automation."),
+        detail("--skip-unavailable", "Skip selected systems whose provider credentials are missing instead of failing the run."),
+        detail("--bootstrap-sequential", "Run bootstrap DAG tasks one at a time to preserve log order for debugging or LLM review."),
         detail("--preflight", "When combined with `--bootstrap`, inspect verification readiness and planned reconcile actions without mutating provider resources."),
         detail("--non-interactive", "Apply resolved values without opening the interactive editor. Use this for automation when you do not want `--json` output."),
         detail("--install-missing-tooling", "Allow config to install missing verification helpers such as the GitHub `gh-act` extension instead of only reporting them."),

package/dist/cli/operations-types.d.ts

@@ -71,6 +71,7 @@ export type TreeseedCommandContext = {
     spawn: TreeseedSpawner;
     outputFormat?: 'human' | 'json';
     interactiveUi?: boolean;
+    colorEnabled?: boolean;
     prompt?: TreeseedPromptHandler;
     confirm?: TreeseedConfirmHandler;
 };

package/dist/cli/runtime.d.ts

@@ -1,4 +1,5 @@
 import type { TreeseedCommandContext, TreeseedHandlerResolver, TreeseedOperationRequest, TreeseedOperationResult, TreeseedOperationSpec } from './operations-types.ts';
+export declare function colorizeTreeseedCliOutput(output: string, colorEnabled?: boolean): string;
 export declare function createTreeseedCommandContext(overrides?: Partial<TreeseedCommandContext>): TreeseedCommandContext;
 export declare function writeTreeseedResult(result: TreeseedOperationResult | {
     exitCode?: number;

package/dist/cli/runtime.js

@@ -14,6 +14,54 @@ const require2 = createRequire(import.meta.url);
 function isHelpFlag(value) {
   return value === "--help" || value === "-h";
 }
+function isNoColorFlag(value) {
+  return value === "--no-color";
+}
+function stripGlobalFlags(argv) {
+  return argv.filter((value) => !isNoColorFlag(value));
+}
+function resolveColorEnabled(argv, env, override) {
+  if (typeof override === "boolean") {
+    return override;
+  }
+  if (argv.some(isNoColorFlag)) {
+    return false;
+  }
+  if (env.NO_COLOR !== void 0 || env.TREESEED_NO_COLOR === "1" || env.TREESEED_NO_COLOR === "true") {
+    return false;
+  }
+  return true;
+}
+function colorCodeForBootstrapSystem(system) {
+  switch (system) {
+    case "github":
+      return "35;1";
+    case "data":
+      return "34;1";
+    case "web":
+      return "36;1";
+    case "api":
+      return "32;1";
+    case "agents":
+      return "33;1";
+    case "skip":
+      return "90;1";
+    default:
+      return "37;1";
+  }
+}
+function colorizeTreeseedCliOutput(output, colorEnabled = true) {
+  if (!colorEnabled) {
+    return output;
+  }
+  return output.replace(/^((?:\[[^\]]+\]){3,4})(\s|$)/u, (match, prefix, suffix) => {
+    const segments = [...prefix.matchAll(/\[([^\]]+)\]/gu)].map((entry) => entry[1]);
+    const system = segments[1] ?? "";
+    const stage = segments[segments.length - 1] ?? "";
+    const code = /fail|error/iu.test(stage) ? "31;1" : /skip/iu.test(stage) ? "90;1" : colorCodeForBootstrapSystem(system);
+    return `\x1B[${code}m${prefix}\x1B[0m${suffix}`;
+  });
+}
 function defaultWrite(output, stream = "stdout") {
   if (!output) return;
   (stream === "stderr" ? process.stderr : process.stdout).write(`${output}
@@ -68,13 +116,16 @@ function formatValidationError(spec, errors) {
   ].join("\n");
 }
 function createTreeseedCommandContext(overrides = {}) {
+  const colorEnabled = resolveColorEnabled([], overrides.env ?? process.env, overrides.colorEnabled);
+  const rawWrite = overrides.write ?? defaultWrite;
   return {
     cwd: overrides.cwd ?? process.cwd(),
     env: overrides.env ?? process.env,
-    write: overrides.write ?? defaultWrite,
+    write: overrides.write ? rawWrite : ((output, stream) => rawWrite(colorizeTreeseedCliOutput(output, colorEnabled), stream)),
     spawn: overrides.spawn ?? defaultSpawn,
     outputFormat: overrides.outputFormat ?? "human",
     interactiveUi: overrides.interactiveUi ?? overrides.write == null,
+    colorEnabled,
     prompt: overrides.prompt,
     confirm: overrides.confirm
   };
@@ -292,14 +343,19 @@ const cliOperationsSdk = new TreeseedOperationsSdk({
   resolveHandler: (handlerName) => COMMAND_HANDLERS[handlerName] ?? null
 });
 async function executeTreeseedCommand(commandName, argv, context) {
+  const cleanArgv = stripGlobalFlags(argv);
+  const commandContext = {
+    ...context,
+    colorEnabled: resolveColorEnabled(argv, context.env ?? process.env, context.colorEnabled)
+  };
   const spec = cliOperationsSdk.findOperation(commandName);
   if (!spec) {
-    return cliOperationsSdk.executeOperation({ commandName, argv }, context);
+    return cliOperationsSdk.executeOperation({ commandName, argv: cleanArgv }, commandContext);
   }
-  if (argv.some(isHelpFlag)) {
-    return cliOperationsSdk.executeOperation({ commandName, argv }, context);
+  if (cleanArgv.some(isHelpFlag)) {
+    return cliOperationsSdk.executeOperation({ commandName, argv: cleanArgv }, commandContext);
   }
-  const resolved = resolveTreeseedCommandCwd(spec, context.cwd);
+  const resolved = resolveTreeseedCommandCwd(spec, commandContext.cwd);
   if (commandNeedsProjectRoot(spec) && !resolved.resolvedProjectRoot) {
     return writeTreeseedResult({
       exitCode: 1,
@@ -307,21 +363,23 @@ async function executeTreeseedCommand(commandName, argv, context) {
       report: {
         command: spec.name,
         ok: false,
-        error: `No ancestor containing treeseed.site.yaml was found from ${context.cwd}.`,
+        error: `No ancestor containing treeseed.site.yaml was found from ${commandContext.cwd}.`,
         hint: `treeseed help ${spec.name}`
       }
-    }, { ...context, outputFormat: argv.includes("--json") ? "json" : context.outputFormat ?? "human" });
+    }, { ...commandContext, outputFormat: cleanArgv.includes("--json") ? "json" : commandContext.outputFormat ?? "human" });
   }
-  return cliOperationsSdk.executeOperation({ commandName, argv }, { ...context, cwd: resolved.cwd });
+  return cliOperationsSdk.executeOperation({ commandName, argv: cleanArgv }, { ...commandContext, cwd: resolved.cwd });
 }
 async function runTreeseedCli(argv, overrides = {}) {
-  const [firstArg] = argv;
+  const cleanArgv = stripGlobalFlags(argv);
+  const colorEnabled = resolveColorEnabled(argv, overrides.env ?? process.env, overrides.colorEnabled);
+  const [firstArg] = cleanArgv;
   const spec = firstArg ? cliOperationsSdk.findOperation(firstArg) : null;
   if (!spec) {
-    return cliOperationsSdk.run(argv, overrides);
+    return cliOperationsSdk.run(cleanArgv, { ...overrides, colorEnabled });
   }
-  if (argv.slice(1).some(isHelpFlag)) {
-    return cliOperationsSdk.run(argv, overrides);
+  if (cleanArgv.slice(1).some(isHelpFlag)) {
+    return cliOperationsSdk.run(cleanArgv, { ...overrides, colorEnabled });
   }
   const baseCwd = overrides.cwd ?? process.cwd();
   const resolved = resolveTreeseedCommandCwd(spec, baseCwd);
@@ -337,14 +395,16 @@ async function runTreeseedCli(argv, overrides = {}) {
       }
     }, createTreeseedCommandContext({
       ...overrides,
-      outputFormat: argv.includes("--json") ? "json" : overrides.outputFormat ?? "human"
+      colorEnabled,
+      outputFormat: cleanArgv.includes("--json") ? "json" : overrides.outputFormat ?? "human"
     }));
   }
-  const contextOverrides = commandNeedsProjectRoot(spec) && resolved.resolvedProjectRoot ? { ...overrides, cwd: resolved.cwd } : overrides;
-  return cliOperationsSdk.run(argv, contextOverrides);
+  const contextOverrides = commandNeedsProjectRoot(spec) && resolved.resolvedProjectRoot ? { ...overrides, cwd: resolved.cwd, colorEnabled } : { ...overrides, colorEnabled };
+  return cliOperationsSdk.run(cleanArgv, contextOverrides);
 }
 export {
   TreeseedOperationsSdk,
+  colorizeTreeseedCliOutput,
   createTreeseedCommandContext,
   executeTreeseedCommand,
   resolveTreeseedCommandCwd,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Operator-facing Treeseed CLI package.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -44,7 +44,7 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "^0.6.1",
+    "@treeseed/sdk": "^0.6.3",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },