builderman

Key Features

• 🧩

  Explicit dependency graph — tasks run only when their dependencies are satisfied

• 🔁

  Multi-mode commands — dev, build, deploy, or any custom mode

• ⏳

  Readiness detection — wait for long-running processes to become "ready"

• 🧹

  Guaranteed teardown — automatic cleanup in reverse dependency order

• 🛑

  Cancellation support — abort pipelines using AbortSignal

• 📊

  Rich execution statistics — always available, even on failure

• ❌

  Never throws — failures are returned as structured results

• 🧱

  Composable pipelines — pipelines can be converted into tasks

• 💾

  Task-level caching — skip tasks when inputs and outputs haven't changed

• 🎯

  Artifact dependencies — reference outputs from other tasks in cache inputs

• 🔌

  Input resolvers — track package dependencies and other dynamic inputs

Quick Start

import { task, pipeline } from "builderman"

const build = task({
  name: "build",
  commands: {
    build: "tsc",
    dev: "tsc --watch",
  },
})

const test = task({
  name: "test",
  commands: {
    build: "npm test",
  },
  dependencies: [build],
})

const deploy = task({
  name: "deploy",
  commands: {
    build: "npm run deploy",
  },
  dependencies: [test],
})

const result = await pipeline([build, test, deploy]).run({
  command: "build",
})

console.log(result)