@visulima/task-runner 1.0.0-alpha.4 → 1.0.0-alpha.5

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## @visulima/task-runner [1.0.0-alpha.5](https://github.com/visulima/visulima/compare/@visulima/task-runner@1.0.0-alpha.4...@visulima/task-runner@1.0.0-alpha.5) (2026-04-15)
+
+### Features
+
+* Add comprehensive workspace configuration and command infrastructure ([#609](https://github.com/visulima/visulima/issues/609)) ([f4347bf](https://github.com/visulima/visulima/commit/f4347bfdcdd1b228cd9d842a927e446aaf23f035))
+* **vis:** add cache command for task runner cache ([#607](https://github.com/visulima/visulima/issues/607)) ([6752769](https://github.com/visulima/visulima/commit/67527692562b3dd9c03bb6a67c084ff1e694a560))
+
+### Bug Fixes
+
+* **tooling:** resolve eslint and formatting issues ([399d292](https://github.com/visulima/visulima/commit/399d29282be5b29bb26b4e5b24d45e2a6cdeeca3))
+
+
+### Dependencies
+
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.10
+* **@visulima/path:** upgraded to 3.0.0-alpha.9
+
 ## @visulima/task-runner [1.0.0-alpha.4](https://github.com/visulima/visulima/compare/@visulima/task-runner@1.0.0-alpha.3...@visulima/task-runner@1.0.0-alpha.4) (2026-04-08)
 
 ### Features

package/dist/cache.d.ts

@@ -25,6 +25,13 @@ interface CacheOptions {
     /** The workspace root directory */
     workspaceRoot: string;
 }
+/**
+ * Directory name (relative to `workspaceRoot`) where the task runner writes
+ * its cache by default. Exported so callers that manage the cache from the
+ * outside — e.g. a CLI `cache clean` command — can reach the same default
+ * without hard-coding the literal.
+ */
+declare const DEFAULT_CACHE_DIRECTORY_NAME = ".task-runner-cache";
 /**
  * Parses a human-readable cache size string into bytes.
  * Delegates to @visulima/humanizer's parseBytes with base-2 (1024) multipliers.
@@ -100,4 +107,4 @@ declare class Cache {
     clear(): Promise<void>;
 }
 export type { CachedResult, CacheOptions };
-export { Cache, formatCacheSize, parseCacheSize };
+export { Cache, DEFAULT_CACHE_DIRECTORY_NAME, formatCacheSize, parseCacheSize };

package/dist/flow-controllers/input-handler.d.ts

@@ -40,5 +40,5 @@ interface CommandStdin {
  * @param options Input handler configuration
  * @returns cleanup function to call when done
  */
-export declare const createInputHandler: (commands: CommandStdin[], options?: InputHandlerOptions) => () => void;
+export declare const createInputHandler: (commands: CommandStdin[], options?: InputHandlerOptions) => (() => void);
 export {};

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { AffectedOptions, AffectedResult } from "./affected.d.ts";
 export { buildForwardDependencyMap, buildReverseDependencyMap, expandAffected, filterAffectedTasks, getAffectedProjects, getChangedFiles } from "./affected.d.ts";
 export type { CachedResult, CacheOptions } from "./cache.d.ts";
-export { Cache, formatCacheSize, parseCacheSize } from "./cache.d.ts";
+export { Cache, DEFAULT_CACHE_DIRECTORY_NAME, formatCacheSize, parseCacheSize } from "./cache.d.ts";
 export type { ParseCommandsOptions } from "./command-parser/index.d.ts";
 export { expandArguments, expandShortcut, expandWildcard, parseCommands, stripQuotes } from "./command-parser/index.d.ts";
 export { runConcurrently } from "./concurrent.d.ts";

package/dist/index.js

@@ -1,9 +1,9 @@
-export { buildForwardDependencyMap, buildReverseDependencyMap, expandAffected, filterAffectedTasks, getAffectedProjects, getChangedFiles } from './packem_shared/buildForwardDependencyMap-Cu08NWB1.js';
-export { Cache, formatCacheSize, parseCacheSize } from './packem_shared/Cache-C23LywYn.js';
+export { buildForwardDependencyMap, buildReverseDependencyMap, expandAffected, filterAffectedTasks, getAffectedProjects, getChangedFiles } from './packem_shared/buildForwardDependencyMap-0BJFMMPv.js';
+export { Cache, DEFAULT_CACHE_DIRECTORY_NAME, formatCacheSize, parseCacheSize } from './packem_shared/Cache-iAjRMV2d.js';
 export { parseCommands } from './packem_shared/parseCommands-D-IgF8Zh.js';
-export { runConcurrently } from './packem_shared/runConcurrently-ATDwJNR6.js';
-export { runConcurrentFallback } from './packem_shared/runConcurrentFallback-3q46z4AS.js';
-export { defaultTaskRunner } from './packem_shared/defaultTaskRunner-X1MIynHu.js';
+export { runConcurrently } from './packem_shared/runConcurrently-qrkWyzXW.js';
+export { runConcurrentFallback } from './packem_shared/runConcurrentFallback-CGHz_f-Q.js';
+export { defaultTaskRunner } from './packem_shared/defaultTaskRunner-BdFTifsh.js';
 export { detectScriptShell } from './packem_shared/detectScriptShell-CR-xXKA4.js';
 export { FileAccessTracker, generatePreloadScript } from './packem_shared/FileAccessTracker-CrtBAt5D.js';
 export { FingerprintManager } from './packem_shared/FingerprintManager-Cu-ta9ee.js';
@@ -13,7 +13,7 @@ export { IncrementalFileHasher } from './packem_shared/IncrementalFileHasher-Cm_
 export { CompositeLifeCycle, ConsoleLifeCycle, EmptyLifeCycle } from './packem_shared/CompositeLifeCycle-7AtYw1dv.js';
 export { LockfileHasher, extractPackageName, parseNpmLockfile, parsePnpmLockfile, parseYarnLockfile } from './packem_shared/extractPackageName-CbVNW-dr.js';
 export { isNativeAvailable, loadNativeBindings } from './packem_shared/isNativeAvailable-BpD28A6Z.js';
-export { enforceProjectConstraints } from './packem_shared/enforceProjectConstraints-_Ej0zHch.js';
+export { enforceProjectConstraints } from './packem_shared/enforceProjectConstraints-C5Jp_C3u.js';
 export { RemoteCache } from './packem_shared/RemoteCache-BFceSe4a.js';
 export { generateRunSummary, writeRunSummary } from './packem_shared/generateRunSummary-qn-_jKwt.js';
 export { createTaskGraph, getTaskId, parseTaskId } from './packem_shared/createTaskGraph-CcsFaSrz.js';
@@ -21,7 +21,7 @@ export { findCycle, findCycles, getDependentTasks, getLeafTasks, getTransitiveDe
 export { InProcessTaskHasher, computeTaskHash } from './packem_shared/computeTaskHash-B2SVZqgp.js';
 export { TaskOrchestrator } from './packem_shared/TaskOrchestrator-lLn-PH1m.js';
 export { TaskScheduler, parsePartition } from './packem_shared/parsePartition-C4-P5RjK.js';
-export { TerminalBuffer } from './packem_shared/TerminalBuffer-D6zP2zLh.js';
+export { TerminalBuffer } from './packem_shared/TerminalBuffer-CnPyFgPB.js';
 export { TrackedTaskExecutor } from './packem_shared/TrackedTaskExecutor-BGUKFE-7.js';
 export { c as collectFiles, a as createFailureResult, h as hashFile, b as hashStrings, r as readPackageDeps, d as resolveTaskCwd, s as sortObjectKeys, u as uniqueId } from './packem_shared/utils-zO0ZRgtf.js';
 export { createInputHandler } from './packem_shared/createInputHandler-DTfePcTG.js';

package/dist/packem_shared/{Cache-C23LywYn.js → Cache-iAjRMV2d.js}

@@ -32,6 +32,7 @@ import { join, resolve, dirname } from '@visulima/path';
 import { u as uniqueId } from './utils-zO0ZRgtf.js';
 
 const DEFAULT_MAX_CACHE_AGE = 7 * 24 * 60 * 60 * 1e3;
+const DEFAULT_CACHE_DIRECTORY_NAME = ".task-runner-cache";
 const removeEntry = async (entryPath) => {
   try {
     await rm(entryPath, { force: true, recursive: true });
@@ -72,7 +73,7 @@ class Cache {
   #indexWriteQueue = Promise.resolve();
   constructor(options) {
     this.#workspaceRoot = options.workspaceRoot;
-    this.#cacheDirectory = options.cacheDirectory ?? join(options.workspaceRoot, ".task-runner-cache");
+    this.#cacheDirectory = options.cacheDirectory ?? join(options.workspaceRoot, DEFAULT_CACHE_DIRECTORY_NAME);
     this.#maxCacheAge = options.maxCacheAge ?? DEFAULT_MAX_CACHE_AGE;
     this.#maxCacheSize = options.maxCacheSize ? parseCacheSize(options.maxCacheSize) : void 0;
   }
@@ -294,4 +295,4 @@ class Cache {
   }
 }
 
-export { Cache, formatCacheSize, parseCacheSize };
+export { Cache, DEFAULT_CACHE_DIRECTORY_NAME, formatCacheSize, parseCacheSize };

package/dist/packem_shared/{TerminalBuffer-D6zP2zLh.js → TerminalBuffer-CnPyFgPB.js}

@@ -23,11 +23,7 @@ class TerminalBuffer {
           i = consumed;
           continue;
         }
-        if (data[i + 1] === "(" || data[i + 1] === ")") {
-          i += 3;
-        } else {
-          i += 2;
-        }
+        i += data[i + 1] === "(" || data[i + 1] === ")" ? 3 : 2;
         continue;
       }
       if (ch === "\r") {
@@ -70,36 +66,42 @@ class TerminalBuffer {
     const cmd = data[j];
     const n = Number.parseInt(params, 10) || 1;
     switch (cmd) {
-      case "A":
+      case "A": {
         this.#row = Math.max(0, this.#row - n);
         break;
-      case "B":
+      }
+      case "B": {
         this.#row = Math.min(this.#lines.length - 1, this.#row + n);
         break;
-      case "C":
+      }
+      case "C": {
         this.#col += n;
         break;
-      case "D":
+      }
+      case "D": {
         this.#col = Math.max(0, this.#col - n);
         break;
-      case "G":
-        this.#col = Math.max(0, n - 1);
-        break;
-      case "H":
-      // cursor position (row;col, 1-based)
-      case "f": {
+      }
+      case "f":
+      case "H": {
         const parts = params.split(";");
         this.#row = Math.max(0, (Number.parseInt(parts[0] ?? "1", 10) || 1) - 1);
         this.#col = Math.max(0, (Number.parseInt(parts[1] ?? "1", 10) || 1) - 1);
         this.#ensureRow(this.#row);
         break;
       }
-      case "J":
+      case "G": {
+        this.#col = Math.max(0, n - 1);
+        break;
+      }
+      case "J": {
         this.#eraseDisplay(Number.parseInt(params, 10) || 0);
         break;
-      case "K":
+      }
+      case "K": {
         this.#eraseLine(Number.parseInt(params, 10) || 0);
         break;
+      }
       case "m": {
         const seq = `\x1B[${params}m`;
         this.#ensureRow(this.#row);
@@ -161,30 +163,44 @@ class TerminalBuffer {
     this.#lines[this.#row] = line.slice(0, strIndex) + seq + line.slice(strIndex);
   }
   #eraseDisplay(mode) {
-    if (mode === 2) {
-      this.#lines = [""];
-      this.#row = 0;
-      this.#col = 0;
-    } else if (mode === 0) {
-      this.#ensureRow(this.#row);
-      this.#truncateLineAtCol(this.#row, this.#col);
-      this.#lines.length = this.#row + 1;
-    } else if (mode === 1) {
-      for (let r = 0; r < this.#row; r++) {
-        this.#lines[r] = "";
+    switch (mode) {
+      case 0: {
+        this.#ensureRow(this.#row);
+        this.#truncateLineAtCol(this.#row, this.#col);
+        this.#lines.length = this.#row + 1;
+        break;
+      }
+      case 1: {
+        for (let r = 0; r < this.#row; r++) {
+          this.#lines[r] = "";
+        }
+        this.#ensureRow(this.#row);
+        this.#fillLineToCol(this.#row, this.#col);
+        break;
+      }
+      case 2: {
+        this.#lines = [""];
+        this.#row = 0;
+        this.#col = 0;
+        break;
       }
-      this.#ensureRow(this.#row);
-      this.#fillLineToCol(this.#row, this.#col);
     }
   }
   #eraseLine(mode) {
     this.#ensureRow(this.#row);
-    if (mode === 2) {
-      this.#lines[this.#row] = "";
-    } else if (mode === 0) {
-      this.#truncateLineAtCol(this.#row, this.#col);
-    } else if (mode === 1) {
-      this.#fillLineToCol(this.#row, this.#col);
+    switch (mode) {
+      case 0: {
+        this.#truncateLineAtCol(this.#row, this.#col);
+        break;
+      }
+      case 1: {
+        this.#fillLineToCol(this.#row, this.#col);
+        break;
+      }
+      case 2: {
+        this.#lines[this.#row] = "";
+        break;
+      }
     }
   }
   /** Truncate a line at the given visual column. */

package/dist/packem_shared/{buildForwardDependencyMap-Cu08NWB1.js → buildForwardDependencyMap-0BJFMMPv.js}

@@ -22,8 +22,10 @@ const {
 } = __cjs_getBuiltinModule("node:child_process");
 
 const validateGitRef = (ref) => {
-  if (!/^[\w.\-/~^@{}]+$/.test(ref)) {
-    throw new Error(`Invalid git ref: "${ref}". Only alphanumeric characters, dots, dashes, underscores, slashes, tildes, carets, and @ are allowed.`);
+  if (!/^[\w./~^@{}][\w.\-/~^@{}]*$/.test(ref)) {
+    throw new Error(
+      `Invalid git ref: "${ref}". Refs must start with an alphanumeric character or one of _ . / ~ ^ @ { } and may only contain letters, digits, dots, dashes, underscores, slashes, tildes, carets, @, and braces.`
+    );
   }
 };
 const findProjectForFile = (filePath, projects) => {

package/dist/packem_shared/{defaultTaskRunner-X1MIynHu.js → defaultTaskRunner-BdFTifsh.js}

@@ -1,4 +1,4 @@
-import { Cache } from './Cache-C23LywYn.js';
+import { Cache } from './Cache-iAjRMV2d.js';
 import { inferFrameworkEnvPatterns } from './detectFrameworks-CeFzKE6J.js';
 import { RemoteCache } from './RemoteCache-BFceSe4a.js';
 import { InProcessTaskHasher } from './computeTaskHash-B2SVZqgp.js';

package/dist/packem_shared/{enforceProjectConstraints-_Ej0zHch.js → enforceProjectConstraints-C5Jp_C3u.js}

@@ -1,10 +1,19 @@
+const LAYER_ORDER = ["configuration", "library", "scaffolding", "tool", "automation", "application"];
+const layerIndex = (layer) => {
+  if (!layer) {
+    return void 0;
+  }
+  const idx = LAYER_ORDER.indexOf(layer);
+  return idx === -1 ? void 0 : idx;
+};
 const enforceProjectConstraints = (projectGraph, constraints) => {
   const violations = [];
-  const { dependencyKindRules, tagRelationships, typeBoundaries } = constraints;
+  const { dependencyKindRules, enforceLayerRelationships, tagRelationships, typeBoundaries } = constraints;
   const hasTagRules = tagRelationships && Object.keys(tagRelationships).length > 0;
   const hasTypeBoundaries = typeBoundaries !== void 0;
   const hasKindRules = dependencyKindRules !== void 0;
-  if (!hasTagRules && !hasTypeBoundaries && !hasKindRules) {
+  const hasLayerRules = enforceLayerRelationships === true;
+  if (!hasTagRules && !hasTypeBoundaries && !hasKindRules && !hasLayerRules) {
     return violations;
   }
   const enforceAppBoundary = typeBoundaries?.enforceApplicationBoundary !== false;
@@ -82,6 +91,18 @@ const enforceProjectConstraints = (projectGraph, constraints) => {
           }
         }
       }
+      if (hasLayerRules) {
+        const sourceLayer = layerIndex(sourceNode.data.layer);
+        const depLayer = layerIndex(depNode.data.layer);
+        if (sourceLayer !== void 0 && depLayer !== void 0 && depLayer > sourceLayer) {
+          violations.push({
+            dependencyProject: dep.target,
+            message: `Project "${projectName}" (layer: ${sourceNode.data.layer}) depends on "${dep.target}" (layer: ${depNode.data.layer}). A "${sourceNode.data.layer}" project may only depend on projects at the same or lower layer. Hierarchy: ${LAYER_ORDER.join(" < ")}.`,
+            rule: "layer-relationship",
+            sourceProject: projectName
+          });
+        }
+      }
     }
   }
   return violations;

package/dist/packem_shared/{runConcurrentFallback-3q46z4AS.js → runConcurrentFallback-CGHz_f-Q.js}

@@ -104,7 +104,9 @@ const spawnCommand = (index, config, shellPath, onEvent, onComplete) => {
   }
   onEvent({
     index,
-    kill: child.pid ? (signal) => killTree(child.pid, signal ?? "SIGTERM") : void 0,
+    kill: child.pid ? (signal) => {
+      killTree(child.pid, signal ?? "SIGTERM");
+    } : void 0,
     kind: "started",
     write: child.stdin ? (data) => child.stdin.write(data) : void 0
   });
@@ -223,17 +225,25 @@ const spawnCommandPty = (index, config, shellPath, onEvent, onComplete) => {
     cols: config.ptySize?.cols ?? 80,
     cwd: config.cwd ?? process.cwd(),
     env: Object.fromEntries(
-      Object.entries({ ...process.env, ...config.env, FORCE_COLOR: process.env["FORCE_COLOR"] ?? "1", TERM: "xterm-256color" }).filter((entry) => entry[1] !== void 0)
+      Object.entries({ ...process.env, ...config.env, FORCE_COLOR: process.env["FORCE_COLOR"] ?? "1", TERM: "xterm-256color" }).filter(
+        (entry) => entry[1] !== void 0
+      )
     ),
     name: "xterm-256color",
     rows: config.ptySize?.rows ?? 24
   });
   onEvent({
     index,
-    kill: (signal) => ptyInstance.kill(signal),
+    kill: (signal) => {
+      ptyInstance.kill(signal);
+    },
     kind: "started",
-    resize: (cols, rows) => ptyInstance.resize(cols, rows),
-    write: (data) => ptyInstance.write(data)
+    resize: (cols, rows) => {
+      ptyInstance.resize(cols, rows);
+    },
+    write: (data) => {
+      ptyInstance.write(data);
+    }
   });
   ptyInstance.onData((data) => {
     onEvent({ index, kind: "stdout", text: data });
@@ -326,7 +336,11 @@ const runConcurrentFallback = (commands, options) => new Promise((resolve) => {
     while (active.length < maxProcesses && pending.length > 0) {
       const cmdIndex = pending.shift();
       const config = commands[cmdIndex];
-      const proc = config.stdin === "pty" ? spawnCommandPty(cmdIndex, config, options.shellPath, onEvent, (ce) => handleClose(cmdIndex, ce)) : spawnCommand(cmdIndex, config, options.shellPath, onEvent, (ce) => handleClose(cmdIndex, ce));
+      const proc = config.stdin === "pty" ? spawnCommandPty(cmdIndex, config, options.shellPath, onEvent, (ce) => {
+        handleClose(cmdIndex, ce);
+      }) : spawnCommand(cmdIndex, config, options.shellPath, onEvent, (ce) => {
+        handleClose(cmdIndex, ce);
+      });
       active.push(proc);
     }
   };

package/dist/packem_shared/{runConcurrently-ATDwJNR6.js → runConcurrently-qrkWyzXW.js}

@@ -1,4 +1,4 @@
-import { runConcurrentFallback } from './runConcurrentFallback-3q46z4AS.js';
+import { runConcurrentFallback } from './runConcurrentFallback-CGHz_f-Q.js';
 import { detectScriptShell } from './detectScriptShell-CR-xXKA4.js';
 import { logTimings } from './formatTimingTable-3qtCM552.js';
 import { withRestart } from './withRestart-BREjRJa4.js';

package/dist/project-constraints.d.ts

@@ -1,16 +1,9 @@
 import type { ConstraintsConfig, ConstraintViolation, ProjectGraph } from "./types.d.ts";
 /**
  * Enforces project dependency constraints on a project graph.
- * Returns an array of violations found. Does not throw — the caller
- * decides how to handle violations (fatal error, warning, etc.).
- *
- * Three constraint mechanisms:
- * 1. **Tag relationships**: If a project has a tag listed in `tagRelationships`,
- *    its dependencies must have at least one of the required tags.
- * 2. **Type boundaries**: Controls which project types can depend on which.
- *    By default, no project may depend on an "application" type project.
- * 3. **Dependency kind rules**: Controls rules based on whether the dependency
- *    is a production dependency, devDependency, or peerDependency.
+ * @param projectGraph The workspace project graph to validate.
+ * @param constraints The constraint rules to enforce.
+ * @returns Array of violations found. Empty means all constraints pass.
  */
 declare const enforceProjectConstraints: (projectGraph: ProjectGraph, constraints: ConstraintsConfig) => ConstraintViolation[];
 export { enforceProjectConstraints };

package/dist/types.d.ts

@@ -85,6 +85,15 @@ export type TaskResults = Map<string, TaskResult>;
 export interface ProjectConfiguration {
     /** Implicit dependencies on other projects */
     implicitDependencies?: string[];
+    /**
+     * Project layer in the dependency hierarchy. Used by
+     * `enforceLayerRelationships` to ensure projects only depend on
+     * projects at the same or lower layer.
+     *
+     * Hierarchy (lowest → highest):
+     * `configuration < library < scaffolding < tool < automation < application`
+     */
+    layer?: "application" | "automation" | "configuration" | "library" | "scaffolding" | "tool";
     /** The project type */
     projectType?: "library" | "application";
     /** The root directory of the project, relative to workspace root */
@@ -210,6 +219,16 @@ export interface DependencyKindRules {
 export interface ConstraintsConfig {
     /** Rules based on the dependency kind (static vs devDependency vs peerDependency) */
     dependencyKindRules?: DependencyKindRules;
+    /**
+     * When true, projects can only depend on projects at the same or
+     * lower layer in the hierarchy:
+     *
+     *   configuration < library < scaffolding < tool < automation < application
+     *
+     * Projects without an explicit `layer` are unconstrained.
+     * @default false
+     */
+    enforceLayerRelationships?: boolean;
     /** Tag-based dependency rules */
     tagRelationships?: TagRelationships;
     /** Project-type-based dependency rules */
@@ -224,7 +243,7 @@ export interface ConstraintViolation {
     /** Human-readable description of the violation */
     message: string;
     /** The type of rule that was violated */
-    rule: "dependency-kind" | "tag-relationship" | "type-boundary";
+    rule: "dependency-kind" | "layer-relationship" | "tag-relationship" | "type-boundary";
     /** The project that has the invalid dependency */
     sourceProject: string;
 }
@@ -462,12 +481,12 @@ export type ConcurrentCommandInput = string | {
     cwd?: string;
     env?: Record<string, string>;
     name?: string;
-    stdin?: "inherit" | "null" | "pipe" | "pty";
     /** Initial PTY dimensions (only used when stdin is "pty"). */
     ptySize?: {
         cols: number;
         rows: number;
     };
+    stdin?: "inherit" | "null" | "pipe" | "pty";
 };
 /**
  * Configuration for a single command to run concurrently.
@@ -481,6 +500,14 @@ export interface ConcurrentCommandConfig {
     env?: Record<string, string>;
     /** Human-readable name for this command (used in prefixes/logs). */
     name?: string;
+    /**
+     * Initial PTY dimensions. Only used when stdin is "pty".
+     * Defaults to 80x24 if not specified.
+     */
+    ptySize?: {
+        cols: number;
+        rows: number;
+    };
     /** Whether to use shell execution (default: true). */
     shell?: boolean;
     /**
@@ -491,14 +518,6 @@ export interface ConcurrentCommandConfig {
      * - "pty": child runs inside a pseudo-terminal (isatty() returns true, enables interactive prompts)
      */
     stdin?: "inherit" | "null" | "pipe" | "pty";
-    /**
-     * Initial PTY dimensions. Only used when stdin is "pty".
-     * Defaults to 80x24 if not specified.
-     */
-    ptySize?: {
-        cols: number;
-        rows: number;
-    };
 }
 /**
  * Options controlling the concurrent runner behavior.
@@ -548,10 +567,10 @@ export interface ProcessEvent {
     exitCode?: number;
     /** Index of the command that produced this event. */
     index: number;
-    /** Whether the process was killed (for close events). */
-    killed?: boolean;
     /** Kill the child process/PTY. Only present on "started" events. */
     kill?: (signal?: string) => void;
+    /** Whether the process was killed (for close events). */
+    killed?: boolean;
     /** Event type: "stdout", "stderr", "close", "error", "started". */
     kind: "close" | "error" | "started" | "stderr" | "stdout";
     /** Error message (for error events). */