Helper to create a test stage

Testable variant: pass `Some(dir)` to redirect hook installation to a temp directory. Production callers use `ensure_loom_permissions` which passes `N

Find the main repository root from any path within a worktree or the main repo. Given a path like `/home/user/project/.worktrees/my-stage/src/lib/mod

Force the stage into `status`, bypassing transition validation. This is the **single sanctioned** direct-assignment API. Every place that previously

Generate a handoff file for a session transitioning due to context exhaustion # Arguments `session` - The session being handed off `stage` - The stag

Check if a process with the given PID is alive Uses `nix::sys::signal::kill` with signal `None` (null signal / signal 0) to check process existence.

Merge plan-level sandbox config with stage-level overrides. Precedence for `permission_mode`: stage > plan > [`default_mode_for`]. Explicit plan/stag

Parse a type from markdown content with YAML frontmatter Generic function that extracts YAML frontmatter and deserializes it into the target type. #

Complete a stage following the proper state machine transitions. Transitions: Ready -> Executing -> Completed. Also sets merged = true which is requi

Drain `completion_rx` and join any handles whose workers signalled completion. Called once per orchestrator tick.

Format signal content using structured sections for KV-cache efficiency Signal sections (Manus pattern): 1. STABLE PREFIX - Fixed header that never c

Get Unicode icon for this activity status

Parse `raw` and either return a usable verdict (possibly coerced) or signal that the stage must be escalated to human review.

Print the loom logo with a subtitle for human-facing commands.

Set permissions in a settings Value

Validate structural aspects of the plan before execution (pre-flight checks). Returns a list of warning messages for issues that don't prevent execut

Set context percentage

Get all hook events

Get the base branch for merging

Build a command to spawn this terminal with a title, working directory, and command to execute # Arguments `title` - Window title for the terminal `w

Complete subcommands for a parent command.

Helper function to create a test stage with specific parameters. Stages created here are `StageType::Knowledge` so they bypass the git ancestry check

Detect programming languages used in a project Returns a Vec of detected languages based on manifest files: - Rust: Cargo.toml - TypeScript: tsconfig

Shared implementation: iterate over pre-compiled (Regex, kind) pairs, run against `content`, and collect symbol definitions with line numbers.

Get the path to a specific knowledge file

Match skills against input text Returns up to `max` skills sorted by relevance score (descending). Only skills with score >= 2.0 are returned (at lea

Path to `.work/plan_versions/`. Returned as an absolute path when `work_dir` is absolute. The foundations stage (parallel sibling) is expected to add

Read all non-expired soft signals from `<work_dir>/monitor/soft-signals.jsonl`. - If the file does not exist, returns `Ok(vec![])`. - Blank lines and

Read a stage's memory journal

Write `content` to `relpath` under `dirfd` with an exclusive flock, refusing every symlink along the path. The file is truncated and rewritten atomica

Unified spawn for every native session type. The per-kind variation (window title / PID-file key prefix, prompt, model/effort source, working directo

Complete the stage with validation. Computes and stores `duration_secs` from `started_at` to completion. # Returns `Ok(())` if the transition succee

Verify enhanced truth checks with extended success criteria

Check if a branch exists

Build tree lines for rendering

Mark a stage as complete, optionally running acceptance criteria. If acceptance criteria pass, auto-verifies the stage and triggers dependents. If --n

Complete stage IDs from .work/stages/*.md # Arguments `cwd` - Current working directory (project root) `prefix` - Partial stage ID prefix to filter

Expand ${ENV_VAR} patterns in strings

Extract a field value from markdown content. Handles markdown bold formatting. Field should be just the name without bold markers or colons. For exam

Check if a commit is an ancestor of a branch. Uses `git merge-base --is-ancestor` to check if the given commit is reachable from the branch head. #

Cheap predicate: is there a `MERGE_HEAD` at this repo or worktree path?

Parse plan content (for testing without file system)

Read a length-prefixed JSON message from a stream. Format: 4-byte big-endian length prefix + JSON data # Arguments `stream` - The stream to read fro

Scroll by a delta, clamping to bounds.

Serialize a Stage to markdown with YAML frontmatter Creates a markdown file with YAML frontmatter containing the stage data followed by a markdown bo

Truncate a string safely by character count, not byte count. This ensures we don't break UTF-8 encoding by cutting mid-character. Adds "..." ellipsis

Set the overall goals

Write Claude Code settings.local.json to worktree .claude/ directory

Complete flags for a given command path. `command_path` is a slice of command words, e.g. `["stage", "complete"]`.

Complete stage IDs filtered by allowed statuses. Reads stage files and parses YAML frontmatter to extract the `status:` field. Only returns stages wh

Compute SHA-256 hash of content, returning first 16 hex characters

Create a new memory journal for a stage

Helper function to create a valid LoomMetadata for testing

Extract YAML content from metadata block. Thin shim around [`extract_yaml_metadata_with_ranges`] that returns only the YAML body.

Generate settings.json content with hooks configuration This merges session-specific hooks into existing settings.json while preserving global hooks

Parse base_branch from config.toml in a work directory. This is a convenience function for extracting the base_branch field from the plan configurati

Parse a Stage from markdown with YAML frontmatter Expects content in the format: ```markdown --- id: stage-1 name: Test Stage ... --- # Stage body c

Get the plan source path

Test helper: build a HooksConfig with sensible defaults (AcceptEdits) so existing assertions hold.

Mark the stage as merge blocked (merge failed with actual error, not conflicts). This indicates the merge operation failed due to an error (not confl

Attempt to transition the session to a new status with validation. This is the primary method for changing session status. It validates that the tran

Write a signal file to the signals directory, creating it if needed. Replaces the duplicated dir-create + path-build + write pattern found across all

Accumulate time from the current execution attempt. Calculates elapsed time since `attempt_started_at`, adds it to `execution_secs`, and clears `atte

Path to the per-project admin token: `<work_dir>/admin.token`. Mode 0o600 (owner-only rw). Kept per-project rather than in a shared runtime directory

Append a soft signal as one JSON line to `<work_dir>/monitor/soft-signals.jsonl`. The parent directory is created on the first write.

Attribute the main-repo active merge (if any) to a specific stage. Algorithm (first match wins): 1. No active merge -> `None`. 2. **BaseConflict carv

Build a visual representation of the dependency graph using layered levels

Check for knowledge-related recommendations (non-fatal warnings) Returns a list of warning messages when: - Plan has root stages (no dependencies) bu

Perform full cleanup after a successful merge This function removes all resources associated with a stage after its branch has been successfully merg

Get the shell command string for this criterion

Complete plan file paths from doc/plans/*.md # Arguments `cwd` - Current working directory (project root) `prefix` - Partial filename prefix to filt