Skip to content

Task Resolution

After detection builds the project profile, xtarterize resolves which tasks are relevant and what their current status is.

Resolution keeps the tasks whose applicability check accepts the profile. This is a pure filter with no I/O.

In a monorepo, resolution also filters tasks by scope (root, package, or both). Non-monorepo projects skip scope filtering. See the monorepo guide for the user-facing rules.

Applicability checks read profile properties, for example TypeScript projects, browser Vite projects, GitHub repositories, or Turborepo monorepos.

Status checks run in parallel. Each task inspects the filesystem and reports one of four statuses:

Status Meaning init acts sync acts
new Config does not exist yet Yes No
patch Config exists and can be updated Yes Yes
skip Already conformant No No
conflict Changes need explicit approval Only when selected Only when selected

A check that throws is reported as a conflict with its error detail instead of failing the whole resolution.