Module config 

Unified configuration system.

Consolidates configuration from three tiers with field-by-field YAML merging:

1. Defaults - Embedded at build time from ./config/
2. Project - $CWD/task-graph/ (with .task-graph/ backward compat)
3. User - ~/.task-graph/ and environment variables

Merge Strategy

• YAML files (config.yaml, prompts.yaml): Deep merge field-by-field
• Other files (skills, templates): First-found-wins from highest tier

Environment Variables

• TASK_GRAPH_CONFIG_PATH - Explicit config file (overrides all)
• TASK_GRAPH_DB_PATH - Database path
• TASK_GRAPH_MEDIA_DIR - Media directory
• TASK_GRAPH_LOG_DIR - Log directory
• TASK_GRAPH_SKILLS_DIR - Skills directory
• TASK_GRAPH_USER_DIR - User config dir (default: ~/.task-graph)
• TASK_GRAPH_PROJECT_DIR - Project config dir (default: ./task-graph)

Modules

embedded

Embedded workflow and overlay files.

watcher

File watcher for configuration files.

workflows

Workflow configuration for states, phases, and transition prompts.

Structs

AppConfig

Consolidated application configuration.

AttachmentKeyDefinition

Definition of a preconfigured attachment key.

AttachmentsConfig

Attachments configuration with preconfigured key definitions.

AutoAdvanceConfig

Auto-advance configuration for automatically transitioning tasks when dependencies are satisfied.

Config

Server configuration.

ConfigLoader

Configuration loader that handles tier-based merging.

ConfigPaths

Paths for each configuration tier.

DependenciesConfig

Dependency type configuration.

DependencyDefinition

Definition of a dependency type.

FeedbackConfig

Agent feedback configuration.

GateDefinition

Definition of a gate (checklist item) for status or phase exits.

IdsConfig

ID generation configuration.

PathsConfig

Path handling configuration.

PhasesConfig

Phase configuration for categorizing type of work.

Prompts

LLM-facing prompts configuration.

ResolvedFile

A resolved file with its content and metadata.

ServerConfig

Server-specific configuration.

ServerPaths

Paths configured for the server, returned by connect.

StateDefinition

Definition of a single task state.

StatesConfig

Task state configuration.

TagDefinition

Definition of a preconfigured tag.

TagsConfig

Tags configuration with preconfigured tag definitions.

ToolPrompt

Tool description override.

UiConfig

UI configuration for the web dashboard.

Enums

BlockTarget

What a dependency blocks.

ConfigTier

Configuration tier priority (lowest to highest).

DependencyDisplay

Display orientation for dependency visualization.

FileSource

Source of a resolved file.

GateEnforcement

Enforcement level for workflow gates (checklists that must be satisfied before status transitions).

IdCase

Case style for generated IDs.

PathStyle

Path style for file locks.

UiMode

UI mode for the server.

UnknownKeyBehavior

Behavior for unknown attachment keys.

Constants

DEFAULT_ID_WORDS

Default number of words for generated IDs.

DEFAULT_UI_PORT

Default port for the web dashboard.

Functions

deep_merge

Deep merge two JSON values, with overlay taking precedence over base.