Orchestration (M4)
Orchestration Overview
Data passing, opt-in caching, parallelism, affected selection, watch mode, and JSON reports.
Milestone M4 adds composable execution primitives shared across tasknest-py and tasknest-ts:
- Data Passing & Scoped Env:
ctx.output(...), read-onlyctx.deps[...], and task-localctx.env(...). - Opt-In Caching: Content-hashed
.tasknest/cache/with early cutoff and declared-output verification. - Parallelism & Resource Safety:
--jobs,resourcesconflict locking,TASKNEST_WORKER_BUDGET, and--fail-fast. - Persistent Tasks (Dev Servers): Long-lived servers/watchers with automatic concurrency, prefixed logs, and sibling teardown.
- Affected Change Selection:
ctx.affectedgit diff context and conservative fallback selectors. - DAG-Aware Watch Mode:
tasknest watch <task>with self-output filtering and early cutoff. - JSON Reports & Redaction: Versioned
schema_version = 1reports with--jsonstdout purity and secret redaction.