trw_init
Create a run directory and register it as the active run for starting new tasks, sprints, or investigations that need persistent TRW state.
Instructions
Create a run directory and register it as the active run.
Use when:
Starting a new task, sprint, or investigation that needs persistent TRW state.
You need run metadata, framework assets, and active-run pinning before work begins.
Bootstraps state, run metadata, events, framework assets, optional wave/artifact metadata, and a trace/profile-aware task_profile.
Input: task_name plus optional objective, config_overrides, task_root, wave_manifest, complexity signals, artifacts, and protection flag.
Output: dict with run_id, run_path, task_dir, phase, and status fields.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_type | No | implementation | |
| artifacts | No | ||
| objective | No | ||
| prd_scope | No | ||
| protected | No | ||
| task_name | No | ||
| task_root | No | ||
| task_type | No | ||
| planning_mode | No | ||
| wave_manifest | No | ||
| complexity_hint | No | ||
| config_overrides | No | ||
| complexity_signals | No |