@netnodeag/kraftwerk 0.37.1 → 0.38.0

package/dist/config.d.ts

@@ -11,6 +11,7 @@
  *
  *   name: my-project           # display name (inspector header, "environment")
  *   icon: "⚡"                  # emoji shown as inspector favicon
+ *   color: "#c2410c"           # accent for this workspace in the switcher (default: derived from the root)
  *   port: 1981                 # port `kraftwerk ui` listens on
  *   workflows: src/workflows   # workflows root, relative to the file
  *   output: output             # run-artifact directory, relative to the file
@@ -88,6 +89,8 @@ export interface ProjectConfig {
     name?: string;
     /** Emoji used as the inspector favicon (browser-tab icon). */
     icon?: string;
+    /** Accent colour (#rgb / #rrggbb) for this workspace in the switcher. Default: derived from the root path. */
+    color?: string;
     /** Port `kraftwerk ui` listens on. Default: 1981 (CLI --port wins). */
     port?: number;
     /** Workflows root relative to the project root. */

package/dist/config.js

@@ -15,6 +15,7 @@ import { parse } from "yaml";
  *
  *   name: my-project           # display name (inspector header, "environment")
  *   icon: "⚡"                  # emoji shown as inspector favicon
+ *   color: "#c2410c"           # accent for this workspace in the switcher (default: derived from the root)
  *   port: 1981                 # port `kraftwerk ui` listens on
  *   workflows: src/workflows   # workflows root, relative to the file
  *   output: output             # run-artifact directory, relative to the file
@@ -126,7 +127,7 @@ export async function resolveProject(cwd) {
     const root = gitFallback ?? start;
     return { root, config: {}, outputDir: path.join(root, "output") };
 }
-const KNOWN_KEYS = ["name", "icon", "port", "workflows", "output", "knowledge", "agents", "skills", "switcher", "git", "repos"];
+const KNOWN_KEYS = ["name", "icon", "color", "port", "workflows", "output", "knowledge", "agents", "skills", "switcher", "git", "repos"];
 async function loadConfig(configPath) {
     let raw;
     try {
@@ -151,6 +152,11 @@ async function loadConfig(configPath) {
                 throw new Error(`${path.basename(configPath)}: port must be an integer`);
             }
         }
+        else if (key === "color") {
+            if (typeof config[key] !== "string" || !/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(config[key])) {
+                throw new Error(`${path.basename(configPath)}: color must be a hex colour like "#c2410c"`);
+            }
+        }
         else if (key === "switcher") {
             validateSwitcher(configPath, config[key]);
         }

package/dist/inspector/instances.d.ts

@@ -15,6 +15,10 @@ export interface DiscoveredInstance {
     name: string;
     url: string;
     icon?: string;
+    /** kraftwerk.yml `color`, if set. */
+    color?: string;
+    /** True when the name comes from kraftwerk.yml (false = folder name). */
+    named?: boolean;
     live: true;
     root?: string;
     /** Server process id (what to signal to stop it). */
@@ -29,6 +33,10 @@ export interface WorkspaceEntry {
     /** Where the inspector answers (live) or would answer once started. */
     url: string;
     icon?: string;
+    /** kraftwerk.yml `color`, if set; the UI derives one from the root otherwise. */
+    color?: string;
+    /** True when the name comes from kraftwerk.yml, false when it is just the folder name. */
+    named?: boolean;
     live: boolean;
     root?: string;
     /** Root with ~ for the home dir — what the UI prints. */

package/dist/inspector/instances.js

@@ -86,6 +86,8 @@ async function probeAt(host, port) {
             name: meta.projectName || `localhost:${port}`,
             url: `http://localhost:${port}`,
             icon: meta.projectIcon || undefined,
+            color: meta.projectColor || undefined,
+            named: typeof meta.projectNamed === "boolean" ? meta.projectNamed : undefined,
             live: true,
         };
     }
@@ -232,7 +234,7 @@ export async function forgetProject(root) {
  * so without this check a stale record would wear its parent's identity.
  */
 async function describeRoot(root) {
-    const fallback = { name: path.basename(root), port: 1981, exists: false };
+    const fallback = { name: path.basename(root), named: false, port: 1981, exists: false };
     if (!(await isDir(root)))
         return fallback;
     try {
@@ -241,7 +243,9 @@ async function describeRoot(root) {
             return fallback;
         return {
             name: project.config.name ?? path.basename(project.root),
+            named: !!project.config.name,
             icon: project.config.icon || undefined,
+            color: project.config.color || undefined,
             port: project.config.port ?? 1981,
             exists: true,
         };
@@ -278,15 +282,29 @@ export async function discoverWorkspaces() {
         }
         if (running) {
             consumed.add(running);
-            return { ...base, name: running.name, url: running.url, icon: running.icon, live: true, exists: true };
+            // An instance from before 0.38 answers without color/named — read them from its root.
+            if (running.named === undefined)
+                d = await describeRoot(p.root);
+            return {
+                ...base,
+                name: running.name,
+                url: running.url,
+                icon: running.icon,
+                color: running.color ?? d?.color,
+                named: running.named ?? d?.named,
+                live: true,
+                exists: true,
+            };
         }
-        return { ...base, name: d.name, url: `http://localhost:${d.port}`, icon: d.icon, live: false, exists: d.exists };
+        return { ...base, name: d.name, url: `http://localhost:${d.port}`, icon: d.icon, color: d.color, named: d.named, live: false, exists: d.exists };
     }))).concat(await Promise.all(live
         .filter((i) => !consumed.has(i))
         .map(async (i) => ({
         name: i.name,
         url: i.url,
         icon: i.icon,
+        color: i.color,
+        named: i.named,
         live: true,
         root: i.root,
         rootLabel: i.root ? tildify(i.root) : undefined,
@@ -335,6 +353,8 @@ export async function listWorkspacesDetailed() {
         all.unshift({
             name: d.name,
             icon: d.icon,
+            color: d.color,
+            named: d.named,
             url: `http://localhost:${selfPort}`,
             live: true,
             root: selfRoot,

package/dist/inspector/server.js

@@ -213,6 +213,8 @@ async function handleApi(req, res, url) {
             restartable: supervised(),
             projectName,
             projectIcon: project?.config.icon ?? "",
+            projectColor: project?.config.color ?? "",
+            projectNamed: !!project?.config.name,
             projectRoot: project?.root ?? getProjectRoot(),
             projectRootLabel: tildify(project?.root ?? getProjectRoot()),
             git: (project?.config.git && project.config.git.enabled !== false) === true,

package/dist/inspector/settings.d.ts

@@ -20,6 +20,8 @@ export interface SaveSettingsInput {
     /** Omitted = untouched; empty string = remove the key. */
     name?: string;
     icon?: string;
+    /** Omitted = untouched; empty string = remove the key. Hex colour otherwise. */
+    color?: string;
     /** Omitted = untouched; empty list = remove the key. */
     switcher?: SwitcherEntry[];
     /** Omitted = untouched. See cleanGit for how the block is written. */

package/dist/inspector/settings.js

@@ -94,6 +94,13 @@ export async function saveSettings(input) {
         throw new Error("name must be a string");
     if (input.icon !== undefined && typeof input.icon !== "string")
         throw new Error("icon must be a string");
+    if (input.color !== undefined) {
+        if (typeof input.color !== "string")
+            throw new Error("color must be a string");
+        if (input.color.trim() && !/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(input.color.trim())) {
+            throw new Error('color must be a hex colour like "#c2410c"');
+        }
+    }
     const switcher = input.switcher === undefined ? undefined : cleanSwitcher(input.switcher);
     const project = await resolveProject(getProjectRoot());
     const configPath = project.configPath ?? path.join(project.root, "kraftwerk.yml");
@@ -111,6 +118,7 @@ export async function saveSettings(input) {
     };
     setOrDelete("name", input.name?.trim());
     setOrDelete("icon", input.icon?.trim());
+    setOrDelete("color", input.color?.trim());
     setOrDelete("switcher", switcher);
     if (input.git !== undefined) {
         const git = cleanGit(input.git);