From f6e2bc8cfdf40f90526fb948131594efff9b3534 Mon Sep 17 00:00:00 2001
From: JinZhou5042 <jzhou24@nd.edu>
Date: Thu, 1 May 2025 18:20:38 -0400
Subject: [PATCH 001/113] vine: separate pending and ready tasks

---
 taskvine/src/manager/vine_manager.c  | 282 +++++++++++----------------
 taskvine/src/manager/vine_manager.h  |   1 +
 taskvine/src/manager/vine_schedule.c |  35 +++-
 taskvine/src/manager/vine_schedule.h |   1 +
 4 files changed, 150 insertions(+), 169 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 1ceeabda5f..a7a797917c 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -168,6 +168,7 @@ static void delete_uncacheable_files(struct vine_manager *q, struct vine_worker_
 static int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
+static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t);
 
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
 
@@ -1422,82 +1423,6 @@ static int fetch_outputs_from_worker(struct vine_manager *q, struct vine_worker_
 	return 1;
 }
 
-/*
-Consider the set of tasks that are waiting but not running.
-Cancel those that cannot run for unfixable policy reasons,
-such as exceeded the absolute end time, no library task available, etc.
-This is done in a separate iteration outside of scheduling
-to avoid the cost of these checks in the critical path.
-*/
-
-static int expire_waiting_tasks(struct vine_manager *q)
-{
-	struct vine_task *t;
-	int t_idx;
-	int expired = 0;
-
-	/* Measure the current time once for the whole iteration. */
-	double current_time = timestamp_get() / ONE_SECOND;
-
-	/* Only work through the queue up to iter_depth. */
-	int iter_count = 0;
-	int iter_depth = MIN(priority_queue_size(q->ready_tasks), q->attempt_schedule_depth);
-
-	PRIORITY_QUEUE_STATIC_ITERATE(q->ready_tasks, t_idx, t, iter_count, iter_depth)
-	{
-		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
-		vine_result_t result = VINE_RESULT_SUCCESS;
-
-		/* Consider each of the possible task expiration reasons. */
-
-		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
-			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
-			result = VINE_RESULT_MAX_END_TIME;
-		} else if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
-			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
-			result = VINE_RESULT_MISSING_LIBRARY;
-		}
-
-		/* If any of the reasons fired, then expire the task and put in the retrieved queue. */
-		if (result != VINE_RESULT_SUCCESS) {
-			vine_task_set_result(t, result);
-			priority_queue_remove(q->ready_tasks, t_idx);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			expired++;
-		}
-	}
-
-	/* Return the number of tasks expired. */
-	return expired;
-}
-
-/*
-Consider the set of tasks that are waiting with strict inputs
-Terminate those to which no such worker exists.
-*/
-
-static int enforce_waiting_fixed_locations(struct vine_manager *q)
-{
-	int t_idx;
-	struct vine_task *t;
-	int terminated = 0;
-
-	int iter_count = 0;
-	int iter_depth = priority_queue_size(q->ready_tasks);
-
-	PRIORITY_QUEUE_BASE_ITERATE(q->ready_tasks, t_idx, t, iter_count, iter_depth)
-	{
-		if (t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
-			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			priority_queue_remove(q->ready_tasks, t_idx);
-			terminated++;
-		}
-	}
-
-	return terminated;
-}
-
 /*
 This function handles app-level failures. It remove the task from WQ and marks
 the task as complete so it is returned to the application.
@@ -3506,83 +3431,133 @@ Advance the state of the system by selecting one task available
 to run, finding the best worker for that task, and then committing
 the task to the worker.
 */
-
 static int send_one_task(struct vine_manager *q)
 {
-	int t_idx;
-	struct vine_task *t;
+	int committable_cores = vine_schedule_find_commitable_cores(q);
+	if (committable_cores == 0) {
+		return 0;
+	}
 
-	int iter_count = 0;
-	int iter_depth = MIN(priority_queue_size(q->ready_tasks), q->attempt_schedule_depth);
-
-	// Iterate over the ready tasks by priority.
-	// The first time we arrive here, the task with the highest priority is considered. However, there may be various reasons
-	// 	that this particular task is not eligible to run, such as: 1) the task requires more resources than the workers have;
-	// 	2) the task requires input files that are not available; 3) the task failed recently; etc. (check consider_task function)
-	// Therefore, we may permit occasional skips of the highest priority task, and consider the next one in the queue. Similarly,
-	// 	other tasks may be skipped, too, until we find a task that is able to run.
-	// For a priority queue, iterating over tasks by priority is expensive, as it requires a full sort of the queue. Therefore,
-	// 	we simply iterate by numerical index if the task at the top is unable to run, and reset the cursor to the top if events
-	// 	that may enable tasks prior to the current cursor to run occur. Specifically, the following events should trigger a reset:
-	// 	1. Task retrieval from worker (resources released or inputs available)
-	// 	2. New worker connection (more resources available)
-	//  3. Delete/Insert an element prior/equal to the rotate cursor (tasks prior to the current cursor changed)
-	// 1 and 2 are explicitly handled by the manager where calls priority_queue_rotate_reset, while 3 is implicitly handled by
-	// the priority queue data structure where also invokes priority_queue_rotate_reset.
-	PRIORITY_QUEUE_ROTATE_ITERATE(q->ready_tasks, t_idx, t, iter_count, iter_depth)
-	{
+	int committed_tasks = 0;
+	int tasks_considered = 0;
+	int tasks_to_consider = MIN(priority_queue_size(q->ready_tasks), q->attempt_schedule_depth);
+
+	/* temporarily skipped tasks that are runnable but cannot fit on any current worker */
+	struct list *skipped_tasks = list_create();
+
+	while ((tasks_considered++ < tasks_to_consider) && (committed_tasks < committable_cores)) {
+
+		struct vine_task *t = priority_queue_pop(q->ready_tasks);
+		if (!t) {
+			break;
+		}
+
+		/* this task is not runnable at all, put it back in the pending queue */
 		if (!consider_task(q, t)) {
+			list_push_tail(q->pending_tasks, t);
 			continue;
 		}
 
-		// Find the best worker for the task
-		q->stats_measure->time_scheduling = timestamp_get();
+		/* select a worker for the task */
 		struct vine_worker_info *w = vine_schedule_task_to_worker(q, t);
-		q->stats->time_scheduling += timestamp_get() - q->stats_measure->time_scheduling;
 
-		if (w) {
-			priority_queue_remove(q->ready_tasks, t_idx);
+		/* task is runnable but no worker is fit, silently skip it */
+		if (!w) {
+			list_push_tail(skipped_tasks, t);
+			continue;
+		}
 
-			// do not continue if this worker is running a group task
-			if (q->task_groups_enabled) {
-				struct vine_task *it;
-				uint64_t taskid;
-				ITABLE_ITERATE(w->current_tasks, taskid, it)
-				{
-					if (it->group_id) {
-						return 0;
-					}
-				}
-			}
+		/* commit the task to the worker */
+		vine_result_code_t result;
+		if (q->task_groups_enabled) {
+			result = commit_task_group_to_worker(q, w, t);
+		} else {
+			result = commit_task_to_worker(q, w, t);
+		}
 
-			vine_result_code_t result;
-			if (q->task_groups_enabled) {
-				result = commit_task_group_to_worker(q, w, t);
-			} else {
-				result = commit_task_to_worker(q, w, t);
-			}
+		switch (result) {
+		case VINE_SUCCESS:
+			committed_tasks++;
+			break;
+		case VINE_APP_FAILURE:
+		case VINE_WORKER_FAILURE:
+			/* failed to dispatch, commit put the task back in the right place. */
+			break;
+		case VINE_MGR_FAILURE:
+			/* special case, commit had a chained failure. */
+			list_push_tail(skipped_tasks, t);
+			break;
+		case VINE_END_OF_LIST:
+			/* shouldn't happen, keep going */
+			break;
+		}
+	}
 
-			switch (result) {
-			case VINE_SUCCESS:
-				/* return on successful commit. */
-				return 1;
-				break;
-			case VINE_APP_FAILURE:
-			case VINE_WORKER_FAILURE:
-				/* failed to dispatch, commit put the task back in the right place. */
-				break;
-			case VINE_MGR_FAILURE:
-				/* special case, commit had a chained failure. */
-				priority_queue_push(q->ready_tasks, t, t->priority);
-				break;
-			case VINE_END_OF_LIST:
-				/* shouldn't happen, keep going */
-				break;
-			}
+	/* put back all tasks that were skipped */
+	struct vine_task *t;
+	while ((t = list_pop_head(skipped_tasks))) {
+		push_task_to_ready_tasks(q, t);
+	}
+	list_delete(skipped_tasks);
+
+	return committed_tasks;
+}
+
+/*
+Rotate pending tasks to the ready queue if they are runnable.
+*/
+int rotate_pending_tasks(struct vine_manager *q)
+{
+	int runnable_tasks = 0;
+
+	int tasks_considered = 0;
+	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
+	struct vine_task *t = NULL;
+
+	double current_time = timestamp_get() / ONE_SECOND;
+
+	while (tasks_considered++ < tasks_to_consider) {
+		t = list_pop_head(q->pending_tasks);
+		if (!t) {
+			break;
 		}
+
+		/* if the task is runnable, push it to the ready queue */
+		if (consider_task(q, t)) {
+			push_task_to_ready_tasks(q, t);
+			runnable_tasks++;
+			continue;
+		}
+
+		/* otherwise, check if the task has exceeded its end time or does not match any submitted library */
+		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
+		vine_result_t result = VINE_RESULT_SUCCESS;
+		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
+			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
+			result = VINE_RESULT_MAX_END_TIME;
+		}
+		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
+			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
+			result = VINE_RESULT_MISSING_LIBRARY;
+		}
+		if (result != VINE_RESULT_SUCCESS) {
+			vine_task_set_result(t, result);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
+		}
+
+		/* enforce fixed locations */
+		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
+			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
+		}
+
+		/* if the task is not runnable, put it back in the pending queue */
+		list_push_tail(q->pending_tasks, t);
 	}
 
-	return 0;
+	return runnable_tasks;
 }
 
 /*
@@ -4036,6 +4011,7 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->next_task_id = 1;
 	q->fixed_location_in_queue = 0;
 
+	q->pending_tasks = list_create();
 	q->ready_tasks = priority_queue_create(0);
 	q->running_table = itable_create(0);
 	q->waiting_retrieval_list = list_create();
@@ -4416,6 +4392,7 @@ void vine_delete(struct vine_manager *q)
 	hash_table_clear(q->categories, (void *)category_free);
 	hash_table_delete(q->categories);
 
+	list_delete(q->pending_tasks);
 	priority_queue_delete(q->ready_tasks);
 	itable_delete(q->running_table);
 	list_delete(q->waiting_retrieval_list);
@@ -4566,19 +4543,17 @@ char *vine_monitor_wrap(struct vine_manager *q, struct vine_worker_info *w, stru
 }
 
 /* Put a given task on the ready list, taking into account the task priority and the manager schedule. */
-
 static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t)
 {
 	if (t->result == VINE_RESULT_RESOURCE_EXHAUSTION) {
 		/* when a task is resubmitted given resource exhaustion, we
-		 * increment its priority by 1, so it gets to run as soon
+		 * increment its priority a bit, so it gets to run as soon
 		 * as possible among those with the same priority. This avoids
 		 * the issue in which all 'big' tasks fail because the first
 		 * allocation is too small. */
-		priority_queue_push(q->ready_tasks, t, t->priority + 1);
-	} else {
-		priority_queue_push(q->ready_tasks, t, t->priority);
+		t->priority *= 1.05;
 	}
+	priority_queue_push(q->ready_tasks, t, t->priority);
 
 	/* If the task has been used before, clear out accumulated state. */
 	vine_task_clean(t);
@@ -5294,27 +5269,6 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 		} while (q->max_retrievals < 0 || retrieved_this_cycle < q->max_retrievals || !priority_queue_size(q->ready_tasks));
 		END_ACCUM_TIME(q, time_receive);
 
-		// check for tasks that cannot run at all
-		BEGIN_ACCUM_TIME(q, time_internal);
-		result = expire_waiting_tasks(q);
-		END_ACCUM_TIME(q, time_internal);
-		if (result > 0) {
-			retrieved_this_cycle += result;
-			events++;
-		}
-
-		// only check for fixed location if any are present (high overhead)
-		if (q->fixed_location_in_queue) {
-
-			BEGIN_ACCUM_TIME(q, time_internal);
-			result = enforce_waiting_fixed_locations(q);
-			END_ACCUM_TIME(q, time_internal);
-			if (result > 0) {
-				retrieved_this_cycle += result;
-				events++;
-			}
-		}
-
 		if (retrieved_this_cycle) {
 			// reset the rotate cursor on task retrieval
 			priority_queue_rotate_reset(q->ready_tasks);
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index 32e187a506..672eb2f632 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -102,6 +102,7 @@ struct vine_manager {
 	/* Primary data structures for tracking task state. */
 
 	struct itable *tasks;           /* Maps task_id -> vine_task of all tasks in any state. */
+	struct list   *pending_tasks;      /* List of vine_task that are waiting to be dispatched. */
 	struct priority_queue   *ready_tasks;       /* Priority queue of vine_task that are waiting to execute. */
 	struct itable   *running_table;      /* Table of vine_task that are running at workers. */
 	struct list   *waiting_retrieval_list;      /* List of vine_task that are waiting to be retrieved. */
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index 80417922f5..c2eded45ef 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -149,6 +149,35 @@ int check_worker_have_enough_disk_with_inputs(struct vine_manager *q, struct vin
 	return ok;
 }
 
+/* Find the number of committable cores across all connected workers. */
+int vine_schedule_find_commitable_cores(struct vine_manager *q)
+{
+	int committable_cores = 0;
+	uint64_t library_task_id = 0;
+	struct vine_task *library_task = NULL;
+	char *key;
+	struct vine_worker_info *w;
+
+	HASH_TABLE_ITERATE(q->worker_table, key, w)
+	{
+		if (!w->resources || w->resources->cores.total <= 0) {
+			continue;
+		}
+		if (w->current_libraries && itable_size(w->current_libraries) > 0) {
+			ITABLE_ITERATE(w->current_libraries, library_task_id, library_task)
+			{
+				if (!library_task || !library_task->provides_library) {
+					continue;
+				}
+				committable_cores += (library_task->function_slots_total - library_task->function_slots_inuse);
+			}
+		}
+		committable_cores += (overcommitted_resource_total(q, w->resources->cores.total) - w->resources->cores.inuse);
+	}
+
+	return committable_cores;
+}
+
 /* Check if this worker has committable resources for any type of task.
  * If it returns false, neither a function task, library task nor a regular task can run on this worker.
  * If it returns true, the worker has either free slots for function calls or sufficient resources for regular tasks.
@@ -644,7 +673,6 @@ This is quite an expensive function and so is invoked only periodically.
 
 void vine_schedule_check_for_large_tasks(struct vine_manager *q)
 {
-	int t_idx;
 	struct vine_task *t;
 	int unfit_core = 0;
 	int unfit_mem = 0;
@@ -653,10 +681,7 @@ void vine_schedule_check_for_large_tasks(struct vine_manager *q)
 
 	struct rmsummary *largest_unfit_task = rmsummary_create(-1);
 
-	int iter_count = 0;
-	int iter_depth = priority_queue_size(q->ready_tasks);
-
-	PRIORITY_QUEUE_BASE_ITERATE(q->ready_tasks, t_idx, t, iter_count, iter_depth)
+	LIST_ITERATE(q->pending_tasks, t)
 	{
 		// check each task against the queue of connected workers
 		vine_resource_bitmask_t bit_set = is_task_larger_than_any_worker(q, t);
diff --git a/taskvine/src/manager/vine_schedule.h b/taskvine/src/manager/vine_schedule.h
index 4ef0c613a9..cb4e2a37e5 100644
--- a/taskvine/src/manager/vine_schedule.h
+++ b/taskvine/src/manager/vine_schedule.h
@@ -24,4 +24,5 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 int vine_schedule_in_ramp_down(struct vine_manager *q);
 struct vine_task *vine_schedule_find_library(struct vine_manager *q, struct vine_worker_info *w, const char *library_name);
 int check_worker_against_task(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
+int vine_schedule_find_commitable_cores(struct vine_manager *q);
 #endif

From 9abf3e5fbaa39afd66430251d536b8b132029227 Mon Sep 17 00:00:00 2001
From: JinZhou5042 <jzhou24@nd.edu>
Date: Fri, 2 May 2025 00:07:42 -0400
Subject: [PATCH 002/113] rename func name

---
 taskvine/src/manager/vine_manager.c  | 20 ++++++++++++--------
 taskvine/src/manager/vine_schedule.c |  2 +-
 taskvine/src/manager/vine_schedule.h |  2 +-
 3 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index a7a797917c..1f907c887a 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3433,8 +3433,7 @@ the task to the worker.
 */
 static int send_one_task(struct vine_manager *q)
 {
-	int committable_cores = vine_schedule_find_commitable_cores(q);
-	if (committable_cores == 0) {
+	if (vine_schedule_count_commitable_cores(q) == 0) {
 		return 0;
 	}
 
@@ -3445,9 +3444,9 @@ static int send_one_task(struct vine_manager *q)
 	/* temporarily skipped tasks that are runnable but cannot fit on any current worker */
 	struct list *skipped_tasks = list_create();
 
-	while ((tasks_considered++ < tasks_to_consider) && (committed_tasks < committable_cores)) {
+	struct vine_task *t;
 
-		struct vine_task *t = priority_queue_pop(q->ready_tasks);
+	while ((tasks_considered++ < tasks_to_consider) && (t = priority_queue_pop(q->ready_tasks))) {
 		if (!t) {
 			break;
 		}
@@ -3491,10 +3490,14 @@ static int send_one_task(struct vine_manager *q)
 			/* shouldn't happen, keep going */
 			break;
 		}
+
+		/* if we have committed a task, we are done */
+		if (committed_tasks > 0) {
+			break;
+		}
 	}
 
 	/* put back all tasks that were skipped */
-	struct vine_task *t;
 	while ((t = list_pop_head(skipped_tasks))) {
 		push_task_to_ready_tasks(q, t);
 	}
@@ -3503,9 +3506,7 @@ static int send_one_task(struct vine_manager *q)
 	return committed_tasks;
 }
 
-/*
-Rotate pending tasks to the ready queue if they are runnable.
-*/
+/* Rotate pending tasks to the ready queue if they are runnable. */
 int rotate_pending_tasks(struct vine_manager *q)
 {
 	int runnable_tasks = 0;
@@ -5285,6 +5286,9 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 			}
 			// tasks waiting to be dispatched?
 			BEGIN_ACCUM_TIME(q, time_send);
+			// rotate pending tasks before dispatching
+			rotate_pending_tasks(q);
+			// find a task to dispatch
 			result = send_one_task(q);
 			END_ACCUM_TIME(q, time_send);
 			if (result) {
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index c2eded45ef..bc19793d94 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -150,7 +150,7 @@ int check_worker_have_enough_disk_with_inputs(struct vine_manager *q, struct vin
 }
 
 /* Find the number of committable cores across all connected workers. */
-int vine_schedule_find_commitable_cores(struct vine_manager *q)
+int vine_schedule_count_commitable_cores(struct vine_manager *q)
 {
 	int committable_cores = 0;
 	uint64_t library_task_id = 0;
diff --git a/taskvine/src/manager/vine_schedule.h b/taskvine/src/manager/vine_schedule.h
index cb4e2a37e5..ad237a910d 100644
--- a/taskvine/src/manager/vine_schedule.h
+++ b/taskvine/src/manager/vine_schedule.h
@@ -24,5 +24,5 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 int vine_schedule_in_ramp_down(struct vine_manager *q);
 struct vine_task *vine_schedule_find_library(struct vine_manager *q, struct vine_worker_info *w, const char *library_name);
 int check_worker_against_task(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
-int vine_schedule_find_commitable_cores(struct vine_manager *q);
+int vine_schedule_count_commitable_cores(struct vine_manager *q);
 #endif

From 89fd46790ee1a0fd780c8ce423696648c981df50 Mon Sep 17 00:00:00 2001
From: JinZhou5042 <jzhou24@nd.edu>
Date: Fri, 2 May 2025 00:36:34 -0400
Subject: [PATCH 003/113] aggressively send tasks

---
 taskvine/src/manager/vine_manager.c | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 1f907c887a..5a7a20bc59 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3433,7 +3433,8 @@ the task to the worker.
 */
 static int send_one_task(struct vine_manager *q)
 {
-	if (vine_schedule_count_commitable_cores(q) == 0) {
+	int committable_cores = vine_schedule_count_commitable_cores(q);
+	if (committable_cores == 0) {
 		return 0;
 	}
 
@@ -3446,7 +3447,7 @@ static int send_one_task(struct vine_manager *q)
 
 	struct vine_task *t;
 
-	while ((tasks_considered++ < tasks_to_consider) && (t = priority_queue_pop(q->ready_tasks))) {
+	while ((committable_cores > 0) && (tasks_considered++ < tasks_to_consider) && (t = priority_queue_pop(q->ready_tasks))) {
 		if (!t) {
 			break;
 		}
@@ -3477,6 +3478,7 @@ static int send_one_task(struct vine_manager *q)
 		switch (result) {
 		case VINE_SUCCESS:
 			committed_tasks++;
+			committable_cores--;
 			break;
 		case VINE_APP_FAILURE:
 		case VINE_WORKER_FAILURE:
@@ -3490,11 +3492,6 @@ static int send_one_task(struct vine_manager *q)
 			/* shouldn't happen, keep going */
 			break;
 		}
-
-		/* if we have committed a task, we are done */
-		if (committed_tasks > 0) {
-			break;
-		}
 	}
 
 	/* put back all tasks that were skipped */

From fbcb4f4a355e67631d1bc0b81682c06d272d6dd2 Mon Sep 17 00:00:00 2001
From: JinZhou5042 <jzhou24@nd.edu>
Date: Fri, 2 May 2025 10:02:49 -0400
Subject: [PATCH 004/113] just send one task

---
 taskvine/src/manager/vine_manager.c | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 5a7a20bc59..8e661c4020 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3433,8 +3433,8 @@ the task to the worker.
 */
 static int send_one_task(struct vine_manager *q)
 {
-	int committable_cores = vine_schedule_count_commitable_cores(q);
-	if (committable_cores == 0) {
+	/* return if no committable cores */
+	if (vine_schedule_count_commitable_cores(q) < 1) {
 		return 0;
 	}
 
@@ -3447,7 +3447,7 @@ static int send_one_task(struct vine_manager *q)
 
 	struct vine_task *t;
 
-	while ((committable_cores > 0) && (tasks_considered++ < tasks_to_consider) && (t = priority_queue_pop(q->ready_tasks))) {
+	while ((committed_tasks == 0) && (tasks_considered++ < tasks_to_consider) && (t = priority_queue_pop(q->ready_tasks))) {
 		if (!t) {
 			break;
 		}
@@ -3478,7 +3478,6 @@ static int send_one_task(struct vine_manager *q)
 		switch (result) {
 		case VINE_SUCCESS:
 			committed_tasks++;
-			committable_cores--;
 			break;
 		case VINE_APP_FAILURE:
 		case VINE_WORKER_FAILURE:

From 8f234f300b2146e2f79958e74d80f57b29512349 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 24 May 2025 22:55:24 -0400
Subject: [PATCH 005/113] use vine_schedule_have_committable_resources

---
 taskvine/src/manager/vine_manager.c  | 14 +++++++++-----
 taskvine/src/manager/vine_schedule.c | 19 +++++++++++--------
 taskvine/src/manager/vine_schedule.h |  3 ++-
 3 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index da969850a5..f8ab7bd1a4 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3418,10 +3418,13 @@ the task to the worker.
 static int send_one_task(struct vine_manager *q)
 {
 	/* return if no committable cores */
-	if (vine_schedule_count_commitable_cores(q) < 1) {
+	if (!vine_schedule_have_committable_resources(q)) {
 		return 0;
 	}
 
+	/* rotate pending tasks before dispatching any tasks */
+	rotate_pending_tasks(q);
+
 	int committed_tasks = 0;
 	int tasks_considered = 0;
 	int tasks_to_consider = MIN(priority_queue_size(q->ready_tasks), q->attempt_schedule_depth);
@@ -3431,10 +3434,12 @@ static int send_one_task(struct vine_manager *q)
 
 	struct vine_task *t;
 
-	while ((committed_tasks == 0) && (tasks_considered++ < tasks_to_consider) && (t = priority_queue_pop(q->ready_tasks))) {
+	while ((committed_tasks == 0) && (tasks_considered < tasks_to_consider)) {
+		t = priority_queue_pop(q->ready_tasks);
 		if (!t) {
 			break;
 		}
+		tasks_considered++;
 
 		/* this task is not runnable at all, put it back in the pending queue */
 		if (!consider_task(q, t)) {
@@ -3469,7 +3474,8 @@ static int send_one_task(struct vine_manager *q)
 			break;
 		case VINE_MGR_FAILURE:
 			/* special case, commit had a chained failure. */
-			list_push_tail(skipped_tasks, t);
+			debug(D_VINE, "Special case, failed to commit task %d to worker %s", t->task_id, w->hostname);
+			list_push_tail(q->pending_tasks, t);
 			break;
 		case VINE_END_OF_LIST:
 			/* shouldn't happen, keep going */
@@ -5210,8 +5216,6 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 			}
 			// tasks waiting to be dispatched?
 			BEGIN_ACCUM_TIME(q, time_send);
-			// rotate pending tasks before dispatching
-			rotate_pending_tasks(q);
 			// find a task to dispatch
 			result = send_one_task(q);
 			END_ACCUM_TIME(q, time_send);
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index bc19793d94..ddfb88f548 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -149,12 +149,9 @@ int check_worker_have_enough_disk_with_inputs(struct vine_manager *q, struct vin
 	return ok;
 }
 
-/* Find the number of committable cores across all connected workers. */
-int vine_schedule_count_commitable_cores(struct vine_manager *q)
+/* Check if any worker has committable resources for any type of task, for now only check for available cores or slots. */
+int vine_schedule_have_committable_resources(struct vine_manager *q)
 {
-	int committable_cores = 0;
-	uint64_t library_task_id = 0;
-	struct vine_task *library_task = NULL;
 	char *key;
 	struct vine_worker_info *w;
 
@@ -164,18 +161,24 @@ int vine_schedule_count_commitable_cores(struct vine_manager *q)
 			continue;
 		}
 		if (w->current_libraries && itable_size(w->current_libraries) > 0) {
+			uint64_t library_task_id = 0;
+			struct vine_task *library_task = NULL;
 			ITABLE_ITERATE(w->current_libraries, library_task_id, library_task)
 			{
 				if (!library_task || !library_task->provides_library) {
 					continue;
 				}
-				committable_cores += (library_task->function_slots_total - library_task->function_slots_inuse);
+				if (library_task->function_slots_total > library_task->function_slots_inuse) {
+					return 1;
+				}
 			}
 		}
-		committable_cores += (overcommitted_resource_total(q, w->resources->cores.total) - w->resources->cores.inuse);
+		if (overcommitted_resource_total(q, w->resources->cores.total) > w->resources->cores.inuse) {
+			return 1;
+		}
 	}
 
-	return committable_cores;
+	return 0;
 }
 
 /* Check if this worker has committable resources for any type of task.
diff --git a/taskvine/src/manager/vine_schedule.h b/taskvine/src/manager/vine_schedule.h
index ad237a910d..8f9a4aca86 100644
--- a/taskvine/src/manager/vine_schedule.h
+++ b/taskvine/src/manager/vine_schedule.h
@@ -24,5 +24,6 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 int vine_schedule_in_ramp_down(struct vine_manager *q);
 struct vine_task *vine_schedule_find_library(struct vine_manager *q, struct vine_worker_info *w, const char *library_name);
 int check_worker_against_task(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
-int vine_schedule_count_commitable_cores(struct vine_manager *q);
+int vine_schedule_have_committable_resources(struct vine_manager *q);
+
 #endif

From 2333d651f0aa05b6687ffed97ae53e3e7be06084 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 24 May 2025 23:00:09 -0400
Subject: [PATCH 006/113] static

---
 taskvine/src/manager/vine_manager.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index f8ab7bd1a4..973eddc6b7 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3493,7 +3493,7 @@ static int send_one_task(struct vine_manager *q)
 }
 
 /* Rotate pending tasks to the ready queue if they are runnable. */
-int rotate_pending_tasks(struct vine_manager *q)
+static int rotate_pending_tasks(struct vine_manager *q)
 {
 	int runnable_tasks = 0;
 

From 904b08be1bc1c144c2b43cb6769a142e1119eeee Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 24 May 2025 23:05:17 -0400
Subject: [PATCH 007/113] vine_schedule_rotate_pending

---
 taskvine/src/manager/vine_manager.c  | 57 +---------------------------
 taskvine/src/manager/vine_schedule.c | 55 +++++++++++++++++++++++++++
 taskvine/src/manager/vine_schedule.h |  1 +
 3 files changed, 57 insertions(+), 56 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 973eddc6b7..346295efdb 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3423,7 +3423,7 @@ static int send_one_task(struct vine_manager *q)
 	}
 
 	/* rotate pending tasks before dispatching any tasks */
-	rotate_pending_tasks(q);
+	vine_schedule_rotate_pending_tasks(q);
 
 	int committed_tasks = 0;
 	int tasks_considered = 0;
@@ -3492,61 +3492,6 @@ static int send_one_task(struct vine_manager *q)
 	return committed_tasks;
 }
 
-/* Rotate pending tasks to the ready queue if they are runnable. */
-static int rotate_pending_tasks(struct vine_manager *q)
-{
-	int runnable_tasks = 0;
-
-	int tasks_considered = 0;
-	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
-	struct vine_task *t = NULL;
-
-	double current_time = timestamp_get() / ONE_SECOND;
-
-	while (tasks_considered++ < tasks_to_consider) {
-		t = list_pop_head(q->pending_tasks);
-		if (!t) {
-			break;
-		}
-
-		/* if the task is runnable, push it to the ready queue */
-		if (consider_task(q, t)) {
-			push_task_to_ready_tasks(q, t);
-			runnable_tasks++;
-			continue;
-		}
-
-		/* otherwise, check if the task has exceeded its end time or does not match any submitted library */
-		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
-		vine_result_t result = VINE_RESULT_SUCCESS;
-		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
-			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
-			result = VINE_RESULT_MAX_END_TIME;
-		}
-		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
-			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
-			result = VINE_RESULT_MISSING_LIBRARY;
-		}
-		if (result != VINE_RESULT_SUCCESS) {
-			vine_task_set_result(t, result);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-
-		/* enforce fixed locations */
-		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
-			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-
-		/* if the task is not runnable, put it back in the pending queue */
-		list_push_tail(q->pending_tasks, t);
-	}
-
-	return runnable_tasks;
-}
-
 /*
 Finding a worker that has tasks waiting to be retrieved, then fetch the outputs
 of those tasks. Returns the number of tasks received.
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index ddfb88f548..9a13a642a1 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -746,3 +746,58 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 	debug(D_VINE, "Missing fixed_location dependencies for task: %d", t->task_id);
 	return 0;
 }
+
+/* Rotate pending tasks to the ready queue if they are runnable. */
+int vine_schedule_rotate_pending_tasks(struct vine_manager *q)
+{
+	int runnable_tasks = 0;
+
+	int tasks_considered = 0;
+	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
+	struct vine_task *t = NULL;
+
+	double current_time = timestamp_get() / ONE_SECOND;
+
+	while (tasks_considered++ < tasks_to_consider) {
+		t = list_pop_head(q->pending_tasks);
+		if (!t) {
+			break;
+		}
+
+		/* if the task is runnable, push it to the ready queue */
+		if (consider_task(q, t)) {
+			push_task_to_ready_tasks(q, t);
+			runnable_tasks++;
+			continue;
+		}
+
+		/* otherwise, check if the task has exceeded its end time or does not match any submitted library */
+		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
+		vine_result_t result = VINE_RESULT_SUCCESS;
+		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
+			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
+			result = VINE_RESULT_MAX_END_TIME;
+		}
+		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
+			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
+			result = VINE_RESULT_MISSING_LIBRARY;
+		}
+		if (result != VINE_RESULT_SUCCESS) {
+			vine_task_set_result(t, result);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
+		}
+
+		/* enforce fixed locations */
+		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
+			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
+		}
+
+		/* if the task is not runnable, put it back in the pending queue */
+		list_push_tail(q->pending_tasks, t);
+	}
+
+	return runnable_tasks;
+}
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_schedule.h b/taskvine/src/manager/vine_schedule.h
index 8f9a4aca86..bce0b6e2f4 100644
--- a/taskvine/src/manager/vine_schedule.h
+++ b/taskvine/src/manager/vine_schedule.h
@@ -25,5 +25,6 @@ int vine_schedule_in_ramp_down(struct vine_manager *q);
 struct vine_task *vine_schedule_find_library(struct vine_manager *q, struct vine_worker_info *w, const char *library_name);
 int check_worker_against_task(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
 int vine_schedule_have_committable_resources(struct vine_manager *q);
+int vine_schedule_rotate_pending_tasks(struct vine_manager *q);
 
 #endif

From 96162e9330990a7882d6bf0ebed06cb4ca437c7e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 24 May 2025 23:07:04 -0400
Subject: [PATCH 008/113] revert

---
 taskvine/src/manager/vine_manager.c  | 57 +++++++++++++++++++++++++++-
 taskvine/src/manager/vine_schedule.c | 55 ---------------------------
 taskvine/src/manager/vine_schedule.h |  1 -
 3 files changed, 56 insertions(+), 57 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 346295efdb..dcedee6e9a 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3410,6 +3410,61 @@ int consider_task(struct vine_manager *q, struct vine_task *t)
 	return 1;
 }
 
+/* Rotate pending tasks to the ready queue if they are runnable. */
+static int rotate_pending_tasks(struct vine_manager *q)
+{
+	int runnable_tasks = 0;
+
+	int tasks_considered = 0;
+	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
+	struct vine_task *t = NULL;
+
+	double current_time = timestamp_get() / ONE_SECOND;
+
+	while (tasks_considered++ < tasks_to_consider) {
+		t = list_pop_head(q->pending_tasks);
+		if (!t) {
+			break;
+		}
+
+		/* if the task is runnable, push it to the ready queue */
+		if (consider_task(q, t)) {
+			push_task_to_ready_tasks(q, t);
+			runnable_tasks++;
+			continue;
+		}
+
+		/* otherwise, check if the task has exceeded its end time or does not match any submitted library */
+		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
+		vine_result_t result = VINE_RESULT_SUCCESS;
+		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
+			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
+			result = VINE_RESULT_MAX_END_TIME;
+		}
+		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
+			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
+			result = VINE_RESULT_MISSING_LIBRARY;
+		}
+		if (result != VINE_RESULT_SUCCESS) {
+			vine_task_set_result(t, result);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
+		}
+
+		/* enforce fixed locations */
+		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
+			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
+		}
+
+		/* if the task is not runnable, put it back in the pending queue */
+		list_push_tail(q->pending_tasks, t);
+	}
+
+	return runnable_tasks;
+}
+
 /*
 Advance the state of the system by selecting one task available
 to run, finding the best worker for that task, and then committing
@@ -3423,7 +3478,7 @@ static int send_one_task(struct vine_manager *q)
 	}
 
 	/* rotate pending tasks before dispatching any tasks */
-	vine_schedule_rotate_pending_tasks(q);
+	rotate_pending_tasks(q);
 
 	int committed_tasks = 0;
 	int tasks_considered = 0;
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index 9a13a642a1..c75fdc9f6a 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -745,59 +745,4 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 	}
 	debug(D_VINE, "Missing fixed_location dependencies for task: %d", t->task_id);
 	return 0;
-}
-
-/* Rotate pending tasks to the ready queue if they are runnable. */
-int vine_schedule_rotate_pending_tasks(struct vine_manager *q)
-{
-	int runnable_tasks = 0;
-
-	int tasks_considered = 0;
-	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
-	struct vine_task *t = NULL;
-
-	double current_time = timestamp_get() / ONE_SECOND;
-
-	while (tasks_considered++ < tasks_to_consider) {
-		t = list_pop_head(q->pending_tasks);
-		if (!t) {
-			break;
-		}
-
-		/* if the task is runnable, push it to the ready queue */
-		if (consider_task(q, t)) {
-			push_task_to_ready_tasks(q, t);
-			runnable_tasks++;
-			continue;
-		}
-
-		/* otherwise, check if the task has exceeded its end time or does not match any submitted library */
-		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
-		vine_result_t result = VINE_RESULT_SUCCESS;
-		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
-			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
-			result = VINE_RESULT_MAX_END_TIME;
-		}
-		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
-			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
-			result = VINE_RESULT_MISSING_LIBRARY;
-		}
-		if (result != VINE_RESULT_SUCCESS) {
-			vine_task_set_result(t, result);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-
-		/* enforce fixed locations */
-		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
-			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-
-		/* if the task is not runnable, put it back in the pending queue */
-		list_push_tail(q->pending_tasks, t);
-	}
-
-	return runnable_tasks;
 }
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_schedule.h b/taskvine/src/manager/vine_schedule.h
index bce0b6e2f4..8f9a4aca86 100644
--- a/taskvine/src/manager/vine_schedule.h
+++ b/taskvine/src/manager/vine_schedule.h
@@ -25,6 +25,5 @@ int vine_schedule_in_ramp_down(struct vine_manager *q);
 struct vine_task *vine_schedule_find_library(struct vine_manager *q, struct vine_worker_info *w, const char *library_name);
 int check_worker_against_task(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
 int vine_schedule_have_committable_resources(struct vine_manager *q);
-int vine_schedule_rotate_pending_tasks(struct vine_manager *q);
 
 #endif

From de0d70d27511ff8423efaad95f2201e1a0956f3b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 25 May 2025 03:52:28 -0400
Subject: [PATCH 009/113] adjust location

---
 taskvine/src/manager/vine_manager.c  | 41 +++++++++++++---------------
 taskvine/src/manager/vine_schedule.c |  1 -
 2 files changed, 19 insertions(+), 23 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index dcedee6e9a..30b28f1c30 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -168,7 +168,7 @@ static void delete_uncacheable_files(struct vine_manager *q, struct vine_worker_
 static int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
-static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t);
+static void enqueue_ready_task(struct vine_manager *q, struct vine_task *t);
 
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
 
@@ -3427,37 +3427,34 @@ static int rotate_pending_tasks(struct vine_manager *q)
 			break;
 		}
 
-		/* if the task is runnable, push it to the ready queue */
-		if (consider_task(q, t)) {
-			push_task_to_ready_tasks(q, t);
-			runnable_tasks++;
-			continue;
-		}
-
-		/* otherwise, check if the task has exceeded its end time or does not match any submitted library */
-		/* In this loop, use VINE_RESULT_SUCCESS as an indication of "still ok to run". */
-		vine_result_t result = VINE_RESULT_SUCCESS;
+		/* first check if the task has exceeded its end time or does not match any submitted library */
+		/* If any of the reasons fired, then expire the task and put in the retrieved queue. */
 		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
 			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
-			result = VINE_RESULT_MAX_END_TIME;
+			vine_task_set_result(t, VINE_RESULT_MAX_END_TIME);
+			change_task_state(q, t, VINE_TASK_RETRIEVED);
+			continue;
 		}
 		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
 			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
-			result = VINE_RESULT_MISSING_LIBRARY;
-		}
-		if (result != VINE_RESULT_SUCCESS) {
-			vine_task_set_result(t, result);
+			vine_task_set_result(t, VINE_RESULT_MISSING_LIBRARY);
 			change_task_state(q, t, VINE_TASK_RETRIEVED);
 			continue;
 		}
-
-		/* enforce fixed locations */
 		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
+			debug(D_VINE, "Missing fixed_location dependencies for task: %d", t->task_id);
 			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
 			change_task_state(q, t, VINE_TASK_RETRIEVED);
 			continue;
 		}
 
+		/* eligible to run, push it to the ready queue */
+		if (consider_task(q, t)) {
+			enqueue_ready_task(q, t);
+			runnable_tasks++;
+			continue;
+		}
+
 		/* if the task is not runnable, put it back in the pending queue */
 		list_push_tail(q->pending_tasks, t);
 	}
@@ -3540,7 +3537,7 @@ static int send_one_task(struct vine_manager *q)
 
 	/* put back all tasks that were skipped */
 	while ((t = list_pop_head(skipped_tasks))) {
-		push_task_to_ready_tasks(q, t);
+		enqueue_ready_task(q, t);
 	}
 	list_delete(skipped_tasks);
 
@@ -4494,8 +4491,8 @@ char *vine_monitor_wrap(struct vine_manager *q, struct vine_worker_info *w, stru
 	return wrap_cmd;
 }
 
-/* Put a given task on the ready list, taking into account the task priority and the manager schedule. */
-static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t)
+/* Put a given task on the ready queue, taking into account the task priority and the manager schedule. */
+static void enqueue_ready_task(struct vine_manager *q, struct vine_task *t)
 {
 	if (t->result == VINE_RESULT_RESOURCE_EXHAUSTION) {
 		/* when a task is resubmitted given resource exhaustion, we
@@ -4559,7 +4556,7 @@ static vine_task_state_t change_task_state(struct vine_manager *q, struct vine_t
 		break;
 	case VINE_TASK_READY:
 		vine_task_set_result(t, VINE_RESULT_UNKNOWN);
-		push_task_to_ready_tasks(q, t);
+		enqueue_ready_task(q, t);
 		c->vine_stats->tasks_waiting++;
 		break;
 	case VINE_TASK_RUNNING:
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index c75fdc9f6a..9cdc8c0f5a 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -743,6 +743,5 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 			return 1;
 		}
 	}
-	debug(D_VINE, "Missing fixed_location dependencies for task: %d", t->task_id);
 	return 0;
 }
\ No newline at end of file

From aff40f7bcdf321778fe25f82e82131ee056db4f6 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 25 May 2025 04:51:06 -0400
Subject: [PATCH 010/113] fix int done

---
 taskvine/src/manager/vine_manager.c | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 30b28f1c30..ea98ad43be 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3413,8 +3413,11 @@ int consider_task(struct vine_manager *q, struct vine_task *t)
 /* Rotate pending tasks to the ready queue if they are runnable. */
 static int rotate_pending_tasks(struct vine_manager *q)
 {
-	int runnable_tasks = 0;
+	if (list_size(q->pending_tasks) == 0) {
+		return 0;
+	}
 
+	int runnable_tasks = 0;
 	int tasks_considered = 0;
 	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
 	struct vine_task *t = NULL;
@@ -3448,15 +3451,12 @@ static int rotate_pending_tasks(struct vine_manager *q)
 			continue;
 		}
 
-		/* eligible to run, push it to the ready queue */
 		if (consider_task(q, t)) {
 			enqueue_ready_task(q, t);
 			runnable_tasks++;
-			continue;
+		} else {
+			list_push_tail(q->pending_tasks, t);
 		}
-
-		/* if the task is not runnable, put it back in the pending queue */
-		list_push_tail(q->pending_tasks, t);
 	}
 
 	return runnable_tasks;
@@ -3469,7 +3469,7 @@ the task to the worker.
 */
 static int send_one_task(struct vine_manager *q)
 {
-	/* return if no committable cores */
+	/* return early if no committable cores */
 	if (!vine_schedule_have_committable_resources(q)) {
 		return 0;
 	}
@@ -5273,7 +5273,7 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 		// in this wait.
 		if (events > 0) {
 			BEGIN_ACCUM_TIME(q, time_internal);
-			int done = !priority_queue_size(q->ready_tasks) && !list_size(q->waiting_retrieval_list) && !itable_size(q->running_table);
+			int done = !priority_queue_size(q->ready_tasks) && !list_size(q->pending_tasks) && !list_size(q->waiting_retrieval_list) && !itable_size(q->running_table);
 			END_ACCUM_TIME(q, time_internal);
 
 			if (done) {

From 7f589f22cd30241acc7b25de94dea3d4e6a59b23 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Fri, 20 Jun 2025 09:25:42 -0400
Subject: [PATCH 011/113] vine_schedule_count_committable_cores

---
 taskvine/src/manager/vine_manager.c  | 16 ++++++++++++++--
 taskvine/src/manager/vine_schedule.c | 28 ++++++++++++++++++++--------
 taskvine/src/manager/vine_schedule.h |  2 +-
 3 files changed, 35 insertions(+), 11 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 227603d72c..f1b55de3c1 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3502,7 +3502,8 @@ the task to the worker.
 static int send_one_task(struct vine_manager *q)
 {
 	/* return early if no committable cores */
-	if (!vine_schedule_have_committable_resources(q)) {
+	int committable_cores = vine_schedule_count_committable_cores(q);
+	if (committable_cores == 0) {
 		return 0;
 	}
 
@@ -3518,7 +3519,7 @@ static int send_one_task(struct vine_manager *q)
 
 	struct vine_task *t;
 
-	while ((committed_tasks == 0) && (tasks_considered < tasks_to_consider)) {
+	while (tasks_considered < tasks_to_consider) {
 		t = priority_queue_pop(q->ready_tasks);
 		if (!t) {
 			break;
@@ -3565,6 +3566,17 @@ static int send_one_task(struct vine_manager *q)
 			/* shouldn't happen, keep going */
 			break;
 		}
+
+		/* continue dispatching tasks if q->prefer_dispatch is set */
+		if (q->prefer_dispatch && committed_tasks < committable_cores) {
+			continue;
+		}
+
+		/* stop when q->prefer_dispatch is not set and at least one task has been committed,
+		 * or when it is set and all committable cores have been used */
+		if (committed_tasks > 0) {
+			break;
+		}
 	}
 
 	/* put back all tasks that were skipped */
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index 9cdc8c0f5a..1fd3e72a1f 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -149,17 +149,24 @@ int check_worker_have_enough_disk_with_inputs(struct vine_manager *q, struct vin
 	return ok;
 }
 
-/* Check if any worker has committable resources for any type of task, for now only check for available cores or slots. */
-int vine_schedule_have_committable_resources(struct vine_manager *q)
+/* Count the number of committable cores for all workers. */
+int vine_schedule_count_committable_cores(struct vine_manager *q)
 {
+	int count = 0;
+
 	char *key;
 	struct vine_worker_info *w;
-
 	HASH_TABLE_ITERATE(q->worker_table, key, w)
 	{
-		if (!w->resources || w->resources->cores.total <= 0) {
+		/* skip if the worker hasn't reported any resources yet */
+		if (!w->resources) {
+			continue;
+		}
+		/* skip if the worker has no cores or gpus */
+		if (w->resources->cores.total <= 0 && w->resources->gpus.total <= 0) {
 			continue;
 		}
+		/* count the number of free slots on running libraries */
 		if (w->current_libraries && itable_size(w->current_libraries) > 0) {
 			uint64_t library_task_id = 0;
 			struct vine_task *library_task = NULL;
@@ -169,16 +176,21 @@ int vine_schedule_have_committable_resources(struct vine_manager *q)
 					continue;
 				}
 				if (library_task->function_slots_total > library_task->function_slots_inuse) {
-					return 1;
+					count += library_task->function_slots_total - library_task->function_slots_inuse;
 				}
 			}
 		}
-		if (overcommitted_resource_total(q, w->resources->cores.total) > w->resources->cores.inuse) {
-			return 1;
+		/* count the number of free cores */
+		if (w->resources->cores.total > 0 && overcommitted_resource_total(q, w->resources->cores.total) > w->resources->cores.inuse) {
+			count += overcommitted_resource_total(q, w->resources->cores.total) - w->resources->cores.inuse;
+		}
+		/* count the number of free gpus */
+		if (w->resources->gpus.total > 0 && overcommitted_resource_total(q, w->resources->gpus.total) > w->resources->gpus.inuse) {
+			count += overcommitted_resource_total(q, w->resources->gpus.total) - w->resources->gpus.inuse;
 		}
 	}
 
-	return 0;
+	return count;
 }
 
 /* Check if this worker has committable resources for any type of task.
diff --git a/taskvine/src/manager/vine_schedule.h b/taskvine/src/manager/vine_schedule.h
index 8f9a4aca86..6455c18798 100644
--- a/taskvine/src/manager/vine_schedule.h
+++ b/taskvine/src/manager/vine_schedule.h
@@ -24,6 +24,6 @@ int vine_schedule_check_fixed_location(struct vine_manager *q, struct vine_task
 int vine_schedule_in_ramp_down(struct vine_manager *q);
 struct vine_task *vine_schedule_find_library(struct vine_manager *q, struct vine_worker_info *w, const char *library_name);
 int check_worker_against_task(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
-int vine_schedule_have_committable_resources(struct vine_manager *q);
+int vine_schedule_count_committable_cores(struct vine_manager *q);
 
 #endif

From 6714bca758e8f15641e1f9eca1a63411385bfdeb Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 13 Oct 2025 16:08:32 -0400
Subject: [PATCH 012/113] vine: function infile load mode

---
 poncho/src/poncho/library_network_code.py     | 30 +++++++++++++++----
 poncho/src/poncho/package_serverize.py        | 11 +++++--
 .../python3/ndcctools/taskvine/manager.py     |  9 ++++--
 3 files changed, 39 insertions(+), 11 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index db6127cc71..97d490ea01 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -28,6 +28,9 @@
 r, w = os.pipe()
 exec_method = None
 
+# infile load mode for function tasks inside this library
+function_infile_load_mode = None
+
 
 # This class captures how results from FunctionCalls are conveyed from
 # the library to the manager.
@@ -84,6 +87,18 @@ def sigchld_handler(signum, frame):
     os.writev(w, [b"a"])
 
 
+# Load the infile for a function task inside this library
+def load_function_infile(in_file_path):
+    if function_infile_load_mode == "cloudpickle":
+        with open(in_file_path, "rb") as f:
+            return cloudpickle.load(f)
+    elif function_infile_load_mode == "json":
+        with open(in_file_path, "r") as f:
+            return json.load(f)
+    else:
+        raise ValueError(f"invalid infile load mode: {function_infile_load_mode}")
+
+
 # Read data from worker, start function, and dump result to `outfile`.
 def start_function(in_pipe_fd, thread_limit=1):
     # read length of buffer to read
@@ -130,8 +145,7 @@ def start_function(in_pipe_fd, thread_limit=1):
                 os.chdir(function_sandbox)
 
                 # parameters are represented as infile.
-                with open("infile", "rb") as f:
-                    event = cloudpickle.load(f)
+                event = load_function_infile("infile")
 
                 # output of execution should be dumped to outfile.
                 result = globals()[function_name](event)
@@ -160,11 +174,10 @@ def start_function(in_pipe_fd, thread_limit=1):
             return -1, function_id
         else:
             try:
-                arg_infile = os.path.join(function_sandbox, "infile")
-                with open(arg_infile, "rb") as f:
-                    event = cloudpickle.load(f)
+                infile_path = os.path.join(function_sandbox, "infile")
+                event = load_function_infile(infile_path)
             except Exception:
-                stdout_timed_message(f"TASK {function_id} error: can't load the arguments from {arg_infile}")
+                stdout_timed_message(f"TASK {function_id} error: can't load the arguments from {infile_path}")
                 return
             p = os.fork()
             if p == 0:
@@ -382,11 +395,16 @@ def main():
     global exec_method
     exec_method = library_info['exec_mode']
 
+    # set infile load mode of functions in this library
+    global function_infile_load_mode
+    function_infile_load_mode = library_info['function_infile_load_mode']
+
     # send configuration of library, just its name for now
     config = {
         "name": library_info['library_name'],
         "taskid": args.task_id,
         "exec_mode": exec_method,
+        "function_infile_load_mode": function_infile_load_mode,
     }
     send_configuration(config, out_pipe_fd, args.worker_pid)
 
diff --git a/poncho/src/poncho/package_serverize.py b/poncho/src/poncho/package_serverize.py
index 4a6e5e7a29..cfc789a11b 100755
--- a/poncho/src/poncho/package_serverize.py
+++ b/poncho/src/poncho/package_serverize.py
@@ -178,6 +178,7 @@ def pack_library_code(path, envpath):
 # @param exec_mode      The execution mode of functions in this library.
 # @param hoisting_modules  A list of modules imported at the preamble of library, including packages, functions and classes.
 # @param library_context_info   A list containing [library_context_func, library_context_args, library_context_kwargs]. Used to create the library context on remote nodes.
+# @param function_infile_load_mode   The mode to load infile for function tasks inside this library.
 # @return               A hash value.
 def generate_library_hash(library_name,
                           function_list,
@@ -186,7 +187,8 @@ def generate_library_hash(library_name,
                           add_env,
                           exec_mode,
                           hoisting_modules,
-                          library_context_info):
+                          library_context_info,
+                          function_infile_load_mode):
     library_info = [library_name]
     function_list = list(function_list)
     function_names = set()
@@ -234,6 +236,8 @@ def generate_library_hash(library_name,
             for kwarg in library_context_info[2]:
                 library_info.append(str(kwarg))
                 library_info.append(str(library_context_info[2][kwarg]))
+
+    library_info.append(str(function_infile_load_mode))
     
     library_info = ''.join(library_info)    # linear time complexity
     msg = hashlib.sha1()
@@ -293,6 +297,7 @@ def generate_taskvine_library_code(library_path, hoisting_modules=None):
 # @param    exec_mode               execution mode of functions in this library
 # @param    hoisting_modules        a list of modules to be imported at the preamble of library
 # @param    library_context_info    a list containing a library's context to be created remotely
+# @param    function_infile_load_mode   The mode to load infile for function tasks inside this library.
 # @return   name of the file containing serialized information about the library
 def generate_library(library_cache_path,
                      library_code_path,
@@ -303,7 +308,8 @@ def generate_library(library_cache_path,
                      need_pack=True,
                      exec_mode='fork',
                      hoisting_modules=None,
-                     library_context_info=None
+                     library_context_info=None,
+                     function_infile_load_mode='cloudpickle'
 ):
     # create library_info.clpk
     library_info = {}
@@ -313,6 +319,7 @@ def generate_library(library_cache_path,
     library_info['library_name'] = library_name
     library_info['exec_mode'] = exec_mode
     library_info['context_info'] = cloudpickle.dumps(library_context_info)
+    library_info['function_infile_load_mode'] = function_infile_load_mode
     with open(library_info_path, 'wb') as f:
         cloudpickle.dump(library_info, f) 
 
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/manager.py b/taskvine/src/bindings/python3/ndcctools/taskvine/manager.py
index b6767a6b56..55be0e835d 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/manager.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/manager.py
@@ -936,8 +936,9 @@ def check_library_exists(self, library_name):
     # @param hoisting_modules  A list of modules imported at the preamble of library, including packages, functions and classes.
     # @param exec_mode       Execution mode that the library should use to run function calls. Either 'direct' or 'fork'
     # @param library_context_info   A list containing [library_context_func, library_context_args, library_context_kwargs]. Used to create the library context on remote nodes.
+    # @param function_infile_load_mode   The mode to load infile for function tasks inside this library.
     # @returns               A task to be used with @ref ndcctools.taskvine.manager.Manager.install_library.
-    def create_library_from_functions(self, library_name, *function_list, poncho_env=None, init_command=None, add_env=True, hoisting_modules=None, exec_mode='fork', library_context_info=None):
+    def create_library_from_functions(self, library_name, *function_list, poncho_env=None, init_command=None, add_env=True, hoisting_modules=None, exec_mode='fork', library_context_info=None, function_infile_load_mode='cloudpickle'):
         # Delay loading of poncho until here, to avoid bringing in poncho dependencies unless needed.
         # Ensure poncho python library is available.
         from ndcctools.poncho import package_serverize
@@ -959,7 +960,8 @@ def create_library_from_functions(self, library_name, *function_list, poncho_env
                                                                add_env=add_env,
                                                                exec_mode=exec_mode,
                                                                hoisting_modules=hoisting_modules,
-                                                               library_context_info=library_context_info)
+                                                               library_context_info=library_context_info,
+                                                               function_infile_load_mode=function_infile_load_mode)
 
         # Create path for caching library code and environment based on function hash.
         library_cache_dir_name = "vine-library-cache"
@@ -1007,7 +1009,8 @@ def create_library_from_functions(self, library_name, *function_list, poncho_env
                                                need_pack=need_pack,
                                                exec_mode=exec_mode,
                                                hoisting_modules=hoisting_modules,
-                                               library_context_info=library_context_info)
+                                               library_context_info=library_context_info,
+                                               function_infile_load_mode=function_infile_load_mode)
 
             # enable correct permissions for library code
             os.chmod(library_code_path, 0o775)

From a78dc95adf8d3d26fa28feb4d0be7513e2066aba Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 13 Oct 2025 16:18:57 -0400
Subject: [PATCH 013/113] specify utf-8

---
 poncho/src/poncho/library_network_code.py | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index db6127cc71..9e533ee53f 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -174,12 +174,7 @@ def start_function(in_pipe_fd, thread_limit=1):
 
                     stdout_timed_message(f"TASK {function_id} {function_name} arrives, starting to run in process {os.getpid()}")
 
-                    try:
-                        exit_status = 1
-                    except Exception:
-                        stdout_timed_message(f"TASK {function_id} error: can't load the arguments from infile")
-                        exit_status = 2
-                        raise
+                    exit_status = 1
 
                     try:
                         # setup stdout/err for a function call so we can capture them.
@@ -199,7 +194,7 @@ def start_function(in_pipe_fd, thread_limit=1):
                         os.dup2(library_fd, sys.stdout.fileno())
                     except Exception:
                         stdout_timed_message(f"TASK {function_id} error: can't execute this function")
-                        exit_status = 3
+                        exit_status = 2
                         raise
                     finally:
                         if function_stdout_fd in locals():
@@ -210,14 +205,14 @@ def start_function(in_pipe_fd, thread_limit=1):
                             cloudpickle.dump(result, f)
                     except Exception:
                         stdout_timed_message(f"TASK {function_id} error: can't load the result from outfile")
-                        exit_status = 4
-                        if os.path.exits("outfile"):
+                        exit_status = 3
+                        if os.path.exists("outfile"):
                             os.remove("outfile")
                         raise
 
                     try:
                         if not result["Success"]:
-                            exit_status = 5
+                            exit_status = 4
                     except Exception:
                         stdout_timed_message(f"TASK {function_id} error: the result is invalid")
                         exit_status = 5
@@ -232,14 +227,12 @@ def start_function(in_pipe_fd, thread_limit=1):
                     os._exit(exit_status)
             elif p < 0:
                 stdout_timed_message(f"TASK {function_id} error: unable to fork to execute {function_name}")
-                return -1
+                return -1, function_id
 
             # return pid and function id of child process to parent.
             else:
                 return p, function_id
 
-    return -1
-
 
 # Send result of a function execution to worker. Wake worker up to do work with SIGCHLD.
 def send_result(out_pipe_fd, worker_pid, task_id, exit_code):

From 83cd050f07b7ccbecc9f2e89389702c98672e2da Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 13 Oct 2025 16:19:50 -0400
Subject: [PATCH 014/113] utf-8

---
 poncho/src/poncho/library_network_code.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index 97d490ea01..31dc5b2927 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -93,7 +93,7 @@ def load_function_infile(in_file_path):
         with open(in_file_path, "rb") as f:
             return cloudpickle.load(f)
     elif function_infile_load_mode == "json":
-        with open(in_file_path, "r") as f:
+        with open(in_file_path, "r", encoding="utf-8") as f:
             return json.load(f)
     else:
         raise ValueError(f"invalid infile load mode: {function_infile_load_mode}")

From d6f2fea0cb83b27693b36bd4795224679b93d0e5 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 13 Oct 2025 16:56:48 -0400
Subject: [PATCH 015/113] vine: some bug fixes for the library code

---
 poncho/src/poncho/library_network_code.py | 51 +++++++++++------------
 1 file changed, 25 insertions(+), 26 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index 9e533ee53f..b696ee5e57 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -81,7 +81,10 @@ def remote_wrapper(event):
 # Handler to sigchld when child exits.
 def sigchld_handler(signum, frame):
     # write any byte to signal that there's at least 1 child
-    os.writev(w, [b"a"])
+    try:
+        os.write(w, b"a")
+    except OSError:
+        pass
 
 
 # Read data from worker, start function, and dump result to `outfile`.
@@ -150,10 +153,7 @@ def start_function(in_pipe_fd, thread_limit=1):
                     raise
 
             except Exception as e:
-                stdout_timed_message(
-                    f"Library code: Function call failed due to {e}",
-                    file=sys.stderr,
-                )
+                stdout_timed_message(f"Library code: Function call failed due to {e}")
                 sys.exit(1)
             finally:
                 os.chdir(library_sandbox)
@@ -165,40 +165,31 @@ def start_function(in_pipe_fd, thread_limit=1):
                     event = cloudpickle.load(f)
             except Exception:
                 stdout_timed_message(f"TASK {function_id} error: can't load the arguments from {arg_infile}")
-                return
+                return -1, function_id
             p = os.fork()
             if p == 0:
+                exit_status = 1
+
                 try:
                     # change the working directory to the function's sandbox
                     os.chdir(function_sandbox)
 
                     stdout_timed_message(f"TASK {function_id} {function_name} arrives, starting to run in process {os.getpid()}")
 
-                    exit_status = 1
-
                     try:
-                        # setup stdout/err for a function call so we can capture them.
-                        function_stdout_fd = os.open(
-                            function_stdout_filename, os.O_WRONLY | os.O_CREAT | os.O_TRUNC
-                        )
-                        # store the library's stdout fd
-                        library_fd = os.dup(sys.stdout.fileno())
+                        # each child process independently redirects its own stdout/stderr.
+                        with open(function_stdout_filename, "wb", buffering=0) as f:
+                            os.dup2(f.fileno(), 1)  # redirect stdout
+                            os.dup2(f.fileno(), 2)  # redirect stderr
 
-                        # only redirect the stdout of a specific FunctionCall task into its own stdout fd,
-                        # otherwise use the library's stdout
-                        os.dup2(function_stdout_fd, sys.stdout.fileno())
-                        os.dup2(function_stdout_fd, sys.stderr.fileno())
-                        result = globals()[function_name](event)
+                            stdout_timed_message(f"TASK {function_id} {function_name} starts in PID {os.getpid()}")
+                            result = globals()[function_name](event)
+                            stdout_timed_message(f"TASK {function_id} {function_name} finished")
 
-                        # restore to the library's stdout fd on completion
-                        os.dup2(library_fd, sys.stdout.fileno())
                     except Exception:
-                        stdout_timed_message(f"TASK {function_id} error: can't execute this function")
+                        stdout_timed_message(f"TASK {function_id} error: can't execute {function_name} due to {traceback.format_exc()}")
                         exit_status = 2
                         raise
-                    finally:
-                        if function_stdout_fd in locals():
-                            os.close(function_stdout_fd)
 
                     try:
                         with open("outfile", "wb") as f:
@@ -424,7 +415,15 @@ def main():
                     )
                 else:
                     pid, func_id = start_function(in_pipe_fd, thread_limit)
-                    pid_to_func_id[pid] = func_id
+                    if pid == -1:
+                        send_result(
+                            out_pipe_fd,
+                            args.worker_pid,
+                            func_id,
+                            1,
+                        )
+                    else:
+                        pid_to_func_id[pid] = func_id
             else:
                 # at least 1 child exits, reap all.
                 # read only once as os.read is blocking if there's nothing to read.

From d79b1edcc019cab0167d7e17e3de46f01cf5ed9a Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 10:30:06 -0400
Subject: [PATCH 016/113] dttools: progress_bar src and test

---
 dttools/src/.gitignore          |   3 +-
 dttools/src/Makefile            |   5 +-
 dttools/src/progress_bar.c      | 271 ++++++++++++++++++++++++++++++++
 dttools/src/progress_bar.h      |  86 ++++++++++
 dttools/src/progress_bar_test.c |  33 ++++
 5 files changed, 396 insertions(+), 2 deletions(-)
 create mode 100644 dttools/src/progress_bar.c
 create mode 100644 dttools/src/progress_bar.h
 create mode 100644 dttools/src/progress_bar_test.c

diff --git a/dttools/src/.gitignore b/dttools/src/.gitignore
index 019e34fc65..1af0628763 100644
--- a/dttools/src/.gitignore
+++ b/dttools/src/.gitignore
@@ -41,4 +41,5 @@ bucketing_manager_test
 hash_table_fromkey_test
 hash_table_offset_test
 hash_table_benchmark
-priority_queue_test
\ No newline at end of file
+priority_queue_test
+progress_bar_test
\ No newline at end of file
diff --git a/dttools/src/Makefile b/dttools/src/Makefile
index 829e42ef5c..c5103861b0 100644
--- a/dttools/src/Makefile
+++ b/dttools/src/Makefile
@@ -94,6 +94,8 @@ SOURCES = \
 	priority_queue.c \
 	priority_queue_test.c \
 	process.c \
+	progress_bar.c \
+	progress_bar_test.c \
 	random.c \
 	rmonitor.c \
 	rmonitor_poll.c \
@@ -164,6 +166,7 @@ HEADERS_PUBLIC = \
 	macros.h \
 	path.h \
 	priority_queue.h \
+	progress_bar.h \
 	rmonitor_poll.h \
 	rmsummary.h \
 	stringtools.h \
@@ -193,7 +196,7 @@ PROGRAMS = $(MOST_PROGRAMS) catalog_query
 
 SCRIPTS = cctools_gpu_autodetect
 TARGETS = $(LIBRARIES) $(PRELOAD_LIBRARIES) $(PROGRAMS) $(TEST_PROGRAMS)
-TEST_PROGRAMS = auth_test disk_alloc_test jx_test microbench multirun jx_count_obj_test jx_canonicalize_test jx_merge_test hash_table_offset_test hash_table_fromkey_test hash_table_benchmark histogram_test category_test jx_binary_test bucketing_base_test bucketing_manager_test priority_queue_test
+TEST_PROGRAMS = auth_test disk_alloc_test jx_test microbench multirun jx_count_obj_test jx_canonicalize_test jx_merge_test hash_table_offset_test hash_table_fromkey_test hash_table_benchmark histogram_test category_test jx_binary_test bucketing_base_test bucketing_manager_test priority_queue_test progress_bar_test
 
 all: $(TARGETS) catalog_query
 
diff --git a/dttools/src/progress_bar.c b/dttools/src/progress_bar.c
new file mode 100644
index 0000000000..14e1995b42
--- /dev/null
+++ b/dttools/src/progress_bar.c
@@ -0,0 +1,271 @@
+/*
+Copyright (C) 2025 The University of Notre Dame
+This software is distributed under the GNU General Public License.
+See the file COPYING for details.
+*/
+
+/** @file progress_bar.c
+Implementation of a terminal progress bar with multiple parts.
+*/
+
+#include "progress_bar.h"
+#include "xxmalloc.h"
+#include "macros.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include <unistd.h>
+#include <sys/ioctl.h>
+#include <assert.h>
+#include <stdint.h>
+#include <inttypes.h>
+
+/* Max bar width (in block characters) for single-line rendering. */
+#define MAX_BAR_WIDTH 30
+/* Minimum redraw interval to avoid flicker. */
+#define PROGRESS_BAR_UPDATE_INTERVAL ((USECOND) * 0.1)
+
+#define COLOR_RESET "\033[0m"
+#define COLOR_GREEN "\033[32m"
+#define COLOR_CYAN "\033[38;2;0;255;255m"
+#define COLOR_ORANGE "\033[38;2;255;165;0m"
+#define COLOR_PURPLE "\033[38;2;128;0;128m"
+#define COLOR_PINK "\033[38;2;255;192;203m"
+#define COLOR_YELLOW "\033[38;2;255;255;0m"
+
+/** Get terminal width in columns; return 80 on failure. */
+static int get_terminal_width()
+{
+	struct winsize w;
+
+	if (ioctl(STDOUT_FILENO, TIOCGWINSZ, &w) == -1) {
+		return 80;
+	}
+
+	return w.ws_col;
+}
+
+/** Compute bar width based on terminal and labels; clamp to bounds. */
+static int compute_bar_width(const char *label, int part_text_len)
+{
+	if (!label) {
+		return 0;
+	}
+
+	int term_width = get_terminal_width();
+	int label_len = strlen(label);
+	int bar_width = term_width - label_len - part_text_len - 28;
+
+	if (bar_width > MAX_BAR_WIDTH) {
+		bar_width = MAX_BAR_WIDTH;
+	}
+
+	if (bar_width < 10) {
+		bar_width = 10;
+	}
+
+	return (int)(bar_width * 0.8);
+}
+
+/** Render one-line progress bar with aggregated totals, progress, and elapsed time. */
+static void print_progress_bar(struct ProgressBar *bar)
+{
+	if (!bar) {
+		return;
+	}
+
+	bar->last_draw_time = timestamp_get();
+
+	char part_text[256];
+	char *ptr = part_text;
+	int remain = sizeof(part_text);
+	int written = snprintf(ptr, remain, "[");
+	ptr += written;
+	remain -= written;
+
+	uint64_t total_sum = 0;
+	uint64_t current_sum = 0;
+
+	bool first = true;
+	struct ProgressBarPart *p;
+	LIST_ITERATE(bar->parts, p)
+	{
+		total_sum += p->total;
+		current_sum += p->current;
+
+		if (!first) {
+			written = snprintf(ptr, remain, ", ");
+			ptr += written;
+			remain -= written;
+		}
+
+		written = snprintf(ptr, remain, "%s: %" PRIu64 "/%" PRIu64, p->label, p->current, p->total);
+		ptr += written;
+		remain -= written;
+
+		first = false;
+	}
+	snprintf(ptr, remain, "]");
+	part_text[sizeof(part_text) - 1] = '\0';
+
+	float progress = (total_sum > 0) ? ((float)current_sum / total_sum) : 0.0f;
+	if (progress > 1.0f) {
+		progress = 1.0f;
+	}
+
+	timestamp_t elapsed = timestamp_get() - bar->start_time;
+	int h = elapsed / (3600LL * USECOND);
+	int m = (elapsed % (3600LL * USECOND)) / (60LL * USECOND);
+	int s = (elapsed % (60LL * USECOND)) / USECOND;
+
+	if (bar->has_drawn_once) {
+		printf("\r\033[2K");
+	} else {
+		bar->has_drawn_once = 1;
+	}
+
+	int part_text_len = (int)(ptr - part_text) + 1;
+	int bar_width = compute_bar_width(bar->label, part_text_len);
+	int filled = (int)(progress * bar_width);
+
+	char bar_line[MAX_BAR_WIDTH * 3 + 1];
+	int offset = 0;
+	const char *block = "━";
+
+	for (int i = 0; i < filled; ++i) {
+		memcpy(bar_line + offset, block, 3);
+		offset += 3;
+	}
+
+	memset(bar_line + offset, ' ', (bar_width - filled));
+	offset += (bar_width - filled);
+	bar_line[offset] = '\0';
+
+	printf("%s " COLOR_GREEN "%s %" PRIu64 "/%" PRIu64 COLOR_YELLOW " %s" COLOR_CYAN " %.1f%%" COLOR_ORANGE " %02d:%02d:%02d" COLOR_RESET,
+			bar->label ? bar->label : "",
+			bar_line,
+			current_sum,
+			total_sum,
+			part_text,
+			progress * 100,
+			h,
+			m,
+			s);
+
+	fflush(stdout);
+}
+
+/** Create and initialize a progress bar. */
+struct ProgressBar *progress_bar_init(const char *label)
+{
+	if (!label) {
+		return NULL;
+	}
+
+	struct ProgressBar *bar = xxmalloc(sizeof(struct ProgressBar));
+
+	bar->label = xxstrdup(label);
+	bar->parts = list_create();
+	bar->start_time = timestamp_get();
+	bar->last_draw_time = timestamp_get();
+	bar->has_drawn_once = 0;
+
+	return bar;
+}
+
+/** Create a new part. */
+struct ProgressBarPart *progress_bar_create_part(const char *label, uint64_t total)
+{
+	if (!label) {
+		return NULL;
+	}
+
+	struct ProgressBarPart *part = xxmalloc(sizeof(struct ProgressBarPart));
+
+	part->label = xxstrdup(label);
+	part->total = total;
+	part->current = 0;
+
+	return part;
+}
+
+/** Bind a part to the progress bar. */
+void progress_bar_bind_part(struct ProgressBar *bar, struct ProgressBarPart *part)
+{
+	if (!bar || !part) {
+		return;
+	}
+
+	list_push_tail(bar->parts, part);
+	print_progress_bar(bar);
+}
+
+/** Set the total for a part. */
+void progress_bar_set_part_total(struct ProgressBar *bar, struct ProgressBarPart *part, uint64_t new_total)
+{
+	if (!bar || !part) {
+		return;
+	}
+	part->total = new_total;
+
+	print_progress_bar(bar);
+}
+
+/** Advance a part's current value, redraw if needed. */
+void progress_bar_update_part(struct ProgressBar *bar, struct ProgressBarPart *part, uint64_t increment)
+{
+	if (!bar || !part) {
+		return;
+	}
+
+	part->current += increment;
+	if (part->current > part->total) {
+		part->current = part->total;
+	}
+
+	if (timestamp_get() - bar->last_draw_time < PROGRESS_BAR_UPDATE_INTERVAL) {
+		return;
+	}
+
+	print_progress_bar(bar);
+}
+
+/** Set the start time for the progress bar. */
+void progress_bar_set_start_time(struct ProgressBar *bar, timestamp_t start_time)
+{
+	if (!bar) {
+		return;
+	}
+
+	bar->start_time = start_time;
+}
+
+/** Final render and newline. */
+void progress_bar_finish(struct ProgressBar *bar)
+{
+	if (!bar) {
+		return;
+	}
+
+	print_progress_bar(bar);
+	printf("\n");
+}
+
+/** Free the progress bar, its parts, and internal resources. */
+void progress_bar_delete(struct ProgressBar *bar)
+{
+	if (!bar) {
+		return;
+	}
+
+	free(bar->label);
+	struct ProgressBarPart *p;
+	LIST_ITERATE(bar->parts, p)
+	{
+		free(p->label);
+		free(p);
+	}
+	list_delete(bar->parts);
+	free(bar);
+}
diff --git a/dttools/src/progress_bar.h b/dttools/src/progress_bar.h
new file mode 100644
index 0000000000..6a38a95424
--- /dev/null
+++ b/dttools/src/progress_bar.h
@@ -0,0 +1,86 @@
+/*
+Copyright (C) 2025 The University of Notre Dame
+This software is distributed under the GNU General Public License.
+See the file COPYING for details.
+*/
+
+/** @file progress_bar.h
+Terminal progress bar API with multiple parts.
+*/
+
+#ifndef PROGRESS_BAR_H
+#define PROGRESS_BAR_H
+
+#include "list.h"
+#include "timestamp.h"
+#include <time.h>
+#include <stdint.h>
+
+/** A part of a progress bar. */
+struct ProgressBarPart {
+	char *label;
+	uint64_t total;
+	uint64_t current;
+};
+
+/** Progress bar object. */
+struct ProgressBar {
+	char *label;
+	struct list *parts;
+	timestamp_t start_time;
+    timestamp_t last_draw_time;
+	int has_drawn_once;
+};
+
+/* Progress Bar Part API */
+
+/** Create a progress bar.
+@param label Progress bar label (internally duplicated).
+@return New progress bar.
+*/
+struct ProgressBar *progress_bar_init(const char *label);
+
+/** Create a new part.
+@param label Part label (internally duplicated).
+@param total Total units for the part.
+@return New part.
+*/
+struct ProgressBarPart *progress_bar_create_part(const char *label, uint64_t total);
+
+/** Bind a part to the progress bar.
+@param bar Progress bar.
+@param part Part to bind.
+*/
+void progress_bar_bind_part(struct ProgressBar *bar, struct ProgressBarPart *part);
+
+/** Set the total for a part.
+@param bar Progress bar.
+@param part Part to update.
+@param new_total New total units.
+*/
+void progress_bar_set_part_total(struct ProgressBar *bar, struct ProgressBarPart *part, uint64_t new_total);
+
+/** Update the current value for a part, redraw if needed.
+@param bar Progress bar.
+@param part Part to advance.
+@param increment Amount to add.
+*/
+void progress_bar_update_part(struct ProgressBar *bar, struct ProgressBarPart *part, uint64_t increment);
+
+/** Set the start time for the progress bar.
+@param bar Progress bar.
+@param start_time Start timestamp.
+*/
+void progress_bar_set_start_time(struct ProgressBar *bar, timestamp_t start_time);
+
+/** Finish the progress bar: draw once and print a newline.
+@param bar Progress bar.
+*/
+void progress_bar_finish(struct ProgressBar *bar);
+
+/** Delete the progress bar and free all parts.
+@param bar Progress bar.
+*/
+void progress_bar_delete(struct ProgressBar *bar);
+
+#endif
diff --git a/dttools/src/progress_bar_test.c b/dttools/src/progress_bar_test.c
new file mode 100644
index 0000000000..6eaab8510d
--- /dev/null
+++ b/dttools/src/progress_bar_test.c
@@ -0,0 +1,33 @@
+#include "progress_bar.h"
+#include "list.h"
+#include "timestamp.h"
+#include <unistd.h>
+#include <stdio.h>
+
+int main()
+{
+	uint64_t total = 100000;
+	struct ProgressBarPart *part1 = progress_bar_create_part("step", total);
+	struct ProgressBarPart *part2 = progress_bar_create_part("fetch", total);
+	struct ProgressBarPart *part3 = progress_bar_create_part("commit", total);
+
+	struct ProgressBar *bar = progress_bar_init("Compute");
+	progress_bar_bind_part(bar, part1);
+	progress_bar_bind_part(bar, part2);
+	progress_bar_bind_part(bar, part3);
+
+	timestamp_t start_time = timestamp_get();
+	for (uint64_t i = 0; i < total; i++) {
+		progress_bar_update_part(bar, part1, 1);
+		progress_bar_update_part(bar, part2, 1);
+		progress_bar_update_part(bar, part3, 1);
+	}
+
+	progress_bar_finish(bar);
+	progress_bar_delete(bar);
+
+	timestamp_t end_time = timestamp_get();
+	printf("time taken: %ld\n", end_time - start_time);
+
+	return 0;
+}

From 354a6d4fe7f699894720c3ef480343598dcff571 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 10:32:13 -0400
Subject: [PATCH 017/113] add unit

---
 dttools/src/progress_bar_test.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dttools/src/progress_bar_test.c b/dttools/src/progress_bar_test.c
index 6eaab8510d..29177fafb1 100644
--- a/dttools/src/progress_bar_test.c
+++ b/dttools/src/progress_bar_test.c
@@ -27,7 +27,7 @@ int main()
 	progress_bar_delete(bar);
 
 	timestamp_t end_time = timestamp_get();
-	printf("time taken: %ld\n", end_time - start_time);
+	printf("time taken: %ld us\n", end_time - start_time);
 
 	return 0;
 }

From 81b228f04c1fb83a892f80c478a3e24548448003 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 10:38:21 -0400
Subject: [PATCH 018/113] format issue

---
 dttools/src/progress_bar_test.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dttools/src/progress_bar_test.c b/dttools/src/progress_bar_test.c
index 29177fafb1..4c72d09425 100644
--- a/dttools/src/progress_bar_test.c
+++ b/dttools/src/progress_bar_test.c
@@ -27,7 +27,7 @@ int main()
 	progress_bar_delete(bar);
 
 	timestamp_t end_time = timestamp_get();
-	printf("time taken: %ld us\n", end_time - start_time);
+	printf("time taken: %" PRIu64 "\n", end_time - start_time);
 
 	return 0;
 }

From d5dad06e85a91f4c73ae9568ce27bd10e2c76428 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 10:51:03 -0400
Subject: [PATCH 019/113] vine: valid link when sending message on worker

---
 taskvine/src/worker/vine_worker.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/taskvine/src/worker/vine_worker.c b/taskvine/src/worker/vine_worker.c
index d285d5bb4c..d1ab432cef 100644
--- a/taskvine/src/worker/vine_worker.c
+++ b/taskvine/src/worker/vine_worker.c
@@ -270,6 +270,10 @@ void deliver_async_messages(struct link *l)
 
 void send_async_message(struct link *l, const char *fmt, ...)
 {
+	if (!l) {
+		return;
+	}
+
 	va_list va;
 	char *message = malloc(VINE_LINE_MAX);
 	va_start(va, fmt);
@@ -498,6 +502,10 @@ its size in bytes and transfer time in usec.
 
 void vine_worker_send_cache_update(struct link *manager, const char *cachename, struct vine_cache_file *f)
 {
+	if (!manager) {
+		return;
+	}
+
 	char *transfer_id = hash_table_remove(current_transfers, cachename);
 	if (!transfer_id) {
 		transfer_id = xxstrdup("X");
@@ -524,6 +532,10 @@ could not be loaded.  Accompanied by a corresponding error message.
 
 void vine_worker_send_cache_invalid(struct link *manager, const char *cachename, const char *message)
 {
+	if (!manager) {
+		return;
+	}
+
 	int length = strlen(message);
 	char *transfer_id = hash_table_remove(current_transfers, cachename);
 	if (transfer_id) {

From 39b1d66baf42cbaac0bc24dd805677dbad8254ab Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 15:47:17 -0400
Subject: [PATCH 020/113] vine: LIST_ITERATE_REVERSE

---
 dttools/src/list.c | 13 +++++++++++++
 dttools/src/list.h | 29 +++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+)

diff --git a/dttools/src/list.c b/dttools/src/list.c
index 7cba58fb7c..251fce77fa 100644
--- a/dttools/src/list.c
+++ b/dttools/src/list.c
@@ -629,6 +629,11 @@ void list_first_item(struct list *list)
 	list_seek(list->iter, 0);
 }
 
+void list_last_item(struct list *list)
+{
+	list_seek(list->iter, -1);
+}
+
 void *list_next_item(struct list *list)
 {
 	void *item = NULL;
@@ -637,6 +642,14 @@ void *list_next_item(struct list *list)
 	return item;
 }
 
+void *list_prev_item(struct list *list)
+{
+	void *item = NULL;
+	list_get(list->iter, &item);
+	list_prev(list->iter);
+	return item;
+}
+
 struct list *list_duplicate(struct list *src)
 {
 	void *item;
diff --git a/dttools/src/list.h b/dttools/src/list.h
index 4a75ad2379..22ec74c1c2 100644
--- a/dttools/src/list.h
+++ b/dttools/src/list.h
@@ -374,6 +374,14 @@ Call @ref list_next_item to begin returning the items.
 
 void list_first_item(struct list *list);
 
+/** Begin traversing a list in reverse.
+This function sets the internal list iterator to the last item.
+Call @ref list_prev_item to begin returning the items in reverse order.
+@param list The list to traverse.
+*/
+
+void list_last_item(struct list *list);
+
 /** Continue traversing a list.
 This function returns the current list item,
 and advances the internal iterator to the next item.
@@ -383,6 +391,15 @@ and advances the internal iterator to the next item.
 
 void *list_next_item(struct list *list);
 
+/** Continue traversing a list in reverse.
+This function returns the current list item,
+and advances the internal iterator to the previous item.
+@param list The list to traverse.
+@return The current item in the list, NULL if end of list.
+*/
+
+void *list_prev_item(struct list *list);
+
 /** Apply a function to a list.
 Invokes op on every member of the list.
 @param list The list to operate on.
@@ -421,4 +438,16 @@ LIST_ITERATE( list, s ) {
 
 #define LIST_ITERATE( list, item ) list_first_item(list); while((item=list_next_item(list)))
 
+/** Macro to iterate over a list in reverse order.
+Note that a statement or code block must follow the macro, like this:
+<pre>
+char *s;
+LIST_ITERATE_REVERSE( list, s ) {
+	printf("%s\n",s);
+}
+</pre>
+*/
+
+#define LIST_ITERATE_REVERSE( list, item ) list_last_item(list); while((item=list_prev_item(list)))
+
 #endif

From e94875e447d6470eaed87a8168993441d8d5356c Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 15:47:49 -0400
Subject: [PATCH 021/113] temp

---
 .../ndcctools/taskvine/graph_definition.py    | 331 ++++++++
 .../ndcctools/taskvine/graph_executor.py      | 251 ++++++
 taskvine/src/manager/Makefile                 |   5 +-
 taskvine/src/manager/taskvine.h               | 121 +++
 .../src/manager/vine_file_replica_table.c     |   3 +-
 taskvine/src/manager/vine_manager.c           | 392 +++++++---
 taskvine/src/manager/vine_manager.h           |  19 +-
 taskvine/src/manager/vine_task_graph.c        | 739 ++++++++++++++++++
 taskvine/src/manager/vine_task_graph.h        |  24 +
 taskvine/src/manager/vine_task_node.c         | 611 +++++++++++++++
 taskvine/src/manager/vine_task_node.h         |  76 ++
 taskvine/src/manager/vine_temp.c              | 288 +++++++
 taskvine/src/manager/vine_temp.h              |  16 +
 13 files changed, 2757 insertions(+), 119 deletions(-)
 create mode 100644 taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
 create mode 100644 taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
 create mode 100644 taskvine/src/manager/vine_task_graph.c
 create mode 100644 taskvine/src/manager/vine_task_graph.h
 create mode 100644 taskvine/src/manager/vine_task_node.c
 create mode 100644 taskvine/src/manager/vine_task_node.h
 create mode 100644 taskvine/src/manager/vine_temp.c
 create mode 100644 taskvine/src/manager/vine_temp.h

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
new file mode 100644
index 0000000000..b9db690ad2
--- /dev/null
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
@@ -0,0 +1,331 @@
+from ndcctools.taskvine.utils import load_variable_from_library
+
+import os
+import hashlib
+import time
+import cloudpickle
+import collections
+import uuid
+import random
+from collections import deque
+
+try:
+    import dask
+except ImportError:
+    dask = None
+
+try:
+    import dask._task_spec as dts
+except ImportError:
+    dts = None
+
+
+def hash_name(*args):
+    out_str = ""
+    for arg in args:
+        out_str += str(arg)
+    return hashlib.sha256(out_str.encode('utf-8')).hexdigest()[:32]
+
+
+def hashable(s):
+    try:
+        hash(s)
+        return True
+    except TypeError:
+        return False
+
+
+def dist_func(mode, low, high):
+    if not mode:
+        return 0
+
+    assert mode in ["uniform", "normal", "lognormal", "pareto", "mix"]
+    # uniform distribution, flat spread
+    def uniform_dist():
+        return random.uniform(low, high)
+
+    # normal distribution, centered in the middle
+    def normal_dist():
+        mu, sigma = (low + high) / 2, (high - low) / 6
+        return min(max(random.gauss(mu, sigma), low), high)
+
+    # lognormal distribution, long tail
+    def lognormal_dist():
+        val = random.lognormvariate(0, 1)
+        val = val / (1 + val)
+        return low + (high - low) * val
+
+    # pareto distribution, very heavy tail
+    def pareto_dist(alpha=2.0):
+        val = random.paretovariate(alpha)
+        val = val / (1 + val)
+        return low + (high - low) * val
+
+    # mixture: most small values, few large ones
+    def mix_dist():
+        if random.random() < 0.9:
+            return random.uniform(low, (low + high) / 2)
+        else:
+            return random.uniform((low + high) / 2, high)
+
+    return {
+        "uniform": uniform_dist,
+        "normal": normal_dist,
+        "lognormal": lognormal_dist,
+        "pareto": pareto_dist,
+        "mix": mix_dist,
+    }[mode]()
+
+
+class GraphKeyResult:
+    # extra_size_mb is used to allocate more space for this object in testing mode to evaluate storage consumption
+    # and peer transfer performance across all workers.
+    def __init__(self, result, extra_size_mb=None):
+        self.result = result
+        self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
+
+
+class TaskGraph:
+    def __init__(self, task_dict,
+                 shared_file_system_dir=None,
+                 staging_dir=None,
+                 extra_task_output_size_mb=["uniform", 0, 0],
+                 extra_task_sleep_time=["uniform", 0, 0]):
+        self.task_dict = task_dict
+        self.shared_file_system_dir = shared_file_system_dir
+        self.staging_dir = staging_dir
+
+        if self.shared_file_system_dir:
+            os.makedirs(self.shared_file_system_dir, exist_ok=True)
+
+        if dts:
+            for k, v in self.task_dict.items():
+                if isinstance(v, dts.GraphNode):
+                    assert isinstance(v, (dts.Alias, dts.Task, dts.DataNode)), f"Unsupported task type for key {k}: {v.__class__}"
+
+        self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
+        self.depth_of = self._calculate_depths()
+
+        self.vine_key_of = {k: hash_name(k) for k in task_dict.keys()}
+        self.key_of_vine_key = {hash_name(k): k for k in task_dict.keys()}
+
+        self.outfile_remote_name = {key: f"{uuid.uuid4()}.pkl" for key in self.task_dict.keys()}
+        self.outfile_type = {key: None for key in self.task_dict.keys()}
+
+        # testing params
+        self.extra_task_output_size_mb = self._calculate_extra_size_mb_of(extra_task_output_size_mb)
+        self.extra_sleep_time_of = self._calculate_extra_sleep_time_of(extra_task_sleep_time)
+
+    def set_outfile_type_of(self, k, outfile_type_str):
+        assert outfile_type_str in ["local", "shared-file-system", "temp"]
+        self.outfile_type[k] = outfile_type_str
+        if outfile_type_str == "shared-file-system":
+            self.outfile_remote_name[k] = os.path.join(self.shared_file_system_dir, self.outfile_remote_name[k])
+
+    def _calculate_extra_size_mb_of(self, extra_task_output_size_mb):
+        assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 3
+        mode, low, high = extra_task_output_size_mb
+        low, high = int(low), int(high)
+        assert low <= high
+
+        max_depth = max(depth for depth in self.depth_of.values())
+        extra_size_mb_of = {}
+        for k in self.task_dict.keys():
+            if self.depth_of[k] == max_depth or self.depth_of[k] == max_depth - 1:
+                extra_size_mb_of[k] = 0
+                continue
+            extra_size_mb_of[k] = dist_func(mode, low, high)
+
+        return extra_size_mb_of
+
+    def _calculate_extra_sleep_time_of(self, extra_task_sleep_time):
+        assert isinstance(extra_task_sleep_time, list) and len(extra_task_sleep_time) == 3
+        mode, low, high = extra_task_sleep_time
+        low, high = int(low), int(high)
+        assert low <= high
+
+        extra_sleep_time_of = {}
+        for k in self.task_dict.keys():
+            extra_sleep_time_of[k] = dist_func(mode, low, high)
+
+        return extra_sleep_time_of
+
+    def _calculate_depths(self):
+        depth_of = {key: 0 for key in self.task_dict.keys()}
+
+        topo_order = self.get_topological_order()
+        for key in topo_order:
+            if self.parents_of[key]:
+                depth_of[key] = max(depth_of[parent] for parent in self.parents_of[key]) + 1
+            else:
+                depth_of[key] = 0
+
+        return depth_of
+
+    def set_outfile_remote_name_of(self, key, outfile_remote_name):
+        self.outfile_remote_name[key] = outfile_remote_name
+
+    def is_dts_key(self, k):
+        if not hasattr(dask, "_task_spec"):
+            return False
+        import dask._task_spec as dts
+        return isinstance(self.task_dict[k], (dts.Task, dts.TaskRef, dts.Alias, dts.DataNode, dts.NestedContainer))
+
+    def _build_dependencies(self, task_dict):
+        def _find_sexpr_parents(sexpr):
+            if hashable(sexpr) and sexpr in task_dict.keys():
+                return {sexpr}
+            elif isinstance(sexpr, (list, tuple)):
+                deps = set()
+                for x in sexpr:
+                    deps |= _find_sexpr_parents(x)
+                return deps
+            elif isinstance(sexpr, dict):
+                deps = set()
+                for k, v in sexpr.items():
+                    deps |= _find_sexpr_parents(k)
+                    deps |= _find_sexpr_parents(v)
+                return deps
+            else:
+                return set()
+
+        parents_of = collections.defaultdict(set)
+        children_of = collections.defaultdict(set)
+
+        for k, value in task_dict.items():
+            if self.is_dts_key(k):
+                # in the new Dask expression, each value is an object from dask._task_spec, could be
+                # a Task, Alias, TaskRef, etc., but they all share the same base class the dependencies
+                # field is of type frozenset(), without recursive ancestor dependencies involved
+                parents_of[k] = value.dependencies
+            else:
+                # the value could be a sexpr, e.g., the old Dask representation
+                parents_of[k] = _find_sexpr_parents(value)
+
+        for k, deps in parents_of.items():
+            for dep in deps:
+                children_of[dep].add(k)
+
+        return parents_of, children_of
+
+    def save_result_of_key(self, key, result):
+        with open(self.outfile_remote_name[key], "wb") as f:
+            result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
+            cloudpickle.dump(result_obj, f)
+
+    def load_result_of_key(self, key):
+        try:
+            with open(self.outfile_remote_name[key], "rb") as f:
+                result_obj = cloudpickle.load(f)
+                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
+                return result_obj.result
+        except FileNotFoundError:
+            raise FileNotFoundError(f"Output file for key {key} not found at {self.outfile_remote_name[key]}")
+
+    def get_topological_order(self):
+        in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
+        queue = deque([key for key, degree in in_degree.items() if degree == 0])
+        topo_order = []
+
+        while queue:
+            current = queue.popleft()
+            topo_order.append(current)
+
+            for child in self.children_of[current]:
+                in_degree[child] -= 1
+                if in_degree[child] == 0:
+                    queue.append(child)
+
+        if len(topo_order) != len(self.task_dict):
+            print(f"len(topo_order): {len(topo_order)}")
+            print(f"len(self.task_dict): {len(self.task_dict)}")
+            raise ValueError("Failed to create topo order, the dependencies may be cyclic or problematic")
+
+        return topo_order
+
+    def __del__(self):
+        if hasattr(self, 'outfile_remote_name') and self.outfile_remote_name:
+            for k in self.outfile_remote_name.keys():
+                if self.outfile_type.get(k) == "shared-file-system" and os.path.exists(self.outfile_remote_name[k]):
+                    os.remove(self.outfile_remote_name[k])
+
+
+def init_task_graph_context(task_graph_path=None):
+    if task_graph_path is None:
+
+        raise ValueError("task_graph_path must be provided to initialize the task graph context")
+    if not os.path.exists(task_graph_path):
+        raise FileNotFoundError(f"Task graph file not found at {task_graph_path}")
+
+    with open(task_graph_path, 'rb') as f:
+        task_graph = cloudpickle.load(f)
+
+    return {
+        'task_graph': task_graph,
+    }
+
+
+def compute_dts_key(task_graph, k, v):
+    try:
+        import dask._task_spec as dts
+    except ImportError:
+        raise ImportError("Dask is not installed")
+
+    input_dict = {dep: task_graph.load_result_of_key(dep) for dep in v.dependencies}
+
+    try:
+        if isinstance(v, dts.Alias):
+            assert len(v.dependencies) == 1, "Expected exactly one dependency"
+            return task_graph.load_result_of_key(next(iter(v.dependencies)))
+        elif isinstance(v, dts.Task):
+            return v(input_dict)
+        elif isinstance(v, dts.DataNode):
+            return v.value
+        else:
+            raise TypeError(f"unexpected node type: {type(v)} for key {k}")
+    except Exception as e:
+        raise Exception(f"Error while executing task {k}: {e}")
+
+
+def compute_sexpr_key(task_graph, k, v):
+    input_dict = {parent: task_graph.load_result_of_key(parent) for parent in task_graph.parents_of[k]}
+
+    def _rec_call(expr):
+        try:
+            if expr in input_dict.keys():
+                return input_dict[expr]
+        except TypeError:
+            pass
+        if isinstance(expr, list):
+            return [_rec_call(e) for e in expr]
+        if isinstance(expr, tuple) and len(expr) > 0 and callable(expr[0]):
+            res = expr[0](*[_rec_call(a) for a in expr[1:]])
+            return res
+        return expr
+
+    try:
+        return _rec_call(v)
+    except Exception as e:
+        raise Exception(f"Failed to invoke _rec_call(): {e}")
+
+
+def compute_single_key(vine_key):
+    task_graph = load_variable_from_library('task_graph')
+
+    k = task_graph.key_of_vine_key[vine_key]
+    v = task_graph.task_dict[k]
+
+    if task_graph.is_dts_key(k):
+        result = compute_dts_key(task_graph, k, v)
+    else:
+        result = compute_sexpr_key(task_graph, k, v)
+
+    task_graph.save_result_of_key(k, result)
+    if not os.path.exists(task_graph.outfile_remote_name[k]):
+        raise Exception(f"Output file {task_graph.outfile_remote_name[k]} does not exist after writing")
+    if os.stat(task_graph.outfile_remote_name[k]).st_size == 0:
+        raise Exception(f"Output file {task_graph.outfile_remote_name[k]} is empty after writing")
+
+    time.sleep(task_graph.extra_sleep_time_of[k])
+
+    return True
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
new file mode 100644
index 0000000000..7efca4a554
--- /dev/null
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
@@ -0,0 +1,251 @@
+from ndcctools.taskvine import cvine
+from ndcctools.taskvine.manager import Manager
+from ndcctools.taskvine.utils import load_variable_from_library, delete_all_files, get_c_constant
+from ndcctools.taskvine.graph_definition import GraphKeyResult, TaskGraph, init_task_graph_context, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
+
+import cloudpickle
+import os
+import collections
+import inspect
+import types
+import signal
+import hashlib
+import time
+import random
+import uuid
+
+try:
+    import dask
+except ImportError:
+    dask = None
+
+try:
+    from dask.base import is_dask_collection
+except ImportError:
+    is_dask_collection = None
+
+try:
+    import dask._task_spec as dts
+except ImportError:
+    dts = None
+
+
+def dask_collections_to_task_dict(collection_dict):
+    assert is_dask_collection is not None
+    from dask.highlevelgraph import HighLevelGraph, ensure_dict
+
+    if not isinstance(collection_dict, dict):
+        raise TypeError("Input must be a dict or a HighLevelGraph")
+
+    for k, v in collection_dict.items():
+        if not is_dask_collection(v):
+            raise TypeError(f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}")
+
+    if dts:
+        sub_hlgs = [v.dask for v in collection_dict.values()]
+        hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
+    else:
+        hlg = dask.base.collections_to_dsk(collection_dict.values())
+
+    return ensure_dict(hlg)
+
+
+def ensure_task_dict(collection_dict):
+    if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
+        task_dict = dask_collections_to_task_dict(collection_dict)
+    else:
+        task_dict = collection_dict
+
+    if dts:
+        return dts.convert_legacy_graph(task_dict)
+    else:
+        return task_dict
+
+
+class GraphExecutor(Manager):
+    def __init__(self,
+                 *args,
+                 libcores=1,
+                 hoisting_modules=[],
+                 libtask_env_files={},
+                 **kwargs):
+
+        signal.signal(signal.SIGINT, self._on_sigint)
+
+        # delete all files in the run info template directory, do this before super().__init__()
+        self.run_info_path = kwargs.get('run_info_path')
+        self.run_info_template = kwargs.get('run_info_template')
+        self.run_info_path_absolute = os.path.join(self.run_info_path, self.run_info_template)
+        if self.run_info_path and self.run_info_template:
+            delete_all_files(self.run_info_path_absolute)
+
+        # initialize the manager
+        super_params = set(inspect.signature(Manager.__init__).parameters)
+        super_kwargs = {k: v for k, v in kwargs.items() if k in super_params}
+
+        super().__init__(*args, **super_kwargs)
+        print(f"TaskVine manager \033[92m{self.name}\033[0m listening on port \033[92m{self.port}\033[0m")
+
+        # tune the manager
+        leftover_kwargs = {k: v for k, v in kwargs.items() if k not in super_params}
+        for key, value in leftover_kwargs.items():
+            try:
+                vine_param = key.replace("_", "-")
+                self.tune(vine_param, value)
+                print(f"Tuned {vine_param} to {value}")
+            except Exception as e:
+                print(f"Failed to tune {key} with value {value}: {e}")
+                exit(1)
+        self.tune("worker-source-max-transfers", 100)
+        self.tune("max-retrievals", -1)
+        self.tune("prefer-dispatch", 1)
+        self.tune("transient-error-interval", 1)
+        self.tune("attempt-schedule-depth", 1000)
+
+        # initialize the task graph
+        self._vine_task_graph = cvine.vine_task_graph_create(self._taskvine)
+
+        # create library task with specified resources
+        self._create_library_task(libcores, hoisting_modules, libtask_env_files)
+
+    def _create_library_task(self, libcores=1, hoisting_modules=[], libtask_env_files={}):
+        assert cvine.vine_task_graph_get_function_name(self._vine_task_graph) == compute_single_key.__name__
+
+        self.task_graph_pkl_file_name = f"library-task-graph-{uuid.uuid4()}.pkl"
+        self.task_graph_pkl_file_local_path = self.task_graph_pkl_file_name
+        self.task_graph_pkl_file_remote_path = self.task_graph_pkl_file_name
+
+        hoisting_modules += [os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
+                             load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable]
+        if dask:
+            hoisting_modules += [dask]
+        self.libtask = self.create_library_from_functions(
+            cvine.vine_task_graph_get_library_name(self._vine_task_graph),
+            compute_single_key,
+            library_context_info=[init_task_graph_context, [], {"task_graph_path": self.task_graph_pkl_file_remote_path}],
+            add_env=False,
+            infile_load_mode="text",
+            hoisting_modules=hoisting_modules
+        )
+        self.libtask.add_input(self.declare_file(self.task_graph_pkl_file_local_path), self.task_graph_pkl_file_remote_path)
+        for local_file_path, remote_file_path in libtask_env_files.items():
+            self.libtask.add_input(self.declare_file(local_file_path, cache=True, peer_transfer=True), remote_file_path)
+        self.libtask.set_cores(libcores)
+        self.libtask.set_function_slots(libcores)
+        self.install_library(self.libtask)
+
+    def run(self,
+            collection_dict,
+            target_keys=[],
+            replica_placement_policy="random",
+            priority_mode="largest-input-first",
+            scheduling_mode="files",
+            extra_task_output_size_mb=["uniform", 0, 0],
+            extra_task_sleep_time=["uniform", 0, 0],
+            prune_depth=1,
+            shared_file_system_dir="/project01/ndcms/jzhou24/shared_file_system",
+            staging_dir="/project01/ndcms/jzhou24/staging",
+            failure_injection_step_percent=-1,
+            balance_worker_disk_load=0,
+            outfile_type={
+                "temp": 1.0,
+                "shared-file-system": 0.0,
+            }):
+        self.target_keys = target_keys
+        self.task_dict = ensure_task_dict(collection_dict)
+
+        self.tune("balance-worker-disk-load", balance_worker_disk_load)
+
+        cvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, failure_injection_step_percent)
+
+        if balance_worker_disk_load:
+            replica_placement_policy = "disk-load"
+            scheduling_mode = "worst"
+
+        self.set_scheduler(scheduling_mode)
+
+        # create task graph in the python side
+        print("Initializing TaskGraph object")
+        self.shared_file_system_dir = shared_file_system_dir
+        self.staging_dir = staging_dir
+        self.task_graph = TaskGraph(self.task_dict,
+                                    staging_dir=self.staging_dir,
+                                    shared_file_system_dir=self.shared_file_system_dir,
+                                    extra_task_output_size_mb=extra_task_output_size_mb,
+                                    extra_task_sleep_time=extra_task_sleep_time)
+        topo_order = self.task_graph.get_topological_order()
+
+        # the sum of the values in outfile_type must be 1.0
+        assert sum(list(outfile_type.values())) == 1.0
+
+        # set replica placement policy
+        cvine.vine_set_replica_placement_policy(self._taskvine, get_c_constant(f"replica_placement_policy_{replica_placement_policy.replace('-', '_')}"))
+
+        # create task graph in the python side
+        print("Initializing task graph in TaskVine")
+        for k in topo_order:
+            cvine.vine_task_graph_create_node(self._vine_task_graph,
+                                              self.task_graph.vine_key_of[k],
+                                              self.staging_dir,
+                                              prune_depth,
+                                              get_c_constant(f"task_priority_mode_{priority_mode.replace('-', '_')}"))
+            for pk in self.task_graph.parents_of.get(k, []):
+                cvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
+
+        # we must finalize the graph in c side after all nodes and dependencies are added
+        # this includes computing various metrics for each node, such as depth, height, heavy score, etc.
+        cvine.vine_task_graph_finalize_metrics(self._vine_task_graph)
+
+        # then we can use the heavy score to sort the nodes and specify their outfile remote names
+        heavy_scores = {}
+        for k in self.task_graph.task_dict.keys():
+            heavy_scores[k] = cvine.vine_task_graph_get_node_heavy_score(self._vine_task_graph, self.task_graph.vine_key_of[k])
+
+        # keys with larger heavy score should be stored into the shared file system
+        sorted_keys = sorted(heavy_scores, key=lambda x: heavy_scores[x], reverse=True)
+        shared_file_system_size = round(len(sorted_keys) * outfile_type["shared-file-system"])
+        for i, k in enumerate(sorted_keys):
+            if k in self.target_keys:
+                choice = "local"
+            else:
+                if i < shared_file_system_size:
+                    choice = "shared-file-system"
+                else:
+                    choice = "temp"
+            self.task_graph.set_outfile_type_of(k, choice)
+            outfile_type_str = f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}"
+            cvine.vine_task_graph_set_node_outfile(self._vine_task_graph,
+                                                   self.task_graph.vine_key_of[k],
+                                                   get_c_constant(outfile_type_str),
+                                                   self.task_graph.outfile_remote_name[k])
+
+        # save the task graph to a pickle file, will be sent to the remote workers
+        with open(self.task_graph_pkl_file_local_path, 'wb') as f:
+            cloudpickle.dump(self.task_graph, f)
+
+        # now execute the vine graph
+        print(f"Executing task graph, logs will be written into {self.run_info_path_absolute}")
+        cvine.vine_task_graph_execute(self._vine_task_graph)
+
+        # after execution, we need to load results of target keys
+        results = {}
+        for k in self.target_keys:
+            local_outfile_path = cvine.vine_task_graph_get_node_local_outfile_source(self._vine_task_graph, self.task_graph.vine_key_of[k])
+            if not os.path.exists(local_outfile_path):
+                results[k] = "NOT_FOUND"
+                continue
+            with open(local_outfile_path, 'rb') as f:
+                result_obj = cloudpickle.load(f)
+                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
+                results[k] = result_obj.result
+        return results
+
+    def _on_sigint(self, signum, frame):
+        self.__del__()
+
+    def __del__(self):
+        if hasattr(self, '_vine_task_graph') and self._vine_task_graph:
+            cvine.vine_task_graph_delete(self._vine_task_graph)
+
+        if hasattr(self, 'task_graph_pkl_file_local_path') and os.path.exists(self.task_graph_pkl_file_local_path):
+            os.remove(self.task_graph_pkl_file_local_path)
diff --git a/taskvine/src/manager/Makefile b/taskvine/src/manager/Makefile
index a036e9bd64..1246f83737 100644
--- a/taskvine/src/manager/Makefile
+++ b/taskvine/src/manager/Makefile
@@ -28,7 +28,10 @@ SOURCES = \
 	vine_file_replica_table.c \
 	vine_fair.c \
 	vine_runtime_dir.c \
-	vine_task_groups.c
+	vine_task_groups.c \
+	vine_temp.c \
+	vine_task_node.c \
+	vine_task_graph.c
 
 PUBLIC_HEADERS = taskvine.h
 
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index 16152b7102..9e1d9b7da3 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -15,6 +15,7 @@ See the file COPYING for details.
 struct vine_manager;
 struct vine_task;
 struct vine_file;
+struct vine_task_graph;
 
 /** @file taskvine.h The public API for the taskvine distributed application framework.
 A taskvine application consists of a manager process and a larger number of worker
@@ -149,6 +150,30 @@ typedef enum {
 	VINE_MINI_TASK,             /**< A file obtained by executing a Unix command line. */
 } vine_file_type_t;
 
+/* Select while type of workers to place the redundant file replicas */
+typedef enum {
+	VINE_REPLICA_PLACEMENT_POLICY_RANDOM = 0,        /* select a random worker */
+	VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD,         /* select a worker with the most free disk space */
+	VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD      /* select a worker with the least incoming transfer load */
+} vine_replica_placement_policy_t;
+
+/** Select the type of the node-output file. */
+typedef enum {
+	VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
+    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
+    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
+} vine_task_node_outfile_type_t;
+
+/** Select priority algorithm for task graph task scheduling. */
+typedef enum {
+    VINE_TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
+    VINE_TASK_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
+    VINE_TASK_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
+    VINE_TASK_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
+    VINE_TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
+    VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
+    VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+} vine_task_node_priority_mode_t;
 
 /** Statistics describing a manager. */
 struct vine_stats {
@@ -1117,6 +1142,14 @@ int vine_enable_peer_transfers(struct vine_manager *m);
 /** Disable taskvine peer transfers to be scheduled by the manager **/
 int vine_disable_peer_transfers(struct vine_manager *m);
 
+/** Enable recovery tasks to be returned by vine_wait.
+By default, recovery tasks are handled internally by the manager. **/
+int vine_enable_return_recovery_tasks(struct vine_manager *m);
+
+/** Disable recovery tasks from being returned by vine_wait.
+Recovery tasks will be handled internally by the manager. **/
+int vine_disable_return_recovery_tasks(struct vine_manager *m);
+
 /** When enabled, resources to tasks in are assigned in proportion to the size
 of the worker. If a resource is specified (e.g. with @ref vine_task_set_cores),
 proportional resources never go below explicit specifications. This mode is most
@@ -1556,6 +1589,94 @@ char *vine_get_path_library_log(struct vine_manager *m, const char *path);
 */
 char *vine_get_path_cache(struct vine_manager *m, const char *path);
 
+/** Create a task graph object and return it.
+@param q Reference to the current manager object.
+@return A new task graph object.
+*/
+struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
+
+/** Delete a task graph object.
+@param tg Reference to the task graph object.
+*/
+void vine_task_graph_delete(struct vine_task_graph *tg);
+
+/** Add a dependency between two nodes in the task graph.
+@param tg Reference to the task graph object.
+@param parent_key Reference to the parent node key.
+@param child_key Reference to the child node key.
+*/
+void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key);
+
+/** Create a new node in the task graph.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@param staging_dir Reference to the staging directory.
+@param prune_depth Reference to the prune depth.
+@param priority_mode Reference to the priority mode.
+@return A new node object.
+*/
+struct vine_task_node *vine_task_graph_create_node(struct vine_task_graph *tg,
+	const char *node_key,
+	const char *staging_dir,
+	int prune_depth,
+	vine_task_node_priority_mode_t priority_mode);
+
+/** Set the replica placement policy (which worker do we prefer to place the redundant file replicas).
+@param q Reference to the current manager object.
+@param policy Reference to the replica placement policy.
+*/
+void vine_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
+
+/** Set the type of the node-output file.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@param outfile_type Reference to the output file type.
+@param outfile_remote_name Reference to the output file remote name.
+*/
+void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
+
+/** Finalize the metrics of the task graph.
+@param tg Reference to the task graph object.
+*/
+void vine_task_graph_finalize_metrics(struct vine_task_graph *tg);
+
+/** Get the library name of the task graph.
+@param tg Reference to the task graph object.
+@return The library name.
+*/
+const char *vine_task_graph_get_library_name(const struct vine_task_graph *tg);
+
+/** Get the function name of the task graph.
+@param tg Reference to the task graph object.
+@return The function name.
+*/
+const char *vine_task_graph_get_function_name(const struct vine_task_graph *tg);
+
+/** Get the heavy score of a node in the task graph.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@return The heavy score.
+*/
+double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key);
+
+/** Execute the task graph.
+@param tg Reference to the task graph object.
+*/
+void vine_task_graph_execute(struct vine_task_graph *tg);
+
+/** Get the local outfile source of a node in the task graph.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@return The local outfile source.
+*/
+const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key);
+
+/** Set the failure injection step percent.
+@param tg Reference to the task graph object.
+@param percent Reference to the failure injection step percent.
+*/
+void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent);
+
 //@}
 
 #endif
diff --git a/taskvine/src/manager/vine_file_replica_table.c b/taskvine/src/manager/vine_file_replica_table.c
index d6ba403f5b..7619a01833 100644
--- a/taskvine/src/manager/vine_file_replica_table.c
+++ b/taskvine/src/manager/vine_file_replica_table.c
@@ -25,7 +25,8 @@ See the file COPYING for details.
 int vine_file_replica_table_insert(struct vine_manager *m, struct vine_worker_info *w, const char *cachename, struct vine_file_replica *replica)
 {
 	if (hash_table_lookup(w->current_files, cachename)) {
-		return 0;
+		// delete the previous replcia because the replica's size might have changed
+		vine_file_replica_table_remove(m, w, cachename);
 	}
 
 	double prev_available = w->resources->disk.total - BYTES_TO_MEGABYTES(w->inuse_cache);
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index ca72d257d9..07bdb9a5a1 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -29,6 +29,7 @@ See the file COPYING for details.
 #include "vine_taskgraph_log.h"
 #include "vine_txn_log.h"
 #include "vine_worker_info.h"
+#include "vine_temp.h"
 
 #include "address.h"
 #include "buffer.h"
@@ -165,11 +166,12 @@ static int vine_manager_check_inputs_available(struct vine_manager *q, struct vi
 static void vine_manager_consider_recovery_task(struct vine_manager *q, struct vine_file *lost_file, struct vine_task *rt);
 
 static void delete_uncacheable_files(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
-static int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level);
 static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
 
+static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
+
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
 
 static int count_workers(struct vine_manager *q, vine_worker_type_t type)
@@ -418,9 +420,19 @@ static vine_msg_code_t handle_cache_update(struct vine_manager *q, struct vine_w
 			f->state = VINE_FILE_STATE_CREATED;
 			f->size = size;
 
-			/* And if the file is a newly created temporary, replicate as needed. */
-			if (f->type == VINE_TEMP && *id == 'X' && q->temp_replica_count > 1) {
-				hash_table_insert(q->temp_files_to_replicate, f->cached_name, NULL);
+			/* If the replica's type was a URL, it means the manager expected the destination worker to download it
+			 * from elsewhere. Now that it's physically present, we can resolve its type back to the original */
+			if (replica->type == VINE_URL) {
+				replica->type = f->type;
+			}
+
+			/* If a TEMP file, replicate as needed. */
+			if (f->type == VINE_TEMP) {
+				vine_temp_replicate_file_later(q, f);
+
+				if (q->balance_worker_disk_load) {
+					clean_redundant_replicas(q, f);
+				}
 			}
 		}
 	}
@@ -476,6 +488,9 @@ static vine_msg_code_t handle_cache_invalid(struct vine_manager *q, struct vine_
 			w->last_failure_time = timestamp_get();
 		}
 
+		/* If the creation failed, we may want to backup the file somewhere else. */
+		vine_temp_handle_file_lost(q, cachename);
+
 		/* Successfully processed this message. */
 		return VINE_MSG_PROCESSED;
 	} else {
@@ -650,6 +665,15 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 	itable_remove(q->running_table, t->task_id);
 	vine_task_set_result(t, task_status);
 
+	/* Clean redundant replicas for the inputs */
+	struct vine_mount *input_mount;
+	LIST_ITERATE(t->input_mounts, input_mount)
+	{
+		if (input_mount->file && input_mount->file->type == VINE_TEMP) {
+			clean_redundant_replicas(q, input_mount->file);
+		}
+	}
+
 	return VINE_SUCCESS;
 }
 
@@ -935,8 +959,74 @@ static void cleanup_worker_files(struct vine_manager *q, struct vine_worker_info
 	hash_table_free_keys_array(cachenames);
 }
 
-/*
-This function enforces a target worker eviction rate (1 every X seconds).
+/** Check if a file is busy by checking if it is an input file of any task. */
+static int is_file_busy(struct vine_manager *q, struct vine_worker_info *w, struct vine_file *f)
+{
+	if (!q || !w || !f) {
+		return 0;
+	}
+
+	uint64_t task_id;
+	struct vine_task *task;
+	ITABLE_ITERATE(w->current_tasks, task_id, task)
+	{
+		struct vine_mount *input_mount;
+		LIST_ITERATE(task->input_mounts, input_mount)
+		{
+			if (f == input_mount->file) {
+				return 1;
+			}
+		}
+	}
+
+	return 0;
+}
+
+/** Evict a random worker to simulate a worker failure. */
+int evict_random_worker(struct vine_manager *q)
+{
+	if (!q) {
+		return 0;
+	}
+
+	if (hash_table_size(q->worker_table) == 0) {
+		return 0;
+	}
+
+	int removed = 0;
+
+	/* collect removable workers */
+	struct list *candidates_list = list_create();
+	char *key;
+	struct vine_worker_info *w;
+	HASH_TABLE_ITERATE(q->worker_table, key, w)
+	{
+		list_push_tail(candidates_list, w);
+	}
+
+	/* release a random worker if any */
+	int random_number = random_int64();
+	if (random_number < 0) {
+		random_number = -random_number;
+	}
+	int index = (int)(random_number % list_size(candidates_list));
+	int i = 0;
+	while ((w = list_pop_head(candidates_list))) {
+		if (i++ == index) {
+			/* evict this worker */
+			debug(D_VINE | D_NOTICE, "Intentionally evicting worker %s", w->hostname);
+			release_worker(q, w);
+			removed = 1;
+			break;
+		}
+	}
+
+	list_delete(candidates_list);
+	return removed;
+}
+
+/**
+Enforces a target worker eviction rate (1 every X seconds).
 If the observed eviction interval is shorter than the desired one, we randomly evict one worker
 to keep the eviction pace aligned with the target.
 This includes all types of removals, whether graceful or due to failures.
@@ -973,32 +1063,150 @@ static int enforce_worker_eviction_interval(struct vine_manager *q)
 		return 0;
 	}
 
-	/* collect removable workers */
-	struct list *candidates_list = list_create();
+	/* evict a random worker if any */
+	return evict_random_worker(q);
+}
+
+/** Get the available disk space in bytes for a worker. */
+int64_t get_worker_available_disk_bytes(struct vine_worker_info *w)
+{
+	if (!w || !w->resources) {
+		return 0;
+	}
+
+	return (int64_t)MEGABYTES_TO_BYTES(w->resources->disk.total) - w->inuse_cache;
+}
+
+/** Clean redundant replicas of a temporary file. */
+static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f)
+{
+	if (!f || f->type != VINE_TEMP) {
+		return;
+	}
+
+	// remove excess replicas of temporary files
+	struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!source_workers) {
+		// no surprise - a cache-update may trigger a file deletion!
+		return;
+	}
+	int replicas_to_remove = set_size(source_workers) - q->temp_replica_count;
+	if (replicas_to_remove <= 0) {
+		return;
+	}
+	// note that this replica can be a source to a peer transfer, if this is unlinked,
+	// a corresponding transfer may fail and result in a forsaken task
+	// therefore, we need to wait until all replicas are ready
+	if (vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY) != set_size(source_workers)) {
+		return;
+	}
+
+	struct priority_queue *offload_from_workers = priority_queue_create(0);
+
+	struct vine_worker_info *source_worker = NULL;
+	SET_ITERATE(source_workers, source_worker)
+	{
+		// workers with more used disk are prioritized for removing
+		if (is_file_busy(q, source_worker, f)) {
+			continue;
+		}
+
+		priority_queue_push(offload_from_workers, source_worker, source_worker->inuse_cache);
+	}
+
+	struct vine_worker_info *offload_from_worker = NULL;
+	while (replicas_to_remove-- > 0 && (offload_from_worker = priority_queue_pop(offload_from_workers))) {
+		delete_worker_file(q, offload_from_worker, f->cached_name, 0, 0);
+	}
+	priority_queue_delete(offload_from_workers);
+
+	return;
+}
+
+/* Shift disk load between workers to balance the disk usage. */
+static void rebalance_worker_disk_usage(struct vine_manager *q)
+{
+	if (!q) {
+		return;
+	}
+
+	struct vine_worker_info *worker_with_min_disk_usage = NULL;
+	struct vine_worker_info *worker_with_max_disk_usage = NULL;
+
 	char *key;
 	struct vine_worker_info *w;
 	HASH_TABLE_ITERATE(q->worker_table, key, w)
 	{
-		if (w->type != VINE_WORKER_TYPE_WORKER) {
+		if (!w->transfer_port_active) {
 			continue;
 		}
-		list_push_tail(candidates_list, w);
+		if (w->draining) {
+			continue;
+		}
+		if (!w->resources) {
+			continue;
+		}
+		if (w->resources->tag < 0 || w->resources->disk.total < 1) {
+			continue;
+		}
+		if (!worker_with_min_disk_usage || w->inuse_cache < worker_with_min_disk_usage->inuse_cache) {
+			if (w->incoming_xfer_counter < q->worker_source_max_transfers) {
+				worker_with_min_disk_usage = w;
+			}
+		}
+		if (!worker_with_max_disk_usage || w->inuse_cache > worker_with_max_disk_usage->inuse_cache) {
+			if (w->outgoing_xfer_counter < q->worker_source_max_transfers) {
+				worker_with_max_disk_usage = w;
+			}
+		}
 	}
 
-	/* release a random worker if any */
-	int index = (int)(random_int64() % list_size(candidates_list));
-	int i = 0;
-	while ((w = list_pop_head(candidates_list))) {
-		if (i++ == index) {
-			/* evict this worker */
-			debug(D_VINE | D_NOTICE, "Intentionally evicting worker %s", w->hostname);
-			release_worker(q, w);
+	if (!worker_with_min_disk_usage || !worker_with_max_disk_usage || worker_with_min_disk_usage == worker_with_max_disk_usage) {
+		return;
+	}
+
+	int64_t min_inuse_cache = worker_with_min_disk_usage->inuse_cache;
+	int64_t max_inuse_cache = worker_with_max_disk_usage->inuse_cache;
+
+	if (min_inuse_cache * 1.2 >= max_inuse_cache) {
+		return;
+	}
+
+	if (max_inuse_cache <= q->peak_used_cache) {
+		return;
+	}
+	q->peak_used_cache = max_inuse_cache;
+
+	int64_t bytes_to_offload = (int64_t)((max_inuse_cache - min_inuse_cache) / 2);
+
+	char *cachename;
+	struct vine_file_replica *replica;
+	HASH_TABLE_ITERATE(worker_with_max_disk_usage->current_files, cachename, replica)
+	{
+		if (replica->type != VINE_TEMP) {
+			continue;
+		}
+		struct vine_file *f = hash_table_lookup(q->file_table, cachename);
+		if (!f) {
+			continue;
+		}
+		if (vine_file_replica_table_lookup(worker_with_min_disk_usage, cachename)) {
+			continue;
+		}
+
+		vine_temp_start_peer_transfer(q, f, worker_with_max_disk_usage, worker_with_min_disk_usage);
+		bytes_to_offload -= replica->size;
+		if (bytes_to_offload <= 0) {
 			break;
 		}
-	}
-	list_delete(candidates_list);
 
-	return 1;
+		if (worker_with_min_disk_usage->incoming_xfer_counter >= q->worker_source_max_transfers) {
+			break;
+		}
+		if (worker_with_max_disk_usage->outgoing_xfer_counter >= q->worker_source_max_transfers) {
+			break;
+		}
+	}
 }
 
 /* Remove all tasks and other associated state from a given worker. */
@@ -1036,85 +1244,6 @@ static void cleanup_worker(struct vine_manager *q, struct vine_worker_info *w)
 	cleanup_worker_files(q, w);
 }
 
-/* Start replicating files that may need replication */
-static int consider_tempfile_replications(struct vine_manager *q)
-{
-	if (hash_table_size(q->temp_files_to_replicate) <= 0) {
-		return 0;
-	}
-
-	char *cached_name = NULL;
-	void *empty_val = NULL;
-	int total_replication_request_sent = 0;
-
-	static char key_start[PATH_MAX] = "random init";
-	int iter_control;
-	int iter_count_var;
-
-	struct list *to_remove = list_create();
-
-	HASH_TABLE_ITERATE_FROM_KEY(q->temp_files_to_replicate, iter_control, iter_count_var, key_start, cached_name, empty_val)
-	{
-		struct vine_file *f = hash_table_lookup(q->file_table, cached_name);
-
-		if (!f) {
-			continue;
-		}
-
-		/* are there any available source workers? */
-		struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
-		if (!source_workers) {
-			/* If no source workers found, it indicates that the file doesn't exist, either pruned or lost.
-			Because a pruned file is removed from the recovery queue, so it definitely indicates that the file is lost. */
-			if (q->transfer_temps_recovery && file_needs_recovery(q, f)) {
-				vine_manager_consider_recovery_task(q, f, f->recovery_task);
-			}
-			list_push_tail(to_remove, xxstrdup(f->cached_name));
-			continue;
-		}
-
-		/* at least one source is able to transfer? */
-		int has_valid_source = 0;
-		struct vine_worker_info *s;
-		SET_ITERATE(source_workers, s)
-		{
-			if (s->transfer_port_active && s->outgoing_xfer_counter < q->worker_source_max_transfers && !s->draining) {
-				has_valid_source = 1;
-				break;
-			}
-		}
-		if (!has_valid_source) {
-			continue;
-		}
-
-		/* has this file been fully replicated? */
-		int nsource_workers = set_size(source_workers);
-		int to_find = MIN(q->temp_replica_count - nsource_workers, q->transfer_replica_per_cycle);
-		if (to_find <= 0) {
-			list_push_tail(to_remove, xxstrdup(f->cached_name));
-			continue;
-		}
-
-		// debug(D_VINE, "Found %d workers holding %s, %d replicas needed", nsource_workers, f->cached_name, to_find);
-
-		int round_replication_request_sent = vine_file_replica_table_replicate(q, f, source_workers, to_find);
-		total_replication_request_sent += round_replication_request_sent;
-
-		if (total_replication_request_sent >= q->attempt_schedule_depth) {
-			break;
-		}
-	}
-
-	while ((cached_name = list_pop_head(to_remove))) {
-		hash_table_remove(q->temp_files_to_replicate, cached_name);
-		free(cached_name);
-	}
-
-	list_delete(to_remove);
-
-	return total_replication_request_sent;
-}
-
 /* Insert into hashtable temp files that may need replication. */
 
 static void recall_worker_lost_temp_files(struct vine_manager *q, struct vine_worker_info *w)
@@ -1127,11 +1256,7 @@ static void recall_worker_lost_temp_files(struct vine_manager *q, struct vine_wo
 	// Iterate over files we want might want to recover
 	HASH_TABLE_ITERATE(w->current_files, cached_name, info)
 	{
-		struct vine_file *f = hash_table_lookup(q->file_table, cached_name);
-
-		if (f && f->type == VINE_TEMP) {
-			hash_table_insert(q->temp_files_to_replicate, cached_name, NULL);
-		}
+		vine_temp_handle_file_lost(q, cached_name);
 	}
 }
 
@@ -1243,7 +1368,7 @@ static void add_worker(struct vine_manager *q)
 
 /* Delete a single file on a remote worker except those with greater delete_upto_level cache level */
 
-static int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level)
+int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level)
 {
 	if (cache_level <= delete_upto_level) {
 		process_replica_on_event(q, w, filename, VINE_FILE_REPLICA_STATE_TRANSITION_EVENT_UNLINK);
@@ -3519,7 +3644,7 @@ static void vine_manager_consider_recovery_task(struct vine_manager *q, struct v
 	case VINE_TASK_INITIAL:
 		/* The recovery task has never been run, so submit it now. */
 		vine_submit(q, rt);
-		notice(D_VINE, "Submitted recovery task %d (%s) to re-create lost temporary file %s.", rt->task_id, rt->command_line, lost_file->cached_name);
+		debug(D_VINE, "Submitted recovery task %d (%s) to re-create lost temporary file %s.", rt->task_id, rt->command_line, lost_file->cached_name);
 		break;
 	case VINE_TASK_READY:
 	case VINE_TASK_RUNNING:
@@ -3533,7 +3658,7 @@ static void vine_manager_consider_recovery_task(struct vine_manager *q, struct v
 		 * here. */
 		vine_task_reset(rt);
 		vine_submit(q, rt);
-		notice(D_VINE, "Submitted recovery task %d (%s) to re-create lost temporary file %s.", rt->task_id, rt->command_line, lost_file->cached_name);
+		debug(D_VINE, "Submitted recovery task %d (%s) to re-create lost temporary file %s.", rt->task_id, rt->command_line, lost_file->cached_name);
 		break;
 	}
 }
@@ -4135,7 +4260,7 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 
 	q->worker_table = hash_table_create(0, 0);
 	q->file_worker_table = hash_table_create(0, 0);
-	q->temp_files_to_replicate = hash_table_create(0, 0);
+	q->temp_files_to_replicate = priority_queue_create(0);
 	q->worker_blocklist = hash_table_create(0, 0);
 
 	q->file_table = hash_table_create(0, 0);
@@ -4244,6 +4369,15 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->enforce_worker_eviction_interval = 0;
 	q->time_start_worker_eviction = 0;
 
+	q->return_recovery_tasks = 0;
+	q->num_submitted_recovery_tasks = 0;
+	q->balance_worker_disk_load = 0;
+	q->when_last_offloaded = 0;
+	q->peak_used_cache = 0;
+	q->shutting_down = 0;
+	vine_set_replica_placement_policy(q, VINE_REPLICA_PLACEMENT_POLICY_RANDOM);
+
+
 	if ((envstring = getenv("VINE_BANDWIDTH"))) {
 		q->bandwidth_limit = string_metric_parse(envstring);
 		if (q->bandwidth_limit < 0) {
@@ -4320,6 +4454,20 @@ int vine_disable_peer_transfers(struct vine_manager *q)
 	return 1;
 }
 
+int vine_enable_return_recovery_tasks(struct vine_manager *q)
+{
+	debug(D_VINE, "Return recovery tasks enabled");
+	q->return_recovery_tasks = 1;
+	return 1;
+}
+
+int vine_disable_return_recovery_tasks(struct vine_manager *q)
+{
+	debug(D_VINE, "Return recovery tasks disabled");
+	q->return_recovery_tasks = 0;
+	return 1;
+}
+
 int vine_enable_proportional_resources(struct vine_manager *q)
 {
 	debug(D_VINE, "Proportional resources enabled");
@@ -4464,6 +4612,8 @@ void vine_delete(struct vine_manager *q)
 	 * disable the immediate recovery to avoid submitting recovery tasks for lost files */
 	q->immediate_recovery = 0;
 
+	q->shutting_down = 1;
+
 	vine_fair_write_workflow_info(q);
 
 	release_all_workers(q);
@@ -4487,8 +4637,7 @@ void vine_delete(struct vine_manager *q)
 	hash_table_clear(q->file_worker_table, (void *)set_delete);
 	hash_table_delete(q->file_worker_table);
 
-	hash_table_clear(q->temp_files_to_replicate, 0);
-	hash_table_delete(q->temp_files_to_replicate);
+	priority_queue_delete(q->temp_files_to_replicate);
 
 	hash_table_clear(q->factory_table, (void *)vine_factory_info_delete);
 	hash_table_delete(q->factory_table);
@@ -4869,6 +5018,7 @@ int vine_submit(struct vine_manager *q, struct vine_task *t)
 	 * this distinction is important when many files are lost and the workflow is effectively rerun from scratch. */
 	if (t->type == VINE_TASK_TYPE_RECOVERY) {
 		vine_task_set_priority(t, t->priority + priority_queue_get_top_priority(q->ready_tasks) + 1);
+		q->num_submitted_recovery_tasks++;
 	}
 
 	if (t->has_fixed_locations) {
@@ -5232,7 +5382,11 @@ struct vine_task *find_task_to_return(struct vine_manager *q, const char *tag, i
 			return t;
 			break;
 		case VINE_TASK_TYPE_RECOVERY:
-			/* do nothing and let vine_manager_consider_recovery_task do its job */
+			/* if configured to return recovery tasks, return them to the user */
+			if (q->return_recovery_tasks) {
+				return t;
+			}
+			/* otherwise, do nothing and let vine_manager_consider_recovery_task do its job */
 			break;
 		case VINE_TASK_TYPE_LIBRARY_INSTANCE:
 			/* silently delete the task, since it was created by the manager.
@@ -5446,9 +5600,15 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 			}
 		}
 
+		// Check if any worker is overloaded and rebalance the disk usage
+		if (q->balance_worker_disk_load && (timestamp_get() - q->when_last_offloaded > 5 * 1e6)) {
+			rebalance_worker_disk_usage(q);
+			q->when_last_offloaded = timestamp_get();
+		}
+
 		// Check if any temp files need replication and start replicating
 		BEGIN_ACCUM_TIME(q, time_internal);
-		result = consider_tempfile_replications(q);
+		result = vine_temp_start_replication(q);
 		END_ACCUM_TIME(q, time_internal);
 		if (result) {
 			// recovered at least one temp file
@@ -5980,6 +6140,9 @@ int vine_tune(struct vine_manager *q, const char *name, double value)
 	} else if (!strcmp(name, "enforce-worker-eviction-interval")) {
 		q->enforce_worker_eviction_interval = (timestamp_t)(MAX(0, (int)value) * ONE_SECOND);
 
+	} else if (!strcmp(name, "balance-worker-disk-load")) {
+		q->balance_worker_disk_load = !!((int)value);
+
 	} else {
 		debug(D_NOTICE | D_VINE, "Warning: tuning parameter \"%s\" not recognized\n", name);
 		return -1;
@@ -6460,9 +6623,6 @@ void vine_prune_file(struct vine_manager *m, struct vine_file *f)
 			set_free_values_array(workers_array);
 		}
 	}
-
-	/* also remove from the replication table. */
-	hash_table_remove(m->temp_files_to_replicate, f->cached_name);
 }
 
 /*
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index bcf2405616..8b4fb9826a 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -123,7 +123,7 @@ struct vine_manager {
 
 	struct hash_table *file_table;      /* Maps fileid -> struct vine_file.* */
 	struct hash_table *file_worker_table; /* Maps cachename -> struct set of workers with a replica of the file.* */
-	struct hash_table *temp_files_to_replicate; /* Maps cachename -> NULL. Used as a set of temp files to be replicated */
+	struct priority_queue *temp_files_to_replicate; /* Maps cachename -> NULL. Used as a set of temp files to be replicated */
 
 
 	/* Primary scheduling controls. */
@@ -232,6 +232,14 @@ struct vine_manager {
 	double sandbox_grow_factor;         /* When task disk sandboxes are exhausted, increase the allocation using their measured valued times this factor */
 	double disk_proportion_available_to_task;   /* intentionally reduces disk allocation for tasks to reserve some space for cache growth. */
 
+	int return_recovery_tasks; /* If true, recovery tasks are returned by vine_wait to the user. By default they are handled internally. */
+	int num_submitted_recovery_tasks;
+	vine_replica_placement_policy_t replica_placement_policy; /* Mode for selecting best worker for placing a new replica of a temp file */
+	int balance_worker_disk_load; /* If true, offload replicas from workers that are overloaded with temp files. */
+	timestamp_t when_last_offloaded;
+	int64_t peak_used_cache;
+	int shutting_down;
+
 	/* todo: confirm datatype. int or int64 */
 	int max_task_stdout_storage;	/* Maximum size of standard output from task.  (If larger, send to a separate file.) */
 	int max_new_workers;			/* Maximum number of workers to add in a single cycle before dealing with other matters. */
@@ -291,6 +299,15 @@ void vine_manager_remove_worker(struct vine_manager *q, struct vine_worker_info
 /* Check if the worker is able to transfer the necessary files for this task. */
 int vine_manager_transfer_capacity_available(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
 
+/* Delete a file from a worker. */
+int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level);
+
+/* Evict a random worker to simulate a worker failure. */
+int evict_random_worker(struct vine_manager *q);
+
+/* Get the available disk space in bytes for a worker. */
+int64_t get_worker_available_disk_bytes(struct vine_worker_info *w);
+
 /* The expected format of files created by the resource monitor.*/
 #define RESOURCE_MONITOR_TASK_LOCAL_NAME "vine-task-%d"
 #define RESOURCE_MONITOR_REMOTE_NAME "cctools-monitor"
diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
new file mode 100644
index 0000000000..0ae4e0f052
--- /dev/null
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -0,0 +1,739 @@
+#include "vine_task_graph.h"
+#include "taskvine.h"
+#include "vine_manager.h"
+#include "vine_worker_info.h"
+#include "priority_queue.h"
+#include <stdlib.h>
+#include <string.h>
+#include <stdint.h>
+#include "debug.h"
+#include "stringtools.h"
+#include "xxmalloc.h"
+#include "priority_queue.h"
+#include <math.h>
+#include "hash_table.h"
+#include <sys/stat.h>
+#include "itable.h"
+#include "list.h"
+#include "vine_task.h"
+#include "timestamp.h"
+#include "vine_file.h"
+#include "set.h"
+#include "vine_mount.h"
+#include "progress_bar.h"
+#include "assert.h"
+#include "macros.h"
+#include <signal.h>
+#include <stdio.h>
+
+static volatile sig_atomic_t interrupted = 0;
+
+/*************************************************************/
+/* Private Functions */
+/*************************************************************/
+
+static void handle_sigint(int signal)
+{
+	interrupted = 1;
+}
+
+static void submit_node_task(struct vine_task_graph *tg, struct vine_task_node *node)
+{
+	if (!tg || !node) {
+		return;
+	}
+
+	int task_id = vine_task_node_submit(node);
+	itable_insert(tg->task_id_to_node, task_id, node);
+
+	node->retry_attempts_left--;
+	if (node->retry_attempts_left < 0) {
+		debug(D_ERROR, "Aborting, node %s has exhausted all retry attempts", node->node_key);
+		vine_task_graph_delete(tg);
+		exit(1);
+	}
+
+	return;
+}
+
+static void submit_node_ready_children(struct vine_task_graph *tg, struct vine_task_node *node)
+{
+	if (!tg || !node) {
+		return;
+	}
+
+	struct vine_task_node *child_node;
+	LIST_ITERATE(node->children, child_node)
+	{
+		/* Remove this parent from the child's pending set if it exists */
+		if (child_node->pending_parents) {
+			/* Assert that this parent is indeed pending for the child */
+			assert(set_lookup(child_node->pending_parents, node));
+			set_remove(child_node->pending_parents, node);
+		}
+
+		/* If no more parents are pending, submit the child */
+		if (!child_node->pending_parents || set_size(child_node->pending_parents) == 0) {
+			submit_node_task(tg, child_node);
+		}
+	}
+
+	return;
+}
+
+static struct list *get_topological_order(struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return NULL;
+	}
+
+	int total_nodes = hash_table_size(tg->nodes);
+	struct list *topo_order = list_create();
+	struct hash_table *in_degree_map = hash_table_create(0, 0);
+	struct priority_queue *pq = priority_queue_create(total_nodes);
+
+	char *key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(tg->nodes, key, node)
+	{
+		int deg = list_size(node->parents);
+		hash_table_insert(in_degree_map, key, (void *)(intptr_t)deg);
+		if (deg == 0) {
+			priority_queue_push(pq, node, compute_lex_priority(node->node_key));
+		}
+	}
+
+	while (priority_queue_size(pq) > 0) {
+		struct vine_task_node *current = priority_queue_pop(pq);
+		list_push_tail(topo_order, current);
+
+		struct vine_task_node *child;
+		LIST_ITERATE(current->children, child)
+		{
+			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, child->node_key);
+			int deg = (int)raw_deg - 1;
+
+			hash_table_remove(in_degree_map, child->node_key);
+			hash_table_insert(in_degree_map, child->node_key, (void *)(intptr_t)deg);
+
+			if (deg == 0) {
+				priority_queue_push(pq, child, compute_lex_priority(child->node_key));
+			}
+		}
+	}
+
+	if (list_size(topo_order) != total_nodes) {
+		debug(D_ERROR, "Error: task graph contains cycles or is malformed.\n");
+		debug(D_ERROR, "Expected %d nodes, but only sorted %d.\n", total_nodes, list_size(topo_order));
+
+		HASH_TABLE_ITERATE(tg->nodes, key, node)
+		{
+			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, key);
+			int deg = (int)raw_deg;
+			if (deg > 0) {
+				debug(D_ERROR, "  Node %s has in-degree %d. Parents:\n", key, deg);
+				struct vine_task_node *p;
+				LIST_ITERATE(node->parents, p)
+				{
+					debug(D_ERROR, "    -> %s\n", p->node_key);
+				}
+			}
+		}
+
+		list_delete(topo_order);
+		exit(1);
+	}
+
+	hash_table_delete(in_degree_map);
+	priority_queue_delete(pq);
+	return topo_order;
+}
+
+static struct list *extract_weakly_connected_components(struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return NULL;
+	}
+
+	struct set *visited = set_create(0);
+	struct list *components = list_create();
+
+	char *node_key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		if (set_lookup(visited, node)) {
+			continue;
+		}
+
+		struct list *component = list_create();
+		struct list *queue = list_create();
+
+		list_push_tail(queue, node);
+		set_insert(visited, node);
+		list_push_tail(component, node);
+
+		while (list_size(queue) > 0) {
+			struct vine_task_node *curr = list_pop_head(queue);
+
+			struct vine_task_node *p;
+			LIST_ITERATE(curr->parents, p)
+			{
+				if (!set_lookup(visited, p)) {
+					list_push_tail(queue, p);
+					set_insert(visited, p);
+					list_push_tail(component, p);
+				}
+			}
+
+			struct vine_task_node *c;
+			LIST_ITERATE(curr->children, c)
+			{
+				if (!set_lookup(visited, c)) {
+					list_push_tail(queue, c);
+					set_insert(visited, c);
+					list_push_tail(component, c);
+				}
+			}
+		}
+
+		list_push_tail(components, component);
+		list_delete(queue);
+	}
+
+	set_delete(visited);
+	return components;
+}
+
+static double compute_node_heavy_score(struct vine_task_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	double up_score = node->depth * node->upstream_subgraph_size * node->fan_in;
+	double down_score = node->height * node->downstream_subgraph_size * node->fan_out;
+
+	return up_score / (down_score + 1);
+}
+
+static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struct vine_task *task)
+{
+	if (!tg || !task) {
+		return NULL;
+	}
+
+	if (task->type == VINE_TASK_TYPE_STANDARD) {
+		return itable_lookup(tg->task_id_to_node, task->task_id);
+	} else if (task->type == VINE_TASK_TYPE_RECOVERY) {
+		/* note that recovery tasks are not mapped to any node but we still need the original node for pruning,
+		 * so we look up the outfile of the task, then map it back to get the original node */
+		struct vine_mount *mount;
+		LIST_ITERATE(task->output_mounts, mount)
+		{
+			if (mount->file->original_producer_task_id > 0) {
+				return itable_lookup(tg->task_id_to_node, mount->file->original_producer_task_id);
+			}
+		}
+	}
+
+	debug(D_ERROR, "task %d has no original producer task id", task->task_id);
+
+	return NULL;
+}
+
+static void handle_checkpoint_worker_stagein(struct vine_task_graph *tg, struct vine_file *f)
+{
+	if (!tg || !f) {
+		return;
+	}
+
+	struct vine_task_node *this_node = hash_table_lookup(tg->outfile_cachename_to_node, f->cached_name);
+	if (!this_node) {
+		return;
+	}
+
+	vine_task_node_prune_ancestors(this_node);
+}
+
+/*************************************************************/
+/* Public APIs */
+/*************************************************************/
+
+void vine_task_graph_execute(struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return;
+	}
+
+	char *node_key;
+	struct vine_task_node *node;
+
+	/* create mapping from task_id and outfile cached_name to node */
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		if (node->outfile) {
+			hash_table_insert(tg->outfile_cachename_to_node, node->outfile->cached_name, node);
+		}
+	}
+
+	/* add the parents' outfiles as inputs to the task */
+	struct list *topo_order = get_topological_order(tg);
+	LIST_ITERATE(topo_order, node)
+	{
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (parent_node->outfile) {
+				vine_task_add_input(node->task, parent_node->outfile, parent_node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
+			}
+		}
+	}
+
+	/* initialize pending_parents for all nodes */
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (node->pending_parents) {
+				/* Use parent_node->node_key to ensure pointer consistency */
+				set_insert(node->pending_parents, parent_node);
+			}
+		}
+	}
+
+	/* enable return recovery tasks */
+	vine_enable_return_recovery_tasks(tg->manager);
+
+	/* enqueue those without dependencies */
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
+			submit_node_task(tg, node);
+		}
+	}
+
+	/* calculate steps to inject failure */
+	double next_failure_threshold = -1.0;
+	if (tg->failure_injection_step_percent > 0) {
+		next_failure_threshold = tg->failure_injection_step_percent / 100.0;
+	}
+
+	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
+	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(tg->nodes));
+	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
+	progress_bar_bind_part(pbar, regular_tasks_part);
+	progress_bar_bind_part(pbar, recovery_tasks_part);
+
+	int wait_timeout = 2;
+
+	while (regular_tasks_part->current < regular_tasks_part->total) {
+		if (interrupted) {
+			break;
+		}
+
+		struct vine_task *task = vine_wait(tg->manager, wait_timeout);
+		progress_bar_set_part_total(pbar, recovery_tasks_part, tg->manager->num_submitted_recovery_tasks);
+		if (task) {
+			/* retrieve all possible tasks */
+			wait_timeout = 0;
+
+			/* get the original node by task id */
+			struct vine_task_node *node = get_node_by_task(tg, task);
+			if (!node) {
+				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
+				exit(1);
+			}
+
+			/* in case of failure, resubmit this task */
+			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
+				debug(D_VINE | D_NOTICE, "Task %d failed with result %d and exit code %d, resubmitting...", task->task_id, node->task->result, node->task->exit_code);
+				vine_task_reset(node->task);
+				submit_node_task(tg, node);
+				continue;
+			}
+
+			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
+			switch (node->outfile_type) {
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+				struct stat info;
+				int result = stat(node->outfile_remote_name, &info);
+				if (result < 0) {
+					debug(D_VINE | D_NOTICE, "Task %d succeeded but output file %s does not exist on the shared file system", task->task_id, node->outfile_remote_name);
+					vine_task_reset(node->task);
+					submit_node_task(tg, node);
+					continue;
+				}
+				node->outfile_size_bytes = info.st_size;
+				break;
+			case VINE_NODE_OUTFILE_TYPE_LOCAL:
+			case VINE_NODE_OUTFILE_TYPE_TEMP:
+				node->outfile_size_bytes = node->outfile->size;
+				break;
+			}
+			debug(D_VINE, "Node %s completed with outfile %s size: %ld bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
+
+			/* mark the node as completed */
+			node->completed = 1;
+
+			/* prune nodes on task completion */
+			vine_task_node_prune_ancestors(node);
+
+			/* skip recovery tasks */
+			if (task->type == VINE_TASK_TYPE_RECOVERY) {
+				progress_bar_update_part(pbar, recovery_tasks_part, 1);
+				continue;
+			}
+
+			/* set the start time to the submit time of the first regular task */
+			if (regular_tasks_part->current == 0) {
+				progress_bar_set_start_time(pbar, task->time_when_commit_start);
+			}
+			
+			/* update critical time */
+			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
+			
+			/* mark this regular task as completed */
+			progress_bar_update_part(pbar, regular_tasks_part, 1);
+
+			/* inject failure */
+			if (tg->failure_injection_step_percent > 0) {
+				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
+				if (progress >= next_failure_threshold && evict_random_worker(tg->manager)) {
+					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
+					next_failure_threshold += tg->failure_injection_step_percent / 100.0;
+				}
+			}
+
+			/* enqueue the output file for replication or checkpointing */
+			switch (node->outfile_type) {
+			case VINE_NODE_OUTFILE_TYPE_TEMP:
+				vine_task_node_replicate_outfile(node);
+				break;
+			case VINE_NODE_OUTFILE_TYPE_LOCAL:
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+				break;
+			}
+
+			/* submit children nodes with dependencies all resolved */
+			submit_node_ready_children(tg, node);
+		} else {
+			wait_timeout = 2;
+			progress_bar_update_part(pbar, recovery_tasks_part, 0);
+		}
+	}
+
+	progress_bar_finish(pbar);
+	progress_bar_delete(pbar);
+
+	double total_time_spent_on_unlink_local_files = 0;
+	double total_time_spent_on_prune_ancestors_of_temp_node = 0;
+	double total_time_spent_on_prune_ancestors_of_persisted_node = 0;
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
+		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
+		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
+	}
+	total_time_spent_on_unlink_local_files /= 1e6;
+	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
+	total_time_spent_on_prune_ancestors_of_persisted_node /= 1e6;
+
+	debug(D_VINE, "total time spent on prune ancestors of temp node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_temp_node);
+	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
+	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
+
+	return;
+}
+
+void vine_task_graph_finalize_metrics(struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return;
+	}
+
+	/* get nodes in topological order */
+	struct list *topo_order = get_topological_order(tg);
+	if (!topo_order) {
+		return;
+	}
+
+	char *node_key;
+	struct vine_task_node *node;
+	struct vine_task_node *parent_node;
+	struct vine_task_node *child_node;
+
+	/* compute the depth of the node */
+	LIST_ITERATE(topo_order, node)
+	{
+		node->depth = 0;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (node->depth < parent_node->depth + 1) {
+				node->depth = parent_node->depth + 1;
+			}
+		}
+	}
+
+	/* compute the height of the node */
+	LIST_ITERATE_REVERSE(topo_order, node)
+	{
+		node->height = 0;
+		LIST_ITERATE(node->children, child_node)
+		{
+			if (node->height < child_node->height + 1) {
+				node->height = child_node->height + 1;
+			}
+		}
+	}
+
+	/* compute the upstream and downstream counts for each node */
+	struct hash_table *upstream_map = hash_table_create(0, 0);
+	struct hash_table *downstream_map = hash_table_create(0, 0);
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		struct set *upstream = set_create(0);
+		struct set *downstream = set_create(0);
+		hash_table_insert(upstream_map, node_key, upstream);
+		hash_table_insert(downstream_map, node_key, downstream);
+	}
+	LIST_ITERATE(topo_order, node)
+	{
+		struct set *upstream = hash_table_lookup(upstream_map, node->node_key);
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			struct set *parent_upstream = hash_table_lookup(upstream_map, parent_node->node_key);
+			set_union(upstream, parent_upstream);
+			set_insert(upstream, parent_node);
+		}
+	}
+	LIST_ITERATE_REVERSE(topo_order, node)
+	{
+		struct set *downstream = hash_table_lookup(downstream_map, node->node_key);
+		LIST_ITERATE(node->children, child_node)
+		{
+			struct set *child_downstream = hash_table_lookup(downstream_map, child_node->node_key);
+			set_union(downstream, child_downstream);
+			set_insert(downstream, child_node);
+		}
+	}
+	LIST_ITERATE(topo_order, node)
+	{
+		node->upstream_subgraph_size = set_size(hash_table_lookup(upstream_map, node->node_key));
+		node->downstream_subgraph_size = set_size(hash_table_lookup(downstream_map, node->node_key));
+		node->fan_in = list_size(node->parents);
+		node->fan_out = list_size(node->children);
+		set_delete(hash_table_lookup(upstream_map, node->node_key));
+		set_delete(hash_table_lookup(downstream_map, node->node_key));
+	}
+	hash_table_delete(upstream_map);
+	hash_table_delete(downstream_map);
+
+	/* compute the heavy score  */
+	LIST_ITERATE(topo_order, node)
+	{
+		node->heavy_score = compute_node_heavy_score(node);
+	}
+
+	/* extract weakly connected components */
+	struct list *weakly_connected_components = extract_weakly_connected_components(tg);
+	struct list *component;
+	int component_index = 0;
+	debug(D_VINE, "graph has %d weakly connected components\n", list_size(weakly_connected_components));
+	LIST_ITERATE(weakly_connected_components, component)
+	{
+		debug(D_VINE, "component %d size: %d\n", component_index, list_size(component));
+		component_index++;
+	}
+	list_delete(weakly_connected_components);
+
+	list_delete(topo_order);
+
+	return;
+}
+
+struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
+{
+	struct vine_task_graph *tg = xxmalloc(sizeof(struct vine_task_graph));
+	tg->nodes = hash_table_create(0, 0);
+	tg->task_id_to_node = itable_create(0);
+	tg->outfile_cachename_to_node = hash_table_create(0, 0);
+
+	tg->library_name = xxstrdup("vine_task_graph_library");
+	tg->function_name = xxstrdup("compute_single_key");
+	tg->manager = q;
+
+	tg->failure_injection_step_percent = -1.0;
+
+	/* enable debug system for C code since it uses a separate debug system instance
+	 * from the Python bindings. Use the same function that the manager uses. */
+	char *debug_tmp = string_format("%s/vine-logs/debug", tg->manager->runtime_directory);
+	vine_enable_debug_log(debug_tmp);
+	free(debug_tmp);
+
+	signal(SIGINT, handle_sigint);
+
+	return tg;
+}
+
+void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent)
+{
+	if (!tg) {
+		return;
+	}
+
+	if (percent <= 0 || percent > 100) {
+		return;
+	}
+
+	debug(D_VINE, "setting failure injection step percent to %lf", percent);
+	tg->failure_injection_step_percent = percent;
+}
+
+struct vine_task_node *vine_task_graph_create_node(
+		struct vine_task_graph *tg,
+		const char *node_key,
+		const char *staging_dir,
+		int prune_depth,
+		vine_task_node_priority_mode_t priority_mode)
+{
+	if (!tg || !node_key) {
+		return NULL;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		node = vine_task_node_create(tg->manager,
+				node_key,
+				tg->library_name,
+				tg->function_name,
+				staging_dir,
+				prune_depth,
+				priority_mode);
+		hash_table_insert(tg->nodes, node_key, node);
+	}
+
+	return node;
+}
+
+void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key)
+{
+	if (!tg || !parent_key || !child_key) {
+		return;
+	}
+
+	struct vine_task_node *parent_node = hash_table_lookup(tg->nodes, parent_key);
+	struct vine_task_node *child_node = hash_table_lookup(tg->nodes, child_key);
+	if (!parent_node) {
+		debug(D_ERROR, "parent node %s not found", parent_key);
+		exit(1);
+	}
+	if (!child_node) {
+		debug(D_ERROR, "child node %s not found", child_key);
+		exit(1);
+	}
+
+	list_push_tail(child_node->parents, parent_node);
+	list_push_tail(parent_node->children, child_node);
+	debug(D_VINE, "added dependency: %s -> %s", parent_key, child_key);
+}
+
+const char *vine_task_graph_get_library_name(const struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return NULL;
+	}
+	return tg->library_name;
+}
+
+const char *vine_task_graph_get_function_name(const struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return NULL;
+	}
+	return tg->function_name;
+}
+
+double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key)
+{
+	if (!tg) {
+		return -1;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		return -1;
+	}
+
+	return node->heavy_score;
+}
+
+const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key)
+{
+	if (!tg || !node_key) {
+		return NULL;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		debug(D_ERROR, "node %s not found", node_key);
+		exit(1);
+	}
+
+	if (node->outfile_type != VINE_NODE_OUTFILE_TYPE_LOCAL) {
+		debug(D_ERROR, "node %s is not a local output file", node_key);
+		exit(1);
+	}
+
+	return node->outfile->source;
+}
+
+void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
+{
+	if (!tg || !node_key || !outfile_remote_name) {
+		return;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		return;
+	}
+
+	vine_task_node_set_outfile(node, outfile_type, outfile_remote_name);
+
+	return;
+}
+
+void vine_task_graph_delete(struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return;
+	}
+
+	char *node_key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		if (node->infile) {
+			vine_prune_file(tg->manager, node->infile);
+			hash_table_remove(tg->manager->file_table, node->infile->cached_name);
+		}
+		if (node->outfile) {
+			vine_prune_file(tg->manager, node->outfile);
+			hash_table_remove(tg->outfile_cachename_to_node, node->outfile->cached_name);
+			hash_table_remove(tg->manager->file_table, node->outfile->cached_name);
+		}
+		vine_task_node_delete(node);
+	}
+
+	vine_delete(tg->manager);
+
+	free(tg->library_name);
+	free(tg->function_name);
+
+	hash_table_delete(tg->nodes);
+	itable_delete(tg->task_id_to_node);
+	hash_table_delete(tg->outfile_cachename_to_node);
+	free(tg);
+}
diff --git a/taskvine/src/manager/vine_task_graph.h b/taskvine/src/manager/vine_task_graph.h
new file mode 100644
index 0000000000..1692d1fc9e
--- /dev/null
+++ b/taskvine/src/manager/vine_task_graph.h
@@ -0,0 +1,24 @@
+#ifndef VINE_TASK_GRAPH_H
+#define VINE_TASK_GRAPH_H
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "list.h"
+#include "vine_manager.h"
+#include "set.h"
+#include "vine_task_node.h"
+
+struct vine_task_graph {
+    struct vine_manager *manager;
+	struct hash_table *nodes;
+	struct itable *task_id_to_node;
+	struct hash_table *outfile_cachename_to_node;
+
+    char *library_name;
+    char *function_name;
+
+    double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
+};
+
+
+#endif // VINE_TASK_GRAPH_H
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
new file mode 100644
index 0000000000..ae99004ba8
--- /dev/null
+++ b/taskvine/src/manager/vine_task_node.c
@@ -0,0 +1,611 @@
+#include "vine_task_node.h"
+#include "vine_manager.h"
+#include "vine_task.h"
+#include "vine_file.h"
+#include "vine_task_graph.h"
+#include "xxmalloc.h"
+#include "stringtools.h"
+#include "taskvine.h"
+#include "timestamp.h"
+#include "set.h"
+#include "hash_table.h"
+#include "unistd.h"
+#include "debug.h"
+#include "assert.h"
+#include "vine_worker_info.h"
+#include "vine_temp.h"
+#include "random.h"
+
+double compute_lex_priority(const char *key)
+{
+	double score = 0.0;
+	double factor = 1.0;
+	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
+		score += key[i] * factor;
+		factor *= 0.01;
+	}
+	return -score;
+}
+
+/*
+ * Create a new node in the graph.
+ * The caller must construct the graph nodes in a topological order.
+ */
+
+struct vine_task_node *vine_task_node_create(
+		struct vine_manager *manager,
+		const char *node_key,
+		const char *library_name,
+		const char *function_name,
+		const char *staging_dir,
+		int prune_depth,
+		vine_task_node_priority_mode_t priority_mode)
+{
+	if (!manager || !node_key || !library_name || !function_name || !staging_dir) {
+		return NULL;
+	}
+
+	struct vine_task_node *node = xxmalloc(sizeof(struct vine_task_node));
+
+	node->manager = manager;
+	node->node_key = xxstrdup(node_key);
+	node->staging_dir = xxstrdup(staging_dir);
+	node->priority_mode = priority_mode;
+	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
+	node->parents = list_create();
+	node->children = list_create();
+	node->pending_parents = set_create(0);
+	node->completed = 0;
+	node->prune_depth = prune_depth;
+	node->retry_attempts_left = 1;
+
+	node->outfile_size_bytes = 0;
+	node->depth = -1;
+	node->height = -1;
+	node->upstream_subgraph_size = -1;
+	node->downstream_subgraph_size = -1;
+	node->fan_in = -1;
+	node->fan_out = -1;
+	node->heavy_score = -1;
+
+	node->time_spent_on_unlink_local_files = 0;
+	node->time_spent_on_prune_ancestors_of_temp_node = 0;
+	node->time_spent_on_prune_ancestors_of_persisted_node = 0;
+
+	node->critical_time = -1;
+
+	debug(D_VINE, "node info: key=%s, staging_dir=%s, priority_mode=%d, prune_depth=%d", node->node_key, node->staging_dir, node->priority_mode, node->prune_depth);
+
+	/* create the task */
+	node->task = vine_task_create(function_name);
+	vine_task_set_library_required(node->task, library_name);
+	vine_task_addref(node->task);
+
+	/* add the infile as the key of the graph to compute */
+	char *infile_content = string_format("%s", node->node_key);
+	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
+	free(infile_content);
+	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
+
+	return node;
+}
+
+void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
+{
+	if (!node) {
+		return;
+	}
+
+	assert(outfile_remote_name != NULL);
+
+	node->outfile_type = outfile_type;
+	node->outfile_remote_name = xxstrdup(outfile_remote_name);
+
+	/* create the output file */
+	switch (node->outfile_type) {
+	case VINE_NODE_OUTFILE_TYPE_LOCAL:
+		char *persistent_path = string_format("%s/outputs/%s", node->staging_dir, node->outfile_remote_name);
+		node->outfile = vine_declare_file(node->manager, persistent_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
+		free(persistent_path);
+		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_LOCAL, outfile = %s", node->node_key, node->outfile->cached_name);
+		break;
+	case VINE_NODE_OUTFILE_TYPE_TEMP:
+		node->outfile = vine_declare_temp(node->manager);
+		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_TEMP, outfile = %s", node->node_key, node->outfile->cached_name);
+		break;
+	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+		/* no explicit output file declaration needed */
+		node->outfile = NULL;
+		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM", node->node_key);
+		break;
+	}
+	if (node->outfile) {
+		vine_task_add_output(node->task, node->outfile, node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
+	}
+
+	return;
+}
+
+static int _node_outfile_is_persisted(struct vine_task_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	/* if the node is not completed then the outfile is definitely not persisted */
+	if (!node->completed) {
+		return 0;
+	}
+
+	/* if the outfile pointer is NULL, it means the node is producing a shared file system file */
+	if (!node->outfile) {
+		return 1;
+	}
+
+	switch (node->outfile->type) {
+	case VINE_FILE:
+		return 1;
+	case VINE_TEMP:
+		/* check if this file is in the any of the checkpoint workers */
+		return file_has_been_checkpointed(node->manager, node->outfile);
+	default:
+		/* not supported at the moment */
+		debug(D_ERROR, "unsupported outfile type: %d", node->outfile->type);
+		return 0;
+	}
+}
+
+double vine_task_node_calculate_priority(struct vine_task_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	double priority = 0;
+	timestamp_t current_time = timestamp_get();
+
+	struct vine_task_node *parent_node;
+
+	switch (node->priority_mode) {
+	case VINE_TASK_PRIORITY_MODE_RANDOM:
+		priority = random_double();
+		break;
+	case VINE_TASK_PRIORITY_MODE_DEPTH_FIRST:
+		priority = (double)node->depth;
+		break;
+	case VINE_TASK_PRIORITY_MODE_BREADTH_FIRST:
+		priority = -(double)node->depth;
+		break;
+	case VINE_TASK_PRIORITY_MODE_FIFO:
+		priority = -(double)current_time;
+		break;
+	case VINE_TASK_PRIORITY_MODE_LIFO:
+		priority = (double)current_time;
+		break;
+	case VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST:
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (!parent_node->outfile) {
+				continue;
+			}
+			priority += (double)vine_file_size(parent_node->outfile);
+		}
+		break;
+	case VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (!parent_node->outfile) {
+				continue;
+			}
+			timestamp_t parent_task_completion_time = parent_node->task->time_workers_execute_last;
+			priority += (double)vine_file_size(parent_node->outfile) * (double)parent_task_completion_time;
+		}
+		break;
+	}
+
+	return priority;
+}
+
+void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time)
+{
+	timestamp_t max_parent_critical_time = 0;
+	struct vine_task_node *parent_node;
+	LIST_ITERATE(node->parents, parent_node)
+	{
+		if (parent_node->critical_time > max_parent_critical_time) {
+			max_parent_critical_time = parent_node->critical_time;
+		}
+	}
+	node->critical_time = max_parent_critical_time + execution_time;
+}
+
+/* delete all of the replicas present at remote workers. */
+int _prune_outfile_from_regular_workers(struct vine_task_node *node)
+{
+	if (!node || !node->outfile) {
+		return 0;
+	}
+
+	struct set *source_workers = hash_table_lookup(node->manager->file_worker_table, node->outfile->cached_name);
+	if (!source_workers) {
+		return 0;
+	}
+
+	int pruned_replica_count = 0;
+
+	struct vine_worker_info *source_worker;
+	SET_ITERATE(source_workers, source_worker)
+	{
+		if (is_checkpoint_worker(node->manager, source_worker)) {
+			continue;
+		}
+		delete_worker_file(node->manager, source_worker, node->outfile->cached_name, 0, 0);
+		pruned_replica_count++;
+	}
+
+	return pruned_replica_count;
+}
+
+/* the dfs helper function for finding parents in a specific depth */
+static void _find_parents_dfs(struct vine_task_node *node, int remaining_depth, struct list *result, struct set *visited)
+{
+	if (!node || set_lookup(visited, node)) {
+		return;
+	}
+	set_insert(visited, node);
+	if (remaining_depth == 0) {
+		list_push_tail(result, node);
+		return;
+	}
+	struct vine_task_node *parent_node;
+	LIST_ITERATE(node->parents, parent_node)
+	{
+		_find_parents_dfs(parent_node, remaining_depth - 1, result, visited);
+	}
+}
+
+/* find all parents in a specific depth of the node */
+static struct list *_find_parents_in_depth(struct vine_task_node *node, int depth)
+{
+	if (!node || depth < 0) {
+		return NULL;
+	}
+	struct list *result = list_create();
+	struct set *visited = set_create(0);
+	_find_parents_dfs(node, depth, result, visited);
+	set_delete(visited);
+
+	return result;
+}
+
+int _prune_ancestors_of_temp_node(struct vine_task_node *node)
+{
+	if (!node || !node->outfile || node->prune_depth <= 0) {
+		return 0;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	struct list *parents = _find_parents_in_depth(node, node->prune_depth);
+
+	struct vine_task_node *parent_node;
+	LIST_ITERATE(parents, parent_node)
+	{
+		/* skip if the parent produces a shared file system file */
+		if (!parent_node->outfile) {
+			continue;
+		}
+		/* skip if the parent produces a non-temp file */
+		if (parent_node->outfile->type != VINE_TEMP) {
+			continue;
+		}
+
+		/* a file is prunable if its outfile is no longer needed by any child node:
+		 * 1. it has no pending dependents
+		 * 2. all completed dependents have also completed their corresponding recovery tasks, if any */
+		int all_children_completed = 1;
+		struct vine_task_node *child_node;
+		LIST_ITERATE(parent_node->children, child_node)
+		{
+			/* break early if the child node is not completed */
+			if (!child_node->completed) {
+				all_children_completed = 0;
+				break;
+			}
+			/* if the task produces a temp file and the recovery task is running, the parent is not prunable */
+			if (child_node->outfile && child_node->outfile->type == VINE_TEMP) {
+				struct vine_task *child_node_recovery_task = child_node->outfile->recovery_task;
+				if (child_node_recovery_task && (child_node_recovery_task->state != VINE_TASK_INITIAL && child_node_recovery_task->state != VINE_TASK_DONE)) {
+					all_children_completed = 0;
+					break;
+				}
+			}
+		}
+		if (!all_children_completed) {
+			continue;
+		}
+
+		pruned_replica_count += _prune_outfile_from_regular_workers(parent_node);
+		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
+		 * manager may submit a recovery task to bring it back in case of worker failures. */
+		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
+	}
+
+	list_delete(parents);
+
+	node->time_spent_on_prune_ancestors_of_temp_node += timestamp_get() - start_time;
+
+	return pruned_replica_count;
+}
+
+static struct set *_find_safe_ancestors(struct vine_task_node *start_node)
+{
+	if (!start_node) {
+		return NULL;
+	}
+
+	struct set *visited_nodes = set_create(0);
+	struct list *bfs_nodes = list_create();
+
+	list_push_tail(bfs_nodes, start_node);
+	set_insert(visited_nodes, start_node);
+
+	while (list_size(bfs_nodes) > 0) {
+		struct vine_task_node *current = list_pop_head(bfs_nodes);
+
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(current->parents, parent_node)
+		{
+			if (set_lookup(visited_nodes, parent_node)) {
+				continue;
+			}
+
+			/* shortcut if this parent was already safely pruned */
+			if (parent_node->prune_status == PRUNE_STATUS_SAFE) {
+				continue;
+			}
+
+			/* check if all children are safe */
+			int all_children_safe = 1;
+			struct vine_task_node *child_node;
+			LIST_ITERATE(parent_node->children, child_node)
+			{
+				/* shortcut if this child is part of the recovery subgraph */
+				if (set_lookup(visited_nodes, child_node)) {
+					continue;
+				}
+				/* shortcut if this outside child is not persisted */
+				if (!_node_outfile_is_persisted(child_node)) {
+					all_children_safe = 0;
+					break;
+				}
+				/* shortcut if this outside child is unsafely pruned */
+				if (child_node->prune_status == PRUNE_STATUS_UNSAFE) {
+					all_children_safe = 0;
+					break;
+				}
+			}
+
+			if (!all_children_safe) {
+				continue;
+			}
+
+			set_insert(visited_nodes, parent_node);
+			list_push_tail(bfs_nodes, parent_node);
+		}
+	}
+
+	list_delete(bfs_nodes);
+	set_remove(visited_nodes, start_node);
+
+	return visited_nodes;
+}
+
+int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	/* find all safe ancestors */
+	struct set *safe_ancestors = _find_safe_ancestors(node);
+	if (!safe_ancestors) {
+		return 0;
+	}
+
+	/* prune all safe ancestors */
+	struct vine_task_node *ancestor_node;
+	SET_ITERATE(safe_ancestors, ancestor_node)
+	{
+		/* unlink the shared file system file */
+		if (!ancestor_node->outfile) {
+			timestamp_t start_time = timestamp_get();
+			unlink(ancestor_node->outfile_remote_name);
+			node->time_spent_on_unlink_local_files += timestamp_get() - start_time;
+			debug(D_VINE, "unlinked %s size: %ld bytes, time: %ld", ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
+		} else {
+			switch (ancestor_node->outfile->type) {
+			case VINE_FILE:
+				/* do not prune the staging dir file */
+				break;
+			case VINE_TEMP:
+				/* prune the temp file */
+				vine_prune_file(node->manager, ancestor_node->outfile);
+				break;
+			default:
+				debug(D_ERROR, "unsupported outfile type: %d", ancestor_node->outfile->type);
+				break;
+			}
+		}
+		ancestor_node->prune_status = PRUNE_STATUS_SAFE;
+		pruned_replica_count++;
+	}
+
+	set_delete(safe_ancestors);
+
+	node->time_spent_on_prune_ancestors_of_persisted_node += timestamp_get() - start_time;
+
+	return pruned_replica_count;
+}
+
+int vine_task_node_submit(struct vine_task_node *node)
+{
+	if (!node) {
+		return -1;
+	}
+
+	double priority = vine_task_node_calculate_priority(node);
+	vine_task_set_priority(node->task, priority);
+
+	debug(D_VINE, "node %s: priority_mode=%d, depth=%d, calculated_priority=%.6f", node->node_key, node->priority_mode, node->depth, priority);
+
+	return vine_submit(node->manager, node->task);
+}
+
+void vine_task_node_print_info(struct vine_task_node *node)
+{
+	if (!node) {
+		return;
+	}
+
+	debug(D_VINE, "node info %s task_id: %d", node->node_key, node->task->task_id);
+	debug(D_VINE, "node info %s depth: %d", node->node_key, node->depth);
+	debug(D_VINE, "node info %s outfile remote name: %s", node->node_key, node->outfile_remote_name);
+
+	if (node->outfile) {
+		switch (node->outfile->type) {
+		case VINE_FILE:
+			debug(D_VINE, "node info %s outfile type: VINE_FILE, cached name: %s", node->node_key, node->outfile->cached_name);
+			break;
+		case VINE_TEMP:
+			debug(D_VINE, "node info %s outfile type: VINE_TEMP, cached name: %s", node->node_key, node->outfile->cached_name);
+			break;
+		default:
+			debug(D_ERROR, "unsupported outfile type: %d", node->outfile->type);
+			break;
+		}
+	}
+
+	char *parent_keys = NULL;
+	struct vine_task_node *parent_node;
+	LIST_ITERATE(node->parents, parent_node)
+	{
+		if (!parent_keys) {
+			parent_keys = string_format("%s", parent_node->node_key);
+		} else {
+			char *tmp = string_format("%s, %s", parent_keys, parent_node->node_key);
+			free(parent_keys);
+			parent_keys = tmp;
+		}
+	}
+	debug(D_VINE, "node info %s parents: %s", node->node_key, parent_keys);
+	free(parent_keys);
+
+	char *child_keys = NULL;
+	struct vine_task_node *child_node;
+	LIST_ITERATE(node->children, child_node)
+	{
+		if (!child_keys) {
+			child_keys = string_format("%s", child_node->node_key);
+		} else {
+			char *tmp = string_format("%s, %s", child_keys, child_node->node_key);
+			free(child_keys);
+			child_keys = tmp;
+		}
+	}
+	debug(D_VINE, "node info %s children: %s", node->node_key, child_keys);
+	free(child_keys);
+
+	return;
+}
+
+void vine_task_node_prune_ancestors(struct vine_task_node *node)
+{
+	if (!node) {
+		return;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	if (_node_outfile_is_persisted(node)) {
+		pruned_replica_count = _prune_ancestors_of_persisted_node(node);
+	} else {
+		pruned_replica_count = _prune_ancestors_of_temp_node(node);
+	}
+
+	timestamp_t elapsed_time = timestamp_get() - start_time;
+
+	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
+}
+
+void vine_task_node_replicate_outfile(struct vine_task_node *node)
+{
+	if (!node || !node->outfile) {
+		return;
+	}
+
+	vine_temp_replicate_file_later(node->manager, node->outfile);
+}
+
+void vine_task_node_checkpoint_outfile(struct vine_task_node *node)
+{
+	if (!node || !node->outfile) {
+		return;
+	}
+
+	vine_temp_checkpoint_file_later(node->manager, node->outfile);
+}
+
+int vine_task_node_set_outfile_size_bytes(struct vine_task_node *node, size_t outfile_size_bytes)
+{
+	if (!node || !node->outfile) {
+		return -1;
+	}
+
+	node->outfile_size_bytes = outfile_size_bytes;
+
+	return 0;
+}
+
+/* delete the node and all of its associated resources. */
+void vine_task_node_delete(struct vine_task_node *node)
+{
+	if (!node) {
+		return;
+	}
+
+	if (node->node_key) {
+		free(node->node_key);
+	}
+	if (node->outfile_remote_name) {
+		free(node->outfile_remote_name);
+	}
+
+	vine_task_delete(node->task);
+	node->task = NULL;
+
+	if (node->infile) {
+		vine_file_delete(node->infile);
+		node->infile = NULL;
+	}
+	if (node->outfile) {
+		vine_file_delete(node->outfile);
+		node->outfile = NULL;
+	}
+
+	list_delete(node->parents);
+	list_delete(node->children);
+
+	if (node->pending_parents) {
+		set_delete(node->pending_parents);
+	}
+	free(node);
+}
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_task_node.h b/taskvine/src/manager/vine_task_node.h
new file mode 100644
index 0000000000..13486e12c0
--- /dev/null
+++ b/taskvine/src/manager/vine_task_node.h
@@ -0,0 +1,76 @@
+#ifndef VINE_TASK_NODE_H
+#define VINE_TASK_NODE_H
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "list.h"
+#include "vine_manager.h"
+#include "set.h"
+#include "taskvine.h"
+
+typedef enum {
+    PRUNE_STATUS_NOT_PRUNED = 0,
+    PRUNE_STATUS_SAFE,
+    PRUNE_STATUS_UNSAFE
+} prune_status_t;
+
+struct vine_task_node {
+    char *node_key;
+
+    struct vine_manager *manager;
+    struct vine_task *task;
+    struct vine_file *infile;
+    struct vine_file *outfile;
+    char *outfile_remote_name;
+    char *staging_dir;
+    size_t outfile_size_bytes;
+        
+    struct list *parents;
+    struct list *children;
+    struct set *pending_parents;
+    
+    int retry_attempts_left;
+    int completed;
+    int prune_depth;
+
+    int depth;
+    int height;
+    int upstream_subgraph_size;
+    int downstream_subgraph_size;
+    int fan_in;
+    int fan_out;
+    double heavy_score;
+
+    timestamp_t critical_time;
+    timestamp_t time_spent_on_unlink_local_files;
+    timestamp_t time_spent_on_prune_ancestors_of_temp_node;
+    timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
+
+    vine_task_node_priority_mode_t priority_mode;
+    vine_task_node_outfile_type_t outfile_type;
+    prune_status_t prune_status;
+};
+
+struct vine_task_node *vine_task_node_create(
+    struct vine_manager *manager,
+    const char *node_key,
+    const char *library_name,
+    const char *function_name,
+    const char *staging_dir,
+    int prune_depth,
+    vine_task_node_priority_mode_t priority_mode
+);
+
+void vine_task_node_delete(struct vine_task_node *node);
+double compute_lex_priority(const char *key);
+void vine_task_node_prune_ancestors(struct vine_task_node *node);
+double vine_task_node_calculate_priority(struct vine_task_node *node);
+void vine_task_node_print_info(struct vine_task_node *node);
+void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time);
+void vine_task_node_replicate_outfile(struct vine_task_node *node);
+int vine_task_node_submit(struct vine_task_node *node);
+void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
+int vine_task_node_set_outfile_size_bytes(struct vine_task_node *node, size_t outfile_size_bytes);
+void vine_task_node_checkpoint_outfile(struct vine_task_node *node);
+
+#endif
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
new file mode 100644
index 0000000000..914de9a893
--- /dev/null
+++ b/taskvine/src/manager/vine_temp.c
@@ -0,0 +1,288 @@
+#include "vine_temp.h"
+#include "priority_queue.h"
+#include "vine_file.h"
+#include "vine_worker_info.h"
+#include "vine_file_replica_table.h"
+#include "macros.h"
+#include "stringtools.h"
+#include "vine_manager.h"
+#include "debug.h"
+#include "random.h"
+#include "vine_manager_put.h"
+#include "xxmalloc.h"
+
+/*************************************************************/
+/* Private Functions */
+/*************************************************************/
+
+int is_checkpoint_worker(struct vine_manager *q, struct vine_worker_info *w)
+{
+	if (!q || !w || !w->features) {
+		return 0;
+	}
+
+	return hash_table_lookup(w->features, "checkpoint-worker") != NULL;
+}
+
+static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return NULL;
+	}
+
+	struct set *sources = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!sources) {
+		return NULL;
+	}
+
+	struct priority_queue *valid_sources_queue = priority_queue_create(0);
+	struct vine_worker_info *w = NULL;
+	SET_ITERATE(sources, w)
+	{
+		/* skip if transfer port is not active or in draining mode */
+		if (!w->transfer_port_active || w->draining) {
+			continue;
+		}
+		/* skip if incoming transfer counter is too high */
+		if (w->outgoing_xfer_counter >= q->worker_source_max_transfers) {
+			continue;
+		}
+		/* skip if the worker does not have this file */
+		struct vine_file_replica *replica = vine_file_replica_table_lookup(w, f->cached_name);
+		if (!replica) {
+			continue;
+		}
+		/* skip if the file is not ready */
+		if (replica->state != VINE_FILE_REPLICA_STATE_READY) {
+			continue;
+		}
+		/* those with less outgoing_xfer_counter are preferred */
+		priority_queue_push(valid_sources_queue, w, -w->outgoing_xfer_counter);
+	}
+
+	struct vine_worker_info *best_source = priority_queue_pop(valid_sources_queue);
+	priority_queue_delete(valid_sources_queue);
+
+	return best_source;
+}
+
+static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return NULL;
+	}
+
+	struct priority_queue *valid_destinations = priority_queue_create(0);
+
+	char *key;
+	struct vine_worker_info *w;
+	HASH_TABLE_ITERATE(q->worker_table, key, w)
+	{
+		/* skip if transfer port is not active or in draining mode */
+		if (!w->transfer_port_active || w->draining) {
+			continue;
+		}
+		/* skip if the incoming transfer counter is too high */
+		if (w->incoming_xfer_counter >= q->worker_source_max_transfers) {
+			continue;
+		}
+		/* skip if the worker is a checkpoint worker */
+		if (is_checkpoint_worker(q, w)) {
+			continue;
+		}
+		/* skip if the worker already has this file */
+		struct vine_file_replica *replica = vine_file_replica_table_lookup(w, f->cached_name);
+		if (replica) {
+			continue;
+		}
+		/* skip if the worker does not have enough disk space */
+		int64_t available_disk_space = get_worker_available_disk_bytes(w);
+		if ((int64_t)f->size > available_disk_space) {
+			continue;
+		}
+		/* workers with more available disk space are preferred */
+		priority_queue_push(valid_destinations, w, available_disk_space);
+		switch (q->replica_placement_policy) {
+		case VINE_REPLICA_PLACEMENT_POLICY_RANDOM:
+			priority_queue_push(valid_destinations, w, random_double());
+			break;
+		case VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD:
+			priority_queue_push(valid_destinations, w, available_disk_space);
+			break;
+		case VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD:
+			priority_queue_push(valid_destinations, w, -w->incoming_xfer_counter);
+			break;
+		}
+	}
+
+	struct vine_worker_info *best_destination = priority_queue_pop(valid_destinations);
+	priority_queue_delete(valid_destinations);
+
+	return best_destination;
+}
+
+int file_has_been_checkpointed(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return 0;
+	}
+
+	/* check if the file has been checkpointed by any checkpoint worker */
+	struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!source_workers) {
+		return 0;
+	}
+
+	struct vine_worker_info *source_worker;
+	SET_ITERATE(source_workers, source_worker)
+	{
+		/* skip if not a checkpoint worker */
+		if (!is_checkpoint_worker(q, source_worker)) {
+			continue;
+		}
+		/* it is already checkpointed */
+		return 1;
+	}
+
+	return 0;
+}
+
+void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker)
+{
+	if (!q || !f || f->type != VINE_TEMP || !source_worker || !dest_worker) {
+		return;
+	}
+
+	char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
+	vine_manager_put_url_now(q, dest_worker, source_worker, source_addr, f);
+	free(source_addr);
+}
+
+int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return 0;
+	}
+
+	struct vine_worker_info *source_worker = get_best_source_worker(q, f);
+	if (!source_worker) {
+		return 0;
+	}
+
+	struct vine_worker_info *dest_worker = get_best_dest_worker(q, f);
+	if (!dest_worker) {
+		return 0;
+	}
+
+	vine_temp_start_peer_transfer(q, f, source_worker, dest_worker);
+
+	return 1;
+}
+
+int vine_temp_start_replication(struct vine_manager *q)
+{
+	if (!q) {
+		return 0;
+	}
+
+	int processed = 0;
+	int iter_count = 0;
+	int iter_depth = MIN(q->attempt_schedule_depth, priority_queue_size(q->temp_files_to_replicate));
+	struct list *skipped = list_create();
+
+	struct vine_file *f;
+	while ((f = priority_queue_pop(q->temp_files_to_replicate)) && (iter_count++ < iter_depth)) {
+		if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+			continue;
+		}
+
+		/* skip if the file has enough replicas or no replicas */
+		int current_replica_count = vine_file_replica_count(q, f);
+		if (current_replica_count >= q->temp_replica_count || current_replica_count == 0) {
+			continue;
+		}
+		/* skip if the file has no ready replicas */
+		int current_ready_replica_count = vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY);
+		if (current_ready_replica_count == 0) {
+			continue;
+		}
+
+		/* if reach here, it means the file needs to be replicated and there is at least one ready replica. */
+		if (!vine_temp_replicate_file_now(q, f)) {
+			list_push_tail(skipped, f);
+			continue;
+		}
+
+		processed++;
+
+		/* push back and keep evaluating the same file with a lower priority, until no more source
+		 * or destination workers are available, or the file has enough replicas. */
+		vine_temp_replicate_file_later(q, f);
+	}
+
+	while ((f = list_pop_head(skipped))) {
+		vine_temp_replicate_file_later(q, f);
+	}
+	list_delete(skipped);
+
+	return processed;
+}
+
+/*************************************************************/
+/* Public Functions */
+/*************************************************************/
+
+int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+		return 0;
+	}
+
+	int current_replica_count = vine_file_replica_count(q, f);
+	if (current_replica_count == 0 || current_replica_count >= q->temp_replica_count) {
+		return 0;
+	}
+
+	priority_queue_push(q->temp_files_to_replicate, f, -current_replica_count);
+
+	return 1;
+}
+
+int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
+{
+	if (!q || !cachename) {
+		return 0;
+	}
+
+	struct vine_file *f = hash_table_lookup(q->file_table, cachename);
+	if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+		return 0;
+	}
+
+	vine_temp_replicate_file_later(q, f);
+
+	return 1;
+}
+
+void vine_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy)
+{
+	if (!q) {
+		return;
+	}
+
+	switch (policy) {
+	case VINE_REPLICA_PLACEMENT_POLICY_RANDOM:
+		debug(D_VINE, "Setting replica placement policy to RANDOM");
+		q->replica_placement_policy = policy;
+		break;
+	case VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD:
+		debug(D_VINE, "Setting replica placement policy to DISK_LOAD");
+		q->replica_placement_policy = policy;
+		break;
+	case VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD:
+		q->replica_placement_policy = policy;
+		break;
+	default:
+		debug(D_ERROR, "Invalid replica placement policy: %d", policy);
+	}
+}
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
new file mode 100644
index 0000000000..8398fd26dd
--- /dev/null
+++ b/taskvine/src/manager/vine_temp.h
@@ -0,0 +1,16 @@
+#ifndef vine_temp_H
+#define vine_temp_H
+
+#include "vine_manager.h"
+
+int is_checkpoint_worker(struct vine_manager *q, struct vine_worker_info *w);
+int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f);
+int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
+int vine_temp_checkpoint_file_later(struct vine_manager *q, struct vine_file *f);
+int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename);
+int vine_temp_start_replication(struct vine_manager *q);
+int vine_temp_start_checkpointing(struct vine_manager *q);
+void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker);
+int file_has_been_checkpointed(struct vine_manager *q, struct vine_file *f);
+
+#endif
\ No newline at end of file

From 40e9679b3686cbdbc0fd3321b10fb3fd3de10e0f Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 16:09:33 -0400
Subject: [PATCH 022/113] vine: task graph executor in C

---
 poncho/src/poncho/library_network_code.py     |  2 +-
 .../ndcctools/taskvine/graph_definition.py    |  1 +
 .../ndcctools/taskvine/graph_executor.py      |  2 +-
 .../python3/ndcctools/taskvine/utils.py       | 12 ++++++
 taskvine/src/manager/vine_manager.c           |  1 -
 taskvine/src/manager/vine_task_graph.c        | 20 ++-------
 taskvine/src/manager/vine_task_node.c         | 41 ++++++++-----------
 taskvine/src/manager/vine_temp.c              | 26 ------------
 taskvine/src/manager/vine_temp.h              |  3 --
 9 files changed, 36 insertions(+), 72 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index 6f3e1db092..cbc88209ef 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -177,7 +177,7 @@ def start_function(in_pipe_fd, thread_limit=1):
                 infile_path = os.path.join(function_sandbox, "infile")
                 event = load_function_infile(infile_path)
             except Exception:
-                stdout_timed_message(f"TASK {function_id} error: can't load the arguments from {arg_infile}")
+                stdout_timed_message(f"TASK {function_id} error: can't load the arguments from {infile_path}")
                 return -1, function_id
             p = os.fork()
             if p == 0:
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
index b9db690ad2..1602621bbb 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
@@ -40,6 +40,7 @@ def dist_func(mode, low, high):
         return 0
 
     assert mode in ["uniform", "normal", "lognormal", "pareto", "mix"]
+
     # uniform distribution, flat spread
     def uniform_dist():
         return random.uniform(low, high)
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
index 7efca4a554..b32e10e328 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
@@ -124,7 +124,7 @@ def _create_library_task(self, libcores=1, hoisting_modules=[], libtask_env_file
             compute_single_key,
             library_context_info=[init_task_graph_context, [], {"task_graph_path": self.task_graph_pkl_file_remote_path}],
             add_env=False,
-            infile_load_mode="text",
+            function_infile_load_mode="json",
             hoisting_modules=hoisting_modules
         )
         self.libtask.add_input(self.declare_file(self.task_graph_pkl_file_local_path), self.task_graph_pkl_file_remote_path)
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index b54d9c7bf4..4ced92406a 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -37,4 +37,16 @@ def load_variable_from_library(var_name):
     return globals()[var_name]
 
 
+# helper function that deletes all files in a directory
+def delete_all_files(root_dir):
+    if not os.path.exists(root_dir):
+        return
+    for dirpath, dirnames, filenames in os.walk(root_dir):
+        for filename in filenames:
+            file_path = os.path.join(dirpath, filename)
+            try:
+                os.remove(file_path)
+            except FileNotFoundError:
+                print(f"Failed to delete file {file_path}")
+
 # vim: set sts=4 sw=4 ts=4 expandtab ft=python:
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 07bdb9a5a1..4e46bcf232 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -4377,7 +4377,6 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->shutting_down = 0;
 	vine_set_replica_placement_policy(q, VINE_REPLICA_PLACEMENT_POLICY_RANDOM);
 
-
 	if ((envstring = getenv("VINE_BANDWIDTH"))) {
 		q->bandwidth_limit = string_metric_parse(envstring);
 		if (q->bandwidth_limit < 0) {
diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
index 0ae4e0f052..592bd069b2 100644
--- a/taskvine/src/manager/vine_task_graph.c
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -242,20 +242,6 @@ static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struc
 	return NULL;
 }
 
-static void handle_checkpoint_worker_stagein(struct vine_task_graph *tg, struct vine_file *f)
-{
-	if (!tg || !f) {
-		return;
-	}
-
-	struct vine_task_node *this_node = hash_table_lookup(tg->outfile_cachename_to_node, f->cached_name);
-	if (!this_node) {
-		return;
-	}
-
-	vine_task_node_prune_ancestors(this_node);
-}
-
 /*************************************************************/
 /* Public APIs */
 /*************************************************************/
@@ -390,10 +376,10 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 			if (regular_tasks_part->current == 0) {
 				progress_bar_set_start_time(pbar, task->time_when_commit_start);
 			}
-			
+
 			/* update critical time */
 			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
-			
+
 			/* mark this regular task as completed */
 			progress_bar_update_part(pbar, regular_tasks_part, 1);
 
@@ -406,7 +392,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 				}
 			}
 
-			/* enqueue the output file for replication or checkpointing */
+			/* enqueue the output file for replication */
 			switch (node->outfile_type) {
 			case VINE_NODE_OUTFILE_TYPE_TEMP:
 				vine_task_node_replicate_outfile(node);
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index ae99004ba8..5a3145548d 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -3,6 +3,8 @@
 #include "vine_task.h"
 #include "vine_file.h"
 #include "vine_task_graph.h"
+#include "jx.h"
+#include "jx_print.h"
 #include "xxmalloc.h"
 #include "stringtools.h"
 #include "taskvine.h"
@@ -81,8 +83,16 @@ struct vine_task_node *vine_task_node_create(
 	vine_task_set_library_required(node->task, library_name);
 	vine_task_addref(node->task);
 
-	/* add the infile as the key of the graph to compute */
-	char *infile_content = string_format("%s", node->node_key);
+	/* build JSON infile expected by library: {"fn_args": [key], "fn_kwargs": {}} */
+	struct jx *event = jx_object(NULL);
+	struct jx *args = jx_array(NULL);
+	jx_array_append(args, jx_string(node->node_key));
+	jx_insert(event, jx_string("fn_args"), args);
+	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
+
+	char *infile_content = jx_print_string(event);
+	jx_delete(event);
+
 	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
 	free(infile_content);
 	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
@@ -137,22 +147,16 @@ static int _node_outfile_is_persisted(struct vine_task_node *node)
 		return 0;
 	}
 
-	/* if the outfile pointer is NULL, it means the node is producing a shared file system file */
-	if (!node->outfile) {
+	switch (node->outfile_type) {
+	case VINE_NODE_OUTFILE_TYPE_LOCAL:
 		return 1;
-	}
-
-	switch (node->outfile->type) {
-	case VINE_FILE:
+	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
 		return 1;
-	case VINE_TEMP:
-		/* check if this file is in the any of the checkpoint workers */
-		return file_has_been_checkpointed(node->manager, node->outfile);
-	default:
-		/* not supported at the moment */
-		debug(D_ERROR, "unsupported outfile type: %d", node->outfile->type);
+	case VINE_NODE_OUTFILE_TYPE_TEMP:
 		return 0;
 	}
+
+	return 0;
 }
 
 double vine_task_node_calculate_priority(struct vine_task_node *node)
@@ -555,15 +559,6 @@ void vine_task_node_replicate_outfile(struct vine_task_node *node)
 	vine_temp_replicate_file_later(node->manager, node->outfile);
 }
 
-void vine_task_node_checkpoint_outfile(struct vine_task_node *node)
-{
-	if (!node || !node->outfile) {
-		return;
-	}
-
-	vine_temp_checkpoint_file_later(node->manager, node->outfile);
-}
-
 int vine_task_node_set_outfile_size_bytes(struct vine_task_node *node, size_t outfile_size_bytes)
 {
 	if (!node || !node->outfile) {
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index 914de9a893..4d94326d38 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -121,32 +121,6 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 	return best_destination;
 }
 
-int file_has_been_checkpointed(struct vine_manager *q, struct vine_file *f)
-{
-	if (!q || !f || f->type != VINE_TEMP) {
-		return 0;
-	}
-
-	/* check if the file has been checkpointed by any checkpoint worker */
-	struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
-	if (!source_workers) {
-		return 0;
-	}
-
-	struct vine_worker_info *source_worker;
-	SET_ITERATE(source_workers, source_worker)
-	{
-		/* skip if not a checkpoint worker */
-		if (!is_checkpoint_worker(q, source_worker)) {
-			continue;
-		}
-		/* it is already checkpointed */
-		return 1;
-	}
-
-	return 0;
-}
-
 void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker)
 {
 	if (!q || !f || f->type != VINE_TEMP || !source_worker || !dest_worker) {
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
index 8398fd26dd..d9e4d6b428 100644
--- a/taskvine/src/manager/vine_temp.h
+++ b/taskvine/src/manager/vine_temp.h
@@ -6,11 +6,8 @@
 int is_checkpoint_worker(struct vine_manager *q, struct vine_worker_info *w);
 int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f);
 int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
-int vine_temp_checkpoint_file_later(struct vine_manager *q, struct vine_file *f);
 int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename);
 int vine_temp_start_replication(struct vine_manager *q);
-int vine_temp_start_checkpointing(struct vine_manager *q);
 void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker);
-int file_has_been_checkpointed(struct vine_manager *q, struct vine_file *f);
 
 #endif
\ No newline at end of file

From 21b25a4c04a6e9aee223b5081d3037d2254447e9 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 16:14:11 -0400
Subject: [PATCH 023/113] simple fix

---
 taskvine/src/manager/vine_task_node.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index 5a3145548d..569e1db095 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -113,12 +113,13 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 
 	/* create the output file */
 	switch (node->outfile_type) {
-	case VINE_NODE_OUTFILE_TYPE_LOCAL:
+	case VINE_NODE_OUTFILE_TYPE_LOCAL: {
 		char *persistent_path = string_format("%s/outputs/%s", node->staging_dir, node->outfile_remote_name);
 		node->outfile = vine_declare_file(node->manager, persistent_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
 		free(persistent_path);
 		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_LOCAL, outfile = %s", node->node_key, node->outfile->cached_name);
 		break;
+    }
 	case VINE_NODE_OUTFILE_TYPE_TEMP:
 		node->outfile = vine_declare_temp(node->manager);
 		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_TEMP, outfile = %s", node->node_key, node->outfile->cached_name);
@@ -432,7 +433,7 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 			timestamp_t start_time = timestamp_get();
 			unlink(ancestor_node->outfile_remote_name);
 			node->time_spent_on_unlink_local_files += timestamp_get() - start_time;
-			debug(D_VINE, "unlinked %s size: %ld bytes, time: %ld", ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
+			debug(D_VINE, "unlinked %s size: %ld bytes, time: %llu", ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:

From 648071fe91921af53c356c5702f3efbcdb5c4f9b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 16:17:52 -0400
Subject: [PATCH 024/113] braces in block

---
 taskvine/src/manager/vine_task_graph.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
index 592bd069b2..0e37061ebe 100644
--- a/taskvine/src/manager/vine_task_graph.c
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -342,7 +342,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 
 			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
 			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
 				struct stat info;
 				int result = stat(node->outfile_remote_name, &info);
 				if (result < 0) {
@@ -353,6 +353,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 				}
 				node->outfile_size_bytes = info.st_size;
 				break;
+            }
 			case VINE_NODE_OUTFILE_TYPE_LOCAL:
 			case VINE_NODE_OUTFILE_TYPE_TEMP:
 				node->outfile_size_bytes = node->outfile->size;

From 824213656d039eee7ce862a243b776ff3b6fdc7a Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 16:19:26 -0400
Subject: [PATCH 025/113] type fix

---
 taskvine/src/manager/vine_task_node.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index 569e1db095..cb5342dc67 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -433,7 +433,7 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 			timestamp_t start_time = timestamp_get();
 			unlink(ancestor_node->outfile_remote_name);
 			node->time_spent_on_unlink_local_files += timestamp_get() - start_time;
-			debug(D_VINE, "unlinked %s size: %ld bytes, time: %llu", ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
+			debug(D_VINE, "unlinked %s size: %ld bytes, time: %lu", ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:

From c841f6cb013e507906d312d188ad0564dd3804a4 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 16:25:56 -0400
Subject: [PATCH 026/113] type fix

---
 taskvine/src/manager/vine_task_node.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index cb5342dc67..fce542f585 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -18,6 +18,8 @@
 #include "vine_temp.h"
 #include "random.h"
 
+#include <inttypes.h>
+
 double compute_lex_priority(const char *key)
 {
 	double score = 0.0;
@@ -433,7 +435,7 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 			timestamp_t start_time = timestamp_get();
 			unlink(ancestor_node->outfile_remote_name);
 			node->time_spent_on_unlink_local_files += timestamp_get() - start_time;
-			debug(D_VINE, "unlinked %s size: %ld bytes, time: %lu", ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
+			debug(D_VINE, "unlinked %s size: %ld bytes, time: %" PRIu64, ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, (uint64_t) node->time_spent_on_unlink_local_files);
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:

From 39168ef708115a1b9e0e21512cf364065ab9dec6 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 16:30:54 -0400
Subject: [PATCH 027/113] lint

---
 taskvine/src/manager/vine_task_graph.c | 2 +-
 taskvine/src/manager/vine_task_node.c  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
index 0e37061ebe..1c0ec8bfbe 100644
--- a/taskvine/src/manager/vine_task_graph.c
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -353,7 +353,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 				}
 				node->outfile_size_bytes = info.st_size;
 				break;
-            }
+			}
 			case VINE_NODE_OUTFILE_TYPE_LOCAL:
 			case VINE_NODE_OUTFILE_TYPE_TEMP:
 				node->outfile_size_bytes = node->outfile->size;
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index fce542f585..8bb01eacb9 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -121,7 +121,7 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 		free(persistent_path);
 		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_LOCAL, outfile = %s", node->node_key, node->outfile->cached_name);
 		break;
-    }
+	}
 	case VINE_NODE_OUTFILE_TYPE_TEMP:
 		node->outfile = vine_declare_temp(node->manager);
 		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_TEMP, outfile = %s", node->node_key, node->outfile->cached_name);
@@ -435,7 +435,7 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 			timestamp_t start_time = timestamp_get();
 			unlink(ancestor_node->outfile_remote_name);
 			node->time_spent_on_unlink_local_files += timestamp_get() - start_time;
-			debug(D_VINE, "unlinked %s size: %ld bytes, time: %" PRIu64, ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, (uint64_t) node->time_spent_on_unlink_local_files);
+			debug(D_VINE, "unlinked %s size: %ld bytes, time: %" PRIu64, ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, (uint64_t)node->time_spent_on_unlink_local_files);
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:

From e8c23e6c9155a8bf2fba12ead9445220fcc8c330 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 22:50:54 -0400
Subject: [PATCH 028/113] some fixes

---
 taskvine/src/manager/vine_task_graph.c |  2 +-
 taskvine/src/manager/vine_task_node.c  | 47 +++++++++++++++++++-------
 2 files changed, 36 insertions(+), 13 deletions(-)

diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
index 1c0ec8bfbe..c6fdcb24b6 100644
--- a/taskvine/src/manager/vine_task_graph.c
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -359,7 +359,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 				node->outfile_size_bytes = node->outfile->size;
 				break;
 			}
-			debug(D_VINE, "Node %s completed with outfile %s size: %ld bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
+			debug(D_VINE, "Node %s completed with outfile %s size: %zu bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
 
 			/* mark the node as completed */
 			node->completed = 1;
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index 8bb01eacb9..983a3cc09b 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -11,7 +11,6 @@
 #include "timestamp.h"
 #include "set.h"
 #include "hash_table.h"
-#include "unistd.h"
 #include "debug.h"
 #include "assert.h"
 #include "vine_worker_info.h"
@@ -19,6 +18,11 @@
 #include "random.h"
 
 #include <inttypes.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <sys/types.h>
+#include <sys/stat.h>
 
 double compute_lex_priority(const char *key)
 {
@@ -53,7 +57,7 @@ struct vine_task_node *vine_task_node_create(
 
 	node->manager = manager;
 	node->node_key = xxstrdup(node_key);
-	node->staging_dir = xxstrdup(staging_dir);
+	
 	node->priority_mode = priority_mode;
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
 	node->parents = list_create();
@@ -116,9 +120,12 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 	/* create the output file */
 	switch (node->outfile_type) {
 	case VINE_NODE_OUTFILE_TYPE_LOCAL: {
-		char *persistent_path = string_format("%s/outputs/%s", node->staging_dir, node->outfile_remote_name);
-		node->outfile = vine_declare_file(node->manager, persistent_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
-		free(persistent_path);
+		char *local_output_dir = string_format("%s/outputs", node->staging_dir);
+        mkdir(local_output_dir, 0777);  // ignore errors if exists
+        char *local_output_path = string_format("%s/%s", local_output_dir, node->outfile_remote_name);
+		node->outfile = vine_declare_file(node->manager, local_output_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
+		free(local_output_dir);
+		free(local_output_path);
 		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_LOCAL, outfile = %s", node->node_key, node->outfile->cached_name);
 		break;
 	}
@@ -259,6 +266,7 @@ static void _find_parents_dfs(struct vine_task_node *node, int remaining_depth,
 	if (!node || set_lookup(visited, node)) {
 		return;
 	}
+
 	set_insert(visited, node);
 	if (remaining_depth == 0) {
 		list_push_tail(result, node);
@@ -277,7 +285,9 @@ static struct list *_find_parents_in_depth(struct vine_task_node *node, int dept
 	if (!node || depth < 0) {
 		return NULL;
 	}
+
 	struct list *result = list_create();
+
 	struct set *visited = set_create(0);
 	_find_parents_dfs(node, depth, result, visited);
 	set_delete(visited);
@@ -432,10 +442,12 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 	{
 		/* unlink the shared file system file */
 		if (!ancestor_node->outfile) {
-			timestamp_t start_time = timestamp_get();
-			unlink(ancestor_node->outfile_remote_name);
-			node->time_spent_on_unlink_local_files += timestamp_get() - start_time;
-			debug(D_VINE, "unlinked %s size: %ld bytes, time: %" PRIu64, ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, (uint64_t)node->time_spent_on_unlink_local_files);
+			timestamp_t unlink_start  = timestamp_get();
+            if (ancestor_node->outfile_remote_name) {
+                unlink(ancestor_node->outfile_remote_name);   // system call
+            }
+			node->time_spent_on_unlink_local_files += timestamp_get() - unlink_start;
+			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64, ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:
@@ -483,7 +495,9 @@ void vine_task_node_print_info(struct vine_task_node *node)
 
 	debug(D_VINE, "node info %s task_id: %d", node->node_key, node->task->task_id);
 	debug(D_VINE, "node info %s depth: %d", node->node_key, node->depth);
-	debug(D_VINE, "node info %s outfile remote name: %s", node->node_key, node->outfile_remote_name);
+    if (node->outfile_remote_name) {
+        debug(D_VINE, "node info %s outfile remote name: %s", node->node_key, node->outfile_remote_name);
+    }
 
 	if (node->outfile) {
 		switch (node->outfile->type) {
@@ -511,8 +525,9 @@ void vine_task_node_print_info(struct vine_task_node *node)
 			parent_keys = tmp;
 		}
 	}
-	debug(D_VINE, "node info %s parents: %s", node->node_key, parent_keys);
+	debug(D_VINE, "node info %s parents: %s", node->node_key, parent_keys ? parent_keys : "(none)");
 	free(parent_keys);
+    parent_keys = NULL;
 
 	char *child_keys = NULL;
 	struct vine_task_node *child_node;
@@ -526,8 +541,9 @@ void vine_task_node_print_info(struct vine_task_node *node)
 			child_keys = tmp;
 		}
 	}
-	debug(D_VINE, "node info %s children: %s", node->node_key, child_keys);
+	debug(D_VINE, "node info %s children: %s", node->node_key, child_keys ? child_keys : "(none)");
 	free(child_keys);
+    child_keys = NULL;
 
 	return;
 }
@@ -559,6 +575,10 @@ void vine_task_node_replicate_outfile(struct vine_task_node *node)
 		return;
 	}
 
+    if (node->outfile->type != VINE_TEMP) {
+        return;
+    }
+
 	vine_temp_replicate_file_later(node->manager, node->outfile);
 }
 
@@ -586,6 +606,9 @@ void vine_task_node_delete(struct vine_task_node *node)
 	if (node->outfile_remote_name) {
 		free(node->outfile_remote_name);
 	}
+    if (node->staging_dir) {
+        free(node->staging_dir);
+    }
 
 	vine_task_delete(node->task);
 	node->task = NULL;

From ef0e8a2af0442abfbde681ca2e5822d04771c872 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 14 Oct 2025 23:06:16 -0400
Subject: [PATCH 029/113] bug

---
 taskvine/src/manager/taskvine.h       |  3 +-
 taskvine/src/manager/vine_manager.c   | 11 ++++--
 taskvine/src/manager/vine_task_node.c | 55 ++++++---------------------
 taskvine/src/manager/vine_task_node.h |  1 -
 taskvine/src/manager/vine_temp.c      | 13 -------
 taskvine/src/manager/vine_temp.h      |  1 -
 6 files changed, 22 insertions(+), 62 deletions(-)

diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index 9e1d9b7da3..4ea0258407 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -954,8 +954,9 @@ The given file or directory object is deleted from all worker's caches,
 but is still available on the manager's site, and can be recovered by submitting a recovery task.
 @param m A manager object
 @param f Any file object.
+@return The number of replicas pruned.
 */
-void vine_prune_file(struct vine_manager *m, struct vine_file *f);
+int vine_prune_file(struct vine_manager *m, struct vine_file *f);
 
 //@}
 
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 4e46bcf232..3ff5965403 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -6600,16 +6600,18 @@ Should be invoked by the application when a file will never
 be needed again, to free up available space.
 */
 
-void vine_prune_file(struct vine_manager *m, struct vine_file *f)
+int vine_prune_file(struct vine_manager *m, struct vine_file *f)
 {
 	if (!f) {
-		return;
+		return 0;
 	}
 
 	if (!m) {
-		return;
+		return 0;
 	}
 
+	int pruned_replica_count = 0;
+
 	/* delete all of the replicas present at remote workers. */
 	struct set *source_workers = hash_table_lookup(m->file_worker_table, f->cached_name);
 	if (source_workers && set_size(source_workers) > 0) {
@@ -6618,10 +6620,13 @@ void vine_prune_file(struct vine_manager *m, struct vine_file *f)
 			for (int i = 0; workers_array[i] != NULL; i++) {
 				struct vine_worker_info *w = (struct vine_worker_info *)workers_array[i];
 				delete_worker_file(m, w, f->cached_name, 0, 0);
+				pruned_replica_count++;
 			}
 			set_free_values_array(workers_array);
 		}
 	}
+
+	return pruned_replica_count;
 }
 
 /*
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index 983a3cc09b..4970b70410 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -21,6 +21,7 @@
 #include <stdlib.h>
 #include <unistd.h>
 #include <string.h>
+#include <errno.h>
 #include <sys/types.h>
 #include <sys/stat.h>
 
@@ -29,7 +30,7 @@ double compute_lex_priority(const char *key)
 	double score = 0.0;
 	double factor = 1.0;
 	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
-		score += key[i] * factor;
+		score += (unsigned char)key[i] * factor;
 		factor *= 0.01;
 	}
 	return -score;
@@ -57,6 +58,7 @@ struct vine_task_node *vine_task_node_create(
 
 	node->manager = manager;
 	node->node_key = xxstrdup(node_key);
+    node->staging_dir = xxstrdup(staging_dir);
 	
 	node->priority_mode = priority_mode;
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
@@ -66,8 +68,8 @@ struct vine_task_node *vine_task_node_create(
 	node->completed = 0;
 	node->prune_depth = prune_depth;
 	node->retry_attempts_left = 1;
+    node->outfile_size_bytes = 0;
 
-	node->outfile_size_bytes = 0;
 	node->depth = -1;
 	node->height = -1;
 	node->upstream_subgraph_size = -1;
@@ -121,7 +123,9 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 	switch (node->outfile_type) {
 	case VINE_NODE_OUTFILE_TYPE_LOCAL: {
 		char *local_output_dir = string_format("%s/outputs", node->staging_dir);
-        mkdir(local_output_dir, 0777);  // ignore errors if exists
+        if (mkdir(local_output_dir, 0777) != 0 && errno != EEXIST) {
+            debug(D_ERROR, "failed to mkdir %s (errno=%d)", local_output_dir, errno);
+        }
         char *local_output_path = string_format("%s/%s", local_output_dir, node->outfile_remote_name);
 		node->outfile = vine_declare_file(node->manager, local_output_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
 		free(local_output_dir);
@@ -233,33 +237,6 @@ void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_
 	node->critical_time = max_parent_critical_time + execution_time;
 }
 
-/* delete all of the replicas present at remote workers. */
-int _prune_outfile_from_regular_workers(struct vine_task_node *node)
-{
-	if (!node || !node->outfile) {
-		return 0;
-	}
-
-	struct set *source_workers = hash_table_lookup(node->manager->file_worker_table, node->outfile->cached_name);
-	if (!source_workers) {
-		return 0;
-	}
-
-	int pruned_replica_count = 0;
-
-	struct vine_worker_info *source_worker;
-	SET_ITERATE(source_workers, source_worker)
-	{
-		if (is_checkpoint_worker(node->manager, source_worker)) {
-			continue;
-		}
-		delete_worker_file(node->manager, source_worker, node->outfile->cached_name, 0, 0);
-		pruned_replica_count++;
-	}
-
-	return pruned_replica_count;
-}
-
 /* the dfs helper function for finding parents in a specific depth */
 static void _find_parents_dfs(struct vine_task_node *node, int remaining_depth, struct list *result, struct set *visited)
 {
@@ -344,7 +321,7 @@ int _prune_ancestors_of_temp_node(struct vine_task_node *node)
 			continue;
 		}
 
-		pruned_replica_count += _prune_outfile_from_regular_workers(parent_node);
+		pruned_replica_count += vine_prune_file(node->manager, parent_node->outfile);
 		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
 		 * manager may submit a recovery task to bring it back in case of worker failures. */
 		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
@@ -447,7 +424,10 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
                 unlink(ancestor_node->outfile_remote_name);   // system call
             }
 			node->time_spent_on_unlink_local_files += timestamp_get() - unlink_start;
-			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64, ancestor_node->outfile_remote_name, ancestor_node->outfile_size_bytes, node->time_spent_on_unlink_local_files);
+			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64,
+                    ancestor_node->outfile_remote_name ? ancestor_node->outfile_remote_name : "(null)",
+                    ancestor_node->outfile_size_bytes,
+                    (uint64_t)node->time_spent_on_unlink_local_files);          
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:
@@ -582,17 +562,6 @@ void vine_task_node_replicate_outfile(struct vine_task_node *node)
 	vine_temp_replicate_file_later(node->manager, node->outfile);
 }
 
-int vine_task_node_set_outfile_size_bytes(struct vine_task_node *node, size_t outfile_size_bytes)
-{
-	if (!node || !node->outfile) {
-		return -1;
-	}
-
-	node->outfile_size_bytes = outfile_size_bytes;
-
-	return 0;
-}
-
 /* delete the node and all of its associated resources. */
 void vine_task_node_delete(struct vine_task_node *node)
 {
diff --git a/taskvine/src/manager/vine_task_node.h b/taskvine/src/manager/vine_task_node.h
index 13486e12c0..b480acfc7a 100644
--- a/taskvine/src/manager/vine_task_node.h
+++ b/taskvine/src/manager/vine_task_node.h
@@ -70,7 +70,6 @@ void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_
 void vine_task_node_replicate_outfile(struct vine_task_node *node);
 int vine_task_node_submit(struct vine_task_node *node);
 void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
-int vine_task_node_set_outfile_size_bytes(struct vine_task_node *node, size_t outfile_size_bytes);
 void vine_task_node_checkpoint_outfile(struct vine_task_node *node);
 
 #endif
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index 4d94326d38..12be13a26c 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -15,15 +15,6 @@
 /* Private Functions */
 /*************************************************************/
 
-int is_checkpoint_worker(struct vine_manager *q, struct vine_worker_info *w)
-{
-	if (!q || !w || !w->features) {
-		return 0;
-	}
-
-	return hash_table_lookup(w->features, "checkpoint-worker") != NULL;
-}
-
 static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP) {
@@ -86,10 +77,6 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 		if (w->incoming_xfer_counter >= q->worker_source_max_transfers) {
 			continue;
 		}
-		/* skip if the worker is a checkpoint worker */
-		if (is_checkpoint_worker(q, w)) {
-			continue;
-		}
 		/* skip if the worker already has this file */
 		struct vine_file_replica *replica = vine_file_replica_table_lookup(w, f->cached_name);
 		if (replica) {
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
index d9e4d6b428..ff2efb5011 100644
--- a/taskvine/src/manager/vine_temp.h
+++ b/taskvine/src/manager/vine_temp.h
@@ -3,7 +3,6 @@
 
 #include "vine_manager.h"
 
-int is_checkpoint_worker(struct vine_manager *q, struct vine_worker_info *w);
 int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f);
 int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
 int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename);

From 6b527b192f145019fc2d050b5f11dadb4a504a6d Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 15 Oct 2025 10:59:25 -0400
Subject: [PATCH 030/113] use proxy function and library

---
 .../ndcctools/taskvine/graph_executor.py      |   8 +-
 taskvine/src/manager/taskvine.h               |   6 +-
 taskvine/src/manager/vine_task_graph.c        | 124 ++++++++++++----
 taskvine/src/manager/vine_task_graph.h        |   4 +-
 taskvine/src/manager/vine_task_node.c         | 138 +++++++++---------
 taskvine/src/manager/vine_task_node.h         |   4 +-
 6 files changed, 179 insertions(+), 105 deletions(-)

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
index b32e10e328..5d7137f25b 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
@@ -109,7 +109,7 @@ def __init__(self,
         self._create_library_task(libcores, hoisting_modules, libtask_env_files)
 
     def _create_library_task(self, libcores=1, hoisting_modules=[], libtask_env_files={}):
-        assert cvine.vine_task_graph_get_function_name(self._vine_task_graph) == compute_single_key.__name__
+        assert cvine.vine_task_graph_get_proxy_function_name(self._vine_task_graph) == compute_single_key.__name__
 
         self.task_graph_pkl_file_name = f"library-task-graph-{uuid.uuid4()}.pkl"
         self.task_graph_pkl_file_local_path = self.task_graph_pkl_file_name
@@ -120,7 +120,7 @@ def _create_library_task(self, libcores=1, hoisting_modules=[], libtask_env_file
         if dask:
             hoisting_modules += [dask]
         self.libtask = self.create_library_from_functions(
-            cvine.vine_task_graph_get_library_name(self._vine_task_graph),
+            cvine.vine_task_graph_get_proxy_library_name(self._vine_task_graph),
             compute_single_key,
             library_context_info=[init_task_graph_context, [], {"task_graph_path": self.task_graph_pkl_file_remote_path}],
             add_env=False,
@@ -194,7 +194,7 @@ def run(self,
 
         # we must finalize the graph in c side after all nodes and dependencies are added
         # this includes computing various metrics for each node, such as depth, height, heavy score, etc.
-        cvine.vine_task_graph_finalize_metrics(self._vine_task_graph)
+        cvine.vine_task_graph_compute_topology_metrics(self._vine_task_graph)
 
         # then we can use the heavy score to sort the nodes and specify their outfile remote names
         heavy_scores = {}
@@ -212,7 +212,9 @@ def run(self,
                     choice = "shared-file-system"
                 else:
                     choice = "temp"
+            # set on the Python side, will be installed on the remote workers
             self.task_graph.set_outfile_type_of(k, choice)
+            # set on the C side, so the manager knows where the data is stored
             outfile_type_str = f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}"
             cvine.vine_task_graph_set_node_outfile(self._vine_task_graph,
                                                    self.task_graph.vine_key_of[k],
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index 4ea0258407..ce4311d73d 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -1639,19 +1639,19 @@ void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *no
 /** Finalize the metrics of the task graph.
 @param tg Reference to the task graph object.
 */
-void vine_task_graph_finalize_metrics(struct vine_task_graph *tg);
+void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
 
 /** Get the library name of the task graph.
 @param tg Reference to the task graph object.
 @return The library name.
 */
-const char *vine_task_graph_get_library_name(const struct vine_task_graph *tg);
+const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg);
 
 /** Get the function name of the task graph.
 @param tg Reference to the task graph object.
 @return The function name.
 */
-const char *vine_task_graph_get_function_name(const struct vine_task_graph *tg);
+const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
 
 /** Get the heavy score of a node in the task graph.
 @param tg Reference to the task graph object.
diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
index c6fdcb24b6..5d5c75b910 100644
--- a/taskvine/src/manager/vine_task_graph.c
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -1,6 +1,7 @@
 #include "vine_task_graph.h"
 #include "taskvine.h"
 #include "vine_manager.h"
+#include "vine_task_node.h"
 #include "vine_worker_info.h"
 #include "priority_queue.h"
 #include <stdlib.h>
@@ -9,7 +10,6 @@
 #include "debug.h"
 #include "stringtools.h"
 #include "xxmalloc.h"
-#include "priority_queue.h"
 #include <math.h>
 #include "hash_table.h"
 #include <sys/stat.h>
@@ -46,13 +46,6 @@ static void submit_node_task(struct vine_task_graph *tg, struct vine_task_node *
 	int task_id = vine_task_node_submit(node);
 	itable_insert(tg->task_id_to_node, task_id, node);
 
-	node->retry_attempts_left--;
-	if (node->retry_attempts_left < 0) {
-		debug(D_ERROR, "Aborting, node %s has exhausted all retry attempts", node->node_key);
-		vine_task_graph_delete(tg);
-		exit(1);
-	}
-
 	return;
 }
 
@@ -68,8 +61,11 @@ static void submit_node_ready_children(struct vine_task_graph *tg, struct vine_t
 		/* Remove this parent from the child's pending set if it exists */
 		if (child_node->pending_parents) {
 			/* Assert that this parent is indeed pending for the child */
-			assert(set_lookup(child_node->pending_parents, node));
-			set_remove(child_node->pending_parents, node);
+			if (child_node->pending_parents && set_lookup(child_node->pending_parents, node)) {
+				set_remove(child_node->pending_parents, node);
+			} else {
+				debug(D_ERROR, "inconsistent pending set: child=%s missing parent=%s", child_node->node_key, node->node_key);
+			}
 		}
 
 		/* If no more parents are pending, submit the child */
@@ -141,6 +137,8 @@ static struct list *get_topological_order(struct vine_task_graph *tg)
 		}
 
 		list_delete(topo_order);
+		hash_table_delete(in_degree_map);
+		priority_queue_delete(pq);
 		exit(1);
 	}
 
@@ -251,9 +249,19 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 	if (!tg) {
 		return;
 	}
-
+	
+	debug(D_VINE, "start executing task graph");
+	
+	/* print the info of all nodes */
 	char *node_key;
 	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		vine_task_node_print_info(node);
+	}
+	
+	/* enable return recovery tasks */
+	vine_enable_return_recovery_tasks(tg->manager);
 
 	/* create mapping from task_id and outfile cached_name to node */
 	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
@@ -289,9 +297,6 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 		}
 	}
 
-	/* enable return recovery tasks */
-	vine_enable_return_recovery_tasks(tg->manager);
-
 	/* enqueue those without dependencies */
 	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
 	{
@@ -334,7 +339,15 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 
 			/* in case of failure, resubmit this task */
 			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
-				debug(D_VINE | D_NOTICE, "Task %d failed with result %d and exit code %d, resubmitting...", task->task_id, node->task->result, node->task->exit_code);
+				if (node->retry_attempts_left <= 0) {
+					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %s has no retries left. Aborting.",
+						  task->task_id, node->task->result, node->task->exit_code, node->node_key);
+					vine_task_graph_delete(tg);
+					exit(1);
+				}
+				node->retry_attempts_left--;
+				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %s (remaining=%d)...",
+					  task->task_id, node->task->result, node->task->exit_code, node->node_key, node->retry_attempts_left);
 				vine_task_reset(node->task);
 				submit_node_task(tg, node);
 				continue;
@@ -346,7 +359,15 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 				struct stat info;
 				int result = stat(node->outfile_remote_name, &info);
 				if (result < 0) {
-					debug(D_VINE | D_NOTICE, "Task %d succeeded but output file %s does not exist on the shared file system", task->task_id, node->outfile_remote_name);
+					if (node->retry_attempts_left <= 0) {
+						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %s. Aborting.",
+							  task->task_id, node->outfile_remote_name, node->node_key);
+						vine_task_graph_delete(tg);
+						exit(1);
+					}
+					node->retry_attempts_left--;
+					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %s (remaining=%d)...",
+						  task->task_id, node->outfile_remote_name, node->node_key, node->retry_attempts_left);
 					vine_task_reset(node->task);
 					submit_node_task(tg, node);
 					continue;
@@ -407,7 +428,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 			submit_node_ready_children(tg, node);
 		} else {
 			wait_timeout = 2;
-			progress_bar_update_part(pbar, recovery_tasks_part, 0);
+			progress_bar_update_part(pbar, recovery_tasks_part, 0);  // refresh the time and total for recovery tasks
 		}
 	}
 
@@ -434,7 +455,7 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 	return;
 }
 
-void vine_task_graph_finalize_metrics(struct vine_task_graph *tg)
+void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
 {
 	if (!tg) {
 		return;
@@ -531,6 +552,7 @@ void vine_task_graph_finalize_metrics(struct vine_task_graph *tg)
 	LIST_ITERATE(weakly_connected_components, component)
 	{
 		debug(D_VINE, "component %d size: %d\n", component_index, list_size(component));
+		list_delete(component);
 		component_index++;
 	}
 	list_delete(weakly_connected_components);
@@ -547,8 +569,8 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	tg->task_id_to_node = itable_create(0);
 	tg->outfile_cachename_to_node = hash_table_create(0, 0);
 
-	tg->library_name = xxstrdup("vine_task_graph_library");
-	tg->function_name = xxstrdup("compute_single_key");
+	tg->proxy_library_name = xxstrdup("vine_task_graph_library");
+	tg->proxy_function_name = xxstrdup("compute_single_key");
 	tg->manager = q;
 
 	tg->failure_injection_step_percent = -1.0;
@@ -593,8 +615,8 @@ struct vine_task_node *vine_task_graph_create_node(
 	if (!node) {
 		node = vine_task_node_create(tg->manager,
 				node_key,
-				tg->library_name,
-				tg->function_name,
+				tg->proxy_library_name,
+				tg->proxy_function_name,
 				staging_dir,
 				prune_depth,
 				priority_mode);
@@ -604,6 +626,13 @@ struct vine_task_node *vine_task_graph_create_node(
 	return node;
 }
 
+/**
+ * Add a dependency between two nodes in the task graph. Note that the input-output file relationship
+ * is not handled here, because their file names may have not been determined yet.
+ * @param tg Reference to the task graph object.
+ * @param parent_key Reference to the parent node key.
+ * @param child_key Reference to the child node key.
+ */
 void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key)
 {
 	if (!tg || !parent_key || !child_key) {
@@ -623,25 +652,44 @@ void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *pare
 
 	list_push_tail(child_node->parents, parent_node);
 	list_push_tail(parent_node->children, child_node);
-	debug(D_VINE, "added dependency: %s -> %s", parent_key, child_key);
+
+	return;
 }
 
-const char *vine_task_graph_get_library_name(const struct vine_task_graph *tg)
+/**
+ * Get the library name of the task graph.
+ * @param tg Reference to the task graph object.
+ * @return The library name.
+ */
+const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg)
 {
 	if (!tg) {
 		return NULL;
 	}
-	return tg->library_name;
+
+	return tg->proxy_library_name;
 }
 
-const char *vine_task_graph_get_function_name(const struct vine_task_graph *tg)
+/**
+ * Get the function name of the task graph.
+ * @param tg Reference to the task graph object.
+ * @return The function name.
+ */
+const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg)
 {
 	if (!tg) {
 		return NULL;
 	}
-	return tg->function_name;
+
+	return tg->proxy_function_name;
 }
 
+/**
+ * Get the heavy score of a node in the task graph.
+ * @param tg Reference to the task graph object.
+ * @param node_key Reference to the node key.
+ * @return The heavy score.
+ */
 double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key)
 {
 	if (!tg) {
@@ -656,6 +704,13 @@ double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, co
 	return node->heavy_score;
 }
 
+/**
+ * Get the local outfile source of a node in the task graph, only valid for local output files.
+ * The source of a local output file is the path on the local filesystem.
+ * @param tg Reference to the task graph object.
+ * @param node_key Reference to the node key.
+ * @return The local outfile source.
+ */
 const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key)
 {
 	if (!tg || !node_key) {
@@ -676,6 +731,13 @@ const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task
 	return node->outfile->source;
 }
 
+/**
+ * Set the outfile of a node in the task graph. This involves declaring the output file and adding it to the task.
+ * @param tg Reference to the task graph object.
+ * @param node_key Reference to the node key.
+ * @param outfile_type Reference to the outfile type.
+ * @param outfile_remote_name Reference to the outfile remote name that the task will generate remotely.
+ */
 void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
 {
 	if (!tg || !node_key || !outfile_remote_name) {
@@ -692,6 +754,10 @@ void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *no
 	return;
 }
 
+/**
+ * Delete a task graph object.
+ * @param tg Reference to the task graph object.
+ */
 void vine_task_graph_delete(struct vine_task_graph *tg)
 {
 	if (!tg) {
@@ -716,8 +782,8 @@ void vine_task_graph_delete(struct vine_task_graph *tg)
 
 	vine_delete(tg->manager);
 
-	free(tg->library_name);
-	free(tg->function_name);
+	free(tg->proxy_library_name);
+	free(tg->proxy_function_name);
 
 	hash_table_delete(tg->nodes);
 	itable_delete(tg->task_id_to_node);
diff --git a/taskvine/src/manager/vine_task_graph.h b/taskvine/src/manager/vine_task_graph.h
index 1692d1fc9e..a3ed8d3c6b 100644
--- a/taskvine/src/manager/vine_task_graph.h
+++ b/taskvine/src/manager/vine_task_graph.h
@@ -14,8 +14,8 @@ struct vine_task_graph {
 	struct itable *task_id_to_node;
 	struct hash_table *outfile_cachename_to_node;
 
-    char *library_name;
-    char *function_name;
+    char *proxy_library_name;
+    char *proxy_function_name;
 
     double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
 };
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index 4970b70410..aa6d38bc9b 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -44,13 +44,13 @@ double compute_lex_priority(const char *key)
 struct vine_task_node *vine_task_node_create(
 		struct vine_manager *manager,
 		const char *node_key,
-		const char *library_name,
-		const char *function_name,
+		const char *proxy_library_name,
+		const char *proxy_function_name,
 		const char *staging_dir,
 		int prune_depth,
 		vine_task_node_priority_mode_t priority_mode)
 {
-	if (!manager || !node_key || !library_name || !function_name || !staging_dir) {
+	if (!manager || !node_key || !proxy_library_name || !proxy_function_name || !staging_dir) {
 		return NULL;
 	}
 
@@ -84,27 +84,25 @@ struct vine_task_node *vine_task_node_create(
 
 	node->critical_time = -1;
 
-	debug(D_VINE, "node info: key=%s, staging_dir=%s, priority_mode=%d, prune_depth=%d", node->node_key, node->staging_dir, node->priority_mode, node->prune_depth);
-
 	/* create the task */
-	node->task = vine_task_create(function_name);
-	vine_task_set_library_required(node->task, library_name);
+	node->task = vine_task_create(proxy_function_name);
+	vine_task_set_library_required(node->task, proxy_library_name);
 	vine_task_addref(node->task);
-
+    
 	/* build JSON infile expected by library: {"fn_args": [key], "fn_kwargs": {}} */
 	struct jx *event = jx_object(NULL);
 	struct jx *args = jx_array(NULL);
 	jx_array_append(args, jx_string(node->node_key));
 	jx_insert(event, jx_string("fn_args"), args);
 	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
-
+    
 	char *infile_content = jx_print_string(event);
 	jx_delete(event);
-
+    
 	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
 	free(infile_content);
 	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
-
+    
 	return node;
 }
 
@@ -130,17 +128,14 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 		node->outfile = vine_declare_file(node->manager, local_output_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
 		free(local_output_dir);
 		free(local_output_path);
-		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_LOCAL, outfile = %s", node->node_key, node->outfile->cached_name);
 		break;
 	}
 	case VINE_NODE_OUTFILE_TYPE_TEMP:
 		node->outfile = vine_declare_temp(node->manager);
-		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_TEMP, outfile = %s", node->node_key, node->outfile->cached_name);
 		break;
 	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
 		/* no explicit output file declaration needed */
 		node->outfile = NULL;
-		debug(D_VINE, "node %s: outfile type = VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM", node->node_key);
 		break;
 	}
 	if (node->outfile) {
@@ -462,70 +457,81 @@ int vine_task_node_submit(struct vine_task_node *node)
 	double priority = vine_task_node_calculate_priority(node);
 	vine_task_set_priority(node->task, priority);
 
-	debug(D_VINE, "node %s: priority_mode=%d, depth=%d, calculated_priority=%.6f", node->node_key, node->priority_mode, node->depth, priority);
-
 	return vine_submit(node->manager, node->task);
 }
 
+/* print the info of the node */
 void vine_task_node_print_info(struct vine_task_node *node)
 {
-	if (!node) {
-		return;
-	}
+    if (!node) {
+        return;
+    }
+
+    if (!node->task) {
+        debug(D_ERROR, "node %s has no task", node->node_key);
+        return;
+    }
+
+    debug(D_VINE, "---------------- Node Info ----------------");
+    debug(D_VINE, "key: %s", node->node_key);
+    debug(D_VINE, "task_id: %d", node->task->task_id);
+    debug(D_VINE, "staging_dir: %s", node->staging_dir ? node->staging_dir : "(null)");
+    debug(D_VINE, "depth: %d", node->depth);
+    debug(D_VINE, "height: %d", node->height);
+    debug(D_VINE, "prune_depth: %d", node->prune_depth);
+    debug(D_VINE, "priority_mode: %d", node->priority_mode);
 
-	debug(D_VINE, "node info %s task_id: %d", node->node_key, node->task->task_id);
-	debug(D_VINE, "node info %s depth: %d", node->node_key, node->depth);
     if (node->outfile_remote_name) {
-        debug(D_VINE, "node info %s outfile remote name: %s", node->node_key, node->outfile_remote_name);
+        debug(D_VINE, "outfile_remote_name: %s", node->outfile_remote_name);
     }
 
-	if (node->outfile) {
-		switch (node->outfile->type) {
-		case VINE_FILE:
-			debug(D_VINE, "node info %s outfile type: VINE_FILE, cached name: %s", node->node_key, node->outfile->cached_name);
-			break;
-		case VINE_TEMP:
-			debug(D_VINE, "node info %s outfile type: VINE_TEMP, cached name: %s", node->node_key, node->outfile->cached_name);
-			break;
-		default:
-			debug(D_ERROR, "unsupported outfile type: %d", node->outfile->type);
-			break;
-		}
-	}
+    if (node->outfile) {
+        const char *type_str = "UNKNOWN";
+        switch (node->outfile->type) {
+            case VINE_FILE:       type_str = "VINE_FILE"; break;
+            case VINE_TEMP:       type_str = "VINE_TEMP"; break;
+            case VINE_URL:        type_str = "VINE_URL"; break;
+            case VINE_BUFFER:     type_str = "VINE_BUFFER"; break;
+            case VINE_MINI_TASK:  type_str = "VINE_MINI_TASK"; break;
+        }
+        debug(D_VINE, "outfile_type: %s", type_str);
+        debug(D_VINE, "outfile_cached_name: %s", node->outfile->cached_name ? node->outfile->cached_name : "(null)");
+    } else {
+        debug(D_VINE, "outfile_type: SHARED_FILE_SYSTEM or none");
+    }
 
-	char *parent_keys = NULL;
-	struct vine_task_node *parent_node;
-	LIST_ITERATE(node->parents, parent_node)
-	{
-		if (!parent_keys) {
-			parent_keys = string_format("%s", parent_node->node_key);
-		} else {
-			char *tmp = string_format("%s, %s", parent_keys, parent_node->node_key);
-			free(parent_keys);
-			parent_keys = tmp;
-		}
-	}
-	debug(D_VINE, "node info %s parents: %s", node->node_key, parent_keys ? parent_keys : "(none)");
-	free(parent_keys);
-    parent_keys = NULL;
+    /* print parent and child node keys */
+    char *parent_keys = NULL;
+    struct vine_task_node *p;
+    LIST_ITERATE(node->parents, p) {
+        if (!parent_keys) {
+            parent_keys = string_format("%s", p->node_key);
+        } else {
+            char *tmp = string_format("%s, %s", parent_keys, p->node_key);
+            free(parent_keys);
+            parent_keys = tmp;
+        }
+    }
 
-	char *child_keys = NULL;
-	struct vine_task_node *child_node;
-	LIST_ITERATE(node->children, child_node)
-	{
-		if (!child_keys) {
-			child_keys = string_format("%s", child_node->node_key);
-		} else {
-			char *tmp = string_format("%s, %s", child_keys, child_node->node_key);
-			free(child_keys);
-			child_keys = tmp;
-		}
-	}
-	debug(D_VINE, "node info %s children: %s", node->node_key, child_keys ? child_keys : "(none)");
-	free(child_keys);
-    child_keys = NULL;
+    char *child_keys = NULL;
+    struct vine_task_node *c;
+    LIST_ITERATE(node->children, c) {
+        if (!child_keys) {
+            child_keys = string_format("%s", c->node_key);
+        } else {
+            char *tmp = string_format("%s, %s", child_keys, c->node_key);
+            free(child_keys);
+            child_keys = tmp;
+        }
+    }
 
-	return;
+    debug(D_VINE, "parents: %s", parent_keys ? parent_keys : "(none)");
+    debug(D_VINE, "children: %s", child_keys ? child_keys : "(none)");
+
+    free(parent_keys);
+    free(child_keys);
+
+    debug(D_VINE, "-------------------------------------------");
 }
 
 void vine_task_node_prune_ancestors(struct vine_task_node *node)
diff --git a/taskvine/src/manager/vine_task_node.h b/taskvine/src/manager/vine_task_node.h
index b480acfc7a..cd8e98afe3 100644
--- a/taskvine/src/manager/vine_task_node.h
+++ b/taskvine/src/manager/vine_task_node.h
@@ -54,8 +54,8 @@ struct vine_task_node {
 struct vine_task_node *vine_task_node_create(
     struct vine_manager *manager,
     const char *node_key,
-    const char *library_name,
-    const char *function_name,
+    const char *proxy_library_name,
+    const char *proxy_function_name,
     const char *staging_dir,
     int prune_depth,
     vine_task_node_priority_mode_t priority_mode

From b4e5a7b0ee1e1b3ea9a33c4e19637a25607f3f4d Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 15 Oct 2025 11:48:22 -0400
Subject: [PATCH 031/113] comment functions

---
 .../ndcctools/taskvine/graph_executor.py      |  10 +-
 taskvine/src/manager/taskvine.h               |   2 +-
 taskvine/src/manager/vine_task_graph.c        | 626 ++++++++++--------
 taskvine/src/manager/vine_task_node.c         | 306 ++++++---
 4 files changed, 551 insertions(+), 393 deletions(-)

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
index 5d7137f25b..01e7cb8811 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
@@ -184,11 +184,11 @@ def run(self,
         # create task graph in the python side
         print("Initializing task graph in TaskVine")
         for k in topo_order:
-            cvine.vine_task_graph_create_node(self._vine_task_graph,
-                                              self.task_graph.vine_key_of[k],
-                                              self.staging_dir,
-                                              prune_depth,
-                                              get_c_constant(f"task_priority_mode_{priority_mode.replace('-', '_')}"))
+            cvine.vine_task_graph_add_node(self._vine_task_graph,
+                                           self.task_graph.vine_key_of[k],
+                                           self.staging_dir,
+                                           prune_depth,
+                                           get_c_constant(f"task_priority_mode_{priority_mode.replace('-', '_')}"))
             for pk in self.task_graph.parents_of.get(k, []):
                 cvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
 
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index ce4311d73d..ff75a8f6d2 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -1616,7 +1616,7 @@ void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *pare
 @param priority_mode Reference to the priority mode.
 @return A new node object.
 */
-struct vine_task_node *vine_task_graph_create_node(struct vine_task_graph *tg,
+struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
 	const char *node_key,
 	const char *staging_dir,
 	int prune_depth,
diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/manager/vine_task_graph.c
index 5d5c75b910..5f64287d1c 100644
--- a/taskvine/src/manager/vine_task_graph.c
+++ b/taskvine/src/manager/vine_task_graph.c
@@ -32,11 +32,20 @@ static volatile sig_atomic_t interrupted = 0;
 /* Private Functions */
 /*************************************************************/
 
+/**
+ * Handle the SIGINT signal.
+ * @param signal Reference to the signal.
+ */
 static void handle_sigint(int signal)
 {
 	interrupted = 1;
 }
 
+/**
+ * Submit a node to the taskvine manager.
+ * @param tg Reference to the task graph object.
+ * @param node Reference to the node object.
+ */
 static void submit_node_task(struct vine_task_graph *tg, struct vine_task_node *node)
 {
 	if (!tg || !node) {
@@ -49,7 +58,12 @@ static void submit_node_task(struct vine_task_graph *tg, struct vine_task_node *
 	return;
 }
 
-static void submit_node_ready_children(struct vine_task_graph *tg, struct vine_task_node *node)
+/**
+ * Submit the children of a node if all its dependencies are resolved.
+ * @param tg Reference to the task graph object.
+ * @param node Reference to the node object.
+ */
+static void submit_unblocked_children(struct vine_task_graph *tg, struct vine_task_node *node)
 {
 	if (!tg || !node) {
 		return;
@@ -77,6 +91,12 @@ static void submit_node_ready_children(struct vine_task_graph *tg, struct vine_t
 	return;
 }
 
+/**
+ * Get the topological order of the task graph.
+ * Must be called after all nodes and dependencies are added and the topology metrics are computed.
+ * @param tg Reference to the task graph object.
+ * @return The list of nodes in topological order.
+ */
 static struct list *get_topological_order(struct vine_task_graph *tg)
 {
 	if (!tg) {
@@ -147,6 +167,12 @@ static struct list *get_topological_order(struct vine_task_graph *tg)
 	return topo_order;
 }
 
+/**
+ * Extract the weakly connected components of the task graph.
+ * This function is used only for debugging purposes at the moment.
+ * @param tg Reference to the task graph object.
+ * @return The list of weakly connected components.
+ */
 static struct list *extract_weakly_connected_components(struct vine_task_graph *tg)
 {
 	if (!tg) {
@@ -203,6 +229,11 @@ static struct list *extract_weakly_connected_components(struct vine_task_graph *
 	return components;
 }
 
+/**
+ * Compute the heavy score of a node in the task graph.
+ * @param node Reference to the node object.
+ * @return The heavy score.
+ */
 static double compute_node_heavy_score(struct vine_task_node *node)
 {
 	if (!node) {
@@ -215,6 +246,12 @@ static double compute_node_heavy_score(struct vine_task_node *node)
 	return up_score / (down_score + 1);
 }
 
+/**
+ * Map a task to a node in the task graph.
+ * @param tg Reference to the task graph object.
+ * @param task Reference to the task object.
+ * @return The node object.
+ */
 static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struct vine_task *task)
 {
 	if (!tg || !task) {
@@ -222,6 +259,7 @@ static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struc
 	}
 
 	if (task->type == VINE_TASK_TYPE_STANDARD) {
+		/* standard tasks are mapped directly to a node */
 		return itable_lookup(tg->task_id_to_node, task->task_id);
 	} else if (task->type == VINE_TASK_TYPE_RECOVERY) {
 		/* note that recovery tasks are not mapped to any node but we still need the original node for pruning,
@@ -244,217 +282,86 @@ static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struc
 /* Public APIs */
 /*************************************************************/
 
-void vine_task_graph_execute(struct vine_task_graph *tg)
+/**
+ * Get the library name of the task graph.
+ * @param tg Reference to the task graph object.
+ * @return The library name.
+ */
+const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg)
 {
 	if (!tg) {
-		return;
-	}
-	
-	debug(D_VINE, "start executing task graph");
-	
-	/* print the info of all nodes */
-	char *node_key;
-	struct vine_task_node *node;
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		vine_task_node_print_info(node);
+		return NULL;
 	}
-	
-	/* enable return recovery tasks */
-	vine_enable_return_recovery_tasks(tg->manager);
 
-	/* create mapping from task_id and outfile cached_name to node */
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		if (node->outfile) {
-			hash_table_insert(tg->outfile_cachename_to_node, node->outfile->cached_name, node);
-		}
-	}
+	return tg->proxy_library_name;
+}
 
-	/* add the parents' outfiles as inputs to the task */
-	struct list *topo_order = get_topological_order(tg);
-	LIST_ITERATE(topo_order, node)
-	{
-		struct vine_task_node *parent_node;
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (parent_node->outfile) {
-				vine_task_add_input(node->task, parent_node->outfile, parent_node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
-			}
-		}
+/**
+ * Get the function name of the task graph.
+ * @param tg Reference to the task graph object.
+ * @return The function name.
+ */
+const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg)
+{
+	if (!tg) {
+		return NULL;
 	}
 
-	/* initialize pending_parents for all nodes */
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		struct vine_task_node *parent_node;
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (node->pending_parents) {
-				/* Use parent_node->node_key to ensure pointer consistency */
-				set_insert(node->pending_parents, parent_node);
-			}
-		}
-	}
+	return tg->proxy_function_name;
+}
 
-	/* enqueue those without dependencies */
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
-			submit_node_task(tg, node);
-		}
+/**
+ * Get the heavy score of a node in the task graph.
+ * @param tg Reference to the task graph object.
+ * @param node_key Reference to the node key.
+ * @return The heavy score.
+ */
+double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key)
+{
+	if (!tg) {
+		return -1;
 	}
 
-	/* calculate steps to inject failure */
-	double next_failure_threshold = -1.0;
-	if (tg->failure_injection_step_percent > 0) {
-		next_failure_threshold = tg->failure_injection_step_percent / 100.0;
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		return -1;
 	}
 
-	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
-	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(tg->nodes));
-	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
-	progress_bar_bind_part(pbar, regular_tasks_part);
-	progress_bar_bind_part(pbar, recovery_tasks_part);
-
-	int wait_timeout = 2;
-
-	while (regular_tasks_part->current < regular_tasks_part->total) {
-		if (interrupted) {
-			break;
-		}
-
-		struct vine_task *task = vine_wait(tg->manager, wait_timeout);
-		progress_bar_set_part_total(pbar, recovery_tasks_part, tg->manager->num_submitted_recovery_tasks);
-		if (task) {
-			/* retrieve all possible tasks */
-			wait_timeout = 0;
-
-			/* get the original node by task id */
-			struct vine_task_node *node = get_node_by_task(tg, task);
-			if (!node) {
-				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
-				exit(1);
-			}
-
-			/* in case of failure, resubmit this task */
-			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
-				if (node->retry_attempts_left <= 0) {
-					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %s has no retries left. Aborting.",
-						  task->task_id, node->task->result, node->task->exit_code, node->node_key);
-					vine_task_graph_delete(tg);
-					exit(1);
-				}
-				node->retry_attempts_left--;
-				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %s (remaining=%d)...",
-					  task->task_id, node->task->result, node->task->exit_code, node->node_key, node->retry_attempts_left);
-				vine_task_reset(node->task);
-				submit_node_task(tg, node);
-				continue;
-			}
-
-			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
-			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
-				struct stat info;
-				int result = stat(node->outfile_remote_name, &info);
-				if (result < 0) {
-					if (node->retry_attempts_left <= 0) {
-						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %s. Aborting.",
-							  task->task_id, node->outfile_remote_name, node->node_key);
-						vine_task_graph_delete(tg);
-						exit(1);
-					}
-					node->retry_attempts_left--;
-					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %s (remaining=%d)...",
-						  task->task_id, node->outfile_remote_name, node->node_key, node->retry_attempts_left);
-					vine_task_reset(node->task);
-					submit_node_task(tg, node);
-					continue;
-				}
-				node->outfile_size_bytes = info.st_size;
-				break;
-			}
-			case VINE_NODE_OUTFILE_TYPE_LOCAL:
-			case VINE_NODE_OUTFILE_TYPE_TEMP:
-				node->outfile_size_bytes = node->outfile->size;
-				break;
-			}
-			debug(D_VINE, "Node %s completed with outfile %s size: %zu bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
-
-			/* mark the node as completed */
-			node->completed = 1;
-
-			/* prune nodes on task completion */
-			vine_task_node_prune_ancestors(node);
-
-			/* skip recovery tasks */
-			if (task->type == VINE_TASK_TYPE_RECOVERY) {
-				progress_bar_update_part(pbar, recovery_tasks_part, 1);
-				continue;
-			}
-
-			/* set the start time to the submit time of the first regular task */
-			if (regular_tasks_part->current == 0) {
-				progress_bar_set_start_time(pbar, task->time_when_commit_start);
-			}
-
-			/* update critical time */
-			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
-
-			/* mark this regular task as completed */
-			progress_bar_update_part(pbar, regular_tasks_part, 1);
-
-			/* inject failure */
-			if (tg->failure_injection_step_percent > 0) {
-				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
-				if (progress >= next_failure_threshold && evict_random_worker(tg->manager)) {
-					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
-					next_failure_threshold += tg->failure_injection_step_percent / 100.0;
-				}
-			}
-
-			/* enqueue the output file for replication */
-			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_TEMP:
-				vine_task_node_replicate_outfile(node);
-				break;
-			case VINE_NODE_OUTFILE_TYPE_LOCAL:
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
-				break;
-			}
+	return node->heavy_score;
+}
 
-			/* submit children nodes with dependencies all resolved */
-			submit_node_ready_children(tg, node);
-		} else {
-			wait_timeout = 2;
-			progress_bar_update_part(pbar, recovery_tasks_part, 0);  // refresh the time and total for recovery tasks
-		}
+/**
+ * Get the local outfile source of a node in the task graph, only valid for local output files.
+ * The source of a local output file is the path on the local filesystem.
+ * @param tg Reference to the task graph object.
+ * @param node_key Reference to the node key.
+ * @return The local outfile source.
+ */
+const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key)
+{
+	if (!tg || !node_key) {
+		return NULL;
 	}
 
-	progress_bar_finish(pbar);
-	progress_bar_delete(pbar);
-
-	double total_time_spent_on_unlink_local_files = 0;
-	double total_time_spent_on_prune_ancestors_of_temp_node = 0;
-	double total_time_spent_on_prune_ancestors_of_persisted_node = 0;
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
-		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
-		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		debug(D_ERROR, "node %s not found", node_key);
+		exit(1);
 	}
-	total_time_spent_on_unlink_local_files /= 1e6;
-	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
-	total_time_spent_on_prune_ancestors_of_persisted_node /= 1e6;
 
-	debug(D_VINE, "total time spent on prune ancestors of temp node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_temp_node);
-	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
-	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
+	if (node->outfile_type != VINE_NODE_OUTFILE_TYPE_LOCAL) {
+		debug(D_ERROR, "node %s is not a local output file", node_key);
+		exit(1);
+	}
 
-	return;
+	return node->outfile->source;
 }
 
+/**
+ * Compute the topology metrics of the task graph, including depth, height, upstream and downstream counts,
+ * heavy scores, and weakly connected components.
+ * @param tg Reference to the task graph object.
+ */
 void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
 {
 	if (!tg) {
@@ -538,7 +445,7 @@ void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
 	hash_table_delete(upstream_map);
 	hash_table_delete(downstream_map);
 
-	/* compute the heavy score  */
+	/* compute the heavy score for each node */
 	LIST_ITERATE(topo_order, node)
 	{
 		node->heavy_score = compute_node_heavy_score(node);
@@ -562,6 +469,47 @@ void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
 	return;
 }
 
+/**
+ * Create a new node and track it in the task graph.
+ * @param tg Reference to the task graph object.
+ * @param node_key Reference to the node key.
+ * @param staging_dir Reference to the staging directory.
+ * @param prune_depth Reference to the prune depth.
+ * @param priority_mode Reference to the priority mode.
+ * @return A new node object.
+ */
+struct vine_task_node *vine_task_graph_add_node(
+		struct vine_task_graph *tg,
+		const char *node_key,
+		const char *staging_dir,
+		int prune_depth,
+		vine_task_node_priority_mode_t priority_mode)
+{
+	if (!tg || !node_key) {
+		return NULL;
+	}
+
+	/* if the node already exists, skip creating a new one */
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		node = vine_task_node_create(tg->manager,
+				node_key,
+				tg->proxy_library_name,
+				tg->proxy_function_name,
+				staging_dir,
+				prune_depth,
+				priority_mode);
+		hash_table_insert(tg->nodes, node_key, node);
+	}
+
+	return node;
+}
+
+/**
+ * Create a new task graph object and bind a manager to it.
+ * @param q Reference to the manager object.
+ * @return A new task graph object.
+ */
 struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 {
 	struct vine_task_graph *tg = xxmalloc(sizeof(struct vine_task_graph));
@@ -586,6 +534,11 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	return tg;
 }
 
+/**
+ * Set the failure injection step percent, meaning we will evict a randome worker at every X% of the DAG completion.
+ * @param tg Reference to the task graph object.
+ * @param percent Reference to the failure injection step percent.
+ */
 void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent)
 {
 	if (!tg) {
@@ -600,32 +553,6 @@ void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *
 	tg->failure_injection_step_percent = percent;
 }
 
-struct vine_task_node *vine_task_graph_create_node(
-		struct vine_task_graph *tg,
-		const char *node_key,
-		const char *staging_dir,
-		int prune_depth,
-		vine_task_node_priority_mode_t priority_mode)
-{
-	if (!tg || !node_key) {
-		return NULL;
-	}
-
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		node = vine_task_node_create(tg->manager,
-				node_key,
-				tg->proxy_library_name,
-				tg->proxy_function_name,
-				staging_dir,
-				prune_depth,
-				priority_mode);
-		hash_table_insert(tg->nodes, node_key, node);
-	}
-
-	return node;
-}
-
 /**
  * Add a dependency between two nodes in the task graph. Note that the input-output file relationship
  * is not handled here, because their file names may have not been determined yet.
@@ -657,99 +584,236 @@ void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *pare
 }
 
 /**
- * Get the library name of the task graph.
+ * Set the outfile of a node in the task graph.
+ * This involves declaring the output file and adding it to the task.
  * @param tg Reference to the task graph object.
- * @return The library name.
+ * @param node_key Reference to the node key.
+ * @param outfile_type Reference to the outfile type.
+ * @param outfile_remote_name Reference to the outfile remote name that the task will generate remotely.
  */
-const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg)
+void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
 {
-	if (!tg) {
-		return NULL;
+	if (!tg || !node_key || !outfile_remote_name) {
+		return;
 	}
 
-	return tg->proxy_library_name;
+	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
+	if (!node) {
+		return;
+	}
+
+	vine_task_node_set_outfile(node, outfile_type, outfile_remote_name);
+
+	return;
 }
 
 /**
- * Get the function name of the task graph.
+ * Execute the task graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
  * @param tg Reference to the task graph object.
- * @return The function name.
  */
-const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg)
+void vine_task_graph_execute(struct vine_task_graph *tg)
 {
 	if (!tg) {
-		return NULL;
+		return;
 	}
 
-	return tg->proxy_function_name;
-}
+	debug(D_VINE, "start executing task graph");
 
-/**
- * Get the heavy score of a node in the task graph.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @return The heavy score.
- */
-double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key)
-{
-	if (!tg) {
-		return -1;
+	/* print the info of all nodes */
+	char *node_key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		vine_task_node_print_info(node);
 	}
 
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		return -1;
+	/* enable return recovery tasks */
+	vine_enable_return_recovery_tasks(tg->manager);
+
+	/* create mapping from task_id and outfile cached_name to node */
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		if (node->outfile) {
+			hash_table_insert(tg->outfile_cachename_to_node, node->outfile->cached_name, node);
+		}
 	}
 
-	return node->heavy_score;
-}
+	/* add the parents' outfiles as inputs to the task */
+	struct list *topo_order = get_topological_order(tg);
+	LIST_ITERATE(topo_order, node)
+	{
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (parent_node->outfile) {
+				vine_task_add_input(node->task, parent_node->outfile, parent_node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
+			}
+		}
+	}
 
-/**
- * Get the local outfile source of a node in the task graph, only valid for local output files.
- * The source of a local output file is the path on the local filesystem.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @return The local outfile source.
- */
-const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key)
-{
-	if (!tg || !node_key) {
-		return NULL;
+	/* initialize pending_parents for all nodes */
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (node->pending_parents) {
+				/* Use parent_node->node_key to ensure pointer consistency */
+				set_insert(node->pending_parents, parent_node);
+			}
+		}
 	}
 
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		debug(D_ERROR, "node %s not found", node_key);
-		exit(1);
+	/* enqueue those without dependencies */
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
+			submit_node_task(tg, node);
+		}
 	}
 
-	if (node->outfile_type != VINE_NODE_OUTFILE_TYPE_LOCAL) {
-		debug(D_ERROR, "node %s is not a local output file", node_key);
-		exit(1);
+	/* calculate steps to inject failure */
+	double next_failure_threshold = -1.0;
+	if (tg->failure_injection_step_percent > 0) {
+		next_failure_threshold = tg->failure_injection_step_percent / 100.0;
 	}
 
-	return node->outfile->source;
-}
+	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
+	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(tg->nodes));
+	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
+	progress_bar_bind_part(pbar, regular_tasks_part);
+	progress_bar_bind_part(pbar, recovery_tasks_part);
 
-/**
- * Set the outfile of a node in the task graph. This involves declaring the output file and adding it to the task.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @param outfile_type Reference to the outfile type.
- * @param outfile_remote_name Reference to the outfile remote name that the task will generate remotely.
- */
-void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
-{
-	if (!tg || !node_key || !outfile_remote_name) {
-		return;
+	int wait_timeout = 2;
+
+	while (regular_tasks_part->current < regular_tasks_part->total) {
+		if (interrupted) {
+			break;
+		}
+
+		struct vine_task *task = vine_wait(tg->manager, wait_timeout);
+		progress_bar_set_part_total(pbar, recovery_tasks_part, tg->manager->num_submitted_recovery_tasks);
+		if (task) {
+			/* retrieve all possible tasks */
+			wait_timeout = 0;
+
+			/* get the original node by task id */
+			struct vine_task_node *node = get_node_by_task(tg, task);
+			if (!node) {
+				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
+				exit(1);
+			}
+
+			/* in case of failure, resubmit this task */
+			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
+				if (node->retry_attempts_left <= 0) {
+					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %s has no retries left. Aborting.", task->task_id, node->task->result, node->task->exit_code, node->node_key);
+					vine_task_graph_delete(tg);
+					exit(1);
+				}
+				node->retry_attempts_left--;
+				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %s (remaining=%d)...", task->task_id, node->task->result, node->task->exit_code, node->node_key, node->retry_attempts_left);
+				vine_task_reset(node->task);
+				submit_node_task(tg, node);
+				continue;
+			}
+
+			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
+			switch (node->outfile_type) {
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
+				struct stat info;
+				int result = stat(node->outfile_remote_name, &info);
+				if (result < 0) {
+					if (node->retry_attempts_left <= 0) {
+						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %s. Aborting.", task->task_id, node->outfile_remote_name, node->node_key);
+						vine_task_graph_delete(tg);
+						exit(1);
+					}
+					node->retry_attempts_left--;
+					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %s (remaining=%d)...", task->task_id, node->outfile_remote_name, node->node_key, node->retry_attempts_left);
+					vine_task_reset(node->task);
+					submit_node_task(tg, node);
+					continue;
+				}
+				node->outfile_size_bytes = info.st_size;
+				break;
+			}
+			case VINE_NODE_OUTFILE_TYPE_LOCAL:
+			case VINE_NODE_OUTFILE_TYPE_TEMP:
+				node->outfile_size_bytes = node->outfile->size;
+				break;
+			}
+			debug(D_VINE, "Node %s completed with outfile %s size: %zu bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
+
+			/* mark the node as completed */
+			node->completed = 1;
+
+			/* prune nodes on task completion */
+			vine_task_node_prune_ancestors(node);
+
+			/* skip recovery tasks */
+			if (task->type == VINE_TASK_TYPE_RECOVERY) {
+				progress_bar_update_part(pbar, recovery_tasks_part, 1);
+				continue;
+			}
+
+			/* set the start time to the submit time of the first regular task */
+			if (regular_tasks_part->current == 0) {
+				progress_bar_set_start_time(pbar, task->time_when_commit_start);
+			}
+
+			/* update critical time */
+			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
+
+			/* mark this regular task as completed */
+			progress_bar_update_part(pbar, regular_tasks_part, 1);
+
+			/* inject failure */
+			if (tg->failure_injection_step_percent > 0) {
+				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
+				if (progress >= next_failure_threshold && evict_random_worker(tg->manager)) {
+					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
+					next_failure_threshold += tg->failure_injection_step_percent / 100.0;
+				}
+			}
+
+			/* enqueue the output file for replication */
+			switch (node->outfile_type) {
+			case VINE_NODE_OUTFILE_TYPE_TEMP:
+				vine_task_node_replicate_outfile(node);
+				break;
+			case VINE_NODE_OUTFILE_TYPE_LOCAL:
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+				break;
+			}
+
+			/* submit children nodes with dependencies all resolved */
+			submit_unblocked_children(tg, node);
+		} else {
+			wait_timeout = 2;
+			progress_bar_update_part(pbar, recovery_tasks_part, 0); // refresh the time and total for recovery tasks
+		}
 	}
 
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		return;
+	progress_bar_finish(pbar);
+	progress_bar_delete(pbar);
+
+	double total_time_spent_on_unlink_local_files = 0;
+	double total_time_spent_on_prune_ancestors_of_temp_node = 0;
+	double total_time_spent_on_prune_ancestors_of_persisted_node = 0;
+	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+	{
+		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
+		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
+		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
 	}
+	total_time_spent_on_unlink_local_files /= 1e6;
+	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
+	total_time_spent_on_prune_ancestors_of_persisted_node /= 1e6;
 
-	vine_task_node_set_outfile(node, outfile_type, outfile_remote_name);
+	debug(D_VINE, "total time spent on prune ancestors of temp node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_temp_node);
+	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
+	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
 
 	return;
 }
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/manager/vine_task_node.c
index aa6d38bc9b..eca0c551c4 100644
--- a/taskvine/src/manager/vine_task_node.c
+++ b/taskvine/src/manager/vine_task_node.c
@@ -25,6 +25,12 @@
 #include <sys/types.h>
 #include <sys/stat.h>
 
+/**
+ * Compute a lexicographic priority score from the node key.
+ * Used during topological sorting to break ties deterministically.
+ * @param key Reference to the node key.
+ * @return The lexical priority.
+ */
 double compute_lex_priority(const char *key)
 {
 	double score = 0.0;
@@ -36,11 +42,17 @@ double compute_lex_priority(const char *key)
 	return -score;
 }
 
-/*
- * Create a new node in the graph.
- * The caller must construct the graph nodes in a topological order.
+/**
+ * Create a new node object.
+ * @param manager Reference to the manager object.
+ * @param node_key Reference to the node key.
+ * @param proxy_library_name Reference to the proxy library name.
+ * @param proxy_function_name Reference to the proxy function name.
+ * @param staging_dir Reference to the staging directory.
+ * @param prune_depth Reference to the prune depth.
+ * @param priority_mode Reference to the priority mode.
+ * @return A new node object.
  */
-
 struct vine_task_node *vine_task_node_create(
 		struct vine_manager *manager,
 		const char *node_key,
@@ -58,8 +70,8 @@ struct vine_task_node *vine_task_node_create(
 
 	node->manager = manager;
 	node->node_key = xxstrdup(node_key);
-    node->staging_dir = xxstrdup(staging_dir);
-	
+	node->staging_dir = xxstrdup(staging_dir);
+
 	node->priority_mode = priority_mode;
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
 	node->parents = list_create();
@@ -68,7 +80,7 @@ struct vine_task_node *vine_task_node_create(
 	node->completed = 0;
 	node->prune_depth = prune_depth;
 	node->retry_attempts_left = 1;
-    node->outfile_size_bytes = 0;
+	node->outfile_size_bytes = 0;
 
 	node->depth = -1;
 	node->height = -1;
@@ -88,24 +100,31 @@ struct vine_task_node *vine_task_node_create(
 	node->task = vine_task_create(proxy_function_name);
 	vine_task_set_library_required(node->task, proxy_library_name);
 	vine_task_addref(node->task);
-    
+
 	/* build JSON infile expected by library: {"fn_args": [key], "fn_kwargs": {}} */
 	struct jx *event = jx_object(NULL);
 	struct jx *args = jx_array(NULL);
 	jx_array_append(args, jx_string(node->node_key));
 	jx_insert(event, jx_string("fn_args"), args);
 	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
-    
+
 	char *infile_content = jx_print_string(event);
 	jx_delete(event);
-    
+
 	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
 	free(infile_content);
 	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
-    
+
 	return node;
 }
 
+/**
+ * Set the outfile of a node in the task graph.
+ * This involves declaring the output file and adding it to the task.
+ * @param node Reference to the node object.
+ * @param outfile_type Reference to the outfile type.
+ * @param outfile_remote_name Reference to the outfile remote name.
+ */
 void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
 {
 	if (!node) {
@@ -121,10 +140,10 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 	switch (node->outfile_type) {
 	case VINE_NODE_OUTFILE_TYPE_LOCAL: {
 		char *local_output_dir = string_format("%s/outputs", node->staging_dir);
-        if (mkdir(local_output_dir, 0777) != 0 && errno != EEXIST) {
-            debug(D_ERROR, "failed to mkdir %s (errno=%d)", local_output_dir, errno);
-        }
-        char *local_output_path = string_format("%s/%s", local_output_dir, node->outfile_remote_name);
+		if (mkdir(local_output_dir, 0777) != 0 && errno != EEXIST) {
+			debug(D_ERROR, "failed to mkdir %s (errno=%d)", local_output_dir, errno);
+		}
+		char *local_output_path = string_format("%s/%s", local_output_dir, node->outfile_remote_name);
 		node->outfile = vine_declare_file(node->manager, local_output_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
 		free(local_output_dir);
 		free(local_output_path);
@@ -145,6 +164,13 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 	return;
 }
 
+/**
+ * Check if the outfile of a node is persisted.
+ * A node is considered persisted if it has completed and 1) the outfile is written to the shared file system,
+ * 2) the outfile is written to the local staging directory.
+ * @param node Reference to the node object.
+ * @return 1 if the outfile is persisted, 0 otherwise.
+ */
 static int _node_outfile_is_persisted(struct vine_task_node *node)
 {
 	if (!node) {
@@ -168,6 +194,11 @@ static int _node_outfile_is_persisted(struct vine_task_node *node)
 	return 0;
 }
 
+/**
+ * Calculate the priority of a node given the priority mode.
+ * @param node Reference to the node object.
+ * @return The priority.
+ */
 double vine_task_node_calculate_priority(struct vine_task_node *node)
 {
 	if (!node) {
@@ -219,6 +250,11 @@ double vine_task_node_calculate_priority(struct vine_task_node *node)
 	return priority;
 }
 
+/**
+ * Update the critical time of a node.
+ * @param node Reference to the node object.
+ * @param execution_time Reference to the execution time of the node.
+ */
 void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time)
 {
 	timestamp_t max_parent_critical_time = 0;
@@ -232,7 +268,13 @@ void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_
 	node->critical_time = max_parent_critical_time + execution_time;
 }
 
-/* the dfs helper function for finding parents in a specific depth */
+/**
+ * The dfs helper function for finding parents in a specific depth.
+ * @param node Reference to the node object.
+ * @param remaining_depth Reference to the remaining depth.
+ * @param result Reference to the result list.
+ * @param visited Reference to the visited set.
+ */
 static void _find_parents_dfs(struct vine_task_node *node, int remaining_depth, struct list *result, struct set *visited)
 {
 	if (!node || set_lookup(visited, node)) {
@@ -251,7 +293,12 @@ static void _find_parents_dfs(struct vine_task_node *node, int remaining_depth,
 	}
 }
 
-/* find all parents in a specific depth of the node */
+/**
+ * Find all parents in a specific depth of the node.
+ * @param node Reference to the node object.
+ * @param depth Reference to the depth.
+ * @return The list of parents.
+ */
 static struct list *_find_parents_in_depth(struct vine_task_node *node, int depth)
 {
 	if (!node || depth < 0) {
@@ -267,7 +314,14 @@ static struct list *_find_parents_in_depth(struct vine_task_node *node, int dept
 	return result;
 }
 
-int _prune_ancestors_of_temp_node(struct vine_task_node *node)
+/**
+ * Prune the ancestors of a temp node. This is only used for temp nodes that produce temp files.
+ * All ancestors of this node we consider here are temp nodes, we can not safely prune those stored in the shared file system
+ * because temp nodes are not considered safe enough to trigger the deletion of upstream persisted files.
+ * @param node Reference to the node object.
+ * @return The number of pruned replicas.
+ */
+static int prune_ancestors_of_temp_node(struct vine_task_node *node)
 {
 	if (!node || !node->outfile || node->prune_depth <= 0) {
 		return 0;
@@ -329,6 +383,11 @@ int _prune_ancestors_of_temp_node(struct vine_task_node *node)
 	return pruned_replica_count;
 }
 
+/**
+ * Find all safe ancestors of a node.
+ * @param start_node Reference to the start node.
+ * @return The set of safe ancestors.
+ */
 static struct set *_find_safe_ancestors(struct vine_task_node *start_node)
 {
 	if (!start_node) {
@@ -392,7 +451,14 @@ static struct set *_find_safe_ancestors(struct vine_task_node *start_node)
 	return visited_nodes;
 }
 
-int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
+/**
+ * Prune the ancestors of a persisted node. This is only used for persisted nodes that produce persisted files.
+ * All ancestors we consider here include both temp nodes and persisted nodes, becasue data written to shared file system
+ * is safe and can definitely trigger upstream data redundancy to be released.
+ * @param node Reference to the node object.
+ * @return The number of pruned replicas.
+ */
+static int prune_ancestors_of_persisted_node(struct vine_task_node *node)
 {
 	if (!node) {
 		return 0;
@@ -414,15 +480,12 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 	{
 		/* unlink the shared file system file */
 		if (!ancestor_node->outfile) {
-			timestamp_t unlink_start  = timestamp_get();
-            if (ancestor_node->outfile_remote_name) {
-                unlink(ancestor_node->outfile_remote_name);   // system call
-            }
+			timestamp_t unlink_start = timestamp_get();
+			if (ancestor_node->outfile_remote_name) {
+				unlink(ancestor_node->outfile_remote_name); // system call
+			}
 			node->time_spent_on_unlink_local_files += timestamp_get() - unlink_start;
-			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64,
-                    ancestor_node->outfile_remote_name ? ancestor_node->outfile_remote_name : "(null)",
-                    ancestor_node->outfile_size_bytes,
-                    (uint64_t)node->time_spent_on_unlink_local_files);          
+			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64, ancestor_node->outfile_remote_name ? ancestor_node->outfile_remote_name : "(null)", ancestor_node->outfile_size_bytes, (uint64_t)node->time_spent_on_unlink_local_files);
 		} else {
 			switch (ancestor_node->outfile->type) {
 			case VINE_FILE:
@@ -448,6 +511,11 @@ int _prune_ancestors_of_persisted_node(struct vine_task_node *node)
 	return pruned_replica_count;
 }
 
+/**
+ * Submit a node to the taskvine manager.
+ * @param node Reference to the node object.
+ * @return The task id.
+ */
 int vine_task_node_submit(struct vine_task_node *node)
 {
 	if (!node) {
@@ -460,80 +528,99 @@ int vine_task_node_submit(struct vine_task_node *node)
 	return vine_submit(node->manager, node->task);
 }
 
-/* print the info of the node */
+/**
+ * Print the info of the node.
+ * @param node Reference to the node object.
+ */
 void vine_task_node_print_info(struct vine_task_node *node)
 {
-    if (!node) {
-        return;
-    }
-
-    if (!node->task) {
-        debug(D_ERROR, "node %s has no task", node->node_key);
-        return;
-    }
-
-    debug(D_VINE, "---------------- Node Info ----------------");
-    debug(D_VINE, "key: %s", node->node_key);
-    debug(D_VINE, "task_id: %d", node->task->task_id);
-    debug(D_VINE, "staging_dir: %s", node->staging_dir ? node->staging_dir : "(null)");
-    debug(D_VINE, "depth: %d", node->depth);
-    debug(D_VINE, "height: %d", node->height);
-    debug(D_VINE, "prune_depth: %d", node->prune_depth);
-    debug(D_VINE, "priority_mode: %d", node->priority_mode);
-
-    if (node->outfile_remote_name) {
-        debug(D_VINE, "outfile_remote_name: %s", node->outfile_remote_name);
-    }
-
-    if (node->outfile) {
-        const char *type_str = "UNKNOWN";
-        switch (node->outfile->type) {
-            case VINE_FILE:       type_str = "VINE_FILE"; break;
-            case VINE_TEMP:       type_str = "VINE_TEMP"; break;
-            case VINE_URL:        type_str = "VINE_URL"; break;
-            case VINE_BUFFER:     type_str = "VINE_BUFFER"; break;
-            case VINE_MINI_TASK:  type_str = "VINE_MINI_TASK"; break;
-        }
-        debug(D_VINE, "outfile_type: %s", type_str);
-        debug(D_VINE, "outfile_cached_name: %s", node->outfile->cached_name ? node->outfile->cached_name : "(null)");
-    } else {
-        debug(D_VINE, "outfile_type: SHARED_FILE_SYSTEM or none");
-    }
-
-    /* print parent and child node keys */
-    char *parent_keys = NULL;
-    struct vine_task_node *p;
-    LIST_ITERATE(node->parents, p) {
-        if (!parent_keys) {
-            parent_keys = string_format("%s", p->node_key);
-        } else {
-            char *tmp = string_format("%s, %s", parent_keys, p->node_key);
-            free(parent_keys);
-            parent_keys = tmp;
-        }
-    }
-
-    char *child_keys = NULL;
-    struct vine_task_node *c;
-    LIST_ITERATE(node->children, c) {
-        if (!child_keys) {
-            child_keys = string_format("%s", c->node_key);
-        } else {
-            char *tmp = string_format("%s, %s", child_keys, c->node_key);
-            free(child_keys);
-            child_keys = tmp;
-        }
-    }
-
-    debug(D_VINE, "parents: %s", parent_keys ? parent_keys : "(none)");
-    debug(D_VINE, "children: %s", child_keys ? child_keys : "(none)");
-
-    free(parent_keys);
-    free(child_keys);
-
-    debug(D_VINE, "-------------------------------------------");
+	if (!node) {
+		return;
+	}
+
+	if (!node->task) {
+		debug(D_ERROR, "node %s has no task", node->node_key);
+		return;
+	}
+
+	debug(D_VINE, "---------------- Node Info ----------------");
+	debug(D_VINE, "key: %s", node->node_key);
+	debug(D_VINE, "task_id: %d", node->task->task_id);
+	debug(D_VINE, "staging_dir: %s", node->staging_dir ? node->staging_dir : "(null)");
+	debug(D_VINE, "depth: %d", node->depth);
+	debug(D_VINE, "height: %d", node->height);
+	debug(D_VINE, "prune_depth: %d", node->prune_depth);
+	debug(D_VINE, "priority_mode: %d", node->priority_mode);
+
+	if (node->outfile_remote_name) {
+		debug(D_VINE, "outfile_remote_name: %s", node->outfile_remote_name);
+	}
+
+	if (node->outfile) {
+		const char *type_str = "UNKNOWN";
+		switch (node->outfile->type) {
+		case VINE_FILE:
+			type_str = "VINE_FILE";
+			break;
+		case VINE_TEMP:
+			type_str = "VINE_TEMP";
+			break;
+		case VINE_URL:
+			type_str = "VINE_URL";
+			break;
+		case VINE_BUFFER:
+			type_str = "VINE_BUFFER";
+			break;
+		case VINE_MINI_TASK:
+			type_str = "VINE_MINI_TASK";
+			break;
+		}
+		debug(D_VINE, "outfile_type: %s", type_str);
+		debug(D_VINE, "outfile_cached_name: %s", node->outfile->cached_name ? node->outfile->cached_name : "(null)");
+	} else {
+		debug(D_VINE, "outfile_type: SHARED_FILE_SYSTEM or none");
+	}
+
+	/* print parent and child node keys */
+	char *parent_keys = NULL;
+	struct vine_task_node *p;
+	LIST_ITERATE(node->parents, p)
+	{
+		if (!parent_keys) {
+			parent_keys = string_format("%s", p->node_key);
+		} else {
+			char *tmp = string_format("%s, %s", parent_keys, p->node_key);
+			free(parent_keys);
+			parent_keys = tmp;
+		}
+	}
+
+	char *child_keys = NULL;
+	struct vine_task_node *c;
+	LIST_ITERATE(node->children, c)
+	{
+		if (!child_keys) {
+			child_keys = string_format("%s", c->node_key);
+		} else {
+			char *tmp = string_format("%s, %s", child_keys, c->node_key);
+			free(child_keys);
+			child_keys = tmp;
+		}
+	}
+
+	debug(D_VINE, "parents: %s", parent_keys ? parent_keys : "(none)");
+	debug(D_VINE, "children: %s", child_keys ? child_keys : "(none)");
+
+	free(parent_keys);
+	free(child_keys);
+
+	debug(D_VINE, "-------------------------------------------");
 }
 
+/**
+ * Prune the ancestors of a node when it is completed.
+ * @param node Reference to the node object.
+ */
 void vine_task_node_prune_ancestors(struct vine_task_node *node)
 {
 	if (!node) {
@@ -545,9 +632,9 @@ void vine_task_node_prune_ancestors(struct vine_task_node *node)
 	int pruned_replica_count = 0;
 
 	if (_node_outfile_is_persisted(node)) {
-		pruned_replica_count = _prune_ancestors_of_persisted_node(node);
+		pruned_replica_count = prune_ancestors_of_persisted_node(node);
 	} else {
-		pruned_replica_count = _prune_ancestors_of_temp_node(node);
+		pruned_replica_count = prune_ancestors_of_temp_node(node);
 	}
 
 	timestamp_t elapsed_time = timestamp_get() - start_time;
@@ -555,20 +642,27 @@ void vine_task_node_prune_ancestors(struct vine_task_node *node)
 	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
 }
 
+/**
+ * Replicate the outfile of a node if it is a temp file.
+ * @param node Reference to the node object.
+ */
 void vine_task_node_replicate_outfile(struct vine_task_node *node)
 {
 	if (!node || !node->outfile) {
 		return;
 	}
 
-    if (node->outfile->type != VINE_TEMP) {
-        return;
-    }
+	if (node->outfile->type != VINE_TEMP) {
+		return;
+	}
 
 	vine_temp_replicate_file_later(node->manager, node->outfile);
 }
 
-/* delete the node and all of its associated resources. */
+/**
+ * Delete the node and all of its associated resources.
+ * @param node Reference to the node object.
+ */
 void vine_task_node_delete(struct vine_task_node *node)
 {
 	if (!node) {
@@ -581,9 +675,9 @@ void vine_task_node_delete(struct vine_task_node *node)
 	if (node->outfile_remote_name) {
 		free(node->outfile_remote_name);
 	}
-    if (node->staging_dir) {
-        free(node->staging_dir);
-    }
+	if (node->staging_dir) {
+		free(node->staging_dir);
+	}
 
 	vine_task_delete(node->task);
 	node->task = NULL;

From 1955fd147491c19501c6cd1112f1750190b699fc Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 15 Oct 2025 16:40:52 -0400
Subject: [PATCH 032/113] use a separate directory

---
 taskvine/src/Makefile                         |  4 +-
 taskvine/src/bindings/python3/Makefile        |  9 ++--
 taskvine/src/graph/GraphInvoker/.gitignore    |  0
 taskvine/src/graph/GraphInvoker/.gitkeep      |  0
 taskvine/src/graph/GraphInvoker/Makefile      | 38 ++++++++++++++++
 .../GraphInvoker}/graph_definition.py         |  0
 .../GraphInvoker}/graph_executor.py           |  0
 .../GraphInvoker}/vine_task_graph.c           |  0
 .../src/graph/GraphInvoker/vine_task_graph.h  | 43 +++++++++++++++++++
 .../GraphInvoker}/vine_task_node.c            |  0
 .../GraphInvoker}/vine_task_node.h            |  0
 taskvine/src/graph/Makefile                   | 13 ++++++
 taskvine/src/graph/README.md                  |  2 +
 taskvine/src/manager/Makefile                 |  5 +--
 taskvine/src/manager/vine_task_graph.h        | 24 -----------
 15 files changed, 106 insertions(+), 32 deletions(-)
 create mode 100644 taskvine/src/graph/GraphInvoker/.gitignore
 create mode 100644 taskvine/src/graph/GraphInvoker/.gitkeep
 create mode 100644 taskvine/src/graph/GraphInvoker/Makefile
 rename taskvine/src/{bindings/python3/ndcctools/taskvine => graph/GraphInvoker}/graph_definition.py (100%)
 rename taskvine/src/{bindings/python3/ndcctools/taskvine => graph/GraphInvoker}/graph_executor.py (100%)
 rename taskvine/src/{manager => graph/GraphInvoker}/vine_task_graph.c (100%)
 create mode 100644 taskvine/src/graph/GraphInvoker/vine_task_graph.h
 rename taskvine/src/{manager => graph/GraphInvoker}/vine_task_node.c (100%)
 rename taskvine/src/{manager => graph/GraphInvoker}/vine_task_node.h (100%)
 create mode 100644 taskvine/src/graph/Makefile
 create mode 100644 taskvine/src/graph/README.md
 delete mode 100644 taskvine/src/manager/vine_task_graph.h

diff --git a/taskvine/src/Makefile b/taskvine/src/Makefile
index 8f828fd7bf..5c8858a2e4 100644
--- a/taskvine/src/Makefile
+++ b/taskvine/src/Makefile
@@ -1,12 +1,12 @@
 include ../../config.mk
 include ../../rules.mk
 
-TARGETS=manager worker tools bindings examples
+TARGETS=manager worker tools bindings examples graph
 
 all: $(TARGETS)
 
 worker: manager
-bindings: manager
+bindings: manager graph
 tools: manager
 examples: manager worker tools bindings
 
diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index ca4ca6a52b..580e25b515 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -4,8 +4,8 @@ include ../../../../rules.mk
 # Python always uses 'so' for its modules (even on Darwin)
 CCTOOLS_DYNAMIC_SUFFIX = so
 # SWIG produces code that causes a lot of warnings, so use -w to turn those off.
-LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager
-LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
+LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager -I ../../graph/GraphInvoker
+LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/libgraphinvoker.a $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
 
 CCTOOLS_FLAKE8_IGNORE_FILES = "cvine.py"
 
@@ -18,7 +18,7 @@ all: $(TARGETS)
 
 vine_wrap.c: taskvine.i
 	@echo "SWIG taskvine.i (python)"
-	@$(CCTOOLS_SWIG) -o vine_wrap.c -outdir ndcctools/taskvine -python -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/manager taskvine.i
+	@$(CCTOOLS_SWIG) -o vine_wrap.c -outdir ndcctools/taskvine -python -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker taskvine.i
 
 $(DSPYTHONSO): vine_wrap.o $(EXTERNAL_DEPENDENCIES)
 
@@ -35,3 +35,6 @@ install: all
 	cp ndcctools/taskvine/*.py $(DSPYTHONSO) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine
 	cp ndcctools/taskvine/compat/*.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/compat
 	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
+	# install GraphInvoker python modules into package path to preserve API
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/graph_definition.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/graph_definition.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/graph_executor.py
diff --git a/taskvine/src/graph/GraphInvoker/.gitignore b/taskvine/src/graph/GraphInvoker/.gitignore
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/taskvine/src/graph/GraphInvoker/.gitkeep b/taskvine/src/graph/GraphInvoker/.gitkeep
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/taskvine/src/graph/GraphInvoker/Makefile b/taskvine/src/graph/GraphInvoker/Makefile
new file mode 100644
index 0000000000..cce5063e1a
--- /dev/null
+++ b/taskvine/src/graph/GraphInvoker/Makefile
@@ -0,0 +1,38 @@
+include ../../../../config.mk
+include ../../../../rules.mk
+
+LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
+LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
+
+SOURCES = vine_task_node.c vine_task_graph.c
+OBJECTS = $(SOURCES:%.c=%.o)
+
+LIBRARIES = libgraphinvoker.a
+PROGRAMS =
+SCRIPTS =
+TARGETS = $(LIBRARIES) $(PROGRAMS)
+
+all: $(TARGETS)
+
+libgraphinvoker.a: $(OBJECTS)
+
+$(PROGRAMS): $(EXTERNALS)
+
+install: all
+	mkdir -p $(CCTOOLS_INSTALL_DIR)/lib
+	cp $(LIBRARIES) $(CCTOOLS_INSTALL_DIR)/lib/
+	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/GraphInvoker/include
+	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/GraphInvoker/include/
+
+clean:
+	rm -rf $(PROGRAMS) $(OBJECTS) *.o
+
+test: all
+
+lint:
+
+format:
+
+.PHONY: all clean install test lint format
+
+
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py b/taskvine/src/graph/GraphInvoker/graph_definition.py
similarity index 100%
rename from taskvine/src/bindings/python3/ndcctools/taskvine/graph_definition.py
rename to taskvine/src/graph/GraphInvoker/graph_definition.py
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py b/taskvine/src/graph/GraphInvoker/graph_executor.py
similarity index 100%
rename from taskvine/src/bindings/python3/ndcctools/taskvine/graph_executor.py
rename to taskvine/src/graph/GraphInvoker/graph_executor.py
diff --git a/taskvine/src/manager/vine_task_graph.c b/taskvine/src/graph/GraphInvoker/vine_task_graph.c
similarity index 100%
rename from taskvine/src/manager/vine_task_graph.c
rename to taskvine/src/graph/GraphInvoker/vine_task_graph.c
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_graph.h b/taskvine/src/graph/GraphInvoker/vine_task_graph.h
new file mode 100644
index 0000000000..658686b514
--- /dev/null
+++ b/taskvine/src/graph/GraphInvoker/vine_task_graph.h
@@ -0,0 +1,43 @@
+#ifndef VINE_TASK_GRAPH_H
+#define VINE_TASK_GRAPH_H
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "list.h"
+#include "vine_manager.h"
+#include "set.h"
+#include "vine_task_node.h"
+
+struct vine_task_graph {
+    struct vine_manager *manager;
+	struct hash_table *nodes;
+	struct itable *task_id_to_node;
+	struct hash_table *outfile_cachename_to_node;
+
+    char *proxy_library_name;
+    char *proxy_function_name;
+
+    double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
+};
+
+
+/* Public APIs for operating the task graph */
+const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg);
+const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
+double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key);
+const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key);
+void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
+struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
+    const char *node_key,
+    const char *staging_dir,
+    int prune_depth,
+    vine_task_node_priority_mode_t priority_mode);
+struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
+void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent);
+void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key);
+void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
+void vine_task_graph_execute(struct vine_task_graph *tg);
+void vine_task_graph_delete(struct vine_task_graph *tg);
+
+
+#endif // VINE_TASK_GRAPH_H
diff --git a/taskvine/src/manager/vine_task_node.c b/taskvine/src/graph/GraphInvoker/vine_task_node.c
similarity index 100%
rename from taskvine/src/manager/vine_task_node.c
rename to taskvine/src/graph/GraphInvoker/vine_task_node.c
diff --git a/taskvine/src/manager/vine_task_node.h b/taskvine/src/graph/GraphInvoker/vine_task_node.h
similarity index 100%
rename from taskvine/src/manager/vine_task_node.h
rename to taskvine/src/graph/GraphInvoker/vine_task_node.h
diff --git a/taskvine/src/graph/Makefile b/taskvine/src/graph/Makefile
new file mode 100644
index 0000000000..257fe8ce69
--- /dev/null
+++ b/taskvine/src/graph/Makefile
@@ -0,0 +1,13 @@
+include ../../../config.mk
+include ../../../rules.mk
+
+SUBDIRS = GraphInvoker
+
+all clean install test lint format: $(SUBDIRS)
+
+$(SUBDIRS): %:
+	$(MAKE) -C $@ $(MAKECMDGOALS)
+
+.PHONY: all clean install test lint format $(SUBDIRS)
+
+
diff --git a/taskvine/src/graph/README.md b/taskvine/src/graph/README.md
new file mode 100644
index 0000000000..8d7a3f59fc
--- /dev/null
+++ b/taskvine/src/graph/README.md
@@ -0,0 +1,2 @@
+# Graph Executors
+
diff --git a/taskvine/src/manager/Makefile b/taskvine/src/manager/Makefile
index 1246f83737..5c56c9f09b 100644
--- a/taskvine/src/manager/Makefile
+++ b/taskvine/src/manager/Makefile
@@ -29,9 +29,7 @@ SOURCES = \
 	vine_fair.c \
 	vine_runtime_dir.c \
 	vine_task_groups.c \
-	vine_temp.c \
-	vine_task_node.c \
-	vine_task_graph.c
+	vine_temp.c
 
 PUBLIC_HEADERS = taskvine.h
 
@@ -42,6 +40,7 @@ TARGETS = $(LIBRARIES)
 
 all: $(TARGETS)
 
+
 libtaskvine.a: $(OBJECTS)
 
 install: all
diff --git a/taskvine/src/manager/vine_task_graph.h b/taskvine/src/manager/vine_task_graph.h
deleted file mode 100644
index a3ed8d3c6b..0000000000
--- a/taskvine/src/manager/vine_task_graph.h
+++ /dev/null
@@ -1,24 +0,0 @@
-#ifndef VINE_TASK_GRAPH_H
-#define VINE_TASK_GRAPH_H
-
-#include "vine_task.h"
-#include "hash_table.h"
-#include "list.h"
-#include "vine_manager.h"
-#include "set.h"
-#include "vine_task_node.h"
-
-struct vine_task_graph {
-    struct vine_manager *manager;
-	struct hash_table *nodes;
-	struct itable *task_id_to_node;
-	struct hash_table *outfile_cachename_to_node;
-
-    char *proxy_library_name;
-    char *proxy_function_name;
-
-    double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
-};
-
-
-#endif // VINE_TASK_GRAPH_H

From 6b1a5db7ea21f0d9baeda382d600230a70b57fc5 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 15 Oct 2025 21:45:24 -0400
Subject: [PATCH 033/113] backup

---
 .../graph/GraphInvoker/graph_definition.py    |  4 +
 .../src/graph/GraphInvoker/vine_task_graph.c  | 73 +++++++++++++------
 .../src/graph/GraphInvoker/vine_task_graph.h  |  4 +-
 .../src/graph/GraphInvoker/vine_task_node.c   | 31 ++++----
 4 files changed, 74 insertions(+), 38 deletions(-)

diff --git a/taskvine/src/graph/GraphInvoker/graph_definition.py b/taskvine/src/graph/GraphInvoker/graph_definition.py
index 1602621bbb..1bf509f72d 100644
--- a/taskvine/src/graph/GraphInvoker/graph_definition.py
+++ b/taskvine/src/graph/GraphInvoker/graph_definition.py
@@ -1,3 +1,7 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
 from ndcctools.taskvine.utils import load_variable_from_library
 
 import os
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_graph.c b/taskvine/src/graph/GraphInvoker/vine_task_graph.c
index 5f64287d1c..394f98c2f8 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_graph.c
+++ b/taskvine/src/graph/GraphInvoker/vine_task_graph.c
@@ -1,30 +1,32 @@
-#include "vine_task_graph.h"
-#include "taskvine.h"
-#include "vine_manager.h"
-#include "vine_task_node.h"
-#include "vine_worker_info.h"
-#include "priority_queue.h"
 #include <stdlib.h>
 #include <string.h>
 #include <stdint.h>
-#include "debug.h"
-#include "stringtools.h"
-#include "xxmalloc.h"
+#include <assert.h>
 #include <math.h>
-#include "hash_table.h"
+#include <signal.h>
+#include <stdio.h>
 #include <sys/stat.h>
-#include "itable.h"
+
+#include "priority_queue.h"
 #include "list.h"
-#include "vine_task.h"
-#include "timestamp.h"
-#include "vine_file.h"
+#include "debug.h"
+#include "itable.h"
+#include "xxmalloc.h"
+#include "stringtools.h"
+#include "hash_table.h"
 #include "set.h"
-#include "vine_mount.h"
+#include "timestamp.h"
 #include "progress_bar.h"
-#include "assert.h"
 #include "macros.h"
-#include <signal.h>
-#include <stdio.h>
+
+#include "vine_task_graph.h"
+#include "vine_manager.h"
+#include "vine_task_node.h"
+#include "vine_worker_info.h"
+#include "vine_task.h"
+#include "vine_file.h"
+#include "vine_mount.h"
+
 
 static volatile sig_atomic_t interrupted = 0;
 
@@ -283,7 +285,34 @@ static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struc
 /*************************************************************/
 
 /**
- * Get the library name of the task graph.
+ * Set the proxy library and function names (Python-side), shared by all tasks.
+ * @param tg Reference to the task graph object.
+ * @param proxy_library_name Reference to the proxy library name.
+ * @param proxy_function_name Reference to the proxy function name.
+ */
+void vine_task_graph_set_proxy_library_and_function_names(struct vine_task_graph *tg,
+	const char *proxy_library_name,
+	const char *proxy_function_name)
+{
+	if (!tg || !proxy_library_name || !proxy_function_name) {
+		return;
+	}
+
+	/* free the existing proxy library and function names if they exist */
+	if (tg->proxy_library_name) {
+		free(tg->proxy_library_name);
+	}
+	if (tg->proxy_function_name) {
+		free(tg->proxy_function_name);
+	}
+
+	/* set the new proxy library and function names */
+	tg->proxy_library_name = xxstrdup(proxy_library_name);
+	tg->proxy_function_name = xxstrdup(proxy_function_name);
+}
+
+/**
+ * Get the proxy library name (Python-side), shared by all tasks.
  * @param tg Reference to the task graph object.
  * @return The library name.
  */
@@ -297,7 +326,7 @@ const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph
 }
 
 /**
- * Get the function name of the task graph.
+ * Get the proxy function name (Python-side), shared by all tasks.
  * @param tg Reference to the task graph object.
  * @return The function name.
  */
@@ -517,8 +546,8 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	tg->task_id_to_node = itable_create(0);
 	tg->outfile_cachename_to_node = hash_table_create(0, 0);
 
-	tg->proxy_library_name = xxstrdup("vine_task_graph_library");
-	tg->proxy_function_name = xxstrdup("compute_single_key");
+	tg->proxy_library_name = xxstrdup("vine_task_graph_library");   // Python-side proxy library name (shared by all tasks)
+	tg->proxy_function_name = xxstrdup("compute_single_key");       // Python-side proxy function name (shared by all tasks)
 	tg->manager = q;
 
 	tg->failure_injection_step_percent = -1.0;
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_graph.h b/taskvine/src/graph/GraphInvoker/vine_task_graph.h
index 658686b514..956b9d8200 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_graph.h
+++ b/taskvine/src/graph/GraphInvoker/vine_task_graph.h
@@ -38,6 +38,8 @@ void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *pare
 void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
 void vine_task_graph_execute(struct vine_task_graph *tg);
 void vine_task_graph_delete(struct vine_task_graph *tg);
-
+void vine_task_graph_set_proxy_library_and_function_names(struct vine_task_graph *tg,
+	const char *proxy_library_name,
+	const char *proxy_function_name);
 
 #endif // VINE_TASK_GRAPH_H
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_node.c b/taskvine/src/graph/GraphInvoker/vine_task_node.c
index eca0c551c4..f3e3e4103d 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_node.c
+++ b/taskvine/src/graph/GraphInvoker/vine_task_node.c
@@ -1,29 +1,30 @@
-#include "vine_task_node.h"
-#include "vine_manager.h"
-#include "vine_task.h"
-#include "vine_file.h"
-#include "vine_task_graph.h"
+#include <assert.h>
+#include <inttypes.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <errno.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+
 #include "jx.h"
 #include "jx_print.h"
 #include "xxmalloc.h"
 #include "stringtools.h"
-#include "taskvine.h"
 #include "timestamp.h"
 #include "set.h"
 #include "hash_table.h"
 #include "debug.h"
-#include "assert.h"
+#include "random.h"
+
+#include "vine_manager.h"
+#include "vine_file.h"
+#include "vine_task.h"
+#include "vine_task_graph.h"
 #include "vine_worker_info.h"
 #include "vine_temp.h"
-#include "random.h"
+#include "vine_task_node.h"
 
-#include <inttypes.h>
-#include <stdlib.h>
-#include <unistd.h>
-#include <string.h>
-#include <errno.h>
-#include <sys/types.h>
-#include <sys/stat.h>
 
 /**
  * Compute a lexicographic priority score from the node key.

From 8cd855ff6a5f7d4d151a51989b2bf1277c5faf57 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 15 Oct 2025 22:18:30 -0400
Subject: [PATCH 034/113] libtask

---
 taskvine/src/bindings/python3/Makefile        |  2 +
 taskvine/src/graph/GraphInvoker/config.py     | 37 +++++++++++++
 .../src/graph/GraphInvoker/graph_executor.py  | 38 +++----------
 .../src/graph/GraphInvoker/library_task.py    | 53 +++++++++++++++++++
 taskvine/src/graph/GraphInvoker/utils.py      | 17 ++++++
 5 files changed, 116 insertions(+), 31 deletions(-)
 create mode 100644 taskvine/src/graph/GraphInvoker/config.py
 create mode 100644 taskvine/src/graph/GraphInvoker/library_task.py
 create mode 100644 taskvine/src/graph/GraphInvoker/utils.py

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index 580e25b515..07e837f6e6 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -35,6 +35,8 @@ install: all
 	cp ndcctools/taskvine/*.py $(DSPYTHONSO) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine
 	cp ndcctools/taskvine/compat/*.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/compat
 	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
+
 	# install GraphInvoker python modules into package path to preserve API
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/graph_definition.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/graph_definition.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/graph_executor.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/library_task.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/library_task.py
diff --git a/taskvine/src/graph/GraphInvoker/config.py b/taskvine/src/graph/GraphInvoker/config.py
new file mode 100644
index 0000000000..e3b8a41fec
--- /dev/null
+++ b/taskvine/src/graph/GraphInvoker/config.py
@@ -0,0 +1,37 @@
+# config.py
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+from dataclasses import dataclass, field
+
+
+@dataclass(frozen=True)
+class DefaultTuneParams:
+    worker_source_max_transfers: int = 100
+    max_retrievals: int = -1
+    prefer_dispatch: int = 1
+    transient_error_interval: int = 1
+    attempt_schedule_depth: int = 1000
+
+
+@dataclass(frozen=True)
+class DefaultPaths:
+    shared_file_system_dir: str = "/project01/ndcms/jzhou24/shared_file_system"
+    staging_dir: str = "/project01/ndcms/jzhou24/staging"
+
+
+@dataclass(frozen=True)
+class DefaultPolicies:
+    replica_placement_policy: str = "random"
+    priority_mode: str = "largest-input-first"
+    scheduling_mode: str = "files"
+    prune_depth: int = 1
+
+
+@dataclass(frozen=True)
+class DefaultOutfileType:
+    outfile_type: dict = field(default_factory=lambda: {
+        "temp": 1.0,
+        "shared-file-system": 0.0,
+    })
diff --git a/taskvine/src/graph/GraphInvoker/graph_executor.py b/taskvine/src/graph/GraphInvoker/graph_executor.py
index 01e7cb8811..b36ba3f129 100644
--- a/taskvine/src/graph/GraphInvoker/graph_executor.py
+++ b/taskvine/src/graph/GraphInvoker/graph_executor.py
@@ -2,6 +2,7 @@
 from ndcctools.taskvine.manager import Manager
 from ndcctools.taskvine.utils import load_variable_from_library, delete_all_files, get_c_constant
 from ndcctools.taskvine.graph_definition import GraphKeyResult, TaskGraph, init_task_graph_context, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
+from ndcctools.taskvine.library_task import LibraryTask
 
 import cloudpickle
 import os
@@ -105,34 +106,9 @@ def __init__(self,
         # initialize the task graph
         self._vine_task_graph = cvine.vine_task_graph_create(self._taskvine)
 
-        # create library task with specified resources
-        self._create_library_task(libcores, hoisting_modules, libtask_env_files)
-
-    def _create_library_task(self, libcores=1, hoisting_modules=[], libtask_env_files={}):
-        assert cvine.vine_task_graph_get_proxy_function_name(self._vine_task_graph) == compute_single_key.__name__
-
-        self.task_graph_pkl_file_name = f"library-task-graph-{uuid.uuid4()}.pkl"
-        self.task_graph_pkl_file_local_path = self.task_graph_pkl_file_name
-        self.task_graph_pkl_file_remote_path = self.task_graph_pkl_file_name
-
-        hoisting_modules += [os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
-                             load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable]
-        if dask:
-            hoisting_modules += [dask]
-        self.libtask = self.create_library_from_functions(
-            cvine.vine_task_graph_get_proxy_library_name(self._vine_task_graph),
-            compute_single_key,
-            library_context_info=[init_task_graph_context, [], {"task_graph_path": self.task_graph_pkl_file_remote_path}],
-            add_env=False,
-            function_infile_load_mode="json",
-            hoisting_modules=hoisting_modules
-        )
-        self.libtask.add_input(self.declare_file(self.task_graph_pkl_file_local_path), self.task_graph_pkl_file_remote_path)
-        for local_file_path, remote_file_path in libtask_env_files.items():
-            self.libtask.add_input(self.declare_file(local_file_path, cache=True, peer_transfer=True), remote_file_path)
-        self.libtask.set_cores(libcores)
-        self.libtask.set_function_slots(libcores)
-        self.install_library(self.libtask)
+        # create library task
+        self.libtask = LibraryTask(libcores=libcores, hoisting_modules=hoisting_modules, env_files=libtask_env_files)
+        self.libtask.install(self, self._vine_task_graph)
 
     def run(self,
             collection_dict,
@@ -222,7 +198,7 @@ def run(self,
                                                    self.task_graph.outfile_remote_name[k])
 
         # save the task graph to a pickle file, will be sent to the remote workers
-        with open(self.task_graph_pkl_file_local_path, 'wb') as f:
+        with open(self.libtask.local_path, 'wb') as f:
             cloudpickle.dump(self.task_graph, f)
 
         # now execute the vine graph
@@ -249,5 +225,5 @@ def __del__(self):
         if hasattr(self, '_vine_task_graph') and self._vine_task_graph:
             cvine.vine_task_graph_delete(self._vine_task_graph)
 
-        if hasattr(self, 'task_graph_pkl_file_local_path') and os.path.exists(self.task_graph_pkl_file_local_path):
-            os.remove(self.task_graph_pkl_file_local_path)
+        if hasattr(self, 'libtask') and self.libtask.local_path and os.path.exists(self.libtask.local_path):
+            os.remove(self.libtask.local_path)
diff --git a/taskvine/src/graph/GraphInvoker/library_task.py b/taskvine/src/graph/GraphInvoker/library_task.py
new file mode 100644
index 0000000000..4b3064907c
--- /dev/null
+++ b/taskvine/src/graph/GraphInvoker/library_task.py
@@ -0,0 +1,53 @@
+import os, uuid, cloudpickle, types, time, random, hashlib, collections
+from ndcctools.taskvine import cvine
+from ndcctools.taskvine.graph_definition import (
+    GraphKeyResult, TaskGraph, compute_dts_key, compute_sexpr_key, 
+    compute_single_key, hash_name, hashable, init_task_graph_context
+)
+from ndcctools.taskvine.utils import load_variable_from_library
+
+
+class LibraryTask:
+    def __init__(self, libcores=16, hoisting_modules=[], env_files={}):
+        self._libtask = None
+
+        self.libcores = libcores
+        self.hoisting_modules = hoisting_modules
+        self.env_files = env_files
+
+        self.local_path = None
+        self.remote_path = None
+
+    def add_hoisting_modules(self, new_modules):
+        assert isinstance(new_modules, list), "new_modules must be a list of modules"
+        self.hoisting_modules.extend(new_modules)
+
+    def add_env_files(self, new_env_files):
+        assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
+        self.env_files.update(new_env_files)
+
+    def install(self, manager, vine_graph):
+        assert cvine.vine_task_graph_get_proxy_function_name(vine_graph) == compute_single_key.__name__
+
+        self.local_path = f"library-task-graph-{uuid.uuid4()}.pkl"
+        self.remote_path = self.local_path
+
+        self.hoisting_modules += [
+            os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
+            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
+        ]
+        lib_name = cvine.vine_task_graph_get_proxy_library_name(vine_graph)
+        self._libtask = manager.create_library_from_functions(
+            lib_name,
+            compute_single_key,
+            library_context_info=[init_task_graph_context, [], {"task_graph_path": self.remote_path}],
+            add_env=False,
+            function_infile_load_mode="json",
+            hoisting_modules=self.hoisting_modules,
+        )
+        self._libtask.add_input(manager.declare_file(self.local_path), self.remote_path)
+        for local, remote in self.env_files.items():
+            self._libtask.add_input(manager.declare_file(local, cache=True, peer_transfer=True), remote)
+        self._libtask.set_cores(self.libcores)
+        self._libtask.set_function_slots(self.libcores)
+        manager.install_library(self._libtask)
\ No newline at end of file
diff --git a/taskvine/src/graph/GraphInvoker/utils.py b/taskvine/src/graph/GraphInvoker/utils.py
new file mode 100644
index 0000000000..d180f368da
--- /dev/null
+++ b/taskvine/src/graph/GraphInvoker/utils.py
@@ -0,0 +1,17 @@
+import inspect
+
+def extract_manager_kwargs(kwargs, base_class):
+    params = set(inspect.signature(base_class.__init__).parameters)
+    super_kwargs = {k: v for k, v in kwargs.items() if k in params}
+    leftover_kwargs = {k: v for k, v in kwargs.items() if k not in params}
+    return super_kwargs, leftover_kwargs
+
+def apply_tuning(manager, tune_dict):
+    for k, v in tune_dict.items():
+        try:
+            vine_param = k.replace("_", "-")
+            manager.tune(vine_param, v)
+            print(f"Tuned {vine_param} to {v}")
+        except Exception as e:
+            print(f"Failed to tune {k}={v}: {e}")
+            raise

From 5cb9b499836d02109c4bf8dbf086d519165cfcdc Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 16 Oct 2025 01:52:29 -0400
Subject: [PATCH 035/113] dagvine

---
 taskvine/src/bindings/python3/Makefile        |  19 ++--
 taskvine/src/graph/Makefile                   |   2 +-
 .../{GraphInvoker => dagvine}/.gitignore      |   0
 .../graph/{GraphInvoker => dagvine}/.gitkeep  |   0
 .../graph/{GraphInvoker => dagvine}/Makefile  |   8 +-
 .../graph/{GraphInvoker => dagvine}/config.py |   0
 .../graph_definition.py                       |   0
 .../graph_executor.py                         |  71 +++++++-------
 .../library_task.py => dagvine/library.py}    |  24 ++---
 taskvine/src/graph/dagvine/params.py          |  78 +++++++++++++++
 .../graph/{GraphInvoker => dagvine}/utils.py  |   0
 .../vine_task_graph.c                         |  90 ++++++++++++++++--
 .../vine_task_graph.h                         |   5 +-
 .../vine_task_node.c                          |  81 +---------------
 .../vine_task_node.h                          |   6 +-
 taskvine/src/manager/stnPTyT6                 | Bin 0 -> 1422314 bytes
 taskvine/src/manager/taskvine.h               |  12 ++-
 taskvine/src/manager/vine_manager.c           |   2 +
 taskvine/src/manager/vine_temp.c              |   5 +-
 19 files changed, 243 insertions(+), 160 deletions(-)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/.gitignore (100%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/.gitkeep (100%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/Makefile (80%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/config.py (100%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/graph_definition.py (100%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/graph_executor.py (77%)
 rename taskvine/src/graph/{GraphInvoker/library_task.py => dagvine/library.py} (75%)
 create mode 100644 taskvine/src/graph/dagvine/params.py
 rename taskvine/src/graph/{GraphInvoker => dagvine}/utils.py (100%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/vine_task_graph.c (92%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/vine_task_graph.h (93%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/vine_task_node.c (89%)
 rename taskvine/src/graph/{GraphInvoker => dagvine}/vine_task_node.h (88%)
 create mode 100644 taskvine/src/manager/stnPTyT6

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index 07e837f6e6..8b9f1bf14e 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -1,11 +1,13 @@
 include ../../../../config.mk
 include ../../../../rules.mk
 
+GRAPH_EXECUTOR_MODULE_NAME = dagvine
+
 # Python always uses 'so' for its modules (even on Darwin)
 CCTOOLS_DYNAMIC_SUFFIX = so
 # SWIG produces code that causes a lot of warnings, so use -w to turn those off.
-LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager -I ../../graph/GraphInvoker
-LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/libgraphinvoker.a $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
+LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager -I ../../graph/${GRAPH_EXECUTOR_MODULE_NAME}
+LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/lib${GRAPH_EXECUTOR_MODULE_NAME}.a $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
 
 CCTOOLS_FLAKE8_IGNORE_FILES = "cvine.py"
 
@@ -18,7 +20,7 @@ all: $(TARGETS)
 
 vine_wrap.c: taskvine.i
 	@echo "SWIG taskvine.i (python)"
-	@$(CCTOOLS_SWIG) -o vine_wrap.c -outdir ndcctools/taskvine -python -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker taskvine.i
+	@$(CCTOOLS_SWIG) -o vine_wrap.c -outdir ndcctools/taskvine -python -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME} taskvine.i
 
 $(DSPYTHONSO): vine_wrap.o $(EXTERNAL_DEPENDENCIES)
 
@@ -36,7 +38,10 @@ install: all
 	cp ndcctools/taskvine/compat/*.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/compat
 	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
 
-	# install GraphInvoker python modules into package path to preserve API
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/graph_definition.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/graph_definition.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/graph_executor.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/GraphInvoker/library_task.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/library_task.py
+	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/graph_definition.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/graph_definition.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/library.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/library.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/params.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/params.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/utils.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/utils.py
+	@echo "# ${GRAPH_EXECUTOR_MODULE_NAME} package" > $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/__init__.py
diff --git a/taskvine/src/graph/Makefile b/taskvine/src/graph/Makefile
index 257fe8ce69..04598b4683 100644
--- a/taskvine/src/graph/Makefile
+++ b/taskvine/src/graph/Makefile
@@ -1,7 +1,7 @@
 include ../../../config.mk
 include ../../../rules.mk
 
-SUBDIRS = GraphInvoker
+SUBDIRS = dagvine
 
 all clean install test lint format: $(SUBDIRS)
 
diff --git a/taskvine/src/graph/GraphInvoker/.gitignore b/taskvine/src/graph/dagvine/.gitignore
similarity index 100%
rename from taskvine/src/graph/GraphInvoker/.gitignore
rename to taskvine/src/graph/dagvine/.gitignore
diff --git a/taskvine/src/graph/GraphInvoker/.gitkeep b/taskvine/src/graph/dagvine/.gitkeep
similarity index 100%
rename from taskvine/src/graph/GraphInvoker/.gitkeep
rename to taskvine/src/graph/dagvine/.gitkeep
diff --git a/taskvine/src/graph/GraphInvoker/Makefile b/taskvine/src/graph/dagvine/Makefile
similarity index 80%
rename from taskvine/src/graph/GraphInvoker/Makefile
rename to taskvine/src/graph/dagvine/Makefile
index cce5063e1a..497c798a4f 100644
--- a/taskvine/src/graph/GraphInvoker/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -7,22 +7,22 @@ LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 SOURCES = vine_task_node.c vine_task_graph.c
 OBJECTS = $(SOURCES:%.c=%.o)
 
-LIBRARIES = libgraphinvoker.a
+LIBRARIES = libdagvine.a
 PROGRAMS =
 SCRIPTS =
 TARGETS = $(LIBRARIES) $(PROGRAMS)
 
 all: $(TARGETS)
 
-libgraphinvoker.a: $(OBJECTS)
+libdagvine.a: $(OBJECTS)
 
 $(PROGRAMS): $(EXTERNALS)
 
 install: all
 	mkdir -p $(CCTOOLS_INSTALL_DIR)/lib
 	cp $(LIBRARIES) $(CCTOOLS_INSTALL_DIR)/lib/
-	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/GraphInvoker/include
-	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/GraphInvoker/include/
+	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include
+	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include/
 
 clean:
 	rm -rf $(PROGRAMS) $(OBJECTS) *.o
diff --git a/taskvine/src/graph/GraphInvoker/config.py b/taskvine/src/graph/dagvine/config.py
similarity index 100%
rename from taskvine/src/graph/GraphInvoker/config.py
rename to taskvine/src/graph/dagvine/config.py
diff --git a/taskvine/src/graph/GraphInvoker/graph_definition.py b/taskvine/src/graph/dagvine/graph_definition.py
similarity index 100%
rename from taskvine/src/graph/GraphInvoker/graph_definition.py
rename to taskvine/src/graph/dagvine/graph_definition.py
diff --git a/taskvine/src/graph/GraphInvoker/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
similarity index 77%
rename from taskvine/src/graph/GraphInvoker/graph_executor.py
rename to taskvine/src/graph/dagvine/graph_executor.py
index b36ba3f129..7b2f4c7323 100644
--- a/taskvine/src/graph/GraphInvoker/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -1,8 +1,11 @@
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.manager import Manager
-from ndcctools.taskvine.utils import load_variable_from_library, delete_all_files, get_c_constant
-from ndcctools.taskvine.graph_definition import GraphKeyResult, TaskGraph, init_task_graph_context, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
-from ndcctools.taskvine.library_task import LibraryTask
+from ndcctools.taskvine.utils import delete_all_files, get_c_constant
+
+from ndcctools.taskvine.dagvine.graph_definition import GraphKeyResult, TaskGraph
+from ndcctools.taskvine.dagvine.params import ManagerTuningParams
+from ndcctools.taskvine.dagvine.params import VineConstantParams
+
 
 import cloudpickle
 import os
@@ -66,9 +69,9 @@ def ensure_task_dict(collection_dict):
 class GraphExecutor(Manager):
     def __init__(self,
                  *args,
-                 libcores=1,
-                 hoisting_modules=[],
-                 libtask_env_files={},
+                 manager_tuning_params=None,
+                 library=None,
+                 worker_cores=16,
                  **kwargs):
 
         signal.signal(signal.SIGINT, self._on_sigint)
@@ -85,44 +88,35 @@ def __init__(self,
         super_kwargs = {k: v for k, v in kwargs.items() if k in super_params}
 
         super().__init__(*args, **super_kwargs)
-        print(f"TaskVine manager \033[92m{self.name}\033[0m listening on port \033[92m{self.port}\033[0m")
+        print(f"TaskVine Manager \033[92m{self.name}\033[0m listening on port \033[92m{self.port}\033[0m")
 
         # tune the manager
-        leftover_kwargs = {k: v for k, v in kwargs.items() if k not in super_params}
-        for key, value in leftover_kwargs.items():
-            try:
-                vine_param = key.replace("_", "-")
-                self.tune(vine_param, value)
-                print(f"Tuned {vine_param} to {value}")
-            except Exception as e:
-                print(f"Failed to tune {key} with value {value}: {e}")
-                exit(1)
-        self.tune("worker-source-max-transfers", 100)
-        self.tune("max-retrievals", -1)
-        self.tune("prefer-dispatch", 1)
-        self.tune("transient-error-interval", 1)
-        self.tune("attempt-schedule-depth", 1000)
+        if manager_tuning_params:
+            assert isinstance(manager_tuning_params, ManagerTuningParams), "manager_tuning_params must be an instance of ManagerTuningParams"
+            for k, v in manager_tuning_params.to_dict().items():
+                print(f"Tuning {k} to {v}")
+                self.tune(k, v)
 
         # initialize the task graph
         self._vine_task_graph = cvine.vine_task_graph_create(self._taskvine)
 
         # create library task
-        self.libtask = LibraryTask(libcores=libcores, hoisting_modules=hoisting_modules, env_files=libtask_env_files)
-        self.libtask.install(self, self._vine_task_graph)
+        self.library = library
+        self.library.install(self, worker_cores, self._vine_task_graph)
 
     def run(self,
             collection_dict,
             target_keys=[],
             replica_placement_policy="random",
             priority_mode="largest-input-first",
-            scheduling_mode="files",
+            # scheduling_mode="files",
             extra_task_output_size_mb=["uniform", 0, 0],
             extra_task_sleep_time=["uniform", 0, 0],
             prune_depth=1,
             shared_file_system_dir="/project01/ndcms/jzhou24/shared_file_system",
             staging_dir="/project01/ndcms/jzhou24/staging",
             failure_injection_step_percent=-1,
-            balance_worker_disk_load=0,
+            vine_constant_params=None,
             outfile_type={
                 "temp": 1.0,
                 "shared-file-system": 0.0,
@@ -130,15 +124,9 @@ def run(self,
         self.target_keys = target_keys
         self.task_dict = ensure_task_dict(collection_dict)
 
-        self.tune("balance-worker-disk-load", balance_worker_disk_load)
-
         cvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, failure_injection_step_percent)
 
-        if balance_worker_disk_load:
-            replica_placement_policy = "disk-load"
-            scheduling_mode = "worst"
-
-        self.set_scheduler(scheduling_mode)
+        # self.set_scheduler(scheduling_mode)
 
         # create task graph in the python side
         print("Initializing TaskGraph object")
@@ -154,8 +142,14 @@ def run(self,
         # the sum of the values in outfile_type must be 1.0
         assert sum(list(outfile_type.values())) == 1.0
 
-        # set replica placement policy
-        cvine.vine_set_replica_placement_policy(self._taskvine, get_c_constant(f"replica_placement_policy_{replica_placement_policy.replace('-', '_')}"))
+        if vine_constant_params:
+            assert isinstance(vine_constant_params, VineConstantParams), "vine_constant_params must be an instance of VineConstantParams"
+            # set replica placement policy
+            cvine.vine_set_replica_placement_policy(self._taskvine, vine_constant_params.get_c_constant_of("replica_placement_policy"))
+            # set worker scheduling algorithm
+            cvine.vine_set_scheduler(self._taskvine, vine_constant_params.get_c_constant_of("schedule"))
+            # set task priority mode
+            cvine.vine_task_graph_set_task_priority_mode(self._vine_task_graph, vine_constant_params.get_c_constant_of("task_priority_mode"))
 
         # create task graph in the python side
         print("Initializing task graph in TaskVine")
@@ -163,8 +157,7 @@ def run(self,
             cvine.vine_task_graph_add_node(self._vine_task_graph,
                                            self.task_graph.vine_key_of[k],
                                            self.staging_dir,
-                                           prune_depth,
-                                           get_c_constant(f"task_priority_mode_{priority_mode.replace('-', '_')}"))
+                                           prune_depth)
             for pk in self.task_graph.parents_of.get(k, []):
                 cvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
 
@@ -198,7 +191,7 @@ def run(self,
                                                    self.task_graph.outfile_remote_name[k])
 
         # save the task graph to a pickle file, will be sent to the remote workers
-        with open(self.libtask.local_path, 'wb') as f:
+        with open(self.library.local_path, 'wb') as f:
             cloudpickle.dump(self.task_graph, f)
 
         # now execute the vine graph
@@ -225,5 +218,5 @@ def __del__(self):
         if hasattr(self, '_vine_task_graph') and self._vine_task_graph:
             cvine.vine_task_graph_delete(self._vine_task_graph)
 
-        if hasattr(self, 'libtask') and self.libtask.local_path and os.path.exists(self.libtask.local_path):
-            os.remove(self.libtask.local_path)
+        if hasattr(self, 'library') and self.library.local_path and os.path.exists(self.library.local_path):
+            os.remove(self.library.local_path)
diff --git a/taskvine/src/graph/GraphInvoker/library_task.py b/taskvine/src/graph/dagvine/library.py
similarity index 75%
rename from taskvine/src/graph/GraphInvoker/library_task.py
rename to taskvine/src/graph/dagvine/library.py
index 4b3064907c..f66badf033 100644
--- a/taskvine/src/graph/GraphInvoker/library_task.py
+++ b/taskvine/src/graph/dagvine/library.py
@@ -7,14 +7,14 @@
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
-class LibraryTask:
-    def __init__(self, libcores=16, hoisting_modules=[], env_files={}):
-        self._libtask = None
+class Library:
+    def __init__(self, hoisting_modules=[], env_files={}):
+        self.libtask = None
 
-        self.libcores = libcores
         self.hoisting_modules = hoisting_modules
         self.env_files = env_files
 
+        self.libcores = -1
         self.local_path = None
         self.remote_path = None
 
@@ -26,7 +26,9 @@ def add_env_files(self, new_env_files):
         assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
         self.env_files.update(new_env_files)
 
-    def install(self, manager, vine_graph):
+    def install(self, manager, libcores, vine_graph):
+        self.libcores = libcores
+
         assert cvine.vine_task_graph_get_proxy_function_name(vine_graph) == compute_single_key.__name__
 
         self.local_path = f"library-task-graph-{uuid.uuid4()}.pkl"
@@ -37,7 +39,7 @@ def install(self, manager, vine_graph):
             load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
         ]
         lib_name = cvine.vine_task_graph_get_proxy_library_name(vine_graph)
-        self._libtask = manager.create_library_from_functions(
+        self.libtask = manager.create_library_from_functions(
             lib_name,
             compute_single_key,
             library_context_info=[init_task_graph_context, [], {"task_graph_path": self.remote_path}],
@@ -45,9 +47,9 @@ def install(self, manager, vine_graph):
             function_infile_load_mode="json",
             hoisting_modules=self.hoisting_modules,
         )
-        self._libtask.add_input(manager.declare_file(self.local_path), self.remote_path)
+        self.libtask.add_input(manager.declare_file(self.local_path), self.remote_path)
         for local, remote in self.env_files.items():
-            self._libtask.add_input(manager.declare_file(local, cache=True, peer_transfer=True), remote)
-        self._libtask.set_cores(self.libcores)
-        self._libtask.set_function_slots(self.libcores)
-        manager.install_library(self._libtask)
\ No newline at end of file
+            self.libtask.add_input(manager.declare_file(local, cache=True, peer_transfer=True), remote)
+        self.libtask.set_cores(self.libcores)
+        self.libtask.set_function_slots(self.libcores)
+        manager.install_library(self.libtask)
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/params.py b/taskvine/src/graph/dagvine/params.py
new file mode 100644
index 0000000000..4e21e10916
--- /dev/null
+++ b/taskvine/src/graph/dagvine/params.py
@@ -0,0 +1,78 @@
+from dataclasses import dataclass
+from ndcctools.taskvine.utils import get_c_constant
+
+
+@dataclass
+class ManagerTuningParams:
+    worker_source_max_transfers: int = 100
+    max_retrievals: int = -1
+    prefer_dispatch: int = 1
+    transient_error_interval: int = 1
+    attempt_schedule_depth: int = 10000
+    temp_replica_count: int = 1
+    enforce_worker_eviction_interval: int = -1
+    balance_worker_disk_load: int = 0
+
+    def update(self, params: dict):
+        """Update configuration from a dict.
+        - Converts '-' to '_' in all keys.
+        - Creates new attributes if they don't exist.
+        """
+        if not isinstance(params, dict):
+            raise TypeError(f"update() expects a dict, got {type(params).__name__}")
+
+        for k, v in params.items():
+            normalized_key = k.replace("-", "_")
+            setattr(self, normalized_key, v)
+        return self
+
+    def to_dict(self):
+        """Convert all current attributes (including dynamically added ones)
+        to a dict, replacing '_' with '-'.
+        """
+        return {k.replace("_", "-"): v for k, v in self.__dict__.items()}
+
+
+@dataclass
+class VineConstantParams:
+    """
+    All attributes are accessed in lower case for the convenience of the users.
+    If there is a need to use these values in the C code, convert them to uppercase and call the get_c_constant_of method to get the C constant.
+    """
+
+    replica_placement_policy: str = "random"
+    schedule: str = "worst"
+    task_priority_mode: str = "largest_input_first"
+
+    valid_normalized_values = {
+        "replica_placement_policy": {"random", "disk_load", "transfer_load"},
+        "schedule": {"files", "time", "rand", "worst", "disk"},
+        "task_priority_mode": {"random", "depth_first", "breadth_first", "fifo", "lifo", "largest_input_first", "largest_storage_footprint_first"},
+    }
+
+    def normalize(self, obj):
+        """Normalize a string by converting '-' to '_' and uppercase the string."""
+        return obj.replace("-", "_").lower()
+
+    def update(self, params: dict):
+        """Update configuration from a dict.
+        - Converts '-' to '_' in all keys and values, and uppercase the values.
+        - Creates new attributes if they don't exist.
+        """
+        if not isinstance(params, dict):
+            raise TypeError(f"update() expects a dict, got {type(params).__name__}")
+
+        for k, v in params.items():
+            normalized_key = self.normalize(k)
+            normalized_value = self.normalize(v)
+            assert normalized_key in self.valid_normalized_values, f"Invalid key: {normalized_key}"
+            assert normalized_value in self.valid_normalized_values[normalized_key], f"Invalid value: {normalized_value} for key: {normalized_key}"
+            setattr(self, normalized_key, normalized_value)
+        return self
+
+    def get_c_constant_of(self, key):
+        """Get the C constant of a key."""
+        normalized_key = self.normalize(key)
+        if normalized_key not in self.valid_normalized_values:
+            raise ValueError(f"Invalid key: {normalized_key}")
+        return get_c_constant(f"{normalized_key.upper()}_{getattr(self, normalized_key).upper()}")
\ No newline at end of file
diff --git a/taskvine/src/graph/GraphInvoker/utils.py b/taskvine/src/graph/dagvine/utils.py
similarity index 100%
rename from taskvine/src/graph/GraphInvoker/utils.py
rename to taskvine/src/graph/dagvine/utils.py
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_graph.c b/taskvine/src/graph/dagvine/vine_task_graph.c
similarity index 92%
rename from taskvine/src/graph/GraphInvoker/vine_task_graph.c
rename to taskvine/src/graph/dagvine/vine_task_graph.c
index 394f98c2f8..cdc37dddc4 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_graph.c
+++ b/taskvine/src/graph/dagvine/vine_task_graph.c
@@ -13,6 +13,7 @@
 #include "itable.h"
 #include "xxmalloc.h"
 #include "stringtools.h"
+#include "random.h"
 #include "hash_table.h"
 #include "set.h"
 #include "timestamp.h"
@@ -43,6 +44,63 @@ static void handle_sigint(int signal)
 	interrupted = 1;
 }
 
+/**
+ * Calculate the priority of a node given the priority mode.
+ * @param node Reference to the node object.
+ * @param priority_mode Reference to the priority mode.
+ * @return The priority.
+ */
+static double vine_task_node_calculate_priority(struct vine_task_node *node, vine_task_priority_mode_t priority_mode)
+{
+	if (!node) {
+		return 0;
+	}
+
+	double priority = 0;
+	timestamp_t current_time = timestamp_get();
+
+	struct vine_task_node *parent_node;
+
+	switch (priority_mode) {
+	case VINE_TASK_PRIORITY_MODE_RANDOM:
+		priority = random_double();
+		break;
+	case VINE_TASK_PRIORITY_MODE_DEPTH_FIRST:
+		priority = (double)node->depth;
+		break;
+	case VINE_TASK_PRIORITY_MODE_BREADTH_FIRST:
+		priority = -(double)node->depth;
+		break;
+	case VINE_TASK_PRIORITY_MODE_FIFO:
+		priority = -(double)current_time;
+		break;
+	case VINE_TASK_PRIORITY_MODE_LIFO:
+		priority = (double)current_time;
+		break;
+	case VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST:
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (!parent_node->outfile) {
+				continue;
+			}
+			priority += (double)vine_file_size(parent_node->outfile);
+		}
+		break;
+	case VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (!parent_node->outfile) {
+				continue;
+			}
+			timestamp_t parent_task_completion_time = parent_node->task->time_workers_execute_last;
+			priority += (double)vine_file_size(parent_node->outfile) * (double)parent_task_completion_time;
+		}
+		break;
+	}
+
+	return priority;
+}
+
 /**
  * Submit a node to the taskvine manager.
  * @param tg Reference to the task graph object.
@@ -54,7 +112,12 @@ static void submit_node_task(struct vine_task_graph *tg, struct vine_task_node *
 		return;
 	}
 
-	int task_id = vine_task_node_submit(node);
+	/* calculate the priority of the node */
+	double priority = vine_task_node_calculate_priority(node, tg->task_priority_mode);
+	vine_task_set_priority(node->task, priority);
+	/* submit the task to the manager */
+	int task_id = vine_submit(node->manager, node->task);
+	/* insert the task id to the task id to node map */
 	itable_insert(tg->task_id_to_node, task_id, node);
 
 	return;
@@ -504,15 +567,13 @@ void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
  * @param node_key Reference to the node key.
  * @param staging_dir Reference to the staging directory.
  * @param prune_depth Reference to the prune depth.
- * @param priority_mode Reference to the priority mode.
  * @return A new node object.
  */
 struct vine_task_node *vine_task_graph_add_node(
 		struct vine_task_graph *tg,
 		const char *node_key,
 		const char *staging_dir,
-		int prune_depth,
-		vine_task_node_priority_mode_t priority_mode)
+		int prune_depth)
 {
 	if (!tg || !node_key) {
 		return NULL;
@@ -526,8 +587,7 @@ struct vine_task_node *vine_task_graph_add_node(
 				tg->proxy_library_name,
 				tg->proxy_function_name,
 				staging_dir,
-				prune_depth,
-				priority_mode);
+				prune_depth);
 		hash_table_insert(tg->nodes, node_key, node);
 	}
 
@@ -550,6 +610,7 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	tg->proxy_function_name = xxstrdup("compute_single_key");       // Python-side proxy function name (shared by all tasks)
 	tg->manager = q;
 
+	tg->task_priority_mode = VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
 	tg->failure_injection_step_percent = -1.0;
 
 	/* enable debug system for C code since it uses a separate debug system instance
@@ -580,6 +641,23 @@ void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *
 
 	debug(D_VINE, "setting failure injection step percent to %lf", percent);
 	tg->failure_injection_step_percent = percent;
+
+	return;
+}
+
+/**
+ * Set the task priority mode for the task graph.
+ * @param tg Reference to the task graph object.
+ * @param priority_mode Reference to the priority mode.
+ */
+void vine_task_graph_set_task_priority_mode(struct vine_task_graph *tg, vine_task_priority_mode_t priority_mode)
+{
+	if (!tg) {
+		return;
+	}
+
+	tg->task_priority_mode = priority_mode;
+	return;
 }
 
 /**
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_graph.h b/taskvine/src/graph/dagvine/vine_task_graph.h
similarity index 93%
rename from taskvine/src/graph/GraphInvoker/vine_task_graph.h
rename to taskvine/src/graph/dagvine/vine_task_graph.h
index 956b9d8200..488d520bca 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_graph.h
+++ b/taskvine/src/graph/dagvine/vine_task_graph.h
@@ -7,6 +7,7 @@
 #include "vine_manager.h"
 #include "set.h"
 #include "vine_task_node.h"
+#include "taskvine.h"
 
 struct vine_task_graph {
     struct vine_manager *manager;
@@ -17,6 +18,7 @@ struct vine_task_graph {
     char *proxy_library_name;
     char *proxy_function_name;
 
+    vine_task_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
     double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
 };
 
@@ -30,8 +32,7 @@ void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
 struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
     const char *node_key,
     const char *staging_dir,
-    int prune_depth,
-    vine_task_node_priority_mode_t priority_mode);
+    int prune_depth);
 struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
 void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent);
 void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key);
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_node.c b/taskvine/src/graph/dagvine/vine_task_node.c
similarity index 89%
rename from taskvine/src/graph/GraphInvoker/vine_task_node.c
rename to taskvine/src/graph/dagvine/vine_task_node.c
index f3e3e4103d..c563ff459f 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_node.c
+++ b/taskvine/src/graph/dagvine/vine_task_node.c
@@ -20,10 +20,10 @@
 #include "vine_manager.h"
 #include "vine_file.h"
 #include "vine_task.h"
-#include "vine_task_graph.h"
 #include "vine_worker_info.h"
 #include "vine_temp.h"
 #include "vine_task_node.h"
+#include "taskvine.h"
 
 
 /**
@@ -51,7 +51,6 @@ double compute_lex_priority(const char *key)
  * @param proxy_function_name Reference to the proxy function name.
  * @param staging_dir Reference to the staging directory.
  * @param prune_depth Reference to the prune depth.
- * @param priority_mode Reference to the priority mode.
  * @return A new node object.
  */
 struct vine_task_node *vine_task_node_create(
@@ -60,8 +59,7 @@ struct vine_task_node *vine_task_node_create(
 		const char *proxy_library_name,
 		const char *proxy_function_name,
 		const char *staging_dir,
-		int prune_depth,
-		vine_task_node_priority_mode_t priority_mode)
+		int prune_depth)
 {
 	if (!manager || !node_key || !proxy_library_name || !proxy_function_name || !staging_dir) {
 		return NULL;
@@ -73,7 +71,6 @@ struct vine_task_node *vine_task_node_create(
 	node->node_key = xxstrdup(node_key);
 	node->staging_dir = xxstrdup(staging_dir);
 
-	node->priority_mode = priority_mode;
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
 	node->parents = list_create();
 	node->children = list_create();
@@ -195,62 +192,6 @@ static int _node_outfile_is_persisted(struct vine_task_node *node)
 	return 0;
 }
 
-/**
- * Calculate the priority of a node given the priority mode.
- * @param node Reference to the node object.
- * @return The priority.
- */
-double vine_task_node_calculate_priority(struct vine_task_node *node)
-{
-	if (!node) {
-		return 0;
-	}
-
-	double priority = 0;
-	timestamp_t current_time = timestamp_get();
-
-	struct vine_task_node *parent_node;
-
-	switch (node->priority_mode) {
-	case VINE_TASK_PRIORITY_MODE_RANDOM:
-		priority = random_double();
-		break;
-	case VINE_TASK_PRIORITY_MODE_DEPTH_FIRST:
-		priority = (double)node->depth;
-		break;
-	case VINE_TASK_PRIORITY_MODE_BREADTH_FIRST:
-		priority = -(double)node->depth;
-		break;
-	case VINE_TASK_PRIORITY_MODE_FIFO:
-		priority = -(double)current_time;
-		break;
-	case VINE_TASK_PRIORITY_MODE_LIFO:
-		priority = (double)current_time;
-		break;
-	case VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST:
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (!parent_node->outfile) {
-				continue;
-			}
-			priority += (double)vine_file_size(parent_node->outfile);
-		}
-		break;
-	case VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (!parent_node->outfile) {
-				continue;
-			}
-			timestamp_t parent_task_completion_time = parent_node->task->time_workers_execute_last;
-			priority += (double)vine_file_size(parent_node->outfile) * (double)parent_task_completion_time;
-		}
-		break;
-	}
-
-	return priority;
-}
-
 /**
  * Update the critical time of a node.
  * @param node Reference to the node object.
@@ -512,23 +453,6 @@ static int prune_ancestors_of_persisted_node(struct vine_task_node *node)
 	return pruned_replica_count;
 }
 
-/**
- * Submit a node to the taskvine manager.
- * @param node Reference to the node object.
- * @return The task id.
- */
-int vine_task_node_submit(struct vine_task_node *node)
-{
-	if (!node) {
-		return -1;
-	}
-
-	double priority = vine_task_node_calculate_priority(node);
-	vine_task_set_priority(node->task, priority);
-
-	return vine_submit(node->manager, node->task);
-}
-
 /**
  * Print the info of the node.
  * @param node Reference to the node object.
@@ -551,7 +475,6 @@ void vine_task_node_print_info(struct vine_task_node *node)
 	debug(D_VINE, "depth: %d", node->depth);
 	debug(D_VINE, "height: %d", node->height);
 	debug(D_VINE, "prune_depth: %d", node->prune_depth);
-	debug(D_VINE, "priority_mode: %d", node->priority_mode);
 
 	if (node->outfile_remote_name) {
 		debug(D_VINE, "outfile_remote_name: %s", node->outfile_remote_name);
diff --git a/taskvine/src/graph/GraphInvoker/vine_task_node.h b/taskvine/src/graph/dagvine/vine_task_node.h
similarity index 88%
rename from taskvine/src/graph/GraphInvoker/vine_task_node.h
rename to taskvine/src/graph/dagvine/vine_task_node.h
index cd8e98afe3..12fea69230 100644
--- a/taskvine/src/graph/GraphInvoker/vine_task_node.h
+++ b/taskvine/src/graph/dagvine/vine_task_node.h
@@ -46,7 +46,6 @@ struct vine_task_node {
     timestamp_t time_spent_on_prune_ancestors_of_temp_node;
     timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
 
-    vine_task_node_priority_mode_t priority_mode;
     vine_task_node_outfile_type_t outfile_type;
     prune_status_t prune_status;
 };
@@ -57,18 +56,15 @@ struct vine_task_node *vine_task_node_create(
     const char *proxy_library_name,
     const char *proxy_function_name,
     const char *staging_dir,
-    int prune_depth,
-    vine_task_node_priority_mode_t priority_mode
+    int prune_depth
 );
 
 void vine_task_node_delete(struct vine_task_node *node);
 double compute_lex_priority(const char *key);
 void vine_task_node_prune_ancestors(struct vine_task_node *node);
-double vine_task_node_calculate_priority(struct vine_task_node *node);
 void vine_task_node_print_info(struct vine_task_node *node);
 void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time);
 void vine_task_node_replicate_outfile(struct vine_task_node *node);
-int vine_task_node_submit(struct vine_task_node *node);
 void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
 void vine_task_node_checkpoint_outfile(struct vine_task_node *node);
 
diff --git a/taskvine/src/manager/stnPTyT6 b/taskvine/src/manager/stnPTyT6
new file mode 100644
index 0000000000000000000000000000000000000000..8e72ad4194d84b33a7e9579a081911edd52e2da0
GIT binary patch
literal 1422314
zcmeFa3wT`Bbv8W0PH>FLk-;HuLYhf3E;3lQ6fUue0gWxenKHIjTLuv>vMh}(1zA!x
zGqxOV#-p))auA<eprPNBw)}0{^885~+K}Qv0NDo1Kmx`IiGef*a$}-Uh?5wTOZC6+
z+Lv?Y2F~~O`=9@RzHc7OGiP7cUVH7e*IIk+wfFhR($3+o-iv20iWYwwKXF0B`Ag0{
z_v7bAqYaW3{y!RB(s;pns>ZsRkw{HbBr@-B|Igq54{306%l1h4Z^p+y5Gnn8&)MIP
z6#f0{w#du{+u!-`x2HvB>c3MyeMLn6{{HO9Ddz8)OCzV8;NPs}r$zpE{X6yLO_Bdq
zfA78Pg^2xo_^%`HJ;6U`{K81-U+uXIBSn7?eL7P6t4HK-_PPrr_V4zmBeTPQ-}`A~
zcIfZ4#Kn=f{rlG^Bd49f-|6nnk$3$2!LK88nvcEn-@ZeUIrw`Y_`bs5;HK1Y*WkvD
zeVI(EyJI+&9?TARr8+W$na=*mroMqx$HvZq&JC&Ij&y3EyEr8?+&Pf$K~|=3V=A&C
zmFd_#ID9>xJ2!Rq^>?oCPjz(nrLXT;za^7ON4it}sZ7cg>FMiFMN%VunU3z%`s{{|
zjj41R%~WZit8=Kct1q)9fUF9p2Bejt6p_%_q*WGLu9~N-4W}~M;Q@5Ii&WUsk?Bld
zUsC&RikP;C2ZsiSGkt>to&A=6B~XUmrVJ}9jME@sx~n(Uo$XHz2T22+Ag+uADI7ep
z_|S0Q;4tVCl$Jhp^rw0<9bJRjfe`4fP7LYb28`n{daE&1Kn90W!(kvpo#`}&QV+M3
z(J37=Zi0;=@W#P`z6`J!*r2e`&mEhGJBL&XxGLL^zGXs%G*k5rq=8j`M}Ob?;m%>*
z55sXieFNPlrz4ZvIMm;n(WF@4KiGABNAF-7JlB`$6%HKC>fQ#Ks{QOhwG=cRkgj{U
zvu^<10KW?4fYfL@OrGmgsiDsPzD=o)zJUy=X=Vxu736VJSd^G$x-~SM!lW6-bn6-%
z7)W)IcQolVRRY%P!nEi}_ku^dOz+a!jT<|M`#xi)QfMUCcMf!K?&}6U`ui}W6;N_b
zs;7tT0ApJu$ixU_G?3oxzy?eN2!x?5QY~UCT~*P@sc8#_DoO<-^>mab%FOJPex}Pa
zG3hpdRe-aBg;B`#fxze@m^QTm%mw)&OsAi>pzz@J*`bcX;f}81lw}KpTVGm}wj<p?
zxLM1bw1KAC?ClGy_R{J8q6P+sNR$rYr~W>0UlIJGArIq~$qs17?d<BxZp@OAMcn9C
zFhsUzMh2(BFe5>JmE=m*`ZPO{=|a`Q$+lWg-!OWCc`%41c5OozEEhCu3vL|j)?Faj
zAh~mdY}}OvLmO$M32Vz3928VD4JfI?=$Xz|%Qxto{I1@?!E`DFp$E)BpsJa!&VjB}
zKj*SE)K{XrhEp3M^o?|>SS8b`d0T^`un>_X05gMVn);)-R|A6`n>)i(PiB{;mnxhc
z>Lvq#K$OVE0HBRFsT59J*3O28L-(a)qoKyoFjy-jm9qogsjmLc;c%Lvn4U9%2sat!
zRmxNJpjMOio!#Ang~2tuo&pG*k?!lJa<=1Q+SCJ}EQVqdq<gb43kEk2=!vUxRY^+2
zY=)VU)TX{JFgRr1;Krho%F>9?U@-#>gQlnm$EZUwjHZ7uYN0%Es9_vKk?gQm876^>
zNnvPG)@LDZwFWn77_hz&6-+WTbZ1G)A<U-U!D5JD1FUw7(?*5|2Q!+h4Y;n}zG00_
zPb$;Z8)6JFnl`mMhjbApWkv=%Yy#~9%799mTDTF~5k_4(12Gf24oc&lGc|`8K44X2
zGE@aYz#x3bz~E*@1XEjQlqZJAAY8bd5ecGiz@T1&T@TdOAT**eY=?)TM2lN1Dbk<n
ze1{S;Wh=wbg29?42J>>A4?7VCP*2|o%m^#H!;{HalIR=e$i^X=P!Uy4_of$^cBBRd
zvm1H?F<QNd*z#g+3AxNn*A^>q38q^ykj@P-te|BA+FRsAo|Vi^o2mN<u?~T@K`G4A
zRx8m#(N=ddtcG=xmJec3=p>-<X{~IvRPOlGEY<`HR8bPdHoL5IXk%m6&=NQ5PwZ}M
zVVfs4`BW{V5MhyojF%uaj9`%3H8`a43DP#EI@4JQd$K@(e_3|0W(%r_;Z}wR*jCG-
zpd@5^X*sKRf>PE>36iJ`LKKxj4);_gph>Mf<r&pe+GLey0D+;b5Re41JFrxRzz?NT
ze(2Q$nD|e#eK4#;*{o!;u?*V;Z4}N9*RGJw+CA9;F<oiu89UkHV>44DsV>MdV<XuD
zsew%$n+$1fDlCV<rnRY{Bz01{^ZHbnFhpV_%oW3pwmc_fNmsiDLB^7_4MWC)ur&=u
zst}BJECfTCP((tKsfxnGWHT%u*jA*x<rtf6`J@C-Yj4?-#)1qL6gvY3KbSt0s-%Ee
z8|h4Hpi55#0hED-L_o01pb;T1m6i!pi9kiBg+MY*l`KgNbVW%<nf8+AEo>^Vk{SwB
zSXGr&DX|)CF1al$<~sVENsWXDgbgZtp#x5n>#bA8R#pZ^l}zw!-|*nTMr+JVH4bum
zpmPW-(XfUO@<`agZDG@k{S!91Sl@?;5{Nik7Tf~oL8wevI7%tbVY;x&<w7w>NjWeA
z){|lWV6rjtEW9*KOtav&iQ=y6DxTx4U4|kPF$}|jZ^y!*%OY?r*yN2A2wkCGYPjN!
z3$rR01a!|8*=QDw<c6S>3SmB{jkiH+QGj(=;nmSI3|l&E{z)MYf4QV9FHFM_dX9cR
zg@h!8C4VnC5|#)IIT<rpU0epqv<#>swMaiB{v}}}#G+W2!9-HvIRgfaWR|2fTn8Zp
zdOM+Ldpid<7|}0<L}i9b+3Bf3WY?!NeHr3coDrD&QjU-4O$S|&dYmLZJgFt2WGYKq
z$oiM(u<0)eY95D>3>*DYB5d)K`k5_5;jSxpZU_K}GEh?+X}%O0Au1(2hPsS3KDc7w
z%3(7ck46TElRA1+omldzHj4^}48Y>_5;<Q4O&MsFplQ>sRGk#nHcsJ6^@Z;`l*wHw
zUmM?*vW)($UKwjDXwXbp(pWE-B3&_^!d@_)&#9*yuaH~9Pb^&802!n@fF3L#F-$V8
zEU@y)2+7nL@;d9~b}(7XX0PaCELb`^2eg<qPQeQOF3AehQ`mbrHPqkN)mg-%MHyjE
zEy_?6o|+I-7;D<pCacoSimh*;XRsKuUhPRn5#(@&a-%517J*VOjez2?DM}g;X<7z7
zNQKZVt1iA+N=dZ^qVfX=WLX;}S>bL3S=uFD3M`~A%F5D7DDE_F_Q={PC?dZ~6Z_K2
zPimxYP@INgNv3un2D>;^pbBDnmL{~Ap1s3^nT+A{@}i=;up4FV#mYs}*)F=;t2Id9
z1J=>mwC;I1kj;HV#vxw~h%6By1F<hwtw>j}3@dMfCV|xMDA8|blBmou7Z%M3m5r4+
zHhUBT6|#$%n+nAM5A7yZs3wd5u&Az3Mnf`6qe2O3!?YOIrUnVs1=wNf3><-j8&jKm
zQ)VGh0Ujw<vP00***C1^5Yg@7_5i0)grpz9jsgV625tg%!!aHiPHjL_@Lz^f73r|3
zkmU`EVP}OdqOh66hKD-24`bZBHbp~HP;9DEDCOlvzN*sXWz()qdp1!et9ZLiB+Q24
z!R%1F13P(r8wSF<7^<T~XNDM1EE`}ujIM<DS5<?OYe!VsW!5`aDU(|s#wei8q#zpz
zcBe_I!dC0nenwC*t+`dYuk``80=rUNq;w1oLP2baEGi8IDh>-Odph^LkL$E`Gewvg
zR~v?8;ozd;G?=MnX<G7^rCV2>&CzxWN6e;Kqs68aDR7$_(ylfw%;-U4NJH5~t5|G`
zmBBWpOwQPxa63xy*et_^;C`DH;xVQbQ4k5yaAelU&uhHk<DXFfH#Rg}a2{f^&b#1(
z#phqZL0LERmX_qDC)LzM%%>)DaU^&$sgX$U!FSt-Ci&GAxu|BTDjK~_B_Tb2WlQ5!
z{ECEkEWS40wswu{{l?Axtj_fx?X8VOx|9Bbd37k3^!j6S<KA=bSbwZ`>U{**<9xU|
z5^?>9SkN77i_LJo|4>=^@yuDS-yECKyrj1``@I$UW0~2mKQuS#y=e+$_s6FuCim=O
zvANyuIn$+?>}hW9vASmO_|@0OuZdq9zb@XfPt~9YXkI#ke;4ELX8a9wViN`25}nuI
z9Z_B&`AOf8{GfM7eke9mzahgUtw(uEq5yQM{@DYQzxzU@%v69i(1<vb#8o6bSKl{)
zeeJ$(6pYT}|B=i{G&9J@x_RmO1P~!dOa9f@&Ac|k@lR7eaSuJxhY4H{nD9?<i@Tnl
zrW9r}*U&Q~3fFopyY(+Po9Zb~BV2&i>$w%tQn6l}g~Y?uI4d0;TrZ&v-4RA_z&ME-
zgPndLZp(ASJKCM<>7)Z8JJ8=Z0Ft5K^U{leeJg}ow9N#KMAiOQcWE-ZK!x2MSuLA=
zQ4=f@mG0VFS0q-pbgYc8Xo)P3x5bmIF6(ett!azYUlBb^O+u2q`>aTmDQ3AtBAylL
zg8CTjPuFXwh}fy=g|bYK*4G=aOT9`*4Zx_^Zr}RB0r-6JY~m0|A3V}Y5BCM>e|<ge
zeC3@kX(_UBQEAGWwab^ctXUIDtZZG|*0Cb7W=&${Wsy~D+rp1)+M1DKbJrv;TNzJA
zR=2EKwRZLLmX4NoH@<dFTVmD9$clJ-N6X6Qj<y5{vv%d>D_32)GIHsv)obFHx2W9J
zEp4k4Eo-FYmGNX!6<x7vWuk4>>W-Gxt5>Zy&9|+NuUvC!i%GpS(caSBkz56OqbZBc
z^7zW-Ey-j{b0nEqwmQE0D&Ui7i>!&SY+kks*o2T%z3b5Bgny|C6uX1a>R)8>!iI$n
z(dL#bT9T_;SG25bi-doNb;rW4NX6I=>_PVpMZ!@f_>Bc3c4?u&kd+;{9=fx5Cpp4R
zpv{=0+5YZ<vocY{=nO<*9#AR+Gc|+Pw8dAqA+k!bxG-VsDx}D-<f<z><f(0WD+r|@
zB+E@)<_3Ae6J`cGRF8Jji_}Jeo>WoM*9!155cA4JbDJCC@@;S!MY>XvaFmA-Q<kHV
zP6U=Ae5T&)>eP3qhG4arIZzMts<V4b{Xo4;DASjEvv98;hTTBnWCRHVF6y<^P;w%o
zqEqU*h~1doSn{ZaNu+P%##DD7fI$?gc&~_!)v@y@ltgJn7hwP3zy=Xbe1LpLb^7ih
z9MciB7$9mY=y@E#R6N1S2zw2?xS&{9sy-YO2AIlGlLi9?;bhg4H}?)gxGH*aYp<T$
z;q|?#>@bW~co7Y>`n2rA*CXB}(}#6*YB<uF-h$m_IC!^&QzgL2c9P?Tre)z>ugrcs
z8XyAU7^2#AQydIY-?ar+q+$nbgVz&W8t^pHrAi+dzaBAAgTn!txa|&MHLM30)CIA%
zQZs5IM0?JIdPTK*mNclOP1%Zh{ezv|^`c|ay_kOZ4KV2~V8V^U%;fw4C8c+QXOg^L
zS;_&C)dZm}8Wa?SSXlXy@ijP1M?BL9Qigxi5!u(2k*pWDNdQ4ME9#8`)bl<aNy9Q;
zKR7}pHk&~pP*c!sEUoYC=cF_fMHB)19?@I;5%Cj>e;OQ@8SEPDk09150!9LtAnDUk
z+7X%aqL#H3z&2-v*tLOFhU0{F6ij@~$rOwQF$OrKGzQcYqsqiJtRCT$F{7&z7_<nv
zpd&pcEqGKLTQ*nkhuLR#Fet3e7!7H2s&7LtqFXf@655Il1I&`56b(}0q6!JraDo6f
zSnF?wKheZt1CSXiPF8+_=Ti(9P{|U>)3GtV0nM_UPzyn$>Iusj*e4(rv!EO3^^*8I
zRaxz?uz+b*EP1p!FgO&+)L*QUqZeHi-5j~T55~~E?wL%-5N1-*i=!g;+v003?^xXu
zZ@$XPUrhodoGg{P2NAKRx{f6?4IuTPVxjnK5D|YyX&4zfJrq?YkLeV)HA@SEdRR%9
z6xWGt0bS-&94x6LU5SP$-E7vHk7*DS(MAR%+Mf1deKx(tK74u*+ATm`xk|#%Z~~-5
z1qeyD0WAcoANwF{Q$-hvivUYO)Ec%@(l=nd)JSh<7LumBL+eD%2=HMr<OU0EQrWOj
z$A-Z{{iyjUlwx|S_5n4Al_aX-5_?Ua%)kIa7&g2s!j#>x-r>$t{@!5bNIWiLk_Mpr
z(uPSGeQ5*$`3X7t(MmyhV^jvI5&mt&u}Rx3LD{<ST4ndpwg6Dr*0M&pFnSj4;y+p2
zvbLoI77o^Hk>zTWr=DW#!YFq<7xiW~_RpLdS=!rpvEhj*!s<Gs@z%uBMM#Y-&Gui6
z0*mCU0t7e_`UU_Z0uyX_BuceFo6oLqB*s_xo(vZWqT0<k8%3Lr=!I6KGYi{Boa0<*
zD8~}Fx6BfzXl)hfNbU-XFg9AO-lT{TYB&^T-y$qsE}RF(&<mIP;%a>2B0%v%-;gbT
zSxXy1xovH&i{_o(y%2w}Eww;y!=TaZ)mnrF^`w^=I;F%!qKM9hUXa~Uoz9h}tTv^v
zrj3-=>o)bJiply^N?(0#q^JJkkb^^bzaA?$^4mh?N7)iFCMn0beqQ%HaAom=$(CHG
z4AzAjLTNFTTbim1D|)fx9DQ&iqeHtR4I}fw8raZ;RG6twFhC%oSOm)&GYPN=gsfd?
zm~f${j#0@P@rBUg=!}9-p%fh)P>jCeGkrtR`X$l&KV|#uAY;4CA{hx7?`WW8EUHW<
zzhQ2RvVd|>yb*70O(xX3h~V&vUm3q5zBb|g&h?(bddd5x>wRaf>piyyUXZ!k(UEX&
z-oGOMLud3XxK9%Pjj;yn=}5qR!KWUSnQ;Bx#{tsKPdTHb_@Sydjw9b4yNInFb!NjW
zqSB8#weMmYst$bL_4f5Riw-+GUR9;0$CBPpY`N*N{CIXFD)h%@pxCRMIvbC<-s`M6
zan!j+z^KBy9oO4m*iG2G(7I~c0<(?&ST*|6=FLE>v_ZoDF4{Wi?D$Ina>vBy<9gpu
zdavuIa*xe*y(59AW@;V^Mw}0C<yW}Zsyrb+4Tz^Q8%=NeqV2@~Qsf)QRSFtIldku;
z>+RKLO!I{sr>3URKOuxuXR=ji(f`SZ*bWBcm@|4WfB1hfgyC~@pQ(*FxBrEt?ASS*
zeyrEWkGjs;%Nl@O)7(w(0yUcE+SDed)~VDwNp)(47Ob;<H$Y-sKE$SuI#(&$I&}wn
zoVF)>oQ2PC{sgK#!J>a0#YiE2k=r1^Tr{T}Ze<fu)kGA0K))KQEI{eH!&2X=725VV
zYY!6E6GxrB&%YaOeDA2!{#1{11=_0HGkGVFh_?|e{CK&aMO|My*zNjfig(TRu8CpD
zenThT40!nNh2xHW#b2GG?&RsNpNZAF{&q#Hk=n>D=flOvl63LaTE+)Me!IkXcLscS
zQL@86=ffD_BV^^s<Q@f?zxl!B$b5`*%k^$FGr`4_nvuI@`ZRb6!BnW;6v2O6r92W8
zWATaoQ+<PHQn?J19vp~Cg>Yh`iO$Lhz8CB7x%%7Xw_udWp;ylBOUMlVBRe^zG3!hH
znhF2wG3L46Pu;PM!4!_oo7rnnXxA?0<_~3_OZcNPlFN)|QyoTS*<3w>YK)r}Gp)|`
z+`8iQxlD%yaTgb-yG)NV?I1EityZ_tOO7Yg7!FK0XOG4zv0#8wz>1sB6=>CX>dA^c
zCEN#&bBX5x0(cgv%q<!D_t=rQgN@kxks-1DmFdwp0M(%uo>8UsKEe@!Tvl>lJ5^zl
zi({2WV^mbC_){ZrGIHHT6$67@i+p1iDf`4qe*w5K>UO51*?~S7PEqX{VtaAyX5ysE
ziNj$fe3I%I7Ht8owDq~XXkQvCXm~g~lv#*!ra#%VQioAQ5_5qYHD*baZky;}PjueG
zkN5XPS1elub10~{nJW|oN1zpPDtAZI@DB`hr}<=IWO~u60U+ID+x%?q9Hy7~LRgNp
zMA#73Eb-PMji~r>Y5KBd%+(9<h0!*`OpSD<QfLf|6nc!J>Ff{<CkzUARt4?u=w-_m
zMpwbVN}vEDD6dZezPNu<-3!qnJ$7)_$?+M`Tf6AlBtg+M61!U)R8crM1R2t;40(c-
z&uTH!E0&4Y5it10K%QS@xJDN)1d%RPJKh&Yu`87A><7}y=r>IYZgn9LAWC;1Pc6Wh
zQ1C2chl&~U(-}@57zk!z6k(ye5ov}uYlz)|l>#I-ssnbRN*p+3l~DrJgZsjy_ooIn
zV5R^`IoF0}xf7u&OQOxZSUyqZnvS-uUb_<ZPfK$&era3F>S&vrSQBksl~~!f(3FI0
zI<aEyis-6K3250>Z7pk}SQ#&OTbdULek#dAQe9W(yRm1%W89HIag0Uje`0sF8K&$U
zkdg0<VxDY?ioY$&rCt>N9IzuIsk*^o=p(}m0aJ5=aBDV=Ap{@7=|6x8(%YF4nvvnL
z3!)<*NgM>#0Up3HIF#$G1%{u%bhe(7AgGz{!X)kL#lV9-xP?s^FiJZCsGdNg@K7TL
z4tukPF@Fzy#BnVsVbaK^(}Ji*0}G=}6pPO^no@2!yYi4OnA5{i-BX2esCuZr_GgI%
z03&UH)!h|hW%PPLs0DXMF*xbc@6n&$PFULzQyb{%6W0u;G*<gU;}nK2H5^@^>cR>?
z6-D<DbBN+v8sN|$f=iU7$NWugkec(QN4kz0semq_ew7iaWTtWgRqmdZ)AZ&<p`7L|
zY=AhXl*P$25t-m&a<7r!x`3I#R?e1emO(qot{CJgyu0vif_cP~8Wxi{8wakYKnH@_
zVE};-4wFy`vXyBE@&u(RrsO2H#>})5iL{2i;wYt^<#zY2TD}D^Z1t+vpR&rs5E+6S
zCn%>LbVPtJri4;*;Sv!{dIboBJe&#^XQZ*BEn^`9eW!Otqsy1Kaj%b3fCsIxI^%?+
zHsuj)a22(Jc%$blalm6=5Dt*yXa?ng4o-}8Z_$Li(&)h<#PVSoh(XmIG%alGOK;>X
zztCi`F)ncd$&{IwULbPFj8RdRv}BG(mjVF=>3ue|sGHY4UpRj~Tzy28Zc7d_)}_E6
z3)ZXWrLVm(8c$={O}QcqV67TCA&r-*lAD=Q6MJEpWWw!(Jr_c=V)twTzf4%QJcPH_
z6rr&8Hq0VDMGx1fNNfhNf^woyV4;ZV0i6ldpleRB5}GL9r7MM^4KuZ6CkV;b*zeIm
zF??IQ3~&qYLtwu`<|93pmRo6l(7Og)&RuwJe~(rW%`%@)q@vOUYsK!<`;OHclb94y
zd~6d{Te#(Op|OP^8noqv`Ih1V7b&ZmfGsVT5vNj6(N$3$cw%)HT}Akml{2gi7E>;<
zK9Mym)B$@kKTmI`Xhd=bYPXq{M{l=9S0CPflhKSs)Uoh-8(mW$+NDg}jWtA?a6=xF
zgzbUH>a9z$J~JrWKpI{Okrmt|R1*t(|2XN&@@Ai37mL{Wj|1lH3KTYOi@+{S^rQ3A
z9~JFOnYv*BCL?@Q5#w+*yRT7(f=AO>!u0j@si`WUjom`WEX13{&Xav1Ixxd&e5s$B
zeIlm3b#aG;v=(qWXhhXGvGSPAu<beeM&v^lbCt1~%GFp2<P!r=c`c(Gu<J5F$rM!7
zn1P7l@^n`6pfb%bCFZd^7gREKy)}SLJ3&7=qEWpoXJk3L%0}=p<;(DrYGTX^%WD9-
zmaZrEAR}<P$*&}Xm{HU*W{OB7_%Dv-lycp}&=3hnoy(n9hTTaMA>S^~eM0_;h*o}1
z!Bg6k$RW`)Z`WY+U>4@3+8id|kx#%AdU>S<H39TO7N-W3dV#J*KRQLZ)1i*h-JoZj
z?0RS|BBxP!?jjg6Zba~;{KBquYT-clLYy^PupTE#vP1RdIiyLv8@esiCsN9Y0=>zg
z?GarM1|4rhse?k49;oG0MBL<!3mc;!Z)k|Fx_l-!5A;PH7e>3V>jP)7e3th2T^wE7
z8STZk=tUo0q?^)v9Ur~;PqHbj%h$;6#?nQd*o@Ghl6o1K^0tzUMM<5K@`_Tn#+7pG
z&Iz<*rjgmL`RK)~tu0m5BK-&HbUnJA86NDf2YX?=dDU<qB4aO%o^4&z#*onaS>yze
zmlkj*M3K5fMor>Gw0lrkSa=WCs2cb+aGi_XQX9@u?wk;W>Yx}ZLNT*b!MVVHvfe8D
zhL1}Jtr@R{Z0TrV+VG(mvvQDx=L(AZ(hv=mTr3v?ZS7p3oh-q#kQNrnh0(-@0lEH$
zasvwj_RRWG%ti`DLopuGuLY2;@b!y@Y$hnp4z1WNzbw$!3nU+GIlJ4BqRQ%~T9^F|
zUBmX38-I`tDwGfS!TQGN0Qu0yj!;A~=4#lM91qnK&WiA+82m1Z(=>Pjf$v4m{fmsr
z4g~a(l`moz<@1j9^w~_)aaAjVz$h*=gsJ4p4Ap;-KV<o^?1_{kX-<$Xs{3NIDon)w
z68_b8hz{~Goe!4K^-49S=S#)FE@6PY3^QQMp+2Zyxi=}aTwfRs>@b~+!Jtx*4R58Y
zE{tv&%to;dPw}df1a4ZU4yi6WTBc@Zb6;1A9>_IT%M~rLIG0qxK@54l?i+WtMRx@2
zI?8r-Xf+nN5~mO_GaL!jGiv!KoyLEFtA?EZ2^}3#x;A22`l-}p;;N?7^ivQMa>Nfa
z6s>QGDsu>IYS~Ja3iE-SPE)SLkUdXUCm)!(27cf|U9VL1LRI+$sj|7~!q9`s=XEbI
ztNO6w)YC2056&wsE<!@WFojlkR!%WMM*Ki@Vq%g)TbzY3(S^|~RpgA!s`D|=#5uY!
z@O$btDL1eYU^SA7GKheZY$FUo=r&Gb(dT*?v}Iw}^OVszCq2AH?laPB&FJ;1En+-$
zL3wJ3AdLVEt>FR7!pYE`N+~J|-KbimZG!UEQ<qhTU@!D_S^LJ;CogMr0pa~2wV_aA
z)%tp)N)Q7{DGexKgA#`;B_LyHfDD^e2A3gs1ikpZY6N_#=B)@bNPkeJNCKJ$g7TPO
zjQKHwp@ITp9U~Vofko5yWXac5L=X>YS)nPLiR&gX8RUYVM>4Pq2l41Jh7n3eZVg}_
z#{xbbwa7Q<MMTeGQj*z~^Bc3SFM|hiEBugp0-18%gDGWkithkC0iUH6A!hPWS$E4q
z19mR%=YXl6-MAiW4>)zr>^C!uG6~qMp~6@%UPlxHLJD20Oo6yyvKp&Fa8zi9i=4WU
z9bho5C?4W(uL@HhIhw`@?7~Eb+YjIsw6L6!`Dp_`jrz3~M+xBs-*+rcx%l?@VpO4d
zarFdMSt&fSZVA?Hn&D(}F$N0t2H`J&Hi+7`LcC=L+U6CrDI#WYc$#iM1%z1W&>@j|
z`V5GSMid%Myo6EkkZ}tNU#J>1lf-kq9uW+fpTl;nfvl;iv|q?xP$3K|+yujt?l*b?
z;4tDAU6xaGx4ckkInEXE6Nw5ju^B<FTmb8v3l&2zS87sE{vt0!xJg4kRSEycaa80#
z<2WjUO;hZ|-ukm>@iCDv#pWU*!IL7_#A<tXF<fFs(kna|;TE#@eYHWDA9rs5S3r}U
zXod>B;6AFFs6pEK{HY2u@2A*HE=t5M>|C?M>H2c;q_tu4F4;F%6%+{6GtFh*Us|E5
z(24C-#z%06SDFl$zpS);w9v@%yQdLt|4!*9&aKRmopmSw7L#v%jMOj@5wee64SpFu
zt%Ya*^KI}sqZFUo!vBTxRlsK#Y`rm7o64Syuh|2cb9Dz%+LBpOrf>~_lz^@+T!uu{
zJgqysA77_OvX3UcALH<j?4PTjW_Sv3psae}sD<Nc-o#$L>wObPioS&nf7kUgvAK`5
zqYU=$WBOE4cWm(r?=e+h^6VHOzC{vLUc!HvF$jr?=`psV62V2I7h&UFXT~4FZ=L0i
zHOH{q&YgPv!u~qKZiGK{S+Wf_@k1N?&giqK&5iB4q`#Z{`H9>mk&$N@oPdK%|EZdk
zeAnN~P4`62^jHgyHr@D(xHEXNGkY4pFROKCFRztfQT&R^uLk^TkY7#s)s*lrYjwTl
ztxQ3^mWX7bVvDWVVk@@TiY>ZgOKVHxvBJ3^JK`*WnI)P0*3mhWFRC~ai5Ebe!1S02
zPf;D=R{nUxn;v7276%8g9Bk#ghJ)?tE7DwjIPrh$dT(lu5)n`v#hAJ}9>euUV>6II
z&U{6+l{;RO-JHmMJvPDt%G~IVeJMt9pk=~OY*0xs70Wr50U50SAYs@VD2KVo_Uv5D
zUVwQ>lq3{I=Ii7OAO<6{fYz}`r{hZ@mH@7VS@<-Fsgl64ziXUg_)HL{)iT!#h<&a%
z5fE@KSgcqyk*sUMZWU6arKzCw4A(n+^|kv1Gxc8_(P%A=uLVc(qB>9qljb}<X)up)
zUQcAF!iDiRm4kGgQ6F$Q#^Cm?64c|j)*@`>=BIfoukUEwsa<J<othW|bzt*XBvl1F
zA@-w*Ay5Z4|COZLsHLW;r0$T^Xmia^ZTJhqnHC;sb}s#CVT17KR`x7j^IV}Fk3=PO
z-mjLCBhB8chU4^UKh{tmqi?)#lJmZe;rSIJ^dM7A6dIJlA0V2n88LQdXpr>o+zoZp
zGN)OvcKnmxD_|ab5Ya{17p_K4ecmt}Y9t7#_(09|-<9T-vY_s(i<U6{TqJ-c$C9yG
z5-yb-8;#Y1)73Cx9^Bj-_x6JXv&Keh+%C;?jZ+DOdZO#L*f$WA=61EkW^q3IH_dQs
zbPN@O;M^|MU2-t9IO*xifkF~wtU?m?dh26E(NF=?d6(<2Xmb6vwekJaPmZkc-m;n@
z2{~C?svc}BUppxxvkp;-(lOBl@!Wr&l)2a)yI=ZfvQ%F~sU`t|Wj3g>alGJy8+vx>
zOfUZi=HcWE>Je?3kL$gG5Wb8sBPS&$*xCCb%62rIX2{BUB;t&5XW_X-7;(gQKBue|
z%xn(YT$0zjEruvCNYByOR{6dywiDl@<C!LB{%C9$emnDTi`^sNcgF6M@6X4^<@*b<
zgYx~Q*h}(#f9wtU{(39|*pP%vb-3NvW9`Ur$8L;8RmVg_g`XqE`7ZdSiTLq2ZIUc4
z8f-MS&Xk*gB4bP&zGpSyn<aFdDncQHmJ)t427N&-r;Qt{`4ir_iLZo7qvATd{^@`;
z3ryXb$5o<+m+<tn>lL&$2aC*xY_f(a;k`;}%svOw_`Q(EB)MY3%JbXxzN-Y@FATC(
z=T>s;3&L#@u$S~+hRRUb=8m6~`FOR-Faq`k9(FQZ2Ubz~z%*#&3FN_<57K$jc+4`Z
zm%AIx**HG=_dUDH%R8fYa~%AKwxW>h{YarRIY;SV%DWl4#nYV82ScSeyjF)Hl=690
zXSAWJi-bRS{mU^=*OZT*Dw6QG&j3*&#~2?wCWAQD6t&|zUN{E3jC#SCwpw1Ie>b}R
z4T}{R+r`Ew8V^aN?Q%#KeMlQ~^j`qP^y9pks9u{5Y3Ah5!6c>*u7WIrG-IkI0P6;@
z3iQh?Z9FCvx5z*!?*_3VBekU?;d;4V8H&RDrF%`4`gexNcmyg3{V4nnnx~8s&S)K=
zz)aCrB@j@;dxkEnQ1|D=$Xp<<0b!?-?b}W?fEkBDEo%2qk*vzFKl~U`^qf9v54C*z
z0W!|5Z#6A*BF=W|>&8P=rY4rVZ~MI{z+CsupHu!J02J}s3NB(nr^gcB9v#-niii$A
z`;KpeJB~Wny}<I{MCP-8?x0Hg)=_7{p(T5r6??sX?yW!&t^T*KqSd7LjDiV)T1&eG
zk-X3spChBW{<2<o+Ol=-MZ{y%Rj&Wp1E?ZsPW$XQezKuG#>T`5Iy+xh1tj|U0C3q8
z1i_bLU$_W#68l`N2<Pk_huNqNnlCGVswr<;T;Ux^db47BgaYXYQgK-9i0uX`^)v(N
zkR?Uq-eDjpk?A5c8BSd`*rBRPe^#vU4dG{RZ|<cUQr&&_r|x_9k_-r?ZGWOL6DV>$
z#5`ItxL^Ut3^@MZfEj`DM-Vhn*s&Oj3>MQK=d(1=;)1D@@5b*$*I(U<%;b_EIJf;0
zXeYfNxMMfe=t1)GRKle6=uwKd{EN4IU_ZVQFx@yFQu%8BuJBjZuJA8ya=qsp$NjZ-
z-dMsYs8%6(FC;xkK!o2ze(4tdud>C2e>2$p1-I*fI}P+R*r1rZWS=uS4Tz%=+A82L
z3*Js1152>qKYgwsETj$NywJ#J@&hTDe-TK7v7b7M#mr;mrZFD`zQjp9<@yqKug7c8
zTYu>Kiv?iZJD^&7geJc=84C}H>`?NbunF=T00}0&N_apqjmDI$ydCw4iJpD!=q!d#
z%EAiX<K(VIua7331;=IWEcW;{u^Ely36Q;vk<>V7TPLyPd$)W_HI-a)eE1UA55~2D
z;%OQhD|}2)Ze}kuzl{g{wio<1UPyr)J-eE{srh<^GI>AnNOa|ehrCz(73G5tQ^1|S
z*J=$dtCHt*)A~@uzYo$>p~r#8;@|B$=+<cD<NjAQbdIkaanV%6*atT4!z?7~Wv@H+
zj5~kAo%S$UNyAkry8d0l(B6^#%_mLiyuvHe@g@xYHG71>3FpD7OA0UlmP-j4clHbH
zsHMBVxU4tcE4D9HJ5tOc=nUDuFoec|X85DdFZerTDFtQve%Eh`x_e%l<DRpFOlQt5
zG>$7vG`{3O`V>4EeqPh~gz|^f(jS6}v^2(EL%{OMUm9cE&l`=dj5CO1H9-K<o>$Tb
zAr@nKNGr7HkVl>C{lfJ(X}geXoTUlxF*_jfbMkc<5Oi@?e*ET-aF+Y&xuV?_fuIPD
zNw?(j%mUglb=F1T<arDVVrFr8!kYdW0Rj+qQ9~C@)b*yvz>k5F$Dtk|c8lvj99Ta3
z!G+4@sSDi!6g!tVL|uQxRT$d!TuC}XKIndOZuTdWcX7hXT5pQeHct|&%7x9MJ+_kW
zet&G%)Hi#qys;}DLi#{U<2c64UxV`(`|ZJ}+-o)I!^JeozMu3!-GC%&C8-)@L;3^J
z|09l}JC+}Rokq#n-AAUTs2cVsyk8~9#_r)Goh-?*{O9poGd5Q)ZnS81ank|V&8+~m
zTZ-K^jxRpmr@!yzx0wyVFPb|(gZJ{Z90-l&4>^`&sl!*B`*yAct5VKjt>p`DScY)W
zzDjV-zQ#!!OZtMX>f_e{2&2ogJ<h-wQO9?ly@SjGFZ4L;VWoU0@(btYJUi)}ktawT
zJ_6qh(yq4*o)!Tub3&%AJ_T3w+m|kLedLd^w-6nK2<njrmc@+3mgXR@Wi}au0nc)3
zE8*ukm!a`-+)5qVa(3`|m}mwtjyn26_tRlngngB5fTPq&7}fbtT}5R_Rs2^F852!2
zNDTCfSjBUfoCI%Q)Ss4}7WYoh9iQgpH=~r8in@1ke>8R@rX(R;jlA3^QE0U-B-AJ@
z!}BgSd=SW1JQr5^3{T<XQ}{^dWnAa_+YSP~gm*OIJ&U!*sqU>0HUZ&FXxZJe!ryie
z9uoexaeOr%O1y~$I8@;2crqk`qEy68__wmF(49{v&bhS~Kb@UVD%vSsnehJ@tI*Zu
zI&il*6kw~M?p||p5Pauv`!?$5j^E;p?!k|XXbwB0e+0<6<2O6`>(CPsoc?KFyBS%H
z;~}drur^e0_0)kxwPr|BMv!b~3GKQhcN7Z00<n1xt-8Mb2vEU#(CFhb`|mIy^z0&f
z!1WfvHE2)?f2FgEaH@)I)r`XVM8wEn-JYx>LjC?PY_A*<p_rJ&k77B2o`yd3XKJ(e
zm&WYHn&&fGj$?gslm2OD&{5QO{b`uRyfRD^2W<KrmaTKCe&4IpCYI9?!m`Jjrq^Uo
z_FHG=4`r|LYjeLoDYGc|>uH&}xnI94`&X{t+9aD6ufI9~QUTOwAq{H-BN-A8P=?^0
z(u?HyC-a}j`op=6>^6Bw_&}~NGfqcu4_bBePh_x8|Ce?!C)$A3?Rs2m6xl)kCuN5U
z;@$d8WYNA{_pI<6VKnMft>m>QQaiG^Oax$U-IVaLSOpWgyMZfkh+K_2YfMq8R#N`K
zbwV#Oo3txRY&O@Qp=cTch>`?&BJB@Bas}<bGrlaZ!AI7RYB-U4J`;lZp@&#o_Fk?Q
zRRlTqG5mRF{M-qt%}S^Yz1AMut7wk7KmbhjLD*3ZBH!V7rR||_xdXSHi4u?rZs60R
z*ScNlNth+GCSOwMvI*}2`T_$agJu3DY(`mqrgt>?;M_b1`zb0(ZElz|%+tseV4JH$
z^3k1`#%7o!q;UO{gT~nY=2=D0jpH}~?Y`kXK-VO4*xu!sh;W6%Mud`g{adgfFqL_?
zM#}7&LOm5@)52cQxcXXyj9NbxHHP+Sy3k9n;QNo(ff^bz466578`LUkn0zdQ=HQ0k
z3+7kw*-3tceug}7|F|d{<^lSL*^99Um_sL)Uj0yM{mnR0cK%J<;)Lh#=m#Ny%FGG*
z#k6oA)YkTIm8gQr1)$h@S)g}bz7$)GgoO7^7t+c5f$A7n)5>!sOssqBuZ6HWlsV0?
zHcRNN+)Z^6Y+5L<oy|XD^5e%wV?=VgGx`Xyi^HWlLYxoX900S0%d5BeUy$lN8Gl5z
z_-PnsW|KRf`{7BS2ExW0)8f6{;%Nq!-3A(>dPkN!R%Rh!2dw>5F02*O!J3iT1~^wq
zD%b4f*!501eg*mr6<+9FZfa=r2Q?|YDYt9-gKo{ish6xi!_vte6M^;rnQyYp|M~oH
zLIH^{HPP$lWnzr6t<rxLkBaMvO`S>ywnB9osiWTiq+VTtLkXeW2;=jH<VIrkP6-v8
z6Dr~E=4_%dEsI7aw;<WQcVqHSY!^Q|GO=f>rX1HX_sC3r!EQikvE=2b#kqnF2}Gzx
z7Pms#{?ItM6MKn(O%C=;ai@aFLn;F-RJnj%+$0Ow>3Vx?G**WMnDE@TN+KvA8pRS4
z+lf&kh&_^76zwa#f;;y4SY1N|`;~7by|>mVe6Q=s9e<aT{|#`4=Y3Z0ty7)+#UKRt
zsKOeJ&tf-f4aetbNaOLjF7%95JQ33N8H}|gt$_r*CE6r_nTQ>FCK&6~JHn@^!Yhv5
z1X<kZkQL<AVJS#2`c%^#Rc7)JjJ-}jLaiUky>t@xQ{uUQ$68h*U6S5W8+79BgB9|f
zW-G#BkCYg8q?0(Z>2buKUwkTqK9(9)D?q2YE6`w_!Xg2mQ(cj{`l+j+HS=T|KmSY7
zlea9S^>e3;lr?~y{A^GiGM@t)xIB~{E$HiR&W3#->R;}~O5H=}o`++B?ZuZIzUjXO
z&ik?+7z$%U6bRs7M0WfNp8^LeKQ{?rc0QA1;-QruYfz8QKph3e^w7Ee1E^hCj{mR@
zPy}p>?`Boo{&YOBy?}18%k*MEVZha%%9Wz_KRYpWiaW6%1;g{Dahz+UAmC$h{!kF|
zVGNJ{SRLF$&Rtju;38(k|G3xyR?8p!h!QyXY?i`cG8*z{k=x-ZNx;lgxv+hfVY~5O
zJ;$O}3}76dEpcnjhyAp;*?XgCjJL8i+P(3q{c&#xM`H4yP2aU!GFs%1G?&g`;V0Kh
zYcw5Mcfrx>H%$jtOMz9d#tM#6dzW<fMX~&8gEMkujz|x=DLN{`O2_?8>exbJ7ks=2
zUIJeQ0?m8iheglUR8^+1nbG+dGd*VXjTHqHF<aC^C6qR&JS~fe6m5FB9-@cDZdU6B
zJ>870H~Agc7dI3fcVgveo^6fq?tMRHqpNt>#X7RcUQ{GRvif1jADP(kJ@k(=L-o0o
z|BCEs;~*QyhDVP3P*?A(yx$jp=l#Bs^F!XD>+DV-dcBpSAx-IhJ>!BCc~Q-OGWj)D
zgTMR1t>}$hQXb3_80JU}g+$#STZ{y3vN1kjE9$xa1A2qpP)aynJxqSc+LyFtSw0ZK
zM<Ao5EVq%Nj9x;ns^&e8De`oScd;&@ft{}W0|A_xn#Zewh<g)&aVYK$OfLpfXYM=l
zzZBbw77bJRH`!_H<WGiPsRkKf_r?8p_r#rn*CjXt1&1)3n&%&fA9ftx*T<3folEsf
zAGuqR8}}}4uml=W2}@N1Jg(qkZ*SbcbSWSlt%2K7;OrMT=jm#e(V-<FXb@d>1R-Iw
zw;x0&7*m9$*=<5YN-RoWbqmukoWW$wrMQ`apV!3N@qcq{agQ_jGJdtidK2FE5e#XM
zv+)N#PCqvJ9=e<8IkW%aIAEaMOGw^}>{pO>`&<--V;PY;$i$D^Vsu6lk2-uiXWSNx
zsuH8Idr-nT<IdQ)e2>P6D8bT^$qK!uAZL+t#%QcTW&B0E`o5i<#)4!)%>sy^Gw~$o
z5w1rXidw1?Z5lHWf?A}ZFS{^FMczvIrucU;6p)WtSpjUx$_gn(5}5w^@V1GV4o9X6
zFTwq$+C`t#$Jk>MsCk^AlR7*p>3u!+DiRV{c46$+sfth+>o`}FTy-LslRD|&7ULvL
z0=u2~=6>muN&oY)c09OUcgA+1twh(3pP^H6|AANW<$U@0k~f_dZ$63=5o~mw=ieW@
z8$aQUSg8`Rmy0+q+$rT;BU)PaU*X*Txrh<8fG~#QT(~Y=)OKOP?jknMmk)DC&{hDb
z;tEMLELUhfAu!>~f2OnuJ$AM9sbg0T#!=FHJ~{tc_I(|@h9now987xOO3r_ZWFT|!
z8nsp=A8?&7tDC=8%-`eAKb}PK#oRb-!ouIVeJ^d%t{ulg4SHYOU9SyF+<%ml(p_@U
zbymp^Im(+UnSYTw4#px%JGcMyG*)bjwKu-l_*zTj4+*3Wh9`r6Uj`|ay`uq|cq~J_
zr)4wZ5`yrza?FtN;?zF)?RmA`qJ5iBL4vsGVGV*Pkk_>?gX~^I?l(!+H>3c@;c+P|
zQ5;E-Q<rT(_A!)wnq^-#WgiQdtu<w%$cA~g=oyxMNy=g@is15ku{|7zSC?Sl9NQ=)
zo}!iFOW37eEx4N$Y6plz;Gb{dTQ=`;t>EiF#2;dwc{^JBljP7J@jqUW_X_?b4(9QI
z*V?gXe$6~k5qlTchyup<yVUb_*haaIfgB4g-+&jddxa^-r3GLQ$DyDc)M670eu;w8
zk9~YP0G7R(lp-Ka?N(%*{d7rPsq%)q<mccD4qa&_UJiFQ`5WV8(UeN#?vg#IgqEgC
zD>bnaIlg)&M3bK9E&(Ga!N3O@p%!r+cW>b({80QAM*e961h8^|2N6ts^Fmt|gqO15
zxAL;UcrP$MC@X{Cx39J)R&-@lk`7m+lB%gXjLDbW%T*2KUtm&RgB1-$WJuQTLZ4uc
zgXhR^g*zc&EnRFn_lp?mg*hZF#5!t=t`6K@cc5@@AeS*t&gc%17Xlf6Z&;m1QQWbc
zlA>m>`^h`*#jou7{ul3Oic;gMl#I~)$Nk)W$eI5thDzI(A^js-AD&VI(XgS$bA+WH
zJ*ho;kG7ll0h!<<SQYJH1PWgE3KWdpAd~oEVeca(o3(UX%0Lc>8*nGb%eC6}-P}Wb
zh-8+BtmGr%!yDdDY4}#$61ZAgrjJ66gKE`ZtXsEhWLLucX$iyCX{_z58^?>i8_-uL
zihp|;e?AEQ)e#N%P4`9N81#U4<Ns^;uM6YPhX{fy-iFW?|NmNiu>zz)WS1p+7I0-K
z>F)z#*xlH@RldEwnfHRjvDiL%wO&6_Up_)>L`(}k?3kc4{IC3yn$_FJs&F`kvIqjZ
z3kSjKoOayzfWj%diWg9!p=A2P<((d(EJIik1M@y}Znm*1Kcd{Yuq5Eg4#`}c=MX<a
z6$Um!qLGU(TO*ji-U|Y*dTn4@T$hxxAH!;*+mLGFg?<G__kQ>2I2L(~JRAwFoia4G
zwR=#^hQGzDqp%yR2#DZZR<i7nf6W<v6Lc!_8=+d}!$m3Bi80$)HdH($KTf2AnYEN9
zQ2(QQ*edo>72F_q!tVLl;2q<ef!vWzJy!o)L3$0=Bbiu(t)l6L@hx$wCB46MF-umk
zzt6z`V>gE>%fM*RcusylGO)kcj%R+@tC<tIb$FzFbjNOpJ`%x$q2!~m$E-}IP^`0=
z*g-N3TTf7p2y@6qk?ne4JZ?)#Dh)_o*5h5a!NXSjAO&{@kH;i|-W7w3B-~S)aBq-6
z1YQar6@*ty6YeWbI9!^rJ4hhN1NPC(go)f^AhZz7%N<1aL~a&1jvs}rDTvxztrQC-
z?zD-4V1VAmc$0iNuC?IbSO=I2UQi0TGi>EX)x}zyko5nKxf8i2AjPFCijU)`4m_O5
zy@3Z9swhFH3qL4vz}BZzxZRFaolU1~VPjat3XaZfe=ahKDgXjix~xp5JFy&zlKcje
zCvw~x<YyumL5~#KzR3OYi5vwWKc!^DE?(|#<Y`<?ysXSeu&=ADP2|QkY?jAQ+tC?%
zJdhs6Pn&)Z3h}T6(i_6*y+~)*kbW=>hhc|$pqs+w52H{dQp@rZDylHV#6lqlIlvLW
z{t&+~?3{6}cpQKEhj^TwyO)qAa`)gXa@T`1@pCu8HC>+6{Z-_K07DekT;vY1AU^oX
zm@EBrH28U&{)ut94?i{4ii{#mbnM#et!6fWze8fAgYjS@@7;@-@U{4%{Axy;2ewqP
z8?iKB1!tJj3IU&@tHdS(y~sI67Sg2dwY~!<|1I`1_t=P>GBg2xT91N;df0gou-%@P
z0LXS^xTi?Ildt~`oZ}zIf6Cq}67nLJfAQATls>0nDdIg|_#Tq!-wmW=;b*_b`b~8~
ztTO~xzNq?EScavY*rV2f3mwzM(Ak22fPzJA{2-603%wd&G%Cl0vlJ%bm6rjw|1}<J
zJZ6m#q+0*4CM~$6#5jPP=A$?=0ktdf5Ktv6_j>u`LUs^W>w7aaX3W4KnF?ucd73kN
zAMhwo&$gAf`YKwT+)2Ap<#~C|oI+Ztx0Rhldd9{exn0LJegDMJx4fN9vOFz|<qms{
z&fYbS_z5q6CMH7RlyEz>$hVsyatu7cD@-YRh2(6zjBkauV2ZJ=#zSb$1!*b$3in{-
zPM|EE`Grj7vL94%!?=8d#arIKIQobfF~Q`wEPh7i;<FWWFHZqi_&HX1CxGq<%RXMY
z>>repd^$;fcg4b)q4LHu*OaF@qmNhQEobzfDyC;IEE$Wr#9<C_fZWAJ4v=!=7;{+4
z$DQrl07A3ZQHJB&8Ke?H!_mL2*orfHYsK{J#pNSLZCbbk;7bsjL&R=Cy2fCrA_mzD
z${|t*72*PsEPT}I5G4#zou>{f{842{cD%n$jA|+us=#tF!aM}|Sx%p9*^pDY7XH3+
z;fsvL1L^~BzO_T)uiiR=C-I{qcTf5vsG<cJsXX;$p{+8&OG`*f^P*6PvhXo!-;x60
zIuAZfK$jF|64Hb~rS>iSI*{nW0%1IB$Pk)J+}$laRk?Vn0EiIjzo}f-fTk4z4x=b$
zsAgg4gp1Q=Da0!mFB^~<L}gCp!WB@V-Bb7xG+%|mu28(0(Esg(imyUPX`K~zoKSJn
zg(g#>{e+9t@G8u&T)cFI?q=EF9k1BW<%Uo34PP$!@vxKoGYl7b5~qUlG}I6f!7mkI
zm>+kYW;nwosqhb#!OjD?ZjnH+wHAE?X4YeyrYmD>cAh3+VPoZrm^a0$>>3tsLSaBe
zye_z1UTm?)payOyZkH6U1pihT$Pc5QOf`J>ivam1gvZ!Af-SsRu?jBVsD)Yv;$pzb
z3V-u-AhzGj)5b0QOXYg!qMnvcwQzBu{$6K$9%U(r@pRDHz8Ozw{;pnv`E+G4A1RvY
zedBVL^ltQ*=568p%9YCI0*&Ru3>3y<IXG}-{cK7Q=MGF2etayjy5eoF+Ss;+7S1Kf
zPEPY1ss^_Ea_caixy<*sZUv+CIQz$Iki2Ug4@tkNx5xQ5cKQYnIJ37h$@RZ70~OqJ
zz7oY(kCT2LQLO%4!l-$}J;&$PAFAwer@8CkK5fEd(gPINxfx)f!D@Ej3ota-_x|x%
zTTPAGkj9%<)^YD<=YC|Pq-=U{Hvr+@cg?`;^ZkRY2t4>bwG1KP*{oahpjdD<!y{8o
zE`Y12p%GNtiAq3stDvA)_z+w9e?oN|Q3+ddC64DJi8_-$-o__#$7{1oT>lQ%^v`9C
zlHAIoOjp>|Q%%X-TeX>{+*`eyXXoDfgtOz%Q7>1Rk$d^g%=REI!u6iby`s;j7Totd
z%T9A=?TNxXa5v5`)a+)s&(yLubc4U#nul7^=2Y(McqlAEA!WCDuOo(DjaV4*yTo)4
z;!WfjkOb4{^#XVu;P96#EOwp0JK*Fx0JHECtSTfkzV}-Ss)_)f2pi|fcfF%}3aX6%
z^763uaY|tGWekkI(8Ia2;Jrltd3b_%$(%lRnShbdE_>yt!wP`@KJRl}d{0hRbrd3l
zMc24p`s^fj`&8^4c3cpP*S=1|n%CM3lg!3I?y(tI6!9%s6DIhYgwr2!XWFBF{we;N
zUho@t{8+w(n5ZNEZWH_sud6vEh<g4hx@OpUk916kyclwto$);C0Tg7@GHfPt?Yn5t
zrc?0f;t@B+e1JK1Hm9FCcwBT~Qzw3kJkvw&e^n+3-|uC@whi(+x=Qs(9YK2^`wa85
z=u9$9A#v~0v5#?J(|X6vAcaRDm1j=WBJ~uJ!XuCxFZ6&T2^*jIS`--vmFOkKp~sR}
zXBk#yfX5I9-1I{p;wDzQCI8yZmt)Iz^88)8oY|kHhp>@OOz%j1%0^kEN7_l+vgAj2
z304?(etgSANC+HrdR_$)TsT|>-J&o7_>|gM)3^QP7Dq;~Pg;8|$75V|pSx4FDZZeJ
zhuiRf)8Zay4o$wZTU{2B98{Qt_lmV+qow^Da8=hivscWW++pKX5a(cB4Ox2Waq3jx
z;}g2&L&xmg`m=lCC<8fFK%47*DRws!5E^O@jGE&={{bJVoWHPZOL}f9#Xc3KS@W~F
zn(~))9W>*1<Uwj~BT*DXsRIbA1Oqd-k`K7&2dzR0U?REnL4`497*Po4z;k|n9XNpw
zZ`GQ21Y-Oy`$9Sut)LMYL$CzrrY)+|d4>R|1?)Mwpiv1N4a(!7QM<eQ#q<8{yW771
z!R79ouef`DdYT0iTvVlz4tLk~#JG!;V?A?bkxxg3@K}cAMMO<O^SUJ@mU%K*vb|Et
z=JLe5BGikeL_j17BVj6~|Ex;-8&%SIT|y-|j2)_!P90U2?!7L7IYBxIhN-cjRYwUT
zz+eI6HA?!Sk{c=~M@y5fG9~@W$G>7Ccyp)}4jFc&JW&PbR7z(!PNnpFs-)9os#N~I
zO6kD{jGXc=W-(s#MsKXy7(!SPg+U-qW@96s^1}Kp1A(H>6Jj?DC!}FgK1VT)K$9Y^
zlDnw^Rrh5+Mv-S;a7ZO#;l+6Y&{iN$eWBdoxrcYE=h;hR&d#rLW2Z>#@L)4e@u>+w
zzzi>uL*)hptjOsx#GYv>upf()@8ItMjuj(7W#L=S4#w%D^gK3X&mBYDI<v8|0ZBye
zM!6ut`iSU|+prD!Bra)y=0McMldd;Q-~7TN;949}cl}v0fCUWGI-Z&!ztw)Gv;9iQ
zR3xpzGOqT9I$3n_#BnVQdZa9Gz<<|AX?wmG05xJbYu~_Nh1)+1q|x6Odz$f<&7;lc
zWtUJENAPsrK12i7J%y0Jjsr(qoZ3t0+Qb)`h=cM&h=)3M^L)vz>uI6E08rmWFc6|d
zTAb^i<$rrv_(@eG|Aa2xU`rol=_e|d_M2Kk8(kx6YdpsqM5zou#zK~FpE+45kvS7C
zpr_;~DE1BFw#V7t29nXAiKJJY9TzAX(9(I<*-i-_4Bv|!wRRdA-*R$?F=+TzaJJup
zLROcyO4_ztkf!;LSx9`w$(gkVo(>GZS2zm*xpjbni91(~#<;Xo(U_8Gr2SWwm1opb
zW&YOfphy3z5E68sM`Qb(ZGR(4i=K40oe!%_aNO}Ceg&OVrT`dZ_T|RZ`=+z)64*;j
zirQXmyAVmG)tXqQuJB=G+5K&D^f+e4VO9m-$y_k+HAU=B(R)qnaACj|dkfFP*=FJ^
zQRPFNJ^=Al;T||9Ej<?%Hhna}K#dCNKI!B>Cxf|F)f2kE<!tB8BBkY<Q2sa0wh3h6
z7wEDPHH9wQUq_mdp|DDFb-X9=ky{f%HH__!zW}N&m|EhV^zeYnKXP{b7@3+@;Ge|+
zTH3PapC6$|g@>eDqlAc4f6ge&>)JpmtB?bWt;H{F56)$|!WX3y_FF`7faD03yU9hc
zpkfz8ztDMW*otSmh<hHHQImZ&Ic+Ffl$ZS>x+bCwO^dMOwR`xReV(~`ibDw}0tHp!
z8TiQbeEEs9{UCbYIF7!*<a}=YJ$nn|LJ8h0fwb>AJN`kQ8LzkKDQElLcxnMQNlF)y
z#u!~h?p+5qt$Ugiav%O{+mE@u@c5=P$wK=$&(Xlzr#Q{WDTBaKS3J+ck0}YHCfJkC
zjwj6IMc&i43C`MQIKLpD>(Ef!_fdD@Z#Fd&Joruo-df@R!-V=R)ZF{*yNSrRQSF)+
z&?edg8=?~!)H|dV2#e2+k3y1W<gxDC95>Kx4Q9`xZ*F=IIVg%s1sP9+P(4SG2t8ef
z(B%IZLg4QU)#Uz(vxC1N<KEJ^+)zg%$k4LQC!|gMcinBV21uGPIexKeQ9ur7t=v8)
z)YwOA>=9}_Mrx4w-`B)|toaW5gAQ}_NsQ0QBL;>tt?^LdAB9=AB9*0{baEGv?F&fV
zMKU?tzK@^a>?lhVj^M${59EXMF962`Ge`+3C1Z1w$SRy6{3Z98KwkzX78E5c_B1$q
zd4qVE(O%tQ(1ruKuW$`!O(0KRcDC=AxmNev!XEq(KM2}?8NCwkiRO3UyHHSE^o+sT
z*|rQRg-QGu*cr<)@UK6S@b4N@BLh0+(Lb^TBF2|BA$Qz8XW3#ICQ$+S58OEielLj8
zH{hD>A$`#QdeBSi0qtiC_l4vI`todHha_wz^$fnflGMa!Vkt7i+4gzBEVKYiwBLZX
zX)~ZjwUvDkEv%XAY+FZJVg_Rk9thWbc)NqL#`G#;?Hal6S+7SEein9Au)O!K?R{h}
zrbak;%iCucBnZh=4guVv$M_ghiVXP2bK#n6kY8A3x=r#+o>xcljK9`a*W3h&6(9_C
zqa`0A4E<nNRq&}Ky_Zy+=RVUF`BrDK;_3`LPAxY3|GWzsuJ;S?FZe@2YGxD0d_@eW
zfBFjV=Wum;ds=V@rd|&`ssPu7w&&C6hjwgq;5Do811OKD-`e22i~XUc@!aoDQt_eq
zH7&CR|JP*SHT9&|+EDZJ__QlpYo7Gn^Ssukc<#42A5Oi3U+;28f2)3>^8c-VP0P07
zjKJ1f;;v6dCH(DMkvY}06j&I=AfBbyO~`BDUwqmdS~}_PntB4SrY>y7sB6E2cjS>M
zfxHj@MRE@v#Q(Ivmk*&edPJPje?gLM(=Iw~;|+zIWtu7d=62y~r-w%bO>-lfL344T
z&9<An0j~!iM$w(&9_d@Kp;!FeJs4*wk#|px{Z<vRq(-e?CUu=#!Uu(4%KWCBfJ;<V
zxJ6v~HFrI-PI{w_tilZ?><>S|Hd#o~dcF^g4S$Eas+g-2#>IY%@dWOYH=O(jrUT8H
zbPx*dG%kLw35dhPL#xuQ$&Ux@Dx?u3Zz9KBesrze4T~f27Dx$Z+2n>uhA(Wt2Ss_N
zb-usj8~7>KEl^y!cj|yADY^o}W{}N~pWB815w5}R@Pj)q)iyD1EXua>+;9;y`OByC
z2GH$X7Uo{%>DA4(52A-0dQ9F|34$I^wTe>wRbZmxBbNVq)w6G(g@H~&iJg98XWz7(
z1xbi18A^3g<GG_9BZt{EJ@X+Rqz!PCU7o;yt^Dx0<8{s`vGv!C;NFE9pS<HfJlyy=
zyz<WIdqD5p@!sqMyfw}07D`QAu3YP%j@vk0KR1F>(2TXW#ket~WdhfXe@1(W*YqU)
zmZl);Pz*^}Sg?Vwg7M#RkTMSUX5Gr-MnD2C`GI%sNcn^xkD_c~fo^)gXb&{wu^z<v
z9%sikR1ppccYB>^G<#p2zx>Ah_{gkJ=I%!|=QcUc>a){j70=?FvG=6`qpbjs6_~oM
z!u59_M=c3+|7ZLNhjn9it`LVhe72hZgkYLDq#JzgI1gS#7*leoUH4iKe9-_1qJA3g
zZ(q?!A!Z!Q{^?-o>~h@}n9GW1)j)x!w;I3-Wr&h0H~Cq?QI{!&f`JJU%)7i-=0V{X
zut!AY`KJfK_xwa3y(@fLnwE8q-YwI|KyeBbQ^3pvrB_yK`GKq5?D0?gL*WRzn-BDv
zjc}(V^0#xE^AfVr8jPE>gX)hHdGsVaa?a=f4k=0hA1DV_<bUXlo`MYTS!~2$14z1q
zE96}2E{x|VtmA(257j=APmcsjLh$?UEZ&Qxa0&v<V1ePj<BeFgzm~bs3hBv@nEG)!
zQC$IqEsK`3-=T03u|i)CFrS`%4X35h;-gAM=)-n!i{TmpkwZX9RS3x;U4^1;@+t1)
zC=g}7eWUFszg$&leGo8yPoage?K(zZ)-ToeX!v+E$-Bkvy6+2|Ubq6_SoT~aUqJ{x
z5aJ!4kiElpjMr3CtL#d#o1hBx8g$=5;HAcZAZI}c*g>1f5jsCsPfz}Lsn<B(%;T@J
zN+@M=+=Ttts+Q<G?v=<<mO9X$`xGHJKMt!y4XV~PKC+d;1CelchW0J8wUcW=e;=XQ
z#-o9AaB$htS7_1C9-(qW8^K{p6i{fE&*{lO!~RRrKE)|ug*v5-0-vJk3%~7I{M^r?
z=*M(@RRw?mJVL%@EragD>UD7xA3JEF6Yans=!vbNb_whm_RM8T^agh{+$>j9JdYFk
zs!!nLZ<OG8W!%32XhsdYUK_v8m}N~+9M!v90*9~ih=y)CQw@eY%l`7_fyUP=?{*b+
zZc@%Ut1&q;W$uIzcNfE1YkP%*?M0M7m6R{vAQF0;8~Vvd6ghd`zlcpVXXmM8e$_^z
zOY;%e6I3@xP$;*17yh5_<PYHs1=ZBomidFU=)fo-q)Zq8u7gOxHp@(CEpF#y6WwnS
zGiFrXItZ!w6&Aq`eFpXd&WyZ@nH0we7=N*DLv@n}!f#nPd6kU&h>Yy1kXwcZnX{(8
zSyUbZuf8b3cc<eLIUKqd#8o}rz5K;Mpz*b06q-yQO%t~~Hu<8OS7u#Nc&JD}`x5R<
za{V3B3ul+wuV(II1^VS$kVNF4_JzCNc`;}7vm|2inG5cViCncaQ-&n--b!)H2x1^$
zsAZDeohAm2d(O6<GC1mKLY|Od1eJ<w2FpNvU{jHYy+)aBj5?9h+?-S1CkDVuw&G_a
zk8sE(xIhE%OnFX`O>Pt*nf?2=qE>LSgNs#!0emu$IQ|HxA>Xhg3>5cpV5gX^+sW2i
zpwJ(Hp=6{zWrMbH)VyIe)U9wX93rm#T==A?P&M+%Rqw9g8Ygse2WP60z<0q=GIe74
zK{xRjUc9AhC;fF%aU9!w3wf(Iv`4~w+(c9ZuV!2^-Gsk(u*vOj0HWEG#U(UG1>ky9
zV@dsfTY?pK|Jq^*3R0TIGElY6!?K`Ow!W@X^=N4#-VVVlV(sp+4B`J|V&fqJsnxGH
z0Y`%d8*C1hY^NS22F834<M4kDgrDaL5Q?aAFfSb}jkxu$bgL4#bSoZU0d102EyHUE
z$Vqkw&dL87U}G1K3>V%tgFcmWdLbs8JVWt4_?u3f5Q{%7Gl8LER?jE>zuzU;XP+*t
zht-Ss!`;*%6x39+o|}?==)&ok;(AU1HT%)=1(jkoaKeciT9bj(U8bgbo`geI*+*hz
zsQFF1l9zj^87%w!fttqsqeTksW1RU(tI^E*Gjvh(<o)Fc+jxk>(~1nGFU1ZZ0n^;f
zJ(zr=<vwsSrOExVCK(Ack;lFs8^?54@Qb4(Lc;4Ef(ke@)HHmXpn|crkbtJ3X%Dw&
zp!M=}acmf%c5WNh6qL8z>2|G!L0STyS0|RG-4zw9ucWB=&H)`}oM~{<1_Nl_jUb?-
z#1uXBwjmv6F%DLxL0!DJUBb4!9YaR0Ox{&bZ{|o>DDPHDPgY59t&-kWCB3~$`ZZP3
z*HuaHu9DtgDc$hKi4t?D5)cqMQzd<*O8Siz)2qg%Y^_-Q&e&*`bb25vjp1!o(&@vi
zRQ}E?=@sF_drm1{1_$Z)R7t<LO8R|O(sx%$AFq;rpi26|D(Q!-q`y=p{naYzZ&XP?
zUL~E!I4jX@MwN74UtU%oY{<QhO6g}-Nsm@Z=M93D;M7$~Ur;5zp;EfOkcqc5LD1s1
zs5@g@p-`!&qprDEPAO%+TnZP+X@P02jEks$tEuV=#)$Vgy_v=p#NT*zVu^^8)P~Yj
zNNdT6>I{pCk>R7FIIZQ9W$X}jtF>B+*ZFcDUU@8NGrz`u=WeKtIHNPj8o5tKG974B
z_a4E&cA;D0U0iU2fe1z);C}Mj2hlQ(aD^ST!)4Y%46>+Hqv8EKc+43a{P_t~GO5`0
zS_}(GIjZo+K5JJfobV!rzz}DHz#1cgfKt8awSG2x7{0ItmXldO*=D-#;OP_h9BB>r
z5#2bZ=#W2-bz+eTs~@QApeJSM%_x|lU2l19VVvvEUGCV>yR3#SoMqQ#z*0WklsH9}
ziQ<IYwa;YeZ*3pp67eaxD;Hz26B8Fq((C3Gh`-b=8{T=`k{8&SoA^R$*-PwTq5w<{
z5X#t4Fy|29dyaDPIQbW3{2yB!M6rrpt6B<y%>0vP#Za0v`UT)$DgCx8>GU^LD$l6<
z^7M=e><qV==bm5H?$B!s3l-f_PS0x<y<y$bKc&bxIS2MUUbA8cj0W&LT}0hkMwy@r
zBkNFskuloe5KwY5^!^l7rVCJ2QT{MKmjiP~Zy=+=jbQr5%dQY|`x)y)%HWQkz}JuQ
z``7UJO@4v4mKvUN*B|K8_?p6^a2gs?Kk45~cu$kbcuhI{1iwi71274{qb58i)WkHk
ziDl+}F~cv1ljpU}*>XE8mX?N<%ny54igp>%U-t@q!ph7p*>bpA9Nosjgu%o|zwcCD
zS}FM9+T7M?$x^{Z0^Y1VIjd*a*00B!K;K9PZ@sz!9nmk^=7PZv14iyJkx<ro=nZx8
ztv5v$WlzReO$2e{;R05uNpV|Skufp0wgyefc9ME2G*^(sDm0&d3alWDiM;ZUz==lr
z5W*s8L?4aewd!U>Ra5^9Q}m#OE@n4(aPaDMtmicgK%yqRSMd&W+)s}#mmyu43h@{G
z`0{=qyd}L6uk{f=Bbz~(wL_RK)xzwi0}1oCy%k;m%wx$MKKKq3H4tfqr1xvpeY^>g
z8s+BIn((;^hc8=P;k}f|{p1aKK_qVJz*MiwWXbuztsqb8P~KmA0K+v$Fmmz?B`A9l
zP!p1bbwhF|yR<@D1<{*XARWPlkbEVg%rC?f$oj}8=r=KOpQ5}SaBNxIU#gIHcX?Xo
zBiI^r6aFLPls%pfEWkS`PlhDWj8z6ab2^>t0k(w~D4@!V!Og+lE$LC=-zt~EYnIkD
z>AE0w$ssuz(}Kvqa_~*EQCM8xZWSi{_wuzP*v70djnF@C&Q?JA%o4Ikq?qikPu^dl
z{QHW_1Mt(_qAW)iBnuC4;U6m$^IC4B|M^xh7`fDMrDhsi(+Zx_5Y>pt=Htu2Y$C@c
zD*mC^4Xt{({D<0+5;uW8zJO`r{v@}VH6Vi3CQ2|(bF7FioKgWdB9_yL-JuXG=DDc@
z*=yagwZJ>w$|)M)R)m*&@HL1u_hyR~halm%+*ZhAD_CP&SOI37Xt|9ueDVjVV)dDw
zZc_)G(fg5KPI|6DV6`$5PIhTWrBn+h!-_jm9b{;^4~XyL58SZ6;$HsPog8bq2S22b
zmO|Jj${l~VbNe3xMAF}g{r8)8LyzwS*<3$+x9Xc(pgW^~gLZQ_?TR@04fv(<R?Pn$
zqzNR-irtBGMq_hPG2!1IbMc*A@+!_<4m`pCUXUOXW;&NW&P!c!iz;Fc*-XuT78vJ$
z*f`4G!@FG*p1OS3&+bA&ycih;<48M*j{Dg=`BSW@{1eX3hmnWKhjFYG&fX(OILB0q
z#0KIR6OK1IrwPONAlTfQeOWtf9cO1ERBs#+rxF81+((ds__xc3%rLLG7ZcCPzlFy6
zD*Ko44f0b6AhL-&8wo74iK1Jx>t3Wz<vx#xc<vE;Ya^KtG2mWpG9j$y?~%l?nv*A5
zcFh$Ku)>HxBqh7havwrR(B-=U!XU8rK6lBkohW?M$*w0q^kU=3M!Y7v&Wl0j1+g#S
z0}xM-ACHih{Ui}a8CmFJ;}u&UKg?Y`EqlZOoO}-W(Yh#H4Nh%*qIj~$Cq`q3kqI0l
zg*Pct%w5i9@231)$*p!0^*YIYI`=ZqsiN+GxbJzIRN(!v<AsID)im&OT-PV?((XEZ
z`z^Z|r<4CO+K*3-#_lH`ucEXTpqF!Z?`}-1&})>fAhqitf9*X==G*107*gOtI4P4g
z`rVfhAK$=<aSNF+p@fat0a!DeWL_5j28G392usJ^La9+?<&Lj|``!eF@W%SZaeofq
z{ivp<Yw_eA{fjZE_gHHVb_qr;bNbZQ-RQ6$Q7=!51bT+OzPy(20$7~%mp5s!sxWwx
zN8m%HGiQ={$+ab-q41Z1%rqS=<dKG=>Qnl5ude4|>C6bl2k}*~KZVA`E*mEcL-Z!G
zE}5bC%vk@q(4kbk_!~X-XKDo(+Jc8%L5{)VYY{wP;9!GGEP?78R7j>?$n2s+EFZFP
zL|EV@;7GL_cBaGha@ci8_F*#&;Z(e*8pFdS3R7LYdR&c_X}RX+%Xtt-*$_ZWdRyQ&
zvf3ZHyopRhrwd*^W*R725fqxFIPD?*O6_+j&ns~i0%km}{2G(wQfDy{R6qkGO!x+l
z_NXi+)SB1DM557dXc~TZLKOsEppPYGGpW$bYxK|?Sr4l50C}2ZtTj>?51fzJJPoon
zDO@RZ{=0alJ}=7@hI}RQ%30YX1q{Ua;uWYUUP9vOnfCD89k6Rzm68<}B%9gdt&foe
zW<e78SE!nl!ow}g3QPEYL_AVQ7;yoo3YV;lX{j5J3yw{+x_2jW^#G`$qn#$_YQIgw
z-xTaPfcLLtX$7BN8!XNKUEbKC`sK+wO|)}q&<(Eu!0MRGWr_p^qL7EU6Z$9oce{SC
ztWLlD;1n=^Bo2<?DtKHK<x51Io&SzRY!?DTgW1m2fN}dZW)u6Sd(T#|3o{KxHH0JT
z8*sc+tx&FX^(q>{r|9a{!i$g^@CO9rr^gl}XeR*~Koj2(+)$f@H&;?>jDa6Sw0#$G
zVGCN&%I*Y_s!Y>Hz}X7sOJ(1SulPXrWPB~_&eR9Eb5>U8y}~UD!g3f08T_2ot~nBg
zF?b>w;KkFiesqcbVd&ZcaeBC3aO=SI7zF0reXNf6mmP=vTJpwCGrR}*%X>qmOD6s!
zu*<2*FJ<H(r@e#@Fb0_yZ>X0A>k*b6#>}bKpNL=<MmeD^nI95YC$BE1JTkjxifc39
z)doY$L*TVYAn(b{cs~hWn`@jR@Wi@P`=H3ae;kNq{~fbr7Ay>f1V((;<ZXy36Ze$D
z|7zlYg+g3b&N`BU;hwJl@L_aY_W%>>k8}z%bt<%rc)e8Al-~anm9wwR-w28bym^{{
za`GR|Z{V7p6!U&ZY_3tDl@Xjd+fu_C>fEjsZKQGV4wHua;9s*i+jZ#Va{;{?U!43_
z)ri8_2Pm9P_~!||0z^Vzyf?k?;Ls>e#v;y%K4$o#JqTFO9Noeo&5*P06y!z_l<^(n
zYjTf4(;cxdAZ#*(SLtxam0mF+fxnl5C+Pc#gZ+3!S6y_Cz^g??0{s!nDVj3|1L}n@
zVjyfpPH@|$kq659aYi3QvBoEKU;|u{S~j63kBz|O*5iQJT+q3KS@CX_qW*6@X4=F7
z3)EmCu^V!SaTM)`*}0zFvq?iml9j@M|0;K2y2_gTfyiA2&d3`of35ATPz&8ZEtAVw
zK8i0nycOj=rUYI*is3Jw-|;KH2KJ9=^GLkqGQr8M53t{s6fk3>?DtIyMX)Y|k7Wr2
z?ZtLOu6*#Z^>;NsVWM1AO+XB{8QN*k?$2Wqk#bV@97QGi`D}bRU1_=)Fwk2OV&4dM
z&ghHi&F_n$?wX1?4^>9LbPp?a&u);=am!A=Q}>AaiImg*yBb1GJ9C40O*6V-BAfvO
z&Fsfi%0CzRpo)A%9*GdFZC0_{I4SAmvzR$b6=3woT5G(|Q5oPpqMl}RoR>jN_rI~&
zSMI_8yselkHGgazOv07yA;9<7OvnC{+(#eqjhRd8bV;wkHMdz%nwhTX$ww1hG@2o&
zyhhG7Z#-)X;+5`2i>|)k#ebM_K&lE}r3-mt<mC;mxH&~-Or8q)IWxBeVVPXqVc50l
zL{BVCr&p}_EnFltZ2}31kA^F~%YPJElmDpgv8g;y2R#B)FqkQpCZj)tSu^={vDZUz
z3YQ7+t*8SWR?hIxs5)!e5fyT)@27`vCUd>)Yyj8r;e9S7uv~Dxxa;~S`KRLqTj7I2
zJ2>8P`4Cha1JU7!u!sJ!9qP1C$LSAsTuF6wDxZOrmwgV`n-jjWWKL`X??wjR)Lj0|
z!Z2E3H|&SL5{YT1v7pZ^b!}?JxuyKETRs)UhpXd3P$cigTlccpgt&#LeH0p4v*08g
zx{r0Y-PEyi5L3fU3z`3+xM{9u?^L0@@5=bX2xfj1OFyU;K~sCwYfZa%i0O`ru``Cw
z8b=TuI<<e?ZoE1?+PHZR7rMO5(4BUNteBS^OwVb2jl-rQx$J%`I6deX*v)TR2Q(4n
z>;L&yP|xjJy%@WuHzRiU2AAF^t8i}6UKVz$)%9oiH8@_8*-UrOE4eK=YyCaGR|bRs
zr$GbYWgG?M5(v8yuetu8xUToKG7|w__Y#Hf<89>h8p5ogzs4Em#kpL&&_7@{ywGx!
zbJydAKSG}WC%7#hV|>^6M;<S9Ai?e@<FE~`sGz^4ko$3s`yM&m3ojX5E{|avXbuUz
zKPdMzH?$nbIuNsfZ?l+>-Xq9g(D@L5`zxEkOE~%FUr`$v_gd1a&g5>2oRmE!;g81X
zI-6>mE5d}n0^YM>hBXTp{?}voqHDz|^y;e=z8p773kSRCU&EwE<xn{7!(<Cpa1w7P
zVZ5K*Po`SY^u^mB4fIfXOg-T#S&d>7)U1K9ipq3xQBsGKf3@uGl5KPGHT(|-2(!+S
zG`D73J4@7TbMZAfYT_gphjz*SiHp+QW3Ex1vLXeZ(3=Va1NPxvfME}9;$$ZtC-U?$
z@}o*&0^H7{*Qm;DU6rd+u!J-EkYvFHF)~A@{XKk^O;_(bBy`BIrhzDR761;;@x;Xn
zQgo9=zd?)TLSx2tJQksFPw{O?fo&=4d%8e*k1(?5#v#?Sr^PuToKb2syIy{OA~zxU
z<>lZpmc7QV54B@uJO*6Gv6xY~{2oQ`ND3?|&CA{J{z+4go*aar*n!35`Zmjk$3|Xq
ziLqe>tM-@&>>Lc3k!o9|y)cp_I^T9IJu(Jo!oL#hAn@z0m}P}CWlA>T;3e=>2(PUT
znnP-Xq*^g*2p<|@#Ijm@i%WY%rP?VZ#n{;fc2;vbI{RI@RYL|TQ7nm^{0I<J4jEX5
zkVQ!?iwYgcQ0)^Z`A`NN%Ou3c*LzY}cDP=~gufFZ@WBz8;0Aep`r=H=U1eVzxmzah
zuMC~YDZh^mBJlQq0U~k6z`v+2Pt+j@cx7NH{<mexn{nr_9-sWE=ChX3*RqQ^;1I;S
z12F;CyhztqzCIJ150aIh)42-R*EM^`15V)nw(f3xYQl6j6cAC!%5aPR3nj<B{e?@B
z6Mq!{O-+6-L}TR|)wVi4c(ssyAu$XAiUi~2!NjMuq_Q{ODUpae1_~s~EYY4*I;M@~
z#+|p(KL;71q%tjyhoG>sXFRBEq`;g~_8vvHpkM=MZb3!()rc5g)52A+#C<4#XLU<S
z8HoCfj<nLWKy`fbt}s6<I0^5is-Pyn5)drJEzuB}AOb~OW#%NXpjXG#R3!}TIk-6<
zoDf`R=j2a^M8fb!)iPe9Ih6iTmE?Fw!V+7fJzM&Xcyc@cbP=)==7f$Vm)H5~*VD-8
z=r{xKr+a?=VQ-K3YU68-2j?IB%QxR@9viNioTb*8k2f#*RpuiWvIt=a+AJLFda@Tj
z0p`Jh%dmTSx=d2@;#$|o(GW5Lgn>AR!2?(^8}2a%y<L7Mj1hmPczGu84CpLy$uV!8
zlsQEPQHjC$m0x3<3}ZQ_7yjruw1n2S)E9CBEB7GPW<+idti3vZohUxYLH{$YbY5fO
z`eRMj4=KH=&Xr<KR(h^fizE```AG_c@JCk2=5*Wi;?sPvT`mH$6FaDs_<^HhV#h8#
z5Hmf};drJ=7xTNHJ$NldLLM<GAt94YeJkt2kcwms1hcke(S^S*K0_rDiKm)0MZ^I1
z4H!-9*>HX3NT|?`!NnAK33K)T;p{!&sqo&%aVw#+Q=+mni^z&>T{B9Oh>}(Iu58!p
zBFZXzM4D16iZZgwib^P3Zj@Qk;QyRE(EI)Qe81n{|Gr+_d-ikAdCs%WbIu{hJ^3pz
zwkn03`|+x{C#wVG48^N6tO~3E`lMkc%c|J6l~|G$WVL%543fi2hUMNNQFj^m)d4a%
ztL2y{s{`Z=sjF-FE8w;|#cy>Wcy%CZb>R7`0J(+uRdG*N0>~OdLJaitZ_8H*qB&&U
zb@@a$=oe)92ls?$Rkh@%gjdBq`70p5I>l^tz-V<qa&^E6#PPpyieNum9_}b4t#2f(
z72+eNq(ImcGf1KE5`_N!CFsK(q7-5_kcYy@(K-uzVok`-u{<1*4@E84jaeNa=m_Li
znU_<@i|)TN26AnG)Aj-a1hvA@Hj#A`DHq93{2wfMq-w}hgFgad&}#W|g>iTrAen$z
zD{w*J^Te`b`ygp(R-{NUWRQD79u%hVPe?FCZn(t4Xtb9<h`*t;$I)*Iu4TwY@E7p2
zRm%VgokY)2cqb5DF0Md$(4FaG8B_x2uY>{3h!yKo=OI;CU!k8Vv<VUk8?`H>3sr<p
z!!F|_m=dT7VW@Z>kOtYEE~6jOT5x>`+EYdod}(zNj13&ABrap<DtRDbKNvMbpk_ew
zjN$fEVhlk$Bj)=1;47pfpDSV#4u`r0&Iqd}{%=P2AI{AZt)1k-MkhUqF|eOOj)VqQ
zOHRo22T^dw^g5wSB>N#!Gof)f*0*wP@A7uW3Nv1S`GbsVM}V6Vg%aW(ESyxs;3|>C
z3E~Mii6L1aA6(Ks*hD-;dJ4)!6diy=&=LC%0xG<dPB?h(EssR+x40y9!%O&UB%huK
zqrj3E!*bR#=;yK@`1nnNd~yi#y!P4+(J-dOoL~UYhC0xe6q<B&=z){~*XlsRQZQ-)
z{KMhW8FtbQD@Yw(-qAoCX=Gzebl5y(Mlq_(wNIf+hzmFxj-Z0f0=s!(NPQ;7qN-sg
zytu;7Yl1>33n}2X0KmlEgrD%J7F3{yizJ?W^nz3T=Ornau!RT)aLOW90tRd?<fF1=
z5Isfky+ADylR%;&dvhWS%0;McdCEu-5bup43_0j~aQ=7&I3y%35yWA56fPCY5)fAh
z7m4T+u{TR$#i)y_nnaxb!W13`;eSe%B!zPM7(7AhA<-S&6F+DXjt=NY-$!Fh>J#YG
z;Krf>MjXO6@xKTNF&jbjBhZ_A!cakZ3j8a;Ksa9s3i;|=N0t>y0}y#hGlX1QNz+1r
zf7Si%Xr^$7B$r3>Z&V3?1KXPwh$!HZCj#IX_$`TR!|n;1FuX26K+?DLqo<eKAaxBM
ziPHZUkt5ribif!1ccp&>jR#eQL`WmBC|InL>9GRH0S0J5*t5+r5r7Zhc~-_PkziTE
zP!q0aB6y`i9(WxR%^%VfXCQCbuO+4!J6?Ds9VY?N=*j_a5#-&40ip)=y%IoJcT2z;
zf(UQKAzV*z5kmvKtg@qO!o8syv}oNRuR-((v5%m>E1|4lf{{nrRpB=Ud~>63Oc<D+
zD44=;0PWJjWgxx=JRk}sF=00`Lg;Urr2|GY3NHpJz!0LrT@9B(SP(r-;W3b%j4?^5
zCLLTX!cI^?kgW25J9Q7Ys45|#RH6NEP*@9>f!-j}Lc_J003^X2O>74d3gjyP9d(fj
zI}b>((usJ~2~8jYaE+1`Y&ju9y=u1!^a>=K5QvQ>B<llx^V5$#CE%umOG4rZ21nSZ
zBB@Um5JN%GKrqpuOkhas9X;<2s@5q1o^iOhZk4^qZwaijs$g`W0S%upU7#)Pf@|Vm
zfJYQTK_>X`lV}4_RC6_4xGFRPsR%BGuAs-1&oMSrYSDyfOw}k28E1)r69}dE<$q2P
zu{hq3uoSRp3;=z?X<#USbZK!8tAz}Y!7yoo(KH-AdQP6O+r$YYyf6U>8xO@WV&R0Z
zXkw_I5JL44%fQ_%Bv_FWPe>#tEQ2Wtjs73%532}9wZgg}G`G?Y6ISux^A`3CW?CNN
zF;zn}QeV`b!eCL1Z$SE)4p?$@6nee3k>*w#XTq~y3z@left!$0y-D75Fw3iO6p#}E
z0Y+2w1^cmK76RPBABeH_gjh&Gv-2DpB=!nP8qAwe<UbaU-a4r2p9`m=81NXd`YkL*
zl2WUQ!)R*3J{Y!|5Jx}@@|_5X!Sd+iP6;rNZz9{vfm*u#Wk)2GAo{kELGpf&mWn&7
zFs$M+vB_yJGRV+t!jcpVM@cx{%@Bd$f;U9y;Z1C&FnK75)<hID(1+zs4ETXwlZJc2
zMBBkSPvD}krvcBBST-O#VpJ`(K+X;Co4}1<VPB!Q%Ub-3+sr=@4Url^G{RRj@jedX
z?XeJ#Xk;8=Zx*N(iBe%r;rS=>Mm%OO7%Z7$G$6_#dIGo%Hw@;*w=2B`=Q2c=ks}tO
z)2nRW-?pP@poU;ILd1QQ0S)*SVTI}9lz7Oa$`qajTxK~zhKEf5keRA==><L*lK%^?
z|Bqc%t0$~Y)LTqgfCJ!1{J*I#Q0vVo2LT;4;c*Z%eV}VRWO@Tg8N7^?1cHX%Z_&bq
zQ^3q(aH)vh5O!?C;2ggiE*3p0CkDP&k72ISHtc~a;0<7dBzRjBJ5f&~0BIB}_bRv%
zx5i)>bRQ60QeHSBvdol0hJHsh<q&JY(Fjli*zm^<^anKw^RpRY7TP;fXkfai1>XQV
zVphw;jFp5)M6}JwgGpFgB(%j)t2<!CG#tn*3KI?CdJP8zDihWY5rw~39k~)hBg?*9
zTDWWT0FNf<95FZ9(bx<##XW%^fWcqT@X|?rflG^5KXEXGo;X1Mz@K3wR9s+OoIr1I
zz97eb_u_zFWH0xEH~~Nb)D$L|umu3xU!5fSz#-|66iqggqEnT?2mIhVP9y;WEZ>)2
zpd0qAVLjFPT!NoU0`PO*Ba$S6so^#OQ(G3Mh@GuOm;w@$+7d}uAU8w0fRk{4mwxmj
z8G#X$;pU`KCrhzJg0?*B#C0ha_SY&UgrF@LzVBZ2nv~!@zC@aA7z;!jZ?Yi<40;7{
zZ?Bzyjly36EnE`f@kl^H)Ea9K?>m89F$Hr3`K~XItU?Xb#YY4bPC{vLDWU*rB>p`N
zu&z)Z^jRj)=dA%txH<lXC4T`ET@C1p&;zJpj2{dp^dycGTGa%rx;z0p)I{nuqh$of
zh1J3qsl7MC#AtxfK*BN7Faxs7E3AjBi{8^N&ops@(1lG*QPnHaWCS4JwowR4OHdrl
z=gagH5aYH1t^#o^VlBj_rV|~R4Lu~G`O5ANk;vm>QGVd&C=W&~gzyzj2pOPFQ?r!?
zNVW@W5&aMlQwr|~)<%$*S8ye|4knu^oCXS#+Wd=)l0{8~2N-HKYq-tV8k`HPG4<-!
z00IR*_8Z}RE{r6gIf2}uO%w79p=4)QTM$sly$t7pwSWt6gVLbyGhzFIlY_^-*G?e3
zaI<Jd7bKv*e1<ZFd)kmOnOGQhGzic(KoNbMHwL{iyLVaT8s}RjuMu7_AlRY*hx-Dd
z4kJ{D+)5p*?;9k}$p27Y4OdDKmC=s*s!oA8BMm{qb)TZ}1DtbtK!aw&#sHxu&ukrf
zoQ3Q-_5B~BEWm?I@uclxeOxKpctxIcq!^@AM~9=x<x}CyT>u{$LT<oGY#d+<A~@(2
zNFx~WF^G{zCn2A8pVLJ4k3>d7rmduJLG+DofQH-4;f<f2gFezgCdDBrJOI_ahWaFk
zSq{HP^b;bg2WcVm2*?p|Gr1`g5{9!e!f?~GCCC;mMw@{T^1wpnLAblp2{n?37gKly
ztPg^oNrD}L46g%Ng{MLfp$66EZo@u4*hj+YAf7mognfZ!G#NvHk#URCOBmr5{}K-E
zXA}05CoxN5*$}7?L)VF*4;d?oNAyT|7WSkVk{JTw{h=o)JHY-DzLsbNfC$hbA`pYl
zZQwt`KN8%lI4w*Z9X=S6R_!-|{f~f*f8jA!9z+bXOFqJYJqV(Il7CI4<C2OK`Uf-$
zHr9T_IS(@Mgz>;zK$DtaL4qS1=yb+^t&qGqw!EzHd{B~H7l8@jN2gcC!~;|$K?$+K
z@Vpsd^EMSow}B%i|4?F3hET}xpHwrvBP1X``*&j{bCCV7E}}{(po8_{h#H_7z)!D|
z5_N2nFu-1P#KKh(N-4B4#T;G+80dB|#7ey;Q(>}fsRMc!B;Z9ME8+AG9ESLR7^FY&
z{-BP{<Z^8`o#2BB$NDiM4H(DgNCiXUc1!?tk(>u3LfVAWbR0n$$g(<)ATs}NN*NMj
zqAX_t&nyYUrn!Qx;lVH@NN);nfF$B*Lgk1#kW}=))t`T>J$M?Zn4t8NO2cOHX&7Q8
zsV&P4e^>Z#>JRkKAE_F^K&}HBS!T;*a|7eQwWejH`~R&!gcD9Kl2lB%NA|zUh?V5`
ztN<gB$N`!=>9SwY2Z%A?kivuZ)=5@IL^AEsJlSOQ!%&9z1j4aFr{!0X^l`Q;o3JQv
zBg_Ik$2bNEirJgg4_}_%1ot};xY)J<Q?;O?^W!U~>L)8kqzR+Y?H@(jAO);L4jm+F
z15fZEH4uZtsG@yVrYIAHzW<FJkn$oQzbMo&9?93RIwheHLEqznFh-;elm+yRHKv?A
z3Zz%P)L^w-{0$Z|I9I8Pj@}We&bTxNj*4N#lDbf5qRGW|evBeHnNSGb((reo6;icq
z?1sT~BM_M7?%^*&xqqQXGaWSZw`dQOVSy&YXt^ljf#CGDEcX7bIsDHuEbw)v@c1vV
zdaB_csh2vq1Ck(PufR=2{z^AQVXh!DL}u0L4CK`Y?f>6d^>TU5)#X?CJk*3{c9qqN
z#Og65k_dx<L4yD%|NhE`&cC6p1Aqpdk#Yl@G@OSpLMxbb=E3|ZqMD!4l3U@i=qIV_
z<&5~`RpegF0q+L%kkooKk@~0n7oq~o2I+SH8*L#`l+}tLOr$)LA(1=@V@-iSJPsNG
z`PelHJ65!lV8{ZO$Pm6r#!E0J5rXxESV#w^%uD|-Bmxjq5s0xC0uIQZ!kP%ovL6`f
z_CUl>i76n5A3_6ejlm@o8h~w#E{u&XCTxK|5G;M_Za}Atp*f^Vg1YJ_g(M(tX3P&@
z%i3;)_h??g+Z}53wd2{CdToSC6ywQ+Gvps&Eder<kdHjZB%T0}Iv_|_2q7{2A81k%
zT9b%IpvrJ=q@7y;Xc$RKV7$~60F`oQ?Kvv1GO$s)A+56*lF>^zHB1qnV68;Xg>L8o
zoY)1lLBbRzy_V1=;=@gdtw(7PV+d!PiO+Q~iC(IO-hf<JjqZ<!+PauRO#oZ;ak;6G
zKsX|<31PJ`B>}kOTLFGbJ;$+v$i_`p<W|-i#Derh8U+HK06@_A5TqIcfVfc9-qQ1E
z!Z#=cOczIhdT8O&1(3i7T4x}7pqyI({y|-YQ?aDcg&622VnVRDvC=4Ee*+9#@Epr=
z=#((YX9*pE1zJ9dUe!yw4m^wq7D<&x$4ZG2Kv)Ue#Hs@5Trz?I!HhQopjPA<GB*L_
zCd@vv$@?K#mgjbyi@YBLDVn%=YeHwhjOl^Qm@CYP8DSz1v1u^Bw2iZp%B@lymp3fY
zwEMx#c@Hc{kp&NgCuFio?#TZ@Jj0#@6Tu~!>y`}x@Kghc=KrA6BvBBjx*h;fLVQpO
zdZC6(N`-L*ReK894oE@<)ly%8<KmI?F3gGF3a<gu_74*WD5=)476?kJDJV%`=)^#n
z!pmTFDOAfpOOku6gDXWP2s^9QIyT`Ai1$&F_J$FRj}gNm@AV=oiXznrk#HLsfgqEa
z7%UZl77l$7Vs)amG2|3DcL~nJ1la+M{g9$c99^Ky-yt4tGOY4QL@kuUGdKVvdCl9r
zBM6D;8F~eA0j9WQVlu(}N~!=RZW(?O=Ofw?ysqfS<_n;iB027md;wRvf1pJKXuYzj
z4IqREA-+xSIo=r7=s%njnZnT_M}&HQEBWjoYFVEq^_kdN<nP5p*exCxUAAKb+h1A9
zunwTab2J|~Hxm0HRRQLQWtTNT-8y{27yv}-|356rsH<Q}CVUa8KVVlcn%H_mBqSqS
z4ptN}21B}CnhD#DsNLTaN}j$IQu~jVqKGXKzW$TVIy?_J4U8=}7_;KUpgGb=kS>aD
z1DTN=L*$^6VDJKpq{U32z>$G4&3G>O_jj&IkT_smR_vv~5fS6Ks0G}SJShLex+Q{&
zjIn5_>z9`;8kEBmD^(C$fD-^j_D-&t5WCESN%moAK8O+j9M%P*Z(vIF3it<vb#Pw6
zkrYR!F(d>%hzrh!)xHGwFfZ^GT`}CiOh2eJLW4}kL-L~oWTYWgs7b!$4s>m3+&hd6
z?BA+L2yw!Q<cj#12@cM)))OMgXmJPz5gDwJ+=17I0LT|+Fi=1$jL>+IK_L+*G-yr;
zlm6|MO#}jO2l^45pdj8T(X(=+#7AI|J&2w}SAb*%S|Qw>1l+d~&Ol)32@fE{V{Py@
z`gKSpvngVg1j7i)k^|<suV@u68+q_;C`^QAg&~2Sb{lMN|0(`3#FOd;;}8r3er8#a
zBh5X&7qnQ?n8L~eg3T0#1L_Un5^gzp4){u7qf8Myp)8!4T9Kr{fDW^SG$~RAB);|6
ziiVrr(fR{n#Q_(EF5H28h29bw9?_X3-VGv=ugG&um?DK=IVS8J4@Ka8B(7uA3EVIa
z?P6dQqR<ypOccbS<4!C(xEO&|DS^ST?~#pIO%yw1(Pz@{$DfA2kq3YvCgP3Y5)yKZ
zhBbZ|k2GAs2iQCbv|FJW5@2ii2hI2k>k)2DE-&(bY1;qB##N|DZoXPaEJ+yP)!Cbr
zjmAA}6CfMVTzTmEMeTkNqUs47N6>2|608sf;Ii^~LC8QF_GrRRAO6n}!WMm`E)e|i
z3C1I-=Y&h4h&l1IpyPus7dA+`0%Z(Cj~)OLg(FOG9%sieO06RzEAfJqI+RMhAf*SY
zCpC!s%j*G5z-B8R58;e`2#kO2#@VCJkrg`9jvTl#t!&B>-Qx(HY{k8469J^^Wsp8&
z=&KP(AbtYC*2_C`uw>Af<N1N40{X42SZEbKWY1(x9D#$w*0{ImDhCX7!;Kd10l@(S
z*^{vz5V7Kc@dPaZvRr|o>_T#uFy7}Q+QJ}V95WH)rU<u<|5LbGH3Q2u2Hy<~;jdZ6
z`+S0dTY;Pa_%h@x1#_U_-z}`%$3jM}KGJ-96B>DjHk*hs;~NQTgC;IGAL0l*hFm~Y
zbl^1`2qVM+M!szR0A2uux>*faH{dBUShoU<IKpc#QeS|k3qudu5b3m;A~y|=0$_?J
zi8sqoW1=ktB!OOx!^2U8`_ReqG>K8@0h{rXfU);RRU%Yh*2hTU70yEH-15E!yl_8;
z1`9R=z+>7wABiK9px85m`@(;<n&3J9$I*r{_@~w4Jy;C@mf&S_2Q(o3H*f%m^jnTx
zktqIG2DOSLz%F?B2vh~MelrYn9LoThI?0;x-d<=UIvkM-GILy}{`gl=YPplo=wKK~
z6G22ILJV2j!58+RTfDwAB|b-rT4FU_o41;Q!l;*$4lWr{QbhF8VL8%og5rl1Jpuzj
z%MKK#T~(eNboPcvA&PZzaJfAI5HSxtJxCckp!`w5fjwyL{|wsi?q%fv3ue-S_$zK@
zW#Uf&ohCF#Sfk$Y_&pFo903BJAyyB51Na&sO2p{@H(HI~4pa~NhPn$jG~{^|j1~%<
z)U5iff}w1~w9hXqb<3%+jQ&>Kz$FC9+`wr3!sMyF;TRm@dI_}D+{g=uaNQETRYwq<
zNhTbm%oTx88&Y~!83+j#VZ_YfgaEitpbP#$<U_1aO(6nNBBoe-6t@>12u7icHqd#z
z2}Ge~Lik{!rwAALM8AcuknY4Fr=joY88`zdxDpdR9sL$wR9%iB_yZH~e;~u(2d=br
z<T8hFk*NR=Ci)jpi7jLV1ah#Fi7-FQCk@FPn}20lZjOS~9{3|iH)%#!{l_*}a#Q^O
z&5x@8k9GgA{e_;QWAXn>d4M0DS%(g2MK}D%cF28L=`ZBhC*;=zqE9kQ|9g<Y8i-D<
z{dMvLr%i{%6rw-2wmc?!+5jd4?%f3uc$J$BLJIw85WZ^R{bRDf362(CI%C4VfHdDT
z$m~LRpNI4Sqt)`sVodb%b9tz#0?3Yd2soN3fjOG2tODS0>5`f}H18dvA5Av8>w|<|
zPl0F)-T@GlfDdr$+baj`n0Qk{42hUQL_NAXodT~yh*kxFLAuACg(Hk;sm1z0?^aAn
z(8~<sF=uELzaEOj69=2v+IW`Tau|%G6yq0(sql08vtm_%2kDlH7#X{P$gWx&s1RWI
zs+cK~HDgMJSYh!#;<uy*`VPkKR3nD_HGq}?izoh}I5Zl};2nfMU@)dYwo&wbiu4=4
zR8jcq74(@V)i0?=43`nYZLEjXqzRu{QaZp(`~*SK)gM)2U`z#Br?4ROpt{jOqYo;A
z+FcFbZ}i9`DGq)6r4Lv5`kQF|koT8M>vfWC6iS=0)1$*?wy9HvP*8@l<14VD6+f_i
zR8<jO(G0no>|#C>!W`^pYd<E{A1}7iIIF64_EWmF@7Gr!pEO?jv=Fd#c6MR-tFp9x
zi-M=!=&LK|4y1o-W0i^2vk7ABPsr6;5OaUgae(iS!1LDHdF)x7SgDhr@8~b>lB_BD
z@2N6r%Kd$1boYj&jOYEok1_D__Zttk@je(gpREvJY~-t$fBK3wMs1+{V@!Lro!6%c
z^&#bfo56nXcG0(TOs0hE*8UoKKl*E9PUhgBtHqp^*Ld?YCiuo!^jVId(cHn<G=J=A
z-={xs{CpR7Z<G3XxjV9H>s8u8hsfTgg#+BU2;U#mwV6@4=Z*OV>l?M6_tE9EO)*ia
zQ5o{a_fSzbhZt>BV+`$PW8ZH?uVxt9M5oJhT}4e%t%hD#;Cgzt!2Y+kh6ZW6MkO^z
znzPGjt|=NVUZXine?vgHBjKm(_a|4ggZYQ{eSZ>?oz3se_DlI<c6?1~QoB-CHuwJS
zFYCKCjn?h&J~H7et+pmkK;^O%m)aNl^5|^!P#+c(%{G@%Mfu*=l0IdcjhEAZ(S4q9
z`_MeEd_XWMJ!NZsw#a<T@e3vIsTZGE4>;Oa@u%i)uvfFM-fOa9R$^OU@O{0f*UlVD
zX!l{dL|5(`y01vwRr`ZSKZl9LuBE+3bzTw{E!EXV=PzV8eQ>$JO3Nwfc9$i!@n(<Y
zb`z;{Ss9$x(S-xQEP4BxX`7zj<}*C~Eau3b_6rI5J2Eeew^d)62sn3~Z@9JN+-~ZF
z2`c-x&d1agvSm%r>pw4yYt{5GpSq&St(=iw>DTh%(BOv~({%}-@DEio$7>E<jcF3h
ze)7_ZJ9Ar6{a|d}06v;x595KO-?P>?ys>*_b$jHT>Ek&1(_)8Iy%=w)zn<QD#36Hb
z(Ec+sH*MX(#%YU776<xDXs9c)#2c?PT-1BLeZgIa_LS<SY>s^!cg;x8omR8mY>a<w
z{r3G;d%p-xTg`~XtOU%ZPxdCX`K@oN1Ku<33cE-7=b0F_fBE#4m{xZGg29fkRvG_-
zp$=T@`s3!a89l6iUqds)^Y_wOB{H6Lx0b@E1Phi_Cm(Egln%>$<L-Ko{R8j3)2%P_
z<wCZ{m4cM(KQz%<jz<jEzw;g)|EX^zUukN4-1(_X!|A56maC=yWupr3s3#s&;T;VI
z7i-k_8d^ym(>rs4)^Pl>+uM^8w>i6MQ+#OiC3Fs~D?DHz!+hToD}QEMU*b09VKv>P
z%QQu=_wKy<&|L3K6vf7)=KNb{F6pVx`Zd^Wqm*C`@t`j)7M$=FxWV%6>f6`!Gdav<
zadX9I&aob`I~R6}Jv2D|)cvjba{97+qvv|_P1U33>geK`@dnI1ysy*v+A@PjG1=H)
zj>a~|mvj!%szFpU%$p5W#RQDv6m?u<pPO88#67p5VqiAYRXtB*%4URpPD`c8Qyd+9
zl17%TjXuPgCXvUDjnb02OH1_#jSrjAh3DI-%K3{g25+O|7RX*7B1bnC{+yTU9RCz2
zWdQSha&Vvs#cy@hpgwL>r5%@8HU|ff@;ESm8|2=i{|2j}@p~PoU0aT~a%58A=I!yx
zTOP_yUlJ%iap=uddB#gKO;<lAS6kPxFisI2*Dc@pYc8+B%g1y0?`pihofA)&Kbs#<
zMQ?XX-i6gd`hKWO_!*Nt^=N6&^uE;Sv^e*AJDlI3bb51d?>VQJ6MMz3;4<E~+P<BB
zB`qB+I>PHo!9n$A`jy)C(>I2$gt25RW-8E7!cPstPb%~?@9FI2ScsQ>D)9dL(3PPN
zc3WH1v8oD`_9wm+Lj2Zaa!|w3#{NNLNXQ8ADKV~>{<N@tcC)vVC-1>L#mur!CfkxL
zDfA9JzjK5?G@Wvxl9l&oDhs9&no-V83(TD~rfGQm^E;1f`HXU$Dg)&K9@Pu8%HhEm
zg9}-BBz|V9Wm8iA66hH@&k<rrGqFE-Zv6bV5Lp^-&EUi@=UGDHXrAU@E)048k}i>T
zY73Rg`pS1KV;ax7=!~w+f7G;=q;%z1T{C=sZAd$ff4_+5=4&Irm?=di`s(S792fSf
z1?#^2!AWIeUb%}o`}IsfI7L$O<QbX<zJ*GyVDU?nd(qE09#xLUAN*9O68u&8(N8W@
zni5Q<4PCs}%+?ghwd)o4QGq@kntgozt~3ow3x>RIn?IOkjjE0v3+1NS%G;pRwu=VO
zc*;LlSv8u`?;SVYV`ev&c&w@-Wg{I8Jw}ZuCD?>!hHi=n(9?@Xmu`yBNL!Vb>JNQ`
zrnNj}AWai}gSxdSB_+)$E3>Ax2;~VH)4dO-ex9n?xzPQ4Ao_I5prBQhQo4nIazgA(
zl6=-2o%#p!Yg%&fl=>BEUIT$KWpM+o5zL>A4E=nyBX88-e6Dt9%}Zx9U>%~y7betX
zC$=j2KdiT>AK}jWGp)d#H8P)mp|xz@qAA>LwD$zVy^~&EyiTv4O)}VbcqKgk`Fd{i
zWy|sO(?U-cjgMt=dq>WihkRyQG%NH=eAU;skbdRXSq)c9+pn%8ziaf{T+HTZXd@Y0
zOphmI&mJyyi!xnY%xsAkivIX(oTKEKXJm@6@UPv!H7qN6CN+NZUt4^u(q#Lccd>ov
zeWvM)?pGKKf^NM`51+c|8L}%47a04D+s31Ve#=E=i*1oY1$$0e^msa4ay`iW)G1Wx
zklgbeN6a;q$O3+ubPZ`{(NAsqiSDA2qbIZWrD)8S*h@3&Dafd>4Vrp7g!t~g>_i>O
z!S^6q1IOI`D(6LNq%*g9Xqy4|4ONFtk)kZ!%{d$Cz6`YKV!yjPY*b&X@SvONQbkox
z>1N+3jdA9mF&g6<@p-NaUV*e-aaQtPY82-Elic0dpGs9ZI2Ogm9KD9{DON9$1!nH<
zn2#558gJ;Xc{;4~u~uVr))G$9c*mDmpW{qd`l-!3Q)#og+t@j5ll%kf$gO`Ayz<Ua
zzU*^j{D3u5i1gu;Nz#zJJo_T2N26_m!()uGFP>S<m+^}()vGt$<?Ae;Z{RNH$}!+B
zUz^j+UA|qxX{gNwds=>uLS4>%?8N681x?0o7siCh?~;+*_%{V>3@3jXYCDe2{KTwa
zw^l(j^Su~1-@Azoj0vva86z|KBSSQXZv@ox&b-+-)J8eODL=Oh{i9k~&&~Jf>n6qo
zs~>wK8}99`;+>f=^cXvQ!=95SA#YPF@64P9H{ayWa1GalCr!K_-~GAyTz56({AjQl
zX?xaaJJPmx_`b)OhKISroK&p8!W_N2AotHiahAw^J1!<_SjFo#<?OmA6X`i779;kl
z?H!%LVA~@Z+0iy%8TrvRrl_(+js46whTAS0WJexr&dHK=k%(-_=zX4J<zQWvW5wbr
z9T~WPYzyPoymQStL&Hxz#%MMaD$H#<dzV{L$6HQg{Ac;Q&H30+|88mJaqh@<6AFsS
zN6&0^_^j|CF5PgG+Bm&#d$mCrZHD87gi=@PrYx?8aN3v(z3h8T{?v>z(;<3VLm8@v
z`f9oJ?lQ>ChWTm-9L_H5JhH|d13v^As~t_)8uY02G^wws2EJx8w3%Ra7}>o;gX(sG
z>&O=VL{%;t2P0Mou~-eNFC~4gdm^@lP{rir?9W!Fk}jQk&C`0~oTPUitj8UV-0f>R
zF1=#0l-#<;%h8i{NbTiOPwvb#4VGCdPvfH5t%f|9T8*Mf&RUIaw>EKOG@ffYjO4^r
zOLAo&HcZP4-)$>n)xQ{@(-ps+@}QOQI?C5(!od_GBJ7&kD!w|^oHaG=TeIDg+2r%2
zS!33%wY(_Tf2-z%iomccqbc7d{&YRtZg-t<4j1u_j*scja?{9Y1=FmT(+IvG(`zC6
z+HD(^N&djwVJGIcoh(?+xWoG_f;|&z9GirCx8<~RiwekLHMUB*h(=yux!Rc1vTe&<
z=1z&Zlhm7wnN7BYeht_Yd5)H%`*}_Y#p5+;@||MT+0ERahpMz+<w&#K7%&PN_GOEt
z<#~Y9pl0!ui=;i#yNz)}6>a534Gk8>hMW_0umlI_whp$@VF5oe*vgSMVQk<)o7rb^
zd6`Vbb&LkNEqrl29&3jbWWp!bMz-+%s>*TfJn9xTddlBj<{rb<x@)*Y=9{n9_K&_7
z(XqPsJZ@vs%hHKXO}|esx$D>W+L`FwS8jQ?W%K=>4F_8r21-jp_Rpkn<?AeZgn2bu
zx%7Lt-`KDxN>#Q?bR2s;JBLl!=1|v{1`)T4t1opvvFq6J7HW)!)I}U^z&F@u<&2E7
z>pk3Ac)3&3LpMJnp<_(|-|5W?AK>R9(LFKgUw3-S3Kj0Z|Ii@jeQJ7%jN65xq~SUB
z;PqB5oOJO6FY&PyoR#U7YN<x~3MuJ<W4Ct-^y@q7$``6|Y%zE~ygu77E;z&?*+Evw
zK3>K*S^CwcceSapjht}>DRwp<+BDDAJDl_xH@Kh->}Tz0Vub2rf~Dx%I`tXfyxu{-
zdH=pGlq18rEUIr(gq%Hu;={C`Cwgs;?^tih_~xxIU8<<Tr(yk?-)#_%b$19=h>Vbz
zsY;h-qr7U}a^>Qe=mV0U#8sove|5rtA^Qvsy~d-T+B`hoDm(~H_h!7Uc^#{9lSOo>
z?LFPMPi<Q~g5<pzo1eNnWTXi>(V0&si(4Ber4=~QDQ?PeaiR2V;s24Y@#*sUmYj7B
z%AeY_&Dr{yH~2noewoADe4D$RJI9jo_INsXs%>O_ezDX!m()QAi+5vXIqw#X?_lEJ
z*U3`u-yna8%kzGF<%zL^x~FU8*6Ri8*Er3YURRKF>aRI|C79bP)1hSp*Uu(RPnRw_
z%F`_yJh_59&syZCw}mLq#&@*QS5MKDwVgYeb-U3K@6X1%BUs3Drb_%(*p%o^DvxeO
zWrLWc4(-Z427Z}b3++_yJbLCe&g@e)>|005jG5a*(^c;T-Bsg}!+qXINqOTZ4NcJ~
z8*^?r<><QNVwU*ynO^x{mxX);-#*TnrNE_vZ;bs0#~gdP+nx`v3v82nD*k-l)53`B
za{88~aq5dg3eh|@s@gX*k|}u&xW+p+57*Z7(b0!VXVAJfm-tKWFEy?WGw{r9k=!RK
z$rijnCVwuN=bUP+N9g%i?Q3~{78;D#O<YVZysC{;VH@JwgX8F98al5XJBgc?=G~?*
z9nBWqxi(>^i(ReCnaEDA1Q(fjOmm2|<Xnhdwq3PYO}t#1md)FBLqV}y`lxT(pY#l4
z;yCV^^|83jSpHy{m-fl6X<Ru`y@Puywqu`btg9Ji(sY^5U8i2ayEW!&bLKiRyTb?l
zN6TYk#VHmu`q$0q?rv`Guy<knV&^_JsVQ)M+;Ge`V@v{j;&!U!UDa1ixhGg(>pHau
zF$i>OA4nK^rTd|$I_h%hyRox;n;%d0-~X2BQ+4y(J)bJBxe<vNrxu-qCK*!d&$bL&
z8#6Ajh6>DUv;Q^>+v$4zy`s}d4r{fw`aY%vl|$Hg0msao?Rze{tE(wjUSoazy3js4
zK7#pD;@7F?F(xcDcVEwk$&Us^asPT`;*s<teIGC1FnvJImP=_jvzU12gB#@})*mXx
z>`~dcDc1M;rBdBD+oc@j-Pt1tOZU|z(7pM(F^W1X#sO=eb9ZhHc940iM$f$Q$Hz+B
zbZfJB<j&uc*xaWXYbB6sE8)wd&J;p1WU}oYZcr#n{{H6sJHM$mFt7;T`^|aC@^1d_
z?TJ4gx&*jp_6jsQREJ%E&=YO)ky;>C(fj9`FrQYNP8R+P>g#@=z+|Ml8U^UJiPFWh
zI^}kMh&C2nV7TqG%VtcN-=xX!7kf;(a9`WCg@}mB691uTkvWlpk*VMSzU!~62U^(Y
z9Ah-|W9LSGN-t<1doOV#=x4q@-Pt2rEzbGd?=|Y&=lQN)TvO%vUHzc{=Aj-<+%AT^
zN8Sajt=BR~Rf`HA>^4!W%Jf@*+=gcFlJnb}B5?xTuO1#eU1e&#H@ezrzheGb(;Obh
zCp8rf14E`I;b-<o5AE~z%RczK{lYs&`<%u=p2HvJ-fEx8>BosYW)9sU;(dAETmQv8
z%k9|eu`#0?&T7f~@=DvI?lFmdjT13_z!6~9Be1^Ar2j;d&w+8d2eP7^rL$D0KQTR$
z?N&IN{N&pv^VtcHPyDGFGtp|X5B67WI2adgeLs+<M&zTchom5$!o6~lQTbV{koPA6
z&mG%M<2(`!O&D{7%O%gZgc=Fe-ZpJFxH)*{ZXUIFEZ^D#T-x81oNTqG6^^;(eie+0
zjO2(&*rR0`ZfwQLnf-gT_r`YDy!bJFXPLa)uXQn$&*bM!onxO?Jx-1c8fa@}9=MHt
z@a2yBQt{K<#$L4^h5Me}=F|MB@$;;6EQ6s|Bwp`fo`#3Uu@`eEO;TvD=lw_&{yd<0
zIAz-<AF=BkS?n{plrJ><FM8fOi+z)C$u2ICx@od)Q_agZyK^Z%xpjMfjE8lLe0$`G
z$#TJBu3&z$aE+agGUu7Q?5+DOKSSupA<O&5scGFJ3L;LL5hIO09tCB;7fd1<i!2&x
zM#uUzB$XaW#+Vc{AKRfYS4;KrYWh?`_@OROo$TN=y06b~y_@B&ol`0Q*6~D*?p3ET
z#{S~IeARYU$A^K*TUcMcPEl*vJuI`kHjHcjn*sAv`mn7E5jG0u&saLv-D%nVhm!8>
z0hz_G_@9AQ)EnRNvway$SrZXqZ87|tRY&CvkGFnRT=o0o_ssN+UnIHXpIs1r$9T9q
zx8fj!@?B3qx4m}f`E7&z5;tB`-xNWAJ|Ru212cvd@jY&6a6Mi2!K1fvmp%&rHm$nY
z-F?dP*#YYsMfwxIVmfR8sO+j$O*&OLKB-0rz0?10{6;}beS4(5U)9%?w1otdZ(-q2
z8Cj`(8isTAH72iF=2X!eEO737g*lq@{zW=x<Tp?AoY&gTi@Ekp6QL~<!{2aMMZasj
z>~HT$!TMdxe|Bu$ZAAw5p~njg>es@r#u;U4kG=Cho$^5Jpt7C72(4^XPNSBt^5<WV
zsn;JJ;;VU@@V@-;<iY%_61&}c=G3$<7<}nqFKXHOTKsnVLTY7s)H{83pMCvQ{TKN1
zJTA)x9i`BgI)A~hL%Lq3^VutwRJ`;d>z9)~S`lh8&FbTVoo5y;PCfAK8oeV?KX?JB
zCwS9~9oO8Uc2D=ixzEjer?d^<hBQSyttnx=Ix%m3Vah4s)LOxO;r!M^EFv}QjIOU!
zbeI`qI`m*sqpv&UWz+rm14kbpq2Z5x+n3AzOH24+^+)GodgE$Cle<BZMhykL$H#TH
z(ed)$_dc-S;QOX{wV{2f<(B)e?GED8y=^7*{cr%!HeZWFTw~0U8=Oz>7d)oW^G$2(
zp0agLTi)(swrK884h(ogC!6LytN%xBV_Hd9V#&PuenH%+?R7St2e!uU#>S?Z{2t!c
zo5?WqV$*%2RKcN$!Hu77N_gdUn8)8U9CLYeGH--xYh&2N*&_Z8;!O=FUziFt3!K)w
zaQ4lmy}#1A+QKXIQ|%i$C7pYe#AkXg*uF2DeWo8&Vs<$rX!l9!#<0c5U6LmYX7vRM
zc^lb8bz*dng<PHSem!r7#R`<OVQOAv<ZiB)ZVX)iIlt@b!=0y>GGcb05v39NcCu4j
zP*?YAsWg6#_8*s|f%|-NCe0rOTo=m>b)_DB)N~%{%ZM>mQ~o0w8K_B<5cVfxkqL{*
zdz_To`R*vav-^&ShoNnbC$GP85g9#^9ir!5Et4qW^Z7F0LH%`9gEK9<k!>gWUcVP`
zlk%<^{rQcVib=xabysmwh!fq}g8O#vc~X@p)(LzMN$8}XeW&CoE2In-z8lVb8v=CK
z->`evpB{47)$-(?Lk3)*ZS>d`ii54sC2tc7do6RSSU)?>L|6Ko0bkcG-T)7y?j3sK
zoZi*Fip_&p-lWkqy-_ipzE>E$)l*aEYxAv|TjqZ@VB~T4??xYF{}7R#dd1T3SAVWd
zeH)|Yseuf}oUX_9Pu*nQOj3kRaG_mwV&!Hf)h}GKtvX(a%1&$)z%Dk=eXv|#X|R>S
z-9Cru!pO)@?UF#g8<QGcK|vq2ijobu@H^ODI+c`Ov3&P^(-1QoeK0|&Q`ME;y|}K)
zdBLti?}*F&hK&riLnnV^-zgBAlPzskusr)KUt5>)Ll0v`6AurQ$;?)H!`|-0MJiWP
ztXX=gb4D$!el9pvSm8zW#PJ2E)||7q+A`fcT5$0NWw(mu9><B=4QIl?P8J-sJKSv<
z6`LI(*Sx!|<10(ztt^%o_*-o|ZhAHJ_uk#b5|!xBDD=!|gFzOqW#PNaX%U%@?Gtr+
zYN8j64*k)3(l7MWUbd=*^^c!io<!QV*jfEV{?f$##v<SRs}j1Oc1k+8UOj!a(0Av^
z`=Q>e;~IJ!T<SHKwm4yrzkhYmz(-s;i2wdN-Pq4U+mseXl_Y!uii~B=s%Z0hZlBl9
z;VEiS-1-w28ilt%l>fEunJNDOmh+;%`&i3Y-Tb5PX=PQX)jw<u8!lrC7Y#O&_pB>4
z`*hNw@9Wix9`C)|MP7Yw`4Yv}=Ww>4g<8aZlTbzR6Fc|d@{HS7XYxm=<UGfI_&ze;
z$f7`D>?R!d`h4K)KDl_2e5*r$<Pwxle)l$Fa}v@~W|xp}eW5h`LsE2I9N(`i{O!6G
zX)OCiuEu9@_h=Z4$c|Sn(#+9qqTiN!^YJe3BCc~&KVMW_TibA~TrH>i*qzJeO@&zf
zDC=@h!7$0icu`8lCwFLz+IA$UT;9JJ^Q6#j^0+l^hxXV83d*OvUz3!=j_d47c$HqW
zr}T=?#dYd+MLKLhu2DAe(S=8H(8kl69QmB0>Nc!o)NT5}<q;>=f#!hmI-^BuK87_4
z!CnKMyBqtCELrfRI?Fj12ddMgwRoE+eBCLnc_)~;e*DC(O?6qgCB@U_QnlN(-RNb`
z%)dL%z;&Wr^+Su%WsZB-WxIYaSSjZC9y>+r7#p+6Ox;_)PTti$#$8_fepY+>BBk21
zknF6^b@=UckM6grFn@K?3p#rsf4kM_>5dpF$#?Es<5+4X)@9>riaciaF^1WG<ZPH3
zbW3=(+fjC%0^1*<#T3V<4+fsSsdzlRXW*3Z#mAqEqG=iR2P99h-gx<~Kv18Vqn_I^
z=H!I`%?H0~6dbJPt<tBdE>o;Mmr!>ja@?-gNvQXT9nGmYmUn}(eyQcg!REO%#b1@y
z9%;SmR*?SwZ3N>P#qZkR(%Bfzb%)d4^p0Lrx|L?owfTzA>sv3xj&`vs#0*(>iZ-tw
z*E=Cs)$L+YI(oD7ZFqnOUk;a<uWMJ&b-TQxtFhTL+wpEOr&LB5_bdG3oOFx1c=zp{
zXu0v$9%`*W!{ygayxY~s_?|I+&fRTsx?RiGFJ7=OY2awG|B;Ay$7U=!KZ<@zi~OLX
z&tP-Kic@g5xQOTe0sSj?B|30#^yS#EEMDDRVb&~jW;?EiU;OA%?o6A;ropL*s9WN(
zmo|1yO=&;4)hYD5*P*)a^``KwGc193Vy8TvvFKMI`@jjNx{-i!-rsW$)d#*rRv%#U
z#W4q-^Lwl{j~{r?F;EzJlMkE4spZ$jv%A<z8Jm^Q(5Fdf<srnNBGP+^rSejEjCL!A
z!|R}5#I<kw40lUUIUMxEUCMdiohZy1x>drU<yOVv&g8rI+Gmp5x6kf*TSpsHdXLhk
zhAp!+;;@;AtgQc0&6cLT;q~7K(|_;ski|3~RY|!2L)bp7+HxfQM4`7@5WAy8*RCBK
zKhQaSzV}HUYj20Wdhir&a=^BUivid2Ds-j>uhWPy1?26yB0(+56i{O+eyu~Ux9^~0
zK#jDxV7uH?*<68^n1igv`-@JiDsM5kC%P!gyDxk9H0})_rcj1jd~j2wy?N~}#=AJ?
zXZJ-br)<op`<kg2-WXZd=#+#B&(NR0U5C?;G2K`kvEQWCc3<Pz{O6)ut{Yw2v`4L`
zFtQAnHkS05FpS+kcVoCoiMe#n_<XF%moIGHXQVclz7zJ>##T77Z`)D0nc|{h*obma
z>e8rjQyG_r#CGh-+S`dw#71vQj0|i%C_f?7Q(N;+cc6I37az4q+haOw`11>;e6Xy6
zf*mJjteyBSxQbEp+h+ITT{!Fl<2dbZeAi5%aiX5QJLZ39eXr{F*X5xc#;qp~w-%|l
zzDvlg891J7zJ-zLk@xEpq6fb%F0tkp(pR6=h@Y~`35}xqE!J88@Dxu~bQQ~%jSJKT
zRKa_=co`GZjnhQ#-;Hpiv-_>gd&*py-S*s`PEqxOBO1!KSBhyXw!gL&-TYmxA*|#1
z?*lT=M1K2D7{$#SH+*PiY~Or!gehDw;LByB8?W+qvu17Bxo^Xs#I>7p73#cw=nltv
zJ+ME#ruE}GZ^n}o=QnKJXr3STCxQ9laa`M-=fMhYnHT2Dj=U-4P0t%;(SGK~iL2l3
z6NA_5%AiO~q7|xC!R{4_efENHI{$?Jx0h!ADtgUNRAjX8oUP>Srq0p7a-m^_iX&C-
z)vb$sCwH7-`XhNVCXe~#2QF?qjwPo%S01i^@l+ApBNO{9e)GYvo8wL%-@0YXz%Prf
zS9yQ!({GTt5nsvhrQ68wk>#GvH9;v-gOwxQ61*yg@3cl43$`iOsC7CvK6*G9_S-5`
zip84p#tXNbd%~u+$quCKJ|VP0?iS~Rdr1eYYP|Rk@NUpC<Fs<Rq?@SYo`>1;RR4{&
zbaR_^3teZwEysrAcJ2KejW2LwF<d8nww;U^N*Ja6wXRe5w2^zKzvjd)x+JsD@7Lr=
zOZ=HylhY`BV%@23{WjcbmO0KtMtSB8Hs91d^X@S8h3bzfo(S~74tMO&Ei>O#QeHT&
zZu-N^(!n2_c=$$Q?!-3E(;0PYf`*5Z9-BmYycISXd|;HLmFSqW8z<bMZXatXS0nDC
z`^Z?h??U{p8ysxfjg?W|k8>7eWd^T2;@wUAEB=}$v%Plpwp~4qg2!ptv{+~~E0+rV
z53K)oZ}|L4hs5;B{1Kd48$%g=F}LBJYnlGiqUV&SA2NT#>dDn<mw(AKE|<!2;lS5n
zX|;9bgdRw$m%Eo@d<VwHUXL8j=d$CsOpy})AjyS~IC_oCF2O}p;`N@bY?kGj9C%s=
ze2gysdRc5f*XDzT3|9oGH8f7?(0q87G*faVO;a(z+3##U-`z^n;{kb7-TM?dj@yQ&
z;M*)QPn*;;*pIu396#z1-`kwe7OnHp@S|ByZF_A;+sH*V>T7E0Ri5?o!wWXW0od>*
zsjedrr^dGY;hxj<`udE9|5tOK+S94(d5!z+Uffx^&fBVM65<kaHwDkGJN;)&wxxTa
zDgkRebnA{%x|^9b8)Mz@Nwu|#FH0}&DJu_uzm(JL<*&b2f_t)9CeyaNzA7#|mV4Vf
zuHCVl`~$b-U%u(!ZbdK3@#92uo8yn^>m5fzGbC<*O0rft8g~87J9*<p`xZ&bLN|x9
zfwt*wR<+f}7cO`-ZjX=2Rp5VVQKa|s_Ro;UpUNZcJ0><7x)l#?;EfzEc-Zm4ro`We
zf2(aK*TcP6D@7$XKYqQdiz3L@XSdr9*{iv}`l?!!8#v6^E9AOra>oi!8_(GcojEkO
zf5^sYZgS}Mg$RC05w=_9VSkP;un8o`sh4`y8D6jOS}bG;#2j|po711nR;IX}LG;Xe
zbrboRS+3~Qg&gt~mzCNTFNIL6oMyc(c!B%(J58sMjaAw2sl-CHiYZ(uYHY0&*53;6
zq&1?}yRvw=`vT9lchfam_r!{5t&bho`nCV+Ldu!6&=Wiz>)jvHUS88uT6Ie0P3n}X
z#?i}RO+PcFG6t`|m!Us1G@R{i?BZc`G;Z3UqlICR;r=wJji!k|%ZBm`VzW-+_h>0i
z@LTL_<mRB?Q}eTQvsjLPp4O(R^7tp8*b~ot6^ChkZLg9}Y^e+lPZvz{eY++mc8to-
z#9^p&A5YigvP6mBY0Ps0@<%)7)J3!>g(!0t*VDz?U9>oJdY<cf(B3B=OM4Xf?y0|B
zmze(M{Eero5_ih=uW#iTSVQs46gz0$o;g9Wb4&8kt!~^W#s0j_x_oW)7Dt=qD@AO9
z(VU_e4P1)R{B!SvYLU=e<>FCVm&7jImUi78ceNUC=2WKUt(_klo+zUA;FkKCTn@VL
zF9fT2EXMk8RXT2s^rZh-oLM75w;0pEQ%%Y1>#dIucKV$TEwVcIa$Q73#tWIrE5aK!
zRH>dC2r0%tezd33|KUeVaV@cM)}xHU8`e;6^|_NI_xs!KOKSrrm$DjI#7i35MaO!i
zlJ1QQzVKUX*gv6d&_5xh*X}&38$7_;a!ONu)(rdP;DwFVO4$2lO+1(c^G>n&bF-b8
z#x*-9-W}=@s)(igS*MS??VQ|L)P7R^{H^;EF2^IC+mBW_f56LXWAYqNcic#~dxhgP
z&|?k_I6)Qc{89JonvL>mKj&rMQ=9F2p{{rSQ0>)$C4CQv#*Puw)^1iuPL5!sk&(9J
zx+&`0yN)|g8x-z$oR%5q^5W!onSYW9BIa(p{#r}<t|Xza#h)CQ^)KCfDf&`BgRO(M
ziu(_hh{-c`s@@*kenw6|3>CwvlF_VbW!x!yb2jUo`0rGX^$(btH@Kg4xbwR@f8@eb
ziPR9G<^x|JO{W-+Rg7d}Oc>=Sat(P4*9NS+mUF4hag-%DbDQ|(BHW3Ng5*(wjnS#%
zn))1?`vkx3U}K56pp>$PeeDgUMpY|s*%=EC2fN1h64kXYhhLVcUa^Rq53JGu_&}68
zx;Wy!#kp37bp97q(nA%6xq`bnP31nMf0WXG+IWBc58-~6-ud%9Qy=uDP2FrJzl}Vs
z>VFs^pO2ZWv$DPbZ?N7eQt7avt?*{;@Mh8POOB`M@cw467$jSGPwiwmZ>VDsy^iDu
zqo9JUEpsg?shQiW=0qSy`PriW{?-8*SzUcOZApnsP%QSF{m*o@$&*FhGe2UU8yvjV
z@8kZbtTgMTqlJ+B(B#M9{TDX&?!2k;Xe(`nn4rsVWx--oh`Do1<x%3<^t!{Wa*JQ-
z{Z-z@K->+LM|)@=Nua28iF)@!dy;>8{(77J$Y8LpuY-E&(#bWCoWFgN_1RZw%nx-t
zhQvX0riX%DTDj(25+6_hpbbg8W>)p3?x*K?iE7)J$QFelxkV~UdYzNq_bc@$rN=((
zJeu6YFaFY&^^*0u^M5?My>hapFeeo;CqBo=3lxNXe(9B_HfbnQ=&L>Kbq&Vp<I$z`
z>N<;j_lvc2nREpz;xY*|9p^u{&M94X^o@4(4ab|H+AAvcFLKR&P4PGvq-off1mp5+
zJgXxdrx3eVuz*Qha;q>eeF4+kEc{y9iv0pNr=kX0z9c|*_J3}@y~Jv0bFnt|StPYY
zzFC#?fj?!+r`vkO+<VRpf7v2p>eh2C$fY^iW6J?Om{LjR9WNMM4!q0i@usbyK4`1J
zY<$#I2NQ}9`6+E+QRm2=SklmUnc7NXkIkA#Vc$MItnU9_Qv1cWCVGn?6x;;`Q)nyR
z3BW|K`=N<A4pYPOQXy6j&COmT9?0bSHmgUPw!&AyWpZ<`OFV$-3t&30DV(mX{SuJZ
zdkKy4pP!yRE^WV52fv35Xl6)2vF)8%#|{b>PT#BjVw1PV|Imp#h=cY-!+PvlAGNMe
zagJdZdmLaI<YL7+SDE-Yz%ljZADF=JwtvcE&8r;!CER~?3qMkaF8?ZD?9JRW7O=zp
zSBt|3IbA>n-*2DZItmuLYwm8@&lhw5fI6%G#m+4J2il4(!2*^2k`-nU6Ld$VqfOLs
z=z9K<#Y|55%GZEZanKtr+DA65k8Efk9Yy##@hp{g_gF?eAWU7zBh(qqKV{8k&5pk%
z0ISMEjw7Ia|CCiYwsnLG$t`YM-@6O?H=(TUGFmRs8|>#(tGiRf@aE2EAKsik(rS5C
z?9mmmN8wjazPb4-L9wSdMM{Fw*Z`Yz_l$Xws^pHkrP*%0xKmBH#k^tcfuWY&-}gA)
z-6Fqddsf(N$$hG~6&?4fnm#&O*#Dm9KATdm^}+tmfNuKsHm#mvSgqM*@Cb0r$MIuz
z2d>UB2o$Vg=ol9ih;~#9xWbXi@1UQMYG|BVpo3xU5RuxwF`O|?RI@qQ^Q}$my`9z1
zuLX#;M3+-jKK!B**?!NpCyPtI!uglcUbmh=&)Z@q;<t<sY2B9gn7Hm(%CU*5fL2i_
z?M~rq`L|M6U2Pxe$Ys1XSnrh#|K{T5&M+CL@U*Z+2btjx2Vk<xEZ)qDm7bt{TD$8`
zxyqeMMyCEBn}%*g;>4?Y&*kXI$1F{o+gd&is%_f%bzqE}?pBR5cZNvX;$icY;IcJ&
zXH>h@-yGa{E`#}JskgA#%ixm7v856!*-l^WIUNl+L-qu|(&6IYVf$U-%HeB{d*2<s
z$vW)Tr`UADn{%h^*P@bR>FbJ42JNh+ZPK4G%5FGmsvdGYd4tXd9k-!fk0vzOBvaaA
zG8i{dzdx>RwSDIaJe$Dty`MB*hx)#cO#NfgS9rBK>mFP7k#mEO#yMl{SWPectl!*y
zm_h38YxNIi)?=>@+!kwhH*>jgXN_*(*QP;<j>5AP^bg+LXtMA=B&!;G^M);Tr(zG7
z>m-tuwL`DsWUcQxP>yprNEn?|5M?doz)6M*M#ODa=u?*viLbOYcVMTgQa0ujbMrL+
zO#3?IDK*2+z<W;oA&Hg>B~Niq%3>{zT*F^ttY!AgE1Lh*JntPHySTrEeM5zij7h-G
z(_@%q@4`O`;^T(D_>bD0QtbL1n7a<2@#e{mnIn!W_9rg;noizP&sa>p_P{)+WBuaZ
zuNEH<aJN?DwhjCC{NxCDS+np-^svh#XSP6tH?>ykY+NlG22Yc(xkOpMQdbo7u}}IQ
zk+476M$*}J%a$(7k+i~!YolF(d0{2%D6zZt9$*PPk~Hjcui!{vrgulM`jnqsPr<z-
z&0pW}J*k>?TxV;#4wn;<93-L2cwS1kfU$A6aN14^<~4M^iL*L+hs*BhOAeP0s&^+Q
zUo$&+%faTp|CIB=g3(gp4y^dknM>lIG}DSjj=nu~;=a?AT@SYT9(~#wwufy(P6-BG
zC)0`rWly|xs@_>b-*bx1=bk|qgj0&nO&>m;VlP6=eD6+i`^O~N6Yt);J^m=<^u)j{
zc8gsmUskT;(60O&hpr81r+qlnEGm2Sj%y&NgKOWGbGEik3+JPO?VGyRn!gjf`J|jH
zu$!Ahw(BJA`69b`$2%8qD7?^X{<!&#-WT6z1>Ri_&kXz?(-k^be|K)7YWu)z@aM$Q
z%pr-GbgKQy9R-Wh;<V3-f`Ze<UIiRlV%Phc_VbgOZctR8IluP&G?$ZZmvGRj46ZMa
z-j=z`b_(4%@mS05XN8hSp-THDo?T)FvNpM&6mUxg&gwRSIVzDc3%kbKQ(fntG^S>m
zx%RzzaBQ%xvaF%2vnbOowj|*}HS^=~Jr<9T{W;pCP!8tMz!B{&wdFmNm+o&=TDU@Q
z^!DrbPY+MXd`oO?-mI)g>mm5O=euW9(WBW<iCVs{BHhaRRG}GrG2Q%EURz8a-|$1R
zcyj=j{q})GiXRr7W;-d%X7^qRUhtt@axSRfXxY?o*V@eBMwiAjv+CA>@<aJbQ%CB8
zZn6%xJjMzJvamke5Ur9t^=(p+$19z3&G+H;+r3@XPmAaG)(fh3GCvlT#<SYE=5jKA
z3hJ>q>9SVHmywYYcaA#6b>@`045!}0WCZr{lI)X=r6cc^Sp=WFPpQkal$bYmKlR6<
zus+C}Q|zs)S<K>1_AiTiw5)<<q5J50(vDq@m!h~X6V_XL+4Be=b-?hgxcHDpR-P@t
zU1z#jT@2P+*k!QQG#BxIaZ-8Z!EPZmv&)Oh*MlypiqbuSs?ta*>|pJY$>X~|7_PCp
zFaK$GSPmy+ec0W~SLQO$e;q%j>lV1MC&svS*ShH&v)4|Ue{ENPBJ^eCS<nvopeN~$
z-(BhT4v1f(xV!$8o@$8xdy_1+1!v_w=eoy!Gt3C`RH=W9|Ju2?340C`Y*aP$oBP?(
zqW$t0cyk$@6UPnfla`j+wWlnKq7SYSd(F0Z-EPD5Zikj*BOLyh*Z1;MpBH%k%U{ZA
z`;t$^uMHw5j?<k=SvphSKmJ~-e6hoM-v^F9zx$;xTAg;4`kmG8tV{f&H?`;bVo=t-
zU50yYf-(*3*pG+Zxc#*4Y4KHds{o^ihEvMfrEf;>EVaAg>gfD7|8SJ&9va#3gXjI*
z(|a}6N<E294NH((d-HbLz#)maxP)18i>?IC{TXlREy5SvZ_B;aWVg4>uKt1jX|?hF
zksCV}6KUM+9;@r{WLY{*Zy29*Y78k*yc#uSo3|tPQqjqlo*my0(sR%E8uz{_9SR<u
zxf{3JSa7Snt<UL12@#<^?BNxn!9PdZuWOtu`;^w#ouh2M%jJXTX_m_wO*ADwu~I>6
zhi~MY&G#RwIb)K{Qs_=YV<nuMQ_W~|y}$7wEoD=i$H<-p4Lvpb%1b6Mg;~xHyACLo
z9NzZ*9Bo9Orv3F-i^A(AKDnA0hkjDZ*7|*WdWY%pm$!PaiEH=qX+3dG4mp3y`r>+}
z9h6mfmZT_~nmMx0cbRIR%Vr<iCPDd8WNCo^+QL$ivn1WnQ<X;zg1e4%>=+3bH?qRr
zHh$yVuY@n*dVYA?L=l(QagV(eLzgvJ9&l6W@Xu1IYt#{0bq&n>)(ElQvA!{T{LEGn
zvCaXzzLV;gHptO1aa7%F37~oB6YZsNXQoiUmv-k`oV#mM?gu%&V2_f7#e+jTMxAj3
znghG)qN~{o-E-rQBqt?YU|)EaMK5<Mt>Wv0{;J#tr+vc*76uiC`guj_{)DgRP6%P!
z&Af}LtHU-sgvP6B=s8DSeMVoEP$6EB#jb3?+j~pEeBA!R@fd}D(%k##<mVLc1@l!O
zYxQ(^dFS$N$HTAA@JSh1)a++iBbR#Ezdli2CuhwLoms)e;dqtOF<R60>qbOUlV-SI
zF6?%@w%%d~^&=hC!nN{l4<cSD3D+w%hJ0b3O=RyF)uNXVTdF*-e6w^Hr>E*<;I<R*
zCpe}CZ_0V@pAh1n{O~PL=j|=Zweyp|wzaAX>0I8iIeGCZ_Qo?I%C8!`-OOkMF9pj6
z>8fs9`cSsDZt);iSaklX?Hivn#%fw6mVvlRw;xSD-p$Q1;d7CXj_q(7pw`%-C0Z0T
zAC13Nckoz}V3lIZ6wRLbQ%!SQ&ZGs4-zk!^;}*1;{r>=!Kx)5}EoU>~SF8#=u83C=
z%^<<YJ`dN58l^qK2Sk<j)a(W!soI`$7wp%>pGcw&<iB(L@ef1WT4{#`{l(fFEd7O3
zo<D()PTqt#Bjib_aXpP>T5$bmk+gsJJ3qORalKfI@m~EIZ$meH#^+J*l%hNR$brK<
zph`<Ix$=Np>V5ccue8L)EXipOx^cKIG8ry+XxHsfJ$hx|i)x|w?TBV8V=<>~9+5I<
z9AhtJ>Iyx<BHaIyVlDfBBJWhGOF1Lc5-+{6e#)`8`W8p-g&S>5o~;_dsgyiSP9-bl
z%3Hvxlw$PJGB8bcQ5VZD>hR8y9r_!-_z6I5q7>tu)fq1psPZoB%sq~EQndSG3CIoD
z-j`skyN^mpd*>!bzJ=XQ1Fv+o8T~7U1C_C}cDtn@w~G}ST4Udx7Jm@Fx;%NO)$qbM
znpfC`vn*V{(<U1-FSzsd!JXDYBFOOKPKz;_AX_r{Uh{8)u|vJd2fp^4ezP1YWd%M8
z)=7>eXArBMi3K0@9D1`gWALHr**4*z<g0H!jS_k4<|xw{3MPp0ZWMMWqp?$y`);vM
z-j~9oZ|9Wn?poc>?6}PV2GhkkNQF-X72-sYy=gxn?QJ3ofA~{AxsA1fccmEbr=QZ@
zC*JSy<=ge{V{-JVPr2n!`ixtC|7T{jyRi(km4Pl2(59~hjN-p%+{&;9N)cM8aU2@M
zqzsiaz&%qYxl{s#PT)$Kjkk({gQD?!Z>_VyV9U`<B01_*rIB-6)H*gTqk6;o+g+{r
zy1|AE+V#qIIHqS*Z;A{xNuK*K8~)uU#Emkmyq3H8wHWUWx5*>hl@S`b?KU$@w)d4O
zJwptRaBz&JI{oQSef@S;on}cf?j>^NImf6x7kx^VCsh5Z#P){{wPkSD?OcwVxEzYP
zfK5W{ZnqXYIHp@}w>CidQ0Bd6xH3H>vi^Dpv(W`BEMv~6{i)yI!7_ZlJea&(2CkEV
zTV&vV8Q3cU_D<yF$lV=^N4fG2V}jZYhtJSob4P@~s*E}xyhFCZuHot!^WBKF5o64f
ze8Ex+&MJxQY7hJ4d)~=Zvs8+4uaSX`65ze6gzgCP?kM5w8@puOhh<=&obZ(rJ_T{8
zgdBo4hoxv^U+uTMSh}xDY?Q2w*x@sW&+f8Ld|#huaVP1j8}&wNOO4IEQ<G9eZe5F<
z5>YF*I{h@|&dBK}5nbBNp`CN5Bw*C(B4rv<sa?mrMeuvg!Y{^ovc$V$pC45cmPJpf
zaJ;m2Oql>nz5T8_tvzslB1X=&0}9F1yQ3D@3Kre`?mFfKfyRjFG$49u^k~@Pblu%j
zjfk&)18Y`7^+)TkiLY1oV$i=O2buRo6%qWBR`*z(+!t7?Gwz8&Ig2f%|Eo;>Uja+x
zD%$_3rWM?4?XgC%{GEBPy%Hj(LHj%;^3T%`^~X)QkJ;T}mKcq@Kt$P55~W1|&YLmd
z9E$-bbYI;#-R*HKi;fZTu_zcS*_HRzJ%ujz<-^|Fw<!U?Z!)6gnBD_(#eN}78plU^
ziH+~C!?&-95VYiei=gJd%|kwA-)05x$Q(5=2v1tZ;!7?2HV^r%*R3D&jh2_W=<7I@
z+J`>B?Y@8G%KuAu^JTJ6e9Epp4ExllES=SH^y09uXvXgU#nB6x7mU)iJ<>9AK~dzW
z3;+Gb$k9(~jzp2bl;~T#v0rwrGnTG}5HLr|XYf>~$^C%rQmy3kFG85D9U^45%*z5r
ztuZ`a@ZpCmVQtW}j6ucby|6F%N+HSs1_FS)S6=kd9#JGvO$1&i0@X5sY9ioYtZktb
znEHBp_s`SrmqK@QnphDxsuj_^9&Yr5SP?h+dRVsAZuIq)D+mu8DTg&OURH0ETOa@A
z0B&!PF1kBc6~dU&anyW3LY(XCYH1DU`mCQXI`?#hpj*X9#wDHNQmj>_a0@BGC^IS6
z`mAT6*7~~Gas=&}9C0X5`Ne}}<-Vm4VHuYD@Uv2Q7+``AKf@xKL}WI~XMpDQ>U&9`
zQNA{|_y4`nT4s(JM6{uTlzEk4_QObOsIRRhZ$o{hwzsl>(mFz$#!c`8Y(zbm=nwF<
zw$LBo>uO8?n1w!=SCNZ8Hn})ST>AK|hkp9_tcQO3_{!yd+_iJ2Yv-}tI{5}Yg5}nU
z7<pE)x6!c4nOb2d-wbiVdWqEHy7&U{jd9jGyUA^@P_1yL((Zf&vs36BWXVpUZ$gaU
zLux4W^sFF!_)#R>&}Y5Ry`fLJ&mF5|u8$uB+5-on8vF2&P+WDHu)f3j?_G~_>)S%@
zc!Vj119Af&wGP_L+i2R{M@<u}&U3&9^bL;+%N*PKlClDA8Nt0r<RDA@LS(gfMz#2a
z>c$Gyo&OlB&Zkzfq)HYtM9y+L5l}v8ASCdz?2da(?NQXp+ZB&R8)2e@i1p^>Or_r3
zE1ZW_PoRu1XR4n_T*X2r%3JZ%iOPKI1^$`VqYGbVS`SYhR>PRb@rzALm(TyB-3M4!
z@ZTwqbHo#w%6H;0><^o;lbQA({e!9T`}ag0n?Uqy(W6(hLOHTWoxL_=;RAr4$E6y|
z_vV=x@3m#k@^PcLr<r#^DKb%D1Kxngt@98Y#mbSqtA#b?m5+<Lefu%fHB9I`9+!n)
zXK6kUGn{9HU}pI1Ec|^lTrha8W5hbI>xtSKJjo<&ZNV8SyUt+B20Rg=+}Q6wFh6Xu
zF_S)QvEvD}z#B91n4hPTy>-Kyho^)pGE?OKc$Yz{X4hV98Wow=3wbLtds}*lip&{7
zw;7gSsjbN5N3(a)(d?C(cr;ra3tgRQe=O9n>WlaC&R|`p9}KemZdplGW}z$_^RC}3
z*$6yYX*0s;kg0s0+88}LYJS_x^VlJ?T|jD{zKY7_T5+cGT@>;=zt0HAHDRNwCsFg?
zXY}Hl|2|_ZsD%2y?=uzv5?v0H;e&Vo4DDzJU8#@V=j$00iNxy}-8hNYGlpZ~p~yQk
zl<yHN5_avt(^z;rGulPiwVfFQWxK|#@y?91EY^5uMy348nf&S6Eg8v65~1)mpM{0D
zH^X{7>!}Qv#Q+`1u>Y<Bd@w!#DQow3f(<%`J|)$DJNpAj6|o@QW{(tQEgVw36bsp(
z>q3IB&!;>sA<5S724?*RJ{@6PE$tZWLOBks$1B$LJeGR;)56w?a5rPQ=4q=!!C+qX
zv@uLq^YPfz_W7{s;4e3Z7}~d@lJ(k;mF)72qKFRu@{BVrU0bzU5peJ6`_J;otr^y?
z>smET*#}R#*qY&OvkwN+@~-#)cl+UwK4UF2ngfrvAKtxB=-sj(er1Ht?Kb*fn~{<F
z?EhT`-`;n+8T{dNGN?ER#m`Due3jA8O*rdW$&pYlZgG^U6faUJu8&IbftV;l?p}OW
z%s}>#!_}gqx9W_H-Ov5s71jFZPPeGGK4&c|<Cxh>ZlcT-Cz+x?crI4e$L)`;Fx%{}
zg`&m9gOw|^E9VQ_<2O>&z&5esWh|-#zl$IH%heg@?#KRebq0NX8q=RN4l`-{<Bjx7
zUqst=(%aH<_d##fQsw@z)&$J(<^0#35%<sYtVI7KVR>QI4KHJHufySA?lsb`9P_W3
z|Mm(v4>B4}Ze>{deG+PceY*DiH!~qczg5Ce(hAMPZm>I^w@k{}%`_V;?(*CnTyCU{
z4r|}kY+jyYO7K7d^H&a7`zDw|?r=boO!k9eQEzy(Na%XzniPddP<I6InY=V}V}TY+
z%#ltpp;=;tWJ3V>msK(asT%`Y+92i2NFFwpAN8*Y*FeSnud*7W5)?icbchBh1b%K8
zfo2YXSWJr-qIgC(vB=&ps5VJ4ViQGVlp>D~M9*!E1Xjy=nl1xy!Ztb}G63Jq%Rg9$
z#|4B%iY~DK>!7uoDBNQdzqL#lMv;#mj4~x;rfJenS{VXr9~~6aeJZh}7i*tiGCgBP
zvhj=7QnY-^P9Z-%8u<uU6+3~Syc=J{q0&#@4(3qlJFjxvOiM$)n%}4=_|9v+AnH4>
z@{L?!>-HBIY8cI=(U~@y9?Yd3#nj^*7Clau;4}Co<a5|-oi{%0Ew$zITX(^S6aG*T
z?k@<tU&ikZe`rJaLzOTO8)})w`q*nfN`vXd*Iy#T9%*I;(pYBse}74M7h;0-h8~d<
ztZxeGM+oV!e;L*Crq?>n@TOOpW{A#x`OBh>2<~NtRu75KPeYf6ybcO^jI}vO&7qgk
zu{h{0CdVS35KHCCL#g+R)bS#9`YV`vKa~Z)t#7}#BTmHd+xnjNrrKr8QPYzWKkaSL
zeHvu*pkOmuU_SK<D(yjUzC~#ddP|}zP4Opd)0C;Adj)s%O2T6#=e^!`QYP>9_PQ#~
z%;XNWxlIy@;TljT`VO!1RV17sy2+dPkCP^d5Z>v<IR<C-JyoK(kFzE=?^Qk{y}Js1
zjeBgTbFNb*FxLuxAPKJXTG#2W^Y)j&!6a1l!>hvXMecV@xW##!x0SIrsPcSU@Ps=|
zVQtWRrgd%5JJ!-hH+tvDa`<Lwo4nD#s=WF&Svt!e+uL5N#WqJGzY+~O#<c`-yVrVE
z6$L^SaLp@I#d=l!v79tOx+_(>MS||_M0cgPd%fr`@kaR$>OVwxNj>S#jYfCu8%TGq
zx3pe#r>b;^3A%@f?o_YxC26IQA9$nALVk?~VT$>Lt<@vqTvNFO<D=!Q{hKJkcru}<
zowN2T-BDt`Dd}yb+uo+9ZtqpDa^zwC<S^f?)w8soUh6E><hOV)*vXp|^&7!oyjjPT
z-vF5Qc*~eD0Q2NN<xsuXkch6u?-6QhTvSUlQ@(?k&XQFUZP{Ulk$KHq^0<$0=8hPd
zgJ=)ih^Bb5$|0(6S!@34EscBVbxX_(c4T^%QYCppN6q&i@FE+T-byaAB)E)gWV+Rd
z8JRvr`KInNZFG9TGLRpiZk>-_XcM+V4a2@?Yr6MX1L%9+SZ}$nQh$ddRi(SA!`e_K
zlyJN~@0>Q^a%qK2({iUxjGQilzcBxuo}N6CQPe9WEJ3bA7p`U~xvo+fz*+GH?~vhl
z@5?Yt>fAyJ>wSh*^Nupy!tZ3V1OlfI8-?$EC&C9%qd$lq4c@~)k<sJ}D<pE>t(8M*
z^l0EPH8Pqwh)lPWGYu1DS6LIN^X2gU@Vf{}IdcrH;W?Y|Ami}CyJFy?*i*-Q(JH>;
zriR`VjZB1p$f`>T53k5Yv%#vkh~CYLe>6oqIz$YJpJz!IQ5;lLmDfhQh)JE9SN@*G
zP~67|JuHHSPL-nwKgff4Nbr@F4hZXbp9e<>3voHM#C3@h2O<xD-<H+FTF7mxCGOT*
z;`T*}gB-ta6$5U{I)TCJO<4*;=ujO9U28+w$?9YIA>v$!^+W!AG{mlq8VfnP>X4G7
z7<T9?MGYk0J!G#GaOF=PGL1`=9Kc{B``=NU_f}{D|Bf;v1g2q}C9M#3gWM~1AFpW_
z%Y^K>y)%v#W?e`-7}DEyA>sa4Med0EITaJp?1Pw0L@A*ur&vG-6F-QmKcHSk(GlnP
zRGd3)aUw4mQih4^<oif!@d(@T4t|K*!JGR5;d1kI!f0W;`wv_@hr0U@CR1=Ry=yw&
zV+yCzJj)nVW^Ur_nm!Et0Dq-cnvR<da524mI&L(e?}8_Z1^XSskv#PYI+980ogx-4
zlhOxS*20t0r^3>_@rNEma=Lnj=_)NHJzHK^$9vn;K9x5oM!CGwxXH0`x-;!#<^{Yc
zVf}AzbvzxC(QkKr?;~r?gxeke_(=9JVF@bw?T%4YV5qW5x-;XG|D6iD{;yT=?~kqB
zKd9j3$5s_|u&Q9CLJ+R!>i$V&LVnQ|?w}N?u+@6ZC*;DclxAdMxAnSD<c7m1xZ<k^
z%V%8RRty1@$XA=d7cveL<tV!&tY65;PCvabWI!vxFJxqDU7_J&n?9O`yN=)hrKgfX
zMbPX#uuJ)98h$IG8GQyP%`JBR@OMt&eIfuy9+^>iKMl7#Bi_H$(%@=-eE%p7J$wHu
z?c+3TpBVa88ns^9CiQX}ZIe1cq+U)lHmbgyh8tCh-&EoUcSA6wscE>p=%1lYPs4c`
zq&q`!n?>B1U7DR{+NC*ZXqWJPUYfbtb)ocrp+xVZG~6>7fFr;duq-X>F^^DAbsAo7
zjPF-T@7vPcG<k$`+|AQYlFZFXM@+hwY33(6@<?V(n9uqBXz(jaOA_km@68NAeB6b-
zQv;@`?rEu8&0;$4LAAjpIZTA(o^D*X$35fBO~A)J_<0zntv@`bw*K^(+B)emHFU}&
zZScQ^=zm4@Z}AkEeZwuD&YwDYn%gK1<8ZsgVV6YpPI_;~)U)5y0A!==yz2?Tj?8BM
zd6nABo`6XEipPU}jK;gZH6CTsVxH)0j(&-K%^FW$L|?PU)7`R3X06A%b99|2DPk`0
z5|1($7z`XX0ZP5ulXxEEtGAS5^g;=6cawp>63}S`2PQBA?vYZ=idVauvgH{3W_mn5
z7-o}?S!9!M*rPy3Gyjai^A=|cqUj$?Xu?(wqA3JA+9E<{95zC6WL>UHhUVY$TIF+*
zfR+pTxBeOG+u})l0~D1aD=JO`1hsVKj=n?k(l^Y(8bV{OTuQYP%7xX+rJkXD@7_|+
z3@ma)nm|ZX2x)?+FGrf-nE*)sMcO2fA7Zh-O)=`{Y;Br{@97P9X~LbH7RLI8wv+!l
zY6gCV6|aS-pJleJg=eC?D>!L+B@0?@d;Te#|Ne5ASI0t+vR_?j1WpS{E0?SsU0)f!
zn>1v2f^q*!Doth0rk0sOv}LDKH++TKI+bc@>r|?tEr+D7IBMn8G#^Y=nr2tgG@%QI
zRg~1;5t}3*Og$@NljMV`mC9Z1i?oMRk)82}O*Hu%uB69PbFS}fMq=30sSPZbyFZhv
z+*yxAZv5KVTArG0I~@tr8w<XUIv%){^|hCLP2K|Tf^t^(*R8v2*2`(&)c0dwi&`uS
z^;1S`r2%~MwKTh_%%xn+(EcN0O<vCzim+N5ELGvD#sZDDMQqY}^axF5r<Oz%(A3n?
z5d}0gb)Lm@pPIT}_T14Y|JM=4Cx7{fX7hJ8&)K%rHYdMl2H`^qOaDp+ewKjXpAtY6
zMy9$y{Fb4)<!jJ<GSE=I`7BQcie#XN-EC)JcNTpsN=+H<UGr_7<4tfMANy8qi?s9?
z%T#^tAlqBuTJhImsqT+Jbra>x&XR#8a{kVif%D}H;I5PaV*xbCD7!bySl3Iy5dIqv
zSljIs*N%;-@A!^SkoDJ9&At0w)Oq*u&g!y=OM-tg$dpNK>_B&uwi&voh>w{gim?6n
z)*`%u;hy=urrBJ+viSQtOBT?!#D?}{R5T$s)DvqRsWV>Lf7bE`xt>MtKeJzQxTH85
z&{CcVhtW~R51P@LDAjxG57z44(Hua9f77%_e~27Fsly}Zk<%L<U6LB>@JPv<BKFWD
z7O|B{V~}h6Y05P>X1QqC28I%cZGNpQ*kSZpN>b5h0Yk@n;gZyj+?_8;9S-)G^~WWt
zvrHE!Oz2=K7<!m@+N;>xG>#rlU5VZI3@ta+9QZU%MVA-f+t51^{5=H;-bDm|PwCDH
z{+=?P6Z}18F(;@?1QSz(a5$xzf4=rtisx87yu#s)zf;`2i$(J9rDTJ%4+nV|`S(%=
zbMo({%;n_YOIas|0EbfWu$F(J_Cbm{<oqIq95wo^aSA^ejz?{-B=W{z9xn_>&5>WR
zpSv=pUqnB5Wy<u3e(uVYRo1QbDaxs_AdoZusLpIjiR<<=v$@Bm7~OGH0+J=b>px1z
zcD#*`(sqnCZDm~k`v+4~s2z(4bv-IoAvlp!%Tb&bKWpU0@2WCB(IzYjoO$HyE?RKv
zZzfABqi0i+Z~O%=)RAKJH8OC41h}t|f$L@9b_o!|J;VZE_}LJ^oRE?CJt_OJ^V_fz
z`Nb{)9FnH<8{mLhE~9V!i*+3cEMJ#jtW#{aG21ZW7sH!VZTIS5>a^W(e8^rt#s7mt
zrB6j<#mqIFeiNv0<n4=JG+Wi!1JUn^0b1>T6|@u^IO11X95UU~`9Lt;OMZ=zSkcbb
zU+e4u;j;OCzedxLJk1AZSwD$nXS4V4>=d}tgc*;sQ+jdZadygNZamITSuTvnIVtAs
z#@ZAdt&qv6N|_+$T=+Zpkf)~@{I>C5N6q1*XgQ{*C`WMcBUbZLaAqg2x_|yEZGH+r
ziEMu0)pF4H>7&LJBcAh>?!p2t?;WMwuZYYy%GOuNX82o<8YrUTWh|;AZ4)bA#on=>
zV0|oVt7Qr_a;B}8DP6d>TBeK<^K>009TjsO`KK>gt#wK9)A2O4+J7gbS$&8|{hi#C
zllnV(B3Jz1$xDUePbK^27`8e+#hm;KawCdE#sSHh^7*$5l8ijX|A!9eCl8CT)B}<i
zL|Ezp$r~(|dJr);{(Ot(E!HL{hj%xZ!=|m)rl?_<c3QIaqj?LGt*7u7C0jp|_Q>x%
z^6X@HtH=av)G#eKUb+O|^z1kA-|@-LKF64?O_Q+nkbH@LQyD0bfEXuj%styszm%oY
zS;uNwDxEZpHPmCOqbV)w4cD}tQDec*K7PzPVet=hHQyKEkyaQ|{cNTZX7^a3IU|HM
zy)YR*K)|YJVe%P#=AtlpoT!w=RJQ&_TBl^1R=}FAC!@Qwf|BaV*vS2hH5U~zPT(db
z8<WoNWLknkU*k2m;%l@KlOCf_&^J!q%J#dYg)C%f!=M?08(iLSCr-svpKqMyTcy3}
zR@S(D!2WHwbwACA?u>?BGb||ILQ7WoZMSFG@zc3^mNpTaJDy53ZO(DcV)vnUtvYTU
zPR;A((C$8NEW?Nn1@Z-}Ey|V)I0N&V6<6+j@bahQb#^a6DR{z4saU1d??luAXE{h1
zVQ;Z!Jm3z3ig%sBn(=_Ul-s-q+~wxH`UCDc;&P3Ls3h_IVR~m3=}|Y?3am2c5l!PS
zn+xfv8UGhnne!s5%qkW#!E#B$dG49=O(AGm(*EN0=|Z=Q>eIfn5Z>rchI;R;-b1H~
zH@U6zVb}g)+|A=ogWfPjdN=-X$Ztfz%7pP}gekkXrH+ktdr$tMNi~911@hk1GWzb1
zsAZ(OF5j^t^8IPMbs+L61fcee9d&-}s9R!3-4{FR54EDkGH0ZCZ*BiFyxquF{COAF
zQ%1(BjQ}g`T(!bpZwOSg<0NgZb@#SReb05DWvQ}r-4&J{hI8E;<ZA3&sLgk$$@bAV
zO<U+rJr-|<m^}?+pK?;3R!}ma9A5xWx#VQj$=vr@^rVxr386bB<W2}?n<@p)X?#-v
zmDtIhDQ9AeX!X}R9iYTc?p_upc5)9_wqH)uN>o)~!=3OqZ@69EiO^V^OYfdQi4-f=
z61(#DU-w1vVu8Zw<X$)FwH0Q9zZ-vndnF`^Y1{fT?emYIF<4?cSYg^kLXwycK3%59
zip@4g&o^J|=JwduzWvD#?fieNKFPJ+MHR7TB=r=RtEbx|GQ!_QMt=CmL=qWc@AcK*
zc_!0BiD{w2bgG0TF)ch@rc?QEbLP_KS88Q$KV43;ht8Vxa;LypBd)p(>+Z=@sN=rw
zG+Q0dXS)36RP8!era&TZl9rFjTJ&-~6A`mHKq`y@5rwf@LK1ozQ2)Y6a|n7JB&Hn{
zraziYJ4j4BoG#Oa{5L1g0pDL9=*FcnPzO``AhlxSV0N%Oi3YRgO<Kmv<a37LBiu<s
zaQ-d?zg<ESg0pu!!R_zZv<#PjayTMNQbZT9LUzTW65^|ORp~J{!mHxAkmXXjmq(QQ
zQVB`qq`dy+p6C?xiX^5*3e&GlrbQCdq8OP9#oW)b-_VIz@}wB_V4Wyf+2Axb=+K5y
zxb?{CT8fC;y~WGaZCvO8c@J6f4sf9ZZezYC;GS%{&;j>C=;;jL>^x(-AVfYi&Dk`e
zPECFn5kg%}gl|i0*-68Q^Qk0b7X4JxaFg??qzS;xKYhh)&Edw&cc{bOo}_fxL&Rz+
z7=G4aZ%^tbci5~!-H@bo&S>v$N%E~vMo)YV!uKTci|cl;!3K9vQX0R=ZVlFm2a}Xp
z1x)iqQsU!yMq=MOy6Z>fLnlj<lo<~UJDOzgH-%V1l_pqfN6#smHZj4d9XNNqZ;cuK
zb*ZLZo*>;@Q0F~Akm8xsN&zPx-xng7;V&{uC+#VzNG<ee>>S;r*cgy<kVvN5o&^{V
zCm`35@sad#4@<Y%o}G#0WU9WCkf8WfuJ1+_){6UQU7R5IjS}lX0!n@ALIO&Q?U5q%
zc)fh={sIPEpBS-s*^HjaqW4Ht)lZ)Q&yQmfEY1}JQp;G72FHT5EEc4#u^{b@1?jU`
zkP?z&Kx!2W(y+Ra&T8(^<|Ns-$ID{j@IWj`@5O@jS6xW3vXki+w-zdiOWZMVm>dhz
zd9fhf5ew2Qu^{~#3sP2c3`pH#L7G|@(olx9I@wwwpz&XuTx;WhBw23!D{W^QQq(^8
zY;kfCJQUXFrX+QW=yN?beXcK}&kdUWC&KwgAG~Qb_QCl^AG~=r_L~Js*4h5fHhu13
zH7tL*wjn9_UI-}Nv>G{WNXjO7!`U2eOz>v}pPS^SdAV)G`C_#fS9<K9Qfzzd)YPaw
zHgrBMQloS}<*BFJm9Mi;q1K?A>p}ubuSVq^w=!2n{Ua)>HA}5Mr|WC<_SoCDx%QM)
zq|56<0+}9+1?l}**g4Yb<=V6m$yC>-UmAC9HmycwZeFdrHVf?8)zbN2n^t@KPm|k!
zq=o(<3OfbqR4ho%(qljx5DU`cSdgxc1!+$#NFT?76z7e_|A_@@a4bm6>Oz7J;bO0S
zhp@|AYlZlix3&uLLoDK@XT*S191GHfSdgk>LAo^-q!(jB`Y9Hq%*+^&N@78p91GHU
zu^`<M3(_mGApIH(QkE|k|0fotsj(nk7z@%}u^_!33)1hgAcg!fAoYj^X+|tan_@w_
zHx{I~VnI3{3sQru7?66!f;2l8q)TH#+8qnhyLBP`Gs&T)2NXB&ChD{|oDIwB%$vj|
z>}{({mri6Jf#e}}X7mdJ+y#V0>fT*&tIrgaRqH)FP^<O6AP~)Z!=SOohA8Cq*+2{m
z`8pP)<X{X)?dw8<L1X`*kkw{L^1DkJlHAIF9W^6EI3)Sq)kPVSOw<13QilaIv=c7e
zA}ba_{&4XvW3&k3V3gQU=5Lq%LK84LA~Ir~<5updftlZ6$QUU^pH=UJIO3-EJ&{*?
zVcwrn^PcH6@_tt%%=<Gg>(@G-aVcNx$gj|zbs594wZ0kJb1vmj9S(c;yVR{&^R-u8
zHdCA~byL^;<=Q7UXkVyk!N$!acg5^?HA~EPXnLU(qj!^lP=5x5Mzcq*oZ9>|zAn<)
zm3t)YP!lU;y+Dbncdd6czU*6TUnH>o>5Z_MyokK*6(|_Dep!yg85c22<RGefwnL2;
zv707o+Q5id8c?lOhn&;1tz!qA2F|u^R*?(l&;lQ{M^%yDj|J&uEJ%$T#DLT<7NiBS
zAZ?BX>5;mSN*X(~uVp0Kd>|`!q+($qK_KTe6ZAjb1ZSU4g0GoHsL7G*6u+KY>Wij2
zwC8h-I$rt&OTkb}pNHSbE!rOmJhfB$E2q{@Db!Hzl-5VcSK81jU!f}B%!aYax3;0Z
zeA^q=D&ON#<%5rhyeG-0Xb$H;8`e>afI_g5OrcPv(7jO|6hHxIfu5pf9kRH-QLS05
zX(VTHt?iQF1JtiTnZT|(7cI=qU~m1QZ{WM?T$90$`{!#9aVw8~(lxHIY~J_tUq=m8
zS=J|A<5EwV&R`+q<Q^xTs4SJgqT;L6wz`zh1o>8JH@K8-nAo}8?y{ett77*1+T5s$
znFF5z%C)*gaIMg*6wa>|3dWfV>mnb&f^FCT<QlckVf*!MIIoq}*y_#ryV`u&2l^7+
zQ@+GyM13fBuQqDNlsTV870CT7Q|1y^Z;LXQxJFv`buDo%Q@Zqp+H#kAzJ8Hb5fL&=
zt5ieiT)s=$`6?FHjceW7HsNdL8(g?|L1grvu4ex@&3T)rm4hzdM-KZ~DkOh_%l<M#
zNWG?s*_@`O-ImtM+z#EdfkVCL>6NY#o#fp-@jA7zEajkVQ7|@J#5Lua+Eja{(u_<A
z)?YG&#!boNzr``q5wZUoqPsLTd_OgOgiSbPYh}}jiXDlxl_6cx)M^nS@x76W)no^3
zl7aSqX=>4)L_+yYM6DZ|QN3t5&T=UqVA4fhKiLco$5}3A171=E3z=j&9WdRctPSA$
z!AzI@F}hhU<70F|psfDQbEWKOfqIJMBR0uu?x=MGOf$(<w|*B6E$TqZ9C)jqRSfEc
zCo(G7+X&18A~A0j02rS!v)kD<*u2D}vuh$=@C4cELfP@p(7JM89rc%{8s5P|f8Vu0
z{iV5-Q+22<uc|F(W;0yYud(@D*1Zc^F6$ahz()6t72P)xx~H9yOfp}E*1(l5m!nWF
zoMY(Q!aA_(*Uj8KB#_}$#5ss8or=&Rz6UIT$ui)Vf%e^ME9(zi@LBmN9|6R2{3a34
z9L#Nr<@inF0KTu~o5We-OwW&r=05bF6Y<CmZIwBim<ii)2soLTCN|XYcM%~r)UbC$
z?R2~{Q91JPtQZx}Z;ch<%EWGw$14-ZMINtATxhvQ;L5~RmV-CdiPpn7S0!36Z@D@#
zDK9eY8Z|A}h~BNZ*?&7Rt<0`hImmy9=5xfC6WzA`18j||&cn)6+t~#8-tw+IV>~W`
zhxKr1ujI)lZoL*ckMd-(rX9|swjXI#lkzPlSxtNt&Ohc`hi`YW@GkidZdL8Q0ws^<
z<VVRPi~uSka(Y$1ZB8G}x8_v&c2*}%dkt}{7iIqyoxc@1uT|~H_GcyIl`B=?!q<td
zxHhC6<Zu}LJ`7itkX3Pt{W&YN3ix(&`?jpavNDIZa5&1N#F!+PFvc&pk_IJ?j!{l<
z0`tGE%&p({_O-Sxfs)pB*R|oTMO_os0wk2BBMUG`wEzP|S5Vy+Ex??_vIq+>Cvj4Q
z1(=h#Ott_xFE%fcFNg1@V=MC$`Iij$5WFBU(KyzEZF5PYav&SSmL@8PqI`?B4T(y(
zA@U6OC5&q$4+$gP41v0j*^2Y6s33^tT+>sm-0p0{r(7Z4)-C|n>vdwmaS&%)dn}r_
zL;g%(W*X=gTDG;wYB_2%rft-=QVz^i?DOlww&|zxsG1CIhy7GuVt?LG<t5HE_h05E
zR*1t>t*HF*y|vVVwUNTx(z}1LR*-01HddTyUN%-rJ%N9b)+5opsHkTmem&AZd!{xl
zQMx#wccM#lfc%};@x!`u=p|0{avv9B9Y3shkEr8^_3@S?FNgKHmTwn-ttSGF`0CxK
z)?>goI!Y8@U2|$ZtFPbbN_`EUk`C|DTYO^N_yXoddZe4I^?(F;n@j`-H=SDVZH;fc
zPOWzrO9+YwV)?dIl`%b`<;u*>KjY4&%)|y?{ND(oG>Indjq%Nh$R>eGgsusa@_PZ4
z+ty?JjF08pCrgPZmYN!KiHNzeN{zWy#5@xb^JIH#*No@i+Sk&7MYiDd!aCiLZj4t!
zVbl>AP#Ie{6+pX)&>STZVvUcM;4w-N?F+i)j_xKteCz%7!YIoyMXW=@D+KVG6z52I
z(%$a3_532VEpO|E+_t=}58;Q=-`1y_-++BvUyVHlCOfDPpkxPi;||J$I$d;y@w@d3
zir=jl^Z4ER2u^mlKHI!_Ws8o(u7iZWMeikU$GlcIjMFyVG)~v)=1qv(rS}?Lx@&O`
z5$)UoiO$h+%Nrv!Pa-s5O1waNU#y!qx-65zm+O+zTcvyH^Sa3HSOT)EB6i0TjH@G$
zB}i9C9!oH;jy#@VN^v5A`d_qzZzLF{Hl3HNqvqUVw3TlpM1CIkjfBY0<Gzugd>&Vv
zO@ONOM~6DAD0~y4MaNoPRo8kIc}O&56>W}$rp8=TE4L~Yd2ejozK9Jit++PUm#WB}
zq9LnjlcS==^4$q+H%}#eRE(AAsRZLg%ugkZ6}9D=1oIY%ebW1L();rX)NGc|&<@Zm
zk-k0wJ_X81U!TyGlfFJ-m>^w4B>a_&mTEf^Xf^>W_k{@_h?q}_FH9)ri7!kTh&SQR
zS`F{x&9f&LCQL^GX3kr#T_g#1HNBHG>k_UZg6l+USx2pfkzSWTLtDgLmGCrSt`eB5
z1m-Fkb8Z4$am+C1CUoMMa}!3IEpTqabh!J-0M2cdhEC4n1iHt7?%17}KzHm8CsGp=
z+Hz7869$;1CMJ}d8J?K10!SIa763@1rU};&nWjVr_0T*4za53|EfP!vlb3*}cKxfg
z!3o*sb-tNoTplMvnF;N=JediD5or~&{WV^9d`Bq1#v8f+HD1d7ukkCc@*0AD9^beG
zkw1?w<H(=KPZCofU&foob~wHPUJyz3GkzAOdn(@OE}n`X!Y>ehCf>Ab`{HrjLDur6
z_;i{nKpJ!6e<d1o;(G|CEQ&WTJzgAdUi!N<-ncVjnS`-9-t=axrS}@?eTS5X8z~QP
zCFyPP{7O=krAz#fE+|Wvc&c2p+1qeHz;tEto@vI#Tz%usq8c6_njPftBPF>e(>vYF
zQV^dcPoA{qzmA%<jAijE7JmlbFf)eA*&UDNd_T$Kjz2@_CKT@xHzqfYr|EsFtRFb3
zvNq_7i9T?)6NwHxO>w_*;-z1x&~KfFLcepGg8w36|4#4zdD=0j)Ti!uqI}DU)qY~d
z%74ET`yr;e{m!$5=3aD~7vj9+lr9Z=)tN<?k)r;0IA0}tJDi<4y&cX`Laf`IW*Oe@
zOxoK7uQ%52aV8r#%--kp3!aZSjjK$_vmk+w5`!(yVqU;ooCC22V0U_ju)xMh#Zd#F
zb4^;rq6*|LS6uxH(GK$i0EK)FXsw{MTny&F?T(%ITBr3hP-~saXP|<BYW&gLMb0=6
z3)Fv;V%&erKw=LQXp<=c#upbCl{z%HPl|9ik^pmhBi^AUms;IvxO}oH53iEKJuJMe
z)L~A9$m^uw_LuWS>!q%b-!zFgrU_&?2zX%>&Nq}=SNp(~dA_vH-WUY@ywsSB0RcOx
z0{&5I-6&!R2y@oKwiZ2I?2KCs#Ze-w^9(z6!X(o8?#3jN`MISI;uN-ud!fKpf@`e7
z`2C~qQO6?q{Ub}Xa@83%yD3h{A8Qp;sM-1FYqOoWLX39}&Y@=4%)fBHw%CbVs<44A
zaq@*eBr?J|jEIbIb`oZ1l#^zW$pSi+>x_RA?V_>_+eLx1IKrtdaE`D{02DYUSthUx
zoz_*(BB%9!pHdsV9!_;~pt3Bo<#lleKJ3Yg`T{9Nzd{1s+hyPm8F)wna%IxypYcuX
zWM|qlj7<|@6P<hr$cKPz<i}QJ@3FSHI63amo>A+EGGK?6R$NxwjMZ@Iuy`#Oc$DMh
z*)(r;`Ry)a^>@Ps?RsT%GtIOBMFjJMtS%)xdzedV$<F>@^08v2I?Z93$7y!+X--<o
zzzX+QoL8Q4Dl>$rfm@YWh5IWm@_OdK;znC4++T5%<%-0^=2#Zf{*F`TNrf_inK@G|
zeJcZ-KKcQB<CLkfZ(N3;XAD6>_r~>)5Oi<cOpBm<;}%&2-5a+?J`azAJ{4zO+SwOp
zT^)QWE)n<}f58z$B3s6faVewvvD!LKiqRLyzzPX)pC<ujS4sfYkNe{q>Nm=X@05Xu
zWJ>!a!28k=2Y$)U`yRerQ04ssUp7^Ff5Ml|Ro*}GWm}b39||uwRk<^UN+cR$=&mYn
zD}32q<?bX!yU&n;!4lAEEeEdY&AQfgQjGn=$Zhh4xv;0OqPMkcg!yI)Gv}IN#wHgW
zW#dm0i2v@4i;wHW3ge`NrR!ZJ(~-`A|F5{Cjjp1&?(E|&uqN0i0bYdC@Ess8ARhq~
zYNUW6Q3**%UWz~h5kinifB*s^X#IdzE2-AvF;qRJR;^U1U=b}SABv?aidB!u5i5#H
zi%M+;snC08XJ_y1$9vDyp40uYJ9qA#JKr;R?%bWp?1rywd=0}_{wOk%be|<tqvga&
zZc4@XXAprojUbc(V$!&jcJF47^W9OoWt^IAr_^vSMa!up(QX&tdE+5HHw2~Uy}<M+
zmm~OZ5b?XO#wXCYx$>Tn)HO1e`Hsh^h<$uKF-UT4P2jzZCD^|Cc)PBdAM3rI*cl&j
zAIJRecv_^k=;MEUGvAn+AmyMGPCQhul1Mn@W9tQ(w!+<f-_z4R!0{t3PMYj#LT2dk
zfVzEVLQ?GtZb!NL5iR%V+H2hDIj*PexDwKHAHf*EqQE9P66~PBUcXj|RoZZ6V3jU9
zi1Pq^bSKDgDB>SmK@hLb$B8U+I6KJJYo2U<qNm+i0NHw<=Hvtg{z(TzeUcahJ4_15
z(wKq-St5DKfV@mAunaJGUae!3Q_fPEl_h2L*jV5hJ@7ER{RKq6=X(_;$}WYcZ|f6-
zr5R->7dICBP4vyMN_15!L=CAB-J6UE4>o*mqTe*(J_8W<3Xl0xs!_HtOd(ylsSuT>
zLbNOy(FPz|S12tQlno4p)9z%P@Tkd;3cV%J<Vw;7MM)TC%wXCjMa1M6jhbtKyJB~Y
ztjd$I!UlL#QA(2w@_RTLKO{PkjA(5M(>^Oo-V`#fO2TN?bxa$1RdPntk}=AJ0p_L@
z7(JYf5zl`zA{@E?<xhl>E_LzidbK}4Ibf}v=S}%iy8~LAY$!4><J)U|akI&i^HKDL
z#my$&z6D^DUg>CNH|e!<|NaTx+7IHPd+B`lAEzzUA?p)F=wA9vCv-2pL0l}EtvmYH
z{<@>k>#ui|?g6@^mm8=PTLC?jxcfM^0=lDnjOpEpdw_K3S~Q*NwIL+d4LVn=cR?x6
zI($tx`6{H#O4}!{TNgC-?lenl(K9ToXiMp>bKTu*R?a)>m)c5iz1+!pNBugU^Lnil
ziMN|hl$K{1=Y!1-_?%_7X8bH8n(?!&T9*Ge%u;^VYv&m`aCRS4)@zMYlX3fGzFynM
z#=6#P``C2PdTk$@?=fX~k#QppzQN5s_A_CjBP@7cV#2iH@m<Xs_1d4A_ss0klWmhc
z*50E6d4rjr#owDuIlR_6e~gZ`IQM21d*)uWG#goL&An79h*NuUu~%7$Bj2sX!Ba2K
zIhq)_nQic4mRrrV{l%o4S|+`MM+rUocs8W-GfIjjYSR)^0$2}pnCv2R&_%!{m!hrU
zij<)aI5$pCU|C@$lh-Ae={NgY{WMvvZE%UTL&og$-kKOW@2!blFI#Ohb1Z#UGp8@y
zMBF#Cv}5+R(~pSz7UI6ua(9|rqus{Hsc}DLT(jP3w)PMc+b2AsRaW;}YbCUb+1<2?
zk#1VWu5<Rvs@VNGJw$9XnYAlpZTc{wyyyLGjN0EmmfPVQD|mk!!$!IK+ZZ;*)8EFh
z>9jlW?sU1`-<}iwEuTq?IOz3btrE+sp6ZsV@#!qS1+05jDahB02$h^AhK|yl=3?Cs
z41#WSqh~Qx$U^JOfXfqf{qr;dB6}*BH8MnA<*x0!nsW{lf_(A45ZIXSR`>|-9U(C%
zN}Xvd)jP9-?W;$ZG1~FA)86pSNLR;SQ1;(0+On?jtqI#^v6w|Z#WF1QtBE5c{c1wt
z=sbku=qcZhWAxu!9X?j5G8XDo4qV!9b1+7P0$m9Z$=)WWfXFcJf>Jf}34t=g9GVg&
z(l`Umb~?skO?*8iX-zyUGAH#hYP46D2M%mPz3G<Xt}iDxltEHlODaT91rP<FRDHNy
zYBr?*BIpdE3Qu#xdMu$+9LAVkkwUVrPDWG;F*bN(^pw=S0gQa^ZHY2etH5v@mGeT>
zniu#udNFghOuLE!7R0NbOkD58$L)63@QPgz7`0>el_u@1LDU+m+lkSWs{&6Bqyode
zQvPZCL#7orXeUePa9p@lJ6TUh<HFhV7i%Y*sPL0pwxnA7+<Yd4L+}1+Q_$}VMNM5c
zRy%b8@(;BfweaWtt&mTH?}4~5@jW`tLA;OVfDXdit(Dk60k(Z5#i~}wzXtpu1#kWE
ziph1TehgGsD^#>4Vb5D!nUa$9CzT#i>k8C<RQhBLBi$VsX*a+gtz=@&>%JezL~Ag@
z)MY7%r?=uQ7~E1&(<b5T7`Ff#0>0%O%;BfYbJRgD0Ne+tiU#c<{|mKfsrEXzEGPmo
z;t+3*6Oi-`%YKf#-{vRJ5~uBrzsv}ysB7N*_9~_nmxwQGJ#RI?y~^)0{89zBcLEKv
ze4)l(P=01nuWsR)*}^k}(*tB?3*Y_c8QwC!_+p-~CuP32I{A8vT+yvV4Wk4VLiypl
zw$FSA-<dIVgl>}f&H^7>@RE}_`$Blu`Xvw=D+nr|(pk^RNV-BI>l*)N{cx(N>srJ4
z>8~G;Aa*giUF_GgPvc=JMjv`v*&qUBjshTaJiM}KaHr$i8xZ}{(qB)=DT18zmV(H5
z{w>a#OpvR@_c35$mJmd;)5;6PU!p`?cuLbgzt$RH8#&Qp_sAOSH`R&YO<5AC05XOU
zlrfqD6Dd$mfmsB|Yyu$jc6i0_hF38jFcYQmS<k{~`iAKc-2%$zzl}SBar1qy+oxLh
z<7HwR@*WU0RS={3APFD~?WN102B!<->-Eisd%5>}z>l9!bz{w>Htv`I{|QV2f$}cS
z1r}CoFcy$u)-@YJ7b~TYhWXN!s&;V|e^^PC8+&FtnQ0L#WBTecPpiNih-5;<m$l+g
z{zg4P8OsO|x%D(ka0fw_YdLLQNR+t&97YWxQUt5k8Ma_m<`w7;QbFz>5GVG`5ZOP7
zqMm*Hj52fKtn>Mdz$Lf($2;m>)2oO~Pv^+Z5Mlo+YhoJ4)ZewOBEoZQ?59x{5w6pX
zR|v{HOaNmq1$KPTXWfElr);S5%!sEUJ-e$&{RW*Fay%8Hv}%8%wv@<^K#Sqp+?(wS
zXF|5~3Cbv>Kp6$931HR}AaA(<-h||tD@uGy=K+xF_E%G}a)~Wg${~Ku2pR&f&Hl2Q
zHhpUPv}**(Cs$_1(3IAGu8|qU{bD17pp5Pm$fm$>3XCN{KILsaQ^Vn4`V=Enlth1@
zDQ3MYgX?r^4S8E4waL0T?nCDJK@*CD?!<4C^8@O|gSX$!?@*u{1+pnHi~{)t$m({f
z130c9if?(Fwv%d@)-wmFj66cxGarCR;ibaFq5M*7doO1up&2T^y@7){iy(scffLWX
z;+j-z_*VDZoq-A3+2R`S!VI+(Ej5nSjCzwa1bWmb(6!+IT#aXlC<O1feaJJw|8pPz
z0VB|e-BvX+*SQSmAm4o@*73(CTyUL};u2g$#vvWD|NSk`Go7Ha*nU<?mDYhdP<_83
zDB~dt{FVTb?UQYV&|dCZ1FnPIbqBcK<*s$$`k1@cgX>G~dJtS%3IBTxTxlh|LCnbO
zA_kYGkOVVI2c+Hv2rxs*5Z~W3<F48N8#5I9R2EXuYoPsXn@!P8npca9UH)hQ6;=*u
zP7T2DoI*-B^H3e!ZB7t&AYjMNaYs|>N(?snYv%}|1~JZMizBq4e4-%m$2lpej@NM2
zF|TkQ^}1c|gXdzutdM0-PTNEK5Mwhz89NAIzDR&5<zPKWqT!#`CSs6@3}iya3?@L|
z!Ct$Opr6`YvU?2#eY}<mbhLMN?x$(5)h5{mMAgtIwcd`83F$mHv6LiJeYCG*yc_$+
zGfuX9$$pHxgGT6CQatGt=t2OqHw6Y0AbJ@AtS<DOjv=iMSWlqbiV2_$WryZ6yKzbX
zslznw#9X@&olFfFp?MqPNg$5ad5a7E2iMsno?48v>Jpe%@GhcsBea8CQD+MyWK984
z++F8Q|1IFZxsC`gFwV-q+vWrEV4dA@&?KMVz^Rxyovc%q1X&Ii?{zljNvi`TDc$FJ
zlX5@!kDf>6C~B*q*jM2iyLz6t)a?TSL}IF-LE!~<_Onw;7r8e;t^bCgj4c#+h64Ku
z5cx}pACx#F=Y8U9$De&YjJ|&bMEoSYuKC)B#5_wp&9-f*w3gMmjo)OjM|}I3q2Be7
z>>h;57)XKP1c;1ngLBgAUCoLz@4oBB5@$6XR!>8@Jx4GB-5tq}r$*LceoAD+QzN@J
zHL@S2M)p{8GE@)lo$psvs2}`5Wk5wFlzP+a-CAk;B6vFNnPP{CvnLuAka7w+gEH$-
z1$i4O?amlYqbC~Q(;<-b!PH3)q(+KHQ~&gm>P^fqsaZE9V(OY=@x&(kX%$qgHNF^{
z{uzQYLj6c<PwywBH#3uX=k*c5sYM`#^(B}n9tL7Rmg`L0^jsk8`4C`w{uW-wHbN8G
z9kb=WS7Mfo7kMXU3xFTRgaBxsB4NybQ^3e2z(o}3MuBVs<P0T1y7(?!fP!8w3VOLj
z(6jGd^N2oAFA%MDv#Yst*=IeMeR!S3!`K#KnN}HYIlU8>8p=fU@q#3V1_8FSsDMvv
z@T?`!N_jv7T^l4clvR?_(2!tGq*DqSJKw>HCx=nGBUyTWfTnF}P!v{I@XmIg>~=i}
zM6WbB6P$AH<#IrN*1%+wE^$XO9SGVkl(i!LuLS?^IsU<dos#L<3sclOA@Q9-#A>~4
zT<BXbyB7x43l?aK>FvBIMfvYpK55$(q~#3}-E<)^$Q%lQc{%C0l|=$DuOhx?ydRxO
zWkT@Rmj@Q9xgjFI_iUUO76o*c)U30uj-U>Hy%u}oSJfcx&#NU@xHzctTqEVu9Zr@@
zrLg>mB`|cYB`D)=0z_#btITfe7`{7kn8FX;VIJ$K*Ed3#DFkE8Ab>fS0*eTcLMKQ0
z?utgQp!{kMGyun6R>{^Jpa1{jG00k@xBGnv#J}|MN9Ip8db=gcv5I_sxX~+L;|lOx
zBOOkx@#2zzpI6S&13ABfnDdsnBwvZW2=Y<7gh<)c6l>p37!KV*Wh`T3bV(9(3Q2m_
z#RBbAVowtdU>AA8<hqqm?JrVI;cFB)On@lmV7b0%W8C~L81(R{N5Wx!=5k<=LscSq
z1c>C16w0~6kwQ6FPSAbDck5CZSSkoYwL6P8c=Utsw$Y!s5n^6RFve{JFxOF_l>m8<
z2w)X3FdrqD$|nV2Zl!^D5+M4rCn-BZS$|vxNjXB3a-0BzykYRUNPK@DO6!T_3Io|D
ziiX&#6pb`PRK2{l%-K&;6?XcKRCOZ^nE0+!oN9<ryPh3D>eK-0*Oefpt{^I@O!%y0
zL<eN?B&5nF)UqKY+-z}l2yT0knEMRXw3h>8Mn$b8?R#9)zVYO%gm!<_6!-^5E$@is
zLge4v%<Ui^Axn-9kdA9CJXNrF;6FX{^L4Ylr*Ppj&ZZ3OCzdBY2#fcbfm6l*Dk&d>
zMU$*$ed4!kpe?a|!l8#(KtjHx9sV2vBJJ$Xn;|-{GBeh!NIEkrd!T4yx^{(kzK}_O
zq}l$DMxBCR4va{Wp~cg`R(P5+o|Ijp48n7Vx&X<d1c2O?t_CKt`GB3U(mT}@oC48O
zhH?&1NX6t(C^6r2P?N=%wf>+9b&v#Q>>xls4P-qBE({0LD<V*jCNh0_wt}2`!TG{X
zho?Yju_uVqyGE*U_B2D1pQrlp1E>Ih3tu1L>oa_v!B-eYy37c?vM4L(IVZmFgu;)w
zxta$k@D>3g7z>_<8^M_LmVEOJB@NRtJwkx2dp!Ge_zV}{uS0DPuYyEur2XV~1Q_HW
z-v0f)V>m51tWq;ORyi9j-j%thVh9<p7um2*3=QgouL35$*(=Lo9~{_BHpi9og!j;X
zvI&4<9~Sq5f31)IE#SYp+1u?C>c@j-3aiWD32*k(BEGB@amF_UWwaeafCvS;5+IAR
zbDj&t_mGi(U^Pn+J~+-n{fGDsz&7W%jgT>nGWtFN<VYfFT%A*tCQT5g+qP{@+qS1|
z+qR8qPusR_yT7(=+ctLo-Lt!AH!t#3++<x;#i^{wH=Z~1)Th3u-tkzT>@np+)<9ES
zQ?68yZi+2O`pDNNxXL`5UAc}omrP|C6wM<EDA?`z&2-Vs%~*p&ufPydaTf|WQUILj
zfyUz(ZT84@QuE%U{owrPI749D@tIfSPsz!PJw+kmN;2TgCzgf`S%x$kM+}h-O~%3z
zv=}jtvk9GjEBq%+<O8u<Qwr;UdTsvas~HUW-~4}lK|Qi;RnPQMnUH+*;Z=k&$Avf0
z>#9HimEko`Xux+y-C{JmzB~KAdou?km_KA+H>`;!8%4L}6J#t8+nF4J0E=JWR3LOw
zmpmV5EQFGdL-&;3P?12q!sD3;n#uCe+!jYzFWNBv7%+mFa-htb9b^?j*D^2$xDwRL
zGt4U+h2j+s%$&1(k4&u%h0LoA7oKu_d5r_dK}CXG;a}+ieeQR3k%ubUV+|X!^S^ow
zxR$rXbNS{l^1Mk~oww2Ekga6T9ssVY)kIidXppOIy+hyhw_1keCY3&#3Y<h_ea~{?
zj3R*d`xF?#-par~ynRpL3qBIrz^#_476`bsd5Un$+NkuEo*IS-m;DMtTVv=Yy6n|;
z&3LO-p<tk)_ztW|@m1h4C3<#EP>n}@E?BaSn#2Pxmoz2$68&2>%L(TM{Z`=I|H{~l
z;tleWZev}~>XU?HmSQRWt7;%XkZ7xQVRg;c6VV?H@kltTp)hzRv})Q8qv%=_c&5;e
zNB4tW=|ji^rIs=(jFhM=yjB~E@Z?Qn#86B$N(7AP<7~KzY$XzlJ*pR^MVskZy=n59
zo+^XSC{dI1dKro{Y@LP*@Lqn6Zvn>F7B)*5NpL!-g?*0t&sop`sLumrW;|n=vR>4V
zq5U3O#uU?9rD6#KTWUllRjaWe)Q%L2N*a~!><z(vT)F9%ztT>|82dtoQ2GFWiX3SD
zB51eeLECuqhxC;8!+xatl0$C*W}UjONJz68gG)f&!@9sJ?XW)NN<fDw)mHvME6z5n
z4`LOI>J{itRnnn$SnehPncaW$kp5`j*T<o3Pt!C9@W3z3-)#;56U9VTo&1@E+$4-|
zA{@>7OSd%`RCq|bvD$aw1zR(dTLzC|6)1aZx$T*jQy#_*%PT*z`EIKG6A~5W;`56y
zg*c%0e48;7qH3*Wp~PD@Xm$kmrK4qDdqp43>ty?5O69S;o9Vht;PeNyZv^<D6g{3d
zJJ*8i?4YsJ(QBvY&$x<yyVyLIF<-+UwtD+$ccGYLfz6BsyZ@6XbgBP;o?Q8Q`lzx!
zdn9JIy6gm`;O7URfx|FM0&9+IA$`2-@kG*vAh!zP*IhSgB1Hx$0Bc6_x{YfA1G}0e
z%VH=Zi-N1@2qL?v!~qBHa8bTAyN_Mb?%W9U?wpMLosxC>Hxjb`jYGCfbc|z|htQDk
zb`e67Nr2Oz2|A3%tUNv%qDGLGDkv&+#nOhPUyTq+m5P~fqF3C>A=y9JQtXgTQ{Kp0
zbJlRdt5_{5cL}uhDcut$@12)OW_U&tPk#z8$tbc+1kRxa8Ya>l(!twhpze$DP*U!j
zy#};;l1Z1VeK0xL_jiaGiJ;*mK^g=5+ynbM$u-xA8$h@<1Cca=$*fTz!+-OR)&n6Y
z<C9P$k(^&6DY})c7-<^8dk5G5^BW_u$S);+hzc#gO<v#3cP0ra3GV<>Y;CW1hC`a0
zb)Itt{!8Qo6V92(Q$rtsEZPD>62C=<ash%Rv{@Y>Y4#F+*a0Mt^g<*Gc>P;Z5aOC2
z;)*+{en6qx%!o~tkg2jXU;;!6HG)9_iY3I^!ie1mwQr|wuK1DhDIr^lAX_P?t2~o$
zxhLrCfhRb$<ZPiuHj9T1X#lp@7%v82iD|X)LwVt!U6moIHkG-1Q4*>eJ!1u=Se*~5
zsVJzX!uD_NrPsgU14fm=SVATnP_+<+i4E7^{;>|Y)8~RpPg;V0)uFdbb@54e(cD5(
zr37*Fh2~{K7(PE7(JX9^?SeYj-M6mxIX14_4wBg4XhpnFO|GVm2{KBo^7Q<kFCvHE
zrB@ft&FInjCI{DDCUK`Z61M#Xz?zFE3fjgNdI!s0hs1N-u{aT?J`FN0BG{O;ZZ%L<
zlqAr%l;j5|bk(jg8o-$#PJfxrMnrvAqK+c<+<y~nJpqXlc)+{<Sy^=(b}BClf;g|&
z>r<fG!$jl-o}<hOt37FLgb`<wPPZVU?0}v?rR(TdZzZ6WUvr$3il%|F3XiO5K(!J%
zTmQ-f{%SC_Zh#avF$nyN24}`)XgF;OTHvN{A*fGiaA!JEGcz5Q^a+9u3<m6Kh(p(%
zU$gB#-f{gX68U4B?f(q&l-J^w-WM^+LvBZfln3IOV4bBMwK=X04!{q-yV+IL+B?m|
zVv7NGJy@N{dkPP+`4!BoYC8061q4I(F2<Az2T*Z<21<>af{45X@&R{R6J#TwlN52G
zo{L+DQD~8ZeC6@g;H%8acg<=;hwX}x4RPuqp~(0_C-L`{S-T=*B7}AI2EYHdDo+9{
zOEd%C0MIHhkv}KeAaFbem-hq5-~M90Q-;Q$&Hr-KU|^l=M1GgBG3sUXJ=8L|2Qov*
zjNM|&r6XQ)hyTb~J0W-MNR>+}FLe@ii43NC0%_j%613??!{w>ixFE{k&=^zB=!~9H
z9!t6cjgUqMHjpxId~Aq3e($?{|E2H;XiAuSPEL(84qZ?EHwN@}2f~CX=OR)Lm?-%Y
z{G4&+uv$2nFeF+HzSn5~>;b=Ihkcsnr#3(kkqgah6ExmCR8uSl8i(CUR^grfj2PT6
zHjL;j-*7yc7Q>6Lg<p`yGvRPDk!+-fq-F?6-N?c?-NaZnNd)mzKnph_rLDrHNuy5+
z>6!2Fr|j0h&Pg+Qz@pO20ED>t0ZEe4F`RJe<y7L$RHkjR_8eOMjn`1inpVm{P(=XB
zNER=N$^mxTf8@^&d1OG$fc;_Z1W}(X-4sfW7#^7+w!okMk55W?aHEhQLy(=YeFs7w
zz(3ebn#QQRQ~1r1G8@#h#Rwy3N%j(>x-6foH1Vt!r!c$QkQUmSwPCA%2nHssZHzBQ
z+T$hES`YGtgQf<hbU7K^@7Mm>oZd;Mad#fNB5{67OV8__k|WEqud@>}x|uKSCNv<r
zV7R8V#VI^wPnty^YuKZ>2jQO9U=cMzvygMs<(_Kb5bL7QCh_F$aw`*3s-@FkL}%p+
z9QX)l*c4>}7A|RAa_{1d#5jC2_kah|B0(|QH|mriT3ZmANgS|)?L5~ZtHH-W6D|9%
zf&)=-t~o(D3Bte5prJg)II7s{*3w&f-CGnLzz?D?E|z3y3tO36R;SYniYJzK3N<Ca
zPXiG682@TpEalMJQK2NnQK<=uQsl9TdtMl%O>FYim!$yA8bC-5)ScUFc&GAp)J;fP
z6!*hgy2<&4$_*IfNIcTaO5V)2>8aEreL;kcU3Dj$-TMpdq&H0=PX5gD8Xcqzm(u@U
z>euTn)KmDU-ZfC91mwier@@OStEMqNiYNO)eR{f}T-u<$je_hTeZnFw{&dZgz+vqX
zCNm|UqcQpLI3w<iY{CZ@D6fE>a=4R9<|~w#9pf4jcno2Ao8T#<F{zkVRMEk`wp<-R
z-4a6!K-IfU1pW;~9LR+v3~ql|g~AQ5r;A9|2D?~SCG_g_13dw+3UmT)%ovUSkwImY
zAae;jTjwhZvvn4+$@EUeb#iNW_aJH+Y=r!^cEFXBx4iN@#tbMMn;0IR$kzFt0t<%&
zUmoacgIk91h%d;9`h%1}*jmrs&s>4mpPc|?oY{1H;07x4LyZy6tsZfoxGCi(q75=P
zRynUH*&Q|#QXnRnXtE_8XV@D8Kx0EP;sBwK1fQQBz&qv5V)IJR3^Q^&Huq{cvYh=A
zYS@x#=#cV-0iIvMhAlMb4?nmI>P7-1Ofv?~%R&{oI-!WPZhaPF`*ndA+K+pwWKuRo
zk(bhidYP+lfHi4cN<!SUJdc8%$i;<%Z9LWy;tm}NEZ|LCXU3Q3i3<skwkZuIbTb1b
z^hISeF+R<8Rew~+vhl~KhTNYOiOF<P$|MNgd%jiR+6={DS^sCRu)?7D3!QM+HdyVq
zAIl9A8h+zmEn6uLLQ&>TpJ7p1Y8AA9aK^V9l_f2$(`tPwkO@pV>3kk}4nYJ8CQG_4
za*|UILQ}V#$kngaPL9dIn=D`=ZU{K$d!R_1$mU?~by+~DylJroCbj9qWA+p8GeSx4
zU=OpkfEgIRV{|rfWm_7tG{j@VTYdtWTAHJ*6%_2zRClou@nn~d7%;S=Z{5@&&AQcS
zOxXJV2aw(9Gza|!(|nfU5zLy+4TSinZ>`N@x4jwy6sV4DpSClQg$d|(lLZ3><7#B&
zP>i7Nip}e|A4X3O{@^6W5@+*O0fK^(ITy1Fmv*VM2fp`C{>7MH6Ha=YmN2BtsSk~b
zzXry8?@UvIXJPc`Ew@J0IuN#P3K6#Ss#f;j=F5tBIMea~i^fQy)@oA;M$Unre$pQM
zRn6?S#!KF7u<6FAG(Th}1h@r@G@M)3K_RUeNKbGgt(bHfEjMX-1cmem^WO)#l*Chs
zt1cy(Z?xU>Z+ahYa|eFZHX0h)dADSh>RBlY|DgEDf|JYPw#W?yw#dq)iet<odV8)?
z(=lnpC|&SM^HwUsy;JsPhHNN%gBy9!qck^&d#b`^neD+MH&?qmj@5_v5BnlBu82dm
z-pe5p$v)6+!mA_VwBdqK+Mt0;InZ%zc7I?#94{jeE(sYq$Hl`NuYKFN(r|mY@DAj3
zznI)^MlR`E)$Si2_UT^m7=}(fW;}oSO>5&J-0k0{4l>!%T^g+ogyiY3H?WS*_XJfn
z&Qw<TVl@zcmrB#5^9g@0Je5Nh<a%wt80q}`Ynk3I1@`HOa$Ij-0G-RunbP}P*|)I9
zN8&3GfEkPQp-aPuq<aSK#Z&_l_KSAk4fM4M*{IdJ2ba$8x?S&Y7?+JPB@Es=D!|O7
z-)zNA{jsj@j~ZLWm=F>eYi}FUKIV$j<-u1D_BPC$`EXK*f#w98!GrjWB_dcU9|teg
zWF^paYTp}rpB8$bCkkgRh=vMq7EPctO#ofMQUDL;s)k*zKO6B0=*x;-v!D%-@3H{}
z<J;?lQH^<R82__Z&)w+;7_5hOQR$Tlyc97j7!>Y)KCpr)ovfs8Mw(XV<#R(_UU*NU
zskY->Msu!bs+v4Gk@dHT;HwA^QEx_$JyI1<+Fn+FS$Y6%yX!BQ@?x8IdX3b^FNFIq
z_PpJee|?$tS++x-9mod66%fzAcX^>N7Xr~!K$-bYM9hy6o3it`zE~>SXTx(&X5su|
z{^{oCnz-(r$cE@8^!itmM{(mDOgTt6+y^i1Zg$1rvh9?afvlv4FX6(crqdFM^N&rc
zh98%(DVc#@MTfVqkv2BIkmz^A-gVAE>uG%D%!DsZj#qq%pIvu$ZmQ}aX9YS77Esfc
z8o{t-n<4X_Qyo@r6RI$l3sA9pFZ6rOt8Ne~aPtIUwQZOhZ^nAc#(rsEqw;aMFG%rY
zk>9-o-Q2hv>A>gE^~;~`u5rIcC^BlqnbrKjH`1)i?<>$pLy3DxA4g{p<J9LtiC2Lz
z@!Kb@;`DO#Fnd~^KQ4~1J}!cngR!;@79k{$C34GL2#ztB_@o7v37qlOAcp>9zmK`-
z7}mN3sv0D5&atgV^XrYLEobt#JnGGc@u!&fY#|DmK+_}EoFbZc?CzWG<&x`s1x)ET
zYT{k!pT6M(Rv_b13q7<Hd{R`B{*G-Vx>JIlULUsJ?fU-EG0d;6VA5eU|HG!JNzXSW
zFcl6ZG`U&=u{TcLvjbsVdUaJQLU1GOVT2a}3^g8FVo?s>ZuTA>$v?%7->Iya^Pvs0
zXHC>miEPzTO$MKla9hGw>-dI3uZY=g2+7H*jfJUxzha6CeP|QW-TX!2A$=ZR7}<XH
zT#8@!T*6e72nbo4;mG^@0Pn^&{8u-cVM_)&)vm`0mqMrg%0*j>bIVPWM@D1$dde;7
z)~r)G$)RG)`z+~J?>!$O&7o{CBPOY?<Y0)tN!+!cU1UIh)=Z|4!Z@6cA}c-9aW#A@
zUBDb=ccu^67w_x>y|SbIu5Zu7<|?yrXg)mT?y;WHkG!PzuRxaI9U;mx+5AYL6(MV0
zY$5!#OGzwCw*Mtuo`4(wTFCxJ2Zn3mKjDp3$HK^YPVaL;EO__GbAD_@dhOF7BDt-q
zQf6qhEDsE+*)!Fw#Ymq0I#$nu*d1TZ(!ZNf?*)Usr)9nxlK9e=eJjzudz8Cb>b_G|
zcQ(+IXluHAvq(`%f7NsO>e%!5ko(HmdcLy1zn-@^+MXF7<o0}_`ufaXYe>9fZJc$=
zJ>DJQ8+Yu7CGV3NOl#fn=zSz?z^Ep#-fM*1{yU}+KYLSp-Q$GXj{RXH2%>}T&BuP)
zvKqOidb6mmb|qR}yjSG~B5>ch->_g&tA}#y!?xl@u3HA`WYHArsUp%>i({Y}O+`PP
zfVnpXe^Wj9u!pJv$-U(4lOzmJ<VT|MCDMBroO}#y`<F?|wRy!$4NtxJoj>1uWPN@S
z?N}m&s79FanoHGLoWs73+426Y8N@&@aEc=x@d5aJyL93eltc3)e^%G(RZ}(4qTp!}
z*y=bJ`}P$;qeT99V1(mFJ9!{@NlCx^2=*e@6tC}?S}5Mq@4X4zUvMiwNK6&==}iV^
zKf)mQC$DL2i2}(dm%H7wSn9Ce1{p-S6LaVu?8T_57<D-irLw2fydf?j4-4yq2~sET
zQ^(ae_IU*My0WZ8-<3i9$+i6@4>L%85HUoAk)eSXC8+tX5rsHy{g9H^mNT8ZgzFNm
zS?ZBM8lQ~l20w@fYBoF`a4oAbM)8u2G?v!U-wFEUT@PwG!z`EWIR9->7m3I!MmK_r
zKe>jF2IGOIveT8k1~oUQQ&k9V&ExFG1FptfXypYvXE&A}5|-#ZpiYWQS=yB-Ov!qj
z58Uwhq_}TTD1fsUhTad^2H4y>H6mq3PHX5;$!j?hRdJDy6NGcbrEMTEEYnS<L@GZv
z^N!#=u8<6uAU65?E~~h1gLPn8=R808R>FB`odMnX>zpGe#-Qfc`41x1AbnX7<LLKJ
z(L~9tU+_sb`I5UzSYFq$1ltp`VUQ-t$WYi)Ppvqi0C}&H^8F4RhbYY&hg1@!f6`w<
zuLjkLKfg&S$ZKVn0YSt(APxS~89*>*X?2Lz=%R&mBb-f0L!3=jb!BD5aLjY;O_wL-
zc2<Q(Nu;FT04j+%Y6;JbKZ*%Pct<flqAcU)5ho~$B+jrvzp@s(8@uBN2Mm5&E=_tD
zswqr9=RApHs8RfB;n-BT56Jrx;R=`^X>HyvmnBTSxU7=kfia`M#XcuZwZ5t{7P#j6
zn>lB1-K{8*lgLu|wDE@&x;;MW5S!_;Ww?z-s)9klQ(;m5?k^UZfbzOJP}7YH@NBs@
zc%P->c?FPX<1#>NNXM7dyaJ&ukrif&L;(aO2mlYmVjDS~5C39Pebj7-16_dYhQzM9
zM2=fN^9`F*n=4{w0DWYr$8y@TV!z|UL(kP}-`+hCHfRC#TNG51_e+47tq3Okbv-RE
zO-p+wAztA*?26xB9X-G?;HjUkgE+EuX@K`R-b1ky5eC+(QSt52f>ZLF1Um>Z^J{jp
zZigcWsU9Sr1xt(Tm6R1DSH_De9eq^B4EQk$fgkA6SM;xlU@w@#q}B@%nRTD5j(<%f
zKnIr%2g3mY4L%7Co-C3Y%RXZ&VsK!5zM#V;DkRTMQ)BJQv|MO!T!vPK?8f3*lSLI`
z-mW;}Su6d)K~XoyhZ9>~D!)mm-A3iFL~K^VVQT{Mt9PR=Cytw89Hv#xn?nimzMlg^
z;ZxjHY4Bj;Z*|LCJ#ab8Z9}QXeeuh}R^t|c;H{OGCJvbTf}R+@F7%}ykwCrZDQ;9q
zPkq(5ErTBDy21gzju1t$Z(<4iVqrItC-U=+fL636e1F<<;zpc_Yh`@P2u2Ix-$tuj
z7prfVmUv^dvw~w#StmPnxWn}_5hmQ4b;fV0)k=@9JL(TmiG%5;L|X?|CHo8_$Vh!;
zlRVCC2tf#(EmAj@FO7a1vyfqvJz{@^bp#q!dE?R@p`QLPpfdem`}C%;acST-90Uze
zG@R)OIHe$>=XMxck?ChZ^dLecv!La>LbhNsL6Fi#qzQYxbg=L1yLk!r`p>0>YweSb
zFjLcw%G=V4GbUOV^v>(hvUf5Mvm?#o*2;$j^Kf{Cpb^)5hOQR-iwKdgO`I~G=T*lD
z#n|Z?7X08cNaV2M?bTt!-dx;ucs4H8@qj=v-3)fu&E*(IizA&I=%(OrtS4hMFo}Kh
zy%aaoYSLz+*OukX=HHCmN%V2WuqJ09njL~E|6SG@6!S=AYLS|Aq)<wc`iJV~I9jWp
z^(uiQEz{t4U4b?C6VIA)M`oY-kgnteJ=u}&L_B}T?)s;FsJ*f+-j$MfB?I*b{&|aF
z<v}OemDV}Z6RGX>VdD4k=dAI(JBa6MM4cv2qw7d<@~cnG6)f#X)!1Z+`Y?6urLAeo
zQx79qy7{wKCveTeTl+?Py~3I05PGdrULgQQWToW7h!ezcfH8z>i!N5PM+;SpM`XVM
zZ7NDGm@rsR4S&x!+QkyD?r8ibcS%@pr7515Sy!GbnllK0f4)j+tjd3ONW1de+XxOd
z+lwhTBN#h?&Y0La)rV_*%OVYnkc$IFi9Z%Qir&T8Slajr&$=DKrp^O1A7TN<b~L~7
zv$wOyZOqQtZJ$s?xx+e2y5>6hz!g4;^;Pw(+b)U6!%d@+>so!JF%r~UxktZg=mO&G
zK+^)9!%A1yQG=b%m`r4PC^w%j6*8hpq`IG+91PVgBtNt(bo_|&E_W#G+BB_vEg&oH
zT<<*8!2Hl9>mIYP6`*F}gyF#awX_w0;#J`dtOZ&&E2wEfq;jTVL5CvDb~GmJ*${UH
zA*+pr+NfZ7x2BlS%os5<)Xth%d$K;dKa7AMPLXLoj)suv;^RX2SG$H=zy{W&JFXr(
z*5x)FIEclUf5@7Cgn7m!!^etlc^3~^fYAKir$tx*Te}~l!2e#@B2q?U%Kr$15DYak
zAY4C4MvFud3<=<*5}G2728=I;uJS7S$$U9yiV}jTSS2WC9wNH8px7s6UXO=!0{^TY
zCbO$-27TqVW}_2j-stFZ$P^<l^qmUw!_<+Jdt5Q)fInFkJiMOO1%n#(J6SL@;e*2I
zu)UmZaiN3K4;P@_)O3df>1s^1*cS1%551)s>*C;x*{6-%-$4FnTz3t=$~iI2r|A9|
z)YU;)HRs8NC~h|(=bB6zk&<d|0Y5mrqO7zN3>ks`m1`bc-*xP#xBW*Se1O^x<kQ`?
zJx@2u)O_6EBY8SbmR=Fpk=xG1f2H(bXAL1N_*_LWr2|^xo#MapqGKGBGlyBkyDc@s
zKQ1CdE%9-m&eWLesaOR$uH^W%D;61DAUfTbV5mUr_y?K`<te1i7UE^Wc1INF)EDE_
z&TPmOu21wat&PRdcTmDUW&}w9)pCB32BjjH3mUptwCBnakcI6m>iWh*0lfu%gDF*I
ziV!jA({OS;+0EB%PwZOMrVVinyY=zY;x!r>BLN5);upMpm;z@;9oZUUl!DTo_a!@P
zN6zeuj&(uDvRB`=S7ZEE;~Gi!R+L8ipn(-)mM!5BI5Sl~D0kDmdo5pG{g-u-rj$i4
zLbiR=EUvU@fkyNt;<?KYtu1T#bk)e-$DOc+{9a?nTc5?C5M?8LhcoGl`#*&2&*ZD+
z%T`(YT+vDwR|%WFv5YmT>K(#x6M|Fr7-Na)?4F;vzOmL$PulW|z0AW0)0BTL)77^3
z+3r5S@w)Ge;kvI#w53Rx(fX{gv6dlm2|B;MjQ6*vjJF>x3q_2nv1KJ+iY#-nywRbn
z{I>V-;~8xe8v|Q$s&JML*{YH9yHWT;Jgl~<ls;ft`Q59fKaD``ZHCOsN%Y)Lh5WhE
zw}W?eWM=n~cW}nJSkxB&pykPvJ_}z&dr-r++P>uZY#hvR3f@q4r``ts!tSD*O6z&t
zX-(srm&0Bfr-B|jp28hckHkyRS3em@3mClm)=kJD-~pc5i4~zB4za=XomOucW7o|r
zutjTujrFSP`0qZ2!JKSILaR*f`ot>l=J8}A6$m#>uP**M$Q2<gqWQb`r?y<Cld>OD
z<F=_ji}x}T5`_rCur{F?Un}nHcQ;yb3tsQ!-G<ZOU>Kpl!DBE{Eo6V{v34@g-K;vt
zv+bLA+(A&v6<d^ne0l?&K3nieBcPN3Z-SI$$cEpxD3Dq=P|c7i5|f6{6CziE!jrcf
z%zwc^{>1asP))BPJEtAR)leg7{a_n#4`N;84IP~1xr6J)Y47QtC6l@r^QQ1$cSoM7
zcWXOjwv&HuIgEG@G=X63z2;VRNB94xqnhNHBN!pCNjPueWTP&uo@}pH;XjEGlrd`X
z*q;i@le9a}!v^$qMG`-lD??6|-IvGUOrIOThYb|L?K`TZZpTa#?RdC&-K@g)cs;oZ
zs-lV-OxY2|c09Fg9Yw2IBR={-PcPavxXo>tdkysiX%SY`?4a}Az>5<3^i9VG+zzP_
zSDv|<A_^`Q)>bv!6Nuj5<9p>{>{c!T*{5@is#~4G1L+6zLT;<qYhuA^UIW(WUsXcn
z>0Bm|H;R>UZ6AFGd<DOJU!+4f1t7LWM(Wb3BFr299bM-D_=o-=t|6D$2(uAEoDWK?
zBCyR(h4JK7a=VAsUJveCdmvx?M6FsKMZ+l7XbBe6X>l{A5X}RTRJ*DoEqmAfz>E3^
zocgc$hl=!rc@<r8I^A>f6xSw}uA*$}(C*Q=ni`SoWj;rVd_vWpizQIZy2|oP@Etlw
z&;+!(Bo0gYrq(Oz^;75oo9j&F&t&>XUc8i|q#`=fiCr0&4;?Ky9!cpS3=gf(<~HXJ
zUbF++_ODID>cbEl36oM?eoGb{d9(10WZ8C+9dC;gbMu`$p>12oc3_Zey3(B=SV+Fo
zc2J4i(%1saSluz>Z0p5j5ESoJMuS)!{T6{W5Q(z1aLlC0_vLQl%}`Gw>KsyI9q>ba
zi=~444$r`iCOEbrnntcHSdrLhm2I2L?hD>LHa1VN(R^h@m5i|l;bAnw>rk|h*^KS~
z9zC!q;v;~jn_!7EJGv6>N>?Jd!-sGtQ9oGg-yY39x=I>{?L>%W7A*@2gO1Coe*+nL
zz`WG<<@KK^*}KgiKG_`%bbi(G)tEWTHF_`oq%P4vdSEMsv02&#_i39z%syZMFlkX=
zz!>PN&pmxn)AYw{2B|^_t3uR`U!~P$`~O)Zyo)#`Vpq(xR~4~Ee-7?=e-mnc_OF}?
zwV$g-1tZ-(CjTNcBQzX7mB3r}%BA{;jj@@Lg*4PMO|q7sG&7`-rvWrS&?0{^@YUG>
z%4U90XJ|on%pW!ovZuU%rn{oc?_F42I<UEQg*VP+Y|HfkmO+RE(W3@jDiHoNOFRjp
zr@f+H&X#qThJRGDd|dh=!yxuDV?U|X+w)xW2VWazuWp$Rv|Ot3|B#HEh!%|3k)SK&
zhl8$J%qbHFmw>NbJbEOujW9Tu!Iyxl^@WUdxF{L?LXYzDq+M@-At<C<p*{jxhZ?po
z<he`ES5(H{GGxlKIl>kb1a)?2ufyuUg2<G}7mE$G%Z&+5nrn0*&H$KQ2ph0#kJ3h^
zTK2<*7v&4S&kC<ahp;&6%_IRpz3!-&E4>)k&gZUrgt_=&NAlO1W2OW(Sw;5m&OCe!
zQ`X8vHBq$`osny_qE?l<(WTeS?%DS2H*&bykWrDIFbqC0M-zZ)+mTncq8o}5Nq$eI
z#meR~NWa$|LZGSPn*1&`-<vgMvBJt3(4knNWJj=dJa~=T+)R$3cBbwrFJKFtn*$S<
zu;<-p%_KZ~y;v(WLE#$bH|~H;l+Cm@V(k1?UPQM<Z8AjNgHZg<-J_=uzx+T)FS)b7
z9++~4U-Qz1<UPX!k($G_$1-RuG8@WG#9b>WS1q_0h;$wh!>wL`Ai3Bc@Q&Hl^%~`F
z)~58D8CNROTa>zIrAkr%j&wmUvkD#+E|XTa2V7D$Oj&t1VdbL|y)|xAP7d!yWDAc_
z$JUTyll|-y!KzI%1zB{`g~SuqbRkjkC;(dX!1?(dXl`Ud_D#7x+gXDzHnqocmkIR?
zI#Q{<L8XQ^ndTo#SgAdx__HBNKjnTx$xkzKdNTT!C$6R0h%mu$W;|K5J(9L}vZ4-b
zL$BbCrBmV)`=;3ynFR=AfN^lOmVxk?v7rmyMj6BU#v*QTGMYO`l)(H*2gXubt!8pu
z)#S}I#d29yV>P<&)Hu!)^RwOh580w<x{nTGX`yXaoM8_IYqQyef)FfNwk9oF-ZmXt
z)E_%hOw;SQLG3itO>j}IUop{2|Lty)rR{LwPMX$MI~&QH<inmXt{pL6rCsbiBmBb)
z&l24J;0eWqr#edYTy`8LxYto@u!+7`txh+Fj`kbzOyZDC`7f7}o_SP3=~hO*V&Vmf
zXvN1}E4j@A1s?yN<%P~Dg?K_P(+_$lFVm^Cg)gNH%L(Wnw6}qM2esQHERfkQ`6|iJ
zYTECCr+CJ_#G&UrTF1@6V~Q+%CiAMgl`h%dX$o>{^#cCo6WCo=tHrP%(QvSb*8LE<
zLe=>azw4Wlx6p_30`nDLfPU>5F<rU~ALtG54Kl~~F&e*Mj_t)koA~c_cO2=~5!tm6
zVP1WV7b%}1>9VMo#CSOa;71RYt+=-TF?vb3;BGkSxWH@ze4+4TqnC^!=W=s?Akj?d
z%+k^5)aIj(b%i@ZpDUB5broz2S{$3a=wx|0Z-s5Do{_K#vaYmM<Rh(<xwSL;%yrL4
z?M2?=GhyX~ui-@P6}8##JHTwv-<46!Ti&ztPH`MelTbawK+(5Rv@y8`eZcZ6_a5sV
z_n$J)fOnyOOTAL_j{5O^emTha3i#mi0X+G=eBsD$Vty4+^7}>U5|;KrS(bGbvm1#=
zTD(OMUx#+Av=O!Kb{vNST@+24=A7w;_o5)I-auSV7!$wJJuBdKe(3AoNXMqt!Up8F
z26CGC2hMdS2q{d<8Qh|G{^{rZMhV+hRd1irFtC4Zpn9%rL*}D|2=c7Y1vG@I@|(J+
zTLG(x*p$V1`#&}ii+et1X|niD`*Dcz+rNjuFE+|yK4FCEUF*ccj(N2x=9c2FS=qTa
zx1oz~S69kv6}sXbIG4rxPN?7#u7kt`yz$<191S|0?#3r0`b*v7u}++yN;WV}SJh`+
zl5!OQsL|{y;rux2lBg(A*7R)X*^7m{r{k^w$FiWaEs)X*vps;8U!%R?>^TJ&g>7F=
zUC5zw+q#6sQNLW~t<*gD;zJBs(q8^4FTY+_C1g~_VnDF{;r4Yqwf4IUrQFW%h>>o5
z<vqqane7%5&*oCvRr$Up?9VWPJi%inG5DCl0dHvRtrhMj=RmFJyiirXx5#4^5@!36
z?8+%l>uig_imK*RE<3XlMICRWc)ZfNq|$5pXo!OLpY4*CorQs`z~FC#?7r(()Dr5v
zOgXa4BVQ(NXe;xDpJ;Z_a{c4f3%$Fge;zu-V$J1;#O0FGK*G;B5o!-m!~`V_bvn~*
zor*xGJSP+m=uT?$D?V__SOiCm6e)y_<}6mlXLdTJ&W^Z)(>TlaCX`boyy4VxI9LIV
za#7g)<PITI3&QqL8d&RX)xI+F1(*$TjgB}yai;wm;fuB>0tNm~=!-4`Hn7{?o+Csy
z_WZ|4T5}W+E<QFkJYlojsE-N8$aWQxU141@rTm8}0;n8fEZxPU?@Bkq3|97=F1_S%
z085SR(b66pMv*3~{0vbO6Wx)k>Ax0W(Yyttc_<v^(IkSOrmQ&nG2iAg=n`t01;+?J
zx^5DadR>?u9LEZi{_>y1lsFt7mto0^6#|t{eD{BFq8==1Gs|X5BWxmqJK;2;?+sB7
zj0uc(8{IS`3u}!1DKjM{%Bqc-tgZny<@A~xDl4=qE#~bdo!L*UUWBIbJ%Wwmg+aiy
zZAhu9AvFvN@E-%k0?wARB5+Ve60ltNeqjhJJ5jBtPnoScC%R@Up|u_%(3{*#0wdLD
zicHI<9LWjg^o7(sn9yx-d8~yTK2P+2YM*=%Yka+5fmJRMZyDOHBFGo<Z%t92nL(&N
z4bH%q)=v$Hz5^Rh2xsXBn+;LPz6fRo1G*w}BGr-S4~ue&S#OV_>{F~>6HCc^uwjLN
zbQc;-*etGwvd840i{?c~-NeH3Zg5iYtT89e+~C8yhI14x8SY=80@_N-t=J-CL|pAt
z5uZ#CM84Zg_^0y+r?%RJFH>fL@z?FN8|)P2@+;gTb^8`VU@vWT=(kfieZqtF*tBYF
zmt=*sn`hX(d2k1;Hg26|HT=r@=X-<2q7&Poa)(43J^+Xo>Vdj2JN?AgkUM#b?mSAF
zMk?mY>mupTnGU#J5m$ytYlC(MHsGV4q`Q^t%+XtvDV6~}f_$JK*n1yuK&keq3sT#7
z@MZpH!!oc==2~}45k)|7>6B4-8g*&i5kZ%-MXVB^lX`uDcOcgpOO&|3t>Ps^wYOln
z#R*Z3Up;CtA|CDL;Z0uQ|NHn%>99u{-$Rp4F!FbW#meoXy1nf~@q|ushI(UUYR@Tb
z-oWEt8PpN`mtU2E+d`(3SZ)s@QftMG+qLE#H{w95OC>xzpW5-|#&%`Rq&j?ji|N^U
zEY6YI@XFOfpN85cG{&p;LJ3O)B&oO>B=u7wg$ZgiA0h1a8}GbkY-~Fr`Zk*Jb1Lwi
zEReC``Pe!nS6(7#+4&W0;;2Bm#{*GJ1q+%oi)5*M3rM@)b&E1LqE>MZS8*cdOA9BH
zseDn2*Y&DIbLqJEEoY3yl=2}SEfm32ofGYL$savYeA)B#L*3d;_XFbAAcw$Z+K6h-
zpjQ-jPx^Cp?a~Ef_d?(0_FiId9$S8moGDB{@6S|Z8{Whht7%6~?3ui<cXc^#enoA(
zj%NPj(^k3o1YTNs6etp%F#x?YSf#lu@&uSkkl_|$2JnVoI}sL^((y}Z!Dhv+gy(zj
zZ9~WkR_tm6>Sj%&n2aLBVNB6Nh3?VrVAlD!o$;O1Sz_Ax-P3uIY0=}zDbXWK+yW`w
z$H>mu;^jx$ned<C&=}@pU_a|HhTCVWd%tY5L={W4+Ge%OX8KM&&5H2uNq3xIE#uu7
zbvF3mRrvUnVod(1>{lT^t`Gu0m<>sC2_iG=yKa;LH*}3Sakps3$gyb}v1JaSzXP{a
zn}&AVmNmT4DM(|YH1_T-zRGr%c)RE=L~fox&&ikS48;5W{wE}`2wBXBlq7_BM8qtw
zrDg?hhzUOcL3E<g-Jc)Bv*&ba5%82_DC>)vaoOPAy0l2GY4gbmI6|4P^qWue^T=1h
zbSu8((HZJ7#&j`s50n@D#Ub<|da^{hev@|F>8AC$;fHvLs$BuwtE6KNvJdt?4u^EI
zY869oTKNX9i=nr>pa><mVi1H70R0{j`j%^9tZ0u%6A4~~5w#%f-}a-wa<y>rY`FDt
z=i@4{>>I21lBcl6U-f~~A)+I^=kPBkD*NC`%HOe6c;WNf3ch3m0BIW;k*69REX9(}
zmp{NHS<%47?tJevno9<DS3O)YX9k=EqrNh9C{8sHY$HmRHqIm+vuYvvG9F9ZC=%2s
zQg6VBzx5SQ8hU$meys!XduU!^d@Ovk1tiR@$wykdGOaVJBca9AV)=2pYFZm8U8KhU
zW@vQE{(W=_B=rOOS;vonXpLE=u1;$)x)Dl`R+DT25^e^=><GgEII2pr?_b3bgkc&u
zz15bJ&Hu?P@Fxr}aPnnLZk*ywV{e4b(DG;#Typ{JE~GG(x%c!L60)sEXrUp<vKaW-
zhIGRWri%IlcGX*QME1SDdA_yEw}21jnWPVtVFm11MUq_UrK|DL{Kvz?&<qqwMfPj+
zNY@jyC53Ri!nirWHFBI-e6EaE;xjI62v@$A;cp-6Dlu+t$E#)+Ak*x9-uuQ&MGrD_
zOD=1M^-)hVG8M{x(gY2UZV=(HXZ{K{zVX`qojJ&CFGy4V*btH4c!{M+5@1x&xWfhW
zEF?0<$qi{V#i%IZSCE}(ho7ZN$;4fsR52dZ<GZTh8I)RUj~X0Kaa+hX7<D_}udA#E
zZdwv-Gz+5_=c#}u(OwKF7AkU&=i#{^D;WW*<c3%c>x}ii%;Oh9Y+$*w0_DbEye`7M
zM&ZsA*(j}T5I8+;funRvr@a}xk8+%*UsgNyUO`{C<o)5fLhv#Xo^3?)WlHf{@iZOa
zzKL*<<V5zPR(pYq*2M_ZvffPhXslmTac`0QfISWJ_f)~<<E0`XU$r5>{F*gKT}y4#
zevRo3aQ~4u?u}XEfSkPLnB<mq5Cs%2Gkfut^I5M!WZ4nc%QL<P`AdY&0oKu6JUx{+
z#JMlj+h|QAn68cfNm53r97(;5WJUpi^|jA4M#m48n0^_*x!^skn|MyB>Y~Yk)Z=Au
zzo&Da-_9xeW^bxq8zOxZVSckS0{#v&1MbPlTK6d-_2Z?@x0Y?=u=kH}n2j1eJ;UAy
z0&S&Oql*2n<TBv88IO;3b5E||y2_I-=|9+!@z%5Gn*beTj#(@>k)%D0lF4T5)P<><
zTE><gzOhQ?&1R=qINWIYn%>Kda|GX9r{3ea-s-OC2LxDLrp!)YYWk^~xqZ(S>KFc2
zPf*<zylOK)gBfe~I?qcEFeB<`Vp0b}l*F<d;lD0I07n-WqxP2t0z});HC^Bh5r3hM
zeTZnng)cR(2N0=v=(hCwXpVcxJX(P2FYb4Lp;QPc6K9R;!h38|StzlS&eMf#bK50Q
z!AWQ1^lYEcC;7>`tp`sa2gA^_1S<6?*?FXwe4>pJgbSkw#?I4SGN~0=1$|WSv~Oi4
z6s`QeEnt%Sn4W;18-SEM4@<s@+F0Oov}u%Q2xVI`Ti$U5<ghaUe{K~S5;sI|pD=Wg
zygcSh$k9h9PnvMhY}snc7YEAY9eeH3e7a*17NXid7IcKrUz{D67~RSiVlgF9z-#fN
ziiXS-&RoKC8Tg4grg`SpF3`3rzT>wh1!9@xLsBG*yK~lCoNt`x06en*I?rg0Mq%y9
z)RoF$6PCLnfH-ry5(Cp2bQf(?TGsHN^+i^J>_ThVLX$e%5{4@bb(Qj}olb$9bki}{
zf)-nwQb2eThM;v+N`=k+P`j$zS+ynl2LY<6pfDH|$pkg1UH{Q#N)vTgg|Y);+B_V8
zX0f{6XO(g#zfdzgFjfO-9KJ>c*Qs)FU{C)+e8@p_vDPVPY0$5u^NBhaz8)P%5^({W
z&$f?pM)yL?<j`N0Z$Cgd$cPq%ryuEvw;Ukokc*ESMP~{`Uuh-DlLXZR5`H<}v$QP|
z`wwTYNuA>^3YPOP1>h#Nf2No7lQYv?+*&355j`Jr{`6>vvBQ7SZSF7k0*u_Y23+@}
zk^H22S5P=)TWn>nAS8{7@j|S)ymc`vY6}a~jXoC`tmhbdeKZ{jR22Kgk9(L8osN7h
zMYukn=wDF#>M3(vu!K$I2K5sjPSV7N6R&AH&siSiDFxRzlK$1A11d07)G8?@D{{I`
zti8VAN&LN)G$!fP0)Mw+dXH%?Ul@k-ewv`?V4B1hYDab-2Ar{>k%;704O|uQ!)3j1
z87{irkW0wcN)X?lCW?owRtWChT(DmmURwfcU)e+0Ij(A7r&dd5nI{!wJl7L<pkHq;
zYgt>#LE0m}k`ahy4HY=9<b%^c$>B90A82h&eo3pLBuQD3J`$F+nj8tH$n|oO3SuL!
zvG~O8T~a2%VI}JKKcuT4UIFmBy4%n~hLx&yFmaC7#i!PO$LrL&Fl3Fx#=$Dc(Z>B(
z*9NRhMe3_#p@{gg3s9H@<WJ~E-(jYT-auy!K-VpW=C`KziZPV0O~j=*qSM`}-%%^Y
zSWyan`#xzExT^P3shYjnmS?=1VpaOF^wEkGEJ{mZ+_G1qi9!6+iD<T`>AK&ZcHpmi
zbbfyh8)Zj>RmUxZ&sKuVgT9y6!iGh=i{v%#RRg(SxF%<Wm`90BW{9vgR#ltfuu`0*
zkQ$w#T#`1(#-83F(Y~eju1oEc9JVzhdG;uzIDIau5jrq<7j(g@2x(=!wYX=TjgCp3
z3Djr!??=btb=(nK`o%L~$N@&(EA9&<iBxFwFqP@uqXU<sYmLnHO&QMJ^nzNdH+BpO
z^$ik}`J`js7Zd`0lDqTQqI1R`rCY<${6NM88IGvNNcBa(4!iEDuhgnx^oNW`1C2u`
z8nmCVZTvk$x{x_oIx@99iQQnN;(z5E`@8b36#yt#g>pxo*1Y)I(dB!v^X|f|nZu+n
z2Ql-U+KCQLkdF5;#63wQ&gCNM#(vN7B>c`5Ve$c~499}}R5MenYGr=-Ts_}a*#_3w
z*mLE*^3JYZ2wUOipDA1><p#3msS<6xmHKb5eMXtf_8ObHTN+<%hLaik5;>%8!;FtE
z=O#}vbByxh(<(+@q39UMFlkrRHl}+2&hB&Y*N?wEli-3KC?yN{<-FeUGONV@yK2gH
zOx~JhHZtjhgHoO<;rz8@UP-)n$_FbKdkkgg-c{=~<FBm7%zi<U$A*Pt_RZXBWdnT6
z5rIBJ3PX(?0QFir3xe4^MfQQpWQod4fUsUo#n$?Fbi4;Swyspe5aOx%B_hiw&XMjZ
z@kK)mlh}!(l!SraNT&;Xd-}enfjp}jj;>ju^l}KwtOR?Bm&@3@0tok*+l85I8%=>p
zaE?L<TLeAlXE^Oo{8y3uL++~R;sB);&8?_y$a70iMQ=5J`M&z}*=X|iFh3;|I1*}i
zVf*g_s8cFDpEHA-dQ@nxz8(OAhbj%``I|_q%9x#Wo*(qN`cH~7SvT-&&m#wSSU)uH
z=ma{UB_`XJ_aFu5?En}0{e-Ze<|qR!7p=2LWg7-T>L)&*U4ub_T|ZM7xUZme!vGlY
znpFIUG_<y4BL>ajt@>x+8=fOJ%@pcM{XF$`gE@%Bu}~5c<eldb9@RI_dX_%RCf6^a
zOy>yql$DNsEr+*&)}G)|{{eI$onnvRqD2SbVlZE2SDip=2Unp&*zdlK)ft3y8a%@%
z;AMN4!4r;aWeW<vqjXaiAFbB8g}R7Lt~HKcr|cDcikZ$BuPpTbfHHnrYCrwF+#}2e
z4MB!u&a^pV;Zq6U1($h_2j=W!<`<G8&-jxvN|Wt+!@N>y_j*(uY%30usUtgH7zd!~
z<i2(kPIZvXq+!k_u?zdtg5(zP$~9U)B=pxQ#&#46^?^gRac>qAJ|&0p9SY{^B9Erk
z@t6YJV~!q$!dGF1*(Ebpr?agPfq7P~tmE2vMZrmwj}X^j{F7TzhHO?0EAj>LD0m+Z
zx$H)*^1e27l;pWzKFF;!8?J%ywHDH>ozd0w#KXM!g>MaR#ZIeRD5|e~2C$+!?kHR(
znRF#(N^W!7td9q2`4@)#$)**+aGMamvo?zo{z75tp{_Ay+rxh4*`eOJji5oqnR*hI
zuv!Wmzzx^Hr3#eXfL>_qgvrW1;Ww-cPWl}T4)bXWAu-IpFEEuiP?O~lFW#8B-<RGL
zsu(PahKy8$`v7G_wqO!|MY!NuIj-10pN57@6-zac(zuvdzPxDY*Q18XieEYTbI(zK
zh7Y7Q-6tDATjV7gnW(njsZ{*Zp2n!y%q@42DAREyGL#s0rE2~DS%>^ae*w45B&`KA
zR9wY=0R}IY7f25hONMa=lNk@^{1vlrv7%<=g+Hny(ozNNa@0l^PL^B;!xPlr=re$>
z`D;#Q>1<|Z-4<iH)w()mbTn>jzCMYrvLQ(}g-xt;iY}qH6;2($j}`Qpty8Q4k;n$a
z)oaR)^L{+9qEvdDOQ4Twma}zXibY_n=c3@aI8oT%BXH6_X5FrBj&7snd5YuuE@KmB
z{`v>V*aN>A_<yz80U1F5|NVBwOMFyzhIl}?2d)fy9rwug_j6P3?Z{C^Op-~lMRpKq
zns8(ZaBv(O_;x72l_DF`6qq+hOBku5LdJBjb#Dyf#ir%Cg3UjkemrtdJbzBI0zHt1
zf=-e#y7W4QJhmu8zEWRt>;`xiF^30wi2WqK;N*UL3Gj<_<-Ahg30$5K-Yp!~S)Z;%
zBbMvu{Xp4~^rran^?x{S1zg+$$pM02mH)6fGT4p0wZWY1IbNIRzPf*cmx>M<fA%WA
zrM^Nw^FM)4_kDk>f1+|U{OIQn>QU@?a)sZrKl4-Ex{CV!h5b#rO^DbTenKwfr*>Qa
zN=847-iC+Cn48@e1!)%lkUdxX_n}6i_xBI!x%?ep&d9<e52as-b2`U~am<f<<oDVk
zqT{yfes8%ylz&YS#y!vIjzRC#;mN)+@89ebRNknM&+T3Q>0YrftT*W6{+BD#Z}BfG
zJ(8cl-`<Dn&bdD{gVXuBGp#qBD4U_uq&B`uYuA}Ko-`+PB-bD5jy{_5yoqdA|L=1V
zMErkakF4YrYZ(;@v=R5?@0)-24{nB@!LiFmbi^>Pk^l+NG!3HaW?Q2Q%S^0~*V&=h
z{A%cW#o2#=Iv8{$bVh@V4_h@^G2mYX2A))_M8f$nWzCV~i$=fI7pBwKY-GA~{T_0i
zr?Z@o>v<*&na?OH&&EnKzrPG3#VIEa8;n3mkWhnHEgQU&4bd6q6l#{N8tf#LB6<D#
zZqu?ALHtG>{;)A=Y6XNy->x|o)g~<wfrS}fdT4q<(zN{QXJ>Y)R}zyFKNt4Y8CMvm
zK}#eFHBuXP$i11HEzMq73QEW3SH3-`)tp*VC}Xp#FdR*l)DLX7sYcNaW)s7g02mCP
zG$aMR@DDUR$*@T)g}5sQvX4fBgI7iKX{U$(cC<=SqZE%$EKX%4M!;NU1I)mYDiM4T
zJ&K9?Pt+%;IwUz`N>p!`lWtJmillc>#b`;i^j;zdM^$M@XwEnw!An8oVo7NrNI>7H
zWgLs{a|1X~S{=32Wsm)-Vg<zGN4$tn4SKyFM<^8tAdTLAJSXoUan0Hanyonl4*Gn3
zB_+CxM`DmaG>f|kSnM);>vzkJ@|Ox7{heJbyQQ+BUtQ99<s{f=l&QbL&MK3229bNh
z_RL!*{&t(CYG!A=xSXRo!1zk32gPU6#v0EJiKk^qVbG{0VYmaXje~Is)Xmx7d8hAf
zbd2~SZ^%O{ZQ_hm-IRW<hUzSTk{tqxa4^izR=`uQn3j7V=t`B5nbcKBHUt-ja-3Ss
z+n-%mw;9G$x-&1<U*Ir5Dsv;GcTSy)L&7nmSx({58)%GO)_p|phTyOlD9v#&vEFCm
zefb0!i}Do6h!aPdJ04mcWpw<VdN8ds*rW;1rj_QtbmKg@U6)#7v<cy5-_4y+7`+kT
z;%gs2Ux;HGVS}{&Wvw)qxt<id-1N-qQv6i%YbGs_q;R#5JJ&gaGv0*-I(n?S*4TBt
z8jV*{_bIfa4G@@z(^hLt>9GC28YzLSPEv2^@`1H>jUXa1#D7FSy2}aLYOXtagajv}
zpBQk1>V;wwrD7wJt|Uk$tP6);6`8;M$_;dp1)2T2;7Nr<D)iRBiuPuKMli$<*t=Z3
zF0VKkDo<<wdD}XV#sIAz28Q&)pE=On_1pVP3c)V=g+zW4A#bXAX1<E2gZ)=zZ)&gN
zh@iEKT2|;wsG%Wu5PcatwB&SSu7Mu|7Q^^=^oL!T*`F~~O3wQO_Yq@Ge*NDZC{Y9~
zDgbvG#U-m_v1#WY3$dkNrf&vsx}lq8R$^@Vqh70#R@Twz@XHtMn@`;rQ7Hi+{{vz`
zoxdmcMzloWX2eP5NOUpm;5izyjEe?30<xSabl!2w7WaVlekFeB@-GdL^(`8X+J3Yl
z+fnQAxQs4cec6_v&-RxMSwXo<E1jsZ?6cyQquJl%Hl1M@3K&wBJI0V>c0Z_9wme@9
z`khtQw81yR;}3^&7Z#z4H8PXsKV>%)*sclujnqQI8G?3^={5*#CAEvZz7Ukfy@-P(
z#tX`)NPW7%d!$xc1jY!OC+GxOj!=Hxgr{lMNrK+;q7h9N6f5X`L6px2g5ZVhg5DOC
zA}B=A1VO>HE0pvx>hA(UeuB(iv`q6er!P~)Oy;F5q6V6_c?tP~p!H<vqWK(h$|D2n
z^Ks@4%bAy)mkMg}Hl0b$_7QZ=DR4V&OQ<0K|EVn#G+NMjK~aLX(x%lDHdqC&2^3gO
zRg_U~TMU84bgoa5Z6)C^gkK4INb6pt`JV{$Xm_MOKce;xP=o+MHz>s-@~WT|d&xFY
zP#uNZPG@SSAnL|x3cA?K?w+IR<#Y}xdLJdyLYeL)uYR&EpzWY*IZUSe$@Evk&16tb
zdvt)--A#QRdQ%`BKsuFlC&mbxD`=b-8uLtg*~{~Io-!Zh<=$FN{{RL-n27)Z00000
z0002Xi2wiq00001000000001ZoXvfCd{ozUu-?0KuC7MAW=1PWgFxVo5#T+Hz)pgJ
z5nwy<GGei_*du{=7>T8hut(U$StVgRyJTmp+X`@!wn+q8+r+|--F!_VjFU8ND!inP
z(;%|^;^fPBmiyj}m=SjR*Jl#Vd+*+N*R!8<&wJ{jq9Q0VMc;6WiX6vzt)iTM@TN!}
zwCJK){&SrcxAN+l&m1oBuN3_W6e!4+@_*o$&iW^(-&qGVTS2z8P!)H!EBCCWj(_VE
zs9dO(LZ$p}V78931+)Iic^90b68~K_z0lDP=w;ws2Ci8Mj@pw3SDR2M94>ML&KUl2
zQ}{<|lK`dHfuZ_I2<UDo#>)uR(n<R3Kn>N_69Bpsg4&5=OIL!ULnfV!#iFi8P?_2N
zuc{ny!&s#X%7?*u6O?b{zr!hfwJQ|HmK^MLh`X9|984D!zX>07!5kV!8iz5&BMNT=
z^N;w>HVES#^g#H#c(;Pz57FRWhDsXTAhgqD2C<DJ5Yi46nKb{c!57qSM;drBr-78T
zu$lf0LW$nYO*uTWS8&yq(iFj63r<Hg9*cpySgSiHq#e_mI})Yay-rWjpAq^~3u-`m
zxD_jO48fc92k~OJS98iO%Uiea)Z@B^xJ_3-%&P;mZ%^{&{4~G_Hqi@FuCNIfPz8B3
z&px^We^<B{*6=t0=qJGyTI}SgQfv0T7QA#e!WC+F+Pye$KtHdiS6bS^SqrKgoE-v0
zp^)AJEov8yZGVU%D#h!tgm-ODlJ?MLsM+oTnR5;P3Fv!pRUa<^GOy0}r(Uja0Jk3N
zm4kb=KE%(QCuwi*!-ru|YYM#o*E~{O@;TUzs|R2%&vgKrX8i8kD69LWbR7FpcjKih
zcS3nckz}NZ@T87_=HHDtd<W)cpxJc5-2cQUozP6v?Sf{xL+I@?%e~7%>@UJKl)JD7
znlsSkURmP<$OJecw<T{PnFvmV=U_%bA;Llx_l`Is!*~FJ0T<zhm^Q-<7n<Rm7FWg-
z)TS3IXd!b7TBM*muYlGmpw&*3f>P}ykyJz-x3vZVKB(2UWWo9c8;VLn*NlQ7u41Lb
z0Pn~TL%-5#`Qg8W@3ml5%4DESh7(CbEnX2uf;OEF|I*)LO=w*rJ(TgDs$lx?QAA)|
z$X<br^4tae^%CrJd=lK7p<L}w(!xe?S-X!P#{~^T<#qxKUR%bN6v0J0gK$xWIIOk0
z2SHg?rg-f1*EJb|krZymK4|1k`I_CFZO=1-s3Q0|j4klv01~z!|GJljysOJYv`ng#
zr+ewx5p9UB)^U5)BSMQzOz_tUnM5=eOUmr(b7%J?feQrpL;YO@Z)OPsOpupl*wT^B
z_V=*aXAYT-vQX`2B8o#)J5NEiU1tJFRWc!cgl6<n&E!0U<h*(vgf4*Ujo|h`^;d`j
z4w)|ew~>ftCh9tQ@cgqXW<~3W0k~hnE_O2~3Wsx$E}rE?`=Cs{a~#|VBP=ACUV)`s
z^jn!C(&g$NzN?yXS25$RgxXhFqe9&s_wE?=GBov`ae1Z{Qr#BS6DQD6O^(OeEMqI1
zF&URvq6}AJp;-cDZ-Rxbv~AsXi2H?RQ?ob+eYMc8J7f4Cb-8;4+8Inv`f%akmIs=^
zxf1sm0_Udkd4j_An}pys%)~RacI}~1gf^L`dcty`2Z;kDAQXql5QG*J%dzCE2ckU9
zDyZ5ALAv}3RINyHjS7$JcMcKuV;4<HGsR==$sqR&-A`QEOb?s&cEsI?;L0?duwblq
z5AsGeFzN^^byS&CfI|PXLli#5QUR=BZqKW;8ely*W*NX$yvfXU^;-HZ08Xzu%*5R7
zwI->%r%&sF`;Xm-6r!7<NlzHw;5fojxh7QM-LC9|Qo6c<S$3r`;1tUTaVGl6?pKH;
z!Bu*grYc<l&V^<y7SG?6uemsk3<P(9b9Y+ygz?VAeDHHrWW-D|P~AD0r7x$5Jp^1V
z-hjI!)II2n4ygdbt@>sWLghUvo<f=T(g0G64FrCnT7JZvyU*J~;kF;Lh@@30k?nGV
zx-`d`eW_7s{uJ%K&R|FLv7a3yGyCZrWs;zVgevS{c2<H^c98ZvF=0uxnJ2KWhjdK4
z^FvhSLTqkl=8WceuGjHgae+?Z1gjYp&tuw8>+d9~j#k&jaw<{h8Y@A`y$EGvXEchv
z{X*ZBzd%24V+0K%<JFhr()W7Q5E+(2zyjjVT{vRA#{qwQBQua!+S2+IF2_eUW_ier
z?LMp-c1fhIfMQciVwuuUL!3nA7*r#F-2w42h{W+RuOCUe`@`5r6<nNvx^-~z8Ys!o
zMeqRBy&E)9w)J*!yDa&5Zit{h9c2W(JqDHPZM@;Ih>L}*yC?w&&JW=0<<Pbpf~)B7
zl@rilq7YgK4ci&L0wEGMQwaZB^`W?jk`6SG<b3pu8rbH8L{5}C$H{0jp{Edruhgp3
zUFF2%X_L1eAFkx}kQGsT5DYFN@|3`}*#nS)ijM<qW4XOvWZ0%5TIcdOEG9CYkWEYR
zoMh^%WYEq^ottFJ<*bAfqyp`+gb>f`)9#`OuYkqsib1&|Ufa!3Nw@BgxN$e$mEtK1
z*&5P=<N6rO6ajsZ295G&soH|PRn1REqaKC+#@?|IzJkL0RiM8I>N@SVH>mAqgtwq$
z0@hB#Y8iX2C>iwDLNlq8hy|??D+Z`gQUpI7m?o*p)%Bh@Up6EysH1zQ2%}b*DLsbU
zopdj#C)y;mG$S)ZZpXKAR*4!I$#<~q<Km+Zy_Gi<vGK61g+?T$!ZfTE!p3(KI1Cau
zmZ7B83(J-h=h0I#1GSo|;iQb(JYQ&q<2;di+q*0;s1DtYl$tn!TIdweW)2%)q_2?K
zFuzT+OhQt~N+h8F0nV}lWd6rN|6S*=@JH=L`9H$EL$$_8mQd^TaWhKgxLK>f*<yu{
z8M5D34C^nZfkZ#1(+wmECvsT!gUr9Qur3#2LmpqlJNYi&<0$C3T*jE7;<7rbK4CIU
z+;5+RCG^Szu!Jbiijc<&-EpSI<G6U6P^$T5KjCt1h|4Fa+{w{3_~{huviy`lV<UkK
z1K9g;Vy$jlEsr%W1g}*TUxM*gvsRNBLMrQTz+H{FgDNXuY%L%&{?TQTOqFJ!UiD7W
zRgA9UbQPzoG+iaRlq8PRA^9&%i!vol1!Z+dEgdw2f}CTFAj)0Z2-Rv2-u(}W9w8)!
z)x@T}3ly3fWlrmKT5mjZ)IBH6x=FxotAUm@s&7$IT^lyQ9J=~<totxSIc`~l2sVP#
z!%Y4INJ0qri+4fURd}}nkvs&&i*X-WE5}Dyc%15}m^t(`g2R4bPEq3PBn}JU>Q6|`
z2sm5Rttt1i8l2>uLek9lOBp~NoE3Be>iEzNi$q$-M(QVUn)Oges>7afs51|PdpC*K
z?q#HL?j%W9ZJpwQs}!jNtzjKA(Gird2J{|cuGmT$LS8`K?Ox%eOpQ+Bf?+9^oAop9
z-PVu`c?0}n6Ah5)b0tbQ>l32CAc<cd6=6ZG68IzO;6NCb<4|hif(Z0zQ>Z~!i?qA0
zZm6+hCUGnTw#7mOaT?*Y$RMOJ-ppGPMEowd@+~c8u?O3v$|%&`%G8~7RTGP{)T`AU
zDekLSI>!gMp&&()(W>dVJjG?k)*5&pQIsJD(QrRRIsk^m%CelyQ{6mBl&C|Rz_Zz5
z7ScuCxGHanPPBS^h)dF8VhCVlUzkHO;3#q8Li)_V`!9hzk1Zk{<G2sgZ{XFJ3-{M_
z)|Y<uzj^7mGY7et-mD>VJ%^s?=jpvvf%pDzUS}bh*Y)_;q1k#HK{1lye%hM$NQ~En
z=2qejt^wy_!u}61_&D1NAk;xI0Ff2J=`PU87w7v^Djon}K})ke(aH^7409;9vZ()6
zCKQfva_0(Ab8!5u;`Aj8wElHzJ!p+&PDg<{|0H!PW-FiYO;~AgZYxmX|72}k&W&tf
zB7SD}SsWt^Tdhoil^L-q;qoJcXr3&@B>g2Bflx=<XKJ(-?l7E7J7HC_QMqa%W2RgR
z0_U|kH9rdhRUL8R+{o{G3vK)>**z)gO()?}Te(}V))ro;fwmkg=i^LRoW~2)d%VrD
z3YF;y>9`&?>x7UeWQJzGooz2(KVaK?S*m1s?Oe0Kv@*A--N(iT&}6e%Cz20I!scEp
z1+gvjt;{go9tgdOIC=N5XDpc%=`b}&l4GMu6@cF_Eo6GDC!xYLQ{_wJ$cBjN^=fr>
z)W2^1|M3cW()y@Ym#1gZx*tAAboX*(t<EP<VO)vi0UBwQMrmuhO-GIyfS@HBE6~gr
zxEWg1bUx($vtO8Bc8tsPL_WBdv-#^uQo}R3dN>=yJYnuI;}si|9u@dV3J7(-;kzDD
z)Q<~7+|P7}XjvHw`06V=;$Rqzo+^uT5i$14ZlNd3`3Xt(!5&=bFYm~Rc@!%X&}|H3
z4-PcabqBJ>gF9H~3+I^CA7k!Vi2`(&RrK%i6#Z*Oc2VCcbF?|+UJ}l#{U|-45K%fJ
z#xPYfLXbQa!?CG{QR(;lnBYEE<n{4x=_5vch&rKuSSEYyrr9p^Tb>nJ$WaG)8!JA|
zr*Miv_dLhb<~Erm83<ZK$5~r-)UuHR*z=rhaQ@E!V78tA@5Qw9<;%c156WK#7cT^f
z4S^{tV*9{cinl}7@-NaNB7e@hqCDtW*<Twg7U?zK(!R}F0!bc0A&&Mx)CpC~S>$x|
zg$1VZY>dr9;%U?4B6DeR9++H1jqesIxd!DE{4M<eI2#JI_~RI3Mg44S@!zGqZnpB1
zv8*I;B%!;VBti&V;#~_TWvAGAR<21zET<CM)C=&p;S}72KaE_{NG0T++l0RhahFlj
zCjV2b<uIK|GAO@Gn9HAd=4tN5y@Y%oYOuiM-oJzgM;qjf78v~ClG#bZBTKT3sty@d
z#F8FUP(=B-)UH&&y8bV;s7wkcQ9;~Ut^RzjwJYO#I{V15^2_TpS<4Ecf{S~h3st^S
z{pR{aJf3zd@`m@=61HkCLs~L)E%{*nD;8(;Ma~!2Q*qSu%hW^HI%gv7Awk+q9$^?{
zq^)Dp@Ctzdla}}9x6tFY;DhD`(!vP0!0syb3vQtkTll=R5Xxy`7>a#(B2+3v%}`pp
zPg+WARg$3f_#QTMuBaK2Ps6!)Lk;2Ur&*Y9>=rS82X{nHkce0u?2`!ZQ#Z<@k#|F^
z9cmL0OF%722hVS1gQa^w43>XGNFPE*6?}@WHnMtIt%503>H3l|?_2o0n=Jr14OD9J
z<uJ^<2RHFgH)pWoA5jaP_Yhv}9!Gd7qep2WrNIo<AHY{|-}eks!6~WY>WAprZc{UW
z*MEShdhupiYKWF&%O#FSbON|%Z=zr1E4)abB<syOzERut1}x&WRUeF6$NL!KmKh-*
znc9DChPSKk*f_$-?_-4&(;r?yQd5n<&S9bq5oo&>7EZ&00cg7qR^ALjbytRgo~VXS
zlbVVeUE_6tdK(f*@<FLy6k>y9187UaLW6i=?q_^ifQz*fwLmiVE$Fh3g%!@cO|qGX
z!v(JBfS^1l?{qK$E4sZ0E40%I!4G#V_gg`RD6(Nl%^4*4P`i^M-YF5zHbQ7SIX=2V
zj&Epjpi7&j;9gJTiY<mN6^!F$Z*qB@K@n8R7=&NqYyCl}KLB0gpDtdF0KAlql3hu$
z?9l25#vs-So0D?GJ`e`L&19Q#V@zwX&IO%tLsD*}4h`@ITPKuTCv?_2f-MM9j4$NC
z2uwh$D#<`t?U`VQPG={yu7}7f2z9~yEikVWLaU&46U=)6=C6Ty0|a(^L(qzpX5M-T
zu7>KHVE+3dxDKkZl6e;d*YXNiqe2uUKTB7Hc{i@MuQHGzUge%kptJKYc*wY?UnD9`
z)+qJXF<ahRlVgCDiC4Re=;2QLaMV6L_bd-tVN^@T-32wcCR=01Mi!`@CQi<3GhP4*
zjx5e<S|7&IZQ*EwxmUAuhDZ>*2_I#i9wR04X_oX^61V|MmVk2**;y+&?3CWYctUCh
z#ZAoZ7Ju4uwuzEAyvc(@@}OQ+fcboBX|7hC*4;zLW>dhA_*K(T(*fabsM*29o4m^I
zkkDg7mfjw_8>2(V%|Uh}2AjwVN{Y%oK(t%=_>m!#3F+~{W^k4i6wSXkv*VE8aY#C@
z&hOY99GX6(<Llw3zqI3@&g?kicN~$9Lj^mY(Jyk%?MO~lsRK9Wbx$A=7Fs(OoTUZF
z@Xci`WEN0L4qxbtPjv%nia@Hn54^Y^=c06!Oki&ph!tCh>XNHlMKL`=JDqd`c`ZNa
z>&}Bv*Uc^e&~Ld!FB97!@>~M60rpr)>_GJaa5k~9byfDM+J$`TVy{4@M|39p!bAML
zz`Q>;-;=NM<?DZql1S2o+jnD9q-v3)J-hkW!#$_%<@;v38oMMWLT+8MWu8&oG^4nc
zm9wnn{i6iy<AjtQL&FUB4D=b_S)}wMA=3WMK1NJe_i^-7L<CV%tzgjdD)Bt<?V%ae
z%SD}vxlIBK_`&y~N(=#{!2MN797;9A5ZWnP+_}_I2<uie)eDJ)!dtzVdn0%i+dtoO
zWKi~&=2+e%y!`?mGpQpD-D0g;%XLVC4EKoCwubA3rB2PvIxXE&NBSl4rXDF#whk!^
zH9cb3kalQ>ksg_$JfYDxTbXOEKVWQUPPS!gC%O%4_tK+J(Id-)aq*%evo(9#a4&EA
z0xPrK@2`LPZP4%uQ4;Qx6>P98SS~AA>Nn0~I=4s0B%>r!tyEbGBBa}~ef{HDu#19G
zA`rcYZJ+{|kI~qqWg1(vxAe#_@pj(KoxoMDQB4V`SKAU0eh(FH=h206(%AUV@n#?2
zR6@;8Zk>eQkOjEMYGID9z>7UL%xqL(Xq&9?6EwsgtP+6*3Z=;kbrT6Phr_&kw0iXR
zTvdvKrnseW@N<zfM|XM;MsX7L(A)=gqSQWy+fxsXJ8{H2xg3Rfl!zKp%$>Ujn(Rwq
zY9<2b?}7%enN~Z#^O0UQuOc+V*UrZ|w%o@!CyRG5%$v24>=Pvk*)9~HNE#%(4@2`I
zXgCOwgRqc%@wmw15b9xg$U$uanOZ?a6xwSAx~QPm>OqL`*Gx~JeqNB?B7`ABQr|w-
zw@<|ch1H4v43BVur^qC;$lNE0#|W)%K#@S~5XU@kFUK7G{W}W;Sa3vDCSVDJ`k!Wp
zX@gR?B*}=e71cde7t`IUY{YcXlTC4a(k5ni^#yh|t0($XC^iR2K`qwP1$-~hMm@SZ
zl2`WY82g=yIgZ7tV(*4a)=8JuWt3^E67sM|1X9+~9o9k#)#p;6!U58B+mY6nX!UA;
z0xEnBjGVKm(U<7;Z}{N@`46cx0`&-8lJR2>udlfWF4OF>!hTE5;2Z413zTe1K?8?g
z?KDxdM<^t{^1H&Xut9MG%MTSUCxTOdmU1S@r)Dp=6P&et9y4MSE>yaXQMv9cz0>IH
zQ&5{JTxDfZp2=l-5u02}^tJibJGpu$xB6<Y`YiiLTh>TesrtqQFGfL=@rv9gCG6kL
zd#@wEo6BFP8z!d=COgM?$y&&P_k{FOS)dPpYX!E(m^KGcXHDW8@0cBWX4{HRA@FC}
zNGeA`t$CKMpejN)ego%F)k*5>MB$2d+oMmA+WuW;H6^I<7p%*&%UQ<tdH_tcJ9?J)
z+5C2va<XwPNI~ma=FLMmOA}1b&r;4nc9!xsyq$lRa%R=9*Z<j<h!jK8$O0yY^^O*<
zcY(kdR&d*9fg)P%mK4Qzw-Quh%>|9KESldKh0Dycti)#~*``1&Cy+Qh>@hntWaK%{
zLQjc)rf}s;@is95=Ms9&(m8>}ycDz$sXdIkA<DUKehAkueZ7lWq1z75jwIA}$X$X(
zC8ChwZBW<Giiw!u`fyJ|P<12Jycep-3gj}WY`~jc2^PN=p$IbXc{uNSsOg3CmczWA
zP`MhK*N`MNZyhwg--_%J*p`HONvPaQZG>SBu@<utiu<7QT_k{6#lSmcAposN3T@$w
zbv87<gTaUk>iG?YEL1h*1jmz>wm*AMk&K-oiA|t|+{ccsGKv`?OM$AMj79;}T`@Lj
zY;kPx!wTLi3d~4St%ZgH$6$^6`d$j*P}OFNM;O4_EyVU>>?sJ_XT4VVyA1-L2le&b
z!IYb&<Tbg+8F6d!_UT`i<=VMf0dsK1Zp&bPsIXs^%nbR;?2q1fQ%}E6Q$K#=P5s9*
z$2$z<uESNlxt5~4WlJC64O9A{9?{);3Q8j2bkUllIxF#WYEMQFVxhGImB$K*TYoxp
zFg*l06X0~ZZeHbm7y84gJH&M<;F!Wh22h-8$)D;6F3fE`!LP7e_+-KA2XZV1#}m+u
z`W(l}^L)Ihd=B9n6E8W*=^tT23Q0Jph=ZT*z#laR*U?WB_7DLfOVnZOWOyEzYv?qC
zkV3`0Sb|zp2$i+TI5ets0-hkkpl^h>QRtD*t}bF3dIzERh+CB()5(GQbC!W~mFK~t
zQIXQL!s>m`K!{YXl{uDIJ|hNnjoa6<QLL)BFtP}ecI$C#;3Vt3;`)IJeXVsN6lKrc
zq`*IjMlo~S$TnYv3Rra)RCabk)oQ5R2-UYj)vZvu9;)7rBXJkii<2&zD0B|(6Cp>7
zk)eakl;kWJvQ~yiLMKeO>E=O7kc2kvM#AtszXlK6G#6Qa;ML(;d>Pfg2LVtE-K={;
z$4%dikc4R_B<>EFHwvy<t9wj`S;tJ)vu|KE>O#|~UN)WhZv*~+tLgRs?POSR2Vf3q
z#T`dzn5O#x)>_Z?v-O0a966(1=VdcdC_v#@tq+)UO((#QVeZ@U^((z2Y~l*3#LKS}
zbsKe@GzG;Xxtr=IA2I{Qg+ywP+{y+zBD$Asg{b)x!311_w~NgLT!aAqdALaJVjxdJ
z@di=9?gnxQ)NpkFGx%Ex?t0x54#^?FT>zKShPE{#pJ~_vsEQ?#1f!4|QPr6(c)5*K
zuLlq)2|^mv5;QZ!Tq&U4g&}*~!K{~nP6?@r=+LdW`2mgSv&lC_&wScYxcW_0T_s1<
zIphIu#~NDQ=%^($436g~6S8V`EI@sRf3IM+59bMDHwZSfM_G^>(Rho8&B!onY`pLb
zzU^DA=_)iS=K05=lHh#P*3)vphIWKp@s7GW19uX9PO^`d13^FMw^GCMhik}${<3{~
zT*CVGCjXuUjZhjcQ6JoE#!>xM4eoO1{!=nub*#vN3^fx-$<Wi@(BH?j1slKeIGmS;
z`jG;C^9(oF%1UVUiM^Ac&0?_*sqYs}oPEU*(r&kKxz8VNPQwqX_wCI<xk@rE7ct>b
zh|Ha9z+J&ziUF8$cO>h7kMjxFN{jTaUM&^$&CG}vWuSi0#ziAB?Hy#f(N+H!m*UO5
zi9(kfc@{T~VSkU29gBcxG-9JnyVxeg)XjZ!4VHY?7Mvgm<;R=Zu}6)ukGwcTNJ6Bi
zk|J0)+xil78PEr2zK7EZ{g~>m!m=$ynBBM3i1>JBt0YxcCJ=*CNsjNnz_IZ5yBY9C
zd|09$)LoNy&qrqNIm_21!>am3_SD577(~u7Hoa=Kh6hkQ!ZQIHBCv{A=lH#86#A-H
zbB8uiK4_whfYnJ^>jYG%y<Of^8-jKuS5=+Rz7}c{bWwAoUH!M3IIhvC4e`ARf7KrH
zd(v3ov~;f3IbuBykZg)zQ_J11;!O>rR{Q`jkxL^w;T>?IC2`C1L!hdC@>xGhai8@A
z6eCo>mJQVw2Co!;Le5C$H!a;TZ@;*u)gCcFGI7Uodxk?KR^7L<5G|&-b#jz<80JX~
z+Oc5|^TmMQI3oa0j=MCHZ1o&6{yi}Wx3YNMh>WWA3KCWX8<-f&VJGdL7ZyY2Gf;Oq
z({4I{S(RS75~a{SimWu7E%)x?^RaLx-Yjc}YZK7Am}&pDRx($r!d>7@^U<OOX_m!Z
z6>`WSwUvW=-ScUeuN`Eq1lzmJYgpBc9VgGtl@6T0XPgdQ?&7%!*53*4!<wb<iyUse
zg&Tj`wCCJ?$pX>V>BoHt6REN1$n=mpxOYsmN~NAEa@<gU=u9JbNOS?x;Cu)t^f@~H
zN2kTzZ|T8^jt!!$$7)X>MA$$~0SJwsBx>V%qk6&p9bYyH1*?-ETDtRvA@z1!tNCFl
z#n;Pj5sTxGQF7zOrKnUlPLqA#bOXu8-nsK`QZHNzc~|cmV+z0r^3RB?QF|u1r7Eu_
ztbf1<<}x*k#GP7YqCzmJN(bd8F65R(+J``$z@e!%v?R3*9rdbYf+Y4j)th1<A)$A{
zPH;a1_1l?71_r6TMD3ac?=*Ulk2Qs*n4t2s9<U&9_VF@ZC={OE49o>i>kMhC4IY7>
zBV$tf8&<vRo~GcDvMC(i=l06@>`|JFgb2;?mVC%6Y6pEzPb~zFL)BAw*P&A=2##v9
zU)Nhp{xJ_>e*%0wY%xpHWMck<(5E|+D3jFC(Iq)F#;)KFsQWttz%K11wVLCYA&z$t
zR(F{kb9P&qDDxr1N!~CPa|?w*J;df>Ib9Zm(igx@L6e~a6sj`qARH#+xV+`+scmTw
zL*$HnNCa0JXdhfizj4dg%neM>2StIvhQ1V`)5hQ3mUzQ0+?U&eqn?V;6jhRuGCHW!
zan|{+MG~+(0nQz$G1Ju;lHr6N*Xp(egQL>NPEsEi`jG47u1xyuD|4S8y%vY2(QJfs
za0_0J_(#VQr+N1(cjWkkR)~_;C6T+^Q*4dPx(HCqJZhn3RG-qS&!PPtVq;0Zvv%Yh
zj?elYuoP=-{1b~9Nl$qR=tmBMs<iYCQ8I|Xn@?*q2~OA~qR9gD`xwOw(n;ZIJC~P`
zh<|dsgbsP}gGDn>NJ|iOnO0xei*OpL^^bW69XkHSHU;(1MUIEs>feyYC~*ZlD8L6-
z(P?88_sFC9DNqp(9|*f``8gG0d`_qfoW<e-ra`4;P}&O~>m?^hw*XD0T?>5;Yh|f|
zbAJ9@Nkf4vq~t^qxmhX)?U9jTn~?x1J<YSC$l7b332Blh>guL_S`VTKD5Ong0=kZB
zF@w>B94h(R-jNW~o`60Hb7^gG(T4jH1s1KHC4!eq9H?E5&0hj@)y@fk&JZ^Y`e`Cg
z%t}xSFg*9)@Gwe|JF7*pXo}M%ygi*we!$0A7K{z4JEoZS7GOZ%x*%(08RBI%<5@Jx
zAVJM|v7b3=9=Ol@aDilIevP>6#ym+_K$C?47970rqCOVlbjl6q$BZrU^knPd?14Hu
zU(yje4R6Eys8&C{IU(_E-YD4kp!wK%!iKDUaz@BnB1!N4<mM#DzvTqO1`uv$4}qgU
zbiVEr(L&K}->9bOHX9ikf~Y#(@8ph)Q_94d1(eE}6t&+G`O`fD`ok=|(CJ|Je6bS2
z`56fee^6AfeNav8eZ>&#+Sz~Wyk9ow)f|IG%egJ~`*uMM-*xjGC-jSK_b#4>HmOuB
zm5R@(Bry16SZdV~XOf`4-Mce2bX<-C^5>)Mi);B*e?rz$aB!^9T7LJ;wH(pv3C9BM
z5Ewen-630n)Zi@zmiRO+@rVF}HJUu18}GT#lFeiGWNT5@wlgzm`aOC)22NdpE<R9m
z7Q2jzgq}CuXE&?BLd~%o)227ihSP!nx@TB&_E}5L1s-|Ix8$6~Mw7M7^v$r+6t=$P
zzR{CgAOH2{{p<7p_RVM=>vIIF`6?|<*9mSslasIj8O0m{*EtNXM>q>d7wZaz%|CzC
zp4~G;=@$s#WyPOFx!^{}v&oWynh>F40ICIeIYN3XRG8IxyH&?*hN#>l28kg(s8tO~
z7%V_aw3=ptk7Pr2iIWY=$k6c+mT9M0E~cn!irlE`VEnB@Bvl=HXowERin*X%v~M@V
zejYc?<i?eA#9#$Jf&mgb)r1IxEzFzw5%LXsp_orAzHQ8gWLJV(KUlz+{Gnn$bWm}A
zjza|kr~WZaJgj;MIb*`d6zjEz>g_Ck_)*bCY@V@hd^&b@hTr$xBKEM7gQLc-hm}z@
zh55EQW-JctiYO3YB?$)nP<&F_7n1kv>U>Yo(xN<9?&2cr%2mNk{tFl8ztHZ#P+8!G
zW%*Nyc~cpX++L1(D-@IN?YxzA8N8HpRH-aM3E)zR4u70p@#vT*O5jGkpvTD`90}!^
zjN@6U>j5b7M@BnPW=8O-7?SC%zqQH`F+wea&jfW?nI&Rn!~*E@a@ga|lTg{gdU-Xc
zKHCJ9Ysd<Xs1feY27OI%6~Uk_Cx^wU&_ZWVZDxU8NtUx3AgFdn!MT~93uMhWoBb$3
zmf>?OD<TyCN1#xmKPBP;DJEB&P77OwQYw|$LmdoAdx&MxDL5tzlN_w5dgJ)4Ty12&
zIc(<T{9{2v4<>Wyj3NKXP*N4-#z%n9;2Z+yf+-SWL)oM&DL?6oV1oo39~J4n9pFa1
zTgFtkcpJED$mxfF`Be`6LT!<`Cdzg>sZ)aLmIU$?^-o2(MjT<VX-2w{65NBFTZ&z9
z6L1MFk3?<Ix&+xQdO2NB!Yw2ejlw&N*kBasw8qU}Qvmq+^m<;SluJb-gXo+m4TZ+>
z?$ntXO1SwFdn|S4^RWWY%@N+{(KD;ptG~IIw#pplI0lCNKoWU8%|v}#;UKX4cBf$X
z5-B})Z&GLwR{W7FR1;g;FqxJVF0Vfi6JsJ(rp8$K@-nO(@e|hxGkr{0$0$^AKyNp3
z1$v!Mf(OzpDFPqw?4#8ja%3i#I%j5eDO1DTkKfS%bwn>NLnLb?7CG8;EE_3G=TCGW
zt)_a#5qa2Ef7efx%^k;?zMIqiaands3F`*V>G>G0{S`dHCM#z883J8>fX^h<(vZfP
z2YN@|T>UJuW=Zd&?NN*lKem;A=c>99s8(AT9p}fxe5hjKTCpIlhL-)Xc`q#NAV=|L
z%BO?7fU@pFT?H*qL--h!Ps75?$jT%5Mr$ONlEWc{k!nCxhD%Kg#f}inlfb$jIkg&q
z1$+i!t2m!2JKMuzP35<L!KSrVQm9_C+VWOk*J59J28HTj-c{hU1XN`g>L(GXyB_M-
zlQoePBk}3-etTY;dd+^$x@i;o8q-V8`z3U1jGb-7`n0u3C0Ri)S07ch>N>+A-p?W$
zRP$)mj`3;MQx>T{T;6%+DVT4bG92r4vm-GrLW9UWCx+GsxdT2nK4d4Swo{@TBWeCx
zL^O$v$dzO~VIe}_&;Bc$@q`;wCyPjF4N)T>+?z(V%`5mdQ-cV*cP=9>o%SDr?Z5g*
zL`T&_X4-};m`>jo(W=E-M_bkA4ZV+?T2cc=+Cv5Ow%5Q{Aj@9nT%Y;`srqFeDv)I2
zuHz7N-+(-$g_kNAoXr++C@h0gi-mhaArI5!a7YlvAQes`17U^g&YaXzCdwgySv-m|
z&2a0z77qEEcBwp=$Dl-fXprU?<eSgZMpz&JW??i<xx;+1l83nznyv?TB{bb5D&W#?
zcRrH^_04`kd-ZLHj2$6sd-9VeZq5k?iQ<9|AWk0^)iGpG44-0ipq2ad6j}QO+9o7a
z6U9)swT2C-hx#)F(M-HN)P9tq%1XH5F}Xr{;WoZ<SFzaX(i{77GiDCc5meM0cxcXy
zBd83|B}rT*)9IyK+cm<Rl)_0|&xmo8x3pep{(DbaLnR8pb=YGP^&5Z3GE6V7(FM*)
zVEZEuTVsCSFK2f%bo|#y{M|Y7cJr8A#YIp{@tr#&cX2&rcU0A<U_)LfGLfWKe}nzJ
zUS3F$8_D|!oFtOKWI&ARwG2l@kc+kIOBUrOg`~ff&9JnP(DGCN;3!mgCPCthM44a<
zz#*t6+s8Vc;sgzaa;qGX7!ukENHM_6m>!tr`24dR6C(TNe2h(&V`S!6Y05KGmQ195
z4cKP1iU`9Fs$NQzQXeDxlIr2SLo7|A@FR&QB{?b645TCTEHQ7B9RjkFkV%2ov{Ihh
zSa?+b`8Mg%+pF~y(12nEVrE|B@i*GEc01YeU6G&(kf~BtWGtf)lEBBl46QKbdQp_^
z#!)44vJdZ!(&c!v;3=GsU*yc59boh#f7bx%%L54=caj_kmV#`E*v26%HGcCbOW+hg
zG)S2>aUsX8fqq@l8J1|o99Aa^8KD1xyX7o8X_Vt(y_j|h)r*nANtO{dg`rkVIXyZ#
zC&@K_P*DeI0ZM;D)S+$ktXO<*q9NqZ^vPCV0p+u6FL2U1*Z?+WISqu}H*(KL`$1$%
zKd2?+tekHdwMU!1V>OQmj3PAT9_6x*6r1AUa=eQQ`w4wo=oaymJ_`Q{fp<*W`9e0U
z4!(JrRo~RDr}*?&U<Sq$HQ7T@vmlm~yms3L#gl>s_pk)Lpb#*8uq|sFZ3pM8gA|7r
zM?zMiPT$IOJ8L15oTidPjtD}4Cps$EY{cjx57HkSgwUMQrgzxFa&Ryj<z!61ymbNs
zoK;g&y6tatu&ZC4+12nH>5AUJpWlD=fBpVIV|K9KMc<I*KW+wR1&#UwjRPE^Bz`pP
zDSWNk-njMo=gk&n5$GUP{hre8vCFklBGV2)Il<*pRg#(!(c<c#_=d`I^`kUTh;2pW
zM^jIfItRoWS0o0wrB9#EO$9<OZ%S{`l=jgSLE5Y!o`sqm$|cmwL^^>u#mBPWQk3;C
ztnhq-x!ElzG|D1+ko`~(Q5LSRpD`{&!khX87R|MSsQZGKjiT1X`9S&x6pb=+rsGo5
ze%2C=x->?jfqEuAB9@4`Tktl`tt{#m>HJ2P9Ts_=Q2(@g=O>{#O@D>mu}Q~rNaS|M
zNxmDS_5L-^lcY^}7#dbXWCz(IbfiFZ?&s&sBmyW0&{%gO$HU7639{_?vU>GnEb_Um
zP*e>LkzW1)sJY;n^+<Nl*XourGD)Y|XG4@a;?sW0*E-ihTplcdg@2eM+D;e4O(P|7
z?2fSIF>()pnGYq`13bV+Ly~D>3WC>RdyTO)kMFJw5v&Q{297B3X20XK99bigatrEs
z30Cn);9U!@SW{D39YI2PB*M#*y_iku`wtXFT*TJCGJT5`JyFP$94p5n4riyX(f2`M
zi9Vt|8B6W9Eo&7_db~>!lIZ<7oK3!?v`JQpvma*UE+%(8zO;1BK4^6}BQ3i+#v!7b
z9Cu#+0iY5`tfJQEXVz0RSvlp6NQ|Vl7gx~D+SnWtYFC;iWSp_c^IHV>uk01CN91Uc
zZ{=1cnbU`?#=m2N=Vmf6Be(xF!}1b=(JGJg%R#+><dvVWCJkJmHSRgi$rr66p}zYb
zRHfCpE2q)Q)wkcnGEj|`I4VULq<ru;76v7K@b!>KWV6Kp5SNES4;yj?but1f^N7uo
zY&`YnB!_}f62(o9w=E^I$n*S-z%5@QI~%dRI$o!8%ONlXj4DLV6E)#FM-NcG>CfzR
zvS~3Ux$FFlJ2o3m+RwQ2FNW-!9YXk!ADT`IccB|P`m6r>Jri~sN4!&M-ct7Bohqg2
zAMmDRw`KOhCw%QnO}b=g=ll{pN)#O_MH_vOVE8v#csMEp|DlXqT<qil9ixr&kYp}{
zOA8HeKyymRAG(Ev=4V=%9t9;v0?8l{n${s%xEtIJ`XGuGMCIo&l_#PVf;p?f*%Zwb
zpeoNTwirO467bv(hkfgjMtPnRCk8WCP}Q0b7;T)P!^y5(h2XM|*Vj>H36o|Y?am~&
z^&kW;(_4=TYTUyVeS%p~kf@oe&J@Z*#L3i4)JJYlkzn#l$nkSZRj8rcdBrIi4N~$~
zLsW72b|G|h$3Dg(I%0+7ZmX9E&sU|F;Yc^s8WJ(ooiyCGq&X!LQEwuGWXK4{t6pf}
z;F4}nliD#JL8fPzSyjXe4Eu%RGolC{%*no&qHGY@8{1Hl?zs-<vWZBP*<nh2LVjL3
zxGXaCOt?W=mhgGOHmD_8up=U0op?7a*o3$3#G}gTOCxYzO!j6em_9bVcvM>7$fBr?
z7%UO8L+MnKLsqFxnj?q^A44)~k-Ln7Q|in*6P^iHW$LHzagr!EG!$5dAC&t%lY(1R
z9b(Ddj9f`loG7ELdPhvYaKNNTjNrAju2C*b=+AmN1|-0jswO#@;GJo#e&jtIfK#sS
z^2tz67>ySbQ7{n4EzbAI&9{zL*|z#e@p2;Uov`k~ZVm=5na^VN3S5JK-SoN(g<$j9
z1(wx)Cx-$gw0gGJdEVzS?)Qdgcv`obj;HZ|Ps`5`{^P4><o+1`N58CM6d#0|#aY%a
zyNj?lJTxkGpFTE2z1WIRywyFOMdb-*xLz&`aG$|y`^-LaI}mZ@&#y%37pHX1xFHc(
zEis&w>voiRSIyKo2-BXlvVD~)ge=c2^8BFC(g)6)($KOZ8(8G(Z__VZdCJDE3e{^v
zFuEoGXd3)9a@6q@Pk?F!hoF9k;0W1cn^RCe$f}-=Q!1aFAt_&BkA!$B{K>80=(=cv
z6_Tq`N8DDT9;%Nf^X;Nol+Vs0Wg=_g!jsU-dEBYV7$pf<xSVfkh)ahh43Uz2_i=au
z*&SC5705jG;RcrQ)Ey>HBrn9YDpZTWcZ*oZ{I#{GG&pxJTbz(7Hw!XT6tz17R~E6m
zWn+<d&O<qHBP%)Nr|Z=6EuMNOS99|nXyZ&XA}D5(drqr{!5*fE=g@L*%?4YVmAtqd
z7c|D3Gvl_87j>@sMt{o6WZ!Zm8$^>jDn@*gf#43T!yf~Ai+BFPMj}1NB6WG3J&O{#
zxJ_`aR{Ef0IHF=dBO8e1u9;$Wmw2Mve$=K&;Ur@kx6mV2cFOO;5u{~*OII6#g4WzV
z3Gwf?hUyh!b9LTpM&c~bAL~zJwI<r^UStt!tGkq&<=E<{9LH@7;nNLfBpdy6im;<B
zjStAeRIJM4lyw}R{j7h&9_3agxRacxhXQqIl?t)_&zwizNXCW+GiIlEoOy>JooDbw
zpxI)<e7_&bfk5;=>$$NxL+tM>_V;(B9<Vj(B}XJWa^hY}`!yVj)N&M!{v)(K2;@u&
zGb->WCmJ*|a8NA$ngp~>(LsN0rC9a2HTu3}<%i-IL=(H4@3H=TyOXt9GQ<$dw|rRT
zn`|9(Pr-&F&c@`b(S8$S%K!}(NBpsVTG^Kz`ecpzNIy|zX=nZve<DQv`gTE}h!<fj
zT7MJjGK~nwyCLvpsK1`MFEnyygmsd`j+Gr%HYTxan_$lQ(2!s!5WY-Fw2x+$n0pd}
zl_W=q8Gddb=<PfivH-7YhdN1E_+|o*gb0%<eiEisx@5kl4;#HqTli*z+W)TcQX(=f
zX!qnYUnP^Evw0Td!nLfW>8-R-UxxW)N{w{S%!bk@@0vsOdmrDVvkl~^BfsFX34tkY
zSlbe@h9p=GV8J47%YQJl+@(Y3cHe_)+%b|~%TeF$&)AOJyp9DCzTr5z+z6jkWOCpt
zgj@Oh%?<|(*j1q;EAAv*%<3O)|7UkkhysCtw;kLi(m(Ix@Y&O9@@Y8robZQ|j9u#!
zjA0eDqz=hvJDCx6i0%Y-1~k`?5Q>N|M6z>56BBfdkc>Aanu!%<ojzmhJn;9_E4HX3
zO08kr|E1V+gIa6#k8#QO$<9+Y_`JY&Wx?hd;f9>P!(CJpqgehw-<!($4pa>^^<zIf
z0OZiEk(M=z1?(f#?V5v>k2|vtway;?{d@5ql9KT74Y)n(WH5sSYJpb!TR6-$5V8TJ
zB7Fo<^+cNS{B~jrPn4$_^2^lsY>aJ0)Q`Fkf*zw~`=|hcW+ly~3@zjYosqipJKp}O
zaN?*4uphSRA4_|oypz7ILEO%P4M?|JEzG<vOHLF5*?_h{YABtiv)4jzt3bZ8$t*qi
zqf913N=VEIZG(CWLtYv3z9mP?e_EU=-Zzc*AQ63(zMBvecg;#Ez^%Y7t~w=5&Qijp
zI6677X3z^`?~|Asj{jzlJ%K=gt{@I`Z}z_M#zs4(m)7#C<038c2+ToqkPcy&@_CAY
zeg|Hyguvyx`{cAI1fdA$Afp#N{Oe}f{IOZ#v`dl)1?hzF2JZk->69&f>=*|~6h95~
zw{rlHM5rPgqU~!=dk9VjJoaXzf`l^Hfc=8T;Udv1Tc-$w%G5LW2!!~HOmd#8nzGA`
z6Q6G=0$r7+OlNjN*UGX@6kIkW2Vq3*Dj=QJ6MC*@F=tU4qTPbnk~vI##6$dRc`e({
ztl5kJ(`vo}J@k@|a#EG280`YuL?|ThPvsV&V9pCrdcQQpUmwxqV(HJ&Y=LqK1=OMK
zX#sWh>K#ciYPg1}+beg(CB#<Cw;%mb&6#%IUE+phnWYRFlI+h<tlOKuXyB>(^eLfo
zbwZ@Ea<z5#GYN;za;kx2vCCD@8$Z!7^X;!XUXJ3E+3zrzHf-|0Wn>j<>l?A&Q<`bH
zLCwEQldGZ820%(uEcZ$A>XG`qYiKyD6b&JVuO*zRx(X1W@vqX`?3T9sX{)rmh2`dw
z2`^w%j}iF&zR0o8E_1OTT^Sf>ximMq5*;_{+iI3%x977q0HRwrK%?4Ck9OOjjmIb|
zP9l?6@<P&|NrJ4eR6FtsIJ1I{5{6GyFu#20P7}-7W{TIe(b#O(FrH{OnoSSI5{Mx1
z=A>9R%GIPJ5K)z*yPFWnB$bj;SM=I`yhw`p^K+&dq+eKh=u7?M_5lkb1?4bW_>1sz
zX&OQa@rFsHi1%3$rJp?|&Ak@(+Hb?=a%2HEr>cDc$DUd^ZV_;RrpTZ5`C&6b=g=O<
zJ9~AZpj)M2FUXIp55Q`VdZZ}B4JUo!svdz*$GaUvpDcN;=#8w;pK*N<y#HwqadXEK
zeIvAw16c-{EKwW<Jq?iZu~WE|PkDXWOh8T+ql`aC81N)Ay@$SwICuub&JnJdrB5L1
zvVOG~ui4YlTpn)*bI1_Iwp+6Ci<uG_KRb9<F-GZ!1Xj=CSIX5FgvE<EP_DuVBkIl(
zm`m}9>;q=4Hd^H89(ceLEa@XMXU3FfXzalZ3ueqYhC;9snNfLq1WYfBGGwkRvExp*
zL$Uqd(fzpl+mOw)@Mk@NB0xz5LVkpBNV~l*4jpMI!CfjQ+Nx5gc*wCa=!gUA9JXpP
z>R^*XpniKNZ+$zhF{0*Y=Q_6AMN?M9;=tLCGxuhUwnC&L_5OEFnq#B_mFf!SV_)1$
z%k=)emiArshCG)Cv!2T?cCwyFZqHT!OS(x1lu0KoH4i`yWrbN0l8=&dnn<C3pFVhy
zBT{Xgu=-((MNzq}8uSQ)R-fq~7nB%tJvJCPQx#n315p6AmifXv!(?}<M%uV0fo$<|
zO7MMqQpc^tb~r1srTzEMkl0?b@?{7`Oi6L)JBxg6jYHOxKIKv52GbldN0;<zIplxW
zt%17}pqIeiH$Z)yZ7)Km)SgKzxeRE|(oo{XA0DtL;E?3k3m>TG7+fFbom`kdj{rK!
zN1PHum2P0ejQ!Yb$fnj?Zy#(DY+FEwK5=Dhl3d<qGJ|m8Ahey5fWJ{+8TU2nL4bpL
z&>XSpK*I#NCxj&HhwXQno^@B%Gr!=J5Crz9o<@j?^2s;#)iO2#^9K?n8um6Y+v($S
z^FP1>agH5!-%P3ff3kB{CF4h+q^h7%ddsjt%!kSZVlw(jp<SOpbJx$YyZ#jW#Oma0
z6O;Jhi*5!n>)3mUKdLWt^q2aFn=<A_UlKayom?6<Cn2V-Zj^!82uCkF_QMh)y^?gU
zAF@YQy>Qz{$v3gn^G%E+bylw$t9kth=wLY+$lQHmBO@EsI=08D*N{U|3_nr~S_W#3
zZ%xuWZc({duG(1`K-qz;4FNtNK9>k~x%$C71kPE~s+FN%n1&TH^jeR}d1Iw8ya>2^
z_3=YFhe#+%f~w05>7@M_%SR((Ja8w(FExfVuGFz#PUCZ*!^bFfIH|h)fjj*ti&#bM
z<-&!1uHQKW_kA*m%3Y}qOrtNIF$Pl*YKU9}RwEWxvXFHF$-*#tMk@;h1Oj2JXGjuU
z8O;%&BB4A6LYRKk?}-wqfQ_Zc+0I{{obu?{b7fvR&s;r3U%~aXx;!N*cQy@nF1syU
z@?7feOgOWoL)j62_RbU;8)<|AHQF45g~aLzY>!*@G92>1f5QYLC(Vy|sOfSy4|lT2
z&*ej+5(5U1mZRgKbFu&};bE{^n~;E_aZ-+tPfuG<HOfa7y575qTW37N!$<OFT8!#6
zD=^Dt@ktC0d2*N7&`LX*PW<+!q_8;@D_PIlA#gMSmFgE^Ay+Ah^Z5`;hy11C7ete}
z4!qBCl6-ths~a3Iz=rBq=iJD?y%^2qKi{x>$Xc+vZ5*x<#G#FG*=unev1VY4!=C~q
z>7+?lJO%ERJfYmL0>+qzl?V+}+OugsE|1dSC32Z79eDZE=L<o@2CmHBQ@@73trapg
zKI8m-s|Robv?}R|&bTb!E*kWN_FPmTO0uQMQ=@0Y2m#fg<9`B^jXZ4CESa#)9^q7r
zbUtUkmXJa9pPQ07xq6E{>Gul?8FlOwMAg6D>x|&uU7kwI3!iFrSRT7bsBqR4?R^+(
zpUoQf2a1jgst5bid=rnx`Hp9L8sEG|7T|C9;;P%lIL}PvA~9Ax+V7ZA6y{&wtZnLM
z*tNw1!qog`<}`|h$tQ1`@OMP3?>Q9Wb&zPF;QxslN#VmGNyB$IW?)E_B+W6Zfjng(
z<kLe!&Lu25lq4;+vD}W%O~1`Uk(1D*{`^-q%7z|Q-U>i&dog>fX(%SkLq`wAf<@TY
zF4Q=3N??i;1G2ljFKO-V$!wAZJ^dm_X@uoG$&gK44izEd!Fr=PN!3w^{XSBB`c&`!
zyRt&;Wjy8YH_KiICgeO0Ez`-fl3h}`I31Mw!d@aQ>V={SE5!8<XqHgM?{!Rvmf-Nu
zy+a6mTZ(;EY_@pVI_N1ebeO(WN0v;oyw@gRjy0xkqmAVQ-Osf;XXN}J7c;kd?OxVV
zOow@p{FY|r3>e@#T79@b38m^6PSU>gXul1Ga@5ZheUSF;<YY<9lBq}D>C8q8y=9=p
zA1`c4`nee?J+FHO1p8^9p3d>!S*ntToNq=G39;cfot}7?HHFjaZANLWS)?^DQzd<k
zv%@1n&(Na+C)@8o*YQ6L*FoVTCGGKKz61Q6Y_0ZKekAOJIjwZY^56fC9}`UH@9W#y
zi^eDVDC#yp6X7#CF~sxuo1Got<#d&A|KJN(La=F);h6lU@-1FA8F1+e2sY<8Jef0)
zgq;aI)X)FNKX$c*7OO*-B%~5{mrzo!5JKrb+*b)XN~tJ!h$4~>y6;pvzI0GYNm1#(
zrMsk5bpPiwGkY|Ae*e$oVRt^ydCz<1GxM7H%*^h7m~plLEE)9uvgeO;b$`$8IrFR6
z?KrT*7B_McYr#hA>UXC<&3N4R@}1Zh#pxdw>AbLES9xBzQX1WC=&$tO<M~IYhnYES
zyXK(aGbUDc?;H8b{b6cjV%2Mg=x{&0nQ`ia?(=S2cP|;76wh<N8JDuI+^+vq<)uM?
zUN5#=nR#h#{)1;1CN1r^+B&qa#aXvi(`RSLPB!Uk{%g0R@~g0}wY<{Lo6<iVS*q}G
zb>-52F&nNZE>-{F*;K_VeE9XR%z@^pNB{ngevjwB=iqrLv+m_R7`OJS>viSbb$4%$
ze)Yv>jN9bg+MenApZPetn(1jep0i^a@pe~vjye32wKB9W;lN%k8EwI!(1#~g3zpq{
z_3FKkp-Wrnl3!KbZSLGFGc}w%|ENv$@#%pNA}2RZ-!i5$%ud*F`p?w@t(5c)z9UNg
zAD{2?>euTdk5Bav$-mz1=&n<><KO+*d+q1mJ>NOUg`s*1?=~JbY(F_^PJVcs)0|iK
zCmX&l9%Gi%?d#K!@4~E?Zyt89dsXvw`s4w9a{OIwqLY6Hq#WP(_K#Q4sc2t=aL<$7
zmOeLXu*<7dZr-J2DOeVLIHvVr-JHVa-kbeA_p++}4ZioyP=CC?<W{=L!IW5yqc%5Z
ze|~)T#NL!O`FZw@AzP097a5+lR%86sMYm0C<P5uPIe)Z?J3mnQ*32p9XFQ&in3-fA
zy>8N?z22uSWN3BkALEm4@2Y!mi0AG+e&S94I+s?9Qj3jSUl+bqGClW#FPDGIXkp-&
z;Cnmv>^oCAPa$r=QiVSYWqngGM(>#$Id|4augr&z`=8cNFC6_~QT~hB`DY8`;_7Z^
z-FyFMbKuGO*8*b}slS_)fBw<iUo791Cdqc+qYrNgd~&<+P^-)FpP$U?j+fsHJ)3lR
zcApZ>AA2nyd7S){ywm1(`sOT8_00w)y0-@IJ1~6y<+f$h4jrlc`C{USJwXN^?w#w~
zv)in-FAVJmwSBsnJE3u4N<o5Z`si1$gtIBbNmDij%WaTptIb=R|M5%V^OUfU%L|@-
z%x`_)>SO+7!<j4dQkEM<1xCK_Gp$e|Upe_hZN%Xp8$NsszqRZ4=Y2ye?6{oTlW+F^
z8U1rv3A=XdvAW*sTRgkpxxaPfsq?%=UTmWgvqpc}^E`fY?thbResw)xSuuO{)389J
zGdue!T**ty8guF#d;j+j-INsOq|P?hKVIuE(6KL3lv4{2u!wgbVc28ZB;9@UYIbTA
z_{c=w+_s?C)$|WhYv1>E?)r#5d<~_&A*E`r>66;#h3THJ4)0i(ce`$8(A@PUMW06M
z<z9~nd6{*k>XClztZU6Lm0NEa#LhZDV7Xu6y|>GMd$lW^`4OT#`e5+&2JYhn&tI)O
zZuV-^)yHK!-}p~yP<k@6aLD*oS2c&ei8*iNU(jG(_4#A32jySqnw))*_WO$5xY0Ln
zEmnMYuXUqo%K86fG)G5WwM+JT|IACKY>rC(hMvDC<mGtQ7FsU$dwgT5@W$mqmkwNd
za%#_w*;LxBKOtTAMsH3o8<&5vOVZ&}E1wT|Hm0!kckKDQVeP-8H^dyCKl}5hc}6nq
zNlQvYva2rl^vY9Lo<r>#+5cYE%h32Vxk=m9Wt4aAidUYoVcs_PrW#X~)P%r_k^O}E
z=lflEQ~V*@a$&R6`eWBp3!S<PgWd|lUQbCCys}iV?9Cczt2T`r^Bm~tkN@fKYp&*9
zG5K|bYFRw(N!`)!ZJq%?htCkiv^~1>J@oL8#;cj<oPt}vs(xO)btARfrf&b-z=31e
zU5$5>s~`C!<aS}9YHztmyX$&W-HbHG)m=z^urqnR@0Z2hXU8}<oxQ4N(Vdfb&vd5J
zmmj5mQOYy)GcG@VIp3u&uZzuj&3BKl9``&NcC^bGzS+~zqwD{UoY^NsPB3HYZ|_Q3
z>a1V0VYB+^w8zSMBji@P^_MxPba8j!AESu9M{F1U{xH0^OYoLt-(*F{U+kWDU)I@<
z)qcO{*3;If(FVg$aVxwB=QSr^=^}GL!=QI{ukZ)_RXr9L_L9G`(u5aWQAx?~6|Ns%
zJuI`-Vc3P!i7YdtpAqqgsOUH0D*mlAJgWnYZQHk<@5SmBUmgE(YRmNSJ3U)0uXL5I
z806LRG)N`pz<rYyr%!~&sFuV<Ulp#8xc$Is*n|zqMi(58^hmQi+1}i9<?!ZbtG+I`
z*H5(`VWBohaABa<h^BLm)V;&OHL2%LH}&q~tNvSfT`n?o?ud+l*H>T4*!=W4@i<l3
zKE%y4XhDxB>8U?e+~*dK7$tKdz5m%;W`zR7_C-b<Z4JY1MS%v_dOG*fDwi#!G#)62
z55E{?WIbbmW=Q;;$pw?=|MFjuzb|^7-Ln@04b6-7s^$#=mgRrF)s<V^6H0cc7#6;7
z4LSTU?4@sW`0k4Cdq2C(`ekxxNz}xaPvbqiy6joG;IH?(Z{M>l{%W1-?y5HOFIVry
z@Un!(>@j-x+q!boZc{Rog$n(Pm*)I>w;}koe&ya13AST?@UE*&P;BQk?_Xb?b9mbD
zpt9QF-B~T|?%~BB*#~u7$5SR}U9DrMo2y56Tfw=!!ba11P50K6Mn9kI(<;kVzAXvt
z1%A?&QATx5DU?~T$AIEHHrNe2yZKySXTx}bzctJ1&vNx0Dt(l~t$y{tS9ZDQJpO3;
z>Wiv-*m`-lR+z*bKX`TC_C+znE%XDDU%F9VcVo6{UN!GF+I#Bz*3ZSy{$uy*btn0g
z#<R}{2Uyp1-ORRB+i!UB3-#?t&G@5cY&XNe+E=I4<_z5~^CY0W+_U+PCu@`Uubr2R
z24}1sqnmcY&0=~$n0Mc$2dR-V!z<6PZ)+S}qG^3GRP%XTU8L3i1D8|In7?uzQ9GA+
zs-?KvAk4LU#p~tk?KKCgOz4{bVD;H|*OdozESp;wlqLsOgq+&^^z@MX3JJ224Yz#b
zu6b$(y;)NK!Z-5kl<y()6=Od6Buq+r<-RlXp_SqJ^=X>BtUTPZCnr<CzEASo-IBb~
zBt`Fv`uoR*u2%~#&rRk|(_FlCXX=#&Nsn^{u`yMvZMzJ9`fBQsh5c&w^jI?^yzA1T
z%aqnMh4<GvHM{cdHOt{L!h^d5n|7MX4IH;($YINRwF_MKuV=w}n}_=xQ8wRbV|eG?
zp`X?6BXy=bj<>5#lI`kvdTQH-439oOEj!ZosyVbjTXnkFe6{{{@QjvE^4A`%(b{;q
zHopI9wHHQ1jtq0Dj%H~unfo}mBEMhVPZ_<--DmzeQc(9X&Q`nN%)tdc0@cDFTucb&
zrPzSyLTbEpr`}i0I<8nYN^_L<vPHtD#@Vx3%CjG471>qJWJf;kGe=wd-0!YW(}vj9
zPW{lECmhzb+d;OzZcAzY-W8WFq#sWDRQuv_MQHk(0Ym=2+v(7C#cm5H?VQx*eQQUJ
z4v5uUbs%lPhz7HDedeyY?Xz*JX+>$lGBwY{oOlI&g_7hi{T!{#u6&+qH{IM>!6@p}
z{o@NxL>8yqYs=l1^7?K4h_5e){FWX3bL7r(A^I9;rp4SaYT2;Jq&1YQ+;}k7C_d#-
zTYBb@@_y^AQ`P=j^{=o`=yk1G?aa_&`vRJtrR{WiDRb&v(TNLccKj)-I@twgndJrF
z_ExR9ej@vltg>#bLw9?Z@;5oB>f8<)%UZupd+*|VbJv3IyY|kz`tjcIm8M(sf>I~1
zaW^>RH2p!z+UX1Tr)U{1SsWJQyn0o)XTKAl?MqL8qZTlm8(w(uT)~B@4evw41Lf^r
zzTdx0SO126N_`%GU&?>$wojNY>&mt=YALZbD&s!+dF#%t9}j9un(}jQmYT~x;s|7K
z^OF0tddyrNf9GAT%;put9K!ziANw2LRu{Lt{mp>5pKrqcetq`5OYrlvZ#lZdQ=X{w
z_}gXY=ec#Slm}!Dusj&|r{((B7iSetzI-mTcIwYhNlo06f$eO&(^+19NB>qmbKh!}
z?0|-=)!!bTS5{Bp|5_TA_b0mLM0M4s`0$)Hvn?OA<u<SKdNFvY!maIV%%(PdT@e|O
zXXP`&DQaj+QSLCe%v6W{s|L#H^taQerf$jaaU<}MQ;+-`n$zE8rcOBQs<z<oDbGh%
zdyUWf`n4-5=Ev8r%a~spQu$U<`<04bx%<e2=R*5=YaI7HQhoJD=$S{?J`TF6KFW8p
z{lO~7_w~aHtUm4lKQ}JhwlVhX^t}}(8g4P;vy)W(m*zRonlouG=kqkJChhTp9>0Az
z`n!EdP8{I#-mCoUw2$!(g)c35#VtNteR8MYbkgs&WrQ&P?{LjvKc}bq6I#93W+#E)
ze;!bJq`y~T<JyMGV|_LhhEJ{K8J)<ED%oY*)^p&=Erzc~xqRY%ciuW|@Y}KXPx9=V
z1_%8z)6sRTx9+{_=(>3o&X+tMxqWj9Qi~YY&HBObh!nn{@KE#7M~&XAmo!v;x9)Lj
zKt!tgLH;s7)_T7kvPWio)8x6|(sr`VUzPo6h3U)Hd;1O%a_kNDlc_DNZezdxef3fA
z<Itno_NjdLX&b`=Mm6}IT7O|u^{S(p=e<1yK5<ovHK$Im*p_P(JA4F>wYb;08AW~t
zwa+geDOq{yo#U;*8smd|m6~(olg7Pz{YJlkcG9^6ZyO)ECGi`6WrwyWR`wb`u)pqb
z*TIAR%v*YPQDJ|cnKq|5WS}`W<%vUNW8Ig`GL6anKfJ@-9hR@lJ*Fke84vHNaeXvD
zE6M*%k>h#Ka=pJ{G7VoF%T`P~IH&80`K=n)2iNRLRPpVtI^C%H<EM=yhO6lt%DS30
zJ_@i@9N&H*d(_|6ck~zTG|$(M9<nCYg1WKTeO38U<sW)M6Le1)&-B{;;1OrQmZ$4#
z0=I9l4)`uymzFjvy*MkT>yXhFMIL1->m3vv{XWcEleteYcAm$rh}v$4^)H{i<F}&f
z=!+jyw})B&_AbBZ_IBAN#Y~MKT3Th*SyOq21FNf}9qM(zj~rx?#vRYOdCpCR>aH?-
zbrtXGKo9>5*)nd)^Ztwf&;PB(U(cJ9t8?U=cg+8pbNRn674ICgRn&+2>|DEki=2*G
z`&EtfAzsT5X1$SrxZtGH`a=PGUp{a0*HXG15%})b=ajlGDUpYa)Vj|}Fj>0&#!%%w
z`NG%RTE@Q9ZTVPV$BVNcWgXgQ(sPZ0tF~JwH`iqD)6-t@Hix&aI-QdJ{meaH+19o)
z$2Dl=;G&7g$DPY+Ugf0a_}=!$qL5|R6l_-|UKVh?51#Pprr)A$JT`Zjt>w!zUEMd@
zmMFesImLv8dw67jvMX1OxZKn__DpT&?Up&-MM}}#X352a=P4u(HsxNhx%$FfDM<a4
z#kz?vl&)u3$PF9+dE;y!YVCIW#m~Q0v#0FpYPKh_U6!BY=eNCH_Qk;!rAjYWImZ1s
zbvI;DutQIk;)QE3Em6rIc&#N~OKs;4jVt4w*Y^%d9IC2kdhGU=t@YM7Uv=x6_k7lO
zgB152iLrf$j_sT3n`piL!{>A@yMBwzA1-^m^F;Q>dENV+oSM{X=Q?1E*OWQ?j*Rhd
zQ1NzneY;PdoUEfEUv9GdHK(jeLdypqZ*!)b9v;4Bbdh;tlU3n_DQ!ouo<5!s@4YFt
z>UpA7>cwvZ`OCDXgb3Tx!863~pZaw#+t;qk!@jzEuD6WxQy%Gj>YhTO$Lpij=CT#H
zmi)Y;RJ67xWG{PrwDPN?eV#Zs_8+R7lYZ;DhTaRG@~Uu^A1NdKWVT12>$2fuRj+en
z-u-@Q&`{*HeSdW~Bhxc~^<>xQ#vNHT_PzP`CPCPul5vyF&n_Jje??6_=juE81ohBL
zm72G!Ob@k{x6eMN#L9p6wPd;L_ujqdd)&Kz?CWr~SzYDZpT*|wjaulT(4tl&KR$Di
z(i``t9`>3)iuc}$bbk9<$NqXo?51=14xG`m6stUbeXHyjv~Zi<fe(MUYLi!oh95}m
z<Kte#dcEUoe^sOX>(|7rYzxYD$X&+a2q#okj7%D~>Po~<D*N4uNtR|a1QUjT`F_S?
z+{E3+GAp|nyPjRKukXdQ1q;7)Q%b$Lt-_#SvZZxnVtU<L<A^{$o4VicWoc=c_to5O
zKG_voy>$+!XvDAN^-vvutVwO(7Wai?G-N)_a4@nvK4GfSpmTxRTC4qkJEc#m+L&#&
zxh>}Dv%#*T*DTL?<vL4cw%lg}jRw!RHlJ2o*sWX4v8&pkn>MMffm7?=>awn-K6y##
z((>Xd!NI)tpOZG`I0=Fp&#+m%iBp=~XQkABOgh{3{p{VFmHTRJ+;LoR)<3<mBzT5;
zugKpazd2EyG#97MeOoMh9vvOKuDaQ4+=>$pE~C~3l{oHrx51#)c<md_p$@}!K5w6=
zuQIjRC(t%8scn|2@8Uk`^4;@i?s(DtP2zs`n)7#6O>V7^OZnnlHnaDvMC<1K&o}3u
ze!h7?vrE_L6yfc~KX2+Z9!ly`quL&;Iciypwr4Mwc@cAl)NiJymjw?T79pHz({%A<
zMOVdBzY6u5v<v6{be{3Dp@1FPye4Sw&*!$bTeWfxe@}35Jz}{a)X1vNZsX3LFPv*V
zYhMPOPTI|>+2u9S$UAk=qyxPjv=0aTT{3s&`azfW7)K~*Zq4vExidjAI7q&1;(#Np
zJNexvjB0VoC|~0GeeRw*?f>GoUb)_T&X9rEOount8=sz=R_1o{;Y0VU(;S~|@!U3M
zMS11E^m?nHbB64l@*W9GKABxfv8xzgc6(sPm*YO8T4Y$VNBXzS|LfClqRU+OyKn6L
zrX}{geXk|fX!O%Rt8)D|TANfRS=U;P`<TAhUH@~m-i%(MM_12VSnF0*bFZ5qrT@9?
zt%u?^g;^TjdEzyvrf<!Z8{yUSa|ZUeep67bpu5@Mq-Oky(gDq0TT4@J_L_g)e$;iN
zU0**{7#Q@NY3CGsX-#UDQ%dprMU$gudHt<kXqsg{_2v@KN8a1`_1aMnz8eIGR9ncl
zmZt^CWn4M5KPydp;ON3_K62M48x5OycTcQAZNMzoop*PvYbcI0cNnpMwfj!HN&dW)
zo-;?*3wAjel&S7dD}AZ)d(n=4HH(T@JH>8JsDI$LS!UkHk_$bYu5F#^{9He<Ebyn#
z;j}tO<*7k3CZA3pvsX}hv;6d5S=Bzpx71#_C9cTkDexC0_dRhi=C)3f@~Yu`#-&dg
z<|sexW!J>u0E^}Uo9<Wev?tD(V0ZOzpzpaqpEN8@&M0^Hc~CFY?2%M(dxa5rcIttP
z!&?U4Qs49aZd_7x&mIFqON#I8b=hb4Y1M)^TV_qS{-}5CaqUNy8Oux7wpI3WsLV3k
zqP;(B-%hsH#M14u0W(%O<QWcG=r;e-)4VSEoaZwqYi>O|Xn~g2^5D=uwWEKJ8u8;?
zROQjq^2w*)hP)eO`@ojBX6zR2$@f>9#l`$mJ}tl5-fax)L#TCXbx7B>i}h{JUtJy;
zRs47uOKp2YKaO**mEQ`5m=EWsE>>T4(eZ_>&NJD{R{498-S5{eW7)7>oD$0Kaay&*
z!V-I$I)}f$rf$4!oO8^TZdMJ;T}}3Q#k9@y8??Z`=BMwGezM`}m3l>Mi*~J9+r22r
z`O`t}w)P=j+g`q&tS@ZNi*U>wy?J9AcRA1H!jq*fPU|=xvEk<x2fMX%o(d=aesLhi
z{U*C_Vy>yqjmDQncSb&J$k~1^;?~5f5f{4f{FeAXosn<v^`gwAfY)UMr7KgqK)Y#l
zsijh+Q^hHrb+M@t&L;P}Ruw9}o|@^?b!f{x`?<WS@3gZ8_qx3>oblD;$A!!(#d$70
zk4=-AQkNHZ&TN@b*%kcb?Yl=-ofuuP=RkL>cXw94m0u&vzaP3g?XBa14G+Hu$R&Q$
zNm_4PI8t-(wGoB)vfN|0OgpX~_&B=9p5qUrw!41m@+sW)BI`)m?zAOmXFOXK6TNop
zz*nVv_j~P}(Dq+rxciClvI2w01J?(IZQE+K)ygN+p-gjqvhVt+)r$7TqizK~7bse<
znGj#d)pL6kF*!AsD~P!>OW(PxuA}wAWd*rMIl;0I<2I<=OW5IJe8s=qbHuyf`JS4Y
zU+Qf)sZ4&j*xvN{0FyU2W_y24zdw4K1$DXgfThj!gR0l7zwu1E1gF1<IQj8<|6z~T
zTpK>UW#RF%zomaP6fdtDSi&hDIO?OSf$H8y^Ty4KCLW{Ihb_AC^!$6P<jPHK+l89k
zDW6x}T~RT7(Ea7{;mIa_bv6v?d+Ke5--PHDe<R~~`#ox#@2(l$U4`Skv+@2{htS$-
zRtqba^?z;EHRsI05vpCT9m#V@=>FI?!g1ybnd{!q7U+Q~S$cNO`<w5Z-}NfldF!{W
zFb6y^aL{L-^AXS0s#*iRj_6-Grn%lFWL=f@y7{p^3hHlqH)|Jp=c)@QJ>#AkyfH58
zi*;y3>cZN3fw!WK!?}{5g-h&=Qm=bxchfl&`sTw=!`4r~SJf=jd(Qj$>G9O9<5ov#
zv{yYSfAV?xx(i9SpG|w(I_TBJ0TWU`4o<urHtY#Mw>j+2*rFhp#JSs*=iOWtI&dtz
z=D)95mfB`c@-e0S0gJpcO)u&MjX%Br`=`72d>_jtjoGct8{1DQSFyL%lbkH0oNpfv
zbXR*i)VbIxxAgqMLAnh$?BZ=R=7o6;UtYc1%W1~=)?-`tGzv%S^}K#h|8$XI{0EkA
z(V4705#vg2dg@jsscac&SM@e`o5qlss<KZ<T-PRh&wsN@<@)j+s`*3almsfJw1w)8
zz7f3nzT4{pGm~HS-_~|_Nm`QpTkgxnJt=+nu5;Mcl-t@G!0WO7aJON{a_iT=eDJg1
zh75<fam9Z}wa+W<tM}fm+~xf1J^F{zcR2(tTl(edXphhYW1V}s{rV56jBQN#$(wk`
z$ZXckSNBG!Rd4(<;PXZIjmE5^;uVw1W{op*cr!oVYLz$tZpOuZr&Rq%kM^`Fw7gpp
zlNNSqQe4e%J&WMe)tOlz)K?_b6<Wx2U%Rt))~%K)Qy*!#cOChddc9_3NJ_o2TV0d<
zZo_W6P4~_vC1r4ewdOu@v52=wcrAN|I%axZLAzD(*2}7=Y<F&*cDvw7Vyd>z21Tz)
zw|s^rJv$Kpuz65(^NT|<ZM)tstgM-MYwRY)IWHzp-rfEvRpG)YqYH<+%(Tf}!{biB
zZyS=OV7R91g0T~iADp87b?7bAOR|rmrpV>wPD=2JpZWf1udkjjHVj&lcIm%C)8F-c
zmZvdt{?(QS@PA!jUmo+J&j8ar=g%PqYhw&97OqKqShQ@Cp_hmG>ZY~s)w@FZJN7<y
zC~b&2_BbTa^VP7)gC{I|vc$J&&e|>QTmHU`15eZXl`x_>MI#|-x!<6_>sxfYPn>@G
zeWvBBE;n}{Uoqy?uoTz28>!m!;;a+Yn&VE7EIZwstvFmM|4z)HkSO0r@_Ds=`%hOH
z(Y|tW#8%drrvX|8L(fh7Fy>qQtuHRu-PG>v`ntq?%YoAFi>>O0o_t~PsH(>9;Fw#5
zX8Ggap1t|gYh6`Z{K5Mf4jR+5!$NgpCeD7*7Qp_zV94C|{4@FOt-sd$e&FAjvU7X<
z&niya;7e~*<JG6$x~gu@4)7U1u|Y>!^~kZ<)}jMCf@K-+k9;5TIBrjhuDZo+U7x`X
zyxw2^=IvO1B-(ae`SmF+;q5731e3kb7k_%x&$K*atI3y93$DKVxb?AY*ym;Mwwk{j
zy{28B3cEe$kjGG^uqclknYMN#EG|*1kJcDHdF=G+$_$6QwcDc>Z9DKoI4kd}<pI-C
z9`aj{_S8;Od{D9MUC*!y#oP6Me!H@?N^95+Eg!oDtxa1tCJELW>-OrmX94R4@50jX
z30ZRPyxe{X-rVp774P^Jj)KWLmBNP;kAJx`W%am4PWEz1Ufa};P2Xy?vuB^su{$T3
zCZ1c+CFk8v`2dfdEsNQir?rkGOm|Oxvi!V$=&|_8bK_g){Q7gIIH__$@bKVAPRi9q
z@x^lT<~@ym`RVw!T}^W5jNjz0mEttOY4`lK&!|zoBYLkebg#{O5-{fYwgZ*HvHdq~
zK7T>ez`4Eb;&86!k>huaEDoI=`Ag0;S8lZTuXkG<AA6}Dc<-0BcF`MqrTGRA1}Ja2
z{U_!yHDsyl*#xaO)lPYDLywmg8ZP)7bKj-h(_3exT<h5jX={3Kp(=9{ZzgM|Jb3BV
zE&a~tg{ivW7waxdLVJcS*n0mdf9RNbU(NgXi+*gCrytYf#_8QW9rjb_jFFks9&i2<
zBXB(UWXM~SL&rY%G~vc2Dty>)H?h&*P5Wz151r9Gjhs-Y$JI3omyRiY-t}<6$?V+N
z#KNP0lK0E#zqFVYlb$(tRdYe!fw`Gp<qHPKTHfR?dvBqV8`S;&T6L%2I%-|I4WGMu
zV#Lx{XM$}k*KJOc8Mkcr-F-U;Z@GK$+Yg6*o(}dyOtm<vPJZ)G9X>qX%sgXT|LDu1
zi`w4p9<=D;<rVMN>&BHeMC_iG_PKC_rB(6A^Xdogy}lrL*p}<@S+}prxOH<6I2%m4
z%RM;r+v!s~yDGl;yLd&?gtgTAiX<E5l|~DfW!IZM;}};S-C%LWrs&ndGw$<w<-w_z
z*?-?nFtDAvuI^Cupi;X}p1-udReJUayZdJArbum9=O&-2!Vj^T)?0Hz^rN>1tp1Uy
z%hP?bJR_w(Sj~9nwxEf-ePb^_ox+LqpRPW6l#%AF;=QT0_ojwC`C>o5e#qlfK8GC3
zW*7KeJZ7O1!Qw65eY7~6Q|J13+?h@NT+Lr(AHH(s_JRXtuXa4~Z_4_eeo244aqoq7
z3PbH4WW>xn?pZK3eboN_h6<i_52A;84PDampK6ec&8ye_Ja(vRmFIpm5;z>aF-gXE
z>z2)Sp9Z&o^w+kS;$I#YLwPEFkA0{U;uE0pvFOJ1U4BEnPN&3tc@aLr=VaUDG<Rbq
zpS8|LaZ^;3>|b8qnWhrF!*0y<P=U!2&9yz3T0AY7>Yv?TroZO+<M!^oE|xyB3pW2W
zBOqk=-iOx0_rs?9xL)^f*taFZ>w9MC=itA+_4?IDEUGlv_3mPcgHLxyxmN`ns}?1?
zxhJ}=@_#OW&#S5K@ZqmLX4FhRI%dF?W8GFdzdl%zwtw4yH%f$7rN`3^_uac;J8_eS
znfk<ymCsg}DBiogTdv@z<<@mh+_4jVoLBbik^ghwq?4EOR$6BL(KlLMYWrZ;qapUX
zOTvSbJ|Fs;Z~y4V-o3NeFKD3t*c1<+apuvDL0#&+w+|j#{P{`Ih`{yl?l)GBSTkd_
zoaNJVt)&isJ}f)e{X@n289Gg)Z*EF#?vZ+Y>|tByINmDx-6uArH(aXFUDJPSY*n8V
ziw?H`(y}?GXt=QCSGdse_9<(v#4!sGYZ$mbjP8GD>a()gy_$2kq`G#g9$s8_%O<dG
zhVAcDk1NhzuT0*k?_SyCr;4H351ZaU+75g4*z#lT>);#O-sik`o_wTUZrj!I<Yu+w
zJR84fuO@FZxclUBllu7e%4Nm<_E+svXK(Da)XS*xV$2w|Enn8<{kO~H*u1$0Cns30
zuVAY=RgD}!|BaH-Wns>rv1KZClc&WcD^lan7t}@N-TIoB9<;COi|)A1C(l32NRc-)
za1LDZBS)iW(!7fgg#Hi4Ouq8TBd74N+Y+5mzpvNT=+Djf=UpE>Zr#RJ7ORG&-QU%y
zr)+h6YJlOX+H-?T?r?QiPf)y(liHH+H*fo;Q_JUR_rKl$^3SEAricD}QaAWSy!OD5
zPiiY`8b>K_%2LRh@Tc*?u=nYHD(b3TKQA9;IQh!cwY<DBS#>+NWV62RH?iDjcJJ8c
z5Y|)ICgYH^Gqp$amzR$ATaqwy>v5Iz>lf1d_IVWTxP0%O_P<ntQ@?Qf8x5lW%hQWP
ze!t<sqz4fXHI*I>xWB_O$9cfW-#s`9Avsk~6~aF(U6vFw>ErQ&%g(JnO$i3}H@uH%
zG!>nCOBw#qj*!i0{CYt7`zObsP1fP=S{YW_Jr2F%-nx6#+<klM?y8=@3l1lIogx?3
zFjZ#xs&meDK7YPxd2YU@v}M!R#g>aK(@)we4RmL9zdbL%+tS=L$BbTD0|q_~88q_1
zlR=+bmM%WIbaB@CztP%#3L6LS(tdCJDD-c$sjkgv&mWTx`55NR?N_f{e0$d|qx!XL
z@>G4yKTr=;bNXDoYF_WSxP5zEQvcph3PWa(ocVWK^4V)&f+HSG{PZW$ruKYMxVM|<
z!0Au=e;8jnCU{+u;`_3F>9vKS3SHtJUB6xS_WH@9L)R{rvgP@H4Yg@2JY^2W-}rI7
zH2bKDNtRadvm>7TDeC>+b-!o6Z?b>)Bd+$ZMsFx{Gl=>e$O-k&nIFCB^!9h<7yaZ+
zFHgHy==m$sgmt{{+@i~I{?h~JKY428(zuQ~9bsXy*|nh9!~E+p?UoJpr84tpD74KQ
z+&5ZT_t4fimFq0-P11_=T-J9`<$-UPKYdF$k$9OO{xEe#Pu@p%_0mz7xi%Vu-YGe1
z{rvSU#5q28Y<=%-n-omThZVM}tbUr~ynCtkklPy$9NB-&$YAY_gg$fo3#jX@yf<1a
zjNg~nq}_Hg^hwa$*Y*6_FYW{G7EL^~F7jPrw(-o{=>pCjRlg|SDQ@z;e4Xpmz?uYm
z{q*N|%<9-L6w1~vvsk?-E_U8KyMlSuXJtHlj2cea+t`fM)bkAs_46Jc5Ec>WuNmm;
ztI0Pp;2RhX7YxB6q&HdcrV0MKfIs^QlPMM@Q$aH}_@fUQe2)KZ6xAJJN@mGKN+w1{
zrmvEmd^QlV1K|B|+-~~anyZq<vg4|+X4`Q!Gi9y0dKq1;xJJnwE3R3BoITfzwM>C)
zX3I6Q;_6v*HLbboAcZwo-bxYr3c|h~&>aN&0v4;;z%o<Tf%auj`?95d*>c_317$jO
z=Ax(ql9ys%_+KnhM&SGsX6xy9;6H;dYcku4tC=8c%N@&#Qs8P@an-G0nQRr|wf(|r
zM$+$&T+JC=c^9sxEmt0#(mwm)&b$McIfDf}NPM!_f<j81S}EFsG;TOeUluq4<ycLZ
zBa^<)3{VceWV+50IQHCnO*R)Kr)vw8QCwSgiXfRY_*;+t+{Srlv55MDbr0*yo*OU2
z-bYs$U>$28UCV3i?<w$&>Su!ZTI{(cV_7->UW+y`>qlP$IHKtnP;<$waa{ETwk=na
z<;PXG<*Hb5<;Q|3TWrU{WnE2|HIvp!hAb$L_?q2Vjo^wwEl6K6)<>#zUXpr)K4858
zeI#&#6#h*-UU4#450pn-e^6@;B43@<9n>w<niJCP)3K~=omQQ-BHcGMamV3<Fy+Qo
znF`cl0fJ_j=ixju>2}Vb>n53Q=LDeV3N3adXchWufo{Mxq22(}g7h&s{cF0c@OmBS
z^uRWmuCs(L?%evZEDs{Nqav-#Qk=FK=bgc_rP~tZogfP?jg=3Y(nh3pYemWnq<M|g
zRMPJtzbv{fabLEh`yc4JlK#h<3aZ4WgPQCWS(`z`xDF9cuwOdU0}VKap*PsayfB+U
zGk2~^0t<As`COH8pdP&dipTNrAKJlkNpud&B^hIEx#6tXPMd1HBI_53=s5U{Q`84}
zG~qm!({&AXY}1Y7k;Psuo7u%RgEKurj^(2O#=UW%^Qi-q?)2aZ4j<Z{R(qxbSKd{T
z@&KnsIBsMoT8BCXg-8J7*jQE)(7MgPa<x@tC320%{R>f^so1XpoiQk50xJZLLv(qz
z<2YAw9Lt4{q~j|7N4kgqBd#6C3B*3b#rbu|a~DH#+<bAI5ssTh$Jv5We;lYAP;vCQ
z?2O~&=s0j_gFi3KX43#(mpxZ=u>w~G46{y(PH+sN)23oO+*Hut#!grXW?b4IIP}2Z
z1<c%OFpeIlKz~SJgN(vJFE|hKxCqNn+qPg^2ig|sO}g(yz(Ec4QV>PgZ9jY=J!xB5
zb`Kawj|*lvZZI8Z&sCWPV(9B|!@LL0!9nNahuM7bSOGNt?^w~I$-2O8*L35?4_pe~
zt+*|kGeF-5;u8-Yj<AoFU|&a}cYOVrO`)0dzt^-}G!B3$x_m9zwi|5=4w}i*7Yq(u
zHIS)eCbEkH@%ost#AAr0uflQFi5^4j(YV?YFSCH#9xpSI8^1!vo(_SF0yiqI3>|i-
zX_S~oblR=KZ5ozkdne^PNtDk4l&==EYxKpyu>|M<&oMg8SHfA@oemieitygAjweVf
zu`lA@&kB&fU5fON)8HzGWf%Q_P7yN#{-UtmRoXWkk3@Q9%~F8v1#Yb46sL3bT)DJ8
z-A21{8hU;}A2d6KnW)`p&DLY43BpLTbD(Bv`}a65osI(sJ<p&N=ogAI6}RblraBwX
zjc2ppvpQ`mdgz4y+_1kadVC?q^A2rLBFi4srBi?4t_Ac4{)(`_91y0)(|sFs2-vq-
z*5bMvuLuUO^B3XuV|#KOH3rGw<G51V7wr3RJ_qlcthvA&7&}1kw^t11s@uRIMbYWB
zaiw>fE<~Kpj!ZWTr`z6HesoKt{QgNtw^J@oC+d6jIJz6NP}-Mh9G!#4(Q%54;W$dq
zOX{)RO>8HwFC*4;aedh;(xnDofX?W;!$CT46(u?$MTzpJHKL6fixx4_rjmQK1Dd;+
z$gn@qZQ9w*7$m3jh{FDGbHFh?6|-ryMkRg1oogg1Dm@;Uf#_0f3+Jb>9l_iQ&wtpK
zV9JH3`HqU7;;`u6-h$Ki0)9|E!dodUmlD2cx{UNe>q!%{&g?BZv3Fyz?+1K^;J9$w
zIX$l!3+|n^ih*<orSr<b@%`y|*v2zq--Ydu<8*LbG7HS`U_ThoRd<9f34PRKJ30;W
zF&p|Y0;lhBTyOEbQKEl(-dH0&rh&?)>sk}vXr0CPE--JDo~P2QH3NE@D}ArBQlzyw
z3#WCF1t*}LGU;`JbXu?s>cTdX?T{FlPXm7&ar#7B6Cl0xy5gU?7FZUL%L)fY_Ej)c
zb;Q6G-KX2J@ADvx$_D4}PU87DnB=mG{=F*t9%F?6kMAJyyd7MV^!g5@OW*`>&Fr~j
z=X1@hftL(4i3fJz8o>DCNOw^$@V6BET1VH<M7n-DtRcp-euC8Y=fOPSB1m5g99*R*
zPA&>u2Uo7!Qbo3r3_bMKUUlG(P3V#=o59XxfyE%#!GY`M2HZZyd2E)Rui`eq>y)vq
zYp8_csfMkhH=V20<ikmE3Cs|V$;P;YoCN+UyMN~!tnvSJIjA8&Y+p&+cdi3B)-Iw9
zU|r||%!_c^XE-g^09;Q?)|NnothkP?4aT;PlW;3VTG#E^?=tLHTAN_jo&eTEZeUfw
z)w7YR1yCkuU~jBSC!(lG={m*hU8qaA#;4~O|Ex_N6j=)hWT&VH{3K$3HMCPW_ThV+
z5o<lDO|;M+kNRT?wymRWnd%ZRlf~@`b`@-a`FosJ4d3fK)FoWIfKJI~FX*K2z<V-X
zcg8$AbFeO<UpgxTU3bywQpIHe^D25w2*+s`<9ms8y~A}c*v*h<&ypijgPNyc`VyQz
z0@uA{UqpJZfmICBOYbs(+|j+K1*gYV0ozkn4Mc)t4(`((%H+uPVnq@qvQuPL5{SOX
z&|`!L_P2p{3hJlxJs_4lNIp(#@4`-T_P<~(NM3|}oe^sd?k5p@D`0A7#X1eN4ysW4
zvTe}%7yEbx?lVYVVEt=LuYVmgyJT=|!TR?&z5b;)pXjl%dw1{xj<NI$Y~K#!l94aW
zNZh)xpF87pj<~FNJcD~0aI6^*w!K(hsA<GWZ58Q0m5S4D6wgE5|DA^dZHo6Av#r={
zaLegrzYDfA?dmS}H;TRnaBEr!?t*leZ^0Z_3G5fLc(GPS+k*8I>=)AOGq9Ww`S*Hl
z!H|1RJmjus!FqGXe!OWvU}-B^hk|~uZi^S9&Wd2RkLF(1=P%M_O2p~#?HR5=)?-#d
z`vPqsz5Za?i^o`NMNlw$l|YXpwK&ZpIt`pZOaPM%8#GBAuLx$(_HZuX0ixTn?IgOb
zKv}WoK}{vg!tsxu5S%~?6*rZQBJJ&;4J~^`FLeI_Zs>M&gNtRb-z3&6*k{D|M>t-?
zF@}|b+=%aqPKvDe0D<hqXuRTB;I9b#n}qwObUn~Td?Gz(u~uZAm)`rbM`KPC_E8M{
z(bp=y<_D{Y^IY{Q7r~9SmcFsh5>FmM3j=c_@TUzYe-ssruL-9Ix<>nL&eC}T1^R(B
z({P$z^t~OlpJbfsuy<}t@88boT+iba*%@@qlnz^NE{c>Ua9x4(aR*__f!;R)Z5{&m
z*Bt1%4Lu$;VVj?{&Hq;xFV@;lXYV#>U2LRII{|Amaa{m)B(uT1iLQ$hO;&+)W!S<t
z^uuZVaGDPH9eBT_ZyG>d<enL5L%I!iV;^hi%)wkKi)Bxb4?r-m4ZxjRQ!G<@9HX`P
z5T`kh+n~d^4zgsclG9ITMV2igaxk#d{`7m(nN!q(f3L&g-@Sd-JwnK~iXCtJuw9m7
ze|q9E4~(<Y`xTNg5A3wDWxzeT(@ohJP^L@RSDP+4>8y<<zQE0b#eT%J?q*-)a#LB8
zxY;ac@NPxh7AbYA2)O2_$1mGH-~}A`)(XejX_$%Dc(h#zX7s(7KIrC&$4r9;aLht`
zZ1j3*BaRy<jsr_r`3YdpUmm7Ch2yov@zdb=M*F?{KjOYH<VmMf=}SAKD6%|soc{la
zbHH(Q^`q;ccLdQj`r)`?;y7<{Ts)4mr8NcGh~CuzYjRkJ8*v<67xY2bVF_lUJs<jZ
zb^$XwzyI%`vyr7f{q4+-E&i17-&i(CK^}BjSW<kqlmT13lPCp2kWGnp!6bYT2(qL&
z{Cp5cvnhJv_wO+hoU)|&2dQW_B~q3I(*2et#n(%sKzT%WTnU^7?IoPfPjs*;yqFRJ
z@E#8SSW+B*R*2)-lxUVIl>h|U;+`VmDImy_;_&lB9L*MgN-MFauY)DU;pc>6dwj!_
zm{S$dUc#SB#j#;;k^&%j8~m}Pc(hbBo5CGPioJpM5)MBL#PMwLC&`ioU4al;Qv6^4
zu=h!fL1+lHm+)v>$oODWnxf!8?`#T=4F53tgbhEL_!nD3|Jq^*KbOO2Yzp>jahxc?
zhO;iw8G0WN{pg7y{JagHv8kbAE*)TtKQWW0bUBCr3&7cA=wHI&=VsW7O&NBur|XF&
z#o=dQVtalEdm6AQVFylsCx9iz;pbo2icOhxu%`i=GG*ZA415#=AI-qWFmNjdZo|NB
z8TdE`ZqL9S7`P(?cVgf!4BVB0!`WYlI5su01ET>O?yPi-VpCH(LTEpYfzM#z^eEc#
zU{iBCLO|G*R|kFp>P^DoXHM9PP5E@NrvV$zygNp*seq0U+6OW4xeR<B0}tuI8$kJG
z==!ABE#QzILD*C%g2XGE3L^+QWm5|ncq9Xt9!(`CY-*9@L@LCl7E7H;f@~^Qav~LC
zQ*hTzil88yitE5=z@}C(@B{{)#K7shWXFR|rFDdWu&Hzgp2@(o82B0np2NV`G4Ol_
zUckT$8Tcj!zJ-AoGw^K;d<O&H)qy{O{Zzu?=LFb_P3`Gm{|(wpIQ(otY`?FAJq_5@
zfeySY=vOQ$eqPFgO&yXtL&5&gUc%x2J+@*~hdbDhfc6p&_vnF@GvIW;b_4J9A(>Ip
z<vfa@)az8}N5bJgJcyr%{TN|Ccv}jlWK+kaJV=6U>V)J(D#WJ#lRA?G*;KjYL@LCl
zPD`Chf^6!n<U}gOrYfb*BtbSMUF(Q1gx4$KaIYCBVN+F-#5j}$?InD>lm(lrmO4Yh
zJZLZBa32|4v8l@)?9YNJ9ZQPCePglxl@9haU{hB+@a-^P35R>d*osZnb+A7T?InDJ
zlm(l*E_H^2H=(_R!~I@t#inj{uy2O;5)Suv#rC&4*wcVb-RZ!)vg!JfaJYAit=QDP
z4)(pFy@bR4TCx3u4)!!)Q;!(<V+Q_|fj2VnrViX3l#}kK^<ccA56Q}eF3(E@iB~rD
znjq+uO}%B{?-_V=2W|`NO~Q+%EZ9_w)R`p6rantfq(W@!i`1DU$fmwYPNYI?s$J>~
z1%qIDBpmMNVJkNEqk}yS*wn8Md?EBB;cKKU*wi1XGf5COjpP)DlAs?JZY}V=CU7n~
z*p!5e82t|RCB*h3UI_h2INT2dkq2R>5~s4F1kjK4YE=@!rsO;Lr(@Za0s~iK;9Lf-
z!oYb9ygLK$$-vbacpnBX`o^=Q4$$>#FxYD{a4iO|-GNuZCK=p;Ut!>=JbE4M5g*FH
zhcR$N2F_>TLI!T!f!D+GbN;PJaCQrF-46EmF_$M&Ji&fM`>3MmCd@^9t|I;hb2$;f
z@6DLwuRVxkTOrq#Q5O>wXvdu1=aW8uV?RBlAqcZ!hvHBJ2;LQQa_2)Cb0J~h19J<4
z_r;uCVGo2{m9VC$!Pwr7h#8LgOo9tBCs$_Xm`4%zV=#{;xE<#41b4!mT-mrouG(QI
zX)3ngNcfqJ`9XsFVt$I?!I;+&JPdMGYCXZDu|0XGjm4b2L$1Jn$a+q}_T(Kb6LWGz
z&%s=o=otl=lOxa;$W^I&qWn9sJvq|sgIrfeldwOG?MD##p1^z@!B0c3+To50KVt&>
zy+(xnWo$nU%-5ukI?UG-{1)ahgr5hH>&oa!I|1Qm*uI_c^9plK*k2`yK46|o@K(%4
z`xT-T-y!EvGl}y2#r7?PpDtbKl&Vw_G4v^7t_jnLyaP+jy$Ie5^W6mRk9iBh2Vrgo
z-zENsU>-woL(D4(Zi2ZyQT|bwyAj+9at;+h)Q>&pAq029Jb~bou>Yro|LNGikg)f}
z_722A?~i#9!RJA)D`O<78W>uD?NbT+MUZo-|A>5-VSb+A37CuK+oEjJFn>na!|w-!
z&xyVed>yt|CiGm0xe39GF&F&?NtEv{%%#_9bld^VLkT}eG1npZf0&05I!C(UP@>;0
ziSoUO?df%@^ihlX4uapnyp-T~F)t_hW6bLa-h}x>g1^PQiQp}me<1ib%)b--7v^$A
zJ+Po&IaCjVqyEF8h7p{L?X3yk19NAB_rrWT!3SX;Pn2^A=1U2C^t%->ZWB5;h4!kH
zCNc4{#C~!KKX%yuHDQl_`=Uz46MPc3-%aE@1N*;C`1i*AA;E(%e@*Z(?BA`cwAv_Y
zA-0$P{E4<$hWSpyPa@_=2%e7p>k<CfV*572z5w&T1V{G+4y8nl+q<y63c(NJd_})|
z5MA9dY|kU?Phoq}?;k|==dryJVPAvo<%x;)b<E8Oei!o~f<M9h62V_$-cIljm}e9G
z3*;PX1X0ePm^%<0eit8%pHm3l73z#bq4}Vw7QlB0FpnVYdtn|=a1G4SyiDRp2Xb8*
zGYNtreaHvPs1RI;?Z*;)B(~QixE1E)eG1*@bY&a}dspn=jo?!-pGNT6n0pZ%{YHyJ
z6%+L^588965`sryev05|KaxYCd7mVccxbOml_*LW9ZJD|ED1lWvAq{zzYg<Mf^Wp!
zh~V3>|C@yWy_mlx_+iXhaJ-k4^(5x%1V4-U2!db4+>YQ^F`r5B2FybV{s8k81aHJV
zhv088FCsYl-5ZBGMDR9je}UkCFuz6cE^vJ3P%j9sggLq&O6pAwa#iXs(Jp<keQ(&m
zCH4a`7Z6+z^Kk?>#2no>Bz{I<zKF0Njd>EmZ82X@a3{<~zq=IWFcI@Bg#C2PpA*~*
z^IrrH#Jn4<Z;^M33dOuP!J{!BM)0MW+Yvkgb8mvL!h9LQ*I=GS@b#E)A@~-|_Yr(2
z=9dV50Q08=FU4H+`%F<yltZpc$t#HndOwHl72vxh?lR^`M-pBSxvor*1i{c9Y;OYJ
zC6SNeIatpU`M$t>8o}RVKaPZ-R%{<n*#CfBS0-GNB@D^Hc?K9K343|SIg}6KUm5ec
z1n-G?7{U8v9z}3%%$E^-80ISoF2Fp6;O3ZT5qvD>1q8Rp{5ZiUV2;{TQc06BN9`uz
zvoL>2`0>TOjo@=JXTf)gp9Pq!5<CWTO@hZ^Zba~8%q<C?iMcbub1|Po@IuVP3BDEc
z1cL9u9Ql)6R|)1j2>TP5A0YS{%+C_M3iHbZuf_Z}!Ea*zis1J#|4Q&@n6rra;cLv*
z2>ucCK?MJXxsc$$AqV#(qJPOkI}SCDuvf&~mEb&hu1d9ZlhiRC>W#TP!8I{YCHP>>
z%?NIQ`ALGCU@rPyq9}I@$T^fLd>2uQvcdM#h>h>@n5Pol9rH^BpN6^UcY~rFJR#>$
zbK$#)Qd9uukp!QQc_P81FwY`*Ean>tz7q5O1W&{KKZ2w628XI4cs{moB=}~`zY}~1
z=JyDW%E6(y#60IHw(mpmGRy}Nyb^Oh!O{APLs=5M4%<5s{5Iy(2>uB3K!P`6zKG!O
zFem5RpE2J+*rWR5P`e0@zJko5N(n9p&pA{z!BIVOs5=Djf$due-VbvY(XUbcawt`T
z55@L_2#)HVLzxlW4BD$w4$2aZ)1fig&qTr={x|@vPiGSx{A>jr94dt19+<}vd?w~u
z1owd)e11WcCm8b}f`?;28wfwBy*bn#f-lGRhY6m9`8k4TV1A9@IhZ#P9O;HbH4?lS
z+kYhZZp=l$QKxH>J`O<+#&hC&kBd05AU}=$%p}Iu3z+vN_!Z2B1iyj#1cKj#9DE)}
z<ogtJGlIXuJc!`Um=_WJE94x?gUI(6=1U09hV{syRufzS^IU?Xe!`(P5nLVHA0qew
z%>N^}F6Na49}YR#ha|4c7~5YY>_=hyvBXE5*4X|EVeg1}9l_l&Ur6w&m^To74(87Y
z?vMFLf}{S-p=5~rW+b*>MA$FEyf<OL0`s8+N6&`<;}XHqxWECAZ$te-^qPnL%pmwC
z%tHyj9dcDFh^Xg%n4cv05zMm*{vY<gi11&5?bV47?5i;!OK>!ffbtOh7WTh}@c$6=
zVuC-%d>6srVt$a|pCAY0Dv@tHwm(DI|Hbz8ggpngH;1Yt?7Lxpo8a9c2cLthiCPf7
z_r*Mw;98iAe$OpRH3V}n!rln;5`vpT&Y|8D<*~&4Bf;%3|3h$R?Ef|4e-h@J(qHfd
zg`I)@C=lbeH|A;t55ioB;9;1LCOGQn9Lkp9%dovO!4om}A$U6EK!-&6*J8e#;04&v
zV!}@mwpS;<II;_K(eJWF?RXIT$tL_9!}endKc_GcBKUdiXC2|E2J^iHzmEAqg5Sk_
zGr^xgu1aMS`M$*bB*8ymKjnm<FPPU7{3qt3=Xi+fhXwTq_JyRsfD9tLV!peV$P&G)
zK&~qj^Dm})iR{(?jnEMJ@BJ^=5plv^AM?9JzCz4n2tE??Ai|Fo<Q$4a+#emV{Zpbm
zu9(Y9f58(Jc?#y!2>aQX*Aw~rLC&GR67@e%<cIJdfq6E;7h^x&i1No{u1)Y1%*PUZ
zHTJLB_uu+o2f40H{J$7KD@T<wBd%*3_G3oqWH07Lg#W{si+;~4%H|~I;e`EJ%#Db8
zzKHp5f?pN+A<EN$c?rQEK&~s3Dk=zmZ^ZWPg#8=L%?Q1<Ko0gdh<a`VoIo&#Za@c}
z@%{{4pMeV*I6W?R=6@ms_hR7mINO<@90nc+?$e#wZ)dPS$-u8L@P`ciEdy_7;C~tT
zAW-<u%0GmGn=^1{2JXqgBN+H12ELMk=Q8k}47`MaS2FOM4E!?#?*rzqAgaS*&cG)!
za62&X>CDe`276xyp3K0vGw`zv{3_r)N>hAYd>ncUxt5sc;qM>)V(=r+&|fqd_z(te
z!N6S@_%sGiuLnA-=O_lA#K1EcI6d$0%zrThFK6J54E!wv@5Z1XL%?}bzn+B8JO-^d
zp26Ooflp`Pt@@o`ZzzL(3<Hm2;K_jVq<;533@dLZ<f1c*nt=I#41TUK@CF9{mVy6b
z;N8GHzO#1MVc-@F+>L?zGVsL=d<z3V$G{sIxD1$o^C(g8$Io;Ib=@8C&aQVLv=`#m
zpuj)XM#1q6_A?pyG6r7Ez{>#VN&SxA0GHqv<fh{CxZ=<!20!$3op_YF*k0tP511$M
zs8JpGXvjy4xd4Z}ARi;<hB%Z6xs{mD!lBiGcUGUp(B4LDFZ$TK6mnZJpN&K382ns@
z_T$9%qOYyof!w|We*?LLn1g8^JlJ4f$fF#^+#QGd0p3~pb)dbI*k0t(l)>H++PjGD
zK{4Pl6LL}Of!`-!9>L%z8QP0VM^T_z;jtO=iTI47;4`JcSqX!ma}4|$1OE#Bdx-rX
z#UXjHuHeC^aw0GVa~;4tt2bL{KSS&XE@Q!2Amk#|NS-;J$l#{{+Do1rAo8<^!TvO~
z_YvnS`npLSgZ)cr?<ckw`EO&e?*rB|JgMgiT*E2NAP*AzS&2h7kk1u!k^Vg)pVxse
zfjmUaui{V<;GNa;K?Z(|ftN%7p<@4vI7F|jc~Z|G5Y<~7gP)#Y-OH1DE`cWYV+eR>
z<+OqJk>Y&QamWkuXfcP+p$2DR41N+A_&NrDjDcSUoG0}>1oVA$@Ougd`=1P)2iC)#
zUGFf!c~Z|+$iY`=3VE#fdPU>23xgjY2ELSm=K{`?dOkxb&S?*WeK`ZKWZ(}OcpC$k
z@7H<#r~=NDdR~O6oCXZ`4h-BE`dJ~a&+Rz0jKO{rv`-M*i~9RX2K#H!K1pmZ>Nz(V
z>_0H@FATg#f4Ux0#QtyMkTv9KVlFCY0OX?H1Ae=W2b6_?cc#OY3_Oj2XEX4F4E#R^
zUctZ{7<eNC|Hi=OH0WO$Nxu9qk84T*cxUzC0XUD!6xS#G_#T{jL7pY%@cHB5Y%YVJ
zL}<T8Y%lsBIRy;%#~64$1OLXrdEkeYJW4c*P!zaL!$SagXV*Is+OHFrQ)CkidA^v7
z{G>7X*#qqh#P%XT6_6K-xya8O20yBrbon=l?Za_M4{(uBaU=+s0?wnhh!KzhJf>;V
zycnNRlnxFp1iUjpxzK)_*j^ilN*V0yq5TfAJ$zO=IBQ|BR~p!PzQY)}1p^<?z-KY=
zU<SUFfhRNYYzDpqa2~Z!To3RW?BJ}H!TuEkZ)f1jU<;<R_R?YCqZs&P1|Gt|6B&3e
z1K-NPD;W4S2HwcPzc6swL7mqRmw{_B@R1DM4RD^+b7oHBmJVdFkB0Uq#CoX2p*0Nl
z`=R}RV*6(}bOG{mF<*v54UnG}bNFm^aQ2$P{}%?X2s(IYx*7;LPwM$LH8`gckc+N{
z5<kgh0)wBa3_Os5$20H^47?0*9(6@r52`qHjlupg18-sAe;7Cq45Xdan=ary>Xx`X
zV{zyd!+g(-!H*>acVpn^hjw0`8L&JL#N`=<Lvta2B<5;36bJcZF)zcREQWlG82EAM
z=c(9_HxAW6-YDjxdD?Txo5Z{Vhki5o=jwKTz50Ojq@Gu^2>Y>Qu%E)f{TO%@^#591
zPWU`<aF)(spU1!tGVo&z{2Jgqspsmz=Y@lOUohBzXW(40k<yuNwE^c*?<Lp8LO~-2
zduIk7#=zql_$CH^jDg=`;O`muPX<o^BMF|=bA;ft%E2Y~2E4QSv4-}a#q|T9Qx48%
zGuX#7@Jt52je(zG;7=KNE8sk-=N-A@5~~iO`8RR-f8x+!$bX2rp9~6)0=%<&n8?6A
z8F(c0|3~Z}J@<j4;u!2VG4O*7yn=yWVc<;+{4WFV$1tu68MqY#cV*!I3_P5HFJj;;
z8F(54-^0L9Gw{m{{665|BPy&K{H%A-+MgKg6^C`MD;)+tih<iOa2E#d$-q}I@Qn=o
zBm=+6z*`tNm*I1?p$y!bflp@OOBnc827ZQtUt-`77<e-S|G~gH!#meQ4+cJffg3XL
zi3~iDfrm2iwG6xja2~}G>mT$5c$|Y=@;o#J%xfW+JP%C~^G3)e&qD*-8t`a^T=G1$
zahP`j8=;+z&)pfgKHxk`^87TgjDp8l277mCFL|z-$Uca{ekrt<Ja0`@{wxOjEzn-_
z95#{tQ3m@9&|dO<Hj({Z2KzVAUh>>FFdc%&Zw7lV_`r@Q{twoY|H(TL@XqR)5A7vS
zS+d0nuwt;E1MMZxe*@c_@K^x3<oRzL%vUn_*#hk)PivCL_D31)sfEFz{+{!_L%jq2
zBMf}0DDTL5o)P{FqWvSIJblBWL!&5P?<oJku!zN;b7MS%LnHkoqJVu26&>yeBIuy!
zqOgd0{t;9_aHya3xu1WCKd^u<y`wz+V}gM*+9gf^@`((Kj_~!5q=LLd{X+bufOlYE
zgnuBN0dgKGi8BEIxjix}JR&UIz(|xZz~4J6I>O%|I5NT;Q16hCFkjE8Fi>O>lFm5N
z6a3qE&qdzBQNf{suzZme@COP)XA>S0?Cb3r7V7E0&_6UvlpdGR*V{M9A5_Ca?~q_W
zQSQN^0bx|2f0SorlwVjhxX2KH?@-{$FB<%dd2qSdXQV;6cSMw=(8w36M^QG?&EXjp
z;T;+o;2+`X>mBax8yvOR(|e(JaEP~0h`#~2K<^Mx2yb!a(e+Fxr#w9aqC<T>Jq`F&
zR9KXEh@|Q~L;d~z{QW50-kz|Wu$m;TjOq?vk}tUEK-_?lQJ^tIrHt_R4oB@85D_+C
z)c)dpjVaKwpgLg71NShkq*ww;X8+_J>>r8ROk6%3O}BSMv@c!1pqV2*=Yxg<dKFc_
z=xR``hz3PPg@Y@HN*0y-pW2P^_g&~28U}2lA{I+EpJzx|Xdpaa<Q)ZC+s`u~7-$o<
zQ>4h1_+pLz=|Z5-ghmGYfi?r~!xs93ZbR3Cs8G14U@--N#ssPbonrp{U`cghBUo5k
zq(E*_{t=<xA(UURpJ%vtWF)Zg1Nw~!1^P7*QU=a8d?WhRoPL2JJ{^KF#&l=|{UV@W
zOz0Og`o)xf;X^|{jN&6tFaaOh@nJeXvV@8FFbe_9LjcnXU|Io8D}ZSQFs%UP3DXK-
zS^-QeL`8$CgfNv5dK1F5LYP(v(+Xi)AxtZTX^o+!G4x;zJs6{FglUbTjR~@WX^o*D
z6KHP&?M;w9^l1W9nZO)Jz*iGw57U|;8|ZTc^f?0h83Fx_fPO|m4<lfz5ir#Vm}&$}
zWeQW7!c?X(l_^YR3R9WF98F<bQ<&BirZt6W&0tzHn92;MGJ~niU@9}{lW&9~U}7_v
z*bF8%hl$OhkvVi>4lT{03v=kg9A<0|)0)Gy<}fYa2qxwm;Ve)IpfTSFrso^sGnkfd
z1QYX-0QpAP3Cx3!RfJ`Pb;QRBkTWbmtUxS5q%uB|86WA4kA%iYO5-D`@sZZ}NNjuo
zDiV?#AL)&c1jiS`E8!!t@saZQNN9YdG(M6VA8Cz`WX4Ad;~S&m8lwwC!r~jF{EX2R
zA^q`@0QpFDd?Y(Q(j6a3j*m3QM{?tvATLPze57$ck~bgq3cd-dR-{8d5+WZdk&mRv
zM_S|~A@h+Y`AC#}q)I-LB_HXMkA%rb%H$(y@{u<ANSu76PCk++AL)~i1j<JW<zp!#
zrSg$f`ADmLBv!r|(u*0oOe9o3QYs%wm5;Q_M`Gn8wepc%`ADyPBv?LDEFVdhk2EVl
zniU|;3XEV&3sCP6AkhkpV8aQJb_GVTECQrm0TQhMNmzgsDL{%8AVmuJu=xc@&;lfA
z0TQ$T30i=MMm#o(21isDJUrs@5f6}fghZkh;4u=3R)AzGK-v``?Fx`+1xOPDq!$5_
zumDL|fFvwH5*8pW36PQnNKyhMXaQ2P04Z63BrHG@79g1lkdg&R!U7~{0aCI6Nmzh-
zfB-33fRrpiL#F_VR)9n+K%x~O(F%}g1xU04Bw7IytpJHufYd5LY84;}3y^39NVEbZ
zS^*NR0Et$BL@Pj|6(G?HkZ1)+v;rhr0TQhMiB^C_D?p+ZAkhktXaz{L0wh`i60HD<
zR)9n+K%x~O(F%}g1xU04q*ejat^kQvh(s$yq7@?13Xy1qNVGyES|Jjx5Q$cZL@Pw%
z6C&{mk%Wav!a^irA(F5VNmz&^EJP9(A_)tTOoeD{6(X4mkxYe1ra~lBA(E*O$yA8%
z<@nZ(@99XULevq2_~wr9>-ffw@9e0P2=N^r-{O&Ig-EnQBw8U7tq_S;h(s$ygRu~4
zSBNwyL=qMv2@8>0g-E+XBw8WTwGe4nh(s$yq7@?13Xy1qNUcI7Qz4SD5NTJ4L@Pw1
z6(Z3Jk!XcTrb47$A=0i8iB^b2D@39dBGC$wXoX0$LL^!t60H!4R*2LpMA{W1(F&1h
zg-EnQBw8U-s}RXlh$JjT+7%+v3Xy1qNVGyES|JjxF_NM&lA<xvnK6=-F;b*4(x)-f
zt}#-iF_M%qQlv3bq%o44F%qURQnE3UhB0b>V<bLfBsXIuFk>V|W29YUEPd3SjFA+L
zkxY$|K8=ysjj^Cnj}xM<W{jne`kxSWJYyhXPkU!qYb$3@*Ky+}*?D++SXn#Uc~Zeq
z^wJ7U_ah>s=J_ucorn6zz*DdY@tq$I)-hnA;XBXMH)x(GJ%gtr=0`@)pYIK(`d|%6
z0V{e{309c%y`>h<!J#0Tzqj9Fyc&`u60L&iwGT-Af6ToHlvTynw%ZB@6tjYg3Q7<`
z6f-C)AVCnp0D=LV)C6guB?;z?8FLmvG3Rj10dv4(I_4|}%*U*l`0HIYXZOR@_1*6u
zcib^<jnTb(Kl|OYX3fgA*4|xFx6RI`(%xax=(LMi!Zk2=uh=gXTdutEuBaX}UVHhW
zBhnvflQDeqgbCG?Do0cen=-0m(xl--$B)cgm&wz{r#;W8%0niOsoig<_xav@*r8Pu
zC(wyWV-Bs#@2nM74jnNfqH$x!{|%*cgW**vWK$+qCr5@)7@<vEZRzsq0?F{?{^Tl!
zWWun6s)kQSaMDgYMFc>*q;!ap^DMS(zL(FjtDZ1n?39{+c-gkO#V)mW-~SJ~Y-VEB
zxU{ePhnFqt<BAP*UGTGV_>_qg(`iEOmVQ#DHpspKEUNDB5@t2IYFtgF?;Eurt)4Jx
za>e8^X)io^XnILaPy5Zhmz<n-tzJ2)U8O^S>_+WYxoZ4~ieXbm>TqGq_;fB~e-9lt
zVdCTo<J~W#I_|MQYo<(|I?~#up~<OL6>Yv&GhtFLeiDb5Moz4%@*Yw%v1;U)bfh#%
zAQ|!QRy40^(-Iuv)%8y;^dD*<S5Q9b@iP}Q9?Cy*XzC5A!{)7a<<N-}$9SDCnOF6g
zVH4G}^X`AiAl4qws1{N_Y1f|)!D>?XpX@zLr)jF_R2NgKC+Db4nlN;%ysEAmUooy~
z-0+%w_~5Si2~XvSG3m|2rcX}CV|J2e618o15^LDXr-)thU_$E3(<{^2$CRo{>qA9*
z)5untj^)Oswpbye!J`)V5K%oQsftmsGK~o1YKM-37w;%=$fst?q|xaZZHc^VCe%b^
z-K1#p|IkZyjFt}P%;}PjQ51E`a2?p?Dp|79c(7)#tM^!wNMl@)Z*>}3CRXTFGLMP1
z$4VXs9k7(t_}>rYvam4B68^nYYv@ap!IVk=G=}&npAJ%UWy9>GDZ?gB9y57L@;}+g
zFI0^$riGfS)Q`P6T1Zm!`KQ-L7Nh(U?@k9`Qzq)X5(ien$p0X57t(ob8au{JNas|w
zLr<`xGutwaUda6;O(m(jOiBY>I^oQY7WJ*8xGB{>z!!~osQO(xV;(;>>(qG03l{B0
z5^s-nL^EVEUNzFsw`;ZOpnIt1!F0r(2GU8zL|-=sWor{^()ssv_C5~Mg~rb3>T;|-
zu`4?6@Ch~3a|2BCeI7!y)GKV<gft+h4xA1l3)k#<nx2Q&)DE#zCi^H{JIvSVG>vN>
zNQdegXtW&Bn`>ENHV;W!an$9MF9W3JndX%0>Pj2@vKz(9LIw08G1cbObkb?_zRxVh
zMF5v*(o#3e7KWu79a}j%&0Cd+jG3I4G-=q>ae3iR@nSK+6n_C0@2DMvR5PiORca+x
zym89-I=gsRVai@xQkY6sqN`M)houu+jpv1Nm3PF%p=pXtF-)(>`ML&{N|)L~t#E8r
zRZTjPpQ`HvX=q882>$7{B}y&(9y!g2X$DC%cRE8JpB6i*n6<?oskT`$a%8mz*<zN?
zw*Ad@y|B27F==$_PQyL6d3l;vZGJIj$@iALEZ>HuCUnS{5vj7O$D|`_Z%yOUk@=Y6
z=_q=lk7DY1RcSeqyiVn>eOt~*FKTtAt1L@Q55;ul!);Mxb!*F_z3DQ9nr&K1q$X`w
zL9pN+S2ZzRpwRlHsD;r}#*a#qb$-LpB7h;sVM8YsmzmOPDZG-#(6N<i#U60+2F-cQ
zA^&YLFBa5VK-X4QCaD%jj`?R;^#33qSv_=Au_|1`cp7d-7PgD>DUdZoRU0X{k!dWl
z`N>tbgdd&O{60>GmuwwVS(#c|y7r+lwg^)i1`?TIt7j`&F{7lFQfi1Aj%_?za;{}w
zOTJ=FbBW@pQb(nsD3_op(-P<(3ZUibnAELO>$NM9={k{LLDD6oIzi5=_IhPr7hyG#
z=95%le{b4})l>~1GcsLO6E5OVIZj)W!Y{AgF_Wx2R!*v(aESLH_r<#Z|18c1CrzsM
zWlg%SHzHj(D^}iV37C4Ct~b?AV-wRg(li966=0f^i*>3khl(9tF+E8?{E!i~ZD`7r
zbZN*`wvDxCOLQ+|b(>EEMTsZWsHQ9HM&cz3{I_w-cUNhIA6_gdD{CgCOQ#kQ8lF5w
z`_D8F6qk|pEKPjF$7)ol-AWD}K77i!DVi+u1+!W?Ua)O;ovE~r%7!#N7gdL+Hkqa6
zMD2P+OF*qNa>H9<+w1vRT_xX~)V@1ic+~#Y%i*mjLA0Q{_xr@0-&SO)A+`4Xcs=cu
zYjLgFRJgi^`HyCOgS~{=yl$_1XXU7LEx)$I)HV7N-QWEz;_9tv{DjG4hGTN9bz4zL
z9mUqW*<I@uwHhyRU13czbV^za)xKJ|;1gRh4fso;28!2|aqa6l-?H~I%=x`3#&z$l
z>lJxg(RO-bTH&PWY|@zFn00J{U#HjUN8Pc_uyoFnZUCrAOZ;@zHudAwS1XDoLE3hv
z0c*m@yrfC*u+>-Xd$a#_JuqJYUm_sGM^BiL=dgV5L~$>JN@GpLmdR;wshp^Tfe{l9
zv00)h@)G^hx2Il1*+gwbd_XDkucO@G6gKn8Nj|>PV$vH+F{5i+SgBbe8((scsPj8J
zSH#W6FFOq?GS{oM^M*|l#d}R_i|{2fHda?l3g)D=rb^LHlYBaisf)f9$>Wf>#py<i
zs_M8NDAu=QMof#G+kkYmHoPjYBo*Owqlmf5BPegA`HjA+4wcB&bbcw=o;=iMW#g&e
z=lgJqcow}%o4d5LN~`XP=^!XA#+QgvvFs_TXGuIEoi^20n){ko47wp9d!ofiv8t;b
z(iGWrlrnUB?H{QX>V~2GhPoD{F*!Hw6!Buum5wUX!fjGImiot|7C*1a%NLD{*`z%;
zE17x853)s}ototQYU^H8X@ze!$4sg$Zs@5TQ?ukARF&h~7Y~B&8>y(Cl$MKjo|BeN
zL&vE+BS%z>OgE~GS2J2NMpJAjtdY9#FU{7q=c6_0E%{8MIFd=8q!HT!sW<4*O#ao;
zqEDooi>iiK51nXlU1E^1rBAWpT;helzoj^`C<1{)tJv4-43!udH*~BWtJI!N6o!|4
zre&7ZoQ?e0?B<b4iyqxRR19uuPA~Std7WCNMNduYO%olDs~S2f-9VGNb8+)lj=8_6
zMkXID^hMak#*9z92{aY4v<<C=YS+agJ2mc6wR_`q`l1a`?P!#a|EqKnK)3s(gZ=To
z?#Zps8bRtU`3|CNKX{V%d$2cZ;)E$RsoEz^8Z&BqUIW!-re-jy_5dVoQRMLC)L$LL
zsNVMvSZ5GWrEsSiswj%?Tv8G8t3?(1IxnA1rSq~$lhZzB!nmqKMpvbqmzHQ=Hkk43
z>hC9Dhm5K5ov06tx?^r4PgT<87w-bNKv47qytG8#K1Nu7PZs@1*9hk=@63}%Pf0uc
zG(|3P-j?5xN||0Q=Fh6BW76$swrsc3EjeClmYZB$4f3`9<aC{I2@Uh--|4hH-Hlj#
z@nxj88O8l~DEZ$4WCm2hOWMjChGOH)7wXm&e|zcgHI#F!Ykt-?Gq$<RjMq+?#nFD<
zTbN5R`Q$gJ)x1`t#YSd$x`a_xF)}~YzVmNG&xAAr+rG3o+D`{Sb`i_=*@c-Y;|rT<
zaGsJ5h*HfLb4l$%RGPT*O{%%uT8kJuDjn^liLtK5*LHq?XYIDvTTB`!vObOa#dfmD
zH*I~YbE)jA2+oH5ouPpi!+u;wXhKaVE5(6>cU(Ki&$GAItA9Vdu-EF&DSWUfT-DrU
z#b2VwsIYltvVpR0tyCQC<YUT7X$(vk9O_=ntK$(>BZummMs39vZMN=0pqE;i_>hdu
zN(XV9|K)Q{Rk~7=?d$wL#U|Z*?5FrT9h)?|s=B(kida-a+D447y+1O)(JI<jy@hJZ
zr0R4~XY+h&jx~1fTzh<%Un(}OephfhX&F&B75EZ6x21FuE1lW-2||9e_WH$<tJ-_Y
zAh*u!Qf<}P+tbyKG>hAPwmwDFm3N7=eJhl13e_#lwX46nRatSvXnrj(J&XAHtX(@D
zJJ1PjHd>7J|L|0|$jS%v%-_h9>*B2hE=o(BG3Z={E-;s-Babu#6wVehJa<V=+Fp*H
z01bhQ)JTSphKRsL(<Y`t#Wo~GZUinGK6=bV#)i++;mhcJh*x;bww}8SUQ8p1U0@no
zWA=o!5vm1C?urtwOc&@T+8pgi-nL!wIVIqHqyM&czkm9;TE(>V8O=Wy=j5OB6Q2$~
z5&A>H=Yk&wp1zKvNV0P{xPNXq@&ils2N_Q$Dqc)K?&nnKkAVFnp??YbS<oK|{S(l?
z4E=oQkAhwrCHbT8jB$TH5ll&(etucdiVBsNe*R!wdiv@Ahg*93*~UH>BK<4r$Mg07
zpDn%qC#&<_O)q{7_z>8kpZ<T8qo4kL0MXBrV4v}s3H$o=y8Cl6^o+xe;Pn4r;Pih!
zIP-nkxcqz#`R<ecRuX?I{kT7)1XB`!J^eVJAefT)8|laSGlD6Jvz=^T&|JUArWaj5
z0{l4e(~QfGK6B&xbD?KH^3M#ZUXF(y_FwXy%uck={>A=&DDq{0_fMS34&&yZgc4`m
z{F6uGjGMPZamH;9>XGH`nsiDk?+NKm9-pd$=J>N+jWsU)iO_qwl<%AA$L$=Q{#KHH
z2K3h!G~0hG{q6eOj7Po7s3iOPRs`37D40^zcR>4mC%x|aE{FsD84bO@UBUGSm*_8m
z{ypetm+1Zfi_8D_p=bYMJpY3Im7!lj22xUa^*_1Y&&J@a-|Y%@)}IW0_Y%H$2_Fr9
z3hW#Q&i;4@IQygOPD%cs3Omyfx6{Cn2R|Kr7UIM9KNtElp!e}g`7%EKInE@l_#pjw
zJlm(gm14WvH{*iOg#F>hW#_~6<94P%&-y(T{7l$+2K+2=wPB^`|4JDb{A}pgF)n`=
zq#yUECG_V&zYX*sLC^KWxzO(hy}td!?Q=at{ZQyNce~!_1(l2XEle-YcGU}<?P_V%
zJL}g!uPHm{!GG4T{)fH$vp?)#0Dds|h2U!$PpJ6z61TG}^c-h~fL{bV99J&}KMDFv
zz%K*me66}ul0OU6kNfkRU`mPu+hIM#jduJKyRy?H{kWa2p}!RVbO*l-+`nf<`OX3#
z2L0vW9B)~VT;H-^pOWk<$^I3vb8$g4zY_d<@VVfMm6GgS1^#0}Grt;q8S_7(iqF!I
z$H(XE7-yfa#aX}GAr9BTeot`byFd7~(EInG$o_TUXG70;uAX#C^8fSn<NkAAV7v8k
zUivSf_w|+Xy&n0_PS2IZZvgjsL3X}OKc4Rc>2IZIM{92-agGCv3z|8{0so}D^fw~k
z<`xI#`&Ih!e78b;*e^W((ti#8UeM2h{o%0x4fNH}Gd_ocv)>&DeiQ8bdPC*98T>Bj
zZvlVNctREbg+Cud&+`5N{kPEn0X_X+RfbcNKer;^HYI!)<9hfm{doNQKu`OX;J2l}
zT|dsa9=?a2snFAo##kjiXb<RiH0CJDf3|a#MM)3p`>vk{J>&K|`0eR$*MAJoewV(+
zph$Z8r}X3cJ{cGOu-<2bvz;t3E;~P`AGhQELi`tS|K<vnm-aVDz5fdR_NaI2`$Nxl
zmyhSlcM<H&fE~u|GT5R2H-T%;@^U>|VrM|oD5+eWPcJEGuE*cg-)`py<I>X~AD6^A
zK0gKh9jS0`$LCq;IWMmS|Nls@xqgij|NR`GP14>8`{Q8ePuMvIcK!vup99FByTEUQ
z9me@V*x~&9F7$sP-({0cB|WH(dAZg%9^=^>oc0d^zdQZycC-doDjt##&Nas=Mf=`Q
z#h0ir=viNHf!~w<cKcr&*TYiC_Xp^CezF++-t@QIX<AQSW<T!(-vONc_dw&Z-p3kO
zHcP{wsj$O(KN6gAI1`+4xDuRkxDA}`r$te!TrXS)b_CZN(&MnRan%dw$MiKPMG}7y
z@#&m#QNIs?4+ZDERt-))&qW`Gom-*T818;P0saWM&LWiLC(ms(Cn||ghhAk@5`PrD
z3HW2+oxvXmuL6Gp{3!4Tz;6J565RW{{NcQ_wVX^TNh|87_j(*A7c~3NdGJ;6r(nOe
z<tsaE58M|#4L!@teSx31$j@h>KLYkO_PU=ZfOFnC9h~Q5-0!o!tuDt?Qohe3-))WS
zp>_K4eD?(BdD@}IW1M@Z_bTaSj<<&vG;{48-2Mf|Wry>T%BUne`j#r!Yp<as{d4I>
z=UU?_NxvNQ8q<`bp68AF+wE}wLi;|yM1RgJv45#?=^McQ%_Vw2f0kZr75C?<68-bW
zrC$;H#o&zFG7_c~<IvE!9`r3<p6>=F`j*gZu6O-*CHkG9*SCSWevcBp`jnFV<apxW
zgC)-Kq^ra!iSvA8pMqxoe9Fu7y$$>Y@Rz_}1lJl>DWQs0;J?;XO3Ih>qclq5FTu`w
z;G72=6zXhWdpGyf&#z>M{h~hftNkzZe%=-5*)3pab=cY7xbl4k{?kvb<^G@iq+Z{y
z_J5;a>wlqd2LJVKY;K?VHU=+?=cXvH)<|w=5IE<N#^9_+#aBsj<9=b=g68_wnUdS@
zX<YhukuT5dXy5Bm`UTK)UekBjyZvq@_8Wm~kLG$`=g2<uO<&_zq?j-5YwhZG8bHrD
ztOdRhdajGE0Oxfjjmd7G`F;U?f3u%Zh1MRfuSCAokAq%))Aha{ke&6xk1DY<2X^$W
zdT!^&620%UWWOo&50&USE?tfC`Zr+9PBYliS&fqThTz(hDybg7gdNRIO5$IEs}CxP
z^E}PJIZ&MKWN*_eU!C=N91esX#-HbP>|e{L_bbUx*Yx9deEb)04*NV$XaUZC*AkrV
zsug&TWLHV{HwN!p(9E^=bANn(k$w~K1EJS7bk~mrZwo#id{gkL;O)SV1m6t&MDWeQ
z&j4=^em?jX;IqKD1iu=5EAX4awFdU`8ZP45B|Y(Thx*Wqd;e#>i|=5%hC%P+^{RpI
zX3y6Q+{eeY1MgtZeY{mYD&J1Vo7toD;r86eN#{NuY0a$UeAoQ6!u@sL$9Q{tbiRi@
zcYmGtH}3vA_xZ{Fb$)>9JKLl4Q|-C?>wJW9_t*Jo<L<BXYUA#&^BUvsuk*>q-CyU^
zjJv<i4>vx<9-aHR>Ha!D-gNG-^OKCbzs^rH?*2MI)42QV{9NPiuk#CyyT8saHGZ@`
zI)B@qyT8uo8h3x4Uu)d`b$+99_t*KY#@%1%cN%wpo!?{J{dN9;@!9t1-1qtJuk*)E
z=l(i>+PM4c{5j+9uk#m;yT8s~G4B34f5W)@>--(#^X$>N##|-$*ZId8SGd2<KQr$B
zI{(VJ`|JE$<L<BXAC0@e&VM!T{yP7|_y_jr+~-&K*SXFzl-ytEzQ1*UookP$<o-JM
z>qhRcbFJN#++XK@eboJR?)#hyd!O^e?792vTywUP`|DhDt&;oeTyvz7`|DhDo09wM
zTyv6=`|G@earf7GC*xXEDLKE=p1Z%!yBT+Xo$qSg{dL~QxclpT5998y^Zv%&U+062
zyT8s4Fy7f7ozJ)D?yvI^#@%1%qm8@2&Z~{Pzs_rnyT8sS8+U)5Pc!cRIzQa_5PNj~
zgFSbDogZ)9{dInlarf8xX~x}O=Vuysf1RIe-2HWap>g-u`K88>wnyhp^hZkWuk*R4
zbAO#*Yux>Hexq^s*ZHl+-CyT-8h3x4-(%eUb^d_y+4kt%uV1>q&L20O`|JE^<L<BX
z=Zw3*&R;a{{yKlfxclq;4dd>w^LLETvq$G2+4D_vH5B`r|E3pxz1kU^`&r)?Xurej
zI1QlZ`Kt0$lKy+xr=EP}LY>E%ZIX}fkM9>`hv(A1o)_o-%h&CZ`}#cchb-U7eZCXt
zIm7$Vllwdp^?#M<wKr6f{#e9k5Afr_IS%OFV~@{7=y^VNhH=${?k#b>w@>9uJ=<Fc
z=<kF5AK^~}8BQtszd1Pl_j69Y+!6MNKu>>W8rK8;xddF-roCJ`6Htof(ix_b9(I8K
zgA)BW;JWtb_WuIsKHYGU@6XUTD00pI{0hDYIO}~pxUMO9zB9lX&u78u&&J@qZnZl&
zuUj1nPCI^IkmAYywSnnX?oNm&^QHe=Lcb&QzOR*i>V2G%{hgriXLh3g0C1kOO)@S!
zJHyUl(5p^8&c_>%=fkJLPG{IT2fPdTmEc{$Zz4~B|B+r(x-&l%?Q<9C?=!CQ@;dKh
z;JOCw{yzg=k*?u7SNWA>ryh8Nf@Z!9IP2@@q;WfaOfP#{!#f{c!n+w)zW2e;J;B-j
zPXcE<p9N0+d~oVN0;m3W<MO{7;;d_MO7fHKP-kUI;<Vo%e0jvJ3cLaMRPY-ShfBd%
zfc`4*Wx;*^m;Y;|ACLbWft2JY%X>fgim>D3VJz3Drq_e65xD&g(|eVqr~g}lbKKy%
zVmah{RbeHM!@Pd_SPAF;i+WwlP?DeI*C1{yA>S{-R|eNLcO{i;74X&4-%8Q``X#(&
z32#@zhnMinOZY1#yg~hc_H(}yeqsrqSHgcQ;Wf+D<*PG!Zzrc3S3KDs*39xE&RjS0
z`WpLD4fN!^?$9vB#PeOw^s2A!sji)`1Usuk-w1pS@bzJ*2kbP5eog2bf;R$J-&B%6
zJz=M5L34X+485QGDsG%-yF$M<^jtrz1Mc&n^4%5rR>Kb0SI2^{3p=NPHvvD_xa{|W
z{p+Bo{r|7y(;fcwhCjRykp3J9Kh>ALopAoz4R*L5+W`9iH*xC&`~QE4+wSn^e-pQ6
zh{Ht0lkLavZ&7<@`#B!<)ff3*1Usy+2H+bZ-_^idfOi4cnC$iI{X+h<0;iqk;NDNw
z&N;tyGW+8F;C~<EvQPiVL9acX`*TEz{sibbuKM*N<+~^B++SiR6{Seh?*%>MxiQMy
z*7Wk9_s#AI-UfQ^Bie#{oRzQ6XuZ6{U}sb4y?;gh<PyEdO?s`t-2REs^ZtR;jY~fO
zdSADzy!7Yt68%-iqu$RGWPcynzZ-h`^Dwy92JZi>#${(9?7R#85$Q$Oe-5s-iu3Qm
zIgk7Xz8UoErM#3>uD4*nxpDb32>$3yMoD_MbM<8<@ddCm1AKGjdoDOX*XHMGveO>=
zo1mxtJB`cFebe6_hi9SZ{hx1wZvp$Cf^P}#=dALFd}(Evk~r<G0nT!@DB;_b@NVGr
ze*ie`k1XN5znc1!O7s_ivs_xUDd~aZ(md$37x4J&o=>Hyf3-xfKJrg`-6Nr-IMe<g
z(C>$OUp4ulBt6G}jde<qcK~O61{zm3`@{Y;=(&zPu7vZxYqp=+uzvvTKL|b;{1@1#
zpNpYqy{uyEc9pkv(s;cz!g`+fiLDRb3Hf#g*S#xlXAn5&#~ScT=uZOI8K&Er4L%h7
z9^*QP*&6;YHm-8<oToeX9os<P$GGZo80_x_J;(nc;5-jG8Fq%l&e_nfg?ul9egyPa
zK))XJ*Fmo{1dq?{(Cae=&gX%1{r@C5+vkh0KN9voho0kkyJb_rQc|2b-tKK&@f-y^
z`$ErnP6X%Y{?37&(Xev`^z`Rn(Cc2Q+BlTx=Yw+|d<~rY(|3)>bH8tmtGovx-$k&)
z`$7#DaoYs-wPJd|lI)Cy9Y04^oO$lFo5U$eUk!c#g64XmzS6k#<DmC_O|(A=`ti^o
zUSj`L=qEt$`@v}cP3Y<W0@&Bs>-G2p^fj>m2lOoOa!I44@*WKRs>Y)~I#X2==Xf{?
zc61HJ{W%<Z=6gBxdavtwJ%xI|&MZGCL;p&N{oi1J3iS14Af;HYO^oY7XN>O8mL>YW
z&>sT*z!JU6qNImu(CaKzDf)8_^wXigwM6gdlY043=y@*3c<LT?B|YdK3NP;)CH8f1
zt&$#8r>_6DM86n%efGrlI)hS*<?RCgdU~(xcQ-C`N5alN(6d}s&>sc;_!9jQ&>s!`
zi6#2Sz!fX^^99&B26o<no_;Qa`I__oI^f5`&PJH8X=f+skAuEviGCdP$3s80M1L{#
zCqRE?iT)PoS*|C*c^%~6;D4n$_IQ2?ej@Vy(Rge>zHU)F(O${z^u@f)xJ|}9eiHOY
zl;~$ee=_vG-iZFZ0R1V@zfofUFX&H&emTsK^uI0U)6<~ex<tPp^ru5VyhML8^t$%#
z@jSake-HFCp?{=AzYzK}q4#w{jAtV|m{$Fs1$|TFQQsB%v!UOuL_ZLEw!@3S&w-sQ
zO6<H0z4qoFx3^35&6iIFN=fB95Bg1w$8vRm{(R{70lxsevc%58(6gVO0e&IuTu@@?
zO6Y0lRq%^o=e-g;D>Nv=P{iS4=+`hF<IoBEOQ7!qJ=eX~y$bt0$K$$@=a$!HcMAQb
zu)j+BTS@+GpT>5t-)7+YY_fBmF)B&l3H(Ly9l?37LOa%73On@EuaC(7&amTpwJVmF
z*AaI52fgf++3)%f`v1wk=5&vP`}059?+*Ri$q%KdZ=G?$dH%c|IOFN(@bdGr6m$2d
z3i_VNx6Dso|6+VLgq_~7vjRBv&A|IWza}{Kn}YX+{y5_*7tbqBhMwm<mxA|$of}K|
zgW$|}KKLH6!#FVCEuiQ1$1dQ!zPvy9%CJ8HTx&wFN8W$3C%B(itNrkL^eospHU-b^
z@cf_mC+OOrlI(Dw+p?gUpA9=ZgY$ZQFXO5&-hbuSAH`>-yxgCCVCQJq9}GLZK05+j
zdn>myuEfq%@Hb)qXxNzzJ8W0yLVqFjbD(FOslNgFGX773v%GJEvtGVIzE>b$?sNA-
zdsrc9lvIy<gRf&;@xKywHiDl1Yze*2*gej=7fwm`sn@k#CE33UdY$<wNzeF9g#K#i
zwMSEm_O;ekl6}TsYbvE^Uvs+i{)odhu%o}dT)bW|0Qv`DM|&~XKMgzD%R7GwdY1QH
z=)Xvgxt`Y%sQ(`N>tO%)68p<3Fe&Nbdgxa*9^>PmPuI&gK)-Q`p5Je9BlJ6$=y`6S
z*m`++Zou;T^$3}}8Ttt&_K!5Khg+bZQKCN|`dgvbnWs{W&&|-^2L0V7`iG&{HA*k<
zli;_*4$mJLhfkru1N#4#<ohS|y0+!{>K-tqST5a*qNKO|3;Oj-^jdo;$qwg1U7Jvn
zox5O1YdNKuuht$)(%%ieY$`?l0npzAy`OtT{lU=R3;m%b_D_cXKIqRb(a(YYe(0|+
z(ccTb#t^TUM@#fCLH{81Z<XjjhyEexzc11M4z6oe?#~K1e|Q*nR>k=P$HS)J91nYe
zbN!%u0+m$nT)#CfXs&mzqx`&DdfqSU=g+Elu8WR^o!w9_|6UZ?c|HAjdFPs5{Autf
zz`4I$HpN6q`Eot!^JcWOx#`7OUY$WHMcz~3AGoe1DJfsxhpB5uO3@#-ANpV4>LuoT
zQ3>DLHjuLaXnK>!tq1sH;KNGz1mnt=^*96iGhk-{^sKM$wo#ECa=$JUd2gIcP~Q>z
z@qN)we7_?*^U(gAq~}VC!+y}WEokQZgYN|161*3<#x#%TOz=VAmw+FS_*@G<82a15
zdEIIwaD7*p=et=6?_peVcm#161U=6gs=&FAQ(Y@5Zk5RQ>w;#^>yJxWzmR?i^liZJ
zLLB;l>&)NFH2{1l?C5M<N%n_<YmKB7{p5MYaOgjPegydE;H<Adj4Ph(kNh4X`oFG(
zDajv}ciV#IapTcs)63h*xb$-nhk@XnuP1`j|C38NKS#iF{RF+{V)uvpiz!LtytBn2
zUMKbari%R-%GD2X>jGX0-W7Zdd9u~V;#dQ&YkBUEu6ZdbZv1=%+lj8}xL(%+l%%gf
zd3DC3B+hth?pBf;j05YP{iTihtB1$adp+NSjLSazoxby2Ne`S~?gVGPUzc#+-!c;A
z(pjI9@*M@v_1hEhQ)O3*e)2jL$EE4ekB0pd!5N>cz{fy;hjA6}N%->w^o-l<&_4zJ
z*Cl#iFUh|4dR{LpVx2?#8)80X{I>>w26p^DnHaY|rjPw)Z`gSjc6i@D`^zZk*<Z$k
zFVQc+yQVUGKRVX9{A7PQ6`cL$EO7Rh&63Ybis#Dd$K%O!p+mqqzi=ILLeeP7AAX<V
z83oOp>yxX%X-8{6rD#WeN=ck{{w!$b9QSs#a!G$sYD-=&&QoK-eV&T-I~eiliTWJ@
z&id880ZNJ|>sQx~l?t97H`O00`8cMhtan|5Q<DFzUtQBt5@-GDnuU@$>$ef|W&3X=
zT}slALmWC5H2bN0zddeaj7L514`=*&{>gc2Htg%33b%hN?6d!F49@eqUBG!R$9c9I
z<r)qB1n?ukKTeh4{>(70dU+0hmfhdZ^J?z1Jf4ahKfk#r^5y3@tHF7_^+Ir#>uTfj
z^WX6E9_Sg*cfsjrD{%U`132^D3!MH>2d900E{5%m>sYoQuP>F0?e<>SZ-9Dy4V-cN
z9DEY=ypMV^_{!E_R9{oTJAyOc-ND(;^?oJ!|2*nti-P8U$Iq*F1)qp~86U3C4}|{m
zl!>?7vrG8xCA=9p=l2fa_rZQ|aO(FpuJW#ve%v39|Lnh4!VdS*Y`5&!yzawx)e&~+
zPp=X_82k{#c{(_+ryOTo<$3}2$bI6`h>!0RrRVwcT-fKiqK|vhf02GXZugexpD->x
z&y$}o(Z2<~_E2vBqZ0jpq1TzY>whiL*H0QH`SUXLD;ZZmV0pP8`499PmFT%Xc?J6I
zO7xnemE_NY^yB{fyf3b!3+D$wub4O=3QqmO;2%Tp`<H0{MCd<(-sktI_v<6#I$Lvp
zu7sV&;5uVhQk=Q3)Y-3+?7W)(c00Uo!t+DT#Y(cn^TW4chyM8W5!t6detjhRvj}!x
zgFlOrFa23rhEt0Ea9@_XZ*94@FufjLhy5L4hwYHpL1<?H?7RUxLrd(;0_XUqvjQdg
z&+%<OILEh7jO&5%{0jU{`12F&FmCl#n3Q7NbPd`$$IliS7kYgr!rRH#;4D`!<I4W{
z^yB*B(6d|@f@_cI`q|+0rzJSY;jZAz!H(}!R9;?J^>v{9?2fqkyeWP;_$b)tcz%d+
z>E}X!bcy~f=&ypF_c^c~-Ut0#(9bKe|1$I%6Fi=8l<41wz6121g7dn+kN=7%<G}Hs
z*Xx%~HkA|~Uaw!#xa_dJ9RD@8xc^N{^zC5(YUsCuo_=<N{vGIhm+1F}eh&1N(9{2F
zaQ2HC;PgkaRZ<+-FLdovNpZU({q1ph82Y`?&UH4TBs;uruCY`}cCLXPm0d}Cjt^gg
zbDaMTb~JamKlNldrC5)v8`lG`8#XD?bKHIx_O~k0cZL1;px>=TzaRAPLqEJkKM{Ja
zD>N1<#qyp4z0RCHKIfF^uYmqT==Ir|f3mMNwvrweK>t{Y{$=Ptg8uCi{TI-G486V+
zNhy|h>D2a=^ztXrYc5lYdcS@x&g+<3lPk%N+P24S6WC$<)MrVQWQXmO=bT(umtCjU
zH4Y`^%XPBOHkG3P+6yR2&vp3GCHk4rYc1sEy0AolHS{+?e@lt}A?O!E|5S<oHR!p{
zf4@Zk4fI^+|5Bn~wtf+wB0gN_^Ye)uCpUne>->$4$M|mx{bwle&L#T3(DOc=fhGEp
z(CgZe*Vlv+{gKe~K8G14`tzZ`7xphN(ccXH7tr5bqJI*4jp6S93nlvZpyz!Q3rqAr
zL(lst_&H71@5;;6wFm7f+@HqAWBs;*Ue{t=zj=v%C+Hu7zGsPkALze=zOqC=9{R7L
zKcqx|BJ|%tKeI$X3;O>;e@%)0F6h67{^1h+^U!|>{p%(APocjN`u~>b`FW6=py%g7
z*d7{blbn*q&zqrdYCN`w&7jvF*4x8&CHfxF-wJ)d68(YDYftL-N0sQOLa()%>yIkY
zUk|<Rfp@)s4n^hFJx<Q&L4P9jPl5k{d|xy!JDeZi2j~3A&$En&{cm9ZcG$15`!Qm@
ztYlpEcn9?U`Io3~4*i|bZ(3r%6ZE{#%|9;_?ep_8Jl~iC``kaaPJS!N|C7>>$DjMz
zQK%QcUt0Pf;lJ-6<qyx#$E4><;)lTw?`P(9)uRe^*7LgR4DgFn=I-ZZCHw*7^0OxW
zxc+JAS*|6{`QhiM(9=)u`{<{i@2R}>bCVP+CHbR0o%^%7ap^ZjzS~0o6ZBodX=m3G
zJ9~ojdjrORAC7!il#?mR&r{Nm`?--|O7fHE9(t}M{m;p!>$fRr)*qT)bl%yx^uIvg
zt3*EldbZDz(DR(+9O!?AeSV&T{#*n7BIx~`S>>btVd%97^m4IXQU5yhzeE3l@o3-M
zmEyyFCC?LRf4O8+N%}uve^ukreiP_9ezqvlZv)PD&i2FWUxz|}B-+*a;Jp5&xk*WW
zvL2rS=edFQZc5Vgd_ZkUNpaAbhS$ro0x88ftOb4){A>kIf3`HPhd*Jz8}uCa`hhcU
z`+;*D-XH#-nDTJ{b!|vVZ__nm=lq-z$EB?#PD%Q|;3u#9a2()uRqfr}{(gm(95?zu
z&A99{4(gjqiZkQD^Trd>o7}!%SCXB@@N<leq$E3Ypg*#pxm+ro+d0j6)bqO1Qqa#S
z(cc04Gt=L0|0D3FVduLNJG@S+GYz-n^Fl%uIwNx4(CS_O>&(G<BjeK72j8GX-x_+|
zqvdwmm*}^LUVX&%KEFhN`ar)N^!-ch9|-;O(2p$9kAq&{t?m9yE72bVehu_9!LJ6_
zS*TKMCt6E8=l{3T9?&`a>1G)hb}okf-N4z-*^hYL`3Tb|6BR4K4(|hDKe_<=6``MP
zT;;kR{6Ek)1b?SQzYu!P<KLF(e}|s)nz!@lkJc(m$(0KBuQuR4(`#PuJAiXu*4VBT
z?e~M8^WdNo{cz~HPN*)?9|HYKi09EI`U}C&gkIM;+<&$!?J<=UA6?7yIB3nU6wB-9
z+tRO=eq67!BPH=wV29`1Y$txcE&W>Q$L(-F)n~7q7lxBA`lGy*^spNA8yc6M?V0oG
z>d@~1J^l3gR4?nh=G>qCp{M<WjO$@d=(Sc+l0TeZ^j;-BXl>y3XF^YZ^j;-BY?yvr
zuenu84~^0<=YD-tyfOI00x89KzGPevZPJh1c^`c3^tbcRj7K}aLBBriESu(fCB3{3
z?C`oL%ew{i>q5VsapgM$T-RKb#E(gTyPv$z_8923_g6}&q6zp3;Ol{(4*UFm$Sa^<
zANm`hXSp7OUY{j&Kc9o1<@yTz*z~vS7lE@}4RKD`6!urgxgz~<4L#dWSMX-Avm5Nt
zPu@?vA@swcXB@79{f(ga?}v%?`zq}4{<QDFIp6Vo@8?v<9yk9!x0K})|0nuCIA`mJ
zIQO^n8TrHem!=t)9p3-u--{wW?{7a3cGNfBpV{D#g5LnHYfP?x2Kly5c{u0!QVZ}w
z%cUnN$sfk&V&n3^Iqc7cp5xn%;9Q4141Ndf{0ICV@b8Q(-xlD1LeG5HUOov^l3v&D
zy}Vt)Tf$Bs<0>!h90>j(^b^4upNn9>74(-wPy3HTzcKXBmgrxDzBTmx{uA17m&&7*
zq!l`I@HjLPOi5hdQRbZIX_`Bn_b$}AJsgL2ew=aHX#+j)4`lzn2>Q0r&xL*JAA(-@
zR=YosL(lQ#ZRpvaeZM0=+riEXShp~4T<@{H`F<p}6WxoVB+m8HN(Iev-VFJ6FfKjg
z?CW#+xjFRvLr*_-_N62{te5i(n)7WBJ9CUn&p5vXz3#d4IQzMf^o;Y5&@(<<SJTg)
zh!4kMKTnW-jt>){=lF0OILEz<zz>E0*MM_8e8PB=R%ngq<$V=;`mbwwO7fHA63=Ij
zN54>AD@m`lf!ps6uFv2&=jZfifLB6)68Jdqb-|~AHvvD&xE{7jzdT=E>rs-QEHBrG
zTSNbNiT*io*5e1@tjC|h8Bf1ILH@8@E2Oe0iL+dOe}c?ylYV)*cpn1GrSB$Ek{#w-
zV_bH&g&p1}Ks&r2fc@Q;1I4(?bFfvEX-cxc9qczPX!eKa{M^6uTx(<KIUjL6c?kCX
z{7U6L4eddDTP1ORu7~%tY3=IqT)R+b{i)!3zmgv5k6(Wg{}}%Cl{h8w=fN8k^zU}o
z1=qb9?oV5A+Tr|l7WBJ7ukRdiJ43*^|2@RG_B40GPrvSyP(=su6HPDPC5;tspX0F3
ztenq=zH9pXIU8TD0pA7sn~W=N|3bcZfiDL4>q^q|b3+?Je=g#%9r$_RJ;1qN7zBPM
z^uxf<2cHB^z5A0~ujrV5d3;(!-w1YiKCC|Idah6C=K-*D5%h<Fp96j>IPF{p&g+#|
zf?o_ftglPJzlWaVo3Bq)UmV|jK2?0SM|}L8N_vgG9tXb;BK;2FT%S<CLeeQo-wf@o
zRY7xqybS*HdYR@3&$o-|Wv3JP?%+Fu?+yD$fLDSu{u97iUp#N$33g^cKMVe!2~PWW
zgI^9k*FP-pN2X6%R_u&?{|nCY{sj9h?^4$9Rgd&%O>pMh+_>`XjC?l*XTDp)4)fg!
zocZ<zXPgJaei!7+b8^OcYKff_V5ckWoB=)UTmVi#b+4dOjGOLlP*Qw2p6FgCCFwby
z@EnqQo<ma4`9<GR<L!TZVLjW|*^YCcN0jfC;9R#41HS-vcy7RXf#(JsXD&xPKY$&6
zPGJ!^*UzgXK3pezdz1gi!+r<o=feLX;8%h3{P|MwOH8l&+6DG?FQt<5?FqftSB$5w
zH7JSeo=lIw&ghi%pnL3{ZwUQ0(5nq7$<DRloeG-yb>O>#&j$B-N9MYvU!E_=F|H?%
zfgSFTRt0DMZfjije@;Jc|6u6Zel7)Py<ZK^diT#GC=NQ4bo*bKUin^?ew@n(CFyBL
zbBdDqgNOs?1?`F44(A2NhyCbg=ua-JXZu`dUQ)vE2EPgA;(5X}*nh|L3024k_j4ia
z@cU1EU##-d&Web`blCTCTYA<n_qjL2&$D5N{5tScVE-X--IMJ8e-F-jSyu&3N&awO
zptBk!@e5#IeO5{QLU5fGD2d;Se9r;D4g6B@+rj4=*Mrt7?*Hx3ADjMmt~Q{ge2)Xy
zXM2_Oau4v9#-(R_>j2L3_628ob+3_<?DvFy&7n%szQzjY^#49^eFn|T<=;0I%f)kk
z_S5C-XZ!Mp{d5iEvcrAr%2{6c|8@G?^VPK&CF$qDpY{dK{Kn+7>$`!oTw}p+gq`ET
zSzix=-vRs2g46zo;B5cDfU~>}j4M97!k;$KbG@`9IQvU4aIQ~=8kc>ZyK-I1xIF=V
zFZlB+?6ZCHdN=L({Zz`g1?+GfrX9Z@BesWj$d~aP2EHZgh2t~ph3lNVpuZe;SnoH0
z-wi#-ZS`euZy!TH1)TMM4|oF`_Y|Mrh!6Kuj1SL&cY~hmANGr07*|;@To<t&HiZAw
zdpne$imjK|Kj*0WdKCT~0XrPG{aix&$DrqWMq`fKXM1Kn4mSJphjC!PW*iQOKP;E}
zf|C59{p$;wIorbn;OoH87mUjvwK4bq4d`{P**WKH_S0`nuXuCb`5kudN50FWejfl|
z#klM|2)-Wlw6h5~?Q9GFB>dkI_8)@%-q6$jKycdk`<>+H!>}_JdfJ%=PCLA>X&&rw
zA4fg+agRVh7xo_o_w~Q(SAE3m@gC^8{_*qtqF=y{pR1|7$0MF^!Vb%;&wMG#4*l0>
zNt9%V=Z(KXPdm%W@sy&Sm5s~JWAM}WDbmx9uJI{FJ38xj&UVrjobmMgQe=nY;Q`Q-
zj{#>KYK+VO$Kk)`N+sEU0$g*4Qq1=}aGtkZ3H~JP=nU5Fu>Wc<{wMxa34f)8zinLQ
zqJ51aZlCq?6FB3ubn@Btw8Q&V$k!{;^ZLb8h{F!hKMlSsIL{~b858%1TxSmd#HSip
z@%p4+-tP{FeuMP4^OM2pkIn?#{xi^P&F`FgjcLvqpZO*HjS~I=__OJ6_w#e(D%b8P
z7w?DRyuTQB<b&I3h4nN2<mVjw!hR3vX}=%%bFk0vf8+V^DbP28-oO7%<x(GaKd*+K
z`92KJb;$Zf^m9Mu`j+P#+@Fqu{(1N_4g6YguIqRX_AvBnlkWe&jjLRDq#x&>K(9TZ
z^9qc^<6+0owPa@x=r@9%@!|cPdqS^kF-jW8G}d{(yBnANy}$>R=tqIS06&ie=eaBQ
z`#cx*b2ItFcF6gZe6yrelAh-heF~a6&n38?=k;{%U#j8%9N3uvejhmNeE~S@U3*U@
z`N?zd#RdI4Z-}_DeX@QB!5_w-_K$^~7ok5Lobj9m&T*CTr$7Au2bT9Wv!nLIb6tJ*
zQ%PKVb8l}u2&AO=^n;&jdrErPJN<I~FzDINeO}hf{h^;zqQA|!9&S!QZeQ1ul;qF9
z;g8PDmBc?!8rQb~=lHWrq0V~7ZMtz~qaU|(W#GRq&gog>%6Ivcm+O6fE*sCM*g9{F
zdi)E1`o38DQ__#?eH||Q^por42FUj+*rz{lqkienhtSiX267}NJ?xt_?$5@?<q!8$
zY!B3rho1W^-Ls)2J34D}`?ng`!+`Y5`909n&u_pPpN*1Dr5HD^XI@6WT}t#kf1`ar
zXH)i!r>^-bDPQ{eAvo={!2HN_k6n#N`+Go7`^SK@Uidu#jQ{J<)1Qr&DcmpWeV>%M
z$G@L(mFr)K+dy#Ixe8o$?RK63r+%enbH1|wAJ}hgTyfBx?sm3^o_0=vp7nA%^o-lR
z;FFQ>VsOr1TP#=SC+Dv&;IF{WWN`M!8Q}E)A>*;$pM;+NKL<`b?|?Jk?d^U}#hL4_
zeZgOa|Ge*XW$?MCm!G<q%<JV|*x~rk`%8IW@te?(h5gTApYzn8(6hXi4eILUHQ1>J
zXB^H2XTQ7IxXLvM<(daQ%k?qzY;Rvd&-z*fPJcSDQ0M>S$ag>R*HNxX;H;OK;QHSs
zUN5u38MiyYwa0P&1K`yE0?ztcYsKup;>Pv!#>O{EoOULI^ZMh7;M6|`{wDnV5d2ZZ
zZ5cc0RK7f)Tp9c^=v#u*PIqwH=?hLfr-O67cd>EBrxWtM8hl6a8)1j*|NFqXK70=R
zEyU-2@VCJ~1Lt~j{gsk~DalWc|1H6vPOo`8X$Sr~_#WWA4t|z#)eHT944n1;8hA(e
z|2gdQym~z?UQ?3&cc5<zJ|A%&1J3J2r-Hu=JJ%XleD;N%d!Xm|@C@`fr}uc=-h`gz
zT?GApu-{;n^yZXQF4|ugoaf#x!D)ZH5?%>@5%QgCT;<&#{BY<wzMT!ud~bxE^OG%)
z!+hwuPWX%*@m~b~9{5sr<AUNtI~y36|2lj0d^dxh@!T1l@$3gq`;$ue;oywJvnBk4
z625^x#F&!G#dFIo$Wg8%jjOzzk4}W1^)(axeZ=zuaQeTX#Qqo1)Bd;Mw6o&sDpf8Q
z*Q?FJxnAvRT;=M9{YXFP4@DeKg?=#jMbK;S>Fwce=nn*c3VODa4b~{!FUHAA==TO6
z0$yc2_TOpXY;PCA4(o9a^o;Wz;1f}gkAO4&_1CQPe<=KHVm$iU0i5$%ci8C+J9~n2
zUK<EIoY$(rIWJ5DXTHb6{?5qvEO6#~0qii}tH7D>J+Lzj_8)?tc0K^tnXtF3pTKFq
z_)xL6fAR)v<$6*4$=3vDJvJ}l+m!GcaITY&0Oz{&5^(1Gp79i#CB~Ugp=bO26P*3M
zaihBOvcDf=T=w@uf1d$8?>9RWoPN#*=RWRkaPH$?0;l~$8fQP{&v3Md(~Zaeayj&e
zruTSzcprQO>?{QT8Tys%gAmbv3-Iq?XB%*iC;Nf(K8nM^SueMOvtFJC=Y29Sf%CqI
zkHLAp?<;W5r@w;#igNu0&id`LPF=lloa|*>abr6?1^O!3zZ80o^Yfq|3H@s&`uD(D
zuHV6R7Ub=rp?%;)el7st$au<f$@_(%=lIhB`cd$+TZ#SvaDEPDBKSw}=Xh|IYfcHj
zAN*t3c@z8-@Q=Yi1^)^BSny?=<a$@!c)fCMaIWV!1HTJ)dV#b3k1?+JUzmQpzK(+a
zW5oGvaQ2ru;B2=)z&_jU@6fZ|)?2TxybIy~ir}=rcL}d5;is1Hx!{}^?gD4Ni%R$^
zcEL~eMLSKwS3<dZfa_Ye$NvCuo_ib){u%UVfb-mGmT}eZ6x8p{(DQub0dSUgoek>h
zMb~`Y&&`d?{%Ew5F3@wFIRpBa;Lo|xZw33efqw!1AnbHRzE480YbEaIt0nsPO7vfW
zGY)^1@Ku}E#fSRMj4M96_rv|!6MFW?5#a1!UxU;B;u5}bv+R%ZWxw0pc$_affwSHA
z24}uUmhgMQY3FHh+WEw|{5%Np`5t<<pN<<QVM_9!cFqHzih92id>!!Tz-i}0<ML-L
z{P_WT`tuv~dXLv{%Z<{Ll*IJo*U`2$F8?{djDo&8y}|8FhMxHz0nT}0COG4NiSeaV
zzT?s_w|^7#w0{>k?LT8YnW)e;FSqk1^t7`8oOXT$=X!Oc=E-nMiVxST{lR&TIvl(T
z^;->oJp4QXoa?u1zz>3*yTCb4J`7I#FB(r-E^$8mHTVSh^C#>uZVg%}3c2m*-Y}1I
z6XS{x^_zinJ=__b*G~t4bNw(Foc-c{<0_Yq#@(OCq5ra89e)}6gW><X(9{2qp`Qr-
zcP0AGTP7z`l0TE6-`#i|AI3pH8Tx6^)1RZDp91}9CHf1YXL+wG(ccI?%X@E${$c1<
zW*<-9ho0B{e+Fkg?%7IF`}=v+7;w%zr-MI;I9v&S9{7FWU!gtNac@yycc%Qk{VZE}
zll}P`db_OmH@zK)7vsZu(A)C4;Aeu{u~xyq2e)bSZ~9H)56>aD0sjGZx`H!bI}R-D
z{{+1)AO4mv^}qZt^o+wI=*!|j{qO&m`ak~{dOP+g%B6e!ynZ(-i4Xl;s(zh*;}ZQ5
z;4h-RY0sjh{$3AuZY^l$yx;Gw63+Y27s5X8ccPswm&%5eFL`Hh_D64r$#lh3*thL|
z;XlV8>6B!DS(GdNStN0N7Rlpmmy3(B`B~HG!RuXP_VelIKs$eNf5cx%Kc4JZsIVh$
zmmw;=zNCLH{j_b6-(lUo(EmH5;&(gy+w*<9R|Z=L{=v=}>=5{B26_hGW#0_O1U}<{
z42}wXPL~W$4g4^3<m|vt8JxidfnT|623G~Xi^cP{zz;P0cLlzY?HeBr{F7!GsE(98
zZf#BP?bi9WHb8!w<+b{MZJWXOfnT*_27d+q-WD0GVC~lJceS{!9r(Z7WW9gR!u8#4
zAouS{aK7=LS+DQzP;&mOHCVsT)A^ds3R!V47WMz_mU&gM)5r3i82H(HXZ=xuZ)SE*
z3;bt`+eLwY*&*BU?~ipqzgj=@JA?i!>u`?--fEYue=+cTw#)pzz*{!Y{HwrQS-Jf4
z5$?~{?X!M)8#tVwZ0)vD;MLaATLkW7!IptH8kp^O4*dE7nfDF6oz=UpMJl;JzgYj$
zUXT3wG-oJjFQDXlzyC&KBl#v4w{rtO+6Ig(0^i!!Lw?_#+n-_jhl2hL<Ie?tp7FN=
z|HRsff3Csp&(3aF{1Ws7EdKSZ+^#=bf28D}UvNI$7ErB&exdbWopmd@{(j?~0^iE|
zOOL=87~eDS8k?Z@4g6gjpS9;=zUQ>g&vk8%{Kw7n^P>Vk+uG*?fnQ|{rKba*-aFgT
zy=O{Z-eb+a&J4+)-zPuUT9kb79{KrifiEz=VVYa1Kg8OP|34<r_kQ!gUC^)JJ->ge
zz)#sS^NxXkY323*-{kf;@0a!6gZ_h#nfv#Dy1t9`$326-tIZ?+|DIg$-!FM!(6_TV
z92EH4*3PE}zM;*({y7V`zk)5aX9j&+tFKD~ud(_4y1=h%mCJiq;5F86Ukv<qyB_>*
z;O<YwGTEN{`KT6DDK!k-_3H%w$;Mgl|EJ0AytYl|TLr!Q*&}eR-IewV-1Dst-1D6t
zxaaHtcgg+neEmLE=OddH*;d>T>}<DL=C=j@d7I4d4tz-4%pVN=jEypXEbyO=KNEN_
z8y{Z?d_Nm!UJZO#+o-)Ac$=0v-wy*{#`0Yl_~WZ({nvqavHA3e!1uCz7X^O0*;yR;
zFl)EVSUdIj?`iFG#lX+Aez98MZP&_vt{wQ@*4|nK-o^TF`@p?l>=?MWx88xjzI)Dh
zVBiy)Wj;Re4Q;%d9{5eR{yaW%yRUI(;5%5HFAn^=Rdc>q1%7Um%x?{RzuuYOANWFB
zzx@*Uf4XOV$K~>)*VpD2haQ2?uyy|4fp@a@Rug!;PTB6^fuCdRnNtGqvwhZI5crub
zGWYS@{p@1x>b9V7YH{}au3i6Yw`^yA&~IV>yb<^#=Km*wPivm-d>{B_%V)kg@a-*b
z4efRJXMmM=oxmS5{Z@g0VdF;Uz!&$=`R*Qg|NS!GFYtqHeKjiZ$)=wi_&D3Q9uxSn
z7Kbwe-^%vCmjvEz!|czsfuCdRmVX6)M~|%c?>F|it!@45g`mII+TlBacd!EhzyI9r
zY-{_ApM!pi`CqR=&foP5ZGW<A;QcM0>j&P^)(LF_A7%FqbO`)xThH_eyt&1vf8g&}
zKRq(=S!-s$j}QDf>ldd6{*3jb3j!Z!alSrqzfb7yz>l-_&*Oo2?Uns`Iq<DpW&Td!
zx7s}WW8l55z5N#W12#Ss3*=<d>#Mu@zpMcGZ{}yiz^kpDtR8sNHu?SQ1b(uO+gk*F
zU%RZ|F7Vz~FFOW){%%>nOW?ixWZo<AZB5@V@SSYj*(dOkD`h*w0{8KDeBdwGynI;T
zS6Tc|3VbtL&z~3gl{P<K5%?Z$vOl*3{(j%g{c{R>`T6wY-%s&O(2rXs>t74}a_bi#
z1%8;VTfPl^q_u}X1OIUUY<~soH+otA>}`HF4*ZSvvc5&&yV|~Ti@=xKE$ep*yo>L5
z0`F+!^Ps@}ez=i=FWfBKpAvXeE9X&xd%mX!exdcRivz#h)~nY9e#$O6-#Y{U!P@5|
zfnR9-^!dQsw#|0l4!nnr+n)tK(aQT%;OpD`wRFR5&+BnUv;2IOz+2h*&w7DBVeNdA
zz(2D5whi3x|K26=mbMPtBk-A>vp<6aA2cZQg92}0{u~l`h0SNj2mXq!H_i%tqV@M#
zfxl(z!y5vB($=N-1U}K~@rl4Uu=V`Qf&XRmyMLa=>&3^TuY&$!TlX#s{4<;Pm$h-u
z?dUViN^1oEiS1jO1%B9pS?`~JaXV{u$$a~u|8URDdj{U4b>{s8_w~=vz<s?mK5$<b
z9Txa^c5ZM|;1^rHoEP}kHeX&5ct@+3TLOQ?+QWl^uVLfQ{J@{Gb<3N9pT2&M!@|Hb
zP5)Ch@Y_wl)XG`m@o&6oe!g<xlXuFzN#JkVdboAqhuOHaP2el+mF;v5e7@CVzrepR
z`v(NR%dXjufBwk*A7JCj)S&Nd{rb4T|FZMaGXuZg`pad3uVL}OKJZ=bxqn{C{n@E+
z_Vb0HAKo(aR|9{%ZRT$W{#CQgKMefYjWb^u_;>9y|2pv1ZC&w0;BVP_>9@eIwt8IM
z=6^3&jrG&D1Fy7mybS{1#^Tu`@I!6hZyR_&8xMC0-0z?075Msna(VX%{6^!W13#i)
z){hT-bDMuB2i~h*)*l-9x_e}Pbl|?;Ju&bzt$m&r_^B5Ea{@oh_AfUC{(!aT+X8>u
z+ST2G-_a`j`C#DPtv@~%_={%$nZTDaJ1+!&n9Ucj2Hw=#=i7k~?3w-fFz^#C--Ur+
zWaGovfj_W&w(~>a-P>jEpLg?idrjxe7YF^Qewi<0<GSlNvhi@mz<0Criq!(Y%J!ja
z2j0orVf(;8vVO5`;0N@|{&WibvG$pF4g4@$AMP6Xxz->12L9|O+0KB#SGDKk0>9Ye
z<)7E{_#AERb9&HE+a}vTD)4$%zb6F#RKu)4E$|c8&3ta)Z`9BH`oMp-espW#$C^KP
z2mY3|!xsYI&)UPQf$z{Q=lgcxuXWA*!@%#e_3FaF-?Mh|P2h`teP#P6kMkF{-fI~6
z`WFAy1HWR+?9bYP-`qFzrhyN(bBXN&Z)?wY4E$I-C)p)%zpmLU@c-DnvPa<KJ7#}I
z2i~A@=HmlD+}7cf10TOk)*l*pdj&A1qXYlXZkhY%Iz7(6+Pdqspzm$%|D3=Z*t+V5
zz#p=G?rnj0xAuH@;6t{}{yZ4?PgY*Pp5T6-y+_u+81ySydwVZ%KWF$d@YQTS`Ze%z
z)*qL#a~jXLxAouE1OLX`Rp2dc-rO|ssg~dNf#2ObmuuI+@33{kK7o(jGV4bKK6?4g
zCkFnbjeAE2zLl+u&IsK1MVAJ?(8mAk1D|U3bx+`@Y@hvkGVs}JXZ}jyyV!WXAn=uJ
zJ@#$jtu6k41%71bY`>xP@7j9YF7tH*-_6#ytpoqj_IKL`ev|d<Zh=3)SGK=b;5S(O
zhXj7Pt@p+U{(_C?hX;O*`EyF(eb>wRUKse!oio2W@Ok@YerMpm-hDLi{Wj0~7X!c4
z=8^XT_s;`-75M8G|K9>X%hqqpTe-cy=2|~(6!?ByWPe%&zLM>awha6pn=d*CzKxyR
z^bLHx**_rgYnRRW9u)YfwKDh59lQU(Y?=9qLBE~NYv%@jy{*Hq2z<2zvz=Q5Kgjx{
zf4<oBebn03b3y-+`RV%}*RNpfw9kURo6XC<zHog%8~^K@J?8@(WItCA{A$}bH4D6+
zwX4kn->Yl3(<$)97Kh$}zh>k1puneE{6_|Ux3#y)fuGwf=X-46m#Tm%of-I4i^HtI
z7uvXbW8hP4-Fsi)jjbM^4!nuA!`A}eyjkH+#m9kn-YoO)1FyGL<`uT@_xjqw;;?ey
zkK6P00`F(zaGSutu=?!~_)nd4zC8l(ZR^bbfls$_X;|P-TYIPpd`%mNj|}`R8wXAc
z{1l7B#ew&+_1Lw6x3O~F75IJD9z0GS&+GQd<$XEmTU&qpAn^ZKd-x{sZ>%2w2z+hZ
z->uL%=i~XFzf*p`cHoEZo_VXlk8Pj%)`7p*IrFZ8pKAW^5%`X_&+_}A-Jg|hy;mLd
zjct55H1IbE<a|#G{0VFS=Lhcl=edDjZ}Z^ofj6>obzb26S)88_e8`5`pLYVEV&nf8
zfp2f;SHA|{sxsSI*48^7pYJlRSU2#sZT;LL@PoI`Z`d+$*LMzl%LB5$Z{Tm(zH3<E
zi>#d=9C&Zr7aS3|-}iD#;EQa0z98`1x6A&_4Sax&&$k7>qm8Q%1-_MyKl1~>*5dX?
z;O`C0`F;|)jgQ|4ey{D176-na?K>LUI>PJmew)YF3EaQ;xmDl`?fF)LziaX79QZqS
zj<k2+*X3eWR0h7t#`EgHH?{Ii54@kX|MLU)`wsp44ZOUE*2@`R8T9AaICE>@YuLQ}
zK;Uz19s5k+R_zt92mbx)Ip1#s_xmFL4BYRlS;593_uuc^X&kuUpVK06zn^EPz|Y@4
z`{Un};Pw~olX>r;*JtFE_6&TpWilTe__@}9#|G~GZd%|z4*0o|`}1t?Y=2hJ?_%Tm
z4S~OD`^|d-pKI&nCjuX8{r%;@*EIe6fgf-E=&Qibv3wT={*bLpmur&C;pOuCLe>g=
zu(i+Tf%n-UzkiFs&$4yM&Vi4zaenu}FSqsT{(&!N=VSi;5ANqgYnO)v{giF9KPLo!
zx9yA034AMSSN^>aZhv;CZ0DAsf6?02gMqiR{y0DIPi!6aX5fB(XJO#2?Ogh&z-P9}
z{`mJ!xSyZe_^_JI&(5!~`feKdeP*X!;M44UV~4<7+Bn=RaQ~jrfq}1M>p=fr3-{-H
zYqyhvepRdAV*)>+GM9H|;QMA=aarK~%+3vg58Wug;pf1|Y?JxY>*q)Jv$4$=D+li9
zT}=Xi-Qw9ga9_V}6Zm?z{^=L^9airH0^i2YH~f1x+|Rx2TyAvGH?Z~I)W9#bb<S~t
z`?z;z;Lq85^7_F2zN5PXpVd3Z@$taVvHtQ>;E$U>?*+b1{cPvUz;A7q`LBV0zJ2D)
z*f`|z*~Hcxs|UWZ?F*U){*&o94SdhW*?z~shuJvaBk-L&XZ_xR`}yaPzz<q2>&FFt
z+uoTU8u(i+GM^Fn#HN}1_mg-We0?}4=vT7#c5~p@4$5}!5Bx*xFHZ+vW9`|$x5V>p
zWaIpTp#Rm@UH=Wd{!TgHKLVfHDf0$aKDR%kS>}xb?|VSz%>zHu@@*gZ1}(FG$H4t_
zgS`X)&h||M1Mg|^@$W@(KR>W}>foUFdHl%0eO+;C;5~Y0KQ9XWrH+|j6ZisaKmQ86
zrS+G`0$<nS{!-vO+Iaqc;3I6k;otY-<sD)3>F+^bGdTO%pjm!&{X|=bG!ESF!)Y1#
zF&2ld0{8oHx&-d`?eq)0yUnkI1K-catFeI(+O?uc(*u9DbLQS2y<DGI`OgdbJ#D>x
zW#9{XWjnV8uJ8CzdbnBfP<wx@?_WL-e1O&Ce*@pMeSZH>fxm3y@b7^?XX}Tht$%yD
zHnBLY8~DdNW&6zn?{Dp=Rp9qq9NGo`oUI%E`*S>BKTqr)^ge&>6}azzD+BlaY<1wi
zpPe4~@-~j07`U&C&I#Pd+nWOa(#GvO0`Fn*zc=uQY=8Z5;NR|*<NRdcQ*HiwFYwiD
zeE2x<%WVDdMc~`p`0#DueU{Jp{v7yEw(k8S@P}<3UeDHFUXRVqPLsfIH9t2D{C?{f
z8wY-~?YlP%yvwTD&+P;6W*guhfw#2rfA7FgTRPhr61bnkj0=1<EB|4E-(&gC2;AG%
zxq&}t^T?dQFSl{>=E!Z|^m5=Y?wI|5Bk=b7Xa0WRT{EuuGVrR-`Gr3N-?(??^_u5L
zuV3HiHwgSU^K+HJ2R6&^Un}tIWH6--0>9Ymy?Nm0?VI)OjW3m+Ze1@k{q7j_hgf-b
z3w%S1|ER#%wsq-@!2eh)=i%SK<Z<}a=9dqGezDbKg^dTUzoBQg(=71Qt-o{*{06gM
z75K87W;>?@-r4qvvjgAF+QaREUuFH*zaPo{yrNmQ|9#NkWb@AQ)}LJ8-1>FXz_+#W
zZJWS{*f`cF@CR&usSdn@`FUF4JFJuayesgVt-jt4{3~0B{~oyCr?PshY|qPeb-nz2
zlfWPDn|bHJAGLX8VBqIk$D0)RTwAZ68+fmMvi<7=|7?fM9|`=KW|@B&_~q74ehB<a
z6)>e`EPpTWsurKdfj@2Y(N=-qZ|5Gp0)J}HY=8g22Mx%4T;Tgz`#d@DA8cQ6dEnD*
z-FsKy{{0vK4*USy?|&5dh8CB4t+QVqhxXPEn+HD3)-yW?KFi{>f8c*vJD(bOjqPtQ
z3H*Vc*^dVTpKtT{>w)iM{qyU<E398EZ|4eLu6edTZytE7MmgV(f&XCZmi~bsVD)=;
z;BT#w?OYf5`L-^d7x+M1f4&xY&n>c@uLB>uYvwDp$&X&HV;kn@?E?Q~m&|t!ysxd>
zD+6D~@;fZ>Io3Ys1pbi4?a{#f9OS*g?=^pZ3;Y&q=c~0{vRr4cke_cE_=z^Y?G<>n
zjkhBL-`Vn=8u)z6_q4#9SUZ^&_-`GuKmQ8c|IhBzf!}NM@B4xKxc_tD+nPVC+qk9T
zKc9XkTmNbk_)D8*fA$Uhnf)@K9{5>Szvl%$r&rehEAR!@ZeI-i92-YI4ZMDjZ0Fa&
z*V;1kHQMDzFV`X6^7FQVe`o94T>`(x`rW>P`#I*=z<;xG=D5H=^7;*Y#ERLU*8`t#
z{{I>H0E=gHs|PRFznW(|n+CpR@65Lk{5E^uC-C<U%=+Ph`~Q`h9{2z&*QtT8Zu9A!
zz>jX0?LQd!sy4s88MuF+`?rDLYxDBjw*K`vY;Wt>Hi7?S{j^iy&27Bx8~6`4?hOh2
z<ejtshXmebnas}!yrZ?B*@0hJKkIJ~{Q1=~e?0J!X6N(3{d*JYTfgx*>}36SwZOmC
z0zRdU13%8jg`EQL*Cp$F2fnrWQ5E=Y7N27Rf70T4LEsnm&-QN#{JTDxKN0wvHt)U@
z_!IrI{@1|IT0Qf1w#bhjpB6TcZyxx4>t$V+z@OPM^I?Ivus9qW_zexR{*=Iv+cxv7
z0&i*KfZspjeonA;)CWQTg4Ng0fgf!7Hnj1>?YwE@$VP!bx@Pug`@mmXCG$RkuWS8o
zRN$K}o%PcLA8GNN8Tg~tuI>%|CR?Ap5_nguuWtjNWb1)Nfp2Hy(kgaN=5e^u{BIR_
zg^dGU0{8o4_6~fXy>odF3Ve5)r%nibz&2TbLEx{-v6OBO{9|h;j|YBJo2-8^@WnR%
ze--#^7Uy3BU#4ERvx=45<8zD6<C_Qms;xu12Yy!nZ0CT$$6Fl62j0Nqa6;hI&Awkx
zbAPV4ecT;EKf>zqg}{A%`QO0Lw05|R<?r_W|D&uIxc@)APJ!>*J(qXy$gN&#0$<D4
zW2Xi_*y4P3;P>^<_8$y<2dm%r0&l-p)-MWt`8_gU%i58b_f(tTw+-AsZ{H{IgDSI~
zQGxd~J|pm1gR=g{z&kb0{IS5_u=UtmfuCgS(ys$Q!OlGv2kzGq*Rt`_%lq2;Ip4N{
ze`4)nx4<voJL?ArzOI#PQsBR>l=UYEKFY@1*@4gOoAvVo_xnrU4*XPG-~Jr<3cF=H
zt69JC^7e0<`KEy%y+-B(1OMLI?Zm)G+B|!5;5RLo?K~Lx^hTM#7r0;N{wwg4ZQfkd
z>eKyilFd|X9r#Q;ALt+W=k|PZ;N$F^;k>|?wf28o;I~@8elGA2Y+hLq_<wq5M;8Tt
zj>V_Z_W5-$*W0$9X&v}2Hc$EW0oPx!a(=(x7vTKcWiuZg?EKr}b9CSrS^K{r@FC{^
zO@XhtcDDcTz?;~*@#DZdSUXu9_z)YH8reAQ{?D{|XN$laoBurnAGCY+=fJ?%w0WT>
z@TIK2P7Hj3wa-ffuW#eb9fAMWGw1tk;7x3O`C;Ijt(o<|20n1D%vZL2JPtQmKW!EG
z#{;vzL*UmhpLxH)+c(L)D)52U&QA#ZMH}BP3H-19vz?m)pJDyz*}&V_yyl;;@^T$y
z`PSbt+jCyAZ+^aR;3r%AX&?9l`(%BO!0)hmZEWBdnV%;HzS;rVj(?wu`?IRm*R4U{
zZO^QKGVr;!9)2V6<!pWRW8gE^%XU_<cJ29A?3a0)z?ZXie5b%4TtDjv27ZS<A0POS
zHf|gfcuVWovjYE*wZn%3A8h^o&A>Ob{`g7YD_MV8ac3)cdU!tld|>mVf8UJ9Vc<Gh
z*EQ&Owt5*9_&6J1CI#Np`pc<-pS)_ee|6**=lOy6w0^oE@JDRjwJ7lO*Uk1<?3^FH
zT(_8?jg2dePi9H+d$Yi;TUT^4?so3%m*3PC`X@3feh)J){rvP}#jO|_c*FFX(%8<$
zL+yPIC)@L>;Ih*;%PI~Hd}HHB8CSXFk4;Avml}8f53}}mg>mU0Pd}a>?VSH||9jXA
zPX=zoe8qflwJZ1kHE{VqJpCxW)wy^m$}2uNKdpG*xcg(>wBlFrWs<gs1$2cj`Hfz#
z-EI8w@4u0q$FijOy$$rr_cD8}W8g;_?-}?`GMLhCf&2d<*u%JF%J)Z!Q>ubq@o8q`
z*yNyZs5ho`HuTS>=j+(H!CY|pf4}Lk4g7B7HyPJc`EyMAQF=1)OEa$cH1Io({}A}L
zOXU}qvId~1vj3jxR}Q?D>6--J&G;t9y&iYA`C@D6A2r*0=nuW(;OFgw0)NTu4+dBK
z|J+el(*HyQmz|2G^{b+yI&l9!_k+P@$3ItcIJoR=WOj}Yd_ChQfXmKNgVL{*&IFg8
zZl?F^rQRQRGCnuxM;gC2@FB);0$0APTO95ISH35i{(-=cHU0>=?D+j5Z-UFt)uw+p
z@VUkp7*{ntntnD&KT1t^$&b$4=BE|g825Ivt_FjYIz#_RM#b+T(956uE#DD=-(h?V
zIO}&Zxa=%2{j|W}F@6NN>}+oH(@Eg6Q@>vNmC|W}|7CVA4ZM}<X9wQQ_*LMn-&?_z
z@2;l5Gw`m){kojT+3WZ5pdW4ervo2h{I$T3G5%KI{=M_>8&|!n9&H&?v8J6vIJe=U
zqK$F)a}!(7Yy<tgWXID0=oN?a&7XY(Kg0N_z#lX|Ht@TR*MKwrhk+~K_f3CP;BOi~
z9$a=j{xiX4XR+ze30(g}NNG;sem~Dufj6q3_17C$oad#V)iSPlDRA$n3t>lozHj^M
z@1cL#Z0KS2?)iz2WB$GTjRJ33KkHfq-ru-?{?+aDHQo+-#=ir&;^yCv-zo4Kv(p8f
z@$Um(v>(&&5%}504-EVk<9;8#`+t-1QKnb?6*rIn8G(EJ=fb}HoM#KQTcCd^aZfKm
zFaIC6eEoa1-Jb`He;D*%8vi8lPmF&7&iMZXu6$QoCVR9f@a2sE1<v?4u=2T|?M%N?
z;F}n45_k{eO#|;{yoGVaUvcyJ?-sbne<<w8&mFqva#chBU`EC7)1X%z_P2b`4190n
zvjRWX_!WU4Zu}Z>`QxA8xgA{j&NcmAfzL92KRE00NpRVD()7;;KF|0I;H<~Dz-8xC
z)4vz^0^?r=?%(78ZQy^J{wL$AN5$W^j}^^rAMAXi^qNvf<7!v(^He(z><0Y<5?UGo
zz5HKu+5E!jz#AGL2QK^G-==}f&JLzOJn(Id9|JBseqZ-#;IcE=^k)V>(76Af951i0
z17`>QQKp|8xc~ov>%dvRcY@2G%gxR`fnQ?$$-wV1{%qiP8GpgJ>QVLL_4{YwUcYPX
znnWpic~|RPJgwNkxa{1YQSo~x=;i-^EZ?qyKViHlxb|y{me0oa1(%)Wm&<%`;L92x
zX59U;W6_EUfj7@)Do%hM<=epaiRXYT-^OPDg22}@erd4Z-t6BIxE-fg%nQ7S>0gI^
zwTH*-yk!CO_nB4?OZUo8d_3RO{8={e7RFZumwn%VH3C<8{r^3z8~E;KrzyDXc>8Yy
zE<009zggfDjQi(ryj}S^ZKt3=&-DJi@?PGvjPDWjHyiIC_>IQ*HLiA|c=|kbbl^Tu
zoew)I@56R3?e}@f&Ybk)=@IA^hi5F`Cj!6U__N@wmsi1MXW8X*4sQnjhuL`#ob~cK
zxa{m;cD@dLbK~EG%Z}H}pWw3N|2JZ(-q|m&mxIjCDuMg|fmkE(S*BmxxW}_uHe1mS
zdiisC)BHjQaQX9++36Jczm0bZ_FI{K|3508?+(Tf3wnE6aaQ05nEtlFM;d=9@I#Eh
zVtj@4T;-a(b$;P}=r1>|9u`Bd@_ujSs<&Gf$&UD^##ak`(*{|$R^ZKyuL~}J-p}%i
z7RD7HEz$h{{Iv`EUF|w-2k`kxKg8^J3Ve|9F2-eF<@J8IZ{T)Wwc_BwJEZq0og8@2
zj4Q4Qe1!3b1HaAqE8sdRZEb#j2+lZs1Fj|1?Y4hh+SWlTm-yAj8-lC6KBlh|_`LL*
zl7DZjx087?m{L#ZXJu6U9%bCy!?EW7*uee&h}3|q-u-)B4g;T`_+@72sK75We!OwH
zCx7fXq2glbW&c_0Ftee*EOAfspjW>0%>Ltn-)a2i!2dA*THxOp_v_X2Q~9oE880%u
z^LECU-97)|d>7+u1a6mwD>gCi^)-0M{D!Teztn8#p+EF0Z%4f`CBHuG^|-n5kwJfu
z@q+>%VtfL);(v)PMEv`x-2P>zKN5QRbC&Vrz-6a%|MV-RGr*;P-SlS%{(|ufj4Pgs
zgB{;i+z7qw-??V`mD1hdvcK5u+#mQa#^(k5V+t$jd_CwlUNOJ0An^5#FAR2$Hako8
z&3`C6`Ll=VmkGSD@fD1FdCxIBZ2})^ylddM8Xp*VTjL`F?__+saryat`nk;RvpF96
zOH8YWYl40i+W_1Z_?i3VH$4J7gJI`G=oOz)7Kcv)A8h;!@aL1>_uW5%%g(u`UljP6
z#+S3}ie4`_8DBB*8;q}NT=gRVeIK+*;N8<}N<9M~Qqc5X*q8r{>^j<L=*O8>4<|uC
zKRtic{5dUf|K8?{1OL|avjX@3k8)$+{(ntw4ZKmq?9@YncQ*cL;2n%VWn6JnxsJ+a
zDn1GNF{b}K@G9fq1UsjjomDJ;ZhyA%jRW_7v2);$nBM;ns@r+N_{5-J+xRJgw>N&d
zaqmZecFQkZ4}G<1_3$k8s^4R*yw3-Igz<L*_y5cCLEsm9+yZ~V`1gU|XZ#oAibHk!
zSvmbEt-5D^blxIAt=Pc0m-jgf&?eB2HLV_cL9g=u+w$E#@Mnzg1+M<$_kj%tmz~c{
zKQ!=<jr->Y+|LV_PH#%-;Gkb_rOc-UzS!&>3NC+s>7Df_fXkouX6NL<TN}S1@V$*+
z68N6RXB$`i70=ajwiWXNZ)yBp*eT*>{(l7hL8jG1JzJ0{KJtHr<-1(qLyR{BXT3BA
zmz|?b-z0GVzctOkWyk-2R$Fk{xzy}z9{BmjcMSYK<6Q#x&&&5Pu6QaAD!0;b=;hDC
zb_K2&552Du^vW5~%g>iA-?IaM%J>D~jN299vQuwmSx@_bz<)P8H-O8I|KGj4z-4C(
zvvXhI8ykPvxZ<F4dAoWy=qpYCVc`24|1{X~b@H-ypPk#^H07bxG;rTXcM9BNJpg>w
z^!{6|Jr6Oi`g=b8%(VE7gno45o=${b@tJ1+pAz_F<1@i!-^ZVe!DZ(h)6WWgrtzBs
zzumZh50m#h|35ts2fhE_oyP+A|5Na^am88X_4fQ(;EmI3N`JwQ%C)?WhxKipE<1iE
zA$<$u?&qiGf9t>(7;gtI`yRIr;ELN)tH^rVw+8;F+1V}dW~T2Kxc^_D!GZh#;~5%w
z7qc_cxR=-Cc4FWjw@YD1<@$a=;eN#x(EFKzUU?LHmAAj;`()t$e}LwLGj6Ye%g%)V
zL)Tq^NmYJ-0KYUW-Q6i5DP1ew-MMs2Hz+9xNS6YFgmi;QN(mAIN{4`yAfSMRfWZGf
z^M23&cl<sN_jz`9=QH0u_q^}DbLY<N?kwtDB<~8pOFjwyfL#CI&nt5MKRx>YV|BZ)
zL!GD?x6GT2SLZDYxz1a0xa4G9E2Fv#w}hK~M^B;42$Prb?!$W9k?)50A-@VAKz;!}
z6fXVCdgYiR%M9c4I!s~o`HiU~{dd9>(bXp3UJ772X7bX%{{Nnn<gd`rRq`}w=mvQ*
z_#L?PFYDF*1N^?Qxb0v64pry>pV%(omJ}x6+*9bXC|tL@{$HPx<VCUK>g0{!waM$j
z8yJ`QjQ^frd4zG9x8BI>`+jLZAHh2#FXNT|arh5DHFc!^6#O7(qRF>)uFGnZm-Ws>
z{q^Mf`?R~s_5GRmksm{yL&l{aect+uaanIdJOH01j}N~|o(+D7JRSTQc?0-Ma{d1|
zZ;c;w{XCM1bxX`f{<H2sL;ckt8C+sApAC@DLXMXQf|BHkk*`ml1+MQap!H9~$5Z}S
z_yV~0ssHC}2l?7UegHp`Uwz;E8S?#QykCRM>hRKrzX8Vs-9Kkxo}-fM|LKWkT=oa;
zCy8;{AC93;3i5sMw8o{5_MgMJ)Omw^ZgTxUI{D!`F6_2JEpptAf-c78IFkU!$-c&A
zehRt|StgP<@f@r$F6%rQ%iplgxYTKb{LkdQ;rES8Kl#wlGviX{Q{<zd0Uhrocmnb@
z@b`^NpD|@ayQMT-_qP`~@vUO=_%f95Z1S>QG9?Oe(49O5yti??pA0iDbs8f-g1jdD
zQ{#3&nQC0>j7MJI?@IUQ(eN*kmwA&fbwBxzT=$bx#_fLct8w{K_mijO72R#J#KoOW
z*NfAYASZcG9}g-SmmZg6ziMP$R;BwxJ96D0dXek?Fv+-#D-rg$1#sOT_T%SkD@`7|
zWT?}<ly8?T#KAG+vR(B5Hk~A2g6(pK>f`Pn{9#=B)Zb%#VqE%3<yRZTY39F>c^1zO
zPitK2#KCxTz;(Qt!~HjuBG<>|s^nF0($R=~S#4jZ9l5@*buaQ5<$ZnzxxP=?cjPay
z-ecs;@VxRIT;}0RUpjR8+~j4u9Krm*BG><$6*?(#Ih~)*IM0cV_3QoX7V5+&{|%m&
zJaS^+R7UcDk<Vsa?(h0OwE2xo{~1uH5P2GSak$O{?nXgVa=pLzAur(D3_dgUrJn^^
z{SA{%eiX9uX`RVSpQX^xCh|h??~F@*eZINhxYTKj{2}sI@H6D2;1|e;z<(!S1;0nW
z6#kO@Ap8ya0eB4juterx<|o{J$dV8)`;VNbjluKxjK*cW7f>fF`5AZ~^2hK3<bT2|
zz_p*@ZXL4JdWUzVI{JUYdXPs?;_D0~PXQlFuK!nT8eIFC=F0>N$d|!alkbEdBCiR*
zOr8b)io7H|RZIVc_JdeZfcymV;cz`Z{9D7{P|@V^R4;Tx2a}iW`#$DJ|K3!OCs}nq
zDc?-zle`{W-xopajDb(4{0R6A<8r^Njq6Lu^*FzoT#xey$n`jX9xn4K^HAA+$a3A}
zW&a;50k=FhF7q=VeLf?f3)lZkrsG`=kJ2hsE_B?MIxFGn$o2oXWg_2>e0I3@uiNqi
z@`-+RL4ER>@RslJ!Eo*W4A%QG`6>8V@|*Ap<k#Wfkn8`GTS@*H`E_s|?;`ZSlU(=z
z%j6f4zisNv_ML<6`^>m(m-tEjH@qZ|4Nn^3Z`b+B4o^v*6`l#M{Xg{I9)wfA81m)G
z3&E>Uoml9<sc|`vdLG4HxTSqW=u@EU{oP*;dXww>#!n^J|6974d;uO8*1%;RWIk7-
zpIydfKI@_Xz2tS^N66d2kCR8he}n6|w4Zw>Fa7L9KhKRzKfO`s6?sp1)YdNK7Tvxh
z;W5dF!_&iMbq(CdQp`_o^6%lr$WOx?lIwA)A9>?Q(p?aYB<~ELOg<Psk9;9~JNXLu
zFXZRpaoYIx%T*cgALu^|c@gY~1>iEDay-9`*Mmx#e0}G-L{PqH5r0cp<FXxRWBz-P
zPlgYCNBxl|FZ)R!jBAo{seb`=rjeh5&n15WUqJphd^vdvJTF^Ko(#T)JTH73c~<y7
z@_F!s<Wt}$;4*xfe|-*l;T`^r>fA(~m*o0>Ac@<$qHfXc-U}x>DdDo-dZC2BC}#39
z|No$VDe}kgvc_e<n%>aYsbO5|=>I{iL!KnL&o_i?Kl;3~o5@T4-*CP<z~t-t5~0i4
zCNJwPi28HM^THQWo#?3bt;x%J(=_lm>@@j0$jYZ{lwXMaJ(I^K3Vm1XcK)07_|_Et
z#3!!`Phwp9(bt*N8<+7eL_Rb59C!}nQs)+42q<V=>KsJA2>CvEN#k<=y@LC11>;ix
zj{A_M4tf0a-rJJL#m`N8kaunB^F!gXI+@Q*o`dPe<?;7aRDZ))#wD-E^G$HQUud7-
zlWU(plWU*9l53xTz_m}kUq@>1`x2Kv|A^|Z$1yH_;%Q@$5zc+SPp*9yH7?unnr<)h
z%kYZEWqawk>XPfYTETT(-F*8&f8)`dMV1S<j4&?a(%123!FgPZ$aP$6jLW$GMgJSf
z_5BQY7`Nj(M6TmH4cBoEck7Vlp7ChzdJ4I4%QNFLu5lp^g4iAW7d)=y<T|cQ#${Y7
zQ~2-CMxGd+&$t~|Npc-m6}XOT4*HBRE<-AeadkB=<I?lw;Z$GmFB8diT(gbKxJsh`
zx#UIROO4xcZ6Mci?S|{PLMPa6J!g!|kSbtY*Nn@!qRKbA<tf$IaYgFrZ`bXp<BDTk
z#?=V@Cm^o}Pi5SWD;v3vs~}v*l>~iOH7-Nazk6+9Jaqp;z6;gYarGzHag8I_<G>7Z
z?elB6_BkBu{m!`b`4Q%Szj5hv9`fg@zV>;OT>E@Ru6;)C<chjQx0m)AAFh3_#(J|E
zmlj8$&-})v&mWPmNcHc?%G^?yT>ETCu6_0-*FJ~AwNE|IpJ7~D)c=dOz_|4J9DQ!4
z`gf#Bx9lO;K7S$CKCh5#pZDO}XN<_ce&o*nv$*uR5c3(=xb&F~`Al%#UU&Sr2YJY~
z&v0_>vpTu<*#xeA7RGve8kZK=q0b@4rO#@}PoetS=R9)lb1k{{xt(15JOtN1n_<0I
zj7y6L(C1y_(&qr=-%x$+GpvgXxkcw$`%FWwedZw7J`2IM&#_o<b>q_F8T8r6xb&&-
zSJRE^Yo7zjwa@Y7+UG2C?Q=0)``nB^w;PuhZ=ug0j7y*2A%BtTYoE8twa-V!<#C}e
zj{i@|KZ3tCZXXw7cXi+FmN54ruH#Ap*Kz%bKJyxvAw`bvF5FVwxQy!<^0lbGj;k5D
zj;n+5qpptrAEhqjGcc~c#_hO<lk2!XhwHfX{ePAiPvF*jKDN7X%R1vSuA3Ow0l3ba
zj_V}3j_Z=~qpr?A^naCnC;YB)JFchXI<Ck#G1hTCL7yp&%l1l%?Ulv2jO$<Ii@|wZ
z707j5wT;WTen<cH$$x{lG;YV$g<Quq0IuVT6UD8>Et8DPxC&rgUl^BhRYiU+)z|H{
zom|KDgK-&GSW0){mc!)H;irt-aa|?XaovaOxSFERDBb;f#ARF+F|K&VWn68L&kX17
zm6u${Rou9YD+l^7O`Zu}*|;57eR3UFYq*Z9H~JiCT*lQJ;~HgL#x)rEIaFV_*Aj9a
z*E-`et{Uin6L}^0F5`AwhskwZXW=@o@#yn`aT(VDjO!ocGOlCD$Nk7%aSLy+l;k?D
zEXHMAJ<)#-@^0_~#*e$aK7N%Z*Kt*Y>$onX&o;(oTw^e<?#5+Y`aV=6slINnN#r`N
zh2+}jYI5y!8(jO$hSxDp8kaujpwCOjrOy(`KcxEF=fC9IXS^Qno86+@OZ!Yku6<^Q
zYoFDy-qOaU&-LiDigD?)3-T?gzV_LLT>BhKu6>Rp*FI;$wa>v=?`q@H=TY>z)wuLI
z8~I~YU;8{yu6_PNu6;fu*FK}*1sv^j8P=Q1xb%4geP%T-ecnO7I9#`*_F0i!`>bPJ
z?spS#|7t)!7T(JEahKO|btTtv4TS5s{z0FUjmx<H#kjsSF5@aIH@amV)z@+DAlGsI
zM6P{aAlE)`!?n-4Snq4&LUCh++6iLz@}D)|3;DEgp8xmAwa*gd+Gizl?Xx~y*Q?L3
zyBe2PQliiP#$`U|qt6LcU*~f+x%Rn&T>IQYu6^!<YoBYd-V4Tsa-q+g#--0=$iJZa
z+Gn)hF60)SXYDgNx%QcvT>H!i*FG;}y_Jj$RY0G0jZ2@eknc$Kwa-4}+UFQ@?Q<%*
z_W2cD`;3kI%NFC(N^A7F$GG&F1Nk#lU;F%xT>Jc+T>E@Wu6@So<5uPt?XxJ>o7uSZ
zIShT~F)n@T`+${$>-N<?YmsZ8t;w~|?&R9%V7T_#5q(ZIE`3f$pYx1MpPwSXf$D3Y
zyU4ZA6Xe?GC35Za4qW@3h4sEQE`2UQpJ9F76}M=93-amVJfFG9wa-%I+GiDV?Xw|V
z*Q@V8*4?=Dxe9#_G%oXb6McS8^>seKAlE)uk!zn@$+gb|aP9L6)_cjg^!X$Dylq_i
zObmZT^|j9!{anZ`I?vi?N^<QpE4lVr0Iq#z#(Jw5mp-q->l>Fo%fLHReeJU!x%N4h
zT>G3(u6-_qYoE2S-mS)^&xi1R#--0$@N-mO`@BJ}eg0`&&Rf30`N?DQMeu)(+w+!~
z{oOaaMYorZD=A#Z^$q&WZ9IYdzL;@B-yRe(F5^0Ze08d?<7!N<<7#VM#&rPwcO>5f
z?`7PMYZ$qXYdl=XrSFUTwQ<>AVKM!<RvVXbWq|Lc`Z}(k$aP#-$#uWFN3MPT1J^$D
zVZHGO_`bxY&y4U?#--1C@Vs!{zS?IAa_zGQx%SzFT>I<**FM`~y~B)4pM~J#j7y&r
z;Pa`z_PK&w``kgUeI6p$K2O87&$(FdJ>#-J=fnQ|%((RV3-YlCx+`ws`Akl(eZEJo
zeHJ3uKFh+j&+Axk6XVinWAxe1xbzt#mUI^cgQ&jF=NNMBb2hp5xtLu0To2bilViPy
zjLUYfg8qLoE`8pXCf)M8amnlNEkqp@y7~Vf$1BN-+>({N0$#@`MScigmAp3k>}Xu(
zb2#R67+kmS<07He2BS>AmZ#9=Vw0ES)s2+?#%1J};H!<x@oIN9pWkX+>cmgweFu3o
z_#Wd@=c<nfN8mDDWyK=<8%`OQ{!@Dn?ob`wPo9wLe)871^jQl1L>cT0%Djn}fX6j%
zkIyN|b-&66m;R;CT<$}bQpROJIg9OE*|_BMO4uzesJ@P?Gr5kduW{+WR;o~$U?6!l
z_(<b+T$9LkTyx<%t}?!Su+g}TOJA4UWn9Kp4*6fGzK-h(xsL0uaT!<VRKCyy^7ioO
z#_hPG4DsKm_X{0Y0=SN=9{S8~T*h?=+pB<a8CNpo%aBLF8<Bqk?`B-?zk0v!Z(Qo{
zMt*{E$?N+r&M|K9FH4O}|N6d*+sO5O7xx>N^&Y}{Pm=!x{~NCJnXQSx;f2Z9L{>hf
z8S1ZSK1XVQJr{Xa8Jt`4!)3eF2#LR_Px*G(5!;dvP2=+)nL5=?ok=Dy`_)+NKhwxR
zfiE#G`<4E`(oIxf@9%ra>tNki$VbBOQ~l?dpA^G<K<6#uLw`LpT;^xEr_g0Nlb3OA
zK>wA<SHP<qmvLPx<cl>jE_JRT-;Deh_(#U={0xI@pE-T`U_7}VPZp6kM1C(ht_COY
zh0f1~g8myWn!MiU<d&BvFXKvzd45A43m)ZTUr*}~M5FPHOPz+uCnB#7Pi|c1CnN4J
znT$)F@yKT*{}i4VF7qkl%H=*}DfSL;Ky{X)P80G4@HXTJ;2p?!!-vDQpEkaoVEjA$
z8>({^bykx93jdDkbVU7A<UQec$xFeXkvD)R!p@=n&x7Y8-wCg5Tn<$~#`8BcHZEWO
zhI|LO?mw~9_#1keJa)a%4O2~C_J=2!hneK};a?iJ_q(OWrA`{GcLjMe_*&z3|J-I=
z>Xbu%7kM%GKDf-Mj4Q%@$a0PHosqvu-VuJ6>fpze!83Af)*#;S&}u^G+p^xN{%Vk!
z9EYo*1i9`fEy*{d&H&@G-5X=OkAv&>{XK{OhUq3>%~R-d6I}8#pC4nqTgm&wcN&-N
za-^!eaLb|Lp--XbaZ+bB@<+*+z)u>NI`@*e3%6Vv9{TkEb<QGxmHZd@P2*B$ECv^O
zguCJvorlut{q?xUrO&@mCn5O*crth-mzB~H?n9PbCNJyN^Ts0Ndfr%$>fq(>pfP#<
zP<8kBXyg;%qse96vP^^PcnieyKHub5dJ0|cGI^PYXleb8d&ys89!`*#K>ieYF8EvW
zQSc}@!H_;>y~E%!;gOt4pOxK*EJ?|Gcn&g=kAr_mz8BtvT<5I=`7Px8kiUYDfa^TZ
z#|gnilW&Bqd|GYtGTzk~?|Sk@@GZur$9vhOiu=7#<5K4W@(0Mzzz-XjI^82nl^{56
zT<SbR{yg~u_^)u;E;6nZ?n9P8$V+<;o|E^5M;+zA&^ovpq{J6Gp96CGTo#kpb1u21
zyva-diPHIeW%4k14dXHoKj3__1$kDyZr{nc)GvuT-N=i=dl{GdH)8vKh8mYT(~%!e
z{uz9Xaj6rY$Jd!+T<ZLS{0#Er@Gp!@o%Dr$oh8Pl&LiZPli!7}F)no`zVGXNXI$!J
z!*O*dc`Eo`<5K6J#J<ik<5H(B@+Zk#!Os|%IuA1XI@gR#osW^fNj?~U*SOSq{hqJ$
z#JJR%kNiL6GvTj|OP#0jeVv%2{b$*qrOq+r<B%VKCp0c~bo-_;E_GfZpMm^ucvj<5
zCtV(Q;g)>HrB2QaqCxNhd8P~@4vHC<Iw@OuFK=Axw8-GSGI<?%4dYU0D2^wMjZ2+n
z$Tufn0B>zv>TE0EF5J@1xYRkFLDc=87x}RaArAT(mpbP%dmnCG>O{hRHJbcI2A}`T
zxYU{Wf%h54rA{8ynM0lpKHs?1IfxU%<;JB>Bji_;*Mn~-?*-pY-W|T*xU9Ed26y3>
z<HlvZlac?0d@TH&ajElR26y3>>&B(dZsc#1e+$27T<WweEmhp#Z5fw3za#&W{0983
zajCO6s#J03e`E03eUdt1nf&#5<k8`YjZ2*ac>bQwxYWssd?xa2@a)E=PKR=Sy#<U*
zoyy1;Ca(xD0gvRe@;I2!mkFAZuabaUI+Fhd?@O+~mp+1gax`COGF%^*8|m{qlOO4$
zq08+iFXL*7{&$l%gdZoL2>*qAH2j=#nNNMa>$-7S?>6LblW%}OA-@U#hx`isHC(1~
zr2D|>Ly+iGcf~E@^8D+ccyi4>uQe|DiXnB!Tk_`cI^=EOEy-uWyOMtk9|YI!wXvnY
zVYJC_Mpiy8F?pG{%s3t{Cx4B3SYuq~Utcf%&bZV$ggQIPx4@5)r_JKN$t@?zlfus!
zx7+=iaanJ5<ZqIfhu<|WbqZhuJTWeHK12Q=@;>m_#-+~7Z0^D>F~|DP`nVr2tG^zH
zJSse)ajB#450=Kb^b>)62J-UoJmk0G1;|grix`*nmTuwuENfiWI|SpZNL~$I&A8Ng
z9o5%qXk6-a$?m-=d3AUz<HuZdTQr~VWL)Ye#(85O<5E8bUf&o%{y4j@Gt{`$(dScR
zjZ2*)s5625Abbj3?(cFx3diwqKY0!KN%HRSJLIF_PswM&6X1!h>{l{B^`pBBx1=;K
z;|j<5Ll)yQuAAsT2l+L4Ve&AX4;LqYiF_I3vfi3y+=W}J8khCfK%JW8)!>cbI-jR8
zuGS_m<NX}o%ed6<hC2Poo5MdQ-w7W{z8XG(JWfux61Pky{}=g{<n54OOWqv5m3$F=
z2l+(!0l3ajkJ!GS<0dcja{%*m!??^(tz16;J9#PiL-McTPsnG(Uz1;hNBYdKC(M01
z>OPLZ!^q3$_PKcEAHb8tb-bry`+UZCcqOVc4t1)Le+sWpb<UxF%Xj!_sxt?5#*xp0
zPbFUlpGm$Hz8J3Ky^Ma=yu(jWovo;IihK+FGWkLHHSz=SyX5EL56Dl$AH%i(Tj)P*
zyx(r>vEuma?~^BjS0Yahuk#M?0}pd$kGhXP(a!+#`|#o9ui>M~U%{urwf_upeE;*_
z;k&6$T)a-Qk32T~D0v$A3G!6%^W=Hpm&tR&e}ilP@1g$}<W=BlCiwAbzAn57`N!}N
z;bHFEj=7IFIQ}#=e$;to^wX5QEW9mw7kEeV4)C7jpTYZ*kAV+^>$tT4u_iD5CyU`O
z+%nJjQFna_>MSH*2wy?I8@`5oJN#SnKj7QRZ^QSKN6iyzGdM&Z8Ge#HG5j=nLih!^
z&d*eA-`nK+e_mc0ms7OFc)cs$MBkUx5f6i>FfQjyyHP(Md8UN^`>T?lM7|yQ4fs&<
z`|ug$GvoUDYsu%}b<PvyTi}0?>+kP9d50(X+^<LO7f0Pk7R+-J@=Wlw<OSgw$@9Z=
zl9z?&A=lT9i;&kvz65z~czL+)4?5nO@9+*(rw!_KA&-FfA@2<zK;9ERoO~pFH2HA&
z=j2o2Q^_a8zl8I6m%PJwQk{jUvxodE_+j#O@Sn)nz<+^jKk0Bk`iH!Lyx8ED$dmkM
z&8w$_>wdT!^)r$0gy$mv37(hyD7+~7Wq3*Qi|`8M_uy5?@51ZCd0frk;eDyjE7TcC
z{sKONJS?xD$1&tF;giTy!Kaa@fX^j=559mrJA65u$Gh<zeuU~2MV;g1h2iJOE5R?3
zSAbuGYd__%zeS(?-~H{qB>s8=xSkK>z~gCF<8nM~iu&)7*M}D%{}^7Fd?36G`8V)#
z<cr|d$q&M7lkb7IA-@IhK>i!N2VCb(=Vy?~A9M2%j`^8nT;}I3>P#bl1)ocv5-$WV
zAWsTkPF?}Nn*2lf7V=i`ZR9QB`^bC350ZC-ABF4ul*ImXo?PD_`+;$Lz7b6E`<>Jg
zFCX7u4>K<38=X-<6Zv&Kz85ntb>77Dbt)UTb?U-(Kd+1J*wMIb$MN}mov!4c!uygh
zfe$2K2p>Uy5<Z6f7<>}>AMk19ci?l$U%(fTKZh@Y>vkN9dEP*-@9%xkxZREy$V*{6
z-Y_onzXJ7NksrZ!OoU&o()~fVV_M@<XCLYmFfRS*&uyz4m%P3&_b~Dos56^9YEt)2
zZrMN{7k-%hS%y$NxN1CsBYmH}m&T=^fw6r)#Wep}=YKprEBPUK752FP`x}y9g!d(X
z0H05u0r!_3<ayy&$@Tv*Mw$NK{&ymu!MMyrO#GrrPUA8UKOtYA{8xBuay^gz*tpa`
zpWOE`$+*;CkNt2Xxt?DgH7<2Jq0h6%rA`zaA8wErf=8O+*RR`A{~kO&d3TKKeezv+
z-dzH&$E7(jeckfLk2{K)(0eW8a=eO{-+MjsnDEAM?ei^Om+o#{=0Sh{HNg00=P~g6
zW24FA!>5v;%;@`B0M~J?!?>0kmvL3Z&mA@ymvQAq|69r5gYSgvxEi6K!{h}s_<pV!
zx8uEIe6x#&Bmb1VCOq;?Ur*PoKc9+E-UL5yN<-cno`?LT6m&~bxXzote_9RWGC!R$
z4|T{}!<&+S32#Y03*M1@3%o1&26$icEAWBj$KWH#YZM3#HyA@+0X_+?^Lz{QGsooR
zd@L^RN6U@N{PaVe)#Sb4TgYd@w~<eTpM+~axgz`ie<kk?e?|TkJSKh+taWz6(;Aok
zb2*N0*^SHo*%rsQ56JcZ^i?n}bq1nNZR1i$=d-<Wd%x&mT=I|6=TP!&QQVDg`HZ{_
zd>Og^ed1>Fy2$S(pASE4-1d3RcxYV6KOj$t{p2NiZg`^EejK`8N?@MTlk5NAEKEK?
znsQ4G^5O8N<j3J1$#233k=Ms@aui&T4;j$^9OJV8|A75=9{Kn1rQ~<uE6A_IH^Oy(
z`lFwnCNKBLvgqfSap|X8L3iPnljK$47s#8!e<g1W|A)LA{9p1;@JMs~`nCTt=szC$
z4)}ZIm*9oT>&Z!|TWXRY%Mjuqg8T^1AG*MGJGO%lHZJov7X5!rJ_0_Ld<}d8`BL}{
z^0V+c<j3J(lSlc$k83IUbL7{Omqvagc~STd^4ak3$tS~qBtHN@M!pk%#<=XCLov_S
zjmtd$jr?u$yYPE(-G55seC8kWUGSt|_<54N+@+VN@YmBD-|Xl(@<qshh1Vi~0Pjtn
zK8deC!MLpVB-T62xUBai=3z0pzJJJi@)lU{F7p2HGvv#0KK48L!&tu0M{wQ$XQH1-
zU;5j{WxM1m<gZ5~&kT=8-WZ;Uyf!>F`D}Q4@~Q9~<U8QG$v43Zk>7_GBfkbOOP;x~
zA8$qSjPP2<Wq)3Sd24Q5=B+655#;&cosCPK{ixI5xYTKb{9y9t@KJERU);;&zR4{s
z$^U_GCC`@G=P#0%gx`FJN1N-vPxq4%=qDEWC-6k%GvUd|C&SZ|Z-ZwhUkA@keg~e9
z{5rfCdF&#7Jf+B^z$?Oap66nIT2VeP@@>iAhj*ent59b+`F8l{<on@^$Q#4gk#~gu
zMBWpAi~KYAYx2|ZjPv|F={!Wr;;$DsF2}umDZN)SF2}v{vctHgE%__>5b~6<eSRMK
zbmX^_FM%H--wMA)z6bs{`D+{}gZX~_I^LGZ$0Z*C&q_WW_q!tGhj4!T;XAwqT*}IE
zpfvWM*5oDO9jML;)E`EEA3mP^HT-MxXgD9<M*e3)KQH^?(x)89F5)<L%DD7j2YsF+
zuLgfiJ^=oVya)WPaar#JtT)bA?uuJ<-j*PrfP5i5C0w^}dhE}c-{EDb&RNtcM}8V!
zo%|NOHu(*B1Gx560R8kJpP$H&bBb{}6^@SW^`&vS-yKDMt8s~5!~JxxamnjETr@8E
z<;dSPF8Si9A7g>L;uf9%7Z_J;@~7|wa2;<w)X8pK#-;yfu&{AiZ|B6aHut*GJG?nu
z`$<yN=Of4y!8?;@hIc2=2=5Ko{)eKUiR4dkfBAwuKF0eEd3N}Z<T~CP<odqT58!%#
zjDqvS*T&`kSO)z^TIlCP=cgb%jC>e89(gZ#a`H{^)a2{nS;*rR3qnf{@;AumhwD7g
zPv!F^OkR!y1u@=g#$~+CP`?&=9e5Y=>F|%p$HE7YABPViKL{TU*Z$L>|4Hxgl~m_3
z>Z~Py2;W3?@}T|!<8nWmg5&%d<8nV*n9^Oi<?+JMr_kSJNIou(Cy~GYpG*EC^68CB
zJ`3`BjZ6MI@)gP7!dsFjK>z*8E5j!km-U8Yy>pGrdLxkEM7|V$g#3H>Ir3lOPss1U
z6E1Qqb4w)mA?tksFG3!cT2k)!i^<cb^WKrX0(`V_8EOX9nPFVkJ1~>4v(~ue7b3sg
zxa3D5f0kVT-sf-QQl~QNyf!X%wxdqc#qNq*bRK?%7d9?+dZJE6<5K4~^3BNmV?KwH
zkAu%3|0Ah%5d>es^?29-$A`7X<@gY-cqkrhB!64X`%mOqk^h-IGyFbzA^1b`g76pQ
z72&VR%fq8D@qOuWyE#0JygocJ`B->z@=xFy;JO{tC-dtoM)~!~mm*&YuVh?~&)qTq
zO^nO@pFzF_`B8WW^0*~@KV8UU!F#~9|1;=+Ecw*rzRnWkvVS&C<$bMj**_N}f0R67
z3ZK7YT<T0gopek6?b=Tc<O`D*gEu6Pg#O!-r-qLpp8%g{Jeq5va8%#NH^yaLGmzgz
zz68F9d<Xmnd1Lhd0Iv7DF?t?iT(*05Y_CY)_`Y<1&I}JDFAtALUK*YguJhay{S+Y|
z4lhr>8Qy{X82n@MGw@mDci?Nu)1>y}+(BLdewsXPTA#lH*ZDk%`TWzk%x7E7!(;MR
z@K@xc;BU!?!DBA_?{--Xk3&8mo|Jq)JSF)qcqa0@@NDEa;Cad8mh}A<B#!|v3fKK1
zG3K)Zd1iQB@~ZGw<Pq=z<ip`J$)~|Lk?Z@GoF(6g{9oin)BEwhfb0Hn8T&)5<^SDY
z`7sZ1$=`z~BaeWmB5w%KOg<ByoqPhkEcpR=Me;rHTIAQ@^~f*6o0CT?<;NdE{ucQm
zaNQsJW%KzNl+TPhbI8-f=Tn`jsI!uM8GIl4ZunjD2H3vO$UDK4tnmG6{|!(lBYAgt
zIC*OMMz=IDE{{|C`zNi8%i}_B<cE@f2>*<HD0~*V{-5{7<T>zow4Pjl-ui=a+vf@6
z(x?8P(97hdqq`g3a+iE6{Ecy2KjupReKH)WKQM;Bo|Jq7JQKP8oUw>;TmM7jQa@5G
zU%w`KTX-|_p72iObKw2R55T7xmwsa6`PV$-(vSX}XoGRv{|@7l&lTJE|0DT(`h1go
z7W_JSA-qoV7x{R2)Kz{xvR!OH@r+A9(~-|cJ{Mk)Twl+uY~0qbYh3Ct#p^sBjoW-L
z<C5Qs{FmfEz?YGy!1I^Q<k{hS$&0~{llO&RA|C<2L%sn1lw6-rg{^jjaSP9X65}%7
zhdBSqMgA|m9C>8yhqcM|b*=Ws?L7A|9@;LcL+u4a$@TpSKO>)<#^+~|Z-*}?*Y|T<
zPre6_*Sp9c;`#d#^2j)zpCeBKze)ZG{)jwE2H*c1@{#b^Yy9nc9NPs?LH>OfpUX%7
zBfK(sovc3Jfcz!ABYA%x4|>7F-1TGbV|p}y!wBO?9es$$*)ilr;Nz+OZ|HN0aoJCL
z;(5wi<FcPTMgB+Ql3$PfFUBQ56yv&YJhUGo|IE1Lry!qTt-InDy}uO2^T$-iCBFjs
z4~*OXOB<K`F68SQxBa&=F8NCCLzZsj$2|vw$X7)3H%uWv44+S4Dx=S@B>w__ntU1j
z5&3g?qIJGrB=<?iRTT4_$+(QGI9@L*Mt%eHQwc8n+i~}i1jmQECO^WtF1<}&_QQeL
z-};kxgMUiCL-$Yeb@0i?r5}ACo-d8ddfy=b75QWMV&if@()TCaU|i}{DD5uXvW2`5
zd^=p`S>|EAgxzw&<fYHLcwD$>T<T9ioh#&H;5Up*oj!Oy<WJ*LXASa?$(O=k!L?5r
zvn<ijFndP0Y<H>uGwNg|KLIaDb$*uOZmCIr(R0v_d>6bI`2+aJ<Zs{;$uq;hhU<Q-
z^S|1-jO#l3Ur&AozJ=-+MEz6b&Ea>*yTM~`@L%XWCz3DRl7hSxJS%w}cnP?U>qFeH
z8<6Y!0<|HJ$mrMGgM9e=-iMMm&+UB{xz=Apo+`G_?<cR8*ZWEG$A!FKg3B<sc?w;=
zGI`lvFR@+Tl0Sn--RQqr=SPnZ@r_HJ<Yjy=F?m9G3gdFW%YoxwX5&()81mW43&L~5
zbzGR9pn=It{fu~ki7@%CzQxexaFdtyHbMQ-<PG36$os?RkoSboH*Uwf+_<cF4)UwX
zr@=SCWxUdVBKIN7C6kx>KUWWNaNFd+^Ax&_zR6$F<Ii`fA4a|z9^bg_Kb3Lm{|xf!
z$WOpC!=-=eN7gS(1(TQhIn#zXXi6SEpZAWYPGnD^%U+a^lHK1pz~rl%{A`n#{-2`H
zx#W-F3#m?A)Y@tC(tn$p{)T-fUj<qDblv1-y$Qla-OrcE<AjGexMy7I>-%y)GcI*<
zA^(y*JNzwN=3n~3%M3vpIazUw-mkOi>jrSiR}3ZmMOl-V^;Qh`UXi>kyqa;_e?#L^
zr#13T$y>l%!L=Wq|B)sy^<&p`7j7A6@)bOVE|;6UtaoU*zi~DBK==mZw*Q^RrOs^R
z_mEGA|6p9|=yC6)ajCNr`P1ZU;TPaC4>B&@j;~E#>ZeWbF5Hr4i~p?KHw^wBc@o@T
z3XyLt;=jK-c^D2rjo{Kxc^?g34lsEc*H7X8#v$Z~;lqtf{}H%zPcSZZ?jS#z{3d(`
zT>H`eWTnYV{Rws4g<IB}{KuX`mnThL)*ItPf8%NLx8dF|7?=7d@VI=_xYQ|xI(Nw5
zhd(ebb()5|3%7)Q>p#o5q|e&^YLFhT+jl`re?v~=vffsxpNG5|ydc$YhWgdW^}MSy
z`3U4kkk5yIX*_|maq;{OtBlLIav}d6IUdG?bL4xGzXjKM$bs{&dnR8FS@{$jCjpX|
z`5A<Hh)>=Jo|b$rJR|u`csAp9f5>lK*1HS&LgZWF#o>`$R{F=oV9=Oc?|c2ptGe%z
zWwfa;{Vc)#ce2Uj)Gw4@XY$hLE%dXA`~rM0d5*H7GQkhzY2ZhU+xa<TT-Mte`3vN&
z;8%=GozjK;dhZ&SI`ff#Kt3D(*tpc$izgnhjZ2;F$Vb9SmF_>^!J`|OI*HwfED4QE
zox{i{B|ikuOnwEPo%}33w{cmozVB!e<Fa1;2Wch9-=I!7T=qBFABxHsZfRihQok6E
zGZDt6enQ;I+L6bFcQ!6{`qp$8^4Yl5c@O!4<XPdvj7yz*I7u02T<VlTej<4(_*A%#
zw-Uztjqzx%&W`x*!Y%8K%ltG){s-fdKZg7X<C5=+`~&il@c4L=CRZgt3toVH0lX^t
za(FB9jINd}1IY1oAs9{G)yIS7<U`?m$k)NolkbP$BL5j4YrFqK+LrO&h36)Zs^cZk
z2JdKG9$&so>I)5o>*GTIINleKufPFxrKuAIy~w8{CNKL{ee6HS$*aRp8JGRDdU2`Z
z{=b=VsWTG!>*RyszZ;i2o!^rx?)M>$OP%$|KO<ibkF_K8ZU29sug~98lI#Cv%VJ#W
zUq_uB<Y(dU!)0?saUY%i>VmQ+Fa6(v*Cf~fr_+?`^hdr2d2#qq@&@p^<oL05umZ08
z!<!8L8#bH#ho~W+j#6Hat7nbN{3OKwbCEnQ{15V8@IT4lgFi7Y^R^HVBq?@ESO0sy
z76%XTS;@QS^tqDc`DEj`r8#*d)b9wF?HDdWEMrYx#v2{S+X>|V;>p$*<i(MnPhJ?l
zio7{|9eG{&X5%tHeK4-?jZ2?1kl#-}5q{RV)cGi?yKu{I#-+|q<ZqF0hyP(*>P$)@
zRov?e#-+{)<X?~<hQBc`bvm|?DnSrym;WsLt<-sld|dK7@I-Lkjs^X<2RX?r!z&n<
z$1i=~iCV_Powr54i*d>SCM$AFU*qBK`Y1uSOg1k0_>n^#%p-q-I^P%%chU7e9_%$P
zbqb-*QR9-|hx~2hk}r?^L*tS^gM8fG{tKPA*YHfnrOrpFlb5_DyqfWFmye5awIxpp
zA3~l9KApS`e64ZmCo9(bopD)jcjOPk^|+^hCvwc>7rVSJ_f1~*w^Von_K-Xt{0(^v
zc;xSWMcr@fz+)Jf{XBjwpG#z1*83&$$;fBGQyV|#@{e&G$YNaTS8C+z=QS?%x1&x$
z@^9fqjZ2+Jv3;F##-+{~<SUW?46hBB%^~yrqc0OQHF@bj49A}?#-;uP)cJ_~E_?ua
z4BWAYkVk=!CeH{TN1hfwmAnRgCV3V3SL7Yxi^$u<SCJ2duOsgZ-wfCJyoCAOOa20W
z*0|hX^nGsclI#1G{cT*fS2Wy@V(;+<b-jDwnT$()eZR8&#%-MvaJgT|c29%tUd^~{
z_bC`}E%J%*#^fvE&B?!kw<kXU?@Yc2-kba(yg&JU_$TCHRf5nmiaaKKB6(`~6!PTo
znQ)!|6qx@-<b~l|joa;hgk0Zm@U(H+US(0|KKV6xl)WzG7P)G-dpzS(r!Mk^$-BVo
z7?(QL@%%BuxYQYp{5bMy@WsZZP8-zOXk6;dMg9o+YWQXHobG#MxeeF-_F5G0&y34{
zTM*mpC3#+WlzsmDq>kjP!()(Fh9@9z4^Kkg8lIMX3OpnEM0if}74SUd%iu-Gx5G=2
ze+v(XM{;A8`7h=^WT`=phpC{Aal7C4BM-y&{lvJ`ZyT!ael9_drxn2la^1eijLUlU
zeCCpIsow|nqwM!z=(r}p(;1gKS<&bF#-+{-<jcZke~`!7!5RGxl})}3vht}L<zp81
zH;yE~oXPt*Q%BDw<(B0pFZ<yYY_HYi$Ke}{OP}3wzP;19)X7!VUAScrd1m-wxXhdM
z6Yf4_IrR?zi|W)yoxjOz!s8zB^|Zb|FHZgrFA5KH-zNRHLY<Q2E#MWXPE)_Spw>IQ
zBh~o`b-I#wgZCvL1|LX11U?L|<L!ZdzA`TR;Y{p@%Z<zY4@dqmc@6kk^4ahk<ZIz?
z$;08vfAC*upL^gRke`CrA-@doOnwjEpZqO+6nPwJz%5hAGr;GQzYkwYUL3xaye9kr
zc{BLW<UQb5$o2R3?~#u|KFUEq4!J7ZQ6C2rkn7`J4sw0Hv=I4D)URqhj$c*ivc7Ry
z?_uOylm80;i2M)u5b`(hapbWh`<2fmPY+*2o*TZ7ycm2Zc}4hP@_O*I<ofg38|3=?
zeh<k<pw4UZN${{keta@~na?la*~yo|%aeZxZ%)1!-kJO;yg&JQ_$c!G@G0ak;Pc6&
zNAcrXNuC(Kl{^Fd0QvjypUL%o6t9q1NB$mp6Zk*m9pKS^{O|k^hi5Pz%|%w?_?gqV
zY_HFeFG9W?UW<GSygB(kcxUnx@c!hN;iJfJ!l#hGhOaR$<64VxZ8a|AiW1dbxa9zO
zPWZ3nRpBp<OZ~4<KkRU*T<H0N)UStpCh||=dC4ciOOmgIH!+^T)t`c&gS0g+>)nrh
zFL;<UIiER#{8;jWI4(^ybxOOuE*ni=&L5`Wars;F@$enSWxZLm`br0lOPwvqA0b}{
zKLMBaq@R?&Oz_0yrT!xH|I*}3AuFF!9r0Jf+$UM@In+-_{xdwYajF00J^%fAj7y#8
z$QL008(su1?MXjzeVL$!$xHp~n4fwkUlLjQ)W_syy-BM18wZfbgAX+>_4W5v#u}G8
zMUkICo)137xYW6o-LH49ajDY^`32-n;7g24oq6eeopr{g&M@RRkq?1?2bcMj`AOx=
z1SiRJz<(vr4}VHt86I1ja7&o`kUpPchf4^T^_FlSy5u)``Ept{e@h|q@$lltrG5@P
zzEm(SU+zM_3i&2@O}O@x!LK%GMvmP!=tHjK9c^5WWBa9`Tjs)b9tvW+e{J&mGdjs1
zp!}A`qHe!4E?@p$EyTeo@*D6A#$|rmm-qRraA{AUTgxqx<;69(XrJA25|@y?E}lQ8
zflHmDq3`q;;gm0c9jl_r7cuz`CNHhUtnP2@LjDHh>S0{QrT53d#-&aX)cKe^KYSEi
z`j>uEyAN5WkmvCn%qK@X!CK?8-M3-8?}q>Xd?xmV4wyWqGIYc5l<%3_=bw=;&gnhU
zPx$OU74lz(E;GVqy)qAttNR<XlGlglG%oX5A+ygHCr^kMT&luln6ln{J|1)-Zw?<w
zbvh>TH;gj*R>;by#U?NP_d%b_$a}z78<+lX;Qq4JxYU`1{0{Q*@I7!Dm-G|YeaLd&
zxNKj2|Bd^mj;yz1SxLLcF_UlUDRh}!LT=IRvI^@>O}-4C!MJ>>zZa3qxQy!*@_EVk
z!#^-CU+VmnF)npd*KikZDMy|hUWdFCya9QBcvHB{r_2LRmx4j$wPmGlnPptg$9|NF
za?3ZyrOt?uy5p;H$^V1=PsSzxJ@U7WOMVLS&*5@azHEyfH}VPpjne-I{>#v1Cb;Bf
z-af*3vypd#=b}1kQLDUh>1SLFe?u)(NBT)n#d}keFX$<BIoRZ-pD9@H$K>PTqo|Jd
zGtap6(+T}7Gj*h&0tG^=4K|uQD0IUwCNKSL#Cp$?uZCZuI@-?@<I+!M^z+u#k$#Tm
z4y`r_JLx~m_R@0`k(_YdUZ=6%JmkmW1*wkqQ{A{62lRE4My8JRGqjYf)%`rd<nwt7
zU5+$)nV)A^@2BJs;S;Ei_Osl$^fO8Z?v{<l^SSG#L+b7?#uGTZ7Tw=)0j~Rhf?VEj
zntWc=kWW#6_E&U1Q`Gd=W0EI=$AwFKQb+sGW?cI3hW_)LIx?SyV!8{rlr;H8o<f(+
zO<v}+EY=%A{sFwbajD-gJX9v=X<X_|LcTBgaQGnOQb&K@J=(a`xrqEY@?-Eh<e6&u
ze&&&<fPZcLn2R3A^YoR*rJwZieVr}FrJvfUvyHqed^cP+hs-nXUcm+9vc2@@wl|DR
z9=m@K`4@M^Em{Y|4N{Rm^RXa1`5X8L<Y}>=)G#jl^BtUDwKOjMM4(PT@=xIN$tT0N
zkbe!|N4^Yxf_ww~HhC5F|JJzlp8@AZVR%7X?~hyK_(DnH^6e3xLYKKIujgq+jLUW(
zfbCm?yeqsK`6hTR@>THq#$|t76z(qE(#p83_c!F*l3#%LB2Qd9R3_+09s@quxUBaS
zo<xo@F6*s~{Ac9l;ggI@ofq}|dcQC(b-E!xpS&e}k#VWBw1uy;#<<j3jr<1kMeuKp
zOP#-y`8o&Ty4~Yp|G7l@8hC<wkMjC+irA-pJ+0FL$N!}7@ceK+&Ywr0g~-psi&LHc
zs9%pfuWuvhM*bmu5P2Q=eDV(PjmG7;R2i?=?KB?Yd?4~a8@KsO#w9-<`G>|O-w^fR
z8khWR<ddB7U&uU5zAf_Uj7K<M;XY(3Xx!#Y8IN!|{dsg<<C5=<`mK#ie!u&W<s<Un
zJO`tUOP%4UGu?QE^9RVUBG=>gesVo-Um`Ci6XKSCjLUkbW4)2jhHef$UPQPr_4hzh
zkxxLKV&rq+4aoK9Rv(dXKz=Owarjr{`tzwR<offeedNzk=LC85$bOu+$&<q)pZo7T
z=<8bP$o1z_#mOt9P95?l@b2VY;GdBXfiESW2;WOS7k-}n0Q?2{1$e6S{~hn2@Dk)n
zaGukIJQsWbc}e(m@}cmB<YVD$$Y;Q}lfQzWB~Og~`89bI+1cHa=z{+&yNA$O)JbDJ
z!g&?si;*{k*EBBlHP+kMxYTKfe0%a)@ZrXV)}zjN<5K4v<d+&3+KK!+<C6at`6I@K
z4kLfsxa1EY|A_nu{0;d7c<PJpo82PwnZSLlk1f~S&q<6&xa;}xcvOnK1-!0tDP0<U
zHa9MHzCpgfaanH!);rv|<PRYKrE$rRLw==k$)7-eEBQtE0rJ=IGsdNUKGeSl*YnA}
z<=l;Kd1mshJ%ujgUh-Eouji8~j30H8yS05T4f!p2M!0MjsW0_p`OxI$Jm)#i1DlZ#
zEE9?cy~*|OaXulx+0^I9z-7IIJ%uipn!NO%2qzXR$OHIR@<H$&<gMX*jLW$6?@f*x
zm-YUE{0Z{&@YBYn&cRgf!Yx;gOP!*1Lmb>7FARS~UJ3q`yaN2Caar$GUp|O>*?%GP
zS=N2z!|^$xahd04J{F{YhZlj%ejxof#(GPTH-uLq?+mX&-X7kN{1bRn@?r2!aNSQL
z(0}iD_;{)_8FeO+e-58Vz7W2Ud>(uS`M2;j<eTB&lK%+bPJRIXJzU4z8RI=i{u%rw
z`80TvU;P(aXD&S5JG?ktxBC_JQ=0rTygK;<cy01~@FwK{!dsBPgm;B&{|nK7zjyfO
zR3}b7{|!^g!{7_ZQ^OaNr-ZL2&k0{oo&&y(yd-=Vc~SU2xQ<t!cU&Zw*OFv;O^(y`
zAn_G{yVj}iuLh;bBT2w54arl%KPK1rp`Acp8~Hipli_QO%i~>+SfSMh+l|}f)gj~Z
z_`VV6U6;tef!{JN$2Wa`@tFK8^pg|^OnuzUk=*xFlKhV6pfb7sU1vk`e~SBW=t+Ju
znfIaOW2<?eMjkD;_XXr1ruBZ1yf@bS2YH(&J|A`spWP>UywJzxWaPTuOyq0xxo>hy
zo@=2`|NnF6&oKYR$rJlnP>uXt5r0Dy^3PIwZ%<x1h4)_M`g5^Q$cNzP4lBv;W%qS<
zkn8q6M6TQSG`aqN_G{!_n+BofFY+9ih}Yx?G2V>7`R~*H@DGf)D7kL0^5oqx-rD5)
zd$29YTQ>6R8$kXV=g*_b^?c?_@~F7~enZ|bgRj4v{Qv*HnEXS`&u#M68GW5c@JR0J
zGEbq)gxCEQeVl4s&tFeUUK^g7d?Y+O`Cxc%<8psVgY)nr#^t<dCGsW6m%zh~OPzw%
zeV^5gOP!<0*CPJ`-hw;>4(P4P)4;pHb>61>)dqb{ULHd_>UK9S{S-x=apWJsr;^u&
z&m^x2|BAdDd=Ysk_$u;o@O9+F;oljTaSg(_elRZMT8I2$@)hu3;5u*H-1o@xg8YEz
zAj%E@h33^Wz;*vThWc5^kHFufI(WG$C`0}b>upB95Z;M=CA=T`OZZsw*fJ2eOnry1
zf$O*~q5lo!7vS5;|A6l%zXRV7*ZItXetsrT;@b?akoSZCZR*SYt{v*9xakAZf9U>L
z$zQKXKBIv5cI00s^xg$7?Je~bx*TuvvcE-Z;BTBn{v7>GH!l6O#(KXpE_JG)&LZ+s
z@D1eS;akXu!neb<|AD^E;DpIbKM^ufZn<b&`Z<U?SI7^*Z&3X)p(^g@uH@nHShxHa
z+7AwsL3Z*!$cG!3^U3AdA*#W3`&NtUzo9R=zHjgd^5obq6HWd1u}=B4+T>*(e#Lm#
zlb?d`CQshb7u!c37k-kw4*WEECHQsn3GmzGBjERp%W+cQ2kD7%+3tfeZ*Psuc(<TV
zl-qtBdK}mUk7-=$Jjv>FiH%F0ACXT^z7L+pxYQ|wA4Fw0E_Lo8pNsrDJfCqHuRc#H
zW?br@!g*AA<5E91&X+2a$AH&>%YG~S$y@g!OB>_S-1QC;a7#Dil1~huK(0RrTu5Fq
zRK>jy5IIgigCEGJA%B&83;a3x8F-xE{TDi}^zfAAIpNvidcTW}*9qS@`2onvry3?N
z^PC^^S%*A5ycPLGcw6$p@LuG1;r+<Zzy}+b{Xt(39AjMitku|ExaBkQGVn>pr4F8s
z1#{pspJm-g?a1!JElZ6LaMw>_e^~bpKWgerKXb9(6Xa9j=gEJDUnV~UzeOGc&mZrS
zzefHsT-uiY|3&}*n!Mcanqs_h@Ptc`8%0n*0eL}qO7gn!wB$A6*~q)YbCP$47bKqu
zFG4;V9!|aiUY>j%yaxF`cpdWH@P=@m&sdnZkI40XS|%8m$H9kj-Gy6b8kg;&e@FHm
zd3hY?e>N_4GQ^WA?)T1&OPwH!T)5Z8-{H~k`rCE;UdFh>$j`$QlRt+iC;uCsfjkio
zd|Alj!QUs(1<z0Z9=tetX?SV!qVP&^-Ch|mKM|B~j(j`v#_;Y`N8iutQ_2rOemr?E
z_++Y68vQIM?*#wBxNP^B*niF%m+jsg`M=1A!K3}*x4X`R{+u@@`FP~>ldphRCO-^s
zZ(RBuhdz54mp&gMKhe14iy}YExa8ww|KDU>^4}r9%edsTBL6G-Biv74lZU(SktN+d
z|5@fo&Ic-n`Rh51OMU&hOd<0AJ|2`M{~TV6d^fx~`3rboa{WEM+2jSJVYh509}GWc
zT;@$**S%o8taE+5yKP+NL0{K>Nv^N!M!oMsZqfZpe{VJ+`Df@S9r@SrT;zM<waE4F
z6WbZL<LYJHj_YINc3jiQbzJj|%XXiP{b~jIO!zUl>^5><u?_p%EAolC+>LH2_`rYG
z{JyIGdKvQBnY>pgf7{&qX!4%Xy{{tQS>F2va(&(JFY@iE^Dnu+-Wc|$uc!S#tKzRG
zh0EsK<SBGn$mEYY`2xqoV&qfdmB<gltC4>XZ$kbQ-h%uAyp8eWt{<I;?#89hthmGX
zB2Nt;4A=4I4vp5m@3F}rbJj_AI=9R)F7+Ft&K&ak@UO``!k3b_g|8+51iq1c2>d6w
z_TMkmWf0sa9|C_#j+aA%7=QVI)~StrcJc}EaB_V<RTVD#mCV~f%v)3AGH-Lye@pV|
z@Q&mM;a$mh!~2pyf)6CW3m-wA4)@0~<VoO@$ZNo-kynDxCGQDeK;8wu1g`V1?@#+9
zxxNqZ8S+o%8{HE2(0|rCQ{kD&_3xUClb6A9uP%89cn{;UX|Kii>l<WTjvJ|Pp0JR7
zsgDP{$@TH{C^?=!2RFzcq0U3{C>ZZ+@&r0R_(q){{e8&f<ol7&OMVevm;5QbC;3v$
z+vmm;xZYzX^8=V|T;^>H@_Wfo!mpC&z&t;I>+w7nwo9_dem&~?bFNI}8FBufmmE(+
zf)eEV^SdhKb+h^P)q=~k$hvjuVe)bun2!Cw5BUW6460Kag}x^51pl6V3j7@T9QZA`
z&d;BC-hI#HV<Ib`QvdC*Xg=M0{(5n8o#%?=I?t`iYt->|CX?&?)6OM77R%?Ck?Z5&
zX7Z1)e|`^_tG#`R(B)N=m+kTc=KluyHuxj*s4aZ4r{w=2ALWU^UFJ>dmqR`Vc@cOV
z<HucI=OMXqsWTG!)a3o)xyX0G^OA3Zmm$9mFGqd_UfH<x*($rca7#Vo(r2=kAr2am
z$AmXGE_L3#@ADmvOP!C9?@C@D-qX0$xmelP8Dd=O+(Z5o@(b|M#^rH5nI6ZCOZ`U$
zef>GcrGAxG-sh1Qf`4sX>U2x(^Q(<Zops2sCtn8N4%huT1I{-Nyu+_io!h8$ll&(9
z0r^w-Bl5rDFUg}v_;I}<j|`9T)Zec6i}di=<f-8a;5y!-7;jqgs_>lT9pFXCC%`L^
zXZGy{9mwT5l`NylKlL0eA`g>>-LjoL79PLOlc$6~Brk=7akOW?o*svL;W(Uy`~gnr
zOOVgN{kK2)2WfoW5pZdHm8a0<*CsFfXNd@Z<5Kd1@J;0H;akaD!*?2&`-T4Br8CB5
zy`zx7Kt2q9mwYk&0r`CRW8<>k-3i@=TV5NN_3n>w7jB94+<(^nc2@+h!*$+rcn*@7
zyc|!;V1LVET<Tws@ZXSw{0jVis-MTlgVM&O^c0-`)Hc4#`G?4NBCi1-PTn5AntTHM
z1o;K{edBVz7oODL@XWaMgTq3Q@*jV@&YS*RzOZqrGX>kFl5we%TfWgP4d8mec!l$d
zLFBq$eM+7@r>`@O{8)AGE69u0^1c}^ZJ@=_4W~{1sFO&oef~W8iwN(x$@3!r2YGh*
zU&dv>)&GO}(zvX*1@dpm8^ELBg*%xy**`yUAF{+TZtst2$m9BWkegi3$BG!2e#T<G
zCCEp?!;MQnnEs%Oap~s{*4uzw&(9-_%X+^?{dVN@;hl}!^?qbr)~mm#H^{iu-+?;A
z$hX2r8kaiydwri9mpT`apGtlLJ_jDjWo3V>=sslGMc%`6aM8FNA7a4&FfMgQ!=t_Q
zUr2q)<L(<IH7@xrJ{IINF8TEEaO0A{1#f0t^0?atU5!h=f;8ZkPmN0+r(MA;<C5=(
z{08HaFX=vH*=t<#OOU^8T=F<=4DK73{0Zcvy>eIFB3I?Oq)P(hl8=n@#ysTl;MK`f
z!<)kOI5r+DXm9e9b*1j}7?YR%r(hd@<7eb~;ggKZeyD$s{DpC;(*XJT<kjGdj7uFo
zuC6gIbtWLcfqVq~TjNqkk7Ij{OP#&Q|3JPKev14N{2ciM_$~4{ZQV-Ta+f?h{7<-S
zcbWgR5_U`6fBk3meEw>Xio6s&uW{Mm;@|*U%(&EVfP4#bJWUDukxxW^l5wg3R~&!C
z0=Vv1`g78iCjU8V$fqMFAKI@l568)~!cQ5O?bsRTrB{qgongpdC+`J+NWKUDgnTpn
zg>gA<Uykf9+!Fb<|E%NH$BTI6`goCnT#xg)$@REh3@+PU=B=1tT~OP&%>S2||7OM|
zUkdr2aPD&`x%N5MxXkAh%)<oohwz!kWxMFOz9!dkt%d8jYM{>_jLW!IU|c7S%ebZ>
ze~aqt{68Ysas6vt#uc|63cc~4Wq!nC!^4c*aU~<yab<?<xEA`dL2=_Ut_>Jh1>-WV
zI>@&*^`)P5=%*uj8hAIV(*$)!lXroCLB0gO*3_5r>U?e|*ZKUxxb*ox`Z-LV3x3MD
zozJV}I-mF9I-i@-XOy@83vrpxeVEU9#$`Tt`dE+|&ij8}avfK3<1(&r^k161B)qb5
zJFfcVI<D4m9oI4RIncO_>o~?W%D9XxLcY;0-%x#hU380aseK>Et3$?RTrJT5QSv76
zlW^_xW32ZM`DXZQa{WI?VWBe_e?BAqe~ElH^3(1%SxUfpdsQOW?N!&fjH@5|Z%Ez?
z9%0;WuWsbJy#~Q`9&U!Zl;e;eh+N9{I*si$*SL)LKJx3SzTUrflIyq*8JBTQL;pv~
zC&AAcx8wSaT*vh%T*rlnIro2c{yVOvcs)FUaT(Vh9}7yt_4v6O{e+XRgx9A!f1yri
zlb8N=e)^H?{0uiP^Rol>N0V=ZPcm-j=Sy;(pJi~JpD^5yzB4Y{{dp93;g<czWqy9b
zxK5J)4*!chCF;kD>;t;qobYtyQBkKLobNAX$aUVT8kc$d3G-8v{4l(+aXWAA$aUU&
z!L|P+=yRNLnYZh>zf3nS^Ogen<y2qyht1?VuJ4V@xbC9={p7dcKN+{<x<Ibux((NH
z<v^dWjmx+uV_Y%u15?dsbGONoo?PFrrU-c})UQom8T&(b<FZ~o4<BY+=2QP)z<6@~
zKQeRRy8m>mBwf14Px7Kgy&opm=Tm3N_4(Qja@~%9k?VH+mt4;$V`7KbK6Se!CqI+J
z_gR=+`>aj=cP^iA2A65?=_zzM#N=haiqYQR_z8I=_~+z#;8V%7!Dktl{cvtFU;i6&
zegENu<i8d7`JatTpAAs|40#>+MdPyGiM4&5Kgc(w_x{wl)E|gCFUb4C-xv?wzkHb>
zRy4n3>*K{#<l~Zm4o_rU>ipH*7fNef`dNv5M)Ggq+2Fc;@$@k$MP3elHYaZiA7DJ1
zvo<mP4Wr5R{d^`Fm;I_2>Z~v>b-JL=x8!f}__D{i)ESIA=gH+hFU#M?rG5|8e{Edq
zERwKWQbhOLMJ^@Z7y0bQCBM#n$npXC5zj$&@~iM}<T(8Z#u}IP4#Rq<8khCz`_Zi=
z&*s|>elRX|Mxf4F<5H&#@{f#5ek}5@j7wgBFDO}z|IW{3<TDtT{3obi!noA`0{IHY
zB|iiC2;-91`R`#|^7D`%O0MrSHr2S)`4;P)Yh3E+`P(+~GpK*sxYRj}I#-NK9erQ2
z7se&8&%dI?^abTo@^4W;opH&ZL;W1aC7%S3cjb&r{x<S8j7vTj@|}!J{yFl!jZ3~9
z@}C=*d}N&W&NeRjX2@?eF8PGW?=&v?KFFUlF8K_||7KkB6OjMcxa9L8A3fH8=W{Xg
z8I4Q6H1fHOOZ^?lS2Qm9>d4nNF8Te)cOuu<!A2REIxSJ>bK_FyZ`4_CT=G4U-)LO&
zVL0ynWL)y2kUwW!@)?nTY+Uj)kpI`X<Z~jQ1V2F6{Zs#sPhR6vN1q23GcI-NqfUL}
zl3#=MwlpsJ&d3ikF8S|~A7xzfA0z*jamgP>ez|eU&q98`amk-W{wL#-UyJ-5<C6a!
z`Nzg3e-Qb&_=9ViH_1OmKDlwpUqQZramh!P69BiAG%opP$Tu=B`NYV#HZFO6d>llc
zB&xg7Et8B(oy@2+$GFtVjQqFcHQ)!}^6hdSk~^cjaLWmkALl7_`IpJd`N@Iy{>Hz_
zcf%v$jW49W<nO_wk>7xa8JB+ayfGEIp4a6h*YnA$<a$2Yz_|32sDrz3OB3>V@Rr7<
zA3bmEY+ULTLcTkBet2)=_Iz)caj8=i`4Qw*;WLa&ohmqQTtdFAw!6_So5?H3^L~Il
zuIJ!{ap|Wc)_aP)E&M!O?k}>RyoWk}kynJriz`Y0x|!tbhpq)dcJi+9vc{u1)APw%
z<a&Q;VqEHvMxDOKrH-B#eQaFv>yiJ$xa9S`Xt8n0A3%P$ammMv?Qb}4T=JKZziV9b
zdS3U^xa9HckwH?NDC%)Z&(AZF>-l+Z<5K5ethYRQe7`w@R>q|tJ+JO;T<T;-ezbAP
zr^0wA8JBz!<X0G%yq-61GA{X=$R9T@`OK()-niu3BLBB>$?JJ$WDHPZlJALpeDVqK
z?Bt8!mB{zQ+ZdPi>Un-Q<FekP$PXgF2A^bH>gf6H9OF{wFXX=^kAd@$pN&f$eSE)U
zT<Ylmb9`o8^7{B5;1}R!b&@ZF`l*deK0mfgR^yVdg?zYi$(KgHs&UD8M83Uo$yY<Z
zhjGb&g8X>nl3$I-!5PLSKO6aV#wFhv^|u+9{5s@M8<%`X<gXZ){2}CD7?=D2<fA0?
z8&2o*D)Q-!OJ3jCG>37i{~Y;p#wGtH>enzX`S>{B=ww{-%aHGFT=FT9A5X6T7jl7d
zsiWr`D~wAWec#|i<a$1N-MG}z=U?}YOPy}$Cq|<G&70))`B6gSk{^wHZsU^I=WB(H
zOMV{mb&N}XGv=q6amjB&zQ1wF>+`SS#wC9g`MJg=e+c!L8khVH<o6htd>`!3M~q8e
z-#_`5amkNH{x9Q_*Y{Np!y8=4tV(_|@=1(KJ{Qgp^BR}@JmiZRmwY+o>l>H+IgGcZ
zamhDBevt7{KBl|TEu)M}z7O(W8JGM+)L(8~@)MBXZ(Q>FeB>wNl3$Gc9pjSM=Od4e
zOMVCPaq)uyozKX4ojkd5$)7^LfN`mx5c!hEC4Ue3M#d$t&v#lIm%P3|_E6)J*XKK*
z8kc-(xzR0O8yC{&JFARKz98}kjSK1Xos-5TUk&+t#)b6x&Qs%(Z;O0_r2oCYXU6=b
zGA{Wc$QLp$R22C##w9-;`KHDbIIkSvUAU#4amlYj{uARuby5E_<C5Qx{1W3rEs$Sp
zT=JKYKWtp68}g@&Oa5=<|1>V7ujl+@T=KD_y9>7@PWIpV)Yo&;8kc-#<ck`Y`uciK
zS>uu~fqV<&lGoRBIvSUJJ>*9km%P57Gts!@yCT2Lxa0?7el{4F{3zs)8JE1i{&Uv2
z<kupfF!}%HM|>wdAGy8{d1dm`$hR;q>(!r^bu=#ZZy-O0{2qKhc~t!3>37DZzP=u{
z&$!f2h5WC^C9khX{cc?H`H+u{A5iLXOka<RV_fnTk<V^i>g(%K`Hf4y7V=fd2f-V`
z<zYph&wh&Mr)^CBQ|G#jH2I?rM|JSGd`dn9K7)J%d=B{v_$uSlkG@~)cH_sKFUR@V
zG2_zDDbzVhegb|5F7y1U`>5eQWO+b7&vOtt<^T3i$>)HlB*%|2gKXp-k*`3$1YQrW
z^FOVMzoDhck49ELeQfeF-bWbMNb=v|V~xvv>i=P!W?bszM5D9F)4?~AcZGjT-WtBc
zxU4r_BX{AJgT`gOvyneSJ`;YPd=>mM`BM0A#$~;WYsp&O@5>mM^&Un3A^9QrTk;3+
zD5?DZAlpmoT!qIpF6*tG(_OeFv2n>~>lET3Ie7+n2Dq$6wtF@o4|1Bk?EkZ{{}(qd
z^{b#xY4Q)@mB{<RtC4qww}fjyQ?TAn@9@!7XEy4LBcBPMO1=U<lYA+BHC+2ygnqV>
zZ-@U(eggi0ycFg+W@^8EwZ0x7vXQq&z8d*3cw6%6@Q;nlal4D`NN$;AT(<l2kh<Sj
zH7<F5zP8D@<aZ%|+_>cR`PX^llK%zyzl}>?pWnSUF8SY)Pm$(-^CNkEew4|$<n{Hg
zQpP2(&yOk@mpq<+25pQ>UY{RzGcNgTzKvk4amnlRqp8LvUjq5n#wD+>SA1(+^0kpa
zXI%0hxer->H!k`1$j8JR2gy~*_jMn#q%bb|!N?agF8Lu6c1soGlAnxx7vqv2?mlE0
zY+Um5ke^S!4E_W8Cit)9`t#h!#$~<Ru;2b`T-JL6byB7CU&y8SRd^}#Kj7`jpTUQb
zN5TDfnsMpp2>O|4T-KWi`R(L+;OEFcgg-Ve^{?xAjZ6Ky$fr#28<tD)_V5pkOPv>}
zQ`)%X?;;;T{sP|5xYW6TI-eMqIx+D&#(eU`@Ktd6c6pr2i1Yaq<O}k;8{P6dd0hM=
z_+wMQkB^2f6J_x8Aob<(Xg`kI$;fxXvyk6`=ODihf8V(DuYa#m)VQoSZfAGlmXhQ#
z;8n@<z-yA{gf}Oz1dkvu2XAj&`W#(4)K1XTxb)c?`M%`M;Dg{Yt1{2{wW(l|aoHaV
zVt<%pT=LkA!Fuwt?lxJDlk4N%C31cIdP}~*mkE+*{NMgB>s<}cLau**R}8NE;nyks
zH<U5?=%^u|TA94e+epk$Tk^s1UgYcH{m7TY2OF2|l_#I9)%~5Caar$e<Ub=n3!h|M
z>gajz7sjPd-Y)LKE%V89!B>&jgRdj61m8tI1HPAhH2ehl1NbTO8}ReSWn9m(ac&rw
zafNr4QMuy=c>(x+xa=)bVyNG3f=HSC7h%q%{>6Ik!Yy&(nxBY#9+Q{zVI0PSBF1f<
zvc{#)!RV(Vd4G5{xUTnvG~<>b<X@qmapddatI4<hA8GdiUPaNq4Sc052q+*R#UQ<h
zA_9VhCPhl<ASDS&Ad!%S6q*X5h$x_-Gz(2Yih?M-3P^7@M66)PO0j{x`^~d+58Qc@
z`M>XVeS5*#bAJ2mGqbb1v*nze1K+QFAN*aoZimlQygSYo#2bP#yR>I@siYaMSKiKY
z&|3LOcwgo2bAY4CrJr%b1ac|&aZGqX`S<WO<eX<Sx#YoZ-r$Jx)@Yy8<dWxV<i9{J
zdHNv!ALX~hOVzMX<dN$W0e9{HHagJy6pyYdEcsT7m+fjXwx8b0?}rapeh40?d>4Ea
zxopoL+z=KUj3a;5&@YJ3R(=ltC|s6T>K|v*1Zyc?_M_?W|By@m1}S#J4&`;=hg5!4
zGk8O}JHC9c93PJi{-*r0ywkeba<8vx*Oyx_75iFmqukx!h*f@BAsasiF4<Bog^zP6
zUY55zmg@oK9pDSerJnA48ds1@o-D+#R-O)jM)`g4|0tgg-$^dzUTOZzaF|@mU4i(Q
zl`nxGBbPkx_iNrGmpn%h|B><o@XyF4Pj-ZPFvGXxlIK&zUr_!5ybLbrWc?mB|K0D*
z)+Coa|02Gw^1tDY;BNiOxrhw6D4%LM7^=J`{7&U=d%jnBXT&d79s^&kd;xrma@T+E
zR=yYUA1d!*cZc8{-0c^Qn%Egi*3P}ZxWAjYR=NAWi`vTF_sKL@eg^f4QttlFqNj5A
zcNRmGyT7wYR=ySY3A5m`6g5z$j22S7Y!8*k+KEe*mw-Q^JPp24c?^8J@&oW)%AbYr
zCztKN3pSLa<WkRSskWZSl^2G;LoRtTv0<Gempp3`|Aq1;@U!HSXEzRRKaoqG9}xeW
z@{i$vlS>}=cP_>1T-vTAPwzDIV1^RPJHoFbmpnK23d4iS<dSC#;v<wl4zEcr{lgD7
zP0)y3^1I(PYeg>kzeS$5%Fn_(z}@ziQ@|E5h~g!GEdDNLB)Q}-oNnVsDZdOpM&*AB
z`Dc^M`=Rdp(jO$3?SC8MHz<D<{+jZS;a@6upJVxhT*{q|`vX_hwd>clLqYiU%B#a$
zD|erB?ydZ3+dM%Exs*E?^}Lf@miKwYKcrmRT88J9yZe)`E63Yy!8hbm?oyQd7rB&M
z4PLR{rFM|`-{5u0CB6Z?h4MS#os{GDNia<L-L|-39J!P`5&kr}l=~3;sPg^r_moe@
z`udJs@&~BrKje~sI^xUKw+ZD@+<m^WmGX6n@1y)b@G)?AoQfQ5l9^#V#V@uLJ}#zs
zS?AT#?ZiivSA?%uek=Sb<sIQWm1o2EC?5+yNG|<=>*wE6?*3l>bLH;%`=fGq{QZYq
zmUjipEzrQWzqFh95_nN^sgFBeUrjFYFC+dM<%i)llz$4Zqx>UyL%7sR)|Y$VvlqD>
zau$>{4`vulF7drWHTT1mKL}q*E_qfV&qi{|vmWtB$R&Oq;*XO{{7Z=chFsz|Bfe0>
zOWV1`e}ecr%JDJRpfh=C6T1`_q65h#&&@V%kV!7_?t9^8l1qFy#6Jjk`^#$`%|tUi
zr`&B<2bH_+@O9<x?`=O&UJ+jua$0!=yl5j^F;^dVK2SyZx)HXXHz;@KjqR1Y^TyuF
zkJYkyZi7qdT`Yx<lPO-d^S`luPEr0de6I5P<7~3|%B#Z{ksmXmuANtsOSyv(zeaf<
z_y%&xv#^pacc=0vyIOynT=Gvuo|DS6;Ge=>`{4F$@HNHD`BE&lt3Syl|9s^6SNZ+$
zVvR4YcZpvCFQI%Hysq+R;0={;f;WY``r~rO{Jxnj*Li>YG8m!U9lw%1J`?Wx&zDf{
zY~@Gb3zVOLFH-&v{8{B^;m;}m68-|*E!UMe{=THV8T@nQx0`h!!@uOxkKKvmZ1u?8
z?dJN`Nac@*S<Lr2DSsB;UHJj{Amzv5<CK36pQHRI_*&%!uzq(d9}j<@T>8)7irPfy
z$fbXH3h_moTxti2k0@s2uOgTDJ&3PGF74^gb0WzlJ^|~cC%NQ5gZzWYC4M8~$B|2X
z4&tYfbGft0CC?Ygvw>XltS@RF%&?tY;(tK=apeWDo%{%Q{duWIVVa<FQ`;cUTUWDQ
zPx-MH*1Ie3bh-5`<-awse!p^e-)xQYQaC@{qTJo5+NIpxcY0ZQ@BX&jZ<V`pe^)-O
zosBQtEO$G&>&mN?yZTg7?&?!dxjWx$sXV#9Eq9o5cO1`D?(*a)Pm8p9X2E4C(DdPi
zCn#R}^O6}hexve#&|hs=J`VA_ln;TwqWoL<G3D>T--5e(K5DBIoF|v<e5KsfH^U#~
zvRvPU8U*E=+w~=n5+6~>PN+>T@r7+z(1~2)V-eqrT;lO|e~_g7VdS}+oXcHAE_t3s
z{Ilc|e;(!TBA57A5&s^!#Jleg|D0Un-S6TBH`p2Fk?T{MT;i`s|Im<J;`d1>WQH5b
zCH^MF_a~S5VpuOD$R)l%;wO+xd^F;x!(Bf!7yZU6<rj*Znar?B`KD{E?@&HpE>g{K
zSoz*-t$(C^Lu2cIDKCZklxtzz)7A4Av`=T{uAU>5yT6AWqr5Xd53or2zM-~0dzHJ-
zZ-1=3*>yJlYvmhzS}%BG?)slXKT}uvX56=Ip?pA7o2R34m%oqlhx*$1QOY}4x1OQ=
zD%|g#qPzl@YmxFpH`zQpmG8ub=!eRO;ri~J^6#*IFK?N<eVTQ&`O7JHe+PZN@+FAB
zRk`c82P;2P3hkr(V_fgtp}b&C8-I`Ts<_VDpnO|18~-2W(Xs)XVZZXy*iK$k{xgo7
z?<se`gZzW?!>G?yt#Y?#6!KJ2e&|M9pSsE)z<J0G%1`4>*Y?UcV1MkT{6MtLKLjqd
zLKBA*?o#o!Vr={p<pr_*tXBR&CmX*-`4bJTA5~r${n$z6Wzqlqq5OLE14Z!0x9fi@
z$;q7=swiJ%n?1Nyx!Vp0DR;kXlc2l@u0u1FpYCAGU7*};C(D$Vcm0_1oZD=kW6DQi
zJN!}k?`Z$u;j)->ZHn-*B0ktD?IY(igYbr573F>4*TY>N?2bWOia%!ZT!!=Njud}i
zSfYK1r+6v%4&)!LJQJQmF8S9qvUw(uOP&pgzeD*d_)NIeU+PoUrU~w+_@l<$@7pdX
zm;CP{&*RG9gg>eL2l&&<zkzR8esz|u&@SaA;D_O^{@YRik5zmm;y+W~0RFY|uJG@b
zcY^-}cjfLwxh2|&*zZG-_LR1hp@#BLEeGwDpMwuk{v$k9xttrxFiW|+kGfnrcB9}0
zaygG$iVgQLxzvBGBsarn%H8LA{!l){h6iQZ=57b)Rp3{cIBA<#+<7CpY*(>p=O)UB
z!CNbz48K|Vcz8#+TVHcf&)bxbwbc&Nl&?bkEak-zzf3tUD}raq<<N2v@w>>SoqNFF
zAm{iG$R&ON;?KgRJ*6Lb59c8fxKZr<9h}EDQa)vXnaK<tmAm_~(aJaBd~7IOs!=`6
zU?1+Fcv+7t(f(7FFNDuiej2_&`3d-9a#>z?KY10ol-n%Z)@QBqy6}zUlBaNg8~-12
z$&-Zm9m-?jd&nhEF&x)kCYL;m5dWI;d*N@AOP<ZxA3q|OJVz1#sq!Q6ugE1&ol54x
z3>U~HPsI3;gP)a`h5rM0>vxL{4~n(38=h=evj2VpuRt#Oqmiew@*eP-%E!R#DjyAR
zs(e1Yh4Q)ZcFLcIcT~O>-a~oB1iN6-%FDusz+L-9*k%dhJw8+ANkyL7%2VJAl+T1O
zQl0}}19$bo>I?ouF8#?ZsOLU%*?&vI-yoNGTm}Xol1n^Jhl2~`5|5AD1%HxD{2KFL
zhGJ2+AXm>hD7PlL9FKkrqfPnblIIBGdy`8%ZrcXgaM$lWSj{GSK)KsbA5*@(nT=ns
zyu>xuw<)g}VST^yJ^id7g-f*;SqdM&p?KL}R$x7zSN<^kALaYu1=`yNk>!;<FTjhE
zOF!V=Z@QXX;y*|HHOfDNS0a}@uD`8CE_n)1G!JH|r~F^!X-qD8-2KMZ<dUZ*^4zSv
z8oVRiwPzD4)C{*%yyTzNKI9;q;vcdUJ}#noDYpaiKdihpe4X-i_>;<$;9JPK{a+xL
za<?FUukyw4L*(54uairj29v_Y3f@v)1AdZR^0?#s=j4)SFyc=ukA{CkE_vK~{FPkt
zJc#%|mEQ>uI$YXrC69X_xj4Dx`2q2zl%IoFfJ-)6zgdOMgBh-;csWk}h4aj&<dVM%
zPGnmsuLy6ayd}J&^5*a!$_K%tmG_1ZQ9ctsTzL+B6kIQFI>pQK)-Grs%y1{UEbm(6
z$x*%ney{SE;q#OqgfCY9J^T^nr{SxW*SaIDX0T3q1^8FW6X55RkAN5Mcxk(m<y{EB
zT={(X)ylWRuTlOq{5s{Y!mBHP8Qy?g){FZ*TPt#@=lh6ntNbLq1Kh3mpRt|yR(?Vb
z!e$tzd@$~lXDN5zQ}M9!!-!w)@x5?&+&PPS9#noBepLBy@Z-vVfqw^g%ljJYQ?!#^
zzs_gkzDfk#)#vg%Z9CLZUKn0i<#F$O-a;<t72B_}d7{aspV@+PM=L)FzgzhU_!8xf
z@xJXAxT}8y)N`BiI`ADTPc-tpOD>zjgp#)Yr^u!L?)wJ6RX!eh{!qReUa9k?_Lugl
zaJ9`}lU(v2L;Nk|5+8;5XmW}F4DoT~5}$<l6mp5*itYa%@-QCjYZJM|zlZpp%J0N>
z^^x*<@N>!^h8MtzwA&8Xz)LBA8eUoXFl-NXm0yN-=s+&Z<v!mvm|T|2eJ}J#xNJYt
z&kR8SpFuADOlNFA<CV9EPgOn~K12Bs_*~`L@cGKe!56_@yT#zR{49C6onSrgBA4a8
z6Y=kn%Xa?imFB?=XUHYKD%#-(xNDz8c!4f<dv^QXJk+y@@_XT>l&^=EQN9LVS@~gj
zgz~-cy2{VO8!A5yZ=w7zcx&aqz}vxH``?6ixQ$%e^D^`s8RXKQgAqSRc@li7@&)h>
z<dVN4^6w>={Ldr)Ww={k6X5TW%l2FeUy$*U^78PnlsAW;QyvNbQF%}Jugbf@FYlUr
z`$>RbseB~-YPf6v<5;eS<kCJZ(LOhmOZ%Kh{0QZL!^bGU2L0Zh<dVM|^50J``J0;m
zGOShJ+j8)-a=c9!ysLZx;(sKUawlUyEr<`Mx^`HD_^RX*e?Q{ukV`#JA-*HI#4kjA
zPjZR>3Gqqf67PPOFoRs;i`ms0%p;e0_xo8($R)lC;`b}Z#~_0*m7`hA9|qbP<x%px
z--)||T=EY?{+i?x?|z@CF}cL2BfdMi#Jk`1>rXE6GZCLgF7eCIo|DKW{xQTaP`&}a
zT=@?84syx=H1Z!Lm;CPYDyNm7LY@M*+9&cTd3GRA33AEvJ>r`xFNEVrPjbn#A9)6m
zOP-pDpGYppso&(m4AaRaz8&J1kxTv~$iI$U;vYi%0dk3d9q~uWC4Md9&ntJogHRlA
zD7f}{8+po+OP+U-r<HQ|dwl)Lr9Ph`&j@nK^AGY&SMI(iWEr{S`QEhyx#W2o{n!C=
ziLZzL>L|Iy_eTGAnq1;<L;SDg5<eR8SNF`l{iGtkGP%T8#`#!ZxEzm;ng8!&dB-bv
z_t|DBclSx=D=&@nz-`K1o>!IcZD0yF!wKcBn_K@}xqH9<d*$x$P5xBgshZ7Gw3lrk
zx4exySTCbIrj_;Uls|s0_4>+3<9zr=<;Bs?J(au94~$Um?q8)Vzxf7R?tRK%#P+sX
zxohXc%5$(iys5nB5S#xO<t|Ub-nrYYA+BGpRsKdLo2MpR=Bi>TeC$l|a-K5@=MUYK
zkAn|Vz79TA`3iU}xopp_{$t3c+_w;)ru;Q{7P;hcpWnD!`3RiPFH-LACqGRt<^F>F
zTa}-OZzq@QohQwI8TOM)eNKdGu8GJcfB7kP!g1wS!QUa5JZ^hCMJ{=6K>QcVo50VK
zOCI<4sy~rSo}q~UP5B`B-*C5`B$#<*xFXtaZ_d*!2i26%g|||^3f@QgKk!s?In>pG
z&mym4tf;L<uv~d%_{+-iaj)RKa-1dwrTW+z<x%nvLY~ITN5R`F?}2&_A(!LA-SEle
zl0O@HX2V^-mr&i#@RV}5zwA)%w*SM*pDknayrJBE9`YmQ>+yNTv&ugnWb^#2+<k8L
zvc7gfT>V`?Tv56E++7ppC0g731C+bv8mWAy4G+?kyZm=5cc0g~Px*{SHqj!uEJZcs
zmeGGGUiOy>*e`Y{PlLaxd=>mv<qyM;lgobU*6#=8Qtr!$|3vvg_!s1o$9?b9&&t27
zZ6=zbOh3E6-108898~dmE4Zv*sm~dd+gABk@D3`^8stw@{t`Tm@<_kB3qF-x%KaVr
zXDI&}K393!sW#Dk<)z`9;I19k+hz%lsQ8A6e?@tH`0FaqPUQJU`5AcO{`QGHO8*vZ
zs~MCguV(Bdyo&OI$kSGNS$KEl_}FkTnq10Viu~iqrQCtYb3eKCW1k^@8M(x}>zZ{Q
zKL~f*PaCw`i^^NWkE%TGckaGdUKQuVzk9qKKCtA<y%qT@D(?ob3YW!~<#OMz*k1W`
zlzS`Xk?r<%^IwLc<g(q~hWs(g2g8$;C&N>ekA`O}p9r6%d^~)y@_XTrD8C!N0`A&j
zHI{cLxoi(rCBO`ClS{iDLi`1C+1`#zuo?a&m-r75e+@P~S8lg3+T0%^mvT45yOK+u
z`S5shiFf_USaONqhxpm#68{SPL2`*tmx`HT6S>5n3Dw+3B$xOph(DzK9{7jKAB7jf
ziHE$bCb`i**O5!PKgcvQ)FqerXvB9Sm-qt6--}%0;}M^sd@_6<x#TH@JWI$W&l$w8
zh0A^?$D_xZm<KZ)QtpoL$CbO|_*vyky4pNf4z?9=`Q34|lJYNcW3eV&=8CW>!pBY&
zFZ=0gZ2w)AFM|(IeiS}L`5}0c@;~4y%723AkW0I{^Z)zErJhxC%!3*3S6(S6<X|Pa
z<Z<@_Hj+!8NW^beUJt$%?%M5sGmi{Ml`pp(oKwCTe#H>GzFeNK;gQOJgZEPI`k680
zvK>B#_-yhBW3_B?!Cd9|_;j#VIc{eK2bISl&!@`A!v9dd7+&Ev`^0UZr_0-l)>iKR
zKB$@ULO0s@5gxx?x$A$jmAmgHn5Nu)pVeID?)$7BQ9evMZ!@fc%hFvJihVdp@v>d@
z&awWY@^0{><g$I@Hc4=TT=I-V{0GX%z|SgQ0RL9`JopcASASe)nFDt2^%YSz2!{&F
z-St!p<?j0oJ1FmYi_OztdG|=`Bb6U%V?9f`i=PFT+Lo}P;o~Zbmv-BnV<)av{serp
z$|L)d4BIJQ&S$EIYWi(*$^Ukao$!+KWAN8hel%zBm2zD61;3M*w5h|#vUmeR_9H3x
z$DELZ3d+BSS5tn~G#g)2d2x74xU{E~i_6@ggYup>O)x^`X^K1}l}EzIDDMJKQ{E9i
z8-5w;GacowQt`2fU#ol={7IE(B=T%mj?1RtE#(~$e?j?LshAlG4!2L_5w{pZuL^hT
zYZ~fvz4A%$`pP%K8!KN2Z>jtZcpK#}!#gYg7v4?zukgOg8)5|vR9+LF3BL^OkQKIq
z`Ta(Um;GoMd>*-M&jXNWf%1OvN0g6(FIS!bU#EOL{7L0m@NLRx!?!D+1>diHDg3bV
z#qeXw*Tdgb{sjC7a%nerU-4gZX}9f&FE~P4-rP4a|HYq!7lXU?@`(hQp^ox9?d-uV
z%4fsll;3011gXlOhtF5;?k6l)eiP#ND0kO8A1ZhK(jUrGkf$h4RNV5ui~3h2FNate
zHHW))JBD^^sr(4Mz4AZcot6ItAEmtF3|si^%FDyk;8Ja=XLB1K%psR!R5W}Uxx^2L
zA5xBw>js~aOP-;Kzd$Z|9)OpOwGHU%^BTOK@>B3O<mF*98U%Ok+!V_@RCxn<g7W_G
zB;~!}<CLetvz3p9Pf<PtK3(}V_&soG2U#w>of0fpURM^@3_HlBol`?Ke}6_UdD_80
zCYN~Ef1V+i_yLG77<XyCNIX8a8C*#&@naBQgIwZs;LXVKmRLBY7u>C{6=;XP$``?h
zDt{9mqx>a!lJdg1k)5LaPsC>{Z;ALx${WF_D<2J?r92M)0J-$H?tb87<kGKBNBm0V
zIq<b`Sv%66G3LJvFDuWs9Gp-d0smRK>j%n?ytLkN3p<>nG2E@Mhftqp${&EYQT`M>
zO8I(tH{~zFdn(@#AE^8^{5IvE!{e0~xZ5_wXyyMPJ{>NtA?<+6vS2dB%X)P8XJ(Ph
zdaQ!{_bIOke@J;t_!8yK;VYH*gRfEE8@@?-3j7)6N${P@?}qPDJ`H{l?%Jo0S!Nl&
zQ{K^XaAo|Z?W(XbT!sYI$z2Ya<z~3s-qxbr4$2>f->Uo!ytncX;e(aeoMkIIO!;;2
zMCIM!$;#WoGnC&2AFq4@e5&$Q@EOV<hR;=g7(QS5LHNUPSqsw6Z`j2RR(t%A%JVMr
zyrle1_!*VQ-Cw#a!LE0=9=}0+VddxGSHN98-TThvm0xGm1~rv`jOA*o{3m#{@@DYi
z$~(ccl_$a<RGtpssC+$qzw&MH_msa3zo5JmmbX-*ed5|D8D3lY40t!?Ps0Z){|`Kg
zydLTzqZx3w9xuZQ`aQ~j$9kNvyfNYzDz6P+rhF)TmGS}b-^ryPu8H~=!3PFhJ*Oc4
z3gr{wWt2Y#FRy$lJOVDoN&D0)U>?j+&*QhKJkKIecja5){gm&A4^qAto(*^PX^r~K
zSN@)@X7HTy257fWmA8cdtK4meRYuzYS8fX8J1TeAN5hq0gL+O>J`wd?NG``-_qpgj
z<kJ3AkmoqLyXKHoU&Gz@a1!nIz4Bx5-;|e}Em_Rp7b-6VFPvl-+~tpgU#`40{A#$&
zCG~XuMrDeZ?fDqmvjMrBR}4d*NaeS|TPYs{Z>u~R-UaUJgFlxK`YU($ui}(1Gj)<-
z3c0MWBxw*cJU}kXE7N4yq`bQ2;3e|H#!45m6W%13Jg(n9ryL*O3yPv+l;x5#TcSSY
z$tBN7^IwKYa(C`5ek<Iq-|1+#-pVJ!2P@wJAEx|ic%t&};K|Crf@dhNaIe(Td@s84
zvhb<OZ-CEG-WWa?F6}1m&>q|2Vv3jTvn%$yC&*>{9DqC<mG^;fRh|ZaUildKF1V`?
zK28?AtsHL;1>Y!l-*b4`?RG(2o?51^GE`LV{yw6Ka(7>`7rAU#CrgBBf&_ADw`9w~
zoytFiFI0X3{*3a%X#Y2qH-dk!+#UCej>)~en-PDV^0(n_m45;6uKZj0NagPHA=Ahg
zV3}m}7~Jhg^RRwbD!&`PLHP^tP0F{zpHu!de5dkH;Rlshzt2|oMdg*?@4;p9Wx2-M
z@Zc|xUxfprTi!m%Q%-p|cva<7;MXgk2yX~?_4yg~xzXeORGw#%XOQwO@L1&s;0en2
z!N)3p6FyG)ad-~g)&C#V{}JV-vAsP{F2{vtcq4N^xvZD#5&to{#P>q{8FGnlj`+fO
zqgh^t$0!`AN|8(aEr@SG9v)v1--2A?@iu+Xk6c2N5I>w;;;}milgTA?CE{n2OT4?U
zzKUFyw?CHmNpgw58}&b|{2}-k$~VGGrrIa+D0#NRYbx(=rpa)ta<{*vkjo;SEER?a
z<H;ree9OTS@-QClu!>yb*CPG^xwOMjw8K$yiGLpPzbJS6QTen>%PV;*B2P7P$+HLT
z(2U&O+mj-C!LKmS<@k68+kao>r{F`CUo%ItnEQOnOTsgh-vS@6ybXLRxg5vc@A%9m
zf7SRT#Lrhg0sb&t7GIWklld>hYKoWqs|$u4>?W7|3z28P@>%c;%0Ghtto%LrKg$1v
z7r+O}T>D>u7gt_yuB~S&<u%|Hln;bgR^9_%Q~7jwUFCPen<`%iZ=rkzydB)N|9otR
zBa|<LXDa`|E^aWNT(<Lf@u7g7<g$K?A<qeN*%jU2t)C^A_*)VGi*mdT6kIvZ2FRnt
zXCl77@_XPdl|KpZto%LrNOGxX9lUv-K`!NfhxmEQE8_h2S>;XPuPg5cKd*c!yjX@U
zNFJqJ_c_1_<>L_FQ28WyYvt~DsRohD^3KNcjwY9KUqYUl<Pv`#f5&t`xx^nw{95Ji
z_XQ3r{{!*Il@~!j@R9P8@N>!=!i!?Vkam-L#$vh3lS@52Aifz~_V=Ua{~mZ}@>h+&
ziv6gY@|WR#$vMwZa>?@v;$xJ*2TxLd#XK{U8B&x7@JzVdPVTqi!Aj-sc(<Ee_TSgB
z|Gr2r?K2bYaEe^oa|_z@M{<eB$D@L>S(mn3$-f8rYmiI4dmpMjx#T~N?dn!?iGK|B
z8BV^&xEm(IUB8`$_PJB}DEQsV_rUK}{w(}KxGbHNTLT3@M)9)V8{z)LQ{=MV|3;oI
z%72FMP+kWsa<}pb_z}3P&j{4#IK@kSZb5xckxP9BAkP=dZ-sxW{66>v<vH*_l<$TA
zqx?VcqS<ykaqH`6cyZ-t;ichjdH=@pR#AS9O&ioxUK`#)`3d-K%G;t}N>knv<=&$_
z1HMA}9q{LsW3hrm${$7ihsvLX|Ev5Nc!}|LLF7@k&oAH=mAAq2-l!aJ9|ZlC&qREN
z@=|D@smk5o#V=I;H1cdBm;F7dtgYxS^7W{@j84GacG40b1o=RDJ@^;OXTr}Y9}mBv
z{5bq)<p<#Zz-4iyp03|3Ho-2SJC4l3epi89_Pa{+&4U>#E58a}Q+Z!_UFBWjO_k4q
zw@^M6-VW~S|Fo@6(2e4y-&l|O4<VQOzlJ=+l^=$WQvL`0cI7|7?}oej)U(YPELZW>
z<l@N;k1M|pzE0(dM4lbW*TD}`9$DVQSl+kDWqF$;{|V)d;HQ)ihJT^FFZ^5O)8QAC
zkB9%Ed=LB|<<G&3PP7Z?w!>3cuCnB^TxStqLHTKTHF9a6-;k#sx#am5@r{)K3cpc#
z-3QG~X1GatO?W4`EQRb}J<!keqIjuKIXSs7!w7PzPe<e#sk|M0jPl{|H049!6XC8t
zALBe^y2n?jJd==Twekt@^(xQB_pOxwg6;OCa(5rK;3OO1>e(3WR#$l!cnjriuw4C>
z_l3tPFM;i0s`5>!=Un9n;14UGgZgYy{zABR&HGx)UxI(2{1p5j<zK^#PtM&wzriag
zFNJ!xRPL@Tdn;dz_|eMOW4Xq8d>-5#*JfjTSfG3s{1N3#;LDXSg6~ki0lr)LTKECD
zERO7V&!PUWD|dfKc3!#rzOO$#e$5@Wq1^KBL%G)~-vh6%{B?M3<*&hShP(PN!FD^8
zytG-a^Elr~B$wq~gZK>P?t1V(<?kSVo$^5@mkfu<rK_4$D&*i8xs>b94}VpT%YvW~
zZrHlzT4B=!S1DhD_0?GUN_ZFLZu^W;UKh(XkzCrXLOEOT405S|dGrH|$Ty&lGTH)n
z>-`I?uWiadgzr{f{2`lczw*NHSK!h<Qf_e@9=uKQa=d7O<Had*IbPI7o-dTwgnz5N
zJ^X_5w(wuzu0GXJp9*)0*xvz>s(co{GVec-OZ}U}yOM8$$tWJ~+A|jAj#fSp{*cNO
zi(Jb*zC-1ik374T&xIdRz6t({@^$dHl)nW(q5L)Y1?4}(e^&lI{2%4lF0>0=V2W*j
z*KTFu#gz|&mr~vbUI8xIWWBiekFNLl%_>h8@^nz10l!uG40vzl)8K>Qu0HNMccjNB
zt2_@P&lKhJ;rA$C1)rmQ1$;i-)u)YZ_TU+E+5Q)yKYW2)+OsF(KU6--Oq1cPa@T+U
zqTF3ymz-)7y85iPX@UmI-E~ka<?cMBkMc9fldSwt_%!8Juw2W@rC&`#zq)~3+Mx;Z
zJg3}Ur@utL8L=|@9PYOBomelYm2ZZhSN=2nC*^11e=BdW$QFKCj$J@kZVmVq$_K$q
zD(?+150`ART<ErgY94Q^^5h^-d*ye+yDNVb-b?us_#oxa!G|h;7M`H|4S16B*Wlye
zdU@~g_(LksH^{R@`5E|1<wY0U^|eNMLHGu^tB-7>G8|VP5vuv#JIW)+*}hm|Uy;jk
zwg&Q_Q(hJRqw-tezbcP{2h(zIZ=>Lal#hg833too&eO_!yqU^#7xLVw{0?}O@_F!1
z%ICm)Dt`>#NBJZ0+u*wX2_C;w<#`f$a+Gg?->ZBle4g^{@Wsksg+HSFMffJTtH1kv
z)bk#HUFG={dEQd~3H(Fl=i#T6e+NIS{IVr>gZ@_e--!QHc}2wktGpb%&~&?fy5${-
z{iU+<Y4CQ+?}HCi-UvPgF8%E>^Z!5CQKx(S9_2rkw29^@uXmgE`O3T2v%XOIZp*>L
z$}_LA6P78TgnB-%{Cp7`|Ag`%J6nHJdFK+=pH_ZNckA1f$KnqWw=0jSV&iu!-_g<f
ze&su>SwEt@O?m6DC?7k(`s>Pnz;)JJ%Kz$M<4-ED(b)Qj$|v`+{;Bd)O|5^ad~yTp
z=akp1VEsGg&!PT5D({N*@~iURXrHTWx<I!7!+0(u6rabtAV%U3;kk?w@Lc<H@`HFT
zqjnN#1{tyMQa&w=GRH6S127p~R=~cH$?VlV-r3`$J$|pp*D0@Rs}bxX-w%_~=N>PN
z?Mv#<@$PqEw0HBwCwqLl@`|XFyYC|T_rYZ3?xScwMR_<rz<mWBUs1W+&fNR162Dgp
z#4v#3*(Z2>iO07ncjdbG4W!&Xu23`nhT_>v;`~U*H}ZHF<*wXe<gO2v;%9h#t;b*V
z_-T&^=%=OrQf@gZ)C}dwcUcM_+jxA0$8$Ws(&IanyZXFM?yljaLYEh{m6Q65<1iIe
zP~OUh1r5n}!erFn<KsQP*yB$tckA~R@>NuB(PH+6)StbL$Fn`YL3t;X@uu<{;6IYP
zdyq1z;pH|!>cbwVyqXOQW{|r+TqZ5|_<r(b$RVS@J>FVQh|D1Mc`STpAI5lmxpKGt
zoK)`4yW9;%mp=hz)WMBM=gIIs%E!Z#$cMvZw8-O|l}BKngXCjjGP>aLDmZVFdP;n4
z2{uD}<&l<y+m+9QPbW`-$!LYgcPq!~XK;*s4COiN@nTonAgMpcH}SapT(gUJ`&S~x
z-%jP`c-;N&f#l)%7gRhpo8V1yw=GC9g|Og~hrOxCW0hByBxaaIo@6O}T<Gzw9(SML
zl=?^>SO3!#KZ^1fz<oQ3XRqe*PRd>W0pxBUl48<5{(#4yRqpa1Bp*%nKjm@zA%5F$
zBvO18T(8LTvbQC7*RnF(V2@{dd@*@EmHVE@uf_%}^^thDJ=9j-5V-~_Zw_BVj!V99
z%4;6~SNXNbQ~hfDMC#-ImQG}d$LA<_d7dO6Y*U7huaZAP{*}iIma#!nABjgd5>!*(
z0J&}^p8=Cmg2!ii{3+!w|BD`fUwIVD{?X%?m$d=1TvE?F5ns{cjmQTeRz|}-K1+Ed
z=2@=1D}0m3_j>$Y<%^K#OOOBR@zOXzOFPJNy^lO~Jl<OQS;Y5Oz5>@#@gC3g_zaIP
zCGT&_bnW)Oa#Sby!{Zfkf-1|)c_NkLbTL?_9Nk^;rSd)~_;>Ptt}<p^5%)8sT=wSV
zeJOq@`AG6r9)Ho}pDK5K>)*=LQO32nZz1)Ra%aQaD*qZjSa~6t(G1zjw_|&FRQXZ(
zLFMlA?Prw#h4|vQKz8-)UeK0XSNTYIFXfZr<CGtT&sBZ~*PrW@yX%m{%3sF@^aXiu
zTgC9PG&*XjKl{zfD`B2!<&ELDEAI%OP2K}0qi4x;$UjkD1=FrU1*D!+DSnX0=P1v@
zJWnXE4?pbjQ_5vql;LOcyDWu|RdC>zda`#?j>QaaS3VZGrjp-E`8Rp|gvZY-?}c1N
z(6Ca^jg-HQ$7d?P4)bgxA4GZHSB~8$_(A#2n5Rrt`$Xz9kn*%u?v7szmAiB9x0Jhn
z;|Jw$qKw*D5LfPH^27`Y%4@)<DsKc|uDm_`HRXfhe<{bGM+NmG!s5g0Txkb<EIb(D
z@%75@L;iO>UZ9#uY6c0D{4Tz+#|JBS_f<2Le=iBmFkksv_+F2nQQidoUh(T~KABzW
znGUb7d=k8y$79H++mzwsJdf}6_?ODNAy<v+_KDPU8%#zodAw>38>HiVdi*}+<55Pb
znz{4rhQ}!%P}oj5t=z@mSu6iMV{ik()$@JiuUIE{`~=*OdsX@L2pjjM^4*9pUN?6h
zcVDlU^3FJZjaBaAcYFNGdim#1^!RFzN8<qD+99pD&HK2=KUIDQ;ydHQLFc(w`CEv8
zSosO~dXH~c{vqOD^!R(qPb2<&<&{d<<^9LwC2>LOmMa4BRXpBUd40rpQ$7VgM)@B2
zeaa8R*D7~;_Ims%x$G)e;KcevkAF=r`@73uxRGrq*A5F&pR&rgz-uaZ-w)s1;~hQT
z&*SkP&-A$aT_#t5SDyzx@vA((#p8RGH^qIBV;=v=<KKAvFOL_;394HzS8gSb*YkKQ
zk9YO>P~~;Y+U;Yi@?`ir<s0BHDt`_BmGUp(0Zx$I^15=b^>}S^+5X*qy&FA#3;8w^
z@AAhgZ-@GfQyveWqujN_T8}?VF7<3%%C_eLkH0}K^>q2aRz4N=`9t}m@KQ}|Ij%h~
z$N6-m@~#m!?snzJWkxeRs=a{q=ajqmeLqpY4Cgt$n%enXeVmV1{w2y?;_)NO&*HlB
ztnzx&*k<U_%#K~T;}Jj9<6}KOTe*8bY_swj#cX*eJYJ}I?)tbq?UcWd^M|D#Kdk&b
z;(t=^>eJwc+~uCX+`b;-@zL-rOxVljfA@QAe5S{zdVG$@m%`n8iIsxPuuJ)5__xYk
z{cE(a^SL}F5#LIAU3k35rz>xR^WeoE-|6wQ9xriY?s}#pf28s!;q8>ah<>B5^6##)
zc_%8r{A%lKm5+g+P<|cG*T3@kAIe)JPq~)4mn*r9eO<%jQOcW@v++|rzD;>g+z)zB
z`3l_EDAg)=eO&x7<vGZ+(BrQwFM}H&KPs;bFVZ@9x#zH4wUiGkZ{u1hckx|3K3w_z
z*VsI>l`n@sqr5)+UFF}yOWu^b{zXyGI?DT3uyLK0PlhKbzY_ON#wq`)rp+@`d2__C
z@%SO-F8?`?mu!=JxvC(4Q{^pjUn9=ri#>i=`88OsPnBN}FVZ%5eR|_MwubVB@D9qy
z+u4Ij<kMg>+U4<oJ$}p0c4p~6B@eojV6O5FHZ0hzd@uY><wxP4D{le+lY9qEMituG
z7g8Vg)*io&{CPWT_&CAi4|{wE`F6_luE&2N?@sYoMcEfp|8C?BJl=);7K$I~@w>=7
zQ~XkoZ}s>w@=lcJtjCMBw?VR8Qz*WL$77ZE#5|M9J5rv<Jif={Uy(mUdFpnsFD^49
z_S-$aTzNI*dO^8cH?Jt~f%s39&w^iug>?0K1Aevg{t{q@ddf$_qm<)guE7BEf;L6?
zIK$)5c>HtaxJ(PK#>OGlXixbwJbpKMVH2N%N<FN6b^)7glk&yz{mR$E-%-8|epdMl
z@V}M64!;UJk1Ute^Fw$|<?em7R?5Fcd{5=S!$&GFiguW+yd3;N<@MnkmAmhWI-tA<
z;@?+31pb5a9MrQYHf(8!DD&S9H+g)x#}|2gxAHGhz;We8r2=NSpu7ycQWra2Uaq!J
z!^aUGe^hxq=6OMRVdQ^Tc?bA+$`2w>v99)stB>>RJ>HnSu$k4}2WaQ<UgWa8E`O5p
zk5QjV%KwEgQ0|uZNsk})_?zTXe|Nv-Gml>&m-@SMi{qf^+N~1Wxw3Nicbd(W*TZu4
z^!O-`XOc_(-Tl((9$!E%^>^iNRF2cU;05KwQO{4vx4>l704EKy_~Og4KlV``Wv0mx
zt9*dvAWivg@F^Z&K#o(eaE|9Zev%xgkYW699xr#Rt$-|-Ya5YP9*_0-6y?|2w82B<
zIOPwg?D6;+a$Nd^@t5PkE%n5uZRjmMK7<^%BEtAA@|aNU!vh|FihKmczwPnLIB}AC
za{SH8Yav$}Ic^1oQx=fp)>P<Q$#DxU^moXcAh(QuCC9DDaB9U~Hc0B}&K*QLl0R-k
z!p8?Z{(;A<_qH=je#sMWUj}`YyJen89*bBRZS(kN9xoehXO?nf&Hu*sWzbFeK<QM>
zFjn~y%fTk)U%=l}KB|bFaE?3<u`(*t$G(vIOtw$MNB4JE+Q0V1x9Xcak9*(0t8!Pw
z5amNL;dYPbcznL{Smasd@#j7Mvhp#=^NI3D;oo`uZ;xNu&(7%Db0zXr_IQ1dw^jZm
z@(dwg2b0kZk3XrrEao}t@oN2TfYe{|Pegnx<qP2bJU&+WM#SH%+~wJ#{8_}mru-26
zL*>P#!e;o|<3(`bld!d6q<!e_@i`uUQTg4-^)Y!v%3ooieIezt_x1Q(<!+wml;d<a
zcv<;Llzmn?4rf7$LAmSW&i9&<Pe2YC&GYy<k4F!_l%MlFrrf<x^rpv)4auFy#kW-c
z7uI_}kEeQko^toQJkKich4ZU}%I|@Hr2H57Zyqm$6D_H>w2zB#p!~jqcKO>W-vA%3
z++FugRNf2mkC1P*sl&&YJpPNvYoP;|`b(Y$$Ti60NgmJf_+!c=uzp|k_zxbxZkVl@
ztEc<iS}*0P$Ujc`9QZ==E3m9GIzpa7UKl6vGCO-GkIztEAGvlZ&w-y-?v4xPagyiC
z{SonL%CEq3edF=&I2m<$+<l}i9zU(T3eIPK@p#c#TQQfvKH?*kcZatjcgrdnMtOXu
za$JT7Ym~P%Ib=8#8;-)y2TJ}#`!e`E);^JXir29(g934v{3@7?B0WCB<Fl2!{`_&}
z>o2o~?DF{g9&bL<&L^`!V4sGM13f<1;|DzcgYt4H<H~sZ#FbkQ-kf|MOh!{YzF&DH
z=J{E9TX@L?`$Wo>{Bz;gDMz;)G*Z3>@$HrGf{##+uW1U#D}NjD4=Mi!zDc?JzWrUw
z-RDb>DR-aqKc~EcEVvnpVFQ+z>7m$%#>!p4Jy7}Qm}ipm70Cafa`!#?Pbx1^$R;{W
zKAY<EjdE9?GNWve6esadpxhS9kHLE@uT;>^pQQY^BGzY;&$1LgKC8SwroFAaC;SKU
znUtsgX!}B{$DX3R7Uo&1ygmFW<@dplDt{d9@SSq^{iU^&?2N8H?sGETmAm?6d3>qz
z2MXA{8$EuAJQH=7(OHj|OtwK%PmXV_+|{$I^3HblV5IVg;WNmKz-07{$4`4a@^(A3
z)RXh{S6;`41&ciXoyXgc$({c`<het+`~K%8<P{Msqr)EmRe3$k(=f$8k>!#+aqwHo
zQ(-d7R*u^s!5rl{4G2~$ckT0{$3Iiv&XqmZK9PD#ecZNEg}jD~HRE)TAN2V3SV+mw
zd7e=2miI^HuIT7A`^@Ee6%(FO{tf&)<qfcZ6+tKN^0?m_xt@HnE7Xj8cznFaS1Nbs
zMXxCDg)%-<{u2Bj@-9@L2IK4tsXzN*k55vL-6U9`++7!}^!T$Le_8q8QZX}}^!PcC
zm%_=t%-$f(U>`C({+-7MV*{2vb1BcA<gO2p$s0X>LU~o>`cZjPc$qBwM9P)?{oqZM
z?}K+!eiR<3d<Ogu<#XVx$g9I-bjIV&vu%*nljD<>cei1|V&%BK5WME`YU6X~zXy5x
zD1REB;_=DwD@@$W=Kt=SrN%)p%i{}F9``#_Ta-T^W(k67xS8VGVJ|#QxqDx1GF;c^
zZWZ6sRx?;hz6iNxbim_Zc)Z9&JF}$aJheRDk^CV$Yxp?M<Ii}!;iOCDa-Jc|JEDw-
zl)LXW{ZaWs#8;i1JAYOo`?{6K2YdW(<tK{TJP#_rteEvDl)G|Y@%VX<*S;fn{Xazg
z6P3RNU!>gqZo)R@TM>U$`O`Q#`at<$_&Mc=;lF$QiaT@H{~+3}q4Gqu+bzmF;&?j3
z<KsPkzw)XDZ9O)4{D{ZTDZdGM{#Ne(Zo2YaxtI5O#NXiYULH?WejIrwlUK1tg^%k!
z{<g<|Ro(-+DonXlf60&2>7a#joc096ls|wx6UnQ=Wc0YlU-9@^<!-<JL%BPjDL2&?
zCjFR{>%5Wjof2S%w#o}(d+VXx{m#Wu<<k*=yT>Pa{66KYk!KBgL|8-n@S4Z}^mx@A
zJD)6Og!z91mbXccd0__Uqv6pxA%}jQeHuPyc>F<+KTTdD%wQkhQC=9+ej+aklhM`F
z><g(Ldo$&OY*^6M<8jLGNBng1GB6o!_V}9~52o9hFEb;~)5zlkmE-g&813;19>3S)
z4|{xr$9E`q*E_G1m$Qo)KK|+PYiC?)2Z^tbd76=zhskJw@(4^zR}KzldVD2$B^PYQ
zZ+X1POdBNYi{o2)JV|+kojsVLJO;jyyf#cmn>_xK$Ip1Y;N3Q<)SvTLRbJYL1+6^Z
z-{WIFKFi}zkk>((GCJ$=TC;4B)L-J8*_T0g<-Orkly8PV?(rkalcgXtoKXIT<=|W8
z*CD>ZJvKmI)<dj}B0WCL<5QLYfn3X!e}HngDz8<*&Tzov?~xBhZW)!DZC^-Q_V&uJ
zwPC?<<tgwKkIx{_My!l>di;BjSG?EGEcKK;u8(M;+?{U>RPH{<lJ4>Q$rsq7!pB`6
z|Hk7r?z1yXJvmQb<+wc+O!fFy<v*iN2R;6l$Ip^4MGhI2#|698lf8>_T#f~kmAm8P
zBITP<#>dJ(fd8eumsG$E_2=5LtIss}Am#VMXDD~^>y=l+esNTJmx8vuQywoqFL!-h
zd^Y(S8xlV5_4q%^Yha$bXh2yU$>V&W@)3xi<MDmU|3&;S%3YpTIPsQp*CSR&cYFK|
zk5`^=XLfnoAXh(+&-M5*<xeBepB}#+JJrQ<<%t<?Q10%Z5Apa6<^MsRy~<yNpHuEW
zuM#|H%Xjs0zkgRxx%-{FPRiZy29EIfWaS@YyS-QWdTi%QJ-*T7`;{jk|8b9hNxs1@
zdiYoZH)W(9*y|}Tj(IwGJdS)5<zJxuHcZ>>@wb(`W6v+j|ARc0aKR|`mvRrl2YWnQ
z`SsXNW_tV~<+Tz2xW`{0-;BD*=ogPSTx5eJEyoY`_%!8(?d-v09)I5BZ+iS&j~82<
zyPmGxn#v<kpDrFB?eQtf-F4sn9$)71r#$|G$B%maGv&juTo*iEU`g)waq-tGPe7g`
z7++z=FXOq4O5?d~57?zci6D3L3Pq9^!*dx$;ko3IGTac2C*ma>nsF?ii<iW68KvX7
z_*Hl=qZ~XJFN5bYnvdt=<?viaEAd?1odXJOA+Lz%GTMjd63^Fh$I0dXl^agsiNy2$
zjq~IYcpi=<&<rxF7Cy5NrOB(4N07T?zD$lJuSM}u<h9A8$?K5ElGh_oCvQNWL*9^l
zK6zvEmE@7+TgaP`?;~$Yew@4+`6=?|<mbt6AP;cdlgTZ}OOxM79zoucJd(T>c@%kT
z@@Vp#$YaUfIgw0GCvQvfIpjB!&nIt3zLGqOd<%Jd@_pnT$&ZtFB0ojmnfyHYE#$6q
zk@oLGUK*W_csKG0^6uo3<hPPXk@p~vChtieOWun-oxC@B4tXE)`Q&}cSCaQ5-$LG>
zd>{D$^5f(K$xo3FB0o<)n4EuqWC(fbLiUBUzdKhFi6H0e{YY|m%#rvg^5Fs)qRHL0
zg-nViclWx))5&86FyxTOIW*(><Ri&flE;&8Ax|LRN1jN2oO~4dDe}?e=gE`E!#@%>
zuce)n$xGwJM*Md22=X!Hk>n}lQRHLEqsddrW69IW)5$Z)bI3Ev=aXlXuOy#9zJ+`;
z`9AWy$d8jxAwNYvmHa$;4!Qe~mbCLU^3p}@3-RgX5#%$-BgtoyN0HAWk0zf@9!q{7
zc{=%A@*MJc<nzgK2_8;eNsdd>(6^93M0xg+FCsrqj#JTa>M3%*FLa*#5y}%3wJ)Td
zA0;nM{up@#`7-iI^5x`F<SWRd$ybrbl0QzKPQIEvhkOnBeDbyAE6LZ9Zy{e#zK@)*
zi;t6Ur1(?hPm-S}-$Wi1voECm`MR$(`4)<gAb*BDl6)(96!|vtX!7UDW68IZr<3m>
z&mrGQKA-#r@|EPf$hVO1Cf`TChx|DCUh-4q`^e9e?<Wr~w=bmq50IB8KS&-yeuzAh
z{4jYG`4RFf@m$K4UDK_D>&Q!(=jb*Acg`&FSDF9r+`T8oi@U!^aL0OyFJt~^A<i9B
zoV&JjeW|!yf5jpGVT{Eqng7vv{S<i>^W2>?xpgP;)y)5w5O*A7=kERVQ{>gn^DTJ&
zBY6$;d^TQ}mIP*yQEl_Tw7f7wE%JKi_4-iF-=~u|G!_Bxqx>X1j=YPpui#naZdqm0
zY;rk2#BLruto(iCc~W_?0(Qb~kH1bX=X>eM^9lJ#n2dfPk2kOD;B`@yBQNEABf<Qa
zp**>qSGe}-MlR<M?(egPlFRvn`}@9B@@d9pTa;lIxol%mf@WAkKGVFe6{@-SNIuJ0
z6nqD{9G9!YUsdk5<B!PanOK+KeZPyegLpdH=WmLa<FDI(>J&6D%phUn?(<zy%D*op
zQRchBmAlV1jZ*GDr!-Ny`yA1|<Z>L33A3B`8a%#NxqH9kb@Ine4%feYO1|2->@za_
zsNC(p#j$+S4ifLYigNdTAdSh_n0V<sWay%NgykTKe4Vic@X5;E`wMf)WnDEx{08MN
z{)qC$Snr=IclR}ZSAGid*U)*al<V&QHzeO++}$USBA4@lBB*CSayjl_4NoTDYOE}L
zl5*D%E+pS(V#gzXr}AInUn$>(<tmAa$xF%O{tl&@^8RR-j>_HluMSZDFkav9are1G
zSFVfySH-*UwJwhi*2O!otK5ALaC?vUQ|`WxH&MC!9@o2+*C}Qj)cwwhtB?Es(#<N~
zeNX8jkAI-tegEfo%6~$~S_tL4a^3fBHdpSx4|AY$_q~*<$`4*+mur@C_j@)EEB_2T
zHlM%A_S2`b&GVv){~P|1@|NhB{vdzBq$p|A1Xs{`lz1KZwd4nl$+1m_2IT0{Lcft5
zn^@=_$WevRdy-!fihUSNF6U`(7)kExF4M-6yJMsHMDj8M82I-q%Q-aT`zgLW`BHK@
ze{;iXa@PmTv`yr4{^o}5<nCA@(+-eFxL`AWjl3H9N%HFCpOe=h|Bk#C`ETU4$qQg*
z$oB8H1(|#$xjUwbS0Ha7fT23MoFBTO5qV>WX55lIlDq?X6Y?J9P00t6yJMG3cHfsQ
z%hjCXZ>M;7Eg+M#$XihS6!II%XOp)ie~`Qt`D5g*$)6y<iF^xr8}gmxZOIRj-%Ngt
zyd63JUTPHi=M>+b{5$fF<iC-3A}@dgx3qs}@)G2?kY7XIg}fShH}d-A-N|ntzm+_S
zya)NM<UPp;koO{wA@5CoJ9!`SEb_kOQ^@;~&nE9r{t&rbAGu*U`9Ozeyn%cW`8M*w
z<a@}6kiSfR8~NMhL&-lOA4Yzbd^q`!<nA0+CjUboL-ECMkdW;vmb?sk96A4f?nv@F
z6dzCCj68w7EqNk&7xGc$eaJ_X4<%0`Pb5z!Pb0sbd=mK>@)_hQ<nzeKk}oB9$9$Q*
zn%rG0i*F{E>s&YNAkTDY#)rt|`qvGwlTUDH#_y9)CjXNBF7or_Q^@}$pGscjO8Y{#
zpB(bi<kQG2kxwVDMLvU^f7f^>c^itKMc##cHhEw2`^blr&m|vCK94+u`~mX2$QO{$
zCVz<hA@W7!{5#8w$=6f7Tz9)+EBPZ1&3HHYqvS7=KSs{K*Sw7ULyBKc{uTKO@(bjv
z$p0jl>wPyA!O5s>KdT*@@m1t&$SaetC9h4sj=U-Pdh)j98_2tmZzS(a{v`Qu@=fGP
z<eSMe$+wVCA%BMaUh=Kv{5#ijUE_uo6#u+KGu}YHot%Fcdk6V$ir-28BKZsCZ;<aI
z|A2fq`IqE-$iFAwOa43gKJtR4><ig`_LIBcWfDI?UY_C)l3!1Lh`a&$Ve%H_N64?o
z^DE5wb@TsLysoAE9=xun{2jb*q}=_TuRB+F`G?2?n!%l8JAVou6;8FEv6A}y19#_;
zF8;~_Hn6*juMF?4ye8b8Q@K1%;qIKr`Au+lPU5^1+?_KxclWQ{G2MAT#E(_=iGjOg
zsEZ#BcgIBMY4AH$o{8{j%4fjcvBu?@1D~Vf-RErPD}NaAuFrRQ-1m*UKHT{;h<AOg
z^TTl0H#&Epzj1w<^A8ZeS=Hwp-1RLk{sP?f70%uLXtysrFImtgKA`en2Y*p{Q}|Kk
zt>AAc?+Jfbx%<BH50sBZ{3+$`cZ9!GJ_qsVls^jpUin)1Ps+E!e^>q@{2%2X!V6-*
zbnW>W-0k<ye}G@9;{SkOt-MSjTVQ$Rwc(YOH-cAF-Wu-S&vNy-1zump4}wQ39}RbZ
z59;!y!CR~NiSTyHAAomKz69P)`8v4!yAW6IGw^;Y{t(>#4y}tn0Uxg7zl6K*y>s#I
z^F8kGT%8vzY}ZSQ%2NV9PI*oEc;!vtcPMWM&r#kLez)>yxci-3SI^<_2UL7Ie4%pp
zet>(Q(dBsv@yk{G3ixW}8{zAfZ-cw<sdD-E!=F|0@4}x~{wdtO&*1WW1K+RWe}NxS
zUbKi^kM8{$nT%aAoX{Kns5nAHzXw6$#X_+U6|fzNOP$;>og9~9;iLoPI7JG54(cm;
zu5wAt_(N1eybSryqV|P&Ir6HgoOpTiq2v|G>s)SMNPH#oN6D*@Ctx8Z{yOrF<Pqde
zirW_wUyVG1t}m*SN78v?4e|k{?F-3Mi+lljZSs@kb;#ZOA(E#ac~dm5cmwjc$QzRX
zQr5nZ_{QY*u`<LX$w!elA%B$Ioh!=Z<K)dKzSuSPh2(Eeelz(E<TJ=ykgq1ck^C}j
zG?Kq1c}?<G<ekY|laC_5iTpY8Hsn`SurH+Cw&XXG-%LK1ydC)>@+k6-*ytsHd-8~D
z?F;da<fF+uk<TRWOumx*7V;hBUC5_ZwlAdIZsd=UcPHOU?ygZ}a#!q}lBWm7KSJJ<
zd?$G?a{gU=ckLjPCsegTlE06A8a^%|?@PXwydU|e<n9_oCg-3Nk^BQF{?%&sh4?`7
z<LDH`2a%7cX<vvBCcl?_2zdc?A`*Wa`5oj#$^RuEMqUw}j^r6mo=HA}{8#cA@-pb8
zBu^}PZ*)51ape5_(Id%!L}wxK@#K%9QxH!eKSG{J{uTKs@~hB^NS@K;O~{kThmj|f
z?;*dP{A=<t<dtu<FQnWQ@>|Krk{4=uDL$3_1bI677wFU^zq=-t$<@)hh-V65*iN49
z(2ReMvM(flf_)l3PC@4)KAC(eIv4S~$Rp6Xh)*G(NIsSPnp^A(iO(TVA)iJ*zKeY!
z@zcrwC7(gQq3fmindBwVNlBhr<ovrcv&lb4=Oyv?krziNB|eutl6)Td)##)o{sHp)
z$QO{`7;Rrj{6pl=54hxu$bTnaOulm9rTC@f-=Ncx{Ev_~MyDhGD0vL|W8~MNGm`ja
z<ad)VCx4uL1$jkuUXo`O`CRhH$sa_gCh@DuKS!q~zJ`23jC~=#mb^mjC0|FL5_ieh
zlUGZ)<QvFS$v2W0MJFZYK1sfZd=vR$bY2p_nLHbvm-rU)uhDslKSTZpIxq39<Q32v
ziEks1#?B!AJo$L??c|HecaT3vzLWeb@)yY4-D6)!xx2{I$#;{lBHu&)2Kip{%dj&`
z{(a<4$oG@SlOG^oOn#7j^1b$j<Ud6I2>D_1t>j0@Bk;U{85bmX#}4r#<ZfMv7b8E4
z=i*n8hacoLuf<D{M@YrZAdX9!@U{E>M)9jcu@8??d>Qg@$jgyONCGp+sC@X$K6E9o
zNIsXm68TB;D&#fLSTgxK@;2lV<ad%+Bi~M5o%|c}8syQ1><cNk7I^}BZStAqb;!?<
z*CVe`*uIeb4al35Hzc1+-k5wnIbYu$B5y+R?(dkST)w{hi{hJ6d<ATj63^Fn&B<?|
z_-JyRI)zgc$Zw?hx#TU$SCY3P-$ve={3Y_6$bTYlLmpAozL4c=OWub3X7c{z?Z}hJ
zqsX_Bw<mvzyd(Kf<ekWiVds~6b|$Y(ehYadc^C5a<lV@3k#{F|e}^LF^7UQi%WaT&
z4~mZ_$0<@cHG!P3?<SJt6e)~<io6fy-$%~ZcW;yTqj>juRjDUm-xWfqDUMUBaIXI3
zIHd}G4f&u@?8DpSIMoU#oF~UARp@n!+xetioFat~OFq<wgpW(faVix0Q{*@m3f+DF
zNAiyd#Xgk9!9X0RNZ|zcc^mQAQ0&7*ijO0oOFoi(J9#|$Pvi;Y?sFYdZX$V&EA0#M
zQRGqNqsjY|Cy}R<CzH=7zn%Ok@-gIZlc$iMCm%~*0|!^Be=2z_IbYwcB<Jh9zsNHw
zPxDgth2+mB&mo^c{ssAD@|LCT3(0dAc@p^)@-^gB$^RnHA#aJ33CTZ=d^Y)X@@?cZ
z$j_6{ByV}OeIfa0k!O+5Cf`PWANfz@bIFV0q(}14BOgru0Qnm71>|SQA0n?%*1nMZ
zi^!wN`TA}y`BIAiko*zypU592FILXJka8a*k0xJ6KAU_w`D5fO$ld*6$-j#HFN%Mh
zy#F=!g~YEWUqilz{0#Y8@;W%_lsxOmhmo%*KSaKP{0#X<^5zxn3(5Z^c@p_1@~6l*
zlb<5rLLP~eW6A#vx%>MD@vY=XDSjJy*K6$yiGQAa82NVcbn+eK?tZf5*-7s1CyT#8
zzK`<o_1%Z$yD9!R@;&5bE7=#4e=m6?`9AU<<on5!$PbXuBtJ;LlKc?)HuA&dFOeT1
z4;p1o8k-e2(u}h*>^R9i%SxP>Wq$Z6E-Nl*G%_<YXq1td64ywyQC3{$n3#;jaoLHP
zSuycx*{LQlBTYgjPm@MXI5<8oD{*vM#-y0rC&nbFW+rB2#f*)c$PwA;X4XW}m<eea
zV-hoX;;7`*1ka>|#FRucUs#*CteC`!$x@GtwG1nUjHb4kY1tX^iLxA2)0R9#Qe0|6
zN@A|ii^<|fkIqOOE!DJD%)AuVC_XJUGb=qKExl1>KIuj!#${z^BsNOU%!tb!5SNmY
z79W$9W?Cknsa*Zcm{DmNF%#mFvyxLshYOr*eVDS%l1Y`)Q<CH3V$xD$62~W|X62I=
z%NQRQpOk1;$N0FE<OHsC+W5qb__VQOle4lC6D}^Jsbp4M3dfC4PL(y58aFyIBPKJ^
z+-RbfM<L0nqtcjj&6AZ8mzp`s%$$`xHj$%7CuYTDW+kL$o0S=EZ34E@W8%igC8xxV
zG%G0~*=&L%CuM~z^x|5=7J=wd$tk%q$EPI5rJ7|*$WBd&OU-i4mDwmgE+Z@Vs>#(%
zcKghyF=dO3Nk|--JvwHrX@Aoeyde26ZhTyNTzqoYq)W?^XP(5=a1qlJrFGCuxz=}>
z*|fm_5{6_MiDn~|g^!mtJSp!slq=`|7VYY3w*0h=tmL%RxRi@q%>Pl}|1DfnVgm@P
zmMNQs*=Q58Q*w6@7pJDi$%YheGNH+KqfN4;XC$X(m^Hw$;?j>~#-t>Uy40s#+^{Yd
zVtTW<l(f-ilg}{in0F~{0cq)`n==Jm>WnTXNRP|RG}~vc{Uy)D7`y3SS{Apm$EKww
zXPMfkj?R-DlVT=h#HHt%Xu7}b6xpw6R@)Ee33WTQ>8s76ro^NqkIab6$h$BuF6^KY
z6qA)WHa*4kl6kU@G+o`8n4~mwz?hJnl@#vv;V!P4=u#Y~!0sq(NZN`gg>9Fen*V&c
zCYpuGGo!4ogp9c4ROweoP6{h%w;5G0vs`(%m@$co>81l6FFk3N*&w8gytK|F_oWEw
z=JH!$iE>Suo{?yJMAJc;gKBDOV!Z5AoYBQy+VR3}KQqbfEAi4_s!C^Oj~yGAkv#e0
zK`U>BDSf0l>`h2cFe@b`+4TE)Vq`x`95qU+W0v${biQ$BlgY}vQzT`ljy8RcIj*E<
zn}BesR8?(Ao}5@x+sB&y&KF?zw^1?w$MmopjSCyp?Bf1BvW1N{JCJFMe1gnol9g;$
zxM@(F)g<RW{)F4x#S@;Cw6rnV=`rTW9iL%N0`hLQZt0RUvA$z6Q_?0}Ji~B_d<$(l
zh5Y8r6P}rw;;VtDVp-Yw>|}BA@!4auW$zBV%Dlyx?Zj32(s4k}-SQ2+ct+-p$S+y4
z*&)=XBYO}f^F&-sHYz#8bVA{|SGXz0j5epSdAC`~dU2kyX$g7PUhW8U@@iH_e74zr
z!_(p1hYqaiiwRwQ^DK<p#lw?Y7nPZB6Zt}OH$ZsiM(vZDn3#~5>*(Y1gl9+L*{HWx
z@kwcEnRJF6o|Z~gd5((<Y0q!<Szx^B%tzy_UAl|>&Wz3Ok{)hkF{3il#$t!yGEB>u
z^%FLdsd1QwCu2WMjZaLGUOkM<eV!XexFyd>9Ba;syhpnDxLk>{;_`Mw2vLWa@X+Wg
zY0s(h)Y8=<H7z{9&okYg4x3)};?~F^7u!0|dczdcLD?$|p39Y)XC_>UnR(?Thi9=z
zQhTA6&t$Xdn{$iocsa!|mpf*I&3itKgSac)267n)NXp7eHydntb(zmew_0=Y<6}(I
zna2G;PEpKR?|3fAwy9iVm~KAzsgz8b5SJw<n&C-UjBS!kUq#&N$u>Pm?n6H|x|p%K
z_s6jM=^3Vj#Yvv(&CIn)Vth(mhG(*CJsex~B~Gr!`9Bl=pA*qt{SRlGaS67a^65ac
zN9K1n;TAx)nB)X=g_G-&gxAu=2x&>4kZU2a@7hZ~Z&YTIS=R|^6H@c(OTu(^{>&H&
zlsL|W?J{o>iQ|*a7H_W567ub&FyAP1&1!A{aK^Amd$Gza*U_#QlD#%>iT2X`V#k*^
zz%GorQD9F=%_SKZaA~UCPspz$lY0#R*Bs`mJD-l!ZA{r2d5d$?<kBEdW;bzUwmHGf
zb>9a~WOoI#4<&~S?M-0rLB;v!Pd7*Aq`dbcT<NAO%7{<$=AM|5mX?+4keRD;@kz-U
zd6#TdqUl8P-^ESWin|7J>3L_AsaX?KWAd9Omz?J8`O<Zqy_FT8nI$)}F1|1yBeW+;
z_Pp61f$j6Sks~t_U1#V{tK(CWGcTUDBhGBqqc5J^TFXcsoi{KgydJXw<`7`+7>4&l
zgr%B+xjQy?Y<NnPnr4pmU3v{@Xqr3T?9k!s(W%*u<klHoFDII2%aCjN|NlX5dtPS#
z7g4FA)NA)rVtJ@$UWgTBG|!{(8gD~ioT^{fHdDm({9Q3ep^J0cC;D|0!}--e8uP7J
z^W*KUi`u|Elblf(#XdRtirlfj^d74G{gK4E`s22L(A}7n-_-o);WxZ+e^211NvsTR
zEbr;cbKU;Yc%RJu{*ufigRZ~47oA`ITjGo6X4}OGr2a)stge5KvHZ%9#QR*|n&~{~
z^6xMc^DBSfYkAvG-qP3Q%X?G#l^=okyOwg{=D99krsr3F#Id~P%UkTa{O!i_D}Nu#
zZ*8XYpv#x{aPliZ2jxd%W@-N`&2wG;31j({@BY|ktxTjrm;a`jmS6c>Q2sv5E9J{u
z$GZHVj7brC`(2Os<zB}7B1m&_epfB|J4AV|x8EEjbiaq>=GXO?zi-U1{^_sV^>+#d
zN&T-jNp$^d7?%)T{>tXI#CI{juYCDkwfxGDe#4d@f%&C;*(7xNgN#dvE<dM*E%B5c
zU3}Eb-`C8XU-{{8+Vb~dPAOkji7tPlr~KF(?Tp!&-;H$nnV#|^-?HVO#EepY1@l~&
zFW*aO{^eQzQz*ZPOr$}Vzrak-Z~2S8ZOiY9d8K@Li&2*^e~%|c==ML~($4tbmS6tP
zFTe7mQGTpV6ZW5#&2wG8e10;&^3z+Pe3?jtUjEab^0%P;B+M_%U)AK%<(DwcBq4d0
zA03w*A9>K_%lEA2xBL~}we2tKTm~sW!i;tK%{}Eu-XwDcf&1P{`zmk$Ex%KhU-^+J
z-~FDrlz+WRqRa2&DgSsITjCirod>=A@_hpNm7jFN&gj1HRLZYm66x}jJmv3eXG{Ig
z%*TT+Ki*URsrPO9(U@P#uVoVH^6&SQzooq`b-y~X(&gXlDL?W<TYfC&m-6f6Q~nB1
z`8l0!`StDS;-fBKPP1eY_4d03^Y^+qr+uR5m+w2sZ~e{x#MZwn=9l_QU3B}&_K{!t
z!7X-1_d9J!ljr>7b5HpvQGSjjH-nVl(2RBYWla0#SN^^(;cUSayBPL`dDP1<->;D0
z@(=#h&dB{o<9y1O?^VdJ{3toGHN(jNQhsw!`TIVzGe%*4S$^q@^zsk#l)t4%SbW%S
z_L+Uu%iq^ie(<F&_&jEo@|&6Gx_tS5hy0fRd`~-LBh2qcy8Kz5^3S9ENX#hZ-(a5W
z@}KdPAAt?Ow<{Q9UH(&^@*}>o%RiCImqW5H|D>n<bd>+!mj5kJ`AbngFTWfTb@_$O
z#+zUJulyg&myJKa?f<2G%9lfuF29+l{NpHJpBL-)m+!^Mul(OoephP$w)vDF=PAE5
zR=n)9Jm~U=dCHGEZP!1yzZ{bE^3V5_ABFOVapC5<E`N@v{PcXvZ=X;3D?R0}MEP>f
z%7ZR{k7xcZn149WY@X}+cX;Z*67`S8{IdUcGS7AUz3C~xbhMq(OwKjv^1t%TAMroV
z|Bq+>NX%a{SLu0|zk1>P_rEC2-{-%~U)9Vn%NV8N0-Sio!lnJXndiFwx_HW8iSph4
z<I<OQPcZJ_DL*!!@^8(j`~*+==TSZ`gD;k<%a8GtzYpc}`Li5S^zu*hlwTSRFZaiI
z(B<FhDgR_X<;yOi%U|v(KMLjJW4;%wpv#x<SIMvcj>Y_AWg-oF{#~B>pGW;m+iom8
z59n+1==y)`DgU?xn}I)LE3b9=?|I4(zP1Iwg!;?&+uzKu%a^~ek`Po=iU^05{p@&@
znh;_6;^VKL@?ZMK&bagn8!F`wG*5N;mzxu3DPNyImzH2NU}RsIN4@-o%#8W%zp=mC
z^1EVADSxneuFG%YDL)+r%RMh1bomWD<*!Hiy#L&066x||Jmu%0d^0)Mpv%9_Q~thu
z%9mrIF8>}+`SbtB<)7{;|71Sp%e`V<{^OqV-QSNFFz07H=;dGLDgQjm-;V89)_<%?
zq|4v!DSwOHm^Oo%oNLhKZ}*hH{tsI)um6!IlP>>#Px<>${(sy4-tm;bFQ4)g@+top
zPx;4D{;^z3pLhSe;3@wk%8$kT(*C3JDgQcif|TF>zfyJ<GfcOmi;uefuQl`MxBs{N
z)3$$C%qit3ndiFwBR%Cu4z)9y$+-qyeqYc0QUBxo6Fu`sWB%82m7cf#GtK<@Eq@M{
zpZkCLdojKIYdqyg;KW(pbKpTQ|J$DVBQd|(JaP?s{?|SA?}{&E<ozejWYYEj#Z!J1
z%8$rZdfxWC;3+>gpYq4$Q~tH4LiugKu_%Aee<{D5nLoevHxcD`#r(4UX693V2T%Fu
zQT~nprT=W}DSscz|4kOo3{t+_i#Flm;MU79Px+CtHtqp)e!zoX|ARc`Z~xcszkL4m
z|0p{Xc&NVj@sB0hhomgU*!QwW+1IfqTUip>Wh;cpPR166tWlOkN)lzsk~KRiYxX@$
zWGTw;UNh6jXPWtczW?)jb?>?Np67X==Q+<=W=!XL0*WyC{y6wG)=298gK!{^$-jkz
z-;9TJoH<G!wBH-ZWAYPm@Xf)&4oIhvr$0wbejE-yH)`VZLP>&rA0Us(FT=r)Me$4i
zkdYZoelZSyCW;R`(Ehiv@IT|=>)0ZB|HbdY!LK1e`v2hf=l)pudpP)1c1V6U^7QA3
zX+QY>8*Ke=n-Iw-K45<!7Ct-hM`5rC<~Ub_;{VtD%?!w6<3os$d~`np+dmi!UmXX(
z3&nT-V>vQ|X}>ZKJ{^h=N6CZyP%M0R9DF%@q+l;f9(}^(yWrrPqxk(OL6Cn3$OFx_
zpU{2*|6e{f|HB-R<^Ie6PjK)h4kP_9h~j~K1dzw%58>boqWJj0{Bkg1+W!d$-wwrx
z1JA((^1-<TlfQ|BF9%LmKtg@|LS6tzO#U|<{35Eq<1ZSJ$K-?W|H0;e9Tfi(s{ZH-
zVDgCpd2I3DjN+r;{{z~87Ym;i2fyeRl8D~t8yEj14nBktX@3n$5ah=Jc})Ak_Yh&T
zzsnaXcpN2<K4ID~je}o<;tQe#K|VN_Ve*}D@K;fMOdjU79S;5~7JdR2{#_h=^nc?2
zFZ&~K@L?zZ?tc%k@WJ;SVe>x>oUDL^X)osWYaDzXEc|3ZAEy6@aqtCE{Qt85GY)<L
z7Je!gJ{7P)$7a6{ith?K;XuN)pA3-4*8hr7{DbR{bU+WL{lYl-H7Nec18gvh$rr%E
z=RW!O_>+N!Z-#?EhT?Pl2j2(>Uk=3=M9G8w?-3UM9UOcrKcpc0fAE8F@LjR+v#{`s
zaq#6(e0nfA4kS$f7vkV&qWCo^S<wC*AdlJpBRKfx;9?C(n*YJ?$H6y8y|8r^sb+uv
zdjjM!`Fl9{MFB`bEikwbBux8%;^6C`Hu#rA0YUqp0(vm{;CrJ$6EW9+`->&ue#n2!
ze{_I6w*D8(g^d49<j0_W`wOt}&*R|7#sGzZ^d5QobHub?9S2{K7s)@k{wf5tVA}7D
zgKrK_)<9xI)gO8FcmKD?!6)WJ@(+H0@d8kS$-jq#9}7;_KuY+J_6Og0h0Xt6{7C*7
zN*-+gmw-M@{wo}O!Nh$$1iddj^6GE<!S`fg;};2`_^AE^@?T-$_u$}nfs-YW-XKqZ
zj+pJ=j)Na7g5>9+BtiabAdhK3xStYOMa=k*O+pIRqU6yhO#TWEz6AKg3?S9)ACc?d
zG9Zu12j9Dejc*Q4)<7CZp8gy$`NsfxZ2sRy@ekVn7SMvpm%+i;NkJk}(-2O+Bo2P2
z7}9=olqBf?3LuZkH^Ra1Lh-@hM;=U=_JjLXVY441j^wYRgh754kjLbE;o$3}Aq77i
zgadg@z8enyDvE#5|J7LdNjUhhbR@X*KltGL%COm=g!<yF1|<*LUkl_h?XSSWUq$i3
z-$xxxnD&?A;9rtJ3Zma<4f5Y(;rHR-Q$0dbvk$_7JSM*j2R}&~$&W?JgZu^{k7+;n
zUNqp*U;V!Z#rOV?&%a-B@VRAB_ERD&0P>r#@JWH^*!XhbWDTSn;KKt6)BZz%Jht|?
z(?s$Qe*f44=)trf++PhFza}3Er9Qw0vzUBl9DFZrB%cl?58B@f<T3e*IQU~IzS)1w
zzcM)Zu_*q*-;cIq;oIWi%M~Ikjv9tgR{U-MRUCX`@P~0gs@Xpx$A7RdW7;2%gFlAi
zzx$8&55~c7M)A?_odW&ejfMXl2R{>BtN>{iU18+qU+oXRzYbgcB^e;?2frTy6UYa@
zOGB$e$Hhk+{8-e)F9!-ANSN{0iG!bc<?s0G1N30>zv19_q4?<c6``wu$^VLj{|3dk
zL$x1h|7R?Gawzux2P;Ps(~xGM@qhXMFd&c3|1b-r;3`TU<PTuspTWVe0Vhi!okO1f
z95L+|#=)nuMuN>zk|2Kw$Yc6n3kM(a4k<{3l1HB~`A#_GVJLZ&8`0u_`OgkV{asP@
z_d-d6_5T9oG3y_WgFlAiTl^s-Gnn-c#=)P%;=eI0{3kg0I^bdhNWk>;uY}2ejDrui
zLAD>dpMv&J0GcrEZ^gkkNAYX^MgM#JY{bDgNAVB-{(cGze-#HGh5~#32Y(R<zsMG8
ze=JHKw0{N*p8{|w@aV7gLuL(95dHo#<kjEy69e+t`mdZFk{<vn2NKAi1J0QKKaGPA
zsoNKW%%S9wSAX+)aqw&Gk$geqX`jD<g?|ADfAu|*h<-05F1{uX{;DGqeDLqLU$OAP
z{Z+B~U#AgCe1rz0&Oq^hB}*LqIcFsQVE<nRBr*N}00)16u?Lj5{}2D)!@)OqLGt@i
zwFTRM6$`%z2j8_BDR>+Vt^)}u{;yPkgD>HV<i{dU`|ZC5NMhRm2?sy64T-t%FWTSn
z*NubU?1luxQSzYu-?8xbaPU`A{GI>c|HQ$ka!2y>4)8az@L|9L8Ej%A49+UJ*aQ;)
zf3!a%Adjv8zd`X~D0$HSZ9pHU|0QwoVV(PUh}D1aMRD-^J&^VvT)+Ip!oP%rAKQiG
z$01LDj)1%WmGp4%<vfx6gZ*z8ki@kA1`fVpHxl#yKjPmB2mcL<PlW=4{{M}IkHEo)
zd_wZk??Xgh{T=@yIQY%}Nc+bQv_BYVnD!Uo;1_|5O(1b2)gUi`Bc}gzaq#m3k%9-m
zzs1MGZ^OYK8$=?vIRBvcGno7)9DH~Pk{=F3%7gwV#KK>|#m55*1L+7-{Lc}SKaGRm
zm5t=np(H^*_<w0J{eKt$fF#WR4*{J8B-F>B{XBTU<l_VK*!uq*7Ctc+{s|m>Dik01
z^T59nCjU4NJ|yRF`$@6zrE&0KC_dA_=zrS}?mLdnemWFi5G4=#pBxL{2nSyd#aH<c
zzCI2<9K}C4{!n7!-^9U>Me$kxgMS?dzXpr_R9N^4IQTXHBR>`ge-#V=2o`=B4*u%@
z*#5;h_^@1L{2grnqgeQTIQUek7dQV`{B_~r>tNv@!@>vmy9aLn)&B+mNB#;9egGCe
z9Tq+f@BtYcUkAm<7=Hg6e<%TYZ2hkY3!ecCAAFxGHhut#&-WkkFMxwThJ_El6B~2<
z)xp6pLh+Tr${k3U<DUi&KGhRs{MDdj!SRO)3;!ApKI9M*eBuBb%wqCwaPYfO{Dbii
z!@@`4;KNXS%y|iuAA*Aq$@_c!XT`$L!NC_q@zL#tb^|6q69=CT3m@ET1g#G}FIS`Z
zKsWkVl0fle|8@5td9<E39P(W#c{vPubp6riQI!0jilNF=p*G&Ib^EshG#7n$5Rk{#
z{{&I?&)Flt00-lb8;kvmIQU-PKw%)E{tS=CVOA6J8;5+RFH+w1%pcMH3}*d*;HW>{
z5oF}mm?P!E`h)MHN6VwzkLD<H{P^<#g`+A#@*g8lsJs8jqi;|G^4R>>e*?+iMtuPW
z@&&N)xp45`pf(;TJA@`7&*=K2@3P|HcLgB%a>tP+LH=nhd?_4!*9xF8kaT5{^5`Qb
z{|pX3RT7flPm7cU`9fIua1<Z?ek(Mm`6rS;3`5^Rp3!{dQwT&4hkPDt;~~uNe=y}O
z(enSsKz2?d<DMJiKAMX@JEG(<ib2?zkn))K(Q@efzJNUVCqB&5+$ecLbV1Y^U4QiL
zcoZK~{t`;QpAlUWdB&8#3&>-O-?>6$`;8rlU+}l&XnA!10qwzLgCxPT$h-aK;1%#a
zK2XpTxP>VX{=5e{((f1hb0AJd%6~Zh=hl7((|^FnC#>?#70CKO1nfJQFy&7R!v2+n
z&WH<&Ns5RF1NVhRg~Wx=Adf<Vg5sj0FqoLQxHxbEk~yirvZe|?-ai`gATs-Fk%K%i
zf2sGMJ97J3IbbgpE(o|aDU8Dn#^GoM<8Xm-SV4fT&0TKn-?GAZ3gK`&&EW=7bnyTR
z1N#EPJb?}Rtzjq?X8{>f2=Jy7U{k?sD3uT^d!(v;%^v%2On|w&z>phS1BE~#2(UXV
zN(U(fs0ufS8xIWJWE0r!9d;Gigb-8)2q8-XCsK%_g)_(pH>XA8L8*OhmX_`=E{<*j
zsBKYCA-7leMwzc`ZE0-}Yzzr#-rvj;)XnV%>=h2k0#@z6tAYmx?q|IJ1gy%bQ>P#h
zRK3o^fERwCtOs`52DZ;Vs0S#G_VPbYLfHy<0@#}!c*6=z0IeA;`%it)E%Cq926%t_
zpK1VV0gL`L1OI-@SUbCT*xJFs_iw=5fLB>q171a&2SaWy&9ncp9OX%1Ye#3aCt<*@
zqx($@cxm6G|J2jk3I?>e6AX0NzD6FHm5a68KGF%?j~C`{XAQIVas^BU%I+5f%tey{
zKmOxBlwbY{n0*#*Kcn^<2GsuX)B%70kplw99fo>k3JlnQ8rW3S%^D0JAj<w&^QS$*
zICF<_oDz1lfoUlKazI`XxB#ONmC;f-4FrJ&u&F2T=8!*+!MmVeP+S<eeJoHlfP>sY
z8U}1z3~ZwhHZ?MI!NNe2zbJ30hWI3JpoVCF3$BFa_0<r&25`iN9z5_X90t6xTr*ON
zgBvKSiKt|k0B&d@n&8p;?1Fpy(^&8}zWZ7Ea<Iq4BSZEJSi$)S_a&gA(ZGFpU_Gcu
z3DIS8S>9Csvb>r6mG@BQ5I_R>{|`#+<nZWtc0m9wR0EIJWaow>j<Rb48Q`GAegYmX
z29|?I`=W{P$fN8^k^1c9!P|uHE=VER{&Q5>KNW+9TJG)bMf$SCkhjpfBDLh;sK15b
zLDUen@JItHtw?1$p&Delci=dyiP%D3DGT+?vjBRa%u1k*Kn;az)FKV&l)!pMYEfxM
zD$AiYAJD3WhDIs@Hbr~kA+;$1wTFk+s3DXkpdlZA@9hcgAs+xLVQ|E<CSn$jc#pgV
zkGxI1f7`NIEz&~*jyHfVdRqd};YG6lP_oXQ9(BJ-Spsy{yd$93X1~6TgvTLjk;*VN
zyu<S%fDy=oU?F4z+h5*53(@eecDIuQEJf(E6N3${14n4GQ|$-GzhdDMP)G~WiPQ*&
zfr$M6FC)M(0G}NQ0}Wt02f_eUtAtoR5C*Yei^IW&mXb#_f^8Ykt^<Suhy>bnzv(rB
z7y%sU3syv*oes$Z+W{85O#lrE0zwQB1OkE%SqLfhr&`dEA_%es7+YX55cj9WK)vX)
zfHv?a>VLFpvMZq*_Fyr5Xh=G+J_rCLtvxt_(*<V_X5gf2<v|CW^dR!!4lEF8$QsZL
zQ04$255x@+b3mAZY#q=}WK{o&7i1OY%l9Sr<II<xt{m);@aPhD9T)_HETI*;1Pv(z
zDyfNBLEZtPMKjW!9j<2i36A)@-)hJQLVIe624q&vGK#$!SQdZ*rHNPuy+91dt3^JP
zmu!TFwt*cL@#T-!&>Cns1+dQka|4bTMe%@mh6CZGEVMaK{U^@gKrh2t-zPwSI-uyi
z4Roai&?2Q7>BtUWlZR3P;|B0y5ol*R8|bN8Xv8r<0N$j;4ww)4G4wESiS8zvhy`RX
zQA0GMDg-)65Ul<vJV_I86%ObjMm~B6u9W_%d1#G0<GVf3(&);45o9UA){qUrrEtU`
zs$GO?z>fXT7y)*1O~gF1xSC}=yBttm(2;-XnF6$zgNS$Xpbdyo^q3-#s0V!t{sa_k
z1u%YrrdU85p@f(P8j%i;ZZY8cPvyd!0U<TXB@YGUE%-UWGteOL*S!DOhH900>-`8i
z=x$WI&71A+?ZpCCzyS{;!w-l<i~#&cAG*2cxd1VnQ|R&f|Jlyq#)Svl8R=`ZCeVBi
z(D`8WDGSwTA%4IS1IWglbKlw91Da=2s0SF;p~_wI2q2o#HO~hgqWTdSI%{fB-u5-9
zS@Rkc{HZDgvIeCFyoquShzSEQK*^dlIFz?$4SER(h&3qHepwsn=~`&8GEe|`$X^2n
z3)OtaFZ6f`2U>v&9u15_FrcQ<(x7^D69PSLULGh3WtM~d<G6i~q5}t22XxKl-vMm|
znP2$%r~dz?UkLCvs2`~)QX+Vd8aYj%HKR%YQ~-{sMb~h?`Oo+Pb_&phKm8J=(U)Bb
zrRvX!6tZ6um<Mr=OQ06w{aFzyJHNNzBEUGc1~sikIucsGEsON#g?$@BK-U2QS{FQq
z2et*gdjU>T2ewEZ&>}Vafoc=`U;cQD@;9pX5~#W(2CKm#7Cnsq;{jyf0s;)^o#?XY
zFmeW*0~kWZ(}c3(9Z*pW#bC>WV+rQ?3^;i)6{GB*;R0)09Oww>3M>J}{D0~A(*^!y
z=AZu2vF~3!IHDIG{1pa|R0pQN{S}!NJQBJ50$T%E)4&n#z-W(<Vn?Duj|0Px6uVFl
zI2lm^eQ<8SrGRcp2h7<=_m^%SMDXBxm<ehjvX9z7AlHk(!S!OFygquJ*bF>_BgokS
z^of0OI3kVx4RBKv@g5w<_dgk<@yLnrFAu9Bn!sUK16WTfq9*xBg5YgDXb2rJtbl7h
zH>3vnO5hq;w$;FaF^>*d2SM*<fP8Sojx><_6U1m;|FjOe1|j=(JFq^<0mtgVde96d
z#Mr;qCy^RxzXBr_P(k#n5cC}|To0h<qpf`>0;4<<a<F<a;E!a~A`^*$8CZ*F8|Vx@
zU^nQ3;{}04HM~%BU^oI!uKS~7bl(0cp&2~k)oS9^!4b%Ni2Zw7;0TuuJVcL$%|K=d
z)HnbS?SY0{ARp}yen3|<>$ib&FQC^Sz%a-GFoA{v#>Btc;0@TR0Fkf2zivRR0XVmz
zycYbGSPjt+nCk#EHLy(GlE1j;&JNQACNhcr)fl>5Jxn=t3K|NoL6ssE$(4cXhJ*tb
z!RH8}A>iMO;E`^?5UbA)s|GGmBVA~XhdU6*Kw#?8MUnx4y%P2S;3=p9V1X2FB;b<q
z{Mr3c4txyg!qq;Jiojw^6X*afe>KtkB|rgkeT>u@i5^#g@B?dratzRj`@_ti;k6d%
zd`LMsqAPd;HLlIUNxDGygELLdd<3Zb&wQzg079k_Y$<s6T<{DYoMaU&3QS#>TIQ7w
z*nzSg+<Oo7uLICR2dy?Tn^*dG&j+msKCS_)cX@qfp(&s%{?dz#=mPGAws=4zgFXT|
z;C^V0JT$%@9(hX#Sg^rE_uM^z5kn2JfixT#e|=EPU!Wto8)-&D<Rhtqf8x2D1^*;;
zHwykq;4vI2N0mni4SfVC%p-<|z68!{k*;*`$f|x|fre^!K$<Anix|(n5L79DV6p%d
zdpt1#*8QkYf52xyIY^`q)n*-`heYrMu{#MEFCjO8u@PK>A!@;e6?%0GOdk`!!1@>h
zpD>`IT0o)2hfrn+Ag4q!0S%P`Z#4ho@8B`u{unfr9k@Sl2pmxBhW(IK0dJB5hkwcg
zpE^t~19d}wFntfWejD@^=qOY9i)uiW10RnY0q6GVf#HcXc997P0@VB#=>~M8{bd63
z8Q=##U=l(*6&U{j^9O*zlvt<+7+8>>edT~P1>goHpdUsOfY0_9LJKCEh~JmNo&}WJ
z+wZ1;tAP(1A*bZ`GmtSwu*ZPO3-vdEKi6r|DP+F-2DfTfTCDCRt1VkCx3^iXF)0wU
zOp)LPtr4#YO2x10Oq}AzvofM0UyI;oi5Lto;N10v^&INPHyE@oFf29U8}Sf$V^{my
zWFcSq=rNP8S3MGL%5VDK^;vm)|8UDnQ`MILm)UcplA~Mc7E9b(>kf5KTB?n`vaeO`
z(ziTaC5;MoiNhbIWlMKqYax3<-SUO`xp9HTh4c0^SDU|C#K@=X^EcI93Q&*!aGOp;
zQmw_dn5pz#71ZY3DAfAFz^MNtUr%o9(iw^QyHjW9Wj~lX`pc#)`pU*l`pOzXJXCvh
zDt*?{({6irY!#?4DH4pG6YNokCp(+ndqM1bN7r~LB$vbDXCo|IWca>Ebld8MgpWmU
zTk@9+I{egKH}3y-aga8BzvtwTb$P_UMfOlWjj0MTweKA&wl_gkTWogtPvhZK1~eSh
zebnCJ3y4Z33MC$;Xr-r0T1tM@PH~f$;qjbxi|hhyJ%?hdLz`j78u2{eJEtlVxHXa%
zrz_IAIfb9!U)ezvhq`1rx{+OY*WAzhG&oPm$~1OG`!Vl0v^CC&E1z>vOJA`h!;Y?7
z{_!|#7tiROaFs3zC{6T{cTLv*E)H2#859$|4ZEGM`wL1AbJVO#kp^6}XD&V3gKueN
z4EZDhbtmE!q;l8ith;JCaf(mqe!^9Io1AA<0mr;Vx((B=GWC8<x7@xr9x9NQDDY99
z?4odqFFZQ3B#q6C$;jA@fuB*)FC|OU{*Zl)a8AQ77ax9Wb;bZHE^Y;G4!Uq1EkR<&
zJT`8%RIV!<gu&Dd#Ol-xBp-?bb0>x_3Uv2`vGQl9k%m|k8W0N*_7N8nzNZ=_31f4o
zijtdSr$ZE_XHr_6skICFMfe$Zf}JkdHQb!P&LZeKu`2NbbqtNBoP?Sn_4v_R_7FEh
zy&k+%RH7jk-luL+<+9oZ*_~awnM?1d(?!)w5$9>ulGKG?G=-OE7?A(%;jfKHyXqRD
zZUWLN9CsZ)9@*eoO%6GKUYH|GC1=*BW3Zh(-rz#QVCe6)CBIKhzxs~On)d85u_TXC
z;m;@h771|=@|S~g^j=XVrrD*zw@>>`q`*{bL8vSHD}y?M#1A1?o>z^~(RL*aJgO%f
zp`)=Xj&J|;_q7lq!WGuo4-0z{f`~B*{P`Dt_!dO9E>!U3jV<b#BfeCG1YJt2=LmZo
zf3blFOYm?M-@eq3AyCvrHdrpDFhd#E{;88C)@Ct-4LHnF!(VNjrUDMKFyQjaA#>S#
zHjDmBK%r^_QIkCy?HEy$>X22IT5CdGw_l`nwqA}4DRO63*~2?%yu(jX<q&_}zDmVy
zP*cW9<x4DsFRKs^qhL{qjiKV|qE;sfBJLw(2|0^T@aSQUk{zsB$&Ni7CQ7YDee8%8
z3qM;pO9|B!tmH$xQQXxf`6}Ox>dzw&qRyXfQrwQ3eD!cM%WT$Yxs0)V(`tpn`;9`?
zto4(+`c^;B3#UGg{b=J6t&(wl{T?sF%s1DS#!c#Xz(~D7^+FY5StN>Qoxj0WOlHw;
zX4|pGmQ5yg^(|FK>*_#V@TH~Xaq_E|b&dCCY7>~((_DEyqqP@pUq6wq6|ESI;gH^J
zQTG3u?0B4_@nO}%YMyaXP49$0qx-YF4yKRVUUfdz@qW8SY6yKV&DFc@DC<b%Qdv7S
zDJ3y9`-Y@eQf5{H+OZ+o<h{z7F)2dmvMEVv=lXDkaGTsNKS(Qy21-40<cCs9qHgYr
zZChfMp-4N_Q$63(SdL3rPo%V`riA!uoV}1PP4AHtlM1=kDo=-lTa)~fDik-n>Pn<&
z){K)4>Gn>ke(G>Ptb4duJzG21K;q7lrYGx?jd5^EhP^<Ke69!lPSPi~lQx3^?jcXb
z@Y&9FxSyU$w;Bv_k9aD;XyYDZA4xK_jo(XPR7C&IW<k!|%<2~1{E=S6;u)fDHmi>0
zvux%Yw>2-rS#r6$6YG;6Dny7#N9%tmIr%hYK6%W2^;q&vSf9u*I_Vao+{^DS-|&mp
ztcXiVdZ=jJTyj{oD$3qP{A<9uq|MNk*7(Jal2Is!NwS&JlY;blj%><Y0(iQnY%No%
z$VsKamhXDmBbqN_H>_E&%)@9THC_l-seDR8NM*m*lvTZTAK{zLra8ra(vtP`yadf#
zwH1+HL5^o=ytSBx<A&TL<}X^kOa8*T-v0eGkZFEjUZZsC(`U^o%ga`*T#H9~&t=<k
zQvWb*(VTMsk<{F+ZhPyllq%<1MV;o9S3{DYMh9E3f9zKCcf7ZEHLKb7;^x^%ZIWbE
z@-2U!KZ{6`VVRAc7xliQnK9uYE}ULl$(j2KzMkB1;m!N+k`3oH_o6vWk~-K5t$#iy
zj?&`m-827Er8zb5TI90all<U$4gP_a?_xbPn*QunHa`=G;kl7VS%iKePN?N-WLI#i
zlA6n@yuZjj$uu6Ebz-C<%IDC-HO<uKjdkkR)H&Azy>n@=OYv0Wn-mVkT0fHbdRdhJ
z5uQa+7rC;9yCX4Cn6zYKGAXTUjVh}MEkkzFQys+BT!mnv?8p7A`U`gy!|M=TRD0K$
z_=1QNex!8)e;f1V9EzY(m?l2T5W*X82h&gX;T<A{C>SIu;>qPPSRjsh)s{Sa9rsIj
zrmwBy!k9OA?{g~I&#Ixz%Mn8T>kRsv6Iyk#ZAH143FcEPD)>}FXBRa$NhwLQ76SQ?
zl?k=2DET(7YMv057a(oESXuhxaEg!ub(xSZb=d{g7)Y(1RGivy<Le~F3Gqg5;NQ=*
zqBgpV<ZMrh+VVOf_ce>paKd80MlVvqHyf1*?^Ov&5(Nq#y3%;GB*Bx)^u@3c9mN}^
zqX>FE`$%fd_tMH1$wKMkbhT}Q{3M~)Ds0bXLaiI0@#`ERZ6&`^$jvV@6MGq!q+t^{
z#z`2_9hFM`JI<WRh&YH-n2NA0_BL#rDfw`aiQ-tY9=GkVN@Jk;qa&Z`+a;Jur^(lf
z<{Il@ha;W&qd17&EiL$)*aBSmqiEs2mKM*HCK$;qY2T7+3QX||jwnCJ?>&2i7U*t$
zLa$l-L`I@N)|A9iUdi?0CbS(qn%NwkCm{ETv3my6;H<RusKv#)JR^-DS77RdptM{E
zUaz8iOTALZCuhzZd1mIfj@nmeY8}%Mw#*dZHWlG27Q6Tg#@wlOwzo}UsbJ#VXS*4Q
zwMnw_hf?9gtX-wTkqJ)Ll)9w}MiFvDA5N%07n8SM(7OSNme74gdiu1{V;iv^(_Drd
z<;f00cc-t#$Qjp(^5(&ZD#d+Vo(nj+X>M}Gl(c^{%8=+0Uwl<VVq>35qX|namE;NM
zjGVufovumI&)oVYEdm%;7!swLMNh6%3XKFXxFyZ20KHNqE=EL*HQg#D)IGvpyhk!u
z5`H|%j_ZomV+tRHz08$7YJo9EvBxGq)T8Ib-|4YA%xH)`R{m6I453_>v*;J5e`H#8
zH@_uwT}FTG#|uaC*WcP)Eh+h~*bqYP!ty%b@^!RD)EE$@uO<ueADc9*n_s-~+@_^2
z?C`Bxrh@ka879(UZbv7XI+SU&i8#}aH(rAU?XJ2H)r64MIc;haA7|~-CT?0c=g!%U
z)Kr2_-{_5lEqjKM6Ef3Yi%8<L5)!qF(|mnNV$p4=DqM*wuNQta@TMs{S)jNPdstV^
zV<D~nfvQ83HXjM3Cpl!kLU-xMB8~-InCv>6m9RDS&F*pEPi-H&Zt9;FCKBB*>AA!-
zB)YH5Zzl&d(ieW-y7sBi!9D1AgpC^S+3uC$d=)OsUeWY9(cQo>%GkMRm5(xVkE0*4
z?m!TJvcjFf#X5EKPnF}a*xKk*ok8>^4&JMb{cPS+E$mu%hM!T!kybZ-jhi<U956n5
z&oWYI!vh}rs@8<yX~HGTV7R37gGQBmr3m+=)(5fV%$J7A@(!7Oc&&a}HK)zD01}Q^
zD^~Rpe9_ZUaD6T2LRCxbEX~auYzE0L2Hm9NaqD#q@Fd&Uaqn|dpT-sbkWymOqvu$8
zeJ?@CdYE^&t4*kxAX4s7k##>Q`_tj-TB42t0+)Jiq0=w$TeyB*JMCzdU(qseL9!v3
zU9-UQ=-V!_xZu+ohZDn=DYo)+J~tPRRw#^@>j(55S{`U(`vS}MJo?5;EOXoYA|rbe
zuh&tiPs@9!W7D$_6C1`dwzgIwuhbI8##ZYBACXJBW(?oP^FO;KB<Qd6sDRbW+DtQ;
zrj6`T!0`^~tubPJdP%9Mk5cdk3p#(b7{5n-L=qQ8tK>V0)4o7S3y<mOX=sz(W@8U^
z`e7wCd*{l|O<H68CVS7p;HH_NWPB6JuS^n58vW`Y#>u&VnKa+Ia|}{n&cUTbRlakj
z*{8qzL({KsOeH;Adb-v3-sEql(UX%9EHm5IUw-d;EJA%=wBKM^_hSc)`?^xi^plM(
ziRy+90fKBP!`82i{#VAPY#n2HS|3rIvo6#e@KsTJdyLV`M5$=}NTww#@ns?@!{p0~
z7adk2nllxi44N;#AKRM3Gv}Ea^}$zE*cd7yJx|B6bL7kqX>CQBMS>14#xXla%i03v
zORejbZ`8uyu8Ca?H(C?ZV0+}~Mq-^?6oS8zty79vqzNh3;@777Al{u%dgxi{CVNBQ
z^O7e<+PjDMG8FIE4X`}Ucb!<>zCiu?$F;bePcJzhG_BAUk9Fk?;>Cr2QFv@RChE!F
zTnslpo#A$0yk+)TwwUpitL}Ijjwu>fp=&q7)5nj*_lpW~$Y1TPe@uwbqG8lWSU-#B
zxtp)he2G_YGfz)pIz?Vq-@ClD%;FP;Gvex?raVhrN@?bu5|a`8>zaHsF{R;DNqpx&
zFPB~)zo7k;eTT2j<y+>exAp7qM{+LxbUozwE%;^p#Bs6Az+&rd`a65S4b>gZg$lJ9
zpLg6+-gcE3g3LY~VNW~NWmWjBXR?u-Pybe6&rsfjsasdPUsmX@czjuS9dntyBlk27
zC+x|9UU#Fhy*iNxU&K!dlZ7lQt)iOSQL{7h7f*J2^AyK?Ijgqp;Gz*X60lZbvwCBT
zL0U}4!1?`opKGT2WY@{GYhIW0a3H2_BaLlidgUx!eWE>`UgYc^JJ;E>$uR2V6Meql
zOvCy^n6rs3zEgVk^U&w?D_Iua<qUdbUSA#5=PmoRH}&aeT3b08&nI<zo$!fk4wXcx
z={iprh>40!Gm46yn!Y9`%A@#Z%F<k#zn?;^i|%Nzx3TQ_DJ}i3J<5A3ME)jWFWB<i
z{2n^AIM%w(*FOIg)2JWUAa196%>dEx$wBo={w#F}*<g1rgMg5|^;WjPeWG(}EMB{3
zY5jaPmd|?SQ2a=0s1RqXw*1CezcL|uuVT~9yZp}i<-r!;H19L(Bs0gKm-G$i{8CAm
z>=++yvsBkT!Q{_9TX}c2y5y4odp}82jqRO}T#>o{`Pol0bjAs2I|^0{N!4CchIr6k
zB{e-$bgZL4xGa>fk2T96DLbGrYAjZZSwZ#6>-*$ihSTHI++SR~a@M*g)Gw+vpr<4B
zcluXJ-D}Xi0kwC$T*r6UEfu|JPE=Aj9DYu`HSTT=KYfSB$fTct!3$;<u(vxWI{zUo
z$x=7@>~Kv8dlB<<KNbh0z?_+h`XAhDH`8~X3pDT$33X;!NBHWNpYr>>sZ^|ouaH|^
ztnvLiVFu5lW#VE*`w@lG)=kl$cAj6me#2jQw$AA>zA_1`S*(4OGPzk~^|gn}c{8iq
zS@I^7%Ga-NtN&yHMUT0fgn%4e{MiYS$|8Q(`U#f60)e~7D%c4<dh@b1n%8rdPw|$e
z-pq0N%5rj|@pvmun!`Xr*&_Z;S+WYxvh_%_!Mz%_GkxyYQm(`4t~4}t9bdMzyHI91
zS3pVsCTH{o6ORDzaA6%AuT+lQwj?cO-f9Z|rjqjmf-feu8e?D1x=vJ@buZNi=B-Ue
zEJs)$4>%X2LHo&A{-sh&D4&m6%MGq7=AVZb-sKi&{InHl;}nqJ`~AGQ`sdco(^)c?
z2VVK@`a|b4{jCiy_Emq`Xu0zKr~5$8d792d3Ay<?Hr<s64;6kYbMRf()ATGq9~w*g
zgEXY|Xp*RIpswHX56*R2@#H?cW8$1ioVv${0u@Gu>|f;)&ok1CMitzohj_1T$%@Vy
zFb?ziXO>s<?b&#A^6go8Y|%grw|NT|pUH=edVVevqyQo_Ky!NNXKLD|7TyxMfzO61
z4B>piVHJs0Vk3!!C(pcPT~2;+Pee*J^lgC2<HWJ-cBkr~+R(Cs$%tD=<j4rZHYyHz
zHYoop=$F5o^<vK1T-BdJE~Dpm?unD13XX|cSUQXSbhyOq@NuWbK&-OUOrK3u;aG;G
zsbrS5w-7(eSK?=h(2pTiV@$!RsTIaU=NRh(hA9TW7>xa%ecrd}j92ClIW|o6PWtvT
zQFKdC=dbMwGQW38SD*CkNj;`ac|<@QV|BP)<ZbW_?XbLC#fbd+<juqFot>{_{jZjl
z6RxnWx=H@NLcD8==&p;;(Gcxkj>;skB--^2doCnM&T9}H=<>CK|4nVIg^s<V0-b(2
zI}15)l?g@gRgKp@O&{fsus!TKIl}s|I3(PLTlmeZ@M*(<_XD)R!PNecM4N$Oz<Q$%
z{n$r$GS{#Q{1ZNc1>3)V6Q4RG?o<xXJ1cYh!3~Xx;^oemIiZK!1H@Y-<9358eIg+=
zUAIfZ<D^dt6fxeCFwTuBDdjo}AAY#x;+VVimib1i&W#?O%#h)w;m_4Kv$J>lqhG{S
zE^Lr~t=m%JJ;QK=tbB00+H9z3=a5TlmD7tmFS5%*0yeg4Zm&@BHN2yR)QsMbc$QD`
zN%exPOo=Rk`ny!{@0k0^7X02ANa$;?G$*|wT^e~R>GXEF?2%Bx8XJnFDAS-ab9V#y
zRs3&>w{v(8?S?R$Cm2sZ*{1pF-C^x1k~-m(|77R;yv!3G#lnqOhdwG0cE_sv)+S5Y
z!tw|Sb!7VjZv$U*2$MW(pFjNTUUtT!kJ+iNr1!fJ=ne7<0nUy=2Jfd_(>dGnAF7!=
zVGUl_F^66IHfls3ayx}n+2eG}l!OpZT&Vt|n0yLVM?IJwIqh3<?;nN^>&@5m=Sfmk
z%^$i_;SI%{g+=mLyK`MG?oT+X)D~m;o~obE`(-EJ^X~-4hj=z)@AL8;_sxF$=(5`3
zO@wg8Ac2OQ7a@}dg|K!&Op{XK#u3%*){^jcMFeja*KJLYj<RMYAGVwdCf>rS<WJMw
zqD#^ncikK-7+zb>IQDG*v|g-mx}iIg`Y^M}>PXwH{WOgiuhel!XT7wB*TXMa<B?Z+
z7S6Z#y_0(RY4Kv!IFYQ#I_)BHx^PW_4DE=%k4KcevGe7nM5imvU2<l<)ybFY%OaMy
zRR-REd8Xh&o9s21Jqf?jW$$_H`u$ST`k~=#6l3Y7m1c80(+J4y&6UCO<2hB|VMN#L
z?(!3=JS`J-^RS#87>%bJ@)KkrxPLE?ej#zCKKf9y@#E=ncc;~RByZHyJKi1@S#&S_
zqUt|&WR_;p?$LrRm*6VLMkT)Q<tn|;&hOk)#RvUW7H|IecU+7B-`IocpEyalc-!u%
z>e1?f^s14e*7VWWpGx6s8_=hsv`6FBV->hX$3~n!k$FifU#pcf2ui9x68+j?FyA)C
zSYy0IP3&o-KI1nwBH6BELWMeN@<sOQh;FJ>;IBK~*(>d-TFaI+^R-KDJMF1ke(N*s
zp9>L8cV~p8mStb)jWeawUYC9#F!{FN63La<VV_?<X20@^GS(x9J$~7|t0Z{ICbJ@S
z$pW8g$m-N9uVsg0vjyELhd!y}@r*P;215<`n<B)XCs1`pi=;MntHUpmeCy#Q(xEjb
zku+3jdFj{|aG}jBL3w-lkd8?amBR}EolfA7F8x(argRg-oZq|ajqNfkLoXXZ-sBJK
z2&+EqaU&tWrbb{X^hHiu;OoG1NSC&Bp^#6QQfGLtNQm?cZiwllhc`laZr>Cx4f1bX
zI9giwz9-d8|BL3@iv*%j0k`!{Ql-al2%nTC)^2g1>&(6y(Iaa2@-vw)`<>n8%{7**
zKW-<n+<taN<ynT)XCp*KX~X)8x$jDBDaUIk&n2qPm4>9vdpF?@O~qpGrTi<NbC&AA
zVT@SYbtb=lhCV`Fk(yfi0h5MMgvR6t6N%%}<T*^@As6;SFJ9v|yyjC97n}V(<c%9g
zV9UF^VqQkW?PuMmjH%!pM$#P$(&ySQ>ASWhX|-3>>dkvgk}Q0=k#E6#xX@NhbArj*
z{dq38HI017>cS)<m{x5$72hIV*nl{h*IO{v`&xpMp~_Tky@ldOCy6@q6OS3MsNFBQ
zA)xeWx+%$I3*XgPhxn1ev+UicQcdz_n@+pkJH0M*8gly!WqJT*)s@4US7aTjT>Ixl
z@#aKVk_m@J76~9950?^=^fLfoo{q^Ec?1pp7CR+PHb0=$$$G0)u~XsJ4lHn-ZO-W4
z!=<iQ?9xMzY+0%TfuA%hb>92#c*pEhW73b-VQw<-iDjKbLLu81Z{`uY=LK02tBE^=
zh&coq65C(iqP{tD(dmexQ)yDjYpNltVyAYNXJWS8cZwdR{e)O-;MGcgm+Ck*JX>3w
zet7usiDe7w%lK9S@0+W%*`8_B2vO=qk=(bSob+P29U|7_RoCG~q|!ulvr$Cw?873F
zhj>B{b72-*f;=HD-Xwc>y?FwrDeP&o0&Bzc26BQvDvKOxxL{xp(eHLwLdZbw`NY2=
zfFV>75|Dcy@s|i-PhctTT)J&!yymj`a;yz<*&g_g8Y;%`B5yUyHZ-zxoNgIizVLGH
zLYeC@q-@pJEIz~gntS}U?<Pba%A%MEVuG2n8kJr)N?qk$zrP#)qwDUP;+~~!zU(G5
zd8V(Rt5m>J6TzJzZe~*P!xx+>Z<4(|w+;O;8Ol)B8+vG!C+|Ydx<`(B=mg?y^P{<s
zF0ARY(K5_O@3aj`W~tJ&3ipLJEz?YgkSdeC=*xVQIr4r&_4Wfi<yY4m4>#zID)&lC
z_lFC7JO5Jrj$w0}_}PXZx2MSx98|Z(w4*<7YeyH|AJj5BS0LN>bThh}<M`re<An?<
z{M(}`JY+FByS*b@6W)ETgL7XdyiO~uoD;KCxTBMKhC91})m@DL+WWDiXN=b_eK)=9
z^DVdJqJ7p*%w+dHCZ{#K`>G~hAqwTMvd;}&SFJG5f2DuXNkVT9LTVwc@QKX|Jg_?J
zWNMv_Zxo_q3l<Xo*TIXLUed$j#kOZ&P{&C8s?`i3r>sp#|0SgmC5p>e?>FNIru7Xq
z)cvFww&dZ2mxP;UwnG&|#cXXZB`RJYn6rp?+DV8c?Q>qY6($(ka0qs|!f>+qW{qcX
zOjt?iJsVHX{&f1lul<cN7LU`vnXTcwxA-tZ7w>*I*34g0DZum8{|qO->Qdv|B-6-f
z@uX~&tbzGfA<K(ko^scnso5%7?-6IyRP$R~Ybz2*J=-n)j1yUpJSDO-{Vh@W==`>y
zx8QGUrq$NI_yI0T0y$-F9kQml!mIZqw0KKX)kE}IvyWWY<6%iSqRT^{+}h?^MV5Rf
z&v{yB*Ab}jXvmYGPcIf$95!?OSW7;pTuB}fSiyVU`+-f_+0NeOKJCYQ8*P{H*^UX^
zG$d1IVB`rdz7?}1pe^uCGmOa9MPHkD{`@@>Sbo;kqjyOj4tT^RZu`+auZpa5h26<w
zmltd}y~J~(Cbu(LX!qVXnc>0>bJ+DdJQ+fmgg~ssJmeZANqk6i7l!va>!MVQxB~f^
z#9lw+-*68@#avFQs85QTpC9xZhNnEg`?$e%)TEL`*ji7LL(rjIrj)aG$w8OiO5I3u
z#8yXSX8Gh7)l`<Bsjc&7fhpJTF5jf}!h=rdY|$Uv8p!lwpeWXxaBx+ZeiD?nB$w6|
zy2|4iwzS+!mXJ((-%Z>r%IIz5vjOXepYQpux&Kf&e<7K2<Vprq?>DmrA4BV(`7mIA
zc04#g7Fd{@n_q?CQ4(3LMpK8j7Nwp{$O!vjZD*}Ay^}S+Vp~HAk%=Tk{htu@yefyv
zps&5s3?g4#Q@8*LUAeom{AJ6E|J3#i^82-dyT=^~dOwu&CGvEzvZ}Pcq7bO#BhX?f
zol6l6x#*}EQYIMU{dOh$?n;^)SEyhe!YyhWI-#}JajbN6K#2QxLS3=^T^8S_tf1v<
zN7C(u@9}Bh9PfX7yIxeLew_Td3(pJMw<&hIjbS+h^x~zHNfp6to{{0Bc7|`H<DM$5
zw;*&b!VR7)xShZF+{%v0zUnBafrCeitZskgIfuLR(M^ZXJ1u@w^!81dfO;yPqWj|~
z^d4gW*ymxW<!GWz<yWyt|6+1i)bHle6DcyJEIj%vI{E5(+H!@NwbQC60*>bd9n<I9
zjTA@3Gfjx&=}JgG)qxuLDk?Nj2fZl?3X(AAW!Gk(j=)djsiHM#YkSx4At>|pYg<Q0
z=b2aQX>+SmtIxLX&U&jq9U8f;dDM-yKlIDqZpmPdkBYIiI;EFTB|8JZ=*{v+hof_T
z3^kVSa2T&Fh*vmitT&4DwFgM)n5ny*OrZ`XUCW&$<rX<UKyFu(C9_v-)SMLo7d#}V
zev&48O-^kzgJk|9%Ukca#Nqj*WAh<BiuCYD^H=Vi>RGmmyG$6&SNT3)Kv-a`km6;c
zIM<>%rz^#6_>fz+r#r*)qu}SHvF}CsGHiH!0tgX5!-@FKLf+*M(axDO-1rtKL-tna
z?b9ajrUz7Ru~PWZmp2KGIF;A@ebs{qO%+0I-f=btrfob<yQ^?d?;>Y`sIFVd)y*u{
zF2_)FjaMCx?w_CIU5UEF=R4}d@ynH{%areqyYB2%9o;)={LvW0?Mu4$>cqasJVrQ*
zJrc9|y0oe^D{l~bi%CopzZj#V;zWp)<fcVyYx~tXoj)=oYjLs=wyx0E@#Fd-!_3sY
zS{FJ-I=OZ0<eqk6E3y7F6jeSvSwj7)cd|~%liV_WO?)p4Kd|w9rs`Z@l590EXS@7s
zQj#l__sJIdlMR=oXl_JW_Xv4bvfgpE4g4uM>!!s1SS5Rs)%^wDv)GL@EE-!xmyZra
z4AII}vz+@ypPl5&BD4CW{(*kbuk!&M#}1hT^@q-~yM&WvU8nE47n~k_{|B*e?oIMt
zJ@N+kUiRw5^_PQuMXv^qiFIt0e}?aIuAk4NCE7cD#FC`l*l2(vZny28mgw8kG4iC#
z5o8mv-(ok*$QvKPDf;x6-N!`On<Exy6Mi_=9%F(12t0ej_)gR1rJwAb^!DZB<UfSU
zq-iUJAAGo_G*ED&C*y?A5g*5zvm=ims|qhaO(qz=R!&$&Iag>gmTh;2`xpbW)i(oc
z+mW<4^Nk^w%az};lfHVX<KYq4|4iz3Ma%C~Ps0?2Z^Rf+O2+8unlnennqU3$8t>G=
zj_G&*3(YeHH$pD<*GE!IwabaGtSY>S5UtLNzgxmk|K{lE4IWm}<1MrImkj)<X>V=p
z3{k{gOW}Iq$NX_tKd1WF=sf-Xi1gPDnbAKzmTY3ao7~aA$-yMp8(U`kc3iNY@wu9!
z@J+n4lYWe2kE@9YUeKIL2_?U#lr{<(==J#-5VUmRmM157m?`_ZKD=<kdC2<hsV@_e
zBo1%4;7dY&G5X(p+MklXbQ2Dz=uoKclBAnD-^x$^Fl?8boGJd5uP>3^o!X=yq$%+a
z*$>}xc_+kvv*J`>y0e+yP<^`}OKKM(_vZ#H`Y?3?`ANC*sm0<b*N;0n^bZYA9X6R1
zWPU1NvO&jaV3=CT2d}c_PNM07f28^K@e8^7119H-<pyjkn&XsS--(8v>VEXMI`nf`
zqK58A_180|hlGO)th{s`hV=rhSc2X!r^eS<vTCh0eO0_DlR`_NP<Yx6PIP;UDK{?6
z@6MMnl86{Zw@P*ytLYdY9c31-8;^TRZfiP1C0`J#*(yiG$(>{Wa*tXoRLy(BeZA0w
z>FY9Q`yH>-Wr!sa`g4l+kFJLVF%yOgew>k&=%eTQN%=EsnqJtII1}ETK0dP(AG)sJ
z6si05-kV?ey5F60{8@B$X`h@q)zbHaS(W$dog5gkH*a;lW^+s119n#ry7G3ZA6}{U
zRO_0GUqUz{zFqnKYF+ri=dd4K$cg8l@if$U=*E!Bk%lMRhvOq&wHQvbKt)Mf_%CEe
z93Q%s5){CKpmmPKgWFg8o%ie{haAz)*L|dXq(*aVzV}IIQQ@G(#n4mvGi-MA&>z*e
ze%ZYy`2sD!uo*33@KoH%u+hmdf%j>7ai3OK<BV4FDYX)94~D$wU!%1B$v(2QdKevY
zqInSJ+$-jt8UN$i>dh{jP{Z8lRKv^pGZf5=Zi!vd1ij)$-uid)c_zfWR*WKTa~M8<
zy6!_tsgkhW+bpoa+xcy2Y)F{2Z);;lXgF`A)h(~IV!*kYg5m44zWgY%lU60g0g2NO
z2O3{UetDXr^kgl4LZCeb_LRX%-&clcGxCLZLgjR_{SOMM*mn(`!yVOOk-vELw^|L}
zP;?kQr44155I4A3Ku#_6B;Wo@g`$qw0QGpQ!HB;7gH?PgDc>gd7rWcz;>)(JeSS0_
z1R~!=-F-8bXJWnT`!!Jf$e8vldAE-D=3sp@%cup7%!|bJ<XdL#Gvj)6OCQ%6Tq^V0
z`Hi1tOeLNoViq%ul1t84JW;fCA~o7%>fVa-&f1ymyf6pq=XE2(w}>P1+XnM5<VIcl
zTAUy@|6ZOg!B*YXKrf}J`f<$ydt(sSV7a_a<k`=KiH?mP>9!=31x*yA5J};0sij3^
zQxmy-8tO7vhVZX@`-%ph(tFE!H#Li0k%KE8)<xJa0*fL0!C*zr$1%reaFX)PVbw5}
z9y_y0^N`7yXwGOAE64@*asR=`@AE!)`1XtC7(DekN>y)S%y{R<nIW0{l~)`Mlq@4o
ziQ{DhyfE^irq#>qbXzM6@z43&E{Izev&GVI<4*{%do`$q{z@n;G>(sp8GYl(@#=QN
zgx{r$7c4JZU(EEn68TKI?&WOu*=tjXtt0H$PjVUUjBf{KTy-(5U-^*J{JkX~&x6)&
z^J)J}AAFhOsJ>i?{nHm8!l>r2>+7Vu*%TeoB0g(qaI0b@|Jq{5V}TdyB-CHB>nmqm
zPAFHiKWJvy)0VksdUu)YwM_GlQ=|B}<2P1+S?TW{JU`ym8)?u@F}`7CxRG~PH#j0c
zm7KlHuS?<XKz)ZPd)T>>t@uOySsX8TB|N67lgkxKh2G-7jC#;1M|M0u7J5JPT|!*m
zz^t2EUy4J!wf_7)NHUSKq0J#VVO~|z*T&EL4*7I%^Ey3y{4vY*rAsG=!dqU%OZAKV
zUN*fqZ}&>pn+7IEQXda^Qj~gGmHWZS?&8&7T_OSI>s@v#{j-@LR|>gw&l}0tYE9m#
zqczpZTd9nAsysq?Qnc$h)L(tqGuwcg^>P~U*Ocd)@qV8XJI%)t5QKaN)#O;k^+d8X
zZ~Eco6NP>Qqoa2iyOxtPc+C||JT9!^UE(i$b(+uWF7NYhyBII^&lh^-axOfZBjA^v
zhrBG#nF;D*^li<YF)Q#?IxBv%)`fD@?~;qzN5|L3lXp3m_lii~H;{c2@jt4|%wl9X
z6GtkpZZ-5#9DfULFH>1`MC^AMw|U_6aNj~pzPs{4?iVF#we?7|;4@2MTXu%$??z6~
zFrTF#(J1`%sv-Pzz{CtBM(W1+aIAL?;bfh>=~)H7d&g|8yOK>8Q{FEW2lBdl3A~ZL
znpNL?_E*TYl(B%)02AIsVrcj8-rY`F+1tM-A9Pml{+y>wKP~yoz_9s3RQ2HVkN)Xb
z-MYPh&o6J!JO3Jba;`VmpX1HUGGy?Rr>(O_rch<ASGl60i66}sC!Nae%xB9Bl?}4Q
z_w{dis;n2(`gFERHp39D1o!Z?HDhy2Rr`MVy`DId>!+}E#du!uxF*xqj@|P*=J693
z1$2yJIX5|n4sTQ%b-rH`H`NiJS>z_2J$IKRq9XL0->ZA3bgOcM7d{XKkrbTCg+4mh
z>Mp)e%Oc5gg_}C0v~pQXKx}KXG;wmxGS-vNS;_7OvvO&L@3Tk04QDb}o$ZGe+$yf%
zJ$uE>8+FW~%$Kz4nbSGNhM-#zk-Z(yBU~}3jiVb|YXggJ)*RJhd99~6#7W`gt#=Di
z6uEn@J@a${gK#<5c)3#=ehYbsu=1@MX@wIXS$c@*w(faf9di4AjuW4xB(&=OS#N6z
zZ_RhrFB4}CxVGgE2W+&cCs*cwDQ7rYvmwN`5VkifH{ozTFqd<HXV~#mY5>VE3T66P
zc2ZNawU4cM*ZGuODhQvw{dN3uV3)0cd)9B4!-qm3-B(SG`rkeO)V&Z&D5;WOs(6+C
z7g4LVI`>9HuYv|eQpGG4b?clr)Re!>B;u;kYp(ofH1&n25FUAqagKEP)YOqFZ1}!w
z_qVIe9&8mfCdSZ?+z)+t-($G8i?p31>+296A_0#_Rdq4MuXUW@!^k_S!o+Sif)DlK
z->yZu-%Ii8W!8O`8!^i1=3YJQ=qa3c{bFnYHNS~;*SAX^562A{es6pitsXs_JST!U
znP4v3qm}r{=aI<k*a5#XoBU13L|R2*w_uBsB&TD;K3;kCMIYt^>gdWwcc!7PsTEa~
zTPLoHMt&N4Ap)1ncb^<A$k_H(iPsmUp)xe<CiBc>F<veH;xfZ>X>-xBdYX%b{fowz
z;*VuySzQDg+ucr|c1EZ?{MH!!Y?-B17FW7GB%4k7fAn`Ex^svaZd18dI3zq(C(=50
zW^lRB#!+yf#WU33QCv;bgZ=pE`Rle`jlj>Wocq6@)8%y^)Qi{Y6$wwA)i#uh7C$p;
zzJ_nR!{IY9c%~HZ>YJx;Yy8O$^XA1w*M4{+);mReb3N;2!nJgLn)1&^U+|rbKV1*}
z0d+{uFP};CDhNchsdiqVw|)1CWPsgH<$3HS&LNHyi_THeeQT{YVJAam6X!a$2L~lH
z9u5%Q9R5BnhF5q}<+Xrl!L(J%g@L!+R#$E^y<Ar~Z>}SL>5LH`MM}x2dzM=~MQOU4
zO?aJwFHxSpkAls41LvLNO*+d=&AVDbC#QFuIZn9X89;A+EpZB>k|Ft?pzZX2<yZ8(
zYp!YiaXMkS`klA4;dZ|$7qmUjKR!%D|G0W2^ps6_?+N)xZr^d|u2Nsu9j6PoMG)k>
z55~7U<8DX04MvMNO6ZDyfT(}^QPlgGw${F;4zKFRv-Q9VnBmD+`m&?mLdOd|t1=lE
zc@^<qy4OFG?09YY{o0U4kHGhckTNxPg^vTVjB$n!bkp5GLw1c=DU?e-irsOk`|;D{
zjW>(^khSDPg-$K)=<mPIo29W$^;8zG=^RpQSSC`LCMOV9EYbGiYA2#4o$Y`4m9*~3
ztbdY*Z^Ei$9TPW86m5j=N(uA%NAb5eMWsz%PFy`5p=?>b)Nq!RJ~P~zw>|mYp@y*)
zl{(?OEw7zO7t5{(_xPTKbi6rM!a_JrP12YaPJUm}n<s~GN8T(y?)8ZfUZ0f8hd;=*
zObY8<#v=+p?DYNIakn3iO6>V{tNX*w+?lsgi51gr?WC1D*1x7;e5C0%`ZUf|t}}-i
zIX^B%2IeO-m?d_X4LH1|GmmXA|9!rPx#mQuy?Mshtng3EUV0Lj^FC`Iy}popkCAck
zwW$Tid~$8SqWR&-IESiivuCYRl3M5N;wxUHZu}nSYaZz3<t?ttk9a&2P5}M*xbR$N
zrn26xV>_yB<)aGBw~hAb7N}>{E!wM~G-V+Y`1jN2-rAom4y&h>!QXCeGbexf^3hp2
zM>U_^XZ%$Sgr$%5g`ZH^%g?R!*Kf4wb?To};m41OkGgUT#*)0Hk~LYs&2ULADCeiv
zj}|3(QRdorLT%3T_pg@6g|)J2rR7o>XlF#ke~)Y9**@m*D{;VxhbEwsqS3K7oGz|^
z3>L=UeNE$YDN%4P?}t+zcdbMplHM88Ja?aDvbKd1-!fS+vBFGUTMKraL9j2N$!f5y
zb#+_pKB=qu65FTT({{?1r<G*kNpevPe0-zh)^#V~KUttJ**;V*vkFb?Zc#G4Xit90
zHV(-biD%}Mc+;UVM}JN-&YRaq+Kx0(E48qD)^>$*Xf{@f#p*1nP2=RIBQ%YF?AA5*
zJ~0o%TvmlCyHXBK3QZHqZ)4^;KQ-MNRcm|SY-Bl8u0A)PWF$?{4C~={e)7TM`m4SV
zueC0&>36VxI1c<jsXY8g9~@FP@z>s^Jy}q08LMmw{E(W^#dZ7%_pREiv{7u2&D5{=
za4vkl=|Xuw+1YfQ6TZQcTe5lQ(8tsEAyY-?Y}D=UPaG?b^=dFaZ8WG$VqV=#-ah?N
z@7@XPs0F90fexnk@UX5c)6=gicQwrX9z2lUPE*-TS$rR|bjY#W)$We3&sba&g6g=a
zd7^LL%{-}J<4G^2$2R9$PloD@xJupPT}@mYO>fV<t?{{5b|FHWpq}i$2w5T{k+JFe
zRQqwNxR{tDr;-T13Ug5^99pXKT-pBkVJt&TTVsge&JFcb{E3WfB0^PEYuZACTXs`|
zj<o~5lHo4;V_jc8?>Ky?zde=vt|hsDeym_J<G1g<pvTll`M33xKRvXCQhlj_e_H=q
z_y#Zek_hx9H>JDxG3Of#ug+8!Ix)s^WWV#LVC&9MB%9}A#FM2An3}V9my(e1XFvQo
ztvt~H+T#DiMy0@FCY=d>=KMA8hSwQNOY^U&zl|}^1gRfMRp7bP`E2JxeX-}N=Iruv
z&W_{8?aks}Pvy@_K|`WkqefMYo{`-7Sl)e=@tkaAN^<3V)nMF?@Zh5FvG(_U5$9K8
zXl!|R!o%9W`Fu_9a^(y<JZY&%J`z%6)U8K9MOSRmLB+cBLOQti$OVqFo_b0+sbC%D
z`twXRg`oDPmj-L%g#;ngJ4GYg$A(6(O0SlvY{+gJ4W}Conb!Y0MjSC*o(xOpD2{4|
zrnNe5FmSopi4A9kvi^Kk@}-QMcjDOS*%q%SAFh{sRcfx?cIF}{IemG0*rSKGl4e2r
zM0odk{aeZ|cQbZRpQ^9UTl*LtOz`b=lk835&C(`i+a|r%j%N3aIkFGsKJ$kk-s5nX
zxOn{j+&6-w>7q_s=g)_`kBUqa)=Qf{>{8@&v-#;7Q9P0|pa`EX`(1XNP;gD^nU31V
zHP5O3O|P|tKt?Ce;8Sp#<Fys+zI%kMqTm0Iw6lPVs`(oK5+VXp7A7mA0wU4|21~i%
zqF`du2uexVfrPRy7?0wEU5MR<jfoA4o!Ej8b{GGdd(Y^29{Ih$_x;a@W$*poGiT16
zITQEp?!8<5KFaRbF|Y9=tc%h1I@h{X2JT;&pm(^QOKQu*rnf^sXxV4p+19YriJG?_
zyQdos{QKL6)z3|Py`SiPY+fhFdOD`tbJwr<I8p1uvO2DvGskBR`Tng%8@21kRpsj)
zG*VtSJTUyL#On0G#aELY{w^48cz90G>~3T4ygPqCY}Wj{$33j%D%0M@tE{8#TAMuR
zH6i-K8&%2hDU(J&jy`K}(<|EPTX~(4d;OQDM-8cX?9l1<;Cm0dNQ*9%hE-fT{k2z*
z!Y_XBT!(4sHcp;D*KY9Ip>tb&d()=IA<u}~y<BwsvXxJE4r#P!>bIj&@6OJh)6MF5
zLKo|v4M$bgoNux6&d=+jSLhFZN&0mjzo~a+&ttZFw{?^6CqAh8px=7O*MoLk-n=+3
zx^tJFSNqFTG>s3xNZ4Nd!P3Ea=c<;s(sp*qJ9ukB6WPjflT16@>tgcMI5Bfm;qg{C
z#*P@jt<<l4<DFJB98|}qe3&VJmV4k}d)GwA$&($Qu5q6*Hgf%K&Af@R<Il7jw$iq>
zlVRE;w-0_htCGKE4=%j$?!xy+<G&UhzH{%}iB|?S$K)Ow@~zL0uKf-kKfLJhkCeE)
z+~}JII?bY*H=F5mDLgg6uzP^($f79A2v6VD4+dF<o_iSic;)RInq3C$o2;{XS%bA&
zNrSGmn6_zU(#CJukMnMsH67<rHe}45FFyKeONKg4JvDI1&=DPNgRE_@cUU`V!0_<i
z7u&opc|7d(GmDJgC+v1Ldl=R9x#qiOIcKiU^>ufupLgiV!GkYmY)G$vYTNXe{cleT
zH0aW&aY2@r(S!3(8*P8G;nCi+CcV?%ZT~7Uhz+%nba!{}B((^Qiwz5IOKuTEZiX^E
zG*oKmWMgMz+t%I^w#4QT?&l;W+w|69-Fx;U_h(Woq+gj}?W6|#^xjJ}v0Egmjqfc{
z8*8Z6Sg)q`Y$7Zt$JqS?KhVr>`i8UA-SkanYIy2Pvo(G6EwXBO=-W=y^3d;)R<pZ)
zicDRuqu+rbnZAXazLbcPEN=SR-nt5sJ(9d=+D~tI^-C8K%+~b8x|UB>Qy=h0Wp4DI
zvQqM*Kf0wUg8q}~8>Xpu*SA&gucL1$)7O^iN>T{EO^=b3L1Xn-nS%X7nKIsfb@ifZ
ziqxpBrk|-U*Pl&Zx#}MJ%hmhpr>IXL%#W}><XuMg)vuF{o&@v)AffdR0>}3PAI_vc
z%+?_F&eHVIx0ptKn5Lz^NJrnogL9gvu6mZfg-l=S$=pbE1(4TP&^L>0OM22aArdn+
zNZx5wUmDdnQQyK{Un*lcJ&&EdP%J0K)R?9@Q)3o!ltuSr`cjXR`X-(iND~$7Yg1)^
zPP8~p$?K{=9n}z`?cYZ<gy{Pd7w^l(AEEK5&fUROh&2$<_<6^$UpcG=`CkSL@$^$3
z-|<*Hpdr!wrGVSgkdOzc{2^)l>rR=XkcOnrAEfC$$b{dc|Ld5Br2fAc1sak@)o|A1
zem|@s!FQ4sk84Owe-|WsGJ(LCq`0GA!128*dkDOSqyr~QH~oMkEa@iz&3{=m2)LN<
zSFRx7fxnQjCG=YoC)XjK+2LqmqlRQQ1Mr>zoZg3yPh*80Tq_AYLf80T5tJ&(Yf9Sk
zO33zfVZVmt6yn*!zNSR9>({}#Aio^hvj8}~UoxMT0cYbNJC+AL1<9`$xTeH`3BvnU
z;OU6(29Eu9K;Shbe)L`fTskUj*N|u<F4kXDvYC^mn-_$AO^H~}uY>g0*K~xq^a}}F
zH_3lP#OUs;YPdS7|DWV*Rm181p#LN<t%f^Q!+Tf5J6FR8RKw}b2>xVGL^XU&HJsk%
z=}&r8)$qC1a2l6?(zB)-zP%b=QVqXS4S!k<e^Cv8R}EJuarr0vYgNMys^Rojo`2F~
zQw{G>4ewSBR}gN@-DzJO*T}P1s*#@{$p4y;gtZCj6S>vM@2rN?dxQL`UJnHQzveYz
z-9bAZSp)q^-lQ7dt{N^Q+?dlOtV4+Uh-%~|<erb=fic0c<R*Rzf#hC*HlhDQf#NM8
z|ILGA$4P7y?zZ%wJ^klE|Jl)hj>49c@V`C%Z!bvMiT{P80`5SMiDE)NI|0~r6fz1r
z#Z6}c2>R^>L3`n#y^z&j&}T0m6(sH3O9Hzqdb!CIfxW!E`gryY>??Cqcn1Dn2Xc$Z
z(UQc((BRkzNn%ohaEDI`+$S?IEIcH6xG0|#oH#NtF+3@d+&3{fI!O`}9335p{FIas
z9Ge(He3%p!6E30m`Xti9<W`{x;o*|NKypjY(2;?mks|}?9T6qT3DKm0(6})1SVCBG
zJiA4xBtAGPGLYOBGd7qgB4&j~CP>7aLQ*OTjSMH6=p8Hrg*#XVl5>tgdh17eS4j!I
zVWn6)tx#}GU{YLQ1hFDCGA1re5*i(s7%rg}5_@9eX?shOW2v!{n2}UD$wcmMNmY{D
zRuZ#`OJd^!No9kRqT-n1xZshJ<izOk@c5t38WWrl`@3(6>cB*zD>_^-?)QWAE~dW|
zDlXm{k`qrF8%xR_9w^*THIR9jm^GH(;Z#&WYfd~J9~~7M9GDawLiPk*34x-|{$nwT
zKPwO&m6$|IP9Xp3ojiZ%vEgF@M+PTGLMhR4aU)5q;r<f{_gDR`HnbIE;%PS*?$ANr
z=?zioP2uRBpJ)=-8RGqV=_;1-Eo7S}DsM|(jF(VI5*bc}b414B(K7#%FBhamJ$7W9
z$-e?l_0Ux^<3?oMr-_zpPhO0ha-6Px8215A_0Ux{<HI<4UQZ0i9XWY=$26K~xlZK8
z^eo`GGsm}aoZgCr$)DypT{|=WhT|PM?m@O`qUG}KBCZQXKhxWFGd(-0FiBLNZ<i|q
z73EFHHj}>v9Ls;><QsDGH90$Z{VjmwcDJcUemo~n&uW-GGdOv^T{d#O6DKd+QIqUb
z`&~GGjg#lw@d3yAcBHo?q>1X`+p8|E5J{AGCNE}ZOOEsHNY@86QF)#Z;W%%9EXR5K
zH*uV|^DxKxc)Q7Q+LxJ~&p6(d<8)r9iQ3tXyqLT(aGI?#$LYLI6P4%NMb2?oa*XK-
z=eUgH@Q5Tqj~mD5aq{jQU&3+P7nuI79QWk-agOu;zf%o=QVstMoce*DU9)m^HOUT1
z*bj9%PS2T{d{d6|_IPldkB9yo=i`C>eu<XbozuUZljrpx0Z#32%E_PS<axhUa`N=5
z0kdC9F9?!E^_Y?u;}*cFJ#vos;N+zo_vhsK_!-1;-u@I$4_|I3C(oC=kmKH5xf?jn
z&o8?;{mnV~Gn_nc=RX|h+v@|zdHwJx3Bhk>oPIMcvO^M%AA64T^Ve+P*#GdT1VIn)
zhxMEu-VfV3&f9r})8B&F#oG5AC(rxgF2{X1`KKJ`+wl{}=`|y!UxQxHC5ifhw^Ntn
zyq%4JQ$LuK7t_;@ljrrc=QyuN#_4Iv>FLkO^YsnnIA5>GYIq{Yd3z>soVO<fIIUMJ
z&Yp#wyn^GaIPS&qjU4Cg+{1BxU131-(nQN`O<v5OHWZRX+odOYF;2^(iOSQVg7FXv
zNuu(+ettdaNscjjS{ItA9t-kfJc>e+s2<+`Qv@n<Ue6lfR1eL=^c?2oc|9LFdA`2z
z$ee%Gw=t{-aDD0Xd}yL&^7b6(<oWTIUI(Fx>aij(X6JiO4{s+tLPXH-$I17l3P_^m
z`jZ#aGnwPPIsP|r`bM8;#pLOoJZYkO`1Td<M@SewOuH<Tzr@LVbDUpq@bO#@^7PG`
zlmE==;p+>J3>EC*?T1G>3Y?ECIw#UZ?e9xo%uW`cl=tI!I@zX)^8Vz-<d;!M5|+O$
zVuAM}+f2SW$N6&UT9GDNJ$h}J$@B3az;W@q`M=9m5gD4OJ$$*^0u`Uh2tT0_2-~Kg
zTo{p8-&&%evG^ujSz_B1(Q_Y~s66HLT#lwj;+w$fnD7JkTXEbFw&@$KBTcN_M<7Vs
zh$hC*fnwT6XkxswuDH*}0mcJprzDB`iYCTm;3JF(5&z`r^rVNR81d~V?+AVvhj<B;
zI~nmHT@hp<KEI&|<{)0BCxRu27tzHsN$bS7pY{xZ2Hb`C1_-Dlh$~x);5_0{VCN0Q
zhr&Sq7;$Y_zrIF%UOf?fNBkfJ1ifxf6Z3yIv||Ir)j$tB?_=_h!2k5QQM?}d%v+l1
zGks`c@|88jeFfqtV7v%Gd>iNqL%gM#sAm-7n&8hVh`$5>(CgzgF?;f%eg8(h13d{K
zX%*t<z)tr0D$~=EE~ZF2h~$4joSZ>?6Zn&zw=z9R&~YCj`NI$o?79Jy@1!M`D-1|v
zlkrF>S0C(U{4tc<1aU*S6l{ffEvOg0-c1wJqX+Thg?J$JUp9X+`PvXCAxM6Zs8$k>
z_;$MJBZ<v-OwUQMCkx5@n2GWW5s!v(W-a2O;NRVdv-8a3i0=o#vH6kNlSL<glFE?0
z1p4U<#OH$iH^dhL*MT@?`d0v_*WYPkJQm`l72^J)n8XS3@8JI~h(CdG)f@52FbVWW
zTnpMg6!A!C_vMI>peJ)A?Ld4wv~L08ADWBuClR+c6Zv_>%|QP{#IHbmy+Ygy>iZq>
zY>0myy4WR&`PmG{bM}mS#?@gQGe`0=7&q(?H-mAeE8>x0XAi`Ez@7la*MZ&Ph%bWq
zE&*`|sP7cSi=kgEK%725mZp5fr?(LK4#X9(9w<aS5ymBU{ek&y7|7p5@{?iyeTsNr
z@WVUAFF?GhK|3)0EnuOfkN604(f-DWH-rAgu5U0s=_aDQ6Oum*`rQyeUQ?9sg?K~o
z+YrP*fc;U3Zx_`_Mk78F{F#RMVesc{#J9uvvlQ_HuxBIU^}s*-5I-&z4Jt+aH2CKZ
z;y0l`zD3*?+VL~udx2LWz76!(fO@lb$%1~Qi}(xhzY*eQuzoN>{0(q(#8Y7rZG(6Y
zjJGbBgZ*;EPeH%yhxi(pmqQTm3jI0`@$2A+iHJ`G`;~}WLi^4~oIb;wrd5ddfqu6Y
z@w4FPgNW~gI5~s3CCFbx+y&b85#pK9Uat|~1M}h!#4Ev0cD;zjgHKDbUM8TA@$;}=
zYKeFc@UuPQk<eb<5WfU|Qy^Xl<NQFxLtsAw@e9z7?0ONi^BBx8DM&sT#-(h;=fXJ1
zt`{*qy`a8pko;{JuXZB7Uv!(~2;xfc{{_TnwH7nnLOcl07oH&=3G?-P#D~GULLKVO
z>}TV)0pe_&Z-O`*&n*$J-Ac668F4qT!yR#Uz1|P;gAmU{5q}HuFcR@5Q0_RyE1*A4
zM|>5uR}SLPERvOoZvpu&h+lwl-~i%1U>$WD@y9SeUqw6@#-)ddr$RfvLVP#0<9Ea-
zLVa~$y~*0QCCqmX5Wf!Ni8<o-(68+fZw>oh5w8dRr3d13z@7la17Um_gLqBw+a$zI
zU_MPl{1_XD5!Zr#Hw$qc@LLYz3RqV!Li{`ES%LTr@cUZCcS1WBBEB2?=}E+GU|u_i
z_){3)E+IYw;`|2U5g`8>acl6~N5mUQ#Yq2wcwgZ4Y2c8=;%5i6OB2M$!~AQ8IQ?E8
zO%{k3fgT&g6JcC+MEpL)XD7r1!T&PEqhNm^;&ULL0}+=)`-UTa5d1b0@j1{RM<Ko%
z^p8P&H0YUxxHF6=X^7tkc_rfU(7$FOJ_yRqK|CGed=cX7q(ZYuRv>Ny<LVm3*#*l@
zi042%?m+wo^vAu3*M#}^FyiX1MSD&n-WKe<i?|o~;Su6@V0^1Uye;(WSBU4qdgBA)
za_EoW5Pu2&)PQ!QhiO%fVP0#DcnOSe%@Gd*y{!?qg!9n0h$n%52gKRutep_Q0{VL+
zei8a(0OE_F9}Pp?0qhA!ycqmH3Gqybhcv`zLAgrA<uFdpLfoo`7!Ns!H-k7?jCciG
zUm^Y$;%y(|Y<ww1Tn*0OPa@t4>c!TxtlinV=P{CB0PXc0@qsXoy+-^cjK3cdXP-C!
zK>Ps2rw*)-m_6@d{A_@@8pOXj;+w!8JH+F_|6LL94C71>#0P_a0uZ-@b`M9KeLk9q
z_*z&OO+|ba%y+X8e*pDbf;juW%Lc?7vT+IVW-xyhAzlK0xPtgth^vQ)H-Y`vh`Yl$
z!#>Ag?Zxg_RvY4%@obQ9jQBw4FP4bEhH<hz;t$|_%@grs(69R-z7W=F!HCoE>C+U4
zcq)u<lMpY0`B8;9eKH$O3lLul>y|Z$Pl0i17vgV3HIie9CqO^Bh<FkB;U41eA)YG{
zKL+*siugX5A8SFpu=ZLD<6#5DLm+=k#9xE|9T4vd^S%u6_s~y!A)XBJKNRtoV9!Xz
z$5Dex8i#l|_-8ueO3<H!_y=`S&nm=ApuM&sZUy7&VZ>KKKRS>28rZ*u_%s;b$`Nk`
zdOjk)1>&j(_?5NSJFv43;+j&iUd<8Dg?4O*xDLcg7sT6wojnl02<!iWh%be>8jiRw
z^!H@McfmZEhB&)!I0x}cXvbxUD`0;U;@4sP+K>2AsMl%4n}Z*&Aszzl@fh(cXqUH$
zzlL#74aN!9ULjz=0pe_YZ;H4N__Gb-&Jc$k5w8h$bVs}~%**`{p9<{~ig+co?<mB3
z0-u8TSeQ4n5x)WB(jvq=LAmP?XV*RVAU+q?!zU1*4t^*_d>yPS?jxQI_OtabYZvzU
z!FME|1ml%1%(qP53)-E{!;Cw_c-0!oE1?~o5Z4Coj(9^D$NUkW4gES0@rDprF^IQ^
z`c6Q62H3AeTo3&AH{z>k1xZ?sxbS5z!gnD44d&k?i06Tw#fX<dzq^C@T$l%+Bc3Xy
z)<`6u5g!QttO@U|U2I_7tB3e)82?)!t^&Pwh!;RScSC%vXpW>O;vO*m1R(wp;x+<t
zCZB|OK`XHU_IU!U7rV|oAIX1%c3+LS8|c}Fct@B=4k5k;#^<w$--CJoI^tKMeIFy9
zS3|V_4dTf#4pbqY0DfcN3t;uN2LH2oXZ$7D-wMiS`~$4R9T2|><CQDok754xMV$Sv
zV-VsqX+b0nNBkrBCkgQ;Fuu%1{2|OQ3lLueak30?J@CV7#LHp5x)Jfy;D_Ugr$K)|
zgLorouM)&fU|wVG%={dwA^PDqlD`3Z*!c~UUkd&yNAm3Z0qp#h$(MqiHNhW@t3$nN
zBhIe()kVBDoX<)T_k;6-wupa*{Z5Fp{?Z-s2v}DHBhJ1j5R3RMuzv#LU140xM7%cm
zEeG*Juzw}uPoN)dK|C4S@c`lnz@F2H-+=kzD&k*3o{eX$UAn`1;}w!02YS9E&dzIe
zpngmbJAZG0_y%Z4bHu%1-mydc67;XGhzEmzdLYimw*bW1x+)y;iO?St5Ko5vDTsH4
z`6vr<_PwG7h}*-sk&n0*tP^%1ZV%&FA>!<F*z<@N!@O`4@%ONve2Vx37_Z+UzCs)Z
zBx=xKSv#JDey)#rW60ka@#!=pNfwCvKz*GM-vM#xhIlXFeu%$={b7iQL;OS|t^xgJ
zJmPm@eUgcIJjC~W#J|J5lZUtqtTVSG-WBHGLd0F9f_o$v5NDr<-bOqD{7`{7`#kg$
z;_UNNEvPqZM{}reUBqj_cx8sT4XoR35pMzOldg!5f&QpK{0{W@L5N#Iz1ZjN%+5hD
z9*#!xZ2rwa{58b?Ux>4Dei`CyowgBi7KbMg4~B8?65?B-+<S;CA<q9nd>X{VXT({*
z(1L!?{LmEE19cEjgL0*aM?hSWM-d2#>FEyhT4%&VL@|jE;%^{M0uX-$@gISBDa20_
z;^i>Tq#}L|){V0f?@bLRX({5<V4T^Acvo0A?nAsK^v6?(4}txwh$n&lj}RXK>z_A>
zv)@@spq-hY+2_dmi1&o?zX{?!;5@|&@e5MH4U!IsKLP)EA<oVx`y$SMR~dr%9H>t`
z;_Uux?E81DUJ4iwvyl8+*k6cv8MH4u&h%V?_}`7>VHl7cM_iZnJH**_*pG-W1wVgB
zyb!o1j9bheZD?OZ#M$@Hnjroa)*+UNmx;|KaYme-f4L)W0_%sNh<}BC7m9cj=yy?w
zv)>EFA+8B}MkB5Z<9RCLcc355M4XMEix6k$4{H%;=Y6{nXXkxK5oh1eE=HWi=WWE<
zx~>9oZ)nF4i2noaq5<*9+8x|4F+#i!_`wQs_I=Cth_mnOdLYie5A2UP``+&`#M$?R
z$0FVf=84IO=fL=uj`%64uL^N?f3%H=uZR9vfOsf$$P<XO>%x~1p8@f95Aj%7fBu7b
zCzuyLBR&?|Q49J#Yp)ErE>{Qf?qH`Bac4N6ZHss@%!8c}9|rSmcf=3W6dl?ZacA%w
zTNf}p+3$5@k^FL4pJgH59QIcs-V4@IhY<IGar+|TF)%-VMBEV8QFXw7%+6x)dppGI
z!g(M2UIUY7--jED<P)I3Bq8n%_Nx$IOcj!}2Jtzto;i;=`@Fmy@njgsYQa0RvlWcb
zR)}wbc=JU3kyJ28G8pl>B9<f|?hNya67dNT4|#|$gz;z#;)W2Pm59%W{?Z2Gn$;@_
z>~uyv4F)oQ#P`9vA`<bvT4Kc}AfC`t<jWD?2>s#+;%wc28*zJxpSOsgf$>TQ>cQ%D
z2jp8L-UrU(d=WQ+bx0iIQ()W}2b_jI3`t~*e9kKs-h}Uu(GUT*OO_xGVJq2y_$V>E
zWDDY<zz-t62lx@h*8xAtaoSYueEc%v!(m-|A2_WSMVH8nrgu`|?PtBdio23eh`$8>
z9XRukEpX%J;s$G%IN;3?cL4`k0cUz-An(F)-cB!$({_Pylk`En7w8E>d=~I@;LJ`L
zG~`T9o*rXqGbc~my{(#fWIN*QcZ`LI4+r_<hz|vR3Go%cuOiNVPk4*twB6mn&?g+H
zcGCOg(Nuvr``*+`j#E9BFrI(mIMwqC^!z~lAK)5hv=s4sl?LSfhOkGzOU7}khu$ZT
zrh16i1m1|_R8NH<Es?a~IJNUNG>#3&seVV$V~@Bk@b<u|*;K_C@}j99lJ^1mfr!h2
zvw5EB$rRN{qCuYVGT_;WcLTl<aUbAo5MKp+H*jh@^}}jdhZJ)1Fcb<o$~bxIpFnj1
zOCBLU0Qeikvw?p=JOj8UjIY!ls((LlZNzr~uaEd+;EfQ!58MKAO%2h0YsA^_9_=_z
z{R5X9B{Ia>IH}+`wV$o`{1CU&5X<eyajL%y%uhiar+VT+J`C{@z@s=$^=yFoJ&EH~
z4?FK3i+C33nZ$9bM+WPYOpa4Mhd@3H@!i1L_t|MX(tcM&UNo`qPqBDw1M8>Fpohje
zjW-WyFZMey%&(wwKR~%R5Pt{!0pjfUlTQ%Wg!q3BoRu2@_GrO+f$>z}=7?VfZio0?
z;9U{_4!keNDcVh5GzD^;`bQ>Ei6k2F7~o2dQ$4eR&*eDPlLmY_;>Um=<hTZ5eqd)2
z$EhCn`}}7dr=sbg=MBfHyeV}cNiAT)W&X4PZj1P5;JzHE_Gp7W12|6gHwVt{Tfp?M
z1HPV<r)V>I(X^A}RL@b6e}wp0S~y8H;rxK<XZJs?2b{$@`+dGCCl9A6f}U=iJndiX
z`%&(QTWSj85`V<KfcHb(4R|Qxp}>bDJ{Wj3$N6z@0&rSiYQMc`j$|pvsms!VujM$E
z_W^zb@d)5gfiu6o(-IFD!Fdeh{mn$qzVFO<2*|ZT@@#zeLA;P=B&iQ@S}!P4;0c^O
zZI_kcpV5e?15ZO-RzpxDnT~i1;PVhK1D=ccQQ%8BPTPg~VGYNror|Fo8xS82d@IMP
z9!*+tlJ;?&>KR*8z>-6V4+4IS<5Umx|9Os6J!%l_7ZLvqdaiPu>T!nk{1e1S!gYoZ
zh_ml+Ygvf)vUp(E{putB^LrhLv+IG*h)ZD|>&tOkFHdc;Jb%Pn0PoLnTCbbn{~(T2
zJ?!^vVThN4o+ysf`P7xXXiDHX)ju8DaU#d5ej7TNk(7eC6u1&Ni+?t+&E@22xx)o5
z63GgVQ~eV`&uYXYfp13qEAZ`zKLx%Y@fhf*hY@GLUpj^Ob&x-Y_$lC55VwSr@*9XZ
z1pWZ=Xy8u}9|8O&;<JIjMSLRgZ-}e06Mjq4;nZyE=eHnljQBv1ua7wU9fB$13qigG
z;<JHUBYqONE#gOkI{|0$vkm4=1>(nm$0N?xMY9n92jn*)&erYc5qE%jxq{;qvGtE|
zvoo^K>{NifsTF}7j{@$AcqZ^@#B+hqM0^GCe8hJG-+{OR%p)Znr=sjR5l=WyhY}Nz
z|AF{L;JR&St$x+FAIu{b9H;tE2~rYCSB_Ktn_;}_f%tCV0f?6X4@dj~@M(yD13nk=
znl(j(mLqNed=uhhfbT<m3h*MtmjZvpaT;n4;D>h{rzWle`C8VZ0E?d>h))N^6M*+X
z{1mi%DB{hby(S=T4ed3X<5YE9uyX^)shz_>{utuV!Oyo4-wO451zd;dpyRwA=>N=d
zetyva1E@S5mmWZdnuy;9ZU~(DjooLe5hqW}g>Eac;5gM^vo`rhk~QM&_d-sHyMTO0
z#GQb<AwCSa7vcfHdm%m*cpt<k03U*Q9`GQ<mjaJM{50?w#E$?UjrdF8;}L%jJPmR7
z`<&^B*PzZODGNAjuUmA3q&0{?0e%Q^4T%4Hh?@Zaj<_Z8dNyJ?tlaz1U)mz>0CC$1
zaTnm-5ohbwFpg8zDPVsR$7xpy1wBf{+5OaZAbu3|oJHIo>h%!u3aHmt#IvCP8n*l8
z2dV<xC27NPYG*Xq=?a|n-=$)9i8sgj{@aJ+`b4$`{YTOO#7%(*0cY(p6vnF&oV)?a
zze~^}kxbw?RnZ0XOhLRO@Jz%90MA0a5AYnsM*&}ecnt8Bh|d9@k2t%())vG!fcy@`
z+3&CpAbtYm3lTp8{4{XpPxib12T1-7$Ui}x{qE~I(vt=4B83l7nEsK#yCKf*yQDyT
z3&i0-#4i9(;5d!XXlVB|j??&*L%Ev}9|Zga;(5UDAkNNbUvQl77dm#L0j$0*bb};Q
z;Iv=R_>ZHIq&A4N&ySorPF?>G_`eh46~Maz$L0EQ@<v3@A((#$b6ikiK&>Iy_YnUA
z`olO*^|0$ZaU7?jmY^pQarQgC@xYm#a#|=!YY;CGvE(?%sh`>BlI0wyRk{cAT5utV
z>ZkI4z|A;L<#nN5x^bM!2ZDSk$EmzM$ft0e${U0HB92q}nIK=laXQqp=dzvQIF)||
z@%#?)FTmAcK}gk7`BwBFNzFJ;^)H8VZ8=Uwok89Y@%=DvhXQBuxe*+lg?L~+TB=0y
zH{$MQB43F(yRXD1#3ju|`2xh*^|9lKv+Mblh%aj`>iL8?vq!^GJkILHuD9qT-j_Be
zNevOd4)JV`IJ@4}32|00PsCdqiu(N#-vggJ3<6G@4~8Bg!#GZ!_OFRx&m_c?fX_fY
zANWkfmjYjecnR=jh@S$!5%Dj;w<7)q_%4nc5&OHr_d^bIoYu=6{BsO(_I>749H)BN
zb-C+^v+HtC5og!mJ|fQIp{5g2N)n3`cAc#O;_SMd4acedeqcX&u$7Rg9?HFdx92#u
zpIv{Gah%F$fV?N-?DwcXz*(Ho=i1Q}$jMXvEN-JXPW9)5{usnp0#D#L)x+X>BFCwo
z(;%OMIQ#u-25@HQ46t)C;!A+<LwpzTBE-)Fzk;}o+DekTv-nQMXg}H^?n+EK4qaV1
z;=^$&e-q?~bDSUNQ#nrMD?xr1;`PAJjU1=ra|e*$&2g%SeZQg<@et7SisP_k7c_n0
zIMu`M?_9IJSP=6A`+j3R;4IGB_ZwRyzCp|`aYTFwErcXD#M{9*?1lK12BLfq#QkC3
z=~WHyi}=G9qMiW657!m>P{i5yxPlRPXeG)=AkMy*H3IQ9P;MOJ?0Z>>h+hJE`1oA7
zzNae|Df~}>ZQ3q8XX_ozzae>WvxGf2iptZrWGRvYk}zLc4Zn&w)Bm~}ZU~)+>Gu(f
zlQ<z>2D}I2nZVigDypXzF#0x=ljr$?YWS0Ccn#<zSbuxOU7+kyhz|vxgLoG3!`1MQ
zh_mkx=t93?_AqY4ac$5|-`MX_s65ZZs*zvCaaigJ+Sq+}sUDu+XX{GDmw*tK9|!#v
zb9P@!%)P*9#@z&KB$7vn%YnCp#%A)#(5~#hf{e4zgT5ho#$%x~VEG%>a4YD9SU#p2
zKBpS44%Zi%p6g)$AjG2~J{BSV7jSl8Bc_L4pJ(?kV*CW%AW6Hn_|7=Hp4qt?9#{=e
zt%k3zhMz&a4D5M@IJ^F)Ll+GsF+17yH*>_<^_;HN@PKM~LN)xaYWT)#_({as^@_WQ
zv+Em`h_my3HCX?$`Z8`+4WGnu=*oh>)>OkUR>Qwm!`b-<wTIX559>I_VL2h0hPX_y
zhMcD(&em^d5NGQ*Hs;Xo2O%$L0&yW8czdK!4)YuA3eRe!+m!R;p(}+XQO?g7egggX
zJQ&1re*T59{TZLRR3S-L;@eNo`j-rG_Wj97#MwBu3~^hi^lrpi{GZ}Dtrwdw*!q;3
zM}686<etMj<Go<NisQVWb)bIqjkOUKW$RYTc|Wu7Nm0)G*^1KxLo8JzapE}dXEWib
zXuC1lW_GqhTm}2g|5P`XzXRL`-WhKL<-z3>!8cTXB5)ShOuiVnE7GG5<F+T_^?>^z
zZULOtgXwPvyf2dP0DK_gGT_4y_XZw{IQ#w^i#Jy85Ri{S@?pRe5RV2v2Js}|6A@1V
zJ{55l@M(z82hQ4)*|{3{Y$U%Ccn;zPz!xHZ960M=O#e0Dc}V^d@O6lP0=^mXS}-rO
z^GK$j{XT`Q+Zk^F@&}O~bKpl2ZwtH#arQitbBMF&kz7Q)C+N9~_+a3-5Dx)fhB*6v
z?_<QrgM0<z(}BN4oPFQm9pYO-{xjkQz<(fq1h@wDSLWw4z-t4iZ~XYi`V-~+_%;o8
zDCftwT^#4fHyH>~d0IA0Q6NM)KfXypfQA!qPc+AQdk%1%x2KHbyglr>PE<c{&rWIx
zNtE;UNNf_v#gNBqllP<q@ja4lC6UKtOKie|lY%8SA&H3+n}j&JLnZBO$iv$CUGjMM
zgz)HK8=A-FU(e2l2hIN{5#gEh|3L-+%<=!Ehkw}ke<??6R=w?idhR!?dT3%2tGMu3
z`M{{yh&bXh`iS|!;E<4n@X?@KMC5_%^nv88K#(I(m>(YgJ4+xBSpSzGd7gVXQ%>4|
zZBk60Lr?ZY<6>gMV@aFE#wCT@bnn@(t?+ny*dHF7Y!jbA9weWTG!Co^j|_}RppT>f
z|4#I4hcv|a*riHc>AycD2*;mCnv*TcpxgfBu0OYa-@y6lbqU%({;&D1NnWaxtq;hi
zkX+%Njcc$g$kJ_Q2fa@4r~I}cFphRSF0sDM^3(MJ-Nyc7;~~2~$5gQOG28bc8+1Hz
zWdPoD`->ZFz1ouO(lS{2CLl-W{XdppLlj`21A({%mrvIde=6TLK+F*U1=8~ACNBRk
z!v0i#JS@B;L^VJE<MOk~kw2B686;+bH{o}4bX>&c?<4F_<(EPE?ECVfHp##0zl$9B
zQ~A$=#2f+8{<Qw|JO`KmfUrN6A1_>FC+lE(kW0A!blv->@?As4Ok*K0EuWr};_~U|
zoqsC7&{)hk3-Yr!T)q~`{HO8@{!l*6i_3S0@}W3ZjKr^wxQWYS`PsW1^8Zu}8iH7U
zxDLz|vwUpdy&C&%!$gT(Sa?(aQI#w|>py*~DL)=An3`47|5^F;car4qmtr`OYbkD+
z!u2)4Kg(zP^mBke`Tx{WQ9>K?Q~T?a7q*|C2mPu10$VY^oA~zgKg-X+m}<%|IW0=8
z1wmRq^%=|0{5QLr@+Ed+#(R*Ty|MgkUsX-{W6y{Z?7BBCzY%${{H*-d)s$Zb<@?rP
zC5i7WKcma5DZlKjC{acmha_5l6Y^sDS^3+bd|P&a3X^0DpC1$%i2Lk66C>G#bfB92
zpS;B52}}^=asG2GKOARoBjn<i1q1NT)Uo#~kRORj{(}6NvwVy{CV+-0>L!w0$PZ!2
z#DDsaf$va0&VLH>v)^Aad2O}<@1IEiKlPu&5>a3_$kFy|L0&9BYd=~aTsF;8LMLXD
z*!<UuY}0EKI6qy(<FyMx5{o|cKY30sI!Mdo6P+fIh;Z2NqA10FXUy{8{O#;*rF^n$
z?`-ST(ZPXYdq+EG`}X30J6l_4M@OmDxxJ$^c_S%EXNsr7OI_`kMm0%SaV%kl!Mpa?
zU%*w^bS3L8J4t+UQgTAHv}L037ba~P9UUgMZ5c;)btLY=v1BzXCCk=WX+%_XIDwtW
zO9I<O7-UH%9SJ#^A<N;Bq9U?8GAcekDt5RuIW{>lIXGI-AY=~})sppb(r;>^IDv;n
zC9u+XD>y7}N?Y0zTZQslCblECg~t+8ei;ZB+UiJRqGF>0lY$dP14(^<RaQqLazRaK
zjCeptLR}CW9v+q$7#$Uo5S%cMSfnE%%lOezVd1~Sh~(JNq^P*qz{KddB&wU(Ku}=#
z*znN6n7A<FI)Xxjlfs9`fu7K~1ajgb{1@~Nk55jN(0{^SOn3|tl!$Kv35!Y`DWU&_
zJyK0t)xe~v7}_j4k}<*2(Zb%ZEf5?nZ8<(!hsuyMB(W9A5y2pG!iLE3gt+ARDB=NP
zZgf;qcmioS;VhKouxOcRDHR;TnoSx^t))REYW&#}ysUTv3ZhKSn5gJzX>ww?G$}kL
zo~a{oDH~8wNupWS-&=WgA6@Cm`gtqg%ldjNzxC@QpZbr5R3cGD*~(Sp48!EACM_*U
z9=UR{xe4KN<ym=llDT0<rGdw@s(R#zM3J3tZb-BUsuW5Ob8Ut4q+B(@1P&|T$W=WI
z70MS1<x>&KvlZq5<Z1tCdlT_&L6x6fVLuO5551~HsY2ypZUN$|J|<#zm9B@%T~D5N
z+@vbeLZRv*Wkq}xHv$I9Rq2AAVe&Sbg5k-=@~OvZjRp^u4Ur9%4U+{P6NRbmLXr)T
zO)aYekNl7;uYo`M^-+-8PW`6?shnKd*W6IG(R{41tsr$&9WYNJJH$g`L2_lfxdj1s
zg&CDH;vBn6b|1uoG71ecPZ9NRWCn)QI*=7$gu%<xGUf3I1DhiTGoBC|<V7Cl!boe7
zagFX0|48MkiRRjZPvuJDF1hl8sLifQe3vV43QqYbr!EJkN;21$Da*Z;*X6m?wcuBU
z@}pesq+Ow0Nt%x2s@f@5L`BMBIThw6M5TxFiMMJJsPj-hl`Bt(0^Vxv0t)CDI7r^{
zjzM}RHB&WDs4?+%UBTA|8TE(+@i+At=Whek6e2EE`;FYd>g*eXVW-|03=~d1-WV8>
z+JO-ng=2k)a|)?c;TwYh4|Bse28M!Mgh9I_iQ(jcHK_&hR{6CbRaFrNrXCUrWOgAm
zp^aT(d016dm4T@%X|tngWolHP{9=W?)={eUDA8K@JWt3+9Bg7)B<3dB+6vi-zBdL#
zj)(;r?EBPBEG>$ZW?-65s{!SyIzYK95*df-+$zs@qKD<mBX))2G2yCh`DKz<+^2_W
z|MONB)80p8jqiXzdtaDBWiEJBq0AG)*;jd7o*hl2;02VbJSHg5xHUFHo}I;az$y|d
zG-RL=Wh53zJCjcN;#V|~Pzb#xYGUz3o1FvzDZx8*<~cIo%GHjD65eV}%t;2)+H?f?
z+1md_&l0LD)c2!M-@`P3Wc@sqC+KK%j?`CKDp%emeXM{SAYI8C2AhrMYY9*&&y()_
zifqZViIYh`O3x)bqE*Tx8K(_0>AnXYDm;{hEhR*>i^P@uawc7yl+;DCoNjI+B3&dY
zbn__LB%aX|HT-NrvE9TrR32rGN3`nEN>fXIR@xwgF1SgEQ-gmCaaZ0hWh7~GREqNE
ze~Oal^GGm@@#U?2rcmA&`u7jgbDxotB;^T0bf(a4+OdBM^dl0oexyUwLkiN+L4rIP
zBc<hCg**~(Wx3~{RGN~*qKzagmuP%eiA_a<^aC9YugLn6_~|ECp6}zKJVx7#^l*hz
z&z!WG*!Sg1;wb`!mJ+p+_R65=tr@oz%9jQnL)dukO@f)WCB2qQV|O_z8wR?UzsD}E
zPb3Loh4O<C!#@MKiZv4L=fCC^s`UcVmNK@EO|p@}Zoj(emy*g-zStO~|4pzwJD`rx
z4Z4sWGEfs2i<SyQrSgWSUEv79hoqk!C1om<q%WNi{i%GZgn1)iP{yq!6+I?ST11dp
z^UD$vx6~Uyry+xk<)la&H-sv$bCDA<J7sJ=i9tpnX^da_sqdT#q4l%7^?VL}|2>`*
z%8F{@Nw`-_`8blBA0Jt?SD)|sNwEZ2JBrKJz}UDkbm2kPku4K#q_XIQ@Zhj<bazZ#
z!pQIhve^G!P+0c-zQ!drr|CDn|AWro<)yzZEdPTkLOJfip^@RzSaRK08XA{OR;P4<
z9TF}b9v(~9T1nwy(ulYOX;ds-Qo+(p$mazMx2QxRM@%rOUl?6e1xrJT%HR;PI;Zm1
z(h!m}iu@(g<yDw8WSo?&B*{7}GB{Qm7fUwC64*xSOBB$>InluK(^DhKZ|gI%)D24x
zrRz)S=%`?!qC$2oH#}Te|3xIk#Yn}oiJy8B!b8KOMiV<)+So@&NPXQ%-N?2r*`W(c
z*zk30N0yesqlpWKlj1lkRGup@BA8S%OqvuYO(e@-YMBK+3keyQ6rM;?lBG}$mW_<>
zba1~w$BFN<zGRSiPsa6^u#ogt#glbKT{=+wzLHe1{zS)ujO#?3hbq)oSeXhdOfs$s
zgMw$qBM$?QGU%veSt(Gq=w$0ncDSy&Liw7^VPwPsMAw=k_}5xf*7whgO;P;+ve>kT
z#im^$*Tdy1UspL<!wTJ%j5^|UBbxVozxe*snPdY7T)G@rC{GYyzLhKQ3C0s&Laj0i
zlP%=Ra?+W}{7HrlHt1`!l8;5$u=#{6ze)N1OzaBz0Rt4J9siXDjDYh4G6~RjCF8#@
zov-O+eU@6`p$fKzMqz6QQakC-@e&lPdXPoCFofo^fl}oz^&}IU+6gvZ(tL7NVh2(a
zZ`EYBh$X8)ZM#eIj_%T=ns$Zz$SgsoFi$e=9oJTtaDHVzlMV1y7C{J#XEAc+6~S%f
zT!s$93RqVtlpD=W2=G;&_a%#mba%39^HwF3_`LVitp*vj36(RyikwC${lrzK^0eJY
z&z-zgz9guq<9$`0CgiZkQK%$2h4EDR>dC5-rDEP;fxa0Z4ANT@tt6zO9C79lHIVh9
zu!Lt$VNUf9%`!hl*I}v&WV$C4U|)0XpKCG&Ija)mhy>JO(GzMgLy&m0m1mqzss|>C
z#W3~cXa{;!{>P)L>{CP;$wA{(JiTLQZ7N?6Fjzdm6cS05ugP!P#9I1hR2ihVBi^DX
zKHW|1KFG6$iTBSwVCn>6>HkL9;(sG-`(FynR9WWH#QPbilj8)Fg6LTrJqsD#`oB~m
zWQ+fq?Y}j1wp=wSK=jdb3vqn|VdJZO^($n4Z-ifY=-D(G9nKIUmuFNZ4FOedzt)$e
ztBLC^dL}O(_Eu?ms(K1BolVZVezm<^B_{(1G#OC|;$k7YNFjc-kO5Fg7iur<%KumW
ze!uHiW#^IjA$>KYh=k?Om=wJrie?lFr=?@t`esxnwGxNPekL-NFO6c-4J|xXo_az@
z^@Sc8Fo=dMIhzp|Xzbi|CJlUYt$<K&kTEbN9k7S1HyJ<wIDYSpn9b}+UM~+NrT*;O
zc7;FJbLF4D{yKmBB|(le-<F&HT(2oq$=c;5B!j3}m|tc6gb_IH9}6;?Il{SNlDP>z
ziByfJ4Q-H~MF%G3JF;3AGqUlYoY_IMk=3lQ@}{4r$W=p$hhX5N104N|7a5FA<aD^A
z_p|tEJ;{?~PcF-lzOaJ~*(5rI6J6p(H1ZU=>k-Y8=h?#fwL&$?L>L3;kJjlW4&qsM
z_9jc~Rzn!|#<<E<HRajDIleqpbE;hJR8^U{ZuKUsf8uy@=J$sJeO28dbj8ZjQw2kL
z8*(Y+t;`_qApJbVTQy&s^xz0@gV@(^42(}k7+fxr85m{IW4>xx=4+{pTDtiu@~%*u
zQAmuFsT!nxQ8P#nCWC$27fplo0J1^nidpnVt0WLC=#-^O)Kj^L#gbhz%{?I_I~m4B
zRGuYVD{z%~+TD_qlSmWpBwz|rN9Hkdw#uIZ!1a;;SYL(86Xr*6)c{vt<!5rTVs~0B
zS}a$lJm#5k%OL$9Qao|5rr;4pw(!ADk|y<+hjNIywou9+94a_k)a0Qea<a6q>INAu
zBnl4^|BzsS1(i%Zy)YvOz;4pclJX`(rBjF`@%w*hH@+UdOng<nq@)g>s_uF}hn$bB
zODO0_q)>h)iyTzX@;YK?NvFke<<S8`2u-5bkd}l4l=v>dSNTanS5CCietNF_$e-;0
zsZXKu)utZ&x4!?O4&rz;fK-E4($-tm%VdNaDOf=-@d=AI(rf{P%H4$G#rlx$CM<f$
z%yCIhRu*r(4XiHGew%4VT7u3e^h(w#Z*q=FLzjSCRAjLb(1INOmMp>SI+`K<REGeI
z3cm5lRk-V7@A}z`3rMdgm%oPnLtYn&{0Z`Y4x+m18#|w*qvy{-KrW1m^utwA?)P9x
zb0INw<~s?<qKwN#H;tt7ePo}`6Vx}PF~nso^@`9UWKi>?BZGygk4CXAy_!M0l6HAK
zv7*}RdgVqmEN1^ae)`vSzcb{z-|6zx#LJ>uV#j|>Dd{#cQJ{=|bS|V4SMi<gk6pZL
z;e@e$J?9s`^lg1-Nz%QZYvR_-?b*7yxuLq+n^rPg$5}y!C5EY5p3P#l(k#r1wbP~B
zbKf5^uHiX-l-Y$5qa&8oSeErnXO(?Qhn3HtcCym2KU0?YVC{x`nfsEPeY{)o!u(yg
zTT^ZiKD@rq%RXy*Ua5Q-?CIUR?;5koyI#e&`Tk8^sjpaO-t2L>;fkBhSB5OEr*Ce4
zWTacjrN6>A)V03cKW~rQj5>YP`}R5EYmrssufEBVjeQ3CD^0_r9gcceHQ9M|a9WFV
zuPS>N^!aOVi?cHhJA|FMS1;P>*qG@XU(K{`bHJg&n`uitCM0Z}SG0Z8tJ2;tzNa<+
zXWCSYWt$T=PTJS2-hFHB36(KR%oeA-e%{%zcx%^C^@u`i{ljrP{MYVqydD!arS<12
zBV!h~_&m6%$%#`-Cw6W4yu~NABRyWVaBFp>m-aYI?HM!rdgK}B7`HUMVt6C-sE4=5
zdymm8wajYzJNR#J6wvzS{@JHie{s>=WgKO-drC+DMi;HjhF<Af|E2Rvy(@c$9cXV9
zzJA@`nI9uoF0Z(4cIH5~MR(sj&DYLd>*xF3>%g8mIcwbl{6`z*7$?`sF?w&9Q>U`!
zdcQuSXMCKz(rUz0*~$@DKBugG86Ix-ptwti9t%zzY;hPKWiV56tVIV&=N_|yy@#FX
z((m}*;F-Fvqn2y9%ltjf70zBi_8YC+(cAiJ8xO7a^9tMOJnWPI<*whk$93Xc9o6me
zNiom1md_{4ey68i?|dcaeT4Czb2*g@V=Gp+DGIlo+vXbm*Y0!MMJp7Wk7$q6{H*P%
zSwnlZru(*(MyYPsI=|MbqvyW1wS`-x)MRQ6#|A&52dW-ec?HNVR~Zhf<zqO%&OEc7
zM)O)ko2_+yX1><#dQV%e;0ChVZtaf*q&G`d8GbO%>VCafyxmb*>Y(%%n!)LHH0v1M
zZJwJIzc5JWXvfrbu_?n+$9Gc{k8w_q(w^btxTL>JX;zq@U%S$C@2ZUcTCo1XG|MsW
zyNC46|9HM+pwXKSg#~*x(kg>K-f!Kd-^9Oa@44?V=iS*Qq0gOE4O?zsX%*9ZSL-;R
zh{}sgcMl%zJwdDaoS<&%<vAZ*G}|9Z)XodLsjEFXwaQJJT{_I;RI3h|t`%#Vx|z7W
zGFC5N`N96EJhg>(UhYl*bf45v?Yz}DH)ubs^&`{OYQw>qwi#ub>g8KLXdTr{t@4tF
zU%l%VX*TwnMq^ipBNMdqZrt?NycAtoOt+%wmY#al?hi)f-{|^N9S6HicU`z?QWpI;
zjsBZS{(Y}a4t%w$akT}JtWCu?k<1^jcO<zxAN{J?O*(tw$ZpLiW=8bs(>E{C!|LL2
z59gJ`%=XWyH|1%KgtdnK`)amMohxm4q(_<CDf9RikBlNo12#+Vt=`V9wycp`ZsByl
zUdvlJ8s@cdtfOgI-#ARV(>Tn`y7eiy$U3SWH)A)-VjdlOG<iUv*^SW?$G=`Mz1VhB
z_f02vTivjZyuILu?)FjBwpP|?b1ba8Po9PDm0O3lrsoGPOlbZvrPzGp&Apj7oV%Q`
z4teqXdjq3e#}w<9d494!F}(KsCd=M`iY^@P(6zyX9rc!--D}kT*5<8^w%x3pvBh-p
zxJ8v++9X~J8?gAsi#_4{&P5y8Jm1l?{-jf*_gYq*{<cTgdDixE2{F$%Mz6Z}qT8Z5
zD~|3iK9T=rd2!;v6|*+&SaUI|^2^d2J<oQUuyFDG<PYaY4YEmjs<Y;Cuko9c4%M`g
zyy(0%LUH=7@p<2>zK$z1%PTI2_>Z(K?ObInb5dNJJvDq#`s&LLLsgdx-}RE8SG2u;
zGDEQ`>T!toF8j8%Hq~{q9=>nb^qtQ6tD{Ua=f{NXQ(HH;+$*nAadxZ0{@hr%iiknV
z%g1)=M71j&k@sCOa<;zxCeKbsFVEL+>vCkLTIt>35#2kT-)X1arBhMTB7^?n?MmnC
zl~it7&}mfX!=Yaq<h@mlDS5KkE2(wm1;wq>;5uXMlberQF#5sO*{73Cdp9fnF85UI
zpY5}t*{gGEPiK|O@@z}ppP5{B_<rd|t1s6IFK1sq_s;f`TYi`875($Or)^b_4H|!L
zN{-EwCF@!@G{2QQIlJrSR{8g&$@brCUK*WWb-dANyGqZS=XV;cTU2g&Q?cOG`x|FH
z4i)!N6kmFB#zVhYmaidi=P>7NV!CqT(uayi?-mD{ZF$-@|6XbTa~?fQzA7HoSQ0Tl
zV{~Z#v7L<_zE2$;+A1M;{DM=VUluBd<iE^4HM~>tyGG>;W@Qdp>(T1Xip7dY?e{LY
zYu<gf^0q~{I-mU)DB|X}JN2%0g4Tk&E#qdFcS)$Zpy#C<>E*?8C&ijm#&(lj4>c=o
znD8O@N9v9nh3|~=og9{UE-Xr#*|VL(wDfgGd7pVhF1%}a$tu72ZSc#;&@bwx&bD(_
z?N+X9Fe$HRemnmJm(pu;m)t|m4@P{Mf50vO<+H+L@49@>P(1Y>GwGjC$F%Gly4}6}
zetjK9$MGZAHSW9fjiU0=>5fWg<GuC9tSj!|YF(%KNBxHhtFA1nIkG|f`Y(gJMHlFO
zp8TrMGsF9BU)^h9yW8^R?4<Z{k&E8w=j^tOTd~u3-1Pgklrweit_-tvOX~DWzgO2V
z2Yt=EMm?YBRkZ!!vR!Y_Js0DtohQAtIKB7dO#Qt(^rqY$oND=~ctQ`OL3PLMFE04*
zUAntb7scDMjdpov9lSSoJpXa3VVfblo^@*J`}c`&4Rw=Ny^Jc?CebEQPqu2SG4;!w
z`AWayAF0J_K7IXIccNP3%UMg^B2wG!a4K~Ay8TjfQ+NHI4o=7Z?!Ic+*ixSp?E@Mm
z1$N!5L5B3pUGEucHcGnZ7gaLJQ`_;`p^!J4+FmZp?P{-`b;$TYr>Nz1wrr`pPPr~?
zqGrC2V(_WH8JCatt!&<YN#u~NZ6%XCUHl~d=U|MYj(v)=U4}zY@r$s9&opjca6FOL
zCac^y?~dYqKw$e)$Gm3wJ^T~el_n`}6+6}$a8H(hcJ@r$p)-?G*Qu2^%^xUVv!KzO
z3wGzdD#G`rT6ZiRvi*_b?WYdCl4>t|s(kWx>e5KHWzUrLU(Z?kY|ul+tiSzjFO6OD
ze(r;5^<?|XYacl?f6~B9K5?5jbtxRQcfge%L6$3fKYM)oYQMB$D<-&4%PDE&ue-Ql
z+B>V$w$DP%n_d}7UPUWkx^`MWYi?3s({|-+CvPj=XHYV7`p%53uaYi{buP59+}PD<
z>c;f0wdlWw<lnHrYqhscs<^gh<$y67M_OKbJb&1%husHAzBu00)3)){kbPA9l5|r?
z+va1jUc--S<27zt5|zWl3r#LfO6fUWLU-oYbT9GH*E`Zgb6=AZ@8G4a3;vqeFf}3}
zTw6Z(*-h8OGnzC^{XDFL@ujAzJ!ibFf5ffaO%|B`eT9qWk_+ld{qjrwQ#PM@S6_3V
zRq2-QSDtLJpJZtqm{Z=~>~+5dhq4wA%76Umvi&CMn)y*q9e0sIXhiPK*+&(7q*oj^
zwP-&zs>_}4w!7Ap<fvUdS@*O_c~i@zDA%Mmoz_HWy*vNtr2QSQSnJaI384#iU#e_X
zr>XAsZ_gfmshUw9o7b%0sFy}<&R2eDJo3`ZW^<EQxYU@kux(q_o`T*}UR^u+=G}1b
zMFri`2RpUxHD$NyN0-zlRZSAdeM$Vj<jI?N25!qAmlvO%mS5Mu%ee9%y|Tw&Djjv-
zUUTu)$I0WpI^Evncd>kd#r)G<O4EXDv|cP&Ix=lg2lu<@)a;Mn)qHj=`i5Cr>sr(L
zo6a1q{=g+9PW_$#?!C>M9jTmp(f7vf1+MEpYz=v5?YH`1i2k6m2bbs0xVXc0Q_a}#
zQ6=iZm7`7+nAcWZp1j7Sg-Pz>=%IgURcwviK6+}8*AsLH?k^0FYF>J?Mxz7A&Nb~A
zpZvuvvAg~`cj=<~1zJ<j1(bc!dnQ}dTe58DpzSxVw%!`JB0_ViW2aoB<6Z5-g4?W3
zYnWz#ZBf&6r%La;ub34SuT!ADuXp?KL92{!&ifwX>@qLvRs5a&Bi&CMc;+=#A042v
zb9#8t_c80&mDQdcr|p;Ys$fQ7pNT8yjP`X})xiJVtHqgay&J4Mz5K}E?v5SYb0el(
zxL7ziwR}G6+<wQRNSzW}pB|GsHSAgu-Coyq>XHbxzF##LHOTug^|Fb4q~E|9KDF*l
zclxGw>Hdm>;7H5zIav;7PqK0@hnR<N8C}@u^To&p?Jbk`Yo-3UojKL}x~zp?&d7Jh
zgLT#x>`B*KH$h%e(KRpfx~X3mzj7US*LCULdwwomIpu`mxwGT6F1=Elkkj;o#aA`g
zfIW`RK?cvJh8GlTYdq9arLFF`y?HH{xr=5#-`sw?Ji2c?=SjWm_xPf_y?LvVv*qd&
z!fU$J>yq=O-PWV)WnTM(zOFQXId)^z7ip};`!RlNDpIy&UUPH&=c7+OuPyy5H=MV)
zl-|I<PO~PCvs;Z#syDKut;Nc2Zxy~<O%*lD+e@1^o6*?td6S7=SGrF7wEV`B+lvj~
zb!^>kbkdhb>LXIUd~*#KDeGATx*r^&tZTbEa-nW&({WxyOV2Bh=QXbyAGp+iOW){N
z?Z*4twOhG$&Z`cqk8WD`+9gLGmpn!`r=(y}#>+*Y6`OOG?(KiP@4g**x&6!{7P`-{
zOf8DqwO653j-23N+3H2J#iM?NAA4BGX=rSnli%0wTef51sAJcx2Q@!uJM_?-xC$N5
zB@10Y*7q9H^6)*=bC2I$x;Fgb)As7Nv(|TN9h^4Sx#h;X#RE_Go)j_l?Wa3A?HY|*
z)qAmFhuOELUk{kP#V8~wdEUiZ@#jZAzqwy}arRX2L*}OIV^YWZuWIZ0`s5AselgP&
zuS_+69I>}koB!99g>ABptO~sb3|)TlM2*|e79MIm=||O$ixIxdPrcP$yECVEXNxCK
zQga6xUzOYU%E)jET9Dnl^UfE$t{+IyZCq#n`1;p3SqIs4&9fe{u3qi>7NfLhrmdCD
zGs>ymKeAzdvA3Q}cYULTgtj|E7COb9a@8?uK7PWtmA#I)8*e|^|7l5qM_~OnvF6G%
zlj8m=GMcg9{>Ou>MgF%}y>2kZdgg;e%EJXg_cK(BdYg<HwP{q{F>&8cbZOju)Nn0p
zn~)n`*3Ly+4>cHke(TipYGIiHRYrUNHkfzIIAh7U!Sf;?`AkghedSDMc;pp5=aws<
z^m?$Np+~9eL8I*rj$2%uIl(ccDCR*^|2tih>b@xGer27%%M1VaH`g}(xOQLvyQ4CE
zr}XpvJEqgO!#zF+o5ziBeOYhsnel5aAFNsG_ck@h%sD`J*7(=)jy`TP#~ByYKfBd!
zTDGxbf~)%N{3}l{4_Ox3XKPKXaq7*A-F>G&Uf5G^IDSms*ltZX??`An<?o=&v-G;@
zHL&b<I%M<3`njd?w(WhKdg{F_k`JCRXu{?dw{4F#E}6LJSpVi9nv~q1sn*7#@x{Oz
zMj_`L)YteJ^E~s}ZpZbjR~o&_)orV^c=uYjflkk_b~Zbk`nnAaYZy4JKrcY+#tFN$
z%YR4uDbAb=@NZVEKia61*`lrMKc)IcTKmtN9&#q;c*3I4laF(B8)#3eXu7pm{^SEL
z&V!<DKFHP`a=%n$Jh@%nHigM+<^`?4(0*_46<fS4mt1!2;I=C}>wQ*X=*_N|wtCI!
zGI?~^kU?Xo9bbI6?V_><FNS-jTso!WFuQw$D7BH&q;`W`w;CK;RAY$RhYNf9r}s};
z@^+K)id#nxeU7cWA~0p>+qU&rv@Xj_nV!+Cp21?1$^G9idR=_+bg<!3nN!W;b$y4M
zJlA|*CwbbHhC_x2#60eFY=q0ThW%gCjadUfn15+eZ(8d<T}(FjdEN7`if;=R>ZII1
zQ8!{kph@ui37<B-SUNDZ|6#u+CgJaOuZ&!|aq^0NZo9uMP<fuKd{e$I(`w(C2xYzL
zja}^~b;`<Y<NvzNFpnV(-(URX+2M%kteK-y?-y2DH1GE;Xh4S%RkM7uZ&p1`UAl14
zu133bHm>h5!QG`KWrO#6(`h{?ZPI*d<Gm?k&Y6chHw4YryM8=zL0;Fa#JvIOOYMf2
z^jMV=e7GWIN9}2)tK;YU3_sIj+wne=$6d;Q6~Au(vIbV&K14jeY(DNne96<ZiPP)`
zhlEVFT$WX2)4%6IX|D&KuRfWF94bqj^`^#7yKN(1s+wj_ahMrlQI&k$yTehle=Jv9
z&MxjAKf`5^RYMc&YaPycW=@(B;_E%MOS{q6L(R)twb-Gs*D7dv!Kb3atNf%%M&yio
zGdoQRc3-&eklZxRv+uAr@8bjfUs$M;Wk>S9?~V?-XK>#5cF#67-E42=Ja%gl+h6}&
z`d;6_4NU^n>*OBt>A2M>$*Nw<m(wis%C>AQ>yvn{Y*av6-OjbPHR}I(>aDJNm%8;`
zdslzsn29y6-m+Wrys}{C^UCW%S8t74GjL#0vo@d72gViIt!*%};L7@}Lxbn-wjQ|R
z_Tv;?pR9v5V@$Nhl&M?9_&1ZM-MSz%`E2;ZbNqOp8oJ+a@9m@1)_?G7Y>(8P^XuqX
ze^&QCRQOjr+nu)$o;1nobU^ca&Dvf=oeaG0L^sRY*FVv=;_AW{etXXAbk(_&Up6dp
zNX5+DhY7V7cG0`K>hZ}kN5_dKi-X&@-e?rsqrn~v-~Nx(n^^1Jbu~S+_5O+Lubx|N
zyMLm=sAH-vWz!n8b80;7z=i0TQGeH)cscrk#fE9d8}904wOp0^YN21$>)n-W!=Bf)
z^P695>?p<2=>tE_wwxGHzw5c9X^mG;Iu_h$|8~37L67pn?Kl2?zgevz`&(+ipSShB
zPM3ae)6ORQUASQ>OII5-XtiGSiWi&r&Ca+vprz@>n>mMG1a_U3qr7Fi_oT;@Y)3_n
zP{pyjQAt|8Hg5egaZ;+?-N6}$A4Jant4U&bfYq@^wa&aSo?Y_TdcWztVb_{jUVLAm
z_ceU1_q1+jUbU{}Hf3E|)K|9|weMOLj@nc=bad0M|75LgwPnYK2~(TKH9o%fjJ~Gg
zUbK5egEL#BFI%T-Buq+PrhjVph#UU-r-wFl+Pme%84q8Z{x`FVKJGOdtUGb{m-U0@
z%(QA_S!DBhpTVJVdq*g)xjb;Z-oCKNp-%r(mIJyklinKf<>rxB7yKPv2Ce(i-1lV7
zY5&A_Sk>XLHk-_+_nOw+e%`70Ihrf>`3yV0S*zoh3ZLG!yUS-d?U$H7TmLLGY=XzR
z!`ogKZGJTJq|e=uZqFO$zx}aIqt}`_yE?iVxlW(#;_NlO?AC+V+h#nT<(j|NZql$f
z*FWS=+cy4y$+7{f&5H)xFV4B&qv3_KWfpsupBtdxV?eFP^NwYXj!UZNy>8~*-iI2x
z<Za7;p5y-Fp6>9H*K0dZ>g5yE>1KnAH+r{qh}*c_W|Zw=n|+E;9kVn4zP;|~`=r}u
ze;@9ro>)@$b@+iZT@r5>zPM4icmJ1jO=HvxS2k<Z`nh8IuD?e0Yu|n2xa+SEHFBNY
zIrmOx3+J^*U%l42RuX%CzQyD9^YR1i#!Ma4D)ZtJ>*61J4WFFd>M^aKeUjX8U)sD8
zheocc`@CZQ{r20xIXsSjZQ#A_NJn)Whk3p3M7KK-;E{TvhV0sxtJ_9j-S+wDo{lFo
zh7N2~F`=K;-Y+q=dVe}Nc;3>grSkYCIlbFeZ8z}0cJJ}hZ_-)o?X5C4J&3X>Zdq7w
z_CI0Ag0u!4I#8AUm+QiR4ySJ0l6_F|GW4z54wrS#PxP{;<s0ovi+y3de|Pbo!D%&P
zHJ07jxV@}ctNoQm-IvSHjtks0M{Q5Z(6?Wm7jG$YZaKpA_~JRE-xjR>xMkP2Yd(I<
z<Bm#d__Y7KOjnWFR(;0OuoFdlpY7@SEbii-qM;|Z6`WaK!)pJDJtlwcf4!so;@DBc
zr*uu|`svi?vc^x-1}`?S8FjpTQgDY4OAT&+nsCf6u<1FM^4ES#u8(NkHY3&MV{mwm
zD!XuFuF2yn$=B;G^5J(*<We<zmg%qS)iHf;j4rh`JUC)ytID7~>wKEbo#s*E7~Z3n
z$v*SEmeF=Di|1;5(=;vYXg#IIlw(_#&v|s+X3}=2g?kg9-kl@gcInGS_5SL8kJf2a
zYPY%~GsVYJI<;cR#0K4R{8DbWALG(0s-KzD(}l<7n>-E=H}Z?CUy-t_V}VY<$FcS!
zUA>1TMQP+cUu<f=IN!6sY5x=R<OBMI+a;g+-af2jRB6cb!j$L9MZ4|lt{LSOX1HdA
zapL3o>oz8?PRg+w`Ly^}th_8?{<Fc3V`Pr2eY8D#L=H@k%~}3E$gYjX5dW3N#(Rw_
z7T?)j+W7t$AH9hKi=Lcy`_V7_QY*WXmTK?9WC~Y<6LP2H{VO-VKcBF7{`KA0GUS_r
z_nUuOIOXfjfYCwk?&;>n9eF)9IBn86wIz*D*I0F@$&A&tHoEoFJ$bmF;jk_GA+0aO
znC>zezv!)M;>+0$gN$Cke05-7mj|z8Cwo-Yt6@B5?snf6<>3d%M7DqXW9fHu_eXi^
zPaD2ke*28wq};D7uJu+W%ZCj+)a}ek=Z}>~Zx^l3c>S)Y&#iyb9(G<ka`Q3s6YW-f
zYT7j<f9|J|r!2p3bDpngywcQaebTKvo|g?5X+5|c7uvLgL$9LTj~%9rE<86rdf1V<
zkMAz1wcv4|uL&Au19y~lebsqX_rree<Q>{SY3lH$`|IIes%H+9<}A}2|0OWXA#mxG
zc+V+;bFMr~-uu^($BV+}^?38?*36+ZI=`}ct2Xv!eXUQkpNHptskv@Sn)sty7B}?E
zz%;S_v5T_<;-dTXtNU{A$K8`Qx!cFLc=o9<(^Xx^v-Yw`leE}U&B$xnd$w)z>ekrK
z@MwtoBG*FewYp~mOg8JzEwM;1$kNQ68XRGt>8e-n=?_V5)i+%eS<5Kx@fQw`d3f-{
zmFouokF+;|tKs|O|8I*mvRC$`k}YjSqJ2e@vZsBcO$$YcN<^|&5+zB=5+PC{kwj!C
zTZj;{WDUPLGw;Lsyt&`s@A3biN4J@I&g;C-Iq$Q~nYnXk78QT~vE=#o;5Tnm7oFG<
zkyQCwYu1*&m!Hbl&S>x8+B971W!Z4IdmYEvc9VZ{PCF&cv*A;1&Ha*|W3z)FCmPys
znl(J#ZkEG6wRxQ!x6D1#w)N_`Oo<yxISMYtGmgv{x_3%$)$4#3rlx0;d-mvh!04UQ
z`Eg$YL#mT9Ev|mf?Xb_{@$pN^-sd8d6(+AuzPmnI%X^T8>+!F{GhA;+F4WxnWq69y
zfiJ`3oYE>PqnaKMezHm8)waD=r3LwM8Yvm7!vZFhl|6hQ8&xuLS%v)r<946+1vO9k
zDXZhI6gRIVtWCh{l^*%48y%|$xgS_<^L4|Einb9yKIwT)eZE8Mnd9@7$EqgJdZBuD
z<C52Aa!W?d@d)p0F}-PE#HPliA0y}8N&8s2YSzU(_nQ;7&ZJB?sAyN7KfQ&5;c34W
zrE{KKT9T8UqZgR(k#bsl+Oc7!3jJ>Oc`%@Ho=vma<MBP0&T;V6>NqRs)aJI_zl|!+
z%c{(uR4RShZK50<JY{LCu8;cNy!=k{^wP%1PlBIJzS=J^Pts9gd01&$&{3T?k||PK
zcNiHS*tKJhj?SaAu{!qKq<p7`o+=#FU*njTfn1Qnn2z7?DC~T$FqZpbdVca5^Lfdi
zgY4hRYF=p7qPS02d5ys4Yj3h#PMo+Ff5ztXk_4T{J|7<CT?)P;)pMJC|6?awWmY>j
zbWlCne14|>`^qkFjrJt=zFGXK($wT=jz&t`TU9krQ#23wyq8*5nlxmmnapX2k=p7u
zCzb~N8uqBuTa{rc#ZM=MYyU{Dwf9(kaHU+|T@8I>q|Yl|XxSn!NYX+y`1MN37sdyT
zN|h8Jj@oQ2>S>)WW4p!if?-)F_c+52&Xbzd)^#r^Jn6VyH2F-oPs>x@?0sh3?m*tg
z9hYowUb0W9_lz1}aCS)ZtTiG29j#7F*)MO^b>JSW8(SI`&3pH9&p7h^o~&1t(Hi}*
z<#r1sGxxQ=qgNUDcu30Ow2mXT4_yA*{?6+QttNlB^@;yBvffQIKfpgv$EfmznZlh6
zoeicvQbP4o?(}&UacuuN_q|K3d%m~dv9pI`TKuK*@lW6G9{Kr9AJ5Ip+8>p>cJNc1
zHnpp?x>u_X_E<J;-R_*l5gkl4Lc4mMJJw$Q`?2osnUlMBmz=opZRe!Qc})@R41Vd=
z{nQ)xqH%J=_CT8{LsvMBHox0_a(%Y>%p)7mYH4=zY$qRg#C2o++Er65H5a?*ZJTBD
z`e~aTS)E;t&*!w6H}Q7<Gw(4gzOHUB**n|Sw)@(3wc4|6w$)ng&)U#@FlFJznb9e8
z*3S(czpvZD&9`#juk$>fq`sr&^q^Kx_oZ*Xzw!R3J~e0S%G4j2v|3hQ`(sW<np0wz
zGez+|4(J_89qJ?@IeVG%qob;|vagFmC3?-c^d!%zXQ;;fWw(d=F2C@(`}Yl327L80
z?mJq}S-aa*nYmq#p2*nOcc1(+mqCf1iRs!Zr&rW}(kNT{tgvR<m9f%AM~$l{)_qKG
z%zU`0f2_jp9p+i>C!cM1Ci`WPYgfBRL(VD2X@<qmd6!~rG5qchIj?kSuT2?WuXcU9
zx6IDo?nUe2KRbD7WVF|N@X`8U@6D<M<*i~y3@=pgIdggV&^G=0ecVwzb8*y>uNStC
zx~kdx$2Obl)m_Kehm05XdA#<;y2an*!k3QY>g{#?;!&!Z5z&QJD~)4^>y=kcb@AVG
zZs6T{F$o=iN<8`~m2smkV@t-%manVZn`sZfWPf;}mtA~z50&b*gY4oz?Ylc=%_o_4
zO>z@FCLLC|Q4rSuTfw|m0b>q3DyL7BbLgA8J0m6XgyF3t-`8a+emb-`^ZDX-6VI(2
zdA90Wz5WT)os;HoyyMW^^FwC2)M3BIh^yz{-1fhCsOD6D;EDEIlHxO+rkCi)gtV?m
zuxm7MK6bprZIk<1eGjSD79G!@)HeU^<jE%wT$vPK^-kNln|jHfc2*t>ata<gWag>X
z9h2YW;(1|hwR-QU5%*nd!cq#yrRcV)(Uf)eO3BzOw`=O)aMgD$ZNps+-(B3BYu|lP
z#@;qFo8;Rstl4+GcHizE(I?lce{Gn%&-wiO1!Mi|o3~~@lKV8Y&)df%7MX5sUfEmm
ztKPj+3FC@;#m>GuZdkMNjrVOn75DO+KQJS)q*8ZjNBIG@lJnGE-Ol^34!I*2qvq+K
zwluB9<K)WKkrTgZx-2~r8BltnVR`%dGnxvb9y^MB!<$a#`FQqJ_*LXvG`p+(Px&!@
zj|X;4GIQJ9qoPEnr2kj1Z;v+ShPa#$l888y{JMDJ-AytfM)J2;6g&G4S||JTOZBwK
zLF#H}uP3e86m2qdUfz-Fh2>T07mXaMrmr$O&~9Mw*bz^hgP$yI)){I(T>gMj?*nZH
zc8fh)>pb(xhmrs(3)6XS&z7qAiY9kWO3xl=Y@NGf=*ZhwvqQcOyJ2)B=)cF+Q^F>5
zoUJ)?>eQ(+kz}uS=Oeduim6<8Hu}QSl@~mwMQ3f7m{2T}5}}gvzMFUR_aWKM9jCP1
z%RPVIvxOTyPSa<C(e1F*$zJZx&K{4PMG{k5syVwjdvxmLb?~s;ybmVbx^;D#w7^`>
z+H-pOv8Ybdqc?g;Jdy0W-eUZajmb*`m1OR_xxR3FP+A(arfzVnN`tk-)HYZsOqbK%
z=I$AODI#*4hnB^FICr^9vzuPNLq^}Z6|9kWCc0+Jql;6A1U@q{9~s<9JM~VaZJ_jy
zeVwajEV~k#)}^Yb^ep$}YtKGL|MkOKng4Ec^9?yi-;E9*PkjEAdVl_0i_eRDR;t>i
zt}#8hRl41>`JKY5*M7~YPB822R6j^BBCn@G#Vk9+ip~>8n?*!+c8W;RpJUf()g|`b
zq&=GEixo8A%}e%nUA{fozoz|^H4o1eKYzRZ*P=HCS6+lanjUcDgZ{4T4_A#0h|}!n
zYxY(mZOY8h&yB@8D(z;s8@67q?NG~tr|C!bF8;jZb;<eSl(#d}&lXQiD@l5$&@rr9
z?o8^nw%w+6nP}qtpq<gy?d#IJ^h<wn*yl>DLgg|~ohNPvx1YD!@-b@Qcd3un)BP+o
zmFu<Y4-UFJ>AOXXjp^oo!#CUP*6uNI*Oem=o=xpjQ#R&`hmHI=U+Jc*Q=b<tk~p|E
z@0L`(>1NM!T}2i1i==E-_o_`RP0f}}?vqvYtfptj0gpW=TG+RF?9nPF=;%hn2@mS~
z8{a55Oc?oi=#}ZM#u&{y{KR*?>yE_+y)Vh7Z=Khx%j$!EqG8Lls`u=R_0jO2z0WvK
zVdBs;r}gwN$$hv|zV%Yz{tXK)Ps>$5Qd+s)dbDP6(Z%PBPe@K`F5RYCKDX$`DwkHZ
zimQ57pMSIY%96I4N&~g0`E9&dJ~HY4L*rXAx$YO&wrB_&cv*9ui_MwnfRiqv-ZJ0w
zL}wZ{kGr|C$f5U?va{yrV=FYZbX}8jmJIX?3M{TjQQF$6z2=Ag`&V>&oH9CiLaB9@
zm0Fy^l2h+wJ}g&1q?3H|nVPZwI8%?Rxyz;2YNV~r3lB~@ma4TOQZ_DT=gQjQIYGe*
zj{@=%J|EFHx^5HIqaf6ObWU}Mnw;E-X<za^PKP9pcy{7yLyw5*cAbp0^UFLxgf8E8
zKklgcBd>OeuiX20I$Ckf@xYedTlGT1zeVh~%JxW!-rQ2f>x}+x3%!gH<=baBzA#tr
zS0WR5;8>TWwhm>B;^n0V?OUSU*e@kYdO`QJx}SR@cP%qt8PxOr9F4S{L#-Di997@Y
zH)G7Q@#FIh3pUymI#el7pE;~SrS`$B_JwjgZk1SMYCihl*}3pjrx7z04Z7(%rj3~;
z5mVCV%?_o!C4DdT>^|kl^wU%BwlsZfxY=&&tmitzDueQ^1D#FGp0@0$ee|1Rme$Ox
z`&-Ug+<wU<t+@@YvwuWtr*E&@pX#!}G3$;`m!UF7PexArXw<jGcNLfX4yi$II&~?x
zG7~QxoIBa&RmP`+579jxzi-;Ad^~@`z3!KXFHW!YJL7tx>Gk!_K6c*Ux=lWOH~nRo
zDK{*X+T@*h(a=5R=BMi^-$%+wT$&hmdtiq>vKbXRD(gy0gEj6ZM<tJuDKVXRZDQ7a
z<&SyIHn&51xo$dsHsfB-i0#dD)QWX3)cYQtw`)*@PjL4aniX$U!loU5=pXVryd=K2
z(rBAeACIrjc-U#gsvCOm7U(`58@Q^x?Opu|)sE5b_wNNgS$*%wEz?ec5^HVaRd4Pn
zE4I$u_-WQPO<n0=`=7s}ZLEfwHWr3>S!`eH)a_Z@POlrx2eml)s8X%l=obBw&W>|+
zOx#+q#^Tmj)vMtLgDw?Jzh1K_bN6u7RGkC*CtBU@JE%F$B=viX7w3;$c(dchB0Xil
z{_%<lS5A2Czxc}KP0hpN!)q@0N+??WVbmOx@NVypo448BW7iguTSnWd)k7AI(9wOC
z(_+M=8&>5*hxuM>);&J)*s+@(ZW<RB&yRPMc3&{*!3`sw*!tZ&7rfq{sM6!r+N+!6
zH{Tz3Q(?udrSjG7>b}|R+%dtccOR8{QQz>ibFXVYn9BCB%8}MMWhl{dd+pL5Ps@^*
z^nBS{qGrTcedRs76<2-SUvhrT%Py(W=VRCDc*Qk4Pqg&^a<Ip`AH6<SF0o5J+pf|#
z$?$3Iue+1;Or#rH-wo-Wp_=aQ(PY~p|5teKo&{h0k16Tqttxo1$A0=ANA;kwR}Y(B
z$c|lZey_mj*Giq?^FN$=rB#yAcT8v9a^JWPOLb0K$GzT`_42~yZ|@Sf<$D&Id#}zd
z_@4Y&)$*3rqS7*J&k<g(*X8|h&Qf|5a{ott^o8lW62m+yX8$UwwTXG3nK-R{rB>g|
zN!2$`r>$7o`{3aDTYA(Dm}s@LS?2AlfmQz<_q(b6cRMUKW=2iWlM$Wkc3<o;a&v|1
z%+0a--pY4(9vX5yWJ`C09p0Tc9DC;1=E|YZuRe$9iZ;j%$gwtavr=C6=GyLweb3(<
zG0;AzvT$+2kRSbiO}+ef%GT`jx$>bt!MQsNcKUDrKBU4vEB;b$*|X4HR||9Z`uD%#
zu&w$|z<RxBG5cRy4*W2^)@l8var@Rxn31a<`hEH67q|3xt?utuQ>2&Uc0X}d{KuL8
z^G=R`a#!`>^LlUl7=!qG896dTUUXeNbH7{D;{4)-f;qoFD&*c@a@3$9L$2q+84gxC
zJ5%MlR9iP|`@Nr4ueNWdpZ)uVarbI2n{6xUdi-E>OaHXGefloCzj_Rl&7F2%ed;^)
zLw<JM+nU^xtIpYX!o04#tNpW^rWaCQ-5k51Jlp?67vss<S^M(U>soD<|MoKQPC<U%
z%e?sh5if?9w{%!<P|)VkDW|*V5_0PzvieNT4{z>x;PcCQQM%i&&p$fbw@=2cqL&3t
z54=4NE||Q)&wA0|yq#rpJ{!)6IM%Plped`vy1h+$bs~Fj?!BA)v>dKFOC@T{zj!jK
z|L6mo@(XvI@6bOt#H{;;UUuHWEk_OBYAiJ%b$6yuoW4iM$4O7VD_&L&ua?zWKkMFn
z2Q#0#xkDdKRvysh#h{II<1)wiv~gW{bD*(R;Gz~&=Jj)mTH|s$+GW?vC!Ib&Dyo^$
z{ho?-msv^i@|Qb34LFh_Ke*9$fL}Ms4M%%)lGfW?@oRT)`!x&STs$!|WXjYTZ%PMC
z6%HM`-PlPZWYm}McizlioHlgeUCYuXC)S+2G^LZooiXd)Iw^<Q-Et2}xSHzzP}M-f
ze7#bH^^YCXLf)6QP^*wVVj=I`#v@AQSVFT+?tc5MMJ=r*+BA&V=M?%~J>0}QMfuX}
z6VF9!SDrB1QZz7a%(dqSC8``szofS<FKN>xGTfr*mOb&uj)krBC45x6=?-W=xH|ga
zWXGLxFRkZ0E=bJyIjbnpxpea4#2(F~7f+OtU!<=+%H`Lr8&R3xLOxpEK9_%XWAl%|
zTes4bKWuoK*zvq><7S=A(vB<TI{Dr0W#<3T(P2$s%#k$Pmv3a>AFEqfF?VH^W2kYx
zLHg}v<7KMnR(oWY$;36DkjQN7p=|E|aMsxPtityLOMA4QG~NE0!)&EjJFo6MwWrR!
ze%7Svkqgz5)a)9xuEciS{W#^_v2yL1HBH-$a~{Vl_3GV4eYC~C+oPQ)6*>mo6#ZQC
zGxXr`SCzAE7x)f$dme26LU;5ti;Ud*pmPh3tJzkWZHtamnLWC?OB;)^3K2gJ=GyIg
z81mAf?G-s+4g1L%9V2urWF-0-tQ@^@cjd6ynwqfH*GpcuEmHqtnDk*s>#Z|~EXW@=
zI8!aU`^@yab51{B9=s=g%FZ*jUmcS=On;slsdL#XwDU#fuDahA&Y0@cYLi3aw^r|6
z0{0ntjJXxida0|P@uOZtmK59>n{#K*k<)$0?S1awvwZb{y-Sx2dpcG!zd?Fj`ut8`
zEiA89jMAT$HZ0k;@b;79Cw5hNHO&(3U(_x+c<-l4K}O|`IodPV4C<5Tm*9M)i|*FJ
zN^6xv{Bz^lgyyx^ahmGezojjAtMBUDTlGeo=^luD=GHqj>q=qmmv1^5=K3io;*zI$
zr3ISx>}}K>mgi~~STHss<=5BeyDu+oe*ZPe$>9DbtF7CA?U~~~@U+v>+>cJ@pPI>^
z-M#hN?yZ*s()`z4`e{Ay(xpzm`vPVk*IriH*s_0P%kU%3swH<bvfddvJk*IfYtZ_v
z{d!&V54oooB~*rAPt1}!E%{|^=X>{ue6pIgMJefM?6cP{M;^QGzG-yVut$T&s`1(d
zu}!ni8ay7ge@6O8#R;Y#`X$Gx<%_z-?KAo1a$>{no-cD9PcKdww)3d@b;(0Mg;!Q7
zKT{hhee~PyWkW(2jE-D(O<PI+c&DHH))-05);=6n_a;x$*2}=YXm<9G_x)t8ug_o6
zW9TF49zQ?7&D7Hmm=>>o;l!?vqiy5lvb~eKTs@r=vm!;?%DH^|RfFgyrb~_$9J*Iz
z8Y<;+Pdg}TmY&D@o~>KAeI2<o+C1CQeQ02B`$p4g&%8s&NR0PREz-K~ul#d=>!Q+u
zb4(6uoIDu#{6|(;hfR|_o2ShFYOS5&_+@Fy{4p~mt&L`G^z9Z<u+^{3{nzrl<J)eK
zEScEi<ugOa&EY4b^L%y6$CY)~zgL#jd9i0dt)``;EtNB74!J#b^+t&~`LoBE*;*yf
z@r|`VWSjB2?NP=40|#ApoNYM3_I|Zj*?`R@(l!UL*BsaE@UCE%L7&LdI)95%Idc|e
z+3B0~e--y7zOdJegdKZ3S>=pc>*(^;s(JQ-_uqdw=kHE=Q_-V(u(9o?UC-vIk8-J)
zU^_(5(&5{)$P*t<-MH3j{r5L7T#n3osI5O?`9=K!k)k%6<$sLba=E5%enHaL_|a?1
z;?w<_oLirovAWj*rCwv#PXAD|O@2ea{M!~S)Rphl-8DaunkA<-x<U8in`Iv*V>F(B
z4WCz>>?eP(ChTU}?F&|scHIlU)zl?~?Pz{oS6r^p<=(>l?|M<ol}Bin439mYmlhW@
zJh?jWeah@(XWDBnPrBqXI>G3ilUHnS1FOi!Den?v`bQ|l_)Pnd;GaLLA$FR~wVKA!
zu}wb~epvkDpuYR8?G4%L<6^(+KX{#KH)C<v^j{PFQVd&aovnzdygTkh<1yt9s#ah3
zU)e4t@+n-a{HkWui*}bc#koJ}R<X2I+vqy&4e?S-y3UR;m4CD&$zw|Hr5n1*qpEF7
zOQRy+^n5Owb5CdSxstO|FK#HGbN+G7*zbK?`Q_Dl7q1&WQ9M@f@IX>~^f#qe=N3%q
zyXRMA%at8_*!XIUNbYT-KgK{SqQ|xkEu!|n$X!4D#LTLk7w1GXho1EHx;>%U?Rdg+
zxdkhv##}S^k83|%Z`tKBs-?Y6kIt3U`DUD4SbM(xurYN;6J3tGn;kZsetT}N%%;>d
znH3!~b2DbynYTApIdCfVkXL5&EcyMpL4kE!oR{hD)(P*T*dcK4Zbt)~je}xNo!Qx|
z=Vw<Pok456F8GpL_wkwZxamJPXz6ITny*q}`n_rRW3Lrfr(9A^H_ZQjJ65hXwg1t%
zaY03W4_{jswd72h%J^wgC%wJLYMlR>mF=*^^qo&i`Sy*=C7<}It<{O2b1GXq$h5`6
zJ8vTtR<4}t*sfQ{wTE0EG+5lO?tHs!-uUy;IxFG=RQnFyFfieeynWGJrT(t36H_<t
zEwO*O_k^6v#@$ydO$ROU?OPL8@>MP%&2(NwTPbNtb>rmSYisRmEoRkiYabo^`1bcD
z>eH@t+wI)vY=?wj8ZI$*j|Z-<+hC`)b&<xT3wPEjownLI$yxX2(uU-Nl5cd6-`?wH
zKEQR0)!WON`>rMJ7*~49YKVNB@Ut$)wJWl}21TYGT--t}$hO4_EvcQ0dqhpFFe|pd
z^-%Y%%D71_r@x(P>5-omWB<JH`GkvJ>$=YAwsiH>hJpwCM?BoU`o$dY#0U2(gB}!R
zD0#YXj#3+XtMW(CGmCx?;)D8xZA#iz6|_gq;7!=W6@D65Rq6~wCrogwY$~`j=eUAl
z;?VM+6YZ=c)mnr->ec(^+`F*@ynK{O-&R#j&@x!$__cm^uh#FZa@U@#YCAJ@O^8=Y
z)6P{FFJ8-x`C0U<@P4m1B^grEoh>9*4{q_uwtsM9tZU}un+==dXPlQUeO>vi+*U1o
zZl`e#@mXb^b=o*TT2ZJ`G{Sb;xIyjuF8h#sZ{5%#I~4t1Rg}l8OJD80$t>K>wWr+*
zjk=r(DZ%Nxay%2_Eqcjq(Qh)mqxCgDtM<H4uf2oz8jQEI>!9M`ulPy1a>kyRvFY7c
z4c@Zj%IQhprZ%WwNOkVmF#3&E>MiaDqN<4VnLp}Bjee}_U6!G|@v&)1{qc|Wl}B{1
zXhf&pKc+dQt6O;Q%vaY_&s-ejkiFI~{#U<59kpDE8>`-jjFUO9vvEUE;D}|@wwBm;
zoA6FS-|(`|ryUFT=$)6^65Gn{>^i^O&pgh3uHN$g>LRCgx1RlYy8fl&qS&BkDsfry
zh0(`*EQ)A1;^>K<ISP_n2RL~iIQ`Dzsq>A|x?B9O^oX`@z2Khl3hy3YE(K|v=~wY_
z@U}xMr+SXvF1tizU9TMdv#9jU{@piRHXj;z(ad`4A&XPr25nm2%PYIH_l2G*1Ny(O
zQ_@Wwy>p~@{OQ_ci^+lZ{YI<LHu$Jl)~3tEA;oJSUmV{xXYPYuD%$s>9uHOiuDK)p
zgu(T6^RL=TS=q0W_Sa5I-1s<0ZI`XS+m9su{OHBet|=kMk1l+?eq-XKcYa4t+*w?d
z*yhXB@UKIL{o0W9u&%DdSn~}(<iB|rFMTBI5vSbEbNSxNYYRMLH)!{I*uDJut<j&#
zhubR@-6{DQ_5Afh=@j3|*9OMip1;#%jm*>HMfT~Vc8^(lbMw8-{)deeJ+@W%ZD=ks
z7?!wh+4t6G+PK6tH@{PGQL_7)KIy9C&yV@(R%`mWcsKY=GCvdCda1QVTD8TJn_E+3
zi|03~g(@_Zw{IJ7?wxlq*l+LXZhapeE=Wmz9ycNNhvumDy>ibQwyzp!I>1WFvAFHE
zFwHxQURCv<y>VG)$<p{+N&{k7T$?yQdQ?zk`-vlVMwOp78gTsFvwPETDrVlV+d69B
zil(ZM?Ftv)HZ1TfZG2%<5+CxpQKPS8r#I_99CFk!dmf;0__J@*;!lUa=ky&sAYpQk
zX%0;u9i25*N*Bx+>VLH0RQBidTTd(XnXbLlugdFHc+re^Z65nPc7L9iHGN)lpG5<7
z>{ltAj<}U*@>cP^>{t8uBO`q8YOgsz;P8P*+w7yy9w`jmxK?s`-kFTSgQw2d-`m(d
za9hdv1^zn@jSZS=e%Alw?RKeolN!raSD(}#ylM59H<E^(CQLn(_SrCTZcwM^T54kk
z3_L&M+dd8Jr3-J3mh+fk-}P?4=|AmtXCIzDchRZ=i_2?1hIGEy;YI3zmmPaWR==H9
zI#I7IFnjgI%l@YiAFFQ;IodFH{D&~7-c<)GAIvMzcj$7mCb`Tcc|yJYoCRTFhL65I
zP_Y<V+c75XN|egyvEKp>=WW}RW2o@B;AeUFX!%3kQxngB3|{c~QBz~<Y31?rzZ)fG
zxU3M(?Bu$1!@QL8soC|}Putnv+vQ$-Q#GY2u3*52gt5DNy?OhsyIyV1nAmf@wx&!D
zEuQ&cpJwnJ4ZEd><(AmonB1rRkc<uOud5jq>P~IBWLuK5{+$-i5nuc)XG_F(`*|(Y
zt7W-j#F_&#hNfOpw(o~XZ+_f+-1C$z<F1A&I1N-*>r~{w=+JK4mV-9A={`+XyVCn&
z<=g$D0{e#S4oi+UC;OR>Jkxi=K_hMJH5xIOhmTv<XriGv_TIh6+J@%W>sm!AoS8Mk
zCD?HJ#+eh<)wjL<b=W2~!F09#0qzuKpJ#--;;kzQmu}zbWHzAf_Lmcv#GN)s>G31g
z<LSJ%n<IL?$kIRbOUmS0f%ot0)n(j|TS@qHy?LKqwSTEbyQi^t*R;RVC+mmxW>uee
zmai{Z>D|6{xnf4Nw57@8ilmK;M>%Op6nb9CUQ~W5+0}2#pcdsui+?l>EcV}|x&D0Y
ziu;y>UIu0_y!oW$lvS34^G?qguPWI{=hpj{OqSi9-f-BV{Ig?zjeX31eP_KXV^q7@
zEL)Y)I!{t(?DVAL&j<aqxMY&M(Ctmm{(`2$CE=!x%VK7(oZ9nY<->EO&%aE)*3{vc
zQB1a5agwWqm$Tyl#qH+uK{2N<nJtW+=dYTx!8&K$;12!TM?Kr<ymRNPoKtm^TNmlr
zN;l@^_5Kpv>V)B{37v+P>Ao`>A~pZ8?ewOg5ni>Y>pu+L^epDWa=F`=yjnK2P?nx<
zYUri$?N#E2%+y}mSNCl#GoGoxsFPlep6ipGU*oJKXM}AWnX9{g_zIf`TBDsGj?{6_
zUm5Cm!L6^KWZ%K3F5eiIzk2pak%ftgo}!vtfWN!TQ0@^n++$q4+}sp3hpTI<YYf#I
z2y6UvJ{7roAiw<O9+J*Iw^QO2`C%ti4_80JHhCr|3G~sy5)17_5@8)BdbVrTnmn)8
zo7+d8<w`;;QmMwW9TOxiWEIv*S<5QMOPk4ZzbZ79)mYKeNOojYD+}32hLXOr^@ihQ
z8x2ilzZhD`MjAPB+a}z$J-0OC1T)&ojx>_hFp^a>mQ^&CRp3k-%eFR>nZ}u4NfP41
z9PX#qLRwZNEz93&aS<UcYuQFc$pYCginC=S`vr1Ka}Id@)3&9IC1>s_G0cTp@{ccv
z8L>U#AGY~&?Ej}NBN=Bdx&}0G{+)7vZ2ik86J#4DBoF@6mYEFatS=JQvXPQzvMV{a
zu9LLk)SUfU+-DP{!9R4BPs5tz*X(zGdB2+yzjMCmCs`%?rJtp2q>?MQG$O!|OVs2q
zN1KqZR!F^m1pB6B$=l~DgSF558tilRngI1``akOR@8pbl-#e4~<U%<4$E6j|6<A@7
zl&P%Z3TabWwWt=>vKsDfWz|e%6^&?%7$@WWU%*8*<v#TNDA`~uK@$1pPaCn2HI$6_
zmlJ%sxE~=;4@t-PQ-{2NjeoamT7E@If7yCP(&#L>CD)D>r2?h6wTT?D1LFM8S~lez
zPSSIS&Sy_L<sW}@ogiMCPw!8@O=X>>&Ps6BxGF~d#8O7;wuG$rB-y}8vff6r&XQkc
zy~oK0TFZtR$wo@p%Q|z$#RpQ=(xP|2{-u!OM~%PtNb#e{e>oX1BpJ?+4Iq&cp$B<$
zT!YvD;e7x8t*4_90B$jX*Z<+Qe|B+W7<@U%Fh5@Zhx7fCW9xa|{*MysoB$~i!~ZBa
zjvhn}`=tJQBEGOg>h~M486(`P)bCLhbMkcZzk?M2)bM|C@-*+igOsTE-;g6xqP}9d
zq8P3$hLa~b{~e@6YJWqHNQnmi#q)VWI@o^$d2}LaiTslqm|eyEIz8h2*-;9-^&iBq
zkw?N1JJ=H!fsf;tfBsbipYaFrYd3+1AYKE!5OJYBN{cEHe-3&foj*HY17Gt8@oVpa
z??n6yzun>YJKyMT;oU%gw@+!(vAK3jj-hN2-f<=^63X{yPe)!aEqeI}@oRFxJM+sw
zJ9_~amVY>T8U^vcBGRh?r|*oXF@$%vN{cLzUI+9u5Z43lhqxi|g@~I2k3@Vt@HoWn
zfF~e64R|u*vw^1}?hbqp;&Xr>Ks*pQ|J)+#9Bw%ucoEV^0IxuNIq++UuLNF;_*&rP
z0cLCv<{HwXpNOaM+Z}$-%V?Z*u)~h~WM39=`i@+x-wSqxc1@{BbO`i;%(zVU3V!Jz
za_0B{(esZM;o4g-q%WiPk^TbMcR>0pz|9c933dek{Ym#8=m#SGW6)>w%Rl;h;HUl|
ze(ep%`9~ljF3s8f7w;g34-&)m#c)?KoIKL#U+IR4;Ty&9#bS7}7*6JJ|4R3e7=B6&
zFBijai{Z6m_**gjix@7&&E@`;e;F~ns~Fx(3@7i(`<Hz!F?=+~J2Np%p*`A*(FgN-
z?m6TT_<1?EzLMwkY)~ZP=hz%i7h{LKyQwq(wiUq;KbPiK&+%MAfZTt6&dV*Ih_Ulh
z443An4*&8)FELzO47U=)UB&QaVtAq$F8a^=;JByCs=NJ#oVaJUst39Rg{W)%y^lOp
zR^2B!$mL%<;gt_!_mjv@0YOgOyBfr5xP2aOA>7Ljs6u_biH3;#H=O*_CjWHEKklV>
z<4s18f4bx!_wF~2@laEXU+1Nx_*Fi>CT~Dfh|EXS<YQ{`8ZADm79UlMkE+EhwfI<C
zyk3jfYw<~G@v*dd%i4TgZ9c9xA6J`?t1V=ikE_kc)#l@B^Ko_fxH^1X9U;qtWq}JN
z<>L<L_YN00Z+STXUq`UR#~Lo!;Zqqd#2qejvKT+n*l4`dM04}WX7*0@M#kgKoJ3sp
zI(hiJac`jzs@E+vD2RJfu2Ts2^1EP9kDy>D7kBsn);xK*u0Z%I4Dtx{^>K6IUZ24|
zXV{5*+%KtAH|}Z6As!;`5e6P2C+;P9E^c$3+`Q*Hkw^53$U8&+Ym%lWyrhD>DTKT@
z&%?!!dktOy_s?DA<{J>~AtG<I;EeeNl5|9&!M+|Ift-DhpdkMMC+;PFF62EMA`&$y
zC?H7W#<iUQ-(V;HeSRYH0BB;Gdv^tAe?buU1`9537<r`#xAYZONZz<s$BW65v&B6M
z*@?Sq<;ThRTo8<V4(TT3iPK{J;u{b!H#G2{@&1PJT1GyfT(|TUGV!;LJg)g~%0D35
ziPTLn$-Xb=>>$73P(SXu(BV$pdqo05gWNovLIU`A6H*tEw;FPBg1G;jU;KW%j_3Z|
z%OeHMmz%G4Z<k=MM#&oz|J4|v{{P7T+e&==gSodI3Rx$Ga0=#{4VSf0Ukbzgx%%`H
zYUy`lgprw^ACWURJMP0hT8$5LU_a)I8BSi?L-mQkxx=NXC&TvwCwA-^eu?1@45#NQ
zL_dY$QgA#Yd@94qbutnNC+9viKYIw|0^w}A4)Ijr)46r3KgV!#Zb<n9;G|sStdw#Q
zlOMKR<mDG6kaTBqAFA)iaFS=r!+{g~<Q$gr7)I~N@Ewf455r5v==p1hoQ~v&yxxu4
z*CGjWfp918L%ANqof$q3I9ZUZ3sgUa(Yr9*li_TA8FCsDNV=}vhuRU>-Xe&Y3&flv
z_o4bYZk+^ThxPvko(i0;U$z~(aT;ppKBH&zN!knv#J)TCq54e(asm4-Rlq!V=GLix
zCvcMgehe3`iwJgDzr6%KvG2j?zcHMxFG&eu2hlroADV6_;3QoohST$RqG!`JWc1`J
z9knBzrwaZjmn|vZ$mrWKd^>PrpY^9Hw@m`!tUpO#Ac1gC?nCXbAdm}$v;B7)Plf#S
z=hms7&Qpn=Z4XC4Pq-JOe*&ENN15SofD^qp!-eZ5Lb`1j-jgXWJ6_S>T@d>!jGnv$
zk_4Pj1BUx>`)RqBGMvr7a9%FhVcSCnqjzTPkazEqK=MPb>QVdjIs?g%3&XE6c3As&
z8Sc#JUoiFuFr0qJfbBOkcGz|@nu|*U(a+^RG@qpGBoNNF2XXCW3$GUR>~ZQ4aN-9w
z?nCWYFnYHAu>FxePJLkXY`xR#UBo`gE44q8DX$B|X}=>{)(>QiC4q3(5A=E|u`k7a
zsC`#%odm)MaUaS_8zzC+VbfLTsleHB(um>gagg|g1Y&<M_o4PlpCy6VXZ^N_rvmrq
z)~Vi{;cU6cv55p?Cy@J4{VD>vK++w;eJD>MkPA57{Q~CsJZ_!p={P{_3}tvFqi6Gf
zjp3|+8X3-(i;mC4KJhJ0mwy&Ew@vcN`k#)&L_dtt50c<ExPZ&02b}0NxDT~&DMmko
z(Q7h#H!=EPMz6)_7m3l+>tiH8+KgVfj`(-}h3kJpJ?b!e;rgGT4`TRnCO@Rj)A9<}
z^ZvGfhtZE<^beW*v-Y1cdR<2UnbEWDp(QCO7sz5H_o4Y|2b|OwYrhMlAI0dE89i%X
zo6+kr`caIYwQtDi$(Tv=Gl|i&_UAKteMTR_=vn(wjD8HG-^A!y`}-LESVo`E=vn)P
zjNX9JS2B9m{!NAlGx|D)v;Cc1w<Ccp47m^W4?k#f+qi$VC4(vO5N=8J{TR-sYshdr
zMn45ON!N(s9*mwXR{+D=bXPE(O*ft4Y`RB*lXQ)lbk8z+Hr>k%XVZPd*kR`_-xxh>
zXNWYH7#D~?+2dmnaFQPr?nC_<#^_xbzMSFg_`ja9W6J2$7(JVxd`54^=ueB$*D#zt
z{_1dXNg(B7{m&l1Sig}u5(z{f%6({g7Zb<@!r9~9CY}oIlh~yCEZ{`X`sWJ69T|Nc
zaN_4K3~vGB7~vKSXXmS|efIp6wNJnQBKeum*vSR^gfC!t6O*nb!(~WDxPZ&mpWy-A
ze(DDU;ACONaC*K;xHZH57&~ma;us#r=!=1q#W;pvWAv<@7mR*9qo?<fkaDr@kbDn7
z0^xq#hn8y?)4wJ#+=9`w={hppm(i1#NRU9XWy5`_{Uk=u+S$kG+58`4^lbj`GWs@*
zee${_5=gqexerZuGQ%e_oLomIf%t*V&lW~+%k86fa>VEh7|zz?SB8f(c5GX48(bji
zvi+Ke+&_~4&fKT3gh0T|Zyo~WZ!PTp&DDUnLtGl{bVU3Vw41Jo)AJu{zb&`F8)(R)
zJ**Sno%<+~O5g&?GYN$E;MatIa<EQ084F0D8p7qdPcea9P!$%u9R*k?3o<t*fu{Qi
zgyfh`0_9VB3ftDg;x~7MLQFz@B{?bN0vTIKpmqxT2-{?AB!O}r$W)MkfAbdLhb4#`
zLb_3iOUejfJ>u=aF^PybLB(buuG>oh^!$S6vn^C$A<{qXCxCN^$B~077p@A6-{q2l
zd_F+j4Q};#iFh@%t51kaK|`R|g=jt<paIH4JEdG6>XDw0P(Ba*sfP4t!2iPi8h`5R
zU?(9X^n8}u$$)-11=(2(`FBOU8SMBYK3hq!PtQlF{SM&IRY+d}{d6<pkx;+%Ix4l3
z4)wba={G|@3lR_PFXX2jaZj*w9r0dJFSUp(kWR@3a$f)mG(XFrJ<xH2^0(m6wvaE%
zZ$mvQAU+e)RYhD;R!C0=aWg2FG2%;LK(R%9FZAEph}S^B@I`!zkgRAS;>F6sj+KbN
zfczvP9;GDcGZEha;|#fvfCTCvYw#}}k15ZDc2b4(n&7v4h<AYUzC^qw^iz7?LG8<d
zz9pnXd2it4z5q6#%D|Nn?+ook1938kAi)6fd(cnmyn?111LNvsq%VL2mowsFQ15<-
zAAx-CK|BpEToog}0qVCD@nK3r{;weJ0sI!?CSd<H;^Uyc=y?h)?_Ka)D>%SYz7g7g
zSHv4y3Hj-Vcm-^$Bc22OeKg`yFwR&aei_D92gGe5KjeM{5@<fRK{*2u?*(=u5Pt&Y
zU4{57=odQ?{~#nM%0v8Me_=;4;xk}AZ~<|(mV*8k;=Z7Niugw|so}yq#AkpXej;82
z?M;S`e_UK*LJ1~H3W$d)6YJcycf|LSNh=q$5bp>1F+jWq?2ku$Ewq#Ah&zDaJQ0_I
zb{mZN4k0_DNW>MvpTeu#{<Mb^;LjAKKL+DZHsUpqpQDH?f`7^om+U8G=sx0};GgG+
zcTg1cKM)@Q^(Y19pzZl2@HU9sfc*}LdqO|zhWIh?e^10+VE&+l_!yWtt0R6F_(;Uf
zpdXnbz7_Ishj<u_t4@f^!}#EfI6aRDM?4h#umbUNDAz{BJ)nNm5zmKm?L)i*>=z<_
z8vI<2_*rNt*AZ_E`dY*#p&h(ITnXyyJK~XW9BmEzX*+R)`FS_Q9aMz&M(t630?e0&
zA^mVEL9dUv0@Rlk;(g(GHwE!wFmAXZ-VEglM0_szc`@QXFfWQj{3+N^LVN*?gPDlG
zBL(NeLBtziyedI_k02LSB5nu%zm53O0YZd2#9u<ayhl6}j@Q2sPl9<xJ194;FFI~_
zN1TrHs)*C^TpMv&RUw~-h~I;HnSi(i_;Uv0Nzk6X5I2PO5Q=zjNH+@cCg_jr5uXk1
zGYxU57SUeB=Yjq>;@zQNpF=zv#_el}_g55Bc!YRs7?)lnUIO*_4e=(Z$5t?}r1h8u
z<?V|2IyheUL;MMhC+digfqp$2aheZH#CJk}aX|bm<i{29uFxKqAwClP7K?ZvIG)BM
zE(`wOh<G!!pDl>1g5S~*FM)Qo3-R`Fe91*z1M1@t;>u8u7Z5ju^T8{KUxj({O~j{w
zKk0b`t=}+c=TDIS2BiBPaV_wh1Tnw`YR5s5-xRe*d;@Sr#2cVqR1uE^{|rIAyM$n0
z3vvGD7jD-`#HYeIFc$F!XrHEtcLx8DLtGEG-4NdZ?b!$MX)rzqAbtk?7K->K=#PsK
z&jS0)5RU*mv54P>?RdnWgMK68AD}&KLEHn<O+&mG+W9WTpF{oTBJKwL=pf?r;rLR3
zconpVV#Jlf&KbnB;P_sF_)lohR}h~I`K(900{rj>@s}{ZeMCGB`t>)&?IAz(r;B7a
znIbeme{2ckJ>}{!-)oQfUKqzz5MK*?Fyfk!4^70k!1<#t;<9l39)q}Z3of%<AirfL
zf#x#~?9W1+-XG?QxDoUtZ^U;(egY8J13$+iej3_CJmU1a;YP%d!Fad@aeDrlhPcuI
zp`2NWf1~p&#I?b1Wr(}Ocya;pDi}AfAU*}^@fPB~a6a+`@gf+<8WFdFcK8GFV~`&@
zf2Z|00_s;Dj$@QtKz~<8d=vOz6LETdc`V{{!9U{>zYpidGZ0UMe(H_*Lb#4SAMr4l
z=SL$x4f@dr#MR+Al8$%`_+dZdZDBrNggEu@1;jr<eceX<In?_z#K*w+@DcF}Xt$Ek
z?r6Ozf&V)qJ`KjtK8TNkab^hORWM)DL;Q!({6&_C8$$b>g18jeaYtMp{2zpPdl*+E
z5m$lnVJ+gdke^h<yF&ZkgZLQm!!g7^L3=)j_%bNhb;MgiKYEP#U>KJg5vS$+iFgF~
zza6wYT92l1{Oy4_f72*eW;Mj0Lw@M>6>4V&<i`~0t%-mOc8J$Ndv-?rJJ|O}{G_B{
zCj#;LP+xI~=R!YCM%)n6%|d)1Y#&B^4vcT5h@XZ2as}}|(5@aJo&x!7K-^eSDAzZ{
zv!VW4L;X-cpM>#24)IQqPi4esLjR@nVru6T%v%hRelzH85U+;g(JaIRAU|^uj{*OO
zA#MlTD-f@Oac2|a^g40|;x{4PJjA`hk0prvL%m!?d>z!|UBs_LJFG`M2J-m{@ipL2
zX_$vnKNo->IwRg5;wvKl2HJ@_;_skd^bubG+#2!QF#b$K{2+|mo`~OtaVZ4xJz#%1
z;`Dm!I>bw19N3O{YnWf{MSMCOrwS4O1^GXZ_zr02HxXY7^NOd4?}zim_lO^d_8@}e
z1Ff%Gs7G1ECj;+=_)Zv41|ePr{dy$gtD#+)BYqmnYmfL>$iFM%c`%*_BJM{D!i6P>
zKZW_p8pK<H-%=3QhjyEdcrqNPjv{UY$H6khPbu=*5nV-mEBNyf;$valdxQ8c82{<_
z^R&KhQXSZ%{5Z5{1;o9C?1%;+t_b~F6Y<H=ZVeEp`U!|1hI!*m#CyQ}GXU`w(7%=-
zZVPte5dQ#nk`S+i@i`N52WTe;5%-7sEkT@qpHzu>9pv*i;-=uYI>dFs|L+ms4CC7`
z#C4#Zw1fUZ>#+-5f9Q_*a_D!eh}%mD6|9Z86Z8vuJ(b#D4*r>d^dn)sa7Mf%9Cv&X
zuYq<IjyN=DQ7q#3p&ru_r{BBnL!5qZTZlOQUbq}_`u#6Gj?wbc?~C6c{Vy1YKO&wE
z<HI+^3!uCb(2l5m`aF^Lh`)yR+yimio(CXK`<D*l^>Ds60r3hLCubnO7t-}Y{1>#J
z5X5&wKU#+PDbTM)d<wMBt%$FObh8o9gm!)u@xgFhD?@xJwCAgcABOSv5#qfeKW`9E
zrQ;{!BWS(CI7jQz0Q{+dcz+_`f-2%ou&smm7ij0kh-*N*vPJwm%*SRUJ_hpdi+CUC
zj|&m^ZYkt*CF1ltd?Mnp(BCr=kAvgOA;jCkJn9tUTfsk7h;Iiw_Yfz~yCC5u;_A@e
zz93HTcWDXZ7Ok&KP_JDP?*sD+CB!YEel-w(2kn0>;)8^2ipC=zO#2<;XJO!rL;ODY
zc^%@vfF~hN-ygaY@e^>qPv=3@4?f_pVx*_z%mu`)q2E14oZh$d4)HP=e|{p)-=NF+
zNCw7HnxDmxA9|l1<;$U8t04V7IG$=Dt^)nS0P%N_pYe!W!u*!buW7oY6orcPMEWjp
zT__mwdZ^z>#Od{oc*N;-ycEQpU>w+u_;RSn!-(I8^SIN9YlDBP5U2B;8pI=^UDYGL
z80IHUh|~Tl3I3*jvw`;90r7b-F7-luE~GmU@paIzM<8Ae+a`$9`yy-+uY}`^BjVrT
zymAiW!(g0WfcQG-*U^a2hVf)Q;;W%OZ%2F@aTFJF5vRw^V~Eq^IK7TS{TvPL`5Mw^
zLOs<Yo&fFVE#mp0|ABZq95-d49%#DnpuF7?9|6bH0f?K!@oPBZ{xE);AReyByGJw$
zae9A(6XLtU4}OT#`x6!+PVZ+}h4?wBmn6h1Vf@*J_!c;S&&M2&Bc~Cc1pV<c;=7^0
z-$&dU%Jm9y`uozah|_sEJ&w`(Du#MghI~;z0glUq5U0Px)IdB7{G*HbeDH$_;`Dxt
ziHOtV%Php{d6p02^t_3F-$?UM&zqu<-VMf?b%@h>!ZyU|c$ka$VVEx!AT9ypMj7Il
zg=Q<NMx35+K0sU+#>p>;zku=lC*o=_o=C&_CG~?mjL&TmSAqWC3GtuMt_C8m4dcKt
z#B1TWKOFJ%pdXF+EGfYeMu@Kke_9~k9_9x&h|}L~dLkYL>G~qxAIcSkcoQ72!x29X
z^WGT5&%wB~9`R(bza4QuXb-uF4}pG1zt5!g6$1LRNFM{|`BxFQ1HU~)yfyT@2E-#E
zpI;GIgnDTS^AwsN@|-jhx*(nc<GCW@D`31Dinu5EO%HJ!@UsQtwos2Ah|i|=i1-e$
zzZCIXFn?Hscz5VuTM!=v?JW!OIZ$7x5FY^fJd1b^w5vMAt6;ks@#k<orwhzCssB~r
zxG)IuebE1H5s!d;`XUZ)6Rk(Q1ME12cn?Ls+C`Tz2S3*%zFd%tej)xE#-(o19%;FB
zq25O$ejW6)5N`qPKNxXkXva$sPlbMT8u3F=u8W920Ka`gd^qr);3t~@jnIBZAWrWe
z9gp}bsBbsKpTN9oKH^<SLR{F2cs=yHBE;W7JG_PX0`T)o#J|CDu#Y02%<ua^w!r+&
z5OHm&cMrt#q1{Fzego!pNr*>7`=Iqe{aFU}TLgMCt%6g1ZcQY*r^qk(e3C8-ZWBF1
z9J-6>4dV7fbkTdn#{=gd>cp*+{1E#qfJ^riRw!QxybZ(2REwVfc4auRa~|{xh!+Cy
z&2VDJL_*l1#&BY%1Mne;O99tpII$B2?MI*C#Lh&}8zN5AHDfrjL(g|?8BXlPf*pIr
zqkvCmII%MrD#o4R#Lh0zdn3LLco^dJc}5Y4)8~n-0ZyWm_A`h3kg$W%ll;)@=X)7W
z^7D~I<U$_ejlhopC!56nb|U7&RfdzU^^&I|(S3#!eP1}veg{t56@AX~FU0BZ1Erzg
zOK>)b9s2vR?!bv1QZD*jV>P5Vg>)?u_W@3Sr$y{ba-Y{^g$oOiUIp~gh?D2glCS~s
zXyAFkX?cf93i`u{)BGPtcGiKNDn`$i_de2Rg8m2M^!KDa`U~mP^3vyJ4`Dd*a~#+i
zh4?k#7KmF5W<^ejy8@3w{1EW1h+hU?#BfQDb%uJO_xq4dlFwV9uVeIte+1qF#$&3d
z&p}gSII&NEKdi-YVn-d)oy>5eR|M|JaH1a%d<nyeo<3J=CBuo{3-mb*CwdFu`3xs|
z`aHGk3@3W}yrc&VCwlt)i(d>UdOxt=2F{bnCea@S-iP5tzYzFPh7)}ia2tjbeI)Q{
z3@7?0!2K9b^l`u=7*6!xfp23t(I)`k&2XZp<4F<2iJtnQlHo+JMs{+cf#C$Dfqi<v
z71<<u`aOb-D!0J}!ijzl=zB1n=;?FYM>Cx04}ji`;Y3e=PegyGNbS?_#e9%H8S)>;
zaDs}!{w9VK`vsuSVK_k*pg+cNqQ4CKI}9i28t9)eoapa@z7g>kz+1z7ibN-RX({d>
z7X~t%Na^p)M=_k}WkGL__)p+o3@3J~xep2R7*6bHNb^{ffH?g<Y7WE6ly{{d7v(dY
z*jWK~P9aWzr&`N!lAl)KH~M>4>W8ynr=6OR5aC2m+p`?QNxJko<;uY6anK0P`_vgd
zOfh-GHjJJe_v!E9?GU#liF3gjaoRrJ5uXqGAjIi&vgRY62l{Bl8-cGxoc>-tp5bKb
zKb_B|NR-HMa(txow;c>8<)!Us7vk-p{p<%${7?KggZq$B!01W3zC7jn0mF%XRj_jl
zaq^se5*{Hw4fs>UZGpc=JPP<b#1{kqhIkh6pNMmBwB<vqfx?o`Pv~>CWDu_eeOKVr
zKWByLqTY<2_-7UHF$^dEc?))o5PuHb8u4DxFKiH}zk7E^d^+ge5jO(vhxj?*^AM-^
zr7vVSDOVPhE0*D;T;IUXYQ(<)--LLl7J{K<#9IO12Auj?g{*L458^RkzntM@yvhcB
zHN#1J{sH=*h+ikhxgax0SkiRq^M%wHPP%9y^iwT{6Z;*2Ph>dBk2B<FI>U*60O(^8
zr{9ZZGMw1?0(SN@oY<kyW2r>^7TB+6I6?Hd{GQ>&4t@Sbm%-cy7f5nMZw7XHGn_9k
zv|Ag*#{r+qaQ-*~`443{vEu^zG{m<8FJd^!3O!#q$8ch&2=vbx&gTCe!-@U@=;eoS
z8(bjSBb+{uMgw?Tj*)i09NMQ2;`I0bqmZ3cD6cu<bpGRlxEq%S3E_w@6R>DK;(LJa
zXE@(ZfFENxDc3$||92Qp^rt}ogyBSgg7z20M}l5vsIWr)W(`~car*ucRp7**<Txb<
z*PXl&w`wOC3P$`6w8N!{)8pM5#HpPW#CL)H8pPpiUeR;Jsr?U#d%*QI{-Lp4mT9@@
z_ag1og>q1C0`tNih}*zCNf|itCro8{1E!3gw8PEN4lNN+06qorLf|tHr{8CJBYq$B
zzKGuez7X;6z?UH21U!o2q~58Y*D{=xi{8Jt0r4I!c{hlX7*6ca>p2+=Cw7cLpM|&q
z@LYxyI}hNx@ll2oJGP)NM4WzqagyQ04!s_Cf#JjseXc|m;*Mbd8gN?gT3j3wULtNL
zU{UK~!V1;T0X~r7q^sNnK8oR_T`dJZ88~g9UL><z2tfP<nRIg@0&#j@=r+V@z2qQ%
z1IF7Uh(CjVeHwAIRzkW}h|ldO@H@bXA7ll@|Np}1Ns&Up&&`O_=XywJ2$88DXnET*
zoY=_(JF<wU0Pn(Z(jKUPdNG{XxdwVg#4iI^VK}iPNB(hvd%F-HNIr?3CeUjk{tCDO
z;zPlo+^d8BV@CzJCBsRQv>xpkPSSM%{S?F}1E0xoVu#lI9K>n8hapbueL2HPx?W&^
z1>*F%9;<=V_F%xpAz>%ta|JBAfOs762E?}k@2)AVQ2UpF>oL4N#~`}Mf#IZmz5#tO
z;-7)9MqHmH#D!f9C-!MLz;I%pzBjBGIBm}*t%VrR5x0Z>_#W{DB|-lK@k!wS)-XU(
z`*b|-f_MNNANwHw81gd^aeAEPUhTvOYJV~$;Doq8@HvPpK)Rub)BHywPV>JSahlIW
z#A(0Si#W}H0pj$zR2LDa{=bL#Y@zs~=ZMqa_kKV;0{Z(;#NAW{L+!Nx>rZN59&u{F
zKjPHBI^xv6G2$IN3hDVGPU~v{;<Ub&BToGvk2tNzWW>9G-*zHSkMH{tmxJTZam49y
zybN(#@0Ssefd29naa!+h5uXkI`Hncfe^*84zx74^rhz#1+i1kQfFH~er{51wLY(G*
z7UDGj-iYT75E593cnYK&i?|`2M{Gu%-dD35acbu<;?&ML;AD7&A&gJCmeG^rMHGxz
zb%-wl{s!@bz~3XD1N=MU^miz~5WfZb*24vdka3LUM;gYxc8E8Fz8m7|pzn_OAmGCh
z9|wFC;%2~&5vR{fGDqA4^y7e2KTi~jBl1PuANX3tmjOS7cpmU;42Q1B?|H*;Qoq%p
zZ#P0%q4~KBTp4kCop}Vq;Z%f=F$p-Wm*r4i2gDZwpN)7Pa96~$fzL(!8SntaZvqcP
z+_a5Qun5GpfNw@T9rzZ+w*${W{3P%!#18;JfOvP}C@$n9-UfIP;-0`yAwC;;1>y<7
zFCo4f_)Wy~fZs)&-jCXV_yf>4B7PV6PsHhSVI*~haub;x_jwQcR=`O+B<;$X`;agg
z@%;i8*&}`w_*}#<08c=iKA${~;iSJnHxX4aoaBc-Pw6A#^g3!gxPU|RPp@}%NBkTS
za6uJuY3Quni#z#1?Ti3!i1=9G6A+&P+>7A^!R<n#aE6m|%>n&thQrXw=OYU^t*;I;
zJQnRiycO_##K!<HK%CwWb_#JH(3c_Z2K*A@Yk^lIz5@7N#EXDGK%D-5?H%Ivpl?F_
zG4NKS1b<Nf(BC=AAT9yd$2tNh^-KJ0Dnu8JK%9>Mvk_kl`lSpfRX7fKGQ)}eMBoPy
zr^ky+h}VMtA;Vz^<M(_6PRrW|%Jma*IpD4I1cOvhpLZjJIKBV8E8+{mjsoIA!22P-
z2e=C2>A=+yuLZ7!_$}b05toCLMFYg?edf~<r_Y6PL|h;2cp_d1d=BFDxh=uKN&6x7
zVk@{;6v61_IR@DmtzkGBZ!d%Wb%<XAz6J3|z_%fO4|oP}nx83<pK`?OfnO2B8<734
zV80RZ&%nPT-d0vf;0NL@flH1S_S1a6f&6qtJQ;Xz#M6NfLc9RDDZ@#BoB`a1;iSHP
z0-uR^OOi1zcq6U|d^y93{SaQw-6zIyVxL~GC`CL3?0iH#3HTs=!64Zrb~1qLGn}?5
zqMQnx_UnP*=b4E21MZIaRN&r-PXs;>@mS!Yh%W}d1o0x^%Mm{Wd^O^qfF~eMpO2G_
zxLOC|1(7Hfar(TQ{fL`^{t)5@z)v9V3;ZPFuE5VDz8&~Q#1nx(K>QN$$B3T=-pFt=
zo+$C96^UAo5mrd^Anm~t_+a3qJrF&eM~!4S8Go9<zCPmbfSV!vrC{F;>D$Bkz8B(c
zfCq}P6NB`FLB9%d72q2Xw*j7rIDOvD4u%sySU~>s8BY8V3U&$*p9lOD!&y5O3@3Kh
zgZ>iY@xX5)eh~Ow#B+hy0;l!+9`gT*;bi=&1m13}utN1+Vcal5oPO^=4RL3%6Nq>m
z@Fc|d0zbxZlAl80R~Sy(=W*cmh|}NqwSf!TB-_LeJumLUaAJqv*F6|<dY`rl;`F`0
zwuonee;g4%1$+U+Nq*LF9};32PV#dT^qUZW0DK4H^gf3Z3@7$?660K`WH_<UJA+%?
zXE=0GvRCv4I354rLi=e(ybgE^Lq6K?-vuaj61LkQt^m9<;ts&&5FZD;FXGFA_eY#Q
zhiC}mJ3+63_!i(+z=?Z_ANq425?l=V1%ICd;V=yrZ9?2vkcsv%oJ?h=0Y3tq__I6r
zp}%iBj`&cR|CAt3zn>}<!^;t;zh|jLTnDailRS_>$_p;ww;lNZfAd%|yh048_f2E_
zwghkibNYT&%3TGSi1sJS4*{q5lTv<<G<GgD5x@n?{e?|YC)iK<04ZUI2I6agPhxmy
zut65f#PAbh_&dZWfUORY4#^L(PoFzM^F=wGXHG|Y%IWV0sD2sP-;MNVfnPzK-Uro)
zIMw%t>(JCb<ueek0{i8N-v|C3ae7^)a|=O0?GGa>T!=!P-WQa}a2R@c{RuJrff(K_
zhWCT-g-AA7`^Jd(=TjAlCL!($+!^tuz(W}hQ&N7<E-{?Ghl1pX)qfJBS0@(*xPbNa
z{SK6m7i1!Dq|X2z&2VTM{GLN%_yaM#1zfKs>9Tf)Ar6NX(RjpH(0n3J_4N1g#6DCh
zALAgSXF2`-DAt>ilOir)z60?Kf=qM@aa-U$$N<j;YKL+!#HR={(K<1lJ|~>oaR&WE
zq^H*#n-Hhzc9an!5<5^uJQyp6)8Fr6J$>H@=JdG;n7=^wEg=8W{NzLM56RC6;C&em
zuI2Yk5W^RV;kjb?V=-JFj<+QLY`Rkshtnm|2{HT%;?)1OVmN)SHcj^__(29bIp%{H
z4n^T(OcTRbis8j#_-8SEAWRBLe%N%)5vS#)zvHKRHz-#c()$9hLY&U$>GMvhoepG$
z3$h)BCFP~Urf7&5K2Z#xkN6d^vq20$B!)LK9E!qQ>JO7Dl24XT5yPXz@JulrhJSv(
z-4*gq7LXl&{9(siMbMD^u;ZZy!`bn{kl}2<uw^*g9-J8tO^GLg3}^ii$#9xyg4Qt{
ziq4aChO_fA=w5tzNj_m1{5^lC?Sz(@jyIIk_G8J|C*`^V+jO2q^dwz6Zu`N0%Be06
z@w2eK8*zHRT*7d+zA6|_^G?uphO_nckl}27y<|9BUrh{W>x*|Jw~v&It*^EOaDgn?
z`s&7Tw!Rb@&eoR_Z$+r59^Cpw*j7b+HEa(;oX#iJ5g!ccX(1i~oYp&OA0*w&zzvaJ
zQc?hBh<5{SjX3>1AT0;APk*;-kMtwK&UD0$fX_zU3OF4{seN1E-bg<SIBlO)?+!c&
z>FN7Q7a$%2`Uu47@41#Cz8ds&zDCnc1WxOda{7E-+TSVP3;NB-{xRSwh*tnlL!6!u
zW+Gk>`W(cYf$vAW4Rp$U#5)2%hIn`2#fa1Qo0cLz81&_cYXiTCxIXY|#I1qfM4a9)
zSA)1O=pP|Yf1h55_;S#{M0_>yw}{i<m48J1An3m$ejK<I^h>e;#48stoE;C#px(%C
zc0AOD$b_@wp%Zf+%8rLmz$nqP<DnlMXbES>!($9*$3tVt1ktnO;T*^W;p}**$ZeBA
ziouq54NnEmmbaeaY<YEvVJ;9mY<cPLm<eagORpCa&X$*s6NIzn%_D#dWWkn~{{D$@
zw!Gd@7{b}|iqwO{{X$$^xn)R@u=J*DAs%5NB6W9{5EqfUYjChgJt%-|5T&NNCb#L~
z>!MCX>hpd4J)Hbp{9U{}f}8?FL!3f`eANS8f<n04z5kcY)5q6C-6uH6<^Q7N^62a1
zKllGdN=!Nh1Ub3;1pU9rIhluBNI+2dA2CzNk^eLITp^wO0~Y+>H2-tIYpAEEN6`P2
zgt!FH{htCKf8ugda8gI4QiO`)HiWXc1&7d*xO=#UdO7*{dj@bd%dfk*x(0d7hlm35
z4RG`I2@avwKo{iV@AW$cfd%<{{Vn8b%7Yr`nhISd*oohE3-I&v@aLMAe?W+bx`mCy
z(BKdkH?EBQwwHgXdSFmMphr+hIONL1+sQM?#m|FlyZ?VfPtE}8nlN1aHfQ*I?Y}F~
zjeo;_+!|r**g$p~l7IgQIQ{@mLoS8<e~mwci%V?Mc@?+H2SZrW>xZz(Ysoszhas%v
z@?RkX0~hFhhr-r>#}>lK*V$yqHsn5Rxa}!yodP(FTas~-l$8VpVIlJ3mLxAY{YT&s
zdVdti|1-7`=E{Bkm3}fY%!NECC`q4;$2k22j{Pfr`a7vwZa*8?v6b*R?(?toEq#Po
z*}_6Z(kJ6SPQQ?2|4QGGWR?r`J^*3sZ~q_RcKj>-Mo6Dt&nM}VOFlUL7aaRn`i)cw
z?SPZ<0hj+NNB@<+;aova=ielKaxO^C()#bjB~H@E?YEIkIJuyV(x>rB91_TNYO;>o
zk0P9S()%%ZG4~JWUy+Oaul#$%1idvRMDkDK()4Nmt;D1s2nX$OnlLPJ`Xqn<N<YwF
zh~NzINc!YBjnnrLlYS$lpAGTp0;lgTCjBdrei%d~>67aiIQ=zZ(ogRoM5NEP05gC2
zKUPfomH|SHY^Ye0z8v?#>F*Phek92(7wGSFg{{BqpZu==U;b|l6=K|mafqZ(>Kvzk
z1JXy$RCK+&5TCXaVM|Dhu9M{zG3lR&hO-XDBz<yTjMKjl>HlXA$LSg&eO%u(K3%?r
z_`eN9dVFHs`hMbcCeU~ky%dxGX$u9#N*D)7{(EyD8lU=wJP(Nb`?G_rb0JSdSehWm
z()hw&Zf?x&|5yAkFrc`?I7;<6ej6_Szv}-{oe<*`8ML`T@~_B!XndOg{$kR1*5kxn
zuoV`+|I_#s^bwPO`ddN4jz3BqqVZ|^x?<ALgY*y4gkVYIQ>-N>{p?0T!5%-AIYi^r
z^v8=ypWa6&i3VmGpQdjiCjDve1qFS-3h}?{KhmED>C^WSQ@epi!rFljln6_jKHp|I
zM4qEe)^U8rNrK*+3Wd$z<)=89#)tiMvC>XhQ=<TuG#*_>Kzt+<<w1PRX*|l;aPdhK
z=NA77G(L2r-}`9!DaeHMar{S+KK(wL>T&!uF5<uXkN0OG1~enS{|x02jZfPTDGyGY
z#LSyQ{&UYIA(Iv^kaCbJ!SPA=#B*m3i4<MQf05`A$s7}~|HwJ<zv55(B1GDcGKb?2
z)6r05gQo5Xjp3uTwY4~`rK34QOIP@>si84KM@LanTW7=wZoviTwoA>%n@dXku_z%L
zD~x4Ke#xr$l0U$ZUo{jdb63zEELSy6wp{hyGOD3<d2GARLQA$>b?a9*qOx4|&~lZT
zhUKbr!ge7^$uj0tNbA*>?M7L)UfjVls;u>@D>EI>cy{P(N+P`B;y`3>m*!P|C!Zp3
zaP@o*%a~6g@+3i!apt6cS+*vY&YS_IxsSh#uOc~3Rpd^lJ$&YSxGQ=F1^6j02>3s&
zy$L*3&mZ`GZBgV(WQn?jB!pxw*<GT@l6~K^WlLI+EumGB=!<O8Mo7uNgh~?0(k78D
zlF<H~xpz+A`<-9?pa1K5J@az!IrBcB`OM5`)^psM6S&tckR%!;Nec1|2@dx1^B}qU
z@As3Y2Hfoy9O&hSJv;CqxjRvA!b#x9lp59rd(z<J??DQ33k-D&6c5@!atg*Yk))+z
zXlyPRq=FF@QCAz$AUhS3Mi3?&?B(xAS}z*39#e_k5W7la^GaRH87bHwOCBXgxBvV2
zen*BSnVhJL*`qF4QNuz%;U`uSpD<hh*EZ195dyMxz(h70_Koh+#I-S$49nIvQth5t
zbqp&Tszqb#BA${HO*zQPTYwN2u9hN<)eLCzgqMa13)J&UP^1%i1k#~HBtr0k05{UM
zZ6smJ(-&w#VUm~_NgOi`^gH-r_stY3(I8>M1_CW6_&S9-P|GNYpsiz}W4O!MNN1-R
z;XjXaU<hd!g1eL&&_*x|^uli7T}h&@u!MuCMJ5_VO*#Ipu}8zgkeV$Ga}6`|YLI$L
z1&*4m<N)<AScGJl>?307YM3Y@Dvn(>Ovn`}#4Z^oyNU!DCX7N8P?cbQ%sltCMT|iV
z;KUM~K$*lUpc4;(36T@DMOY@b{%il(DRQErh%u&yoJ?sk`b3>)zwItNg)74J-dD$T
zffA=EB_{@puoxzcQw3t{Lds#N-zk)x|9whMxKEV>@gy|kO8-wKoOqCfoM<LO!WtwL
z$C56NRW)KvB-S61leI+*L2i^Lf{1I?F+ZiMkQ1h%G*%}~Kvn$Rn4tisQwfv8G6O8H
zpU{Mv%n;;@8V<{qA=bQCX<%|}<V1BA4J-~e<p$!(c98eq>M=PIIq{H)IG(s>khIv4
zU%!6QV0aN)49_?vy??f1@LFJ3%R~!~*shR)L|qoFDRlpib)xMQc1}*DWEGDX&v0T4
zrIxsoH!@PH4KWt%Z%K}70#(4qPQzBiPQzZq0rqqH(OX3b#27nFM0Q^GmyYbO-)RMP
zO&{+tft?+Jow3HKE#e8zcwzd194I2JoPtGoslhR;yJ;k1bxeE1qJ}DFxg!=p#F3mB
zNa;3P$q8m6GWv;IMeyh_FIIVOk`wR#r~Ur}g9VFtVl7?c7py-M@x--}ptOEB{|O1$
ze^4c<YJXn^NyCzlcj&)U`&$5uyXm(_KaovDJK-zVpkQS|x}CA_KYsm!<HY}|dm3Z>
ziPZy2b0Q~#89!D%DG$gElPS048kIH_MwOt(WkRN2GbSgh%GTk5RjDV`Z=eWuf9jST
zunyh#cPB;-0V+FiHNw;*?hnhzyTBT3*35T*)P4Ug#j1mfRTq2X?kT+CUZWWnOS)mK
zez`Dazmg_P>$+JB`x5%(PH(fKVJ_|s{gIZ10oG*|#@l>1^cxhLUtL2yZfU@(Q+%dk
zccJsxp<mNg`~6AEzPqNCFR0e~*IfAGK63HPh@ZW<NqYgC>DVa0fo4(k`s6byYc9O|
z`fhE}SvAG+n4gDM8b6sRNR1GCmu%L)|5EzH_}z!*#wR|%s0kKT9NF;bIayT9K+{KC
zym@+VgfHVZ>oWb*3&9=Is?!50RZrR?HgCG{sw-jEEkB}2%0Q6kU}ML(%`P@m_pHue
z^cFw2^NWkuujl7-;*ZrxFQ&TOi`?P0o}Bt-hkDE#he)MHH}wWrm*vJA&eof?q%@e-
z4?7jP&dQq0=E<3F{&K-Ptt)Br?A^C2`B|qASetG;>sI&kouNtoIYYj<5cS&CX@N<W
zw~i>vH7Cz0f31$%&?~dO%h%6ULZ)kbZ+BDoBXWd(t>Wg-Te?n6ELh~r<*&*=Vt6p^
z>*gsBen-an@db^14WCh={Q9^9RtpQI<ILYfd5gJr4eaZ(%F9fniz<+zD>bNkvRnJh
zg4g_0{?SvLI|;8%t;vbYo$l(z@D**(7`kBVy;SOXN1OEfwOQuOO|4@L)z8N7@fZnh
zIh9ZPO!_SRS;$CdT+chaPwRD5RN!OvlVL7d!gqBO6wfb-yENO{N#A%>QQ}}m)EoD%
z)eP&d8s3;njyg@4Z&7!%zaAIEUwKnQl)l(dV(3hdker?4^7MJ@Vl&6+{n2Z#Uisc#
z5|OAUsn6Kb5jbu?S}`0xxBk3Y_V$wDI9~IFjS<<se2=9bD_=_*wYaMD>BH`*@wDP|
zOJ#e*#B%ic9_Ky};yoF0{m4g7L&4#1zs?i92wogsELURXljH@x7`?c>3|H;V9*x{q
z8RjT!B)Iynh^G5e$#-LJmLr#Lyt^0ZZM?PfR9DenZT&+$_t^Vx#HDXNQ?2@1{Oa<I
zo7~StZ%u6WtU3L|x+N&ILiS+FbqlrW4psBlmt;Z;1o>Qe1(u%A9UhDBOTXn^vn;gb
zPR`ZlPv?sqd3^LuZ(KSeAzZ)nw7=5v17aIHY*h9zed=3r$3la@=eXq#cf~?Sp-3KS
z%M=4G1DW8@_MKwq<bpq$KH$E`x;9U8s^P)d*82JnYf3rXMUsrye>!67z9nVt);D2J
zg`~7WVs?Y$Y%sfMmuLU;BxBjgM=a+E*olWapVl6E<N8i1^0$&R*{WH`v$>2Pb*^0A
z?P#G{O$f0KT%L6)dy}KG7GG9W_V%pPPK2xkCl1HWTFQ<awV1MEomd=+jpdO)*cu7U
zd~poyvPlF1r$R;nH(n;C78(A4Gfr%;B^yJ8j#|VO8CqXTT=IHJq+D9dzD2IP34%KB
zN3O<~xepru%nZNw!%QlA+4on0fxDFMyvVQAy6p6$^SikC8pj{vTllVCTgwo3--?-T
za`m%a1fe({!ld}KU33@Nwlm!9wcO4;yjdXdK<Q^zb)L9X!sM=J4<cW(=@BMvpWUEi
z;5)+Lxa*cZ6PrtzV4a^wH63qb09T!wXZ6y`gf~(I)!fetj&h9$-|YHa9QQ^kvihkC
zo#S+w8sX-C>-BV#na?&54i<#)*S+-0q{EO0K=Fk6of9q?|GX5)Gh^~U*JN#L#$=c=
z86Ml0UWcRVOZHo*5~epFTI#r`T$<r$OjS%CTc?#+^q7kn(R8C}QPhb|OOAbC^6ng+
z44s%3KdFI(v58MJk};Y|+>M2yomV(=S)6#*8KEVG&aDKq&8~Fbyrpy@Y|4@0aY|T;
ztXGeI>G(LEQ}Nn9JFQ<k28Z81Pajt1DYLQM@~zfKV_a=`jHh(M@8HcBcXPhvdL&%q
z`|!#6es!4D_N{fFEXg}#wMu5B+{LxnkIras<`Zc+`*2u;<C2dU@#qZKW<J>l(?`RH
z)wVv$ok^+F;J&V*FWex%ZEwM)N4v9ao?gD&E0@i8;q7Me0J%rQ)sph7ubC}<L}$+W
zVoA}8bk@}qG2@rN1xI|=ygh2vyG@eEI!(iExn^Qc@KS#+Yc_9AYx;i4GA@_r5@l@N
z!e#VjdY+=5wVe{38reNrTAF*+^<wx-TT3r%?llQD^b~xb+xgX&|A|$0vTR_dMfQ!+
zQ@0L_b;o?UCmy{0{h3Y%0p=V-Vjzj5KSSqZ1DE#_otQQC8@PDFxl%a7*~}!$xXr}o
z!WL7Gn6vmYm@nIwa8UbP=l+M*+iJYCR~aXFvKwc1?zFVqH21=`pFS}*)Z^LHyR1|C
z>mDu1_TUIy9Xo$CJ!U>if%OMrn-6zCv0r*lvQX#!0kzw)O6?zbhGf3o>!ee=AFEWc
zhBJJ{Tq%cM?>bEZdxw=ni{WO+7$yfa<G*zC426BG;b0y-t64i7?eKojp&8cd2Ig9h
z`y&=Y>>d9s-4|RV-t^|nnNI({$IgZV*QzxIt{VxlKM~4)^)XZH*t*bsj`+#SPSrzG
z9O0?cf|}DGo3-96z1kYHbH?1_J%e#<=kym5&aVs(8)J5Utk!&g((;ja_EYiV6)Ftr
zLc!-ZRcWrB_1*J+Q>U%;oUCVF=Xy~tM*bKzojz-!nw9d)%7q0Km;T^RzZk2=;JZTQ
z@e!%us7)kIo-aov=a?KcVx&u^TZYf*)48&|6CT^YT1@a=C2#JHEdlMU*WT`kZY#UA
zA@_S9-@IE$>5(tn_b9wPFZAm8>0{;1CrnPu=&nD-E@O2~j8nCs=jypzJcZ;q8>!76
z`f-Bo!d3)!%hNuDSDNdT2{rb*Ly;0Eil3yN>)WTD?0&G&MY}u9K;G|q$N5W_GfN9|
z)aml09~~1@I%fUAqR_KsW1Q{|B_FxqB{vU0ktWpe>Q$w;-MH?#A@WA;6MF$!zORdI
zY2H_D$~LK;EB>M-Y`r91viqdVl}`1Po~6s_A93>wj9gs#v~%#_t+DYYdC62~v*^xN
zfgIiJc7fx*Mw*wMwJ*lD#Jow+?2WEqHP5bHmAzX1V2oeP$dT-Q;;Q1ooA1q?>Xgb_
zr}<VxFSbbIevDY;&Sgf7ncV4&-rVW!>o0W%t9^`dZ{=C_)bLA_bJ00}$$YEX)6McW
zHKl1I&;PMnd|hy%<*{GtxroGS)gjr5Ed#HdoqCr`pZ{>TzFGMCYFkO~cK^dO8r_9k
z^HzU+5`KlmnD~9J_-$%MN<`^Mj?H1SYSMkX;fc5V+P}G-sXW@Q|D^Y9Zm&d=Nb}JX
zUv6`78?6&uHX^~(b!SP_Mqk-<>7fSohjm2tlg2`Bm9Ms*v{OCh7NbAsvzlp*L(6vJ
zS+4E3H8~!HCo-mp|B4Pz(aJvWo?Fp>yvBm-Qty~d{|mKrjt>%-2kSa#-&RPs$6fZ(
zO%r)9y7xUtSC;k{y{31bjcl&x;#*s+s|NSC%PP!_l~%H81Rs2Ns=aaF!A@SgQq2HO
zR_^kw)nBbx%1c+K-QaoaYq4puP-o_ZUHt;P_f&|*^qQo}#LDWs!*(^BvVsTqrJj2-
zsPKW)HrBd#xc}O0LrKUFz30xWhPQ5wWh}GOA^JA?>#j~LOk!ugG#<cnY5W^G$#rGh
zj~nj;-amen^3z56Kv~K+fxO|!pdGJA;sw2U3@SDpi2FEtMy{gPCRcEdz1;Wx;XCaI
z?rI*GyppROa(9ZoeA|gF=hkbqtxWUP^U4k{O(v+QE}ESxSS_j=UFLXcq{XVv?s@&C
zk+bFNMmD}3JH&sk;ERt`(OQGiUpzCL&#+aj_3?QddHas~l@A`l8e__PyykTj!#MTD
z*+mPZ7xvx?vh8Y*QQ!5#HngPJ)od-#>r-+H2dhqYH*`ttzZLYvXRq%^PFLw??uwPi
zZz<k=y^(l_WcPCQr<C!JH>KZ~7_E1zTKveV^Qw2Yb48if#_*&K8yudFxn_!mv_%N?
zybZr|LNlcF_JLi#MfcNQ`}$omGAi1&ulVVm{r1-O(`QUCTKwz@RM}Qlv2Oj3H&d-`
zZ3V{;HFLXP51P9n_w30*(}e}H>QvWG)rW!pd3{xhenO92c*fm5j|#lY43}$UN;|7y
z;FtD3E}iR>#Yx$18w@&L77Fl8=9wGJYptJOq*n+H8F+cd;8Fi96H`ah@Ic^krYW<g
z6oDtEXMCdA|C!cj-D?-9Qe?k>*tg36l~rM!gio#R#XJM9<9fc$!g*J#a!!~0y0Stg
zW3=*IQfaQyuKRZB!Hci<gnfSR*<9=Jy#Dz59`T%e9nYL4K2J{VSLJHX-W)q`w*KAa
z@<GX=k&DDG@%0WSx6JmYRLY;3Hw~T)Q|u5Q5BnfKcwO>tf4WOQpF;V%f>X7{g33l6
z#X5pUCtL<T4d1xD!9(79NoD}k{=$|OT+GW>6}4P^FYq{LXnCb0SI3@(A;-9+2$K!A
zIcw?;yjs~{^!-)9mL<tM8?UuIf3$qp>g2f5Vy}?yR?FSWr?P(S9hm33Zc=`LYh>Bj
zufw-EI6Hj=ziNiEA7LMQxoUW-yg8#sHZ;HNIIBy^xMAkPQT-1b!L|32r}ieU_|d`^
zq*wcJi?`t;vD7R@(ae$J3D$t1GX;;tKG;nP?3nuJTA6rAv!K-RTOY@c1)tDR;S>o>
z9az?UVk*LY;6c2D)4?xu^FC|4T0#qI-9J43lp?FsX2yM|z&q-xAd}DwyC>&faF>s<
zE5_%1U3y(Ccy!zBK&H~&%7>dumZx=w>h`AE9+vFCbxSj}>}7Q5lb#C`8SKB7Z<9PR
zi`~lM_i-!WGhW;umf^d5An>U=+qUDklG`|Mk9Dbhhz-s*YL^mq%<|RjihIy~<DqNh
zKd%|m=+=A@S=^dyr)ot!JaFzr@QD-Jg4%6)m)^75r3Ep`d($n~X5z2@XIs{R_6rOr
z#A6!>s}<*>kMIq7>|NR4!kP3S(EQx1zU5!(d{b`=E_q(z(Y-F+gWElg+dW<Xan=3K
z@che+?*mK(ybb(F-F5ld;!pbD`AE9iXed_6K0I{mdV%jAxr&SOx1@Y8#(r$oHg1ve
zPN!Q);jo^a(f#UinqKwJgogRa7Xoi3QaQOh5-zRGy=S@9b>lXP48Kjau}-f_OFXu|
zin_f@>FQFt52K$W{#iJBIsIm7YRI_K562kgsu`&j4_`I~);C7kyxzCrk@@jGcKv>K
zpKDa3){mdhk5*Z^f2~A5-Oir=M7=w#+nzCQy<#GMVY|qIBCj^?$9IFz@Ctrj`1YV|
zhm8RL)Tv0OV2d@HY+FZFT@JQPT%@-ju8(TVt$RR6yzohEXjXnu%s!9nh(o*{(>>Yp
z$vZYo4x`QE4JnUpkN-0f`%_F$`O1yHO$Q{jTHj6;xrYqZNfH^4rGC=lzqo5|e|G8^
z&kys6&_jFDFF!E5)ccDrGB&r_l<wZ@C+Y86&(#vOVn5ashpe1t4L!GCC&u`GWB#t`
zHBY&r$IG2|tsS@!mJzbMc5j0*M@Q;lv9y7CjDZH13OBP(a9~h^wE1`0gq;$>Q_t&n
zXLp(`JDT^}I3R%IepmmM2(4Z}&3NHvom9<DOT9T=SO%-AroVmoP+esrqEGf~`zq+m
zF5+gAJ(+Htv*pFIa9y|7(04<1?OTE-=v4J|E_7e888e#LdB&crb%5JoI&Y`l6Q0TW
z=6^m+N0(o%R6qB!*)}V@@DZVreh*t!BjM1R*DEHChM7tZaK2i?WARLRbcjz`E!WVa
z*mu*BM_Fs#uE?mLFN>(1$<w+rmAU5f>+X{HgiE~MbBP;DzT}jsKQf&2O%O{b>U?eD
z^ilKNDQ*zSG$VHFx#kgb%cLZd;aH4<uQQ{(XUx)+ogU<sNpA9!<im^1d{v5N-Ag|?
z$CwtHO8ENdSUa3MC?L#uVB=B!mltz&#V2A)cZw^&cx2V?b!dC<j9${w)8Z2ITT4WA
zLJog24>$C8tdF<clpAR3{gUI6VxL#V{)1C8VHX;dkBr;COk4NLxuEAIS9w$-*R$Qt
z)!j>p2l(H%{G@XdcVqqCZXGG5_isB6%Sd!`baZqk(6KLZJ=GDpjO)o_rstv6tCn0P
z5ZngoDiQe<#2=P%u?}<Xb@g?G{Om}kW0o<Ui<6Rrfsz(ItvU3P^lp;OY5bN}7B`PL
zxjDwS9TU2uT-P*v)Qfeqrkr5M?wDIDd~Y6Z6JR4G)GdAXZ@MJ^(7)8~dTPQEvG8&s
z=$=JZ!)>PJVuy@)Z3~y0tkh~YDs$F!&e2(U-$Ly2DrZ~6@gZ01hGF%gA>p&p>1G*8
z^*tK<qa)}pC+^?F)miiANOjfY7vBa|&nYqUyigq#Sn-2@&2F7>D@V@jk3Y(fv964F
zapjRXdVKgsRYb}3hr|ei?LU^ar3?g8>Zgch4I=fa>bB~4nI3O4aV;X*v=n|?nwi?U
z#Z^*&P~*h?sEK3YrVQJPJ^1KfO&EOPolRBWeD2}d&Vb5h<tsa7Nu)x9pJ#H{Hn%a!
zu69fi<5Uq#AMrk1wEa%>yI|9HzbPRz_4vp@g|y?(_H~X~^WEvq*=M1twzbGbH|eI-
z@*6FFJbG#0>mq*Gb1XG8PBA_e_vXmTLwa*>`^CN&KOb7cv*Ok2b?d_)4)#p?zC5L`
zR@f#Yw_)$V`L9MH#k?PQ{p21cbGcX-@qM=_7_xlVY&U!@CD)YsK)E~9uZF-$XXB-v
z<f|?sgPsrMm&SWF7*`6Dby9rJ+ttna4)nL`r5qt0Bt_lnR+|0JwJv}4dA_E#GSx9A
z`9)7QCP>LPEb9wz;M4r6ylm*XVTokw#Eid89(lRpw(bp|i>_}f`ml{$x@!0-M`hg7
zw;FX8uWyICMP)8ZnNEHYWQ#j+SmU(94liqY<C>%^chovd`WmmVuIPHKGA5CeK4rhU
zV!Jx8V)*_5lfC_g;tLgrbH6jST{V8)yQSQh@#>N3IfdEs-pdaY_kLXeKrZI^;}c;v
zN9s>)ePDC;=6tT7?o*|{o9_9V1Gl~xzdC4b|A1PN@qP?{S19fe%ZRla2pmx2Y%W-2
z-df();nTBqSfhkjZ>81j_?ZVQmkDbumGx(hJX7sZTd<n2q3x27xkPCg9si4hUH|w^
zeJ$;_2(8|fc{{%^@v>LhRrAa9mG(u0x94>(S$~VU(QX~o-LP?CIM+YV)c%3itI4Sy
z_beq$$265bIY?Cp*jsH1?71?y$a7~pT(9@u*>a2Px5Mx4;aw29sy5!D`muNaokJ;~
z-pxLkH+k>zR<t@cRdrybU%78AKe9w_`}^<ujI0ejUi>$vOw1cDT0eNIp?Ky|q<LUP
zOq-t6M}^S&BJYLSPL;{Ukc!q}S2c&1MhdsyX{t#UTzFU$amlCmVqdS}k-?XT+Z1j!
zSDz}KylC5gvxfN7;E0@2U%Td>{)qsG5IeV<=e#by&#p*#8SL}8jejwqAY+xN?RvX`
zfeiW?$!hcDjbrt8$Ikc{^XA^Wrurnb|9I)tzO;WHmwFEr)SUfhZ<SHz{U-Hnk%YcG
zV?p9SU+>(S$<A+nJ+t%6clGJecFQ*ocRkCZBZg~y6W=#FUhjUaGVLV!itkWc{;N$D
ziu)se9{BX(<g1rI=1*Q6u<rXllkN4X!enven{I@X`2H^Qkf5sCJ9ag-cS33wPrc0?
z=(4%ye=^;cW$-oq!$<%4t?+rw^Rdu(^*sxPDc?N@zH7*m3SO!_`iH%DjmLh?b%fzs
z7R$r(hYo5p?cBkv^ZMo1i$~N7U+$~C>BYW@!J=LMDE*n+77TU#r*_-x65d3;9J1)?
zU7q8V8QyUCL^-+mmk-?;P3=w|E<tmB$(H&P?`>Wk?#LfFAhzdhv)SA+<=T@0Jjd84
z^TRe)MspUMWU7|gD=d4WbJs9+;N&Mmk=E9i7W?*_#=NVQ+T&1qZt#0plf}h0_o`Ko
z>CBXt+~=xmZd<)%BYXGR2aGwPbzY(8j;QLb5qtG+<dgTE>R;b0UoaL}v>*8Hv7oXj
zl<%b@t4(^Inyj|`0EZ#V%Xh)YpCm@{D+w!oemI^PKHxc^xcrIMP1T$F^V5}&U$5&(
zsy2T?N7rXMFIyC4=OeBA?UmU19j`mZCLSGU8JZpx5r2^3ILcu}zqCH)NweH-{uGHN
zM^AmIz8bvpq>Rm>%!eMPvV`?vcc+&PIoT(^Nd1u5FYnmT|4@Yg$7G`y;TSJ>&oG%R
zNLSjvX7pB7!l8^^A4=nWN=~2LVY?`#NErUQ^5$lTo%uPzrCy1Q{mcRZDmJ?aHCGA;
zS~%3+oQ*2Y8QXg`C0laxG_zu>IBTHXC1=+y;zo@(O658d7tfuEsacYkVE$#oE$7hP
zZ)GE=4yV(7YdsOj;_AHcYmUE+?MA-Vec#yra&e<&CfD<d`x$kgls8@QsJ!#|`l>`(
zl^v}Q^0bVd&6D=}Xurx>`}2|T>Y-MRw+3xQrV$0B=}2}ak=Y-{Qsyt(a<*-m%{s`s
zkS1{D+}ii$Mdr5L#<t@-j60p}pVrJAAU4hX(jtq9`;ZM^&Zi#F(kk-O_-QmY#$N5A
zc*<>^P)NY-rmEbv;;v>{ktb4gS8Z7to9pQJ`swM9$?LC2zY?EdS$c3_UhvHIYy!7z
z_GR(9w!r6c{B4%{`*J43yEfgExe;~u>3puZb>hkrS=ZXhd({oSp(Py(4813UJKpo|
zbl;L1=E<27m3r?k+4HH=@{BK|?!#%<LtHYsMXydKd^yf@>Q37_H{E5?;$bJ4);*Ke
z6rx|^9d^H4{oHxSisv1p!e@HlCumN8tq$wDYszgKq3e7vabkb@$J}JgLyUv#D{F;Q
zIlpu7U|+L7XStR1QHg{|Ij3{2s@t#lJnIzTa6ZxQows8X=kc&>dzKlrR!C;f-&khG
zrI#>r*)X@%W1Qd5pfXue!J|)7|IBgC)S?^TEg5_a-xc<8#wQ)&xBRg3i=yP#%)`kM
zQ3H=jwzu^%!`zb`Tn6bXVkckoD+SPTYmG|iFUFY7Ha+>^n$;f3JbdTMx38u4baz~~
zF;?F5o*|~bU?Fccy&z;BE4i_J|8(1sPr3DV-KJZ?s*n9l-mv~y5OLjg$Kl>uP41lb
zT@0k~UA^91^t*Qp2x%I(uefvhyL)?nkEU7lgH=|>bCQax*Di@nt-K>8@g;aJ?5N_#
z@gEWo^0#-ye0hDIB%*tJ?C$0F!`SlT4Fg5w#T=V@zj1eGVbdR?PHe0CteEyX5AB}l
z3e8~2sJ1j&c`>=^>&6_$>Ni%VX3@cwt{XYj_QhRc9M09@X_8WxG^h_^vAfG-xH&z$
z=I6(meaa`_(c4Rg8@M?=`uX~fHDkQY+>+%jJKT%gmK5iV%vbQ)a%CGx8V(vfH0r*5
z;^qm{r8PNvO&^-~rhYeO>6FljF@3_}m87<oU+}}dew9-@IlDJ~zJ86KXNKG7+}F-5
z@ng2a&vsXsJW^ZVpH}x|z(3Sv9c#WJ|6YR_MgIJzvIGgwR~!K&j1oH8_eeSCcP-&$
zyVAYTX<>VJ)8_B$<^IplPRep=`$~CF)yZE89xWrJ*6m)&w(gYkc^&I5%kPo>oQ@mD
zh(BrLo^H7RZRX?SnU4n-7q!TG$xNoI)7v=*Z?}zn_!N9#Q)tnKo%u7&vYMx&6tL%n
z+h6J`%g(S&9_u=_<(x*DzWAs$Po(~E=R2_s@!6-bGah#xV|AwjxgKQmXLWOUoSKce
z#lO{OR9IYZ8Q;h4B{NoBjUpP){QenlqR(d(zf4+RuX17M<@=4-7}xCxVr*M3@%89>
z1!=Cw-DNVT_=WwX8EvO;j`)<ceYn*_Iul>H_H?UD#OK=*8Fw4rHMRz>U=fP#;1o&`
za@yP5Ys|38+0aQ~B-nG~;hs#nJ#Q_q=Dd~SzbHelOUV^AJsa?-;UD)`Lf@lZ7(Sn>
zy6|jFIMV0Iwx{KE9urfIjjo@g56$koli_hzr|WUcT5`Vdgzz_+cjSmVo#%Ee!^A76
zg&R6-FJ)K@6y=WDKJO(8FeztL(iyIZqc76rZp{D8lpX)2rS&||9mB!cxk^9n*UG`d
z!;)iqdCK!%7Fy-XT~;QEdTo|hY<p8A2t{qDb@#CPyA%7Yb_rfQp4hM=;UxQBvn>K^
z0(0tRLu75876RSYF>^XcS5y_*<i66{vm$X<c&+!HZ3hQtyKUlIIFFu84&M^?T)IZ`
z{Hs;M0oONlr0wn1+Re}ZEVd*u>C=`@C*yw-%v%~dth7F<N(+t{j%JVFe4ZPgtWNYE
zzSk4PAbQJRgC!=?<+<eXojF5X&En_XmLEz#!DZnXAw$>Ez@#qMv$8&J;X<>Ot4Qs~
z19~y5L{jKdMYd=z9Nflnl(~0x{UST*Tkmwh!#s;2dA(w%vMS3OlJa6iA=C2jshxu-
zjW65FZ26c$)^j<$eN~nWaqn*9mNk;*+C_7!b!Nq43QM9ar`3g01<RHE<;B^eTj(D(
z?6(g%q!$y*EWKDUN#Z=T;n-N(q4<sw>t}2|MuAQSpAx3@TC3>4OOw}L;!!)XVSPkF
zMq`iW++vF?ZyuW#lP*X0Jr@3~C7tX<nN>^X)x36lq&FEqeCkyD;JK+!N9nrE&FAFI
zT8m9QM4l?OHr;JsNw0B*bUgk3#4PV_(JPKevOR@<M8_n444mn{epoCj*kJcyrdcXU
zMnpG@-90+HD4F@>uG&jy;}gn{%_n!2cM6v2H8tuqdV8vIcpkr)5;o@)6T{+pRQt@K
z#;n&<7Y38GABUe6B{n4}UD~7L#Al%OY3=3(@5L}tjTYHM8BYuD<*&4OSbpXEEmHPa
z(&}%r1{bo$7e0ut+O)f4P3BLlD{psZc)!@RL|@#WyI_OXS-x7Y#<Eu`nUajElLLD+
zXTR{>W@TjdmDIW>W5LYVU-nb|@mjOqu{igY3DQGzZ#Dgs9zEG<F7Iy`@a}7eX;I|R
z%x0#7e)D?YWsQ|1hnLLm%8~h;bEu1@oNSZV6HacESKw1w!M~7URIH)v)U7aL&AXze
z$mxy$X>n3}b90L77skqLOWDy=z8<8!J!(JCz3{bkV{;S#x!5ef_T(0EfuE1sP8vy>
zZ=>^yyMB7%kypF+ho&nwH(zNynPz*}S2%fygXiq&e3QXTpVEfE>y^liC3OkcZ~PwM
zddJ_TE2q#larSo0$6pMu-{e*QzAvWTlL*`ygk@Bl*zIbRVVhj*-RO8RO#S=0cB8Im
zHfqN+Q%*RX<gs2VB$mu$A6Q`e;m~;xwu;XjjyJpKvrKb$T;6!DkF)scecn%R?Y*8{
zetUkB%bZ@Vm!V#MmCBBz&RyO{Ux+vKb!x36thX-dmgNoGt?=;b!$ZaoK9y|yFd^K_
zu4O+i<l4-W&wG~fR6~}X!u%!q_)Pw?nsawm<*P>CY>HawH5C-QKJv;xRBKJteFcqC
zpUoB-Y;kisNmH@84_v<-e?PS>qi)y4sJJ*Q&sM3~;5*Y&ONAcy9X!Q1WbMCU?qK53
z@=+tv2eN0S-yWY?GbU*#JGbxbvzHe~PW4vo);t!+D9t`)Q{gt_<+Ywv!>&;AAe!V?
zC7sATnzQO_ms{|amKp2A^!aQnwiEQUv{XpqF8+S5PEzjvfgWxo4;L4b>=tQRX&EWG
z4e$)JC%By_VIT0b6l}E_fu2BD2N-_8MThv|QUU^9_-+DS7zf>IHfEMnn6L~MMgaQ&
z=K;Pn*g4|pwb^;28T8mm2bQt(YO!-@u(Rl~8ng52P);dpD2#zD=7hkP5j)3jb{2{*
zPvFN~0{Gg&&T)dO%YdC^#m<ZA)?{bd(bz#|Cq*+*mUWq7Vi`adb6Y_MG}$>$(rdEw
zo?y^tCnYm#vWq7%X|T)0EzxCHie@%opAll%L%)n&31b@U;+pIvOco1+>D6OpI77$2
zC`4wDgg=s@X#MXOun!~Q<FEfxs*izU)&IT1@INbaaC!Wfy#Ecu@SoMO|6XIDtX}%p
zkDoF8XVol~g5MU?(X5)K%@G3)$8~@s!+%!O{(FVtKdWYGIrekgKR5=;DwY4e!0>y;
z+kdYy;0rDOi?Q^8m5Kj#>nPs;wHx@MBz1Kc<>dDl_`NmY$WQR$TC0Db!{GrGp**d<
z0HW@#!}@z~JzQRca>7DT!T~($QjV;YwSlykc0f+1h1fZ@J+S_MhZlaC`V(*#LKY6-
z(Ux*#CE$A^;Fp~t2knB^QQ9W<%keN;h@JaV{Hz2=goB^0a?;diYIy2i-q`Q{{>NcY
zC;w+%6A&u@3-9;~pTsyPO=(g32aK^}4UdziT~PW5jLTsBPw4^gSo#w;py*-4LQ);2
z&%jQ-{~{my7Y=@`_$U2f54b<^8-L+-f8m{f;e&tSAOFI^ULk)<59eRFz+X7nE96gl
zwEx1vnv_4u`~QU>`wKt&7hdoee&;W|?k~LSFMRkfeEu(-nc>g*1@C75lO0z5g$w?L
z|LynZ4i4@iel89UV6y;2Ey@?R3xT25X7D8kzU0Bz7VxD2z7)Y1w({LjOO_%dOSvvf
z5mlyON_bhBKgI}uRqEgr7>F%tAUNn5?$XpSbl9b<YpP@BV5XsIsN+Bg3&WPQyM_c%
zHQ>Ll2g?{7eEj|Q;ur9}5x_DC2e1SJD*r!5?BnKy#rwx!y;6U*?+_3ef~~dp!uD;z
zHa!UP3U?#8VCyLSeS#b)>+}B{HY5Ps#lg+N$;XF4-F*Pt4!|oIKgYHbaL2NQEy^Hx
zIt6(;P<6X|1qKE0bvr=I{IH!L0D?+_v1qB`yu%!@y&r-otNno<DBvFGhNX|Xtixen
zh+E(R2bVxMEGYym0M%Gve*h5TU*Hkq6zB^4u5LbVnCO4QW5Hb!gv&uYfb9wJXmHz5
zSU?CRb6!4wC^@Ku8Wt;sz~5%2Ab6R^JTM<v>Ro&TXl>->2iBy}l0Y|Kf2>q#0z-8U
zSmv=^5FA`Q_d0;JD}<n6SGT}Gf_ngFl3;g&ySopTWP+2kKc<l4@EOAf%qNU}zGFYc
z25uwuGPc@-x^FJdEorz2jXb_&4wa|Xzm7&8E|sI`Ur)mwv2)<CZi6z5!s893Q0$$@
z*b&TKaE>o?0-QEI%upWa0kbY#UI%g@FG0f%AqVo{y<xb#7vw-5*aYXHG+dH~XF?A2
zfO`O3zL184pRwb-6mnGmQyLEDWVrlG$btS<G<+0tRL?982kVe<J>O_JSSN{deD4OJ
zM}~%TV&f%nAYLBqgUgFR4&-UeMS+IP(#YG;=mB$XTn|`N4jj-UhkbA!Lc?k6555N&
zNDo-HjLU=h1aLslX6%FWMj9?p!|^?bf&3O44%R3G2e<<E!S&40a4`49ImIwgp0+;l
zfdoQMTaL;!9L$ArJ-U#Cx~WXV!J1j%KzhJ3U0fc2hdJP?G(3Yw9?ZpY`KvUXHk|`B
zoHm`T*!T(@(7z4);Ch5;IBok?rQvEc@<ueAHeP2MzMV#XFAb-aKS0B2+j|lXr%nF_
z8m>;G{|e+F+x#>f-?Iwjm$p7XrjZAI8g7R-H2P`fCuz6_jr=FbLHTOZ@UJxb1!y=O
zxJSnvNGDhsgU8EG!<W)<ZW_LZhU0ra13hbL_y#Bs@~cI|<!HDz4OgP!pfAPK!-Aay
zw+#ERQqHJf%i%fTV2l83w}AtFGH`&?&i6o{1{}^oUjrN{Bj5lBI=z4gb6|ZpaDcN@
z&ZuAb_ystK_c9!ajGzq8_rQV63gIj;Lv9H7gEz)L2ww*iir+8d`c+`OafrMRv|}>D
zz2Lx=g76d202dIh0OKt{IKBq@D#G_be<i{V!Jvn^ChCD=Phgr7%9^Wx_s+!gbpZ@+
zn0re-{FYaR{o^#k(_z7WLpWH03>-f0;QAY&omWDAIFE*vg@kZ=&<HRmh42_KIA9Kc
zcLc6y4pve<ME)@Jn<0D#+TR)B?y%AYAY2{Rt0M^C4ebE-KmiU<4?Z5GBU}yIzYyV5
z)Zl~)gg=IMXhOI!>|eSNJ_hac8sTrDeLf(3mW>+mcZ6#}{mWqc#`E<V)=yr9?}Ygh
zLwGOLE06H=Kq2Nd5svRQjPIR^$J+z#Z;!|iLhgg`w~&V;d>nFczYQF&e-ze3d@oF#
z^FjOIdtu@{1okJ_5IsaDs$Os(4je9D4DHi`aQvM+PZ1sj%N^gt64%29?Y|B$A1n@#
zr3ui9Von0#e6Sx-NBDiHUl-vAVf!^ixChuI0dx3Xm3VrZp`0ZmuMh2DkMMe!PFI9W
zK>K?mJOuW)0SL$6O%{sq30Th$BOL#KN&>>uVL6^dxD&`A=CTn^g!SP%!tuSKs}Md3
z%c~XP*|7h?-yx6N^DNBoG$PLm>&JJ5<LOxo#~)k|{tn-b2*>5|aUYkbhj!3G<Zr|F
zyBpznI^7V?0Moe-;ds1>2*=}1LpUC99>Vc>8xcMX{cQ;Mf#rq2y93W}H8{as4<i2z
z@&SYkz;XNy!W|(WMfghCUZxOE59`Axgg=1w{|mx5!TS6Q;mVLR!FGn{OB2=~R)pun
zcDDlIKViH)2tQ9X4?z&&K5)EShj3>&zHdNy5Y)d3;RVpIfN*>suZeIKXy=^>$J>Ps
z!twg%iSR&Jz99%7fc8m3xIN5oD#GVrdU6m>1UJE$yM}OG7;h!QW8i$F5#dMRINpJ9
zAL#Ex_&wN8KOx)@>KB0JgV&SoFg^ANzX;1~FT(Nrt}ukR!SN*(;a1Rp8R31fU6dfa
z9`=Vd2$zBSA0WI4+W9%c>!JR42;U9I{aJ)tLp%IJcp8*vgXN6dEd=%_d<ee``%f{H
zQ>z1EGr||3eszS~LwRe2pMvG+fpD<*8*sr0&w=y#D1=ME`g{W6GSHqE5&j0w2MQ5>
z3D(bYgl~iCY(O{*ESJX!=YsWZ5aEf?K4S>)g#LMiABX)R11tx;yp&;nIS^h0{elSB
zf#r+8iyqe_2kVC-B9Fi8NE_iUFkdDJw}AF^K=^GquKOaK1nqnf;p^c1Ed}8{Fy2cD
z7lPvl{w{YsU#8#$bESxU2DEP-!k@tQ_z2<MFkk%$4~6qy{GC2{yr*Hl<`8))m@hhb
z#O3jMBs;>jV7aeGcqG&-j_@9so-GJ3f%R4s;oo7s-G%UVuzlGg9DfI#7s7pDI}Js+
zDNKJf!sDPlPa*sZ^k*V`3AASs!Wm(^zKw7LYOxcV5Izsbk0%I!3g;~^5k3I*OdvcA
z`WF$d0LNJ-Snu%i<$&`>PJ}bV`nDF~Q?Q;(B78mUH<S_H59RT37+eOT`15PL9pGFS
z+TRh;BM<H4i}1BD{ox4z26;Tf@%}Ic;duX<jc~l5ypHf(*siM({s8u4tq3oH^|=S(
zk+2+x5bg>&z85dJ4D5!#tNkY;?+@z<8?4v3d@M{SKf;S)d96pdC2Xhi2<L@d1L482
z{q97#6|Da@2zP|(^hEe}$U_jm0rt;F5#A2xE%>{)@cf>J{Z9rW{~ET_D+tHmK~;fp
z{M~qs2)_mU=T3y5h5QA=3n2f7a3XA<bg;hQ>AwNTJ7$C{!S=Wu;in;AiSRgRH~cvY
zu0Iu)BmPb?oS%jE7en+sfc?fcgl~lHR14vzu$}57d=%D)T?oh5_n9L+5BhBo&I0>$
zXN1c@{{e(2!FCsc@KI=oScETu_D@3iK4|C52v>#jR}k(E?Q;X+La-i`Bb*-gllKsw
z4%=5N!s(&^8N&17yz4E(J0YJz_)b{vKM?*E_CL#D`Q!CO1pHG4bNIXAaDEBaHxWeM
z2=+5_2ych>S4VgWtS37Wz5=!*TZH59{PRY*6wFr`!ts724&hDk{yhcZhLGnVd<87u
zn+Vs1{Z9?TpTU0kA;QC9{pm;eX~^FrJPY!9gr~uDGQ#?Tmx}}J_c#$=1?vL|;U=&i
zNF!Vr@~sGe3)_VO!i(WN4Sxq8o}Qmj4u9T{^QGVfbNG0Ib6wbek0Sbi!t~(xXSn<%
zESF1&JQ3Ezs|X*1{ncHBXT$!v72%dJJ<kv>2gjpfgpb1hY8K&v)a+6Rb?h8ZKM|G-
zJ4`Rme?t8N2seiHN&?|@u$?L)oC_$#9R7|%Tz@&VgBc=Eg7G>d9DgnlfN&3Jw<8Fr
zgZh&YPK5noI>PtCdRvHaBUt|{5FQB2r3vA_uwUvz_*vL~UL)KL*5?lh?}Yu*cZC1`
z{}b%LaeH>c^5#W&F4QlE@GaD0A;=?K7xsIa2yce+#t1Kh{f|Au_rvz+gK$@vpKydn
z!2aYI!Y{(|I*;%Nkmn+N8rC=b9g(<wZou@{A@U=z{&XOG654YR;Z<-P8Atd@*gq^H
zd^xnw5?EjG^sIq$TnLYb<t~hHcW56Ogx5fMHH3eH{eU6DA3;6V2+xG&;)!rm*d9X>
z{ucUU5PlEVpEC$Ih4#!sct5n;b%d+Ha=C|a7ij->gs+4AIl^aQ|2Bf~3$WjwLwGv0
zCq2B5m)BOvIS?KQ?Y0Kt(J(!d2ww&J0TqM`K>cKduZDKRpC{qzVS?Nhk?(=|4MeyM
zY>$x$_lD(r0^vN+pMh|EUR#9l-LRflB77Y37KDeuaRh&!gy)MN_S-{<{41FL8HD5S
zF8Yb^N;n@|4*Ne`KNqZTJP60<_o4{L<u@Zd3AQ5*gr9)@j5)&JKs&o4d;#k5LwF~&
zLpZ|MKzqg`{4nfK&LR9AY>(Fwjz7<=LOA|BycOa2^Y$Ku<ImNH5RN~G|AugTSdMh?
zh?k2nv;#B3-@);e9pR_(=L`rx4(%Y0aQy#ATM&+yuO`A9px*}NuwU{-crWyaAbdZ_
zAm)xDd=TdAB*J;%JR}3*L$KVhAp8cjTLr?$Aa6prBh=G{aQt_2uMzG9+tmkz<Nrtb
zj_^IO-7SOtA6~v%u;0U<>)`w-w5J#%Zw|{*9^sZSUz!NN0reXrJQ3=*N4OK5KlmVA
zALb_<;ev3SIEL_DupG}L9Dfdzi|}IDKbImL|Nn6v!i!<Q(Sh)2$OjS51pVU(kA?9r
zB0LcGGfUugyj-s0^Am(?z<Itf!Y{#kE`x9xSfAAp{sY?05aG9AyS7GnB|bkvI32V@
z62fC(deRV%Kd;C`coeL+r3lC8X|)K)-wE4=@ESNSzeV_cSbu&Z+#J@=HF&$h`U;TM
z7+5aK2>$}_M>G*$4cmn!!dqc{Aqc+@=ZEJJz7v*LDZ<NPKi-INO{k|2;agyN(ZP8Q
zUat<pb}ESQ4%jbkKsXWBx9teu5A&ssaQy$o4hUz0?L7eDqHugXh43C&uksQ85!&Y-
z!t<dW1`%El`%gL;4!6Tq=;uT@7%PC2M)(?--|Yy04(pEv!XLnX%m?92ke@-gH%#|6
zg!4c<G$OnX`di@<WFMN6lKxQ|c`)UI$tO%898Sl6zrzf-j})vYUlDl&igp6wC&G0h
zXM^bldVp>($T<-11UWYi2UT_omg8C)4)mOd^6L<O3UV2QS3@q3@Dj+CX*h^i3M3eF
zS~MKQ`-wua-(Mqq3UWgl4)iENJvIo(=OJMTzYgo?Q5p{7#ecsWhw$alJ|`i^%iR+4
zG#YtOgmN&Q*JwD<kFPT+LAW&3a~I*(kk=p_kM};p{h|B=gnK~#0^w&N$LHyI{W%T!
zIE_5Wmm$p80u2ZG!ux@52+x9g7-2sRyr8|{zfWBbIfxhNx4=HYt)bySKi+TS^JP4p
z_&S+wi2MkQR|DZMAvZuc{{PvX2xo);-`oQ^o__p=TA>Ih!tp%@;aN~m4#ICjj?ZUt
z{jVT@g2;<P{Vx%|9rAgEn?TME#}iz?JLF;r_lH~!;rQ=OEf9VR${#^^CgkT4UJdyz
z8V-i`2vF#lYoy_zo=CxY(Q_IOP#6%#+&dZ$hXe|rrQtxoBZXr7VSq&`m;-hI+zfay
zN2K8(UIiGh0K)P0<Qoz02^3;ZmxcrVsuYT?|EJ+V{{blPiEzBVM9^@chYa<cq2WM}
zKIBCR_l3Nfh66p|1KeX84)lamD1k7D@CwKmXgJUz3^^TGw1YXkUiDJF1R;b^K)#iR
z13k)+>(X$Lo_WY!5RPxm5rA-3XwPE^7l%BLhJ&J2g8FaJa1bxP?&2}R@&0EN;rQ?W
zmx4t~n8WRWuR~ae@Hv<s8H6*!_P!0_f{@!Gd>iB;2seg28R1rt=OG+_&d@-^fqk+-
zW-#}Vh6DS|!1mh@Ip~MM_`4rm#M~Ez<M$oQNtDaK|Nl}C?I4Wsm2f`23E`XJec5h=
z%RxQ1kOMDmKX3q%ZvhF$TnveF_?;eqF!*5Z6p3>9&F?^E7ZH95-ltR}Tm;VNTObGN
zfuh(M)?bk*2a0|$u7Q0QfEy!G4!^l5<nsu3g#0VQEg=6z!$Fo{H%MR;!aSJ6$IV12
z&w=oG$hjfM(+`W4Acb&qs#<~y!b2h7L&IU0O1a`h!-0K{Lixjx<Mql2mdjBZc~}K0
zA+l-Yfj#kcEO`hA@9+e!6yeQ~S0KC|@+uk*k^<rYu9b!Z_7ciJMED@&PavnmWI_7j
zZ6)D7jXY>aa9T?ENFxtbU{|rVhr*P@?{fSMFLEJ#0&*dQi$mjyB76<x5;UCBu3>wT
zr{N&K=1^V<;rM(*2jTeo7JY>KKs`Gl2lk=IK6rieK=>wV_6ZRPw}m_%a=iYmhWald
z{206+yo_-Cxj_NK^I^Yq72)`EiJJ)Lg!8a+gl~b*L+<>A!)ShwBQRTp9q<I$2X?g-
z;*Id_Kmc>8)WdH*Opw<g9A7s$hwwP)=Yrwzcz;5_BEoS!`0ovId3;`kuQ$Z`85lkV
z(US%J1qi<e{jCT;N>5GbD8j+MGQh2XM{pU~tqA&MXgF>E?DQ9&gmAom=F@Ok)j+fa
zd>tH!mzLx6dYt3^0N8g1IKbg4#gG3k59Jn6Da!XD9B(i9ybrVs*rX}?;jsEY@scQ4
zsp+9jzYGnhwVOH(r>&o``=;mzdhoFsPA4fG=z)(9DSIFQRUltL4;h?b&WL*W%?lyl
zgK+%5lD1vY+B29&o;F`cXgF=Y5@<MWzJwtMwgfgbg?=%FpM-u1gf~FHG{QMxzVPP<
zxPB+dw<7XokZU0P0pz*}AA%h3PjLOykQ*cNi;&~vJT6ZMjcSd^gLlmX=RiGB>Kd>Q
zet+$XaIha0a9-5IZ+Q{O{SYn*c@V;7A;<3v@pP&{ei)J0h5RVOO(2g)I6m)6LbwN%
zKaKD($j>7jpLbnEI6gngLO9;P<RSb9)L(?~TF7r8ydCl~goFLDfV)FI{I);7zXm>D
z;PxDW@~u!FR1b(KWFxFE;6U5Hyl6OW`|6|NwC#&T(MHuxtKW=<)9Ux3;k5d*XgIBY
zf^^UUUu>Tz>=+zKJ$mA2!Pq8G1Zix;C?|rnb5IaLI?&C>Ng7b;|I@})aL=s&OKIvx
zSJHw0ARdqiS!rz7uK&B3s9RwDCoHz9*Z)gcnk}$kNEn2&Z5Fm4mb*WeX*cH(4+ke_
z=Rmj6|6KO*cLDoA;l_Y+flhuNZvSP0ejfiT=;MWL*#(tjS;bEQ2HRf|q+R^6w`==h
zR`>G{c9X_7ER~{c3<dojej(BUf&Ky5wo(URs@yys+ylXjx&ME1V7dmXB0f&yYSr-*
z<Or+nZz_bH0Y+OV!9{iO^#_NBUysRvTgU&e;bpO~K<D4m?}1&Tb)ZkCb&{9|+@Gn_
zLhRgFo(jm2gM0!xkXGP$sRv4b|EKtG!s{R$twZAn<H(=lPlNH}@c=y_k7)ey7z6R+
z<0f`WanIrLB|PE>JUj>k9O#e1IcmQ;D1grcfGlum`awVcr}W>1>Bq+<AxsX;f$;e8
zd^KVWM1`hbA9jA}*fm-QlSK&wcrW$=3{C$G439sz1hT-P>F>hWpVBYBg(6M}fSoEx
zKe+!x)BgiwAbuDfc1CsTu+tUB0X&ir|1vBv2>)9#yzU9Z_uvyr$np50mjLc>{*?YS
z6{-Y&6vDhj?1P8L?Z4_T@vFn%4dCnk@%ZrYxPQZ6!js_*9oQd~)}i6SzGQz&zf1@<
z6xeSQI3euAiGA?!c>2};68|C;z@M`M9l+t?sXpvE>|f$Pwx22y1_eR<T-XN>kH^3J
zFYznE|5v)h@c01_kNb`O5<mW+|2Y%{@vp)@cz8U1kH5s91>^TdDkdHtk00!l^C$a1
zhZ%Q-9W#g@#EFN;;}3%I%itHFVh;EK?ic(&JRTn|h6STIu<s5y|DW*U)a#&pX&oB=
z1RkDN2s_`ofeN6S-&b*U_%RiR|1AJdLScB6<Kb`)?$<$6Ma)bHgW+XxL3qT|kK<Yx
zKN`LehM&O&{}TQ#7XDA=r*w!Kz!8QM!j9nH9giO`KP>qFq#XoFlK|h?b79!A3S;La
z?1P41iZOKT#t=aq49u9r_p_n;U|)xOup@XZ^r!G?F#T;Hfiw>B5;iHwlW3i+qJqp8
z<;|PrWJn}Ad07QHMe4V#jEsUjCc0S`lb{4}To$2Ys7p`xuSPn88nrK`i4UBz?E4p}
zQ%=<h>#+X>x%dZSlR#f=lh42d1Xr)1y#x<zr%?iRzt$jvsH+41M-8v<7wY8W<w|n*
za`SN|1^bhNu<bobRB=*Jh_A0xpqE>aG|A#$sUVV5pqmPb5|bo}8kHmo#3e}rkx7!A
z{9K`mApD*hPpyWTe!_QhLa#YFp~p1g6FHeOrv0My?6Gx~pb7-@K}t@T#xI0yssycu
z?DEMlVbta>C~-S-0%aT|CsT$a4clL$AQIx*NO1UH6_udc2Uq{$0tsBm{lf)N(SsA=
zg<4RhW$UOZ8uP{WImP@0Q*!hqiJZ8GoVcBwNXg4Aks}oZ#E#L_;|enoj#=UgZ4q8-
zU?@mVctxQsREo(Pim<p7rCY=KLwGSCCO=EG)fV9(M>mmdW{Hw@jqax~Qva_Xdj-HA
z*?A2M4RZ}MbC48ISHna}QD7>=1RoJg{e&N~zo_c<6PolBs|z^@1gam}2{LlBnTQfO
zIaq{Dy_(P%TStt!kM#iLL~ZO!Vj*~FNRGyC-NPP|6YXT&iPOJk$wZ06>R2AOintTS
z@BhvQr7*D!P|5?l(&|n$Yrr!0niwyIX~eE<1E#|Q9s-8ppcLcp&|D%Iq7*3>bcSlT
ze}mX|;sIufRxPtc`%X*>Q*Ks|MX(qui={~t^G?@cV!<LD?nLu;kjy$v>iI0Op??V`
z`Vuo@BL=Xb7EiDU%tT07h$$fFi=Bx#V@y)ycY*||iRF+2N9=MdrkWDO3{xWgo*E|>
zJta;oM_8PFc$}}XINyLcN3l4YKwvD+2h=$6jQozs78E!K8^}M!bl4FZ$`%X8g{2?F
zi{+bQFf8vF6~`hr!xZCr$J0U0`x`tR@3C}@fpmPp($Ngl@en&wRAI`WkdrBK$zqnW
z!t!O+=}sp4H4<0p7!zCS-n$czw73%k-oJAvKEvvzy9V(H#w?$@6Gyr*K7{cj*vXMM
z*mW*wI;^FV6B@}0Ez}H>6Pn4OQh{I5U{(KjuCWR}OSFuIO@(qCbN}({mpgH-HdaZn
z@}%Smv+5H(H_yq5&;$*AOF%jo$qASmEPGgsq7*G=8H@I@EKCio=U8H>F(!x6kzIa~
z>qi-=e(ZvN0<61+2|p&dsqunpul}o%9No-9PS9Bd?L!^3598m8V(UWsK^E`pfO-L2
z6*-ww`4e6mCj5F2@c%CWON*r|c_SmGVTS}^?cdWdVbR7;!&bvi!(PLo(OsIjHU>mT
z_(UAx62ZO<MR<uDD7A&!yoejvV6k9@&L%<zDICR4F%eKO2@T}?k)Q~GBd#Fx5?2_D
zQw=n>>nGONQL;t7jD5>!QBP;KL!=J<wU{Vy5s<?}9h9rX|0P1;TtmHtk91)f<<D6I
z%zF5kXAbUHyi+y#$X&5&hr;8ycwP>t1Nz#9AN3hyvZCVXeAKVjGj|>3)LV0<VslD`
z!i6Ua<%Jr2c_%NlcyF{WF6lpCQQ;gS(8SY~Bcrq0X6=RJd86Nc)mAU;zNwWt)-hQ<
zy1(Pj=-~bRkCm$utRF~}P8PbU6|}XKtG#)vyRJ0xftb9?=Elj4phxb*hi;wr&*knB
zJ~5fWeWoH&)ULXFS5>xfUve_nHQVy@$*~hpZ93HqY%lEyQIt@%PknR6{BYqr4;}WD
z1@11LSB1}q@@lQ#75EpY%#E3NcnKAUh4wv&Ejznmz@Du4iQBEh%}u0w{k(=lt8GE9
z%UYF*fG2gQp9@{tafnSMA%aeMNZdGn$8jqKvt4~=mzJ3<H%s%*JzgkQl;)i;P;~Bi
zpBC}riGjk(%mclJnGz-YeimQhDnD;9AiC?qVP<o`)E8d!nPwf*c3$&}rre=(3{OX-
z%#!V_1uCvS>K3n>v${2%(=t$U`(aIdyJ>Ydqc`)G)8m)L`n1+4e9P?Sy5zBaOV5cG
zqljHLZ|kN-XHo)7eB-MNf{7m@hwKLlhYc1k=jFbeln))|^AP17ruP<!G|b=X<7&Yz
z_taipZm8vfdux>O7+-!|(D}Zk6pPUd+D!wNI}`gxo^<gTdLJzdF6-u(VD9bv*siP-
z9`|v4QD{@)(3XAM3x~?VS4fGhy>W9qT}V?v)+JuL;RMr8bp~098WZ~CO5C2p<5BL;
zZ2X?rs-1h5Z9Kx?*>dJ-RH*aTo9V3#f=$|4XVVyc#PSJtO?>LaCxkgp4|>&OUg~RQ
z1)u9bBz#SHOkZ_O*HLjF`^|VI;&Z(WqJW5WFcX8ese8?Vt<eerD;)c}eQG`zDa$VH
z&K)0`)HL1fVbe3)D(Ex(oJ)9bN$TB(+;-P2Nxprz^_`W5&uh7`49HZh@JXB_Upc`s
zUiO0d)iLkx%I#9~_eB>x)MK76mAN#iM@S9hatydrOOR`NOIY{lFnyueSGu^&Zz3{h
z!j?I*-QC6Dl3+(*==vcgb74`i?tO3s(Qy4w78$b_9#NkXUJ%|sJItP@wUsDy>;+Hc
zDrf(pf82Ww?y<?_yx2phTlS5=?pWvoU6SYi?br#CkmR{w6uDw*4I}T94?^H%33f6-
zSl9n!HFo`%toBPSERY&@zMW0G?Ar?I6POI0y^z`x-j^RtUT+e(Yv`K5KK{@^Fu$Rj
zVD5AIZM~52{qtpR3??Llrbv+$%z-hi-77@Zx1A=;YIAy$cB`*5St7r}E9*il{k10J
ztYmTK{se)W>4l6cJ`cVec~c(bvFHBI59J%(xvwr8+|lT-%PM92D*TMp`;yyn6E3kX
z)0JOh?t4F~YS_4J%gVP$X4|T@Ew{^VIJDQ0Ire91)1dM0`%z7zCK2}fw)~&(M``cq
zUdznMn)6fStR?T~J<<t}b$DXlY0zI2zp`U@V(Fd>7p-ns+m5H%e<~8az?#Hww&ROL
z@%ij?Vm*O{Rw2sWMb=S4KBnab6&HW@n{O;0xv<8f_`1OktN8Kp6v@LX=Dq3{&3iTN
zip(qH*7SrJ-|${urd7Ub+|-UZW%h#bx%inzm6@QG@~sy|pT!3*_Y<Z}eXpL{s8V=0
z&u}P6{qwoNgz^Qmi~F`Sn>$3GD69zJC!08oZp|8RZx3E!9-^h+GsPPdSmdu2QZ%jp
zxoC~}jjw(~g17b>zo6Sv^r4~avVO?^vSwR{TSYwH=DyMWW(%*c4wx^Px2_II9{>5!
zZFbOH)p_?Vt<MY(yE2Q`YF;$oe)O){c3tAOA~nzAak|1ipE=@vx!3opaeMT|n-PO}
z_w4hY+Vevo+`73fB=z{MiOmu_Z&aCQI5-&pI1^oS{OQz2iH_Uf%xZ@!Z+zWy|8S4L
z(uZQDEyO}4#oB_Q;jM*3lZUiFGq+grHMgnc4EYF}?~4mHj~F_m)x1>o@=#KyX?3f4
z{J5yJs@cIiAB?LX#>S7EUq51gLt}YSuQKPAm#>R7%l~<>tmmJP@)ymSjh_{Tue8ol
zY5iO>&cV}KRGTy6-Q(nWZG7sD9CL8tOO3v8?o`IiBD#ky7tN=0+*8N5y;tb@mbAAg
z-Zr9e$(>w_!%f`B##vl$8>XhoMH!};mClK&N@yuRW6GQGO`0uQZo7FV-egR-y<9-i
z%5u0vZbQLy=>U`65ytD!irOp-GLwrcHcg>7vDj;LUQnjTyH~oZ%OF3xNA6wfdR9{_
zIo5y%19qlL7NheFwsvAc>MIL+%&e3?x2^Q{_Ow)KiAiV83*1vs{?^RR;)H4UYrh%E
z-60uTdvDmd<i#=NcXkJKq&Kld7Nqho4Y0~k5gq@vb4L$@?f3khZ)5b6f`(nwKR)06
z_M=V3h3(sRA1Kt>5@mYDTduv|%ruL;=*rUT7YlDm_!&HCNJzIAGBt}IpA0l9C@Qhd
zuXt1x)UIt;^l2rFc8{TFanaHrpNpiAh8DVKyZ_^@&>mVOt$S*|cto?x>{Hf@B6rV|
z-fCsLLY4*_his6~vTmi@Rep@&l6S(-nw<0FM9FcvAF(=z?IWB`9?U7OD!(_gj`i2F
z*36b)ta?&<_AGj9F08J1*jvylW+zcA<udC*ueP+WiAU$1(UFG&0`<D%mM6Ynlrh*H
zovkRc=cl2@3dPHLryr9K^xa;PXX_{RGf%ZAz3l7V5R0$uHt9we_iPeg>hs*?>k6*q
z4uOjU$^Q>|XC9YR6F&UAMTIs?S}6)`w4zme?$WMk)4r!gn-&r+q%2WUk+KvD5vhcP
z6iO+gNF+)NDk)L#%-u}xXP(FVdw+kw^Z9h2bG~!UHP@_X&gq<Uy)M3Ge{GS^mUQ-+
z^L?+nu}9RK)RfsvyxP&;n46&&B(*v`Eo0pML%U7Q{*XuKXRTN#aCgSQ4dEx<Gd`Oq
zZEYTEHxIJ;#g(wFP<=)5WUlK|jS%I`WVhILSHy$W7wK8OxT#lBa^1D~VfH{=vQyrN
zB_hkH1M^?KES8_0B>g4WFD@#ow}8h(arD%x0)x5nPm4ld9KY~;nds{`#ojLkdR?S9
zRlT{Dm2lDCx$ePDp@H@*GtK2pU)?ybt0ermri#_Z(WQu`_=Q_+{sx(>TICgXear=&
zGA&DMw1XrLp9{|jw!i5&s&M8j|Ltnq>=VM>Uc+{~3hsLv1U0Z1cBL3<6l|9@lgMC8
z6_eV{$A5p6Qf*X_x^v_AA&dR){i}Aw^}9cKGrqdr)8Xhd?N<{5A0FN~nCN5DnP?K^
z{l0#1a?-$Ga#GmjnW_cjh@4Par7-_5m&Cza(wrC9w52y>YWB3{_1y9GmUV1D5i+1r
zzA(H>V|hf^ZsUahv0TC3zaJGeCNEg<GGfESdb=|1j0&oQUPRZL9G9fHYu?n|?J`Gq
zy&tj9U2`Xe%ZG74HR<5bv;*GT9ajck7|hH`YS-kI_u$Cx=$>6SPr&@{FXM^$?C#a;
zpO-Cn{9b+Ja{2EM1#8D03nI4-oGS}XA1YODmRR-psDjwjY;#GS+!b|3?$zPaX`3>d
z6~A<82o~sz3I6_27Coq@5y5cyMTXbK+h-ca70Peiu>Gi}PYntRl-91Fad+1Y<%<`0
z2_<ieO>1rBTbFljmWEAgbfe4>2gOAFTigd;4Enzj*(McuQu@nM<ImCVX{+T{FRnW}
zT3fYTz3KA%P^H!1yj8c~ZfGry+vaVg|BP$Y-NCeTZK$cjh3knGZ#OtZT^M{^kv({_
zJb!%lMdRTpmuCh$pUVtIW`<u?H<l91R!oX*DKMAXet9g@=SS;`#`2WLa`TT?MS@i$
zOLsBdN_XEOcCY!vq}R(HxvXL_ch5IYn*PnVZdoPtm%DE)iFW8HE$`YG<|FGGzQ@Wz
z!dF42Q(tPE5sUVP!!ky)1)oO?GdqiY4%QB~5Bc>}>iMsaI$dF9Rdal$l=_(4Z#5aY
z&QhV?x4{$rG1K>iPNExCf7a1{7X21YX58v+!_Qux-4*25#Aba-)9%i`=jSw~WPdH$
zd7?*L<{gvL>H1NNpWy@TXNL1SFTd`~R=*iFV#aD7R2zJ|qbgf4$9%RdH;)&4G-phn
zmNUZ!h9|R%R;5(#QnOWc;+0xf&(nF%jbYK7My{Xk2HAd&10`qMuRl(I&1K8jw%qCV
zdvOMpRoVJKKdqi|SYoqh!S1aaU+U%ES9RxdTJvyAe825tYqv^=BbV%xHWwG&ZdhvT
znlU`|(jry%Xri^K`l+geZ9gRDov|p+6MmiBm+_p%N-kSA)cf*Tp79O#o=JUnrw+Bh
zW>DgbSiyB-dp+}SOUp!^=X>rR_V+!Wrn-nf-mm-Jpsm@;@6wZ8eJ?FV%MG~Idr}O~
zeaH{J67Olr@vb%UV!hA4D`#Y#ZS#Kq_;tu*MB(?XF880$8`XC@bKGf=qR89~$+SL@
zFn-Uy_3UQvu?yt^>=g?h)?5XyY-5U}J7hZQsF`&YCN60=xQ-saRub`PUGkc`LmD-n
zRbR)Ad%F|;S>Em#yq8+lobqYX%cos!&D|3*Nkw8G$}JTp@(PE4Rn!YH@}{i;Z<uel
z&C**i$!ehC5CgA>a64{-cbn*r!;kxIP&aCJ;u{#>VcMlSpgmglb>4-=%B)TIbr-nq
zf6qL7_6H>w#z#CX8TLj(PY-dA94Kwp<qB4nW)EL!#J<d^!^KGGggswGYveY+FDlo*
zJRMs5C7_^4x=nuL&$6aDPF80U9%ZL&da1z5a`Nng_m#iS<_g;#=1E<-$8BDV&fEQ4
zY$dNIxtR}rHs3oo<GhQr!JTn#m!5nx<xRYX7h(;I417-}Zh2>PduE#HXKL-nMK2g_
zqEEXY(fc8g`RvP1c9B&d<Q9oeoC`kjC@YqSO-d~_)c*Vq;|ND#AD=xxm7X2=E^)o|
zo~4mp^AYZ&qh3RTrXuUglC<qYz81`hU9xz$+dQ4^l_`G5JA~a-<<`$KTb9#TD;R#8
z(_e+1A9z(={`%vw-Z*jPt4t52<Xcj<W^G8R8(KFv?cH`&=c|`*>z+O{`hG&#Yy812
z?yeql3pc-}U}>-V-fiI%x`#zvKQ@$0`JAuMk+=Kde8X~^ibRX-=6g>&b3>H%?=LUR
z4^vsV{^w`qpXFB~O+T*nkrh<y+OKl9{G|Quor~3acQG8fnoz5^sM+O&g-}sCGrQVn
z8=D7x@}}O(+LxBqgf8-DS#^5Rp70T?(b{?QZ8lz+b2M$+{^FQ#`u3WUx?E?{Pk!)y
zadRl0CvREErWxOdxh&1^`mfcgIG!&Vp0Q1LQ^eb@mHrGdT6?_d`-2&+cl_xu;m3!Z
zot&IpC=8q|Zh;95Jk7b^f^GPU7%A=*@H-N?UnTu3ov$ZI=icGuL}@asWYjGblKv%M
zqy5mv=0)+1ts=7*I=Q{7-o7`ZOL55EBVFc+#xWcJtI}?I8}C+CjU}YG&udz?j3w+?
zH^078F=u_`<GU2fC0;H?oZrO1=BH2#E#G<O-0cxEZy($B_-77;t+)5m6CZYA{%+>7
zf!XxUha6sGo@>|T1pCe(o;7Pp-nS1+?-w_oX5Fc^Q)`Y|FW1+VBj<QM!~A^Z2CANH
ze_Jv3@m9o_{4gP<7yPORbad}*Hx-)sXzvWAd297%UzmU5qxky0jV`kueih3#39g?!
zHP2efAVz4@!lmEmYRwRz%g>l*9%89=G0DdH<)d$Ua_VvmW8TcayGnF)yV}RnK*Jgx
z@qP|1iDpKxg+q~_gi;%$x!l5XR|clEtB>B;a_WVyMb?^<OO-=vJNCZn<92(b6!l5+
zN8ui=z49$(s!=i<Qg8Oyc{C+k<jpQ>`8eByJyi3cE&C!@+hq+~j1NtIs0mqcIcB){
z^IEBwF?YC=5-ud`S179}Wu~kyc^Y}ysjRv$cy#`!;^_T_dbQnk0cOBceb+X&=ptR6
zlJva?`tSbUH@foC?(E<J^=<pQq-6wl+^-XJ-r?SCaV+uk-j3k;-K?&ok!w>}1TS{7
z^f+=<e;!Oeci>&CRnNQVPnMI^JNv^an>L@+x7x^I*0_~%QvgTssl-zU=31^jJt~mq
zSE~Ja&zR_9^`kX@0n5iqK8ou;IJCpU^_t|nL$NAG*=rSq?jHHwlQm+t;;E2f|I%53
z`)kKft<kl!XMOzM`exR;RSspD?oVb(ad2;q-+XzA?PHI^4@(Tk^epQ*=DBP%WZ5kE
zYfL9vVpsn~%Xy1lR<8@c@h-pUMn`|H(~GM~Ll*M~?!JxlQ`p4CI4{>S_6I|BY@!Eu
zrb*IU9ivBIqsBNc^VoeR`tv39KStdD!jH$>GzPUP&Ap#L%32Znt>5AK+7EYqA0Ln`
zNxRx*JQ%l|O07y{E~R+c{P^CcK%p9%k6buhb4n{nwyEh&Y~P8u-ZH*CX?rF6b|;&#
z@LYdA64uEz_TDx_zh%j>NpF6=y^q$JpEt2uw&+7%@4eBBtDTouL^rKw$$e{_YQ5;n
zsi8~H7T1`xwZ7b6SW@1aIGj1GCm?uz=Z5`z^PUIYdA@P*=2stON0CcwR%~74u)wNw
zbx<#(!{Dc1-peivFIups<?+~igS9LDJ%dL2o4)rx4x0F6H1RERD5B)J#+%vF$KJ?f
z-<d4>`R%7&q^FVag<gT!8+@L@EXUKL>a9A=M%qQzN%35>7F{J@+P=xQ<nw0z%Ui66
zs;Zs$L_JqLoNXA9l*)Q5FEy*-ytUuf=NnXB)ZdtOStCT{0e8`cvaOs^N7H;&ySiG_
zDZ$bfcX}_Z6Z76&JLh5O<Z$HHq46)g!qMYh_hcr^OShz5E)l+1aNKHiK~#Z;ztzj$
zyt2~Q_Vz0;tz4;7sIjs1Q_#X&FOCM3@2fxET^iF-@Mh^gzOg0gk)B)ITFW0_N*r~5
z)3#4Oj9+mli~YF#ojI*80al4NpV!>Gv#7w>#y7N=&HvNt{I@qQaM`m<Y`W!r>dMvN
zD8tRq!x+2Gs|Q^rKdqYU_<fPa>K(o_+7~u+Qs1lW8|<4@ab+mjSkMr)dBb^2(X9%+
z^0A-0J~s7@e0N@U^72Xlv5l4&Ry!~kloy4X+s2ot?|a<7W^6{DiRoy0_=H+i`r|K-
zU$1q2AN;OY(e$W0#_3XK;i?i3e&4-i`DfUg-IHQA?O%J)zr$*!hPsTy7mXbeoAU}+
zN$URUT%+Q*YK^symG*_5oD(<4ZoIlkopbiryMXxtRI~H^xfUk2YrBH39!XQVGv}?{
z`figb1K&L%TQ_W}_*_DrO!!G<{?z%olFH)n%|~vaTg^bowJX0zg=6)aEr~~ttdnMy
zJyTjex8{+r>?yvVjtNq)yrfvJoq7FZv+@1fZ3mV78YeCpzLH+EH$6IqJK%eiQ5%y-
z(7V)&4QVQ_-4P>Q&e6du?x@+neX_{Ybp4q7uGw$9<`!))W2#uRpyh_k!ZV?vy9Pu@
zqE&a6O>{C`_dBtw+s1IN(srf}#~gRHbG5n`4zzTL>_7gfI%jZ9Ds;vU<GZ<uO)Z`E
zr8mo>-UYp>6ZSaO6s_JY@3-uZj`;kmX}Md+?G+l8msB$+_dH9jE7Z`?>$lncr9UJp
z)qTNolV}%5*YTKrl1_;`Pku1GexmSA`=g5k>Z`pkc>gvSsa*LyeNmH=mGCA7*&*v&
z!t+lt>Xa|b5#9KE*$V$OD?t(2;T18)Dk{=>W;?Q?w~9M;D&=b_*7yH3iSrXyHkdz9
zqqgv;zU0@>Ss#544dytn-xmHRrki?KVQYNcc6}z>p1RSOr+>xApMNj-<tOKU_nz;e
z18=0?zf_1XX<}_xy}T!^G`qPyqR;Z{P*>E1(Te>SpI=RyVAi>8DpTCW*UBBbTmRLm
zmcrVvTpc4i&xPC{zRY=N@c!n)jy=cY%nc^Z$MfyW^?yb!(K>aiYG;|!skJd*jnihX
zJ|ZYo8MX0Hq3_^jhab9(@0jMzkhokE#}cNe@8cGdADS;<xkcOi*XxGMw)1Mg7u}$)
zcy=sp`F7nmVI16ZS$Kz;#>|9MPV$L(JQEEHJwGeHYTawUkko?MklxUStyPY`d<<7M
zo*COCw#~in{Gk(OlKI(@$2TyK?sk9kQL;=VBYvAU<M}$DTN`)GTbJ^+nInEvwGoHd
zwjV#g%HECWt+bPP;O2huy!c-AMIT-a8XjLzpIM~WZy|3j$vSIs9eZvHb5M95Rc+x2
zOZtA5McYbtL>0QnOp2#yx>+vR8K|5rUY%Lpq2O*=6MA~}JD)zz68{a=9j{OS3|sDI
zddAF=ql@a^^_&vh-f(?^fac1SUhUDD+ZE=8*B`N;qb{3KtmXOimG|`{!=pwAmYz*q
ze$`l}t-kRjPuuvXSA8SnajAP!#e(JX*r|Dkt;G4ABsOp0^=iCq@zwJF>oKvrAC9?u
z$G`3=d;CqrczDe-dHbA)d{vj!d`-$y7da~yC@b3?OIj!xBfWsC^=8A+6~i+%{KBy(
zcN>nhbAIz=KjFOp>iOpko9(I!XS_Uo!LxN^OG4zfC--HYz7}=1-e*ysHL>Z!jV00s
zZ3c6Lde(PQee;EEbeLHLgQH#eCC+z5r0z~$U80cKZFu=v)cJdIx5cgns+U?B*n6oK
zM4!lc^P@;v`q9JvC1)!*WX{I0KR1ZtT9jop%OFlFlCu7X?Yt#HI(zSk|K=ah=ug&T
zlu$L=6o33opXKkxJM7OM+?jvSvFTxeHVgBK<i+dcEb3c&yXx}W9^A5)u=`@X@P<p=
zOSYSF#*!~oZMj#89kun|%)6@Y&CU<k%8ZpQ+1E55{`5pL)c;ZBvo(u~+y%cDGRuoQ
z80eIn8TKWeoA3H`)%E*sPm=dLtZQdKdTzA(w88$SiKo@6)n^}cz8o!^A5kiPSZ6uo
z2Rq8r`(<y-^-r>UKiRPN*e&-7o`tgl%^R#fJlNaMDr{oEBRzF6`Q9tTi^jj69$&}H
zu<YQR!<RU$q9b-}uZW&-s5qZ!7qq=HN_&wC_m;(-3wY;5s`o1n4$n7y#hR^FqS5E-
zt)=KD5O2jaP%YRhD!G2c?;4eL3w5qhMo+YEb(<A^{IF<ecU?7m1V_N!8ap?xEMu$F
zl5ghvEUw98%$nJJvt{`~$9iGUBi;&8Art)Fr%T@+p3(T_L`bxP`5fOXn>KT8Qp$bu
z$!T?h+f`ZD?}87DYsM&#r88KTv6`L%cfd}RIi6grvEugH#QRQp+1#3PN?qJqADKh~
z*SG5Qbeb2H+H^N0?%*y}X~>A{Elr3$XR_zGY>=(IVe`hb0<XGj7v#t<e6{<2+96Tq
z#~~6Ke2IIX{eHc@@W4{J#I3Ano_`oJ8#$HYovy0>RCAw0`jUfr>@9H_lfNWQuV>$!
z-`;8@sS|L%_R%llMU|AF${hKk9yP~5o))l^S2N+!lcJ8+Y)|WP{k(Oix4p=~YihCG
z{2mdHO5N2}8xD(JaLyC#`+h#`@#_xJ%j-Y(pM1)x5x#IG?+?#>?aFcA#!kUcq4R_E
zwLWot|E1NS?8x}KDCV(R!zYKVy49bX9P;}(8D+~41l>+gloHN<mn%6pP}6a6MWdyh
zUB#uau*fYbg(`zZL0`^Hj=vwPatIANCdR_6<&f4E+^}!!nuyTo$?l6jZ?sf`tqyvK
zgvZIt77x|g3D!#-Qa6rYQSDw?JJxwp*?Z)1P_@f;ZYkq>@c>ofd+!~rTC%kUhs?Kz
zo0;n`cz3sAo)2sP=X;BT*G81>l?yz@?c2$;{(iHJJjWa!+vN@Rf<I#Y?sinoxV*om
z_M0{DjcZ#9%1!J9bk-l~T0BN|TNhAa!Er)9ZBy~7Z;dQZqh^}*G-S@%A*NmtzTMwK
zyM4hEm9wj^_f}?&*&C<wyT?Rl9AUk)-jnIbJtOw*J<T6k9ZWTna<9*_3KpJs(<n!~
zRk<N>;$WiCzFJoP!}XWkg*@jiiCC7i?*Nau9ADhRQrCj+YvJn3ycvt`ikWwHvMwqQ
zFJEfeU|vb-8P=d=FI0cLB((SZC)I74Ki7zaWH(P=huudHSN&P1o;B|`xhKosH~YFr
zk?}9h3d6Kz4nCO&CBv%A^Ox7{i#xQ8<6Ce2(b4+E#R|(34)*d54K2Es&bRQ#%uj5m
z!hQTKhOB!s7#WvyILvUDTUF2yp!f7uR9g4G6aF2-d0Zm`=YO{Ty!l{*$ii52nV5G^
zoa$LiD;AA+-o6;rEB;}<uMUfY(gX1aA`CP7uijnvT8P8x`t48Usv$QAdSns~9%N;j
z`F3*bChO_<S9n(`^;IW4FgqkD7cQxr&L5#SSjvzzI25M5K>FY%>(AP=4JH;86>_vm
z&VFv#P<>(Ic%DjJkDYOi-15yj1z-7_EIsl9ZFSf=Uo99m)W3MVQ{cGx%kmM6TO1k3
zug!1Ik|{A`<fN?A(NPf*cMb4&b6(*Q5aj7D;_2!tBDZR#+)CLM@)Br|_MDjrxCVgF
z1As@>!E<8_mGIUHu2%+h44(;u0X{DY14E<*g&~}qL6Du5?GO-#kIbOQ11V3SfHo(0
zGUGZ<z62&+PLWvV@L8OE`kdTmoNUIkp)3{3fIxd!NsE&^mQj~emeF+<C$|<S+q&6Q
z+7`qcfxi$a2!bCp4Cp-wWcdy-X>*F~XV&HvPoAO0DVxBe#i<m_s>_+fz|_q&i&F`x
z)8Z5dGTNMcAdNOB+j`=$MVe0h1Ix=y`9^yt2{XK9`p>7?;4^OMCKDD!Tc&@!CH*Io
z>0eJYPx;nlq~o-@14-a>Ukr5lvLQ7FV9PlD#2%_Y6vsrz5u$CF{_&RFRE!O6!||_Y
zryc*oA!eF>vyCP+{loMxEmKiUv?l?l#in<dDF1vK0!J{>yc^@AKU*dWx+wjFXnRc4
zo=N{ixYKt3-7Y?elh2d~AWl4zjrtt(^gGNrhX^E(9)-qusvrMHyT{TbNbTU8F*MFT
zogVM(M;x~|=7$jn&!7Dx9HkvGPrqY~BTvwF*r(rV!2C4WA$7pGvcK@kzwqk6@aDhp
zKEUVF^+VcN1`K}d;=k-!_!lns7q0skZtxclpV9uWeBnF4|Hb|O!h`<8cmIVa{)K1#
zg%|#X-~J1y{Nt@I^Z;t4`$|^|d@$8<>cLdUDIW1(%rU^jBiKFUA5pG;fs~a-I&!kK
zU+{XCk<QdE+>?ht3h+k}{;YyOYv9jn_ygVpGtyCpKXNodIR%R2IwMnUEh9%$ef<r3
zmX4NM+D3Yg6!7X4%w{Vzlj7<c5)iN@*pc>X7A43J+3V=(9^&W{fld7HqM|YeQ@osm
zy&S>oa9i9RU4z`6L)__!hj&nLh_8DDJ@W@|#X+<sz*C+Q7_bf6<n8b22u`1V&LQ-Y
zTLJ=nLjx%uLGJ%h8tfhEPVsZz0$wnqmv(dC;tq2EQ;dI`<Lw^|UI?Q&f;Y&VU40#0
zy?h-#oV~aF`Gx{q?!a>|_W6vT^_Bo^F&!5N`!GOxILl&r^yoItmpHw=2^0na%ELb_
zZv`O;kim05=9?h|0p_~|{9*13AqY?&zSDp?K6jIL#zA2apgf#QvHaBhH>IE6&Z+rq
zN*<OS%jbc87)bpkQ<$b7o;|SqJ;b5BC>`fS9NGi_u)HkdP+p9VuR)xY*Z+(BQaZkj
zPR}YjzMPKZcd%i;uuZW&^z{SdFi!*fFhF|*z#r!H^#<Py#QX->hXKmNbsOdnAOr#O
zh2RhK#}I-5^MtPvVEz(95XgM-ePzh$^Bti{Pszje7}jGC<}(<ee)@8`Ax`SYKDtQ#
z@ZAd-Ag8zg0iFJT*iR=<UvC|B{2%tyaeDi;V1^*T4Lqykav9Na_{b*aM-hi*m7?SL
z9cjp=>G(}L`4x10j7~p&JFZ{?LLfjra4m`RRj1=JbliZB)AvK{vlr^2?}tfr@^Fk`
z{f7~UX3@_B$LTn{*1+<o={Ws-b&-zK%U`48^z+7TI!-VDfR5A8pZHtJ&`x^!7j*LU
z^GpXFr<WH)OHHUpn66wa5r_2#=U!Z12RbfK$Gz#e0v*Tez*&IdISTC3zAp&3ki&QA
z+EBlQ`!GO05B#aY0}x<az<~MG(bQalIb8Snpa?ie!2spq`#d<nz6S&3Fs~>Mc=YF8
zPt2LnlHGDD`j0#+gcHGI(Yul0lt&9#&mgR95a_>=0Q1G)h~7zy{bSD^bYjHwB-ZmD
zwO=YB|CD74<Pdxb(sP#J*mprO!8zb$07B{1X1cs^?7?t<YBSAWph|5Z_$=5-L3lm2
znU<dg8xw>tQ=4gyzZEx5@LNa^E9w`x9`ax#gMhycin%_j2Vp`U`(%+OxDV=>@Lfw7
zupT`)C_&IC_+C^$8wig7(d|U=cvS!X1W!Z#Z9Bo;P`}zo@I$B`juE^L9pi6(V*3xF
zddA-(!TkJGu_#r99^aW$5e)>#-{NW~cnYeYK7z-f`uR!lBzQ6bfep>`*q#^Ycmct`
z!$}kb{LK+8pM%OJPsndZ`Dqed5het|gy5s7p6v-fi8y{Y73a$WUr+`Ce?tUw4#X1(
zJ@XMyC3rdFrwD!#)!P+<H>3HajNnJnJd4{0+ry0d3I2u%=7K0+{H-I*+fe_<-x|Xl
zfAe@Lnr|>ajmEnq!Ox=l_ar#>#T`O$KQu0O5xgAfKS1y!XyVTzxF4Da&JjEewc~Yy
z_oIGZMeqtFkI$#Ly!hjC*hj)NNA=c2=$X3j1iqC?@WrV9nNYi7J$T)`kl@8=evl-%
zE2`%;1fPe-g)YHak)7rQmq+!9&*Ru0UsV6TguEjf@8JaBg6zb;HnE;YRNljc{943M
z68ti%|3ZRG;{H!??7Op?;Mmtw6Tu}>J#-NK6&iQg=K;3=F*;xWB;=(LXGL2q?}f@W
zpWxWn{Stz&LH$FP;9pUB*AhGl*>6wq>nL9jf*(ctqX^!M_%4DEOigc;Jp|`L?Y^Jj
z*q6=`f@9wq83fP8>l1=wpH~-1j^u9;+zBlV?-Ses_1i{*W8X2@rzvhP3skONLOu=E
z^C-c;q4{?PvJ2~Z2zNl3OYpa-9fb+L63x%j1aC&;NSWZ+*BD;c;Cxe2J!~N4?a{Fl
z!9~%$;YV=nV;B2k#QH^1eeNOT52E=qmEhxOKEdsb^)MrTiI87BRc(};1V4!Cy@ue}
zx5#sXA4PiJ6TAbp;}?QgqjktHf~TYUnTgsB+n<8!VFAG_(YO;O_(n93$r9WSDg;5D
z;B!&Fh6Eo#=e11)uR!yW8^Mc_o~;Bwg!*kX!SVc@L~uNxA0s%Px6cwBUmsp2xEreH
zI|Sd1%Jqcc22<5Tc|~wl#6J<-9L?L`34R={8<|l1<93{d>TM3epQHA|zO1nP1#~`@
zBIJD#S0eanG=B96Zio6m_DP2IPrV-uzR5?(V;?|U2>t}MV+6tD5l<kv465fN1m{6K
zhv1^f{)+_PhQ=f9QwyLiu>HT$_<2akzd^j2;NK7*B=|OTJW6l{BtJp$Dl{IM(L99h
zS&ZhxSp?@t=R0nK_n>xMK=4bb|12c<JXAl51aCt1iG2iOdm2%H(<J1vFJgUypF(yT
z5qvEgM-~LXkH&=!$<eq7B)Af?GmPMx=zO%D;3rYL#}a%T)qf_zn~{7D!RI3RJc5_O
ziUOgK;L>PbEhhLaRR4Dfo{q}<gy6NPT(1b;i#T3);P#3_?LI`vmrR*C)$zeTmiI&V
zg*Z?-FqcN{C_wP7Xr2)#xG1t`HNi8{yrE0*?Py$B5PTOpb|SbfDwjXOg;Bk2C-_2C
zu6+c@KH!cKya4s9Jc19Sdb~z(Cp0dq2tI-OPXobuP<h)4E{1p?!ST1XeiHlwvWE?o
z8%Dz^qaD@%0)l@*$6^F8LC5k0$38AK2`+@@854ppM*YE_;3tutJ_H{|<072kN74L{
zKyd6MHI?A<DBn{A-;L_Oh~Rq2p4$XxLGAv8;CIowx|QJY|IRRU6FeBT(+I(_PeW!@
zKHOeM(0zls1g}QpPK4mLs6VeHcm*n#8o||3Js1-FGAfrf!A(&=^dR_CblwUf_-@qy
zcN07x)x#lzE1`U|3H}k;Sx9i~Bd(m__z|2Mg1<q>F9_a_=IsvzFGKUvAi;G|`{En=
zxV?tZyv>QWm@A_5wGhFPT8bpW@pXt2!FNq{D~dkB7ohsLBzQN<*M;DF(YOdC_y^SA
zq6w~q`fD=5y%5hNcnWIYa|HKA_LmSGpO5booD13cjNtRpJk~*Qaa5rL1b>eD|1W}5
z(L6H?<%8R63u<>hf<H&~vy9;RNM4cP@SA)vXcK%H8mDFizl)9?2>u?8i!B7lzGou|
z&VsHJa6992?MCHKC**@sy`3TWDb%m75*+&^tR#3Sn*Zwwz5tz<UlV*a8h4)w9*gP|
z-?zs0V_%l|{xs&eJor8|=FgEmOK>}bwtz$8GAgeu!LhGDeEo;@tU~Q>M98b6`m`nZ
zSJXf8eKM>k7mY{oof2BWd<?a39Ko-k^Uh&{&qDU+5c~>i_e%uVM(tQZaO`vb5y4NP
zdHW^7by0nOB)A*8F2m<-T&}yQ-I-81Fh7Up4Gw~LAudR8EH6RuZ>U|?5PZ{A^-|Uo
zJPgU(65I@pM>m3dqw`K6!81@j<MD^f6^`m9iI87|<j)Ws-(SV;jP>CA^S23keE<J3
z!SQ|mmjuWE7x+f-r>GzPAb38ipWg(xL+cG@G+wctf~cQx6FeT(1NPmE<*`pcNkSgC
z?;3(*-`{2g_dxUcW`e7s{^>*T<<I~Swh`O{l`D?m>}WjV`(fCA6*P{r33)Eme+me$
zjd&Ts@qHrfn-=TWL-sr;<Y%JePJ;WO_1HIp$DwgIN$@5#Z*ZXY$NA1h^(jbjOVo}M
z1b>Lf9l^gM{dxqKLHaikd;+zLGr`NzaR9+zBYSob{5_g~k_e9P!(<S=9?j4B1oub%
z`8vTjq4M4%I4|Oj1jprnOYn0j-+qF#p?PMU;OVHmGf}_B?X?f}D_(-Dq551(@Xx4R
zcsyY}!KlA!5%TIt-jv|)(Rq3^!86c!*-LOkB)^~F=IFecfjC?yp(dn_(^G^z?M4KM
zsUrAOr2jp^H=_9#uM=^3y-@u~qISR>-!H)ThcJJK>@+9jf1~{HbsLr!K>0=!^6Sw!
zJWcSqsQ+9e_$@TgG!uL;(*K#@ClSX!$gw@KX#FXK<^#<AP<yQ)xB%*hRD$FC?;8+@
zYN0M1g6QO7mqq4L!U&G02g+$W4!isVbiSeY%?`N$N>D*35A|z;KNv`#?dVhMlm~S3
zP!C>bKc(YPj|Wr&LKDI5r!eIu9Y;fx7W1BtLp?{4{6~TxM7)=d!=l1x&R`g(<4`|7
zzfaI{sQ)$;27wW+i(%bEUJfA$taKde!Rvv!1jp-&g#^dzgynP`>TiL{L69Q&^C?WB
z_c;&q#qFp<$oC<6yne^_e?)veA&;MPG9@^EF3K8l+z<C4J<fFUu%6`+52WL;T<g%d
z2q8GWuHQj$4<x^f;Q0BceFRTN@&^c>fcQ~@Uqn2M;P9K~Fq|Pces1X;!Le_$D+I^S
z8(k+jJDPOwAP%#GZIc2s1)+`LPp2^DH^Jf8ZDC+R^9s}f>)#SW5b*!ial1#NeEI3*
zVY}exjg}C6KayWY@I=IA2!0N61%jVJT#ewj5!WPm1>yz-uS49J;ExgCNO0`4$d=$A
zkh~k>xc+g!iXk}u275Navyh%*Iu1|mc%HdM$6*^_A9QU5$G)3}2riG-1M|`O3ft*|
zIKDo{Tms|)gE=9uJcTI^1mA>sG{NQ2`Xrs;T8N(}xG~~42_A{~JAxlXe2m~Zhzp=~
z7AzM;XgNR;qvNnXuON9nIt~$9o>NTeIF!fFV+GQ2C=cgQ7$WI7ly5@%v*<WNH2Jf1
z9Lj${k=1k@BGjyu209Mq@q1m}h(iW#X@NT+j1e4PCvd@s??J%w)~Emi1pkiai=_l#
zfclRt!B3<60ICEJLDv!M2rh`Y3F5H5&{BqGpF1H>gW$)Xj>Gwf9o1V9!5I<XM#o`M
z@wy_0jzc~8dHpzoD<D0IbR6nAgzDii9fx|hAo+BHyCI%M$Kia7*H>rgIMlxx)z4*u
zE22uOB)Au9@5cn^K<kng#Bn{tcNkz8pyS9y8Xu$MFw3Ph3Z9LJFKK{)`wzC0pWxU|
zQ92Im2fw$loZ$F*N;x_X>j9Tbjo`RkRK#()Rzc%HaHQj~TzFjj&~aEUFDMMcPC`E}
z*FJ*da%B-5+nGmjZ0A+Pv7O;l*-~ohIJ6VbSIu-B+PMqK_YnHAox=pjcFsTzjoS;`
ziG9pqj_nje^4Lziu27)k&`#JkFs!BH(9TR61^y<8e6gJl1jlv;5FFbXNpNgu0^-=t
z3n<?cbR61==g)I=9NOuO<X_NnG~{S89dsPZKSc5)bR10qv=|on5)=ryK6jyv=O7O4
zq}MM?ClAL3eh){H;OAi>K+qz14dQwPzmK>D!QUaik>GC;cP02B;+_N_Kzs`whkd~o
zUH^vBaab-kR7sHpXF+@?9fx{cke)<34)yRM`TYdP=cB`PoTdjR0^v9vhX_BfoI~(s
zNdH+n4)uIN=fTT#9O}_Q^2G$#K)e)j-0q4X4Ga$mZa9T0t#o=|zWDw|JHfe-J)Z~;
zKA=bo0|dwSD+US92RkYVKM0QRlZ+GG8V&*&kUs?6&l%B##rzjOli+yW&Oz`oSZEN?
z>52mD4Vg&eTD0G(?`1$PjgCDDz8Lk-V+3D^_#J}ddH5y4V^Mwf6Fe93`OrWRu$>nX
z$G(R#$Je=@ggoZ^34V4;E#(ry@pX6OUpOzyA4bFa!SYcA$Jc!a{=&}_JOt&3uQRZI
z{9a8xA&>c|zi<xJ4p0y7Qn1Kt|HA$L!jBMqDO3W&B|1(&-`4(xzb80a#!`m<!e^rK
z4ef{eu{{4@xD>&4p^+fq_aLwy!znzyPJwNR*8(sKt`%V*>rI44r#O9iW$8H7g#*_4
zf71iyolyb>w1x7J<9=&JaC0aCg74JkUv`Gkae6yr=s3NdOAv<)-nzy4Eh9KypGXq?
zK001WaQr;8Ji%R&{b~d+L0pUAPZ8HAcsJtf3H}{%GlEYbj?0J3%ZkR2Eg{c^IDU@@
z%j5e+ZiM_2B=1ddNyPmLj^A4gCb%k+$MYr5cOBw82zd*{cN2Uw;<z7SJzEe@Cgg(=
z$L);e;}B0L<njC7Sp+|c<Z}pKfH<Cav3~qM+hrsVn~8qD!t)~J^!>RBwI|#_T{wuK
z9he=x9wRzVuLsvNl&9D8zw<#&=O`LFd!{@5hu`S``eX^6YiRmt+9yi>;x&5uD=5>S
z2Ekdn28X~5r}75}a^RaKG$sGv`;ms1ZLqJfpniZins|rUqV6?K7lS>>(CKQLYfkU|
zbB9d797Mw<_utZ^<@mG`@))kepiVrWVnI!`BZUFl;{5Se74ZK`ABf~#i1avroZb|r
zC+n{RrF%l8$LCRu4Z#jPMQdV!whgdgAb6pSM8H1G1Lw~N_F;hYCln#`FGA^}p%7gl
z^M~{Df90=)PFzkXtq9n{yvh6%0sF7~W#PmD0=`c;b@XQ)fsf<B&VS{94CSu`BS8=W
ze{dcm^S=Zb%pWb^!QNEJK@}o`0ovm9czYA@|4Lu^m-M*)@U|YMpEeBT(}B{j!wWPb
ze{@Kx1v~#${sz>c_pX|f6agDf@Q3Zj?cWL*w0}AR?t>tXDx{efImO^FPLBz^zWA^7
z_#d)Ds2#C9nZ6rD{FnXKUMK|`*dpL?4*0|AvHgr7^Z&|U1YKvYMr!Z|r^m;?!Onl?
zj~0SXNKgc9;W`ed$NB%whc^CyVIWG6H#j{$o&${kul!3<{^yXO2-xy~Kb#)tFZGx5
z*P!xy{}1)Q>@WE{ZJElr0i}oe!&^dR{%cVFqz`B80~<egJ*DkWdXS73wEvR6Lv$)$
z919|OoIl3c2e&MW#~U_uK_!j>+TwJ03%}!r_vuAtQF?j?_eoh_09XMhs+oe*|I02y
zVJym@Oz(v9uO#Gg`7w?L>Hn+$$OcSFP?4Yr*uq;DI6dw^usmem08vDi!Cwlc11bk$
zG58Y!e`I>N<|EI&08M?Y2yF0m291Fqm>+$BWBR|+ha>y({RNzcOi%l^Td=E_yIbfM
z_mu%M|C0~sRSL3e<o}mGpd0St-0^u<6MQRa1tn>B4loD!CuJ#xX5G`;XplIvftuI^
z90apblOmCi-(C*n8+AmJn;~=wH7N>3P(jjOT2kO?l+8}d0r-Q3zF4VA6oaJOF+e9Z
zDG>WI2C@(2Dtn**F$FkD9@(=6R3LN6tfW1BV8RA6v*~=40#kkhQ@E)~cc4FFYNDkW
z+mwS*Y7*E5K4X*0;d7=_O!*$y$x2`dH&;oe9j(M#o9H|qE4fjVrW~U}AF$%o#D;QM
zXliV@EG1+qbmJ;M?K+h!9)9Ku=u%2-p!1$eO&l^vtfTJVBF1NsI7v;q9SAgFgKq8x
z2L{-Q?NmJgXRyHMGcAUiI4~udSOuNi!es-@Qv~F%L<xDGbO<h#;-7^+rY6N40-9)U
zf(^JN^`UQPO<CyP7Puh>u7e>HhYZ-Tk?)^e33743#sA5vkc&W82_lsY67{J)j==jW
zYS%$6E^a+OgQPH7kVCCp8xWMN_u!Jb%azawtfEDWgJ?}!G|m4pEjrAf79|3r%wW`X
zx-g!^`C>+iKc-5YG+(UeIPeX7h$aK<Hv#ro*8tDAz`rr}HcNA83<N6Wo<TLhyRb|R
zS9;ar&%M_`r-}n+(CVZXmfr-F)4B%q26muBuK&NZfd0Wgtw)n9{lVflJ*Ko0gZ>Ha
z0DsRwKY$u&D)~TBtc_*i{zegy`J-uLL1kOlXmTBe-k$$u?LYG2I(lzrZ|o2QS4msX
z!+$%&rD$0KrEM^0gT!H)WAmxreHeBfYElC1PSm6wpmw+oVT((e0ZYX10+-D9W&oeX
zz*jM7e}FY%p8yW2p^t0elp2i*k3%pm>W*M+#8-wGP?MMpk}AahJrtWk3^hqp1W1J|
zVZG27wi|RU4t!j5*>`|i=mQx55_T4jE80kh!{Hw4H^3WkYzG5OO>O*4ommBKs{*xE
z*;_(uFEsk7iQkd;^V_gz1JC1%$n$sz97r#wOy&{>WxoXlpbuqk=tCJ53=~9<nq)7=
zZIn0yCLg6Kc`#QzO^U4n87arYv9seY98Y}HV>pxt*bICYzr+Lh-XXcR-nOa4H1mK@
z^eGF0r+MHM9XOef?Sr$#lwWiz@QV&+iRaX$SX#TpDpA50fzirMiRPuo-lScZgmWY%
zIRT5~YeS@f{c@FXUV_ued|Cmy;^EWMa2mlj02j<a&LAmO%nVF-RHh?eVR`B1HC0_P
zwxAo-q+nTU{7A@xX(!UKHQAD=?8;QOoyR~ls0-w$S}XA(sERl+&Cu#Delmm;R}j}h
zc$WzkKu@k8%*Ie{^dh6AKyjb|pea!U<!U6Q#dZ7v5Hpi|1_gzHAayz?xo3amxQ<r=
zF-<763<xQ~BG5D<573|<*#1ZZtq*}X=xrlh2VQ`Y0g~{cB-0jf?XLhadhwH7am8Q<
zYS5kenJX?298eQKPkExAk_I_V5#W)Vns^t(NjS5@1;rG=trWcj9Vey1fd=|(E$Hal
zPH=_`<E0&fj++Eq6e6xYiZI8dv>4D!sPWID*ZxBUv;@~)_!URk?`cyEaIj9hqXfpx
z^biHE<)Nm}z_B=CJG8M0;G{I#$@dvod<)1&D=ALw7&sMz*!WJEZ_*AYDriexP>67l
z8HFn@8zh=4NUtzH&(h-lcut49x4|qyYE)*>H-Hy(E70!GLU`!w5SAmZ6lkUm>mF@d
zGFl%(nec)61e~Cf_R_}KUO2|Ml7negGu72-XE!iR(HS1(RNr%O+Q^;(@F~E5mpy(i
zC`He+|BhpUaV504yVEmE4|V2USkGV{w65$q2n@i@87e#7H<8o$coUGgCj|TeYp2II
z7~HXaz%e@A`JW2LD(q?eaDXI!haEGHgSI~|hx8jH-lx^k2&n!fy)EEmAq1-oUNC^c
z1{WmAj{Uk~vT#koMg@Cd%3v15^W&5lZLva4Qbc~$p^|K19jsl@ER`WIsj;PSilKzm
z$0{*~*6Jn|!AV6gekAl3oYM8MMbwADc|9!Hw0=C_8vxhrP;WViG)U3|-L^919T;(Z
z)THfVvQu^%Bw2wxEktO7yPzOLOK%02uqLPgFuLAONdYbK@PBJ`HA^dAHAoivf|{rZ
z&g*FAfklFapia-ZT=9b-DVXrAsfl0zG3UjA{3uDWUxE3sB74d~GajNcfQi0mHE2-W
zpN&9`B<-Tjw@GFqP&qf1X&3CF)VuHJQzfcEH|9EU1|$YiLb0PWxZ+L%#XCb|M;W=|
z)PP*<C=*w_C`^!a1r9J;%gWJ?ch$fR)2>Re0rT6Bm((94url_-Zvjq^=3e#b^@iL?
zkI<BHQ|k|EQizyr&nU=!%HG)RVnQrj@z;R`IC&K{v3|OOdd9(MfakSDBT$Z{GB`ow
zz6(gNz;rw6ifQUH6~Td~D^&zX+EfxS!ZhKDQ0d=^L2K0Ds!Dtdni{n-H3?{j)=-mD
zrs@&asg$<37DF{y;z(Ba*iP5?A6sO5bZK;Ieff~qCSZ=FO=~?8AnLED`kvV!c1jV&
z(#t)_UBnsug*XTM28)DvIfsb2I{W(vgot=}hln`)M~JwF1_inMhin0R0sj8(t|9Jj
zB2yphR++xd4li$(0_^M^0zOMkQzjlPA>!{2Wc>o5dM{^xk)`-wB$WSGd657Q5kGgJ
zAp+De2>+XOZr;J@js}Hd>>V5o4fF60cXx9HAHjAG@ec48adQuJ_jhymclCA;76ISV
zrWvjRN<wi3Mh8<+)-+9?fuX^~{DkWp%u_<N<pVX*UW`gj97oLr#tj$|H~(DlpaZSM
zY7jMlN(xLGTnBtWKLb+*?MWFuxe>5SyIKZYaae4ym4;g|ztd@h13?fZL=a!d;F*Oo
z6$Pg~t;uRICBe%ev=lP}OC`3Rqd+Ad$F$YJ!1SbIkdy}dBJ7r6%>fEZ<pcZAz>YP%
zDv{Ktt#&QIMTATZj1|YjNn2A3EWC9Sdtz%Dair{Yq=+upx*mwR63&CnwPNd-!BJ}%
zGuUIJCO$+}GV=>46YT<$HlFZ>7$|VuDUi%4X^WVqK~g+zw18C}SE3r|(YneZV)MD;
zUri16sqqiy9P!zp^1z=E_~YY>9|7sfDNu~I=GqP~?e1IunFJ?kH$-UHh0sW@J)3C5
z3L6>U4_1qR@^uFJ_8vs@1GJEhwlMMl5=M!CDwYajM8Nr<n)qd^u>Xim{4%{X&`lhT
z?O@g#dB_l|41U36DFYg05)=rWDVV{QPb>Bl8&}*6kO4RnLd9<d6Ic&qG`m5BG)x@&
zu(uYRKljsa%~H`59Smq{1C=BVsy6;Ls2Z?n7msfXQGrz?avNj_*7oY)mjW7DQ+&$e
z#MXZ)0!uo%%BfhOf$y&x(3JN-Y7mNV<BGEaHTs`+i2T3U(X#*~hsA0H+n(0H=|W2(
zuy&RHzm=+|6DXL<7S;w1)7MMC(e)DTwg<Rg5<}NZZt!|(cq(D<0x*6<;6>5<>DC7)
z1v_vNh5I`FMO5NFxIWWLnlFY70}V*D9IPF>>nA>V{X}>9<Z<XGY{A}_|1dlzZl%_g
z{a<&YE&en)g;jQnz+^ClA5Y8V+HUzg?cv)KwPFfKjy}n%70WP?cb=;~S7h<Koo3Bu
z+@~}JWvMxZnoDPZjve!oQ7d<E$(CKMY319wZ*G3PZkxt4y%oLXE81FD6r_2i4eYV%
zbFnKQ7A^1o$ttySyngJ&kM<M4=A3xC=f}X0i94UNqw33KMg=)UozCSrPgXbGQ)C&l
zxhq}47~b_&D#<aoEOq0nRR3c=XIBVs%09$nU6%KlZA0rOJK0PrX7gQbr`=q<j~p2}
zDHYaa!<G8FBkxX{P=DUGqmezV>&4aO_%eIkW_VObe>_v%dF6zOO1|7!%5TXt!#y3W
zTx0Ay<|?DkCakv@j_TYRX53!o#4vGiF+*w9p^w*@IUZQfw#d;x#MR6^7@MiZU^ZJ^
zuzA)ahU>A~7rJ?(Zm-uYlZ<Z7<H=EbFyuIU-|lkF8IoVNj=$lM+<0Zt_$`i9vy`!s
zaR)Pt8ICu`UvnCsud!R*&uCRpqc9T1bxteZr1i`19Q}sH4PFh-4SWrA8mxKRJ?|Xc
zRqdMnP-~vm*UeECpY|`SzEl5cvmvwajt6hfeko>Vo=BJ>a&uT`pjKY{;LC``t(~(h
zSZp;{{P2wPDpqd#bo2@1x?Gzz+D)#k9Gl9@JZ^0cp8LFFuAD_`*2Z^-cgH*tu}^R7
zl{8jL>y<DrRcqOh8K|OIWtAB?Lr1`@)@(N4qXss<>V=977lKs{oGGi=SH##RY^-D(
z$hmdZwN74C?XdGq!_WL1DFS>i7zOyt8C>~F7^>y_7?V9;G99Zd5^lI3$R?ZkPPRiJ
zK{Te8{UN1APKee1X&__6lZM&HssaUM)80ut3EYdQ3^~%VBxh-M(Tz`s558N*qO;56
z(Rr4-S^b?08S7RW%?M8t@OrHCE2pHZkT1>uLcK{>*CD+}D{TGqUrBy8ePAlA@!O`x
zqyLfd*z(dhg*P@7nzp4z4EN-mJ2Vzj;u-hElkY0!AzzODM-BO7F`oQ6-XAp-?lWjO
z$Fyc>xQjChdB$*NPF9)C7*%GP|7?49E@$9whF0$h!Fx)Tv)Rq8hV&9@V~(&l*bTL?
zH&Je}o4E|V<@aE4aE{T>%I9mPT>f~+`A#dtWjW1TbuIik?H>c+j}6PY8)K^AC*lCZ
zXTOOQ@RRKs6PdNs1^n>x0SP;Hvw)$UaBni9$4vWH-4B><PiAD6@X&j(=boStW6GD)
z`;jL>qiDY($AgeXXEb>=qZ{<hO5X31>6+IiZYa2KaSb<f9G|r2N*zWg`7;a=?AK$q
zC+NpKXkgwe$tRg`Y<I4UxS6aadpvu8%#wtqF)j%_G0gXDHD|`&I+D9$fM2n9EjwrA
z&#R*nTW4!D{n}C;p_ujSDa)G!mo9Q}L?@rsDt;>*BxrPE;iE#yG}~XD6^05wwi{k<
z6=VAKBz>j-H<_>H)@FPYLQ+Ovy@g$#q8eF6LD3~&i_=c_|FW-o%Ja)!>WK9xjSgd%
zd#~><Pr1VB{p;w&zM{79FTdYCec88o($ArI&q;wmqw|pslbdh&w4Vz;xkOa4MzB|7
z(Socfwe%kkzM0DvM+C=ab3MJev^(QfMM;jQ$I!<a>U*-c`8Fgm4t->Oyd@yTL*sBu
z{ZjAQ*Kz`{T`ah+?Rdc6^<b;`HSu=84M!RrD=lWN=yI@)yIs{R8KS!3W`lfo=iFSL
zM*pY^9&M@hU#_pSmI_(NkQO@o;=UIzuNj{^;(fHiCr@45H=JWUe!xvd>{@nDkr{8(
zoLmm0hjFXr7xK2=579n%^N`02scRXJO=kN!t4Lj2Wgw*@b4^|UVehGi11=WNe#C`c
zQInbZ=4pscH$(U<@$Rg^V(q9|wSuhiBl0%dZ`}n?a{rXdyVjs%bX|KqLm>Y4(MiGa
z=VHUM8;TpWIEQTG7R_w;ynNZJn;Y1C+Gu^;?We^Ki-)Zbn`q`YaCJ(#j@+KTkkh=*
zKlh>XlGbIz%uOqE@3^*#4vQTua_nYnV#pPiTR1mzmV-H)+><$rndMAp{^oPAU`u(t
zHFu{=qyyWP$1@i*%iNi(J^V~6?rT?S!_$rp@!WOC=V&VhZ|vp`EYO~ubwhG^eW}%A
z-L<^&+&?Rp$G!Y?n0xoh$J#PlPhCXrYujkECG6H_i!sVQI;U~w;zj#rFBUOm`^~yr
zC3jNSa`~`il}c_4cgxIM2eJ|x0x~k=CT6EoyE&NswD0INFB^_(uiKa#Z2w~A@VY!b
z?N3{I=lq<vQdB!2sP4Kp@3Hc@_6uUm8&(XjKI*qX`~G#~?j@|MH{;shWk$udyGELI
z@94hXu!rqS+{$-9mki4>s^vazcymnm>j%wCxv6QBp*&(6>YX=Dcs$tX;5A$Os)(0V
zjiUA%-4j`r3siX`A0INEE49R1<z}Dt5}vJt#~IVMaw<`DIs=w3T*Gr-^32N_{*v-W
z!5dP1>WuY#MsLR+)36X+A{r;FA+I)nP&H+Tn{LC+ZTkAvj)qF#qRt#(SR8f6A?cau
zX+u-7<CSX9Dwnc75#7)JIJx1*sRK7k4!=#@yrTK)qu;(R{;?rn@)f&<^{rP;tUI?g
z#<cP4!T#avsc)M!l8Zk7_H>!cBV@i&$1`Pbo4~w5f0q|88MEb`gl3Cdzq%e$=Dfe<
zzMpZ!eZN(UxhY02N$gwgT7qT*^y0qXX5QgT>tB4gQVg~~TKJKz%&n$9vx@S{&e18R
z@8Ws(L$^X*cdtBGI^U-0)uu2;4=-U#;ez%huMZVw1>UEu8Oo>%t<6kiVi~nKUc%h6
zv><JpaLZC(6FG^Qm)0-PmI6BMI(R95fwN;G*h^JyZpf>#9^>L-@Y)kgk&f9(k&cU^
zy!J4^pDdMrov)suNcU!d&H4!SQWu-OMPHTgYRAMso%uqZWxGkyfYUsYlk*C#j0TnO
z+SZAI-BoNnaW9rwa+lA}-QB<vH%nU(be8gr%=iHhpE*ATk}o&3bosEi&aK`*>)NVh
zDV}r7lT~@T7ln<z(f+YSiM#bcho%?nZl>H5gEQFToO%y&GhPs8>-V@C8pCB%#cO=1
zq$u$8()ivZ2}}|tSw-HBiuG1qCwljL#fKH1N^8BckJG*K%D#=>4<%KMR5v!-vIrG)
zQ{!I5m@BJ~Fxy7tH6|SAG(FW=Ewnv?vR}Vph2qNmdq)C7)SBdT6UQ>Ioo-on=S0Za
zg(r>+^&6;0>U{GuZEgJc-XHu*T!FvdV+*sdomM!;$#(r~_>%E%W1~Is{`C)2nCd=U
zb=5AmaXm15M@mmz!_i}r@wOQzv+KZ&qIk5YqG5#*Z+zfknVIh@9TwQeHPo<HbuC}t
zy}HzB@o}dOUJ}}(xtB#02l*Gvzs^0*`0dn2=`W(|YF);hxBqn7E6Z$tQGJ1L@wPoH
zA__GxFOZ2=e%I|%c!=RAuary7qX+x=bKI{m>m(^%^h&mjDr)n(R%0qUwA{mjdxCGr
z1GdJ(Z;dxazN|6GFxI*qrn6$N*P3R=^*3`D=<-WvXr3AFcgt(J-;ffd@jcmaYcRF;
z`Sz`9pC^MY@}BdVM(68#%#~@ZIub6yx;QZ9+tu)V)raAdCb=y3ZWU^rH)~|YIE!lz
ztvr3c+2weM^RH9|6X(UMrn^q%{7AV~RC;LbWKM4t^QQHDqrMzVcGoJ~Tr>K<K22D9
z;V-6rTNm>FG8}uF-XJ`q&$01FZyyVT?K&rwi$XgEW(PbK&9sty#ULLm<V7t$eS@pH
za8yuvc+H`UmilX~uW2?mv2&^D>C1I}<T?Lgj%w1xjO;wtGAmKtosn#}=A}1Q^+uiF
z%N`u#W7y_$?be}J>2~uq#u8Pz7hF3PlgXP}YkS5vz{*Dd`uqJAF~0J_^L~7N&1<pp
z)m4h0ZA?SQow1xA+e^)ziX6v7K6o?;_a|SKyF16^jhlCmYnb{^UXe9-<rTF>Pi!^_
zQU8>@^n{GD*-4qB?lsrkR^N+wv{Y3xNWy%ESYlzSDDS{R_t1S=?7@%2!%YL<rOmTg
z;^Qr+d*#DNu7=&q%`@fCKfEcwuJhFH_s`yhjSM_F)evhi#~{q6U9i6L%GKrP1#D*W
zmukmT?>L0mZHt`!w!R=-Vd-qHz*&M<n|iK%@V6RZOR#%jG4u27(%1Z~r#9E`cz)E=
ze~i8Ugzdl<rl%6u*I$X2KGP>~qw{|M@tb$gCx<#bU9tLn-)8^*cd4tM?pcxg_U&Uk
z;4gLWo98Mwf2r7B8d@LnN;%l3eNeFcLZ`p$?Sm`gc7C~%otu>$Cd`_D`&ON@$;IW5
zy4M%{I`E>+^Tj~><&R^lTc0Z5uCtXmKOVl)@ASmE@POh?_Fhjt<_LJMV(q=q=M$20
z_@rvbO^%UH76-#CPyN`NbRMfJq#oVWcT>yJVWs-v+gmn^iIykNb+mVsZ;`Akd=TNz
z^x-T^jg+v6O#i);b;A{p7(R2<JrUGCxJ~j*(Thz2&FKmW8+(4umt=2q-*mvfVb&61
zFEcmG#<hzEB;=L1o>^{d*~PPF(=6#rIc8>38S=JF?A=2g1(`0NHr8DePKmIM2)V*p
zpcr^#pUFh?Eb-b%3zoMFEYb>Z9WC*QYBS0cWl|J7k)*0=t9PR4cH`A+xi#4uFFeIB
z58K=vUe0r%By#M7TK%vePm7(w?8`IDc3Cgwk*@oFcdv-N%tUjRybTj?O<HM@6>HEo
z$A(R}&dg<X`I4QzB|s_Y*bghtFw56IAA(P6uDbm4Qh~l_SZHL?rS83#zBIk-dfM>r
zYwpR@_g?8-ZhzOZ)^rc6hR&Yl8fWiSwlk@7d3?X3Br5UUGc9iem32v3ecoz$x!RSg
z*AG9TW=el_k5_%ZtaILj7l#k_^K35=c-#@psjw|_)(L;z{CvxTkVwN&v;11)u+NJ=
zi{H9^`f<2%npuBH{#O0Fmx```F<ZJ^Q70_FaNR;`bCGhNS@BQnan9@4PWJR#{^Di$
zw8rK96%%*9r6V)5Qb*%{f0$Q(#c;A+NB#A~Vy90JJ+`=BXAeC1e$pvLuKQL-gy=@W
zHmf<ts;6JvX0VMmjbG;#q1N1a@61;QE0bLZhk~~aWu+=FJNy0V$WYNfqasfms{mfz
zWj<#cB?RWzU790Wp2MQw-2cPHaD&diWs(;jJYP7lRr-jpt~lGSh(?bRts8UZ&n<nk
zqU2M>DFNfvzG>pKhJDOsZwOwuJS|tWXPNJq(6aRFKi<FC((<)@)q)oS)dkP9zh@nB
z7L+)&qa`ab%XCgaY2GCJSYKRs`n~eC>$c9nQJ4_A<3Q&9^4qm0b-@Q8tuRwId3zy9
zqQP(*{}7MbD&O(>aoP1>oFfXD6eH}~^3R>;Z@pbxZ&T>oWqE0>-o=c8F8<C^W>Jfn
zDm9MI))d1N8)TM!3Ay+rC}Gxsf_&3}$<Ei5AJ?8YoOx!t$>aG5N0R(frDO}4?&aT-
zqpIHCSSo1eSs`oU7_{ZcH|>Jk@2!u%ap1KL&HtvQ@AUrCWoo<dt0NaCE^J+SUA60Z
z5O3I~M{oR&S6p}(G?@IvwdazXqoJ_-?us=^b&o7dx8->7KXh?^tFZgZ&UYd5_B@}H
zLgI}Cwz-umxV9ep-fCNaG{QGyWP*BGJ&WbLN&T1p8CLFX!3T9eS3L95-jl16{LJ|<
z%Nmm=r-X_xB{yZtub3FE_kBajdvKyR>3p=ugCjMMf7&b;4Gz?uECzEp`{A9>9)IyH
zq^j^|^^}~kvkP>aTqMz4AebTX{q};TZMPL(t2iyZliAyJT6y1|7gS^Q$;TxXBOGdm
z`pg+yjmO5U^7L9-CvO|(Z&!S^``o%$mn1R`U#WC9W_3%a`^hir&rz_}w)(o<(PW}#
z{Y30hwS8>6ns)jgo^#=g{GxfG9!y2RHDtgeyM-b%TUneQURw)(4#OXo-&>xP2B+nQ
z4d(dFcYn?M?4aLwpUw&GHym68`SK?Dja9`yoo)HH4o?}qZ<;VaD~b7N`NI9$#fZdt
z+xY$3YG-}B%KPodW|Nh*@yr_q*1w{(v=#U3N>^R=dggwmChdWF%_;ASm9w`+fB)$w
zA-2v@;?`vje@DmbXXo1aomn=V;_KrtT$Y#K8{}@oS<9AnVbeDL9(L!Tv-_?xh^7|Q
z{8-i+@aaa=rzh#Dau$U=de2nYTbz?wRvqy>m!WmAY}ndO!~eyez@2IJ)_%J*6o>nR
zzNUP?d+Nw4@l#r_-q&3`D%i8+;>*p~B_|bIA{=$zj-RyK-mo(I41;I5udvRK&V-4C
zxWS$MT|X3J)b-!q(`d@IF{#S#on-RAb0P!YVy1=5%u`!@9Ddx-@>NiiCU@VJio}}x
zhC;jCQ<$R`C*C{j#C_<VQev5ON1`O}*LmA1R+>B-GfqCNH@q6QA;PY%QN5{6>a)mR
zld)ve(!B@yy&@Q9Fwe04?YJXnhnKu+p031vxgz=elf$aZg6&V}9MH55Ef5%}X0hI5
zar;GZ3`2d_h7C5Yh7<L3ozzbcUArW3R!_}f#_gs&iDG}=D|Ow}-6?0E^|EMQPCM-{
zp6q+BPF>bid2ft=d)$rryUn~_<?df-drRJM{fn%w=*o-7cJD1S+H?4`jqYiKt9_OO
zmA^9|Y+m_&cV)lrF2fW*(>YEL1$kaxcNO<cR=v`5>`Y~hcM8?**tk&UxuP{8H$-QC
z%Kj3OcJ*=gIo7^SQZ_CZ-OjJ{yXY{y^W}5SL0@K}u9EL&g04dRU&lH0&nC_OCUQsr
z#2)?#4jqN^^E>W~T@2cOd_2-EJDTT7<F4-?=M{5R^Is~T8D74=b5!AX*0&{N7kaXO
zRxwT_&#c*DDv<nXbL&ADPL{S<y=P~Q?|nTbzmcs%@#E^YMQiF=ObS`5lk?ZN@G0gh
z6@STRGAcars=Vyct<TC|SdRTHku(k+VBM@I^HSPMrQ_L~gYN21%S<M8yvM8^rS=pY
z?%)6R!CCQu871kHCvN4OP1mvewszZ=rIQI`&w1@%@Yuv#n*MS&5N}KvJpKBW*zZNP
z_kK5TXUi#jHtCePv*6D&ctY%CKiRQyGgWBQ{OsT_85w?!`PNclI@hcWHYXYg+s^x%
z+mNqWGoWI_{>G{>WdT#Jcw4^5=5uF!{ajWjYNT|yJX^57Y3|UewPM^}&DL2B+~U+N
zcMqjIt)H>J$n0=-)R(?;1=asU+M9sY^nC&UH<d&xO+rX2r8!ATG)QSqijXvyMh%*f
zL`h1h3`J!qNo39tkqi+TLS|7yW<sR*?0eVld#s=S|L1w%{d7C$e9qcyuf6to&b?=!
zhfD9Dh`b*2=l##TH4=8W#~0*wk2@rEr|x;bT;^@v;Zn++1J&zA?5mGY{b)8}`Kp0~
z`F6xQ6=@6`-gv}IX6R+Jnn|fL`LFWkx!r%cE?QyI-2+?Jgx4?elX$+R>BB~W4cAW0
z6EzL1cM-p^mvcco%V$zmPPMQ8+Rxex*2*>)E)o_jnWy$J@7!IHSFdfBR$iOsI70v9
z5lyk0&Kt!B;xp8g4U`20gZHfqoz?VFpjaTBzr~Y()zrOV!`xIhDsH*4>e^Ekv98Vv
zO)>t~)vBVQ2PICf-0<sy;lnX6qO`??x20-^2h_}6(zNoJ*<r&gZ*v6p<d0J78eyGj
zYNVX9{Lhr<{u7U=3A`M2cX`BwORloU%lz}cRvfJi-|bU&WQBz5!M?f<X46Kj%(mS;
zU&UqA3VGoOlLrB_^jD6|w0X7bhs_UB`PR(BT!Y98MT3XSCI(MknQ__a#je(b`CHEI
zbn54QWWuip2}x5IZKywJ_IRYTZNb6m#cQM@I=|@H-RWbu?!voCUi^y(h<qHPcwR)a
zP(l5fWO6@;wP)7`50G-YXX}37_KkvDbZ)uk1{eP(?(U3NGZcef>F!)S-^XF1vHkPx
zqWB?`+B^HbH@f6A@%o{MQo2w4Vup0Li4FX4=;_Rs$t~W~j@h463N1R2T{1!9hg|27
z*%zLMMp!SunBO5V@S%~)?VnR(jH@h4Pl!&Kni5)VEPu;*_KvB~3)(%7d}$eS-L&8H
zbKbtj!>+}a*Tt47Z)+d-+xYOKkNzK>Hw$=qq{e-kz2N&0W7nqK*x-YM-m4xB*}b{u
z!x@A1>9UgES>1+xXK@Ta25t8K`Eugoje~wF&yC31bf4dJS+(o%moCSYF9)gDez~H$
zY^!<d!(l`BZBDU?@_jGtHm${@^_5iK*216V&4b-OO}KR-Hd4Gjt$Du6i!3$I2_E~i
zvS%Bp${w0^S$yqacY{&E2IhVr*P5jUN97GZnHzj>d!gavL9>jd69Zbym4$AdfAHc?
z=%p8Rf=R)uQ&&}V6sguP+`4H*lf;zOTcR@8Md(hkHp+bR=lM>RxB8osZ#|N^TJY0o
z@}1(X#c$5;*;MJ%z5Teym1h%{Y)#ND{;B@-rt{_SvZZOK<Cm`6bZ+qK$N|fw+&@eH
zezX3k#|4${5kk>%!zO;XkzngG<#Fa&r~TEFd=8Imk2rRqy6SP1!>N1eo2=Guken;!
zF(f_wlID7&3ehK}kEVyV=MNSff1qL1uy<~bhEY47oV!(i|E93}{kRcr^ZIR!3)x+^
zTDkpDc*QW)6&JgFViU7>PYI7KOPf1fYv}ypt7Z+}u|af|OYrl`n2Gn+C!MT$dEt3Q
z|McY=5mtt;WZiXA5^58}=B>Ti$HL40%sh=X%>&(}PPA{Xom}2W%1nOGR+ak}TJF=g
z)ftu++}gJ2#4dFu3sb>UuXiW7s#m!w@7|{{W4x4~-SX2LcZ^aUdLdNRdEbXVdWDLU
z)Sr8{D|dUjb)S!rGCIEQQS_`WhqUW8ca}d+J2`faTX^HGMY^-5hV5HE)2k(W_IztE
z>*@O((|$i0>X-dzk^buJ*xVLV)9h1YC8aOkIaAuXG2!gz#<N@ZY|u&?`_t*rTTWc0
zyjk?fz@5W_6C9TGY5q0jrtlD_ZjDOO+wF-n1G@RDMb9^LJ4`yRR`9ydo^dxee{M~6
zb@c^KA32fBh1q=47YaW;-0b-Cz|EKbMV~%s@BIAb<_~rCJ-?5N+~?!yj1`23{HQ)R
z*rCU<`O#O6`=2)vPhq;Zu*2t`q{j|6((+tyKWfeDA411my;N1K3=eLQTCsYtxY{TS
zfw_6hSD$<@WB={rb=#aYy;Wa_+7<A*%c}N$U}v|lar%kfYe&Co&z-zeBXZR?!`QRZ
z>aj1}?+zN@(7b){K<fz?=kH&U>eGKqowS!ol7XyXqUHeA3+{HZYW73MHN`KzX7$8)
zknYnFZjJj+KG5~Q`g)zecbu5IQBli=*TPAHD!cz1SHAzxxDxGZ6D;i_yM5fNWhJ-2
zdus~zzdttj^J%?+z}?4PWTxiJXsdYk_gZ^yuE>t%-bL!c@o}$Hjx1C>7kjf(TiGtk
zbDor!*ZCdiWOoc2eY0}Voi@=OnvZ@=DbBGzkv{QDV&tFiF@GY%T;fKYu0GWqw_T^T
zVC%y9A~t>Wj6P^id8+s8X#HWG(IbC&`d_$qEpL)`vajFUKMtqgYK{B#y#7<M!rEEy
z9bPO>OB$KtDHGoJz1-T6)$fvIW`EaPd-#$_d(iq<{%h45Qr0H$`yQENw&eJx?RRsY
zZ5KakU^%VbaYg6@r@S$v`VDGGsNpQRmlWZ@q+rbiqve{S9O=*z6>E-FX$)1#s{MR<
zM85oG*J*NfYEmPslxLrNZd+a3Ic@&Lt*V=iJC6zby^za1^KI?8r|YYh&s%@!;8n@9
zN0YplZFr`9#Asu6BHz0X+4A@6wSB$_>JPCgHchIFSn*{+SMBfdMH})jS)0v~R38xE
z&^d0@(%I9j9&&O^?_7K;)F2a;e&2e>hd=#?)y~|%ytCi_k>ARaHcwt6AD+NBu+M~D
zAD1P~8tgcj&s*U1>x=WmO!?(5AAV+{I%WOmv9+;TJGB-ZP%N6UYli)9*{jK#QGGSq
zyfQ-7J<_kwUiGTs+|}jQ>q_sG+_FE?G}?5;TZO3nX>-TiwTrm-;259Bm&2nk#vlE(
z{K4!4`Xd~NDZG0r)TDjv?vMAGDciKq+r3#jJmSds+xC<0ukA<=*!4%w^w-YIi@bFO
z+n@Pb$K*I(x0xy(|KY4?>#k(yJJs&9EiKfp)}$pAcRFu&a2#)XPJHi#$i~-!k0%?P
zx3er&N?n++t4-_V=*wD5Y99ZVZWVV{JDs8Tv)k(Sy5&-}MWfdlKM?xj?WkV3WT5R+
zxz`^0K3n#hyS}<wWWFO`?V0CYhm~WO1gmK}33q>tFkK(>@Rn8JWSK!v>>fA{d^)f!
zWA%<9)m2MU9#`&~rD^-za{Vz4aoZ!I8!897bZi`C9sVS$-*=URGO7nJySq5$>!`JT
z**fW@Lhx-nukjlk^bgFKzq`-Y_^<DL58X_4@kyGPq>{SK<w;T9+6Ox7u6?g`jM%sP
z-7tmVd)rQp|1t25-|>@yLuWqI={WK{al1mauKv|4QU$82dv@zs`Yx#M7^=SD%<mO~
z{#NfBe@@u1^hWvRoiC-=;~tH9E1&yurB#Ju^TdPmjT$Zv`0`=tmhi6=OKwj16d^3F
zI!w@5Nvf!NtCH=q?8`27{4xhN#?F!Z^*%MK>sN=2(U5!hvNJ_)zua3mzTvK)&x(SZ
z!q;!iRxUsBc<SL@kx6zLMUU<t_DM`Ux=XG=La0hNr>^;{b-(x1r)#-Kb_}~AvgToe
zTdkkB`tzmt7EQV8QDmW1nq;g!e(7Rcg~kB+`LCMNjc1w+oS<l4U(&B@t5N3Ffm4Qm
zIDTuPK+Wtow)^E*I<;xouexEC*gxOe`MJspoq^kCEE=<0<j(2-+t#N?RRr%?Rh@BK
z@kof+@R*r~L#3<YEjBpjxi;U3diF8LZOm%Z-P?bO49sttQ8g?|!aO@;hQW(T$)6{w
z2cKGOda+iqF(y0GGDr8A@?FWRf%&_K6&AF5U!F5^-H)Kk`a2;HXP!5+bU(I#(6-FA
zA{K4=Q<c7d^DIh<4)a}q@Y^}NJL~UnSy1-iY016I=J7}0JI`u7WaXgj<f)Zu<-9+B
zZ~mzLj+_MLws+1m2k43hnZHop9cQssVdN*NE7xzY5Ymu1|2?2E+G6d{p?))V);vfS
z?i^X2TQEJW-={FGgo6qlhX>VNnEyrMYufMUR{IiS-+ce9J~*~+<FnvefrUzYO(P7&
zwhX`iew}}xa+w>)#%?cOA-pDDFT>s7UTu_q&A7x`hp$}$I@>xwk6gHFqthw1sh7W=
zT>DWw&D^imy0F;L$ad5Bw_gvu2v`<1^VYFrUbdRrBbK)hy|=|P?o{4$-G^JP9?ofB
ztm(OV;1z4*-!JMW4mLWKppdO<aZt~C?^K7WQ3Xz}v!{DsRz6rhmZPs4>^uL3+`Grt
zdIP>hSq6LVX&=7g*tKhibaf_Zh!sb44^w#1_i$F_b;Uc)(=+c>TKyUIX=J{P|MA<l
zSFF?5XBWrJ|Fkw_SMGkl*bS-n$EHe&X4ag2(|&5S<m;PD5-)DNUNEz3vP`n&?69zX
zMlyL(_cLrvl}kr<nvK+&F}}_E@TDIMj0@fyX_dd4>((-PqDSeqOOaWl9TT-AHW{q8
z;>%6D*^(cSd*@BtS+n)YdlWLB`3(K_>U4x^=hus`5)Yo+6sWrHMv}Xgj=xaX?r9%J
z=*|i8>v%BdY_z84d}+<jv*+YyD*KfPow55cc2njIyMV(TrEMd`G(W!Vw?S^K$BH2`
z54-#5mrZ%kjQMnYcIW;a?7!pK{8e)vMm)3<Z7F#vH0kJ->%onauO%zo%p7~@<t?SO
zf|DwTlor{opR@S(q3>_MGp}k<y)w?l`9<6L_kF{|!<XlV1iO~*oUH#Y!Rxif=VQ0a
zn-lkjxb86<Huvrpjl4N6cC+R_R^D4?v@=~R?Lkh?{=5sv+(Oz;>@Sztea(N>aml$O
zj_T?Ml^afYH(>JJ1HSfZN}c6LX76vfBGaw?K-p;L!qfVn@06DAJ@jPEl;STlyXL8%
zEwMSeY?*cALgP7MuG7;c=a#=|-?MRp=*EWWzxDMWx*A@|a~+mb^<MIO$FYT<H|^ES
zeOmq5qNz@_?9=h6LtA#gS!QT6>q?MYkh<6W4ND(Jjd78=QmT=6?8t{VXScl%pIq)S
z(@)Y@)Gp}wW6g6V2|r3_lpIq%neX5^|K-irqbq&)jy)dIcgodspIc+q%jI&!4%!y@
z-Tq`{TtDr_SDkGK8gKUrn^e{kFxhQVUFqpnAI9X1hicp1YxVIHe4$%5z%9MK-+&D_
zW{jWi|2p0<(JIr<{Xwxy@pXHHGcEGgAAeq3a>RLedG2hV5@(mzwaaA#Iu)D7mtUEG
zgnycX*l~Av=e8eiu>rGu6E?P;%<|v6?{Rvh%d&=vlcr|H3x514KP7oj+an42oP~>x
z_BmyLeYgGWg#pt-jJ~`-rm=O-rRqWL>LE9t%wFgEwDHEx>}#pB?p_V-^wzWK=d(iE
zx32r<&9yF%OAE)W^V51YzGZ}yos_3#M9qCyf31AE=B}*4Upe}dw^uAmn~?AE=KUVq
z<GXLaH9J??>T>);^IOFm_HOpo5z{XlEPgxU@ProQ&<h6qCDOys%(%OE_qH{yj|N;7
z4wyM4qCMwh;v~OtBZ=uA)%oJm;o-aVd~Uo580xTh>20a$jdz+?6dzuc>^e?1i&OF5
z_(1-RgHFd%g=8Om&XtXjPVqI|I_cErZHI43%>40d#8uI>hcN?Y|5`eCxU+WC`74@(
ze4bx=y`-*eOzQq8HAe?u)-9fK`SNoeS;5zei%zW>BB!MoGpuWWl%2Th25+}bmMbH&
z_+QG6ci%J4zW9@ieaxCZhXh?$3P|V9h)dZS_rvSP-Now@V}{hs|7P%fk&aOKy%%8{
zYt3yZnA(>=4VK@M_3g^f<zd>{>nFKvlr}INX8E<E<eTcV)oBKSv(E5k+m4v}>3X@&
z`o-?s)VhizyJeH^wJ7Xt@^o2aX>yojI*1cd7p0z^lT*Fc;d1o3+l}|?yOy35*jDxC
z!O+yq@S&1Rb++uE=Hb73=<aD{A#=Sp?N>|Z6Y-RKvHi8H+d%!~cfW0)+=&x1Xv|$b
zG)ZT6wY=T2`eDskTQUpv`+81R&%LowFHhs6*P8N?xq*gp7o9FWU1fPHKJ|gcBRzqN
z{E?Ol8|;6FMhrC!?db2I{Z@NucGA`ALq>0d`sPmZ)t@p?Q6sop^Q$)Ja^F?WpMLqA
z{GB(}Y+YHCm)?+<@e!A=6*;W1Y9Icr;?)ju$)=X2=Y5`cU8s1SESGe>ZtL)O=J!U}
z360pXOCUs{|B}oDx5u|^v|Khzvi?o8<o2+Q!_TC)NN-yB>GPjEN@8E?OFo_L?t1-Y
z<k_Wv-i<7HUlFkE$Kg=%TOtR7XT6=`S?@NhvE)=&$*I~+4lx&H5?f<iLxpbLjX5xH
z_5$T63w)mN3FJP#!2Eb?#N<7Br<{F1iLIEdRJ-lw?|aXxN?up`&k*aHDWhQjVZz}d
zU;5+>R2-<Z!){(+`=xbP+LnzQS@w07;l;y}yL7%@7koHQvm(vLL2PXQjH{XT5sQD?
z_GwM@RIR-ru-7oD{88Ft>&r#^%eB&Pd3Rd1m8e+sGpHZ6A~R^`g_Ie_2jz>7pS?Tc
z@`IomF`L~({7gQzZL)qPd35{aV$(?vt~=^X%T2!C{mn?V|Bb2H_nZ4fWSH+!>bG;!
zMw95Mgwn@`k>M88W?TQMPm?SCy)wL&GtGIu_E9Bi<v~L=jTZg5>}O^%Ge~nnkp1+V
z3aYau4o151t-rP4!@+A&fzN#H8aY24qY70*#QmFZYN?m1?&!)c-`cv{sHjr@&~@qj
z+TT+O4$GaFU*;0{Qc&chL4Sk31D+_JjXE(;U2?yc)|`SvYkXE5NKE?Lv}*SDn{|FG
zZi>2<AL@L}fBj*=-q!qzc+s~%mh8NtzH(Q}fPszu4qZ%N{p)7bF}LD{It9jK99`P%
zgHsEKWoY~4?w!}SGs4mP!=T}fopLHyB!;Bv2DK+ieCA}71u5w5%~Q0=uk;k0c6aLT
z;p<k7`!Fm%-?wORQsHQuoThvmv$UXq+38tX?FT#F{9L5JEz!SWi-_oBzW^VreW%;L
z=Xq8ZXwC`>++JC^dcDBxvV^hXLS@!tlhswSit~k5No>~E*L<-3Q&-*FTJce`Gm?K;
z#hutHF5OsOlcE1saASPo#OBqPBhDn|IZV4MJXrTxXLeDBPpbK2k+)r4OeJty78mzH
z)nc@P$G$TexvDyY7BsJM3TQNw@4TbCZAyrV_U*<sV`I7{f4c?ezL5I;E98jVCs$i}
z^;RJd_u#uD%MWcyEYMnZU2BwjdFhY%aU)8~a-JP)G~z3CFbT}aUodL-u5H6LhgNmi
zo>9B=Lc!wmzR^E_F1~D7ld)AHI<|KIltG$Bvpn<PDraArYxPTb-nA};tHrK)WnpVa
zwWi%omNp%7Nic!)yt(!9@6qq3mpc22tX0idj<$QB6k&GH?)Vh#qbfdkOihAA58o+2
zy6sip47HMpM`QOS9Qf>NlE5kY{ys75MfSTfqQNhnyeh=|-0<XA+H-8Tam3|E^2yn!
zjl`wu#oZ6TzSq*PW7k>7=w#QJrN-|>G!&}>FP|UwY~IeJb4_iGE_P%!o2K1%IWs+?
z%l4(g>fI?n`11Lrhqs4CuaZg@vKCfLU16bqd3f=Nt#vtOi_7+HpZ8U|P*8LA{?)B+
z+ssQ=S>&kAE-s6A&Y10Xe{S$fUA++D?CIxIL_Vf;ZhxlS(J)4#Z&~ykW1+B&=O-sl
z)N%hl;O+k445gu&Et-|a53KVqtKZ4H@U^7h+I=Ce>yM6TY@ht*YW1?vX$p1MY$AO4
zz6(m9EZRF^*MfVh#V77(KR9l<=bPs|<6j=v)k6n<-I4YDwj|#m$MefghezG(^Tk)Q
z)-tL|>A2SIPtBGmm*gJ$qq;iYz<yVN+lQ^Y4t!nuy>6?-z;eyz>}wMR_xgv49Sn@f
zD_-Z2c>BXj+h^NTcc%#nuNpY?efZ7e=Z2SjxAIfJ8!J$IXxvaEw`<PR<d@8`x+#;>
z-Wj96ar@2_t-gaFyj@+nJaE47W<Qkyo1f*yuM3rVtSYhIZ|$o&w=_iu&kP<tYMGnG
zXW>hurJ~2%B<>nFBLB$^nJHoZH7@3A8w*vEnhphYL``;gusn11S#s{BotoBWC&T1_
z%dN7sQS6iNdN!+eRqM~@RE>tHKi+zI_VLv(f6iZ`x+;C?-C=KnTO)NZ94`4dX=p~u
z&~5uZzN>GX*|aHa)R@w<SHeG^`=Xt4C~uBMy;jDXkc*}_-4o|(>We+CzMeE=eUaju
z<L+*rs&&_Y$9mo1A3XE@<6tw>9GN47@73}>Jy5vwjOMa$zUd>|o?lz!n(bybBB^ft
zxOt~GKapCoM8N6Z?orVyXGZ-TqCEfEsQzOPyA%vrdA}oMv7tc6370I-W#_N256#@6
z<SzEoGQ6+<w?aO<{H$|D=Raw2rrwvzkX%zPl9-u&DrxWVS9c$D6ic}|9m%%PkrRBa
z5$Ic)P-)t{?}+eJPuoi^tDSTfoP5$HT<@gif8qVqzQXd>I%OR`_n)_U&RsZ#&%0{0
z#iBjZDYpz%Zq2o;+Y;~6=skJMkV<a>k-WS$x<j-oM&IDuvD|Eu?X~Y}x1LW_KYVJ!
zx4YU#*FVI5@r(-Vn>WWZ@si04nf@8~hHedxS~UI9p<R>v#c!X#rGDP%3q_~yuasV$
zJXdaqROd>=L9e#Wv+S&VJutInFTaoFLSOmvZJ%{FZ3-HEzu)*(61(>uJns@SQ8uzQ
zwOFUC&opDHF%9xfagNtc*bfVryb-^!;;zM}^dA?lZMZrhT0r!wWOS}@#*^POCkEs^
zS(PocK(^fMSbmj4n&Cy^VGi@0JQrn$RV<ejY!8h*^=$XmT@9y1{4;i(-EEjK{+ir%
z$32lPZSi-nUa_2;-#t$zcSgU-mGz(VGuOX(`Nt>gKzhr<ug2S+wuQxOzZRQOs`E!Z
z@sDcavQ1MGAIVizYOW96dLf2M)$hXN`!n4%+xty-YyD8yu`0MSXWag~^AfH;ZE<{a
zXlH!Dr{u_4XBSkL78!|cxj%6K)az}7AGs#EY<u6eXXVM<>6?R|oewU^IeO5zE7Hc!
zwm7T!t-#}fMFYonH{Y%K`a$Wp#pBc(+xPJ&4xesJPI%X@^G<x2*7z$!hF+I<-aI~E
z^^|MSJ^ztIy&pF&7JK)}{-T|i_o-W>RVG+ZZK;!RKigj@-fo!Cm(YMoC4AYPKQ*?c
z@BOx7^Wj&=lG>~io_)-oP?>c4PNV(1PdR(U7oJvqoP4Lg=&*Wev#;OuOTI0OPd#>@
ztSN6f_{@!OF-_BatPL{OrRWW9XfZCA8M^Xj`>VFNZ=R=HF6ze5_Ierj<<7z(zQ5vz
z*m>-K74rFLdf9OQtFd|`OU9jS9BSX9AGy#v^~05qeK*+2ue*E5xMR$qw1SMM{fGaW
z7O!z$^yu;ZUBwcnT5i|p1#LaMPs(?j3P+@4*5iX`s>Y3LPOaHCzh>m=CF4iBm5)h(
z@>OI0dAae621~1-ReM`}Smd=}u|ms!L)R&hTdoIcPR!jOn%A;NXvg4{vCVd#`Dt>)
zy!JUBe0_5Hp{sA-zjd|vJ^Aad)WFS=7xV{@l&*K0czwt2E+sy9kqYJAYidJ>{%%+L
zz0drjlAX&BSH1R#yDfiAq`o_atp543IIGskRV_05#h4KjOl3NCPm0V988PyC%WRvL
z){9}9MpIu7dbZzCZ&uS5_mxp+E_fvUcqlR^zJJxbj`l+;kt+%#k3V^qGr#_nm2U8{
zIp6n=j$Sg-G*x-fxQ3|_FE>w}ZFuXH<Cgal*=A!VH5-XGFFEi_YoTM<a<wUQXV;dR
z?Mawy<8y7&lCVx~%cuKI6F;?T{gzSttada`#oT0D(vp%pX_3WG<ZhLzy<fv$d|_Rc
z@Ya&-j|0cvam(nAy8Uh0=nW?RCkiBM`v+Way28Iq_Uxa=KSwz$8_qxVRkwV3x4Lmj
zLdyPHam!7ElP7<F$e$axvUT3u^LBjkl1qPXsTn`fu;g=_zqnqJn%JfbM>|LQW#(;L
z6|J?%s6j*c@j@rRvROJ8l{#x~Pur^BbgtWQ$CQH4duL583pP`IXRLPi!O-8f{@PEf
z+9Sg3q`Soen%{CCdg;0DUco#SP6E9SkIgTianrs=TjY^gv}c9gB>82#ttAhPw`=wq
z<J<Cf`r+t`=~m{=S2mR`eKl{K*YY{GLi!VD=jB-UQGfI9@XoK5E*GaNj2T~JGIrtX
zvfOVC(gv+gO2OIpOpjN0PkgIWShV2V#ueIY4!y7+Uhw_fvboYHBV=zKTxdQ+S6H%E
zy}Ez$qATZ(7m5yR9Qq}Xxq<g&-^f1-vEA`|&#8Pb_Vs@Ls^U*v`nB?lc~27)aszZO
zL{H!!kSfxwxBQy4aen&Lcd5=|Gxkq>Fk_Qz$A;7QCiw<Ot<3E|?}=$jZO3n^H70F?
zJC?t{rQ@LfBe_y&zm8l$k?cx|yym#AjT2{X-@nzbYNAi-G>?4M9Gf`-GxFY6TdiHR
z_o?KrrmEYwe80CQ<P_*`(u!@oWuRMSz9q*^$mYzv@_di2D>YqZ=g;y;wwRXAu{1X~
zlviOMC-m{uU>>{k_m%he_LkQfuc@P{t)Z(5dyK!y&kE$34|%N7(%ywxH-@j8Fj@|L
za7@;OA%VV=hcA8xhc8x~Z<vTsKk^JGxorZ=P;;V*;0#gm%sx{^Ws~_WMdcUu7nL;?
z6*m*@N7lX~a#lo!3G>K5Pf_vYK8#qHsQ6UTe%x~bgfk(9d2)<-@um2>K4zk_nfzv=
z@)-hVqAF_zO+~d+`kIOwBnwRy4Ug_GYG5v^Z7Qn52rz<71STz0CN1)~%@LxA32(_i
z=G59gwxY5r{8L5clLe-VYWFGaFDgHc8fZ0uW5S5F5m_d1*A8dmWRmnVNcw99m}F7}
znTW}Kr;0lEiRv$^Jylf2l$EgA0B#=C!HJJZ-Tqe|7#)xYOVRK?u1qGFT%k-%9l)_=
zqH`a3XSQLz>0<jMi;q8qkI}~HN7|U&F;Dj~AM)HU2?C_B|79D}*GTmJuXQ#=p9%Ak
zCFR6~a`Ny0(_bqYf0_U7FLR>h-+`DZ!1>huue1Ez+WWs}`2T0+JDv=G&q_ys$Kn5b
zHOrop{5@|%=t0~ae(tJke=}yC0;cVd)!2A}TjsFO-?LIKJ<Hqj|IZ3_l#^A-{x|UV
zw7$R3@pE8du)i_01{1u1;eR+;;qiY1e@_ek`y4+<{%-(B{2YZ|xMDAy`@H90=k&Qp
zbmgl5PLVYjnOgNfC1wJgdFJ-7V8K0t1@2g9$XbeIl{Z*=ujdR|qmir-7~4a5JG^%d
zN&dCYF*)PLJuShZ-w*SonRhyHcO?I(Bz-}i_H$HzA;{BXy5%j6CDGIGP)_<%306Jl
z_N@$C&wQ{CNSu;hIC-w|U-EZ*;iUhQV0n$(Pcw|4X^{WYBiRcd!*B^!DRTRBMvrwb
z^7DJ)p}p{>z3`2_@QPmeIfhHH`T_1(!Pxnh%i+s!=9oJkFx$RNfA=pxkOea&{?QMN
z=|z5gFWkNt9?%Pq>V=bcI{nMeeZBC;Uic4&ORzL?$05cK(#&}DFa2u0@F~4;vMSKO
z^epOyuk3|y?S+#y*#D*fG{YrW{VI1nWb*Z_7x_=U@Bz#?`Y-*8y>O#m_}pH2STB5C
zFMNA1yprJ(tnq?7UNiZ9*o!>p@5T7MIo<)j-a)XKvWKU?XJBY#lm}VcLX#}|5bPNo
z=o!h;v^8hecD6OwCI7~ee|qHK1oDqrblKK?BKfDI&Hc}nWENkxH6PDC)`c|wUP=Oz
z<ak)xI+&T-dN@p*=4>(3W2UK@t%V22+dC>OEI865IFPZ%FEE1n9~k8u@;49ljRhRw
z85zJB?G^0HEL9N}6dnF|Ha!AEJt90q!aaP#VnR7A;mE*vUru;LU|2+8RGi16Xy0gG
z4=(%5D*>L1eLZ|b!=n8IJeWl;!lEO*nWZkcj_f(~@D2-);{@_-;2Ip{+jC3|C5I@A
zk8iMVlrJZ2v2TQTSV%}<6thrBPXZoMVNssJ91oAkC{Lz<yaR$f{5%7L|1K}KWn|3_
zkC?!y04BHL(NSO^U3QUiVkonYN1#`PC$lt2WK;xMWc#mNvdf+m6&T{nB+R(X-#3b9
zx1T3dCJ}LrcE7N{yzIqPlpt<F1x9*s4}5*7C%De!W;?_))YIQLg2_l&Sfp=HHX}Wl
z%NcHc<3xn;7Wa<x0LT0lFDk+_G}4bK@C^6#CdK8snDGZGbDn)P0d__`m^u?4?8!Kp
ztE<Nuq<%9Frgae20PhH25`|SydJ2@q{wh?zK&I+N_=X1udVBs|5s~ijuy9=AAh%dB
zIx>L6<k=@IgsHaCJ=yHZ1F!Ii_kul{3qr0BBUw&_Tp+bxo;>F>rTVWkBvbfAxUX-J
zhbPnm>SeA6|Ev8Wp0TW?Lwt!rg#BHF#Otg$fuTL^nOQz3(A$@#f{Kw+VrnZYKgj!E
zYt!`T;;#43bb;J38n&v;mh3ajW^uzL7FT3(dYww-$?TTO^X9c24&h`ybIN)1Q65)e
zaero?1R_6{`B3>70+~R#8uOu?%>PIrT%Gw)p3KZwNFZE;`B1)x#Wh*{eJ|XV8ShCT
zdf4(SSX_%aNA=Gk!b~9YY`^(&DUY-LmdxU8zmfPPkS#mE=3L6-?ELcP<vgy-$WVK7
zS@LW<Gg+Lx|A@+yc{2$l-SNza@^b_-fpAi$ls_Pl34~8zK9mdg;!m=sGYLeV?ax`g
z@YG)TQ5H8~bkTI{Se&Fm`9l_;$l_#PO9GK)`@sgvmu#e&57o1XRqom>euTx@<$jID
z+2#9`#o6`YCyVQ_^bg@@4wyjfWY-647XPb0usA!v^qoCK&nV_Y^OeSuH)QdXEY7Y!
zmsp%!qf$L2E(t_GxwA>R7lBM5d@}Q)d;@_@Abbk*q5K+wOdxzT^P#+zKqe5*_FI2e
zIhru%sJu3dk7IFD7B^*avSv03M86sHp?a3E%Eg?;b6K2SF1J~nT`nJ4oL&DFSpJ;K
z(r*TwM3Z6hAeKD4T<DcQksr*GC;1_PY^O0FnlIk{1s-Sj!wy842}ItK`B3>Z0+~R#
z74xCIkl81J@afEl@(TnqfpB)Yw{R(sv)iv1%m3_p8_(kGdh&tA+4A%qJtSQ=pUm<<
z8H1>u4lHiN;&WNtmc{*9oGpJ2IN6Z9IaL2mmb@K{cd+D#us9#9eC=7hKdU|rW$}?L
zdA5E7mOQ!JMeQ+X$+Pv_vgFDAX)5o@l4t8*#*!b-l4tiPZ2j~dqa@p8&33B4q!;~l
zEd3){@{KHcwtjNGN&?pZjU~^vpWad;^@QDy$T11H-txY!;qg(-d20V`t~8Ic>t`Tv
zVvjuYq4Ej9iGD{GFJ*DIJ^g_9XSQOnPc{Q#pKx-wbRP)Pet>W(kRcn=hmb%yy;di6
zi3GyQJ>2i)fC<XH4VP1$1Zl81N%tKoOeT;qlmu#z8tH_XK>HcWO-W^Ef*EhqBR_#m
z5}82Clmse28w{Mo!#z9_GUti-2GA3N_<XRF`k(4g1;4F8@~)si74b3>kqH}ln;v_L
zMR=e9@gpE#hWK_;F_>_ix9QO{icC6~P{Z5w@TJ7rOt{P2^l;iwH6v~h_5MBLnqX%q
z;vYyS!GylhuTuYbft}?3CJB_AjOHE7Bc2I*G!Qq0d>JAx2^G^4aq$5>{Vs@G2=cf$
z;xC|{EJA!Gq??HNDri9TT?{l|;*hUABwq=QpcHXOs8`1kcYu0Ti#X{cNVtvoQ8KAv
z!gIu*gFSS-qjp*<@Z`IY{3WRW1EAcfya~vW#f?dzTovjGxj)P1bHH!p{w$ksCY?PK
z%n?r%<#8v(3qalj@nYa1h?fITKztz7lQhKjdC77%BTnCKT!?rE^h@OaFA3BSP0+d0
zcg#_K2+I8;l6Ql07X<%N`880EbiAhg)+k<jvPfQBfyXrwj{^T2A$}M9V1>8{_}>L_
zS0SE$FT@=Mc%0tHrgr{-_PYehr$T$A<2#jq4gF*;l0ORVYbWA#zFUE~F6gO3{3+y@
z&If3^sUZIn$v@&{i$m^HlR)JUkLDf!L3||)bmaau2~>U=^fUAw$CPgdc_k#T3genC
z;%C7R^c}=hPa@PGTO|Jg`e!%9Llk-T`5`U^?IjZN5o8j|gyo1k(|!-}cYS&CTM?HB
zzm*_f0`?z4d<{<x=N#gT!JpR=mw^6?+<zy5`bP%Z<7>okgFW97msRA&7ld@Ep3Cw)
zJ{oav@Q()KRb;Zs1arjmz;DwLH-L8MfVd6lcR^eV%6Bf}gQ1;zB7PDkY5|Co7Xy$G
zg}4UvSG4|8Kj=X_N=NciVE<;s!=RtsjkrGa4~Gyx4*la<#Fu~{t|2Z5_BSD}4dvU4
zxE$o`3*vu3KmDqf<~IWTJP_(N<yBBmh9aH`{o5GCW1*huA)X7zrij~tAM6p|4E@7g
z#Iuxm<rsjt2G|pg_yy3v0&y`YuXTt=fZy^F-$X9*m{5v%I2<2CJOKP$gZMY7w+)Ef
zLcjDFar&<2H;8W~1;m8!i2Fdh6M%GRInw#}AjC(4e?}nAr^3^(hWG%OHyR-BtiY4E
zK>P&sOEVCs{k8|<w4V<~oc8B&h?^?&(oI3!5&W_d@f9$h6(Vi{^}ihP0;mtC5ch_3
zuOR*o+T%UMe?ob+AkMR%S<M@9L8#B&h(|#`AOiDcTE1gpzBB~!%g{e7BR&TDrE!R7
zK{=Wr&U<MFvu;1)dmz7a5Z8n8&L8oI(4Ryh9t-U{3GpRxoQe1VXfJt)SAjiy5MK!W
z;3dSr%kxU09`Q}k&)-HokoLofmqYz|inuS-{}#l5K)rg4cm%ZHPl%s}dhi2rb0|k~
zVO~CHeK3P|DuZ}E%#-C1KLh=n0^(<(o~t5m4DzOkmx13b5$}Y0Xpi^=@V_78>!3ad
zBmNWo6M;B+2Pg@#i0=eF%MgDJ{lH4Z={qCWAif>^zaH`Ha9oObE!5`&h(7}V97TK-
z)RR+)7eISFhj<g{zl3-P=&wgS3HqPgh);ran-HH1?dvJxg^+Fw;!i=(Tg1!dxy8cy
zg!ma~N8b@IgK@tL@i-_)e#i%{=ZT<481eluzKbF5GKOc54C3NorzYY$;0Ha#GogQ@
zZ(Jd#$t|ZQXxAo4-UjTMhWIOJkG6=r!#vg*@mJ7~1tER~_#(t>!H+SBABO9}rHIpc
zQZnN7`eY5_3UIswar%Aa9>nXR9qmWF3hX(G_!IDdJ>n%WzTZZC9*i$dh&zBEo+6$H
zerrX12F(9IBW@1!+it|mq1;7a+$N_<eW(C?h9JHV^e7{~0@~L&#0{bTn;`z3NrMDC
z#B0Gna}ke(emD^ER_Nzr5Z?j!QCA_}1@p#@h^IomEkb-F^xFpzZv{V8Aua*)=c|Z^
z!f_MgZ=k$hAs!0l{ta<GXpj6bZqxF*1LNi(#M|V#Zsv?cJOlbG4aB|Z{V2pQ!u(`9
z;;lUOoLPuxK>hSZ{5p&ak%&(N|0f|H4deAX#1BGy+=h4^*i(jh71a9^h(~}QE+MW8
z^{Nr^(~z$hh|hs`^a=4B&<}JYPLBsd{i5ZV1^yp~comF~s))-$yPJUcc&Psti2nh5
z==~v@?h~kQo=9FC{1b-wbkM&P@wL#t(h-+{`QH}A&w-v2#EqdH(ff<kPG#^z4U+#2
z^P-!G*F$@Gig*gtt9OX&gPp$+e+B)IFr-iIkq5cKh)Y8~Q9_)4KROO^cWA$+h);)l
z<$(A>katIXqzbPA1R>r4{Z$;|<>3ER#IM3}4&sSWk9Q(I4D=sFTpj#y7V&!UTRq};
zp<Es!z8T8#HR1|j|98a4ft`XdzoX^#4dz{vh}VN2I-jNTDWF#i$-6>5F-BY*u4`-%
zkAw1ZL;NSSFMq@XVcd*Hd?55o$%tPB{p%5T2LBfz?g#V0a>Pf#eC8D5Q(&CBg7{cS
z_a5RZP#;<lk5S~+&o77%hjQnGae(@N6!ceOi0eVS7>@XUC|@<iYoI@wh<LU<&mK#}
zYeByY;>}QA-iUjG{fiJUgZ?}baXykkCS)M)3;kFg;@vR*mLl#0_4YX8x1ro?5pRTa
zZzG-}&ozhh9B~2g!w1A$pnY{A9s&LT04N7qj%si`1o3tyUb<rtcjsY_KH?QHA2LBa
z5bCWx;#7Vf;sfA%Y9Zp8eR&BlLwq&V^9;n}p*?Ov+#Tj8#fT4q{`oNC%b=cABc2Q8
zTaP$Dl<xz?KZ2dF5Wf$8`-->?_@58TnU<Fh^lzewH^DeK4Dn;oU#TFT2JLP<;^es~
z63h_)0`m|D#B;$v^AL}Lek1{LFX*?E5T6Y7Bo%Qr@IwaTA7Q?ljrczB!#>0npr54Q
zCsTh0Kz~SoUqJZ<kUxX;Jco940r3x@rw(y7@Xt-eZ-AcHh$lk29}usHap4={OQ2kS
zBQ6W=r61H&nlBkBUunb>!T)sJrt-ACXd(GW&>zzICY7h(kGmrIIZ!U%h<^op!V%8^
zd+6_OsD2-iUxVeL-`j+^9L!I4AzlFX97MbV#)~tEKLPoxi043iypOme=xITmUe|m^
zoL;|oBYpzPQ3U)!{a^><&Je_%pnWMLehK=Safs9Y%>?ls(0=U@uY~qE2l4lC?2q_2
zD3>V2>F+_45YK>gGZEhe{Z$^~O;Emj5U1Zi9z|RM#+UPmJ3_iQ5YL2m^$77;UN_01
zzrUd6k^<$|f#j*({Lmjz`F3c(;)s8P{0>Jv7wX|y#QOm^K)ew8lWB<0f%-EO@dF@F
z?>A68Cqw-SNAg0DPg;+teA6hNgVrMX$uQ5{ig+xP%O1o>$n*3ZL!5pOcmZ)^@WU;{
z>Gy!o5U1Z8zDGQaWP}O75vMOw?GJvU`89_ASr+l@FfUa`yc_&Ue-}XY^o99}8Iu1B
z`W+FczyF($I30gO5T6Qujz^sK^Qnl_d0IB&v>uitZUFt>NyNXveC!h9df=Zsh(858
zpCeA&#e2kmLVf#%_<cyXAM_K{&(r0(#mkXFoIYQnh`1$BoTH1lFO;JR;?-b}J>r2d
z?$1L!2l|<Xi2K8JYb@f&q2EYBToUSQHsW4TuXZ4=0`0K^aenB3&LG|&?7xP1Hq3t>
zAYKmh;WotS_op3*mqI@*0O`~6dI8rn^gb@-x1b#5k^DF!zywXizk{Ahh!2GMj5XqF
za6B7vEs*y^`~~#?QHVQ3Jzs%%IFxS|;uGO|WIN)Zp0f|}JkWCzabvija~ts#D6gl8
zU*Nfo(~dZ(;dCNy3H3@6@<+>s{@zR;aXMaVAWnY|X^1%e-J>Pq^mme;h<8By_eXp)
z)bkL;3n9Nzi0^}WW)9+3(7uWgr{CA?N4!5=*PTL~-lw{Zcpc1_==}`pPZ6lMZAe}d
z_y@#Yp?rnlx|8aWgYj`7;v&#rNg_^vCp`pl2WVgNh!2HvN*(c$Fi$o>oQ^vdh|}xq
z8Hm&CWe>#Z^>Q%c+R$Io`+U?7v|Xnlc{-2DM!Y}tV}*#v!+g6O@k*#yClROj87?7y
z7Rvn*;sMal)B6Y1e(LuQBtIC+<u~Gy;Qv0*Pf$H~VVo64+zINf4C3|Bjx-P-4|dui
zJ_5!^AH-FmeI+8k7y6eR#K$P`9C`}zlfZ8x-UY|+5Z?rT`GdF@_(uxnFVsJQ(4QzF
zJ_GV)gt#NjHx?k?0_CzC@vSfqUyFD<9PdM16b67Q#J%9U>^9;nU|#VW@jAG!6omV@
zG{1|$9%aOxK>q~94}u?OBi;i3iA1~&>f1)dW950}OP^Pu_RIoaf#k=5{nrrZgZl6Z
z@n29beV~7$`n%!!MHX?|el!v91NCGo;`hN1a}hrZeprn7TbTExA)XKZ$p%iE2_1Wh
zhmNr1N!JhNb1D&s?u2s@aWkTX33Z4Y@-U|zI89dr_)o-5fe(i9gv!qYu8(*kaAy`L
zWzYuPoyAFh%Yg?0r{(n$`XBnc1ClPyD~Ym^B~Sdbm_R0MLOg(nIr%J3n$~oZ5EDvR
zoai~hr5sKf;>UrXK)eAs{XIKTOY~d>ex4;y(wz+H*0VT~??*Dogqw)};bG2Q7AJZl
zp#OZ%;zSR9?z#nWBhdeb#fhFtFt7W@;zZ9vkpGD|eSY{4ixWLNpuGsoGY3qde%KCr
z2Fi1B56=cJ!Qw<u6ttt^EKclc1o=^j-vqAA;zZ9Jn78Y&IMMSN<i{i44&0E%iJlNR
zwqS9hN4gL5j|tP|xtpGRi2=7~aWcfN;E8c)KS%sS^i%F7&l8}2n*e(J5Z3`72Ar5p
z+QmucLjvtzi5`;fJ_4DrTAsV<vC|FotVP@zcn;!8z_%bC1N;c$^f`q}#1DY{ITj~&
zUSd8ZT$kr=dhDd@INU<~A?SGsocbXh%JC&jp6Gwdd`S2u&)xLsr|Us<BmNEa_Z#)M
z{4l6jbRJF1OANR)lBds!4ME%q<VOJKW0E1|_?nj-XDZ@;M1ToSh|}i}7a)F_C(a2$
zd>QCTL);AVTY@;P4`&gl&lx^OJP7oBMx2f>k_tS-_?QjJ?-a089&u;j8i;2AH$;3F
zaQeI^)&GU;Fu@ballA9FSjOU{ENNKH;>1q+{NXkhCtVdxPdNKnoXC%c^1Z_1M1L&v
zA)$%IiM%Dqzh`lxe;^TNLKlk@dHOx|(9zt}9Fk3<zk+wj8O!2CJ_GbmVR51#ri~nX
z7ANv$ARolyM86gDAt8aqiF^~tXR$bR<y`p!7ANvQLH;z0v-RI#aUxIG%X<u*$ddlk
znVe+8V3;pZzJiB2iin>b!#kmi_z{>#(%(l=JzL>=X9dU;KLg?_+QHI8#)UY@S25yr
zJ&_}bUk3R~#Ob;)^f@YO553=V8OaY4;N|NY;`BM72Z)=1{1e3Wfb+q108RHOa1j<K
z`Aq~aj(8k!X%;8_usP36&IlGK<=6rhU6sX&ezLwG2^xs!1J`A7qG#49t~ke-#fhE@
zkT*q~ejn$6_)U;^M!XjIY!)Z!MhWrK^=5IBu9zT?`y<W=Jeb9a9%@evixWL7Kt2KS
zVBpJHocMVzFIi3+ixd5ip;2bDIMFW-9oc5YMSyPuPV2uY*<r!~#8>y>ar*rssXxS?
z5FX~#BmHAR|4qb|fj>Ze8t^BGn*jd?oZ7h+?CGP-Gl24Yz!ebx3VZ_M4PgIN#NPmS
zLVP*s2}E2O+ItM*lR-}=;(oyM5YGi(g}5G+%R|I1fYa}1s2@Cl)8FGzPM=pF0sSTI
z2bRIS-wg2#NY5T|`g;Rk#CL&wIB=3~U&s^LWU=H){q%*C*@$}r-+}ll;Khh91zyJD
zq+L8Cm6Qp`S)8PM801eOUIx6H#fcu8-v-2Kd!XNU(frzwM49jv$<O3r-h%hcKJ|YI
zv|kYwo&eS34)UWA*8r}GxFv8q#J2*U3!J8V814)Bu;hh6mTZz)^2Be?!9S^pHv!K^
zd;lohj5t5=-H7V|FGXAf_%XztfuBTtI`Ff=i9ZS2!F)(~gya)J{u$y+fwv$%Wjr;U
zPL@2WYS4^0{Hi<w>gVO~y_hJA6Mt?1{St_;1wI%!wV$qIqJ;P%=$8yxdPu!}2ld~A
z#YwuaLH~5b>GP=eNPi{hpNn_{@BqYL0AI|~PfXEaJ|rZvII(jO_;C%36Fd3)5or!5
z6Y(yve<N_}ANm~1LBy{@|6GUoHJ*CTZI*swCrm#%Z7fdgQ3QM15tj%44RK@OKM^+q
z-e)Y&08&qge!A{WU&L)dUJP;iJgp?+z927$_+sGlh|}k9Re@7~ii6)A5g!iR9dWvD
zQas{Mc-iEnA}&l4VnPApTELGZPS+W{fq2jT0mL`()N?)|UJG1UjkiPddjitcK>RxJ
zS%^Oc9)@@{)c=i$yMx~f5nlxS0^;=gt_|@sAm0JJKa&m8j>6%3XNWp4UzA6Kor;LN
z!hLTo#D7A6Wr%n&<ZBw@bbOqLcowPDOz;Ix%n;-f-oKSBc_O+R>gQ_2R|3yLoIcmR
z1@S_VFGl<>@V$s%2Y!mhi9bu>27N7y6FUWjdG=pH{5R;ii?|xdKR{dw_*3B2Kl6F&
zIqirq1pX88RNz7|F`(rhqQE<0jQBIS&uoP_Eyn=F_d$JI1f19jh?_tbOP=`08uFEm
z_*CFqkRC&xnVe$8?SUU*=^^Fv8!Ay1OCG8wH^w8DJh6v<5Bm&pAF$^g;;FztA)W~Q
z58@TT`)KkECjKYs?g1{u;>7;E0X(@uEKcO_fxI;0H-V2v{3q}+h|}MDtFt&smtH68
zvp7jtiWtlUL&PP3PXSKKo%neS5oUrd;wD_myzd0@VBkS44wu~AGbzBS-_#)8HHeP_
zz7cUx;F}Pi1-uaPO~7{{o&mfZ@vFcOB7P3|b>PH5Bww`s-s^>bL3+AC&v(SX1LrQX
z$>=4Aq`XE${SnY&4wyjsNZ<nzr_TuwLfjDKhaw&Td<5b?z{em?p9fY$JQ3ulA$}0J
zHRAL+VF%#UpFzBAa^@kP06Y-!9N?=Fr_Z4mB2IrVREaqKUa0}`Indd(Af5vJ3vf~{
zq}_SI_0jiU_;17)(FUf?%Lvu81ip8MpD}Uo4-bUAl8rg+6Th)}42z4vKG~c^JOhqz
zB3=T=biPLP6Ft;SGXj`^c~CFBpcj4@ab2ET4!z$`^;0eb{-)dx<P8wlfMZ&2RG#L4
z1(K(nUiV=6XGorYkJE|xEwD!p21}}ka#zG(gM2)TLl@6IbEOw90i7w)PvlKOk166#
z!0EbnRNj^BFrfg+*YGgsU@!a@;_pCS9L8s=pZ*Rl8SzJu?jUF%RG!|4R6~3f_}8)*
z?#JS=%e5$_7k;D{-pt}ckSDScfdgVEo9p(%XChA5GhL2&8Kgnir=t4l_5K?qe-iv4
z0P{^MPp^NK5WfccCnG+XL}Y>^;*)^~ARYod266hme;SLk=lP|*@O!;*L8$a3IihDa
zF_H=Dh==en$A-nBiEz&ZvN*Vm%UAcp5B9?E_rg07R|R{dNr%k@Vn0cj&VSTd9GVUh
z<9PMLH}}G?^}_!kPUj(tFy0b-NV=4p_QL6UAXq*H$ww38nQ#bk6%vsNv<(uoM7f0b
zkIZ36p#I?<aX9j@LpZw}VHo7fv;Ahml4sX9M;50x5VU~Bp-FK`IEzD(a>;TQXOEj%
zEIttS$%gI|`-y(q?&O($5-5L7c9=lNG0HzdC7sGU&6OwiY=>j|`z#_)cn9!M*iufv
zuSsTcVt)l3m-oUiBYq!_pY_6jusFMY^@0464Z9pgSe#vsv>zg;+2yFfl4qBr28*-H
z(SXI-<!H|0>~gecaawjHOA6#46G*)!w*YL(0TYyYn;yOzj>jT?7mi^%-y=T;(xc^0
z_0#t>=p#MlAa8<rH*gEY>F<=R5vS`qIv}nBg+{-Zp!U$;Be@~@i6Bq=4=Qg0+#AW;
z0uMlZCh!o%=K+sE+y^+F$I^7efiFSwbp7ij#OeGz1@Rovla6>kaN6E!x_f}r>kP{2
z`)sx%J(obf0P*|4cOl*mycBWTnD!%1pMN=wxHL4rO2p~+l~st31Nrla+X26XIGw-J
zevbOVALQwE1m)qtY5Sl&2KY13PpUV#fJ;1~zLO1zayfl(5#j9qBmsm7XZI)aAVfI3
zKZ$2?c7IX|2SlFTpV0dygtPmTLO39t-Ji%a$0U$EvGYay6~fs03MRr#Ae@~qT8@OX
z^VLp-nLs!@U-UgbgtPOtgc!&K!rA${#^R6_uACeZWCGc+^TpAOj0<7jLda~RB6!;X
zx)()W?xyME8Rf~*^onHO>KNf0?5Rnp=D%L3M&FLd68rltdVjrDktOxlYX#Y_D5NiS
z`$y6-VG%*h%l+8W|MNmaRuX?3!hYr7|K<u*|Mh;uUR9wt18PQu5q}Y9>S!`=x?~?R
z@45WXfqxtH?|1Y4|B3(oIy;({cVrYvm=qQF&34=uFfzsH>lN+q;pycS;k)>+)6Cl#
z$;%k2k3o)klb}EI(n_|Th*1Ck6$}mx^`*+md-ot6g1PVE(<E=I^bKX|5%bDEUrpu}
z^BUY2RKl@;XtZW{L|C|QL{uCk<{RMQ$Gm*gms?%`pZ}4sM@W-kw<)63g#7zQfacS4
zW)!nW7`ttglP2WfKLU<FhLItcNdLF-b(pwBXK(h?`8y-R4dQeMw(885^gkwWOgAPl
zVXy+A#%zfkv6Tc_-iCYK_OJA-;XIws!XfwGCfz4nXXf*-^jAar+8|8QCwau_FJsuh
z(w7HE)A<0X`JeRTm=pg>zY@}~hKMA6k~U6%AH)8YK7D_~TZm6L*#9NWiGQUZ>%xm+
z1rbU5WGuz$KWEs#(k~=RnLy_$yd&PdWx7wckC@ND(yxZ}7Z4#Pko3uTfzuaa68~5F
zCNOx>bx4Q~5^(;>b;Q5Ymv`mK&n5#B6G-~x`VyzF-b?!OFzC_WLlGS$;PlCS{a@+F
z&gRK4Cz)dcNuR{U={rFBbiPkyNyvi1bqK`g(f{I8JinLtr7#G??O+<6>uYjA<3~Vz
z-2ST}KK=bIRe<wP?)UsF|3BcufWAkC<X?*U;QSZ$l77P=UW(;3Vc6pI^Lt6(1b!Hm
z1@TDwGRz03Pv(crU(fHML7cN(g11NeDavVlx+V7~N&FtgAh;RgPk=3sPmk|0k^kkt
z2C)A=^drRnA<T!SOYLgwCH)3PUJA-k|7m(OK0W@`OZ*?oJP9NAB$7cmen&6%?>WSa
zzXvK7v0siApV}|Z*vF{&AH@b_U}1taZ`1Q1r%#@P_?Q12Pw=9AgqS4#5zL3ir|B#9
zl0N-?!9|EqH#9yyCfCjXO5X&&Ah^uU9IyS$Gm&U~nm)N+{#X7THFznspoU4~)AaRv
zNx$D|o&<gFp5$MF`Ox?@eG5omo1Os0270`mNHGAgp<<9Nj$<$JE6jNj==TOx3y!~l
z#-{?X?Q6l?Q9+!hOSfdb4Z6=3)r9zLM)t96921{h_b{8kf;Pn0{)_(SKZ@5w`Z)dq
zh)>5KDo^uIkJmC0|5blxSMwz9gCHqCRpvwE)AA$v!D*8ym6qf`hqIYvjtQhWjbc7H
zJ{jil+>t>XN4OF6ni$6l*ngy({#ShMbG%4-$T%EdYofM1JLpW%*B(D{+&EnZ>+0#~
z>rUYP*U{G2*VAK|fsVcbH^PGci59lg`tbdyk&k&3>VHT78NJ%~zkL(#t_jl?Msd8O
zBO;hf2kx87J(RS^`FI5S`~#9J4CcM(948kG7Yh&PnWi&coH+qukx`-KDk3bB;~C){
z!146)i3ksiU|vh^8xa{87RsUTr{_xXuK5`Cq2A%qk({WoD9>Qt8`3=(_2I$3%=_Kh
zFd{lMG%(a3m{(ksZ=?r(<9r13I(v|%@1TzgWGrE>dm@<3klmh~k%OLKI?L46)Wvk>
z^t9hDI`5pVlG;_6;nXVq%xcDKKDO!VN~E>frtMRdW%%^8Z{5-)?%M@oBbSq%v^Q26
z<H?Ry#u7zwooe1`t8@WHtBfc`aoe<4R^H+~*dwY_%@yvh{fBV6V?Q39o?b;vuu5wt
ziU6*vj?T17U&*z_$4X6rYh1L1Rni4w^;~z;d8Y2B^G!W!csdxfT+Wcvw@T|eE6db6
zXRG9PP-T@?W3{SUY$f?}`VzN_oF(nRDlLEttg4P0Xmv6=G$=GICX_iLZk1*(&J_Z?
zxdJEt6X?eX$o`K2(jfmo0!V`jb)rtkS<=v~(vrg&8+mE!bm(+5Aof2%4wwIZNc;vS
zrX^?ncW@~=fE+M^iF2RXWj1YO!+Swhw~4k@@&zUn_vgCTFbQ*mvsKzJtMtTvR;#+B
z`hwE*1SnCf^aR-+Cf~EC(zB=CvuDt=XVSB0MfXn4{?EwtQ~%}GD*Y76sZK|a;C~sn
zO6OI(^i%)ko{|6SfaQqvQ!GcMJ*5f-NhZ5Z4Cc}db6bK=w~I4KKrP8&%$S}YtSC-v
zd)fz{0I5R6D65{@ZAG<DPoJqM+anK25-9&KX!0+p@-L`uwdz)s#{Zm2UZSYYiIOG>
z82r!4^wWyOtyXDIcxF#$8W9&j<4t>NmF@_oH9b9Bv5*M&oTG70E3!P=bJohcfeK_R
z?)hiLY{kpH@caMZJZ=9aZ<ThQhiubY8Sl1{GUL`#(|I*I59uDE|BdAj$;6m-9GhRe
zIVf1_p7f;;?XfX_G5(A9-+TLgbkK-%r&pX?Ah%t4)Pniv7K~6{@lhrF_#)v2{S>pr
zi*~J+*|oP`XwIimE&*jSyCkw*txB^M+{Wf?kQy|0>zW<Yiq<GtblqCAI{W(1f^mlr
z%X(XOHRLSm`19WQ)uTv{S5LlOYP7D+@l@-+ZFSx$dC3MvFYn0mKbywi9z0s+*NQ*Q
zYI{`Oy>4zgnp8J!MO}1I|CT6qdymmJ%|;2L72^(<wksaJA22;qJo;(sA?d||$7X7Z
zUcDXkG|8gq#LL@tF)Jc|TaJGjo*hyyyjQ~JP?u>_op0ix*Xy>;7B(-vshZwdaVe%#
zye53qz{|3`gx&fKNwqbZleKv5Xfw;jWr0I(l|FWTFxWO|qw$x$9$|&cT;p|4a;_Z<
zyE(W<?)w>!29ZcU7m;^IJ$|e@9lzwBXU=i42j9)ZQsw%)7mDq-IV6<RweZTE+XtLv
zqJ!UQD{eU5Wox7E=pmlrGpci=m0?4{)I%yZ$}V-C#|LG;YH}{x)Y7hWD&gTE-x$Bq
z^Id&Lzi<=Yq`Q5;def_%#@56uL-$SJ(*1C#NwNIxEYV#9wj_O(AMc~;<LVl;Db7%N
zXW60e4UZP>N*KRNsiEe})e0>`&#Kc=3vF|j8Z3T%{IcV>L1nY1f3one8dbZq)baW3
zH?D;rXB7R27-DCz=F(Mr!CFaa=`(J(k9GaZ>9S5a`Q><o@X<TB_jg|ild~DqJj}tx
zt2D!>{?{U5W4BFbr1wW3n(Tf*`buBUff>35yY9#4Y{*zXsivQaWQ~={xS9Zi0PomI
zcBjs4^AsseE)s6IqAe<V^6<m>V|!o5Rx5{Y>39E}ws6DM1`&g6+JfOLiUdCz*63Bc
zrMOn-iG(a4AmY$RQ}-HYp5JD{*iD}L&%{I`Ib9;}mW#=@@`a9@G_dlj_Q>!8&m{AY
zO6HcCxv$jJJtGF046(J@aN5MyX5+mIGux|mzh2B%NY8zwa9DR?#UHuc$(ceWV_nwU
zNp0I}dPAlld1lqmbq#jr3gH{KpHSDS<kz=5o@XbRtmHq^Q~RS{db(z$`?=ba5kZcF
zmDVTUxOAewu2_>mlSotFCebFoCgG-mCxjz}d=3bFGXAn;)apo^@}g<-ep7UYl`m*L
zsc}W=!J?-XFYiy>GIOLH-=yXB3m@Be6r7pUQQi8kPBndR%h=<y&pAcc@hvgj)}J%d
zszjpNzoE2G)MfEU`vRu~_njDg{QR!%YH|G^?|rQLx~W`sj8Rg2n7M39-lg5U5C59)
z7&^L6Zi7*uYT=sU!q0v@a^l#_z7IH+rTs{mGe#t4(sId^Un?!nMS0yjwK2=u=%+|!
zeW8olM$bkKJ?W6VmBmTN`rF-Txbt3otJ_jNi>6h9uHT+EXV2f<>MF5KeBlAPErkL#
zdRjJ7t^vzZ;$xiyMzx)G6zV)Bf23cOQ-F@1)&LFDho{W0>K3Th8QR`h(YY!&d9wH$
zfyXj)_)e-Fk%;oxGvMp)hOGkM{^T?mHrz9NYdZGg5x$uUUngCbdC)InrGD~}1{p`q
zi}xh!zZ%SQsEZ$MFx<Yl-MZqb?uoAsF3hHdb0%<{G-u-2!@7+JqY7P}7b!?TxYI{2
z#gOyis;%(?DRcfpw+x~2cbx^6%$QW7WIQwXi*>#2obzEFd!LG$eOefittznas;WoC
zkNNJRW40Adj<FOxUVblYr_yuzs!N<Dv8R^|Uv*0{>Ghjo=6#EY+4i3%@_D*{?CV);
zFKs@4#UN8q&Zu$1c9U<Hc3#|JcvC$_(Q}^u*Ifk(x&g*YO~W(`LsfTX#r6F<b6JZ*
z)$72;&#Q{&j(%-^+~QX1GTrYsT2>?D{S=qBxvl?N<p1!FYKfS!zm&z~f}+R2R7Sj%
zFczy`C)OoZnD;!8GiCDEaV}BrpI?}3UA{H^SgNPzOQjt~6-R$6?HJ6LsiQvaeXD=k
z{65c^f7==3{nOs>t9mJTL!xTO=QV>T*?hGY$t+Mhsdi4aPeuRmRi5LQKULX!<Ma5G
zqnu?GZK2g8hy2L;^44OCQ02Lgr;E#S3v{>M_-dD8$60o-tzK5_Y|vL3fw~VvyM}X^
zU03o?(`R_xy|%~l%)ct~Z@b9IzQs>O3i=jz6)G1c7y1>M7wQ+)6fQ0rT_{>K*fb)w
zZKwQ+@n3CZ^BxWDY?=9Td&4Eu2#2;=A7^Y#Fgx3SLxNd>z!l>n4}RvK!xiW3*U`57
z9*K17wP_TMlTQ@;=)J;zbIZ?|gN^S$6wcVIW}LRMbJkfU`xqy=-DeYa*-wcs&(q7<
zwdJw5fkEzrS%uN()^+r4Iaj}ahQ^2sA9Q~Vm%QuhT)s_P;!Eio*I^xtI(2F$=ij{H
zB-s*kBt6Yrv2%^x#~XdVdUf|bn|s~SsO$9l1v0<Y+hwGmwAsuwHFJx+J!4qVS^J|=
zMm81?w-qWZ6FM2QbmFJTy{AjhYrj1sdj4g<tM7;GpEYOK#$U<~(qC^mIV^bd_R)>=
zrGdAl9yss1IZRYZf1>5^uzm|)yx6l?B7R@(7cUQ0y9wD>FZu2{JhE@q#erMpPD;g<
z*ZuJ_`9JKvd0b7=_xOF&AW8#Cq1-4EnuN>^q9`IEqSBlu4U`O_kR(&cm?86!sYnPR
z^PG8(%*i~2XRmwK%CXh&^Z7pC=k<F2`K{OM-gD0TtiAR=dpi4^vxi4Rvj?3I3+-Cl
zWlG(!1ovHUW`-u1<+!KMzxnoEou?PevqM)5eflf%$F<KdmK4}UpEuoiHSOh+p2Mt{
zyKh-s_v7@U>|^(f_Dwq+^0tmvu|l%<hl;XxQ{KAx#=f3sHq_|+H2>ztmv+Q=RcW{G
zfUC>$*DZF;J>(i1+PKZcDJQo4j^7`$YtYDB=8K-y>+|B^@qt~sH_bk4-}<uc>zP+f
zyf(WI2>hJ7W{y+q<q7*2=xG_Z((*XhtZ1!ca9QM{$>vS7AE-5yuDsGbbwKT1%6TIT
zx~<jd`s~KAvWXU%x96C4a{bZkaN37ECY2v{^^0|xrC<AZVN7f<^>d5l&kS3+?#`WV
z<9&QrZ7Esb`uDOj)9`IC22N~Ld-Xf3?F-AtHvHJr{P&*whkX`Yewy|uXY!k7i@tOY
z*)pYc#>UqBTeaxcyM>{Od#Q<Ah4Ro-Dh(V)<lJ=ex$Pd~Re7P=$Klo^9j1T!c}Yua
z(au2&!jAgo&glKSZrPVmqYZmv`^I#!_dRpgpkV0FDTx=?`DUvG_BJ~Ca^rf}ve|QW
zJk#w4p3SUnu;TTXEz?J~zSYI8!OFS0<|Eun&b?u^u4Vhk&ZjqS81UlurW1qfySpz~
zwl&tOL%-|W9o=;td)6Mk*P&zZp@|XdcdxHk+P~Fl(wOl><;U;4AYs3}agBCr-{}&O
zc(6-^@%Tq|r#!!rRyv`*d&70ft2~G8t#^5%y?SEy<IyJNv)1P7T`8%wxubC8P28m+
zo<E=D<Qt#ZJUj8&vAuE~<W*iCd79QrS;CruGNHZ)bR4%LY>>yGV>TL-T$Fo_XzsH}
z!(ptaq|@Ee8FdvGdzDH?9hV=Lt$)@nzV^Wemr|Y%?Q*CfJ7JTY*~Ety526F!>TFUq
zx|~sX*7Zff_{5OSCu&b@mMIq!Jz<@?ef^RfM>}5fGoRUVYDR8*#ce}^&xCHxJRRNf
znne$V4~q_I3~OJSe9pn*(&!fMl75PIM!zP`o@#z$^mL=w-)9A!o_4B4>9pbH%K>Xt
zXRWYQUvN(A)8Z_J9l^c|;}%Go93Jv(Ubv;hwJopw5|T3K6(nt0+dWtE*z-WSad~CV
zchfP0`Zqeg{bRFZZ?a>5DDKMceembRvaY>64p)rqtU5uZXtZbM;4<H`4m0n!F>_T4
z?bT<E&(6Gi33FS7)V=<z<%<=co3&-DYs`!q;Bj`Km*e-xX2U#Z?2FJ?_@isgk~&RC
zXihNLS!$@R@YE`H)U<GQ>$A-~<gJHJaL|1*`s|WgrguNIyAgMK{pzinKXVV}?sV&u
zo`1M?&suq%{3p!qu>a?wt;2pPU0v^dOVoaDjPGpzq)YPrgCTad8Z*jPXBKU5JN>-e
z*+rWT9rTYLv+uTfbcET>?+S~9i}uSM?R)8hN~vDaNt4az+pLdL+xmDxgS!Faetmnk
zd(U|182h=8qZ9ItGv);cw~V`<dCuWfalr-u43#z>wbvM%+1f9h`p~1cW&P;h?|t;^
zG~Z@cS^CLkVtDE+zh$A`Z#v#I`1s(_*`((AGd7gu+Vsnt8m|9B+sQl8`gq0kp+irl
zmbk57mYaR&!|lm4TQ_h%U-{;7Xv@5rhr-gEdG2^v%cRNRQ8^hN?-u-?dTg=vgZk>a
z^+tF8eZuUk#emK#*R6j|GWr#7)T7(UbyH0`x*9#Y&|Ob5Ub9D`ET2+5c*~CdJa@#c
zNcHjd_8u*fQ&aMbTq4(SnEBfGUTaU6+bv|n2sV_+8wd`_z0*JLqy3qC|A*e*lB=$T
z#|qCJ+gx0z_T+(oQv31dM>EYd*B)f+8VC5uzm&NoJ9F`c8y&~3m^5ft|5~;h_ijB+
zQ?XSjpL5wR$6Wg*`xtL@sPpEA!&P$jxPFzmSnYD_DQVCzZHl+q-j=_nR><$&Gj`kn
zh2}nHnYX@tK7a21Yfs(mtZn&2`)XbuAAY-YRB;1`O&0y!23|au9#yKo!s5dEU(z&-
zg*T)b`pI?IU&%LXzjOA|!i!lQp7*<CVRfgkMpEC6n+*EQh_D}#=f3`{O2EqH!^Vc5
z8|P7=of&YoWyOpzRm)p9d-NXYvZwM#(DoJ2<uw|)dMfE<4XemCHQFh+#3jVwNhg=m
zNg+pn)Y@9d@csHd4`&S9k>Yej+RC)fUHfON-;Z?+p1J5&%9(TXq5{@NO~_KU(^}fR
zba{^%{gXls%w|US`L%d&8|Nm`&MpdS5pl`hZReP)96R@8=sUSRwW6JdK0jK=uI={)
z?OGow9Y20|3$+V<m;L%Q`QU>e^*5N<v@JK8)bnNKj!|C@1-7{tUVgG{?S=hKo4qWT
zQ;99^pz`$5#s-~&<}LO}{JO1cevbdaB@>s{w+M0iHlSI^*QU3Jgw1NV<hk>+i@6#<
z`!_nYt5;s=i2c`l-0(j5t@Kxi`?e>WF7|u9c&*!%r_G}5Wy9(y{VZg!*~Iy3(y&|O
z);VgQ8&ILX|Ki~DQT=;flV6;(yrYu3)NDY!#(KjuZ5vz8fBNft%JNi+({;0K%YM&B
zHh<iE_lpUcQ)Vr0bnlW$%dJNgPNknoIMLC5#HKA{4s7dc6n|Z9khyz@X;a4iocY|S
zQJ;aTecyFiGJE-wUlX5Hv{!%fb?m2eMZ2!txGwcD^Xv36d0s)I-%XMRukH50Hr8Zk
z=D9mj_w?dhM0NfcH~YgU*XvvC=EaX3pPXX5YsTbT{WQLH`*5YtszW`0bW?p>-z>f?
z^Y_Q56EZK(-f?SBxY>lyDR~DbmzB*g|F9+S<ruS@_IvX^Du4YrpEu?A=Qnv%?%wSf
z@AZ1}-jSF0b^bNTzRl#<QQum>{QhiQLUfZUM-F6csT}xl<(;&b$@{y{vWx8=GE>Dd
z@9X}1UshgeR1x%GUtHMLad|(6Kk8}vYDDXgJB#*}dHYy8RmL<7*l1OmCtVlWdeHib
z`@TQkf3~($n@pp()901Mt4&Wnbyd~jVQSHr-O>q52fv!!uw72Uk%t2+u9Vq+e4KoA
zL0D7iVAG!K<9m#(d}KCs@1{oWbO&`EZ1jED&{sXmj~I8`5-~TlPS>!*OAhw0=-4M)
zZl-@hzRIKx-wQIDT>h|T=dCp%$@h;MDaEMnTbA_YrJ|Pk`{D(KeL@!|oHm(ltm`&w
z%L@0mrxTt`-dpPNu5?d}uuVQE@<tAgN~+iNY2)a|6^V)y4%)YUH9Tio7x$^Pn@Zhl
zCss`KZ_vNX!Bqi{nt9W$vNz@1zNww8Sa+aaQMdh8akJ)~G29kAxx2~n7Qc_2>o#u7
zs*`5n8)nHbU-Q|$jl<4&>x#6^>gO0;opZO;y`EC$_>)%gms36KjOdZ#_jLTI)RMO^
z=9ypFVX^nBOSDx$?vDu#1`hwZ^x5pyaT#qVCcajW$Oy1)x+|?TY-Y@@TAL=$l8ZD`
z^{t$`ywafJ=hLo7MzqtPRBuRw0d<@HaNQ8r=FIZZOTGkV6?om<*mmcK!v?zF_I_NN
zynD9(y00CUjZ|4%=5%$-;t9F7CJPoS-#*l=vUUEw6LadlvC`i@M`PpYR+CTLXheSN
zakP6%Vt{#stHz-A1^vgrGBt}GkrDLFXvw+HOXV}CFMO=GfB3lVlH`uv%=(RWnmJVK
z*1Mwx!)6bkSIO3!e>2HQ`JJzwc5$G^CGAAh-|<$RHu>#8xN~ds)j<Wlo%=7J)B373
z%ULh#Ww?s&kb?sof7VM}VXvh=dRnM)(Dm^1iVk(BUuiMu?4B8ktvVF+EV`lFamc`z
zfvubt=!8z1IySQ7_>)tuwyu~uW8vsrx!}T<r_Y!<j&RpWF8z5aS4)4`N0&XbPS!Rs
z8lG&h?tRXXSy7Anjnt4IG@`h5hcQ#XUp;efeOSUs-KinHuKJ`5551POy2&|d?&;vW
z6LoK0PYAMUzJ7Y*WKYL6FRo?Yx7iq5XVo<0OT%C72wZHCd;4mad$l8eEm%G5wT}NN
zPbIU@Q<hq8>OJDL-nC<@joRh4GMWE&^fQyOz0US*ll<`M&J76~Q{68gTV1<;tIc1Y
z_u0E<wc*$(cmEZQ4}EQrow;bXW@z4Er&OO~Dc_BDE}0y(c+<eB?`2OS+Aav{cW=a~
zjP^P@cEdN{XkIjXO}XOHk<-sTEYh-kpSJVLGl!Y`-X)Iz`1XYQw=pZaeXp}HA+b+b
zQ>VnU?PdkI`YD9xAJJ1@cWJ3gw$i?P+D~IFbPb2b%~iVm<Lbz!%bpr;8K$;R|M~TC
z8=YqkaC0{+Z8d7fzHPyB+EI$xcUDg|iJ!era`9I0{t-SU{WB7NX7Am&_iFBIrRH^u
zE;+9c>G;0)h5fZo?+mzieMSd|8w+Ffa>K1&PPNS5I7aJ|&*IhdZw<?Ae`xQ{%65}0
zjqbdCG{4L<=X%Gu$R}&E%FfjNZXP~1>P(9fi^rA@&|A2whr3F9=Vfd66<Yi@aXPsr
zy|l%dc8C1pSFPE;-8SxlZ~q-Wk9uw$6s-4gK~X}W%Z(v^8ttTKx7_%wGki#gjOMGf
zT%Ah2V_RHM)eC62<F?EA&f`2&%p&%utox9>YIdc4lO0=cf7x4CbIyw8OJnv8`x+dw
zxz4N9q-?n!1Lv>pR`2rWvfVk0jvZZ<a5j77iMvtu>EAn!AHU*Ndj+#`%_bc1QaR%n
z9itt4t*)E%>)VDWq;{(f>eY4~s@|a9m$OFaI`4=my<}B#|ElhmMsdBb7#vrN?!M^M
zvJoH4H=o?w()D&(hJM<(sHl-6dqp)mwWi!*U5BL^6K#*_&v=-$uA}OF#l&74&zD{p
z6BLs@F0IF&{z(BR4KC}S+p(yLO?<fC(NiBM#E)z?prCt#`<>SJDtd=IO;+0wU$SG&
z^$okzN;{ni-BhajqF4Hy_K)uBhaZjZu_|I?`GW9mgK}T3zp_PffK<`1_GP#6p&L9e
zt~+qHo70TwZbJ{0Z{Pj3tw-qUfOGot8-5K>l`pW<emHo~n}a?Py+`a+8hkXrVVY7#
zr-Z`|OQY)y*zT4$e^8@!&Og#)Zyc?^uS7}Lq@Bk0%|CO@QXXBKwkKUK@YEgud0$gQ
z>z~m*zb15i#hs6vEIVG=b!FASH=F%p$Lm=e*FWfI?RTTI!=9!YNB4)n2w0S1VSRm6
z@W+?RL!FA1DnG5BGB$QcadGR(6^~pj&dsXlC7Bppk~bziQfKgz!*RM<dvEU0EPZzF
z++L%_tH0fkecQNOWR`W>h6bxj?p>Z}wcF6<dZK*b#||gPhCe_3AU*u<T-W!`?+&fJ
z=4$%c>xRquNjgU?yJ&TGd)~AAMXUa|cTZWXQMbokmlaoQ*Lic|g>~MqI+~XqewK~b
z`t<SilhR)1>vQj&$covxVvPF%^;rgurXFALxRcNAHC`4L9*-Sf94Zf;8~oGxsB$Y)
zo871UvwMCF`ndY!j0SB2N1h)terrP8H}ftX8@f8t{Ca~|I#ZnVO5YWKH1t=SF>bBH
z*#j;sb=7{}QfjXDCFx8vpN}h+FFtuhd%fe{EB99Sa@nCiAkeG#1*Hy8y<acY?$|-C
z|DfXw&E)!R{9^U8|MU>cccnSu%5AbX_I`Z8W&h`q&wj_YnbGR6c4^^1&kcv>-|K(e
zTs8TJ-FDp{nvG@+-F(Gr%ps$({;m9<ycoO3#ZGno*yAph-yF+|b_dScF{xFLF5wn$
zH}7ibH@0o$SDn^9BMNW#D$Vxqq-ogV)CBMLX^Mfd({qx&*XlO?Ju`2BgV(kP?c`bv
zpMA(<dg>mVo)M2e?jAFKd4BP}Q%eVY(r91ovD7$NBH#N}bh*CMhnq*e-$ZQQ8n!27
z)vx+rzs6niSrBsg$PM)?L4KhNUlfcv*>_O7#mKDj3CS_5R<vz6{h+o}OXo8)7xrjs
zIMe&<wosQS`Gy4}U3OKT?r*%O-N5noo<{vTw;XwF`-62}a~Ad)6MlQa);V6aH}tzc
zsm=3IbF%~IOg}be$>oiWpN#la=f{%Y_a%Mo?Yl^geIvsCeA)#>L<Raw1ATp^79C72
zOwHR_w#GeKe*h_qS@>YZI<&Iy`*MZi&+u}1OzlVLR|O(BVUR>FPD8GVYHels0_MmV
z^tl1K2Y+^I8tJv{)O6;`+o?&@6ztTD=P344GoPVkuVy{Hb|1Be(ptH7)vRsR%x%?-
znF>>7PVCf_ZB^jQa1hvFVhtYKs%gxq)n83#x_mD+seCgzHJx5+8n$Z6>=g7(Sj2uH
zFW`^qPOnv~3{G0J!yI5t^1%-CU{0;xYC1FIZPldH739~+)m77B4rIPEF6_$mYx)B-
z3X+Q7)t#4@#pb_f<p1g&FPw*XtR>>II76rMvR)$9*?}Gu|BAds<zL8%{NKIft90Zg
zTt^!`BmYm2L*ayc)y&{kCS*JEvR-a~GdPm3>T&z`IeA&HvcDOmwa_c&Z!UC6Qjp-|
zO4UhA*`5MTK~TjzA@5d2gdO2nLE^x1Thw>tcyHt`9Pfu5yLwigbwy5Nkm!Uv@-YN(
zI~;io$GwqH;CKM?bdHB2U&rw%<Oew(hx{VPp-(cz|80&Zv18Wt;U8I61K&~uhpu_m
z*(s`lU$23e*1$h8USCvRWc3AO%B-MP=dXGVT)PGieRiv}17nh_<IXkk;Wh9e#_Nkl
zy~ye?7XE}9^k>w-Va}=Q!n39ZzPkoqR0F?P1AoPMeNp`*t7lpGf7YO1o87mo3#VEQ
zyj2ZcA{%sq!&`#G10qa)|MW!ii5|ncFhzKU#7Rt@?akqj4Onruw}ij;@Mi^o9pJAc
z{B?pqHqyk|zBBw;2u@^fEM$%>WUee^&Mai^EILZO`Zy1;vvu|w(7U&r!(cD=O~l#3
zOA^dR9)<dQ1q4S$$BglhmqbTK1&7B3NJ8S+=#^+TID~Ct`~&@?M1+ktfgV`sG@Ok}
z0+(KF)QOMp7%$(TF<t>a!J&U$vu~8Y59`R~>l4Zby-31@jVw~CMjCmcPLNM@5bFR2
zp+bTl;SqG>Vm^gMdIkEkK4mc6#Wy0B1u`o7FE9Q4Wqrrkco-I@(1>V%NkEjpzo7ER
zQ`8cB8tU&8B@qEsk@*x5%z_o=9~m0#>*IwdFnD4$OlcueSyV=h4)OPmVg1mee8VF7
zAh7;%nEYrdI(P#1O>58cCP-`cGhn|;=(fa!?hnwcgu5g0L2Mrc^qaFE@j!q~fVW^j
z;*kKEfE~!^#HRpc!rRFZu#6kBebR^e6a@5**pE28I|l*YlKqG`1jqz9+*65n1jqz9
z{D=<)$b{#@ed1r9DX9OWpC{rbY@h6(74bGAezykxO2nc6DB1a51BbC3AP|0NE08{n
zkpO|Pz<6ik)Zzhsa}mexJTf~lK8f@pO+i3k%(1KVKU`>k{Ht#(v+^(RR|9vifqT`!
zg?7Nd_TxqR&}O3RnkC{;7Kn@Up_PcQKz)eM4kEr8ImD0HPOgZH?Hm_z$dlynr5d<6
zpNr%FA?ow#t0J-k?S8UP=?LW!`VSL_JO%>c@63M0djMnt`t{k5ICgQC>5I!Lj0pn)
z{RZqu`knxpfPJxkkc<lY@C-ouW0CXvlSKMZ#z}uh4f+d2`r0D><u&MU6X`b+>F=vS
z|FlS7N2GtH2K^@@-bJMU9y!DtltH>Kda#0cfV3k{bMSzEV-csh8hCvpQT@<Wqz~;m
z5U|sP{m4GG8+ki@MEXrd`mQ4T;&9Sj*I-{yqz~;p5Z?ZHk$ru3p27qDO+k2lX#Wux
z*L%>B6a@Tj#(rccQ=~5r=X#O8yhvY}?Ss^1zdEu#;jbR<1BZQibPr_&1UQU&BZ0gJ
zLLABl2&5eda4547ryy`I0|Blo+Y|oU;68BhcMlXACN9E8rVpIGgO`a1$7wDny!}_{
zZ&nZ#ss1GU3!#!=Lia)9rsyw~JK|~(c}&uTO_lvliUP>w_*{&LRUH3;5xIrq8!$Zk
zIX(#!>JZ22K6jeq^YFx7j#D{*&hc_+yfFDJY^tuy3oe|=PhnHVi!t%FFkevo48t)Y
zjX55L`cjTRhs0#klH=Zxv6)c$CHuJ;|CXG7PYfrOYtr||%tdob5l_VQ?Zw#%Lpyyr
zejVd~Ajh-ucqGSZF85%Lx4?LyIdLgGG-v5FPX7bOPddjdF`vK~MG&&H1M}Nvp5yf%
z=lCzdx#SYZDLgdy9ob)k`JCo}Ax`?Lm~O<&QD2wikI`QmLrD5NFq|~k3vtSqFs2NI
zIQdI!2N5TKLpgo&7sh6Z?U27qIi896Z57A2V`aIX<8?5fY~i>8@*IxqV*KQC+!T2M
z$Nexr9OHO<%n!vJS48~_93PJ1xyErn<hMEA5!2-%#|<IEnLOjTHTp|)$xyls6x1c}
zIsKhj|9s{6O02hkaeM)mYXwXnvR@DNRXE-Y-8bTRbBt$NTZ!yYxiIJSDZh2+crMm^
zeL3!d@#DksHF&+D9N&TAp*d+NJc@X~n8xWZM}KLqZqk>-`{Pnhe<#{m$MGw8yo2Lq
zm|nD|5ZS+s*L9!M*Twqn6~`}Nz4Vpi&rx3y(~ay8!En;tlEf=9Up3?OQ}BA*a(pMo
zPiKzjqJD3lW4U(YIL+1Q&GAtfKVcm2hxwD{_Mz}oJBijjCteT3vxc+t8tw1kcqZQ8
z4|3cc^Hnj&>tlRg=lDvD|Hm9ZkNV{tKL!D2Qps@-OqV*Cf9bl0U_5AZd^28e3y#mm
zV{?wDW4+X!<576MeK~H7;Tg*DG)!MVjz{42jOBPG=GVy_pN7{Z40-!=KN^VfnaSx7
z!un?;$D=Wx_i>!YW?$gAI$qaJj>}^>-*Vgv%iTwg|Hl0Do#Xl#9-6d;(or6-S4l}o
zf8uc%Z?vWp@%xxw4LJP<82`;Uz6r}|2acy=`gY}b28Pp?<ArFS=4hqx^v8JU&*|Sl
ze`)Sk(!Y#)p`1RgSr*0dcbM*R9B+g1JelKC%nwN%htaVhvpN0(@9*<DPHWC?=C~H-
zlbsxYi|MtG;~U|^nH=P}HRh|M9QQ?jisJ*&{&|j{#OuAv@!P0RYxq$77h?W-!0AiT
zUn(D@e;xDjD^7n7URMRjLoq*m;dm$X_b10^V*1kBLFDfoY&X}zd_?>QrlUH?=~$cN
z=dpcd%5ekCKUN%HiTR-m$M<2mu;KU(yx!g%uaDR3!f_kCUJs5B!1CqGak}qDa9kVX
zaU#c8V0|*1<Et?p*KwTc;T(?Bef$u|shx0!<J2CYa!=_+?S~3ZKLF$Z3&-DMe9~G#
zWM?hv)7;3!X%2i1jBny=F&^|dPVG+<j#K<oJ|#Q(=r7HsOq|xJ8p+u?gZd#n$Lpjy
zmdVZ`s;@Zx5X^7$InIVW%48MCk6=FE%JDnM4{$sg?VRFx2!@BA%PE|mm~WqO`qUn(
z;5f|%^qb@Lz#x-)nBU2M8;qYO9H%ukT65e6ud5Ts+o632j#D{z<9IlR&xhj!F&!f~
z9**_@B#vuhyrpv70n1$`#~WikvytO#u^!&X@%>mXj&r;p<`Y^=gyORYhW`PlpO5wD
z8;;*Ze}8cN8J43u7_Vf%9=t?n(um_Ur@0Zw=V5xa=lBDRH(QR6!|)8?_#15Bj^wyD
z#?Mra-@){vH9+7rAPV;~PX8>X7u~l>{}b|koc<Av|DzmVjQRNj$Gwr?;domN|8tJl
z#(4h3@%EUG@)#d*8m^1N(}d#}@qTK+@qu_<tvF8QtsTc{4sk1vpTm4Y^)ZE~8`d+<
zoIcgV9vrWY`7eOu$Fcs2=6C_SW{^aV&!BYYIOX$Y95=@NxtHU5cwPA%--+e7kmJXM
z;7Cq#JPYfY^Bku&*`IQ}3#RWYj?-E{6&&A+<>(8?(~<w=cz?WJdj6pFx<Gn(-NZ*@
zIyUF{JIq(c9KVR+H|2O;^tS`YBQPJ@a(oh|dw-5cVLlnbamrUg9KV9~Aw6Hxb<z8i
zbWT4QkEuOH`ggFrZ|3y<v0UeJygkPMagKk+_`JmN2N=$K9H;imOODfX#TSl0z<5)@
zazNqtN3O~7x9G1v$2XyV8;+mC{7>&A$$mU?2Tp$t)^CG29)$W{99PEt5Xx~Xr|}%8
z`jE;!g=ZwD*FsJ|2ID`A;~g>oZ|67`Ye_!GyWn%yDUQcO0GM3kxB|w*BaSyhf8TO^
zvS3E?gX8qQPZ`sPu6GvZw}u=ahvlw0$KCKgYsT@1SiZV(yeY<;6UV8&I)vlYe)i?~
z2Mo_xju&9MPvLkiJWk{I5sa7R9RG=SHgnt#_47Dxf$@BT<AX6Cu5vsZ?L6Xmcg)Y_
z9N&rc<WG((V7XJlEu|y957gy2y$@`~@geAM2aeNw8GDW&#Qa9>T=F*r<H3v5?}+6n
zjN=PYKY`<;F?~}w?u_?^B^<vA0bsI$<1f$-<s%B`6D&uioPO1sF6a;G-@^E*&+)gI
zzA!%-2<aDMxp3fk3(Wr`IKB*d9LFm#-sW;V8N;)h<9o0k-^X!U>*XZJlkvXun&WPm
zzCSr0i1DU@{?qkN$8Z{O+z;Ki<M<<R$i$xGFEQRmah&e=ksP0k{?6k#)tlQmejL;L
z9LL*YIG=Dl8smr7Oon2JNEUuo^dBw<e)JtdgX5Si5<QOhmsw$bAUWO}c}wKvFZ7iG
z=_=BPs-!Olsu#y;F5mtl4&jUiBTNQye5`;ao+1wRn_+tSbKC^uD*`!%(;V&05OKJ*
zm?57p;t+I97Re@#_e1^TA`W)CA-^i(V8<KzTM-9+2jpKx9P}w38eqPL@Poc1>g$O(
z=+8!OE#jc>g4|BTL4P&!ks=QILy%K>qIf%id>W@e3i%un2m2++H;OpeAA@|Ch=YC^
z^3xorenh1r4t8Qt|E-9FohA@qCUvlWrFfelU`YcJ2mRKlFXebQ<XuG^{7pwY4k8YA
z2BW^Wh=cw*)DIDH&<{oZWDy7bgQ%Y_;-H^|`ddUC^e>|RUJ(cV*{FY%<13Nh6>+e0
z8|^$3aj>%q^_B2>9f}*2J9_U!?@K@pt4OxT`r(N5!OdbBWqoToJ{Ng+ju#=f<v2YT
z4;FC<4?Q=H5pnSMGunyZ_)Fw5$SM3b$Wui6VBZScH%mEvDldCQ9O9FtNW>w2DE~j<
z_;hq2OgJdazW{bnO`@(XC{Q@5-&h-tQ$J&Cj_*MG!#I8qc>r=s-wD`$2ovdJQ$Xfo
zjz}Nem|#Ac$8kgC8Jry~wvx3Rhdz-YJ2~D;z>)%vTOdEpap=<tQo?bnZ=Y~{fS@jU
z$8qW}_><$ls9zU4#WI1*g!qYs1160)K1sk5Lypfu-j(B&zK$H<j{5E#&qqF*<EM~E
zaQqr_TBDW1Px)a!>QjE8wF8%n?BJt_%u<0!AKVPUbT8z%6Y}#Mk3oK!<Kf6lL>!uc
z)NXko;!sX!WBv6)#34Kj(9Ro<!`M`i_aY8<sNYYeh=ZMVs82%}fx!>PQGqBzr)MT`
z2=UVe4w&e2+*QC5Q{-Sn9DZvNhjTC<3#1#zbCBDLxH$a%L>%l;f4%`6KZ<q+Bd73>
zkon5S+j5-RW0OR7#NnSQ;^6NUw4cgx>PI+F#KqxXCgNb{3EEl3@khwlA*b+9#PH{F
zd;#)vB0J*nmxws{`yTDz<~Y44d?4cD@V^jou%n1Khc_ITL;fB)g?}Z6Q%P6YA&!R<
zLylAX!Ghz|PH^G)L$n{v@p9ye9H;k?OE|8A@so`lt`*{;9B&$%IX*>Q@L&hW={a{d
z$IHPWlRS<u0#BG6tbrGDoZ7WT96tz+9VVwaPS0QGIo<@{k6qz7J>QjZe7#^^g4Kzv
zen2l}XXyR|(FhzL2PEUr9q}f3yhOys?XD9w@Gl&v`(_(VH`s{p@2(;)uIH&AGMolZ
z@9P$F`c~*4jUym^st@;Y`cxklah&QOT9cXVQ2kTN=~H>9e#oRx<y{HO8S$#}h2e#4
zhMzQKL<2eKi{n`;;^O!*7jbcX+K9L~-7))C-7ngpo}Nfw?60wii~Vgc;$nY$h`89_
z=E&iCp=nF`uO-J*@z{jphw<2y<Eoe*mK>-4?%g<Eb^qcx-KTnUyaes{<2c<HC?C;v
zy+(a^PX80~;T(r?$sjbIj_fF4zVQ=I%kKFQZ?I+zNU*S};ti39bKC%VG{@T_kK=eJ
z<dZn=h<qByM<Acc@iEA$y-C+K1^IkVKNb06jxR#Koa40iXcot_Q9qmG+mLVJ_&(%&
zkwbEb^S>0+2R7pTPyPcJ=YQ&d4qTl7rR*34yc63Gl~I9<?JpH^v3&|B*b&?RpRF}1
zT1fG)l@qJh&Jd4S=N4APk<U0*n_ou}&*D(&8qVTS`2V|(qA=!<&qI*(Ht<)CfUZ~!
z*a0wco`Ul>@K=rS?prY(xc~gWb>Eh`1)Eg=vR#?j;I<66v?2d#3wp3G&f}nKjtckS
zKqPd3B-EAdK-0*E0B(!n!kF9?HnK5@P`>D1i_KnHy<46CRL|0QEj07bToF*8SLc5g
z-Z-iLfH9CzUU~nao~_P*S4@x>?7Ud`>xcTgI{yn>3$7kwJc9r5iiP(d>ecG}w*jL}
zX#Nc0=-;_ApuVoo|14}+&>DE)zY6>D{_kf@7DPJ1j%9)wA`b#B5?*Z&J6E0m&#|Fk
zV<tET|Do+e?kW9?7^}|z{rJ3)f$=9;`Qx6BZ`9!4Ra4Mt@E_b?VQSTd-xyzXFGcqd
zen@*h{I40SF8o3D*$F1p{uPe?xTj+%pVj$a=p|@C{sIC2!6ffLcwU|V^!>sf9E*h9
z6Z*k+s`KC4ThI{u53gFtJ*8j68vK8U*MD9XIKdYDlY1f>?0j|p=Xj$AmP5FHcqK>f
z$$ta%pI<|+5CY5OI5`jwtK3tt+ScHH7B<L@NwEg^@ZA7Z%<(*Ja`c5gV*<D(bF_6p
z_neyKCc5W2xg+k*0Mu*H9uW(<=flNChXmHp1e?5jWr%Pl&xK9ZKkpvKu~(aZzJe2P
zbP47lO36K?Uv++ilXvKU7B<SHjKPn057iT95w`b7<{1h5)NhH-fPZ3vYN9&#8h(Nn
zjmIZ9ynA7G9JVZWXhfiCgqid|ts!U8!Q5O}b?(1kL++*}`A+v)8&)6aON^qs7_sHp
z;v;d+9kx=O56mOP7M+$&h7%hObNonSBBX5EKQ?nvjMP^MsFY1R#FmPa`ou_OHsIla
z$=F!`sCYK-P?Z{+Cs2w;qow16V}hh;y1NlP&(vtYtu#6&I5bomBQs}eiuVFo0nRDq
zr^Rnr#V+LoTLTVCKU@6G3KxIdYpBeCQ%VUg!<6RTE%}c6+>gw!lv~cCm9NTZ?K0<-
z#}=O*Q_2JfjwvS`li#Q(-C_;|;*@gYm8N>LBnDtDCtMs$w!RZCtR<|^7UTP887Q>H
zR$aSL1y2c(tqYf5#b|LarkL%V!a`A{6qCUgz;dRgyI#%1HS8RTz|wMXrGJ)|b7V`)
zL1Z|mJg3#=j?a@_T$LGiaWC}Q%tS06Qf^@&EDB{yw>en65yJN>TiD7jS7JNFSy;S`
zExecVNmzT&G3C0OOY-L!Jz0ov&}FG7onmgBQ@#j56w>ZO%*l!&EY8*&7eqtFRM~mq
z;FU>$db3_Eo{tFr%hA$alv+o?3i&__`mt5|s`RVQ^-6immh_`T!E@OXX)$Xpesh>D
zBPXoKcbwumRaSXBvb>Yjn#EX^i#CFx>0i65r)#hiua3zA%HmxnO|Tr$aomdRA^n0H
z4%O)qct1M&!He^UdPF6-T-$IvYe>D(6T=$26qWSRO44qA-OkNx-^s>@QgXN2OtkY<
zNNRpG?YfKhNOuj-Sht*HyGGNLU-pmm)zV5h{JUE~%NyIeq(=Pu(DTT*-_dGr{VkqZ
z>YG;#mJ9B9>cg5RlM_A~ZdDxh&|9z8wpLH|E8f>?)@H!7V764!0+T)--6nXL9;$W2
zFQ?Tr^^_%3EZ&D4*pznR^Ju-3b+$)#UG`|CzD7=EJ7tYdcKw4iZzrj(8FTuI&1&-;
zzxci{Vs9OJ@$r8Cv33<_Y~McrH9J*HqmxxV*Di%8y;XG`?=RAAWE#Jq(?U;!__Nd6
z*zMTmFny!P`6hKw#;$dHk=OEa`l4%_Rd=mk87M7Xx614BmdS7S)b6sa)sQJ|uFwCJ
zH&D;xNS^YSx*vAFP|#bQH{9g8N@mvkdux1h_XItEZPL4PyqoFiDFZa;cX;;uxckm8
zKS%#OGOED_<>ks(lXQ=@^_govV3@S+md&cS!xn$vbmmdu_jPkiZTp_-<KNz?hxV&W
zV>=s^45{cpA|Y(ejBz);PA-aTsTXCm%4K`W?Fk{ysV(MP->$Uzv1&~3nU38ayx*#E
zM}4LB(Sp^xjRWUSzxymc<al|3!t6kW+RJAQ%+f!kKeJY0Wt&=Mwp~{{8+>^iv~JSO
zZW|O$52t=Id1<&W_k8W+N7ft)Uh9?~|7`Qv^}}86wRb(|x}j6P_S2x3eW!o5>vQXk
zQ-i17%aax#PCZ-{QD%Dk#;c%k%_SduTk6GVHFBDDtf2nI(Xpcf7v>r*dVjWU{eg$h
zJ#8I#_sV4zt>aJqH4a8ty3KZ4*dt--#)028o1P3%?D{3@-NZUg62A>IO$u(aZ&dd;
zo`=7En)$eS-}#fypD*4qxck}0gXPEWY@U^;m}%d2&Fi!4-nD)D`R*{gZ&S5Dx>xSp
zTB?`*sjWf4-dFv`x>`RNv$Foph%`&jmoMX6Ih%O~>!-cgm1Z|!=B|M4M*>c1-`vsi
z@wA|ktLH@KDy(j+o!z`-{+%0k<8AUQ_MLv-FWMpcu!`ZF_TPJMFTVa_dGE#(&0qE$
zyfR~8o2<nqogalvJT^VxSh`(@gCT*(leR8z($e$Z1M^4A(wlz1p3uUhZKLFc7U?DB
zCswv^u+_Ooo2apt+o!*F%U}I*kJh`utQ9w&JvKVOqj-!%R<7MppF<bS9DYvxc&3x7
znO%!3dFO9;uCVQ$9kaWROYq1Z{ZBjBD*I_8-S|m<x$lUFhjm)Ex}7z{X5)%R_4a!u
zowAE;cCTanx_Q$t{1{{O<>W$}2!(ZOMQzW%-{c)$Z-hqEaqAYP6#8FVIqPAYM;_^V
z^*w`ICZ?X~lyY@gy2n_f^u}X$pGz|@QFb#LJNefF(~0LppM73*sqf1fL*$y|$^Rat
z^Xt^t0UtVl_;KRk`bmwGgUWu_Zg}lz0k*eUjS+~Ara$#X*dW_M$80oS8yNQLqkXKd
zlfnsi>2o==rh|=hy3Mcsu3j_mjPGral)Y|gGw5mXnB2hpgoMRWRtw4%g3dkKtSP@L
z-BbR2?zNpQhgGPQefN+|>Ercrol~KAt!MQT>ITIYw%psmC#;rrlbg%bpB^apHhI~*
z@`t{BK~~s==Vz{X?sPjlW!JXPwcgk@c0D`AvCFb<Cp;aOU#cIIUNAYM)0W~)X}{Dv
zqgD<+cB!k@geA_JpN8jdJyJMCsmG!>Z?>r>9zEyKuv4(_@X%!kOuHL*o#&|ksI_f_
zTAQ`AW9xce|Jks|jJ0zHrdW6F?NMHGbj14?6Lu__yH~%^rI%awttRTHeps*F;hA=}
zUdr?Bp^hbihS{!zq6UuGa&YOEr-$|=c-~k)Ak%Hd?eRB;Dx6#Td6z@`mI>!lqQ11(
zpVRAoseJmz{iW_x@~yh8f{K{pliuahaomd7`37n%ejUCHP^zU?U+vQR4Ldf}PtRWC
zAa_c7v$0i@{NRTpPSvqiQko{M7tGdMTslsr?fPxEGk^aoEq|@px5MCmnH#_5=j_(p
zJxQ_U#1r)j9CSX^8*yy?++2;E40*Q;9rOl&+&g#N!#xY-d@oqN8T#?7*RtI8!5952
zyBV!C%AW3ACa>qTL9g}IpA!zYskp1yyTJI3txwN|*8<<DJf5)RVz}MXv3A)P%_e4A
zO+KBlYh&$kJKyMBIUM(_&e@k^%?*#u3zqlo;}tdZy~ir^Q3?lo53`-!uw+o3cfStk
z&zRlgY2x=?t;hG8Tx(jI?R!x?*g&K(`4bO&e7tGxmw6{<9rJhX{p2{C7jUwq1ls$G
z*h-e&?ZBaeq>h4KqTHVsmM?3;GlNXlu^FCmm&TyeF<TSK^<aNH+1f61QXjo9Za#2y
zY3+0Sa&j~#tSdS;EURV5mafabX60DA-fTRlomW=RtY%ri61}{ARkG9CZ=L5|aH8{`
zzzZvH?C79$a`_lvRn19H8yH;~sug1Xd*b4dT-O!XjazEn)v|Pp{M~EHZY96n;|5*W
zuF>Gk$V)HVwEfZB#v^IlF5QsS95<!XH~Y)GE?wx@EyLL3aG!SXM<%B0FH!xb?J=$_
zsdD|9nTBcuQ)XBU+rQp2Ps^!rY>{S^T^)ntE`vSdn|4*|kn5_od%%_aZ*5)LnyJ||
ztxU+@zH-2o=drKT%`Z-_7rwA-ea+%_*^8eR?@2hKquV{nb+JjEIK7y<6G!`u>-ac-
z^v|-UUG`sZ*(pa}YrVDlyr8$vN-uwndin5t`L`Yg2PY)vPoL6j>9*}R_Ad&ob9dg9
zxx3nCZV8yMD{0%czHXt<9Xu0eZBWS6{G5F0_~I+c=TCQh(En`PUw_iGHzw4dc=sQC
zC+dz=<Eh(6`7>6Tx$WbNr<*lScXR05u<O-s7CPIF>MNLJ6}`AI{%G;s1&tK89$FDS
z?$I}!dkN~-=Fe?ilDKPd-B+6$=nXrSzbZ2A?3-r8?_Z6rus(aE-}{n~I@h|i7;NA5
zSzNz*R*|#9&qmoNMFm-W%s4GKOVj1m;|IH&ADVhY=jef}!%wd5;25b<`7H0&X!}*_
zgTHt$y*gu9#l_>juHFh8wK%?Go4J{LLUNCmF1p>u#5T>lBz^2q={Bd%;fX%_s{0LB
znZ3v~FBz(#mamf$SXwNX{%Z8X?Ym8^TPzy7CNb*S(rfj8c1?_LHE^L@(tsR;`g%`-
zb3ISqyVp@Ydr{Zj?@ydIY|^(Vr1`#(1vy!-mhNdgC9M4CBOkZzsSP{-T-|b(YP#*M
zh~4(@3kMekjtIMJxTVkWK9{>Y1t{D(J<o55`<_;#6H1?dzCR%3r{%}7^^3E%1!-NY
z6Om~!Q-0a2HLaSZ1zNTW^m>r)-RoP<O5Z-?rqAnd+@++;XO&%378KX^cTWz>tDn{L
zXXw7zBD1NN=RaTH{KgjT{z1v@u1<PBIn;HRp<Kx8K?e-$e_p+#PhtC77jC4g8Z^n7
z9&@$MtJ-(2l#H*CHwv`AziE$8grv{K=YbD>FEszK-2cGJCtoLJY%Q5yuADtq<MQVZ
z2Y)}ldE5NrqgvZ$hwa{fxWDNXPtQ>k`(2r<d;h+1+FjjMce5UD@c&$Iz4MipPG`3o
z?%Q$rk<P-mddK>DX)f#-_u*3FMY$<XnwwO5$8^y5$RFC}P4@BglU?tQSvFkRD>e7W
zr)f98gl{x*S9RC_wArVV6<eEQahc&uOTC95+|6>IN5^>iuk)<XwB4w-Xiw3_?W_C!
z4$uvfbGZ7*ATBO{`I2}o)44rgmg)|?fA~`O22tk@8#LHupKy3oY_|&SkhKpV7EhV2
zemA|U{&4x{ez<-9WtfBC;fMWp-OvW=v%EH6DO#_;+3oTAzTYO?wbZw<yM26A)Xq0w
zjq^Qb?aFJpTw_vT6XR)458rn_`94lzO!OSv?@7@~p{0jDoj&&@ywN=cC+(KUPx|JU
zz3t`Pad-Oxi3Q60pDIjMdRJmMsmGTx--GFQY&=6=9VmQsO)tN;G<S`4f#O$n$01G@
z0gCIJHCA2p^l<Trt5Nag5k4KxmLK`<)_0uRgZy2mU(MOw+GW$)NsqTZ8}v!paJkvG
zm)EX!$<$c;^YA9!tp_ZBq)!XJS3BiqdHJO?k6bG=nz(z-urtUj+Ihaw8LMly|LyGh
zLPZPjOQh@v#r}UY$3A=1s`?%u0+k1w&weh<v7aX2M@>3MflZ`8Ly=9WKV8X5t+1AS
zJvO_&c`r3%ThZkDcJNLZzR~)zA4rQTJ5FH70qih0GhnX%=}NUO*ZteQBe<_gz*Nn1
z<5&0A1>VI#?EEX$&6y8c^8b9f5ZuaFy(#)*3*O(#F&D4}p?68}v<RGzY1<At=z<W3
zeR<iJU)cLw<g0qB@tnT=^BiAP|Badb1{@I%<*Ry#{(ZW-x%d0XRQ`=mXXN}hpMl8v
zG#!GR-r30x+207+PE{*|u*4g=u&u%pf8_i-$q>fti_%e+ml>PHew0=+r}($92EMcg
zo>c?iR|7v?1HW1We^vvBJ~-8dpWXVa<uG??b^4|?aQhlK%t2V4ozaZf7v*AES!ZFH
zScCr58aVVdug*SvtErB|T!YndoLU@Tp8B%)mj2_|)Zc;rai*4R26NfV%xJIB;OH1r
zi@%S(s-`G6l}*hq`{QPFm(A8Lo6Wt$UmkhMUUSwkSv%ORnxP%vmI@ANs&rr9n23l_
zAy~xN{Nwn+{ck61N_Ib()jc#KVoYo#o4s8&t2@q7K0YXd&2%m>uP~n&-yq@IC4c!4
z8O!Es4+1-Xn<oD-G=Bc0V*_iLApUQMzCOM|{(izt?QwC;d%xI73B)m*!X2h%|I2su
zB|6mKKa%zFXL$vrHTyMYKblh(?n5AO`-j?$IQ20C{U#zllI?>4Z_0k89|4dFaHx}s
zCj(>x96pN>pAV1;aQIw6Jd5pvKzQIY6!FafnSj2O{fI+700R0@>k>Z<kO}A;upjZ$
z0GWV3d}bnk1t1gN{u2SqcyqQ-`X5BRg@`M%@&W>O4B3zLyNI|r-ufel@WA*1(jO(#
zHxlsx5pOBtRFi`p_^GlV2)G5|<DsK~W!#wUlfOMh9NZA^jhyV$oympc<gW*E6Sftn
zyBBh>4d=*y0CL`bs7Sw!NT2c*=)<=~vXds#7sngiUqHZLC<~;&79bO_(}?|u?*+&N
z^u>0L%c#KNo=W;>kn`ccEz%d4yGNWp*@17mAiNz_QM!xm&^L0@Cp*;MsmpAM+XU2-
z0S=$(@5-}3CQ#NufQ##Uh+7ci_-X&Ixu3x%lz9-ylOUiEeeOsozmdQD(BH18Kzs`x
zJ8_)mv~=aTGh8?mPhlhT7sB`yxi7~XDheQk<G!drmgAKe?{OSIg&f*BAQb)rysmiy
zuHv+2^)ilkKs#GGegf?r<@g3Hc<{*wg#0}y97@jPmN<>|f%Xpwahm%UKDU7oKZN0V
zAmA!qivB+3xCzGFD~>P1;|h+S#AE8?O#T+49cW*H5EqWvF@}ryWITqoen5y{#c)F3
z0x|c;<8~aUKAxR9egf^lH-51ln!{E+S2W}|Tgq3Q{tUdXaU7@cEao_s=QSKB{p}p5
zF<S>X-dqT_<OIhloHsZ=6OSKroc#U9aq^eONKpKfzcd#Waq_nv#s~4IXqUeA6Q76q
zUp!Yd#50W<?aA5kL^}=~r@2-8aa<MCYaqwz`DG}_sgLbQj?-8usy`_FcQF2gIsL|X
zT@f6oIgMjEPWQhAj#D|D%JCeGhnXCog84a(<J~Yk3pw5&!=K6VR>-qB-T;rOuQ0{K
zD%8*8^r>7N=Q!oJiySw^aNglKwHqop{ubk*lH<cLJhjmtg_Gvatj}>88>h!{e~eFK
zj-SWl_8hN=;pxHg3utE;$0>h!aeOV>@#FYuyv_uUC*t+a=XfVPUd-{0Xy-7;ha<nn
zahhYhjN|k1x_)weH`=L%=PCZv@w)Ulz6--|%JG3{w=c&#pgyG!+3$+}PUZB=Q9q62
zWAS)B$1h<xi#Sg8*CUQYR}m2LoXSv-wZi&G5x1bG1d1q4kyH4oJhT*XXluhW42TKG
z;T(vWh=ad0rlzxqgRUJYGZD|h47`hsvhyN+u#<<^=`7-)&mJ{p;>z(L<nAI4c3NXP
z`XGmRfTW`KYY3+g@c}Z9(-){jGKJHR#S=7_Gufv$?jn&Lh<|FwZszP<#c=NBI6XJY
zy2mj0l#cM+0CJnNPx1Ml<Mx8Oq%LLxvg3=q5yvT>4LMHF)iif9*ny<-MmzmD{T0Y*
zZZ-0EKk_LeeXwJWJYB?Lm)fIyIDQ}X&u|<%Oo7}-PWc@AWP+55^f9Vr{1>NB<wCi(
z?6j;M2>EcWa41pb_+sRmA}%f$O+*~*JVO0u9EZNkAci6?E*Ijte!&jB9|W-!=>u0s
z-buv4&Rwjp#B=%ruZ8*0RiqDgY|+kOj(11y!*Oaa(VTG*|6per>W7H*!Cxw;F(MB7
z)W<T8<I!k`<_04B)ZR_u^yi@dToH%oO7H_@iHJjZsQs`;#6h<Z?PPQOF!C+P;SloG
zZuSE?BGL!@RNl{UoXYz(5eI)SqWzm3Kac#eh=YB3<Zn1meg3~8r*Ix)Zb0f{#Rwd-
z0zKO|6mht&lk5jVbM{gBnuYnt3iT;n9$<K^Ierg$cg}u^U|upz#KAPY69E}5;t-xP
z8I?#TaGah4GdP}t`rA3a9eI(6gTGiUNG^&v_)GQGGmg8VomzE-9g0uH5*-l-J3e@#
z8^@!OJ8?V%c_7E@V0=#DIIUr{mgDf=AEZFU@zyKjS4AAcNzX4|kW;$PMn~egbs--H
zVSbQRoa~tNsa>Z4K*ZxwUpyBt*rE0h&8<v!GO!-2&)NBb;nA*v!@E!rxO_@mIJSpB
zCOoJ2HauS^sLS*ren=kU4(N-y4ge-Rx8t~#pe7l~aX;j793O{#3CHQZ(ov36KBx93
zoQ7~xef5yjr}9W~1<{I8EAyG!J7h-&*`E}5fRkH5Q1^n6exmG1c$X{Yh-L3diHq$t
zM+FEAgrOfEx8(RtJT~F@O+3bK=(1}9J2V#FlGBfe05j<(Y^wCPA-CoDLFBzTeg-*(
zm%@J)xhtoC2e~`P>3zy@j>B5ZAoM<*?7u@!`H1)z<iUcos_T+9mKh7@xC)j#s-MV?
z7IMmW#0`;)-)BNRTOyyv+3$j!(v9rcA*XgI1Y2CbQt&!pBhDvMv=7e3`avQt*8g9P
z*%b}pWeY`fV|4%e<o16)>xCcW1QW9Fcx*xFfC!1Hu<tW^H2W-yHUz{Lc!m#l(SJdo
zD4*~^|G!yOc;LT^Y`JECGR{8#(Jo;48YwaLjR*_#508<UhDXHso3ain?PSYN<8fek
ztSK7>63G^>j>iD_2YCfV`LGYC{~t*cW`|E(Fl_^W)d*&Xsxt;`4;bB+=!6aJa9iGe
zD|Q}k^)<Pt_6eE6W&s__z72s*s#oZQ4em$@;FkQSEqu?Y&b>G4r{b12<UhF|z)rya
zUwNG!ze5Lff5*eWzSRKh%YJZcwP8Q8<Y)^=578s|1_^$U{}eA_j8*5qH<oMacOY2%
z`&$vPAoi=yf0{Fh#s-7`;5YC80>)%Pq!a8Igxan29!Q{n+|zLy+o{g~tj2;yVSQl>
z{zIKb-q7{K`^xJ4-(OpBN6$^d(I5A84DYL|b5HF_McGNx{@49BcB;DYd$$wZSfhIg
zKis4F@SkL?I{&3`u}rAlA{_m3Psc~uPIdk-#T&3ADuVye?&JNx%@}uyG8cnu@SoSc
z&a|uZ|6w)$YgXfbIr&ckllji_5Bg8vVGvh^pN?O$o$CBIHWM_Au^hnlH()>VhVsu3
z#^9RxF|G6<dkWn%6`7EGiU%dOQ=NNSleHEp*5F>7+~axL(3&vD1aM2{Xxj|kb83?J
zkl57-xua8N3_wxgE>rRq-J6plZt407!y3(ClXp*ZBWIB!Zh806POmQgTrC6#<Ugbz
zR0-ss(yuzd!DTTthL~7`aVGGd5Zv(Y;jxRq_b^m7Ipj|8KqTCutPf6g?h`Tm^xct6
z@a}~%tr4-|G5%4}Y*6ce9Mfvv$?|_Xrd4V{zSDiihOO`2Tw-J$Ej6<CtNKNZ`3JFX
zN@M()1{?Yc)1*kkAf(ZffZ$Np{E7093=Q`6iIxZxp-|Jc%CnS9t&8Q}#TwhDoVHE5
zlv3fC^1W&-rDz<Y5jaq9W+QQ&{#t`{U29O5J!d*jFVZ>A-l3&jwoNIvZGAfBa>{#K
zIcEP?Yy-!%?qH7%gZyLnZzPdQBSyoZU8z)<*u_sOl}7moc=`DGv1^qI9kKi*l6L=D
zz^nh#Ufuu39@cs?vl2JF794{qTm>HBuuFlZ_ES!EQ%G(99NeY$Yn$q3j80Rd4H0Uk
zx@lBFRfN)1x29E42cdPUn^hGwAMrv64Etx{=>P}+jv{45I3-F}A*KHR2q%@XaC|VK
z<G2+W3uI$#W&~ci6+KKr^MIGjoFvzv=DRLUQ)uElx=-_rfpx>y=j_h;AUCH%(bzdi
zdDq_dYqIkybYF+QZhJQ~dW5Sq^w@<X?H^bs{JOV8(Oa&sYYTfftpL>qVQMoR4BBja
zwS0u~!W~8fHc8vnUZ|$Mw(!%T&?T1B+HWY$Id*7)eAefX_09F(#Vp(Bz0#+h-r@Pb
z-!HX$cA+eF+q!N2wnc9{yRFT(PQ%LW=3dP4&{yzU^n0LNQLo>jZ<lCo(miSEb9GNv
zal6&8Tb!7&tnW<21-?dS?u?wHzbS6+<jD>9Z|wR#yy*TViFv`txpu3stM6*3_H>+L
zh1GNGl(a^^_2k~Y@wWAtGkB8rA^*1ad5hPUH@ZA%W7z_Yb(_EM*ga-j@#C*XgVS5@
z>%Y12Ep^TOpmB#EhE0lW@p+J4*GHN8&yqS{AHUmk^~hhYQ?6&4rY`&Xpx)YMOV&PE
zytb!cXYSRp`I_UpyzQc=zM_B5)s!`wq4~`Drl~)-WGwIv^GV<9aHhe>e6ON8H_~oe
z{<t|~cmIn<2DXjfq)qxA6qEgV#*n@x`;tdq)&6yP$F)@(Iy}vMc_wXrf0rIwj=weE
zskCx*_(AEo1$XE;ZiUPIfo$x9Mz6ppE$g)%yWG^uLNUYf(yzhuO`ggdubtJbSZ=>k
zZJTM$O;3D!chddL>Q4cIC&##@ZmKky`aGjYa4W;a14<uSG*M9<K5^kD{Xp~2hb@~N
zeljFn*KzbVBa_LiRlIf9eY!B%esb}f%5Oopb=P`J<|fbaSJQOg;?S+u(9N@39hUQO
z8L?6SN{Zpe)9*G{Ms^7v^D;T~#SW7}U1ndtnsIVYcSrf>T|PWBpJ%-E+TO*#k6vlI
z*!oSx&NCiq+Y=(ohcr-He#R?u+10d$9Y5Tv++G~~y8DS=+XrR6K4TrTwP9rHTaOD(
z3LIUVA9)^nB(V14$*!+VC+M^ZHF|jVUAx1T>iZ(vjF;VqWrg*h`1x_Xu(0q<;n763
zo8GG0N*zwRYIg`bX`>ycxA?@IH6J`;rcG^rRMTeuEbAQQag&@w6;+K?`+o3PYN#VW
z%<x+0HaaG{ezR?wH{M~Rc|&7EN*&cX%4eV4oczXjw0EJ;3e`)4bp20iX!|#u)qe1~
z#HQ_|{TfMI2L^6Ux_QC$gwE;a+t2Exgl2TUV^&Xlp1b6GUelZ6U`o7YM}OL(aVt{)
zjJeY|m00)O<*)aGDo?21l#`4ttYy-k>C?D7Z01WOqpJ4k(+sN$<*ML17AKTnEdGg~
zu=9uN9kWqY^uDt(aPH$-uA73I*InjVdClgzL8_mmW1`%q*2kJ_?KQ96#Pv#KBZV_g
zH<O>Xn)Ep-#b$Be=A)kty_kH|XUw#7u3MAZJ9W`&cxtPaZqwMOO)@R)m5Q&cx08F?
zdd`JwJ3{t1IOm=>VcXG+!XtBn->(awI`NIV*8L5IN*g4L&#zfI>Z7J{-iu3DwYE(v
zc8nOGkn10`x|_kRvY`sk!o0tHewSV#XL(Y)L)CStVxx<$D{jRk*Ms3~3{dID=e4!0
zCduhq`Wxr(9oa=?cCS;@8lIWAN#Xg8CA+U4dwVIletJQR^d&Yyo?D8RP7Tvde69QF
z=^Hn_ab5RKx*ghSeBae!<9@DM(9h54N#FhDVFyOf>AQN-<Re4#a~^bk^n7mnwTH8w
zEIQt(uItTw+w{&A3Vp})H{3gSfqsj#8@HBP8(vY|n5X=?VnSkHqZP`Bq7I#pbcvtW
zz4cnXOZG3^0zTcTKkKOf-nQAMy^`jv+;zWS<2(D^pZNRSo%79XaQM=Nlib>#e6nlR
z!@IL{u4FFyy~ND>+^!kLQv<H68FuTr%qXF8Nw<KezLDDDEBBllvc10k+bNFqblWr<
zc0bTRWK?`u$Vu&2R*LDGcg`P{)9QNYWL12L-~B?Ci(9dMUO%<tQq^A32BSBx-jup!
zXo|8l%V=Cuy}k+G7qs2;a&4RR)!j>qJFIO|uc6kG1D*7=!fUNsZSyon&Ns=pV(C3Q
z=`yb~frpYtmINqXPzp%9eXw#sc~gtVc3Uq#%(1*VA^B6sImaE|49lM7@2;=%Zh8Cp
zd*yYTFB`n=M~9S*l@Yf26XJ??1@6+!R-bA6{H<Gx)8L{$f%gVaw7+Az@4KR9`c$?5
z$!I5N>Pp!UZhQZmu};uVhW0kdDENy}({WOhdaEf5?+>hjG3g|1WbJBa+?TyCu~pNU
zUaM9z=!2~wJhu+E!nu`jt|o!}T=Q5aY|wL#s~fWf&zrSGZzpBfg6`!14A8Bz)JCRX
zRb^CNA1KJnW)!PZt=jpYk4;jmax32XGg3-S!C$zFf2HQJNsazhW<*|sljd?~<*RxI
z|2g3x+x<75`yz+uXt4~C9pDEn(TTyxjYSN0g}&wr5`0Bcbyi3p1qsyeV)2z7C{*=r
zp>smMQjpjXz-^dps~~aWc$Dn8j>MJY<B`X49Nw+tW8`0F7S_Pm)WA0}USIb1N-#t3
z6bow5KgzhK=&7`u;7qn2MSXfP!I-Q(!MVR5B7OflW}{`;a23<w=qMjHen+h770HIk
z#LyX2XM5Sm9@$VHZg@`z2|Ftr-qQ*8*gJS<`_AxZVP3=79vayq^PCMfVjczj<$1K=
zyCgD}Jx+>4#T^O37a{;(iOSwJK&ha<^OV0@GX~H3#O(!VGJSZBNZcJcuMc$<2;5f1
z_N4%sfWAKaksYWnKtNw?pYkuSPbCWUp$w57dgudvsfbg_2Yu)_M*393d3^{Qhza`{
zupjBm9)#I3*ny`q;+AY51UTF?h|`!7;1K7;`>=fwUSBBZ0*A1XzNbw4U;SVahd3ww
zu_7)G&twsYT8#8(inv%`9MAC1i1aD{K)i|bNi&fh_#Q&~_zF>$?qdCpsL#i9caa@&
zJPY-v5D)Sq`$I+g;&`TSj1bRa{ZNs<IG$rfT&zD;#KrNPBI08G#Ud__=hY%E)>lRj
z`Bw$^VFT~EL4d<+M9QyFMnHgz>s3k@;&cu_0m$^hCiL3@X(?=ETzogB`w97bOioa=
z66r&D)*!dxIQ5Nk;rL$Er+iNKvrumYr+)~Ky*a)W?SygM3OS`C*)K!AcupS=B}p8=
zgvawZeh-gVaGd7d-puh~7@oZxhco~wl>Prn-<x=Rj^ng02%V?vf-$xrrNX8vpX|Wn
z3XW5Feseqx?NHxDvTuvL5pIc3!DA!b!o~n?!iK^{`cl;Eja%Z&@R-K@5r2f-7q_sf
zBeFk%<CMR}eN3SB>56VBpOPKAuTbAO;GiFe`o*06{>Z6M7@USWh04imk-h=y!sfGx
zL->919Q9EkI~1PAV3Y}Puww`ZOsJ0naIiz+q%k67rwb@Eapde!c^A)>19sA6+JDap
z1x{^{kK^p<AWsx=u(J;Nd=ZCTC*)Zo4%cOld@FKF_X}_#OlW>};#A)ibNc%Pb;(VR
z)0n|~B7dol1t%XlPIX@$sFayNFd#pWG!SvH1NSx%V-W{^YCl<uIOx-Tu8)XA5Gel)
z5pjqg5^oU)JN@uPtcZgh%0EdW4t6O2%oTC4<IR2`G`0|~7wk~}*)7rsJCuKDj34NO
zomln*xh&ELJ2n8BJQQ)TL-~i+sU$npj{hOj2RoF1>MDS>Kjnh*PebICPreCil4cyI
z{A0;+%0IRu`xpe7B~Ot)!~uoho8uHe!5pXhCye90F`VN#J{|c4j!#8SW0@e{Ae?QH
zuRwj^5N{;gMI7`!@We?G2YqNmgWMHyXa|yfK@RZ@*Glae>dQzx105)!W8xQ()4I~c
zi;-(``fribm{rn$jl41H!}Y?hA#xh?!N-FQr{4+n2a32j9z2nQztGM(1O}OSbNmx>
ze~#0AEtumph8^03AmCh_-v-L)ACA#p)jr|%vqbvnm5f~EIMmS~<-$hhuUKCRIb1LN
zNHlPV_g5<7VmnkWK_BV|5*yqBPGJE=?I7MhwR3@s?Hhn2Ccwq^sT=?o+iwoaOyHW}
zTAbm4iMZVhe3py~&wH>-`X$K4?OxEQzRaERJn8E~0GRX;HdS_7Be&<cC2~iO!?%18
z7hzLn#|8Nyj=LkL=R`OZ=c^^C4_q9dS43PKpYmuAHsbh{qCS)rv3+{40$gn0RirPr
zA1dNv`~R!HjsBrNrZN6;F{a{|Ab-EK`KQOD&|QFge-rh8?j?y`4Dhu}4JM=Ub<6+l
zAPGqg?Ip-dRL=kdv621%`-j=D>VyH?118RMaMA|;suA9OE2abauO|1Df60`Tc5n;z
z3)r;exD6gty-ladf7*f`?DN;3#TdvaVN>-Fb&OcLvIDpm*oYz9e}@fMZ{$+8h4M#b
zjoK^zj8*5q46<`{KV-Wy;r;h!v^xJ?;pWK1TlO!JNZA(J!My*;jDi1r{8692mF%2Y
z$UV3L$z;Fk!v7EzsQoBYW`BJ67co{{_;WD)L1;(H^q?*$|0(|VGgh7dkx=0=Sto3&
z{(1lRurt;9ucIkA5&N&o5bysD#$-XH6M{2|4rXZfIrlH&)Fe>PSLc6XeZko~tc0cP
z5V91xr|W;hSatrt1EWl!@0?i3J+aShr#kl<SRl5NB5ry2@E)VO@JBWk9Lz&^QnrOC
zCHEA573O(${uiSE*65x#<erY9Z(?=+)1cWnRFtwUw57>C`Cn7t!msE*U;boaMVqi`
zT!a5{dV-R-u#rgFwjulR{=<7QnN2!@`sVnMdkT+f!>LK2Z)0`We-r(8l^K^vq|87g
z_9ORn{Wk18sPKJ5zoP$OUo7OFaK9Sd8)LpL5Ibi3y!#R4p3^Hu_r@G2e`)K7?m0Dy
zDpVHL2)UzEFjod#DpnVSB^v17yov}r6n?@mMigxF?rqS0A}QjQcMo%%RF{6n%>)PD
z=uXPE@a==#Q~FisH#jLo{~fU&GGGjfB<~)g8CBTcA5q5p7t}9e0sq7TWx6`|voQQL
zwwB!R?#(PLgsz@aL8|(OT1cgqRu&yCI|=_5=H?x(tQhOu!J2KD{P*jfxCW8$bf30i
z?|0flUrgmA!`L~YzhQuSd7<Me30ueEx4Nc{GW+SUpE3Jcv!5gDkg0t9k0Eeo^w%Nl
zJDBo=mZtci9$~NSnA(83REB*W#}o~=uLJvF(inEYt~Km9vK_|}e_LnW2-xZ-Y?%#r
zu*<?~?B|%OAY0kQF{PKG4)jM1HB_dKlY<R49AS}*a>u2PDfZ^ng|e5SvSV5doGW)c
z`drIV9ztR-{c~DFhEwcqgxLt#;v>e6r|e~~n;lb`H-FX?F<~)aEUb;eR>tTh>wgMW
zn&cETY-FWC=C|vs!-9D?|8PH8{w2ykIwCg8*Prz|jrNTSj*JP82!~Z<a7xB5tdp&v
z5M5W|8^I2QF1j5<{iMO+vC;lgBiN0JV2k3gHEN_rp?-BGVg6weQSlPL;OH@uKsKpi
zRsY-=pFlx_d0v+&8v(`aR2>PXWM1JJVPD{aX*_`k!Wr-lxolUU;5|~=u0UCgzzQkX
zEDGHnQ-1#GGs+V419l`8Vo6v$22xWNnUpg9jGa^M&8u(?eNRD0FyNRbdt^r|lnotI
z`&ly`oBzU&&3~|?!|X`^3p>*PV8@Z!as4msxc&z_%FK?&e_==C|6~WxrK)i8Hi8_<
z(qyDXp{*xh+M%y7E0?JQSOJr1Ij8nvy^lLUSzy6B0$V5*RSEiEMc{v%U`+47ib$qc
zZAKa)3LsTu2UJ*qEebz4ZWU@G$JE}+j&gliHP%~$Z8g}|nr*Gw)`o3u*j9&ab=X$Q
zwo<lr{C}8x^LVO)|AG4^l@@D-NG_#>WGR(W_O3#9qO$K<;tJ7XOV^cD)}ka^rBYN<
zqzI)&q=lkQk<v<9<e9m5<~mONzTe;Td;WOl#XV=<^O?_lX3or<nX?Vp(!kaPY)!yc
z7Hnm~RtapC$o(6QX$5ox{mU9?{OfK2FX*OVav&)VS_%+I8KlZVng9VKfB_r?IyGny
zu!V!D00Gm0SsX+I2v`X$<RI`2J~S8@%R#aL0o#Gy9Hayg$i`|Vj2JLC!|XTw*M1fn
zZa)hRx1WWE+s{J7?PsCk_OsA%`&nqX{VX)xet=l^!;Xp29l_HfjcLupS=Nfiv=jiI
zVZ9Y#K>t4sB=8RdIsb=&tpCG6-v41B^ZziA`+t}TJSz`zyN$$FipLtZtmer+L%}u~
zl5yACZgY~}v?D)%wC@Za{MZ(@UN+TA)*>t0H)s0fhXp0Pc}1lrPE0|Au?x;8`kb(c
zyC5e#&D5*h!s<E?W8%WOUeYV~n1(2Ll<+&eih58zPtq_+L^31r?fK%3SDxlA=-ate
z_1&G|o?_MF*0nragx=5nV8@lS$M9?D(mLl-f2E%<-j2P{e`xCN+`MAdr&W&<zi}z+
zzrA$s*zLQQ@7G5ZPf$HsKVIhHxm5us_wE|K%uo6w=hL(z;C0`Y%O46Cv{&x#kR3?a
zuNM?wSeRot_4VpC`^9JyG@~5j9APsNvn6KyOMFjnd6tw=Sk^F3E!ts|kA_n9%rx1v
zKOP;^a(Q(5_jMlkN52)7EfQ756Bz+{$NtFISR}qbQ<ZZ={Y^zqVXv@OXJqJjqr(q$
zs<&O=P$L~UReWaa4|73-nBF~}w0?b!1Nz_RNqcJVls@oQsX&)8u)y+XNr{~N;mgUL
z6$vYyd?tEZy>eV|^t6ZBn{PIv-{tpwRMwqvv0W+e@t7PnvxSY)IV*E^<c!JD%8|-(
zd~ix}^%bcArtLbNj*yJsQ35Fr2d<W7EXzvmruxmitm-A9rk{3EvU>X&ZowvZrdL7Q
ztaH<|+Iv!W9Z&BH6qH?JJVE+&z_0Kwzs+UYvy-JCWl26eSH8DR`F&RXkG=6N9hVjs
zRFrYml`h*HD}ObSaa`j{pMbS)?DW*kEp_1=Wa>U|y1ZupiMNI`RDv=X(oMR;&VmYF
zr(FZ)RlmJD<#c3*fpTBRy!+mpJ)(NI*oet+S!i21O|`#N=J-Whe^Z1HuNJSpiq@`_
ztGULB8RLqit1F~6rdz)JHQjvt{xQe2?5CyFKA_fo9E|z3V}juUns`L-4u=<=n)7Yx
zH_mBU9lQNw+8Ac0S$zJ>WzrRgopQRoKQv6rsk^-Ru|jr*=K0i&Fi|_%m6tL!12?%?
z&42DjS3UHiRbAx!7OAXr+L}9sx#Wr`QJO`#S}b`wJG3=L=8Z{yPaW?ct~>Q9k5iT3
zxUjy2X&Z%S8x2+|CWMxbH#*+>Hosco<#JE=&6Srm^}T0239%E|S)e?}`gQre6J8n1
zR4w;@x7o4x>&(4BzGa0TGd55(FOb_O`*6NxfqAycQA7IYnuCSGHK}F&URFZO#PVbF
zPb!DIo)q)@n`wW1#cJm{{D(x|r@eXQl;bJ8MEHH0+_a-Ih22vnDn+KfZm=u7QNt_o
z^;D12wZ1QsdB?X)yR6gsoqYG_1@Et3P1bu?lznJ)Yp>L^lb!NxLK7`+%I27f=U$p=
z8@2~Ax(=qTOt{|Bv+7O2r42oA>z~x+e1Dhhm@5+UW$C)MQ<CpyK9{<z9OK(7RW^I_
z$5!$5#Ggl)cTVnayt#T&jm$isKTB1`pPfo^%XCkw>8-kZ`wPYXg6NNX@@0G5)MI_~
zFP*vO_Q)<Y;nMc?k3MmAUo=~K%J+!2#OKoo6QAvSWuV!l>=rWS%mT^BFE%fc5$k<k
zt^CE5*ZF1%PqX-OgZO<%-On00XCARWc&|DrZ=>^hxwB@8$?XA^tBxmIPx8JT`CxMD
z)dxrS9;bUhdb?-f@!Q1oOWOs~BJSMHxU+n0pvJep;HcsQKYLzmxF7z`-@{6!ea4~g
z^i^9_R>-Gc+C4aUr}-M?^H<Lhp>;DvpZr~xQM*I!;nZ6b7BnCG(|%KJx3f;Twr_up
zM?}CY@#DGUjRX2>JVGrrHrlqlSbR4>Y<05PHxustcP~tOdR4Ifd5C>s%B+f%UV~4H
zHT8}`+wXN0ZENa?k5=Fg*vIdiVOSs=ANq1($?NYTV>5WidT02`9+d50efmB9h_ZZK
zXl8;_W|r-i-S-_{tP3+gw`uLglXtFP+kUff;eO8tGNu|a6D)Th{W2wWMb1L&zC^i9
z>+ycm>zx)Hke+zF%kJ63?6fl{f3?_T|5{V`yukFpbaTTQkwx<6IfnL@%ePIw<XjqD
z6u0)J#ImVh7k2J<2ZIybk1LIZz4wqGtS4k<XM96*nntQw!KM>0WIxKry`CIyN$WR}
za_Y~%Hdps~^kgN|sY`NC`5U!)PA;jrmaeM$ZgHwp(v2SivX?tgnSEY7k&-{T)=$~w
z%&k``vEfzc%7iO}1m&~Nuif6O**?{`LBID_gX*e7LbnWp*7$vwn!IqM&E^iCJHa3N
zE8nX>2}y}Oyv)mCLH0S}%0y~j<Aap`mEp}PSr-!zj|){^b<SNb@Ia7ALaJHa%E{)z
z%I}O67f)NZGEmxQ#oA)Q2ilh(J@~y_;p8NjO1HO4=bk+{CnnQ&F=zQApC{`Y)k2i?
zS~P8nxi5eH-pJ@;tO~tcK23QQ?Of*0My}J^@d~XyS(Mwa%T=DI%N-6VY;=nE+jvpr
z?MCmF7b=dfb$J#_Rkg8goSYlQ;~d)e%C7uZ1Ff@ayu|Og%s%5V;Y9_CmlDn&?c3%2
z)ALq%z=0`-s~HdWk1uPiNWF01s%KHwpFRb9G5<{p8bKkZQ&gAiSU+=3%ByP4q&pWD
z1@`_J{5thfy`=EIU-fT<eu;dvw>nQaF3-@lGkn}aGMX*U`QFf+q7gVZ&f$gdoZHbY
zLb-z8GWuo8!i$xzThIA9O;}Xr`x4FfHd4tlQ*!Oi^QHXX2~2eDHcCx(|E*Db?~;t}
z#wV`=3jaiAPd5KBi{citOR_RJt>&@Eg3srYDOVl2R%fL-*Yr7?UdicmaZ#l%8naqo
zXMFU`J?a_PDe)`E>1gkMR$u3;+4<M*bey;4hEuO>r$0VfYIXC%$w({92C&zgzgVNC
zWRZuan9=sMl2pEO`o%6;pO@W>wj3}uyVg0y#i4BGB9|RT&i6{?$2P^;8P9CfuimxH
z-B9OK=9FimpN=S~e0#BJW0u-w-%oQsJ~f_uV3ts5qKw4*2j_d$4yc#hqWx`7+MedH
zbD?9x??t&s^E0Zs6w7LrRA-r=7@zf9<<(mYolhCwTWR}FrT2R2YZSkJ-B^10Z|d!e
zX;vp5pRhS=eqxiOiSL56aaI8y)^v~5$MyTv>}MIBxMV02G_iZL=@wo|?hWq0J5N)D
zOK(5<%P5x(IGl8OS$6gD)bMflP9Axg+|;dm)^6O}*~&Y|@V!XJj}B5AV50(V=y)xM
z?^0D$xMohNt4td+z3A8%i3j}?8v3n8O@F#Scyswde}u=M0q*`wqD5mV`(4Mo4~uV(
z6b<S7=I-L);QGRWGRA7Wtiu>-VF{NCZf4G06?=xB(d6{|H*OrO$<AG!k|_Lfid*cL
zy)PBimevd2Q?KN4-{iPk^}e+3<(Gw;OTAakR(rcZe>}yjcM7-|kM*asu0IU<!8<}0
z8h%sZI%B<dnG%vBzcU=1<M-ugX`9aRGL&px%sokaS3g(ju4--R={MFevotMC6J-r{
z@Mx@xD4Ax`s1(?j>Dm*1v7}h_)5pW<1EuRsCfzozT{B<$SJ<uTI<NF1)LwTT&AZqq
z_f0vDGQ&`1novpN@;g?tiE{5llGjUlNV>>-^k#ir7I%?<yF=!3q29%%H9x06c8QV5
zdDVT+Y?oDRZjJxxeP1<7C6czuwsqLluD+#mzprT8(|xk*d_29Dd1lSetuRR0q55*&
zX}9jrcOR&I7pQ0)r?T38$`qYNy06BF`E4m?b|_BxEp=#S;f};*0=fN@jxN}n*`pT!
zeD8|j75mj+(&}WMHL6)&=TF|8T*2S6t0%&ktMgu6&+_f1Zq?CZtxKFvSD0Q1>i$!b
zS3U90OD=zd%BXP;>np7%Yg$*PPS)I)@%VgdgHOW`k7v<sG|ASRISU@INJy$XG<S=+
z+oy}0PVp6b8l*he-I&n6c%R!2yFZ!fl6wY~9+maP+j!4ws6SDC?bX1FyGwhV4_Pga
zPrBOqrpBrLOSOf}Ev8|eNN4C=i>aOK=axt}>=2VKUNfVkd|&<H0!xLBm923-i|=2%
z-W@b(-tjq9*ws?jQL*E^$@t4jWhQ;+Wk265d!{%06!ZQTk*H^i!pwO|yG@R~H9N!8
zVW606aBK0Mo>yL0BK97AinUofJ5pzht7raP_4?2DR<6vi9lrId{S%b+0$7iE;QI6A
zpZeot(dyf(G^Hc|&4dk`tJEC$x7Xd|X$;+(I=8BCj;xyVsr@oK*~M=5tJZ8SoBMRF
zuIfX<P`+ESN3%nwHHD8k{jep)-(q}>j$fE{wn(miSLKVz5%cm57bKYd;3-%6{`0uQ
zS?isN>(qmIa($LJJbHMrze)V8S5$L!)WV3ELb;Is`Bp#YZp`z3vRt>{=lPh-3Hk4L
zw^c^B&Ng}KuO>qK{6|{-#LTO^H?6dIdFE`D`A@Za%{_q?sX<>QuWa%((~n<aak1T#
z`{9#pshu(JA5{NIzfve$;VXGI)VpJ{$JUsvu5B6vH~)yOKR&sw%BV!;7+>qLgD%ha
zWaM8DX(_b+DKx&tZu9Bo*T<bZvU&B%o8nzF*JzhoI^9|BdU>hX`!gc0Q5|FAU8e2y
z3btZ;*h`)Fh%5}*!4N2prB^JA@~K?%=s}0h-rhO8lVViD<h|n0t{V8ICa=PC{-;T>
zhj=XS*Nxu06bv+8<+Vqhlf781AhB`XQ?DZdmgj}O)`d5VI_N#^JvWX2_V-y*{y$U9
zQ!=h4ed*l8e<N$$?0a$2Yx9@IpE*~4c9P^F*~B|a`xmx~$8~Jz(@Pw9-*efrvA4{|
zKDM|=$CByvZC&$|j<H7vzi(@~XQO03f6^S@iY_N*+xkV{)oy*Qw4GJG>7;5*J#UiC
z`cwB^b-y1gul0%%T`TUpA^+9@qwxpdIR5eLYP(i#-%_8Ze`Ac&#&t{LXLRL1whlN`
zYIek3OI@a_@aEQuXP9mi-xThMe<U}keAkM3*y_^ruDd+7J~y_%Q;wTu)zn@5ZT{H^
ziKd9g_>OvK2l+d>ogp_LtbBXZE=FwW*~>4#UUC{E_Jg}Ve0loLpDLk)T|EQOuNXA0
zu~z$0b6)enwSpxf?X*Gh3rFVk&Y8c`P-tEA_FKURG`8%xCAfZiZT%hz)6$&4l<b2#
z8`D}`{5CgwIytu=R^d4s5})th{@QEDJ@3O2(uzwD+!_C8+}3(w_`D;o_gm0S3+xB)
z3YuyeS1V2V5F00BV>MF%F0WS7c5$ogJk$E_FT!IQ16~%1-1qp9uDeyH#`r;whi=#&
z-f23EOT**MW~~!&7EZsr+A3n^X0Hjn-60L{H!1Bc;^rIsUZZ@nvfj&SM<|!Ya(+!|
zt-rkdXp4@o`>XR8#)=d@x0n;Qi)%~9TJ6sHt(mhoUh#Xi^KtUmWA>MtAGQV#2!5?l
zPq;>#tZrjm{q&aWw}97ThoiU8m>GM4Uj6CS!@-ry;+-zr`3pY3wmdeeF7K%6#1oUJ
zH!u9z`^a!WE2&@XcZ<lOz_ouKg>&guzN!7+ylKe3FGB_81-l30yN0;D#!$vo!h1L9
zRu$*F$78mcQO1M_j1iwQfhQ3NPXjXOb}0LKP+dL&U+{7uycdn1UqVAB)^m(Bz@gJ(
z{lNDOcd}k3TnhXykO5Z-f57@|d%5)ZMB~STHQ08;_1U7vt>!b~ie|5>ro|@;B((W>
z^e3~Pf6an%fO`lt07Bxq^!Y@0k2U6_MsbhL8^b4R%qO4=QiAuE?m$7{?!q7T`;1qi
z5zyvN$bf^F3!#JT4{MJ?F-2R*ST_;C7F`Nu$>DGGV<rp2@v{akFfK@IH<vD-XcV-I
z>jIzXT0Q|SR`y}&hz@3F^mi%Iq=6K3^mXCzkr*CfXf-!7|Mx~Cymb%Pf5Q&e5$yi=
z>$#yDaaaM`j{YtsdT`($dHf{l@PM(LT1)2WqS<f^awSY6Z0}gk6S%{JM|$@XN{r<^
zsZEwgHx7qmATLECZ0}g`m6ws+Sk9BDL!t2g>Ch9?L!7MvKk+!kVcmpJLgIRkLlz(o
z?|l-T3d_Swktag1&whr0m-8$*4qk!e@w45Sv)VmKcNGR`tB>Ttt+!!rE#ij5D1OI+
zmtslcR!H8K#5W-BLE=t`ZzXZI94{r3#C?%`0*TWRKTP7=5HBF{U5LYHbck*@%fm~l
zAVRPokN7PTKLGqfth?;&096zY(}VpK*+IP{@tc4X*A>J)Me8W?FIe(C;Fs;##}&Ne
z0KCL^Wh+rQTxVsZbm23qBXRg$@{u_F9@9wNeiZHxxDa7wB-Z%>*c3gAJbdSAB>hKN
zdWJ$+=MJE!n8k<sCET9iyF5aiC)|h59q_xQLWF(^pDW<{8A7b5XxIgY`4}*c5hC<U
ztn&yEf$!`LS;LOQ`ei+a%DL&R=nU^5+k<87oV^Ll|NU=Y5{9n|v*IYT-YiyDWxYJS
zi1o{QxmcO?cCj++^<rh#`^Czv7mQWVE6W^%@G^k*s}0v_YZ=<F)7LlGv#__&(l*qy
z2MZT&1|RHXzfU|A1+A>-7U1ei4s!PM4<$1nSI5Ah09UY*pfgYxO4;n^=wk1<)iuD;
z-PPXR6)fHd@2PwEfo1&AO>Z|p$k~W<ha5px@xh00St9n}v!9O6-k?Ce?cE$bH<Qy2
z1b5~+%L1}ro(3Na^=3b{i{79nW(=-GIQ)pAr3Fb4eA<dE=i}-74{{74BM{M^?q}~6
z0@qgb^bG``A_W^dSU56(Rb6m>oez8q!9RX?7E~{mgIpQ>V~$%q<nUa9`8==>9prG_
zhxtkffrA|0KE`|_gup=#$L*N=LkJv9AO2&W10irw9-ebBKM5glSiT=V;sV@NHfG7g
zu_czDi8z#pV?oTN5r_KWISX@`cj%xzoLFOypPhs9@Htt`X<#2ZC@%*7F<%EEaFC0G
zf6VP61dg08u^fncg4yCMJuoj=&rZb2_9PPI;bU`HK9#_U_T&@v5X+&IAWzhT`ze?&
zqCK?)J;d^PLeK-pEZClQ0w>z@iJ*sQ51#13bcuQ<fPNG@vOWBWlgo!nke3AUus!n#
zoM_Jyf*zthG=e-)&pHApmX9?-53zjkGr7=yD#0E<f*zth_?=jC{eg2c=*W8TyQ<{!
zIXa3xX9;?wfIeJ4mqwAlNsyN&$Ty54kNY38op>Y;IWfPozz-cczxbUPC{L^pnot-x
zvK|vQ{zs1^;!vJg&pim7Xivx}dKd(GVtpXCN1~prQS_W6=ppt4#P&$kb88em#Bzpn
z0(=~Ce+bJ{o51Ce9#{@@2wVwqvOMnRp}Y)19*^hA@@7a6l%GqGw?UjN??#Y^=NfGP
z=27Ig5#(W=!ScICk;mhCXb(&q%O{N@pN%+_hh>H33r3N@NRXE&$X^{r{vJVIfgt~A
z6nP%R;f#G~G&=OI8|1J}EkW0Vu?*xQ;2%5O?l8ymKv?&ngM1qJZ-XA-;IV@aa^kF-
zJ&$B_s52g2GJs<P=%760YhVEax17D<@QbLw&?fO$h#QbNE_d9nvHn9S-AyF<+sN-s
z;^Vm4U<--k^H4O2e?$6l{lV#KA-O{&c?Be&N8(g;TuMmX9Qm)1IMxg2ZP4L#m$JQ-
z2WX3V04lc*5`TyM-6Z}O9hWa89*+D!NIV<K50E%Mui$t4IQAfU{7xh0j>t}YzQ%kB
zlAn&kF}Fv@OPs{rQ8`PK_)8>D{8j|4hu(;*ljI{&y2NitKzaOKa(q7!+Y^QKIFR(<
zafT0xpFwtRBXQiWl1Loa`(q@I?Wrd522`)``4`)X<?**AFh7CfzbEN2M#uFBiDNq_
zp>o1{ZXkJK636K(kvL9QgT!&VxSzoKak}m#dAxq64~gSv^#e)#JIYTeiEAPMP7=R?
zj#mtc<8_^xBwmW-@i!{4{W*xIlH@DV@yaCeqo`gTCvjOMe}cqO@l(!{I3LnO{MH4m
z&veAEkmOgO^0`jp-AEpPUmfQQuSa^9Bp-?L+eG3gke(J2Z$tjKBp!$C`AXurT?~>q
zu5VLN`q)ktRBkg!9G~y;^Eg<(581h#B#*z{p-<xd$dA{}#CqVlAG!@Bc_Cys?zgb~
zZDeNvNj@COZzu7mh^LY`en&im#PRv2fW+}}!s~`(dk!M~RV4YJ>}+w?H^=hq>y{Ks
z7fF5xD$hO=A3(=<EDFbZ@H|9-#P1<{W|8;@#Fvx!BvhWnZ*0K&-+}DF?Et5%ig*l3
z4_=ozm&D_d|0ao-B6}W@cq}TnE)s7+{)xz5Y!BQ*hsO(;&qDfTkUT6#0hT2DN0*=n
z-Yvo7KN^WoL2;}|9M7+8Nn9Dp+ar$Cr6RtKz$XG`i+D7FLp$-f@F;;pc@HFig216X
z4e@FMhw@tyzenIuegooN1P<jR5&uTuP~IPLzVYlGm@g=g$9bXz4&|fSViZ*Zhw_IJ
z*C22xpN6;%fkSybjwP-S3grut{C1K&zJCx);84C2$!8Nd)L(&kA%R2r7R0Lw9LnE9
z{2}7Fz8Ro)`jjBgk7VKIGf5uz8<Qrmg<y1|{8YrD{%PPphAl>sB5+u59TAryaeKsx
z>wrS}0K|#wfI{w%_zIFea)|2@^h0}+5jQ7rs3!_>YZ8w@+=0ZC5O*Q*1Bm+~j?2dc
z@nC{Hv<KId7y^g(<RW?EdY_OVNBjUu{vzTjBwm7e7UI|*+`di_<e@!yesYPxVY;<Q
z&lM8CiFh@MKSjKb#2+Kxh&Z+<1MyaZJhbN?;vEDI?ZNY$E)wrT@?S~(58{0!{tNK|
z0*B|3U}zX{Ts-V8^zyNHS-&$7$L$EW3)NBNR}kc3zTmY0=++Q8%oi_8*O<iNJLu3^
zllUye?MQqk;;x88FSH-G3txgfv}XnQhc2AJp*;(co?Rrq0C5J1Ya+gv#8)Doia7K_
zdvLqRBFIB~)`5TM&JZ}X2i`Y??mUUFL;MPfJ0X6J#PPiD7UI|*+%6gk^3Wb9R;m=r
z3j&As1S0)!NPG+8A4xn0@h>DEh4^p8p%<19ZWr9J69*3Wt3hlpg^$3YJ@~q?5Q!%v
z{o*8EfVd=y=OI3qz+t;kL*p5F#Gx23vITCmN%FW|Y#2q}brg=*d4>6f`MQkki6ZES
z9ACeVC-K`zK9R)X{aok{k<x|dPUw!0!pli|;Qe3du9Nsv#BY;0{>I}y636rNCy2x7
zuso^YAG(*LaN>HjupIDsdyu66H?oHZ79?=EJo(T#6MusMbG()TUSAg5qr{F*kwkjP
zd>Ki<B+{=z;u47KlejYCYe;+{;&>f2oUSIaXCsm)^B|HQ9i%6e#PRikND{X|^1DeK
ze*<$bfx~v8h2|HjB#!I<ITH6r@>fV4%Quj?7s_u7iDUUsBrb^LzatLI2hRy$(A3Fn
z0T>MH55E2)LgLP-93%)F=2rySFO4|Vk9NTxC=Y@>)E|xX=#lsi#EnPMV@;5U{V>jh
zD}h7(`ACl^iR0@m0VIyEgKQ=7Ye-KR;y7RUe4Rw#u&Lp4K1SlYAPl-90*AX;59>W<
z;3w;ELh|^y;OhX7N&GRg^96~&NBj+mcOu?}I8N6B8VMX1Dp<&g`Qj&Wb(S=^H%H)5
zCDt=<6t0Ch&KDP|KYApNA4xPOar_NcGZGg>daM!0`3gsN`V%-YU)xDs70JgFILsH;
zlROGPi#X1gJhG>l#OEV^mBcj=uOxANed;FSIA1x)&Nc!k=Bt~;S0VXd1P=3s^^8R)
zZ)iVkUo(+BFM-4MWsU3<Byn@ZXCjX452|LAxdaZ`U8H{%ffMaFByp_A261R7?0;~&
z8wv6-3_ChW-U}KA+ztYV`Pzo;k0fz?oo*kA=OOunB%XzM8i7MQt5CYx1P;@^i{$f2
z{3haO5r@%XzVLmu(ouLLNl!1*^N7U1A>K~n+-O|)n#8#f|3KpS+qs`fd@7RvN#Y9-
zA0Tmg#K)t_6*<5Bqwx8N!?J<pxdQ1~K;r6%tC6@7;_4*67V%YxV|$!I8qnDgII-Tk
zk~prn{sazfjbdp5-_9m*s7D_0LnMy%oFH(bp7W#dJBZ`*aYgxRAaQ5JpOQGfe)^om
z1Cab%5|2UrJ&EJ{Xx~UY6UqM|@xzGYi%Pisak))I7n{g@HsUzHg-Fjl5<iK!5{Z{1
zzKF!HAifN7obD-fyvzukSRd?3TouWC5jeE99`RTLC)S4~632Ru6F5;%;V8TYaa=yl
zC|`JeTg;mfZz9RRLHsd^ze4;4iT5J@hQz-i{*lCa(RJG|Bt9AOUx?%K$K^H_P29*_
z0&$$LnMjWmiQ{iU%aQm3B(F%~@`$S<j??{yj-w%g6YIlz6362x7XoM53KaquLEyyt
zkU-*CPbPsA_2iAhD-p-#qlfZUP2xI;-z9Mi#2=8j8R9J@?uK|9iMt^Fj>LB$-c91+
zh<`^Mmp^<i9lC*0xCk1k<NWSLdc;Yb{e>~`tQ3jk`x&w%o{97<Kpfk%9ND8!;Kcf1
zPU3i+wu!)@t#(LH7=aV(!yXdHdQu6Ts3&U_UWPa>pGzoT6(oKE@mdnELA;*C@qL|#
zB>ou5KOymE#9xy5C&W8Q{3GH$h~x6d<@RF~E{JZN;r#wZdZv^3AH-*oI6t~CB2D7F
zh|fbD+k>y~X%aZGJ{Xa>E~_?!@dklITaTmq5Jcd_`VdLtSkGPphkE8B{U-?=U3z4N
zln^+S$K%gt0*C2h*G}M2{tB`azd8ZEP~H$lm;?uHz~S=2?{my2a42udk^=V?5r?|r
zxOzU)zmml9INyxKdC~lLBZ=ejxhIJ?p>)GZ9P8Ob;v(q0wij_|9;yl~O@#z`xVr!a
z7Lm9N;ui=U=2sZi!)pW%ckPgT6^WZ8UPs_i&sbCr4-toUA_Vp*l;<RQZj|l^635q_
zei8J*B;{FJ!1qewWD+=B4%%!lMV`bR5jP<50>rIIyb^I2#BqJNgv#HKAdgIE#YiB?
zLzD4+)&nFSfy(U&iRU7oP2$H9&qo~Q7p9A*+ms6gd074i$j&l?JVGFpLU~G%hjv~>
z`k#~ddBk6l^dL;>C&<He??A(V8;c(9gkCfiWN|6PVR^!I?;}MrBz_lhIg%bUJfo~4
z$isB&Q6f5{a2konvaA991c}$9LNX<BXfJe@B+i5Ki>fE99-^TEOCFD#pcs)mu|nDP
z7Uv0~z)^TKiOV5>@+dry#7&U@(kQ%+#J3`U%P9N<iR1f6_<2s4Uzjh<`A|8*4VsFv
zG)RuZl}H@tS8Eh*M&dZX&ZBTTiR1k49)+ioIL;S-4iN^!d|_TjkVlsySoy6Vg+C*4
zTvtAh!vB&um8Bh&IqGC#FiaP7Dv2v0d6iMPE{SU*dCO6_2Z7^02}Z%sJwkgXBOP#4
zK#(W$8>4Xid?3^V&)2$832^v1K&)SZjVawEJ(%|qIMjpN=UCK#U_BN{&$LmvB!NRc
zsz@F`uZ{JDBfgR#5A%z;0f9q3cwB8m;7~pX=?Non+$X`H{89M5Q8<2%4%!Lz;BnVD
z)c=vW@F-l0z@h#4SSk`YQNPA0+;|kep1_Iv-3T1&j{^VD1&zXYkHYs8IPo|hA#kF8
z;#yTiUNMUNEdnR%$ItcQa;|5aPw61YL;aZdjl##E!3Wd>_2c@?N8m&~5~Fa%QTQ?f
zC+gQHaHt>8i!Ddt?xXMk0*Cr>{ohI8MEwb)@T^hzDFP?zFC}oOAJ601-|rrpFJMmm
zE)r4xH9-&5uM7U6`%K_O`N2^*USk5+2b``r8VBLyi}foKIND{UyI~Z*hrp2uEcrYV
z$9?xD0!LMkCEq~cuxr6%7lc`T37QJC<neh7+K;*-7N@d)+2u^skIzd`o@l2gK^~_C
zkqLpra>mX9?La-aPlCvwz;Rw7+C|{R^K~MD6UQxC1dhu9q9OtpK>Kimb&~CY?+ikR
zc@EplS#uF`V!9eA9CK;pHz9Ev@;j5bFY@E@4%U-|_-=wcF<&Vpj?+Cs;yB%_B#zU)
zPvSV;b^<5XlP&@$){}1pPOK-y@h7pK;Bh+4FR`BBehYG9J;BerK~AhEvJe0VH~5%B
zKVBmZ@?pn|AWtk$8i5n*2`*P?BYe-!2>e4gm%U-x4mkt)<w*P)@+*=!et$`Y#KVyt
zD@YtaKd(jNl}KKn#2+BOmc;RMO1OUFe7!{SmL&O3#BE9Z3*z=9j@PbrA@K=loaag6
zczlfOBen;xX^ZDym`fo&AtXJE5Z_MXdWc7oIDXCt&pWYx{9ZsjN!|_VA+|eWyCBZj
zi0$G9(gTZ&*e>vMk&qMH1wNjTLz}R}?-@Z(Y!?E^2*`=;VgZ2@+r=FMC$@_N$Y`jC
z*e-04(U23{1r_+AgT+ED2mJmb<iv6?gu=i<PAmrx7G-l{Iph#Hu^bu*oLCMY2%K0B
ztd0SM!E}k`Fb!r1ILL|Rfcq23iRG|@AWtlZ|J~Yy!xtMI`jCiofU6_jl|o(>a7X}s
zLS=LT)`wI^4<>(8MUlK(Az|@C@S&K1(F|pMA7%7l_7_tK>nRT9z<IN)V*q8uAoy{V
z5d+{SQbrB{A4(bBilJ|&uw__Qfv={x`B4<v`;Jad0j^t-3N`{?o7wCcNDmwa9RnPF
z-NBkKL_Gn%?*9sckHmn($JP``2l+%w0R~^30e)vcA0Jm=Iz`dfkM61nzSy^b^&uMM
zclQla^bhd!2VZvyMTxn3*t-Qd`nbYM`u~9w2RdLCCbluCRule=;81nvgh+us$cSwn
z25Q2e5ga-GJRrjZ{zr>X>?@!;vR@f6sB<*?@q8b~g>G0I1%3ta4|QsSf1>k{X8S}D
zlmlBR2W^E8b2G3%Qu@1~5O8F>$mzpz!$|4x8X<kCi<~|@4~~?6BH++zu{WGwa{BQ6
zI#T*+Bcu=0CZ~S@u#wV#0XTG(tlyy@a{7Bg&`9YQq4Wz-R9OD7zbB^;uam;`@puXB
zvRoE~z|CiGIKMbP3Z~S6kdflwLIMvtG1)sf9^S(1u5h1xoU^#t^7uX$+xKt%YX$)$
z<=<vDJ4PaE7%>0ve1z@C^$)(EIa2z&pi<!OvNxPxa`}G;AtR;VIhP&917#GZ595;4
zhv&<Y(l<dTbK<!eY9yx*-zOO<z5|MH3L_C5IX)bpj}*TW#lJ>~3wO!!;dco}ioXjT
z(Ek)4ey3-o_?qbbAy_|%j+{RHKEO!jZz9W%^#Upf4wk<#_$QY?y#LD*!2wVhI4bhv
z`|xZ!6d(JKjFP?*Ob|E|dG;21VV%Rt;Q9yWA0wsTi3U}<tU$I7_>1FXa$}VEiD-~j
z^dI8GwbVx{zg>93GLfAUv>%@9aQfK($D^dLi7t+;#fG9Sj*oHUXz8O5lTeZUFnxFp
z0msMbcaM^OB1#|j&qRmgWA=8G^s~?eOcwP+FnvkzkK^O?DIlC>A`ZZch1feQP<)KZ
zV!ua8zs`{z1FtCy)0YDOI6h7vzFz{<C$HtHIgK5^ca-#D9Oy(wiN6$1zJdG2-f(_#
z`Z)eP9G@e>-cdmY%91#ahqv&17kHm2YKt>SgkYa6s|n)6t^#a^IR_M9X&4<UKa6cq
z`sDbDD82(JL7aaa-yB37sr|fgVN39!`0)6_vcU0i_FynMZ5Z?O4EPJ)=SKY~>_!%V
ze{y`-Jjr7}fGA6;@E45FNXkjsVZCoLQv6OdKz8~M@mb$vq&o(BEBY;@0{5TR@>Et*
zQ&M3q=K0^R<>?VNWVI$MSDF+iC62;g%M7ew#$IkOrgFz}MpgF=H-5=zmK2Rq1D3!<
zfvxmegY_J5pQeBSy`9FW#i2p3;HqMF8>>J}y?_9}0Cg(-j-@MHgObYn`X-o2QrRED
zq`LV9P+57N#7akt<)Jz|`hrOaHPF*1Xfxf>*VQj5aC0aXOh2}Iy0}thWdi3@9erKE
z%9vY%JOf;*j?~SbP63Vqp{yXNDA+N;7p$GB&Q>SmLiKPAq=F?cU8!^rM_;O+uPay^
z(?5t#bpwV`eZeHgg(?Hq&-^dq`32EOh{&=YeB&e_$k*AC4wvl=cBF%EqPkFt@-PXO
zlL=G@25fcQ><M$>114N7BY+L+oXpc51L)LXPr3)lU*KlPKo3Rm-7^p#<Qo{|@9!5t
zCn=|g`lFi0mUH&=rMrgE?O9nwCF%sy3EB+T0aXXZ;p<8F3$PFLb@UJP@EchW<qI80
zU$E*Zip9<rTX`@j+(3U<XHPdzR~KL<_(lSpRl?(H&%P|64i28{RxrB+Hp64;>A%@^
z0sPu3)z1wdBN&hF>Emi2>=)qe8W3pj8sh34M0W*S567TDxa=t<j8#nPRB4$&X$2}P
zhrV>Sce?_W;^OM&2(*LjX~=+OP~qQDIm3)o9Ru8h;4D{>0%q=>&_as6J<D2G->vqn
z7z>>|eHVh`2&Uuq08#;TcBcFJZ4O+3GSA9MprThGu!wE3hpVrBV33oKCmrOFz+6C0
zBY5Ey+mjAI@ESn>7sC&`4yg-pr3ZMrf+~U-sZc<Lz$!=~poxtf1-3%))mn;EDBU&C
zKET!4)pIMbmhA<XP3UNs4lXGKy151ffIxIr#sw@gyCujq5atdyVHb*lv4MqwmLbJV
zPfK?_#mv&!*uZ!-#aatc<JI<NdKP8|dRDA()}Ed&MR%RC9>vmlt?@c*V+yN&c)CzP
zaeymJVC7i~XgaR$aA8_lP@siVd|h2#0_{=jrl1aB2!P8d0k9>ozN?ECzlDp)4qM;W
zISAwgd|Ve6Ek(wKBBQ9{4pe#i1$cr>8DW#0eO#y-tQs|m!s-+Pffvm1*fpHxAyzvo
ztZ1NKcn0|S!kPqyT|h77Os9a(%p2BX@XSvI>}SCOk=Nj;(HyP~$?hI$j4E18C4V%$
z=uV6INayABqhMWOuoNomW(^kA5#{XBID00XJsbAkSAGH345L;@6MmK!=y9NxQh|Q9
zFRB6T*6M__e6>;V>LJ`69+$?5+5-co16c}I2;eRbq}4|48PXX7IF0>4a&1%r@PI$c
zAXpL_E+_c}^!+HX44!P+Wx>uGjfo1Py9tDFoH=XtXvS}T!B}{j2OClL20qjSd~obQ
ztButJ8|c8U|Ilt0i?L`O-eq3v1iPrHm{<CN2jl=U=)mp^)($9{s3&NTBm9{y0pmc&
z;fX9GqF^v|wXBk*f;}Wr8wDkx`)4g`xYjLOij`636<DyfIv!A%Uoff&Y+wM`rNMxx
zY8U_<Fw_R=<d^}=p6$U0YPfIsVPjrlnazkAidM@SrO=pRG@u@v4EESbve%~op(b`+
zhyXhn{j``tI#@}TRYL}2;V~c7=7#5Z=vZs{MtuO`J9*fG3_53VZ6?^IF@B&7z-k^<
zEik-@;Nq}Y7t{yFBfUr`SX6cAQmB&;DX7(13PoV+0gK9-E74*a=|W)fZq#@<Yd7QZ
z3TO~ZhejkYDu@hL#3iQ32-YNeK}FuVltLfN2-am|mMtKidE`WxVK#PPaKv6W)lHEz
zUSijFjxEE)K>A>X<Cs1gKkYLkI0U8ueYKUWCdz{0!>ob!#_j<n4#YyH!HV*g#xGa%
z6)uF%UP~O;1UC8~<dy!FhXs%H1NGBc>XCL)AiWEi$LSKFe$mn8sUyi#fjsGWf@4NJ
zo=PwYbUXvWvF?M%^F6t!3C9zzm#f@|E7XX)?1gQW`-ZP+3loBFs62P90A<IzLO>{2
zo9kcsH?TU@ul$>?gThv5z@ax_5jfy{(wMBMGzQIK*b)0b>bJrAiO1E3ki!2_zdzPL
zWWPT_J3JUe_0jk<jd5ugC^UiuJVs%}gZh<UVJkXY!Qu*%1xE;VOVA4s81e!iT%MQ^
z=+E)en8h$5j-RE<fqhnK$48Q1Qj=&3kRR6n2>i$XN8sQ7htPkCjvOBp$X-^Bpz-U0
zxe%J|fWAfaUu~@Nql>eYa{4`Hn8Q#{K`2U={aO~veQ*w@JZO$;HFG=7fKko%xFynn
z7X`2e5OgaVGmyuS@eWI`1>J5X><?KsGA${1#e3#b+zEA;5&9>_Z5rbqCw})))Xo9n
zv@7OzG}Pdi1nmWT*aH~)CK_{W)Y36@VH(o}^!fx_x|>+?{$SyFY+Xzxkft}&m^1;R
zW$fZ47?{qPZxZYPYstUcNM1i4mKAGM1x^keD|KPJCfTXawlnB$pN;?*{ROlZE_%Nh
zmO5b#ch*@Ah${Edm>~k}LhU|JC@;>8mUXzm`Qd}80sEY20ZwhOIT+HSb_h`DdNjr(
zct+CLrM{5v!KgE2=+5C`+*ZC7^<s?H#9djOleZxg1b|bA0W$<0+ENe(hftzbiO@#2
zP1sa!R>EV@nID8hIZk=e7!QV`T*I=%mL6BG?5<}U&q{@3zYDT|1KWO3vMl?Jfc^Z@
z89<gfA*!E??i1BNj_$$9P3>wPsEl1wgsh;0F_aZxA~-HX#{GBs`Oos*_h3Kp-{t!_
zMa#l~@ld%DRvVCA<vv(<1Q>>Mrm!=>1bc>zS70m-t2a2Ev&){*&bWzo!H9*?X$R^d
zyXF4>UZ15N<0drnj`A&(X`1s_bLGaNnTRf<>px|ghn;1uja6EfT8z8Ow}xjMRWHKq
z=6|IV)*tM&EG*4oBMN36pl_U0KaGjcDwnB1md0oU#|ZR`G{y~dV3?Mm8+;4v%dn}_
zumd^N6XElY9jk)E!};IUPdnvG&asC!v&VaIkL~`G9~L{z-#i*4SXTKKYTWEB;I_h3
zHPqky=lT!YKhMxvgb}=X$OB9QgOt_8GdiojLj%;nL<IDi)R9keoRbwphl<StBXu`c
ze}wu>+_|ug2fa!wNDtHxcm!Fw9ORGI0GB%138C2@I72AavWkkvxXIMvX6SK4YbFlO
zewpln-w<I2>c;f($Gn2WUS=RTtCPgRd74B(rbt9~I5A{8(+rtDG){f!o{7$ToD;es
z>;h2x=ZJw*YtVBL*#ty3;m~f$q2u-6#kT?RZT=7O9YB1C|F`j(I-1PD&7i;;dYVif
z4~Cux`v`&|rVbc^p^LjT=fDu6Cw$0*$7WbE>I$5aQ0TL1%yPJg8zc*JMiGn{7{-js
z0l#2`GM*6w_h9X%ae5apzQO5t3H%)#1bz^%{1J?oIzh7o{SU0JYoq>72&OV)8$hB_
z{Z#tosQw9C$Agh9IKM>w9YdcQ^_PpT$hZW<8K2p_mL&}mq_C<pfYD$do{xy(@WMRn
z>$#jZ1k&S=UIGng&2;g!w{B3IhruG?8qPiu5Y8V1KYPp?>4B*)E`l&LgaET>d<lmc
zro;(d%GslG_GmOFtAPyx&YlT52%Thsb{ldKx+a7$kZ|Cr;p|-*c4_1@$UK%|T_@pq
zh8<LR!GaSKLiE5Z2q=WnZpZEkLFw)SdMQj1bdmra8oGZChA=WPXqW@@aYAnfTl{JP
z&cOhZzz?UL9LJnM^uh30m?;iq#=@s1I9_lVVXYYQ19_Nl4gh|5xrgJ2=S*-=!HJ07
z>oMAgPMq-aodU@7P#8P+kaLg1;WsZwl84VcjKu$p!bj6Tntb&rdRUhqIe8nhAC}Tc
z_Kd8j6i8Eo#AwVIe~`a!K|+7XjNyS<2F(~;421KS7z)WR3Zt~){+AgeKnkbA@QR^u
z6X-uP<ky7$BSU@~^d}7YZGgWk3|vwHX*<AuKlZ){+;;~1(0J_r=i^N``L|5y3jZ>8
zc}xHa!Ulpe&+4B5f~|>I9=nG8p#K^i7aWL21&l$OGj|znOvB)dq47O??#b!D&|LKY
z?8ka=IgGX)x}OsWR<|2=$A}eWC>%c7$i8s{?$_9(dr*Y?K`@+sWu2JT@c68&@WfyW
z^I9VC4|N<`)>>9@F#1P%5FEN*JZW|wn)kwSJes64%UO}xV|q@dCk`RO=%Nu^+~kDe
zj?NMcGDZ#nm+EoPz!3&lwMG^Om$XI<h)DyPV%-ja&(wptsph|0*)p8O-~<*Y$gX9a
zAb7FFgmbzXDUkX<#gzS@0y*cdWD2yDlO~Rn%xb;=V%W&Z(kKo`m~$Y&NJP&cUyb|9
zzrGG!RQl{);{rAhmffK1pdo%K(8)RB+=LejLGR4ghE(Ih1nX7=7(Z;%vPa{5&cp&s
z-h^F@CK#;taK=^aeFI#3@Fh5dp<!VkYX*X9mm%XXC+b%Neg%s;qGW^Em^w0sSIS7{
zx3eQC4a1y7y0(HL(y-P6uCJQYB0kUrzyjAarh<$ttX7P|IZFXxO{ma?7&xmywe}qi
zOq@_5L~W;myKgkcI~0m97!6%?>Yl^tSBF{&P_af7)JL9w<>7$&;ZRzfbWA98+Y!@2
zBbsgrPC6z-E$kg30X*~p3AB!ofDMIiGhza0T+}Vjp6`J=Hx!$o9uJ>@`e#D|Z2Q5r
zA<h*oTsdG`oNENkXjX~4(B!#UhaiZT7Euik3TvcW#n!?;aOP$3VH7w;B34{5KAsC|
zLm4*=BL>+0crv3hs*a1(-?Q2P;T8&<=ZLd!T1*>u*^!~63+Hc~fekD9&#a-?u4qLq
zwl$wuvA65tIhEyJS+Td+ACgg?F*)4g=H<%!Pp2NZ+cP(8Yw^=L(a}aBG2Aq5>Kp-W
zZ5q#;iO~XbV%Z*{Q$y?Ra!+5-J0}v+@@$QrZGp+nM<;ttyKeS1PKbQ8$>+pFuX9hF
za#wlgT8EXt3(Hs**f+-eL;3IDTekjHZ4du;_s)|0#V<GHXHPM)$ae}Cd-2lLDg1oK
z#LtU094ikbdmG$QR#Cd!A8=P`*4~XZWB<x*Jx<pa3csA9Wn&cW-zF`e(IHBm)HJEF
zM}I&xS?}VT=dor6DHiMXQ+d|a?HC_ub8F%|)g#JPV|!-F>P`q(?)DXIOZJKRF(vx*
zlzi{~Gm@XY*?E7;ym5bO?-Ui!Ib~v*6d|x<@y}25B=m1eW&GJ;Hvb~mjo4c!rQXcx
zpBHKTc@<AOx1?0GnZUH^Cw9?f<fH-wECoDu7weAQBgPP7v@j0rDcf_P*&#Adb~59c
z7xih@P2Kr&E$wUH%(h*dl$V#WxMGQrYr)^0ODci|Tu-)bdi|SE`uH_7-ppX3j)Jxg
zQ9aUPXSNM`gnybVXLWFuO2v<<$pR8oIT>}sMJb)4rs?n19m7`{EIRUGh4CV-AU@^W
zVVlw!{mB*|a__u3t9AOs&1(q@DnIjXru5|M6c|`<aG$bOOY&Wms^+-e5vnuxH#`+x
z@1~zOe|qOMe%FY(TW!BjwT>Dr=}0~!9{(oKK`12qN@vmdswoouv*cEKPVwkBtb9ia
zpZiL6;?bN{>1+H`y`PJvzCH8V$NY)><Yx!Xrk2L_$OWf<Uh~5xzazQlebOQBCi&;)
z0(J7w7eDPCAD#3zS3Ef}EVEeO!|u~E1>5`OV=U*noHc(IJZFWI&0C8NCPm$)H7U{0
zdhG>5#a-6sIfrgGn4MCaa_6&7is8-0s#*{8dovmu^=;3mJ`X?q%J;`wTeqLNzwYQK
zZ#cT_Z=j9jW8c@z-&x;k#vCo=|J-#W|L``6qx1U>Z{~{}RbRQi|9ha{g66hG-l<)i
z_<UBUoN2hOusiu-1^1~p<GXXunA@s67nfL8Gfka4+fQdg&5ODBoy8_BxiabQlLd;M
zJEr(vh-_`lx~^QR@iAk@Gr<j>HjUf9y>E{D-De?d?AfI8Gr{(F$p`Vr&$B~zzqpg_
zvhZ4H?yDJbQH>|2#9p0V=AN}fm&a|n!RNQh%xU+j0a~|{4^FxK{ljz(@#*Unxq{N&
z{iPqu=qf3Ud2gesv|{2S>xQM_H9Qxqmj0<*yP$i<v4|KCeVWmX&hYA6chgns_PPnY
zDLuVE@j&;*x9^fn0*)!omf?@ML%X$_s%o~Inj|nqXWVq|s^>~V-aPu$MMBf4B~zzm
zM=EYkPLhs}Nm3DWRMt|~UZ^$khJNHZp5;8Z1$v}K_Z1z^n(4SoYut@7k!zx>xTgvx
z2wF(3Fi@KDa;eth8wQbL(W=}Rc+Ltvl)7rH#QTy<D{8_EAuZ<@%E!abc<`tSOiM0c
z2%F@&1x(9J`7SAXApPWlU==|(*AUG%)5Q0`j`3vD4^?R_E|6*69d<`+oo~{i<K=T6
zh8%o)Y->T=r)BP8PhzjOuPYG_|MZ$?kxltJ>BQjBox5I0g-nXraQC-@_O2JPJa2;A
z-U*BsoS9k^`C~PY&O~Es;_7WjSBvWT3q?F@`fVP)g?p6_)xP)d%wusc#&HL1_~aSw
z$?Yys$1Gncy=dwmp@<DFzg4s+T=z2@DEdNO%GCV(aXW9spVlxw@bg=p>*u8(yxd>?
zK83;`JDxY~ZIj{8CBeFD<s$Is6E$&XSi2r|u&?4>q^ZH*j|1W`()L@|$|W5-fPkd*
zpOhCzdER_z+b8gM*KfhI+0q-SW(-9kPu<i#LY4~sYsQ-#nB=IZ=P$i<;sHTA*Anfy
z5fh|z6C+JD6XQ&@vu0Ze^b2_L{NdTl?aA|zyNhQdw^nov_Y5B9L>0kp6UR$$wwP{h
zb$%I7`SHFGC%$Xko<6zLRip2Vi6yp8@;S0v_R#m&PvREcGdV6%r1Eg!ma~ZKG5wEv
zYYRN-w`-pY6~!%UX<sn?+cj}JJr`cp+-<@yin)(Yw+IYZdsQrPbYuU9J@;?+e{h}c
z+bm}uE!f?*w|G{@&siU1t=|6LonMpgbF?oa`D4WT6Ax~?JUHv+Y;I(#(Vb9`9q_K}
za!aq(?uJ0?TLPYGE48moP~opk-}>fg{AYzd?Xv)~{T(W|uBX<b{0TU#e7n3-?dhRs
zz2_GdrOyrCKJ$~qqrPz42er#jpN`tpQ<AWC+c>VfE!$kP)bC~#^ctjT2NrMYD7nb@
z%O!vD*zRVX>-0kry<(px<}VxDeSv3D*L!n8k0Z_90`N!G@xk#>E5FZC!3*c5Df-BL
z*UyOcXl!<;Zk9@81Pa})+%}a9{Mb=`MY}naYy8$M14@cjD$;%LRsPysIP-4hubCD`
zszq%PpGB{4;69YlYaH#)^H!?iSz)l$igiko5p%r;%z3U+OSNLPXvG)X_Re28RUs+Q
zzkEWsPVvPZv&GifO&gfY-ICqO6!2hXFT5EPbxHP@%AB_BPWi+TX7*X#+b-|*CMloR
zmvgX<wYX6->qMmIY%|^_AKG5S!-*~FYE54CCCz#V7d=oDx!b7Qx^a=w)aMC@&+Ih}
zrharNo7$zAmr1*lzH;rAHF;Nx9Ql>DkLjW|DdtqwxPAO|BK*zz50kI^SB~%N80S#q
zSjS(fYc%%mk~vE99zEINI!%uE@;4^=r7e0NUX^S5PCP<fPb{b+@{Mlu%%F<>w|EaN
zdmkRtSnzH7xJp;ghd=eD8Z^J{P1(AnLb>zpqK5FBY1(7&T1OVqw)FOgs@$UYt7cLY
zxc)|T9obNv@OS2?Q&D%ke(G2p{9x%lZRZgS!JQS0w)e+UP4xcg<aSl9GCaBG8YM#R
z)k5v8xc=HXu43a$ocHxJzhu-MdA(5Uy@TA%4Iftj-I7+b<BjCLl0BZ<C*N59HCR9H
z@{Ln}EZ65Noc+4))>7Bd<ZE+hCn{XMZQnh?381wLE?m96O5()66N2^5lHcxYs^3{O
zRc4>^V#k()h6|ReB&c4H&UEq8QLlQK@LjG+A?I<r+w6@Fhoa~VhFhV$;UeYjbtSv*
z^XNYQCKb^+ex-~+&^P6Xg4p{Lb(b8PFwQzt*>{5zHMFtuUb=CLu)m~*;k>nLS7${e
z3G4cs9XVN2XsTtt+2Qjs`u=(15xZ?#sN4ZHB{R9z={X(JNewrxZ8!1RXv$w$C_cXM
zs#%jtcYU*5WS)t`9f|8t!sgr-kZn4{|J6jjhrdL9=dwL}r!*Y6p;YUcS<EG2+?_E!
zP5!Pxgt4c?xVOt*{-s9qig#w4=1sl3Zo=vX4rP3`o)eoQHI*j#s_iM5?VYyGqd@tA
zZR0&%rh!P4bjcQ}CMU_IgHCxePo<7WZ_3N{OuV??GoAlYuY_U!{vIdWh?2veGLIZr
zHOb|SHS|v8Q$4MxUQ@!?WsuiPt4&v<X1cVb@ug%swnTcKRq@f=mg#9H{IHX&DYJC!
z<?0gEv0G21rhAOJeB*nln6_bXlfYNO2d@rPmMoV@cx{~bJCUCE+jF8@%i6U{O)G69
z)BBo)?tJgCuvsjZHcRuQ<1e{Q-xsN9bk1~pcs8?(VkXk`I8j(-yTs{DcfOxi5ap^*
z=X=>!l-i}#vwVq)hVEpQCPCZ8^n}L9JKuRyijH=Pnn^YtFIl0gp<nAXx2$?;jqWAU
zeaaeIwJvkZ%9h^yzR0I0t@G=vIa8l+`V+}Gv+$nMgMpj%hJ#wmRpyr6>t8VSx%<_7
z-<{R1RR^N)H5(2Zyz`n{_N%m7H&`+?z4PnqNmHNi2(P2Z{kgMFH&tq)Azl2HOSZTG
zf79AUmZ}e8XuBA`x+>{^nZ7}3JB%Ky8(upWCXrW6KUei#?D=AqOr4Vsza;MJ8eYq{
z6VF@H*|NLKs6|O7v$jMr?^2?$(#EV-THd8D^#fh^WuMm51w9uuE&u61=~>-(5%o1n
z50dNo^48MR9Dd2K>2WKIFNy8)d-K@vQ_}!n)AX`RmtVVlL(*2xY480eF-w73ER~b*
zXO*dx{JMPYFX8F#p?Rn2^Ip$s(SKvQ;ViGpC$8eX8D}<p8?cuZwMnUBnkq@uD(jeR
z1BZha%jCC>k4%?MF_`o{K51e4Bo(uBrlMDQuDS)g_O~lnf38d4KbJX9rII2yZ?;6l
zqs#GBu8%WRRRlZ^r|oAn)ODY0=MQVLkw3SpK<ie>Q@-UZ!n=C+zv4PoEcAK0l7;Q9
ztB<2v>o)9oy_P@RXZ+n$A#Ts77<@L_;P1Wf@`^BX%^p=Zvsdm)1JNg%i~0D!v<r1n
zH6j-$Y}fY4Xu9GRCA3X*TyV%lC#hZhxk9rHqRcAAmF#aHs;7<#bbsZlz_&@zr15my
z^@};jI@iqb5;hUcc{$dYC$9TQ)_j3E5pGv1J!pYp536Ma#`&2Pro61yUHqlEPdCIz
zCn$JT{KC**REf6RiH!Aw{d~HWaqHC2A84+YJZvgzwqcd(5s7P&b^CNDO!?EMx93UT
z9;<4z@Ltas2^9i%Mpl)k@`A=r3X6DSZtJ-HVt8m@kbO8KF4sl6uOom~8=-w}aauR?
zT)?>ECdtK(vla*L7nm~7?3LV|mz(N#*z1Ud8x*K}TmEgkq|<lXx#alUYf@qt6=s?q
zd$)yqu}sU0QoaQX1q}+eSGcL~3EUqi10KjJ{1q^Ex$l}tW1G$OcMNjJ?72Mk0ClHR
z3{9*=apK#36TW^J&%YwzVchle#XV-GgNzkT@&!-FI~EU!IZ0JkoYykC>LFsdK6!l4
zk)->I>%6Ha6s^y->3lW%bpGo6G*!iR3!@veZzbe~AO2N1xgdLWb>mXI^Xf-yXUs_X
zw)@c6^zdSCmCedxeaYdin)hrICwZAjFOh8Rd>U?d+|4RK^1x$5pNHq~@3HN;T994Y
z5w5yz%8D}{Q7<muT~eL)c8{G&zR0X=4MlUleG`anu9#XiO(y8{{!P)dkE|LKay4sN
z$BHibq$aUG#?SPy<JlDjmmL)!_AGDMoBr49ev-p@2d)(^X?Z6DwH~c0ZKW-Bl_~IA
zeO@?SBBzZhlk76Sa{cD@yZOtlQjWh||F-tF)4`S<MmGg7hW~io8n9B)?pf8!iwl|`
z-w|@GKYi{z&xzdK56ji&U#K<<k+m0!(d+x2QXtdYYaFAob>G_)f?wap$b@VT-T(63
zC9$sDB9nB<s@NYMyyyAz7h3jt%|D+oQ}wg#&Q&Y8o^89erlTNb@2TAM>1}U!*3OD;
z8`zVQptJJodzsxb!ThzqmR=OS&sV!`{`8bLRm$d$kNW55^_B7qpYL0He?8ZrQepq`
z1;5qi|6cawSA3%RrL`xD{6zxZi^=HMMwr;G(Dr^U_$y$_F&9;e`TX^#WTzfm;&b%%
zq1Wy4Ki3|eE7N&eD0-z#)dH2m6vxBdH#BWd)J%8y`QStBz`9^9i{F+(DW_W#M30n3
z=sjM0Axh{&%jp$G=G*ps71gPF<duIs)oXA3LgARFClapeyYFiF91?x#mEilmt2_UO
zL?4M;-5LCaM`l{h%YCz73wrHc?P0V+`}b?XZECZQEqNulMy_mkd!?iF`g?*#wh^Az
zrk6bC%k{7CF>_^FahuQUnRC(Owc}u<d6U}Sd#M6#iZOoqpRX?Vww8aNd39nX<IgtU
zb+otc6Ly~3zEDhtcP?X1h)DiDqu6K9ZBHt!Tl3ay{a2T(MzUQq_681aIBk67_wyw8
zi-jIDSE%iE3VY|tx0K5;TZua}eWRIl=i;i;W7B;4ZQSG4rqwg=wSPMFtE`}C*EF?N
z>G^Y{Og*fh#aP9N#Ql7?cHBLF`J!zlG7o3RyjC#T^3l4~-0Q*{AF~^h)p;tXr!3F4
zl4o=#+4`)}%@3(9njU19|Ijf%$F)MWWzC2EHwHc?Wx6>w<)|GJex$!-jdpf}=fJ}6
zl6e)|PBi=~(zf3pt$VC@U?JUAx!WUgk`Ir3$$BB77`5-$8kQJsZ_3rqkDdN&wgGLL
zdih|?*5slD{Syr}McVZ;z(nW4$r`Tj4@*r~pIz86`#_>BU4L+LrtNKYw>2^MrpPav
zGm)X~-gm8Gp5b;Qvtve%F>MP0IsD7Mv*29e@%3^g%L+|W=ggVp)3fuKy=w0TTFk}h
z>17*1@)yHz%(!AHSG2gWa;@_MDN_gUKdNfRkCOXbpZqx`dcjZ8=uxt5`ik}Y7L6^E
zr1HN0AeNzBWvmnB2U;ed*u%?nHqBi7Cv489%_0jQUTrrzSA8(LUwqCc4-v_{mlq6k
zO8sWW@i)b}elbyS_M)xG*?aJ2@yC|MQWbI4#TU5Nukd)hQghGF<m#xct=rF4uiIa`
zPCogj#<}WMbGGbLJ92YCVCN&pHEnZ*-?ZL7x9`5X{_X7weS7><em)+v;nSo}@jp9L
zgz}g9KZ~DQ<}xm@zH7%Tas4Xc!xOJ%^U}5V20m;ka@@VWH>2w9Qsz&)k6~A5{(ir#
zR`&g=>vJ?_gm3zoC4Mz_{x|R49zC{E4KkBubNMz>miM=2M@^0S^?hQ&-_`^tgMmvD
z$whwFVY2O7`xk1x@jezlK|;o?A}XQm!GZO^>k981X%_b_yB)p$_sqTiF&iUaPW)`W
zG5hV$`lWpKmt5pS6D1CN<d-w}Cfa>pLvPGXm?(IqCNsh9s{A{CVbPOGldBouCiAs+
z%&vL<de082iSNF@k4sxJCUmj>C(E?juu`k_QPvdyn<}j@r#zkhagsInjEl7Q`f4+b
zr{~?<k?NnV{VeXutNT`IO=XLlt0r^JzIWo&voS{xeP&L2y5QXGtkXra$IFK{+&L)a
zx?GW}DtFF~cbC=u@|!%19qgRj{j%@b8fYJ`li@vPlrTd!I_}Z2?1lU9s7n<mxE4K5
zZ4E20T6FQ#U&fQ}dWqMww{5@d?3PqID^%r8Y3mQ#&W`jQ%=5Pe69;6rUuf*6CDn@<
zO*xySKJU=%^4V8qnuU&E>9`{HnJF>V`R7fm69?6GvR@ZW6n=U*YvZEp4-B4gGiN%_
zK6$0iRNVBrUP4}DU1^VOKx@^Zj+8xaKk4yq5tlsW=RQ5uA^u*$-J?Kt(F&{L4~HL~
zbzAS?mooQ(!h};r>xCOK+)lM{tq#%+5?QLAU45F@J5pTwP}Xw&sg+l596tGG?k?N=
zlg{>*TPk~H`nN}FOtd}`yt;7P52KoG!3}##n)9nnr<&ICt+q}o-Rs!f6JPM-s%Y=-
z$A=#qRd|*Eun@1m{$|IcE6c3PwN9CSa$Ei8v{te68eNIQ65q0`eRxg<d+V0Bo-zBh
ztoiYWPam5H3WN8Tw|$D+7UosdrdP69Y1N5KqRJP}fAno^oMqZAz5471?+p?Yn(IzE
z|C*HB<`@<{?>+aY)9(!TpYjR6tK#JvemBolv5#i(b@@!2=)QG~Fsbt$%ct(F*rBj(
zceBZaO~12b{69{X4Q+T>;(RH%W~$r0iX*lk;<Jv+7OF-j9NKe_N4-T_eRikK^anF8
zJ=z^q({PGj)4h1$L%idK!JT_2Eq--v*8QltRlIKJpE&pmeC$e(`<VVA%_VHfCG9P(
zhb#NesQj{{74@$1DIB;|(D>R$CgcarDpTajHLfkQTC8KOGOcU%uJ-;t9=D2;tWch%
z|4E@=tNPK2KWg(n__%+ttz4%tD_!jJ<FH3hy32QcG5z%GrL}~g-mUSg1{>br=`TG^
z33}Zv-5e3L!1UGivW_6-(_`gVO1j0AYVDFdV`6<(x=ecCwdR#UVq0&@zfaq<esFrw
z`4v}nJwMC+ELT@vQ+U9EW@3=9XJD>p@Z6%&b8*0`Ew&dv&dZjZ!$0xkyqLZ%+P{l)
z26AjY4ljN2!*^cu?S01w<{ul_dTiiuZ^6L)=8I~1XEr(NF23cbuRHsrw@Fg`wsYed
z{W)E6W;12}mPoDASQCCpuw6ptuhDE@ourVW@0;W|Wn|1-VpHpR^4;<5BU+~G8oV-A
zOIrS%***6<<7?RXT(McP&0}~&UMw{{KW>`Afr3G;W7o_(C&*73;6It$82Ur&!lZy1
zN1_k?IQcv$^ep%*3{7oVq3_YQ`cUu*y#sGIzJFrY82@vt{;l9cUq4!OFe5U((lh)5
zlfoPJ=~vvn_*LyxM{7>_spD@BYyY%5bv!rxRP&@|?LzzSFZ}A08@~3T$_e+Bg64}y
zw7$eh2glV7Eb7=qJDw4^&_aH8U~t^C1=2r!_I3_rn!ep*{Cnp0Ek362{vX=j1D>nz
zkK_LsDU^hw5L$%nky5ratx84ND>I{zR0>%si87KhB1A%4%F4({GO|KeWt2kef6x7#
z%kA|2{Qv*of1JnT`kec`uk$|Zea^l2e0=U*us&VaK1@0NwZTT#7{xXdi>e3W%C`5s
z)7Dka|IV?$Gqq{UzRuLvSK<~69>u%VI49rN&$rer9qr^=8s2(q@3w<2w_cq|Jbm@x
ze&O-`F`Et7nkH;GRB4p9H@B*rDg8kBkwGsp>+HR^`?i-`=vONXO%>12JeIr6JJB#x
zp(K8h*3B2Xb30=f^;u~Beo&g^>%Q^T#z)Wh1#-ViK5q4>+y43J#<QzTns@@!w4{~S
z9eN=UztsHxukS0(COKsT#tOWD^j-b%bL;kWr}5tonVMI&8pM4JwwV4@kZS7f-Wz;3
z^2GU!k=%%a#<;!WGVj-vKZpzus?)We!^&?%*Xby`>+O}zi~K*>KCg^Z6p>`?RZe04
zw5``x`DD?Pr!CDdleew#iDpbnlHuAe7&~7<XHSjAqm>!1>K$Um1E0->rq=Y>U8~@E
zQOEN8_v^0clc$sVd!!rRxGm5yy?8+Rd7X;Ng23O0IO-+0vHO_P$2k=iYPQ<^C>3b_
zmZfXeR_dMgD{ozzJX>38!J&4Ai?ZvDE1BIZqnj$!=3nZ)CNh>YXVbFP%N2@iw*&_j
zG8Kh$EPVSd=4QzY2a2w-mGWZ)9_;9ni407*b>JMw!nj9$dmn%53-(MoEZ6o~;S0MB
zzdUc&)z&$Gw$rio^o+aK%EaAVsBHfGfYv7Gr|aYVYv^t|iU*dxh`6=3nW<PeYh-`c
zE!~ELDl7t5tylz>3ZIR*r=G*)-&t(PKj+KnDI?bIgQ?QGtd?>;jT_%Ix4ujbY4z*W
zdDkKF?NP3&M2p|(6xWAyV`p^P*Yj!#K6K7;PM%-sY4=TGOu;kz7Bf$%>_|bbaI(f{
z`W@}&kGNk<be$4XF%NLFl^UYsDXU4{fAJ8#O6H%2OdZM7iQUG(>sDpGYaahn6U80y
zM5;L~I`PlejsxG$_1WcQ+T6N7f1h*^ueEFN<NG`J-R_-p<LH#`{0Uy$*FHlVQvDNS
zTDiZq=dCoJ^IqU8|I;8Y8^6^m&N)ikp2s_QHRL!j%V{oRf8y~_){P-G`ngTneyi$}
zmv}S3<#r7ItghSFG;ibi2iAGrw{PxR!X@Bdn`@N7)G+NBrzgb6wDNL<l)v@K^eufx
zL;4TId6ItSY*>&yA*PV@eCg#S`$qI#hEM&uqOq;PB~tZc>hzk5M{8SCxt}LH`ehz;
zeIz~obvR|!uh$%nRaZ-d6N|npjc3O`GL>Z1T64dqz-YzK=L-vh10rIKz3*_p*(Uc>
z{ZDXIa^l77hhDAP{Grxq`O%-=pWnEZ8)e;gR$-OwH+Fj+@Mg4sj?Z&;G5Z_hL5X6m
z*K4{Bo?kb*`KOHO5NBAZZsxngnklzT>H1F64H<_e5#QGh;Qw1c`x}3+c&FXNJ{;2Q
zo9NWvYDYITOE?${70h|8U%#i#zwUi_)_2hcAMZH=&qfT3YGWG8WiK6!K0EHBcuCg%
zL-o}ho(DsBL@$U5jR=HfuV>GF$F16-)TL@(;&-<*a_gx=4@W~&QMZ!mllF`(bcZwr
zOCQGTJxgI^5RVax+OoyJ&B(2|)0|>*s4#>s<(@)f<d}R#+}z7;j_fuMV$H?H96bkb
zO|M*aUW_kcuqK4{?WgS4eR~`O6?Uhpy$BlrRy}svj_ymo9bMi8{V;11ORk(!l<w#=
zxs=M?u1Xj0iSlSY=bu;4?JaO$bbkl;iqqa)??m+J9HiowY_zy`p^YQ#!1Y>(U4^PO
zdrXd*M%c983S8RlS!N;I_UWvRLTExJUtwwUo@E7TgL3mNuSq5A7;>wIKGMFg#y0gr
zef)Wi!tnZ=58srj7LK(G>tx-Q`(4mDd1&6dBUQqsZQN^2jkI5G8aF=hK_Xl%T3?6%
zSb;~4;WrnNTccMk`Ymp_F+NbVj{SDLb5dJlMR6HjyO-4M)WtDhw2u$0(%ExDE<fPJ
zeS!TFY3ENf9B$8F=6dBK|6I+>x?wr(SO4smh`x97iPg|E%ktWInMKJeE?;)1sl{0@
zxP15Z&5FzKo9%s_w+1Q?>*e2Fl4w$QRd@FyuWcFhwMzn&QjQ-ofAo}Vs#V*GZ+COZ
ztBDl{Sr_tT<=Su0_1o&vFPz8C;MGzW?VS=nkaFAds}H}_kMH46be<UxYIZJF8BXwZ
z=_ufEjm=u2o9!#*=Jloa`Ih(E0zD#YFJ!d{-*g*#_wc23?g+*9s_9y<SL*_!y4-v9
zen)<g?fbOfH$VLHuJ>(@>G#(Eq0^vG>cYQBCj7DsK1+kx_lp0t&)6<%3s;Bi#s{~g
z6+LfmHHkDUSlw*Vcz8Zfd)7YA_Sp8HaiR50YHDXbsAX7i)Xb5KJRo`5Vv)I1z5<JX
zZ}B#kvbh2wWoE@sb><t0ofA26k88m%n-85eC&Rf!PYg22{84iMu(1>SQ~i6RLR-()
zvE<`xRMLazeqMWnM>5uIcdc;qV#y-a-23fzY;VSurntIO#BMb)mo7ZBP-C+2ChMPF
zb#vSbwii2YTN{6wX_RZ9&cv%sn^SMXjKUPY7&)HZzSsBc_f*yTxQ0uIlLuAz_P9?g
z#ee;xmb*99^6^TpW0U8ydAc{HGxZ1d4GKp4oi*fFc^=_DuYBqzSB867FQ0yBPYJhX
zq7wbFdYjvR3?}lQbFu&HH1_V1XdN=Ybi6QV-TC8>nOfqWu5&)P@5-MOyIM+R+HcwC
zpS<q-?8^h;6LCdSuiiRcvuFxD8=uAYGAp?^(fnHKaZdI4S}}!frG47z%63uyi*9n+
z%jhisQr;!Tz53!K=Cca&w|(q77MLH4<7j15U+-0Mh-Xchc$D^D&hhrf%*yND+-DCu
zZL=FbTj#CAVo}5~yxCf8$M|ve0>8{1Bf%>@Bf@1$U7|K|glus%F$&95R38i6IS|79
z?a^BgzWA01sSAAi_hX;&bB0I<+-83FR(<S1_u&oB{Lyha*;0EK_iKEN=Dz7UE@|P=
z^K+v@SE-2b&euhYj5+&%eRNn;CiXFz`{v>vw%mxGpJLyHU)Uw^t=h}qAJk$QSpT_8
zJlFHc@5qjdvF+bvU)U)QuP%^&buuN*O}RQ-I&7~|mgAXI(}CvqUTJBuUDH=|uTWck
zJM4?Jk2X(uoauA_0?Wvd1-dm??yg-I^m1G%S60LEiW-ki;n(n@)!SAEHh4YH#2&3I
zu*3I<zVwf_H+R3~F}~S9eL8jDo^z3F!-^d;5AM<UvDJSl`9Mm`ii?{vT03qgKh+!2
zk9Owmarf_9+-M@P@TCwX@07yeYpaXFajRwhJC-k6vS@CoT*&yn4Xw|I&uTSZJ$9N?
zrRBVAv84On@oh3YYU%In7n6Q+w<+N1!mlS*ONpg>CaEm^+JE`kjsxrKYbn3Nr0D0r
z-PNGDKT2<<WXm~<B1>r5Ny%qBq-rxuJo<cMD0#)oZ3|`pV6oTiW(O7wyv<CUU+3{-
zOYW5fH;K5yoL5tc6DOawPD&q?mcF)FdtIP$OFIAK3C8Xz#svLMfr&}xNj#}-58o?n
z;tuKm8kEJ_;^pv8fXR0<?C>TEF9*M)&S`skM-!2<#aC>KEcwlhgbv<*{*0}#(qpWN
zp^opu<`vJ&t^IwkW(OA>+xZ}5p3%ayzv(`+4J3w$+z1v~vFrQ-i8E3Q0&@>M3@fva
zz7Z_0H6gCWxj%%(<ygS`?B_A%D&C3Bg(VO9g;uR^Tv2c{g*D>f37^kD?DTs5F8IX{
zF<tOpNGIHwmi8b*B3RDUV3_Z<<37{#s#O{k=KNcY`5({P*d|`9*t|iQ!~1-8h~}Zi
zQ8$>ku?5RfBu{roT8q?J3sH1Dl39ebC)jV&|GM{VW7g<94qHk>@H3mw8tEf#BX0D4
z(#-F*=W8cWQW?yqy~k=kD)X92@QkZYgce@%J4%1-`)+gpHMR9!x^3svKDD1Mcis^4
zeWhR2a+X1%CtMBNcW)X0dcZk?r?%pZ^`VQcQ#alx>s}HL@8?S26d3S<ewF3I2by~+
zVg45S4y8gdOsmzRDON8V3eSk=@4fO;yo~i5y`9V4Ya2G~aZK1`rE_ayd9-m`x&>Es
z>>E+ey;nDvk0`i_zCChyS!!xcyuX72k4^2|w^MXlvN=r8V{@jumM-a~la{=GjwwTM
zcR<bPnznOy!*#%)^{tg7Vv*-e7maOfdT!zsKWy~**ZF+Gm64tEc})tW1$d?=bi7WS
z5%Uagpo?P5b$T4+V=sDd*LBZt4Ue)jeJOpN>~}^LCwKmOdnV3zw}|$X<!2MqL-A@O
z(qm%9(tg_>e@}eh={BVv?WiPBza-D@(b>G5?0Y*DqLW+Z=j}6RO3yjdOW*rzVFz7>
z$^q-ER|DgBJ(8Gy<2n7(=~5rJ;DWV{7M1?hU+zw2-~H1l%{x6OG~t~BCAa&j>+wWC
zp|?G2_>YAawAc82{hqP>=tZSJB|T?0c5>29pFMQ0<A?uwnU|th<5I?}_i0wGX75=W
zXnJFZVQj41X1Tj#tEY7qoQ-9A`^>6Tc)H^7yxS8m&Q(ViJJXphi5lFRwrWJCprS9V
z*Gz5K90NW5lq<X6s2LVohuq=Nay8{*Pm|P3;n}lCW6zV)ix+*R#dD-ZU9DGfi__oK
zS{$NZdSIS|%8?zp3k^5Fq2F|pVVkYl8REPq2>yi&3&g%xd`g2P3%wfG+^!bSH*@lN
z7>if%>{z2~CVkFqRF{J>R52&mXK67jk8;4Voa1w(=Y2McE`7V%FT(so&G0Irl5Ru$
z$t<mky^@vFYJTNT$|cs1D_?S&yfA$CY^U<%Yg^^=s`$qNy3O9<uH4_J5;sjPC>l+^
zZrl9*plizY_PKvLf6I52>>sHptgbpy<<6XTKi2Zc#HAnn6%qH(uaxlWdo2Cy^XtM6
zWfykpQ@)6DkHcpc5&K^8;dRn%bo%T}T`lspPfNC0amMM0++(@SX~(6*)g02wJiuss
zk)2y_eE_e{tq1-(lYiD7YT7kXvt!NGt7(!JC6&Tqz8b3=w}~Z$w(9guCpM_|S9u(I
zb6==fGEw!oz+<1TfJ`<13f177sd~)I)U8GQTb1&A4p`a^-72kXa{t&F5L<UKVxOAr
zuA&ORRPFO8*!U!DM34AhY+veOd7Q4@+yCWmy1RN^7d!`wyXEh7pAa&wE!E{48v8!Z
zq*%(cirOtR{h|+_%{5!UEFNP=lP#XMHno$jEfZxO4#$7J%MaC96wEKea`~~t0X_Xk
zaZJ;6?VhoIb$8#+36Aplbl+F?h{hs=xX-Ptf8EOYrN7E<IB=Vep77%m-6cYM)VuWP
zI0V=@=8bjxpS`vF$g8W5j+t8a+;Dz>RjC$SmBh<_?>MbDPkq-wjh@J=vtExjZc7k6
zw`ePWYrn9TL0MVc5r5`Jk;BjF_6fT(&}FA6O}>3@@K!ult)-feY0*%Wyv`F&4#6Hl
zkA?RaUuZqEnXYnaLt9<i8=3R&by>NuUrUvom?QVi{L`MC;n(_6dk(hT;2KD>X@9Be
zX~9?W>q3RA@iTi-ipaVN_s{GRQ4-fB=*BM050&9?bLA>_roXe&Ynch-ab|HDc{2$G
zS>6j*g7&y9D%)*edM^D=l#cGZ@ba;RE9@>e?h^QVmw&s|^Iwa3%KR$Ms6|d~uvp^V
z@?!a_A)fbxiHgdSi`HQOZlL0!67r0RA=$CDw6xsF;Qj{B4Jq4O(^X@Z7!-I9?d+KI
zGf7qP{s_a^R@V{L#YI6|`R5*68ri?7b;Ypxsmnz}#!nY-VX$9k<VwFV{M>~_#_Wo_
zk481dT|1ieLpt)ySBghsf4;WwGD&^M6!GJeVYi$tSgf>bHRgZ1c)z>u&XVnqkIJo0
zwOnr!C>@^?qkK2Gg4r_7NPhX_`XRN!;}<dyj0=X`9bd%rF!bzu*OKPF&(hrmFLAW)
z_~C7~OqI#I-*tMuCinV~@_ou0yk`5~yq01A<i#Nvy76ApS`U_q^<rl#`qtf*T-qY>
zUZ}87T-j*ZS5x_E)@wyaI_J@M6d$r36Inc3vh$gsKf~|pv@ZoUlY>I3zf-!CCPKpk
z{Mzfn7liUHw`h7^xN?{`;`8d`mkva!*7u4DZnoBb(K^MxX#Ty>=(zeT9~}*+`ppiT
zbSFeB{aGgUv3cpY`5HXmmoBMG&Ev9)QB|gJ78N(G7&{uLSsA1AY2^`p`R(smdk!e8
zarFGj*{=M0&BgK620wH%_xHTmw0`sSA`ge}J!ypn1tRy=Iv8%8vX$NM7}s|<SIqun
z!*t$tCOhd1QRP1MFC<=#?`c(DYJaI+FU#-IoH^zCqYY}=lh+o-ImV9v5>aYd-<RxJ
z`8Mq1sq-s)?rKdHu&8r?IoGH==Cro9H~-j|58-hxLIb%fGQAO=#-q1S)NX25OqiSS
zL-E_Cgfllqg!7*%eEjOR-2eUN1J3s{yN|f<jBQ-)W)o$#QM^HMSRrf|_LK9QO3vkK
zev7mRKU9Cs6P2-J;Z3=7Gr_%1ZS5nL*mK|YG+!Ez6?jIUR6XbUewU)FdsoWEPvSeq
z5BB&ntvNTiLHUaG&85k^&O{09m^8m4=d4n{Jg}4HQhgMw^wv!4{X)D~ToNNaLY4P$
zzuL2TVYl48e*dh8_xZA?R)lglvV=A5uJru+Lh0yOi4sq|`mNsaPaBT#F}>bCueRsN
zQ1UtvJ!ijrx2jslL=?~H<*t3c?(=|$H@~c?#Z8%a3O}lXt{fb4iIY=E*<;1MZawps
z^X|FQ6^%Ax%l%U7L%L%Z_cd(bO?ve@Wwfz)@2?FxA(i4`VI?aHymfl7vx;3Aaov{8
zylU?X+1)q1?j28Qj4CZIIw5)a*VvQY1#Q<IZ>Bm1-md1953l`vr#^LjBstRJtH`Pk
zs(g3yx1X9|KL2OoW$vUyiCx7_cl3Aeea`#h%w$#a;WtsPyXbsud9pLd_Ydu8xcrK4
zbl=vI`rnq}{EO>SmKgBx)~~H<`cpp1*b}TPDA(|N=@NrN^UiehxUb5c786Q_w+G*u
z9?oUqiFtH=x>?4GGflj-B~*Lo;UbydAAub;qU*jI2{kXg@?x;)rP00@SyjP&WrwFm
zJ<fQV9-@15r^+#*)bLH<!y^n@C)FqHmppvRnES|VK&ZsGx-TI(*`6=i^5vUHiCGNi
zyd+xZZNAsan3b<uc+n+q-;az4+apibJo(~#d*AN3{v|1lQ!Af}RW*Ldk6ko+QFZ*)
zl9vv1x2DdCpTEl8DN=2<k;3!o@|_I=&hd&roKsvlUBi+`PBr#7=j~2jQ*nCfh<1L)
z!*9N(F1xSFS!~<pvoGguh)$*2!cSkgt8WiI<wyt{+@!p8Kqbj0&C00F@6UYysO{z&
zC(`^*X-N7j8BJua%p5h-zTy^re7B!a#O-8_w}w`(rE|IY;`b~Vo$`HLp_BfnO!CpU
z^}jWGdL62j-`B6Swpw<>V`$S`;n;_|w^oNZFRmKO{HCCwsGykO_3LE*^lj1K-5IjG
z$1gH3%(fGDP^!=!{_|_!Ek6JLaUrimcHLJCMjZ=A#SeHrZF}C+(qS6Z^}y}i13#~M
z*G#1%%zPq(2Zhtu9x3JOa%(md2_IVgfi0uBV)-iZ`%!ZgZHimIwp$eM+~+Eg({-M|
zVe?!6;rI_J+MmnUWTbfnAJ4zHbFP#@W!janD*<xCx0$L9TKoN?MYb#x;XWKCUsTll
zeQ}ZL#1Hi+g}t$zPi`L^dLg`LcxZav{piIvKW#tVw@}DK=#=voyOwFQKb*!NhWN8M
zUa<&&XPeNudfv%#VfhvR#uYxd_`;0V-F(?vA@gE*gU*lWja?7U3%;4yeQW*D+B(~q
z<<pw7#@!X2O|LvQ6|R`dvZ;8<rzx)&e0PCN$2M-;tsC=3^-u0TWmr7$Z3*8&_f5Mx
z#s&mbIBH~dHVO-6WS>|UF*ql2K@{_O7sHTa=1iT(bLE~b^|S7|k-(Kzq7<Bxw_$Zf
zvDMY-61GLhUi+#o=lnYGWZIk0c5-T?!onWR*{dF2o@*(qdD}!bb^VvSkDlE9%pS|S
zK$!Db&xY{QA10qxhRD9UBjS@~R<c3s)oBBj>X$D3hT%VB5<EvP#B)z%hs%~Fi5^Od
zT&cY>d&PrQo<|L$T_=xi;@dD8>bQkzyZY~v4L3%Zl%BP%jh8j?mxy+%%~l-hj5r@#
zzU+kdjSWs_%+o)QeRLG9x$$RC*9kW4T8y|((ZipzH@oi@A8??}txYGgG;MOOa_*<A
zE$6%k=7yYgI=|MSD%5Gy9#z$gXXnuG<GNnu`|DbDCa<c`#v3=S^)(O5=w4I48vJxH
zZ`;AIDT5uCuK8{4IRDV_r|v}5;*7df$>B`NxC4DPdfy*zZ`50;&7Bw-bGIp@wmPpe
zL|tB^lkLfd=*zn%|9D>ddT=lAfg=MMn&~}y{oA?)J}e9<5<cNwU-@<a+uLtbkC%P_
zy8Y^Fo8ZAmcQ>b7zCL(&bG?go#4px_Uhhu1%lhSEyN=6cl%=hi`mUSrt(RA--sBjU
z@x15d_r48#R214=2KRmv5HQGZtNj*qu%Wy1$zIQ+^;@?VZXI~`nf=7Kvm1MNriE7?
z+7<k3GX3y)e}>!%k0UpaKV8hLQ#5FDa3Ja{<2T95UFUP+PVVFm+LN(a(r8dZIWhjB
zjoqI8tM+)WJ<gfs`@Aw$((H}qRrl8ux-X>dAC5B~+nw<#)}mr6b5i1(%G0CPcP^Q_
zWYpw{{r+w6Tq;8}@!|ZAO|~DzxzFf|h2I%3E*N}qSSc|*=#AsGj<n$?KFwWcw&W*d
zamO83ijb{39-6oF@u8+(kN8hI70*;ESxyzde6*qHp42`2KnY=uy;7!4!z&)hdA2Af
z$aprrw^<_NuXNz;v)3`vwH2?bTMI<p%dr1@x$<$pvDBLJ3Fli5;|eEvKWy0B@^aNf
z39b{7jni4W8JQbfEc<N}Uf7)N<2E~&=(EYPW*37;?B=Sedz>m?xFxN_9Tdt}D$ox!
zd^(z!Pm#X=#JkW|H1@zHZdcEn2jT<jsyCM3{w6hViG|Te+ea=#<&F<bvx}Zd{`e&G
zYqRlcM(g4AhQGJ;tVlJ|Fs{4A?H(ycU+itjy+*o^c~pl>ZI8v$YjrKMbMx*$FPGjF
z%xQ8U{`zu>%K5s_1eF;zdTT;Ica-vT%I?$b-u`D}6#vhwwocJ8zaFjRU|ap@?ds!(
z=NWfgKeNPZ@6sC|0^Wagd)Xz%n0d|7`j1?&kbmmjMM1pBnSz@3=_bT7bvHIzEDI4R
za!Omeb#zPG`1i*w9_r@dhWSI8dFs1PC**NfmnaJgysXKNFW6}tTF#iXZ5O>SlatzL
z?Bz{#c};hk+vZ;mU(UUF$yeQxP4p!Rkvm$Cu2z3?GG^!JnBmnUQSm|3jIVXs9e1QW
zo71yW+OI*&;#j2Ek-B@a{w+#cgR##7a>R$n>3O^yl)h|ry=|GM_OUA5BDL7kqdHJI
z_*uz1-&?FVGn8LQAG9<3lP#crm$_VDX*5_*g`RDJ#`%h4J7gY~_3S)RpZ}!imrb}{
zOKp*af+@Z5yaRplI?{ZT*96O}x9#w_ac0!5q_Updm9t$~BKgX)^+W6vdoC?*mH5zP
zHvjy&i(levnJVLQ<~FXs6L4jb$JOsuhK5@=8=TFFw_{<ow%(x^FPeKI&D4y=Qa`Yo
zGm|f<mQgFG#o|F+d)6ry=?(GcC%IZ>UrIgO5vgMoS5x@nOpwsVB$viJiZOO;>BmIG
zqZX<<?u?UuTW`&NSGR`OB;o4mI_1PquO;I?-HgrJ%lq?g$=0WiuRX?YeP;XOvR1ld
zy;Sev-|IIfC(9-MymbH5*?@s&eH#r;+t*>CVkbGbaaip)=DRTTxoBN<TT#WCuj{L&
zjl*=xt~oql(vajXj?)T`XFICoe@ZvLscd<7k*u{+54&N6zwoNS<T`Kfm!g*_tV{d(
zV-7`(?r0ZinfvN{d+Ge^+i%Pb7Gb={S{T}!mz4VRdg#J^cebCOTyp-|yBOd70-LM<
zOx#&`^5++qlRrNdZT2lupPH(DcsfY-XVb#`-<;8YZ}v=d_YA%$uSr`dAf)@ddaSy9
zrCZqV$s23^FWwxb)0kW-RsSVuQuIA{1pn{{OXG>jAj6#ki)_EX?#c`5Q#PCUVxDjD
zG|A+{^Qt}xmXgi6!7AUx^E&%q_+&RE4)U?CWA9);RrK01^)S26x)hyPLCej0H?4G7
zULfZE?o@rq>FbP7_NwGnTdm;w<nW-$hf$y9OOxWIbg9I}7Sh}bpN_x3XQ-pJ*L(jG
zI$cY#y*2Sa%N2QVXAC!5bU)pg$xe|KxiX>tDdxL9y+IL=<jWt$7apH8_pD!)G$6sB
zyqYUuE#2C#(V{<U8C6I4gR~zed=d)Fu@Z}3HJvk9nAq^hPN!03MM!6dnZJeIoy!I{
z#ZTUSaf>C_eob?TX!vNn)wWa3l-`H0I)$4y<e$mizrOOz=ACDA!lI)FB7@dn=hgI8
zze=Zc_w;#n*KV`&3kNis9DlrWIR9|4>fP2k;*B<&y2aLRVBC0cypUO|VA1w@8IJLn
z>MpDrS!Mr*=jcl|ABuR@3f83`INzEwzSq1^zKUJn{*7Gi=&AeK$`#|U+pe4pT`uCF
z!BG+rkr%JN=KfWRCU)0+qUm9cXoK@Ew|P%e|6ID>p%hdlxX+YRBJii;$)y=A+V$0y
zT$M{wlQlM^fAcOd;V(#U%`}Q&z9+%b<~MqtFMT<$Lf}^>eetVr>K%0%tJVbmc~!F6
zmP_Q}8d2eks<E{p+aJskv7_Hmv9zMZc|3jbxm#T&QJEt;rwks)T=33J$=aN&wdej?
z$0LUa<iw}>cUCe#O=i!X<Ud^TIGRz0w?9)b{ZLM4TY1Zo?_Na*vWuj>c7A(KcW1xD
z=Hc&g62Bh5`~1z|wtMyxF^<tiK7}D`Z|rjMdUsuPtL<I(c#$usk1$DFz0%N)T{fr5
zVbi+o{={S1@uOFYYaFb2INm5o&h7Rc=E!^D_agnZFgLws#k%b9oI}+GtZZ`~o|KMn
zTyeW5M3>o;a<}nJSw?l@p!$RGfpqzl^}pLRVx8ak<o(#tmRj;jHFwXvr&?VJ%Va0r
zez{U2B#&(j`8+8(nXBa3zjnOqZHsxiaiD9y?X{lw7cDj4drs@z+i{tn(e<V0vB%>d
zav~J@Wj_Rz^zP}4PtX?QYwB!@6Bxd-JL%ofOM|bCtL~;4$yP33pA}GSzFGI!#$Xp;
zQ8m%NE4TM=)pc;#8hYW@m|*sj2Tt`G@f-E>zZ`wV^deRDl!9&%C0+A~t$D28$!DpN
z`X`)<orK-Sebkn4_Pw)rp9ojl_VUET`<Dea<uRpNY~e5!tf@3ubbkNT`p%QOD^uES
z%DVgtJ*R4f<KNxmvUWJzSl%otweW~uRrdG^nGX&wmC}WG#NWCu=1v*e$2m5)Ab-`N
z_a6MbzWI;aUb&w6+V3{v6Zqb3`_rJyzux-f>E0dEoT#3PoNTQrNEvw7C_;HxHhuQg
zxeX->Cd%&b&ISECTF`Mqn`gU?`-Ps^Y`dhUcWMSkWo;oF*&luVF?w_G?xi~k#pCDL
z?D%!$jw%JSU4BBT%20VB+@C7SSP*~O$}^I2ciD>isGp6wzIlC2olE8iz3Vn!?7g?Y
z?pu`X4|<l`i_0>XXkNJE-n{VX=T|-r-WTdC^)59C&%beOKhwAS+m0UH`Ow#H?bg*k
zoK@eqXG|UYao@o9iQ@^nAGO_K@()(GZ@FRdZqSlbe~DRi__C-YmOC|7_g>UD`Ee<0
zm*_%qmyO{CeNLh3LuZ8w)%QOc5FKjUy0u(x`6{80cboY>Yo7?J)6$(TY>l~KdGG$u
z^-iDLhZ=)k(V3oaj*!{5Ws^!};!tJ~+i8~PA2QcHJQ@43V9@u=ruNMt<I`QCI?a13
zuixFQu+?Ng8zaM8ukLMgDtB`y@j5M-yTE6twr97%v9#}lzh0O&_HQ1#uPyAX9b0=#
zw)qm5-3h+Ps-&FS(_8khzjUukQcH8a$%X9^F|2WB;iXKu+Xn*cSubjQU3XsQkC%w$
zyH{L%i}e=2F$m_GytiaW>FE`&XQvKx?HAEpz;kNZpF8<F>U{g?Rpi>wGVD9C(*4Ud
z-{z_LA@hFz+;nhkwCBs=FFi+h9P~6#PFyy$_^DOn{?V~Arv2G5Kl-W{m;0WUc0V)`
zQdOnJy*l8ESm?p2s!t|2T#U7U7sMXh8AEaYoWJtAP1~oB($n$DW-WQ1H(w2yKS_<7
zW)loz;<=L)vPsM&!B2jJ+YPNrgD6c7?ae(L;k<QxLIrdA0$B|Xx0E$?e^#`bE0p`^
zVLRVbUoGdctEaY~WaG5=3}=#PlohNkHf-?gI^6bsc^ZG+{X%Ei7PgFU&R=As!?J77
z$A$NN-FI|SWqZWR^VWI~I{3JoE2CJgMVI?NT57V@)Ji*iaBIc)M(a;4hF$AY=s9!O
zI#&5V-cfU|=%hiCnbmZ@XVjZHH;-0(KG2;mo3PMXb)Y+_YD%12@rF8m?iczY{h%<}
zrMBxUE;^?0u=%aiiH_V*X`juU@$i+l$&N+pCvL~5l<s?CC|_O2o9iLhm@-)5!EVJF
zPxmFH`Dw$}l%q8^jS;pEX}KJ{Mv6~2+~0HisliPRtrGDk3diRQh)74OUs7K`5UsN?
zWtCDTW8i}oTGvt<8>V~C_KCYX*vYFuambo3P)dCL{iUUrR*mTRwM&-s)9Ni6^y;nV
z4>xEsYBUa9&dqKQ{mLuU(YL_Hb_svLsbUK`IZ@VjgG$R4tJvLn%5H@|icnV6`r2HU
zbM@(bsng-LXSsZ=!*^y+FTB*0yy;Ey{eI~MoXlAj{6bAJV_eRylcyNYsmC~ssy|$y
zCL+7TlTNuRx|NxEBDei<*=<>q1{I4V-nUhR8cJ(quXi0vm}ZH5b@;ItixAIJ!_bA^
zTW(!jX>$6-^#^K-bn}f2?Tzl-GP37CFku(})S__N;Y(jUS(438x9q%1*|=o-O0h>$
z*~fQ+YHPTo^W5EPIjhGHEZL+b<LI|BLRyS5FuMEWIR%Bb_K(I7qnlm|jQ5O;_h5e$
zl@pfy*gZX9d+TVlvGs!-39e&Ti*9djn(`ZR`8b-eB4&ic{AEqL<A<{^+X7RsG&D0+
ze^!Xwv%xr`KjDtZqpzNomzK$4zY1|OUhz|+t&QI3%4os4yCWW4MKRi;tM5&B?7G1m
zdD!IZRj=rQ)L+a`q%0x_x(ba2vwd7C1w5?RR}9<j3$k$wAN*7$zld#RSEcI8(MUt)
z3P0xjEmJ(Z(u3B<B$Q{SOQ-w!?tFXWW&6hqNymSDotL1KyfKyc$p!W&>~wj;Eu0fq
zFD_^=O<SDVnDJP1Yq`||??+lWPdZgaU3^_m>3w99*KUkZ32ECkBpkKZV*Zhbw~yM~
z7RW2-@1MgSDKEvp*XC_;&g*ohH&-+rDwJ;ZC8pPOi4=UgSAEW;HtOL)-7fotH%aMt
zk3TMI%jB54D_|VvyfHDWe=wx1y65*t^PK@o8AG2r3IkL9kDQehHXW<Incx-1-M5QZ
zbQNp5o}X5}nT110T!q;%>ub(nL-*s35^-!=Mh8Q0|54m|`GTcEujuuqfmwl7_i6{v
zSdTX_B<farJ9qr)bFl4sP?z;c=GXZ``?w7%ip%HIDH%N}X!pwvo__keSTLox&4tDL
zy<55YqCvOl9Z~xR59Kd6Iqvcx_52T$j1ghJ#ojTc5ji$q-v#egOVorWJkHflD&`$K
z=WyU)OfdcFK~}F_pGrrvCRKvoas=l!2i;kke?lk6u*r&dynpvd`>(iW@2`<biA}pG
zf-Wlh0~x8JCNag|I}gd%luquv(6(PHCp614<k&~O4?|_V?urc0xohM?I{813bO&A-
zx6T<>h~ZcFiux>{aNoCp<xFr>h)7bmZuf-JVLn6Nnv56fDhq@Q{OZnJN|N5WqTKh?
ziK9Ps==Fa6+PF{uq<uhx%!8bA`WroK8r!>Nd1BhvE<dt*S!tG7sJcSJd4}GdnFj}$
zrWC?i#jYBMsTlk1uidNYA}+bTVTHKTgHNYq@-0T%Ow>o_tPm@j$9{83;p=1XZj9P-
zEa*A8&f(e9vXc*&T1>r^+&je=tIF8n^GCHKl95})Xjk0Z%n9br9&0(J-Hxo&PGTN&
z=e;Ytzcp>`@&h-sWsmY`9DKTK<%KDRA2v~scd_d9AK?75<Act4_80l^w&vcz4;2@m
zd$X+%{#5W&!PoJ2<DIIe-0KFC25U+ZUR?NT5#pv{tWfA^xTOBndK({O<NA?t?M0j+
zkC`|6EIlH(vhKc}mt|?u34YD_7bA9Ozh3@4%kRq{I;I?v&3}FWcZh-d#S^i9gFR0n
za@hHd)cgQ%p$ZA7e1X@8<^+_ewwhc>kb0PwcuCy|TlwDl`gd3DmhvsTDjb#X={Kb7
zU)EvNc|R!~`1Ky=wo-QS{CS4#Ed~ok(sH}1E&cVFg`e<I{#foUztLYmvhtPJP5-y!
z`%fiq9q^Wnj?p;Y{6;G~Ys@}<ZX#m>v&K2TQ_sDuF9jZN$Q&%W-l&@%@#90T_vFs5
zU&Fz#G^cxXnlh$7yzLwpvA6mxE@!Ew&nqB#J<0Z5KeLEYkJ&n|l(@a_U6nC=hHN%T
z{2VmsWRSUjvp2p(HZO8fpq}gTWnrdmneTXyzv*PSMltUBk+W5FmB7@|0>2actT|6E
zIMR|YKaYze<L+`TIX@BSN~Q$|E1kyQ4c|_B{IqKA)T#MZ@00V@q@Nyr*}RYU&t9da
zTS|Qj{OCh=D=Jd9XlQH@6u}-WWM#e%d*HsUwV<t~rJ%IDgtUazI+?XF2EXS6U&9Jw
z8~ArP?2U%l`(fyw0Y>x#9o&bnW}?7<PomKI7*OcE*y(uZ&z*Mx6NB#!`LGRyJ>ZWT
z8+#zVCL7Ng22D0W`mJm{7*J!I2cEp5365i7703kF?ILsoENncQxKNE1e}|PTuB1@v
z!6&9YLr-7JHjny#t1x)%(d@B&a148(2;~+$248K1m+diRax?lZY=VdJ-0(EunO`8l
ze+|UzG)hGjBk(y}CoCbo4pAqNA9#)r2t-=Iz%$T50PP6^V5*R@;)L2}yCK^N7+yyc
z7PfhYth=$wfHWTPIQ}GUY#%W2uq+VZtDkTd4;ftg#97XNu#*2^%?Jbi`4KXIkkQ|D
zw`b$g#v2Zlg$sTMz8mPU02uKuEBKfcoDuJ*BJ1>ETJXL!5P*MJL3SDdEF0)Ypv}!N
z_jrM2Tn73X_}c}j{jWX+$8+Fubzlo`Tg;3Xwa<AlR0od>f#X<SXXy1`0NbD(AK@_(
z&<^Ts>|yj8Y&?Ms+H8Vn7#SAP;hw6Fi9uTt@6I}g#Yt@ieBXia6G7~dDxBvEfesu!
zfOWMxs}1&d8}JE1Y_o!z5iE{ttg)k8W;NhFnCGBoJJ8@|(*|YR3d*L*Cgs8=h?Nzq
zFDM_--~S)=1OI~_v^@`Way?j{aC$8^o-oi>fsEVOM9$37W|KP1CZfS6sK&;Fl^2u?
zq|<}xaG$_<IQ^EHbh|)0tTO+V?i@^)2J;J}$Lt0&sDb*^J7Kd3)|XfwTUgE6cr>Wl
z;Xa5@Zde-lsw<o|LR(}ufH2@oKOw{C0&JEt$GT-Zs||1$+zuZc{7{B7DaZ)hf|ynl
zvV&Nh>XVow9Am+qQUh}W9Sqw+jT!Jkyj|2myI}PTWK@Ig!XQe|!X|>HooP}HY|a2}
zjLo~Sjlo#F2W{D5aS(vtS3qV7eA^ZHJp&6J=J`P13y;AMydIPP!REtCk#&NQLHEJa
z%0UL&2?US_@vbrW>P4KHKpmO6{zuxg2vf!EU4g6@)Ms|C(q|K7kf+1k0Yli?M}u`c
zDQ--PD`UytK^uNp{BIld>N8U9zf5c=EQ31n!GfOx>9GKq6lC*pLZN_sG$Eq{jfC}6
z1U=Tb=NZ)51j87$*+c??&!1spSO$6*>u~HKwKKP1z5&MaS(rX!rmmO+oMG6))+NYr
z8B})W3`(6N??L?*PzHPsbiq7Vk5wD<T;SJ@@VF2-z7zO@9@bPZz#h#2vSy@=p^sU^
z^$as-yxHX7+(l2~_%#AN%rG+=XZ0Y)fWK|;Z${;WC;fel;jg!?&mLp=>#gc!&NjP4
ziZS3lM*=X)Fmty3`xpa-^KUStUrd7&XS=@-Gf=qy1~YcRi2XM(P?r4*F~WeqJ@el~
z3^P|~e;;F@EdLw8JqC&(4ZeZ~Uqyqjp}|FHaPS7he***V{r|<+{R=U|K#`=urD<?k
z8eE<RSERv}{^6@JLPxQuoPtNVND2nZM$#TNDusOjy%{`0_9O-h{v>yJWcGuB0v}U1
zi|`o3KW~<%3K%FFh?3x1G&nwk{B;bJ9F$WPQbG6$J{TxlNqe(V1`2-FG7Dggfr4KF
z{|DFohiPL3<SPh|fO(7v3>1AL`qw7|#o(`fVuyiZNJRhoWT4*3{Kdcy1NCm;Klr|X
z7*&6O1~;a`O=xiZis7GQ43tCvFaQ`RrZl)24Q@_@ThQQ^G`KYlZcBsP)8Gy?xDyTT
zLW3Wn!QE-_qcpe|4em{YpP<1{(%`3QaQ}Ze)x+V5n{<?VzvW3H)F{={-~|rps2Lt-
zqJa5^9H>1wcjg_i#IeJ8WG?=GbAo|SYRh~6qxZl?p8uRtsV&AtL0gpCGE9^lvT-aP
zfbTO=MiCy0@6W~GElWOh5$cKia^hGF<a%@jp?)UdA9MdX!`y@%Jp-gej?SQWaE{dr
zv7Zn1=nU})>aQUBV#q5HUJm&r!fT*?)T3WR9)y3+{%L_cdKTfaPRO$m-Us<}gbzdB
zgzz!Q(f<05bIjl9|4#4=>Y0&xG2r`iDQgf;)y<{IBYYv$t0H_c<OT@mh1?k7LXcY{
zTp03W2ww-e3&Ld~pZVb_thN&5ClI{~<N*lRf;<M{+aXUyxIX0B2seVf0O1EAe~fVa
z{t&wke}-^-sDFuYYW?R@>Jjb<^_>W(zHWIgWfbA3p?(VCL6HAOcsS&Yh+kcToEhO)
zA!kQ;BIJt^o`Q2v{N9=DxwoNyHKNajTomDjkgq`a6Ub!|{sM9}gj3s{iK2(_TBzTS
z@Hdd}M0gwI;N9fp&<(jg!uuijLii`hPa^ya#@We+VI1_we{o(KT!seMp}`MeoP%^W
z!q=Lyyd7xh-DvRRG<XCJew_x-ror=R@W&YEAl=W_!*;uey&wC(+O3*~op#&~vHC!v
zP|r6M$|s!9-v2Iz_J8AiHV3dq2LcxZC=apPJiE><i*rt@2>WXUV+I(XwK8*<VutHy
z?`Gz}Lnm>*WJXA=p~d5zdxo>Z*b|)d%y8n);WftpE8lKhKYPEt0H*wobKV&{L=8Ex
z0&tM-mx(oXVVuw2FB5zN&IM=e5PTQTSNy}xalUGX`@`5NoX_4b<Ljc>u^61s-Y-+H
z^RV@8oX_4b6Z&$TgViExAX>Hq=j#YeISpgqa4tE+iGH7lbr1(ddWNgRm;laYXSfiI
z$>V(XY6)LE$ByY^{J;9ek_JCcgGbWf$uxK-4gQn{ucg7eG0s6zoT=|I7-PgPssF29
z95gsD#yKcTGj<ALOp=CP4cBj+(T~8`UYu{5;oD)%g@&DzH24MFj><oFGH|Z;4}VU>
zP93h-n9=LO*f0(KPh77xqbK}!8FowaU+pP@aSqCs8GRaz?ZWx&Is;}F4-PmdT4i><
z{~XSV*<zO8z_~6=Jv)y*#ku|r$A$?Wns7e5o<QXL3Fn40`hzgWf-PBckk%9Mb$#sE
zQjGsseb>_9>v20qGxqIZY$wiV?=Gm<Z4}BO8g}ey@Dnt67;b-d9RnK<c({RcW4Jea
zUbu(z*>wy;Uxjm`RlphrHN3<5>^cUvi-$3so5DTH%!)8GGiXn<fB15oo6m5<jy%pS
z{^2`tZaKs8?+>s&bBzC2zu4h=>lwWtjGe-{?F>H!W3f1QnBl~kI2-3qGaUae0NZ<t
z@&C%Vf(CD;!G~$^DH?n!jq3^}8hjrO?uc;?xEcT|hkr+befrVRhtS~hG<X&b{(uIr
z#5f1#2q+33w!qI38v5_J-W{qa6ym%#`+_D3ONyJdhnu;jhpCf`r?ZE<DfSvCH*4&*
zPZU#A8&79TQ&S1q*{IBHRC+clMUmK{Ar1b>fIs-IJcucPKZ@YbdhkaH{E?=rak(_E
zmzKr39R3$iCyghR#uG_XQ{h%*sF~mvWbm{ycv=}etqh)422U$P)#Daqa0{|{Dp}lu
zES^>tPb-V3mBrJ_;%Q~^w6b_wIch50f*h`t!!5|+7UXaXa(G%fJgpp_R*sq$PbH6A
zkjGQW<EiBFRPwkrc|5H=o>m@DE03p@$I~j{X%+BP3V137+>QdCRsm0|fTvZ!(<<O;
z74Wo*cv?kVuZZ>AmL0n4YCBAIwY3ekcAM^2Q{SOwO0l%`aB*>TH+8gk$KLa0?_>Qp
zarJb!GxadHcSNv@tEru}xfRuoaKACNvUargu%2}+Q%g5%a|~FTJ36{pQoOv}J>0B3
zUH>)&HEvGso=#5YZr(&9{QY2-z#pyM+$ruJR@QEA6q{pi_J8N#Xl?FHnN9pp5vYFr
z*UQG-tZhhT1aCL9biuNAhIR2UcXu$g#i*mbg&Qc4oAnV-dpB$HVUUP8?CR!n)ZPj^
zOf;m8xrezUDF?Ex8S!k1fGse}Jiy!2+#Ov!+(~KwItX5}h7D0GauWlAwewNaqvmc{
zBe~f-+nQqkBIRW6ffxZJ+};{B?PTr+<nHDU*3L)*Cu=7cH*W-5*}FR+$kGLCVuaaZ
zPJ<w#wP-Y^hrN?ERu8m|aqRA4?uJ$eKY*1U$%TsT(YjzIbn$ev{HL5A=C+6dOUz$w
z|E@Q9eVq;F$DVHFcDJ;%wsZh5yK~2ejkU9-H^t5zA1D@%)`SZa4uOv>8+$iwd|}?}
zG~*~ZceeI|m}J1w#l-;|C^oKGhkDqMP1`%WTVt(3(pq9ez>N(483P_}n0sLrGd*VR
zft8zh8=w13L9DDTJZ&k2jMOBc?$lTF;r>b;=5WN$dNAn)e}6+fsi}><BWyVkGsUI?
zVtC;D{}gxD94RS2Drbsg>gfhY7;a)_4^dfo+SpjTQR{;X$pFzh**n`~^Bm#dxEx_K
zDgLkCb_hJy($3V?+|t3^mh3g40<JF3mUb>Q4q`*u-p$3?$=Vt9_`l!4INQ!(0&oYt
z>gh;S6)z{?nESY36DB%}om`ylJzU&~mom=UvUG8UTG-QIe|B=6Jv@^GHnKb&$wh^|
ziMuw{GyfU|@G!xgT|De9$qfYN%Kx5?{~oKj?%%NruswMa0RTI9V6UGfc{PC6UiKiT
zzvfcF|EUmwShu;ky8JZ>0c_{u?%{0igqGh4OtqF^HnwzfMY8?RnaBf-O%E5WpkV$+
zQeeLH*BKAf9rmIe_A+&`IBad{0b<lS0sFw_F3bmJ2{Z_1Ma+zoD>$uD&10uK%ro6^
zhX-}0PLHOT!~dTj$7bAFe{izK{ukHO<tTP$#!i5y7Uu3)wb8?WPtu_D?k>(0>OjPb
zZ0|wDT|GT)V1eOL5A3pp+9VLzxLI3cmz-E#z}#!+U}^)dOJ@BSzgV3)OPboaxi}Gx
ziWzeLyF32-)cRK<aM4Vx&#lGcSF!CU_8wUfM8H8T03M5N1SeKh0FNVaZ7dD~;PKc-
z=!um>z^{=wv2q1?B8hLn;vmpt8@P)n?5JXK5K#R#D#rPBEKcZ&^$DOSbK;H_<#w13
z1eCi{F<u_9dO+Auh8*aVNIVmAP=2!h0pzH@n1=op4Shf4qS)sRY$M9UNJl*Y_)QY0
zevd|NPq4~C=$Au1C=aL$!S`cv5CBibHi8ENhy|2`J_P~g&u~iRX;_@FL#(?1eF}+d
z(a;ksHb76dL#%9|?QBM}L+%%%e^I?B4Sg_)lk?4j9M}OHQ7>X$5aq=9Li>wY2}j#)
z4JlvpxZoyna=#Gc5#$Seo+uBoLI~`GG80?}i-Q0-**>w(0qpF-HbT#Z#X$i2yVyqX
z6#!xZaPs^>tS|#RV9lG*6Dy*qovoM#1k}zdD*k8O{eQ*(|87qsSbk8iLTn@2!Ggr|
zNt{?&0{Q|HC)TR~zfa=CniFVekQZTpH5LZ}aIm^aaAIW@aPqwLzuMV>r3c~vtsPqB
zA&(1ky9raX#r=fbZVDt$ZZ}O5C$}51(hJ)2F}4xyL#!wQ{)EK6us8^SKg2ddPcA2U
zJklD!wDd&1KzowUcXHT12q0hbIAz1>znqW6$>VVWiNC<&MERGIcnOJ<%U??3<ndcZ
z;zU29=N&MIfB@<R&M8E`W>_2qP_J@qBlvLuu>g1lwh=r6Kr8_M659w4u2nz)oLqj;
z7a#ymE<eZ%1i;DmTX0I{<a!a`+ko;Pz&0Y^Z%~icmyUEkCD)6a#L49+zTXDrsU+E7
z2<-z-uGexBC)Z02a!^iVY$M7^d;<dPRFk+F76$?F8f+u<<nu)>iIeS+{mL5CfB^CZ
zW6c-rV8N04fpZfqPS_`oqvg3m(v$6^lQ{VHfv|H2a@5W?5+|1*lmP^wCzsz7r?cfJ
zbVNBpy#OQf4TE|#-xL~lGD#d<a}stQ)38%V(t~y&%F|8a<aX$%VTYH*8?ZQ$uQZ8+
zYfFMFllW^A|G#4gl=*+L(?rt$ujLUSm9v>-hdfV`>qYiwa=nOo81%0x$<9iW{Z<lR
zPvT_z8YE7(&jC5GZ-#9|`;f;k`8rA->VaR8?Q1~}?3iO4VTYJ+fu3v!%uyf!o`G$I
z-V#7801oCxf)nEu<pDs91&}ZBL&84@{|DRx+Xy@HSR4dkryAP`4s;*@-iB@ePdT|g
zL0t$tL_Y%i<aQ(4lPEtQb{qtv9)Me68)0V$IEV$b{QOk>PrHeccp?@j?2!A*n#76o
zAZni|7vKpb{U$690^kp@jj*o^AQk}6#5RIE0*D2`i?EI0<m<*~Bz^&lg8=mJv5nB*
z01yj+cVZjC^8myG;3e2b@KOM=0C+F95xgEiEC5cPZ^4)X0dSC((2oL$1=Ri=(s`3?
ze-Vk3?Jpy7vVAEMCzqf4|C!W$$^A(EKg@s2e}H6%Y~Pi{$@T+CoNWIhiIdA8OX6hv
z)c-%EmZuAAC!*a-N&0RQZy<5dcZ8n!KTgoj_egw%q<=!<Okkj30qE1Pjj%)fpC#aZ
zB(6o$=a4ute!=w;@G-)U5*7ym*dfnL<aw3McjD@Q_2m03vfiAA-hl=`3OOhznA3=I
z`jYemBpyiOgCu?ta@0-?Nl&(uMB-#SV2pzR?2zjP=6n!9yOHfY#wnGP?Yw{-wF9pG
zKtS!hrDB|u?SL@|0??DoGltWD`EMGWmE><^zaswcAJ`}J)im@nG`KQ}lgqgia^R*m
z*hciPDM>#>;;dL41faLYHbPH6?@W-mFct>^=<TqL&`SY`1yC=tUInLAy*(Bu^g58E
zdcx0v{lg@^84bM)<UkL6p0MvlLmx!agL4X@C!a6K<p*;b2*AD*wh{VU0Ac|xe<2m)
zdS@(7=$}E3>cKTU2*5t53!!fY5DTcjpNet4D;6j8qmZNeKP3GTl71e^AISA3?&Cmt
z+(>#s8hWz-xRdm>{AVSm0Rh<ez&4`%;s9a+Ex#fa<9bglPUux3NA>eadQFm^oG+LI
z2|KbR{V@_J=4Vh&;7f$wkfiq}aZ3{SA#u<qAOJhZv5l|;;vfJH=3asW1_I!q48*u%
z1P}`ZUq#)W`A>3!?}L0k{3JN=br9I8A2W7N!F?`-?}qzCdxCcUj%`FaiSr%c(<Dw@
zPl9|;kT}qR06u?U8(~KtKrEp4m8lpnC%DEV^yGQtCy5jF2Kk;OadRvV0<cfkgRuYt
z(4WFK!anFb5Kw&p732ETSe($GhaA;kBkBD~`ZOAP^1N||q<=<35AHQU0Odc6ZA5u`
z0mK4Yo^dM1^`I_<o|qp{{Q@}Nf&D;|o{uySko!@Tqz7{>VW0YYB5HZa`Yj~=Ig)-a
z4f|FkeK1MyPD4-qoes5qY)SeM8hYY)ZlJ#QBz+PM{T)(y$mgm1H1tnN{1?eSaeWK&
z4I%M*lAhdd9i)6iNqXXUcfd{<i8BCz1<=3Xnu_QbPRPMWIEgPM>B-}T_+1dNL%!bF
zNU{UQ0%2c+WQUwD@p~R%2V6T5dRvkn_$0wyNcIg#ocNs&u#-gMK_ola53y(LTq1F>
zhDq2@CfO(Zc?L;OZvRIlJ=xETY3LhBda|E4)6fr+^ueThjnL3fk~o-Kh<dHS;vj(b
zVIb9445!p_5rM@C{d&lO9(>12@U0~M1(IH$hTfROOGtWfEd&B6?nP`P?4Je@3uwN;
zw?P1$e4iMDQ>vXvEKb<D4moNkm!!W$(t|Yz5K#RKD#kgv{BI!#<&VNPBH#BUJ-OXJ
zk~q2ilaK>D<noi()yZ}^u)Y8R=r3a%kuP~2fUI8y^`Ktl@+*++kjt+|(v$5_f4})}
z`x}w$kjrmI!;S-q&%xqE`H5$TfpR92>UD~wXCmo|-;o0SToNZ==R}k2aA0u|fFArN
zm&kWDPO0q)e2L)1xIp!bp&oE>%}nTt>mnA6Z-*N2u>i&a*Tptg5Wxab9<Zy26Y8HO
zFivoyKFdgaCl<GW`)f#i7mS0CbtDe*eY=thi1i1eJWpXoiE&EsKjKt9I9Gx|a7F>@
zK5-pO@Etr<PFyb$`~WP-N$TMlJN&Rb;RrY8r2^oSAP{y&nW_8NsUI_366TwN@H##!
zAjUgkM*}u!5u$H`7ph>4fI#TG*{J(<)Q=gy1KN3qa76|x7(h7hQY!e0a7At^06q)?
zk#8*+;8@^9_-|-m0O9_yoMH&SAc&ixC?dQG+Sf$*dl9OhSPvx1vl-esgy`j9y@+v5
z=y{;SdLeqd1yuWi2$x}^@+gGghyHd0;iq7}IS5}3Z)k|?E22DiVZEvm{a!fWS`oew
z`sV<`Z$Ur&hVcE=;!}v<brboX6r~>EfbC82WH5nXK@j1N!c;DSa8Ednh-VWLcG6%u
zwjuf!=qJSW6`@y$?Pi1M!&Xr9^+34(A}aSs_$8>nfbdwzuOU1M@=SztKtFkia0P0%
zl$Qv<0V;xpdW1K?c?0~87zCoeDxB2)A%yF}e*cbe9@y`4u>A--i=kc};X6gC_O~E>
z5Khc{5H11x*Ad|-U^}}ZeDzAIeJ_MR6{K=Mgdd0V$ytOCz;PFXaA{c13ka`<{Su9E
z2k5up_s$>??Xw5Yhc^(e0{7Dq{u1V!kMK0;pT!7&4$nt52p@;_YDIW2JW=-}yb_-8
zz9L)@o{;Gn|E|{u=pVcY&xR*_5rh-v*^clM=!ZrKC-hbb?}6nxg78jwzVkykQO=79
zC%zX+Ksb?aA;O7#OAt=vTaR!e-%*5Lh36yidu<R1KXHNmLOi3A;EG&S9sL~YC&4`-
z2fyzIf#BT>srzgQXNL1X7s4y4a>_D<ABXdXAj03leAgg+3mm872sef0kwLgD^po`n
zw}kV_W`uu$`D!AZ6WZB^@E@=|dI$%<cLiZD!uepnCJ5gE&uid!?jR8DTo3)t1>x;*
z{DR-Vll8>7IEQe;-!3EEYc)0f4TRr-{__CgD`CDR2>$@D_rUMs$>rGz_gfKO3){I5
z;lXpM=|>U10M2he5YDuUs%K)NeiH4r1<p(A2oDgV>WF895_<mCRDKcB?}P1s4dJQK
z-<}}65Bl><guB9d^)14G!g;<I;f-({jUhY^`qgiQuZHcy3fqsU*HuAky?78_3EO8i
z!X02g${>6XERPDp8{j;?1L3T&-S#7V4s0JAgj+-XDTMRG>#J~t8^ZHoEW$Uz^Hdtb
z9bkJA&p0L8#|G+)5q&1SA9;mvQ`in|2)9~EZRY`mFNJ<Gfp95Ns-7P9Cs7`$6;!?u
z;l8k6_z*q>?Stn4fI!&U1ossX{#=Br(?EC_EWaMYi>Y$TL4;ev_B@R6R@k1$5YEg>
zH57nwf7p+g5Z(rP62ecwaax4%V%R<}5k3m%=T3xgg#FluaN+@R!w64@_Q7)oKp@)L
z4$hO`5pE0je<A!2ybfW6^F3i_8qSC82+x7%>tzVnf%Aq4!r#Gqf#(>I%b5<xojSt5
z!}~j3gzLa@ZG!L?*bepxSB2$2itq*zYB|mzJQ3FG0>V$jahHJbTd<uo5FR8-wO@$v
zHaNePAp8KFC+iXZ435tZgcIw?;5i8(5dF1oIdy*$;hOOJb`B6?fzSuQ@^B!WxIYm<
zxIFAHafHu-*AL)%3uOCY@Vust@KjhYLxh*Xel$b)I#?ekgxkS+$p_&T@cJ?c;hgY%
z9fj~8aK1`Hcq6qslx&12!R!A=2rpYlO;CaGhp=DXApD&$RsSC0i{W?#&v^g=eCT2u
zF>n7wI5E!?^BJKh=JO?Ro+J2g=npFq?gRTp3gOzYJvSj-2lfm8@PAS{rJz6TL-Y&a
zJZyvToV8eDEO;P%F7!`-gj3ZNN(91{p*|krx8XdHj_?*ZZx<l^6uf?Wf$#x1FV!KO
z6V4~?2tP)wGay_T*7rNYzd(Oxgnml&SBfaL#)}XxE=J|c5l+k(Vh9(8_SYl)AS{m-
z!j0hh)C%F5u-y(L+#a6SToLX^%)<yDfb*v>!Ykl?u0O)dpkJLsI0rnxoJaUqc%HkA
za7ICDyJaD~ACA*Jgg3zJ<Oc|!g7aGu!UM&r_RA1H2=nbgcmQm-UWDI;emIQq5y%;!
zzY~69zJ{7FGs25u`z%Db6}*mJjPL?zhZo_u;5;CN@G|J1!U%7I?Jt3FG3fW&2=|8m
zyaV9{uzd^=E(-l*AHr9_@puT~;n2Pn!t0>@!wCNh%jt@6N0{$Xgdc<B%NOChVZQzd
z*MjrIIfNgC<Lf-aH^A$YD1@s*zl}xscG!>C5ncetV=BTK;rTZc;r#2UewByt3h0Mb
z2;T|Yp&sGx@Ou6&!mq$_-Hz}8c)ihs@Q-jj4kEl7w&y6qmEd`89-ME8@xlN(8^Tw>
ze&<4X9K0V~hHydHzk&!S)-Qw+ehu1JLHI8?9<>lY2cBoQBRmC`#{l7lu>B7sT$Grf
z5zY<m97Xsb9M`@GkA&mv48mQYKg1zi0p1rRA$-#us$Zocd<g2Z5Kg=|C=cOv(9Q#d
zuZDi|4B<!NeMB?D<6*uX2rq<w+l%m5z>%;pjBxN=KM=knocP{r4!qtZ{O}-be-4Bb
z>t+H74}kNq62ggf8*PNk!+tSD_)&UlIn5C60L$ZqaN_$gAB0!HdIlkU2OPgq2)BUc
zNkVuFJfCJGJR0gBA^bNS7ZnKqDM+o?8-&k=^W=MkUxofNf^cFT<R`*Mp#Kx=%0xdd
zh2v`pJl_(01#F*{2={^hDTVOg@cgm~;f`>g*@p05*k48nmxJZDLik<S??(_m2=nzr
z_)2*H8;bDFaNfRxaN@o=1>r;D)PA{(@Eb7SB7{r9^Hep$)2U`CEeKbI-*bIHxHoK{
zF9_cX=V4-fh3GFYSl<P(KMB4c`r$H!kHh&v1mREMe4>ExpU{6a5&j114G=yD&R1p#
z?}GJpM))W^@B1R0PL$ekAqZDpN99)#-URELig4oo^d7=_p#C|+iThLHI*Vve;(oRR
z(Z7fN@)6+{&~K*^{u7?>=0QIq>|4U|z69Zha6GO;_}+Qcc921M2kc)}g!{wu^)7_B
z!hH*b%R>KmMmRCgA4hmM?3Z&0C+3aI2-k!DK#V7%9eUyXb_day!u#3B2v>&f^Ah3A
zaQ<mRII+G)d{0Q^dlCA>D58H2{qq;XzryQJ7I+;;*vW<M%#Cn8=qIZX9tr1FX@nE~
zqKWYNu$>JMPV|c@!ig7%I3k>w9|92GD@gULNQ6Ix{*Z|9LOB0qB0Lk8^8vz%`Kk=z
z?84N1Un4vb=G%pEy46(uXN0>lQu$AWn^Q4`1<un%e?>3&KWKXkxTv=8fp<_uR1~n=
zQBhG*!EQl721P|hYyoMdq;13;F|e_*vAv32*oB>#m|$aLUEf}F*2Z<$W&Zc~d7t<8
zhnX|yd)8jD`<ywPQ4W-6JPPZ*HskXCjHZm&#`&cq<K@(fepkjzV|y6P_-7pdgBah5
z{e2|kukd=vRK}gKeJ)^pI*v<g7$1-QZU^J1j1>RV7?;;uE;3#S%Uyo|EX!H0BVRK4
zDOiuWj32=AF~ajmsplH@>(Y#;;=EIXaV?gEHRBIazCGgyaa?j?JR942f5z2VzX6O}
zHB`zinsF>1)kMa-pq@F5pT~94CdT3UypZ-V{vFrzCm5IW$`!`PV*h%`cyo;R732G`
z{Bs%ai1VDhzAo$QKCY`vV*ijl2*>kkjLY?81IDF4j*QFkt_$Piv7mc0ULV`}P{!r=
zj$w>ftEZH6G~@ER{Ak8gvA;}Ud=jpgW-(qK{aMDiANK2wj7Ok9dl;AJ1t%D9j`ekg
zaU&ex9x&by=dV|cm%#Do8{^$@-Yks$M%M2ZY*%F%ABg)k8DE3_(T4FaSdSeTZ-VRN
zu8g0?@*Kc;7>)yhjGw^qKZbELY`2pbPlEtOn#;Hk%CBU61Ge*Rj4#7+?-1iPa2<G_
z@xi!G$Y4AQ+esGVb+8^kGd>;LXF;52WPOF<I^Ue}Em;257;jx&DTfA(zrc3VhVf$P
zk2B+5CW@XujLY+1d0&I{^EtNX2qym!;~LNS8yu%*F`k0!@MVm*m*Xwt)3N;bF}@JT
zz0-`}si(wsgYkFRf1WUY3;lV|c$;F1p5KhmmFIovmn@%xSl{w~ZOOB+zUnf0_ach^
z7K|@OJ&ueo!G6?>@weC?y%;}$>#<PAYoeYpj7OrM35<_IKNm5+0>>YD-=&OKUYFU$
z<iFtfaGY^>^z#biMX>)qWIP?))f>k9p!^TUvv56J1m^+i=U?bgImZ35{A)437Ta4B
z#&_X)kR9W9Fs|;57sviGi1CS7kHZ)@$M!jbarm7fNK+WUhwXem<5SSj)r`ktdH%)t
zIxL4HjQ7QIxWM>PY$taazk>Dhg7H?!zcM}($6<NDm8`EeIB%B1@m_NIJy3PVC!+pF
zjN4-Qw`1J8rc$0=82^gp(2wzO^xL2DOXz<T<5}1qCNSQ*o?>@4<7d?hU%_}gY!6!)
zm+R33jMu~ZJ<GTQj$^kt$N5p-4=BrdBDSlKOg;wVHNbI2%Gbv6#FX*v*gvZ<J{ZT_
z`ivLFa%;u-F`R$p`IfX>73-@vlb81kdNaNs=fUBO@5KH%j`1m2o--J?!1+s#)6$<;
z1(bS}_hCui9nZV=Fg*r%{&JG>I7N->I^*&>!vn@U;=J{maVh_u@oTtlG{$xz{oIS^
zHI*6HVE?Mm_$wS&TQDxqQ)Ii7`oCdZJ(#?_t~HqP?>LSHF&=?-<#i6JAO2Sm(j+F2
z%TJY@&!s&44iF@HAEo5-zQKJ=kG${n6yx%~)@zK*`&Tm=U!>NVRefi?GWIw56Xw#N
z0reDlBkX^YKT@!&IOFpFuB{p04;e*j#`ps4kG&bMjpOGq#sjgPBrv`P$L;luZ$tgp
z7&pc7=ON?maGm^}aSQCfX4oEOIV@M}!cy5V?uggBx-z~C*9k)zm)}cGVZ0fx&zCVi
z1^eAr#&=^q-eg?fAMl3p&Nxn%#5iPJi*ej&!T343o@ZQ(^1+N3L;W)tABpw5hjB9;
z_pUL%u%1enUNZg)``r)5Ph$Tv$N53VWrzLRhH*>uzZ>IbC?Cjp7u=u7_!7lU)e^>c
zBHzOJ2=w~|<CC%7-eJ5Ej;C)JuY>CZW1P2Tyi0L@v0z-@-`0$A`Ts30jE7^p8N#?}
zeI>96#&2N#PG<Z9uHTk2UJLch^ET=KLTqn`nf!fhCl45Zf%-o)z5)m0Lb(2t`a5EO
zDarT=93SQX0UL-gov;pJ(~iiyh<*I}KxM}`y07X)cy}S+8P^p(2nRha#0yey#%&a=
z@@Bj*a(~8Mk&hxA>>kJVJehE?8;A1K7>`9h3%M)@9Bx%9jJHMk6NJN*DSwamBH>V;
zy;1%p;UF)6r}q=#An$?l1{TT(>CYtORS1VAo%~(jI)sCsSt#F>@ioX@2?u}V?*R8F
z9P}JQ`DnsHUj9C?ynj>rc^c(s5P8t^9Qg*qL67|Z*qwxfd=AQ|F)r63_Xwx{KPMdY
zR0YRGDo{(=!Y;@M7Etz02nTsfl&`?JBl2d1gC6OB2f{&5ca(QwT;2y5Kse};<sVKs
z=m|wViHytpTjX^(5Ci#%D8HM@%iq^Kfn1IcM%b}05&2F+k4*1~JoKX!Jn)h6<;V@N
z<A8pUe~P>i<F}EQV!S5$Uykug$SWg<-A>{q+kaao-x=j?8SjMLm2vqym~M>A=k)a>
z9LAXh)Z;@q#5)>!0OPX0f{}w*C-EAH?J$9H`2A@}8yFvr{2b#6$g>$=h}@`-qEFg|
z-<gI~o$x|p|8MlaKH;4NKZ)|42nTuj|MsqggZw>|A4WLH7eO9HILLoQo=7;zn;~CJ
zILQA*zLRlz-_$|m&<?wbS4Z)JlukI*mwevAWyTY+95NW+jQl?1DafBQehm3b#?z30
zWL*Bg@K?q!qr3{&@3MbALvG0UBjm*yZ-nJ$&Uk&~WsyU6DCfe+>k|(3QVV%A!a=?Y
za#zAZUjDwlC*dGp8|7mecS5cu9Q4TZuX%)n9=xog+Qc}Xj;Kx%4tlm?`CKL(^t2K$
zNcS0swgM@aaL}_G^%TJMjx0A{owO(q!a@EZ%FF*tkn&?uz9W;D?Zky}@N*8z`x6fO
z&!Ya}goFGhl%GyG$jj%NEg&4^PoVr?goC_%p6>y|K|UMhZxRmjIp|L&;UEvsz=HIH
zaFG9oyih&eVHNCxyc)ThaFCbdRXxH%z8%Ut5)Sfmyy{Lk$oEJ2p@f6H9Iqk?2l*J3
zpG7#x%kgRv;UGT~<x>d<`3UiXbeM3EUyJe?goFG75EkhP;UF*D)!&4J{1y-v$r#UL
zKrP72aj6XBH_)#9e;3#VJ@Wa>El|FwU@#A=jm4Wt-5HnP=MG?eMG-~bpYd4qJA&~*
zd7Y5)WD`YC5_0g<UO~F|ZA^Y1+C4)!^y%(6&ZILgpO<%)aEP}Qo@d=h4t6{0EGlom
zh&<?*&!;o6QjSBp0pEgljR*(*@_Tc0!a@Ew%9mmMJ@Sf#!+h6Bydc#i9Q4QNs5s8}
zSB%S+@jFIJ1{cN$;eJ2d%5uQdcU2hS(0+P?fJmbVhjLQ`6e$t8Y**6HrHo5I*Awm{
z^2_HwZDPDxL7jTlF2bQ4WL!rXmvLQ0F5|LR)To{j4si{@xN-=GxSFE8K?CIjkE=N2
zGOqH3yNImvxi*y<cf`1A6Heo5%(#rJ19BOc1N!MsIK<_ParrYnj(ENhPUP)S2W;jL
zdGOyC{anDf{J+;FgoFRG{jVb&^c+Gx8yVk%d>i3ig}iKsdkLrQ{{-W*{BJNW+ljo6
zF6&X2=UbGA;(~IJb_+EWJ0byx@|5Ge8Q~z0r>m-3$fbVS{%shSezqkX%BP5-coWH%
z@j}Qu6HeQSJL57gZ{#vA*`7xd4slJ<Sry+45Dsz4>m-Yrei_#~#${Z85e{+HM*nv)
zUIY0N!f9OR8JBV0MlRz58<5@+4spqO_B-Jamm3I+WZFpC^7^X8xQwed;b7Ad{jbM(
z2joo&?=IwJJG5n7#?=+MjLS!HPvt{6#I*%^DB%!S5b}vkzpSrB#${Yf2#2_aqW>!x
z_d~vc@a{rh#<h!a8P_r7GOp3+X9nRA*D>Tz35U2QBLBwp%eV^Rz%J`i#$`r0#5D!|
zFU|M_<W&jpF63og^%$3NiQkadB^lQ|WmnaWaER+B@_vLvTuYIMF#R&Fk&Mf@CJ_#C
ztwaB{j3*<XOE`^d1>-WV&B$e3o6*nXghO08$S)EOait=Ef?U>%jO!iaGOq80LtGco
z|GybOjocV7I7|JqzDhGL<EoBa#&rVyY)Lq%w#N0CJ>d{nI?DHD`ej@`jLWz}35U2o
zp#Kq!zePTVa9Uql#${X!kjuF4p`Tj_hx&qNwnExVIK=f-M@4xv{W7i$#${Yj35U4k
zbHuV4FABy*`an31>u<(oT*VqI`D9$5lwDN~!a;RyjH?0R5Z6zX?}%Ks6B$=G#${an
z2#2`pq5p#zm(MlxC!EF=!MKbo4!MlW1pQw~IGAjPd==pkS83!snSL495yoX)=Lm<m
z<nz%kGTss6y-hfc>nY<huJ_2nJ@C^4{WNYOc0__*P;HC6G;&!lrSLjJH6rf_88LMr
z^5DOGE}K2$J<)#+(_?~q+=)EI6^qyDyokIl%ED$6lOI%FIhaV~I}rI)CSL%*r#nLA
z+Y|XGOujLe!&@TXj>wm6s_e*en}g+91v%`tCGvJmz5<?)yAb&{L_UnkzsB>&QAEBq
zkzc{&6H6)wHxhYyO%9G+Wb$wE`^^j@-;(J6#pHc(y<V`HA_VcaAo4YlL-{~E8G-Gg
z4&%Ydt(YEJ)~y(KLK~eJ?}5A*;{%X;GVY5!nDJ2LBN>lFK85jV$mcP>1o=wF*COA_
z_-^C}7*9ifhVd)NZ!mrr`D4cAb;Wm#e@6MAj2FQ6T%@@oAnVr@d0ECQBd^JLUF6n`
z%jdSYV_c3)?u^Utl|l)JsX7<+k3=r}<2X~r?@2@+Kk5#oF!=y%hkF>GQd`k;g>m`+
z=?@scQdp6HiX7a-Aw+keFm@8@r@X#bmT@n&PFz(PIq1QmU3Z`Zlg}xw$aiD>R567I
zFfRX(K9cbeMO-x&IoNd&FE#RIOnw%Q+bKjIFWu>KoFVcs4(!KrPG@{O@+*YHys!et
znR|qT9{F6$Ovaz1o@a!E9vRm=<T5T>aST!}lb82h6vRPLj$>*ZhYK@a8Mz7JV7DON
z*Hn&h@V_O>S7N*=ay4@B6UwuOctL7LIE0GbR@H%Uke6e9AmiW@q_Kp99(x@X*VhRL
zJ%f>NX51h73C6>a-(x%(`8UF$|H|)kjnH9UFSU`&{<0X$r!(U(YAFUn8UKRqb1vf}
zOceR$$iZ$s1?k=o6M3kwo@n<N<1WZg6Aoo8|6lkj;h-lH<!>?`g8VMwpy!)-L3&O&
z=vjdBFBwln{*G|aBd@!CCmi(bMftxO-+|l&7a6ks-$ri6_;ut}8UKL12IF!)QwO;$
zf2=N*J>k$kt;7pbAHt!&<Qi){<4!thQBKHZ`)P*fl`DxnF7<RdjuLq&AM?VBqLYlv
z=fj>O9Lib#|M(5UK~EFZlfifc<PQi3J-&4myDta_J-t!>4ddOBe;}N;pI?N7o*0xj
zXrtJX^*bE75#hA`m=g|q7NL9@#^)lh$@o6xbr|1;ycy%ykhfy|0`m6Aq5VKT)>Oh#
zg)ol8jw*?9Iqq#C`XSz}(6~g}OXTq@YaPE$<e?lspg;E*e~tVR;h?`s37s0%Yr;WK
zY5X2AhjICTm!Aoz^(#AqtVj90T0`t0l3SzxB81cWEloK1BcCr(p7EZjr#9oE$m=ma
z40%h&waD8tJ^{HMa;RTR@xt3bRX&W%c`%W2TagFSTB0A~mFJ4viF_TMr1Ex|$U`}#
zpg-3cm(M59ARP4H#C6M4!a>hD)RWEl3FL1Gr}djlIOute@;@1Wj@$rGprGDq{hAOC
zdQ6IlH<8R3H%4BS@mk1hFkT(GHRBzSH)XsP@>a;9exdwj{SIVY*6&otZABhP%ZPr6
zHyIb9DMY@uPEvV0L*$_x2BSaejQ2%;g>YKG_Xr0)aVVe3_(<f>2&eU%LpbPJh4P;m
zUyA%2;k14Y@uG(8@5fNynDN8N%QAi!c}2!=A-81wGjc1&-yyd_4)qJ=FYDKhaaq4{
zjN6JlkmeKp5U>1y>|`Qup_5eJ(uh2iry2@Gq!WynKz@~R`F!4+j0d6oUBYQSJ|`UP
zUP1YnjPFDKj&NF!-w6jj4#mKGai0$3jgc3`0S(lG9(le~966LfoX2^J7o=)L9`w&c
zJvAAhgWQtnfpYE!N<?yF+*3zYDlf(pk;fAb>pFAfvk0etE+QQ4rlI_P!VLv;g#bl5
zO*qwag>caGN++#Sy(Jv<lt(>32&Z~#*eV%iIWH=u>^DFT+2y$!9O;T2<e{A9{~7gQ
zd?l8%2jd@*do!MmJb-Yh_iy3_DZ*B_(LIM5>^3%0_G1`VBOgsT=#l3OQwRq=2`Hby
z_$cIwgo7U04i_Vb@`3V<6E8@cZFQSGKQEx3?TnvCz6-f5XSsfR#CUH-t?Dh~amY>W
zln<bXw!_MVQ$K4H4)wbe_1F_`D41+Nu7p!PG00{6*<D>xG=|6{(j8bv<Xr^G#Bx~4
z_#Nci7%xy<(Z7@NpD4c<xq%R?E?(H2RVNvjZTc$XvYg)$4&{)em{olvyt-gM$cuMW
zKFD&ojsBEEZXgb;Q5H5$h`fu~m(TNU!MJ?>Z(G8l9nPr+TEu-ogo7UWJl`&i+hV!(
zV>}%BAjXFvAA(%^FUPmBj91lpBl;8L^^hkqj>C~^JL9rEPZAF0AB%b}5v~?&9P%v2
z=OQ=64ki6xhTNR-jmWDqeja&q#_uEV#&{txB$7Ab;Qw|V6~9eSxLPpz{|nO?m;Y~)
zgj}|(^0=s9PUNvE=qwy2^3Wc3VLcvWd<*i^ghRWM_gP&f9Q52n`J0U2M1B`Jgb)7U
z*EOn7jH|^lNCg~}t&Gd7in4Ev9Q4RG1xGB2JoxiB+O=Xl7r71L5SM%|Yg@uWkGh0-
z6Umlw`FvqV<kFwYinyvL<MMpmljs4v{jnhYh&+a>(=?gLgFp7@&osu{Az#e6FY@J#
zdmvwp9Q+5n(*Ny@%YJ&8=mGzO%8ECUP7ryi1Nc)S5B^U_yV;D#Bmc_y0pvdzm(Leg
zIf51CdtR_BZI@@fzD`QqXTdmLCQ@k_*Py&7<9(3FGVYH&k@3;U*CChfSzS;$u$jnL
zLRr{cV)9iAD+lio4&^C-=kx*N_p#ib5)Sp%$x6}ljd7{psFQMB`dPfXvTuSM+DQck
z>E0VL`Lh^Td&Yy!luW%Cm-3#Be=<?z{g8uQY-+j#S|-0pt;i=ao>*7m%ZZ*c3evqF
zW%Ba50hbx~#`C+IL=S!irPK3`$;;;w7&|G(WO=${11*6Z;*x6+khEd)@_7Zej8AN!
z=<P)G$T1a;1Ty(|mWq5N;n045VmpatJQw*`!lC^%tflCgh#dTvb3Pnd&*bIvnRgHl
zcFUQ9wD><5#!DeTNI2LHM1Bl8*u^FVYE+MjJm_zU^3NG>i2N1dpkK~wUkC?1((ZT0
zy-?3@!a+~o^Hp&GfqDl$^HIJ8<1>(#LN4PfFY-XLB)pK=H`Y-x9}y1aP#bwy#^pL{
z2;rayt5+37IOyq$dPX9b?RHxo<v<*fcSc#*Boldv_bA4-hVgyKHxS-k$jkpXPbD1m
zWTX6E#vda;gdEBZ{E=hRH6joCTY`W{8AKjc==e`2Fa0ToLCSJ?4Ie}@M-FObSpsj$
z<bUBJ#h&q`njkH%D-b=nG|};JCf~zShgGpe-b6vV_aq_@<yI6s$5O@(k*_2i%4Z-B
zikk@sJys~co$=bpcOi#z0Dt5hc8qac=BaKGZYbof#S2mv;h+a>L;8tamVd8`3NPGQ
z*@9iXG@t|ZkxThHU_>MvB418Hy7wML9&EZ|T)i3BAn#8&EjM4nLC;8(4`e(Nc?fdw
zAN-N!Hi~gsZi$4`a!V#0^vH7C%lH6s4AKq8{S>VF!1!?Frd^Z|($9G0^^g}8`%n&Z
zu$--lJRFnBmB@pS%di~W7+;9ohjIDb`2fcEp?olM@DuFHb>K+G>!Cwai5~D@K38-$
zk#B~wut{O^@_Dd32#2`jbM1FCE`ML|B;%EE@;u9UDdbm?LtNm`R`G&#R}cTp^w^@F
zZ;ZD`UH}^mlo@>Nj@*dxuE<Rp_e5Tb@qx%IGaijx&3Gj8TF7O*dmvbm+A)4s!K%)T
z-#|Wu@dwC9G5!kqL_K^ta#=p|cc4}=J^}sT#P~eq+ZdmNd@tkjIfn-sUy1T389#vh
zEaUr-Uqmj;^ApDVoN;-d_D9CcKt_>@;le=bk<Z7lV7xxcH_*eKkjwHshkkZp{0wq8
z#xs!jW&9R$FUDUY_htM!@}bCOTusscc*dQP&tkkc^7V`lMxMs_Fyv?T@F&P+`N#_;
zS&aXU{^u}miYEb|7%z_e7vpN=2Hli;mUb&6H$o0>!}t@4{#RvOi@ZML^O4&#z8ra9
z#?^`&DqqI!kdI-!7xMXxhaum>xSYREGCmLG?=!v*`Dextp#Q~T@(>Ajp?uCFuf_OH
z<n0)Lg1k55ACU($UbFyM6YC4cD<GfExHIxi$f17W;~uQvR3cvl6l1#0<ehQ7`k3)>
zD<#7l#!V~~UdUD1O1sIp9yVoM>Z!>1QJlzYF<zsgqSu;n`Fmz<882Q~k+(w*#cQk}
z-Ma^ohas>vmX9~%O_2vMJrEzHIL2}Ls+z&LyCSYy%(xHo1B{PAevk1P$X_u27xFKR
zA3$!{L-`=<<tU!l7efx^gH1;#ScAzIDxu`JA{@%i1Ix#n@qWmg5e`kJ9A50SB^>mO
zLwN_r<?pXJ6AnX~iFiTkPdMmVh<XMyJ{P$+av86cPK)?|bH>{spUZe><SQ9BMZO!k
zEay11dw|Ge)70h2AoAe<UnqZ{@lD7dGd+XQ?mNb(A^*wvD&$3aDj%R6z@HPy%ORKk
z*DtOdP!oA0l!Z+TCNF;n&5m%0>vl;clOyAok@sZW2rrVkGcJEOVE}UQAN-Nm0Y)(1
zL@}$H&A0>db%eup5}CFW4*GFAP#t2tFJ?H$_z>i`7!N}Jl<^egg>ZtCaUDWloAIm2
zofxkH8Aa+#xS@h{@8N{YYff-r3F9W1XN?}7h8)@n)NlP#N`@1R*F}B_Ik<<X^tueW
zj7z%)Zi+rBFL@Q@(r#<iU!C!m$gPN;28v4EyAzY|g7RG$cS7#QxF7Pqj1NIR2s!u<
zc4eO#OSm=hXA#pQf3Ij6<6}_&I>!G(zLD__$af+Kf55J^eNYd-#q?yLp1X|SK>n2R
z56H6_&q4kMx%3C8EmhIpN}&LUcAEqrL@Gx(^j$STk!lbQG0E!yc7#K}mi@Fh;Y~pS
zrZD8PUCG~1iey|>TFEem@pj0^Gu{OGG~^Ht*tJ#EsOIY7TbZ6=sAmV`{>Tq7J`wp5
z#^aHnKra31hyFYw9LoO;mj7$Qn+jeX<-alB2zfDF@IZFF)T%pD8@Vj!rRYyR#^)e!
z!t}_oqb-q#^#Bg1Di^|GTsn(-Tp2%!yf@P?{SP7>+Rr##9E~O%;wmd%kmeE&^06qt
z8ac!Z>!0~J`LEZ*H#07uAG@7#3oD^aq+N`+!a;5y<45s=<6*|-^L~#pz70<fPBUJi
zpkntt<7=@&TxR?{wx8>aC*e&B8H~&4VBcq4KEDx%58e5flj4f*y(NAIbHMANUD>WB
z_d>bxOnxlNZy>xAeum96JzW0(F=PjM3zX}E`Xu+o_Ta;~{6DoZjK`zAJfD_&<Z}zR
zFnP(3>*3e*@aK%b#C`dE0@#JP<awy92jFn6x{i238if7=hxRX@dnTVxDfvqHAkqjX
zFXNxW_#~8{&-g;*s~KO1{2<{S6_d(4wqFpVyd~pm%%fqvDRMu;?U2FdupV9%22+v1
zF38JvBEPSYye$Zc)QQQvDOfd(@gU?=8J~!JJ>yG}Ut~NL`A5dnk()xLiX{Dfs_d%d
z?~F<Q6S*Ukm(LUEL%1W#!e%7lEeJnAczwd(>*3XLp#}bcyj<tBVjQO}RWHKp5&cnm
z_(DB=pB|pUcoVeok#RfZC2@WL|LYQen(E>1dU&iJzE}_6&$yfiuQT3G`cJqe@w1Gv
zvIG88-a-%Wqlbqvj?<lL8sqYQo(+W8A^x1#!{6xP#c|#P|EZqZj7xuP8JGTe5MG=3
zGhPp0t%o1i!|yRJ{rSSU^rt#3KtzJLEOeigw^4fdRXyCXn39j{na{X9U*1l54Py7B
z9^S;{kA5mYT@Sy=xINl<M0j;#w_x!<`hnNNV>Jj@BZG|-<MNz2g7F5JXE)*WKFs@i
z_;14L{f*V}dK;88<qm}7r8J#oKRtW~;qu%FG91*y9}|vCMxFj&gqPG2<*mG_vIRfQ
z32#NX8R0|q@CADKF~XgRo)>y}F*FALU=z^gYM_VrARN9=muZw9zMOFEBDySTdUzJ$
z&7^X%t&D{Qegc>6$Byx>n8#HQ_hNh>%EvH%7WrhxUm>5bhp%J&3(6m4Tz;Q;o^kp8
z;2k~u731=`83x$MWckSN(aiMl>WoK2Mv>YOjzhkVdlFtiN0c{ty%w?q$7ZHVV)C-B
z>>wPcM4h4x!f~qC@xpil1Nwo>K50cbj4`t9wjmtOeI<7xT(%u?Smm#WPbS<N1TpQ<
z!|yOI=dh1@criSmhPdP!8BDa-!{zTjOZoQb&m<-<`7**aC<~i&j6)egl4TBkw6l&V
zZ`d7m^B}EvHOk0(ky&I}0jKqAOXO+0awQz6Vjb}$oQ@k|gyWQ`BXNYwItP?UI8Gfp
zl1w-b)jG1BaM_jtr4eq1pJ8*EaO|2ol1Vr=Z5_!W9Giwhpuj|e4OWqE-;D4wI-<O(
z2`@{yHQ}<)!C_m%<(v#${+}Eimfr~g_aySNjQ|fLoX&S~gv&k(@`;4g`8SzxI$v)m
zoURAb2v>t*OqU6-E}__F5>D4eIfT=7o%}Kn4$Hm^>ddgw1E=d-HQ|;Zh>2bYs4Jn^
z+7kJCgwyK-^$GVR@^rikBfKGzk0ZPh;faJ>6P`?XW5Tx+-h}Wp!kZF)nQ%H^XA<6=
z$mbAF&s$aGI)J=31=-99Z$<RT{||tAk!yB1Y)$0lcap$u32zGklPlr!Tn!F+5-!J7
z;9-QzdxwF?5pD|rQzGGZ5{hjy;T;LzPPjecX@olxewpx2gl7`&M0gJ2bY9SXc_8GV
zJn6boj+wxr>eS)|N%m#nb~>WG$u<U@#$}H(z`;*>{jC?_;Ex<@ya~r9qa(qD8{ucz
z#1c;Doe6}~d1of!blyoKoX$I|2&ePTX2R*bvzu^PhJextr}NG^!s)zoop3Y!44Vgp
z(|ISGa60dNAe_!SKMAMvjuBLpNU)*vjv3)}-l<49op)*xPUoFQgwuJa72&cifFJgR
z(|M;W;dI{VOSo*Spl1l-blwRfoX$IPT?~iSpa9c&B41rXu}vVn2H^_`r}K`yz6*zI
z6ZuU<p3XbF2)88iM+m3$j=bLr4%2yuUf-tk&I6){&O6zJ(|P9u;dI{lNw^#nz+EHk
z%y5{_J7$E_d8Z=bbl$NboX$J)cX&WQop)Lhc{=Yn5KiZvZiLf$NB%Au=%@3}5F$_K
zogl*Lyd%HI06lcxi6ioK-kC-?op<IDZYy-jw487|3B`5;;T;LzNw^%V;qYO?>AZ7>
za2U^Jx<)vicODQ9<Gf7SgwuJa1`5C!>?&R|kL)9oPeeJ{wk6+#T((uo<^LDUwkNqe
zRD?*f%}BlhxvlP~a_>C&^8>jo6Dco$*Qqm;FNJY-XIzckjq$q3`!U`a`C!IdBbW20
z^hf?4VgQquzcVQ3Qz_pY^@KBd`F&Lk<MMmD(Top8J>waVKt7pq`F(K$<Fef+GA_U0
zn$P%3)W4W<`MWSH7*9j_HH^!3?FPmlqWo6IpCjMN_($Y>88<AbfJ2NIM}Ca)(#TIU
zUKx2h<F$}qVY~_Qn~b+bewT6iJ1Lor_eA-Z$e}x6s5;UK`v+`{PzE+(C<L6Y(~6=#
z;Km?`X)WP&okrKU&~|02Y^Zz!J#?LBOE_JpEhL<-(+&_$*J*bNr|YzWh5pzzlg@~(
zd>%IVL)U3BM7|`EPa>SI)6Nl2*J(cqr|YzaSm<DvuG2gTr|Yy+gwu6e0jwm@^N)2J
z;dGrAML1ojEg+n(({2+^*J<*(cVL&U)B0oM08ZCwNrbD#F`2qzqXGHq5{m5_!fOy-
z0~-^_TM)jN@Y;kI!bS%2bqMcCxFz8$2(L@He6A1ZsYkdYHdf&E3ExRLU8h|lT+V%v
z?HS>8o%VxpYofm+b_TF3=Sny{gmAh}izl3})9Cj&be(nqI}hlWb1vxbjGYHKU8kKO
zoUYTd38(8c6YOlDhpyAC38(8cH^S*UEtYV)PFqSiU8kiHPS<Hq3AYtK$z+V3AN;hF
zP;9qi=Lg=Aa1C~T;P!-XB;1kkGlX{{yd(|^pvQ^uTZC%}uY`jI$U76R#?LUU<It`n
zGA}S3T68>8_pZod*VmCm!m%ss$Y#Q^%j!rP;dK1ZBpkb%j(j2<o4k(5=ahq=*o1Z5
z8UhswI352T2&dz}Jl_O)Y?6>Y?|H_+u?gt-bfSlj|H*{Y@jsPttWupGdA}j(r{n)U
zB2UMEdHoaQ>G)qBfJm^R<G&T*bo{p^oR0r)gwydqfN(ng%kvjFOvnFJB2UNv>x9$s
zUtU*)!)o!8Nv@B8SC>$19dKO%yawR`gwyeVI^lHuKS($o|6dbM$A7s#0lRekcf)lB
za60}^C!CJ|CkSsq{J%{&9sgewPRD=U&1WJ%*tI5l)VQtyPRIYIgwyd~LwHl7Cx~!5
z{_iE6j{oU|)A2u>a610W^$++-$A2>%bb!<G--2*D{>$gDgFGGo<@3CO)A3)fqkz-#
zUp~(pI353|61%qIm`qCvx06t8GYRiVxEcpd&~Hz;yx$49BjFk%--+<4ggX(wmvA|T
z!(q8j1O0UTS2c_n5gh3?L~J9&m2H6h6zLlqscPus73rmFI3yxM)iB&Q$g3ex@hLLg
z%RAB|I5a9GGQuM?#3S4{!dFO#hk`sPvuW7!pSw0xL3Ch<uScX;#4r!<a9^)TUp>cy
ze7!>QKP2ttx%5Y)myb`luV4Pzgp(fLp~1mkAwDW4lt20W#j&8kA>m%(BSbjEqXNTy
zh0vd%|44!sDH#?X8Xf2ZlDd-lBSh8d6#`9uQ6b)ufual}f<hxjF*7~?5b=%m^%kY>
zqo=??);A>DBibuGUp-K7fxh|M2=<Eg@Cyx(@EYc;r_4cnuy1f^_z3;Q;u9D#O#e~u
zP*HFC5BrBj{U1kViT`)qL<R=?igNfrYELH-5$P2UZ8o1a1fl9=M5*LklFGrr|D&Wt
zq@hva-v3v;kzW4#&3lV(;jg!>MI-m{6Fny?Tu)Q*4)FCBy(=^%A}}J-H^f^{okfO=
z)+a1^#CS!DEIuBgQITO$&<yh{7O)x^B97}ntmM~!T$kO$FEB`t-(W(~@gG8pqNwno
z|FShC%FoYN^oRd5Adld{kU-stq+bv^UzDz=iegnpM}0b>X?X{Dgn4-n^YZ^cA`J@-
z@eT<6Z#mJa1H(f@f_+2u6g@Q9h!C%^h=5QrqUcIDpK&AtsyHeLN+X}6Vc~(H;enBQ
zT8ggshlT`3hK6GW<zG_Xp<zNpKI%n>hzio<zK?H^FU$fg8;qg<*Kn=tK>6j#>pS@z
z49tJ5j)?RT?Ji#zd}9N_4;Xdx(I?}|=MYRqVWBX{<a00}G$Jy@D_BqKfY5_sxc1J!
znBn+;4Kb0>u_Hr0#B>}OB8M7fiq@}GG+ll3u~0Qs42StOdN>pjs%JQa8O|eb>hkal
z4-NjOPpovHspZXz`tm6&4ey9ZSZBZx?&CWo%3lmmexYL3qWkPMWJtJg^gj*<g?a~x
z0a1=`C>QP(;-5EAD=a+3|KEZ^V%Z{<i$awj0YgBlhR|4beKaIA(zl^gx84mzae9jx
zQMd0O64g*F1;Tv8^E#PtfG7@V1pnV8IA?=XM_hj9DYeb}^v@3<OB0-90mIXuyhFBm
zpZ@uQ=dU9U!}<UJ+x#{nFX+_ge{XS&CVH+8+)BLQRLNGnXbPCE?0F)bDz+d8zCx1c
z%-zLjuuspK;CK?ei4+P8Xp&@pSq_86vHbEE#sZnh^2>a38;<#T{E2w}B>(?Py1?TP
z76<Z+{|v^z9SuSJ;Jfr+#y?Xq5aIUI5L^+*XyW#@;$VLEW9KTlJTWuahwDDv{szJF
zv!9ITH3u-i+;IDA#DV<m-$wg6m=Wy5btG>8gkbsE_e4Q@4Fyzj`$q)J&;FTtApNJE
zfql3x#qDPbmY@AN6r|_oLiAtu?+TWm{Y<oP4Vgp&``|mb|5LF1?5Ck1HbWt$Bp!cl
zkvYHomoa}InNd&v>LPP~{+rELGI(M>@E@+PasRvMv2R^O$@pLXhv~^L|L+BSqlw2q
zS5JOdv`?>Tf*zh9?gJ5j|LT99n7=DEo=^V$B6EJ_7l!4Ri20%XpwIL2yQ|0kcC=5g
zv4Se@|5rWv(=b21R+?Y_Dq?)hFaAu-Pp^sPmmjW!<`=*G;d(jFLHuwXlgHmqk9{+|
zNc~^-Tk5f2egSy<&;AeBMY;U}dhFZ&kM`a5*tgEdzB(WKBlXx1`ycH`>9McL$9|1`
z>?i55pN#h7MIM@X`<tuBz9-sG!^}|s7UIRr|Ck>8*4S~~Fu&Yz`-k+{S1(j@XfPw#
zuPt8O{!=~n6Vbjq=9e38AMS6+ul)z)W8X3#`^I9Ol3)MJ`5)siDDvlLe|tXm>*Zq~
z?t943zAJv|Q&t9!TOL2$?~q^qFw8&xKk|3f<9{ytpMv?J{@}VjufL&s?8`5w{%ijB
z)nh*y7ogU}K70?r?N8BTU;h3@N6arby!_(z*uRYSHN-xw)w%r*dh93S#8F)u#x1wM
zMvwjSi<AsBe)#@^+drqrej3`Bzbhf#;Py}Iv9Ce<bo~t9hj9Dv_1MpW#hyqp$|mof
z+lTL+^6Njji<K;~m~*Pwwh%9FznaLLZ~MnDJNICIx#9LJiv0Q64_l(-NW+X^AHJ{Q
z_S@^RZ;giDVSc&c_FL((Z@pB>VGO~E1oqpA7q>rHkA1Z{<Wi}+D4V=@Zoi)%`z@C#
zSu~gv?8Em-+<v?s`(gj1{V{s%$K_)mzMtau;rR#o)xW&2;lJWvrN{o6eC*rhWB;5U
z`||%7T}2+6c=?~yW8ZAKl8ctVy+Azv96k2s|3CiM{QXLg{k~}56P=$bwvPGOuOLn^
z@-2T{_^!wNa>L^<E%FN&RJKw8w|mh(ZU0W<7?0mUkNq$>SrUn#*K_+F^w>{Zq2#CQ
zXJ>)9efYjOzxd<+NBjPI?BCAEKD1?Sf1V!uiT|VhS$gc}<YT{UKKA$Nv7e0g`zXbj
z_s+{dRgZn+WF-q7|KVB{kN>V7`|_U>p>5H`?SIpg->kHf>%ZDhB_WVs{i`wmAZlEE
z=Jv~q{Q0&2xMU@xr?SzF|GmU#9>2XF`*CRBQ>>3^;`ZC?v7ec&<dXNhPZhgxEt1>s
ztH*vOE?ff?HF@vceypDSuH}?0-cYzC@%#~b{6Di=$+Q>a2mkwu7x#ab9{Xw7@kR6a
zN8<K3>B)cjf6RYePyWpRF@L6>{5hCkEU*5Nxc^`E<d-+k%JPy*cz$@EO@8g)3@;qw
zWlWj<U+v#oPk#0Pn7@mj{MMNNzx)r-li&7#%s)*}epk%@^gr6~B#}Sg{=ZHsGF#Gq
zy#<o-VD+jt>alNINy$GpujG{vy#Chev7eTr$R}d{sbcFZUfe$Xj(L9dpN971Fu&Yz
z`)Bmncio`mNW+X^-(S4AefZsSu+N4$l`UNC5^0{Y$$MAleNsNW(PQ6iqjH?aA1DyF
z{~PU#ZuF0oiT3d{JntBf|GOUh$!K5JGsHhkytw_U0_0czIcVR24FKGJ1(83$_O}=9
zC*uGJ_Ji}W-%5{tm0Adkv=N*miQ8|g$9~`KN+vr0gbF0YbxD>B{JwjB@o%rL$T^|B
z+;ICn^w_uEspRm)j8nySxOj2<ll9n_H)*09sO8`D|9Cz2lhMA66YNLiV}Bpo=hvAn
zYbYkw$|mn!i0hKv!t=9qRU`o(*I<6xj}hm^FZWN0eEGH?^gnH`A~{uTqQy&^k#XG;
zAV2%^_rBr!CQUNGWH0sPPqtMgvRTLE`JV}ppZ~E=I<HigcpYP^P&Y!nWPa)YZvpc2
ze=0V-<BA)3?=rsx-v!9eelq?LMS1jps>m=(ykvf9zm)i%AV2%A8pT3}G=y83U*ZxX
ze}4A&4p8EU^%*3vKSsP{erexQk9})r$R&OcPG(Sc^YY`as-_<M*7%RlDdIRJus=?`
zq&jK8DcZM|2S8Y)>>kQ?6JCc<_WtBoq7(PL>dBu3ldVWSrJ%B#XJ6v(GCv-do0mSy
zCrb%%EAz>1U(C<MR3%}u%_qrx@=$=tFQ$-x&41-FzqJ&^Eh{Ef9NK5yOr^p6IiQ>*
zo`00cpI`gAEg$Ga+RtR6N9LFH2k~&*V6G)hHX<40I!Y@(C&4~Ikz{^h{$KZAz;RnJ
zCXz)lWh>u#`9bqwQ>0Gx_HadV8W<pn=hxl-3b&s%3~i(q$)-hf>t?N*G-+(3RyS^H
z)4XvD<=w{Gx_Q&4YIW1*HjS-8Q0-ZCoTE#p0tSCH8i+fy|LpxSYPtH)XItGzTa|;j
zn>x?7hjKSrYjv2o`$yc3<Ljdi7I&Tnh6VXH@C*0#Rfqbi!N=C>S}=$FJD)DUxMNBj
zSBHkE#offd;o=rbU$r;f@2rjt4IL)(HneUM<R=v9ZbZ~61bHD6<P%aSQa!|1?d2_Q
z|BUeUQ4IZ4F2*ZDEpFru^a~X34H==12o3fP4e?b6hNvS0eAU5$K0ZM@Phl@6G<=v}
zP-skbbszD`H(X@(8ljGg@Kp;1I_DzQ(E^LRh=s>~It{v7C@SI$9_AAmu2$};RM)Pp
z7Pls<WBr67aUZ9;fju74D~I<mHWb+!`j7mR0aPhU8x08zX(a9=7584j-N(8r5pTUZ
z_4ROY?%574!>(grx1M(PZXVscx%6viqi)zpDv$7sRW)ef6%`rKE;7)2n6GfGf$|{&
zK|}9=!0<58t^431?tg>gR{j(de?)XHXeRwOoj6N;v~%yJ(f-g(cx{~E<fBO_14n<K
z`Q5R!*2!l=u0dqCNonKSn@&m>ctQt*NPkVjDBIsUDe=iH?^F4_Pc8A2_M!5@CQUQp
zgz*5o!N*Oj*{U=N<21r{<SWf-dyUSPPS>jp(`s?BYm+9#98{_=PKE^{=jJIjbJm_x
zc9eIQx;e2vex~ozK4?tqrD+m+nQ3M;gZ!E!@DB6bUg#blOb6>0rAn?B9e)4*?WfbP
zN$4Z92nX{rp`7NAoc7p+Oari_x$;s|<QUjH_QAAo+N)_gJMzu0kDs$?$Rj&<XYCie
z-p<+^c5cqv^xhinuOk6Mrk5z-mVTxoI%j-b657_X6x2mK+QQP&Mz|E>Vi6|Z-7I2F
z>sna&nGQMXXJ;C6MtnHuXBwK}XBu?dwC+F)Ebo2AMP`lmv_^Z}MVtFkvq>}QO{9rN
z`%ZCRqdh4ySqU|vkrrke?JzS@*nPoM7p=GYw7qVeKW*;{#MFG4t*LpFu9M!FPCO&_
zoo9@;Fu*d_K6cT*)oATo3R9>#!M<h3Q-*3$jk-t@RFl$7Cv6b<x=#8M*~LZsReE4w
z9z{;u>mGCc+tx&r;9z0tqp5GGi`{h6WsyxZ4Wa$^fI)Tx?FQKmw(}6RA1Am<bK1c|
z4Id_qGBJqpn$X4|GEy@m(n76~?MgUSzU!o?Q42w@!1n4_)BPHnR+|X9q=O>xmawaH
zbYdS-t)$fo1uxtM(zVNf>3+3J;Xyi^8tq#W+N89oiGuvYmlvTzl_CT7wYkvDi_0G6
z<nz0u*>T;#+Ne>j2=S+i^bHPEiI1>tAa1?%3ThxI-jJ;ufK*D?Rmp)s8D;WzVO(ew
zDU`&9`*?>zZ^y149vT{{>f6k^l}GPhjy*kGdv@>JPvzFtRSY;_FjgFi3iF7n6{Qk4
zT*i(NyLlfPhWQ4gS@HiWLd`!$4`tM0LkX0x3R*fea${LaFEumT!2!`mHQG})X_7w_
ztrI_sVL_wK9xw>jy`mF};xg1EIJJabvai<dYsSCcE3g=$l;)$+PP9nT$-$^p*HPq8
zPzY&ZhGGbC(57j|pMbo|_@ixWp-G4lec#Q(O!r_JbSA;XVp5u&Ry60?LROPtXQ@eW
zvk1_LsxAdB%vPiAVX4vDsb9_2wTo7lqiRBfuBFO>Z@X+oSDF~DYhNJS%1&)M(O>K)
z*m*)1@em&!v<?=c6ZD|t4lIXYu+nHvEdDs+AQYSYw)1>pDY7Z!m2xma4z9x6ya6vy
z2dLH_l|^l*8vtKC`&;PHjj=jY@(rrW(dMioWOKHs%~f}sFX+L96XlQR9ft*1e#f;r
zy+nRZLU*+&&hi@VwV^7Tt3y?Gx{IiP1`KWAzWw_RI4(Lm+AFBj2f{XAu!#)C0Y?l5
z<#m-UM0)E+Oi|rdy3s<T4YClW|4XBNqS0odpW4T$Kvcf$o<j@dMK#pG=B&<2-sq*h
z2XzW#P-&gksKPM*hz9uY0?P9jO1Fnb``+eDPmT6F8YBfJ4nqR@31<zQwcqS?|NbYk
zd==)uh=TpMu#ks2;umVObF<T4@2&kz`i~fRMd8j+=2_@LasU>6#zFf?`%(-&*Z`EV
z^LH(s8+mVb?lx)8+P|fR-gYn}*=axZ?j;NF<R7KlccPan+(r9EsLr#kKnLv$2T|C}
zq}^a*^#AvG`Z#J&+qv6mFXHSf8i;P$QeHFZi|NGqB5-HzCuj&V=6vFu0rRHlYoa_a
z<`u47rkr)rKG%h)D|98dm=+^Vbdw-T{h4D$TXoQWbI^YHcd^)cC<UX;A86CXLJW47
z(5Xpjk<ovOKLL(S60V;#o%ol|K>=*89)<<XAA{O=&e{_)s0Vp1Uy?u7DJDgYPNnv^
z>BQEe_rEAE-f&(;ab;}I8;P-@;fO6<F?GBQWqDKkQps=_x`A-;pH7RBZDMz!TciEI
z{1N5-Vy75|goZ!Kt`97gL}fZ^FW9*`YES4oyeNjNrW2<MG123kwYTILr~NLxQM{A!
zip3AkBYBP0Mbtg%E3hOHl?UxvW|9jeT`$VNP5-I9IPg~Zq3ia|VCP>>kn+$Te>D?i
zFeMb0Bbfrk#AZf`t?BMB<1faED%QqW<AJz|4eg-LA<1p~8vopnUAm>;m@u~+WyZy{
zSaRRu$J@8(Lz-vYw+K3{t~SxCNRdZ1hub6>nYkp|US6dx-=j-s=QLyEzIK5(Y)bpZ
zmF>U2<${Z;1*11!uG`>Z%C25-uFr~IH!gMege{NHq+U!3_J1Alu2t6IuW!%aEq*)t
z_uf(CvR*BV5a_|4Hb?qj8(pzjz~d&BCMPd=a{S}ZGw<SCou4vd(3EyrRjZBO_59o0
zsuiv!KHV}a$grEL)zYfR+67EDywkbTmT&i-8Wz3#`rwfT-I5|6j^EpET+5IR->UX_
zUbxJnZFPdauXbMYci+*gn{}8IH)25C<(T?G7r&l+^KGZ|sIiBOK0jJwZsL*6xho!T
zGJO8%=lcdO*V<|xo*m!t=+>)7M~xGwb?ATap_{3RQ$52vw?iA1x>{^x!o$?(zfM&c
z<rROa=(kpF6AOE`HmU2L)biQ<S@o<M4fTH>QLMh1p|M*H<5HS3ZR^-p7+=q@Zh;%d
zFN<7PYf7cq7hGnzuG|)Lj|v5vn0+!&ak|_+*}S+(t#_3()|6>py>IuWeuhhmq^fUs
zR?qNUYFj^kjNu)#$`+SrddAxpj`ucfZQj<|vugY`!{;?ycJZtp|Iu*2S=;W(m5w$l
z;$wEOlc#z7!&2FHIsOF_%m>!KT*)xUVEkdrpi4)>eiU7(zFdB#Z=t<*CGYnQD}7b7
z>RGMzlYA;%i|;U@w85?lNd_HCH@R<`F{tzbtLL7VY#LW?*K*|W^wn<lHs&nfIe*y8
z4_ntwUfsQ(q5p%~1I9ZPY&m(j%cG=~bqcpRl+!dY;OL{e%dN^ZeqcUeW!C8Bz1)g^
z9&yCGSc4x=D?T}D<FR;e#*bCOL*BH1m^F2~i*{$#(@keCE8S}5n3i9jw4C^4WaSo5
z_V#Z5zRb3V{;h^*FMYSMO~;{5hi3H~I`V_*+|hNaAG-P@zI$}ag^@4Uj?Sq3X`^LZ
zr}&qao5QM(Uu>DQYWK=p3)1`w6}evMb=6hfoow4VtQfzqOFM^cjgmq?n;lx2nRvtg
z)2X=o_Mg@TbXl2U|7nqN%9QL2-!7YPn3BD7&PPN4skX(!1qw7=lDhwV`wWvyjUN<<
zPP{ar*!N~l93GV2(4evX(}>HnY{P?&52_g2XVv2>o!t(WGH^VZ<v6R%q8{%HomrWZ
z+p$)?2W8@>^mIFT;ET=5ok_N}Kh@k;p@zrAxQ<V6)l4=UVOpT*?1!#KwYmk*`C8U~
z+Bj`mxp~Xa{s^m;;{TzRadfG^{f*xwRkZY&99PluNZtJ_&jckOtX6JOMaycIlbWqD
zI@f1N*mc`)7XlUwnMs+a4UNoQTRhujK2W{g$Y7Uy`-z#31%{csu6VXb9XmfQ*ek_h
z=>DJ4Pk$~*8)<lb{5PZNQ(9XeDOhD~iS!mVlEqtf@%HXfSm*O%<7m;w`eD2#+OvIp
zip#1kQ+t*Sws&iECE6iS8?AmhFQ9UdPOE;He|AnS)#Hf60kh)HpH!!I4_?)7YV$6s
z<*vAEtDb1$J8;#u8h7ekv7cI^b859K6CF&it*m>+Zs6@YwMLe{(yL^<nc1l=6UNRD
zt!f`p)VEKO$u;h#&nf1ZaO%+#+ad+(?Q=D;i;FBf`SGOzt+jn)R<51vVEe1K+swFW
zHg4mS7ueQ{PrW%aWn+Q1*(t>e7kf~4?$hks%^Pg~;nlEtk&t24rUe$fS76wN29x)F
zz0q-J%!ih#lQ)=J41Vz|-CYx$)bZ&34c|;c`&(wWKbYOjwtG^sPlw(%nbBg@9^>eo
z9T};0ruQ2VA09P5b?mwRgI5n4*RRQs)GKAa&-H6=vwF$#&$Dk{IFlVV&Z^FK&F>9<
z(M?wu{!w#F%J71V*M0G`y7BN<`WL^=)}!4=HTizrsL9<W!-qLHYSL!$dq>0TC#FXk
zr-WAcI<KSQlm6`nPN-&lZdp#ivhrhEZS8EZWnFIRC)P6_ZONUU_~mFqk)nYg6Tg<~
zo;$s6`M{51DQ{bJwX0G1;iu$N567F_PcM97z%YjgqpUilEQxHo)$+jw*S~uADdSx9
zZHJy4$2-RDb7(RDyv?R#dsGHS4UFqfIkvoJ>GSOeO}4xFW##p=HR_gWchNer)Vg`@
z2KLUI#;Qh^O!vO~OFjI`=zvn%dG0kTIG*d+a$I4Du-IxV3Y;FBGq%gr)vo3-#^zm|
zZho@b98mLXQTImMJs-Czc6{Ql@Y%O26y5x!c7+>{Zv+gVx1_$~sr@~^Z1**}<#=V<
zkMTdpWFEf|AKfrq`=XpnnUXFRJw6vd-?pLl$iOLsr!AQ?`mwj?)+?KP+c#cu#`J81
zo6o&#%)GY5s`0ZHZLZXxSZ|7BOmKW#&k4CD+g$AbquDd>H0yJpGKyaCUv#@$?N0p`
zyCmis*KeP-^W>ogxxFmfAG_oBen3CNCVj___19KwlDuh^L&Epb&acjP9I(Fsw0o^~
z*k69zE3oHV?eP%}@4Wa}bW7>UQ6{tcd@NPvT8Mw_q9z>{91EP?<zd+ar*0<?dOLkf
z&!cf)OIPv<TASP7cUZ?}?VT1cuQJWi@=1)vn9?pIzQh;5k=c2{?q@5zJgu<tXVsJa
z5B6U(-K(ANI_G!wO3e@PiHe#!aL_B057nPU7zS=BZCJNj*HO!dzx`G$e13+u`|9ux
zjji6?d1x}=rFgrW4R6oHTbsvs9<JT`YtZw14;z<1Y(D#OyUn&`JXDAK&wg_Gc*#9Q
zU&QV`@!ZO)Pg?TNkb)bEPBIU5vzt<&XnK*#<=qX-8Rn+MULD+WPra(cgKwx_$CY{b
zD0yG~A*C{wI^SG4cjSYWA4h!*u9IBoPIzdolN-wQ*pgn>)I2b-UBQx<?v0odlXdUG
zmXg|6R?{Ck+?!;O^}xxz&6UDCPMY56RjKzTudlr~WsRKjv*6r~SqlQbyc}V%c$blT
z&*CPnCj4#psbc(Co0laj&U<)%<<ec}_PZv}E-`p_->27_Ca3#U-nj9{{x>n9S5Nqr
zS?V+A+PRKtN52hha^)}gVM}-Izcc!~c3o1+QLm%#!g_laKX9e@_-3!W?JD57>&CO}
zb!KN?)oL}jQuBo;moAy_8_}!w#Ncx~95)3d82Ka(_fPuT-)n2blh#lA9h>f7q)Gd_
z=`#j24|MLcy6%d{>JiNrG>PoH=*WqC-wY~ze`gihcjKb97kfP#=dtnezzPO0hisVE
z@4&DP(=r<0>RD!I*SU>rw07)ta8PUCP7de(eptaga&oKtML#w$j&RAz+HlcGv;I<4
zP@xQ?KG}A=dlkRm_+xmjPIebJ4+#ufpWUuho$xl^!yd)WFY$d@iROJvjBU`c+LKG+
z)4un+)uTo5uJeu^etd9i*!sI!>y4FvWxlTbXmj7l28NASv}{{tXWJ^>rrvE`G`)9~
z;K`4Ag>5M6x1vJMxkv3HqZ?H{QPsayzi!9cB-HU*H-2Zz;!^$gXO(DMs&^0L5KFJq
zYpnhbns&N%(M^sQ0xLBA>@{;tY^&<_-wIC*|6Imx`OS4(AC#H$tL*u|lUt4}b^Ol!
zkohyN)jxmZnajQPgDNaq|8(f*>@RInk2v<;^}23L+Xtx|9~^v@Q`>h$!94~(2k&lf
zzf?13=vec><Gt&7TA$z1vhu!p$7dfn_pD~aU3)9<OTGT=%-R{hC)M29+o|FA>kHRa
zebs!_!2(~ihU|QqRU_iVUq8pDc3k(ZSoK){FI7hdcQ?uGGWN#H&((TosK$-)Y&5C<
zq?en24qakXe~qgCyt^;_;`TJL-ZuEriAf>Og?1Et^y^3F+~KL6+B|yn>wba4ktf@i
zKO5}X^K9m{cBNcLC4ReQ)#iP%N1ZQh|Kc)Xw7tWl^;Nd5*qt-Q;%DThdZW{~eVN>_
zOYV~S;Rj|l+i){%?U85Mbu_JCsQa0xH7Y&xaJaflgKLMb55Lv?-O<(03$%TE=6=$%
z+CIyszIb1v*}5_%yzYA!UEzE-$$iZr?cpJRElIuDb$?b$!l&f#U%IV%^3ra~udH?D
zug}g(ba<0xUTEW#T?S4Aj`m6E+u1L7ca7W)Miuw%n!0VO<IitRpS?EPdgxS6uZz_p
zc6Knkvmzzv^u{Brx<9@>E$2u2=F)!^ToT;+VCJWF_gZYI{nz+C&fi1)u4Ng2e>>05
zqxFd;lds(|->}Om;&3P54buW!eK($WIJ@SxmxJmLuxxqb?y1ztN&D>=1m=#JYWTI!
zS*ro%A2e=t>p&HYF5imZI9qIVN&oQoS-u6D42vl9_vwwzuXhZ|+<Wb?yYKu9yV`Cm
zY;<W`g$cf&;>S02Rlgb@-@)bP;;RW4oVN^H^{eoMwAB9pJRj(;T>Z&AUx-~A-0O||
zHCwYo*CMO8Ztm)?sd;jTaf7jCHub2xp-}w}XFM*w=;3j!a8Bh%l|4Fp9E%CB6S(;P
z9gmEA%i2WvzqNW65E;_OcJ(Cn{><s8m%fTHitkk{^3BQ-_8neyn`<<$V@QWeqq<pb
zf6=3iSv><2-_D7hevT?z@N0-VFz$zM`?yWk(Z{L=jqhq1IH2p|#!LLRCfuuCvd|Tq
zr1g~@(rzX;oa-BJH|JIJH$j7=##)rzduZ>om*G9r-Yj18cbzv@&gW_c)^9rSO_tYw
zqkA_>JEX78blp4Z#p2peA}_?XcKO)X(s^2sLhUzpKJe++g1DJ|2CeV6(?-)dqp<zv
znX1^=UxzGvH)2Sf{rjwPwT8@of8%cU>c|<%bq;r~6m7Mu&e^Y;?EC4emM_Ykzt*VJ
znx*E&QybK{(@pzf$fe~KD~<H4H0pV!o?kxSdwx1$ZRhcWZ??V=vh~2^xRo1E$F6h#
z5!<`QjP#$yPfd2nNa<Q<_VeUD50{({zO(z_t%Rsz<6A`AY+02WnsB7+vKb58kB?bg
z_V7;Qksb$^mkoP6rSpsTSIhPO5&kIVWr%OIZOvbc{!WjrI__EM%Pu{<j+LEn{q39e
znrTa39e+IbT(r@`z<qU#4cm6l>Cv{ooz~UMNZ)qa_fYpup{uPT22~0!{Lysd@93@M
z{ICXoXDQDYW0ziV@2YX@QGU$BF)?oSeh-^&<KJnrNsox3O^lk=-_X_MV$;>DbLUPq
zYyGQnA@jbeDN|SZRWDg<ZfdW<)w_D_)OHM;osfJe;Z6ky!{FEVMy+_VWW>7$6CS)g
zH0si~!yhlkyo=cuvu)kJ)W*SCbu&ghs<^&oR+*n=PVQX%&Bm^qYy1l1Uh}5-8>cxe
zxOBO(SJ<NPiH|Ce>G7nS!JWj_4P0z$+72{~wJ$%qW`PsY1xj05Uzu>myz<KG?Q6W~
zVK=Tp$s_IuQwlbUyFA|CVZzS}&VDY|Sq`UKSqENr4o#ZVwypE^OLbnX)qLvter~+!
zN#_ko-<N$m)V8f-)3o)59d;jo*DUwYv<{x9qk5E!aZFkAaP5?dU#EPUmolJc{T(Jd
zeXB&yj9J>LLCAwu4Y%ajc+Dy}ylsIXpDUJ+Y8>*-9edt=QN_N#=UW>s_`EcvfnSfk
zWv_32X7sb)ny4P9qxN5N^Ln?_$z*@k>Q?LeWTb9AwcdO|p(;ho#GhQ*@6j!*1{G^9
zn7w-H(raBi^_yx_b#b{e%hwk&@NoT^l)23~tB>Kszb;pw*LdRErW4nusxyr`1U~J)
z@uz*a(f#6wmwr_#SUV*6O1sJ19tI6a+J2#Gw&k)0JB>azYnOAtzx3K~-8vNdRrtqA
zpE4iY>^fn&QQNPC=l2r*>O4JH<aw#ZelM+`v@#r3qFK*-U#i`UP95XAdt0&IFJ3kr
zXkL4Ixf@@XpX{)rt9tCJ17YGBhpX>ZI=XnOMdnV!=U;>WT5ObiHEd$Zn=guLHkNlh
z<aD}9t#9hHEvCC1_de6A`CH4gQvx3v{~hXMGRNX_qMKFrnq}>-z7y;8H{0iaueN_r
zwK-pYTp9bbtDkf26L!X}vkSY_c-(yINXrdhcczahWL~fQ&SOo_T<<*SR;u@meuH10
zT3BgKG4*`UQ9~}jtybz@CEHxvofG!=PuVno(4h>wK~=J&3|4mQ_`2;zqa&@=sTxiC
z&38rtfqSPO8+dTd{wHfw2Nw7?qhIL#aWgWT?rx*mHu2NB+Vj?LxNo<=($)J;Jr1mX
z^L_rd#jW}+YPP8G*|uY+_!Lfj9p|)HT|GKuXyTSrH3ue|z1sh~MUm(g@ne!Q4|jVO
z;a{!&_vX%*4lc=D^67NTEq`AwIoH06)#=K6u2s!Fkkx$ump3K_Hh0f4Ib=3tPMKC0
zw)Pnw)2@H@`ZHZGG+9w+$HD$vKOFyXd~v7dE1O%*+}-Oy&uNt=%(~cbQTV!&>E|~7
z3>*}6qEzLtKZ~?`KJ&<;_#Yc)nGDLQIiShK`^~;2ExEX_K;*pj?X8=xGA&xA+2!50
zW|fY1dU>ejfrs@Y(`~;FnC-lLPQAHh3-`>n8M^h>7t_ex<Z(5uzI0Em-tBPl#n(Sh
z?w9$Yz{oP$n*w)LzFOhvh077ci;d~l>Yh)S{keAw!w)>KbEreXYYjW}?sKGV<)NuZ
zJ`L@Wcjo|Haf0+`yx8RB<LNm>Wl+M%Co_HOG2cwzj?WTShF1u>lH1lWH~V>g>&&cI
ztKT=fl3UC0>5a>|UI9OY3VfJy<=&_=U6)swacSDAEbp`us?zHUZ6bQ*Gb8`lDF$|Y
zGd)!X?naiLUY<kDTi8B#`m3qUMPG-q!#(TXo>@bEw8r|W>88Gm(sD~XPHLR6yQ)KC
zmD;gMMJ~Sf9pB_+rqzI!35AOlbKX;+?1J`7*B0@g?`hs^!p>uvn}e)|Oj-0Oebe-?
z+8q<iTzu@UQf=OA+U8H3P4M1~KmM%k-8I0wcj>WN555k1*yXOz;w7n<E=E@LaqUri
zc)PBTN6zUMb0>9B`mq;Xh7Pw0c4!eFZC0lAl4;56D2FibL3>M9@o_MFdG5Y?Z>edO
zhF_a>EU0bP;ZG;Kd3dGm+1nv&Y}SFSuZR0*kH{(TuFj>8Q?tj8?O1!xvQp_4-c9d*
zWof<i<@08@NwhnkxqiT!`knW*OsG&N%4x!il?jD?)Q#LuPZ>Eg*~-)SQ~T5x<I`I`
zEoXh#VQi_Lm(=4XoxD)e#6I<km;c`Wl`mF0UB`P__ix9Ot_*9VZrA5cX8iimS2vAu
z*b#8F#ip{plYcySUpRZ7YRcY)LlzvF+OO5SAz$jft2k(BOwRHRoBXb1w=WdqV1Bsj
z-9A~Z4C>tfcCu#s>G1{uFI4AJMkGwFwJ{;P_=6TM_nW@A=(6tF#S%qhW{)cI<lxcb
z?L&_jy>oBJnSG9<S{@0q@wY0v<lx}#?lV7c3QvxRD%U<Z+NS!)KIKcjY_=e^a8l%*
zYWvkIXI&mWdH9sUcG|2}wlNd^_D?D{+HP!@hELX}G;39<`R#3eHkHi$+%9Wh^Ma?J
zFNtbfWApRY>tY)gxzVou;pS}zFIW=4AZ4rh`E%tDoLv)I;=-YJjXh^wY27w#!(T;;
z-@ZJrndOJE2II{a`?`D_SoT|t_Vb!zYtlCiJm|D__ZgQ0#Sh08DwlDz$nfn)yM#As
zlaf8}rPHeZ;kyE2Y%(VNIx%U&>WuL(y*^9}THE(cbS?Ye2~S^Mb}{Jw*S7Nw!&8$C
zetmzmGDe%Q=~9cr&B`5j^>`guv1Des>rdQ1l$r84_~g+B&NnJY4p~uf-S4q8axK<B
z>@oa)%$8$wQb$>&tSyw3)v9p)r8YA!muz%*tIOz%@lSKLYx-8}^7wwH^P8PTrW~JF
zd6DO=O-G|<UTHC*{H7hHBdu-+uWs1y{je3qr|$^={KK-3*N?$fuJ>+P==&2d+i^2(
zn*?88m=u`$rIp{HK7+2huDo5#W~=Yow`bN44qxH4*SKhjCJpyBS~Rs*sanIjreAVD
zI=gUs$kcC9X<M65=vM3atv%Pr-D{b$`+LUBgReYqmZ|>nYTJ%)Pj{`l=|+>$53ATX
zolkDy(BZ(stO0dDk9VtoY*X^_&TFUTgpcn0`^oIFhmH16A8p_FL(Gs{_1{*nq+Yym
zP^0%{B2NTmM6USVJz{M67ZW_(e8)P>uC#qc|C*+^f&<R~N{%0PJjS=e%OCgWE!{G#
z$boskPF4M||5fWBSJuoP+chfum|x_gy*--mepR5+f!f+x9*uLI%CA_sBHp~<x)Td5
zo|P>3y2i-+hs=wtK5Xtbu!qB-(!2Y*Mpy?wJ>uPCq+?b43M>3Fc77=BZXVgA|Ks4A
zf%R_%H9j-Tq1=lTlOB(3vf6NLrIVY>NA|m0uIQ15#|Q7fV|P8G`?hygcbrI#a(K9R
z*>2ZrOUqo?*d=<^<`$+sJGc0Bt=JRq2Pa&k&RsrI(mo=viQnhP1(TwUo>x0M&&E6V
zcejFtbIW~QaH70!7|k0;N8ta^{25=y^c@tjS}Y^FpRIQ0=IaLs1~fDMn0DJ@<zw5T
zuYEqOnPazmgK9{vM=ihJdf2{X`JCA2XPe(V-D5@jG5sr_@AP3%Kj#N8roEZh{PCdX
zZTk%JUi4SnJ-!z{+^g5S!h<N^qY(`z%}<~Ad+xm*PevS`z2Mfyv<~h8=c5Nr*thY~
zx}G<4cDyk8b#l**HeEk^^!_`fe01VZ`xh}AiZ86QD8~ImXU{kfZN#<E+TGWV3TP9t
z?{IH-xAqn5ryoe@)ZA%o>BSYUlpYZEcvtCl*LHX&cvg8(=S3w`_f3W!R#`mnezx(`
z?nh07_MEPJ|Ix742a8?$6|`~32>(VsDu0MdZ1>^w-H0=Nu6%8p*7H@)ixHEeDs-JQ
z_WB^REzJYZ%#HorX}fB-`L_K*oy*n#Vb=TPeX9X`95;+|C~;=O1g|>hiVm;2!~J%_
zoh!EZEGss7Sn}GgBO+4<L{|$9DeH0M!Ow4BtBw2n{j=x0%eL+?dYIeRisL<Y4|}?2
zf_1eW8$&|Aw%Bvlqs5+6Wgmv8@4Mfx!Lv6#YGhQ5ePVDk{bA^UEt^M8UD>}`((Yl`
zg9r2*U13Mqur)uL#(t^X;QJG&O^N=);*PC29$Vq$*S|+p^jmV{`}BdiHT!$i8Q->w
zgMYxF=B}O&ze7qjvTiXj_qyZz|A)Qz4vS(58h)3ghzgi7FCsxj1WcG&U|~^`fEihk
zEFwryR163Rh+xjBnDCf$P6!6fIVX;aiaBSGw`-<)Y1_qfzW4p^^V~mfKP)rz>*}iR
z>YkpS*u6GSnLA4(Vz<YN*QU>xhGeD3?2$P|7`CaepI})vBC*f#9p{%yc1=GXn6la;
z=XSHx?UuK%oc6Hl!_{%8jRrWcDbQ-|-p@T~Z1v^sbGoD&uFnsQy8pSR-s>DK<AXU%
z9M;cWx8m~BC5`GB`**lBxbdvXUgoVn-`T3X^v&w4P2L61Q&&#~r`+g0x3}BcZBb#F
zeQM^meB`*|n^9$rnAM(F!=7$6x)?KKe`;C7^S4Kagq)guO}gvk0E2B0wpxxEcO#;Y
z&z!R#54&u2t!Etj&2X6QlqD~!MN3;hdV1mIC2PNfZ(c1r8l?Ekb7-|Lj&<DjL<f(U
z)ih5h$uLjjP}|lo>yE15)>~^#%aJR`)V*ppe(J1ii61SeEHy8gQ$5h-TZ5O)UvAZ{
z8<8=sbkn=Gxt~pQbMqtf-%PVKlpnq`cbx5*M`nwRjJsK_xLnlhv5|T21AE`bdUv}N
z-RfCgi+6p!heXb3`eakj%t^IBUwXLGd-9Wvh!qZX*3QU#o^yXsK(!HX>x8}E-ejS|
zc-NgJb+*o|``~!m_U(ITyF5JA__EKN(~Ek(IPi7ZRo~Td0nal`!)GknIcL~MqrV-l
zA6aMNY}`H7Mrk%8(JHv@`wkPIcAmU*@n7c~4lVVyA6nh;_Q{o9YBf96Il9M!d*iNe
z&EHYY`9sXhmRma3@)~sIVdaFw+ud{1o{eAT|L)l9@7J#d97x>#e8j+iZn*}v>HYD2
z!-wy8oyp$R^kQ(_PsvS>N%1nD*PjnJXpz;s&R9Li4xcw0#chp07CA92{n6joPRkk_
zx-<zX{bu%c&AjTn7T5Atw(2(K(xua%I$yimBskf_&ZcWU?KR6=zZ(@%zd`OC^Z6;$
zE)My$G&SN$``%N%r`G#B>0I+Ola5<2xtzJ$T<2BGFAehhWhKOpbiRFCYi06ZvlZVO
z?lM_a7<eju%7+db<A=2iKl>;#dx6ufLAGJja=XN=9;7X8q+F)8@pI(N?vo>?=`{!#
zSufx2bmZ%~HFn+^)@xL-`RvgtI&XG3x%M~PdF)zAAG?d~TwPlfw|)Kn^~;raHw~5a
zyfEX~=W0vF4!l=#!7$bI$CgVsZ;ae`M;bXU|NOfADP3~XKHH~U|9Giq+nsGbO=!L0
z^__iQcXq}ODK(Y$TNwOschj5ouiQw#_qvm|{fL>}v|DV~I;)6WHK5dQuH55?UU0^Z
zgK3Qy&xkcVm-|nPp0iK=H88AJXWPqVvrav~-r=u#m8<63<!^Je%0Fn<|Des%clT#L
zae5Up-D<(=*;!+%{`}UvuHts{<8#*=uj}Jec;k)#*?{hgFMUgWd3BZPq(|pdG)`)*
z+UfPA=5C|E_L@HJe5_uRfR4pMRZc#?>~zPbQPs{lMT1}V3U8BcR(o*H7OiLNE}kCj
zzH@+Oq2;rPX>aV$PyE{boO6eFf0y~xba~eN#fj^YwvQVR?moq}rnBjXDe@EAS8fmJ
z+IqbH9i?-8)ZV?_dp&4xKILjdtE(#;TQvMSaZB#U0k7&ujJtF)w^QCog<1c@jWuUk
zCJef+>}BWkVcLX(BP)(MZJRgiW%r^XGTU7P4-c;<Pj<fh_?Z2jq@WsgYOmd%e)G;_
zvn!n*v>m+CFIZcrIKC`5V1#YK`jPt<tcY3era7U{yUByj+%O%y{;6Bh?U&M=njNPP
z+`Dg$RiHd3Xv5KXpWxWdt}j2iwhB2>`2LgK<&}pb8_(X7vm-oY^1x!#8Rs^J+jX#x
z@n8MwcDKwibBy&CcPVS1T&=^ihxaqQN{5{pliu}hm3h+=wAUTDwl;E&Ril3EC-z9`
z8}vOh@90ratqj*b-&cNpS?NLHCEcc>=Nk{dUu)Yg^R2Gq`X9XhJt|@U;+#c;I-G5)
zS9|EYZeMIZJnc6t+vH={?Yc+pueoY&sd8=bC9h_KJ)VT$t?a++>&AoQ-+p`TezWuP
zG0*00jOiWuyvI-Zk(b#{>v|3OVxHmmIoqsxx7m9`J{C9h3vBat+teqOJ{#XW+{8b-
z#plD5{c`tg>0|!0$;w05v=pnO@1E}L_jrnR>oKpaN10CQ_Txust55x`hK^{h-}Bka
zDmG($UPo@Lchq`D{R7ipAN;V^boU_BO)uq@mmS%2=<b+ilReM19ntQ2{L=+bYkkph
z>V5Zd-PnUIx-@jH^7))HxMh03p6~Q~Y}k3J%2B`g)+TYX+UI&G*56ut`skHfcjdkv
zH`IQmf49}?^i@UXgOf{ohHcvPyuIUyolXZwBsvV<{=QbzoVSq%qdq2$pY>`{7t7AC
z_I}(IZDaV!q~Y#Xu`QpUcz<`!*)}7J2PMQFOkG&Gv8%?_!_f_*i!ImB9+kdlX^FDQ
zfJcLLuSZQSFhBd_f??BkJJvh&|NCyII?DVH_YauqO@4YbD{Jfzn>qiuesZe1F4ID1
zL#rog3upEGIAKUqr<ZiR(n{;s@eFy+V8)%{Mbc_%-yEtu`?_MV+t@i76Bi}w)T*B`
zv)hkGb4Sj}@44=Bs|iMN!<srb5BGSI*P-DYlNjHn%5lY;#)i1*9X>iaP`71S;>ONb
z9hEV&!&+|b?LX_~#HC-Znk=gl{J}#byZ4PZdHK77;%@gd9o%VU*FKFy>O3wsZeAlG
zE!c18=7&qxeQw%5eZ$kKdsgr5cKO!V(i(>=*Bx&2<HqMDKRe9%KICWU{x4q#<+!fi
zJ1<~H-_0>K74IY?GM@xi_kNbX!|wL%&C_m-J+p1|g(`c!Ucdb@=}_Z-{x7YDIpjD0
zR@^CU`zl%embH4WTRQpvXbtD5+7lNPw(os)_N6?Z34N~QSH3mf>VfC1YiD(Qe2@OU
zZGMQYOQU&%sz&+y-n%u`s*j@SqG)SL^WhQ~N5{@m3-ZC+;K0`8^Uz@-(y*W)sZDz;
z8!PM9wk>cCJPVg;rQ`>X&5|!)lJ^)i3V>1nYv4A0g#d?>5{)t55{*PdjfT}K>rN-a
z?MNDYT~C}hu$R7Jj;2iCC`HRfU#dA+Pv1zUZ|I<}E3X=$uUm9hp)XC*%Fz_&81p4*
zAykKF`W*BPr)j$A8|7%p^`+U`a(#=bI!^l5lPkIE+oe=?(vQ)qr=h2BN03b4!a-l^
zpl?Ky5XA~%TJ=0oL;}9LEqpI(yNJYZ$&*}6)^vh=Iq6G>>l-=g8_M)`g?D;yqa1zT
z(U5GDhbV<W84R!C@l6QA{D?041sX|uP%feTQjC*=0MYHHZ{(;ibt4u;|JeT_zB!Qz
z!1y+pK1I_D@+kEc{0BJ|^<<!23zT!$H*(jP_7vi+3HuA<;~`!svrrdK`d;z+{d?&L
zc<X!ligiMC%EY|W`75Z-p87`4V42#a^9!1l+a%Q}mQARCs6P_=!aq_e*_x#EQ^C)Z
zwH@^>QlK7(=v#Q{OG#eDN|V?TQ96G`B&N&J^w2lThWekX?WAupSx2UCol=QZnuUz1
zZ?Vly{~y>?5Ie<~t_b`jv^n{&ZI0NSTuBCP&PCr#a|~&6y?<+RJ*x`sm(CM*1@k{m
zlQhcT+OMF?N#9;`s9Ig_RfRSffc+gV1Qw4Q!lUiP2DHlzWcX?ySXLXLc-oRTzdq!K
zl3K#v|9dhmIza^&r6s(j#X+*EC852;uW?$x%m!8-r=^-9zMR3D)-SWZl*ehQX1FhB
zqC9xw_n;-=-y{`fwCD#lxFlMt-s0B?E!7)ZJZEQLDUZ`q^?>CJ*0g?^O{+XkOCl}b
zVAizgi?<AeRV|@6<DkHWJ@U5*Es4c%41m@zvz?TSX#FzV70WHlH<&doiO@?iL|oO9
z*!;!-X#MtuUMk<A0(s~ieh*r|%q~(MuO)n4s(c&Pgr{6dJLfftEu{6Y!emSQWCz~7
zWMai*n-xRERbyd+H@lcvu|~8dc?^TqR>HQnYVKqj4ShDuo+sv)Qi()(zLRjiMT_&R
zRF#;NiwbK!g#X$SBiQkoAQ#rF{#Nt7kc;-q6Z95VwN-Q2(-`qvI8`MbDZr)pjTmj!
z-19U#NLZ;V%s)*TEF+MM`pRSA{dn-huyQ1<B?$kkO5i03HjEWEs!H%vYpSSZ<f~Og
zTuDcs#PMw8-W(TS{jMrW;rIe!TU%1V`FSbwCmdfT@T!smVOjof9rA7ENLYjCt-%jx
zgk|}^U1YT;(?1Ji5W<SdPhD?#w*vmW0{)`{u1U(HPQPIV+_(Y`b5Pf0jw8aDkJyB9
zkvjdZ6>x_NIK1nuPR{_sYmgp@2D*ojuRwlU1w5|;zNrEZ?V~1he5B*j3j(L3%JO-R
z$|}(Fp#rW&#xXUS<0jQuSKtP;xT+(rsldxUMB7gn!po^DnFQu)R>xt^T6NrC&|ltL
zNm12sf!9_kraVdD)GHFz5e4R&t;rmJg)u2fy;9)i$6sN5OZa}m)#V4~l&#4em#Ln=
z1>QuJA9@7+AaI&H9Lo|Z9ny5v>91P>Z%KGf<~SaSmbwTWM*3n9#>!;XP2e;a<fSlD
z-w*~@pg*nxo?QW-T>)QI0bfpdO=kQcjBQDNwhFwZkT>{8Hid9l;NsB@03EAd6u6}*
zME<MBtEv~ct;k#%ZjQF_kIXjZM&1G?|JuU8cJQwQ{A&;YI>J9PZ-kp;C-`S02-*l~
zY{cY3DjOl0jgZ7fNNpn|vJq0*3X-;hq^%%nE9w!n+X~ujg;cg85z^WU+H5=h_S(5b
z>Eh<;AahfCIy?KweU-j42RFG=6cgS%C+~NQTf)3qIAaRD&n|(<h{!w>Q8DmVv?O6T
znU5lpOb!y1K;8%+86pV^B5$k@izBbalL;~yyEye$Vq#R_F!FMyBr%c9VG*1VBO#MK
z1(8Wy1iyxp=_{1M(MmFb1x&?4-Wd;31_i=AGD>0c5<!T}pAj4##em-=$W$hQV!V>f
zlmR+}!XuTTff2))48e3MWachaeJZ2KWK_azHcFW1CnhjH97-58Dp*2tN?y>139F(4
z<Czq~%sgaHG6uy(j0s^j!vo`pZJ6*QSfW%8BV{HEl**9U*x}Jict;gx_yPTdM8`4-
zh4)vPZOBr2R^t+e#KlL%gL{6B5Z-|;mxE2>Ol3?6)F-W)goKD-Iu%;EEWRjP4$3Df
zDre-21Z1`^VVj*$tsKCNO5(e=<%z_3huG{BB|+f~NQ75ogBiUrDGQxj>{sRN<V2);
z;1d93K}sYMKY+k!6<^{n&qw^|7`AT28M7F9and0&@eT?2=?h`pDI?q8$!l2<#Br)P
zAEN`qT_F((&`&#(AC>n3NCMBrap&(mR22VBK8xY3-M<*_MAoU@9SnytH0Apk&dOg#
zP7WgyV@CcN!<#Yu4RR=#Gs7!m{||ah7+xPaFHg_(Kpu`RG@lV<9RkQJ$dB?2fFuBS
zB|pl~0VDx<Px7PuK0p$H_aZ;a-vT57jtFk#N4Xx8PgZ{&<RC9&<cBlz?hJ>y86fcb
zVY~$a^26#s$#4%6NApw4a8HJRWjJfM3OJGk(C<ZlR8LiaB=GsC9OR*`Qu#U{OaiDg
zB|plcP9cE2FZog41|SK*+4k=zP?7g1>r|fB7wCu41LdWRJln2d91j8X4<J7(&(_yK
zhST~2{pJj}V)U^3doY~!TRoB%0@!sSKWeuk&iaRyHv%OjKz^XjQ$13$4uRL-RKx-g
zAnQ~f<RE|^Sf{)lKoWql^#Wyq!0V3@vB25#(h(}?hqglXOBs2#T#YN>y2wFKEApdy
z8Zz?142L>`0P-;EqVjD4k^uRKj+t_(I|v}(n*1oI=fNO9gyDK*9RkS1)etH#ULX10
zZ%{`NKo6Tw*3WD^hjj>`ANB>R-xVMUeEy*gL*VltCSpOJ%|Gi;Ya&DS{}+GSF!KMm
z{7J7ULH=zS{j7i3c4$vzAn^W#wgdt6K;CG%AT0#opp$a;xEaClVPqWw$hRjyDjy4w
z1m6ECA{O{ivQFivGMug7JmjDsuKH2=&B#Ij5Qfv^EXcFvI>E?CGV<3L?#ghut^on`
z4<bKmw+ho=vH7fp9PG07(vXp7>&2YmY&-ACaPTd)+ndqfk>PNi0s`cdEmr^|57#oO
zo-l@YV)$4_51UUq2Ri7FV&qpadf4)=t3b~#hO^}by%4}}oym{p6WS64;9ba%a#)7|
z>DYYI_6(fW4}B~I(9@Ots2(Li5<s5q-(mzRa<+YrW;k2#*~meEH}a$U7c=rh7%pC?
z6Z6xZ;d@b@FK+>IzPzUy&X$+<SJ3Y^L>X9A$93Rvj5~|<QIp|PT!#g{!UFPA@~cLE
z5a@9Vcw_P#36KOBOF#f#ew9Q#Mo<oR6*%yLwg-XcXLcoVTP`kC{Gql8+&F&3Py{fx
zfuPb;OWY0>7b?C?O9aq{AyE0{I^uS`xKQyrsE5`&mG6%ZOXK9PVSZ+Dd?QxKe2&xd
zujF_Y%;#o~S4F$~IbIX%v6$n{A;TnG78j~=Iad}z3CG`Kd7pE<CtiU0%<(74E1`Yr
zADEi~0?ilY^)Ww9IQbQ#xTGb=O|d<6;dnFL#!r>1$~77rxDO|9S6ehd`$L+a$~8nz
z&m$;rhV?jx)AJYXm?UI#oX(jwljFB>hgrgLE3Du39M?yG?&0`z^qcSz6=I*}(;CZr
zij()mdc4kYE7VWVYp9-3^ut?Dz832L$#F;Af2*NCs2)3P=k+;01m(>*e!7a_PDxvi
zf5CdU=lBLuT;k608>oLE$9+&fp5x!qpUE6g#d4BIOoTwo^#=X6h~xB@1Z@{oz8U&+
z2Pgjk{RwlAL7?*OaKAps@w1rE+Z^AC?W&C9577@FIo=03%-O}-rQg^!<oI!{$HpAr
zW+0}A>(s2Ce9TWrj&H*Hb>etF_7A-|-VwP!$Bj^bB**um-$rv>irX+p7Mss9Y*%wQ
zo`L=0MviBr-6I@dhIU~NDpr4A^v`*YTVZ>+%JKHJemTAg{cxY-X6Vl{jt@evf$3<w
zx{Pv_IsQS+wxl}84`DuQar`3sr#{CQVm}FUQL%oA$K$Cj$6sPT?Ks{P+Z)U&#p;=f
zcAYp*-^c37@k*E<FOJW`_TQJ|@36l7IDQKAAH;D-lpo9S)5w!KUWWcm=lE6hLpH~c
zVY`~maS!y*dXCq^a&6`KC2Z$=I1b<3hj4-8p~$as{5x*n;dlq^4<B%RD)KUpmtueP
zisRAfw+|dQK)+G@v^@vl{!$z3hw_=YpElsQ4Q@+0z8v+Kar_<bFP0o{g88%M_+;dE
z93O*vx^uiSZo}M75NQ5CWBvBz_<q#m#c?mJ-@Y6_jDGOr_&aP@LpYv_cEdS-29HzX
z7hcQrN$13-`!~&hTRL9i^z6iTmCW%TI38QT@k!WzmU8?o>R-k2T3D`i9Pf|gpDi4(
zf&LUeYRLFM9Lsy2lkbP^_A1AzfA4TS810sE+#SpNf#ch7yrGHpN&V@Gely_sP?T@P
zarhQHgccmPK|LKfu7~>_%%KE<+O2~Ar|pY!Z?rp@lP|$~8Org7Sl&?_H$wSTj?cn+
znZfZmY|l$LJ_gGLa}crl{|EiQo8#}GAS9gPcoEk7b&gL%f0lBb*4JB(o1#CfVZNx}
z=s3JS$A4nKZN_m2Y|m{uUIX`2dyap`_UX>?#kf6?<J-|cVH_WY`r|onhug^<H^p|6
z!|`<V=OT{VqJRG4_)C=E!SPaTCxsl(L4J<o7Fe#^93O}BWgPE?`{759)BQ^e{Xy&T
z2+A9BJPMCfjX9o&?V}~f+hM(T<T$!h;>7WAJifqOEf8pa#$$W-=XfBtpGb~ZLc56^
z-y^D(q;Y%z@|hf$<9@o7<4@85>p8BE`G>h$Akh3DMgPDYDlA`s{1V64qMu7R{uLef
zg5&+L|M|x8j;Oy1?%y;&^|2k+<G4TeKc*a?h<fOI_*Bmv>?dWMe2Q313GJt;{0NjA
z%*nS$e@1fL8{6|}j%Q#$kk0WC^v@iQ)APy|9H-}%TR0wxb`NoU3;N*<$HTC_-QxIj
z^k*5zow0sDar`0rO$QuC0`=Qz^iM60=VCu&%yHWP)AKE=#~t(2gOjHhN_%m950<Mx
z$DPp+AskOc9>?*<xSvkocw20*Q#oD@`2vnFKt1^!kHhxAjpMW*JIryKpZ6Spi2AEx
zxgi>^-yX*8njG(e`@0dxZE?S7!tv`^E>n)T!+xe4$EVP73&+>swkyZOQI99b;kh{o
z^tuQw*9F{<266IZaGPGoqVj7|4~?gMGwPYh>FJF9%w&#_#P*!c@lrhQEaCVG^ygZR
z2crI693P1M2*+EXo(mk;!g{~U@w%9wXB-d2di>0BIv1!8?q}3LwXl8G<aiU@|C@4r
zxL92hOODg)@|`#yiTa&6-T=$%!*RHW0U?0n4{&=t$1QL>3zwkQP0%3zo6X7RV*PIB
zxE45sgaaI3jsCpM@uk?GzvlQ^QH`WJ)-(0<W~{Ha9N&k2?#Xde)Dyt*BFz6}j??{i
zF~<#XT(ySddoce69M8t~cADe&aesfq@jK|ZYN(HvHxBifbNoIYUtBnzg8KbAo{D<n
zIj)8BvpL=h<=1lj9`XYm-;M3?6317e{(Bs!=T{#&ULEVPGNz+`u*Z5dKn~{WBZCDU
zk5hSi9@mZ01J7pQVP7KSI5t0t3&Y{KkcocwX6zb)K@1}~`7tP;%*fMcdmst*2hHav
z%+O{=p5CJb`Qw~^18n~n84l%Y3&JE^<+!<sCASz3<)Y`&j~EVm;!*x7$HS4oVmRn2
z!2S9w!$HqBl>dk0Ymn<>xxo)0{|tFej{l9k9>c*d?HA~MEvlzEwnH;U9`w`qfLbve
z^w8@P9T*Ps!KkM*$LV$29t;OP^gdKihJ&6w)Z@YN`N;h^eiC^A#|x2%Acsw8Cq2jy
z!Wf3bp_;yTlg{x1)U%Y~pr;ooAz>HCgG4O3&Ttq479fAjaL_~Bj}Gn!G@s*8zA?v_
zA-82X=%?+cC&NMi5tLUloGtG#hJ&6nD4)u3&~qO70_1dmyoUYJN=BYOy9i14aq@IO
zI>vCQ_mAl3lN_h@a*pB9er#}@d6VIwM~>sJyBu$i{3XX{BY(^BDab!D9PHBlNE7>Y
zx*wfE`AQr=jGW%Lr+%aRQC&{HI*unBa9jg<Q--tqQA>t{AKX#iisLfmT{%wgli728
z9LmcX4r3)x@`K>PaL7+M_HP3i4*A)PdIocx-fs&<4$T1C&u;RA5Y5Pg-9Uj#Boi49
z`VXUidfcY<asW9UUr_xDY;XCTo|`DYmgDrk-8PQDNBLbGe~G++<2A6|9^p8>4|f7N
z&8G+E^D4&&BY(zl*ngAIKOYzl{+xjFdN_`QO^{DP`34LJdH6O1gmxUK{euU`Z;9d(
zKaSH6HIC<ab<{tL<94X$FNQ-t`yt=WaLA_<^79-IME;E7pl1g14-5xABazp|^9Jgl
zg~&}A4)W>99XUQ7`5=yOM;^m)$j@rz84L&gP0>G#8P57)1H(bS70MswIDOvzCc{}h
zPZ<t+_Mx7i$Z3DI5c|OzAVdP?<FGxq;&=|~>B#ZhI3AO8{3V_@dLf78m<7RJ3?mQw
zdn>dX&v8@aqZ!Wj+o=o(J@k9i860;(J>pD4<>jUQ_Iyr05#@6^9)o->$Co1C$ngcp
zw;`u~fHFWRW;h&L=ze;U;ovuTHWb1;hC{tO3zR%}2nTf%sQ$j<rlc0bLEaj<C30Ht
zeenFQBO{Nyl#rqyBM*KSCR`%RK^)(W<qcpsTVIh32R-*uKAPh<k;gL}^w9d6z;Mu0
z729D7$F-2p;<z>Pc^s$riC1x)-p5_TaeCi(BXaOR_)SWF5Q-QM^=l6TB%EP5$Xg0j
zA}QrK?LU8T+#Thc;K>!Jh5DuKq&34qe<aFxXE@s)`XQ(7;W&;1hcNPZ2of|+V&uX9
z5$Mm!91lXC#c;Mg%w;&}$wv8w98W{Ol;Lc9Sj%wGvlHbva(pB5{T!$FeG52#4dss_
z2S0-!z&3=N42Sxq=UERK4)PsAm;@a>d8YN%QpA$l3<vqX$W0l})>n7rw7z1nUAZ#y
z*u@K)A{cq_&vz_W6vsazk7YQN)e6sZ#xWf9G=WT!kj!!V9NJ`tv-LiM;h@JJ^~~XT
zXXFbR&er=XhJ&6klwZSfdY^kEa&Q;;$C&&e++*ZH{|s;}2~Qb$bb-J%@Zt;gKfOO*
zjp2}=g_s{hj??F&>o6Sb();yNhJ&8{sHZu{cOq}WaMsW57!G>wqP!i)>HYF<3}^kU
zU^wW}z~hA*$G@Te-pIkv;J4=F2Vn@qLDWQ`63G-s57-qtGqRY?$m69HA;mgQej7IS
z9Snzj();myINk*Fe~{s<--<cj9mg}*I8OJA`wR!WuBiVJ$6b&=Lk|9da#25M;e+^;
z+mSd3MhpkP(Z1M<;h@JCgh?2{@putS!jRK;TNj-g%gAHbFQmxi<mvhHEKZ)*?@ES4
zKJhZIq?pq)8zU|<@>CWKzhUITpY*wh4;=4{{`|^ts7HETLK|O}fbxQ#Q7Es=@e#=D
zaC`ys`W&By+=Aou`6x?{Z%26><WRp*UUTw;(3g=H+P{b;0gODoMhj7+IC)y$WQId|
zkE7i*ju#=H!f>|z&t^F2d5H4!Ier)UVuphrI!;^7aL`j3uP3bIxCZjg$iY8QUfh)2
zW8^{qWgH)tG4i;Jl2{VJ7zwnUQ~&5O99AvRu0F?`Bd^79)<2CI4y$sMH|BT`<Yo+K
z{bS8=Sf$rn+Hrgc>gj|W`~&5s{t0K~LH`EanPM4v@C6Ms7<pKoh5F}koIXdgkkg|;
zMVlCTusaFu9^^QE&ZL;(uzDNqp62*v<X4bGc_IJQ?p;P6t|RpzKL{@w4y#&tKjkgQ
zf1>_x9H;jye{$Ri^=N}J5@>z`ge@{2<ail!dxpdKFb{c8hC{jN`!@YJt`CMt2<AAw
z|DMcn(4QzsOC(bn4*Kc$eHJ1I2KA)}D<rIB<gus%KhDW}<H6wqBaf~W<ll4h^HAA8
zj68N3f_xo(sf^}_?x#%|4prfZdQ3Rp4Y>uwp<I?&E?b6!o*<O(z;Pw=E(`}fwB5=X
z4tmC+yer2?A@@KI)d%IJW0yf3Hz#orVi=A?D1lFAIOu6BP>Ey_a_YAOSl(5PJPzfB
z6vdppIbMvp$jD=tD#({{^0Z#wF&zAmi{<^q@wv#qGhAqI=!i<NK>}nO^c11I9>?i@
zZ3BkGDjjdvXE^A2gL)csoIan_jN!0K$J>?+2R%*EpVl0&hrB(*VU<2d+JoVs#}(xr
zIW9-8U^uMO=V`qe4tnTwNPRgTh<XMw99HRbX%Rffoo@oeL4O+RN#Xc7<QWWyUD=BK
zAk1JmtY+dtI1f3re`r^+*pD6J_*vw4IS$`HgYcc>{~)g?6{3ZH81zSpo02vhpNiat
z<Cl;tIsORwIF8ePcn-&Dy)WlD{hr-s<lsgq$_ls`L&9FEun_XEC9VqpZy*PGsF&^N
z|2rK23;BJ9L%q;3;(LaJo<}JEnd1+U|3D7zh5Sq-KL}Ng#U+S=e$WM>Hp8J@gYf*T
z3By753+iviar*q8Im1EEOFYT8VL0figYBw4$Laerosnx0S;+r-@`K>Q@jW7z_;UOZ
z@<5J%Kt6`yaGa&*WoZltyN)P7ljH8lmvX!x^7R}KM81dPLy=$Lcw-GQ;wi%+pEP_x
z4%GpEwnBeaZYD}lPTyZO<ai0T+Xft`&%-p~I34$zaNHBygLwtqlH>Gw9&3*G!-G|O
zj??FYI&oZz{T?<`VZXyuaKQoXL^lW=FSQCJp#r|W0{*-LZi@8-3s!$f1$-ID<*1jw
z7fkgGME;49$6EwKjI*XF0MRUm?<zvz`PmA%J~VDM@*W)TB8sWLOHK8AAm75t)Bd)Q
z<7ZI*7RUQxIX`fm-aoC0?Sk4(M|n$z<IqR2K;J6_F_w?6Kt7M-^f-8k;kc^^`sw?0
zpr7T{aB#+R`hFYbCW037d<rLTi+m`<=`|sU%Bg_ws(|0+I4#!?hSPlq^f$#pD&&*p
zvI=;31$+_1+3TwZD&Y4j;F`F9Lw;C2<_xD}aL9j8j??~p5X13Q7Q`iq74U@>@Le1?
z7qpQ3eGI3^YKSVWfa~JP6_ksWZ^3Zv$^{F~74V1(_-uw_*DUC{!|@1#lCd0)uOUAm
z?}WT*1>A|@SVSR3Fvsb*Vm!xNqyEJV$6ZZ`IZ^?CTLG71AtC>)o}Lx(&<gluj??q*
z9Sp}VO33G9jwfTezH)pU^14{5kWbJ<$0ykQ1>fT(Pay?u^Hd(yNTj#|oGq_4!*LfE
zh&{vE`to8pHVuIUFdSVjkQjzz5d|`l;cUB|&TzJ!=P{h!A2%~xAJ<_~fa_3Rc7H$5
za6?>&MG3BhJll`GW;olg3I|LQ2l8xxZU}$`Sg^+tDZ|<0uQkKj@qj(U@fM<>*Nfps
z0ulcOFq|FFP+vhbw4b4v1~0=1`2?PiybUfv9@+`DXU}k`M+I(sF&xUZ8@Gp4z(+Bh
z-7h9FoNb@k3}@TtJchIFa~Z?g_PLJXZ2R27aJGFGFr00lCmGJR&&v#_J_mG{;cWYS
z!f>{IzGXPuKEE@ZZJ+ddA=DS!KG}B2wom$=1jw`PlRhsDoNb?N0FVF+wtaSHINLs*
z7|ym&4~Dbtvzee>JcdZgI&D{G98bmVmK?u|+jN`)btol2S{_@Br#u1k(ShT|$n81)
z4Y{1-m2rIBljF6Jdvd%1a$k;{ARoYSOXU6>Z-+dH<M6$92;t&FI4(%Zx(o6sj(Z}H
z<v4vWp6;jAZ$T)Z#L2^V+#w{33zgl`$R~3=4S5#FXCR->@ny*8aGZXZXCcQoq5M*g
z??%3o<McV+H5@;Q@*6pR5jj0RQ~#78r~M!0kC7kX^n68L$Z`0tJcQ%oLgh~*<fl0<
zMNanvXs(C^$yL~XVZrvRHYfy~?N^5}ob6ZFGo0;LuQ8nMS2fWX=m%fWK)*Kvob6XN
zF%!Vqe$|}eY`+@DaJFBa%5b({J;89cUwzGRwqG@=B<2|M!}hB|3}^e*tqf=TRr);v
z(8KntX6QuVY`=Pr;cUP9j^S*-O5bY+J#4=!CEF07nPC+P+x><AB4^tJ-7i2MT_Q-*
z_6(eD4<$mZsE2J2?-|av2VKY@3805<544{K&b9}790AU@hhRnz+aBn5EJ2=a5A-?~
zaJD^^FnZYbAY_opf;`(EqyR{O1=}9_Gn{P?^!)>fX4}JQMxJdCbpM8Ewmk%6<pF2g
zLn6c3_Ar&<Y<rMc#f^@N4;(_4@v-7EoUX-(B*sguf&=3NC00Y?;v`nF(XauMHdbW5
zgV>N^fmR@7RsPL)oVh@498O7~HV$V8_{9X7WI>&YU*`?rGoYFyfR7Mn3Q((%oisqL
zfH*mT+9;R~Ky3s!Wq?{4VfKIuW6CEIP%DD-2dIrJpGrV&v^cAP+9;emKy4hEOaZ15
zP#cFc3aE_}=LO*FLzo?ahd4*TZ<tI^5EV^k3ZU&HC@vlvpx7SC2AQElXez=i7-T|(
z&}h<dVMYvP;E*A)AtQf@Ce=ACB92TW!KMi$(_Dmw{K{g7hy5-{=HDRs5S5cXfvy53
zlV6Z+GLc49$Z)dfkXbcCtjJ`Ut%W%;a64>xf>lgxbWBKW{AkQTNVqaIHZUrL?8^V^
z0MC0s7lwx&l|Fmb+OI3v-Kn54Sp&u%8z9mi{;3IkdUGNJ{eDI1*<%Z+<F_pd1D$ky
z4l)qzh5tl1ba+gl#~7LqdlCoheEGdF9evJ$s`#akClIbrL!Ru(j}1}>aVs1R$;c)g
z52=0H*ZL8r&VC*`gx>cPwf%Z65?DX-Q)fTJQB1+whvP19KantX_UU`!>@fs1^5u^s
zOr8DLP9RP0KZ^@tP6jxR^Y*6^2KM>-JBEXYvzVSPKo$aBuE2G^{_+rX6Qs-k@%dju
zqSWPIS1zUrz@##=gz*EP|HFhqUU>T@2-q<P5&O-5H!Dd0`ah<JagsXwbddFL?e`T)
zude*zSpEVM4*|*#zT?YZhZt99-wOq$Bn=yQ|HJhKb@nZs#Z+wjf$<V=-?{?(G5^s%
zycea;zP%dzF#h80yH;R-ItsR73s2Vh^27L4o&El5?8Cmu+mEWiegO)$_!s-oKd7@G
zgZ8a4y^JiOE_nNJKaBkS*8X3kU_7R$3%>l5DzKl2_Mv}*0QTYfG;e=x1@>d`q~YJn
z59hV&%5UTXR?FXS0{d`JfwzCG0{eMr-wc#6fiM5z3hXP;KHL7A5Iwy8(hBUKNBeyl
z+px;pFR8$O0NS69>1AXoB|qLioX8Lrztz7ro}5LJI5zP1;kuYQ|G!521(+D@HzPmZ
zexnNP=b`<7D}OzbUY-5T3ehlI{^n}z+f`tno`e>GbC|%FAHHj?&c3~?m<Z+>gaGA-
zw#1j;w*vd;@xXHh5;K9f57+P1**A0(6VdDTVBdoLc>6;uu)i5ks`+spZ+}7s>FM`h
za2TK}0iS+u1?kVDefAt4l<?`{Iv-RKdoB)gC77O;7Z?P(O_wk~q`LG^Fg^H|4Ro6>
z;rR$iuTqS{uQ7cCZU8~;Qk^GAdUf>|;4VridWcJ?KR6cA^t4~OS%G~+yczgI$egGH
z{?qi7yr?KWbe1Go(}IedzomatLH_@mDkdnXBrYNUFh->IY5p}y15@Wed#RW%L|mx;
z)ASVlsK9>sEK$OO#6tl4?Z}U&r}kl<PIdPGk`iGOa>Rw|KTS^od~a4={Y}RU)p?Bl
z4kQsxPwls=z`mWaXkp;L_}{Do`_}Wt^!;%Mg!0>|u@B#Khw@v~jETu4^G(H-0*=#7
z!DmFop@Q`Nt;F=*s37X)(|gnO7*7{-aNuP@0WPUJx*UY*IWfrre&EKXr}FT<`O0Ji
ztBGPs0j9TB5pjj)pW+m>&!>Nl>F1MpHt^}klX!LQCu6ag%8+S4&=t`1wEch|c-xRN
zqb>X=-{rvLr~_G7mmY>0Toxgj#IC!rkd$(f)bC=fcx{vu5u)bfjTe}AmJNJ*;Ywmu
zG`T`$72QTEmD+UdVBNk`+qSkgQmJh_n+~=e#s4<e)*aflBk|TYw$?;WDh<$^Aa`@t
z)F{`eA?Yse%dA1NUfi@C*bA%n<eA4N5?No@%zq9^36b@YWnPi_x@Mm4<D<xY_fxnc
z>z4URk$F^HS7gd1inLqt)fAccC@E584%T(ceC(7NWk{LaNRcJ%aX;;wD>9!98Z7gZ
z4VL*A304(pKjXU){ofQ>JupGmSR<g7RGYd~6E#ECSq>@^wFs(I`Wh;-JdLvY87i_y
z>4I8ew>4-w5d>@s#1zy+^RO?V+ljdezTKj0$qertIPl@c;>CvFUJg6%G3i~Pu7|{2
zk*VWkB%jjELXqO&ntUWIPgh50lBSc!a(n5jWW7~VZzsoEa_Ji_3-1di#{cL9hCLej
zYV*uip^pzN7~Q4q!FPjB%n$an`H>o+_k6m`?k0_5HIkNS^;p<z+}{ejA^q+i{5ic!
znqvCqn9Y}U9^|gsKGC~{>G*z4>fakTAacOZ!BKshhL}FCX4+<6hs^_TKE3T-)~BUK
z?HSVh?&*HYj5{kz!y9k68kjax5~US2&-Xyi=ZJ)}t($B#nfZOA-AVU<?z{gpA#~<8
z%Z=A_J2w3+8@k|bu=ft*tL}5wPIy(88hbh8^GdDmpLh8Nol4eyy`qNStchE6zs6RX
z>LOjG>vqICFxlQGs?bBXk)xMs%<Tz!W1Cr*MVAH5EU5BxUH6;X1N&bxwyrbo>Yey1
zZYKTBVr+LUpH@e6_0uk$W3vk)ruvzmcaBN<@W3OW-P?n9Ckm?fxY<$bo6XlM7C|QM
zRwy(7j>_Bey=8u%1>Xa&_SG%SQRt;uOqf=Gj?~#cvg%3Q+E;Q7Dk-lo9C)M7&itH-
zbsJPO&TCw$NY_kvsx*9?-tr59Px7YR`F?-gq6UdgHA+X+2s5=DQm=n*jT_(RS8n@K
zqsy#EXVa&@J^o04`I9EEDjzsxUsUgS&cp?S3r1xudGqk$tK`Q0gSNf95p%}wmi@`-
zf%|gG&g5qLZP&ZC@_g>eme+sQGkO*9+Hb<`qn2LZ*KQkrvvuf|mp4yI+emh8d$n>z
zu+^E(O&)m^kDVWOW9_o`$BOL6dM+K||18p~dFwUKCyNX=FMRE3`{i|9H-(Eu=)2^x
z>wnBN-ca<9##N8LCxm9J+DGYJVdd?y&vbW>BKvA-OW!$anqA8GSy*j@Z?<pVx{Z4+
znh&k9?vcbVMN6ttbKd<i*IlcgI6G$i_>W;H4Huek{5+%Kz94D;tj*J#`6Z7&w@hRC
zfOFbMOg4M&*qagls@BKeLAQ2xY(BK6<D!U^yziFDy?QMReA#GC=Z!<EzxVy(XOeRN
z@hVB8W93o)?@JmC>e61>^o>mE9qe+^p?#2P-pGO{?Mw#L?0#iUuGxvWFL%%8g!I1I
z{^zHMgY~U%l#~qp6xvR@uB&9h!M1aYN|U|}eAuq;xAzB+?&<WyL?`sE<crsq7YF1i
z6W<yb_f6F=sD8BVwGFZ3W?ky_$nkym!XfK)yGje%m>sc%Ye^8OKmHLnRojWVQKy&b
zr&t>udGl)Kv#o}W^n8j^wi~sx?%aNQ>gIHZ*K;if79X4W;j;33?4k^dJ*RfuGPkJT
zXj^Wp+lBilW-Yk9=yHiH$TR#@o9}^{VJD_0zxx*O(_zJmo&OY9x*(T3c3bwiwo|P-
ztv_VcJ1)JM;q}*=YD?PH8G1uwn4i%MCSP8^<?CHwKtR9{iH3fq;OS>3>NUFX`DC^0
z8j>EHHO$P3unr!!;6N*cNY$E5wPvC!=WuiY^#kdrJoiOu$_y8GJl=58reu>nlEzia
zbb^a_<~DSkGD726zV_a{Nh|a_=V>f74jgHE*1@*n^V4I$b-!8N$zs~pIyEGZJ-SrW
zuAO=N;o05~zh2%`YS^@Jj_>A?Z6?lf(p~dxj^~)X{L~NgH)ND1-)J@H(CK{Nu|cN_
zCWlwQr{6=7p1Hy9^$mmfhs$)n&E5Lt`LomgHh&8<>g;=K?D($(YNr(*8hxur&JSaw
zUh~erIC?cHrub9;RXs|rj^#DV{^yNn%R@KoJ)2x>#N{Ii^&0G|4Toh~uGcuWquYtO
zA-<<#A4m-!`n=cb8MSpsdZXC$C++$UnCmyQk-7O4X|T_X0-fT~Nk8-*T#LWnuc381
z{!_c|RZmp$S+U)3Mf&=J;C>GWY%%**$EtX_rFG|hCX1hRiWq&awM+Ny#r^eKIaIn5
zJ7h+UrdHwIEly>w)N%<;>d^OkjU4wrm9AM>C~ozAr@!N}_rtZ)c^|Bw4qkYFuUW{9
z9$(yiOyviT)Ny?~?yc{)hqk9icrA+W*3HO1@My{5_*$JN*tuV<W7cVWL8lw@t~BU(
zuYZY!PuRwLnX4Y@WINov*U@X)rACR3=IpGo(y)v7=!v1Xjr3}C@Hf>9w>g=U`~Lgs
zv9_b`%-*-$_`{`RWmCqO8eDk);G{-(bIpv=`jrCD+kf-7X{Xzw>yk|k>p3l4>2I>a
z`ON3iM_boR`({LV+$r84>N@vT%SMVpfrcHUq*_bc4?k~_ZKt^FT+nYqEBB{n5!N^E
z51CQt(~~}B^E_{T-}J(^%_j>>TX(a(pH~XEY<*>(6Wa90_4)6I9awbt?$j$U67?RR
zxm-3b)HBp>eE%M66MvSRxvKn7Idl4Ahgu!ZcpeBSk%cWPSURidMAw@U`m$$V+S}bK
zGD&PAk4|eoOF3yz^wq5Od%dhTSf}cE4{VgWvRkK!D>>Ed_gFcdo^^A`=CQr6u3K67
z#Cu2I>~jYqyYK5}t+c=Y&h>V^eHI4}WN-ZGH(2>&%KhY_Blpjm(!w<`#O1`RoXh*)
z9-MaHvG%-<y@w4Od%VQs_JEQ)OFM0od`WTC+#cA*revp2&77f?tzWL3;&~u#+VI(@
z^-P0`R)<S>o$>aJTH3Bm&wZiCvqSq#_rDmhXMOShO<{MMyqWYcWMR7j1GG=)Ms{D_
z_EzBA(bhR%jK56S+0x~w<VW*uFjS!JawZNi>2_l7h8cH;7Fkzwe&>*LbwlfYMq}rc
z6c1m1rpMu}?t52nnmPC4;A*x{=A1P@FH_8!^dia9c-M9Nz(qy}#~<tO|7qg<p!nOS
zUF5|J4_%r5zTL+DA^LX4iH+X}TxuKEO{dUk>Ugb&EmPK1o_}xJoe`U^?u@N{a{Xkl
ziRW^MoNlJD*BERwGV4rl1FieYt9O>&+0o`_jp0gzF(<zVuX?}p?!AXQ4&@$NGwsmN
zI(7|f8r8G@*nIlAS*5FH?wa=IqsQSsG0jFjUiZ9iOqH#94@ZBzxhJFFf&C68E80BV
zy8QJGKgrJAmwpl#N5{@m3vypMIIuODl0Ga%8Wt2JwP|l<V`bgiwgs*c|G@4mB|q>L
zx$Q^B;Ti?FOA`YA6St|~;QBKJjWOO5jYLC@hSe(TPA8FYUWTXJ;&*u*^bK<~d+Hly
zYsvMcQ?;G+Ehg*8^sQ4WX}arM$n>QS`bI>=L7$uqz<EG_P)dRf{yFO#rf81V*Oe6s
z&l}L|w<ZwxF9GtYEqU`(otTzT+TUZee!Frg%4n(1RDMmP^~+Nq<#AfSJl(-^ypU3k
zgf*>Sp2{eX)cWNqT$Zy>S+E?g%KsYRno~`ty!0BVlyLs~6QqRmdUYJ`U8&<96>zv0
zs7^kF@S2RDg?c7zR0Z-G74U394?Tk{|Hg=fISC75Hk9}PhtkE((?RB@^mKOik^3rr
zWe#p~r6ekF7`d@7iibuF3sK@D9f^tLu6S@lj2IIHr*<K+ajaT=X5_brNJ3*nLRh(=
z=$O$Y%c^f0v>@wHH+1e*7+OF8Za{vNcLGQPaPTMPcuDOydAk3!B(m_V50wX75I|2Y
z@}s;lKoWS)<_Gq5DsL@Fi}Eb*h@7`eTPo;>%ZF4CtvNWQ$IEJh2D*m;hu<?T0jsWw
z0%M=4qAi|snjSA13Oc|Ry>v<Mfq;A!QMK^DHLe4P-z+>%Q2$e|f%%bh^8P6A#&I*~
zh)5VHE(G16>o4Si9EW=V5W>ZUO8ye^D2~%_a*gHqI?U%pj`zZCyrikp?|^(hCr{@R
zT*vY2xV?wtBd}ZtIX)Hhf12Yl$S-l6ehc*h$MbQ!jN|khg|9dsj|Z_29DjxR{KoOw
zxJ@s`sOlZ_SsBw&?vLB_8=;i<MgQ04<d33$`VCAfzXj!NIC&?u+mYi>P!GK(N%fpX
zIr^+2<-L#(;`A)Qd<Jry?nm^Q4XWn`%B#N7O7a15`!GLgoSw(%|16F_!g9^vcq+=z
z<M?#sOE|s_`3{boqW*mx55xQya=bQj>OWduI&i$n$)}_K#~g=yP!Qg8ysL;M8W>OY
zpFz9&96yff8*)4kx9PnAst2xJL!jS|rkuXp>cHulB8p4sGxJnF4Y?mDPyHUjaXrlE
zNRCgy{G@RFC~i;ZI6ON6VKK+=iCD6Z<8ZG4!VZqV#_dBKj}XNrr#L<h`E`zaBQNDR
zt>3pC_eXj9tUL85VhNqgk8;{>nqWC7r~4J$OMyUnJ8@IeiQ}2*H#x^A;C=!3Bp^^d
zw7g1=SHkUK9G9bhcFtPR)eXx}zr{`U)BMmm@+db(J^7q|6Crox8-N^NkNPiiJRaqr
zaGdrRKRHg@hc5a9vVp6DCUe|?e8S}$dheBfvzKx@exUadsh;|R7V>QbMh~R1#(dB@
zUqK#`kRpPS2fHxth7iSZD-la#kyAZ1pR}GSH%9rXoO~<f^qaj@p0=xvj9tk85!~Lz
z=)o!xG@a$-X}e<QWQB4KM!UBddEjt<0HK88V3+Q9?3}D1KLLbEc)`d6A1zRc<SoNN
z58Y3{F&yNVq5MydFG8-ZBd&lB_|g5kI>SLvktimq!SMsgn{vDqxe3Q<|7L+4>IMAV
z6y@zXPV1503#IaKeg+|ilkY8J3H`<_Ef?J%GnxEAoC`Km`i?!7r~B7TPW~$T5zZ+f
zKz<Mj+w{BuINScIUupgYVe)SxuJC+$1^h?_{1L}ZahslNK)J9eLJU1u<?Tu_9iM-C
z9t4~%FC91Wdg@i6$C%-)o@U4)pH<1v6}Q>*7vO2gTjG++)A2OzKPYbw86&|~TnKF(
z^o&AI`yncS0=YdW{~fuU<5jSe=*jWA$UQmU6uB?Q>G);<$E{JGwjY|$j>v;J`5wsG
z^C>8APvq?R6!5;tV>vzaUBOWtk3;z+j*my4%yBwy%t8)sL{WiMMZdy=-CyYV9XQ)g
zq(UlD2dl@A;jErShO>J9&)%i^_2n7imN&h?!oNi!Mpp1@4W@)^BkcPO|NlD>zg!c6
zDznFW;}_UmRM?oT@ofhp?ctxAz^6ASGH|_wZ8MO}9{#Bbe0m!q1B~{wG>JW~L{flD
z+V4_qNmig;+Eai_`V1Rwzi^Ei<RGsQjKqb+gDlnA-;D7xT+#(^ANpB!_5<(&8fzcQ
z$lHhVsk1LY5@$kwY~byOl1O#-ucLihPAEUv=Iu`=4D72SV4VaD0g`V~Yl_?SKTS`!
zlgWxY`>)addFUib0Q=DQ()2W6GYL~?e>XO$`j`(QCIp(EZm%LM>e63_Op!20T&Vu@
z>GMd8y8IX51;M{CCFCED)igcL|6an>*{9>G_L!b7XnMN6gRH2tAKp-u2tYxwZ$N%D
zJ+*(9FwR9n3Obj3D`BhrA1`}?M5(i1jP@0n6zs$GVcz}&!qk=jJPwvhF+E+-^mO|!
zSy5--5Dbz)kL$1rV@8^umj4xDV4r`6Z#Q-*t14)})DK@PNFPvzM3C@NT&Vt2`!qdV
z&k*dZB*c}z(AY_^5ErWdG#y>m!t^QuT%mJd^PHxm+=Ku)zu<}~nTYnSsUR+C{weN)
z_WAVm*|`iVSV8&@B)z)&vuh$IP+&T!KiH+HeOiA|9^N)2vBQ4D5F_Ef1DsRy>7knV
zV-G<R1rDqi!v+(;9vh%dt4lu-^G~m5&@_B{;YLn;;&A1#=rDMS@86!`>(Idl9_1t9
zzdyrQ@}63!$2og){@-5W?jV5|eaS1JF$v_I(Xd!aoFqOXiUq<ZyrdZsuM8O;EJout
zyy6-!YKTsVrz(UL{Pw8m*vOFBat*jGYA_v^AT<q^nv!Xton5_se3jmEAJ0DCj&dJ~
zyR1L6<ty{)B}z(&wD1=!6;{bVvgRc3D|hqsa+iDfinqe3UxOs^t-HsDh%d~>DWgIH
z;}T*+f+ZyJ*l|*@B5`;1Q1+Ag_{s&Fz6x*8J}wHcKE4tcZ@JuQfYPClV=uX{tA~q3
z-d`c><KyevSI$6Z*Zy)RiKEO{?&9e^0J27uN`D2e9=`&iuplbw=jq)`?oC!DQYTj*
zM^6tAxudVEr-wx9>O^iAdXj8Nok`}DG6zp@VcpfOkGEVRmG}2@b9HnjsK2w^TPgSU
z_Vo6VNc(v7^6>0Ol9#Ij<tj5$m4^YldO$ge5m=PV_<GAce27-T!^FYEh7pI6{|StY
zqs&nuSN8F8A_bTD_{vD;++`jz7bpzWD3K4A(A@Yyz4Vj03SJb1iOZa2Vo}^&9lT}W
zxnPOR3kpS^DE0J!?3D*uUzsmFWBN^z@|-;S`OzSC4B7P*nV$~AUPT}NJgP|9X9ysn
zDOr=knnBuTvQVTPF{00v`WKOpAS<$ks~BR!P=i+mZxseDQ{WE7TY~|@@y9juh#2dZ
z`N-y?BJ;RS0h$q$GV%A_vP~hYip*Dv%wsgwV{yeb^Ozzl1@4_GTBShd3^HDkj)~eV
zcxzxN^fzw}{13l1sNvQeA7ypR{HWfn%D~%yvzJz2kfBA~#Mtt8`rqq6LdpXLQGkB9
z=&n}3%|+t4Kf8_1zpB1cz5e<6Q+@RW{J&N`x?=S}i!sQsCjXft8P<WiCDl_%s>k<#
z?>=Y_c3=<O2iHg#TmQGJ2Z|u*UrDlFfqu2ET9H|VtvvJQuhqluK%vuZep0ccW$ENb
zyCSnNr9=ZPDK0!!R4IhriTJC3LD@c1ouSh!j{i<l|0&+(=bz(`|BL?cAAe5&gxDv}
zN;%XYj_2`xWqnoMOlCZ-Z5iFI6<Pa0&MEVaTNc@sNU;>z!Z=;kJBR|%;S7@b)91=n
z*KkdwaFCQn1r84kBS*!Uh+uNG5PMCQ30-88+`~x_C!altj#5U)MubHS$FZ3jJ=lHY
z@s%iMjsW4&aq*pFqGRJRx#Yj3|K)fjwZOhSi5{1d$`4CqRp`o-NWMuotrWA8L=RC(
z%n_=En1lafzx+rwR&@ZU-%<ZB>DeQc6dtu1PCgzX#bJ*!YKU|cc@#$}3|bQ6q{4uN
zZc#V=CqJo<mKMU{G)X+1w)h{JR8ub1$U?|Ij4jIDp^OSlRFZFGDB}a;BEdKRo}LUv
z*z^&@Rq2HlvH4Ip|GPeMBx4~Af|5w)l2oH9*ix2{rdqIOV?#zHgv7;%1XDw5@+}Pc
zpj=AQmT~ML4GN4835$*$trVO=%>FWH6ilj`O$%vYJbXGPUO7A=YDh@zpEB@o_PzUf
zc#sjGw0!USH`|Ppg(tp9##N<NTTklBOGd!H-mdb#GPiQeLfib;{EF%1PEre>K8|EO
z?USV1e__n0ba(afAqB$5s@nANbt28TeACs%L*|x5U8<x5U{4QpHRR4mSSOv8(%02p
zE^PFZxw(m3&SX?7>m~Of)juqPoJzzgLlT2RLV}4i*!rO3^8eZ%oIE|`|KBNENFq5$
z3L+og`BT3^hq=QdhQtPv7ED^T1vcv>7#~CD>Fq0bqMd0Aw#wDiH#=623W<v&2b7j7
z`=)W7$pE^uY49M^xWS#JvbZ?%A)Scm;Zk$cICE)eAn6T*tyIzy2^{nGz}dJWOE?hj
zB?AbF%}4Pdzt@3mD6+EP$R~`qe;J<b?exdkv44#1{KwdUKgPoK&x&)^{g1J5?X}{x
zL;e{1=MshgF>TjB#@_s6?Cw9t!riWlOJq?VJLs1x6i!@(H~HZFD*3sBTqO=xWNDiU
zDKb-=+Yw+>K*vW0saru)<_FizABxP!ip&RM6LHE~HJwB_W#U;+Rv&VTB@B!Nsl#-5
zBu{%7?;}h3u3?ZmgUFLL9fQ=z;+nQWsws?Hv(n~+jkJRJ7K$t{JJkS-XcCQ)RGJ2<
z@c2ilLDN(s3r$t^hM^mC7N&xVEU_fPidJIL4AM4$t>hz6VDWuJI4{gf2v>-6rz*1g
zkW<FTifrNREbSvLj)7BgR@!D_(ka_sgBDAX`I4B$y#;n1q11S$R;DCFSbVoI>%e&u
zD+&tQ(MN?;Q`VfzVsheh(Sf3HSpygcTha3VqK9$xzv?00od^XdCm*R>h@})ELx%Aq
zY56iA)2t}6b_k-GubvP=Qlz`&y-spQM{|$mEt^P2;8}9wH{nF7Tu&M)fp99VFmO80
zD4kC1KU+hp&WR|^+Wc88uh8S5YE^+~s<IeTdW_71>v^Pg398-1>XGdpAuyq?FbCe4
zAumN%7pjM>idw|~phyhD)rI8e_M|cVvGv3J2&DB3S0H+mb=S=As%A-A4AeVUaeE-=
z&^%u;B@|ZKHUa|Jy2-1ts;dYL{*(5Lf_||~{{z)2<8*Zl(o2aavgEq78iTYaDKyUi
zEWvsb{jA#GgxvgAO=4O9C%I9T{<j@9!H?{uP%p5Pl3i5X-*LArizm)CXlhTIgHZKl
z!Q8elx9vo>sjMAY=i32o5C5l2_FArTRBS|ih%h8qsUg>|`j9r3c?SB}3R+pp57MhG
zBuQK|-^((uiao5DL7M{CEZ^pK&|=t5L7w(8zP+lwseG97qmn^7++8TI%e7)%s`?L5
zXJ5Xn(*1*JZ@+e<*fxKw9fPzzB*RP%39oIF^ZDP}#<LY-J<)>#HTf({Jr{QQ^7i(d
zzA`UTdw+_z{+D<|w)&xdh{Ks~fLxaodYE9htmeYO&@FSNa4;mbBUTDr?I6Ds;_(!^
z##gT7FcU)@50^g_QuuFgO|BZrjp#KPd;3s>+J_0T5Ot6`BNqt8b)kygGT)TfGWAh~
z)q-8Hs^-bN_o$aY-X$3Fl_Uyc3x#+3KY|O+5Em#if2f)%UwZe<(<*DOS$&~Nsv4lE
zkyxHccGvP2z#IqUuW6B7v&feLRFz7O^F}nrE%W~GN)=hNo5z%EB_?Ti2{DOkV;Haf
zaw)4kB{wGcgO6nWz(ZHjL++VJh?72mllp_{%p`ItC_AaSA!#gKv9auL4kHWq%yYCt
z`jC+f5#hW=eIQ1;WquXK-7?>*lXlB|svh50hlv9~EzJOAlD4&9B2tB{s)j}hHAz!}
za?#H)$dq_dP}QB0FF!!{Bwh(8HvnuNvV%uU96YWU_7~zPF$ZY{2{Ec_6Onsni6XO%
zz~8Q;F_rh<dZL8ZB-hMfPCRajW?Zx8=#q06MJtE?<g$I)D0a^m%LL{50AI5BE))bx
zpXuAYn&2ifASf>pSjaphs<kN~y{IUI)hKeIBZqOaLHbnkAA8}n7pmcq{QR%gPIIZg
ziTqNH?C9W+l_>kA63KycB9s*KlJY}~$xPXBv8#mfm^g?l^W$9fFTDck6IC@!iv}G7
z*_Y8(<>Q<GxGz>?`YXQqZHALO$;4DE87w7|*M~@-D}=4WZJqMx8WM9?EgYNVdu4IK
zxifAvyUaRqdhvoT3tXkaQf-GO!45TTjkOCMb>+rgQ&-AI*KXfTs;ijY&v5<vb;Fih
zN|)bXaq?;38=hI-8|rRYw{cMGLEj<<tgDmI$FFIxK^va0mX4h;?c2iBjW3=%+jP{+
zPr3I-|2X^V``K5y3(N<l7T29=x&2&t;^)*NbLqY}rxsULzV%I<7h7^*^U)-O;E<wz
z*<HTfyz)$EO6Z*QegUITSMeH@7TMcKN3nK<SDT&-TsKZze&FlAZy%QreDEWuu+Fh>
zi&IX2x|3El`%^dh^d-|np4|TH(}(xZ7cATL{!^p&+kGaSbFW>gxpD2p9xZ;Bx(paN
zEhhKgL#rb%jdS1G%WV&j)=n!KlxlQXCv|sanL<(ORI~Rai!2M*hs}nXo-`Y3a?*IH
z`AO5K<e;UqbZGT9#wTZ8Zqxp0vy<~S|BTF-<n%1F(EA^so1;4R_SK8JaBytK5buD=
zAIDYgy{!4q0qf!__uf)FW>4yMc{>NauB*p=s(D4R<kR+7Kb)#8cXZm}l%9Fau(9#l
zS^K|je--3Z{qng7PT4apBVQb_99rYmhX<BNA6D+sKD5mEvZSc!FUgWs$2XhFi(QPX
zKiaKpsaeUe^0SLI1Gn1P<eN`EYSeDZ@v6(rcKU6vb#D9lqC)FS`~9BG-1W9Yz4gtu
zw@FldUOA_vaCO6_H$I<Uc5`dQ+%4W~Z*{ra{_xQkiL(y3(zzA1XV;gi^$gB->29#Y
z{(Q4VAD=9quDpNs#f2_4lAm9=)j523r4hY%Egy8`K*QkT<+%;VollsY-G9feL$bu^
z5wFfxx;1B6;1`X0pPIis5S-R~<iZ{1m$r0!>DqAT@oo!hOloFhJT122g9RV<_dYdj
z?a>K$`gE)kJ+|2URPOYUu5nv>HaWNd{5!iQU&idRsa(}8<mb;vlBNDhkN&=tel98L
z>xof+`y384Txz^zL!FKD-d{Mnzm;s%<x73^;<EzVm(42~v##*!`OBGK=kMzBEVr*i
z+QUWX<KKJ;y?4iI{GEpz&iiy6d+(ZZ*ZfU`it=KT?$jOcKjB4--EQl4{k^u~aKpPV
z#)o_OT8u8*dVk@qk8N(n>?m#}U)t<@t4#x2zn%ObcD7ujx#^t!%}Pf)#!Ppc)Ng~o
z)!Rz5s(7y%VldnL`?|R!v-TV7whI|;+R1vZooqqFWBom>o7EfYaZzu7zp;(0wtDR_
zvE8DM7j?QF8Ggi6Ib;8z(1fp*9v_IlzI2n_Iln3gjYsE)eLUK&j&sK(#~Ob%JQ%2Z
zxw^82!=$`wtrRt<7N^X)-qX6~vh2J@%NFNpwt8Z};d9FxbG<y;JJgd^FKjSL+o9uO
zqtqsoI;RfSuC9APJE+FTTFq<d*Jx+l$jm4`CN-dIq0OYasSmVk8Ty-q%k5;=RsL>%
zxOS?KwoeU@T5j(&a*e}%UR}+9yuNB+rAgB>LN8uD5#OS|-ldQkKNbeN)l8dKI`P!x
z%ClFkTD<hz_F>AK!41CnUmG{jx%S=CdE0kQnSbwbr%kug?<pmvMw(kJrwwm9UPt!#
zaxcwR@6%T*8*Hegmp^9MhR%EIv}|NCGOe5Q-xpsjNgi!t)%C`emw`XG^oVg?I&WX&
z`DTkcG@0Mz=J2V;)>`Jt!@646>f_#_$?n=@HKxAijl_Vu@J}E9`NwSPx9d&8q~&7|
z?9Hy+`9OYl<+{f4hL+CH%o`e57JYzpEe-Cs-1?^AO3L^rSE9PcL_I7@x^qmc)s_wf
zF4R5k+U8u9aQm|#o@^Uie99`%#e2M^W1aqrP78x7g`K>l`_O+*knYM>rK@$jPYSD{
z7;*BQZp*_}byvzuAM2)6$r-eN-rHt{F_V<i>Eq|jtFczs-%%RU>gQxH&)1zbBmBRN
zN`0dp-Ryiji$f0cd&X!cKXUqFklL%tU5C6X-s4lOmzG5R?09Tgi$gAXH@xr4$-jRl
z+HYHx>p<4J+rvL$%~?8aWiI?nnquF?^-H7Vt~1~2XpU}PI>E5mq{RehM~KRXsAKnM
z%szC#gwV%^ca80)*}rt%Gx4?3s7p%+htBTJYmD=F*sQbTY?HvEus4#~tq$*-ZWye+
zpdcmB@S*V$-6Y)+laf+nHG4QrvX?1pYS$Q8#X&bpJ1}+RBwdHfGL6ETlPpMEs}@*Y
zR>NUe^M}U|>{WWNJ^4Ln{E4W{$ri^lA8ebGG<#<J;<FuF4)rhbn~_y@``)2HoReED
z`aZIE-Jx-<+opvcoWAVpKe9&sY|bSt8X$i>yWpO6;rx)?($8)sZCy={hc)be>&=bi
zbEco47d~$A^2oqz&qB>Rytf<GEc;u(k^4d`Pc0mGPP<b7VN0LsZ@ZpsaB=5}<)8MA
z56r0Kl3pjQaqr}S#m{<evwxuZSTpBc&D<v~drxhde|zpSJ*&JMlL~YGNwl!*)qOz0
z!EScfwi;A=d?G*E;Osp2drkKHb<jFgqIsk1%*ypn8ipLRxvM)ez{Ah@>5;{&bIZmi
zkJ{0<mRr_kS?`PqnH!~_PH(Rr84)ya^5wJd$F0=QFTH-;)NSzYYa?w2clpaLGO+rk
zDb^1Y+77Ol)aTanvGe;jdog5S+T~N*8yw%fv~0{uN4ICw_1kW6>0G#7qs-`1w&M7L
z4$Tf6yWBW=$>M;UQ%9RG*eP8+<mNzKlg?+hn`lRVt#;|G#rmn6=8s&~{haNO#uq!~
z--?JdsQIJYix+MOjO4{`;}m+AdfY!&Gw5bk?Xa8azGt^LZE-k$+RwHxTAhfOteI0b
zzN`Lrn{Lv6;SVCiI;UPf{9byoW`4Sb#gH-E4d>qJnScCpfZL)``9)2pKMx(#$Z=bf
zeDmoeZGN=%Zga`!dg1td6Gi0(|LBw%Uh)iY6}r5jOt+TYqetMF$vZ>M^ycNX?Uw%D
zww8|DCY#<z-uE)oTi{{c`}F&U`SZd}!j>C8ZEQAWnTO4fRxe83Hl6oB`@SVvsXcsg
z;PS+0t<3axpSA6MBq67)`qpiRHFN@on@uSQHk-0H$?Z_S^~}sk)^jqKZ#KFV-C}0&
zS5H0D1$XoN&n){?+s*bsFLUqw9#TR~JdeEZE}!Do)a$R}_r_;KyIgXaf9>#ln~Tlz
zFU5z3e4VYo!ENcXhYj-2&A8fjoK3ZnONQsSv59V5D{XW)w=j#6u&*XPKiZB<+n!z)
zxivCB+9E%=bFbrm`G>rHPsHa8>v-gGrR(+$bk1HfbFI`bXN!OMwp9Nm5mk>S+g|9~
zZ0YnK7U$13ePiK&PR~YfZpS8<_7;xlU$A>$YWmvEVQs7V7++o%r`YY=&D!bSy22t8
z!}b^a>sW1j-skTca}TuaTGQZo{7v0?V+(3s&@kzG(x>d=x!Qm0-PpfUx8K@D=}*kl
zW9n!&u3LCz?mJoH`@C$&_a?I4mExW#3_YZl^<u~Q-rIJi@X__7ABQDmtdoY;&KMPD
zalXgI-Y$Fd9seHY*L6jcoWtFwf4p&(uyupG1T|{dXvXCRoowfS*pTyPe!Be*t7_xS
zO4ofz>bPTkS$l`5%})k3j=ZpI;mVkac~yScmJNzJ*68A{&Ucqb?~r%!9Qri%@AC<r
z*R0u~aecn)m#59Oy$^P-pFDe$hfG?!Zr+iSt;uJDp0>Mf)32u6F28zfqU>Da?R>({
zJD7ad-)KqFwQc=)Xu?jtI0y6gI~uQE>M`_bu0{VUi!b}?ZGN&c|Llr8$pPJ?^tI=i
zoZsR;c;f4}lhU?(8pfaRAUp56Py6twh*{Fz-eec|81;0>&1SlD`{#^#>fOj-@k`$+
z+n&62U1gnRwe)hSZv2;(8|_^R=6OC%P$ZFchx@0@6WZ%kbBnYH2-usfSt-AIZENd0
z8MA|*Iu8xmTV+jlS!nEGw?$9Lesi=}dZ*<Z{5zki5%uokh@9{)!@u8g+vSx}usy{=
zJAZNQX4XF@zO4HHP<AHpRCV9~zowAVBuWycLgu+72~kwiOfqE(k*R1@l%Z&%GBgiJ
zDw;%vlu9X0N`o{b%@h^?v+rH|X@A%Ac)k9=-RrvNyzl3%z0TU>Irnz<F4fm#%B|cV
z46|Q4ba1Lw{fu_UL@#R(y+=KAOdMq%&l(!0I&sM4Jk7pG9=y4<Dl@LfX^p&VI+ZUI
zwhz7YGNH#=jXc|3UQ4WR^zmI{t*&-+#DL5qo2K!mt;UY)e!R-9u@&|kH$zkGg?-D;
z3a2CkB~712-<`u0{j^pbEWZ=EaD}qyncQ#J%2j(ejlC-$yJly&;w~9sk4&4x?Q&^j
zlI?BAT)V%%`AZKgZ>7QB?b4GK-P7VDD|TvG7LBelkZLeI{MdHn&e|<g^=?^=xndyK
zU~q5jL4EsEyKn1N=bKfWiVLcZ%X@LuX#c3TyiLBku4npazIkG_->W@5eg471pf)wn
zcM`qU2IhAT4q6uH|Eu?(iX*};{hsxe8v6e5!0sC6>-t*_3$CzObx~=(hi=aJ__x38
z&e`8jPE1r@qqJ?VjX~J45$lU48U*y8abVAY^hkrX<7X>sj#s*zG_lXM)C0OPMv6Wv
zqEgoy?hIB7wy6ARC$UqxLpIXlNy(`nBYMZJRC?2Czb@m4gM#8k|GG7z#fxrN#1t03
zS61#n#AM0OBFQ&PV=W%_ugNdbcUZLdZ10##?gOQ5B1L_7T)KC;=i5KQ-Cw`*9O7M?
zY&7%w;@pKPGlr|aHcNi;Cv$TzbIV=5s#XiH?y=nJw)U&nt4m({G(T&79-BQ<$<Xic
zxcKZLmW|&gUb*;YoNdbbS{X~vw0`n8Jcm9mzR>32a(Z`~NYI4mN8~=Q8ts+!+}~bR
zqv3wPth6O2uJh)#Syq2vlz*Zu{Y2Rs-N?|^@nwq3cP#vQMJiEDO6C6h>Ag$D10GMf
z=v@7)P$;F%`M{n#68`opWzv5ud{yf9VqenepdS67TnpT>!oj9NN3(FER7c1-*{A)|
zTyr&kOjErtI-$2n=;JptBcgZTY&N#^u6nWJv(~Hn3%)B;zvi@>N$j=k`@1mZ(xG*B
zcBiZJ9^`Me+0gw}zY$*=Ch1QqACdTJ@?PaRb^ER?<|dz!j!m&DF47HU*Otw$4BjC>
zaH~PxtGnM+{H8wicE7Q<PmhA@lO^?kC<m&%QZ;UxXs4!=73r;3|3Kg9^!s6pjV8`l
zX&AQ3$0X_8yhSIIOwLWWYls<Kb9kM%-}MRA+JV0U6Q*cu=I(fYC1tbTq_58XeeR_!
zH(7el*m_R5_r#pM{9hmE7FPtyeG2P+)-JFpOD3yhT>8wM#$?C5z_RfzK~595PHdUA
zzR~r8)ZqCB!n0h5Z))}ln00r!+Et_4y!-O)yT*6+SXU9Pr|fj1(Mht#zEwhLS^Ax0
zZ<H+#{9M~_^xWfaK2i~NIq%!t7PL0BFPWESp*1LV|6B8v(YKz>KQ?(%<9nax8*%pP
z+DD$|YO1O4F&H`}s6_lxi}uo{Z90#3#wc9w&>mGWNj23&t<_cI!H<GY55KZ;)!N6t
zrFZx>-8<NF*xpZanqTs>)#Vevo``aMST3qRY~7aQ!JCD(3pA}Gg1S9Erk1bmwfWiB
zp})MkJ-%P~BgNTk#=BLbZ_fX!TCmG=&!2ej!Z4{SpPS()b!&=71?R1F^t>_u*TKk#
zh0=L7j^~Y>XUz6fb6z@Uu4CRq$B$RvC!4!3Y8`hpc4LeUFF^Td^4_)MC+<Aa+oF1-
zvRiIYy6*N(A;FvVZ4S9EjL3ElbiA^D`<J^%J}enIF~x4bQh;__`I^Sg%ylyxtzNax
zsaI`k>^C~1zSh1hB<Wd<_nd_xLuzIotkYPoe)n9juLF`7&2a7U^YreHOHrlk_NgDM
zKK-&Oe)gd5fikYEZ!el)`7plVdqqF9`t|*vy>xE>6K7tVo7hp%5i9GPGJ8Tz>RU6%
zQp1e4!pBP`PC1Wi(Jfu$-@M>_!QE2t#mB-N8|Oa>5zibqf7hfVw`a93y&gPt*-^a<
zdFIn<4w)Ld6dlbfc{ua<rpDFQ)6U<Xd%0lZfp%9v+v%O7LUS9Bm)#xw&@FcB8SNA0
z>TkAP8RR$T*@aos@+(d*Qabu_o6w{;b9$-BXXjQK^qP@#FKAO@&fsprmDYpAvM-Bl
zjS3y_=-SgZ$M^gAgHD+T?>?$>iMo4see>&@{moCkLOb_;N-Xj&)1BVwJA29aULWj~
z>viA#Z1K8anSHWjb^1W*SAO@>dOVoBW66Zj#ZK=JYfii^Hbc5<QM|leU}$dBVEcus
zhG+N0&v&_J?sn{9?em7Y-P=2t-MZ4=Yvd2tAD>nab?Lml@WUnZE!myJ`ZoMBe{fP}
zqD6f4`_8=blJ?aq91imS&{^Tv-plU$+Ii}kZ4vJ$t-k(JPdrin&I;4UfVV{p!cNVz
z?0;*;@jIFFX`lKQN7b13tDnB_!NSIavsUlAT{qA3l%~XjJjsKnS2%obI&F{}US@IW
zhwp?V{^38$D<oeP3pqVVTsNUXR6lQOV&fdi2JhcKCnC!Rq}~1bU02ReA!fF;Rn{ku
z33sYTRy;EGKU#k*@xh5X>G!sdQFeSa;7NynY?4OgF_rMcp+Scp-n%8@rjd0v_=2ok
zfQ+-a^N;a2+dKzPdy}*`Tzx}s-?Qq&7weZUJ63J~YWMk$B9r+BW;1-|Y1OW|^;FmC
z<MEr0R}IWf4K9RqQ*!@SkkWE~`!4CTQ)V>&($>m4d9-8bHsPk$*+(53^Di79_opiA
z{)hO2m8(KdzO}ekvw6X_k3A9&cXv9zOlna7*cW0WJcG8nH}zO>{nOpjVN>4AZk>^A
zu<P-@@S%kRw7z^#_7=X?<~N0>r7>iGRiWZT1J7ig`o?cu^LQd$a4*<>(Zpr)D;|#D
zA(_79i^_-okrjt$FI;%JrTN6kKRx>-Y#QWmUle+|vcmDQ^F71jVWF3MB^hd(y;045
z(-Ee0YxU0Tw%n^5Z&eJ^H{27TF#cPmynfco<!|2(IbnEd^r1Gn_WltcuQb?SxHiT6
zgY_i6Kd+5Pi0k}5biGIIr|VBY|G92oyE;ng)}9;pf5+auC1>ol=;A&<-YxCLH}<w3
zn=&xn+}D3q=9O8OZx3=xn!Tr_)66ZSZ%ybeok35J$Q~&Vv@tl)^W2ZyiX%VtIbJzR
z!}$CL!-_fjT8DPLU%%Jx>%yXiM+z2ha|zi{@Onhi>*S2#6_1Cney34buBB#ZI(dQ5
zj@+=+47VM{Pv?cKcL_-^c&%6T+I+O#Vc!N#pX*vhuOoe~e~Gxh<<;Qfb!Y6VmZXmL
z-tqLc#%O2zleeZvWrsAMi&m>vXc&Ghzwxw(!GNVL=Ua^9WP9XlMfw)&jI(Qzmo8Hr
z_gl^G;b$KWom)<}!BSN(&x~67WYbyANAn-w)qa$bxI63egPJYF4mVvtG(h=G!`!cD
zi{m;)whq5(2lp}Q{mf8N0igTbvrK1HhTI$9`@_i#@t@tUR83e|FY2Qlf4Q<$>DuKH
z(r>+7vO|Q-OT`_;W-h5OuLxdy+cTmje|Bup(dj|crcKj+lNEj`JlaXB<>%Up6;*}f
zJohe8Q{Ah3<oI`&ZQbsl{Qac=o%Iv6>e5YxWaG}1jL1LYZ`XI$38Qx>RCvbkw>~xq
zY5utD(bok_gYU@}`?cpCQ=W2f?TXEBqqaIN)VQX)y(pab)-JDNyz>k*@7Cfi)=Rfr
z5BfT0(e*v^gahQPr4yV+i_Lo7Q~T(=n@jcYEHvttz2nrYT6OIkvVApcMyTDnHM@C=
z^V};Rzh4`;G*NYFQfumVMU{-fwa<$iS1q|&^gPn-xYd`{Sx+9PMYdboTi3mN^t^FX
z&owKD9h+9JS0Ha0`|!EDlS*r_v1Rp9m9Y*3`oFUrC~6~i<9A;C2-639b*g{o6dqk`
zs`a41;#1Rb#iuo==BI`>Tb%J0>GeQfEjd9ft^AYMqkWg>hF+*^(%ve4S}ZhwqqXSR
z)R{N#AJ98mvQ0xG&#?P4b^nbMEao{@|In~k{QR^~&BDy((A3BmyOyhHz9?=iSlU*m
zby%ZArDjEOPTpN<`y2<?6<fr#E5}{28&PR`x@EpkcKFYP>m$k^x_bA2T%a5qSf+3x
z-|v@2cF(6xjZIIMuDdYsZdS;v=G`*S@6`>|-kSV7-aIa2Y3n}id2hWWhU;|lmYOZ&
z|Js7qiv<$6o~)cT#ct4anM~8r3Q2X3SVxVQBWz1H#l|G0n<(v1AFp2(b8x5a>ItP0
zGo~B&iRt^h?3Bmn16ngh=Umw&v$WM_?)3A)`$R3W66P+iD>jbUTC5wb^66q|)rEH#
zO|^q86ZVh#UcdZ7q`5-_Pu%pXQmkjcpFK1BXIv9GxbWK46DLCz)-TCW4op%=ReoYy
z(7e;=%YdoTmAlKfs@qi98b=6kzS1x0jMy0GM0<~bNe{fuldr{UY#cnjWm$QwhVpjD
zz4C+dYKpIPU+=o@v#`QiZB@HFwio4V<{t7tp|#>zzbP}FVw1KW_l-}P@zU3M?~DYe
z#JoAK$K3ubZ+!fI?1{Q>pC9-i?<Kph@6Z|d*QRG^9GNuwmVfFu`4O{rhdO3Dz8Se_
zYv4CUr42t6GG*TL0;O)5zU@dlpc$Qd-dK6lTg~)n=cK7pr^33~U)$Tp(^=a~A+wKf
zgT>P6{my$|lc~zGPT6BQT~q8_*gO9%_Vq(;o(N|iwZ6L|W!bRTlMURY77ma*w{`e-
zm2GLVlN)%4dR%>*HPECYMQ_5S+Dz59O$+j?T+32+7L7W$a?!^dx!=6FKse<*;{}~4
zopR#(Rd2bAovVMZ)X8*fS8e%xd1PJK%<)mS2RE4YSSH~$-D_ZiyjX(Mq)?F%?+o>%
zA^8bn_hfInC;N%(ZPU_!r@L+Ku5UY&N6stF*I9M-!|rIQeBn2PH%==UbNKX>k38ek
zgJjQDcZ~DOPS$AYqyI)Xu+%=%zNT;7+2pp2g!E{yPM4U<6EjXekN%U;GVb^G=Pt9X
z!?$HFUUKj4mC$W-jKjJIyniyLS3uM1usXL%3!|<(e^T_XQ`~WK*G*YRH>qBm#iebx
z3Qwq!J-_w3$61ArHLkX<mzK;~TJinMr^bPEAH>MYUrF6jTcQ0zTz+$IxAhVOqUwue
za$23U2OksBi4l=pY_?>9&Cze?*Ou0Zy)qHC3<)tc+-GLr-CZtFKdgGM+ZNm3%O314
z?-Oy!rdzhzI>{Ve-M|y0b-Q=d?0z+;^vs-jizgMOsd;^iofy90zP+1ur1Tlnn2`LZ
zcCCX=gtYP-1JatGoc=XM<=*{idVeIfA9z-T?^o;O)rhHl_}}*PLa@uD?Q2;^(dCko
zl5(D~LXT@oNn){;o8xYH{j7+)(Rnq-b(NNU=g73keBZADzQ14jHXge3+Iip!5uU7s
z_~rk#+wd>D%WrUYZ<Lgl@DA@=6I;6e%44}*K{xcG+cfp_<Af6zY3P}!zY%>UH!;<9
zW5v$Rv5)5&v<!UY{(HGXu=mi6mgIp|zpo}t3Da8Jwylry4N;#n$~!CiboW-aavnI4
zw|GJy!HLoHC?NmglS_1eS;m!F7WRYY^nTV>r@yghxJQI#R?OPL+c(=~+NR`KmD-xg
zIs_SvuT_uVe|nqcLD?rg&1Q|Lu{Cl`J~+AR&U4+AT01X?X$le>o=)!nCN1m8f-$Qf
z`j_mSe0_M)-A?`0Z!bmaf9w3Hy>j;k#pRbGcZ>5n51R+~Gnpbc@w#cfuFj&Vn-p9`
z49}HD+_$p1D`e_FQd)f4j@p*6(&Z8h?v_tn-v5rMkno{ComO^JJ`CF_Rek43oXW)f
z?2+oxQ$9Y-f9Y{4J9323{g-OS)2_Kq82G_|WJ>1ihke~kHzf)e?(G=l`|N|l#_PRW
zYb{pW>~0LHcX5gNZg(ia?~~@Ps*B=>$FF*p(z5FDgNw3P&Kx;?tyTF`Q$~V!hu!Hz
zbM@c7{yDh${XD<4A>jdrR{L+?$v9N_c`vU#NX6Sr`j$<&NJXnpxVgiK#KR{no)m|d
z6={A-H8HB*m{#g(vRtwEDHY3$PsdGKarMaN**Xr#avo&&oAV&!pqRp)wt34}<rK(_
z_$F#IGskw!8p*UHsU_dDZ|>PU&@s!<UHE>m>EfMsYmS7?YW;I?|GfLV_g_$$CwpZ{
zTIlrTIAc%u+Ku9acOCs)8)WmRk7jbclH^3UUqVX;u4^j0aOY8}y-a27uJO56?KuO^
zrn;Q}mH%uUZ}$l4H$yj#zrQg5tfkptF|)zpmK8bYgoTR^&l=lr$Co*KMr4(L>s~se
zd{sv0?Jpj!pFP|*+^o2B`BZj`hqJ*er}skFQ`FX-nGlive9N3McWX|@1RoWDY_2d*
zaqQD?bMoE{*E;>_)!26*Hh9}>toWoO`LO#+XSq<r*G~smHOD==R9PsO(N8=*qp8oQ
zA#%Mow2dw6rS)D#I`O${+5H}eeS#mY(%z6ULU)Sg9NiX)U!M}rf2=ILVe&&)S7O`p
zofqFe{oVI?d4_yXuhXfw-xZh%n;U6W=ZmPF^OkvXCHCj4kvG1qv^(XyYf#8m`N7}c
zc6uCFZ|#<rE>R$_tQr!V*q*xo(?B!1xbWEb@h9KvY*t9uPU$-#%GhI&?Xd0MRz_Ca
z{Yp+Zep|n`^2fgFDfb5_9nzDQeBa+k>WfF%t`|QPtJBjg6mRt?lZzVgd+3~%_I*|#
zGT$yMcdoYT;6R_XYQJ21-a9j2R_(fB;Yg7|W_Nxlw13=pciPgEo4S7;a!d0b{XdMf
zy$u<K+utUqXCVh}_Q|w)EElX^_x6aoT%B0z=RA*rquU>!K7P3OMwN#WGTk&xr|r4-
zOkd<$$i<n3lT+8UHH=%?9@Z=H+2KRu(mbCPA5FcObvDz_p!4Wizr0Y-C;KNq*`F6S
zd+98Hd9MXi9;iQ?m1)>E=g?AXzZ|F2Q=H~So%f%7s3q^H-mx#qf2O=TzbNrQ^_eN@
zv-dQ;75lNPX6S+Fl*my|8+Q*1x33HH40vX^>twC`*s}%a%Z4BAXgesEJSJ_bSJn)d
zRO{1o%)KY&uGUKZ@x}4@o*|wWoNStIO*VWq%Rekdag(}lcEZDkcZ=@@`n`U<!FvBE
zqi=;b7TF)WS92l6IIwceay6+ZUwiG;(3X$%Hf&RzX8dh#-L1D@CSQ<EDc#&^-JE{j
zv|;F+TE)i0&mv4`8DCKxq0y3^{Y~rD^=7GO1*XQ<{`Zd?ubix_mv>3_QMOiM;I^`1
zV;|_P%D6pZ%c=~UZ9kQ#K5SnSJ!E%_-sHoH;=7)FYWx!up7ngKU%ckQW7loG)2e1~
zv))?1?X-Ss(cYx+S*OAe1g7jh(UIyhs^o>W^Rk9z>OEy|jkBG0B>&og!Heb?8?Drp
z9x-`w(D|I9BfmT=xtVAGWA-lfn(v7@H=U2(IQ2NOB`iW`poXRDaxvL22Idk4>AAx<
zmd%WOwxvlzZShirqK7SuHw+w6J*MN#+;L65<6K`<_NZDp*WPom`O0LYqb(n7a)XSw
z{aR*bcd^gGmv2H&hDo1|dh&Sb+3&@9_MhfXSZwF)W}0{4!G(^2w|sk>_+H4kV!pp{
zsBQQBQ<@!~C-k2*e%yX<n@!OUv&zjuDOybzym=;{)SN#E^*baP-gm>9K>PNxXjR3Y
zy0(_?lPdb9&J4E+ENVXKTkjh)ZT6+Kw=N2Y^S^KRw*K|;K*qX~o)e9}Pxt@z(@f~x
z7;E2)^5x}Uc9ywF7={Y1EE_UtYG;xD;ED);^UIF|5=P3VpH>p`HyGgZscFm{FPC_~
z#=K^^>H+Ih$JKX!FdKDT{-fJng{v<{&GkNCA(!OQHmS8yL9TdJ{Dx?|9ZL*W&R(n2
zQ#9ggbbW@bX8q0$E%k4NJ%2qPdiQtPpz_*mwcg*Gi`1vI%bPU1r`}v9AO1eaOd%{f
z!r!iEgs)ALyYH2I)3?8iz15gA!PZSJTTK7#jbpYNr9#W}tR$Wn)y|BmoZn~A2O-g?
zDcj~HS<g}s+UvILQ+$}z0M*_D{+#pQI6dl2aD)x7pK~9F-YZU6xGC&&$~^QaBUwE+
z$FFEy^#@1kw|3GU1CNcYJCYb=woPKK*W$oSdM=`0e~bD~Tl%xg;)0`J%|oyAhJV^$
zs|^i2-1qX#h;eRONwb1&=ZQEL4)}U^w%MTI5dEML-*y;e9Z-$#W0pVYtxb=9q7xLl
zk8A$5#CgZoOapg=VXc=-{H9Od_&LYK)njzeck`R>NF*=6H-@({x|?U&(CTJ|k}Vq(
z4BhVLt$TLHrPV{?rm~01$tt<TU$+k2&W|4}nc+29$K~|)3ol&l{Kb_6nvBospB`NQ
zN4{Z|^VKikBTG&nxU(hG%~0=IcS+5QvM)9cv)PxBpZ>LSi^8NL`2gD$U;Lz(#qHKI
z>EV6;(!y@@3VXki*gxp?^9{cm0@}pmcXf*$eV`%k!_(P5l6qGHYF`Oe|6c1B7;!4F
z>a0*ikJDRJ9BpP#s`|WLZDOgo#35@#-Ye;uGfx-!9}XXSdC-q@BK3x1%{BQ=B4tTu
zETxq$3O{;3bz{@ewrvBRs{FYA(r5qq1jn@Nm)z!Us;&3Sbt>4~o*Hn`zT-=>_N70~
z(=PpKxb3=F$0FkAg&d)CGIh0idY6VcE;sUOd*j{t#`{Z4<)*-Ib^2pN3oM-sjF0C^
zZua>iB7Uc*Qtj8|bEhq4m&WE?9G#-su`h0T{`r&Z%{5mo&zLeZVg9bDKc$jszDbTc
zl4@JDEeGgm*9C5s)UzGir~GND@QwxRwnSaZP)!WIA^mgsw4#8*c~w^|WZiC?uFafq
zaix2F<@`#MTEmv<i92U1y`S-JUR{%TOk~Z>9l~pl?7Y2rN1ve{VmqZn4%|yj%H1rf
zqcSSY$m&zunTMCg>xZ3e&eaefBzn&$?ozL|+p!gk^j&A%Y%tl?*z!SncFD8q^^<v)
zTQr2Vg$}Il9957d<(`zXY~Zndw?5yTbkn*i`25}r`)@63K9_oH%9Z#^%QLZ4m+g2m
z|E{cTYUgNS|Ckp_mosaxHkFj^zMDE$|Am+P%p0|)HwKlpMXr0{dHTtq4$t87X;y;@
zPKW5eKIAjc`T39TYD2=VuT9KXl$$2HVV|^3T5M<LthxS<4MRWXhTo3M_qymFBXYz=
zMBZ$s;j%yKs}t<smbZD_RMVVvF)~}}rfjF3P{szM57$y#<}Dd0^YQz1+Zw0s;@$36
zJFY!2JSu#p+^x6i!(V&otv+m!X*8w1L%y%=oHNg>9WJO&d!ltN{Gf+|p60Bh<-RGS
z#b^7+-<~^iR`_zI8G{{e?o6;v89RCH?S`q32MfDQUnBE*bd$I60$1M_(^8`!hCQ!!
zf8G>6@U?S~$b?UubzA56&YGZ8Kca8v$BQjG?{aq!d0X&$ceP*XoGfvNTU+O^(ET*$
zLb$OrcZYd)=v^7h-ucdJvbEDqo<`l;bZCcIwwbJNuuF|z!q@isE)OqkD|(QU`?87q
zj}s$jPLe5-sgZi_KPuU%Nz7;G_zSPE?T%a-yT|^(o9&^e^dE<{iqwZp{&qZJrFfr#
z8O>I8GsZqxH8e_n-~K(v&925(FFe_<sOdRkbkmh7s_)m0-0<4SPSJSpxyOsFOAU(G
zCSUO$-O$v-K7K_+aQ5rT<60L4|Jr5sbW7IPwM|dzAE_Q#f3MwY!N&NSk@bn2x6O_-
z3Dw_Kel(?go@YegUXHClEhZ()pN)KXU#M67(iqvy%adf5&Kz1i_-@tL+CF71t#S@~
z4dj0BXs91~M!iirEA*q?X4kE1fzuEAdVbhoIzsjF!_9@euSE&FnR+g|G5YJH&If%>
z4n6eHuCZ=@FtYe+-$h&Z@5x#Dx_*xC=6;Ws#3i^YN$gMPXFB54uARE;hMW0Jo+#b$
zu;-Z$?i;7oA<A!xPnj#b%Ds-bD`i>vYi4hAWjV<`=eO4MdG7tO!%nto!LuIM4h&Wm
zJrgafth_KuOut#Rh9~L1TI@!X*Y?~A^{s_#-VJCyny_+k^W;anQ<Y`hO;+4jX<qwa
z(DvnSRSJ4Br52H{M~;s_x475m=lir=l6;2Tcz@%l$L3q<+nyFL|B(Dkaq5VLekm5Y
zj_UrQ*OaE&op3oWvhKalS=%o@*){{RGVkvmD`|RX{R*Xa`H$*bhj`B%cl_Z=W33+D
zv!g3dgcd6v{O}@n)gCL0yG0H69-jyuo;_2=!?Q|k_PHr`wIBB?f7zcM+)bot>K=)i
zuD=|fM0YRj>lHBCciYKkgBbyJ`$}4mB=$_0^G0Ipyj36k_w3gyT3A#2;KHI;E`1L4
zIca=<?17tydmZ-gz0!Kbz<cpe6Eg}nj!Yc#<?B4rTRR+TOZE<Zn7C-pQTGe?ws@{Q
zyLR2&Syx}LT>itU?_R~PDRuj%xDAPu4VoKQwsLuJ;>ID0oqJV!3SIS5>!Wvf$>d|t
zQyp8?KATOEEL?t0b<o4=kn;Roi^6v|&R;nDAT0WvioxaKg%bVGSEd=+TSQ&7j~^(!
zQnfn!yTZn+7D{n3%A;g_R5LXC`<?i+>zm}3DWim*{@ACITKK1XpPPqY$4(iVC41*n
z^0KO^--|E)j5JFcXP{}N)Z!%+lvUTP5xp^KMa$JuT1htB<YbI5N)L+ZZ%}6;H^1DW
z^u_t`r=df>YirGW5dUmi<+M7-_t8}s{L81Gnm_UOy1Gf3LiG#lEVeD#rZQj3Bw<I7
zZrzV&A3Rvr;AwVQxxWAU-g{NW3_osM61u~)Jlx^ejY;jiyv~BcKQWJ#dOfV$k$CIu
zr)&M9uNOKt7b)mCbnCG#-R+EAU7w2q!wZ`WC#J5iz3pfHbbZgBMbo34EPS48?Os2$
zYRDG1#FYp10wwQ%?vNf;pxQt4`ni0SeIE;(CFBnt(w!&WU^_RW?%)y2y~RiUbfO#s
zOw{(@8ox+?-vnXHqh}J9?N*6i_<g#an?h~gBgd)7-5cEX*QTbv8RB=mbctP-oOP5!
zyv&3}lfD(ZuMl7Q=AiPV$`@a@&;P1>DL8gQuvD}A)Z~qO`aG7FR&DtC;;UQvA(h1W
z+WE$sKkjcdS1>D4OYFYm{PS^QhvJM)zjmDSkcj%_RK4`DbhP5;tW!&$dI-O5o^|Z0
zoZG@>Px@7ex4yh5GF59;dX02Qd#d)dhH1klhQy`~U$|mqNW}VwpES%r44FLZ-Na#S
zmXE%Ty%lh6mziA9==a|@<vz{WY!{`pWPA^IU6YfWFI%|P7<O-dGw*xs5zEwlN~-Gi
zU-va0c0T7*8YMMf->$dgm;8$38R-qfGF&sVe$Kid_r1Au@4Rjsa-KKs>nYt9(i(NJ
zMt|yyW#=VI>s9iX)la@t_`6E>WX(6ZhkMdpCa>Jwaqi|)@5g1kz4dBaWt+yzMcVx=
zUvRwNG1aE=>LGf@-Pd0U>Hn-EUgq(o>lLoAUmgGY#duu&_RJLTn)akkrq@Q@vyT&Q
zKYp#m+Ons7)tY0kJcV^X9qM&9`1y;uirrt&oH5EiZA0*<W)I!u0}EFeg|E+B>M5SK
zB<Fs%zP4PLw(YpeiFvv5VL`{eUN`gzS<)=sH~VAFtCywH$;*CUKem4dFHhg9_c6t(
z(!>9hnlwLhtC;&>-x*DtS4T$PT37YGt!}~DnIex?I<0Xrf3Ritn(tf9%~wbocAsnh
zC)YG;gK1b;(cHY!>f;lP7lgMS>6;g{+rins^S9#2{iYiRmvye}VIb3gPS2$I#_zW+
z_m&^LrB~I9A6GMX+^x>|(Z6o~ow9j$Ei%C+hZh}ee`WGaV~FhLZBnkHp`vYay18+&
zI;(fC6WVygQe*g<?@s1vof~)0k$bnyzVABwkITi6T($l2{OpJKFV9STe{fcv+*~vB
zr&@0(FP1*`rP^r3biMd@Vc$(Y4p`hb$7;HXQHA>+k*(SLq@ykkJyOoAc;?WyKKk5@
z82J*RB=rf^hU@Ytj#gXw;B3HTwQE_!ZKlkOI6bYdW0TNB#UWzXJ_oL=H2S<{YMq<k
zfRi7R9<;RWa&9=Z$Nl!f+gmb@uF1M*Z5ecW;=HG4|NPF<aIFfNpzPb<rDfmRmV}^G
zht9B}UbRNI7HrNn*(P<m<z4a0y4Q32Ij@hg+b}Ff{rGA>{i<0*7WF(CddYNYqeb#B
zk<Hs{g;azk)5guvUfelJW=xdJsNz(W%x&jyt_&O~Kg!3_ruPbuRc6iKmEWYLwV6&F
zrML1;?4hG2l2`f-E;w$~tJev?J)Un)-I%7O|J`Kh&lRc%=1=yS+~;sx?WJU^V-|UX
zo|o&raws`)v_)x?<Cd0PPqOWF#E0j+x>CP;xzySrMbDl-t6uJA{l?&u+=uNme>aJ*
zyn6n_>l?q+k6ygr>&^O#6Q?pNF5S8~JZoRixw+;yduWTdo{INUY#T12zWcSo{R!Rs
zHU4^Az1OV4uy4&iAtkvW>;C<DPW89%XAbV}8r2YUQ|ZtJ+Y94{sj7}z>hz&+QvSQ|
z-^Jg(y!fzvZ=+J)=fV%)q;{D)=nv@-dUO1~!vuG?_~FkIm#K_6rI|IbLZZZ@xAdjw
zKdmoZRqEZg_(!{h)cCScZ~Ko4Ev1jw6brR)`H*3E?y_M>p~IF9J8PS7R4HyBRbk#!
zxn{zF`j(@`TJOppRSt?6cs4RuGJIiuT0!19iQ}G|`X{Z<wtjA)aN&aCqNW9@TWZE^
z=oH&I>o`0ckKWHPfd`<`eQu2_$L7VCm3n-T8lKy<q1ChYs8x)~{hp7uL~A{}mwe}N
zy84vHQ-9)<?=3kW>Y%npH2k+oaMW{k&!GiUn@X;!H|ors{e7A0=NM7-xakYFol!cv
z%lD<#CQs+|l=gKGp1CB)tk1qTNGz;-j%oA#@A*NkPjc?0SWcedrIsBmU8YbFt*Y|M
zQ9SwF=ztW%w<Bv>@)p!gyQI5f?CwRn>ut_HxKehzvi+URuA<I$ODlSt9-KSG`;NsP
zi?PYQ-^O#xU|Ka-Bz7BpyZDiwT*HzZdyHDlY`eX*{JNmBaI^QCxP_Nqy=@<==MyGc
zX??zUR}Z_Z+S5OpXappGJiIeV<7cK9&u??o#eu=<w{BP{1^1ot@~wQK#r0<!L$dcs
z=x3Jtr{B5Ky&<qga>jP`p#R_1vdGteO5BV5S2T95EE;dRRu(*RkiT{nC;iu2S@s+w
z&(R}k0Wr#7D~nqYYoiFaFxGle3u)DLVm8v_Bf3kgT1hKe(3P^Rq(lrv5VMpLJex3p
zZ;i)uC-3%T?Je%Gbs{#>I>O_n2UuL@mfEVKYi*JL(M?hZaomEewI$Ld#C>SR?VchZ
zaH*Ahloau6lkmU%`m7}Uh4X@QmG$hVkn~R_Tj@2*f;Fmt^Q}N0oSlutpY`PY)`{9k
zzfcm{Db$^BfXkm-1Z)y_8ocq`%K(CzN#1E(Hi=9iYlv}iSubWu))2Fi=A5|SU0R1j
z>{?=$QpCnGu+heCGdB3^knwHs*CFHEc=T@@7JM7UU}Nw<epvsrmKooM)jxi;{+A6~
zk~fJVm%4$CWD?6HvL4zdQEO?{jbfaQ_1&zbP1cFqNN-ja=A1F%T;t4hr^`vX)8|5C
zA!WkZum@We#2~+1>`8s$s>eU|g$qeEDi<66v2k#$JovFmm^+vMJ$8+<a0NQnR?2|O
zsvM4ug?ynLxqJoXC>+2RqXj9(E)&WA|GqXG|37~Ik4^4>eQ}}v%lT~x6e9emX#S6!
zza#QLt3Lhx{Qt6+n;LhR5U)3HJRCmYuNm&ylklKihLKGXPXAv?<ewEM{`XUne|inf
z>55mFvtIoDOoacG&cFL~OXQ!PhZ4cN2)CB>e<cx~@_%9OyoPnbRl4A+U2yd-xJDOT
z^Ix3QQ^C_q|Mw&EEEGYH{lA?5AJ({<2*c$+A6oLaME_MX{I<+f`sbOY^nfX#m!SaO
z9f9Kr3D&+4<>@2+e9&7X?hbqw;@-f$5EqOAqP%d#LqNX)@n!sdI$Hhxa20UDdH>}x
zz~lZR{#F8T^58x;Z3b?Ocq;G{h-Uy-f<A}Z+7H|f@hoZw@jT!IPyq|ZHc8%2#Lt7C
zt`)=I<^Gfaw<TjVldkf&C3$r14*Jne;P3x-O?+|}xCzYHsQwXuLzH)d0(gH8T#(P-
z4_^b{`WNxH8i5Pq^!LNhz>EGO{+8fb$fCST#06tE*Dg@G2=n(vc|wQ_%3GAzgzQLz
z{tn_Yz@H+{AD6iP*%!q}3H0RI9&8e<ttZO!KwJa#JrLIe9*Q`5@FVFraJ?M|oIDem
zO;*5V5uXg4JTQk%4#4Re4)n9x!0DPvl+Opg4cQT#rzo!;abM6^BEA^-ImE+&=OP{j
zd_UrAfR`e^9{3}~H}dzD{x#xl1^s8F-w9j>wcp*qdm?@ixH#fD!09u_X*>n}izrV6
z>Cb>(4{^bqPn2hZcp2#FnrYPjHQ=+5z6v;9`;hAI0}n&`THry5zW^SC_*>vUh<^aS
z0`afFcOd?g<GrbK%sW|=?!P$cm;Z~acfk$1;N!aBwq0;Xj`wBeb?)G+R~Pz#E_hTI
zd~Fvzp5uM_s~re3<X<mwn+LkkleOypD?a&rJ3ao1F#p<$+q=<){$UrKta0~W_Jz6e
z?7w)wF8GixxOo?xtZDgQ_WioxWX-t$(y!}+Z|{Pqcft2@ye~7~rsYD`4*jou$=a3w
z#ou+oMY!?4FZYio{<SE#Gnmi+&i44%mmIg?_<z}V?1Gau;QmW5--SO>{Cxk;|M}OX
zT)wG%{&)V*zs}_N89tZiwgicP&B$$5cabkyW1}x~T_6~bdAxQ$|9f2!OAWFQSkm(3
z{qsOr*QI`8zOH^jt|4CJ`L;Y)SMTt}p02K1Iy^0VOa32SvZY7<=#xJN<c}fwV?_QK
zlRqZp&uH>TS8xdb7+wBBy8NSb`G@K9kJIHJsLMZ6mw%`(|5!c#v3i31_{Zw;kJaNJ
ztH(c9kAJKl|5!c#vHE<yzCg*hqtCaaFL0TEtbu?CJ{26rx2Dgxrq8!#Ao$Dw)PR4i
z0bg&xw{O7L8wesGu*pBxkZ;+LuQB8wYbfA+jUiue$hT(5w_wQ6#gK2=h<~gRUt`4A
z81d~G@sBm)>y7x<jQB?x@$DP&k2U6hYRo^%n17Tp|0rX=O=G@IV<X;wub~|h7#bcJ
zNFJgY7Ua4pG-xqz(K1(V`E0+%K4fcQP`F2c7uj+T32~2%AX|Qm$rCWiR*=UcFVC?5
zStUU5#4etXR~Yv|W*&JWF!wazz+hJn@VtXLvtiymZ|{KcP~ZPJ%+=S+eW4e(fPz<8
zghx0h<UjuFzl7vrwmeSa%{{Q!Z?PZsfjr`t%P)+3WLOYA3s7+@D|o|s0SOBV_+P-R
z{tXY6=07v{ZvzSRTg>|#F#g%N3XBPS<doq7VKiedK>s7*_F+LSSK_3nzpJOOzbkow
zC@(aOJM9pjy9a4^Z2N=<pwVab^5_Qtk!bu!7XRZN4M&LAQa^5u38ds6PW)H-A2|q~
z#`|A+!*hE79{o20usZu+AUI!$>R-$*w+^dG&?mcvxGxUn3h}=(_H_63^>PglUdWZ_
ze|-*5`R0Nb;u#2wz5lOu`h3`~ZMX*qbL(k@g+%_n(?ISM`EoDrVdnfa1Nu#F_~zf0
zp?n^2qW9xolrIKO^n(~q*PtW%MGU9c^@RH~Jc-*TiP%x#Uex{$0=b0q-6z0&J$bGp
z)gJ>+^yD4`<!2b~$8f>*s~}%8dQkmGM$h`+!En}pG5)+&V27-WN$m)(FaPa79T%~m
zg6qY9>!*T!qG$bCz;M<dFUB7w#vj4;*1zqqWbCkU6I?(2Tc5}1S${4vob~4l<Bu}q
zPZgtQ%jFrvS$_oA2ZA`0Sp$tTxjrC?#D}#*ugh@#lqG;mIG!UI&ibzjoV*R?UNm1L
zM$hIup3$@QlinLA`LgFlugeH$?W|<%u=R5jlP?>8x;8bj!}@=au``VE{}^M3&9|80
zte<pkZ0u(<qi6m3!*JFgQEvW768Tt#d(n9I1di=1Fr4*gIKx^0r!buL$A#gnKMR2q
ze}*&u1TuQo{tAY({*dbfl8FC-+>4$U=^IHRJcxTyPR^Yq!h^XN<?uK%etbqS+?v}a
ziRj6rYpI^?pUFK`$_H}WBoTcW_o7^vKrWH<9m%~YHztrvL{IL`Qcj){O%l<oaxcp1
z{a&mm=S~vQlh3H0{;nPC6N#8hM6b@hsD2B9T*CTn0p{yRaobdX95~j~>k49DgVEpW
zLjMLh(Q7jLrY`jKJ|xj=F?va+Ut;5_44mk-8U4sE^yZ9ShtXSip?6{Qq^xOtJiE{@
zXY_iEKDrD2E=EtjBcS&8bfG`X=nWYCg)a0D7`-8*f6|5iJEJ#Z^zB{f$8s8yNIfBQ
z73#k|fm|Y-eCI&<Yy!DN%8RrS$`=yIC8Fo1RsZna1agV!O}H1;XA{UJtf%#p@F?y@
z_4kOFON5iT7UlH5G~vq`F3rSYG{Y4bK8E4L8E(pOvPK_C*iRdVui!qX{>)|gN`?nB
zd=<k5_i_InpIAoE#*?n?P2x$)j^>-$h5j7F*?j2(A91<dV)Sgjb-;1HZ@SQn5h0hz
z8|lNTpL9(@98bEoG|`ixgX*=w4$-e>I9)@U@HGsd$mGkG?-Yi!^>7};*?L0mQ<8-J
zB=;97XUlgpV`m&Ep#G;bdN!Vi86M5(={$t={c9P1im`9b@FIqfXZSUSTQK}K!zVDj
zhT&2ir~Se!;3N+0IQxO&>^S?C;p-Ut<GF2;h#j_{ao|%yJ+b7rY20W(gX8ZHdcw)Q
zEvhGNkR-y{a$&Et*#2Z2UoFtH{R!=_h@JJ^i`vfvJvluqh6}!*{C7Q}-vbgm#0P4p
zhTA3y`}tCU`JDChBg0ug+ZfLJ*^_Cfq#S9!!x&EHPLvxnd?Ldq04IL3^>!x1+4y@g
zoQ*%*@3H5#g3+_*#rAt_e_jB35`P=U&&v$AW%xaYPh$8hhEHbrCx+WGoE<l#8P09;
z6Y-}z_Y!=M^Y<4Gl%E2-5&}8DKO}lp;5`t33Y^|+rgrG}aP&?#<$~|0{;sJ_II$`C
z9`NsP)+k>H_LZ1?i9QZEorhDsJ#aGDC5dt!;2Hw_52xcRnVXSB^%9^bV=GCdUa|dv
zJ)a8nWSiDcN8q>~x-t4GjNY#cJ*mSa5r0U#pmE$uAeRWA%Drg52MFX6&Nokh|J6><
zGn}o@ml@91=WoDCzT}#M=G(#O*>)!d@gsWDXHq@=UK{(#w)g3bUJLACy(MFx#GKln
z+J)Ye(a&J?i@VUTWArl_eNq>CI<F>vMl*U@Zkr?$2Xf6t{iOAc=o1(o#%+^Ccp~?r
z`Ze4(NrbcYa4Vk*?2|Ew>eGM|JzFk^7|!-@CmGJx2ezJU<TTWNSM}s3V`meiZ(%qa
zA99UD5<V{r0p`bT4!2G7C4DJL_`FDLNg{Ec%e|=Hoj@)TK974*9!MaUu$^TB%-1_{
z+f>hv%WOPT8ND;3&j60?A7%9O8U2|q^jEsj-|0gCgyC%YzGFCBzMmP+w)cTTf)9xQ
zY<ZEnF-e58^^m>K;KF@I<3`H`$AO$XNu*rZI0x|QzsrS;(IgQ)8|QU=`fvSq;6%^H
zIjswQSLMRC3%1-ZGIrQFv-O{ia}A?s<1E}ooZ0br0e38oC);mqVR%>NV#(wi#OP_c
zkodSVoRl3&xV(G?n9tesW&11kd}(<RJM8)9Fm{5uZF*j8f5O(cuKEXhUc`Sl#?B;e
zn<VT%IY*L+-kp2VeCc@+?!oX-Zkr^++4{MLKrUhXY(LEE>3EIx|JQ!FSdcA0UpAgi
zz=@xp+>4$U?QaPu_c|zN$7L^uv*R)w|B;-AB;r5Y-nIBt5Fc-Do7x`>9G@@SZ?pA>
zjKw4oJzIZh|3El<zQi|@2xtAI?S;%$WrzS$Pk1MM0QZU_8(iuuc;nB72XfogZ#rHR
z8R0a^!v^6*Lt;nL2*DfQjvQ>0H%*3<d|j0VzyR_7>H;tx@za9^z#j4GkO_?&@rT%7
z3U+8cr~HbNzyKZZDEEL9qV1P*SF*vSHT=JVYXxH80P>ARd_xZb*oOFi1p(NJc!IP5
z97KFG*g1hX`TY_}#ez3}oQXf<$R93U6TJPy?+y}x`-o46g8hKFAK3qi_<0cl5ET-<
z)A;Cs|Gg1^p(xPN>j|n42K#DAuLTvy2=NPGht6-QojGv64oE)|Dk;5hO!a~_=DF{Z
zkY1~sz|Tm;jUnF+h$ln7DTwFw64*I_c*k%7KZ$sJe*vfW@u;6?l?0sL$D{m?q=3`=
z#*|wNFs}jG-vS-g55zA(oay~NYG)Ss*$>Kx@@REI2Fi##gI#UJQ=p!hA?^invqRiK
zNnoGe$D{e)?k(W-_m-5Kf<7GCnE-qp;*)@HL0lQ?$sWXMzn6!2e<^`KXArM~exnTW
zVCYck{W|LZIw<$2NM8be4utqo{VdRrMBE$7R|D}{6@i~)5LblqwL|<D#Cba6x4@q{
zh<}83LBD^bex^Ww;)(QIV89{2TO^6<wZP9H#GgUAgd@Ha>g{sGcR@cHjX3>}CUJ<L
zhkWVxo7A5(P(Sw~{Ub84aw!+_bU3d<#8sfYt|ER+Rbb~H;(PlD_zT3>K>cV(JP!tT
zaZ$l>)PL%aI^y+E4~-C~dP~G*K<|LK7{tc~aq4F<;`H|xD-fsolHXC1ME$4v9zdMt
zdjfHq?`_0wU_5$&_!*c4Jwe>3pTLiL#7_Z#hxj7s=bI7V3j7=5#{}kiZHTXhexnm{
zS@2U#OmHBL&lPB=Qiu<SeET5Y59)~=;;B$S2P3Wo`3^(88`x1pJO%2lHsWhRZ;1GO
z$k!C{Kp591ApQg9S5pzMQW3<(331vkd=RJgEe!FDVFEkRh&w?2*@?Ik<a+?|T9{wu
zAubF1g@{W+oXZi95*PS$8}VT1-)a$0QWognAT9;{k}}L|X#EKtBG7vxZVzz?M%)GB
zzY=k6sBamFOF<m65MK@b#u>zWLjAvtxFgi_JBTlbdi4zP`_O(G5pRHT>IdR0AwHrI
zZyFyr@V^h@&*6L(5l@1Cc@*NkA#Ns!%fk6uBfbdqu82#+{3-zP*b#zqj6{44j8p3o
z_kr`@hPXZG_adGE*D1#ke-CjukN6iQfj<?9*FihFkNBjK0)0K=kDz{jM0^R9%P+)3
z!5;~z7qlD)!+w9nr6F!Z5!Z)yq>cDNft$Rsh`T~OCn5eB;yD{}Uzj&8MEp4T6N316
z;A;@y2kkTm@ovz6o<RHqw2QNdUxEG0h@XKtKSVqq?7u?1657#c#CZ_U4#XG3cp(Ay
zXn9?LaaIZOawy*sh_8bFK?CvK;J+T?vQQ6A5VryU#v!f%{#YZf4*j+Z;yZwQB2MGz
zhxm-4f{GP{_%q<)hz|h19Pzs_KU|CWHy96+5U2fZ8se*9Tt0$$E5!d4;+9bErHIGC
z_*jKF{e8m|#J@v*evkMTXm>4$*Fn1zCKZQEwEjeZonDB4hyFqV@jUQf4e=s1fn6iS
z-++Bf#NWZV?0~okw09T8g`pf5A#MxTJ4+EC0{+AxE(QBr5&r@8a3A6mpdUDjIL)^Z
zaVKbBR}nt}<JUdJBVe3;fw-iIAfC;LUx9Yoj(9M%J8_5~`It-{6rn$qLHsS8uQKAU
zFn(zvJ{$T0Q^a?T6!>Y2cns8&S%}m5u?ONOp}qwn?hNg81>&9HXFTFMssevf5my9%
z4j?WIaXx|gL@2Kdh+9K@zkzrZjK4LA?|}1qjd&51;}^u;pxt&L-djm<UQ*C*X!+9h
zJq92i0sF%dkAZ$k5Am}C^E`9JO(FjFh@Vgw954^@5V+6mjkx=8fj$)RiEzEV25~z7
z*@QTqFQp+)=S4>lZ-n}A3UPlZmr}%EL4Bw~oQ@w)5D$j>(13Uw<og5h>(Cy>pgz)a
z{0_Q)h(odPlrV>VO~ju<KQIPyMQATJi2H#*GZFWJe#ss2L@39_h-X1LE=N2H?8hOV
zt|U0K6vVTkKiQA?0Ep*t#0^ORxm1k!ZD^0z5l;qx9wI)Yo4`&B;&)*D`i1yA=;wu?
zU!>(&P5WWQx4?c+#M@wA*AMZ#P_G6eo(}DI2;w85-xz`TIw;3+i0^@RYK3?`TyIWB
zd>_P<Uf<L6T?*su9Hbuz`XIzb;C#aoFNE=Z1>%Yj|Luq`fca7y;u=scdl5H)>%qf_
z9|1eLh-<^RpO1Jx)X#H>f0Gc@pG$}*KtEoCxEIvtXNVg>d|n}*1H1w8eb631Asz|#
zTM(ZLc77o~2l^i&s9&^v?|@z$@gYir^X-ZFc*wUO;t|k43`9H{%6ACj;V?g;_vffT
zeWBitLV8;$M_t4}LwhtvTn5HpGsN}P1?Odj_-&}4^AT@>dhUU^JY2{5B3=OPdNJY~
zVZITD_%CRWQHVD{JfjhphjDEe;$NYE+k<#C)XzhRm%@FOqlou_@;!;TFI+dBL%bF2
z-$9)I|B#1>)9cKqh*yF?uMl^IdiV?RYKVgn^ar&5m_Yj#N1O-!Lr=tGAZ{{<uZHUm
z+TT$7<H-h>^pM^K#t#$3n;_qDh|hrj#|rV~P!A^~J{S672gHlP|2c@~KzRir{sH_9
zN1V=Imm@w1>Sr|Kt<b*W5SN7hYCGZ;aK8Hyr`OlV5#I>qSd91_IIru74~2UB5OERc
zH(nu5zhD21_$R1W9f;q6_TB^fOIjaxL%GN!9s%F?sUkiN=ATB0_k(`S3h`p7_l}5f
zf;hM#?giyS?<Y||=RmoyKze29ml6<Hf_A+VaevSsMqCx<A*T>8h5o+`@sBWHrQ;9v
zGZ5<AbEMxtLeTC$AU*)vS3BYn&@LpPAEow-p?=CDegpPZ5T6eHzaHWWFdrL__(y@8
zys3yEg7J4g;`bm9ix9sH^?4cM^!d8$5!ZxqXFK8!N&<)WBQ6T{>ICBH5dVva_lNl2
zMEokW(^|xTfj{pNUk(1WBAy2IO%&PzEw3dIpT3Cqg7&3^IQ_kX7UJ<xUSkp819m1O
zz8TulT*L#QU+_kJv$`P8VTkL4owbO2K)u?G_*w9CH{yq3T*yV7&U?-y{uKI$Ylwe?
z{^ud$=V9LU8u5Nmj$aY~4to0IIa*%z5C>_P-%-94{82zW8sbmyA5;A>sBb1n?+NqT
ziHOI-_%ai55$Fdz5bp-%7>sx!l*=l_TcF?Di1>SmPa5Ke;Aa-%mtdcM-%ii>D8!*0
z>FIcO7x4k)KrX#N+yVOGkBC2n^7@Uq8}ROM9@HNb7&iwXeg^ub5r|7dz6OYoh4@cE
z{E-sheVzm2zab6_5T60_u>iz3fd5g5Z-x30hxiQWuju#u^nBaE|AR>X2I@mT;vEpj
z62!fLS0O$c`mv{oyTJI^i1;4Z|B3h{INxp%C+fc$_$h<<CFswGB3=dktq$V!cRAw_
ze*)vLJ>n*??}T_am`C{{UIXJGogY#E6`?)GAbl0Yb1UMF(7yH}9xE)US9yr9hW@J<
z@r_WQZy+8ZFvEL{cs9(VULkG+*DqfXr}|FB8(`kp6ON;C$cDHnBmM@;-4Jmduw#KZ
z{k_Lj#Gj}OPRtqcc&I17h%W-a!x6s${rOtNt)LwxBmNHJmVtN+w8w13>G!H<5RZUy
z@G|1%&|lp_{5_1n&k(2opR*D15@;9n_cgR!_Cb6^;hl0Rn8yr5JPYcx8sZ9&pElwT
zAP$CzKZp71Si~nl9A+YJ1pTBF;@zOU+z|f-dT+$_VV)3xcq-TlLEIMhBN0~yJ6jMx
z2Knwl+#Ig6G7+cWR~<xL8`{eW#BJfa;3DE45dTWVX?uBu_)r)}z9LS)FYZMAB)v|A
z^P}~IJ{N#nbC;he4+eimAWr|^pg!VDpx+yh_zakzOhH@<>WLHL+hDx#K|B-mVTcD3
zhq)AuxCYosLY!XLq$5tR-?I>Z1?6}eaZ?y~$`IcH?dvw;=b@i@ia71x8W7ip_S=g1
zTo@NbAg;8$x<h&QM!X%$WiaCOIZ*0|%R|1#h)cmd!3uG6=*OlbPQSNZfH?o*I$U|t
z>vih?YnWFrL;5K&KE@)xfnVx8-d4ovc)thn0;tcqh!;Y?T8Q{;INz&?KY(_05Ai7A
z^@vwN`F%p%5$ew$#NUFR{w|NkM;q$TK!`WxZ(tl8iFiGXJBEnMLw|0GxQn_Vpwkf-
zgL$AU;`IB|K*YC09F`;gMM+>k9&!48>kh=NVLo;U@fsn4odU!Ug8fp&4PkzA8*%#m
z*)znABn0-G5ch`jYD3%+{1J!xLd%7Yzk?7T3UO9Loc8lZh|_tRCE~Om&PQAZ`aM6y
z3t&DLfp`k+uS5I@__-Nz+AcB?7lQdf4&s|3-?ND8K)t$xcuyGDXg^KkIYm$`yn3Xc
z3hm+(;vrD~{~*3pSYSvB>IJp$4c9XR5l@AA<4D9qq2HkOi`vnFe%KP}3!q+2M_d%z
zqbuUH9R?y!pAWbkadVje#3P;x*SR|or{6mtLfi=Y{{qA-VH_z%{3w*;ZN&RQ`+bJ^
zOz6*>5O;<7SR3N2puLGhInX$h=UtQ3AMsM?4~HRs3hIF_;(K7<9PwZ30{c@C2lsi-
zh~I#HKg4Ik{mdl9H$$AaBc2aD9r0Rd7e^4UhH@`JyaeVUC5S&2oEGmE;`I8f7V#1&
z_xFhFLcZS-e-HMBpdX^;1<jP#3-JJG7pjQU-|HG8PJiz`0de|!@@a_E-;K{loc_){
z0&z_kk5?cb2JLh$;^lC@@tDK7kc0RkXpa{V{{{A|5Ko2qz(>SYNMN}ns>FZ$=XaI%
z&@X8rt`6;D65^?ng5wt>o(c6o3Go9^9}XdY68hC5#BE`oQ;oPc)bn?UD?+~^4C5`W
zKSLpI{SbE&=kXK$Jvi0>2E7&1FCQ+@J0Y$BdQZfU!THkp9ko9m?*F7Ay&>2yLOcb=
zqZ-67!1*>KE)Ki{@uM)Fs=)OS^=F#8;Jn5lZVesQ9K^>#zwL>58u%ZKcq+`F>3t3%
zE;}efe#WVco(!cB9$p&aa9X@Q3@1Zo8}!dP3@3KR@vZZCd59YUF9A;d83p_?;^Tq0
zFkF~pJIEg{(RnVlV<*78VGt+E=KwcF+zt3l#AAVb0H@{E0PW6~(ZeMW|A;t7PvYPU
zb~YmJ20RV%RN%W2PXc~`;UxZ7AoDzilYC1+pO1Jk@UsjjcIfqN8N-R4I?!K5yaxCq
zh7&tFP*GknoY<kyeRzks7%3nweE?2&$tf8U$R#mof0Wbtq%y-vRoDpi!GPh!P7E=^
zB?pERDP2d$iQz<_LBw2&U^uH^!*HU{=Bs(U-H4wCeg^Rp;I|Q%hd4X~PU~9<^bfBX
zJxme!mPDZ46FrIZc(5amxC!tc3@7D9+oK%Ai5>b}szHc*gB?wV6FXTjewi?w*vSC>
zSj4vjw_rFK>Sl2-k|r~p*!Sd9?%7I+?}Z79H{v-kE(9TN3H@*+aN-7urvcbcU^prF
zX;81y8BX*Tpg)DU4e(OL-GM)2I5AD1-~El@#C`zi`-~85P(POeS3^7+_yolBfKNlb
z0=NfoTHlgjUgyi`VJgf&B976M^1VzP<I+aN>2ns+5Pu2!-H6u$KfrKO?sH&3%40am
zm)`%(M_dBR>ny{G9b@R1${0@Ukae0!x{5e`K6@p@iJe0*E<a>Au@eAxY7t)uypG|-
z4*i`{Bg2WEG|+!Ud@FGNL$^5{2^T3B3+_eIK$wS8K2Lyoh72br=(=C#3@3JiLGR3P
zqNn|&Kf{TB1L!v}oai;c&m9aW`rV)}U^tQLf&MbXiT*U`>ln`JKQWx>%Rt{#Rj@(h
za0mEE#Ge4Czdxn=Ze)W?Q$bJLMI`C$xipip15->s4`cMC9O?69mmyvP=er*9R^SPU
ze+0f0aU~Icw!93)>GSS$5FZcvJjCgG+Qo=30(}YM-oURgoNcFf7*67l0Q&oguLb^?
z;cPp7i#Tm}-w=NX?Xf5H>!kQdxflw<!yAD(ogYqMI0>-~#F_p-U210u*zraBo}gcX
zI9<1IJ;RAViC||x!-)ynzH%8(^m{>njp0O3+ZTOK2KDni=)WU9ZC_$AkD&VdpjT!%
zu}}4S3@853d7uO0O<>0t@$bN+5g$w(;L>*B-MMX2?$4D8<?(hgdV24H@N<lw)T?t)
ze~J-50sK1RZ-L)J{5kMi#AQTDuAE<p_W<6ExGC^2h#LYI86~hsPM@3?oo}chzDywF
zSs)$*+zD~ouSPJOl;dZJ^LmDpe6zvMLBvl3FGl<#@cW2Y0B=T|_P1gh0s%eWHqiG2
z-ksYg<sJs{AHe8gsOBGG%;-tE({->-5uXWhwncm=aC^j)fKO*Q@yAV!pDoXs;UwR?
zpm#<58t{b-Cw9uj1$GuQoY;{7`yq%6178Q6#H|PSG8dTPWgtEq_&J7?a*u~{FJm~d
z6A1d}3@3WJ4(oe{6a5j;i)sosh*_eq2m8_tC;EJWjHiJ(tv^<X)B59rxG>m{WH`yU
z68JiXlYHrQ(;kKsJ$;UUHp7Wt5A0lFIML?<zs+!>r{5DbF`Vf4gT95~L>~gYj~2JX
zC9+HOrN9R<oana#H)c4|KLT#SaH6N{7EA+9+tFjV|2dP<lh0@hW%Q&T()++m5g!Tl
zFa~jd;Bkn%1K-7PQvd1iZ4NM;<a-G8M-Wd3o(r6uKJnj*dy#YnaVG)h)ia#Ljjp5I
z#BgFK2=x851sl}<8sNH!Cjy^__zvJci0=m;i}*R<`xs9A^nmg`%5dW64bb01oX%Ij
zApREgy>tW{^t`?TABp%M;MRyw1b^HaPW%i7?$2=I=Um|15cdOq67ewLw-H|h{2k)7
zALHo?940c7ZwKh5ffGjR+bX!v*^kjnaGWM?kxYIfdQuO0-T1paZUIStqWnA5LrcVM
zKyQP%G4QzzC;rg;X&wwG`KEy08}Ve|{tPE}Xgv=HPEKEndyVH_B&}jNIbZtR_-)9J
z7Tl-JWH|BXG~~Mv@dDt7k$rQBe<{OBJt^W|Bvmq;_+tn92E^wB7t!M%#xGlP|7V<F
zmnRFH$cUX{&<{hr8u&Pd6MwFP9b1MII}M=sWH`}Rf<BPpL{F~^;uuc!B4B4L!-;+q
z`H)M;5vTu;;0D8qR0!<cXE?F*4(v2AoD_*KluIka+4>-&&xyE1%n}n%$qtuf5x*nA
zJSB#cd_P0JnuycuQ&Zriy^!*PYQ?i>IH^}x!A}Ro%Ye^fII#oWHE#jKN&Tnw)|cVL
z{&TPsfcR73k%)f+z7p{!;A?@CxRE#vgE*uiPOp#7Ax@ura0hYveAjmjC#J7*FOt48
zoaB3qPkB5^xIm!gNcA!dC;IWA*Ff9>xE12Qz+D+m{5b*KkKx2VZ5Qhir}zJNBmM&H
zoI#xS|CbS`{rq!=v+;S)aN^HCXfGm$f{bW<sGmI<PV_m%7?*T_)A7O^zMnN^^l&M{
z*E=!#{v7EA^Z5mcivagW+#Yxk;uC<cKs*lk8pNZ3#{wtkOZ-&fd&#ZSj<^f(a}0+N
z@INVIII*)F^tTaD1pWc>bl^fpf(;sf8apY56Lu2x!w{$UD@+mp3VK__>2-k@;(eh$
zL@}J4uMF6UVL0(e8T9)RR|kF`aXSC6K%CCsUL#KD|7{E>{tN?uM2rO+Bs=0yG~}y{
zcmnXzi01>Jh<F)rPsHy6U&e6a4|F@cwG1cz)PsI6;=h5PW;k1~E-{?gk%td&BCZa+
z0r4@wI~Y!oHTNP(!bI>++#vQHK(B;2eXg+y;`DjM)`;%|J06JB-$g8CIFZg0xWS8N
zIPs?h?Ce4OI`FfIe*s>OxDYYMrFz8s0B>bDG2z8mbALt)HfVg5K(C0n8gOn=bbg|G
z`aEK8QTqSk?x1%=d<pPyh7*6n1&8xiGn`1*fIbuPoxslkr~UIWxUW*g=%Fj*=TOV&
z`*WlmK75Y&Mc}WH9r(E#uiF@b!z2zwYAV>}4PrP<5%{0zFr4V;f!><oL~je+iQz=Q
z6nGHBi9QZ^48w^&1^6z86Fr^h=P{h<3qXIF;e3C{33BNX!->9{PkFp%h7<h>&<jIA
zXna0_UXI~JuLSj3gW<$JU0=<D;Y9BS`q>O8`caUtKg0R{fPM|biGC93Qy5P41E5~z
zFr4UpK!1thL{IDCeTEY~U0<z%;Y2S1^|OQFL{Fbb-)}6p!zGd((c6MvmElBR3jUZe
zoaj~II@FQjL|+GbABGeCd(f|7IMLJV<xLDHdK2=8O9z0{c4yvOz$+L%nC5@*lF^fP
z*F-Ym(p$vo|G)TzcwaIp<I*?8djS6poSY`fmyY9NX5=WrJpftmo!ko}sSm@6KYC!N
zKjIp|6%ls;J{0k(z()e7{=m=qcm{~8^1b1{k41bE@YxI}Re1yOK!%g^bpgHtI4u|Y
zoY^&9@L0rWs|yUpBYr_%z>^TCzi-@%cyIVVX$Ru;_i5>f*GLNN??s&cPVXS%lcD}(
zBfc8y`7y-h6b1H4S(8L$efe90KlFY%=6;|dybq(_(FHH<g1_j3_aKJ3MD0%z?DFV3
zR)mvsr|T<dF?yC;FdUj9-%?N)oZb&69}_*jjxJ~Pz4#Uce_nOL`#}FnK4$giUGTsz
zczPF{&Vz`3X~v%)jGpE6|M_9P1@!Bf`**<;yWn&k0b-{o<Ig)r&+`7ze^b2`95WX2
zRlxrrd2b$1)$>2_UlfH<QAl;|BzqzuvfYHp5+(auc9%q=L?lIJsZ=VV6)j{ZTdRn&
zRMJjKDpcBjXYQTRdC!~Q`}6ode*gXE!M*1^&ud<<nb*8#&T`K=<3!?UtOA=3Pr}<K
z;nU&Z3+$5hsE{}qBT(|4gy&*h2`D5|8Ht0YK=Z+%=W&4;;AnoPZcJVh>UoE8blr~y
z?q`4)98!rTVt+UZN6$SVd1Hn&g;I>k%R{?O7(W2z(fezW9v2vALzuiQ<a}@(0`f2f
z7@Eu`;fa&*1`>yh3_SxR4qe6IXx;!|m&{e6vk*sPfhES#{t;G-aUFFwLo@RO<-_Ym
zg)&G#%A!Q#<nrs1IJq4yNSqvp&LmEb+dvX0_pcZdCyxUuBu*ZevPql|E`zT^5+{%I
zH6%{nU!XD|KOle3C&`2QqU#}w7@r5@hrHhb^62>4mLw0#iQ3qc#L4j%MB+#mphyxY
zw@W;UliMYg#L4ZFMdIXk$s=*(6M!z0IJsRaNu1m+H%Xk_E^Q=EZkHYsC%20j<e=<A
z#Q$ozE`{;kaD5TRAHsD7j7x!rCXx#Ci_u?zel#ByylgYh(eJ{#m^?bJHpDo(FUSPr
zA}~(YU|bS%YmB3L+|l_Z@&mdr(GinJ^FO&^d==F1jd4rJ{V<NMp9EtZji2cJ6_v*m
z>e+_L2SC09<B^b~xJ7z)Lyr0x;^=rH1=EA(gHOXax^8m><26wK35+*Eo`dl=$j@T@
z8RVBR{uy#~{*B822lDHfJRj`zs2?GDG#}LsOkM)YH(^{J@>a+}ctgY>r=fi`zCkg{
zOA;rKCvq?|kSC8PL8RjoP*#){z(ESglgE>NBu*YrIM|svfjoIUaU*f^c#=or<ncrj
z78>Xwk0-GtP99IFOtXw*8M1!@Nt`_1qHz+qiR>TLj)0T>!#MCK7~o|8p!@CtC;Mj`
zC^(S-C;O*{#L51d0tAT!zR3PT*Fga%`v*M_0XW$|=)P3I$^M}zglzSrySNhH^kC+<
zH(H{5gwrVs?k;o}ih^rM2t^?{0IUE>Wd&to)x+0C0SFOGApxPmZXO{{TYTu=PCfxn
z!5)DD!9?!AGGRXc9!~Ude<$AnFQ+ZRK6H<ND%ALY7k2XYaB=qt{tqF#OUUN`5OH&%
zdw2x|Z-rvaI{inUEdjxs|I;>8h^RUA#ee9e2fO%(c>bqWHy1Z=52w&T!t=mk<1YWV
zJDvPo{9U~MQ=zYqYp_f3*8feVOJJarhd-U+EoS4ph0sw;xqG;VdO7*{dj=3u!dP~3
zbq)3igT-Vb-vBpXpAb5T9#D2DN7UWR<DV?p-|OFkzC_R<<wV$_MSz_c>uv#lenbH&
z3jP6f4+Ud$8~G5riyILGjCC*nP=&zYfIyF6I%;nZZzs=S7e5c8AN+rj<`GIj*M-B?
zxJuperGGBKZaxl0i6y|uV-wh@3qB@Dcz$U@28>7l*Zhl#yg(;9E+Q5gNf&;j{ViN&
z$bw~54qdp6*B{+afbQD_c|anMRbU-lMg_YVUE-gdrnxiM0^#7SO00rKH1-NYVIT&|
zg4?%%gSQKmLtnUkCt|}y_QT<Yqi~oJ*as?c`%wg&$bZ+NeRO{hR5P9*`7agb|5y3p
zP5>QmqWpOI_YxZ>D*q5HKe`?c$`AHWc=?M7HlhEZA$0!-A;w6!{UU-+WPchw!1M+i
zi3IF}{UC0?i(nJlpG|Ba(tp*zosgNxeqazIJEaBe@Q4KL1DE3VfpK6TiV;i9gx)7;
zhXDM>>;Hq`6WQ0LGc%y$0AL^F#qERNNhYd)A-vFuuJbXq{k#8w--9NyA0Eogp-ZYi
z*ze=^RVJ}-F_)SDJ2DKv@%n@7F%#Lp4o?`UpmIb4^#|wJxP6z&?86R@o*Mu<K*H^V
z`^hG<-w8V|Iv)r2!S4sS{e(&E2ZEDBBBAGkm}~#GA3KTtga~F1Z(=)0z&@xFZvV<8
z_G94n`X-Q>l<@jrn#BGPyl{YiF9i01O5A?eB=#-9j*Up@K5ORMzw6&ViT!Wz#4v`~
z4id00Lj2?Q*@^fBBKY_h2!x3g$NU=q#Ou#O<e#Yh!{G(le3%p1UqJlh_Q7>PVE-S-
z#KihHXdi|lL6`~UN8ig~{&B@njt^c)x&?xslu$l|z<K>d<)=n7B?94r3MjuQ@sIMO
zav4uzzgL-=UxL_9PAETO>nF)SZ3$Dt1Us<6^MmJDCn|r+D`tK^(*9e5Kqx;dKe%4N
z2obaa7R*kaxv&<lqc2R1vS||g+5OBM<ndREKqx=5A3KTtLTDd$BV>L&KLXn)vETWQ
zDUr#j95eo9Ca|A5iG3vvX8x`J;s1k^*bf|F=121jgZNoAf&Cn4UkN#enT=AooVjot
z>u^X6R*O<FN&Xm9W`12H2=(Imt5JTq9evf9F_(bP$O)-K-{8C!EtBQ?V16<K%eZVO
zkslnY5numED8JG_=->E37#!yUop^phbEd>MYy+x4%Kx6&K2iUv8DdIMVSz#Wfi8{m
zqxhZ3Hpt0m2|g*5UU-oKbZ0N(AJ0FXU|5I|gt#9VUTB;P`!53$AGrT!5^SRUy`Pvl
z#<2S1`4yE_G^nJctiDu9ZJDa7iZYd|vP5~QiaPUCSxIT>k|hLNrn;1w!I?AK(A0>P
z<*!B-;x6*PYpBE&3ObetM3;eeDU!sUl;Tuyxd5C<GZwspT>`zSVIILDJ^}tz6;5Ki
zwVu^##x@^!su*!1Nr?D~QCFE;*jQUpJ$-yVeB71cH~dniDkvyW*VtH-M3%s9YG4~s
zYqZML5M>i%UM&!#hWJEya8ei+ttAO_k|E=kD3T#m3epKh<Z&6aT{471VHhAXF_cL9
zx&xyg{>0Zmk`*oS2Q6v8Gtq`+3yCdNz<IP}Z6NfAar{{Ze#W3BB>|BMwt{^m+`8c(
zn<aq?3N3DwcNZ_ARL|OmmiUV>_k|Waz?U?Kmb86ZqO}A!(?}JSkX@BnPfKiKf+S)S
zEv|;n)(F&B0^_EM&uPhOK&f&KQ^+*&EpvgE6iH()y%+K1U1$LE5Vc?k(~>L%QHH;A
zP$yv`w4Ijty$tk;e-xilcS7Fcf7A=*{-HOvo{yIJyBfHB!$v)aKMa>J%U1{LK_rHM
zN{9u$b*mEZ>)Dc=BnVtYBYZRsRg&R`#BN%Wsl>EZiH-mA##bab?hV4t|GOVd6UU%R
zq~{v&J1w?e5Y@p^&xu(J-i5mu<wx~ktT5|C-(W*yPAT%Y!KcxZ%=u_ZwnUw(8Eu(l
zL`CfrcZ<eraPw~yttN!52*-V-C57k`#;0xAh-~Uo{$&rwE;x4lNBc3uZ+t93?_5M<
zLwMG)uBbqMulXE9PoGGZY$^HiM6z^s@T!=X+7%o!ffeSQ0{VK>KC+yjacGmbDEmB<
z^;;9;f*x!-)@xmR`|4Ht;?vFi0`i=TWaccgY26unm3oRg|7>m=r|Rp5sH$hrdN#%w
z4FB$o(kZ`B{0)BGx_Z-{8R8vE@^!yP+UGs)do_2IV^~4SGVh+&u|YM>gFJ6vz1tWN
zJ@`3ZifwoBBF=>^UW>D)f024F!e7Vjc6+I){-cv>*V%oZmA)`@?EYijUqc^Tok(Bs
zr_JN=u<9Ajr%jxDM|obGD{8zt^Tl=QJx5K8!`BA~T{WX_jD0N@sZ$E=E)&UbjeN0b
z=z7o0ju@Gs`7)yZlvV8yR7~@Cs+=`hwA;i|=iHv#XU?6~Iv3Aram~7AvF3A~fcXMT
z-SQkBTJ1}G8<6w)tkk&{x?|ASd)7tvg}0xUSV(%hUoMZ{X_EQKzT|GQwYuu(s`Iwz
zP6&0qAAFqe;yGltr8@0gPO(+p*<<a~HqBLg!0i|GH8S6FTl24W!M3u2o{!nBbAQI)
zShuLiQ6u%YiQ<bH)53bE-dq<UBx#sjvwE;7=67R*rXYRl?NFssj*+Iu+L$#wb0U=Y
zbWSsu?{vvIt>XKAM!}(?!KuH7r>ct?IV?0ga`M4~($CbBpNBrt2X>XksTR$Cx1hP+
zTt;Z1|BI`1`)t~*${5a5>K3bp4OwJQIfb9xH}BL63o~nqTD>m6#p4gP@g7Frd=^cr
z`Y{o%f-N*_)_e8Svf~7&U!8S2W~u9v!ZaGo<HVvGb61hVq)f_ys1)mu#8over#LlC
zp3KOi=2E;8B4fDftv8%LmcOt6euyMTCcB`N+D2h@HSz0Hof5|ED%L3ISn5W9j;S&g
z4P(!-5`Su~l>H+o&@%SusOa^}#Ztw~I>!n}RI6@0-8Q?eL2EFV&qO}=*RQB_gZ;l^
zD@@hh|L_gXj-)iE{SvQ{+Rm+XbKnF;`9&T@y!p3~h4}!7;Pz3LY~D{?F-6`Br?Ai7
z&BC7hOEYlpC%G8QO$%A1_^Me1FOLT7h)g(5dD-!MzEW)XY-gp%O)*>RSB3UGeK;$C
zWv}lK{+gS`YuJbdZerm+E3qH~764%-7M`&Pc8wawr218JDP8^$4YoUpK3yQxHOfH|
ze_WL%&^5X{UxZlVtT1z66MQo|qqm^%tZ&^e1q-Rr)X$b5tdA$obE+Mhrxd!LeH&L{
z0+lb#QdmaRm%2(rck0O)6EV)5glz|-_${0-?`P#S8@1FG$(P&{qj^d&U)m(b=oEio
zwY#%b*^KVkf(^%tbygJ5DYo=I*lAm&-7Wi!MQ&ruH<#MxqeTuDueqkS%{4tdcOcV7
z#pXw&mx|f52Zm?uc@HP~9p_i>SeGH|YPq#9I^SiLt+rg@#rmZUN8C0f`^_l6*7?X~
z!+yWhTJ?*b?Ypag!Lj|jK0SZ8!%q(<Lz$>gZ;D&yI~F&5b$)Z%>ub;G@dG2vo)yz=
z^9Jsk*&n{uKe(L#K$m0X!EM@$wa>Sy<}O^-B9~h&QEs2N#dL0i|D*od9eTCI*Jh8#
z;Jg!QhdDHVDaRM8hA!GEJ)__coqdW;#NsXN>kk(_5#paG{7KWuOR1)+Md-l8U(59G
ztesiV6cYcOJ5noemR+Nsd&b%Lez8E4<Y}JlGu18^p1XPeSQ*!T=g`gTKl|t>-#(Wj
ze9T5Pjnz(6ZE2X+ATdNY3E9%jZk|gy;_VR;p?3CuvsgjiI-As!rH&ukpHepGNwHlx
zc7(Ms?47t|gs(^RrQA7vwpVw4^L}*I(B`FNVaU3+m}~WweLp(e&i7LyBh=)IFWr3K
zZ!@Dukyt6WtJWVK-o&%0>A2%P!`6ZRhg#0+$_t%K3g%FLB*amgC^lRo5_4EY_}X22
zXS_IQ`LuJHX8w<$H-eTKYS#IZ`Mky)*Z6sFuS$ua^h(g=*)*oF<#pM1fLIqKKGsja
zB|%ful{{r6BRjU(T6Fykn>`ES)}HdrHyIYRmX8oQH#5rID0I`tgjkkqI`yqF-Fz<s
zb)y!vm3g+#wn*|8Z(r0s<yvAD^^5H}0mZQLzND7br}9MA*;&ipr+jy+e;+EQpJAl=
z@o*QLq0yL>k$Y}QHC5$HWROqB%*G7oOKFFn7``Ezc%%DvTk+(@H#g;^#-$HFI~e|e
zCcnY=(0cxk)%Q4Co5Tyswp`?YI(K>RBFV8SZ@o@Q%A8qWUvqAz^5sp2cZT+co*Mf(
zqwLzA^o;pIA6sN1@-0qmo}-;rFmG#;_tf@9>!)8!6t>uX@zj0Y$A<fLmm8Y3D70?!
z-rr~GUF|)CZr3i-u_ny=>YTUc36J!=4BpQ!Gn#8KuXX;lq@@DyPkuU(&`LKPmY~}V
z^S>Sa&M$sXaZ}QJwHV26ZbL&Sk4XNg<PVlt<B0#X50=BBXN*rB>a!>OC-Nxm;i<P5
zPy7GcWbpXp`c^KBV||8Np_P3{r$1%2O>k_~ZI$Ux)XTRYmM=DME$PxUeCG0=zjEht
zUx5!hixaEv6ff$&S9(1`E^nil!m+R<$Jb9B>PH@IZ*?5KD|RW9C+WI-gnqqRo8`>8
zW=#ewyuL1eA^gs7=3GlJgX&lAj>E#zUry;~-A%gQvuSQnZRo0cfewM084l|Vt39&>
zEF5-xH+0x(FQ!oL+xoF|AAgX*oY_G_wqj#!83#_S2$q-Cyw#A?Cx1!GFz;L5j8-2R
z$+6jyVy!1it@)3=UT--(ci)0jAsXxCG<ly&m({G;p3w8$X@x<wakEjYVg9ONe?{#P
z-#Ncxzi`g%*eZW2ta-7)M^Ue%eY1x5_OUfy>r<JVc1rGNWMZGbf}G(xq4KFJKl@mA
zosH^m-|W9=sLFifuxI%#?+X`bMj75BGpsD!J$~y5$nSgqdbV+f_w>tYH~VsDMf7xz
z?4*T$?JvJM^;YOchrsvlP9tCMwak6{?&~S`zUgk!QQPV+9*k0}|LUH)eaY91XPelE
z7xM4t@1JQ`KreqeB&_<8-lRX(%j~Uo6wT{x!w!$!<i`T#yF;tz2o0XwDb4k=)TH`o
zRYUL-nFmK3;(wOi>3Q;K;7!6Ml{x!6rhm-%C>fvr{`=_9?EA}m)!!bj`}M{*<m!(p
zGiJ(eN#7E&s_aQv`tr@bVWq8WgsynLV7smOO0w~~x~Bc!&#LNow2YUV-~0MO>FvBm
z$`hCH<68?hbSyZ(ch%S&?IU|jBW@pUm(F;%NPHyITryozwUO${@!~;I!cl|M%KH-2
z8ed&kxHBzl@9N}JJ;!F}t~;GHy<Mie$jHoyo?BJ$RW9_SfLDQJwchoL%n%91b*C*K
ze5x@KzvY$UG!`v5_9NHH%BFO?L`728wK0#^cDME^76rV>&FE8qd);33aBk^gsobQS
zPmDQSb{|N8=CD@k<KRGrrqS^=^f}UJ6$S%y-Y?Io{w-p3a+$e~dCT&k>VbQHPO=S6
z)5E5{<k_!Ldi9EN)<fl&dzw|=*l`W!c-&RmTl>L&O%U~0%9!xm^^atw)!!#AH($Ev
zibYGCVJ)>%=(M`cpeJoq-tPBM#h<*P%g4I}4@GT=x^ns4AK^n|R)aF-k^`P^wNAy}
zFDcb5a2x(0?>2n#<D#+OVIez?8JuW7DpP&$p86A=n7u1M_8ybi`-eh3la@{#%cA2{
z^h_~Y56|+md~AM0mp|*wVrw4$+hQL$r=5RN;X)hB)~y*ba5766o4q|I@yIu;v8{vt
zNr&o7o-PY%zPqe$QDBA8z5e5_LB_g+l-?NCN4gu<eO3;BZai)1(2XtHah|yxGPZiR
z)f78aZ0xOUWQDdI@>(sHwm;6#VnJKQgZRoTYg~@EbF>~1;gtz+w#dGrEKu4@ywUo2
zi}>7G`N4vT!n<EK^RKSAIuP(CO4;Yg`&57S`YCdyDFw%s+cV`TGipWl%Y1q+{K+k8
zi2FfSVcHUTBV7Tb2VNsD^uI}&DLXGN&aFG-5ukFQ$gZ<&@8zDDgMAANE_zoxZ0JAc
zKVrCCpzdyca72E}-H(G|>)H&mn^MD{vfTD!Ta(h}7h1C8{-*UWeZ4=19q;LyI;N>8
zuiTk8jr-#4V;wgeomd(*w>tdnqPm?nZfx|R^Zl_IJ*p6<?P8Ux{nX5uZU2Cm+2h{B
zj(w{(zaZX)s0S{)B7gV6YZqvp@PDfEraC3TxRLf}4e`Co?zFXQc*5^?bMc!H*A1)^
zd~VLy+_Gk=*E9`&t*e_=+&_26(%(;wi2c1UtGD|zb=UCsw#Wzj`ESfBzP_y_V|pTs
ztMJ}_wjj}6(=(NnR;5^6?(GuOK7HsC-_br<els^MONSlrxEIaVaP9II?<!B-aQ4iG
z!>g}6^14`^KCp4~`iECH9h|fB@^;ZHS1aAz%tzHN{2U5i@PxE&<+<`(ocF%mf*wwX
zBK9S(IO~MGj>!Lc<`nxW^V7cGBgThX)K+h+bx`d+Qp<8d%bU=oQY1Q6a&A-$&3ld!
ze^!j-v8zhw;w&>h1hw~6?I~-LK9VeKabou9mqjj@L~WK7v_02&dcwi{`QSPJ<rVMw
zSB8li`r95>opJWY@S<ip$L{y)6@yQ|%>Km^#cJt^{1-_079_MDo^{8?+1c5Z!otJu
z&UZhCQ$on{J4frQ*{$D#xjR`X8P8Z5m*0>)x+e~;hi7ql5cxfNot-Id7Bx3onr}Y1
zr?Df|L-^%dBlfV&aIGx0gVUR}Zcg)(x?vy8P2s;W^(x7J(7)O@*+SX8&Vu{evCgqH
z6SkbR&I3DUp1W*SY+_L~m)$N&cd?8Jg=OQ8K?9L&>1=7|m5aFto@CGC`fW5tOgM4H
zx3}NBK34v;Vs#D-<fSBhYqcAi8{wX8ko|&BivQYe?IkxdvSVC6dBi0-+MVHkt#**r
zD8E%*s69p2^U#??XWy#`l}Q^~<?c#X3)>pr8gG9!s!pOwv&&g1sNJROQKN$K?T5QX
zX7GoWUP^e?yp*-FVJQ82u}Jb!UC}p<4!5KZuAEhpyPB7Mr|Po6m(koldoq1?e^PmP
z!Y*3k=j?4S*9|2$UUy#aGgkOZJ9qXz$8ArpOP0KLIL3LW?r_BMqi?q#DSkK{y02gL
z=XIVcx~*i1`uk+=-BC_b$3IEleYL)S%e_OdLZ&=3wQw*x^+fuWox=D}b3@>V6_Q`W
zv!d)bhMcC&dX;x~;ZWm;CxeCqbvoV>zO&O)*;c*$WMw>W{Z7>-A~VvXs<&S`w?cQp
zR<WhFZd2%?HnyI&?^{NVs$}Fphqdc3p?z_!Z{ZZ@ki2cV@W+-dpQz{83#6X?T~N<=
zSZ`FHE*Pp~eQ{2%KZp1tZDE1emk(}Lt4MNFKhj@tN=32NLd_(r`?ukUQNDWGe!JXs
zPrlK(cNbqo^Mrq{yR$niCA59S@6z6x#~v7-*)OJO^Ltj8?uUg5t`@)K2CpThb&6Dr
z)K=RH*Sallatu3@|M;}Vh`>tkMH@fOO{FdE{CR$s9i`UI?1^=;r&4NaS-Af*gVQ-e
zkrjiH2O3?A90SsmHeO!U@XJ#m>08qW*XpN|&)h!wRaYc!Sry?n*WY)K?73Q<@(sQp
z>j(Qq=e&Qlq4?(UdWEWJJH@b~O0%$y8%3wN*XjgT(jNU-Jm)C=*Q<9sr<Cpr9tc};
ze^#7Ew)2gvZYSLQzDvbBZVJhsCtLUK3f}>G`G%Z38Y{P_JU)0~vtH|v6}x~%I7ix*
zgZhrmm+yv3WKx&44)w_XIHo7nP~?|%=i%Fcm5-JU9i{*A_}<~<wEfSQl4sFBIx@~1
zjc)y3;{U~V^-s0E>wj%D30WKZ>-D>DuQz=exsxWer#eI{Bvdfs%q2$~ovYe~d$<yo
zN0+h&vsWc-_+k69DAvEAETU$GR{N#BFV@6v=DqdcwU&Jot87=p3sLiR*5*~m8y^3P
znEPPPA6i)IgWc&5{M2RJH+zVRC~dX4DRjVKM}@I<nvvS@{iIUMfHNX9G8Xoxr@fK>
zT)gg0$YRyKdEJg5+az};Wz0FgYAmYA+&27K=S#DZ&c3dD_7!&ye2c8uvrXoYUy=FD
zt#@Zjxy$oWUf%BXD!KDG{F?ER%Z6pA7DQd-^f1_{{dHF4=`APilg^ctJd^gh@!rtr
zPV=D;)T>i!Zlq5+$zitBqcNgKZhz9Qv0F{0cK6+$<;e=Xt?|(~-}>vtZr%QRh0^`v
z)V%sd_pg;bsiA)vT>5w*z<=TB^7@pL0?vUOTVJavw`}fO=y$cT$iggt<r%LZy+&W2
z>ToqSRwrk+JLo+Q>T6^<d(UR%T~~wl6*K>}zDrYN73Yndeq^vSOqGSB{p%CUzIp9R
zN5m@cro7Gmu|#&ktc6>}lQNEe3>xL1YSB3*d1LKS>34y&K(QC~>^bjS3m!gp7QevR
zw7Il>neb12v7w?auRDpJ>OOR(l_haaFSJ)WN<MBVQL}h*wQOZxYmb<(bX8Zjl~-i>
ztry`VOT;%>&1d<l=v}<v?z$O=dK_m&ok>xobo0r4U-NG2SesFDRY~;muXQ7zBkr7`
z&PvpLxNzl;0fnc+UXf4ow)DSI)-F%asSy+QDnBD5XGS~OA*i=gBvd|icvruWm;4pM
zh3CJF_{L>b?T@J1e2!C2{d8xr4%hNUtlz##e6-pXQevXAJ*J^D!%TY5XpZ68#s#<X
zKikXkHK{aa$4(tFi0x=C36<k|qju3;@3xeU?D`q~LMJ|zxm2`t?3c;&8|Xi5QIt^P
zzFaOQC4W}8O*4fnnXMqzFmR)tTvYx1icX!4(z4gzE@i*G)JNoSu!u&|ReJ?RS;^v8
z8_up%`*z^TftTtpscRB*^L79D`3WlTEaGk4lyYIaAd9Nv^h3pN&-TqfVr3P?Wh~e{
zmF067o6e>%!66o%hTZEIuoWpatSziO5Z4#~+fDr7K*5}@cWm)r`<M2V#yLdgM#agi
zj#kvw%<^?`ZlkJvEZzP3rE5t=a=f~Bt98fkSHlq_)s{kwjD~pM+LUbUP3wsMT4<im
z#q#y)-j8nCUtD6j0<BweK7?i^j(8UBl#U1ydqcN(zSz2ocb-(UQ1IK%w!&mqy|b>f
zmUOtSc#$?_{bGzu*YDg8*S8s6>BCDuORvxI=MUs&8BL3-VTs{<UHaQ}M%ej#duQwl
zUvOSHhM&W3VY$GdP4+jNhgUO31C?%XUGswTl!(7yfTtI?tI!z>j_Dr+tXADpiC{k}
zArUw@vb{2_{*|)^?{_WxjFlzlv_mc04ovI5pn38N=e)i>Igc{eSLA=4_9!r0M<tJw
zohw;yUzN~N+3nrSHC-OGn256p|9O7-aCTDUJI)i2P9F<!J?J-gOVC*9*UOon)1oS6
zH0I{T+85=rdq|sR(Wmfh>CN;!R_&dWZoKxZ$)8P^PQ95a{%Ol6wcx6@+6OER7kg#u
zW^u3Psy=e&UYeoS?E6J`KV>&AsJ8lS*z*4ESfN9VcD=B9u>1n`u8mpWh3<8D9Pioh
z`BK`Z*x>cNtwq}%wDfF6&7+jVtPC&iKeFi3k$oxdzvdmuR#++CE0=ddFl_#YnLoXA
zW~!bnOza)jbemJF@zsP^Ywa@43cLQrkKN4;QZrmH*bguIaKn8u$DO_`oy#&DoID@c
zX3mS0Z~mEAbgIT$$5^V*d61X3Z<Rz@vDeL;>%J)r`VEYBd|~0&b{u?@oVc%fh4HrO
z7sS}^e~eW*xJAA@l`r11^_}CxCFk-JzUBt+a!Hf^P+U~ef4T0D@e|_}npgIV-wV|k
zao+8oHQ>L%)mi+hZ@^sp0hY+1u_()P2i0D1XDP{E+?;G*zEvzIbjQUl(Q8+xIM0#L
zJCVm_$-~jp^Ci5{PitS{HQ#g1x6T_x<x*v8_N1H{TX2L==Fz+}S&lX4Tuyq`A7WmK
zm}(p<oH4-fzK5&wK*o;dmes4Xr6hmqK6%U5>pHTlNz?wP|B9;a{n3y2uNY`Lk*d_W
z(OowF#<5*7hTE@|CLTYdU~a=QPwg6K!r{+$>++W>+wg2OY)Mz~ySTAGbBok!FP0m2
zEIj+tikIdKhP<PzFEizNBKLZG>E4oF&JEhdv$vH=2#3(`?RvX7!evSGiRQv%?j^Sz
z6eFz+Zw&6d>fM^7y4d=f=G`QfWrt<!2B@;4dpTBQ-`(@e^XYKG#u+oZkN!v;bEurp
zw*BrAZHM>sRF}^9o{=b=(qPr~$UkMq#s-7^g<E}toZ`e61j=j;`*{DG@Up{q+?#KI
zTpO@8<xrMQtilZ^S^k`LS3V_LTz&fN*}>8fx7BKgZX9R7Yp%2SzH({e$@-4YTctJ*
z5A+^IXfMAX^OJkWMWyiYQ!#EO3#=cd=r8UFlzqa_t8;pBv9?6UeqC`DnO+6Y7o}RA
zUoIp*xi9S4zpmWuT+(oH*pWG@eh<_n?6@=3o-Qni>r~kBAtdsF*qfg13l~Sohdku_
zP{V5by?n*R-Ula|)XnU_d<weUJlNjY#Jwgr)!Js4oP*ILJ3j3du1|-u4(dyP+x;$m
z_u!pYqx5TXTXJLWO@D4~r<d`_BeM4RUY0HL^WO!3?=0ajKIGR#oo2LqMABL`oVG!y
zeb$w;k`9BOPTcD33GCq)H7_5u<#qqP)7gI3l!GgR@}qjpTYhg{cc-f~D06jZ**ChK
zJZGoErX=nF=K&F4g|UMT+e^M%IB8sy&pE-qHtEKnpF5`BPo5XDn{|s!NU^_O<Fd=1
z&pX<$nbhpm+WXxlSjx;ab-JCp{RMr$r)Tp<<FXo^3NE`CWX)R>c_V?PmiPXZ(@7uN
zv}cScu-HltoE;msqO`T??iSV`KKQbGXH2!<_Ph5_HZQ6DL3v?6CqYSQJDsj4HTC?9
z*HybkgD$+bG+n>OUqys<R=ccaRUfxf?)=C-sTWVrj1DrBE^oMQc%gpl$1CsmHc=I&
zZRX#}c4JYpzMXxpP-Wr1%K2NJhKgT2+;^mB-<PP-oTgtlcXprnnc{4IdA5rb&+&b4
z7Uu5M6|(v^=wH(Ns)p-f?f$G|)gtG5uCryXj#?>wVnMh|kbz*S-gZsX1}VYwS{c)i
z-*H%ZV=MpKi_^q<lGwe+_8q(XeT{VCbo=uk6h^y(SJd>n*z;?@TwF2r=%vH!=EXNO
z93F_M+{*ns_LpU*w*K<g`<4e~1@D!!iQc-EO>bZ2HWWIuXEx99)>%5=oaW};XbXKB
z|Kn+wwdKg|-x91Es@b`6W%Er~!)43OeKadS#n;W3KUR9UKO=E<Lxp+5^Wz?7yYDQx
zG$8hk|8t&}%ZnzjIiG58$L)~2oAXGtJAL`VZSQC&;_o*NEA>4#tol&!=|M~S;NDF~
zGW&-7M^{f7etNvkeC@W;y1FyVc$b$aY0b|%aj)5Km*@r)@#g#Y_8$8aQnpO-jLxa~
zdN*sdZ*{M_@@M*{#HFd*V@*x7-LH?<{@|;7YdX_LS7dCCwY|yM*?y&K#+{kk2Yc%l
zvGxy0_XG~Tnb-2$qU#IomeDT3{)KM~Og@p%GtfJ-|DF$CJkaW2N98vBqMz7t>Efu;
zhjn7Chr-!ryXfAl+P+IN>RpcMyEbjXAKjO;Qt1n)Mjxi;7M1kSFYl<=RNA(Ezs~$M
zRFC1F;Dy7lTyFVo4sLLGw<C6nG)-{+ar^fv77=S-2rThnPrDx&Sw5U$wW02!p-IUj
z3)bVy!WSm#Q6zj0K8Sp>n8!Ki=be$jL7t~~qPf5B=U_AHDVG=6yv_d6!91BFsTE~A
zcI)lqlnr~yYU0FIzx6?djAkXL@$=kgBEyDv4xINtTN@N?zN@s5-*TQ)P<g`6YhMLE
z9LuOq?r<wz5p{01{j1Qz2L&s2Rhm|Q)L%JoL(cv;931kz*D1#O`kGW3w*Y^47kSTs
zU@s4<mzx_^SxrG%K}lXk7A^t*f%{FU#6P&TgSca!xOau61~BAD7Hl2e!p0J@mckOw
z$1;zbV_FI!4DLaJx5-hQh-Hc%4__=Rt0@ohgE}~Ihqo{>pM_t|!?%}Jk4G?`&47m*
zJH?nsiM5}Hx~h&xP_L1PZ{=Mg6Oi`>dWcjDK8QT~Sq*sv_p#~mP~)c<@W{kYHRjP}
zP2!O;s^g&&83k816PfSxOp_tR^FbaWxquHN9=>?i)jWc+Y{op)ZG@FN9zG%iQ8dPV
zsO><8NbuB^xiZNo@XHj+r#};IW@C8s-&@!i-kpf!cRDg<*v9Y7`DY%se>_$6cN^P3
zo+=`9^3y|P&i8kPw8ZwWJ0F=F*(kF~QhyiOD0Ba=ke1jOPiv9@Tx6rb8%eQEY~zvh
zcLTUTml>UZ8CYU!m_nic6T@{7#s5sqpZ}*);4PTr8^Qf=AnL)rROF<{SeZ(JxBQK7
z0{2V-d0oc$-;ZUC#i^8ae-UFz2Xa@8>qG8_aT?^I7zekG%_7|q%jjDK^C$i%YDI82
z#zY)EQ#p$iS3)3=iFB6upGf}lB)oJIUONdVZrhnqf6pX*WD@>^;Il~a5A1=ofT+hT
zQvACxF-42P|Hl7#-)255McnJfxWx-RfTrL^Q83k40w2VKY^M4u;6oLBECC;C;A1KH
zPzN8x15c*J3$ln0WhKhLl`)@YLl3Aq8Jn(Isb}i6#>mLZ(AvpbZ>6cB6UCGH#M`8q
z84s>GfoGcBLjx(qmz#Gm#WOJ2$Di&=@eKCxpt!lw0|I<QoWMg;PM$u&#3%6#o!>vX
zKk+mk6MF`R(%mL6te=m+j}yb_q(uVvw@t3VGk|#DDwyGUbT1;foC@OV=O1Q5{+A^f
z=!=LiC6++~^29wx<6H|sBH{8jOw5p<MJyvd8z9H!#Yuc2NuJrCnfj?DZVBZ<dBCWL
z^rP#|K))!7qy7!J7>T2O7vP`_NY8d+86=<|>`M{f10a!b{fC&C!6k@gB!3lhpa<Nd
zhIkp|Ko8l^^(0O%&m+k3^1L9)lj{p_CH_}=c!>T660i%#TvQ%u0Eq-R+5amTl<5aB
z)+2di$Z<bdkhmC0em#kk>*WbKUN2^p{@c&nNP5VAK0wj~_I9Y8nIw6#e^9&Newa?u
z1NsQkqd?+9B+j_;l32(6U<c&^mm<l7SON*u7d+d6^n+!PfIK-Kz_AZV;GRVAj}p8^
zn8Cp4nFbUR3G_9PfGqjhW9EMPF9)#*60!^Axru+^Q;<NJK>{4v0_*bNgGhh_yMbUZ
zAQE%``j_{@f*Ue7kISQXx0qu5F>or8kl&F0-@q9}LUDq)DLjPmV{RVTKLy&QW856-
z*^2Q&Xm>ZpF9Bx|X)p6@Tz@gFFN!Nv9%U$(gULUH0ab|cgRlWAFfIgwjz~9|U*mQk
zzy^Gb@nG1W-(p+@*6Rz#7s3GigK>8bCg6hlP`!4;fD**`5Udw^rx22#0Z%T#Gio3q
zo(h8qy^|dAdr;04lfMAlYdyvz;6V_2Mhoe&hwT!E$yY;v?!q{Fhs6Pm`@loxY>dx@
z>)_cfa=nDPnClf7Kg-7Cw=s^Mks^L7Wh7L7Yv`Xh7=I5BjfOG)9qMO={T}Jr0y{Jx
z#<#+HEx<T>*9n@d2<dqP>xJI+iufED4>U~Ae8_DvE&(~3TMg-vgFG0MSAjeR<8L9~
zhw<0YZ^tmM599L;#=GFSf!;lW$}=0rNfjo)4BEYe@feViNSv@8ke&!Q=<;HGF+4S!
zkMVVI96;|3L3-A~IM>AF2cRBfj3>bUVvX@FP(OM%EYiQ4d4fjq$K>xr{gD{o4Et9C
z#?xV(q+z@W%Adlx28`zdj0eE>s=)Yurkg3ZFunq|%Oi|yK=~nzXF`Ae!nhb}*D1`5
z$Ul$acsm#4$*`Of7(WC1oifHp;drZqab-A8uEsbGmeUU7?66%tFzx{T5RCC0=>KSp
zN5cK%UX0&_`#bc`JLHF4*e`N1`9kQ2D;S>%+m~^13iJ=+AE0`6rho5Y@{1uybFU-$
zEwEm1G5K)l&k>BHda}X(jr2Ida?ZrKIuIbzB8)dfyGt<s1==&g_+!|P78rj6$6H&B
z^T2-RfN>)@Zn$C`&3WLBaR)f=1z`LH<dGQP5Bq5x#^=F!IDm0$82=|Q-VgnM0pks@
zzNHwKfc|O3xE}O>8^(p8pL;Q$0^{=o#?4{-j$vFI#w~h>5sHUW*uVH;+#${j>m`cu
zqtFiu7)S5=UygBf9Dv@Li1cT}^4nnYC!t+ejGMsr3c&bP7(d%E9uLQ#M2t%?!<>TN
z)riV-2+Ezt<Q<`&LX1CwdMYt~94I8xZH!C7c<#WsBOGsEVcZbzr#@l)1MH8#F}@6r
zZ(Q)W71e7H`b`kyhvD%PdKVRv_lEvg!Q_9#cv^vR^e$C2X9Uud2=^=Ym^>P{Ju!~P
z`4Ehw@jM3Omtc94F<uYH+anmShWm>=jJq(Ki*gm?R*<8)@KC)z!?<n1<QKp=>A`q3
zEGK%0Cerf&w%2z|J{FD}>~I`H^7@dYcWxq{0Q)Z$lW&IQk;gbM<eC`&3eS&>F^=Y>
zw8r>$*uE|pPlbN=$M_b=(f$^dpSa18krFU@)SuHZt`FBwVH~}iy8z=-aJ?DhxiC)J
zF}@V`mu`&vfC3W<oyVi{pM(AA4JMC%N*KWS5N!9)82<pr=WiHC?*#vY@e?o}=ECtF
zmFEuBGaut`;5aFc@wLzovKZ%q$InU_Z-f4!VZ0H>A=>|-@+^dMHkkZ0sK*cE0?^MP
z7`KG|WGlv_;W!zM@r7_d6^C&>xIaz8_#f!cRE#UZ{*sAtXBfBWxDVC04UW&nn0yv2
ze+9<Np`IHUKMVbH6XR&E!Dfu-!2Llx#?f(PH^$MNJ-rwgMd#fZ_d??s#xKLT{EYFL
zu)lx9_+l7WzcKCr$JHsY{m1<Y_eY!<Ukb+`K8(x5acmC8^Wpk@j7Px>{Aw6CgLao=
zd^YqmI$i^tK^IDc{mU4W{|)2K4C67d-&tW?8;&RIG5!;_OEAU-V4R0z{5AB$c8m+d
z<Ii0fPlfHW2jhXT{HYk%hj!0m{0MCK0*u?hap@Yy>*0C@#z$bkZpZin*zVmJe*pW}
zbBs5`dVRon9&GpT7)S4rWrzI_Yz9r$1LJiz#z$d$Q869|+e;qfHBgTx#;3sX#~9;F
zpdYL;-V5W+1>?bR{PD-QJFIUc#%IAeNx--m?C)t9zY6uA!niE-V*$ojLc0|hcZB<k
z+ZewJ`&|dde?z;kFpk>m6ULW9e{#Wb1+^o(E+mNYaM&*-F;0VA1>-W%-U^JPxtvWg
z9tZtnk8yVBA5V<0f$Jd{Z-Vg?gK>WtC&?I(h5kH(@qN%gc^GGbdah!e9qtEfF@7J$
zPcz0{V845e@hT|ahw)<Ae@8Hm`WGwgPpBQE;CRA|@dVf}L@<ty!(=h82#?2>Vw~vm
zjHHioFF5{NU_1ft$2Vf!5ysCZjHC1JEf_xv?e4<34&>-}1LTL}aC|<F$!oy4I*;)r
z*srf+d?t*m28_Rk`}YSJZ-9P&hVdV8zc7IDYFM5zjAugq)8PIP)$1YLkIcdN2{;Z&
zVEiuBqk{33@cddA;{nj0<`{2+<#WKeKaA&17(WQ(IUM8Y{5KxsM`8augmHBKdkW*|
ze7O+g7ogoLjQ@guxQp>>80Xy>w}yW1!?+Y|-%*S&hWooIFy2vnNx=4<h4EvspHeZ7
z#{VT4-v`^*1mpKmzr%P69N%m)t_Q~v2aKCQ{cadP1@}h*7{3PNVH?I}p#Kvw?gDu_
z#?knB8sp$TAdm_%-Uj_yiE(tj`!>csVf%JsTm}074aV2P_8rD}6C8(Gp+8XjPKW;F
z!}tm~zAeCb4U}JuaXPG*CdQw`a-x2K>`I{a#pI8{{jWR5E8+MSjBycIuNaK0LcR~<
zXs**NjQhaypTl@F^yhVqo5FZN=f|jC(y(8(WAcMA-d<qb6OOAx7=H!%Z;Z3Uc;JTL
z$nJXRH(`vc!f`+b<6mJpmtq_pCm3LSE?i%W@!hchf|n<Ogvv7n7Kr4JaWqHQHjJN!
z@wNx!==a)8jQ@c3&BeG5jH{~{FN5R!4U8+nxN5<85sZf(jC(-40~j}jei*}eDy-Ku
zI6fi&_`&!@zcV9Fhkir9CnJ6bmJ|JMjJP7~kGhzCbPKCF#?c%^==v+t69eO96DBVM
zk3+&St_sJOc#L01`$3Ec!G3fK<4@2yiSbSt_f;5If&Jnx#$j<N-57rd{oIG~MrL?Y
zMlqfRkC&!Ee<1(VLc6mt9tGQ*it%+YeiSg?1=~vt<I~~zV1jWWC~t@HLRfxJj3>Zy
z(lI^^{kaq4;&6OU!8ke|I*#$}F#a!K+!Ok-4CBw>`Nd6)3qb!o!nhNRlUEo=bDV$1
zcoNjZxOtKA32LuEcs+p!jt7X>!~Q6O@lmLE5ynm7ahC?hy`VphFy02oRcnl!g8~rA
z72}uT`C1^x%^}~8@mRRu*^BWixPAoV%b`E>F<u1Qr5NK$FrMo%{s5Ne0mgY@$Lqy-
zD%3xS@kdbpC&rIL&I!j4)Lv*#bU}>g!#J11_y}xYbbSTsLG8K{lV1tj3%yev$*aL}
zz!8%df$P2)N56AKVEh#vw-YeV2mP6j@ij1Rb1<$C{dooBH{iHYiShZcUQHN3hR)wH
zj^?0!i*a$---j{246d`lc0hhZ*VA|~o(KDp490&!KPzB-3EZD9!T46VztF_^PssH!
zo(%V2_83os<DL`7+2J_mf$>_XXEVmnKpuqgsgQ5MxHlYUwqx7|#z{KHJ7GLzVf-8H
zFQ+ix3)}ZB#+{-6uVFk4`u{G*M`64@!?-lm{~6=<a9rYragE}k9LAv(#vj7?k%JsG
zA1oqcoHQZHgAjznEd`B>KtJGc_einA^q}2>JBb5Vh7$iEZ71mmMMT$$(C@UMJn+x~
zh*M6H<bhpf2BlDPF)j`H6^uJUUV`y;kXJyC?CL?@O5&jWZje7FaZpYN$Ui}j{67de
z4~%!ji(vc+V*C}1hs792=fxHnFN5)keg^>MhoQ`{Oee_$za_x(gkwAg@;HnaL!OB7
zOOR(^ychDL7=HqJHi?6FNA)^S;-H*kP`&`;qmWl%9NjltgK_YRVUX@&Tnh45jHBxY
zk03|>L~->J;~Gr$6c*V3ko-o-=a4vPD%gD~QX~%A%M;4$U_21=)fnFgxig6a{i={}
zB5|NU6Y?z>uY!Cpi32_AkY|%P&~p>=ix__c`3({$m**~t13g1fz6;~CV7q*P9Q79&
zH~@Vn$-^O@p=l-@FVVP!=9(42xFOUp3^`Z@dc<IP6iFOj;$&<=`+p>_3+3%Fc`D?7
zBo6eW@n<`U1OK3uLE>=N%h+@oa#Sxg=W{W}(eXny#*e}J)?qvi^1B$n1$hg`>mcvK
z_#os@F^=vpAA=l-fqKEiLkb%_E(Y}i`w+Ar;U#e}4hX|Wn2m9M$VD)|0&*(Gmq9Lz
zac9WoF^=vZTZ(Zyl-I<#KjiutKMc7s#=+bSAfdTbQ2SOuZjH%bhujt8?T~w79L;UC
z8FJ)*Ii^`kIL22)o=oB(K6N3_A#u=-){s|V+!69y7!QNIhs4R_Lm!C){V`B}1mjtd
zbHYFZ^#Xd<L5_ZhNA<l9xgwMYeg^v;G`F@Y#-m{%YG524Uuj|77@n``VSE?dPZ(nS
z8I(7{I6AH~$9O&H1VpmJ_!_8x9mWOWI0?-#p4%rM*QqeoF*y17%6Sr=NaA4JMyUiY
z06&xYbBv3^^&c2lgzIR$M|w0Mmj-}HhzB!QDd_nfz{%r(AW5D)ejcBMqvvJ7X0rUp
zN#xO-&PX1fK2vmI|HHWp#$hv2LMP!zCgGJB*Mfd{h;e7gQC&cs!$V2N78n)`f0F%1
zh511F$?d2_;z%bzx+G4H9}5yE#~VC7X4nOKkRK#T^5pWMxWLP!Ns=d*$B@Ly<yk}G
z<no9?4*UZS!7bss6vmU``XY=!hU*F#N59{p{)O~MgNhJoDf5eQeGJ&W47o1G(VVWR
zUPzA+Y;O}xUIB7cUnH*%IU1)CNAYTp=|Rs~q468ZuYr2pF!>FTdt=-UazBi3h8*={
zq(21mEtq^X<l8X52l5>lN6)3kWBeqPPr~>`$Wt(m_P=QuzXj!wU>xmdPhh+Y%I9GG
zCFGYN2Vp>te-vMUll$W#7%$+99RJgyKETQGzn;X&@lPe>Kmwb|cG0*3IN5F>5GE4f
zWV;s_l*!3<J4u{u_y0VXFqlwwvZ;k9eLcZs^8u4z^8nw>F!8Lw6A1o&E5g5K+MPg}
z@q&c^Ns#%j1o8~H|9_q}7aZ>4F%CjX7ko^RV7D0GB1$X)2962INte7rTE_EB6Wc)C
z{$KMiCh`KEXg@$KGLkO*M&le@9lz#=%CVf-Fj0PVyoJU?lpp0o-(WugmdSk;$m&7?
zbRG&ANPNt%@lO+C35*N6<Ak}8031UkG+v4k%fJTe<M42l5<#$u>}Ny!=sh!p7$f2K
z!S%t3><h{;<zt{8U?14V?Vl#tMD}Y~nfYs(U*n&+{o}-ziR@>}GP9sLGl6}u55w)Z
z5^N&-DKMa1m}<s9ar<|PEfd+#Uc}7e408he;8X>-KSr>L>@$=S+ZGW2<b>NFAvR8A
zp8`)Dm0)IIADl<w_Q7-d!2b9KuuLQ>P)a0ppE7gpUt$z0k$EEfO3;3b8Z#%b56X_)
zSDwUvCnzkDq8No^E`v{$9}$B|^4md2S^P(S@ZN!m%Flf97%_J!%n!;Beu_Z$QU9@@
z#C|?Jp+oy=R9=)Hty@oG|C=jQA_WQp`vSy2%8%^(O=7<f+Bbvw(HF{(*1`J{CaQme
z8&iU8e=dPgeq?{=B=$9CG4s=i?c{{=BL>=cBKv~wPy+TtP=9bK5#>kr_d)ykoR{eS
z3_9p^q=fRLVu9!Xz%riy+d^h00VD`@;Q7y@{3IJ-afT=p$Y30)L*L-M0xgq8)kMi_
zf0uFD8w3EybF6<w7)u&3zY@k#`4R3W@&lcCes7q+4++9=JpV%?^Mvi^#mo>6^MUrG
z68|VaYQKqWgDe&x1Ch}0dE&$}IM%@PgL7sWBE-_)BqPOKb^r!Q30q~nvudLJDX{#n
zungELMNwHzi8SRU^}pu4R9&K>yp)mQf1mSGcl+N8=rR^{DbmE7c>LVe<U@mf8Q;Es
zj4uy5<BNE6B;CWGPVw}hyLtQgdr_GO*dbKnWs+1P3so|N0*-h!6%{GL6t{p-Uw5j1
z0G;X)?%@_n_h8O7sR^X?nVRIy4AdCwP_sN?o3U<a?c&8)@Swv5Q<o6Byjg&|kEf4^
zJ7beCAbw;*D3%P7XMAeHW#3S+4hkjjN9Y<~3HEmf%iyqI9xf9VK#Rmn(*n`5YpAEE
zM=)CR@egzHC8qiW8maWHfgV&zcc`9l8`20|NGt=5#23^6A;k@NN`93oRbHN$Nz^qU
z#DiE0p}Tto2U8W@J;D@;<$zE+!&{(PZ2VnZfw2H8!|zmLlF>kqV7iY-2sOYHx?Pk?
z1upgR4+YH<5J>m&Bi;e$<L2V)yHx>RqzDZG+uXc8+%|`V`cVmYcn7!>jX`cbU=K_+
z`3KIvsAsEZLrl$SMcXl;K?T!huH&Os10m48-DycvBxQ(2TH-DV8S3AOH&-P&@s)w$
z1I^)>C?Y{ie8!wMGOmU<?j&PdBnK^-E+GhKlT555X4~Z51x8-eWOoTFEwS<M1fD1}
zEt&DlnQ5{-p@Ep_lSWK;$(+Y?Rni(#(U>|-6JG$49@E5+&`8oDMnT<aa{P>v^Tr7f
z-ITVY9@Gv@!l}1WkC?==j(4FhQQ0LDaH><~8bjp|PzBQ*E%|~3l{grnB^pQ&vv9&`
zNx`g}pc1~sxJOHNkf53-ey#!sD8zJ?Fgw^BLDW&XW>w-7P<&z{OQuSu0B{eu8cMF)
zcy6!}9GdCH{$iz{{#$vH0G&^daj}qLzJD9>n!O3dLc0v(K7<NQVuik0uaYPOrC*)M
zzba`9-*|PIQ@<+Lz!rd&BH9kQfR^}<XlkPI&?Z!I0x}zqn8%g5tzYZ+pFf@{|0v(M
zpW|xuc+(pCiwP0lg)u}~hzVZd1g5}+=0x#ObS3di5cQ}A`wI}3&~VZ=G&3rwK>tdj
zCd|22NqRynX#W&rIM$K)WZ{kDBXYoM(vqzus6?g5Tk-!`;nlzX{7L!$Sm#&pPB(B2
zM@iB^Rd*m_62|GcTWE>3jMj!Ss7EoJBT0Cf<ca>Yah-%(M*oi;pc36(1a@}^2|>oh
zz|p!;8#643Rwo*lutH4Gip-EB<HbKC0}cqJUXJGL9S<gAo?pT7&Kf$MnC_JddTAX~
zJE$}muk>ue0F_NF|6@qXB!F^F><X69Z8Q+W#8k$KFRDRYGqV$u`?}GRw@KK+vJ%FW
zh)HFMVAm#Oh(1d=jJau5V$<IMM_Y-yHX;Ecrf7+<RHlirJ>GLL<{DOhOiS7&0SZIZ
zggIb_@)1K$Hp52e2F8Fxs*p_;F<?-vh<T7@i0UkcF82j4|3yPn8YhKPVt-HN-F+S?
zNoF*E;t<Vk%1#<f%b#B69LI@o#)mJadNlVj*{Qs7IY32hz08J<#IR=o>W$}nf0r>H
z{+nN&glA2{cVPvp<|1rE?}J|LLWDA{lsIGv_Hc3YrX@~m(&g~>aHsUshz%qc5xM^N
z1U#waZVLBRro@0Pvnp{YNuA+8BgQx~185`sN6c{SHf0Bm<>sGWPX#oGF)fM6G2V2%
zace-9*m@;XVz5u_*nlP<rt|?N<FP};{djaR!hVVbtZ32{2^tY<KqcA<{RBA)l^ci_
zAoe@a8nn1S^xd>%0|{bQ<X|c-k;syG1LfC3n#Lm$h2i^LB0m&E8$m((g9-PI*9XiQ
z4GNzW&1XtzX37)(VH9f`V+S@3Gz6$0*t;<`AsdWw0+a|9XNpAsVj%ucF}!J~1CjE-
zO)H3+c8C~zn5uyPhy*$)NZ;U1GH5+KD>>80*QQCJ>EpNW-z$HlFYkE#Wz4~C>6PwG
zil^#+z8YN<GuNFyD_IZaO1W(A<ep+mm6VC;joWizrPu)l-PBq62lklQ#H3`W=g8Wm
zn4FQhm?GB7d-j{I_j!f>tUrg#wI4f2XD+W+eS0_SaLAh{KekEx3A*ST%otg>#_UGl
zOT}7~#ENMPzW+@4tj|AWm${(sbDdm=uZ0_R@2>3@%J)8eJnJ3yL-G4qWR#}jx`@wF
zHpjO`H@x)!qnp<8$3=2vxAEZ~(@1gY^Oe8Lb&|fY<p(tGa^Y6mRla-4^p-m(Y=-xo
zK2}}!ExnDHmo4H1zwz=tQ=JZ#^1O+b@$R1W?(y?W^G%Fvyw4jN2^Xh5wcMW{xoz88
z&y%Wd?mJ6fd#|#5lzKE-;3KE@kL1p$w?wsF1{S7<Z5i#1HhpIx^qZ?t=r@Oq*EeB{
zq<mpk3tm3%<QT1ZPu&DjwrQ$YSvdu}DKq1FVr17IO*^rgCCKt~#ZGhGwKeZUV^+q`
zh;dE*85cokxoyxYIMO*?W^QnL!~m;xLLb+r;-@iJQ|zZkvgq&nnHC|!x@6jy*&`a9
z-tHPKf^~tME%kwOlx*vB&&p?U>~(vlz$%r{H}hIEN8_}t7s_0%GW#owx{@1@b{55-
zaBk8RmR3&n%TzsdH^;8~P{6D3{v}gx<Yce>7GiAYo9XUx+-7HLqPI?P(vt0YQ%=)f
zZuV(Uy=q%8_l)O#+RKMQbioHfin1@%z{j;Wr6~vbKe5EDkJr@IuG7^OuX8qSxvM0h
zv;V+O7n$s|lM7lJl|*LKxql8G5ir^|#aVX$URJuw63QdxC9GwFM<~mM8d*nG_Ogk%
z3i4{)ZsFFbRhk*N$7NRU;yV7Ct?_4LlDOq#o~gJ~Is|js{FUxfex^Mat&xwnpT6@k
z_eDwm<Iyi3HNB;9*DhJ}Y<=$Tdp-$#ZR)F^O&2$iihCk)MUR&5bly>A<r$UKveRRt
zuTlyGyuY->x4a3FU6rGsvGL`rSG7~4juz>u#O_;~sa!(MKbN*%-%abxR*pesx#h7-
z_ZI7}`Q+WF9I&UsFjXhd`K8SId49{f*Iym+p4Ync^u269!^iQ(Y#-KMJ?7ovBVDyH
z;$eu`a_Qje`QBF+#%&VYci85dRMQsQ%bQkmiI*j8S${3*)YzW&Y$o3GXM{@9Z+z!w
zTkXB5s^U@hT29-YE`jakw;rYBuj{#Z@+P(FmTl##0J*ALkCap;vyS@C*dL+ZC2Sci
zJNU$XvqVh5WwmoLCVbD_H`5;)Z_0^1$s)e(;6<YvPVq{c?@0&fwl~?2aJ;;HYq-ZM
z*!R=AAg`p)EZ=6%zwXlYm3vupiQKZD61gt!-i@~sCFN!}UwY-fcj(e9{%4n7wadug
zE<Ye2n=W&7x1h@B%EBv#%jVZ?IK;~uo)pX;QzGM)-e&mHRnkkqa!-M4=7;kRmj$G2
z(^faLXx&#*H!@7UlbOZQt0Glx^Wae6?M&Y~(Ga17T(|qUOZVO~E?lPI_Sw?(o`-2M
zTaSy~wB9393)z0gyUdK?${L_-t0@$$d1$_U-jH(L!KF_P6rw)M?sf38<LuRx$#7ZW
z!0|d*<94XUc8;1*i%XQi`G@Y?6+G8&7+y^4&?^<rd7tgTwy5JOkM;TfWfqmW$=OC`
zM|JNVDbp1)+n{^#Nb%0@C4Ow7-rf5u<sV*UYd?E--c|E9uKa<GN5Xc5ZR(!UeZJqY
zMbs>E_<WL&BG2fq+^Fmmn=~nFmpSXq40U8*_rknCRe*kFaN~Usv%Vu<7OM|;oLGA?
zd3XFS6<Yi)u4Q{KwR<1f@^zc!P0N#W)O`IzH}!}{(pRtTpp+|@ip+@#x}_a&^=9Dg
z=g_*dEMZB8Ctf(P4VVTeM_8+xuJKpP+Ua~>cdJmn(rl}c(89MbVh@~;)vg{o^4yxE
z{NC@of#+g>h4+hnec!O1wMMPRk+pYozzQp)<$Wr?V|!1WXn*Fjbxg_d?bxed=1v!Q
zQjf*eT$~|!^P{*4Uv8t)n)9LTB0&O=UfI(PGH9X~G&M$tl-GL1g|Mn_Gw1vf=YKoA
zaL9(`eZhh57VqrbQ?jd^GJUI6+*>#K+zAMvWd`gHy%M)@PwmNAyKCak0*zaIm#Il|
zbUbL$x-Xh3ASt$__0A=s5$-GI8f`o!efmHBg!9b5nch4+r)SO|OWo&t1o)$Gzc{+D
z^W&|<%hTUakvJ3L`k>3Qe7SLt+_n_)oRFJ=DHevJC+C}9b7s4e6CzwV!}xnvMoRef
z#ZuF?ZEb}cJLd>#)U@xCsMR~LU{^!n?X?4Ma%sm8jZNu%-JbdNOr-D)<>!JQXCE+#
z=4o~+o4Kziy_RybO{RKk@vOGUhJ0$j_|5{+KgS+L1!-+`7ff4o{<+b+WzlNBDpQNv
zqHWr*a+RC+zxH_S?df(hVJz>VN`FRFUH_8)x7B_ZJ0%Bx=`?K1)8`0j$X%GnwX(}}
zhq~_DA9J}E*Xy2C)#W(7%QHX2<Ne5&=PN4*6n=l2J7j<Br%w6o6KmXDmF<5Wp?^I&
zx-g{o%OT#IGdj9f-=;f>-u?3E$075Ku|s|A$70t;2A*H?@C0W_*wl-UcJ>OFaE<Kv
z#?hC4^VAdlps4HT2DlGanSFR3VVoayAmof_ikzDNr6&qTmzE44kegBKP<wLUbSaL{
zd8-V((<^*)jbo}7KM1=LIlX1z2gl8)S^}|l$|trhJ<Vh0zLVpz#gi}2X`U8mD_59o
z7&|>25q(JE*_y<a5vuECrE|VjvsCV$X?FDVVNQcD;=lNtWM|qev2vyF_s*@)S)g9M
z-p*P~zbk1uUuw7GrQb1*?xB@8+1ZKNYuXmPsx23`3|#l&^q5yw>bsI{y`H*zKUN9G
z1_uT0R-Bo?>(1IJ?R{Y!yxZtLgZ5>0$(zFG@V*V5r+39G<erTA^5DT={(f0<E8dt1
zbBnMF@JxBvG$y;xD%o-eXVR+Qx}q{O^F+J?FL^3@&F8xPBsAbo*0Fo0BbTqdjWRj0
zXiY}WlRb0tJ03ffa_Un9e4g!&EE4-JB>%NwrQz@3+ohGqtM7OWo=k4|<Z$ih<JE7L
z=h>dIUJ$-MdClmFZjG_2i*)v7tt-EK|9EAK_JZ!}Cgu3cUMJ2;{+0-I=lfOLeL}8m
z4xd@)Ro^txOLN;gPJZcdczwri^nFBwl0fOZ)ZZ1ydt=*Ubp*9m+;coL=ZB5$H<ydN
zQvM^g8owM0bQIYGR<~_mv$4<o!>6-Tdh`zm&(BHV)S_2@x__wk;A`_j8RbVmF7=+d
zI?wU`D=x`x7oXhO6Bg|%&o_JLt*<Uy3FgJSv2V1py`3ZTljQrjE5;8koY$`TxNDED
z<<x?T>5BI<U98rR6})_w7HRd%gyk!%(5iFCqRwBsZ>jwx`r+5Hg0Yg{=hLl6S6|yO
zzwPGj<8ga*zGYn2+Eji0;BS@E*{|c{Rh&1RQCw2%!SnSp_u&cwrJw-yU+JH!3J)x+
z`t@F?Y9wDJ&c;9DP3{H9W!H7*y(gwn7v~sBb<HWRRJ`V}P^S7>i;izchO~MU?X9cL
zi2#X3mFg9KQ%pW?TxWjJ|F-NI+iM58dr}{~VUt^PVYGs4%$!Rxe=zF#wTEBVe>?Mg
z@y|Pv3fr#jj|+Gj;v)X^$Bo*ICW&{6$pY4wrbb0`cYS-Z$jwbPZCG^pK&M7*56eNz
zhw7)#y;OS;w~nKX<5Rk>`aJCyGFf$h{ByIb<s9F74=nwjrjmA~LT+V>ZGw)|?gP8h
z4LMdACCy*=)O<DXEp5%lKP=iC!oi(Ee~*JNzzfNLkAwZzepowOk8j|X$E{nLv4yvv
zathi~YYUu*`ENAneoFeWS>Q~?6kgr5^{-dg&i>}mJoxmm_Hc*oNb@lLEBDAu$vlUl
zy{n^c=;j$n|43zNJ^9m@>p^AC$6>33?1xs$-oNeHGG%zZ2xo$}^E$4Fg*xlm9(M{9
zINm5?$@(F7ZjWaFQ$tRz9*!?NPfzLF;#2EeerB|NX%Opy>Bodtn3gr>wuijzy;iNX
zdq~r=Ka_V7SB;VC)$~i!8mb{72Q`++Esl{sa%xwpuyFZco~^^e#H4#7ZALzeW{PsX
z=}s#;+jvBHq{sJuzfg<ON3HUa|A)OdkH_kXAHFXkv>;1KiV8_Zh$zXDETv>gD%tln
zyGTjOk~S?Wl@^qx4Xu={C8R=0McPXt?dvmhU7yiuzV!U=`+nW8*Yn3SFPC%XJ)ik}
zW<TqkX}u|S_{*X0yiiH~%Xz!XLg(sye(`$twxN5ZE;&E)y^!<!?di_dkA07qG_7cT
z#lQH<$&A&0Yq>iur)`ov9<uz2sczP(D@XRo@r@RIDRWC|=(!CxuhurXw%=Hlpweaf
zNvY=KZa(g!ktTuut1|;9iLP;5-F7YSaIry~U1Y2EWy>)AE7#7)U2Z*e{Fnac5m7s%
zpLl=VX;-mPAa1_nw+n-o-yOEP#$bNbn(El3(2|wE{O_7XPO~}UKG`FG>z%Wk?d%t=
zUtW?X@a0F>iJaRN@3rOfXGhdI6|k$f_c~_^zEg_apZZO<dN@yfk#OrCHTUA^@d_R?
zI{b&0Y~>&K(P3fx6YG=Xp7QO`k6#m`zxZ3ae!bi{m2L}ptEW{-Lec5^it!$fBKnH9
zTZImJ1WXxvc+bPeOOJBemD1GI-0M0&@6&RhKC^mi!DE%WH8ta7H$^FA{aE!n_C2d{
zy1szA;M%uCOSDhT7HV1GFlwC$zy8eoF`*qsf*+ntJA5TIbL9=&d!?gY9*mAUl3QX}
zadh1li=IQb7eCDxv!0O{b=X7Tp8Xl|uTq9PjS{0aA2wZFP@U*^J3H^%gv51cgbT#K
z4sf4n%%d!~VuR}IwJ%CODdb)+7`U(GzQ$wW^SARgyz3fN^rJ3qt`#~pF4D$<TlSOK
zrC~*nBil8{D+xpm+_2!S;v?ahs_2XPQ+&J!p3^)cpm^+fvtMM8vc6&XuIm?TS7@K}
ziZv8l{^IJg>avFe$Gj^uxb(~9fRcP2Z)(-;_cLO?-xC-te3ARaj>%0s3t40BP85o{
zEx5pw@wj`*=BnYkzOsix{H_n#6UFOQIwCK~WSwf*$nM2A%0$G!W_9u!SM=m<UU(|a
zI6L^nl;W-PCUtB`IoGnYe1e(8ja5#ay5f!My4Eh6HwJ0T4Y7(&D%?L{d+q$@JpRIl
zMBlos#tmDvtA+;5eq5q8ByIeQQ+#}Z+xhBarCwjPdGA@*e%N?<xt+kfc4@%_e72R=
zo3c$RBIO%5Id$fZ*?w8@)v($}vmbh$x$700+L5=f)hx$p+S*o8;}y@p$EhjK9bGZt
zL-O2$7U^4~Gh5DeRZpI*mvSpEb!|jZoV>tEUXSExQL8(V#pw}CHLj$J{B-;^P3y)f
zjZuQ@)h`C9+S<Ae`zpP#uwJI)`rC)GTCRK-Un(~*-WPq`*ZbiE^^8b2n;oOWhkdL&
zt3PMMk^5#la(<RsPT{Ja(!OG7sgC9^olO%fM_C3{C-6@)TE9IjL_To%dK0A&!xFmY
zh=`lKwMeYlsCoFj+&U${5y{Jjj>=jnJM@98V)v92UP<$oj}4p=wsc~Xbqni#*vhY>
z66R+=F0IvS;+}QL*L(4rf;{2HUj*i;E&ZUXJ9Ow1(F)5gk|`67H<r)aI4!q%RHNGc
zuh+)^lB^Kdj;cIacX0Ru*`wV{_ols9Ypj~y{6)yWdaU(d{VIU%WA?Kff7TW+xv{R)
zH8rl<RWrGAxAUB5C+9pVL(|Fz4LIA|FIWF3evS)sZSj(_al(~>@!gVYHxzgIE#76D
zyKjl@qceF9?#<UOZyaqqcIMzq3fwa{wcg-zuX9?jws3rEPikAu&YB@CvlT<o3TvSM
z6ufvx{OG=i)s=-}dSZ|Eoa@vIi?4b(MnRJM7b~MJecHtdKM$La96q@t^rnZx)5E7@
zcn*IY9d|$d^z8vh^EH2SIXNGG-jT3fV&-JuDF0B~v10_5)f9a$p6-A7b8XFuBTv$u
z(>`y0qLA?`?d2|$1os%OK*6sClJ#+S_*7iE_wcHo-xIgz<IRc%JM+b|3{>4Fny4yH
z*nOdE(L{@5o$2eULK?2P_#Kf~d){qx;<3WUEmtco)*k7q@N}Gg)jKq}IabO@GjVgM
zHFwNn?G8ujYiR~fWf}5u9}Z0%B^(tf_FSND$%MNaGgF_eRXyPOeVaqhys^6^-lw09
zlhb_We0oEMuVAg?ws1Z((RlqATFU#k*<Ifeekn6UZ$Rpd?+ZVFjrkZ?oBn0kfoCTB
z2JM~bmop|#YU7Ei34u*3Bwl9PsgDbfFB>kH+F~UfH^sK#t%A^{lxUld*8_jH36At|
z`c*x?GDl^8V~WU-7RhA^Zzdf0;Je|JgZL`Pea<62lcJBjTWyq>zVPbXPCk)oW?93e
z#%b2E8n|03PCOewDD`w1|HE1Of<=#0Qis==%Fo&D%6~m-o=}j!UfyY=*s6Jl<S+l?
z>ueIO^;Mpiw8D0QMv2p=4E2H8f$2MU``9fs>6m8oOh?wnMBS`SDD>Eu`HE+cwx9QS
z>{U~iIf(o2_HP$o?jC8;wd<~)?fv&<*UbDC3P#Ai*-(6Buf`lJokeCU%M3qc`)K6d
zek3_OTf9Mi@^bOS(;1b^W*rOa);HYp!^p?7#XXp-F|S^uBjTy$&`UfY4c{J2sD7`p
z<m7>C*OFqsFB;f-BX=pEciKXeI^Bdh_Xj<@J!8wgtudQ!wtSLb=yf(W@L-&SX<k}=
zb{BV?<7!)58@&VG!B@+4Ym9UC95q{wwQ8!1%s+nhEl<5tdCg^V-iMYO)BTrvJZ<D%
z9<n*qwlU??h%VFYbK_ckQg<b$Sgf1U@vcyF-!HYA2;0*Sbf;II7&%b>`iaZ;(r4sJ
z>BU|CsrZ9;pKOv7>I0<RKY({Vh###PzXYure_rHS)>9!DZ})d~i{F-Mhx?=*YHt&(
zy#CZAPVb(NZo6rz$-9%Scczrw>wYvrO6TaiJ6Q{*Ga4%0PFf@^53A;FN_b#x=8*H-
z<ng*d<^2`4HEm&8UB;6fz2D{@vvQX!zLI1A%J;YBi<25911yR>dlZw!-`hRkpK`da
zYn{Cbf6Gbb)=8IN&4|2k`HoT!_prRU+RYZm);t=P6$`E;&2>AgcBVxCd$zDth{2+s
zN~QEx)$qi2^P~B-#m4qy3{EFT%jQ2dJo>ooiPx?TMIZJZ7rw9bWd5e=eY>`Ys0!~e
z>Dtv;*j5o`%GXvNvBTDS`~aSMw|Bzlw=90YF)KWx_ELDH+V3|f_bInVe}CW7IsKfO
z+xxPxjG#Q#AJ1mUU6EG(F8}7+^UyUxmwv4Z^0w=qRW<!whML8rF|O|lxR#!e8U6ll
zOOr>{^zQ6igAVRAZ9Q99wuP%~*`%*tD?3&8Mo!*!OHpi}*oCC3sVnAm@4s?z{l2$~
zqqzpHF?{t=r24Z#lkL*!!e7VcSWRu{UjH$0)Xmd#G)D-%F;qDG#q(_9@bD{Y=}R7}
zd%X`7$utqui5tAeU+wourL+91dn%Gx5o2=nmoBoInX*S{t=+XJr<x7KjEamMteft~
zhU&X2SP8lW`x;tCamSTRu{^#yAXlukrXwfa!g1($Uz>$bq7N8O6dtL+H!suC@5vXD
zyp7GuT*8Kuv(`s{t!o%}^L?zn&Rru<o$#CKnTpnl@%~3=u4~E)PxUjfNGV(`wJ&{}
z61SnCyRy&iid9LU57%yJzrEjk=ElMx+tIg%yPupJrm}tPigl|M-0N*Vo|(Np;Bxe!
zlo31^-eljm9wgo15u09h&_p?Dg+gXz+nGo5J;EWswOagcdyMAG5H~%t>Z(-KrDd@;
z`Hf!5v%Ab6$T^-5A2$1J&-bn78y|G+ob0EoXz)GKaHRQ2&(mqj)6)c0B9>ZC`E^!C
zZeC@&p<RezxyI!!cW-t#7b`@kl`NU4e|paL#a)WK?bH_PFE5$@&{RCwOR~@?L`1A`
zT-auhwcN)=&g(7o-oGudS!iEM(Gn-VF$cvm>rJEE%hcL>Tt-Q(xMp|mVAMdbJ*Fa;
zG-Vbho(?a36qz@mC&WGQ>9t1Q?};(Gg;tSw)qF>tJS^ect+uJcX>{ZT*+pW0rNRXx
zbR?J63tIA&Oudo(=8WX3haT_jJvZH67nZkSmB0tB!>7{|g?!>O4`ocg{JMM68y|nI
zA>;G)3+k3zNLVM1$bV{KcD7r7{`ZPVvzdlc@r&2&oi+E@xs)cm0*jj|dJ3LS*K!{V
zehiuLnqM$Q_x)QpZaLSLA}UiY8+Wc68fs@dZmY&gb@>YZTWfs;x<BWvGCTfkQB(Q2
zSAvp1Zn=8OE!5dm(v#RF(c|(?<-?p6{)cQ-8Uyz>s(uq!D!;eaK<$)Uve<;~()z&n
zqn~`s3ygo6vUW(%_{8IaJxO*=*WE&;D|wba8n<Y}t4S3%^Fqz!2C7F4nqaD;_oSS6
z3|jAdmabH|*|Xp~4Q0U_ide6Ht0=gr%`s}q{Bpl1h1c<7U0M6S=}Ow4zFv(QcqT!7
zZnLTO$&~L?4+(~4zFfK^TWLd}c;lF&_aeI|RTWzul6w%s+U~M{)6W%dKJh%4ST(IS
z!(DC;8*H9<B2(jWX|iaRbo17?HCoLDG6vk2ChRq}UXdkHUn+Fdvtp`4X8ZZ?0k;p#
z9nxu9^I3ZM#g;~q`xdLXG$ST`@-?4fy-s(7)r<4ebA>}%_O*Uc86p}G)DyI8{evZy
z9-^97Jq0o|Ds5J^mMR@s8C2htc0f$r?VZW<x#u)Lj?S+byzg9l*qX2H%Jx5>&HnX%
z<CUnv>nk3`OyK7`8!NgxXHdNB5o=y$`Bk?R70VuVaL@5pH0r3n_4}!HakNT+&Kj%B
z4We8(Lt+<7sAyhZol&GY+-`H&g~cyFTs-rlEG&Qj&9d6eyNR*uxjH4cP5dAs;J!8T
z_x&~RZg@O<#<ONg)uM|FR#ksYob+u0Iz_dpe6TN8^q98X`AT>B+`AVRdVV{y)>GKm
zp!Cbh;eo@h?mfzNGfIs0R)55js|hbZo!G2#I<JO%?%5rhHWJe`^fUyY=NG+@waO89
z`&Qy#^ZfFR#Z8aq7?`I|+Bx%!^R1(0b(#u|xBLwS)=BSv&f8s9yj5h=onQJf8!Rhc
z&Q#jf*4;TePodEBWzpDgYC@@<3l;f%_lK3HRK7D1$&G$6uYT)^k8fqC@+XhqAQUpD
zx}(r(+S#8@`b9mq?&A`2n&mUR3~%r+S#jq~vxc4hQSL(zj_UcV#+CYXcm4QU)toS3
z?(Ad-$Io-eI|ZD-{zz|JoM;@^mI=Qcg$1<M&fe*&GimDJAzSN{Z@M<<-5kAJeTv3!
z*$ty4lBD0*TgFBfuDh1uzP(Ioc=?3KSLI8CO&2{pKX*sWIq#{ncyvUseLvwM9{eRq
zuWg{8nPJDiy|F9IA1+dm`k>@sH^=xxjc`}VtcycLW(^r<I&$HF@4E_PXJ1;ZvE-%$
zYn2OMU0V_B#<p|2hd6c)%s)JJ%Jy-V2FvXCZ@tm@ZO_fOI}Xd7Q+nW;zD4}#or_^(
ze%utuj6U(vJI=Apwc~N7V{F)5tuaDzvO;=VKT@2f)=h9%-@13j`hw-$jw6RHTDGS+
z@N375O%DD6W&=WfZ8AL)Mc=xO6#VwuJ6h%HqYB~YSH7p*diupI+GqE?Gm=jV<Se5s
zD)RH6se2mU`+QaRY!COmwFVOwNAT&y?mP1+>Xb!ChO?b+PvLFNajMG>KiHizMXBj&
z%9~)xmw}qw2hZ@UUu5|9y2+A#j|VwC61!Ep_40@S?Ky$%=R23{6b=rnUa4y1bIv=S
zhj;bCTUTO#aXAglB1?|3g#UA2C2#v1KeRS<T#r6l8~XSs=leNxc$T-Tr^e4~=y>&_
zJ}L9~PWikmQJQ=@HN1i4!jF5ryCN=e=cRmh?ijFO%=W~p`vcX78rGHbt9S$??yNA+
zo13+BOnq>!l*Yw%YucjoLduWM8uf9|wICj~a{;Sb!oJ(tb*z%D%eo)9;e2`9Y7t$Q
z(=4~xoX;*!3twHocBOvq>#JTr<1c#dGwXTJ|K;T`GsR!4eturjy;(fPwAMVswe(B=
z_M@>!E88AVj=v+fRo(Am>WXZsjD|L+&;@aZ1&ampl;3}wIA_;D!D){^>=n0oH7--v
z=j5J(<6HE#J7xF9Prc_JxzAQ`(s=j#`_74feB>@^Y4&50BY)ASPeZ5kjr{e$uwXPg
zZ^Q53$e<s-d||E`jl694KV3807)eV(oS|5$K3?N_K3?NlUr;8QM_*836R)1&)C~jm
z1T|y%j0C%M2Rs@isELrCpaK%nM{7Q#C7%WP4F^v}(LF#Hd(IXLfHkJkdeO0Hy=dJ5
z8wa6vqS5Nl>?nGJ+3QlLL7W?S%eIe{ve%f#>r$6+4LF4&%^`O52IIHj>LCvM+Yw0H
zh5>W&+S1sB?;y5*Jwg7tgISZ29Dd-B9e&T3vnDncvm7KSY$V8UGI)Ri+C$QF@cR+{
zIUM!>=9<%ZZtDQX3=(!-Kw|#Cw-z-{?SCCN`|b9=IDYH<zpnqasNrP<Dhl_1W>Rq0
z)WkIduNwEp;Jk*(!_w&`oE^@$I(S&aDXz)(^RS93&WX><3a2=Fbq6`-tUZo^346oC
zn#=L_{$BvxrI&DaEP)48+!pwHigV@?@vxF9?h5j|DDDmXBE?q%r!b52%>bU>wcAN}
z6nlr4-CqgA+jVRYPwzY3By1ya&fRrF$(oxyEIjTo-8Qy|hlTC~{pEH8zy23xvGxPM
zL-8ZPJ1Bk}cpJq}0{=qsLg3uwf*8Ut0Vm(MA<?b^A5F<u0XL<1E$~GY=i~>qTZ%V>
zyeh?85f^5M{r&G_KOE<$FL`{R?u+C6^u=ZS;S>Ae)BEAG`r!usa9oakr3aT|U)-f1
zj^7IIOFpI_zP%s5uOFU^ICHIc_VEzaNmW1c&HeCpwjMm|jpNwINVMDCkNnqu`0swW
zIC^=Sxpq7Ic#8DPBi>i}OzVf^Z<F^WZ^G99Cxm?r##v#{BX&kF9=f{N`#Ji$q7~qM
z9lc%c(fj)L42&0f|FZ-<dqsE^_8Rai>_y=JtO-w+gU5@)vzL%pVXq;t!imC`<18=F
z)~3Q<QU1?T^K4}*Y#pj>F;z|&JGLrY6M9_<=~iV&RAuW^WhX?9Ew9Fr=V;Jm^}Xmk
zSu)<m)hWasFDmcn>>B_j0W$^c9sMHM%gqNwaF&@zQfMZDJ(~34>ln-mK(i72SZ?mF
z!9lE`AZJHEH!SRf7}1R;KG<{SK>US*{qb7%NE0i-*$2&nVA<QFDG+}C_CEg3j=`S(
zepnA8{(&eYDA>{2+uqs3+uqI56U|M*_0l^P`>)#Roege}40r`0H8^&lO9*5OPXl3B
zFXG`yZ7|Cj&6aTeD{202Bx!7IfsTGI{=S?@oFv;j`}=!){)yz~80?5s<%81xpLT@X
z7IOTY4SP-$zO_l#;wI+<6A{Db0)%sp&-fhd?=|O_AwPClej54_`9KVj!(1Kx2;YJs
za+u@qPY{mZNX8EH>F7uJK@5?@cJWyi;h7jBhq*ZV5q<_k<S@tQFoaiPh#c0>%-3Bu
z<#2qCL*&Wv3+usi0tuHy;{<kC4^w_Da4au@encLR>)2s=E%YPYmceH*crZf`J}V^h
zcs#}q>zRpugyR`1*kQYp=tubOe&kOw<VP{&&-WwW#E{3=K}3IRKk^?K^7t&3$p7p|
zUK%GHIlLKzeneh@!I||-zAZwRKUu38b8UtmJicOw`7HD!`Yjk7w|T;sGwez;xGO`R
z**-%V@-hthbqslCeUY`Aae8Jm<Z~H%#xi&*Ll3jv)-pIVJ<k}Nss96mGv&!z%{Z7@
z&eCu{f-dJt49+ZPvQ{%)&ISy5W;vSy$9Bgt^1GNJ&rGK?L!Oz=Acj1%KdxbLW;!=B
zII}(MW^iUY4*|#N9M4E+Hbb77&O!#)WylvZxE_O(wVknkSq6X1kZ0EWYX)c9{nZZ_
z;6X}}!}X$%ex#k_wv8R;bI^})m{Q8_k8%u-%N9GjJ>a<5Va_aPOE%?jW;risaAx{B
z*Jm7gCii2=GwUUc!41(qNk6&1qw}lIkT+t;Gt-Z+xriPskjM3c%Y<-y;B+}~t|K|=
zH(|(=;~>^Efx*|Jee7sGn>d)wndPvvAI`ac;^<-4FCIg%!}{l;A4xwxMq`K5BY=K{
zGmr21{t@Ae(LQ!`IyZ1ITMrH+@|%Iv@&_35__Gm2KC>VBvkdu34Ef9b$k#FC+4r>2
zJPz!d`jKyC$m8joBt0(}^79$|J%gJuIP-jfS^gl-E+2fZ^#A~L$6mf3IP-iA@23MF
z0$W^Pm=}ScTrm)S4>&$Y!j5p#-|#sJc9`R<C3iR;OJRr{;bOpL*z^w%0KY87aT#H!
zz}fWbDFHvO3+#w~9?;L!gWDlVw<BAc)80(cKB*T^;8+hXL&8bAFjr#mXta+V-42sD
z_&@#Y27@!lt40QAjz6S6v0Y{KBk5tbALj9h*?tTd@?Swe)-#pC$3Z#a^y9IM=*QRn
z*kO4U^dp>nTb9o6QidMpc;dy-!)*V740&ezU(Mjm_MgGv`i%6D_Ke#aX~SrjH5C6t
z4s+aw?I6AghR9()4E?mR2f5*#O)m#8`&<|AV|hXJ!^Z&Z$ngtv=DjtXN9>5*8N3`n
z84n2$!N!rp=WN&!egW?whx3RX;S!Kh6Atd>8*n2<&YZL9<uQ<`6%==Y<F_-#b8tl?
z=g-;n>WRaJhg>9Q)60v&zmei=1vnsu;)e!uz(I;zL51W{+#f3N9K|=|N<glRv*}IG
z6_CG0@$FDP4=El3>3l`;VDNvWco@{<P-sV_UK)Upptv|R#_<%_fpS)+crDn|rT7To
z<lCRb?f@vaC6s(E*v0qTup{z^Kz=2~i=dt0`)y2lH7L(`ir<2A!}sBs@;gA!0g4L%
z&!+fsNatCKpN9Iv-(q3v_Z-ae-=z2{Xjfz{ACli>Xt%E@`6B2?WDQ6n|Ba)b#SQgC
zcscY_VTv!t0?3V~couL)ij%eT$hRqp{)LdfIh1@4l>Z`%lm0`#(M<H%@^R8bzBNfW
zu@_G1;fH+1Q9KOFXFJ86pxzHs+#USnx{}y^3H5$~lIMp0TS;-!f9_EH9OSEw;sc;P
zyrsAR@NX0s2F?fLA4%s3;9?XX1AHvSTYxK3TolSjo8l9pea@ly3-Fs$JRZu&j^c7)
z*Nfs@P(B3|pNlhyTs6hXH=gfO{3Nu8rxdq@cGyjEP3T|bdXSVSSz~rE^kc#cAUzTk
z-w5fKqxc<=SEcxLDCgM}w}x__PjPa7W=ru&P@ZlSm*o^2Yc0jSAw6VG7m}~h(0}(*
z^4Fl;vM9bB(pf<9-_T#kS}#ODKj^8W<gY^cw@_RG()p6&osi#;6xRSg0FGnCZYAgu
zqPQ3Mr6{fl<Hkga=R<qepm-FNg8{{*pnlCMz68>3NAdU2E=jsb`fVX!<hV_^A{qB6
zJ>>pZ3dIc}orfs?8Tdttp8~t}6c+}&O%%6+@_9h<!BD^L6px4Uc}a0cD4%x}-w5^c
zk>b_BheAF``H*h~k~QfGcZT$gq~!G=J<=3chy2P@d_VMe9g45RhLD>>agvUC6gL7r
z&J=G1zbD1Xn#TSVUk3dvgyLlF<4B5cgyTvK#eJb3$(od;+{&R}Z>Hq0Lb+v9yb#(?
zF2%c{e$P;RD3sfIiXVr5ahc)`z{@GF3HqxkJ{jceDgF@Tn<%~v+SLP!$Ag}Bil;)m
zd`a<dP!8`XZVBz`1I0f=d-z82_vE4w!b!dSf^mBw#U-J>hEQA@{Gt>;2Itk2D82*Q
zl?ug^K>u`#?}h#~i{j@YzXlY~hjwU6@gm5t6UE7zBpwte<G4S?Z-d=Pil2r2lH)ch
zPqMbm4oW^7>f;c_he7$Dp!g|hKbI)J3G`f}_<bnnMv5x|Z>M+zXP9AiQhYzu%MXgD
zL4E}wT_nH1p}!BOIC-uxp5nWpJ(F)^5<RaVU$ZFrHDK42;$}D^a&{Dd3H9zp@fTp1
zoYxb(q`uZu^3S2%4p5w&ALdY87xbT}_)Tcf6%;4!@;1fE8W61%C;hX7;)9@kzEb=i
z)ZaiDUrBybpq$BhI^m{}Ul~fi1<G>@#fL(@&!D&{=rN-BVQ5!Y6b}LJNbz{+cYYLi
z0r^OZ4~FrRoEMOMk^Z%lk~aqV!xWzl^>vcsZ6IGn@%`8ka@Q%&p)6Jt#mB?(;t9oD
z!QVykXOJGUMkC2r2-qD&w#XnBO$5UuD6R-xmg1jb{8XVhS<79A;^lDsnn!V7Xje-p
z-VEjDN^wibS0Kf2LHk)l@e*j~$rMij{rf2H0qyoU#bcnKo}+jP=&7Li1Q?&mbr=rD
zNw<RXd`!uIgnrmb@tx3~e^Oiv+VfyY7tucg>SZLw!=QX7P@G)vs8gI=?-)?r0_-lL
zcsG=TJ;m=qx_v1w2jv_|@$pc<2^7zTa@$Sukx;)G6wiinCZFPD{I8;T0QetLycpW&
z6N-O>_WX+C_aU96{7Ajbg!=tN$v=ns5`^*~@~M!1F^a!|@|2{wB&0`%;=e$@JjH{6
zPo}so_|+&LO8PIw=YpO^6i)!Z4aJ{AdtO2Dh0uQdDNf!ujih)X_~R*l0{lBE9stL+
z!xUc)?d>GRn_#>p=YynPu7IBFl>B$7mnMqufcE)>;%lHibWwaZw4a|8Hw8Wj`Y}mQ
z1Lz+?@d}War8sn7mI}qCz#h4tBl@2~ejO?Knb1DnDc%P8@};-}9G`+IZV2saEydS@
z-9r=~1NkCrCzEu#;2q>zDfu11KT+Hp`t<<F2hlSP+Tj?A2SC2GC@uiwye-AgfSv$~
zUx)s`mEy~x9iF0i4EU=kt_Ah=gyQ79<Ris%LH}TA03^R^Ag4lcXJ}VO6n_lqcc!>4
z)bA>alQoWZQhWi71IH+C4f!gg_<TtJeTtukdhMq8Md-hL5Rc^dGx&$W7FQoM5qA4g
zVaQ|E@@$Hp?NS_)$(q67c((@Z8ZtQ6lMi}KD83u`0tUys<owl+;wzwDJQy77SBG}!
zLvj2bJ9aA>9Pf%lc||ce)<d2vucf#f=poNDNx5CX%8?`2-=v&LIx{FenV{!5#Sa5N
z0i5W+$x+X$qIfg#Hj2Li-p%0n5VZ*O|6p*O)==QXpgofGM?g7CF*q)tB9ND%_(kAy
z4316t!uU3o!Lgnike^2JYT#PHu@|R_JYO`UxGM_7ZYjlmIhf^6@pZt1DZT~xCW?Oo
zzK7!Skj^s{C(q-m7#x?sD#+hsaGb9dz`H3<>V>T7j>WJZ^1MJ8>IZYIhrExk2AtI6
zI~d<)G2~$=N3qa-0ERrSm&cGEM~dTl4cNIcIIdsP-&Zm?*29Mri(ClB$@9@w4371X
z{usyLSkENTlR$CuKJI1)$9gW}f5`0zj+2e^OZvqbN}jayVg|={ZNctUirWCMWN>Vf
zwDVgGj`etgd?UrlbI<$0Njgb;dq;6Oqzk*jqMR*}U&`^aWEdQq>;OKM!Erfk2X4sV
zSiTLoHG^aMY~WrDj^)1qU&Y{9z7+Tt2FLPvz7lo^863-#>xBXa$MQlTU(VoIp44MA
zgJXHpFP<<smM8OIxWteLInpnt;~nG%1IOmzl#9(LG30SQMqwk!DN~%hS3QlvaeE;B
zVm5<gJ>>bf0mb)$eq#p5ddT_o5{fsVFzlQe9P7UXdfX{~4!944WBvM&=`aSzddPG1
zNQ&PCJ!=^p>q&=kK8eAx9`byB3&mf6o*fL1^^kGkAcJE)gFycgiVp;y3!K#BBoqg`
zLWVpZ3h_H?*i|w()-MBkswqAO_#KL?0l!P}DZn29C+X2*TV=66Q`{K1usCOj$U6g<
zV{lw#*MTcDIIco};6@Z*4}3X;V?B3(`!G1xvlaMyithoQM)4cKvw@TT^&ZZL3mEcn
z$-$1%z>vq~zXZzd9>pzyKV)#+PRRLT2gN_bdEI9Q$NE=;p6?V70Zv}vBk7NTelZwc
z?86-EA@A7>QG6fh5d)6v5$AV2`e8Sg;^e(S4F<>cQpT2MvF0*3)<fFK3X0o+d=$kU
zfbXEVC-7W~2LdmrIC*dH7RC31d@FELZsfZ0HA5aQ3D_|P!3$}mJWHY61Sx(IxGaM+
z>wOx<kK#b&bQm1h7r9TRPw|(a--yAn3Uc1Qh{3TQGsuKB#b*Iu%HUYfDQG_~4372e
z26+#PllMZxDgFxNqbN?EpT+^l?G1}AMnCK}Gvx8ON3PcnFgQ++3S6fjrnofl9E$G+
zev;zxz|T{h8#;Xv#XCX1j^eH$f1BdAz*{Ju54@G)8Ngpsyc>82#oqw`2%MCsJ1$J*
zB;dt#(r!hdex)c*p8JjkPV|Iw)Ufm@o&wyS;%UHxDQ*vZ3xnfv1Hbc)-2n#2?SY*C
z<TE%leYSihgJb!bIKjw0WpJ#2E}ODg?-(4*llP)UM{)#6expH;5`$wsE}%z;!Lc4Z
z{~9}62FLQjY>LjK863-#>(KQKj^)>b{0;`k@=rkjNe0LA$sm7)!Ld9S4n*!ggJZOd
zO<Anh436bDfIP1xM*y3{=orV#5@&EMe+cBKP`ncO0tUzRH5K$YGC0<A3*@6H{tEaG
zihluqlHwPjQ4~@9D)8$Re+K+DgJad?IQ5OeaXR0DyvQg{MsWFHJ^=qiPLbmJ9LzFe
zaIAkE@I?%cRa67_V{mLT9C$Q?WBC@~hbgX#jUac9!7;kXrYzP~2FH5H``FDCHv>JN
zDZUuEkQ7HDDF<?$C`Iw{P;N6Qt_<9Q;yS<sC~gEip5jY^@1%Gb@O+BL0>44=?Z97A
zoSYYNjs82oCqQ11;^ccdQozZ1#dNqHUP$pSevaOy6esVUx>9^5jN1VeC(m=EC{C{9
zHd36NC+wg&d0vxAaUC-LP<#sH>jK5eeeYt5i$H%Vr8v2tTuJfGklz~=KLzLKH~ZlY
z6este?@@dj95)|QoIEdhO!2#Le*T=|<T=7?idRDVJ1I_{cl1y^2lP+iGz<23QE?k0
zt^js$buhUG)DPjlAQwdO1mIZ|Zw6jWadIE8mg3}oCjKr6c6b9#neFF?af0TPDZZ2~
zjqZO^oZKhzqWC9}U(Mi9#O#ptes~eZ$vEFYac9u~j^gC{bTIULoG)xQ5#-5x@`RJ?
z_i2<o;kFD8O^~fAn&RZRd6?qlIb#`vL)T*K`A%_l$j<^0!s*1j*=%VRE43e<%iy4b
z9ixcir0&UhgY{#1XwIzH40*hp#@2%FE5ms-Ne?;y-`5Z4fx@EY-6&4(R~Jy6jAQR9
zPR?h@`;A0@1f&zh*?n#>FucLnO4t#3jt||BfgQ|AT#QJ4V$N*0x;PLy%t={dzd8Pg
z9Olgaj<0>N!yK3AT<k$kgR^0CtX~%VB%H_tW-VgKGt;@8!I|lFXK-dZ$@Mp#&T$}*
z(~chzECjzi#go9VNb!f@SEBe-YzR43&W2q!SU)*$C*?rwl6h0Ql>7i_)P@wt-y_1#
zl(Xs8PrjEy@<H?~gS-_bKOML&#b*O&&QHYYC+}l8Q}PQz-h<*xfRpi_q{js~sTab1
zfQM0ff`La-d@b-8iYEczK=EC`NqrK#hk<XU<WB(KN%2D9dntYyIGG1V^w$ADO3B{^
zew^a1z)w(|-0#h&cn`>*r}$6c#T4g<@wW;%-S5bGG3LyENABlg&g^%BxRWD?IkVrL
zWN=&-#L2)8P9BJ`i4TJ_?WQw0({2NUGwreyg2J$Vrd^g&P=s%=qZ8T&2XeL^WG~n?
zJeZ~Ag1(x>QgR9kVkrgsV-J>8Q9|FXVtUbsumW9u9F=e!rM^GNMTPhMVJL<c_E(+$
zd<cpTVSew46UIpoGa>ZH!XS+O9W8rLKR17rJ^W2Adq*dyK-bW}g3(8!e9-dTINLa5
zAcw5FyZ+4r{oMa6=;P_<N|dAWBD)yluU4^?oc(=$@iOg7XthmOCG;s)w7NL@dKUQI
z{X&#r3GoO>fUAeSTOj)28C3B9;RatO(rp>5)W!e$a9Eb<#v%`9&~18ybbI&y-l5}9
zK*6|u{_n=0jN)RQ<amO1*-jU>_LM>5CEJ-uuCMs%AVAJ{KwWPiCh_s{1n)EZB$m~M
z@r7JhVul?#@8I}2$0^*;bqRoNsv7KoVp-(HyQD9}?J)N9m%i+qLp(ALgSP+J_d)@E
z+SlU5=z@sYKDJHU$K!ur_PfCT4Tw)RbpG*ir7!#OGdMAr_VIW{+dqj|U-nC2FdTye
z8IHD}jl%k}AC4Oaa%&+z&Og4FP20!$!y-`KXpiICKyWGnu*J5Rt`d3rvj0V!BPGMI
zkMF0`_U|EvMWDDjk<fo(xXvc;XOI9o|M+=aU-l*7#%>$KK8{P<|9}`<gam-05;(YU
z4+a1mN{rQscwhFvz=hI1=m)Y$P6Yi(eA520@xJU|gXeAcA^l*!H$L%;_7ndY+>dvr
z1}0*k#1};I`$~U(5JzGw#K-B!Nh0w{`W5=IFAVqZ$n_$zN8%Gd{!T+*_8s6vaVrR7
z`#4J^KC!Rek9~8n?@kQCmc%D`dO!BN!2U51#P&y`ABj)w<M+eR-=6@ykKB2%&-?#U
z{`mV6edRwjoTDe4QT|vZZ67~J!1l@fCQd9Cs{~$nbs!NSfOy$yM$Dt1_%iswhMXc1
z<am4S6C6(BLpa%(Dsc8-LolbTkdMU2_jAa8uMpY^q$5HgExQc?JXF%-S2)C{$1i@S
z5wwrT7p#+xe+=T|_RVy3{G%wmulf^)3mT|K_Vw^Mq=>{P?WZr>*k1iaj#V;mP!4(V
zIRYIY50g|AV@K3fVQ+fxZ*hG8Eo*%3*H`>_NPj++f6Dv!$6J;Bl~tx|OjXxXQ&Uxu
zkx`wdqM<sS^Iv7^RE=rVWMovPX--#_!Oj6K^fQ0%0Iok8xzN+NKR%LT7V944<Vcr|
zby=hFSNr9Hl;wiZ{~2=rGw}bQ8SGIz#LqQ6z|}d})kVh5)5ldNI3mDxhKyX0jAxJx
zI!l#tWaG&)E}nr%%0Dn-vW$PA47z?mXSLqsf*;w@v(a0uXRT*tZE2kF-8iNLw{@5K
zNt5Mp+nAq_D~mgiNy10tWGmUJ#tFZ!;KXxQmyatEio>@|ljg`8%dxufw<&eeO{w)4
z5SztXi+A54=~=9F^r~N&agvX$gK_d|E?DJ0;k9u>t4Tt+aY7{!t%{J9^Ald^Rq{**
z3&>}jFh`aj1dt(q<D?zzB)J$*5@V-PDDEvXVjNSBQ@+ejZ@HeG-U>bYG9hV{0u+#N
z-#A$v?_I%7SfzxcOQqyZp^)?(oW&Qt<cN?o%Q$%!7A6+iM=0auU|9u}T1HypN`i}w
zlcEq#8etrFTWCEVqm7f-%a&jxZ?U8>_DW!kJQA-8Q2^GT@CZzhq!=ez$qKWJm023N
zaBa}H-{vR0>rEmyC}EONMG|Kvt6-M!1=JZQTvaJCPMW5O3g{jq2T`cZ5-LqdDgRxh
z^Amn^l+920Otj)m#a5t#7E?w!3wB#OLrEyk5G6(EtUlNJlHhi2<X1=jwW|iOgyJTl
zy*G7kLelGzQCtSOvgSC`sInYz4RaZyJii0w37upIGVyBiFQiynx3|ET<K(syDQ1yl
zjr^~E{6zNHwZb;n+n3DY90r+YyYRG-#mhXF8%i9|iqtxn_Rvhj^MP#PLv_#F=j}v2
z=Z~E>H!t~as_sz%$)Y<2O_!|<vM(syy1#c_GS5+&vq#qn>3leDzD!In<z=jbsa}E5
zSsCL+Jkq8~=KDJjss*{#e$wuUYW=<Dx9jtonr5S@N|8-7=W9p&usXd@d$Sl?aD17@
zp7y|irzI)VmIw@q3wOHtYj@lhiJ#?<s^8XsG55Pv=|AersY4N2W6#{2KKIj+3t8$b
zd{~#wb|p;7+oCN!-SEqN=k+(A$2^p9&;7NkA#CW7qw!aE6d!F!*yvqX)_g4Odh6?u
z@!hVQt<JIBMN*UpnWe2;VYYw5>}_{n|DGdWJpYXKhzvU+vzo4{RVtUJImJ1K8l779
z;?$*e5lj8YwcN=vH{brK;k$?4_RDQ+CHBf*n2;)7HrM1`kWoeb<m*3oTr}IhaoruK
zms?%Zzl~DyNpYDPq&H;scI`#y3<|!km0c(@a+}MhYv*Mn->Afz>?%vE;`J%<vYl*Z
zd1dA<lfiF?Ii7pYbIPy8RxCcEKtU_gddP%a)ttMd9TMtF5~ZJ?^|o0vpywiM#I)NB
zD{?=Fi$~c!=H9w4XGhyq8-Z26Me(nfymU`K^(~KALa?-ch(V+4nBc1g)mE<@QpfQ*
z7N59%<F>%YEQk9;rK3|@vIh-3X?`zF@t$n$@gof#8>=VhZ@ZyfFE#tFlD@sg(%_fT
zQyd1%j+iv(5^whBu-se&??p-rG%km(^x(bSdA6)D`HjZ(t2I>$`&QN220oRR3LLpi
zNV7@by3}az+0vW?iwA`(#@Prj3txTlt+I09(m^g|+h(T}O_uETml)Ujas1)VNi|!0
zsv;)5C~M;4+PKv&EhXZJ=B&tK>GEM8wu}n>JwEncmRVq(OtWk3)3WZN+iF&*NSW~d
z8g{37clz1fiANg8*td*R5v=Go*S<P_rr<62L!<9V4tI14Y$`Vsag%aB{?fXr%}&hb
z+?BfJrA2xjhxNQJ%_`dMZCUtPL{r0gwwG7fNSB`cu@Nhto;#@K`rRzBUS`jXC(jl|
zhTXs6bS66A@pI>~4;xlie;k!*7_a<ehMZHrza;OvfSRP1Pfg=X9hD^?4V|E9{5Hky
z+(C&sPj$S_CrD*&`)>L4S9Q%#JKp0zi}!rredfWp(Ve1^Vb?R8FQ~Zg_^v7PSU1`+
zXT;FXg2xrJKIDI>91%St$70uy*23#Xxwhk_cDD?iFyyzVV!{Wt4bn4nTW(#-t@*XY
z<6z#Y@$NOA?a_OKe%&>BTKVkUQ;C_QTedb%oc`|RnInbSh2C%4XQqC=rMaV^v9g%U
z@xAiMPxogp_vuN=pP{Z)sBu?2Ky<ES)V^=}Cr`b3H}#xxTx5tv_Ls%mN|%2bJ1y%;
zs8iOZFN!C)N0)p|yzJ>O7~H11^VA4QQ?-}6a{{i#svCyyo^;Z!`i@YP*|S%zsz=sI
z*OXKTewbc2_{vSskyg6(;>tr5#X`FEh5P~%{Wm9`tADYvP5xqC%jc<=wY0K-td`wb
z8**_*?xb~L!-_^5Z3@3N@x5y5pzfW<DyAtrHd`E39{COZi(7TNa(}z~`1*5F8V?K_
zw>upedsJEG_+sP6BUY2Pc^PIWz7}`8H=MV5jl}xbO=!d-;}&_BnE1of>?~Rql<Er4
zy0i57X0hr)zJ}|ql~$<8%B~o{VM4h2*!G2Axa42Ezj|@uj_;u_8u^jW)70E|KM!a>
zDG{JuBi^?8@xae}$9&nG(W*G_=GkJ`5^piID)GqGx6h5U+*K(tal*GfbJw==_K05M
zI%Ub_ZGY;L!Cu*~T{3%es^&bux9sLy+ZpK{zTfy$*H$N%OcJqLHqAo$!^~%f1q~l6
zPfo5nlo2pwNlHM&w^xaYL$!}CHPQWk+%td8>VY{ABrHzkau0juA>tC8vY@JZxmwmd
z4|^pM)eZ|OkJ$4XBh?2dy?(3b<U2-Eyg=hq^;sPeQQeu-2L`Kds3|UdJSa)<_y~p2
zmfBC_1|9dR+>(E4bzAv*-yy-%W6yjmUR6Eb_4n_2@vnn^Y-=C*q;&ASX<0c@yl0<k
zx2bhsia)A7UG3L5o8<wL&Ci5I$Nw6$M5oPbwZoY&+z*O%Zs7w2DPQvKEaDGO^R>9N
zKwnSnL38AArLnU7R$lHt;wno<U160T8IZh2CRt@}vOq%It#uBQ=hqDX#Tu&en9t+o
zQQ<*OReT;N-9Ha35<1&FOYMcqOs$QZg-y?o3wKK5OBm;6)xjnH+Ht@t1G76kb``od
zLwE2lZhW>V<A;RD?Rz;ndoRZ5TV8W;OPp}@%&{ffB?_+}tnjuNxnp8Vp`PZm_z>;(
zogWSNT&!w1(!PAhwTFhWN}VxtQ){QTT-2L5ZsW?G!7~op3>X-*C35%Vr$%Q-U%p?L
z^yKS0V~doO6;c|G8O@=k!frf6RR(MvuRU+nnrr^wr|wa8vetX9E}m)r!fDO2J7Q|(
zwLydTx}^pMJmwA3HddbagLkI(S&3n%-}uE@o_#7d!BM+5{2QyPDJ$Rz&*!VZtL4(_
zcJF!lMfCgD$i3fE_qL4FQLTF8ps>T1H6Uk)Pr`)rSKhp<%gk(8+A%*M{le$K<qL)v
zEIPC4!o0MfA9Cj3Q*9}$y)ead+3T0?UQhkH+JAB>8955!dxf0q6mk`SYYV+&!+{(R
z<3Fi4IF;|M*YLC)2jpDa92{78%u7n!%2g9qYK%W~jZ1!)^!)tPZE>1Q&M#0sv)tLo
zQD5|#yGoG5%1?UY&%_;u-Ew!>DDc(^-MqDE7a*s~#15HDO#J9P!(!G#F-PI(7yBbO
z6eqn~-C;U^h@NP20&j7+kx`IS?K=743iDi@^up!_3dB7eqjLJv!E`y^$0O?REYi(V
z`N1{H-A!xzyx^p-;m_YhxQA{t&^0dIEj(b@Pm|8Q<9ei)?CLtGd^^x5?1jqvlDrCe
z$#bcfQb+s{nzUA5t!~wOLzzQIw<uhf@t-67doxenEfK|U6@Ia6g-4Ye9W+i69DCR}
zE;FiXwEDjHW$HI{4jf+)*D4;bbs#%s=#9@yr|HTs*5=ag8M<ow<6nc-&ox*bn{%`H
zc9mj+Vd9p^M5ze_yD#tTuJUqPU^?k_@!aaHgV*OiyYKXP$k&Xzd)2CwuMK@=cQo^<
z_`3_4_od&=T&DfZRQd(iWy#u8;uSNZW+?{GIpbG8t1CHWqvZ83FFdlh#rVITbW_81
zfBDRxk|P@p)~tNN)12vgWV}_6W5U9~f+-#)T=%`(W);||pRrr;R7yx}OR2Qq`P-W=
zUUy6$I%TAQ*4)DPJiEM(W!t74zj;RG;I+aJ!Pios-!_wP+JCSG6}U;)ZHaARgYv&g
zt~y@1Y+0nnttXK$s^k1Tujgpwh}g|^*47WR-u8Bu>+N=<qcgqDj=VhidqlS1Y)4X`
z-1sU1IpPmbbG5wT_h9OfhO94qQZBKXx`L6_hhAp9&2ZP><+AM5<dGtU4?nz_xg#v)
zV(}8?K+Uv6gDua#I~?zoTVcD??s$x~qvEe~mP&!2PAE8QW|(^v-kkQWP0aq7W^9qV
zt&y?rv_kE&=!(@5huaSOJW9MZ)?8rX0{*f0r`<FyO)H-lF<Iry`ShZ*zGVp^9%9vL
zs$n{3&ghJ&Pe>_!)ic52p{MQi1{2RRYd*P>aPCc(&Y^kNgm;b370g%47g4hN&Odd4
zynoCL`LR)Np8ebt8kqdO@YM5IskE1si3%Mz)rZeEbf2mAX7Wp&OoIiIom%xOiCfo9
zh}s&-CnCAAOnm2=yitjdro_(YNjUa#{^wm`mIbM2CPl109UU0g$h&mgp8d9_c8~Af
z*Y<Ep=UXcITH(I>i*nuX3dh6`tFIIlk$W#&6(Y_0@IY)-wou2D1#gxdGrRpec}#3@
zl;x!*F1KgI=ggVDMZk2k@02VJKl{r+J671QxOk_h?A7DbZ*2D0Ms2=+^w`RF$%iAk
zyKcnQf3&>2X3gtwrJsDZ-q|uF@n^-=V?&+=#5C33_Saf@X^zM6vp*#)ukcp7<qk_p
za}pADopSzr_eb$xxf0)G*YFQ4+OxIx;_=M3y!|TAtk+0n>5n?_{fkMGYney<h?l<l
zhkcsuG8{cx%|m)@ew98{%-6jbH}`GXY<<%Njp6cvcYM5r*RUp=guyMR-u96J<I<n@
zlDF-aSJ~7dhCK!eO?eX|CBE-$ySCzR<E|vRjluS_t726K#msv8YK7g=*vZP}ekIM1
ztpi`4ikYk=5EWgkGW#IcBIggPvSCT-b5Fe8QR90ebm9>ifw2-ADf5i#20E2qYbsj%
z#IQtZR_@8&j|2U@AFOIGIxFhF_0my^LY9c|k(*7v%~#8}eQ<cX#^b=;RN>FZvM$dI
zSr}PT{C!#8*U(>X5np~)Ep70aK7G{{t*<#^%ZDxUerTj#I7MyevDA>EmEYql2DbPQ
zRe9ww@#m18?$#;sSr>2kTW<<+e)Pe&=4qi^wEtzUdhMP!|7%MbvhN?spnk=Re*Y(H
z8O}%X(OnU?V;>X#tR>jjT85^Ar?>}P>~k$cW9qIqD1{BK&;Ofi0b(=%>udh?on-Fb
zH-RAWu;FIE74kR3K5mxie<7QT{fFawXML@KH=NC3uw?IZ{&8*z^Yr!)5+uXk;rZ*i
zJ4X1Pp9tg02szGAM;t%Ppq&{4eeuQpaQl9^M?V}Vyf6LH{m5_Xhwto%r}e`#`r-Ng
z@Js#htNrl$e)!{l_~(8&Z$ITj-6VC!>u9kT*5WM4#a>qHZyEL~SbeXdWpD4pSx728
z99Dn|baiyWcP{%`REjK&#aVPK97Sd?PlYyk@vR{Lz+iiHBNQ)x#aL(S@71ax3_a?1
z!mk4mjd-aoe1r8b@Mobdq8dH!cg5>%QLAck)`3Dr$^KS9el|wFbsvl&a`+ZF?u~?R
zzz{jiac?Ai4~EELj&FYvo`oTDnBzW4_;U=A!-psQOqB2*43Wd~_*oO-xL&cN^@sw;
zdhmO3M1CYg9^dCDTn4xzV)$7S;c5(dNd_nHz+(OQ*(s4H@0#KC;4y{p9SlAAI6(L@
z2FLxE@Usj)n!zi8W4l5O-olV)+U;O)d=5bLe`9cF`IEWqba@WJ29cvVdB-1fY4jud
z0~zu%3?9kg%<@lU@UaZ}R0e0ZpG*d4rvEI1k7MW|S7rDi1oL?|d1n%H{3G8s!EGKp
z%$P?nYzsTW$(W1V26mWZTLIXEoIGd4<^r&fH&YlK$5{;Zp+#~0kN`Vf_J59kET0S9
zh~lx3{{<9J0C{VQ9|6BJ#ic+VA8)Y3Hu2Ai8~gsuVIurI@U`sFKl0?AV|={9j>wa5
z5u|c(FV_YCQHsk!dQMUN3gowl;-no^Q=EMBp^4&Mkp6axi-6sC6n6ywKnN%KBHz9j
zrg#eIC*?}y8$iz#O5Oyx7RAp2H>5b3lS00ULiCgNw1Se40ly!`cY;5J;$OfnX-7nV
z3FM2!BYZ8$lW)KfPS#*JN$KAR@<kM{0R7h~J`?J_iQ=R_$lN$$7q1P9T^A+Kp)A%<
zisP{fyFn0-=y}G$tPvE~2fr-EpMhQ#ijy@A$XqL;-yHPMqvXl>MaEkqzZK-k_(?dK
zOOQ_K!S7UHN4}{*<P|uW)kMiFgZvMQdjl7N`XPF503T2BHqfs@@hs50h~le2o_vFZ
z=qKN-TTjW8H2@A$oX9<-_ytI355>)Zi@_xVv3mv5Gl}9mA^jS_adg;a#~^d8iJp~U
z&xWA~zav48E6XU3&w;RWU~sI9oL6}<IMzePeLsrN#Y&J1VsNZyDCBn|aFTw~9=7(w
z$s7=@1KSNpKkQC1^kYuW7cWqJJ6oE?DyBF&PLxu1XM+3-iu(cYV(7trg_PTG2FK|s
z1bJ?JL600s|7nhwHH6|ffeTao2Jn#-e*=6p#h(F}r?>!=zaqtXfvW*0^|A%@%%|kX
zf;@AL0G!{^z^y4g`$3N{#dCnKqd2KwGFP6YClTZ?Q}QHVcPUPei{u-+xcqT_k^56*
z4n3)tS&;r7&_g&G$9_=U3FOI19+4-<KLI%TBRm%5ncw`!<rV>4fs!u<KAGbAz||=Z
z4+U6S6#oJ8`V5ZCK?VJ=Tgc!zJ(4iaSW<jAaI%I5$(I^%2TGpINnx%9fc2B(jV~o{
z1bRY&<7DG5wFT0@h9QsBZ-jo>F~9AP^*e)}?F@O$?Sb#3cm(i+6b}P_6gWvwDx`;e
ztDo?3AkX}kKDN6Fcn76F9{5K}KhZM?M@Ej6^Kp<Dq&T_1I)dV5AU}%Y<UCd$I7vUL
z$2pYzOVDFX@#nx7^`pm)k|%TLy(s<(^aN2{0FGZ_6esUeMgu45UkCM)!r)jnVAc@^
z$L)$-*IcDI`4(Rb#mQR8T?~%(gSYpkJdz%A{wISQD{_SYf&^(&oDa&uoZ@8dD_4q>
z@pcu1g9^4i@@;uymyBaa81lFrHbbOS6i)+wjpEtBA5)yn`Faf;w_Chx$4(84#r#%0
zF0-jnzdsrBn3FXx2E#=xNxv`Hok;Oe;Cd8a1AHOH@qIh&JQ*C4!sZbSj?0JKZ`}kO
z=ZoDZLH}Nglk=_&iXR0dWbQc8a}xL^O1_qz8WyXH;+*@<ELH=>10X%^6esC<OL20%
z5WopRj-=-iq=)$}cN|9ajHBeq`Qa3b=drb-_0uUX1Kfb(<ouBNEq5$J@=NBdV}^f|
zA;12Vo-WY8isCK66DeK=dUjHL3CJI!_<WGhrFbdy>x&d8`kCK&$09`kElQr~e?W1f
zzl-9@P+z|(9t7zh1UHp%F#eI_%W#U5>ua*s8IdP?rc&}mk2b~Iz%E&vg6MICax<dj
zYa#vf`r-H<EOulZ;Q0Q`<)wK92oSCS{*-?BS&EbM{Q7=)2gPH+KL{H{j@V7)cv<5p
zo&j8k;^chQxgWls;ws?3OmXrJA}%Oz9E``Yqu?J!adLh|?pqM~0?<p^BjMyYNXC1@
ziJn#c=uf7&FX$)76QYOka!Q`Gw^tM==Ph6R;pE$gL_d*Nfp$kY$q$^4vHJ>~^0RA9
z80wA4gSU6BTf#~E!S|@KBb?MPd5xX$`FIC8W6q{mp70eEH-~(#q&Rqczwv|n9qv-|
zAwV9sgvWzlk>dBkuSD@FkWP|*q9+o#1|?quT$kd%fg4g>2=Zl0acSTSDJ~D(isDMZ
zZ7Hq+oRlX?|199nlsuUW??G|$Z6aTaF9tn<6er_e7{%Q|K8oVxc}5Jy$@7d26i)y>
zNfak*h?4tuB)@w>elN)5>cHazaWb%j#hCp6%G_$slx7cCXYZg8U-t7(=KSRUe@-*1
z12P^#wXk%_4z-1D)l0{sJ<MR3>*cz=dw=iH@h6~Qe)Rj_jXxR1#X8A&fp*zW7q<8r
z8`BZ{WQ*^^^%b9-H_c{7M*BFe*pc{nyukZ(`K2R<9XYS(`2PD&10IKP``0A`WD7S?
z$@4q>JPz9+_9Z~h2W{DDApyW0pg=4B>Rf-~gBZ&l?et~89t@a^awM^RY=W2}_QMhD
z%f12#`jCR+sOgOlUKSot`ih?l*Ae7C2$3iDi64(seWhOpHw@&+^$JcuK2DMNB>m}#
zQAtDuT{mK3yya|q|I@PjP)J|)x59yq#K-oBq91L)0I|OE?*R54Q8?3)_=KHAJAK(N
z0sCZJ#`cBKkHjbWzm8a6_OF5cHY&p;K8nV6<>-H3_RW<!;ks}f!1nPq7Ku;nHzI~j
z&~r+U;le_0BE;wT{=_HAYC{2i#lMF$i^GT@$J=Y4;4UnKex#m2jMXg6*;60@wj>_e
zenp(@Gex<`1tk;qA&c)T<NFa*Hd$otZaQ70{D@k7pB&q#<7<L_4<ZO#IzE1W+gJT<
zRpCS+^@QsW@00k1_hlQ$Ob7eMFb<7E3>PUKA9r(l>_>?8QVjn`&ylbJhNHafHq}@B
zW03wyR0PV)c@-+aHPFr8$KU;bFsBsFF`YV92D|_HoYJ*Ue=?xU-ql6#mW*MImkIXt
zbw#f#`3A^@`3HKt1_s$X`}_HErjrul>E{{T8|>+V=9rQYr;wnCUXP;_BgD%ey*uU7
z8y4v5>mT};-^bN4hyk!#7kmGZKZcypr(C=l5<x!xVZHi%{DXpJf*pgrgY3f`J%iD^
zT;TKfvxme12n_M_`x6}I8SG&n=o%E_6C4BrK_O1Qp22wfEJvS<XHbA+u(QV>;O~cK
z)v|55IieT9h@i8hpR=paAHQq3hhs<(Qe^Ll)cFQr3#fGMgIxVk6ugHf;JSK-B4q^I
zyZih99mXK2T7pA@?0tjWL6N6luxp^7qYo#3fWHrV4-VxUD{~A8@bPqZ4EFT*1MN5i
zA%6s1!(E+2g26O+7`6z3JYY3W5y7rOIPt--3#oUJadPx?3G;Lb_K<OQ3~+Sz434m8
z7tbHBvp*{1KVDx{`+*UE{HTb%|M)!pP)_~OpR0ceBT|^Fr@IHcTKt0@eNeN+Dudbk
zppWC>C_~@nVOJu^;qUZt{KR%IV9WbDhJz&D0~x%_3H9_Np=ghUqFr{Vr(Z~rtG%-$
zDq(!BfgNdb(05Sr1<6dABIE7nALfVVV!KS1At8S5*w2Z@V&SRQ7x0K=oOHz;jaTe@
z@+zM=(^@a;p<%^1DG3KGW8eKCQ<CLyd^w*G7FH!A=Y#*bp_$<%IYd1R&E_^v_-Tn|
zbC)0`Xg0Sj%;r8Si<kV>OZY(M*OnQ^Jq?jIPAD~=v{MEJdB%C5|GN4@EaOyTtx}<N
zeCQZqobcS3Ox#r|Nt!RqlO!e!ld6s3c|I4Jz#ChP6OQ8S$NGfUSE7?g<K!aQwP*n3
zSOwdhN!cU_C4tO`{-YetXZ|ZDnkdZ!cKZn8?>}fr|3PS$wmL4jJ`{@eA0*L#kW~Lc
zGW`cB^dCfux{nl2?myPl{)49V6NKv4N>&pB|5NhX{lr3Xbo&pQ(|?e0|3UNn4>IpR
z$f}<pJi*@KA7LK<2n+Z}Sa`o-J7m|QCiRct_<sj){daI`|G}t{p!xsle+2%nM;v(U
zPaxf-aPX;r2cQ3UaLK=eul*yK(+|(%6Q%b;!s})0*|N-$1HNp~Pr0Jd2mPx@p>6*R
zefrPPj(>)B^&g6h^vl14@p*JVdBU;z{~gT!!bIO=7>+IT@7Va$FaNNu`R`!ee+L`?
zJ9x>zgB|`I?D6m5@cx5UKGB_meawPlU>u2PvGwf3C;IXT5Bqo;G6a2f1Rr7XS4YY?
zhc#5wf3C~c;foK3KRhk@Ze)N}<7mFF$ozdB#gQ5=`6kyy`8yRBkFb!<NI!P3^6LF`
z^C!ke!U0atwAQ&~>fElL@9gQF`i)=TbI0-ejRs!6F%~T{1(_C0m-@`JetOHPES`7L
z@X3o-MYnePhrJrI$^G}eNS)8ooyG2*KcA(g@a4=>ZtdZ|89ng2P3fg;RdbxrB$(|w
zYcKQms?GEJ^2+ua28X|fDKC9qk+I*#M%89BkET<&Xv)SLQ>PwUB{$%L-L@moCaJxB
zIbHFETT5$hU7>W&_E2Bpl<&JQr#2s)J*80Vj*@~|q1*k_!OvPkE#=?-{Ox%&KWv*@
zz>KE#%Le>Bw0we$4$t;-BVFE=g2yV92Wd-ZABj>ld$wq()%v~q&n%OzxEkkF9CK6r
z!1u1;=YF%1R|@WC$0>fe^;^zLrErsC_uzvCEsL`sESyr<qLE#ye6h*zimCOtt79T-
zHy+oEzQvUj>b1kZ;HuxuW0QUaTzVL4;hCKzInVcS<)VjH#nSe!=awDs?r;}Uzbdr(
z-uJifH>~sKYm>9qE>`=#{lHajbDxsVySod9jWAtxTJVyxyuaqek1{`{71UkAsxMX6
zt#J?C<#J=2q5HaHJ{#o993z}NLPW!quG|>B@yY1$1m2zz5s&$UXLk*}c4C9elATf7
zqjCi$(yn+M7}3Pyx+y7EZF{}ER4Z?Vri6n)oWY=@t%c>+JZdyv$1hU35XgP$N3O5n
zZl!~hoJMXuGXAzf@R6o1HoV^NKVB&J9&%A{i0TE?%|aUJ-`x!&j?>!>xI)M43~`v=
zUKTS=MP!7B%-lW8G7=MR>5gB-H*MJN_5rowirp$DK4ZS})ax(jnmqQl?j#jKkMXZ#
zLY=hh^_B|+iwxBr(LK>YRAtypd3mm73D<RnR*Kipo6q%0<Sy%b!ke`Q<yPrizRcGT
z*zPfT=iMNAq4Qi_QC^Z8B^#3`i#5KeZfbFf>#R6%?ry?$&p3r=Lz|m|nwxe-P1&f?
z`a|}Mf4aCs^wO=P?$z8}t8iM}!8g@ccik7Q5`7ir0U71WT#J*xiklmJNVB=_#y54{
zJ%LjPYLwbk507wIxu<o&LD>~tOFZ4CPfhqTtK^K@8dj!ABv(`V*YN@4PYXHd?X`&+
zS?<mKso6}edq&CYX?(23SrMWRA$tv2Id`PEmh6A7fT%xL?t(jfr)JcutZnq%%$>WS
zM-b5oSXNnSjV1EyAb-})oCQI{XK!xw{1!7kUWjW~wie%y*w}+F3|7xjv#dJKAF^Gs
zYvmKQ)FS801tAxNSzN;gnCyQNGiV%FgGik2Xcd;Rs7ZQ^!oW=7iRs%Exc0`Yrtgv9
zuaU2g8Gd-c5`8PKyiY<t8-K<a?luj}YF<=PrnsSX`K_mqXRhm1xZE>X;%b18Uqaeo
zRhuQ38@dOrdUtMI==@tj2bV@(4N||L^Ilhe&-tj&6`dlkI*X*6C0-w^PceNU)*u@q
zWBfqsseD5D6g@u~;~M@zZapWrt@~6&?D+$|50>Y}%wJe2aZIFE(_-IIze$mgbZTcb
zzBM#>Yj-ExHp6+l>Pidyr>$qa1W(*Pc2U&JqBd@?bx(a&bM~%w`+MIDkG(rF#=rB_
zoR1kIT20v(vz82(^UdZpzvMNx;n33ct@X#34hcE_E>7e4F1?4@&*~R9t~TG|#oLhM
zH6`W1TkD5goWENO>29<VT3oIC+HzLf_5rhwFSS*w2sLfo{32rRNB)MB-)6jsaq<$M
zFu>YqPtAxJFZCT(vo<d}rvH)0Drc2Qwq=OEXX9Qj<rcHp*AqPwy=FBHOU~{bDEhY3
z+ag4-HaqK3bGCc^o8gW5JKs+@rCWIV!@!8nY_mhM%dBUY>}bjSHn!o!w_y#3?r)kI
zoPF_7NVc?rUG@k~zZ}gQp*fnhm(%Z;u3TPmq0p#s^!<$Xj{7<7AHK~Le{r{1alxsR
z*(=(QootW#z9CWc-Pp#HT3tEOWij?2Rr#XDUp!AyTu_%~mA3!pG0j<@b3UD_vk-HC
zb1d;rNP4^2e)FFR-h$%p9TwtQ9fKO}&v%&rOnxKS=)FAr*oqg`1|e(b**5Mok9{p;
zG_KK6X_A%E`4i?pNBifSgost`wf5J`w_3ftBYX48!kks3uFGXVsaI{BS>__*Vf}M(
z)jOM&X7!mf5?-CR`>3>ibhc%^bM|N3yV-Y^uRT^5usV0f4Y~O2gN6HU8)nXz@ky>e
zd;6^TOa*^$r_ffb7R6nQHGc}W40(1V>G~R#XJ^6=C>KW<Z@#AWc*#VGllp?Q7AY)A
z(VDnCR;^n)MQX(XWp}?DW1jCRYCLaq=3MFKQX`=of)R7}jv9NZ_LIj|zCf0}YD2{7
zEBE<yECh!)h*b;CRo+*B<HrBP-kZl`_5A<;mo1bK6{&=XB-ygHAWQZ=6xo;TWlIYw
zEu;{#B~&C*NQ+1$EtZrer1ho68YN4#ea~FiOr6){`hDK-@9+El@B6&nuIrq+pT|6B
z&YU@OwmEY?UaPq%HkDwf8{%|gXj8p)WnR{*2W4X&r!QQY6_aaUX}A8%f<u~PiKhZ8
zZuRe}{G5AbD5`KMef93<?s=JN3?^$9mbF*BdMIDIe~rG}9yR^?@0XWM?ytNad0S0>
zc>T9^nwL+mk>YyC%(XF(Ipuiqewl>IaK&YD^18yyZj4CpEgGAj)s!n8uu|{Q4*jr4
z%f~V-ys|9%ney7=c~aWOjPv(om|r|?Zku7wnqhvzJf%&{IREjQ+~hU6?W(yU%DF%L
zk|d=9^`5TD^$XNr_bzEF)57b9MgP`3%SrW=HrKp1yS%og#`%wo^VQbmHmT+wPOivV
zKajMgH)-m+h1V&I{%i}$sv5D?_m{7Jx%^tq^0CEvZN_<RvU!$fxdvXhEc!$8+N?9o
z7oIjJGBT`^D|yk*+<Hy!hc&rYVLtlviLtJ#lCqi>S6=M8yl?yH0rA(aChIfSsN5*t
z?DP07qx8vVtMzXDRK0m&YjtjuL$%wg1veV<FBa_BsP^$&>yMJ#`vOIWSnRhhYdLyX
zK5%hD;c=t5+M<$gUUC(y>J+Z*x%G?T#ofEGQy6hdL^U^f(-wt8Gd3j{nb)XuA9^jy
z!Op>P&@6%N=(+DV@63MBW$JiSg!PkvV7276dV^i-D#Y2NE86y~d--}G_Td{b2lh9?
z{|p@OD)2a&CeHr#7c+}OY`4YUg-(>sp;t!J4S4R4&Kb@2Ni{R-^^)Ry7V_$f*d60N
zHUk_NmM3+sa9~=zo44H~WcJA+bM=M)c#8$b&DlM><i`Fh#~YQKy{x`%aE+DO60Nz#
zu;h_;xxwberlzS&m07os_ik_6>V2(5xZ|*$($#k_TECZVb76{Y-kg(Gw?-_t**RO^
z#9-^($fdGu_6b}b_PVhtwp?kSyI*(k^ItNN%pGUjajRy3)a%tsEw%<vQck3Lp8H<6
zZDjt&vnIorKXC3dFI>fZ*>jTF_u>ymB^}f2tzCXw<;w4kUKOhQuJYp;Yl{CD(`vi+
zrcE-d+OKKO>q__)x8%f#*Kh$d^Dov2<uzlloKg7}V&TvX+dI|O)%DePA~-r7Ip)s@
zzHd5z%w+E|C#kHjw?|5(+&NA^9yvLzWJ;;%=bk^dYVR>wDF>kf&FlgfnWy@4Gm3Qu
z-@0(PtK8ekpzBn?P3c;h&0?AD#&kWEfzt4V?<SU>Iu;JiD0L#nMscPvaL#abyc;pI
z;Msy=M#{3!3@o7gI19X44jvCsZSC*5Z=3+2^~!-WC`^o<V^YD+sKI?YtzyA_b?tR5
z8lS4|nBT6bX=JReW;8V9@KIM7w}_a%jb%$j)(olYw%V7KUtI5m$@srIr8GFi$-qC?
zoe~i>Y~IYX<^3_myIGo@=L4QiJelpo9<boUOOwMtw@5BHqwcWcf{4X&Gf7#CfTU8-
z$o3P<`R`e-E*fbKn|n(xdfA+f2V7d0H6D0DnYrU3lflBFT+6F%tJB8xvX;%?5$M;}
z<{NM5wR2&7Nw0oNd2px4;Kj<G#d0s?)`p){4PMt%R(9uyiIIPJv~=SU|MKVx+33k3
z)>DjX=YFp@KYT{;XT1;EJP&wVHm{Z#Bjnb}w88UUOFn3LH(dAfZE$O-kT;QtV%F9Y
zt)^tVy&q`pA#U3hC0ZJ7UTPl^*f-SrB*aJH<9nI=%e4FljkV^DYv_na9^G>N+{;Oq
z+no}veOs8n_^&+2W;Q7yx%xtV?YS4TT~e!_E*m@)u4L9-6166B=SfZt&aU=O9ji;1
z$3<3V-PUzEH|}4++dR5OaEq_l@cxzWy^e>zx?20ZQ?#JzqwBy1j_$apZ_TBLhC8fd
z9(nzcSkm5MaPxckjnJ@Xg+FcTU)vXjJNQ|}-SB*ty1q>&XvVAs9)ST(^^srpd}JC9
z`81=?f76q*8trmr&DLAS`?u;8`E2XG<6B@Kv{gEDaM2aj3zrkG&VDLkK9nw~X*6Tr
zMMZ7y_@ggWtb2l5Uzt}8c-1!T_0T`{wk&LKW!cnNN6f0K@1yVYs<zsV*IR#78j$pu
zcl%y*zyGC~tS^K4QYvB^2u%a`fd9N#H+{}_OpO>>H}4wd;^VfxR;A@2;!u0;)#h96
zHak^<=KS*1u{Ap+9r@vLgty7X6=!_kUf^Hup8uNTb>>3dP5r^cY${n|d9Q6(&yZeU
zBpN|+ld7^-DQZ68HTu<GY1}I5#;?9(Ec16?s_6|jx@L8{w)I8&v4bfWE8dR{{4ig?
zO0ei&6zAt}+l+m0v02SN6KuBS(2&9l*Zt|&<O+QA)L2{Zc2~T3v98F$e>l@#Y56(h
zLs4qstXi^rc{0}&2-ORnWzq?h=3V|(@1Kp{(F~psPFrinScV*w^Hc6R8g%d0*Pc=3
zRek%8-?B6@4Aw7+(=__-o-}?xIb`z>!PfKVn`$p4U7{?v%$x|dU;nb`^8As$@EzCo
z+N}3`*DAml{&2SB&w$ds$rA(ju5CMT^|JKVUFupL7gO%}Pc(Qpukj}Os)jjpYq=fy
zU{7Hc{4RS!^4)5i+!I#@4WmT%<u<i;%oWQ{y`8!9*N6TOhc50aEq6Go@y)$pN4?~*
z@QjUi@2xUk>TaqZQR-^_biuAL#J~ES;asH<4uRYa7r(9_$g=(+<h`@_%F}Zj<IgkJ
zUQD(h$S7DaY_(+BKl$of+oB7{LS97Y&*u?M%Vht^ucE#s)k5@<2FomwTSL{{Eqxpz
zSDzeLJjwrQm;CzJ3!cIfCwKI`RHhgv&ouKGb+6Om+C0{)@-TX#Uh8S=3TEq~O)HP|
zswun~`|NfzO*8eZ!O5nXM^iQ*mYr8U?xKC;)yKxecMffqI&*h8ZEUmeyDFV^-6gfD
zLgQPw3gn+Oq^)?-D&x0@*E7C2IWHtdc7#t=)Np2^V1wIPg;|lg-s#z2M1?7H;`v$S
zVp`b?MUNYp4d@)-niTk<)34_JqT$-)Qyt&-2)_?eSX{oc)bi1~p_iwmIUXHNX!EF%
ztTSah{bJx;byQUC;C2~)^)@pXBen6swMnzKtcf{U^6+8z66qs1T|&>xfAyI=d$#Z?
z<Bv5R3)t7@r}9@`sb)La*jX9BbWYAs$(B72UND7oAAho@yj@eqwb{7e@=Z$GJC)#@
zVprw=dA7Cot-71#9=!$+Mt5tofW|Z71@Si?H@qK<<4u%#pLKQ5<+vf%f<1@InK)a5
z$C#O3=>L=8TOWVky}9^^vTx-Eg#~R3p4jLzU0`%+@?QANI)|e<D6`S@$GSC_rQ~%B
z1=(*Eu3E0@_f;V<JMP>Ki(?B4pS!f38ML1DDP^YrlzqoxA+<b(n}Uj)FPkJS*F5%9
zf9!h0BO?K0)ualm>;<YjB_2(+DLj%|nR-f0;x6OQ{Nh{OM?&;+T`tGRpDuP$7cKc`
zZuKkXnjN)lE~nS$X$|bnxN*LiBUpV8*U5DyGJ1I{wnRL=)!f!}>@`P=6sI|7!Ow*C
zx6j8_<;7*SK3K)5zH6zx2-6R@NB=DLxc}>Br`^k~MgI4!o=rLScOG3Zua<c<@<Ui|
zuu*bqns{4si^dr?$(*%~#}fm@ey#jgyuv0T^}guAn@0J)$?qb@a$1evRo>j~W|wty
z&E<!`#+h8J+qvY=1YF|D*t_JuV0l<h<eiAQPrTc{JSmr6Q^0Q87%JMBxc2qgQicxh
zxjA}U8tXRheqDI`?)Ds2QO3`W;+5Gk;zRG=kNxBH`TMz43a@QIvbuf$`uMo1`p#|<
z=fb?+Y}p;%sRiQiT-d}d3RSl)Odfa~mG%8c<7@dSo{5P4amh0#@3xxO%QY?CH6Cp5
zA~+*Gz_8i#dPqUbI*mn|b(T*Kan16#;%eZvKDCZZ%>Bv71PPreZT;QGr(<eGSWh~x
z&0Vf~<8q+S^Yw9>qW4d!KI65zy;qB=uSG(7M7cpm^XY86F3<VJy@tu5-HH}TvUW$4
zPDczj+sHo=GDv5r)RvH1n80#CH~p1IPHAn5R>G-tifN*ry3)}n;-{uQE06R{O}Z@=
zog8SpyYKrkt;gc?0yQFMiHqgD_f9YWb;NgjN0oTbx}6EPTy}IGv$(%k)VjP?HtV`i
z{%4<wqsLkn39-sPtLYn)_)58_eAoOLb5@;Rv#W@bcY|xqPq{NkU+J}%<vcMwsBtJl
z+grAKA)k++!3*m_jd!Y<c0J)nX9J(Ocj){$VPJVlPw-6E65}hISw>{%#T4kWsUIC#
znN}`0HF>jZ^P;g6_u4C47p<AwFo)ACK5>7>dErTsWi_JtfnO&*FAutMwb~dD@~9*~
zo71+ty6_?Ac;lpis&nzI#KD??^wyg*S=!o)<xb@p?+Z`2YmVRjOv<2Za)M*6L$S$;
zU?~PSuTMhhFNB4?TE=7-l?IrHn>{xv_4_Q?oWy)zRdrq9>+R_so;<dEwj;uq1ZMd5
z9W*V@iks`f>;Chm<3&}~XUVTh>%Zhn{WENMV)DZ+<MbIE%*yKv4ofV%{^`=^Ehe9&
zSWnhDHSg+sx06}aHuePj2dzhm(#=uIJ9=;NMl+u%J>bZ8bfK+kF~<>|gts?S>@3%t
zl%#z~WFI>twDgDS`)7S6wY&^Jnc{C8e@Q)$L+2~xKF?r5XvQV820voVss=8xEjO-r
zI&~H?hfBmNsxj7ariX={R>)&yl5-R{KcKhZo#C8s?7Moy0#18ovt6m~c$`{4u;5tT
z@?Cuk@|ZW*?HsT%daKhT$>PMMq5VGom&HPf1ij`0rE29_os*0=CcO8pyYakyY;MD)
z;F1Wbn&t1ks@0pnI)9EjB|f_;^|hTz%1~S7_j{kdPN-WXpYwcn>tjc8`ec4#&*m$+
zsTDiK<{!}?kvmhU%dj)Pux2z=Gv9f(v*y;r3^#c=%{Q3dDm+kmQU8X^o~^-GFT`B@
zdS=$-3-j+jL;V76y8q2^RiIyr5b*>3qse1cq4Hy(FjNB#>?%ebr-cYo7<QXe7(%%j
z7ILt%#S>!CR|Skw0&Fe#)8OQeWc1`Dp8Qgj;Sb<F;QX2x$LbiP1}FbvCM`~(Nal^4
zZ<aDSv(DrcA{Y^G11FmX>>354Olu&2|L4Z6`hC*>ueARAF{?QK6(0qde)lX#gf{)}
z$E=$7ZwD~M^!rWlKa0VGX<DzNKMc&#x;!#dP@f^Rly>|6?{W~L3RtQAmyi}rsSoIh
zUR7ZGl1-8tVEt>2X<gM=DYSh3iJ?Hu@=$9ZjZy0kF>6BnxM}EL|88_R=)*moK8WBv
zq+C+#AHm}2=ugw(;JS7?|K)V}eLB384)3GGKhxnq=y0sF6?JSX@~~8Bs44|8O4Vxc
zr}*zE4m$%pgWMdp5ra^<5x2oM8k%g-Fmy1{(Xr6Bbg<OeV5sdt33LkzaSnE;xKp*$
z#t+_3e3HwJ0=n){J6}0?xCPOK#0(fZiuiyP8h45|k`>|5-7SFl`jux81<r2|4sxfB
zRfR~9zYhfN+lle5g51#pdSg;8Aj%2Ya^eT-J{oHX^<@UPhd?(-#6epH4Cul8N{EXB
zNEqP2C*sxs5(YTvzlXR7fP?}6;6?)C=-mOJ2m2i2>BKxRz(G5Tcs4N)3{N+YhN=F!
zh<T(3^${4*FD8D7*8)fw$PcK;h_?Yq7_NU!!++_AA;<MoboA(5DqKGg9$@hNh(V6)
zW$5VD>F5pU=xyof-RbB<=;-&;(Sz@o0K@a2K}TOmM}LEk{sA3*3mtto9sNf-`X6-k
z=sUdl_TmR%n)O`@Ij%?VY~kgjPDgJ{$3Gei3it0xM~}WsiR%y2(Z@lK>$B+S(YtTB
z9=)4@ukSrN{-4tE|AvnK6CM3GI(qcoVLU&4u!Ap%29D9FeGrEn*UQt<Ytqr1(9t{4
z(R<U;@1dhVN=KhgN1snef0K^>Asu}u9eocS{RAC78#u`(3@`urkmKbqMn}Jzj$Vt7
z-ja^qg^nJL1%&7403Ce-9sg(O=u7D6%Sd`2qMT6uY@?&^Ch5t?yAe8ibP5W}pR7k?
z_~7d+2rifi!}ZdT<NCF9^k_^TT)%~m-iwa^P&)c3I{Flnp1i;3(a~S0qrXo_|CEmY
zJstfh9X<L^H(oxx;6*K1{^a~Gg&fz*(b1!^ba1^H9laAB|J&*4Bk1Vk=;+bdHF$n5
z)6w6i<NpyI{YyG}G^P#S{(PsSp9L=!aXlKN2G9Qrs0SQ8ctiWI3ds+64GwWMb`8*j
z_pcE*C;1T~aWu9J&<m3|x;_OR$6-`rj&{xurhtQc4d^@!v@O5@CtuCOR|S7_bS((Z
z`GEmFJMlwtmH|i@;NXXBC7b~ar28H&RKa)#+#j?t9u3<sLyRZE4B22j4!&FHj&XE6
z2G`BNP=1!dbis8qFvRCVKf7r7H_wCV9>Mq{SlGuf4zBlsrP3z9{gi-<Fv4<ZlixfT
zT-*>=Oq=}X$Ei<eDHPDl78uIsAT3Bi*ENW*g!y~}mm_`=ZZH%N@t3fiVRwSx{>$Nw
zDQ0+{jP&c_eliE+?yy1$Vq6ziO!V#)@`J96lrg<8EPox0&jJw%v&484<jxqM2g_kQ
z#xr3!9OI0z{EuNgkCrSY9pkmI94=t|2xuq>yN>aESU$BFSBK?;u4_>FD1)7hus4_<
zjrj|{!UqiLWx&CKFf?`=;yiG@X2N_SZUW<@>l(yY!}^TIDnMKZ)(14^2I5ALZ@~Op
zLT-w2TgdG(?hLsP#ycQKV|1W&x508lV+kN$4fpF4n4dU!K8nVOLVAB#KKYn_2Tb=m
z#!tiTK8EqzaC?!*0tGI@;r`A9(?{ukhI%x16ykGX`TJq|J1{@!x&Y~4!+b<xdI8vO
z<Y7Dl?(d}-4~6Z+9gOS2{jmw-C*gWM$9Na4hrJjNfd0oY{sycFVT>?eXuU*WIdEZo
z87zlI7_Wf!VL8SJVSPYjkRtzEX~|MFG5t>H-xT9(pq@OYD3C6P`QM4@H^KeuAjXs7
zb~%A@G=^g)#_eHwUc|T#EPr&pfYvJlwlnBmeZ<iiTP>KMA-KM;F`fkZAjTI!K8f)i
zu$*VWDN45oZbx2>e~0^>5XR@j{c9!0li>DM#rS5JkBu1bhV{%6;{`DPP8c79_0u2Y
z!*Kr!!}tprj={JC%zqBXTVT4EG0qJ0S%z_Rep!R@bujz{<07zLy~MZ*tS9{#SB2$2
zf$>0Cf6(;^+Ky;U%sFuV5YK_-BZ%=LxZPJ^yaA@CjPW#>A8m~5gM<h($M`9@y-<0h
z{8+(q@WJ$7U_IG|adduj7~@qi|A`o%1IsfT<8NU262=u_d6r{b4er+uFfLA8T}m6q
z7sLGjgK<9SX9(jbp`ULUKMTWbaQ#rZ1;XReJd6j!b_})0Nbdv7VHKu-3F|rPUx@UV
z!3<$~n0_4$TVebQO-^ya_<OkBw`2S&+>gRAeh}vWD8|tkM=2Ob?O_haQTthfanw%U
z#<(lYPXos1z;f=yxHDX@_ZT;U<uHPA4am_WKUB_hU^_{DAWdix?||pSi{Ns^ZD2kn
zF|Go)qY}m!!TnSV<1gTTXNK_waJ$=M{0OYK-WY!f^BIcqV#p6+9E}B<fN?aoRTjn-
zU^y3JTmbT$7{3a)*L{q$!2Pim<LG$v2IC5_-TR1fUC7bcp=i4p!2J}}7sTsfx_mHS
zh@Xc0<6?}DL%tN_jj-KDW0N93ws8Bd!t{Nx{1q{t1H(obuZQJnf$=(6-!@~M54MvI
z80Ug|H;fO!a`eV{4cspRFuo7!qcOe?<}(iC7hyS^#P~{B{uvl=hvi&~ac8K%iE-3%
zpbF#ha6i9?@dI#wY{a-c*l>h(V%!R@?+1*l!0q@2<Ia#%8w|o9st;9=&xYwBewCUk
z@hlkQ-{AFvIL6<>`lf*K=P<kh<FT;(O)>rtY&YyN&H(o#AB@|;@+6O~3W_olu2&SM
ze+~7?7{3kID+lAk(9ac&7sGm0jq&BsKe}%L7K8i*!g@{~Lly9ou>SO8e$Y1tzGA!r
z>Sw_Eg8Y}l{LjVsM!4UJVB83<7aF??`6+<)YCWdk0l6W@72t7U3&yh`--hu+aD75B
z{t32+2QfYg!wDGIg7rHa<7RL_y^L|Ry>DTh8<uB1#tUJ7Ix#*AZubuuzYEKG6ypx?
z{Dcw4L*=Xw>j^i;Tj72oi19se`$}OPJ-<}N_(!PM#W*@&w8D5lte>tJFM;cYuJ2L)
zKfrQ}!1O0zxy539KlGo0aWrOn0me7ObjvUv1k=5b@ue`_hVfF^E_Gu(0@j~T7{3YY
z&rggKov*0I0hgn45QW=U0OQuMo=aey9qt#37>DjDS{Ubm?VdTt_tCOLal|+yEPp?Y
z?}h2^#rO!!=TVHGhxI2F<6mLDJ&$oThTm0;Z-e?8jC;cTKfyS9-t!9MXvCaBjPHZ{
z%M`|+!uE;{t~c6VXJC2G$9N{(Z$&X)3Xex}7*B!aqmJ<*s5i#A8>}aG7=Hl$cwu}6
z%uguB-@%G<7~=<EeNDpnR=B=rG5!_S|6+^_L4F(K=o=V~7#D}---YoW81BXRL3rF5
z$G9lme$3Dx+FtdrJb&NkCh83+8ZXF&Fg<l4v0NJC8)0}Y#_izx>SJ6V`nSQjINV<D
z7)R%AK^XUd>w5s>E^z(hG5!s1-%N~OhugOh<M&`aFUR;5xZNLOd>L#X+A$su_3to_
z`kjnm{5s4(>P(8Z*J{|_a>DgS{5uRU#<&a2zc|LTA(zFtJuH81jK7841motAyJ36_
z3`bymJ={;TFb<n5N;$^6VYxJ5JQkK`H^$e)@Gp!HK|ix#y+h^Z3EP2H7*B;^1vmxS
zhDlPhYEIIFqMQp?zzXBAT2X9C93;6PZbx?#2Yxm{KWP60`2<`Qa&+B~xF6&(n4fKs
zpN1UeUjp(1jN3w9hw(j-e;{#?b<{8X6N!WJ$%J}#xSyePb0D9O@!OEgkvKdBp)OfV
z;=n)X7Y)pY#DN~gaVBw~{{qB>g_Ag0A4TFo&k5^i4vCZXmq{GxmqUF$iIeqhBo6di
zQ2&X<$@(c02YPgVJ0I?6AUatuMB+fd8~R^M;$*!Ji39yfsCOoDvfhWpfxZ~(qez^r
zPatuiN8jwbOyXpH8Hoe^2k5_z#L4<sBo6cpa6g(Nak8En?wG(W&@X~|ArdF+B}p9U
zm7rdS#L0S75(j#7sP`dpvOa{wfgXM1CV|As`V0~Wdh`vcG7=~2Ye*dE&%yk>B5|@F
zjqQrc=Qh+c!&gWEC+j&$9Qc0*^^zn`)+>-W(2qjBDT$NyTSy$}(fz9s5+~~;NF3-_
zpz9zK2YS$k0y|IQK)(^{Ye<}|ZzOS`cY*p|5-00NNF3<*K|Lqz7=+3b<%gfdfj$%J
z6-b=ye?5r<eI?XyA#t+amBfMm1=L57I9Y#`#DV@B)SoADvc8zafnESCB&?Cd$@+E@
z2YMB#A0ctF{yT{Sy$#g!gO@G{!^=~I#DN|?S6)xzWdFJ(4)n>;zblE8^?oD{^w*&N
zD2bExNhA*Rolsv);sC+Zb4odh1N}JEx05(P5L4ceIMB}pe}sJ}ak72}KW#bM-{qiQ
zgv7~uDG~=#^bJT|5-01;NgU|?pnpFSC+kB=97vBreG-Y2^_e6Nq!*#SoWy}1?O(Md
z4y5%^|AxfL`hF4z(mtr40bdZp>l-(T11TFk|Cb_hvVTPq2YPX+Hz#qj-j2k9UI*$!
zNt~=dK;l5}2KAXFPS#%_aiBj4^|d5U);Ezj(4T|)eiA3^M@by$YoMMRc8J8wQ-H*Q
z9zCyBByqBTbrJ`9)Opj6#L0Sh5(oMv@czjG5-01AkvPz!=d}eGN8d`UB5~jco*q-`
zNF4Y<&uhCej@~=`1Ub4+iG}BdV<bInnh9?d3NLs`j4*Uv5KjwI_%MDH@<ot?@&|sv
zJ7B=nFpl1{G$nC(2&d{jNdCcf4Z800#`rCeF~YWEJQ3a>2%^JxVf+V7JPhNRa67`o
zFZH-Utq-(hDVlJK+C3Pg_+xwp44)uzayi55OD$(K52WyNlbSABFGTV~&JSwuQTam|
z^<6?RkLOba3P3S}Yf3{HUWV}~7?#9%I}A%>TpT1sm>g|FT`%DO_jLruFG0Nq#?iNH
zbuj)2>J2cCzO8PGarCXRO&ITiezss7_2YEF_!QK;Vw@4yA5V;<{+;N08kI9I)CXdE
z^o^=ej7y^WiE$Ok4`5sa@?(&LY?JFxIf;|&j}YV_I$4kQSHQ{o|Lt!%DN|_QX9{u)
z4U(pQya|1w;oolnO9%K9Z}K`x6R+LMO3VIFk>G2;|L@aJa5GZh@dewS+@^qK>fmo0
zgVp=@5@BKvuRCC&I{2H$@c80{2AngI>k^2j4*sSwJiZj60SvVxD2h6q*@Zbq=V!<d
z(1Ce;{i|U-RIj1C-|a05uOVi@@m3uHI8}!Yq%I7Dcc#I9fzpSkdlV;vO_%@gFnx4f
zfo`Z;Fpu&d4CnFu3xP}#hK}pB(4XT43U4Q7rptd6%zqg;xDp2P5Au%Z{}jQfc|i+^
zFfjD|7WMC;(LeD~IGLE4E`4>lK_9{cBS;^#jVKvZet86&E`4Qq-@y|V6rlr#;?qLJ
z_a2Cu>Ed621-}ak;S`U5jo{PepUs{Y!4bv-`3J{d6d&dPF~O!wUjkl#%ES0*g5sla
zJux#~`rBaox=;wx2e+b8e3brMf?-8OjbRJZ7omp!{NdVH#G>iaFNW#Mz^EX7a88P+
z|CM0Vtv|X?FahJE35t)xUx=CM(tiWf=VqiSLHgiU9g2_EAM_&y>Eqv?3We9PsDC=m
z%b)nD9JuJjR~Dkh_>LmNDM}y3UxMOeIt5`Gkia;Kho)fAcr;Iz+6j|Gf97#5c#j91
z!op(uEp&wO(e^_NQ2tTal!y;};_>5Qe9*p-4UZ4TL6~m)eR8D5Lg|C;2QEQSe6;<h
zOPd-KR$TP$Z*ZLfngl#PxD3D!5!C21V${j+`|`BV-(?Nz^mOrsoM<t&fDDoh3sP3e
zD$zbAMSM*Pn5>eb%xV>Rc{y1jAvpzEMdDji)PGqS8ASyJV!5ocA~7NCKmYa=KWxiE
zHq@zkQKtw~geV%;8qvS1KnZJDX+)0`AF6pod=95oH*%1THiEvp2AAIh@Ym$7%jNgf
zoy+--ZVa_ye4s7?9JzC~Q^2CT?p!`Kzc%o5%~5A_=Nhgiru@2*wQR&_{Pr3Scd2O-
z&u$L=3R?KbyDqH{{x5YQAie7ze^*mOQ&-zzlc|=5r8Z@gv7w%^0fol&jIA^b^|T0R
zU~FP-OflEi(ArGVBqo-6#v3VG+J@SHX0){^dVV2JKAx^Z0dCZ<G6{hJUEIKTf50(h
z+J!<v0Zx8_#D}bi4==fe5Z_!v>i=0!D2a~^ttbA0_diCgFW12%#1<#knLoxvB65;}
z>);JydE_J`*TKWY%%M82gP;X9JWf4lj{M0GwD9*lV-OddKQzvDXan$boLcyilT1P4
zhS6H0Y|-_<KNwL3_CVTZGmIe?L9J}HVe}p9GN`0Uh_8)A*76gZZHX3<i}4`d<2t`0
zzcO$gxj=Y%uu%e3=`v7PsWPr55yUJ7WUqhX{*Pb3eg!>`9wB>09}I#ShKUdCr}_u+
zcq4x@2Aw}N9xOn32U#7+jwj|o5(CN5|9|4LZv~P1f205Q^S55M`fju#QE0TBgAcB(
z2CGFY5#n1)Y%uqINkklC0mvM%5O_g@!o;^D%#FNx&E|&f{P3vJKt9@6POq_1)aXo%
zNUjcxn#_TPJA`!)9`+MGRaPuC)06MO{Bj9xr7@;6rw(lB<Kpi4x!+G~-vPBd+I(9l
zhbra$b&PypcUSIdS~qd~%liAV+_4m~(F<?h#qb_Z5`6FP#36nE>BY@bD_K+2RWF)!
zu-t3k5PWcfw(iKXma~ddWi4fn-QLZ%JRY9kG^56@<@~gFQ+lMV;kKe9%{wQdOv0z{
z)!Ld&*9`aUXJ?;%ST^MQ?MQQ#?Lj^Ln3bhsm%Fa5)Gb*1OE}|tjFO9k(p3MrR@hme
z&bZ*+Gv8kBSUY2I|6cy=o6K6P*QU90v#tnboN?)m`l?ort~(x;86GkQ*>|&f&-Jmq
zdSLxjY=!5g1KoiqhR%60hc4M9o?Ui6FMXAfk&T+-D@(0v4{lyZ)&gzEOpR0O)@|&M
zu07FUdRwz_A~AMW=!F`w(N*aWO@16~;WHduIx~8T(@pD$?%M}*#4-*WJGj1G@oDCs
zupg^?PjL>9yDf9<zo+PGsl^i4o6uq=_|7Zp^<-`wPh3Ed>}-3_jRUH)WFi_U4J^+s
zYnb*dN&b}-zP4iYQ<eFuRqHk{tA8ADx$oCUyEa2_O_RJ)<;d!NMZ-OdbS6GC>?rcw
z;8N~dKPvM@_0i~5&{JQz1?8USZnjOlQo59}c;LnH@2v~OmmbOJy*oR>#Prxm&8Aki
zlWkR@9<meVhO^^pU$=GDtF?X5i0$8IksEq8U)-nOe5<g#c?)y5((x`!Jz918U9ZqV
z^H05UGktDcW6GWJ@t&16XHw+VdBqvE&n<X)1TES4GY2oSo9(ONk}*>=P<veJd&lZ^
zh(}0>$B~)JbsHI#JGMVfWw_xIv&R0@O1`Q4jIUHutp_EmmnbT~sZMD(eY)mz$Fdm*
zSa;`{G#nPZWLSNFMbL8Dqf)zjHFGwm+ugI9bB5clFK6x00V4^Q(;4l3Kkska(i=5(
zCu}6SJ|q2!p<2tt;TxYz&+vuI#lCr&5h5VZ-P{)crZU+<sJ_HFrSBq765kAUwX?Hw
zpFPrfrWkv{V@XR&?puw;nrs<1`xI0Expm^O6k~VSD(jGx+()(dV}c%kt!ngKC>6vK
zmmV`<^I*Mu#cq+++uPT-8!ju&I=oNOu;-WTcgnUK3QkzLp|NuQlv{9utifINxetba
z4Q<NNRND}(+*$O`hiwWwEM;;PZ28nQ@;I%w&(YX&K{NS4;#}5>;O(oDF1MKH*y!h0
z3<u<ErMvIC>G1Q`L`6lLZhl6Wbwy_7qggBX)>kb4B>!D;r_BCB@e7G8!Tl#91dsE|
zoKItr_u4i~pgfo5>SzVa8V`5F@r1g}w6#YHdu$k_iwYw=n5RT<nK1FJFBZ)FY{P#$
zTdYr@>sHP+_QFdk9=AkR?$_OU?bGF_UqS|QYh(M)*G`1)&-drQ9~@=!&NcFg*v~sF
z7X)qO+7Xr`ad}RqInQLa*)bi3m)YfhUXkfjdbT;A_6?o*8s2<k(EEA5kcXW_*V0vj
z)vt};iJd6wK6=q<O2nLfBk?^2y8yA;;C7Fc)0Cb?sWbfCBjrQt%iaV;sXu(p6>`90
zY?gqgJ8?e~m7^(E&Y>A!{)|l?Ul%cRZu8eY3&8N?x(^t#{=^IWE8ay{VoY<lH;#^!
zR@3U5?4~PepGB7%ENor0EZNu4Bh{u!W~;mNu7<Y8#+IhFX$v;z%QlGI|9DKwVZpaF
zn`F6_ZqA$UUd@Vr&)LefY(_|GfuXX&oTjdZMhYd@o<|MkR}CCT2t#3F%=7pveI^a=
z`#atJ4nI;8d$CD4z&hGy(YSu`YGTMnqgowP9xc-v0nywk%JN$CFiMutNyoQKZ6>*|
zD>m87*l`x6y?m|oy79)1==;Sb?vBS8BC>MRSH1CH5XEHimD}0wvb5a8gOkxmGu4vw
z58p}J-n62cUrzUQqTpR&aYfgp@P}^sRg1RYdVEqi#d9!e$UW)pMy~7bLY5H$OC}dM
zDd|}-&%RxD?!-sOW|0S7)-Hp(SuQM}27k)#P0M&I9H_8nw@-8W>Frw2>z6(nx!;?3
zGLHYq4FRv548IK1vAXfHcOPdk<?NK7x5kv|W8bna-L!+!4l3Cf{lgfx3w7Ad5!e%a
zZQyBZeyr*@?w)tX3q{WGR$2Nyzc}DE*{BlcyYhuuud{iO_kj~emF<+L=6yXIEqF&~
z_cWcqDi@RXwf*$<GQE=0<C}hXR|S{IrT-~cuD_3eme2jVWw^)k-m#kdR`BI>t##Gx
z-IBwQyWcBI>aF31gDy)Soay>8wRnxXM)lDYWx+U)CYAN$m(8jRbQtA}Pac1h!^}Qk
zzh$%E{?X%C)NacflwVU+tX`lZdfiTc<-?{;+~wBuIZoUvE$lu%I9ulVRduOhMa?Ep
zz7H4Wz03Lqo^QM7$XYLVamPJ{f@R^xFEXE3_!li|U~{^bym*Dv(+*d?(t}3Z(z%b!
zp7m9I(Y-33<Yf(_Zo{Q})8A!|cZeHa;GlReu2^R#-CiwvHnB|dS^?9q1qbu_R~fVo
z@ub)UZn`V@YQJ>zl|>ug*=X^<G5#rdD1TlO!;nJ9%&D~_XCBQ6R^xHmC1>KfsN{x-
z<O?Z*U$>hA5}IDsdB(*Q)=52(Rdd?K{64-*%~q&q&fIx@SD!~-(H>E)ioW#l+~D!~
zLCLZ{iSv9;<SLwc)wo35(_GZ0`wnNw+JRTQt6skJb<{6)OKOpw`I)b>f6!+Cf{cdF
z0{<M}xnGu*y}p~GKfn2TlAWYYf4JDzbCnBC8nrnmhQw@{KYt1Q^!3L-pZ_u7zWyR=
zOxN?wya#C?=N)Um^^LMTvY4~xnFV*q^+oJ2c&+B2II^bNz%gEE26t)aLECeexSR`i
z6xZnYZC|nSr)4EitWoFwC2Nj7^4x3D$-mC($>94z;oifeSuu6Yv)}!4@YG=yUVk!Z
zzG`pque6mPT<q4VWc@H0b$F|MaJ|!sJnN=_(6NVVfiG{n|9k(OfII4+{q<6OLu`!<
zhxRwkJ3Ol%F@9dLDLr(HX1`^L1%rc{-qWYmjO<nuA0$+c&fYA;ZYQYO_<Wsmp6m=y
zUgJ4!^-o9ZjPIIzI5X>U>NH$`&}RAMr+M}6b@8POJE~c4@AKd29B`uYCBul+n;xbY
z;jtfg_|NxY+;KZCQ~u#r^J80>*`u~T6s+=&jJ15VxM`qfz-QIY(WBA3onLYse<hxj
zuFx%THYCH#A;qe{)Y(niy?vxEV7&AFZC5kaetnhTv;zX&fnQkTRm*Dr)A4M<b*>Qc
z1H04zpRsHei1^@o7#Q_=0x@1~9HTxbe=HcU_As*+r$i*nMot;Vjhqr1)In<r0WoMT
zxc;@I#-fcuL(${pwj^FS6eXAs<kaUWMw~*7Ni#XwHqLS+{&i<DR&%mxatcAoUlXuB
z|NF6SXZ+;{0QzIvf-CjEjfr|!a5~QMHzWuXb+pUB7co)qj!nnGU8BE^i9)>;`)dKy
z?<Z;hUc^Klf%xBy<^kQ2__GY$=Kyyq!1f~B5^8|$cb^Tk3~WE3-+%y|E~ie}DEb(u
zJ&R+bh+tfv8fO3NJLoEqV{*!RDqy2XVhc1ONB3^fVqM5-{t%^5jEGqt>Rlijqt<C+
z7BnB+H1x0ky>xga9S)wU@{sQE3qx-Obo513{hw=j^o+5Cj-EDdtUK{xYU2CS)cXz6
zf5x?y17p|{&!r4CmB610_>-qH>ae%OV=hC@zXrP{`*Lsza05ftPCwMGuagh)m2O%N
zT>OK<_o)N_&X0qun~xjegE|T=^<mn-Q`qL@=RtfX8{8yuAim#Cz5js?e@m=8dR7nW
z6>-}5d(0~(VjdW%2cTU-V`0HZ2h_1f1xXxsDfmmjlF$GHr*)jf5BWj$1#oZ=8*y!7
z9vI-Do*<6eIKaXEImA7Pd0>EpJRlwfAYov=goq#F5yU(&pa-o0;-EeO103w5h^GKZ
z81AQshN*h6&m;XX<hXvEq$j8QgT%q@dE`eGG{A&`{E+>FTSmZe|9T`n*+00K3k>+-
zBYw!g7m1Vo2hj1qi=-#}k05by{}%Z_N8)7v`E>kWCF#ljQA-N;Tr^M2{%$V;2S<f7
z;O-V-s2&0ip3STUkTCe@gL-5E92u=$ragxOakjz*%it6+RObOg^%<qB4hohqRG$$?
z@3Nu#jQB6Oo`$q&zxzml?Fr0=Hu=rd;CjK+uHQTg`til}kfZvK(k+Ae+=c1+p#BiX
zg<v=l<7kZ3RE!^l`8<#DuP}TC<3=z))fh+bbUeVgDAYG$JPf7_?zjR&>$?f^cQpK)
zzlZDFk8yBs5ZEW$<hOnnOm_m~Xbd&f#~-CT1a)&^I*5M+CyIm#U>uDpEQE8YUxslv
z$X8+<y=#fy2|(#eLcKnwM`Jpp_5tY|q23D9C&F^rit!xUYEgnP?gI6@F@6a8N9_hm
zw;Afet#x3COTz7#h;f>VLdnAT8t4a&t%&>_hkkBidN#=KW4r<SX~p<#sDFcT6PTfo
z7)R~PH;iw9dRCYY$|oAjdoIQeVSHhXqxNnU#tmROqw+xhonX4Un4Y-xL$ys9mxtUL
z<7muue~eede1>5h<%c{*9B8-SK>uejJ=!0xVtftMqwRy%3)NRNmNm%645$T@LCg<Y
zuW=G*Cv-wUOxP60(Ur$95(g}eswT$ag!KaC2lydwwNMS!7sSDNE-)UF9{53HATB0x
z;71;or!dABLXP$iw7!zSIbrBsbC53hq5NxLel9{k+8ED+Tpx1e{|j(V7#dRtaB%I5
zEEv<Hu_Mu#f4Dvy(}%!x%SoK<zk$TT_Pqr4|ByIYkH)?RGN4EKN0%n3e9-wW8siS>
zL*a^v!TkwvFsl!_42c8(ry$oMagZN$-DCwh+9vK$?}~9$ueM|SHq?h>9JMn?F^>BD
zqcQG4{$Wv3J)yC$L4H7eL&pX5E&}3rKt#gIp?~BDoVx>if~AY<PZvoKcO9z!Gp0xF
z)Hf0b`RRk{{=)cM$eH2BM&*gxc}@}se$a882jeU-Q+y;2_7!wo5GHZp2ldGm!#FxW
zktA{82engZ%pp{shA>@ak{<Zifm{dU9+2x}9DQrn1aeR;Kq^f9fVq<NAU~*G-G=dn
zuu}M99JRM-OhHu6XlxUd4oDZ&e`IJsz_|hdgdvXZ1)$?K;*vBO<snH=uDAUp4vU5w
zg98S@VlrPrhokdQT)z#|3&Z@Nbp++W3K^K7^}ziIK@H&K{G;{&aO4w6(X|QUs2r5R
zLc$O?qXjAUa0)nieYcS~Io$vfC#Nd{Ian`{2U8echVf%CjPix_U69l6L(z^ozz;f4
zMfpd1N04E{*3l-^V-(P%^T-VtN7p+WF^<lc3^ASt{iAY1>1IQ2h3QfKv&A_2CW<4*
z(YvT_7=I4^dtn^4SN<3ugnD#c27=`6_!8;?CvQh|-2pgxI|@NP@Im%tL*isV+ew`4
z=fCUY?dIbo{ijp+zwblQ?sVZDzyGCyce4KK_D$*q{&&~$e|d13_HNhz>k<yPF74hP
zURS_E_1}tr&j2migoyxP<hlcvtAoF34395PXu$oO|K0eqL|owWUv-oSs}nz9p0vsD
zf7Bi$AVti8QwVhg;B-5@fI{stxTgtp=w1^))NLZB)1_YwmkYxwn&9c15(}nFKYN<=
z!8+pUgZnukeL3Pswq_VW?GRc9w7}3b63*lC(U|XcRP~=fls<|N?t_APy!^AF0NqbV
z9`N-~AQnuw{!ifgt25GKg7OD#HA)|qe?7sdNudQaImHoHC^Hxz;@|O6_#QDcUHaVM
z<|JXLZ#zgIoF}1VQ2Olzn=XAcR<JBA2SP?Q6d#5Ah?(i)qp{S`^()fj@!t^(rpte^
z5G}?h7!l+joRg#YDE~hRHeLGYn*fS1KANETC_G8bOqYJPFiqhIg&_So#1F+s>GKeY
zPnUiK6o$h1XoBLS@N6RTbm^l9UMN0DpO^Td_$YmGI_ZCfLU(HBP-=hTBO*d4{ZJ8_
z0-dLV^g)%v(+Ah_APKxrx+AFUgl(Wxe^Iu;ebMRS6TKd&_J%h3{g2W|@r_aZ-wN7H
z6g=USz&MJBrq(b%CZiO?_&7)L5cePeIA6wA^LKn1B!p9xe}wnJ^zry_VEXY$NGCqH
z4>?`^Q5U5}(1r29_5;tmQ2MC;fc3%C22r+yhgyX3!*&Qf&s{+L@c7``4nOu0h!O>M
z7Q)`sCcpnddSnB#Y2(BEM`IDNAkimXh3I|$$NtAY=_)Gnid6Z3-X~p1`%jM5sk7>o
zrNj<ObVC181q#xF)KNToSU37Et()!xP3qA?H<}4{AJ>i6WCQ)jb)!3Nx89}oF(-Pl
zf76Xoqs7pTer@|p3?#v|M4fV%n%18`kRBob0=j7H##EIN-chs~-9yzuT%ZHAZuAqv
zH?=P_;SDa2sRUx(=vTU+C$?^M4dRwWh=^pnm56p%$BB3>>?#!GPjp51^$&3q3ib<d
zbMX&wC7`>LOOSuSE~4M~pZrks@~?alnV6{?{Q$0mZgki0F5kAgRkVl<6xs?xH$)F<
zunSOa1RgU{nCQFQvCn7I`vt6@zPx%KxTk5)(D3!q>nu0t*6KUWH!Y0WrqtG!eg0H-
z#|49VV!^8IIzc})jn0W$X<PH;ZDO~ob3eDNt#^_BlY$GqiicaJqSPD>b=@v(J={_&
zvgh^igvx~dB7=}$$~`}B4ex2%^;qTcuB?ghwBSV@W|=PGvqN}y{(SJb=)%=CJ4;qx
zOkHWR)l%}?oQ|RMo63|5w|va@&dK*W<oo$a_ZN|HX5Yc>?so-(BsOVJbX;a{nCCrU
zHMe0xDXE^T{rQMqW`#syK#IH4q4zey*OjEKueU9hsYqHmJaT(8uPom+w_#m3Rvn7r
zl<mh@<(WCr!x4*ia6H_|uu;P(>FkyZY)|#I^A+oJyYl&;YHTuRskgS!d30z^zWSyr
z&o*tbx%Xcixm|c_c~XC^&v>QfrTX#Iuq7ug@|T?YaoY0q$g9;ow_?)In^zp4%6}$#
zt$C33LTgghy+PLe`Cd`!CbKPOU6|u_rez}ShkHLqY+#bA#jZV#W7kz$?>tBdHBcFj
zZtk|-&10foJcmpDRf~nPMc0lFfr|0PdA>583ol$}aFzVnp!43^$!(MD`~^GwYLAHy
z@0n*Dx;HXE)u}?zKxKjLDeLgc05`UuZI0fuUf(@6mV13qJYe4Tb(fmJ>~r_C7~Vze
zWJjm6U*#5m%Y3PJ@J+x%+1lmmYnqvZxC6Hz*zk7j;^n~a?%9bezeGrPD`cPA#;`k@
zMSV#LcdvL8Wk!^CwNUd+jyWC-cWb%!&*}DYlrQ1u7i(g;&g)xk+`X|{+L^sLMVX6#
zsdSX>G2V|)$HxpM-fXBgYcmgTKO3`mVYFxSz16a<@_CCoZU=M-&KD9r;GBQnCf!dz
z>hSv9tg8EolqXejCqHoi5HZ#8nZYkGB_?Eii$lhE)G9kYl*RE$ul4@?T8V15mLi7I
zC?(3_#8)#K#jZ0QTls@?yXt4@YW3EA%uUNeD92QP@V!~<EMCpsHq5{`XPD{O#vcsD
z$2w2Ha0+4RUK(*HUyXr3W6FY<nPB8FuH<su-v5IVX|aUDpRt>R2s~z(k++^%MtO{n
zp!-;enW}3)a)>D2M3lHBmb{<yl^(olORRoSYZh^$AdVr+>1b>0f%_8Li_e~IQ=Vs0
z_K7*bGxv(yk?5yPYwND4r?W*Yn!`Gx#kfr*L4DSV8C#+`p6Iyl4>>!tSI8@ZQI@4w
z)N8-A2x}1Un0nFVZR6ETO!mfBKFA$-loxq3+4hhx^K*&o^E%5r@2B1w%WXbsA9~m}
z<VTiAyvvd(PQJJ>h3>3go4%XEQ=2>Gzuq~(JN|C+nVJp1(UjcsWA2d#Lxy#0xxcrq
z$c=hqUZlXq+;FR9Ew|K!{-j7*<BCgi2O8G-eqlMEpB<6BH@*Dq`B!Tjmo=ZvuXwb{
zR?B)*k-XQut&dDL2hDD3kuIO#&wVLk=Gg(6`^IM0?#VapQ+f{{e$Y6tTwAT^if`rF
zh4P-~);AlOR`v2diP$!8$jNlnV4H4`yn@u0*~g>&_AAEt9n#URI&eK^xA)+~kfVN@
z&!w9`KCy3J96TO-Uu&nE@7~y$_O>pYHB$W#zGQH}WHLHB<R<XYbV8OZYKE6j`6sP`
z?5n*>sRskj9?8Dd>vTa+f$dt9px$l2kV|Jbo>6R`Q7F=-9k)mG!%tN$O;e3g=C<X#
zdCm>-{J7i{&Y%>XSrFcJduMa8|DN%qnL0HedDk(G#bh3up>=BeA&q9XtM;Rd6hwFL
zZ@nI+7ot@w_3c0}SH^v9!%OGRu6&|6CvhNTPU%3FmSNEv?Z%=dQT9DKtDMV!*wpT=
zupV936V_~-F`?}r_=-<<bzDs9DXy5*3~{Z-ro^*q@=aIfCI%mhde+4&tNB2C-}?m3
z+JjqHI^S=KCc4!h>D828qg8Qph&!zI(2-tVX;<y64VTWY%ZS$6*Hf_JYFxw2X0=a>
zYqY*KTX8RrxXg2WNB)Yb4DYSYYR#p#L2O%APMvN35Mke(vaQ0XR!k#n+oES>4x_6^
z7jZ8>EI2ppQQ7>(|4eBr+<98kYkOH;EAiONLMd5aMki0-lF|6(H!DuZR~gkUd1kj(
zR`A2A&?{1}Yc1R+mt{&fD1AQm;Fp2?rG%>3U7oF6vtlO4uc@-zW|ft+{M>oU^ZDS~
zXhqNRmTTfR0d|Qy70i7c_G|77`F=+Hxsg|v{%Gga%6p}`3s-!+Fl>BevB$Z$dn7%-
z`4m6>%DeOE%M0#>5`+FFgHNXv6L)*>&iK&!T+aA&%C%D;#J(7;Hh!w_@oLg-Yl0I4
zmynCKTZ4$wDO1h?uJrQd!h<gDUc0nUDeX+|>)m*F#-(tcmlu-LZUn?eOYBVSv-TeN
z^1h>ADt26G<Eg4oRXV3u?e)KUTzt``u%T7SI<|#zsfmN?KLTvCW(|B?;p(uaC79(4
zv&lWv09m)Vw9=Njk85&ehO{O(Jzg1GA->|S;ngtz)O=pfK$G_H9R66ZRmabZKbrH(
ztNsyd180WWt%P+~hIBW#z8DFQJ@%ta@JmgN&Go^P$3KsJ_$Z}Rz;!W(rAO^0+aqud
z3=AE2bKwag3WsKFI`PuDMt$zV9#bpHjWgX&UT3V4-1pN-_m-)!W7*jo%e2DSmsD%%
z?Oh(WcIOS#u8S`lRpci_k|np_63-l2`d~zZawwxZqI6!Zu|(|ECoOztEGv|ftM|V&
zbF0j$*E7yPQO97%5V&Z(dacI;rh3_#|LkNdZaY=VrYzZFchY8_i|6tBrM~&cJm-8o
zd)Q3M<HU)|d11{u>E4?X-pYy#c1Wx~+Znre4NsccRvSzG>X~<j<tXpgEmE4ZX~m|v
zlkT@$xz^3;3mx|4k63b4QB|Q+ZW+6gW}ijn=%Vl~?J`a*BKzx__Nm?%N!MPI`FYZU
zCA-h!b>d)9`sv^|7DoQpW?a89eqD)Ax%HCw`KH?r*=wHox$OuZ>zNmMYO*F~?;*YY
z>$a|&>eCt&kGxgpy*JgQZvFPF8@lefg<ooL|3}|7K4L)DC}8%>tJgkl*k@qR>i@l|
zD1EB^V7k_KrnQ{fs0$JW-P`?B?!j?)W*$)IKD;yFn8*q}Zara5)eE70-P#{Jujwv*
z5?R!CCh&;;)g{_pjpN0QgW>Y88zT>z-qQ;5c)=p&Zuv>-J>NVN;U(<N%RR!3`0Oj*
zjEGmvNsu@rFYfuJrO4(<bc*8X!`~K|3NUO{VOzNB$h?GtAui#QHvD%+oW|~k94yu{
zZ(s6_@Am$EOWq!hJNND5#J;2K=NIHW(@54oc+~l6<lW~#Y&A7`A2B<3Mfv2ty!Xsp
zR%?Z0l1lI7%;x%SmHrZ1qEG(RD@STA`x6e$i23u*hT~)EI~(lV_S()EBu=S6F}R{~
zK&Rg*9GVgMuXi@8@7AoiQ_cDI`Q6P&w_7o0xHS;>la4W*NBV3ygTlnS7jf(S7-hK+
z^*sBgBf2G_dgdV!=a+%Z;YstORrhJ9>uxsJ>1Iv}8jV`IouO>DlJ2QxZ;vN$W0xM>
z^>$)?TnG0V1=r;wl-ot=pVckhmgZ$_=Db<q*Re-pRriNDITfpYBd%h>uZs@F&$3q8
z%Nw*=r+0R+{#sLq)cI`;r(;tkJ15`dmN93QB!0HCweoQhwPj}grhB^cxK>L-XiopZ
z+vhY_HmaQ;_H7c~kQTB3uAkqhnikFOV8H|VN|C8f+UsiBN4I9ZeQt6`?3eD3qjULn
z=FJ>+dzbms*u!ejH+EISPl~`de)iw{GbiZyN7$eBKV-8t@U0?Gt;y#l+xtUS-7Hu;
z80p+_UGmENEAL$=*jY}*N2M}{QY7jo28ui=@d+O*EPXFYg;V6$ty?!+d!BvdG2<EY
zuKCQU_~I`za_^GdrOVnfznbNaa-WPlYhGDkxHqvPoUQdn*Fozuam)1A&fk$Yak)kK
zq5bo&&eMegTPu%V-8&_6{CL;!rWI%VuC7(+(tpKdTYqon=fP{W&pSm6+CRF!-N4Zu
zckixUQ*y)8r#_W7>mGi4I%d~Y_4<*0W=D+Lhmjj87hm@b+`H?$Me%55i9o((vy+F*
z4deFmr)GKI3WjYX7auEC@%DIsXVUs3(~%vYW|a9@K5?F<?7BU&=;~mbnNE>U=Sbuw
z%@Ee7*AuM73Pqf<ccc{eZ7NK^>ZGn8&|`PH)!0@qtnF#U@vlv(>;3n9`xLNaY@mqG
zA$+p0!Q@w2*<eypx_|qoCds`qkxyR>%;PNgT_wGfFXdtpUy5-1Ysp)IH;>y7G*q4+
zHQQ*X?(=j&te<yML~yLB``V@8l(2=LAA}UoV+dHFuy2Ol9y>es*`FjP=9aeYxqBmT
z1CPY%p+&O2rSC>d%rqSf?=ZMYRhg+2MY0KuS(|<Edb|J5TdOreR!PA>11`9&RJ~O5
zCfMl0MXPS#%X%N~e|h@y`;?nXib?4a@9=rwFCOQ+Q?On^TK}S{h*0~(3yPP1W|&Wu
z4hMuyT-|-Ma?jq)d3(3a6Z!dN&8MR`6Kr1cgi|!Mj&ugDck%v|Si{wBz9eVyPW!Rh
zHLvI7mc5XWG@skrouyQ#lKo45<UlHaiCzg;n9<gzMJEH~QxyebDs6?9t4_&pdfe|~
zXqKvaLp#@p<uF6|t5MINWp;Lt-n|V7SzVQ-R`~wyOuq1ks~z{<PE)IU?-jE0y2cjk
zl$IAuYX|Oq8NBiS`<9?4flqM(`)dbHJ7;aLIY+$qnsY1m)wUdITi&w|9rF7}SF>z<
z+34_i#lFDcFO3&oNhJq1dsi(kF|K>JPHXsr%S}-aC7vytIav1y2%f3!dQhGq@Ul~Q
zo6y08&tX=YMdkMGLym6eSmT6d3*BEjx@Exf(Tf{XG6hD5LV|oF*7_bk{pQgId9BzZ
z?f)Fp-6rI9h)vLZ#_<aq1J0THQRXdoEq3?cyNKe{r@z6s=jD?~&E%2G@}8yk=gbRz
zh?BM2*`mEo7q>d+cN8RtjShbb-xZo!l*fI)m#28M*k?I|l{$<9-!6HX?BUMk5O^yl
z__1w%<*Y>a4PkLN-<S42+{d-M+9f~uK<LwQ>r2lD63_p0_OMfHnr`5sd263m7@p(`
z)0i92U0x!+tTJ9$luh5lWaZUE_2C%`8_GW__NHDDx-zFPRbDQplbuCu_7<~&O9EXI
z;+@>j9{#iZTFDtd`{V}R^+A3`29MpF^%z&Tq$Wuow7T7|w0{9le#hNAjvLIzj<0_C
z#OS$2Z}y!Wj|-NT^M7quF?@PY{?Z+fdWVO;7eoFTs1*=&J7$_E^_BUO{P?Da`*-L4
zl$`0u?i0=}*0QF&U1Njm3F`u<Hz~aLcM14jkhhuDdARmQrm00yLh|Fvw2vF>WRFbc
zN4;AAsHa2C_(g5%zJv+(B`?Pg?qPYM!PVEbyHM3HcYB?K+tfy9{^G-azPC0gqz$F@
z+vrBtFt$GSUii!-hokh3P~2{z`K2v6j%Bys&OKnx`6^b}?Xusivz%^|Te7dQd$b0Z
zE7ty49@#uvJQ=XH|Fm3t@4o!;3cCi;Zc($Fx`(3A1RpU!WwNfd?eZb#L{+!>pX~HM
z+IJlY(bL@_9)I7g`jpctenpN{o5IIEd;K%wT6N|g6b`*M(L2h^lsJ0xEQ`%OwekmT
z&dwL}qb7~dyC<_P-?M3--V%q_2WqVk9{0WF6J`>bU$|~jO<U8xrgrO{9T#m&%&xCb
zRaJEErhFEBFT`Z(xi!(^!+KuB@4VX+W~FTHJXx=)>C#eVm&9C>YwuCAZA@{*>X?06
zlgF#rIg`KMW*K($hxaFQ=!raze&sPYjPEcf<4+yd!-A_fTw-{4W{2;%&C)YvcTUJY
z9^D($#K9q=8td-0LwvYm(*5(|*rmdW0#SKtbxd2=mWV%IH8D||x8xpYYG-^E^B0~a
z)q58mb@kakN4DK1C_YJfJhfos2bcBYiG^Eq7bFifO|6~$k-zV;u0bU$&n+dThf9VI
zn<wu`Z%=IfA`mJ2q|9X`*5$^glS5IX{3_=UNZ+yztt`vR`ubupT>n7o-1+&v%iU%i
zxyI37-Kg&pB)NH@vn=d(mF{W3{&zM)+s!{LUD&niQTN#ciCuD@TOY^ACOmeQPk&p|
za8o?(5le;-i|dgC>6srknR8`CanGC;<(i*8WH>C}v$@Vdq|Wj9p`yBl*)z2tCz^%r
z<DU#18@)CEnWw=>NB+TIQ<JSry;ykeO)$mmVV17TP&a(up|JPY`BhF8`%IGe7Raca
z-pg3Z(pSeie{=3~^$@4gm^PUcjlOgDCaAXZ_B+i#*&Gzcuch4~>b*I^{llK34b{%q
z_&*)rpLU)rrDWpp?%t2@R8u@GPem$L99CAn5<Iu*O91zxbLP%+x7M_L7=PTesqn0b
z8AU{BLa(Yms;9@xW5;0)`-MAm7(yi4MHX4E+W1yER%1l%1^c;jWA^uXYUXEyIYsBG
zB-F9Bl|MN4kaN6oQb5(ExFcckT0p|vJ2NA^B<&W|xkRg}SxIkGURTs3*7v=1M&_!v
zyoXz?BIMSGiX0b=zo1Y*$^GhzW5V+&fu4mta|UWZ^Pep`vEuuR4z|3Vr#}=1mk5_O
zU%1_o+{AR~;iT>kMV<2wGZYJQzj)`%8>lR)=`0hUnd!MoO?G8+P}T~r6&ooToTYZ@
z-PRj3lX>fVFZA{XjTkU~->ag&?6!q`X3`OznrMcer}>lli&v;ho6S_-qkMH?Y>en#
zi#fcJy+Zfw(;hFdjMxx8I*{by@!-*hTfbJd@x_FZ&rc5ib^VcR)?i#K!!gKp&E09|
zJqF_4J9}S_Xp4J#Pe;Z?Uj|TCn$O8gJ9hu=HjXqS*U)dp!fKfs`Ew7vU7x;Oo#*?j
zSTn<rbMgrcu`_Q8$)<N&o>`)`Alf@l;h^#APjR=FlnSzM5?YyA{iHFwXO`6Cj-R{z
zlx_y=?(*DNU%lc1w>f)MM2=ni2i<f{_H*V{xtY>0^Y?r;c=LI9e{Jo?=PjPC-kWzC
zRORhx(akSCxlMj<LVMkI?NN7D;~EnsuEPg%<7c1i8LW)*9{ZRl8T7o=VPIg=_mXd+
z<8yK0tz+Ixzl6rDsyieV!`H;JsW+yv*F0vlYcJ!E$iA}w^kqHj*&XdUfDkdyLj1_@
z?7_vv`5!|ycvgVU1L0{Qg<-cjg&~xiVIc=ATRgE4+<FJk3V^ABKMhXq!;E^I{E^_D
zJ#S8aElzF?;$1v&>st#fCrlXp>2PvKGMe56-vyK*f{uU@<_P|%KD2-j;%&dpGm#UW
zSzes{#4_Lyq?rV?gi-s?5ImBR(6Z^wG6GKN7+9bG`|tF@2U=JjnEv$^#h-=r-`yi_
z#7|>P)TfJoFZl1@-2+c){x&A+h(!P9v`55$Kj@<Mx%_*5!80K8yKmIGK`>?FH{Dtp
z)8U}c!E}0if=~DE+fF+Ay;S|5df`Zfft@6N)A`S%!*3FthqN83b&p^zboB4&aQH48
z?MaD)r=PpO^q+U@WdC0JAH6LX8cK{7=^DI!n&^MOC`U@#!N=d<n~1i}DR7%Zkdrg<
z!r$M-(=X61AZQxbv<E=s$dI@YkAeJs0*ROOoP#}xasY<PdO0x<9^s&OrBE9JICyrA
z_)20P7-;6fV@AZ`BS-2xV4!Xyj-FKlKV%N(fdS4({E&V%fP?`K@`kt(fP?`Kd?Jqa
z0Kh@rN1U90&{iV8jF<-o@(=nXAg%%+VZhHq;)gh@p<s_f^Th1$K9PWf$K7XP!wesT
z{q8%s7KjP^Pv7-I`9}E!{{O$;^?C+(b(DXUpHy%lAq?GrK^(p7Vn|y|%_qqJepnG~
zFn$PZe8Svmlizwx_~6$U<03HKAdE9ZKf5rV1k*i&@ps_CJYmOZli%rzz;G(YZ@`L>
zgYn(4Gk7t^V_=0v&uLNlpgyCIF+KW@&~uEJfWjlJhc@}0&u7du@CD;lXk-2_^4>h2
z$|rpIKZwY#LYrjCmIy6K_MD=~R*`+lzV9N^Vo7^K+O!ZYlFE{zq@+Zt$Wo~!N-Aj+
zzkANPrqB7zN8ji9J<ngi*Kc0VxzD`sYi6#w=9;<hbId&h{({R@fJsbfP6-N_yMaTI
z&uBS;Gom>ptn$+#j^{N0$p`F@pVh=%7=54u`OMV~;EqK8Q=q;42)+;E<g-=yad$jd
z7MHu9Su8Ds$fp|YaDw2Ga9>$W@HDVb6~R}7eHsXE&ciIYo#2^}Kc2&l^~C!oeJA9F
zz^}L<9hNr+Ir3R42k>VpLf#7eL6zWmKg=ZrcL8}kS09&)_sO&)<O4w-&mG6|^}r(t
zdAtwq7J}n_2+|3j1mi#!!SOz3rwESs?ZnTbVtulq-9HoZHPBu^2)-HmI~SCX^Z5qy
z(+M6A{ZxVArqC}I5d0wIkH<Nj|5KP7V?oG!LjDc}Z$=5J;6re{&ub*Xr$W2nXIF8#
z55b>z6Y@`Cyv6&fV0lw!v9v-$egouRN^o@DL*XI8RY3pe1V`&>qVS&Jc>lm31n&er
zxnNwxdOCnTClcHY>@P|1IOy+qpJkj+545`$A>Re{H6eHwaBG6|19u@feg-9g;3Lql
zV+oFLtda@N27ZqB?Zx^RLi^?t@{SNcPw*#T->U>a5Bk>;{1^D=Q-b$Gzj{OP+t6NL
z2)-Qj$NP$6{cE9IQAmgRcgSCo;8I{W^4TO!kXuN|OTzWqh~T>5C#wj)2*zheg5$Z>
zz67_1dPNcZ1n9qo;I*Lt9)e$n_z{9%0e#L89PeLUM(|_MUbO_b20J_=_(y1`7X;^p
ze)@snPeA{l1Q!E)jt6_-cI<%oB!a6$f1E||CD5<u5**+6YZF`w^rsVC6!NhlcoK8?
zp}7+L2*d*ko(ki`27>#7eNqS>0(QtCcoX<J-WLYjrv!bVLJ=YF0d}q=_)n%d?JmLl
za6ct@KJ@q31jqMVp9sDh{C0%kcs%3<y|Dgx{1hiR9w%i9z6SJBBe*=+S(o5=zi2ap
z<L~Qh39bV6Sx<1hPjEQFYv8^#iQs0S=Wc>8g?7aIs$e@zg??H{$m9KKO9?&`+Wi*6
zw}Rh3B={xJ6YnFB%RL1AJs}?t?f8S>`2LRzt{XTXdGMc!1Q!4<N$_%LFJ*#Hfc~gO
zaJ)a33Bgri9I+-i9<M_Pz5x6(ir}?SZal${Lx0>%@L}Mo1iuG%+ePrT(7qW2?*aQC
zB6tDVr-a~*V9#=b<NfNY2tEnM$y$PQfPda2I6IV!@B4837D2ygCFF5^1_(Y6^c*61
z9oS)*;A&uh4k#a&+YWY~O7Qg{kN17X@?0Q4n~=x-XAZ%)L4Q;yxF*Vw3c3XM2ffV*
zt^@73mf(0_Ur&Oc0r^mZ=Q4|>B@p}*d|yZ>_;c{LY=S=k{qqTq_hG(F@J<*v@b?~U
z&);C@hlG3rj0-Oao(A>mC-@M^4->ou>NNrM#pTLEKH>z&`$^9xxGLnYLGbn9=LQ7F
zYXIQ;AaokJY(CW2k&wRv+>hX=LH`(n8$rKICb$9AD}&(G;8!OIo(#O0;CNs6DuN$^
z`?Lmvr$M}(;2&T->?Jw$i|+)thxX%w^XN3P+iK`{lL(#z>7@uh8SJS_@YA5r5`vFH
z+>GFO-(dW^1=hy~?yvCg6PSm9pWxpEF#iPO(q<z6U})bx1eXK9!q3X#eDHqW=Lq@l
zP_L^5?}U8r5<Ca|r-k5MV7G39?|}RV369qwVTbV;>v;<7AVhFmC|82u(NOLjf{Q_1
zi{SWo7CONXfdAn8GOW*a@E><V{x^(EAp}=~_DvwT1ImyJI|wca{UV3pOlcaefZ*J4
zUr|bMe@IYEaQr=|ncy){ZWqD3LC*n#=YYSB5L^((0Y0!3wwo^SsRZ8z?JH04)u8_Z
zg5&Q4Mg)%rJuL}-2>OdN!QX>E0R$HYeKrvMIQVNS!Hb~XGYOs!_BloHK9DaVxIOsE
z4T4ufK8*xl1p0Im`~mcf_XJOdcKS*1wctP8(Ehl+M!^3?3BC}x48dKXU*qu}=OYXD
z*CXWLKzt>^gW<Zfj^K)*w-3Q@gFT}N?hSk^!3V)l@b7R~Ph-$CmypNzJw*gx2Kiqj
zxEQq8J%Z!=68t?0mun66?IGk{AU;I!ZfM_epfAqnDzvW%!P~*lB?*2A+I=p;g`pi6
z6FdgwmlJ#kTo=|5yae?2BsgBv1^@ny_5THSNFwB8K>u`tUjcrA;MTa`5xf<65y4HN
zzh5OdzE8&A1F)V?K+h+HJRToj5j+|0d+~J}=aUNd<bnJ!_k(tnAvpeB#)#mWP%kHf
zkAk0s5PUE2WP<yH-bV;N6ULcSz|k-TF2We0Z?VXup#h?_I)X#BXbmhJF>L1+7LM{!
zXXH-pS59y_;Q0F}vKx~30REnkcLDwhIMyG!FO3I2U@i&r_;)qT@$WGB|6Pbf6Eaem
zLO!@14?x_SC4aazVaSKF$Rque7?j$toZ$HX!5dgOtKIPLDA*2{A)izhd6fSd;28ve
z13a7H&w(ESj_Ql_p91^}!SVms9}s*M$m8oCw$Dr89N>?bZw5c)1CGjtF2qP7O~_;a
zQD)(&zMLo_73L9ql!<9N1jqj;)+hKZ$Y&{VtPh@F=0I>s$UlOG!w|_hvzy2tukpE`
z;CfK*VIm(?Hx%+%<gx7#zsSOoY!u{kh2TNJuM+t~lvYP@Jn!NKOFqaC@woAt;Q0Sr
z?+A{^r4IyO4C64k4`Uu5>o}u<Dn|vRHY@jJ(0@2iznO)z_PZ;8;oStse$EAULI+kq
zlqWcIUKx#s|L=!Rv$i{a5DIhLj<_zU4Z#EqO<=fU)R(nfNyb@beOdEYW#O##)nnnf
zEQH{8ijhCc2kSF~MV_@>JnmxsL5wz!MV_@>Z5Ga2t`u-oU!;Qt#Ag$HJH!<Uj_04u
zB{=?`rABbPMkk(Ugv-4E?Wa%3-vYjr;H|(-3El-9*8}I@2i%5`{{q~O;6H&o5ggB-
za3{C`G>$jHMS%wp9M7u=CAc!kM-hB6@Hm270N+G#2jJTX?g1RPC$>)j@ZE%bH1LDK
zky!vS$OjhA>i;vre(1pJhu$ol)ej{hACxz1{&W`3nm@Kbl4Z>w&$B|DHUIyswb)pv
zI>N34|5=NTRp!rHY{Z&wtTHe`@?Yz<jj=!*YZ90iiIcd6hT#N^8Ip`yptQNn&n~X6
zAs!L1?Kcxq`yu#whlYjz3%XFdJFfTmHwy_^|6f5r?*I>+IW<cZe?*wtAc2az1^W9_
z+e6ak1_XwA%%$dpD^vR>xcNeSeL(o!ppZanukx^HP{6~>$uq>oAKxiLL;oKh&>TqQ
zTK{TuDy~Pp#tPtue@@M!J|V{HW9XzFdK)8<>Ct$Mz5@N9rbpv8%JXmf<N42&2qWO@
z5suHHKA?V}hXEYv$S_pE{YaAfjO5_!+MnH5(6~5O`3V$9VHWf7=bbDcjkjZ!zYEG&
zg_M%i5!I0_AKh1vRell0QE+Cw|MNzckLGWVReseN^+#os<)d)}m5;Ai)JH}TLXZmh
zddrOclO9ep?&rtSUk?QE_Z6I;)IX0pF_!+^aHHo82_>l``U*(uUr#Yq6x_y9pO_&5
z%E$7U<2XKcP$w9o7=R$22bnk?r(_-pF<J|S$I{;m^tX^=rjw)&=%)yrUYv<(@2KNg
z<qN@$5Wa5)@jvNteE2Wv@&8deu^=3A`51qrK8&S*=@O>I00>G_M|4k%(_{UGDdoq~
zAO9a=5v0cloF2#dsKjHHpAQ{B3IrvoBl?K}r^n@^wdBVtAOD|0k4nQDaC*!n|5CoB
z9#ev~d^9Hpr^n@M{iXaD@OuURo`=iB>2ZAiU&_zaV@lxPZ6v8EntzYe<MPoO>D1qU
z)`ok5z7$d63{Jp|{z;G0ps?yM>36{dAk@CB0cVG?3r^1}M14L66Y1p%j?>|z52Po=
zXmxlZK5+u4!x+u0L0yy`12{H9dR2mB{W0DH<&)|0wp~S75RPQ}bSnK={wrz7OyCUZ
zB&j1>9}cI-?T6~~pRy@dgc_R)N8#iw>N6TU$@FNLAg{d?qFKNf!Otkd5>R=p0rlyz
z(kFoaIYa^?N>fprrzXh~{#R?msV!WvkeT3re{HxmZvSYk$N0!x8;-nY*<6#P&Z5QM
zt|K*B7K}?v6Q>A0?IP;#^psolv?Oi@s6gW@ovoVAHb7TO(qo*xOIO;9E`M}|J9LH5
z^b}*Ec|&MZ^BaPq3<*JD<3DS{88fyur>FFwwdR=1%xx6M3&!Df<`^ndZ#Gu+#P^w0
z&hGTIakBDA#gxr5=t_gO-@e8e>chh6DPPfYbt&CAn~!)Qxr$ws2hdY$aXg8eYCY!u
z>uGu#Y*m_#f@U{T7{3PgO%a?))t8Y1=W`pUW1-p%>A1)AG^Qf%bS0){;S=bIHAq*g
zV$5{Z<Av4?15?#VdM`=UVGh*6Plj3%?>EEdOi{Gu`=1s1s0I0`mGml+?##1WsswkU
zt(@p-hT>lY;~5&z)ApmvPzgVL78H_27Nd@g9|y`PQ5xDn-cwMXAxoWL3{F(Moq7#Y
z=j2P#_c`hWL*VwN0V;-wr(nQ$#wo_CfN6$8*HC8k6kcj6Kf0h%Ero^XY<C2cKT+J%
zm{R+*nV@3TXMMpnRb|X9*VRxl$EweC!8uiodTHLF3mQ~YaY{~bZ6o!%L%jy5*R9Wj
zYaUUrdg}G%v*5aB>Ufhn-lJZFp9LMMb5w4Ej`b+B&s1g)Q7%tDGa>=h(eVp9^NBiB
zht4!mXQ)U3mA~Unbf$qiGlb53qRvo}fFVyo*C*7Gl5(Zues=|hQ(KTFu(n8;QWL2j
zK)qaVdkQ|;)Prn5?Fldbr?myQOrZt=YL!Asv^t`L{yOIRfv~SSw4Q!S4YL9J6q)<P
ze-R9%Q7<J=!RA|n!qftc7DDtiJ#jjll@MiL!7W!A<*>9oMZ@p@%NL;C=_%FpG-|Cz
zD$#RBBHmKeP|ViaQb#q_9m-p{ajQ{s$vdg@s67}pq^E^a?(wk=`wsPalxjA`b_zs@
zQ*XBN)Z0o`>McO>-A8K2dbIW<Rcg`;Hb%44o8HlRs!`)te>SEX|J@HthMs0c<tn5n
zPrcF6rx@zf8p?!1F;r~L13_T}c|qaj;_t*5d(cz)Q4U3&rkua2Kj|$Soo57TS4+7;
z)w{L->{Cytwj>rzMyqa8vW%9dYNwBCCzy<$2SPbO!>y^NRL0$b;q_E}232*+*%`i6
z4Oz??V5AaMWcWVijEtV}g>s@Vf_8OOoY9vkO{fI&cRU5H?|KT(ZH-W(%0bQ{--7b-
z6trnX1yc@pqm_#iqU^V(-c!()5|*blnNvki(U761Z;%oCEGX<Q!=1t?jp-HiG-jif
zqn4wmX~<BTQX+J+`Oq?&Q2~GINPVCT9ZMPXV;gwGXF<ggs^DSVf{~~NSECj*M=cmA
zN!5KADgF%&%Ome*QV#(_TQY3VXiBOYl*W|duZ*CxH~zFtFQa9CqI%w72*gk=Lp2?8
z1<D3g)6scq(OIhdt*LwGN+oAj5LulHGJ2kj(65`Fg~DlFCRa721X0+?jN|tKIFI8A
zddyF|(A9<!Ea6999FNM`-y#?^>G6#510C%S#gV`ILzeaL(Pkg~F3of22u;K-O=RkY
zZAa5(_41!^op^LKVHNv0eV(o`S9@)jRR0srwYpZ`zIpHH_Nh`$xer}^?YxgAEWfZQ
zc!H?CkX_MW<;QPVBFAS$#AHQR9Jw;u*+0@5_`E)SS^b1Hm)+hyzioExjOp;E9W!}1
zvWZ5-_e-fbiz;k%ZhC0TYZJX+cEuvas^8Q5w<VR`-2bMp$nf&r$P&LpSNcbNiWM%7
zSVTv}y`o)QQp3|6Ws^ANmU(R7j|*LII%D*0KKoZDXMO$MFuw2epz;0k(DD~tCA39i
z?E#`S+w}H*7uzM-z@f01<96|}<#$gN<S#DR`gzqQ>xAW2Kdg0Z^yXXYSA=c57BunA
zvkPLEvQHPK4_&b^wpOxn-L|mTW15Ypn9Ae&2t^mMl}+`(PM`R2HTOZ;;i>Lo{f~N&
zE^XP;5!1RX{bEwvU~yVOZu#j?&7wZ+j}2Fp7|w_(OV6%}7_wabtYKDMrNa}80ej)A
zCpUj-*>TT4X1clFz&MG7t0(h<PUTOIve0(!3~nEnRF-&xN7BLDae?Aa$|6~7+-qD4
z`!1ew@$CCyP}tIZ>ivs^Z@)txztD?}oo%rxson4BxbYROdOW8#9al>fna+M9`Iw&U
zJidIXxi@)yl7$13ctmp9=@a+s>CBrT=QVv`%Sqm|FW%@)yt17wJ0)0;cNJ%e@Wg}&
zSE)vQGj^>MpQCB{Y~?A13CcCM6D3^LiqcD`_Q;-Ni<o#xZ|1zoE#}Q^+fsZJ<GZvx
zf;Q1_FKImgc00e>_&Eo&s}Ik~o}y7LHn~GcxA2=;i)~r-8@5T^EvmW3qjh%l^QSj`
zikWY%wc`9Qp_Q5^)71n|3Z6XDI$Pt8Sba|S?8>cCK36){U+brHm+96$m@V-wFX2cF
zmuhMI5suUr0o8}?GxWAcNjSHZX(uKcsZ@!FInlOGyiOC})j!u+<H9uOu=4BU&Pm2|
zs#<sGRJnI8q`i6)$6uP!!y#VNADEa`(?^qj*1@YGG+rupFn9MNZq=(D)KZ^Ue$B2L
zh!Eu93;f1Seb~uPeVCE(^1~1!4%7z;4)M<ZVCuujWap@gje=P#>joms*{HK&E2Apb
z2ZvIhrUxZ|7jiyR@itLcTBSUL|Etx4@a>;h$>ndDCblF=&^OWl$s6r{+Kvq&iSjSm
zc?{STr1-2wgpZ~sv(GmYwlJN<;hj4!U#?3}desCCVGlj^-88#oHob%XoB<7k`jNH1
z4Wqqr@*MJCS|@g_y*5`aG&P#P+Vt?I@!Imo<tNHp$t$h0J$6QaZJJtov4n^8-P!x@
z%iEt2j{G6uIqkxRn<u9QSI6C{cKR}(Q+<43Ouw$goQfsAzal(W?_WIPbnYfcv-9)*
z_iU$E9UIMaDY)@XFf@q9<MY}tZXn3&`p|KHE4K}gXVq=exjgk-$QqF&*+Ta`_2*xx
z(a2hB;qX#2Nzm)isIlpakm4h2Y(BW(b}is?j<H&OYiM)j_ESp|mCamziueAmDJVST
zS77;+Z=v$~0?SKV5)%#-G+QUME{hX!Hn0q*P27{6p*nN?Y?*L}3n>q8)#QaNxu%#d
zQ2+kKDGuM{zNYA`f@Z#i)63(uJRNzg_7|v(#<iH*^qwl_a8a>2{oqA+W<m3uob1!f
z=hN&{T4`T0vN;x;+~drwv6e1M%N(zI{PY9%^CDN4u2}CHV|C<qMx~L}%5zp<f_2RT
zeb}bnH7_gYf04INdE9q})mNme@8+%RV5_6ziLb5BWf<_R;@v0G!EckAVQ7;(*&;ok
zzhLs&O%HQpkH$3l#Ag_N+nRYl|CfQ;`sQasU#46VNZPxg>9<9NmrnDn7+UY7xRm26
ztHw+CUFlJ3+)FJks(hJG%S`Z<-4Vxe-P^7@N=WqWT&Fd@xMHi^&&~;^ksp)=p0^0?
zm6+;zg2z*{HF$Yxb=?lD8y7>%eWO;cjO2e1K9aTGQMmEWwP`22Z}Eof7EJ0`7gc!8
zXMaz|nv1sSJ)zTmlDl8c@fJ2b<5(l^J4xAS+CiiH#-V1{Co3ynw|6>b92T3>`eb(b
z@jGGPBAQ(D4NJ!LPEx+56PD7yx!kz^sB*4tzDddSXS40tzNXq5R2cgQKPq0*G}W(7
zrCdyFPPvMAf4)<RM9RC(J&9^xgtZi0*Buhp;XX7mF6(BqRO-C9V&S#-gPsWcC*<aC
zYgIRX?)+d<++H24=39pqVq}V~RD6sM9<^&ao+)?I_<68x@2^6!aKrT6+ec?Nz48jb
z*i*6W5r=5n;Tv+tjY~L>9AD7%t<~IE*I9S6&i#1BpTg%FWqYahUgPgMDm}aFax!^u
zf&{gAu)VSFD^;tSV;j%+tnKy^9zR-PJpK1|#jb(t<~5&29h=h3nx$5b7f4w&bJ3ib
zlvkEb_0tceI=(Emt~q^^NBFIPoN><L9O2-hpp}EZwQJ|ys@v>T)4Ex@i_ah>{<gyI
z<cX=7$?B<_sa0Dir;Ob3-rYlcYn+>uBc9Uv!rEbQwzYIjS{8j!t|7+AWYGuV%KIOa
zd*m<APwh+$5dIpfrV?}DVsw*J(fYI=@n%J>CC%IU+l)R2Z=Th)@1#T6CO5vOUo97{
z!bG0QYuzdpJ=8r+58L`>W7FD(T}E%kD{k3FYjnjWci*~tsZGt-bkNTEi0o*lsd1O~
zRr3`m_9fABx4Y4#s%O!58|j*@(bqj?uw{{d;IU=X#t)WFFmvIIh&edn$b}V!=2<H|
zZ>8qa+c>+A*eISWT(RUpuYj#!z4d|In3IQ`4xPT?opfLJ)D-nso!+aaeYo8cRc*X}
zM%~48<@x2$YC8pEAGf5e4m<Mo?Pz23aaHdp6EerAr5l^PA21CL9IbE6G5+z(jDJM>
z23Kba*U0_mT)jZv%#DFBdyUVx35RY-S>jQxWjdko-lXu1;f7yjB@53#nI;vvHr#6U
zfwfsq?pZbq#nSgWr6`<|Z3`V*Rx-EvVcBHqpd0U!W!FEF?*3M(uxKF0b8~y>{qJ6n
zb&@?ku69ZNHmJkr=iqs%wENOq|NNP+{X0)O#ojr5ws3Gp?Ec5gekaryRZGk)p7uG%
zx?$<>GfUlGZTMEVsx>yWa`KnEN;)MnA(u1r>-65-FmmFu8hmp$VTvo~lbY8ltD~kJ
zIdHPFHOEf(Q|g7;<E}cLcwCULE!1Gkx6U&?B}?;SpyBhWU(OVU9QjJm@v&@KTyyk6
z;r;f)l&cTN9cff^Sdh8bec|<^3)A=CR|*Mmw&_2seCHPDPB+itu7gYKw?^5d+&i1i
zYaG_L&Fr54hVC^J`;IR@vDa(YN1oWr9u7NRy-I1n`NVUjZ|B8$=TFbt$9o=LwYGmm
zZ1b(g*IQh6^T<4^2s`B9u{No)ys2~fsoI|l%?-k(sXIP=pNF4i$ML8fhgJ5LH}r(w
z&l)G?CVE4$ZbE9|)eVzIUK=K|*Q<ok&b?$iV_A50-_y{@iISguuf%wkuP;~FEGK&P
zwOGUJi-OIHG>*=DG>$K)#U^ib`qbt;!(GH{aJix0qiu2Q3y*%-9PsA7oV4os)`@yb
zhRQ#d(>lBMURyEhedx)(^25taPI69B-M7{KB<<x*UeWB3-FCyjL^(ca`Zqhq6sVP1
zM&ySk{8pRpU#Hj_xO$IV%Y!ZKX?L3a?ceBz`mgiRmb*LM@O;5;r5es2uQ0a)son)n
zdj(gUJ-o?jH$!IM0#BVO+A0S2b2XnISu}0D_nV+sEgtdXgXZ6^mA}rb)au|vyO~^T
zP`vQHU}Uh-jN?HLnG&>TMxL30JEGaH1h7qPxFb7*{Z&EX5AVGt`#v4zG|P&(aQ2>G
zg6@g;OC#URt>~-lxFo-1*u3z4!>doCp|vwR3k-6Y_t)6I^We8M9FNKg-*tT@yS`9u
zWW@Tw$ccMRy^1d6F7PsNbv=G4L+qouv4^Rz>6s`RzwM;e7B0)A_gBlQidIRBD;h@8
zhM#b2E)GmPbg1Lw!RHOrO=p!9<(6*xkZ7D_88BzE$5m^kTZYR+9Z#npe}Dd=#SPC_
zlFL4iDtf1`F`sm6@hYn=#euyYtL6-?t_~V^vvvOEMK?1#9`awmW1cdQe?;TPwh@B_
z+l>3;i^BR}dpA5dEc(g%tH!116SsFf+mu{TJtKNg?3c2I-%1`VjS>D{%H4hKL0Q(?
zA3=5M6_-b1{C_pPjawLTXO+jo##yVZmzFec^wkruO>lg-{*1?}i6>?owb~A9w``Iz
zS}(R*`$p$M&YMpX@*f8m%(S&ISiIHYPWiXV6F8EW4W!F(zMD2hfd2O1c64S&|M>C0
z)|j=R)|i!P{Qj%)`{-KnB6ivq4fgAVycH3T%K5V1+1c6Sg|jp5kww*ws)o<|KWV7f
zFUxp4XU>c>^=qcIxP*KS${3e(X{T_*@Pj()F(ZTVd4I~sbA0}3SAVMq<`eZNb!N2&
zPPa&XZ(;ea|1$T<skzhn#2$66u(R8~u>69F|3PuV?4M~#Jj$P5ur;M+%Zu+kd^L8^
zvN?2=-K}eto4Ml#b-lzYiHK`~od>_geY_uFzDQvDo5hjSx6K<;S>P_}nb|?F*6e;c
z=hn8bFLgXQx@CVhe>fi3E3vw0qu=Oej&8nzc-4lg`I*!87qMO5UR3hy+K<UEb%Hd{
z2OrAqG_-zxY*_U1H+iR};S!EK$JO@@tiHLIFK<SF@zhUhHjmC~tZ#nnayCWhtVUG)
zswX_%)mE3JQ`XLI<=Ss~k+#44b4AAdRz0t}`op!7vrcYb$B|mJtEs;{{arYpP|kv_
zTF&M_UJECx2q-xFWW>y$zpr+m`(&BkOhu6g()uqi#GBYjd!D@V>dCHM{y8PSDF(-;
zZ~eu0Eb2sjW5&;uCcF2{*kpfvXdgYG#r0e>Jwr9%MfvVo%X!xG1&TNoC-HqZo8HO(
zY5degWuYm%g}=*=<NR*Q&0CS#U#B7_c(jQ7dYbco?%E3a+^Xwao!RQny)%t#9C$<L
zd=*i?+Fk67faAFOymu?->LpK`QRe+?w#({stsB^N&pxVF+r#PVk)zsSB{Ba>v3}vM
z849kGW5=flT11}yb+wW!D``|~o6)$9Q&N5nESY7ocObUbwv<yh^+n45x%{^6r`QCV
zvP!b<NKL4vdu+3jAKA3kpNGGFV(?=rrQEs)^VDa@cNz|<Z+f2TD=lv+e?z%oeqKmv
zv%%#p7f(%p5F7L~V!&j1!J`A58~IWeTvZ%is4c2==c+-_WY@`Ax493$pK{-byJklC
zyu1Z<)e0h_E54e9SG_ao+H>vVXiKhNHsRN2;D3Ps_~n+hZ6R%oMBe0mAHVq0-b1Yg
z(RY%hngo=J_dS$7AUDa(Kx(y2wX9x!=lSQ4(s>ouW}VHRYAnUW-jVk}vtvn5=bgPi
z#^<&@nQfcBSJ;+U`mD&CMu}ewM_=jNUQ!gX`n{Ux;8knoB|-YuAN11<9^WmfS<~9~
zTD7F?Y?zYS*|XLBNvoF4)y`Tyv|@Ti_4enfcXLGS=P%C*-)LDW+-viO!_m>yZHv7{
zrR}hJn%sHOE6?s~y^A@d<YtujEZ1kJl!{IK^7f$)vG+F$MmWEfAK1T0O=X94ieLJd
zYx0SC7u4tE@62tk&91p~IqJ#z+*J?xbozg1oVA>1KlkaE*17iQYaYeyP941cwl%(@
z{@Tf|NAV-F9Ug_ZjgsFUEAZdac(?pXS?q=InZ<p*6VBhzZ{JhVI+WJ(dpJAQW5`>*
zZFo|};Jdz%%cgPPgI#CN>ik%CUg-Gxlsgi;#9Rg&-!9kqY}4X+xm$0c<(=m9PafE|
zb@<IUpO|?6&>r;#3SNQ3`}FCPpBx<yd)WO(#xF<QfP;Nc%axU7zFbWcP0psZy?d=R
z@8Q)?w;zuLj68LUygvG)?c?>|ulld;j&qFn3qNO{5*Xq2__k&C#e%+yU#~iT|Ge2z
zdEwUW=?~gx`kin7op$$ZKijh5gt)hPv3k{?ca~mysw|;h^7C4u@`!LzXyBxcQ-_D<
zAFSZ^fA}H3EbZm8jqVjjY;BWlBgKz7DsHRfo}C(beCi6DkiO>LOZ$>uYH(~T_W6;r
z?%Q3n&!3B&?ti)w*8gJP*=zSRTG`Dh%bwkKYQ>Ekqfg|oO7TRUXs@$#)@-=$6sA3z
zGk3@|$NRFKMetSYEo!;v4#%b(dT5uwC%1Rvqq`0Jo~7DKeJSo=uBqU^e6CR1<89AY
z4*iPD5Uvp}?wD<Qp|$SP{rF2#-_6~AYW$k@@Ug-B;yexgrKWR6*A*&>lsVWBzVH9y
zS-Ej|IQ)9(D$j9GignBL($9a(ewf~THTFu|+XXJg15HnpK5(Voc~cO>v*p8)R?nSE
z(|av^y-f<bR?GfwylgbDf81@y2-!VBC#2k?IBMwDYW@8SM%Q({K42mkeSL1%3N5FN
zrVDlVW=4zcJEoLeTDBvuTqihoQ(%>eMA6xpOG|!kk;__lS+n4S;`HxpJ}&&S`|Xp$
z*Um<TX|z%~zv$im>yKo-lkyI;KQ_|i$FpPal5?w8?!BlJ@G$IC=#71+wAdd-=I@ly
zuwFYM@VuXsLJe>J{Bimt%M<d>A0HTaYTBrKZ|3Ek)NOuQvk&zO&eQMTH!?$Pef#-q
zXP!J?Eq2{QNpj_4k2d8G#XdYLCEJB%HZ99bnKy+?tgqZG>cjMB@7~G(JhO5829uIG
zJCheX-*~!KIJPw`xACp*KA)c8TE!#Qyr0AkO*HPXDV9_}3Y(mueD360QO><93maDH
zFI7_sE9`t+AL(8{xi8AijDADz-86L#{%WO<lTU9i%;S+*J1Fz6@A1}<j<A~aV@0!{
zt}O~WOmh%%y<?u08B#ReK9xuAfDv!xR)by_y`u`o?i#Py%wOiMFcb;%7gyP|TkyBv
zKyRl2ZS9MoXEhg|8g6^&r*LVD9REkvrCnZL;Wu}GwO0w^oLPRr#DtUEY?fA=lbFi8
ze%H%u*S(Cm{_Ipm@aQKm0T;*S3-a3I*Ua#`X}|J-W83aTt=|n&Uwd_v)b=IkKRPfa
zk|uap>|C6K=a;Mm&a6E1cRq60&VAzW<I(W=wJV?|M901=_G*mq=W_Xhb8NqYG`#fG
z3dHxnJz*{9JMdw%Kv~$mfp+VRp*sP!Ha11BA2a>O9r<?1I-1>b2AgBq<PCNT!im>a
zqT;WtF<0CW<~Ken&8X*QwR~VpeoKmasb|uR9E*hGn+;~joUq*9n){G@l7@uVp6;9R
zWrO#+*yeXUHyo07NM1E*c!|lqh1n<Sw>0wZwW_9T%WSJ{?mE#a@?FvN&ce47b_iH-
zby(kT+}?KbIQy;R-8RYs?OnRVeoKYA4wv6}tH0+_dHa``i-+Qttxj3g{Ml<s`@V#>
zt(yDz4jSg}klrH}wfV)HwjE0^%g^)jdpzRsQE!nL#|7U{vx2qb4o=<qoy$D;Tw~UY
zXz%sQuYQf4ea+><OV7>zfqAc&HGV!^`D6KxTLy21yR`WqUAlAK%J6~8C7+#=*D`tD
z+SQt!J|#WwwH{4qZkU77)vi5H6*NK)tCZ4rh0i-?8)+?Y^oqW8oRi3GnY6|BoDwsB
zI$p|{#xIuL#?$HdWZI-ju_23&POK18iA}bd*L=pldB&$|@k>or(QVuBEH}Na@1VDF
z>$P;bYpd?dzd7x=cZZ07Wcm7mJ7Vt>Oee28mbdrq!oqt!wCd-Z`3H4YY8ISYWo&#x
zeXC}KW4mH+?d}X+j?tMPHDfZhW*QZ|5f*ix;J9SGbBAC1(!+d{H5K=68#pnCy|2-J
zk7*#S>T2|?LH;Ek2cvrqDXJwk@f_KfR9NkjpzeM>q)txOK&yXygoE&G>*q<E<SKWo
z%W5iDo$Efzop^1Mob9ZLr{~7$_?pM0hF$(1y@h^qrNr*)rQB<_bVYvqR2?_`C~o-W
zk`c4b)vY481xi|XCtrUM@#R6<SGUjGcZ{x^EMF<yH9N-6DaY&3K5ZihHg==MnwtgW
zdK6?2|C-LX;c%AOQtdZIH&v%9`|UdUd&A*?mo5%mYfGZP&zhQKljIROuqDT7No93#
zaYxK6-+@hShsuA>(42m$W^|6^B`vexZC=xchh6X8cCB2lxp;fJ(807*nO}Z?Te&Iw
z(bq?Jf|h(Z+;dL)&20TuKlWZIPRtBF?faa!R?4lmw!e&b;6T@RcI#!1no&|C>1H+l
zJ3MC$r3Ae;HmDyo*S!&3&CXG^H(;~sr4C)4-N!z6=zEyHwDVTCb2PEKx8g=d>Gr+r
zo?X=B_s(cuvt_Tojh~E)_(+w^fI-8zx~b(`pUxM1-M>^-y2-J*#K)<<U!h%XQO$)s
z10gngs=c_2gKt14x3S3v-sKzmy<B{=3b$r*EGf8K{cd&O4EtT)rr{kcOGl*r#?Q_(
z7Pl7O__FHa_r%j>w44Lek6HQ#%nSUe7<|V5hrrZLa+_zqNo-xWmeXc>TDotVXY%4T
zO*7ugW^>ynh*$TNuj|=8e$ai#gt96F$x2gEeo5<a_p0d*hOQU%J^iZN&1Bvlj=b+4
z)%mtsb90bm9<Q*y@dr!s4V(IY-CME$$cM<j!hLbuez(cCyJ(gU_X&>ceJB|GL9w}C
zhI6oUQ_t7YUA0miqd|QyJ8s`uKE+Grpt9Sw;rz4wbyMt1B|~bix$iJ6{8pdRF4cA-
zbm0be!C6re&uD%9$}csXb}ef8@aX65FwYxRI*NVMMtP^sp6fPu$Dzhck5g{QtO*Se
zo0a)Y-7rCl`Wk#@(G{tymhJ|wQ|8@cJEXzID_WNjm~*A+rK(WHH7UpFgToE9v`O){
zk1v$;X6wj%ue$9#<6Q0O!;*oSOFngF7ryZOu|#6+=IX_J;si#X<#@=s){CW2p3l4P
z!K$ORAAVK*<~8xP%inSDTXXRAg3j-!tIygUb#c(M+n^bd`MvgQ?n{rLkcrZzDWBL<
z)I~Sj32SVcwVj*artYC|#*2NOhb28<`(6IDliMYG=YIE9gM8(sGEx@m%3S*Ee+gHp
zDQ4uKO^W`qNLt&^X4=fui5`bdrr$Vnz;$_R_U9cxcGx=o(CSFpW5gfjQM28)@bP7t
zaR-X~tWDjv9eoxr6ym~DyRzH%vV>ah>Gf+LRjI$&eKOO;tFd0|<*cf7F6oteIn^Ow
zLuZ|`c6|BzdVqyn+O$4JK6BRt`Ztf))!5I}3Ew{D`Yl_p>gzJcHs{UF&ikryEd9-c
zHA*Li4<t>0x^qP>+tpQ`yp0|L{Q}DaqS|*`G}jz^`r^Fh!{@RB(w;w7F6D@PyjXpf
z>WUE|u{>S2hyCZxb*|W+d22Lrl*7Js*8y}Zj_<oS{pWlC+1+g`Z>sWb{bg`=VT6!a
z^6JwMWqkRm#jaOg`aF1I?ZR0?mb*)T>i!sLE0&XKOYQn5`c7o3gTCvuDV<BU?mE2V
z=%vjsO4B3wikctCS--Lfx?5SbDrxnJm}#RIpGqGSaBpUtvx3i4tNQDY_QN~Fd7cU=
zIP@JB8MrrZTpgG2t`gJQfZ)&;{qtV~&;7Ex7#Oi}Ui&qPF!`%r?UpXzplLflZuH4c
zTAKbI&oxyord(Mj^=Y|R3X9}*JAG8$@8`)+)sg#XlcVk{ds&e4<LKS*nUQb5#yMGC
zvDtc8X-Y}Rj{0$q2ku@}yBfxGsF{BLv7Gn$p4I<vmbpgrnIx$f`WG_m8rRsKc#UhA
zqDaHfApK8kTr>VD%2=OzDO#V}OhA&|6R%H==0X`!FBBN_q8MvZuVSo5jb_O>qZ3rP
zhTa%?=rh;2F5+N6L#=X6A!=!BeO~lz4xZmXiYj3sAheyGDsL-?zJO%XI3oc)j;CxB
z1SF{?vZ*u%0^BQLmLAIZzX8?v?`vLzQxVBH7_-3$NJTmRGsBrF!|`WE*FR~{Tvj%g
zSz)LuIB+oLwcr@@$eilM|7T7!K0A}~f&b65keJK-g)0EZa`?!6#)UC~0HZ(0|1Ye;
z&3uLvCPe<xoVlhpT8%@Jg`tnksjqzhv8N$Jj_*G$MhA}O=dp$rRD^XcZ$=-Wm>cyX
zWl=gb7kn(9@E4Azz_706jpr1e{EIw#CUdO(D;W83Q}4{c=x5Z&2I@7IJeo5-79acz
zpFnk_vE<PjxMOi;ii@!LIioLAd9V13JX-s9tb8K=!qJ?~vE<QOwqtST+TCF;p}u&*
zaks$mfUvo$w7F)6^U&J@^rnX1)Y02~^rnH{<}prdqK^yF+ae;b|9N?GHy1zZ;T2kl
ze`vVBze`B8lUra=G?@cDbn}nUf0iu&qq&odyE`-adXF&b=@l31p%}c_IC}EMDJYz=
zkh!-Xfdhk_ygXdo|4l=^V?1b1C>u9lCpRx&Cr@f`TT(mf>6oDKFb^j;mmn86Z|WJC
zfAoYWivFd5r*{aYhIg2U|G&!$@Q4}<2YGn-QVXwB#fEwR^FR$uUH;D+;r^5lp@7CY
z^wS((I~+~)LjiF#M;CK^T|*p=rI^p7KBIv6Eb4{17J^hj98KxLd^v(tKwOG?VZItc
zDxfO~dSSjEK`M|OjSncGe59!tmfwUR6%a>r!!SqV0}6<vF(32&2vUK}znqB~@@UQ(
zmPemaK>47@N-)RsZxNSc;mmRJzvZ&l7mda^A0O&73P>MxLB>1;K`J1QMkmaZ5TpX)
zJk$&GGz6)DIBHYOPasGI#8I1K{(<W6C?Ne=?KTbxQUP&v|AFOoSU5U|xj740WZ`&C
zWptXgUeO#BpaRJgSvc}xoPP=nN7LFdKgYt+baBkDv2b)vz<es)NFd#nSokj%&f4zy
zihyj1o?XEK-w7a&?o~EG{n2L>5J%5y;DD#{V@^%<Wd!DZ3sWAAyU5lk%w`@K`CwUu
zlvy|`ix-~JNB4awV149Z5Z7knKU^IuWI*uE@bK9(g0sT~)rR1$@NAVE!S8_`eF*N1
z9#Eh{F!S(79|OoIg5Z;(+|2}kh@6NDDa^y4eDHXL`!%+MG7MnH2>Er;AZH1#ft-#C
zRgCw4?CA^r<Q~D5k<(G3g?ad+PZv1CYl63cod*bR3yu7n;A?o80Np>Jfa^6297l}c
zX>f}tL+}!a&m;Igu)i+B@me(KeuK4KA@D1_MiSQNE7%i1<BK_dwm6c==Q`MV3&F=h
zd@sRQqYSBVjNo{!^790b1^ZMI+z#whPw?B&q4BfjSpOUtN8S?hhrvI;68r(wivz|3
zoDYr*6MP!@^Gt%*gPrj+;W(d%xL*_Ut-zNN`~`5l#xBn1EpYryIOaLvhoMA1&%ti^
zcLXed3C5FDLVg7&v%NA1ZVP^LoZ$VS5B1-2M!@+$0RR6;@MIW_hX{_>yySy+!}*+t
z{)p!Iqk#Da@c-Ea7lv^|o!}ubPg#%Pdm#T61ebz(*%7=GDL@6h)+E-)3*^HHc{T7)
ze0{|7FTwtJ?I+AnGP9>0B=Q-A{P7yiSbinQ-yr18;QI1_;5=aWc7p4G|Gy*nDCjvv
z@O#jYIN-X0^(ljkrx3xlp<mA+_%Qf`BEc)bpBEBb7`PF^?ZG~)2#(iK$7|eUJ>NtB
z^(Exn!Ox=zE(QLK_qM_L@Iw3UA><dq_2LM@k3#=CLvTH)R~f;z!JfAXJ__yenBYy&
zUattg8}w&`^0EF&P%baQLm>Sug1>@xlq0wT*iD(>^P%6V6WkEmU6bHWU^iWYyTUlO
zl;BywEeZY<Rgenn2p$RdGu{NRgK;B*;Ag=8Nd)JH`tBn5T(A#b8xGs~AlScvkjMS`
z3c*XjKWhkH1?}5J@C48Y?}35K#cK=o5%LdV-1|=O-(Uw$Xa}56Kg2}{ejKi&GYMV;
z`p+S_JJ?f`;EB*)O9|cs{$oY(voQWR6I_Pb>@<IZb3;6a;9DS{Z3O=e`RpV32WZD*
z1ZM|-K1Xn47;h^G{v7OZhv2!;A0HEZ0LJq!f=h#)KN36y+GUvFN>DBj^aI?!A>aq1
z1h)qLr3t<q#vi;EGtLK(+d70i9_N=69FOO#36A&pawqsv7;l3Kz6ty}p5T$tj%ft<
z2A)N5Q5aA12yP61a*5y{V4S>3@EveHY9x3oTxUB7o&~&@;CKzmZv_7e`iz6|0NZ~7
zaAAT=0GA+mFtno*!F7QzBDgi!*_hy3z%2<L5B&n~C5H7J0Dto%<aa<lqX`}Wd@I2>
z0Y6FbIOwN%&l_CsE$9yy2>B^6?%_2tvHVWpm4tjF*ykp}4PYFuBlv2te<Q&Iz&<?$
zPlj=zpWs4J-$8<3hkSk#{1d7O3SbXhFCMTz7s18BK70gU3w|y_a6G<<6Wkd3kp#i<
z{fZ31IYDnlg4co_R0%E#_x}qBz8l8F#RSiQanFF@oY0PRg0Fzz2UZds@BL*%a7~ym
z=}&MWC>O7Ri|xM+>>o|Y*TMB}Bf+<W{kIU@55~hZf~&&#zlY#M&@On-39JuZgRzK^
z-vj>4x`zPj>J!1QDhc^O=r4~6?g8;Og6D%BUJ^VB^nXk6SHM~K9AM}J_Td7(aJ{NQ
ze?EdAgz;H~;CK%&*1ZT&{z{O)1R?(t{7{DAN-!QO5qvZFxgo)0!4H=aoFDwqoZuBu
zt}Vgwo-(ckj|4vqB=|+>UmFOn2iN@+f^UcG)Nz92@8d-TmxKH(3BC;OlkXDT8RGc<
z9Yv8TUx9sI6Y|aAA9$R@@=b8RG(yPZHUD{GoWSyGkdHXQxxt@h3BDBUsYdYEU>{wA
z*ML0ho(8C1%5Ys+OUMsFyL%Gc2HHK8;BP=af#8a8y+|i`2lS(Cf|o;o$s_oA7?<$(
z5^OiTCrmXV{{rmaKya$cjL=5#HW&wb2%Z7gwXXzs0{>y%>j2pkf8P;=aSrQw0m_|D
zaBJWS1ebySzJTC(&p<<h{{VRlg71Ox*@588U>xuv_z$piB*7iPuQn4r7Op#c2#)t)
zIZE(M7?;iwJOKJBUIQK5Z6@e>mylP0@u7v_Tfm;(1h0npAi-V1pV`4qxZHB^XXZL8
z|NQQUzjsIw^7Eme&LKGd-l0Ws{5^$E@JCRtEx|3o4(<exh3g33%MI%<1a?j!<X1rZ
z?jSf`dozdN<Dh*D2>uBAX(_?++V%K%ajcIU<kLjR<GnFi_c}nT>%)EEXF}cz#<A}N
z$9t@d5PTHu!wLNu>thS!gD}C*gMUa6oDS`xMDS$biwKU#RbztVHNh+iz7y=@MDRhl
z?)VXW2Gk4h`GM;d4()<}=f*r5+8vK)m}|rMe1gay?}<}Pa6Y(RR1y3&jE@ZjSA}}D
z6Pyj~)=TiW;J4oi{st*b1ukeetp7Y1w<i&N7x<49!SjHt68tjoB?OlR{qgVFxLkG^
z|Lq9*Sg4m5!DoSAMi9IQ{0*;}j`MGW@njDnzZAydqXf@~_&I{_2D`EDjet!25ysoQ
zg#07WvxVUJ{-K-TWe^`E_%CP|cJNbNFI~_F|346OHfVPVLcS2}Jcr;DVf@!3INsxl
zPH;9DH*5)>3*)~#!HeK}%DVRgQqdp$A%T#`dr#rtU2wgszz#Wtd=}KJfZ#8|4@(Jt
z6YdXd366iKZYH=p^v5oOPl9p>2#$Z>93i+Nv<n~j3$E7{7?-9JTowAQJi#r&pBE53
z6UHSYg5QMuLra3=z3!a}o(uWo`v|NjxFwBs?*&w)r7-TX?y-P)JM}^#lgM8H?0<^j
z($F7E2(AHkyg_hr@SjG4|AzL$d*fmKm0^5%PspzX`JV)@WvWl(hIYgG1fUO85G8m9
z7)XZTo^TyeBRIY<(Ia>*<iC>O(?Gv<1m}Ww_aXRK=#NnZ-wN_u2|fkJfqeuw0Xyds
z+#lMdh~W32UtA-28N}}q`~djRGlEY8d-f3gJdCSD1kVS*8VBPOZm+N4S0V&I0bG*c
z1#sP&OYlU9FDAGv*mF6-Tj2V>hTsNZH&23320sZScpubv6TwR%|6K&fdnz3!_-PnV
z@c+TEebS-6<%IkMu+JTW|AzK`LU6o?#cP5u2K_%1JP+=}@x*<sj~=w60E|PJcY~iy
zC-@q;E+`V*6ZBt1a0wW1mlE6u>}f}E{5{H@;CS!r0D^CUeiujZIJgd`5d0<d>kNVi
zgPo5P{3`fc5yA0Zc~u0T4)(c4@XMg*3xbORA0l`m_$@!!6}Joiy<3LhGeFOU1jqk}
zSV8a+=<jX>PXar{5PS;wa|Xfvz@IM?d>YiNmf)9AMX1n1a81bPJHhezJ_-6Owu3wP
z^AzCdvI{QD$bS)wJgO>~m$sPTaG9blBRKPU0BZg@!L=B<(`c3~91V>(puO-sJESKn
z*Ae8MS>zG71@2Gqoxp<$o(MdGg`;x$!OznO-ir#M!hRNx&^-pF(Xt4B1NdPUj`GL<
z*UM+&C?B+xE(&J|KE%Yd3oIPvV*&lHf`y}eRzp7536A$BtzqHF#JIhl0mtnw0e1LE
za0SqZ5Bv+uF943`Gh%K6T#JxLi^ZZ~LU3-lj$0F4AGiy_t$+s*96#@{6*%_uN8r?H
zEb=hKF!aIKPwa1a-sU-$e2|?zK>rGY?*e|E;Hkh{34RfH2f^`t#4Z+&+8z7hN8l(q
zn1G@GcNUK7HJ?GLb<g4YfaDR!{ZWPBD?xrS!Q+50BluR}wgle`+>PMZfCmG|?Xn1X
z1dBYlAmdC1i#)Rb1F%~*!EXaULgWL(E$s}!AxgW!k`J=;MHt}jv&h4xm!Z#l7I~!4
z5R^MW@B!ez2`&ze#s=3J>~A8#@qIB$j>-iwnlyaCJeZ*kjkb^_AEZAX=d}rL2m0s{
z+yM+^^cTL2;P`rke@Dda$Oqp?;IhMbew6h(q6_*WHCVY5!Bru?i{KN$KKBWZ#~B`|
zAI=~1H3Ua{CZOQQ!db_G-GAYD9yB`5+K(Dp<XQdp8w+RkAN+j<okm=ddZ7Sc`x)~~
z;ntJE;d02ZCu=^EjI+$=bXm*A_QQID7)_5wp4I-iEF_OO9#`>rkM)G)fA(}loV8pX
z5FpE?vvAgOrGO*<LATf|AU>PmDG<kY!tzgn&n4vLkpfguV;&gxMES=8Urg|G!1W2v
zSdpD#O9_tK+mzsV{<j6e@!n!K1n-4%?Ff#qkGNmp`u+xacS4>M`h_>a`GE%z9Q$7=
z!DT=`ir^~1@pS;}qYZo$A-^2>HiFv&-%jxLz;_cI&;QRLcqGUl1&++Z+AnbbMx50@
z(Ow}apaW}v&tT!K{waxssep=O%^&+S;;i}Oc0rsqe>{#M&YJ)K&E8`FJd^mBjm7>E
z_{*+h{|KO`8p(ah{yF=fClHB!!~)%2!d&K3n~Ke&p5hEaJD2_ceOEE`bq%=`9?z+d
zjGzZc@&NAl2hXBDA;#)+=%gNcqXMhXjTM)pAo@y2rZ+;uV+6ANd6W!dr2cqZ+eqXg
zM8xM%aipUj!Pme5t_oa|IwCpv`uXR1aZ8GgRemGIQGnYiW`uet%SYFdvC2;#qkL3H
zvV1fyj#d5u#ZkcbvCP<i%SYqwSml>O`8Xd*N)DAxmXF54vC1z(kP7(w4Kw!N^3nJ@
zR{8l#%oN`tA4w{T#&WX!D-=T_=w6aF6oEs?vqI`KPLGc@6dNo33rH_Xq{r=tkLbG2
zP!VT{<zevr%7X#(NQynA@L2Ufs?3!C4mS*vR8)X^;q=(AUQukU^1p+EK8%x;5Coha
z$A_p7W2N^3gBtuV(to1TkEMU+I%WxrAiX3N6{cRee5^k&b$+b!i_lFF6*QTLKkqm_
z257I`vC40BU`pWo14$~1vc&0e`Dh-&Smh5u`R2@Q{=DP#7)<?3`E>XJh_!t5T?41b
z<)b}7#wuSAzSr$W7h;xx(_^Iam-4Hi{G*Uwl1hNSa^v*4d_5>%6`z2NTj2K;JpT*u
zpY#l!DQNna^v+Vu6!`w;Z|TwVl_)P&EC5G8Y32ucg5z@W(H+tgVzhmbp5!<k=3x{-
zU6n91Efdm{dJ$%#ZHMy7^mibA6)p&lWcqDX`my}i*@c<F8PZ8oM+xeM)8qD|lK)3{
z3el2f&^wJLi880cEb4{68k6bK@WesA$dE73Bxv&{)<8rVeR{0)RW8g__<j}VL8ezx
zQ&(l#QcUuHxu@6y%>~Q^|NDE2H9}uNI_NPJ(WAb{DloSkx{d})<`ziIcZLAt4Q(n$
zPrF`3Nx-%@TdKlDsLf@l&6BwCu1Q9Wy_C3bQYrLpjOTsOw`S~_B~R^{HC+}Nk)E;+
z?V0uKUpZ~5iZ`A&N>BHb;fAc!Do{DgQf@Khef*xg(7sJVX*6mhB^_#eFLauoZY?83
zPw8jMP$$~|y|+`iGNqcl8QP*uf1SR=P3GQB^t27Q7_*d*e>N5CD_~|rGxYOt3GohC
zFX<H+8Wuq9Rx2qRD(M*#=r8F?ElJ{wRtuSnuDu2*hUJiqYqX@SU$|tbhg)EPd#I#5
zL)^n%Qr2A(t<e#xz)1Grblw5(9-iI-)Y2b*(M%DBz4dMNZ5ZaGj79A_1_pCCgU!dx
zQmD<xmQg#V{bRKiTR!Lu9;yAach#6i3R}%Iq|la!VU)e}(B@0=+Gd(P@tnq+hr;XV
zY1Y)%Md^%RAgRsSt}}F@1|{4uVbs}_=g=$%slC>yQseLT?Pj#kKl^Hh^P@ern1<JP
z{Iii7GdE`aY?h_`*0)}kGH63jd5m^eBit+HCZ(F-<{V0TS=tt~N!qBMd>RMU&K#qL
z<8E`H&O@gPUuu+QIF6q3&Mc*iQkbbZsrNkC$%xL@!`Kjwa@l{JVlzXZ|0y~Bb`{#+
z=)XxRf1g*yG{&;DO5~JgDc#ftaMZR-O!`irO2^25j0)bM^rf1CCrxBt)s}~X`>DO~
zY8ZV7CHT8Mdm1~7ARa?rz#xd@Q8_1D;({i<L3=4xv{kgl_Rl>~-?oL8o*>@IA-{Qo
zc-pN+^8A5&c7$<FD0ykj{n^z|KS}LSiN!Rn63bq%T`N7FHE>&<wN5=TX}{&Fe1Ve*
zddE~RY-&^xU3zRV`r7m7{SJI35!t$j<CauB=<5&s7CqNQJ>$)qh~|eI7iP%>bi7az
zP0dVFzx(<_QQbH3jQh9QcW4gsX@-i<xzOl%G}rl5naHjE;@T;kjeNX(D)w90Tdk@e
z$x_Syd#!k9raRhE>=*AKw)f-Y@U78#Il=G5u5Kt*?dW+Uz5nF;!CBs)x8+icSvDTZ
zJ#V_(Zab~Ct6z0|m*Os|5l;7HU%lw$q)W#p+&!gunr36ndD`dhF`s-@8&l(at-F`f
z+QM!>Qt%MFcFM+F)^Gdu#JhPJ7Mu}X3UPiXmcJjAiu21=i|7;^{1jZ!yrciI{}TQ1
zi(dqM=UY{NxVqwJivfRe$A_P#hYL>Fovv>7^x?j=Wvb6@+rC!|dKc`tm_9YYWM|(<
zg#E%K-IZMm9=X%nhVure_a`_{3`kgf@@<pl-H<0<+TBwQWIC%(?D1izAJGt;Cifs#
zj(3>aO-VEHsK?ip-yW~M@_f-D!Q9!F)4XZkLf+h`lQgz#h`i=laJoJrbQ|Xi@9x6S
zd3GWjCij1^Pg0v0d7{@h`ca69@x|)5J67gQh^c<t$)@_fy|*|bJ)|$AEZw%OLL=sG
zp#R!-K8FF-Yypo9yZ%?lcy>%lanp+M<noYt(=RrD>(wr|P?L~_Klko#KB_yVPRH9y
z)=l&6rjZS`=LhY7h}hTNJNP^K&6881c3Ha`vK|;|D16D<x8Q5N^7{NG1H$byLq@Kf
zBxr24o|P`WLUM)FeZy>n?426Qg1!L*_Or6q)gB5Am@)pR^IbmEqJ%34)?~(BpZfjv
znbhrV;w`6rW$wK*5ju4zUV6!V`PRVNVfK1A?W^oc#jPg1_kJ%Oy0B@#<K@$fP8NR6
z`rT-lQK9Bt{wQ&KB#+C8T-=58JYRgHZ50le%;+nYmNMKKZlgVHGNbQQvA$T}xnifQ
zYs!3UYqw3R;E|V$p-nb2Kf0%M3cs~*<$j)@K3$?mx8~D)Qm%O&ovR*OJxA$@U}l37
zM?#FNP@|qTdwPw~(G>9s8WXRuDc7hv>rgvViAX2huX&rOTtj!BHgAHL^iq!4WFKeU
zV7Z`VagH3xe)eZ67lM;`jaD3sUVOm+g+x{H>ELyHjJ}n3D`ksxtS&J<aIYo9O`^=L
z;7t~9!?gJRgd^Iyp~+ik+y5>;xQAw;vgKmmk)M;R@@?B_Tetq4FC^#4CNAeQ-hzI0
zf~r^Z%A-n6T&kOz0}~x<KGL@Cea1g1H$>a6{5AH4t*c6vp4CR$QjtKm?OI<K1c_ak
z>C9cgQB_%^O?$PflGkjufZX$k+qAm4t6o@tWaC>I&gUFdFp-vIb!eP;POk<<*VDN2
ze8y9exP<D{4eXSN044H;68SCd>8QY!_mi87n`%~{UQ+#<5}OdTuXKW{<>UD;&VN54
zU%&O4!a*%l&eOcsElY17a5$dq|2Zbo{h_>&>^ezfc}c^X#1JVqYoTRF_t4pFjFwoe
zIFUFtmzFP^nxK^{p1E=#?W+-&mt;9D{pWA38M`knOE0t<t$$WC-+0A@Aqz)d)2DH@
zq9^+IR<Dik;6Lwp<=nmvvs-%iZx<XMsIA<*X2}wb($#e)$CPKx)YVdcp7_1SD<UP?
zJk|3$$EUic_mPrIWV0Pqy1toQ)PDWFxu?&wvTD7e<2I!?3cdBl<G<cNBc!uy;nHt*
z3fZ<%M{M`^C~eqptlqdhy{FLPtk-O7x$G_TR*F4-d!+IA<FxL5D<11;BzKEu`ljbb
z{|NM%pVDo3KX?2w(I)nLE|p%hnicK%{6&=$FDGXhv>DYOUC?y1QDT+b?kTPDO(E;F
zW$f4v3F+ARcs9?Ck@D~QvdPOPCFN3Du4ns$`rJUn)ke=>s_imA+pQ((qo7uAY+WL{
zJS9G1r^V7i!~AuFldNai3EHH_?`uCPXp_rtaj9p@dnq5I2TSwb{dk;ecTB5ksaJWA
z=Js;O!AF)~xbBJRIDMc0rQP_TgH`dWLG?MMD{_xe+B)ee=ZZDnjA;_>@ouusw;7bu
zZIhZ?Y;UyA!)a3Gy$7YqroIQgv`g%3ZiVkmF6=ufHTV24<8@BYCx7TNajJPUl%L%9
zfv3rLxIfMDZKTs6*Y#ggbMK28tvjfaTDr(dG&ua4)U(@*Os&?PF_b#@WR>vhp3<J3
z?IFpf&SI&huIr7)m-Pw#&T12Aa_QGLGAaEeRCzo7Opmy=tX6}{?jDtPo8*-t_OrCM
z<gHcGO7{)VRd3W-rG2G5_gmT1$#DsL_;W8diZqo;c=CHqic9vbH*OcvNSW(AKS1>N
z3|V_4v18%6JH?;onznCDo*NoD=jUc^p{B{T0d|)&J=t8&)jn9!togR+P4H5?c)OD#
zDeEi0&fXn%@nECT;e#EUXIq~8q1N;KT=(9DjmtFsqr01x%0p^oGA`Cv?AuT^&t~UA
z)9#5=rkt5vHg(|qgYB6cmu+Z&S^oIGO!V`5l}5RH{5M<UE!|}8rmuVPSk-NZxZMu#
zf(nJ#L&Y~=t>F1$%EzNr@%*-V^;*suG0W$!?Y%Vn)`H_LKA}&BpY1*Tap{9;+8HYv
zZt}%jHM($#8~2_#6xEjVJRthy7ZW-DhS>F=rfF;%O&v7Z&#_>_X5Pw24rawdI<Xsd
zUVG_Qt`SpO<E}hCK&{hh!u(o+hSQ0KX;VWd?2n%E#p}k<>ld?Qi?1ck?9+?rK6$cD
zb4K}xSCPLKMrgl%va+LL%A?b5(W8}ZQlYgUdpWKj37Yrw^x5~#<{xI1{T{IXaLznZ
zXWkXx{cT^LrZvVnM>j-I+&nEPetEvuv+D=0HEgucyk4ZEFDB47k)uAOVAyDN>s`eN
zkJ}kLe!tB)v*Ce~n&uUc_0OgqP`KQ(CszGN#mJ70fjb5|w~KeY>)f7SS1EjJcG--I
z3ooAe?@W}gI5=(M8v74|H?9hg4BU_X=00zHF(1cT`;OocmC4VYLt0(6P3QQ|Ov{S?
zuJhr^Bag7J+mGCRa?x>Uy{Aua*4OD7+85bEl`G7puCRMPJpZcZXJmFuZ+lAC(+x{`
zZkI@{H#_8c{nTr#i{H|AJW$p$bL$I#c60it7sKPVtByF@a6M9*_V8Wx{*KmnZ{9_8
za4$G=^jg+?UX8{Ii#L($-XEIqYsNu6L)}})L+pR&9BADpn%5(mx8{jt^RkE@-8Tz8
zX0J){n-JL^_)4;^sPJo}pU$+625%0jJ-N>IN;Sb2->3D%mt`EM_Cm63v%H}?soi42
z7Wy$GZ)xtOWzigm-X%@o*kL}%G0d-9H6^_E$meg1m)X(dOc$(waJXaQlTBhvzD(ZO
zl@&FZxSZ!j!a_M`y=^`tU1BQn)7Eij(R`*T)~#l5j_ZkS49%wT-?Yvy$hJMD$@O+x
z{}$Tw3+6-0;*%wmTWm$|W!<Z>^C|WCk)G=$pD7j+aM${%(z8v9PegjYpW4^@aQX1B
zsT@rLc5FSitxF%56?op*W4J=JhG!&n$D=su`R&K$ek6#VzwcgC{`J7?o7-DWO`lCN
zxwpo1yR5SE%M*&}oX;-=^<G}k-O(90O+?jV-@qQN9L=@wmibxV)amV;Ejr!%v*6zB
zjn}F&UVO7K4PQMWA+<$jQv0;8CV{~<TCcyj`V2*71uD>LOZ+SkO<%xkmRECl_g+aS
zuBSd<GRvMSJ=F^G@6MYUWccI7<;4LP1}d6gzHU+(6bYSZ`t8WRq;hjpr;jh454;|s
z$)=m0rS7w_-EaS=9l{@8NM)ZV#Pwph{!Em7uBd28k>r{+^4}#y=X#zkDJmXNHY&ML
zykt>hgIJMBliRdgy%Mh+Z%mo^snI>nLtXus?8I(43q|X-U!&A^3R-H)>?>^Is{7_!
zz`eqF*}E&&33E9)YgV3p`E+Xhhnqe-)NR+EZAhGT|3Z~R9_J2`MP2S3a>Kz@CPr6d
zH8{95)HjQENhT)EDv{-impbJ&VbI$rc};TVxS_4d%1x{9ZhKw!c$iyf>c+(9zJAra
z&#LNpTCP1=I&k-E<QA3OJ<GjQ3qSlybute>7#ncpO-92hySCnAh2;$qaSB5sO1|fd
zVxNur7%uT>aV=H9(9*}J@mswytU)iO?z3F^|3lt;$K~|KkN+(dO{p}DN*YL;iuT?^
zNlSb0B_X9qQ&EaGqFvgG6b%xUlt{yf7DY*t@jchwb-3RbeSe?t@B91jcX_zaInVRD
zUa#wVUF+O;=bYD!#a3pgxI^S0Z|zI?<F6d>B?U{k{|;xQH#apkwUCf)puMjUM#^&i
z(x<@3Utc`_n)>)_+2gNiF2}Y~z9%8sJ40SboX-XvVCj#ZSli{8NF=0(C<Pe9DxbaF
zVI}3hXG=yf`<-L)Hg0##v}j4r*OKS|Cm$*N;pLAWPeWO4Ea33a^M>6Xdhx6IU3t`~
zYxtk7)+~-!yt6I*DlbnIPu_ts1{eFStY0)ILc5i&SA1e{dCS0f=Xt|1Hb2w%?{8gP
z7#@6IwtvloLe8tqYk!Qcx8zC<&LKPh$+d92)rDh=wa;nxygOfaX-3dCa9uGwVXT)R
zqmz|$g<6`=D)G*>*sZ3cowNt_G+S1Uny;1!BIRR~V=Shxq~maT*j?E2dB@N$GV!fp
zJ*0sY&r}V^zp=E6w{tu`Cw#b-^&PJtr@6=@bw7?8-R|4Ej31MxM&-tp=i)~Ar2F){
z>vropF1_|t;+VWxv~c$FT$+9ZZFX)Az3j=cMb}LqXi`F)N<C@CY`b>7sHUCS{q_*=
zlz`o%(u70CNr(AmPF6(JM7mF19_4#WxkheN!qbAHv%)1(T?b_}=&Je;#@iQ+yf`s_
z^s^oI+I|Y|B+HxBn<?_=Jloul{YdxW_w6!J&$8!#dg%1`VModjdm<>${CG3wXgu&S
zSKggOyyHLZvH|?iilsm8a_Rsf7Emi87EpVqN8jF2#c~(*b!M}Z=QOhn7*}gXX@+Ts
zrBqut=5dk;y6>$vDbTpQI!8E9KU>Y<=kt!2xu%L8_TCIbW)#P7m|lB&{^PqwbIMl{
zli>m;MOy1RXS=^-WvvqCEIBsf`f1LjuymiZYjJ<-%>Fj{Sozx>Z<8{FQ>|<Dl^WBy
zTqSq8?lE<naV+w5e6N_IZY3A%qWS#<UBvW3W1(=@s=XVl&wJ1pCsl6M34P2|<ZEY8
zz32XwxjV7mm8#tQbBnWH6&Hop&-zLWIehxj;c#>K;cb@Lxi8c1<rjrEolL$t+<WJM
zSz-Ml$G!Y541G1#cRJgiGqX9rZ4d0KpF8%wK%9C=FIebH)P>KbGg?BN^V^j3ibtNr
zUUfHrWj?eznmns@HI?RoJmp%$?!yU6eT4>_1TU0`Wm1prSKqUDZ!*=`woi6DI<I)T
zy@_})6q;J~W_rW!_!BW|T0aUqHu25A=C<+p*lc&ye_?56_vYhEZ<~dG-Kg_4Hr*s|
zW-3$kar@`}p)%V-djdoJkKU-WI)1Be{?a#NyGI}70?bElkBi-)=ek4w)ktoH=gNuA
zulqX9cD%3%dhwLh`b&e5U~=ujxx9OodC!Nc_1mU1ivvm`SUE-na~^Lju%<2BV0hwy
z;RV0Dr9)54)ccNhZvL1X$C8}Z6Uec+eTm+B>UKF#+0ulK_Ex6i?GI85w+_F%#b;SE
zbDR0ehg*q7?RF2ePYkVD9U+?Rv}&Qit=R3y<5jLK72zBgcGhN(ol?+A5X-kJ896=i
zX7uLZF*BiB2J5Vv^l{S?#tY_wREHl(#ho|WcXBPwmj{zi!XCXeplk2C#2S2c{D^zO
z)61*MC1OKkmGcI+e3xZB!!FoF{)OpH!HntXi>N1&Q;%Y{P0eJiqwvaB&f0N7=(g^=
z$^tf}jaJhyVs1qH4&|tE4oM{@_my#{ITRXSxLUC_F=q5rUD0b-xtr<t^A<--5AR^*
zT&!w|*z6aPTQU>NGVUVAa#Xma$j@%G?c0EwEH3SRkEPrN&id?lexr?YmDDGas6i6l
zjoY46#5m?DJ4@K{tiHqZgZF!Pmy5t9Y%Of<{xS3;tvN)Vd{<c3kHnMX2W0GX4m_5*
zoDln7mO1tQ(VIIWMSYJR3E6Vw=)|g3DbkrVqJHPf8~UlY8Fhv_Z<;ZF^58*c@!rYX
z5yIDQDOBcqk@BXf4_rG`$Wz&r5YKgggF$1IL7D3J?1bs6LNSpa<qRHTnN8fbZZyii
zhh9=Jnzp()N4SJ?=0AN&&wY+3WZZIuEHNdn&`2;>FG5Fr_miV9#rpSc_sf(~xt}Cm
zK{sS_rY1J9oP9DltaNmPL)JYzFIE?)ob&$C@>VT;^Q|A<?s2$hZl2iq<BjB6Jv*tz
z?1Kv#Z(0w@tuNSQ*p*{ydemUFR6feN#KI(feTZQyEy>6X$GUudKj)aRcB@(8R#l&~
zF9%L2DvTt@Uf90QG;eZAlXf7-{Sy1p%TLW`npL+9U6G`o_;R#NdHRRy&x*PxZxx-Z
z3x#D78^~7|MQX7PacF(cy1TYEz4P`}Z<|z_9EoXFXD5x5>)ZVl<jSutR3CflEa8$t
zs`iOL;-@y7=u?Rh@iY}tvIA;6RplZozMj5!yoF@AfKF~9=15NBlKIB(>SE;wN>Yl}
zIt-qu8|H8%mH)Wocz0+QnbpQt(-3CgRR0GX8{;V^$z|OYEPChJhLT^=c9bX0dg<&H
zREy;)6lP^D+23`pQ`02N*z}NW@W-9e^2ITB-`*&xnD|70*!+5(MHid=P*rj&Q!r_G
zZcz~}<F|bQVYx2bE-OT->}<MlQ}0f(u|$E*^|O?tt7H!6DUujJdAu|#sH7V|e(%lL
z+r5uDjuju-M)CM!v#3as>UMTE<?V0jV)`5+WEDn3oT+ZEGh92*c&V!Njgg74K}Vdk
zltNk5khDv7NioIYNG6vwHPc8fFWQzIZnNfkz7!9!huP_wMOTi$<d>REG+1|Y-FX)!
zCCbLKAwlI=R?;$JYHITu>8ss}Pi|p&JDIyr<)F{iXD`2W^<Q8w-GA9`)}w!BOZU>I
zkTi>jFTU;J3BSVPaOqOOWGVSNx>MN}TAG{=!wKJczoZ$QTeH<f`Lf_@7ORk`&70rc
zlYeus?9-dw+_E~%I+4fT-4_kj+ZAMet%It3UyaPgZ5vvt#aM-s`rKy8w?@XD{U%sl
znmDPV-Jx6fBdFDL^&0BBqw-#3JP#;hHlN+HDA~5>kygd0(>qdFpUElFW^UQ{-a+P+
zMe$wk-mKu0vAx+%jQiZ9pI%shvHD4OgpgCL?k9s{$|3QSzf=RAjEh3I7i-W8Z&s(&
zFpJW-J$~|RhHC%U+ltzIV$07Z-hA@7PxB3Z)Vp!+n&QNsY!~{`TPIXC+#H62bWIj2
zXS)4F&zvO{sDBvpIq@X@xUa_2k)^LvW<PQcA3L~ntkvP{+vL^iY2*fLqDgK{I!e9f
z_9)$H#T%>@vULxM79Bai0_)q!lUdPk;tKCfNL>n6_V#t*d_JN3fzgyCt>2A_+x*um
ze|ze!t=f@>6!AxHKI!Jn`b;LgxmTw|YskQaEbSTv)xnK*7iC%3D{GxgdmdP|pN2nB
za_=h*vAT#cwrs=Gaf_uJ-NzTY)}PIz^>xr^Jf-jIKqaptn)KrCv*T=y0g_FYYg~-R
zG>;e+hD~J5iL}KX2)N)$8EJRKc2kG1wwU%Vl1SHr1@(8zEO)i|<l80GRo3;3NBH)4
z$W`!fG2eF1T*F{G#5d!{Cb?ghrB69;-J9=7jD7y2zl^%|g;VEN%0<_m;W~N7xu!q$
z&FnXQ<8Z#}-jg@W9wtc^mdrc+K}p`ocSF5rXNN$We`?NjZA4+;1HN{4%@6eR4};&3
zD|khjGiJ2xE>@$s+q)}&c<Ne+qiiT=yOmhNn6&qjbPeCms{O$UmD?V_Sx*(@@r3qN
zjkxixvDmSU*FhIT9quLZt-V|}m3modxFuQmX6cMPli<}CbQ|)?NZ0gIXzVNJst`UK
zTk+uas`C+Qv2MJlo^K)Bv!FHfD_JsIzF?R0^pB-$YkwLx_=V8Z*~cjl@S5#*yRKF1
zlJENSuy`$7+VlZN?WcFW4O8xl#J!-t%}49tDNY+QGa~yizpQMx>KV0qpDVGQdtY2N
ze|S~>P`{2|osggPwM$PE?6SJ|NE8icuj@~`PBU=uP-Mfz-df5+YBh#^Ie`H}&5NZv
zc~>r!@7$m{veD#)n|7t`&N7LEw_P*dZ0ytP3s`?nwE0m?o^MtM&-F6%=n~rI$-6xR
z(jph`&rxz_^jsv(rtCFr?ioGiYjx_C&_O;C!LdnAH%HO8pSJVI)ii2sZ}_~J@Y<{S
zgEyCrQ=J3TS@sVGJ(jvZZKngc!meD7z4;?*Riudi;9iDLUp3h~q+<KaHWqn#?Preu
zMXI+gb>{bV;L*RnZ(TKf?$#p0*uk*%$%jp!FMT!*FXOA6+H$y!d!oPp%QfbDW}|O*
z?RGoZ>3GG?zWgQ{`S}>xRVfPX5Q%*xtO4$)1+JC%us4v#tjYLjCsHn`B<yLhJGLd$
z?d4`C`C*yQ`QiPqsoT0Jj>t97`b`Mu)jTLs%}zP=aka};HZtc3>hbfs1Mht+1#Ar_
zclS5f?FrDwqSO46O}t-KEA+@j*im-ZPcBCH&x7%&T;{S?mnB^aAAd;Ma#weOotE97
zg{4ee?(&t<j3{^Z;a%rlbq7-B1AowON;m9&R+(5s>%QfQ55xW8^D3WJgU_!PsvRFm
z)2Cs2>-|5EP6PgQ&4v93_a_p^roj#g36D*KUuWab`k=9Cu)k3eVgP_lU>_u~6(Q{X
zxpxdaf{Fcki;xJn->A?tnysOy)}~P*#HW$M&N#sH;Jzaeb0(flm7XmQ#GHwwP^1@#
zSfxU5Kz4Kuy?_cm7Z$k&lfXjHsM8Ss?wkYjK7o19kSWo##gi-1bH#zYk*gHxMItEG
zF$L9Y=tVGsX~iU#btux1=wSIqp^ho21KP)|MPe~;2=+zDJTd!N-rx4MXxtHkm1z0d
zC~*G?NP^%4tFHrAQ{YD($ax^QB6t8C{GEX4%CU1mEB>ASPh#YN-2aM&v&?D#R!)$o
zTY-b8ApTC|ggY7j#o>)W$SHCX{K<j;o**aOW%FMKj>!MI6L49E{CCg%Zys{O-5&pC
z;E0@r>u*Tl+<)=qTe$xA&+^w(+TZWs$1{Td51zELA#DGA0L{d)ZSXO)7vuQ;A8G6v
zxfQq>LC>E%HSxWG736~n^7tJqe_{e8t{{JzAP??TSWbj7itU2!zsh-U1>U^^2V?JF
zdKOmTq}agtm;BllI1k2|NdEL&!aRZLR$W1UA3^?4e<sWcn7qph@(L^PBP(!lZxa*I
zxFF0CnEq=7{%2ee<_L^0$AkHE&xk#Ug7YVEju>*D5Mbwj6cp!>tCyqoZ@tU;{)&9_
z=X{_SVV}gsmJs2_&co5#&(YKSkRw`v0B>uz!^C2QFgI?8t!@4MY=enU5MtH1JN}1(
zI5hxa^8Nwf{u!`G$cdHE-_b8%g@8GK71SCF{bOwxY)y!3gNMi=+?b9Q_^*0-cze4C
z`Vf~CnnqpbzwAFp7!&AE83;G({5}a<@%OWqpuNFdfyWdf11GTrIJlP#=Xj3=9NbTi
z^Uc^kNPvS|HE<5@`34E_jo5#jgY^|8z`?z4IM)CWOMnBNIQIY$OMr7>|8bs;?Slk3
zH})UrMF3(6aL{LQUI`$U0N;ZB$2q+9mcWVa8UkS~p>{);G2wnZF!$nm&O#34w-RyU
za)QUNarrJHdE)Xc&(F(tfe&$cFt36H+6RnEoVx;uCDg9(GA3|vhZ-(_0dk-RTm#^I
z`B&$^^*n^~KtEUwarxIo9Gt^BaX%q0|4JO6`N51%yo%xSfP?w<7d9V(1aDa;+$WCR
zJ4FK4Cy?N+tiSm(B_V;2yc0OMw;H#>2L*usKeOwf^#`{b05eDv$%FD7hYOo3!gs+3
zZFCU60Zyd{5bgyF?u2kWc7Z3tzd`+AJp~CbC;n~@u%3d1b75%r^fLa<XQ1Qb5Dvx+
zNO(WN^~^yh<u0H8t>-al1T0-&-u&kG;G)=!a8}rkc>l-sm%xU7fyiG6jfSPM<;`#X
zG0+cl2tSB-9B2pEPfxWhNQZC*c!>w@@dgQ($KOrMk8pW-j9*jZ^6Ic1@q6iU9sw@G
zv1EYg!QXudV%>rCTORts1L62HcwikTmN$j|k3x9UvKR?|Z!WIC6#4<g#sdlG_}^<Q
z5Pk~!rwQS9tC#b4BK!zYh^0Y<{{j;Zmhfi`al1pXf8x)8;M^J3ixTF;IsOiJW`tY8
z{>+1LJl2Z{!tr-8$|3v%9Pc^^$KTOtj_@TY?}BjrorQ-GegXRJ6v8v%d=igvPWaX8
zBEmbMfAE-OxPS0>Mph#7p|IU&5l#*J=OV(d!ST*OzT9rO{%cSV3&Qbt3~?fy2995D
zgnPnceuSIA`U)W&k1<0W!v;(-d*FDNM&#4sc*Nh?j+dVm)>jpgcZ2PsgYXvUmjejD
z3){;9;rKgQd=P#H>JLFUKlD!w!h7MkNJTgvV<Q*g6|lZ|tT?>BIdB|yAo6&5rV(xj
z>-7!cxI7hXA6)-oD9?;=@cjfNZiM6IltB0eD6fEU+^#voal6h4$L$6n9JfmxlLqu3
z3Mh90k)ML?m4$FeIM3uF+zawTgx`hh6#ni$+;5*CuR-MR!~T2=;rKhZ?jjt2m+F0l
z<L~D0MEE^e&R&G$@17YzcpoS*mR=&f5|;BF!d;ieN!}wo6RvBs2;T<%@D<_4Q2$Sa
zN5bP(FdyzuL)c%}BD@10Z$vmgE^zy}9=yNpM&$8#6RRNnEA)>A!V_S9oe=H@$BQq*
z7vOk5hVYHBz3_MA<K?^r=dp8$ybN5giDT`6evZd(!rv{A>+yu+4)3QpcZK?&A^Jn$
zeDxOLym0=RMR)^TM}8qZ5q$Z;5-s!xZr2g&XGgd<Txa<ZE(-l4j__(IuYmB+a9rym
zyaOJaBmB^EF-e>eP7V8K0Kx^K{27FoK!2tq{4n%?KEk`<^>a1CEnvUG*B{((Y|x)w
zh`bl{{~*H6VLzEbIV|TFgg3zYlEd{Mx4RW`JO&5O^P&GYBJw6sFa8d8Tz)ldm)(dw
z{w_upgujD&3=!S}^&CVvIqZM#2tN+zlfwvCf%Q6t@NckxCL!D!&OetBP6Pd1hHznc
zd>`R4&~6XHgP{IFgl~iWAAhGG?$5Q*KXZt@CG1!DLxQ-xE$k<BP#?|{;B_Vk!tr;`
z@grOs+LJ&y4J^MR!tvN_dI-nIg9XCpVR>8-j=xhs5aBtny}}Wm2>p<N@Eq7rG7!EK
zj?)5!<1q_s5Y7kvNgN9Yn0yBPLmcx4@NaPZ4k3Ep!*yX2;jmkgEFk<I?9UW%9N_JE
z6Y5!u@KQKm5yzwf<v9t<xgC+m-|;7f@T<^2st8YpelSA#W!TTH5v~vC4G)ATKzZWW
zFrb_pq1{MC9)E{-62kH8%N&IFLp>!3?}XR?^$5r3!+Qufhw~>Mg9G<JK2N?v<j3H+
zm`3<MkP%Bu2seTKnHrwQ^;;~9ldvFM81gL$7l(R95$+HB3I0xOT>lGLPF+O42ey|v
z!hPX5bw;=-<N*lBV-(>r@4#u$z6apAID^O=z;dP|Tnh4hgwMlv#QQI<UkF~e+(qQ;
z;QZNz@MCb`4I&(msWO4^GB_T;AY1_ICx`t7oCfu!hMW=M8zA3_a87)_MR*XL$7B%R
z3df@Y!li(5EU6(J|GrHeqXmdwhwW&D$e)7#Cyw0$<i}zCeGvIB*q`xO3Ai7uq2G=n
z^7uRG!x0`1`)3rw@fbvB5RU)Ocpl+pa9k849Dj#+1;VM|_1F!B_rvlxBAgBS`6<F_
zVS5cCd<|@`*9b3z^FDEG7@&F`oF``x`C53qgzyuvzSM9W<Nn9rG0lST4p?6vgsa1L
z7e@FatV|&7Mffi`?lcju2HSBz!tt0e4hWxw{m>8Lsc_y1LpUB&^bEp-pg%JZ&IjvN
zh;UNqw;Kq*3+vT}a6A@iFT$%~|9_3}2sqw9A{>u7{1f3yu>a7)_Q%`N3~~;HyFf00
z@LE{@T?prd^B#U(jO)kWO>Tt9cSHZ!Ap8>KUI_Ps<Kh^?@mS#abun&tHLU*yM1CC3
zhu0AP1|C--JQ66x(p`iH!*SP*a1Lm97~%DByc5Ta0aZE!%kvG9pNGfPu>J9RWkWx+
zB0L;kpYS3af5)L1!gb&{RY152Y+pTuUxVY$65*eqyc@#t?-hp;o(%mEiST$>uVjQL
z!G3rd;r`HX_}_nU|KRULzKzId!twhM;X=?Z{w{Z1&n9Sh9FfQU{srM2&_5KgU*LN1
z>jpf=5YCsN92X+r0_UZj2-kz{i^n#__24nVv=Di1I9?7QoY0xE4=058!}<mw9RE9C
zIKq42{F8|A8fZ5Q;V0m@C`R~I*njE~&H?9v`v}*9{3*gu!}c9TcsQ)^EW%r1|G{t0
z!Tq@a*FSn#51hY%>&OO#(*pr4Z9_OMEDwI&gzFK8<5~@ocZKb4jPN+<A3KCsKzSd8
z<A3Knj_?ksCl28)uwBv+-UP=*KEhAKevh{^UN2GDA6gK3{Cchj;drdYmk7sWoJ=De
zkA?Cb;d^1btiiWfTL2L<xGu9HTpIQRK7@xse@Y;H59CS+Pk?^I-))ZjAp^=CMC7wz
zKk+~~1=N28;Zm?4;xTP;{XCGTAoAUCKF>vXCiGVY!uw(SHX-~bY~N0V|Agai5a9{1
z-SO)zyqx&&gI^JO{O?SZu)MfDA6yrh5l#d1^C0{R{JtiF@Eq9g@(9Pj=W8My|GvEs
z;dl%IJA{wHapZw;YiO4^1`Kfh1;|e!^0~0x&mkPY)$S_7U7_73gxkV->?OjPp!^cT
zYoR>;_afZ?dT?CqhULY%HdY6a^buYU`@bW?U0}aDgz!?hzQiG1751OY2zQ75umRy8
zq5f`!FT#F~zq1c7e+%qCRM6iz7lwXW3prR`!8tsM5Xpln8>%OfKsa;*i8K)hvL9gv
zWg-srY=;Ka5zY^}4iN_`R>5{LA>u%f8k9FfxDw<CA;;?l-9U1jNFL~a4)sS7$-|*e
z(3D3c5A5QvQ7b|?{!VD(SSiGQs7K`S`;cxUJP?+@nTQkn;UN(R<w=I}-3U*Fybp5V
z2T(8E4^u?)KtCQ+=Od9kT*3*O7+}8xeFWI8B2eu6G{W;CXCvaoe&8YEKo7WY7$iP~
zPc37T?L-{t5rZ90l86I6GVuCP8sYfw(sD!`=)wDyIuQqYLZKdQg!@8n0691W{^7#@
zgM^QJoO>=~68!!kz`;-#fIJ=169{<)!iypABH}=g4df$49F(UU^7jaT2RRj-7x8(Z
z3KR@Ww2*^C{L&Ec?L_jxKMhb`7~$2BOAvA3XDv9X$Psa%X9~(IA^Z*G`2AvdIq~^q
zKao6fJ32rPvV-!AVgEtGW69v$WEqnrAoAxS$78wxdEjR})gba$;E7IzKY@G@a=iR9
zu;0ETl7~wIA;&6klQEWnJn#?x&iB;_Uklg$^$1smoD<>lkaH1n;5Xc#!U)I5g)HR2
z51^d*ysd?B{QgoqgzI2=K=MYo&oU;#V}arNaet;E@?}uI0^zlgH$jg3nHSDqtwi$h
z(u$B{lt>=<*$(<=9N`Bc|3Jin-}2$Qxj@8$o)9R%gz#X<@kd|qa^iko%|<BJ?{>cc
z<>?Tf3^^0zz;B>l_<X({;air~l1LNj0p*W^dgO@Y$)PORm>}|aIjxB}sPA>C2ag$p
z_uFE~T@d~FSUOIm2b9MVD8o`TkvvpE;5mpqULNAuFhCyY0;v^|?}7T;SKyrp$FHw?
z5RU)-wIAUW@H*`U!dHO?!V=y-;1Ku-Pdnfa%GD7LyEBP35huPrIkE!B=QE%m$m4pd
ziR8h0fv2x<2gnoiJpf<{<zWctB1mEHS|{Sf>&W{RI0tNOaGH2NR71EL)NfD3iO2Qv
z6*zuhD9}$lUdoB&iTgj^PeEJJK$~EL_b;FaW+j~EB783UhggpY5hpIE0ud*!uK^J!
z_L~h6CvF!XB2L^N!iYF=e}lt-(2m6Ahtm~-6PKTxNDp!O@pS-guU$m)#N}5c;>6|0
z*9V}7xcvKx<cZ7A136$|OzFa7K7>cZ<827<hsQe+E&vLECH#5;*Z;5BGr(>sl*j9Z
z%Qr%f_fwqzEA|Y~^RL)5fWL-%@aq&@4}M=b{yhWd_<isA{DAX+#hwBB{}p=%@PEag
z0UVEU<&W)ygzMh~JJI1~{F@6xP8@p%=#hdv9Ff<A{4~P%Lmr24d|f_^a6BeW3c`J$
zo*c-5dm$o_1|m+}|NDqIasQ`<?E^N%<M$X5C+`3Fef!`vasN+)g#etm|34<;z}I-<
zf;-?earq^PIC1$kh&XZiU5Gew`E!XlarwuIIC1%<V0}SZh|7;Z#{oET`TuWX=lpq4
z&(+Jx8-H37jevtltq?`$j}-od<jQ)MAC1Jr=U~q_itd#9EAY-=3jgyY<I2hj`TjTB
zT>m_+xU!P}KDf9n_y6x`KH%9)&^7UO9NQ%%1-L~wup9rz+}Ivq#A6AZQ~)3UNN9e3
zOa_dT|F`)?vAjU%O6A9|Log9SLXW|9B^d7tgtLD>4s2cChnJ}&pqxMsAJaHD#n`{>
z<JTu>xlsE?P_F{EB~Cv7un%;h_QAUGFZ(u7nGoFK8`M5nkN#EvC}>{<X2jbGwGW<0
z{g?ejn6DOY@eOJ}4Lk8K`!}Hde3%i~2lFFpzaC@2K7Kud?Glm(fLID6eE#{s^TX35
zo!F^=l^?$j!GE8?HK65h$4>mK{5E{cIdDIK@`Gzi+&<oazGLiP_VMqF`0skl+WuTu
z<Hrlw&cEz`g!Y@DAg~X9x<&18z>NRPehwUvf-pb6LF>OB%lt3<*MUJS;q?TE;JOC2
zuegH!ZfKteC?QIy{k<#LzyA;W;7<UkeOGAz_X%k0E3|)uc(EqRj~5BVlKEHtUqbs$
zZ~%fs7NY#PUjkRKe;srdES<v66DPd<I0JvbC5Rv=q~P!L`0u&6JR(LCfo1+z`E%d}
z^>t_;lpmBC&ySZsa|Qb@u%T3N!*Gk|$1!+L>tFT_z{HBBXUiMH{L6vu<N0y><tx~~
z4(%(${P+gXj~^GWU|-<CvP2UU1oa2c(&PDY`)w=O$75+FVdsexo*!p-R<J(~?c)n0
zu>Y@EK0VMr8jC3r{_eK^KNppM%8wUoXodXwpt4w^#|4)Uf7c(!AMpI}Jie*fxV$HT
z1GvTW;oC1TKO#ml4D+KL&xdpHJTDb?fNlPhUc&q$|Dk{Ck7Mw?4CqAjGXiI0$p$fq
zwjcQ2`Ct8a9Ns|PM9@M)=)Yh|!}H_)=U=u#7N5<_8M%ORECE0MYyJS!6P&7m*zc6M
zWqG$5DL-;Zn3MmNKi_gWzX0MGG{3NzgcKK1`hSYWBrYYkOM)Q(Kaa)qHR^Y@NE8UW
z3fOutiiNfL6|iTYMl2N;0Vja+R}>>wR*hJ75UU3qf=9XuF_c0Xm!r&J5qT_@LohAJ
zIBNc*mawO2>ZHNo)doHuDDHP+@VKM+SM(i?|HNpL(unTRh(E^5$RJ3;3ypxo<=sZm
z$ePh@%STQO-W0r=(f1hEVg-K@K>IsB5EckWGuoO__ta<rwc@Xnyo73;`hZp86sQ6g
zG3P!undwA-(~159ZD2v3q#QK1QxJkh1u|iAZZveFKjLwO6s`XiN$7X19H0&AiM|J7
z>--8>GY%YZ12irnW{!iSe}Jo(ZGfw{7m2@jpr5@X2^P9ZhHH6W28-h)gT-qK^z#6_
z|2+lXniJso`y9}_&oKbg=FAn~XY1wf<mkucWb5h?=;z2Ku+?G5RtMp&4uZ?Ep8{+>
zeYm{6Fr8dM-hS?me$Wz7f+ZtIEa;R!(6oFO$k{pC+XnhOa(O#(`8oPH+6I77QvQFL
z^2am*Lj*lo>Hi4$VS%Xp9Jrjkv0}M;5W-jmxdym!xf1laVnMCE1HBw}aM=Y0a1pr$
zF9Igu73ksdf2ViZt$(RB@v_C<L&O!}{in3HTt=#jDrTUr9<KJb%MrJ*`U-6I$9(7w
zs!rG?uFmfjzzDq12)GY>-%o(8m%XDua2xa`A$HgA7775C36;V=gwSMcq^P$~P1Q)q
zSW!tw6+H`%30eO-p{l3y7yB>3O%k>mr@k<p1Q(c!roY2{MZ9N=Jp+CuQi(17j%~1j
zP^V5}(kihvU=F{h!b`CVJ5-E*q!Um03K3gMf$`W#@I#A6G#1oMC3-S?LL+)kH~N)o
zJjKpGF|Z7<7*&TDVQ8%70fG;c2=H~_fVradbSRa|9uHoMkUiKqVIvxF44V}Q#(}f3
zvQT3-e;0rjJD50vMYw`7$5i8KcVcn0G-9<C6r;!gH&Mi}(gHIY(ZluNyWbyk%d^;D
z^A{EgO*8uYa-gv2IV?058x{|ZXt-nZ;vSt?18SXE0bMMjmNyoZEI>vl8iX>7p4N%(
zht<Wzm?I7gkm`USX92<3WC=VBVtD<jbTc8QSx>-rSWC_5XUoCG8nMb^G3O+gGc0SI
zYGv50^4lSzO}~Yq93juLC|0Dv)TwfUJc#Y38LOqB8>_1z+N2w+%BUG@#ApID{b{)6
zoS?L9qCGm%V>;1K6@P_;PJ(Sf>n{t`V*r~*v5Jl<{yGIZ54HhqvwZphVfr(lV8cU^
zk?aGjN5p%^znti(fjJSxBoo$%R>7PX>!*Ot<{Ht=_!<z)%nRbjQU3}jbV@>5fI~E5
zvAMq~V5>$n1t#DFaxELzh{e{AFwkr6g@KY0gd<uQEr{C~4g!tnANxdKU<Cuw?m+8e
z(e5M&D}hdQ0El)6SBWXM-!bm6n1DLcK8y^>O$;?nq|F-3OUiO&z<4ZH-EtwYm~p*G
zY(NIA#kr!N;XUua>k2+Bu|D^wF|gi;McX4Z|8gloRKw+k3OI`m4+MwBq+>W)gw=D|
zwr1=tUQn0c!3?qfg)_9A(ao3-#RviVG^7OrC^e*Ar~`Xeidb0pyZ>T=43~{fZCLJK
zgud_#R!Rdu`&&#Sx)p1!z-NB|)}}<k`_^L45%}Yrzm{D^W9SGhx+B(;8kd`u6vV9K
zLY+bspb(4O_-D+5c?AMAkYj)~h(d_<P9<zWYhhb3jxo;&sKka5X1jO|Y)V^Uv`iH`
zCF(@C!?T#!@6tgR#bB`{{~aX|=_0E^7XcmQznufCEbN|8&GMYJ?1SY`d|VOcY2p)b
zpYT39`#?WGN3Q^Dd};Ex_IC`hhF1{Ff^fW$oZ$ZN@!^cjXAC~feIT}<<#a`D-A&7L
zH%HHDbG^zYH7288%_3n=c{xXRku!Neqj7!=wPBCwch^?>e9t8IZN>#^7oW!UiT-re
z?KrTH;;I`<;RmiYMkUPmLVJ07)@m&*{P_9BOPI9!5pC^K@Y11$ABzpOGvyTnBHtrj
z**mS{zn_eI@?F($Zq!CM(O;ZvjQpNc=N9SX(zK7}g%9?4P`urnckS>A%W|KscT-jT
zKC(IGYnQ4<>YSTt=&7C#p0;wN=^2yPa_Zcj+_5Oq!7;_Rn8z&pE{n=eRcJc+pyzYN
zF@qgrM~knx`)8zHX3ZYEYC!h#@JDuOM*c8?Pn)?EGbjoTtU5$4aXiR%E7(w&HET$h
zob8rNW*qb2N?Lx7S<jnWhc}(~ZaXApu5wB@IaJU@LvmlM)8Q-r9+$KpT~5z<!?Del
z)pC48sKWV+Ph&g9y{~M06y9*=siE@2aG}ofcn(|2TA6#g#zK9H@wqYuhQ{k92dZWQ
z&J6XkrBt3S6fddGT=3i-8L^<&t-X5cL{@;XY!s`3ha$O)u<S{GRl2F2nn`kJG(|L4
zF)=CVT@KjAB=5T}_DT8us7k+Mk-knX4<rYdlJxGHott+!VYsuv#OeCrXZN+?EQ?*a
zSNING%#Kd8Y5cC!OHmXqm(3}8$1Nv@jii^6{Dirk$R-1Q+V*UrwaOW!5=@c`F>H}k
z5?jj-R&-O-Q@#82z^sYKj^cW9{wnh*!zK<piR)+B$g9@cpU_p2?N*E<mx=Z!v1&P-
zlYW8ZGvgTPo@h#&^}eLnPk-g}3A;eOfrsxD#p&p_3jtlC>uyks=(w#pUG3&(z$02%
z&%4RTk58xh+|Jt38Yv|n`4Cq9?D?QhMml$$rS`=X%CH|(3QqLpq2!}XLnO-0KZO{1
zj#G)~y>|{{`*bu+(O#a$m{FEw%l)6^B2kCwZKR&RI3XULNn+pebBhoCC!QvSN^7#V
zb!8-RGD{{lJmoYt)B`t96tuXLym@?l;|0a{@wZ-YNQ>G{N}1QdVB<5egzbcoU^_D;
zw0cXjVRu|NWAW?0aAP}-3?fn=7_jp{);7JYk|)J*qX)YYCMJ%Z4V_-Cw?t!n2FpM-
z%%evVXS~GwF-XU^##ZUHK+?CwS;Nx>VbSY1SE>eI%i!d*A!S`laalz!kxNN|Wi6#!
z6t#i2%84VF8C|$y!qhIaX{`0li54JzxAtli4-e^%tq)GHIv=A8q}0D7Qt+lONJ^Q?
zUno@f`@5I@_hzbxUfyi;o6`?o)Si8_dwt{a@06ccKM4uS%l4^c`F=#d`)KI<7fH8k
zf82W6f6M)fFl)d}z4K$ik$mZyIji>>8S!WCH}+L+qSLCoy4~VYIDdF#(fK&KSaa1=
z0lUtne=LZLyt@=3^Xnu})Miyu8&QjW`7Rkx_}kwt_H$ga^R78C@kB8wZA~j_r~D<R
zuyxw`%rE2CYLUbjd);uU35ijA;27AvRW4Z6sZ&Ky>XV0t^@g1Z9U(DVy%|@jP0hZZ
z;q$iiI$2cm@b&h+Brkc{Hc?+c{7R7|ul}RW_BnRCev*vtyUnDXwy!GZazzA>(cIl~
zJw@YF2V?0er+l^7rF?zTH+JbuQkv%%#`^3q7)xp3ICn=OUU>ULhf7YUFiVM{WHP;9
zm0qCY*?e6|Q6BGSxoNbX`z2q8Y%Gk;(d%oy|NLrNxcg9{w#dSK{?1c}3U9CaV01M{
zwy-0IywJ6qyDwn;x*O}=`3r9J0hW@cjTd`s=dWmns5hqdp8xhd_uW)bQvHJ;K6a1!
zgyQFiG@H+nirV?`GJkK<)Y<8M&`ITP@MfER5x1;w1XGEsZCN`q#l7*?s!Ok4m8IpZ
zSrZa$yD_wSmE*!`$rzdk_F~oo=X`YnRa9vs&gRE?iVx0&DmGq_;3U75Bi}?KoL`uD
zx%ax|<I3zkA$0-8s_IL*J04n(C48S*=luEDNRjQv5?R&9+RklNyB@plck1KJ^m0tu
z^_YFXlk2)nSI3m5$7WgOoSB}_D=5@PRMVvruk>czh&#p6$8uqfn~A@@QRER8`>TqQ
z*;mX0S(1%}US2Q}Qeht}U}bsm)jZcc<5o{_vr%7A>|68L$@;tbaYlXf-7<Z22I+3A
zC$DP;Zt1;bP9Ip9c4=qdBZJyW)_nD9vVj7(Xzlhx1?Ik<32s{h6sik#+yXQLEzTZO
zVkml=@?h*^l-ox20ykOpf=T)_JxY^$XN*iNEcZ916mE<uJRTFwb*Y}S(8%+on{j%M
zd0!Wg*tSWN1qHgorR$<@#zWph0h6glfeN~XR5`(gRECqPh1MzUZ1o4{4LqVh-z*dt
zkhU;puxBV&o8Rt|Ik`4pcb;wdx@O-h&;7FWf%#dlwTxRslv86kPv;ry`#ToC_PV5A
z%`#B>`nYXg3}<Aj$)M<aBj1jX^=_Q~<=dvYhK+n_d=;uAw9WeFEFTmed}*}5b*Rmj
zrIu6Oc+h*pKHp|v%X$7bv$d^1)JtPH8MRw=)ivgwkJA|sMzk0Yp5!$SeXFK5PZ?xX
z*f6M7Fg$utt2*JRf8X)^gY&zbdHP0f7#cM+XP%q1`s}1Nzo}HRfL_Vp<n)cBrVU*m
zZcdVqS{8m|blV>yp}?9URG8pfV$y2W$<b$9{QYUc&*%)#!Y$pDea><2ePe@01!sJl
z%f5xDZ|n1I^EzuQNi|e5_qJ22@(ah#^)!xq=YAb|cvpR}EY2)B*<V$(sVt8D&FR+b
ztWvRUN}Ag;-ly{1emVN7<GnL8ceUL05#3K67i}A+zCS&_Bie#)x5eW|awCpLomXnB
zj3U#5{Td`PEu%+SoNNx1W!UT93O<+qaE$(Lb=_J`Thhh^kB-+~zA4)5CnKvRt%lz<
zeLK9LE@r#Z#&hA>XI;wgM#+h#=zNiCpY0NkztTT-cY6E!9D1srvX($&UYTCn3=R49
zyF1pLn2D2Tk4lviWZHPcS)^!PK6T@{&bg$f8wZ0wzC0K7@MAAiEz5zpDT6q7?TVNa
z+E>YEbGMkL+$eDAIXC2_GX0FJ-Cew^j!fvQ@l*fr{C<Nkn0!N3vc4F7a}{vq<#@&~
zIBS2PVxU=4{QhzOUw4m4>}J?08OOa_nsX}h%;9(61QtepS6_L2Kds}}xSDmYw{_bK
z|3^n=KKvM57j2L&y=A<^a!Ob}yIv;kcu&Y`=c1sbPZPnzROfdbblITzb*yT4iUeo2
ziB?U<7vq3azRBcjzh(!M-16R?)_z+p?$22)PUYAr_hV#f`|GTu*Q7Q040<yxGDbQw
zc00&_y4y05b>Y0{r~ZzohXy<*X05C~d_N$hN7r%kW@WvwZGFkE>J23|N5gCTW=+{{
zjveNt8v2o{kWKx}BJ5I0XwNh6OXVRSGK(^w4xfJdr8=lYZ92k|D!Wi=uH$xvl9*%0
z?fIEja;N*TneS3foy0m0XgQ~>E;#MofyK{Dt#j`Z?D_So<+Y)%cOQMHrPb>yzuXMd
zh6yo6dcm0`iHllY9l6d6tTJvE`_)VOuhcCH>~VW>*jxSl>obB|WP>#LJ^J;=Q}mu)
z;vQkNve}#6cPh{Ok@DMtw4tK459u1TVnm-!@C{|{99^f$Tp{jG`)<$H$&B|OzKt8b
zu}yyPL-}yP)}@n{3k9dg>BlB&`OR8{-o-s!wYcH?-u8D^(>siBO{BH$_j=^^Hug#L
zr8*`Sm(1>)WF<+rSQKv7cFxw^+?Qt(G8J%iMCOOc_K6LPW>dE$*UjFqF28(lUwCm^
zS>a2S%E6?cGzC&U&ff+&$s3xDBcHk7@;LK=!@8$|>FE;@Z%Id4<LNc~f652-?LYoj
zqGq^V>`IS#>4E8vhvxdV!DV~isP5e3xhXxzGxApyn+<L9L1m3=d#YuIu819<^A<6Z
zY~Z`mtKz*oM|t1AZ#q7e6_h%k3m0kPpNHh#xprGK)p_KG&nK}rF;Tk@Rt!u%J)Y+(
z>^gq_V&s=HF)vZduMeg5k{lu(2KO|!%Q!Bj%9gUo@+G7<-*dcOLnWo-mub7XyL_vz
z+<vM@EyarBItlOIt@<JA!uNDxlf*jy1rF|{3N?-ThZPiQ&*jClo=6_O@}N7Y|84NS
zk?GGjx1OGxuCJGSVmI_zZlmQw!);B@TdEr(PM_JH9GFnn5T9N0$t=6XrBal;h}HhI
zsdLzMaem{GN#>#>x5kv_d4-KO^;%6U)@$yUitab|eJ|;xcJkPR!RQ^CrYSz0g#jOH
zOFAtRTSu<s)pNPGrWQ)Y7b_VTPyY}tRM&MIJeB2p!lL<+(a86!YL8A0@7EaFVcl~4
z;Qfx;3*vP48@z-!3e;YlJwtj<M7y5Cxn!a;zK4IrW!FQon$LC9bDiV<cHh^tB=O2D
z|2+@;DpLS|n8&~09M14Gdal<j!kFRd#^J^xKxyR9;$M|<O6kVH8b<w5mer*4cc{2X
zndDbx-y6`(k2w7K$RX!LP6a2pIPPD%m0VEIsBqOdQ6cei&k=9ZKF^<K?_wA=SVYcl
zQ9V&S^q4b5;B})9N6$%C$-0-1$R|tNd+R!S#nl8EPm(LM=Q4#3wKer_e7_^-?2X7-
z@2b^;We$v_PfY5?BwY&&{C4nFd>3z*7f+Y1e|qXdsa~Ik#e0vs43_hkxz34kvJX7i
zU^saw-L%*x_rxi&)fUXLp)EDEF9PrX9M2F~swGR4u(;{kAk(ILPhfA`)yT{l)$;E}
z#$RcQlRM0O`yxMS4jg&*CHj$y>C!ECGq<p{<LlG<V^wuB-qt+!z3BbrW51G3>~8fu
z4a37lK|;rJt$Ft7FwniJNv~oNWUopcVDL?HVyjNdV<)?LZ1=74;jb=XKj>>WO08Qo
zKhk(d<ZNGPzCc&IY{I*OsV|eiBs;9XJ<Bqk?$l%-Z)Q4rtU#-ZZb9PH&gZP1`}51D
zCzkfhwdl{9$;pt8wLfc%-4y?5mdg6u<^ps7%!rl_PPQ|T?8%RlY`bj-Z-~X)?*;e~
z4@>y*;fxStU2RT7=FGX-%a<;(wS>8By=<Vh#*SMs-`JpHT+Pjn$^E0d^De~#)qKiU
zeSrz5L4h?J<ypNf>jkK-@(&ag6@R0t_kUGbwDZXDLpJ_5&&+6NZu<{6EMy*?Su(le
zdR!=HC`2-drl5~!i+lD1Wd~aQ{8yX&?!=$u^bX?=j<C2O5gaQ&_|a~+y}_==*{KN0
z52Wl<d41VcJA@BixZS+<grONz`rX+E!J4{Hi7#TRJY-i@%rd`-N#7+QKphrQBOpUp
zcfe>d<vRJu`*YkuK6ZIi4&N?jgi^7IldeCYfBh$WL_?H6OKAN2D+A2!+e!x>6u%a~
zRk!hBqx~wj)a@eAUDIVt7dKUqPjZ}K_CEVS^u(ZpsuxwknO9R!drkVU(|5hzCF0gx
z&(bNRuxDd!<Ju#`bQ0Wx>2^xl0pzw>)asr&lSML_XLXy4Cw%Vo<Qn7}4q}%)t!rI2
zzZw|6(blyTZW<gTvUs1lY`4kv&)X6wo*!E4w4uF{F}PL7{Na1$VgG|RHpz{v*2s@%
zhSK;|TvZ<TcC?G?VDLDbvA5~=%arsbCi{w+qU%TQuRh6UPiK)pdGVUYlY1X0Mp8ya
zALN*|Wr=){Ef-E)%x+O#vv04#Dfy=IA?<6a5)I?M8k2V!t7yxe<73`ReE8sXax(tH
z@pCoVxfkQBZL@UhyB?OGZG2hlX1#tk%ke-PgCr&6QwM1SIzjdgS3NqOh0VON&K|Vk
zH&D<leK%)PxuiOnNPfC^!Xf&3hVt{V8{y--Mp<f3lHF(SyEj~Z=N)U-;G^?S_fO4S
zKl)IS#%SKA*WXKtS(v#bE`A-;juL8_HKR>O#>>af^`A{W^K<8mgt+ufo5Yq=X^}Ls
znKjR|o+R3sFgZ_>?yY>Lnf~GN*y_TJ3(lJ#rm~2?U93oFcu6}YCEn5Zo<F6>q?nD*
z;TF}pWA@u;f`luJ#40C~=gzy>57rE89k|iP)2n%UA)7qjsKF&J&)&*1Fwo*#;DX^)
z=-@!lB2oYECX5E+@v!GlY}BT+q%4*yZ`?0^VqrI2Jm~U$zr=i|%dyoG^CR7(s@-32
z(LN(3G4G(b{U`sqzw}MnFULr=A$elZbhqij-B)c*^l$duHCxaAN=Hb_oqJtI@R~aw
zssbNWM4Y*pk10pRG@0F^B^lD8#BN-|$7vM!ivpJL<HH$&#(VUQ4H<9ycOGxHVh$d(
z;$<9qYdgA?vFX{47Na0TZDEQMhoGxQb#3al54G&KGHzeD`Kn=5bbLE2Yg@Px=kaiP
z5^bRj=^!(uLk+E&;v)|)&V~5D8xB0YY46C=``}G$e@H*R7TN2sp!PaG;ZmIIjBLzV
zn(>aOLn<MG<44p@e+8!7o;Dd|-*jI)ErNEBjtFTJMMo^xbeKFzCpY(Slyb+%R=;6I
zd-{RbdsBIXH+>1{OLUPl|4b%&QQS)8__omwMfRbJl9AzOYPB0_Z4c8&9MaU&yJXFi
zx%IQPse}T5&;z?om1NF)lX48KIma0zGETBiTAps@I9RrHrL*x-OHJx`%}eXQo?jhY
z5y{DRe8D*ACB>YQaX?1XI&;^xB}OqRbR0E5K2ClR`z}Upq^PC!EUMd0fBN}p)t9Bo
z*V|*<)7~!G)VOoV87g)R%AU|V@m_as*VuO-)B2-YOiRXB&mHbAY2DI&MPz$#_0tk+
z&FK@~n@uh6u<Ers_H2{PPpjN!zxoT4i!A31hw!et^Npgx=U5k(lFsfby5_(h(#h)f
z#g4Al)7z)B<okhu0jubIvw456JrZl3&cD`DbvQ?R-&DM}^K8$T5owL^dxf{|{S?+I
zxOuW5Pp{QsFiR{?WbO|46H%j{>GU^r??;|+FF9-79#oLaI$3-C!K1qxq*pfgo!0C(
zdPg6rY7}tSY0U*IU%{4w>zW<6*G{|-C5yjfxoXI_B=O#m>35+V?H#PP6yo1ihcDm0
z-#<vgTG{IKX5mSn<er><kyYJkYra{P>a&WunVt>4Y_0r3sw6wM!~6annomLOZO!Yn
z7PQ&AEewJzqD#Ff=S4lvAAjz<)05}<nN6fgY5UJtrCXetQ0qN8cKo6LfS@&H!-MVm
zj~lPt3_5Qp=agI~t|ZVA-o3g>cu@b%UUiL8{#-#C%c0aYrlTs2qhoWrXDoLg>Dq9y
zCbHXq{kgIecBQ{adZdEN|J&b(;k_V#`hSQSQEb|z%;$x{7pPRPtut|GzuLhYtfa`x
zYuoyQEXQ%CziWb0!Kg;Uq~Lz8M$Y4qZ=WajXDwY5%zQ7i@BX0M+v<-GGBZBM2i!P!
zuT<_??P32iodTLy4}VpEz8mb=aNnfJ@6E{Qr4NHXCTu}W`y0mx_FS@#Pdz;NCi>~F
zx<h(3^*eP!5*H1}_}A8~Uf<Ju@WpzQHQw8Vy40<-hiNQ+Nm@9}F8R$1S+t*iex%-V
zN5zC%>F%UQhc-4c`qiBLBy4U+<9mHu|MiZd3hDdyZ)_OK#4dKFK52KVvAm!6R++DI
zvo-&Vd8aR?eDdCTBNdN4KB;Qd%}iQqy-MqRXMU)LxvgDkkGI=f-F;MBLcSV!TBPkA
zc21S7-n;utZi#(m=hLQwJ#VX?HK&U0v?ws0C@CDu+Qh5x%H2VEM!KjXxoX$Q)&<wS
z%F~|byAtj;R?EEq;A0-_lEzan^nTlXQRklb?IWMFY-w)qs0n%^|MSMu{DSrIA8)OL
z7S2~Je(I`kPd9({AgKE1T>hY0>f50oucnVLPD~FkzV6yEGdR=G_wA=DxgzV~COWnY
z+0$#SyLNxd_jJ2eQ<lC|^Z9GUG0od`L22?Er)9gYDfKT!4l;VAd~5yKPtJH>{(LEi
z((CHxiT*2-8*Xl7GrIO}_iWoF+xvUZ_a+s+50*>UV-vcVQCguH<vVP)*W!?gkj?3R
z{3K_t@b}35^3<XGY+_#5IT@~WMJu{b`j~IR{Ac$s*RO`~#Znz-`MNWXZba@8t9aeT
z;>OjcMNc<!3cH`We(kz=)i;`bQR_V}?hW_ZA|QDyQulm>`?0D=mhW2Ljrp@yDl%%k
zA$xtEb)N2A*a;Czku$?*vsWpFwA2M%y`9CSpS0O;F0gv=_~N%)LnjrI*BniLuqoi<
z0iCgPWC`QZVd}%XRqT&#yIZ<JRO92~{oc%auYwPgX*ag8ab|t6y4N0F?43aU<U~cB
zErU<e7D|h<q(@t?hu8h+Dbad->vj4<<h@?KU6pxJ3ZywU_ODNEQoECGWx@Dqc8k%p
z%)Zy(MH(r_!(}H{89rXmE#&rNvbj7gifxU_n8r{`+Ug%&bL|pGA7JrrZ?(i{`;p%&
z-AtOb=r_ytMenKZS&<(n$-|xbv&WuC<fjdAmA6ahlTtafY&`df@=Br#tAl*^g}v#!
zq?sk0_NqQ~^Nx?a>FAoV{?j?Jn4J+nxFURlFPbDgxhJW9&d;oBV0!6m<XoHVNu{{$
z6A#{H9P;Mmc}$Y>>B^l~<t>5pUv);!OI?oLXll4Ny@9@vWW!InUMZ963YX66y_21H
zJ(5OpH;8mLcNu1B7Ut#@e%DA(j*l_3E->Fn!WaAO_Gh_UQ4RKyMe}vS!okIFPYnlB
z-8rpMJ4v~J!Y1@UWNbp8Wr-I{-@W!DTllk6iyl22t#H+|+CEr5_g+cnTa$&SeS@*h
zOlo4Far2Q<zh~tXA!koUZ5UTNE|QTLA>8(j{-uVc{$Z(S*WAyZmGsQM&s#`+gZtXu
zN8%6Py)bE`lA73kh@&h<=4k-076*+fP2P#YEn2Aw0i<a{4pSfYFnX<@@<?h?h|>;D
z`FVlVwVnU*BZIvH;@;A?IqIJD>M5%(_8+k+s_|9UR3ADm#9w||YAQ-Gc6TpblKSm<
z<HJ+mU$oY?&Mqk#IIcfSo+;%zRLCUCQNFqCUA>j#-qk{s8X6bRR*U>RbepQ`i_sMM
zMZ+FV=4YGA`HDA3=x)-Nw0YSei+$VP&cy6}$tH40aJA#=Nd-Ha=kFJyUY_2za3=hD
z9v0wSM9-Cd`?n}=B|X+7W%YhinN_^)OcS(TQ<}5Bd$JR3^s;Ug><?vp?o`z0SIwGg
zIG8?gW6QY6jT0R%UE0R_ncKI%VsmR+_vU8hi8Z{tn$k^7tx^=Zj^&psq?t<od{x8Q
z9qp_Y(e=`vd*Q0g4Sl=Om)x5VNS<Mz<a;9PFvpeiYAPvlqp1F;0tN@_V{y6tRQ0Bp
zCKJ!R`?&V|hQ^2UTu1g#N9o_#<)eM)b*<_l4Rbj$@pOqyF8jB8m$s+pmA+IHso3nW
z;Njm;8fxbFytykjl4S8f7|GE_N-OcNR;EJSTvTLXZqJid!}&v4^wd6><gU_>KEZZ*
z^h0s@W*$0~HBCxs_XA%3P?;R1j9#N!=c;vf_AJ{@rhWA+`*#hL&ofRW%JDztDX+id
zsj9x%=_s@zs=R+nig~j0>5p<AxghU@Hy!M_oAR0W?=z_vN&XVC{@c^jY(n0JO=7;=
ze_9u&D!1%UWH+|t;WIjDsH<;qV?dg&CFP}jaw4_NQ$t0)YrJ_@;kD9b1&n9!-1OSa
z_$z_y^v=uEX4engxZgMWlTBBwr@Oj_l~-!gQ)#iwl{AI<sP5sYI;M3z=SJ0K(*_Rh
zYc3fT=ewg4%+$r)7@45|>dnZjH?<!>-AtsXVu`M}Q2qSwi5Iu^cReX%=n%Hcn|$rD
zCX|`{!C;9WqnoP7`*pIaDS~t)3fuPd*K4TC`gN(sHnsm!EWf^Ki_J$f<rB9G>!JnK
zUeRr#HmhsaEz+b`Ilt*uJWs{}!9fiM3$gE)r*4!x(d<~FmX}kT4E?I7Tl~l*r}t=A
zmgA1C)gg~5#N~dPb?#fJJI3)<kcU5aAV1}vpXc^|6GlpJiHqEekq?^;yY5}<ovF8R
zvbGwOxwdW1oq@f#RsA_5*NrDsd2WlEk^bWQg<O-FjQK*;)ZE!z2Q7QP;Ch9a1D_Wf
zM!Aob*6Qmg^>yWbh?hU7qvmw_7+ED(4)2Tvt59tDx_r;eN7Bwjoe$A>Pka;Ykz>)U
zp>$qg|FcW=;aH?{9WgtdSGHv0-IH5Q!<f!m&RA?ZyiS%u+TfewO?tX3eZQu<H|JgW
ztW{}TS1KUWEy+h^#jxRvSL~zrf}GW}<?A^*Q;vN0eJuErPK3TO%<?k%ZOf`EG5YNR
zk4IkR`&=UbF!w-_gMNG)rx$fuHkah$rE<^06rryoiyD5r8RZ^H9NiRWFLT{PWM1}o
z(z8=6icWX=()fo+jyh|HoeDVZVy>oErrTDM#~JYKS%hmZNA5PqqcN_@FDuB7>1sdN
z(aU4(nGw}-cC?qPhkiz!|9XwaFpaE9!bG^ruBIerwek89{gRjW=G9uH$@$e3hC`1>
zyx8fQQ9$My%YG{1kf4U{wdwK8H*dA?H?SMI`_h(#TXM~@)wkOU=m+lk9?X0#QWaWY
zFqOR5{_XlU&%}oX!5bEMPg<(oy`Hq*mbc&DGj5Wa@v_Fd_qR>I<-{1BPqutVmgJjK
zdE!N%Wxx%)MtY+t!!Rwy_p^L1DV#O~@=dnWW<QD_y?UnKvcz?6&#!{2x}E&@=HGUI
zTTt%5f7$nPOvrhDj}zK&wYhHOIxW^+E_f{arsd|l^8rt#&mRuj|KXGy`|OpX#TnAM
zOX)8IW{QS<KHku%vNtF?<#kDA=d7Fej-RJHi&f%gRU^``6{eDH>oMb~_qoTE*^^Mj
z$f3(Po_UcmFoZ*D%j2qHhjvY0^Mo-&ULj?Hty?x0I`9-ry)=E1dT(*|s4(?`uFtY&
z4BvIXeBPTp+1b!4qgMZ7%Dn1<^sx}bpU<p~e|br$S5n!y)eTW!dtbly{*3aRqT|6D
zUft~p#(S)-?Tb!Mr+nJaRuplqgfleP<V>MwpzfQ-<ON?Pze}o-!()^c3<C-23z^$o
zKTC6DW#9Gr5aGQ!b^EbW3Vrt3PYJf4#!9|Ep>h7Gdgq-g)%J)sn|0j-hP~wdpEb18
z#Hw#HhL?Rhee&zR(<*{9cHiZ_H*dDxe>vi7U$^RG8#jqiZ+c&)#Y<dm!~M+VZynnE
zll1*~pRfjXJq%T;*)p1BKGAXDyQ=V}=D0o9+cF>4Nb6SJf92=R$@tdru{Yn+V_NUM
zJ2$kbjV}Z<E9dL2W<Ne#F}Sm$m@DN-+4r&^Iv;m$jcw=o&-YK#zkU}iF?{UR%tia2
zVQaCK#RuDgG8GDq*Q<0K(sw-XPv|~0seM&%;K@ekC6D*)*r-}7ovfy@CFsnJU3<<;
zt(#wzZ3&RtX3wkEMOP=d?eX6IvJ<WX0iBy-+VgV^7tZ{w+(i-|?J{5FCskQ7rzzw;
z_U>45jAd|Bm9Z>e>-K$d=jb#@IkJn7wmniVI%2=6Zd!l-_VLBoS95O)SWjjTrJTR)
z-7)Yeq4bMLlO5^RO}p%@QlpEL-q3O1*nWLn#0tCb@?nvn#)*B@X-|b_j#M$Vi7HQM
zp0VfIw;}c;i)%nH$)R**EgSE%^xsqDgGIhwvntEZj(B%z?a()EsuT;YsVnR=r;cWi
zteG0<wZ5I0*X3Xq{-v(Uh2q&}v7_GW4i}KfACl)%Wvl!j2N9;gyv>FE2VeV%V+iBl
zfAAQ>_@g2Cy8_S{!r=B__|=I-5!)wGqi2jD^J=E2#_o;54y6FY(qr&}MeI!=)1hZO
zL#{^86;Gi`FA#^t1r~{<RH2uOpi-d^BPF}AhF%IoSdd>V{4Y_EUtoXv4n6F>f<PA*
zlh+Y5;)CsGfMYCigTiYA8(79OAbxN>g%YrV#Sf08R9v=UKxRgNK$YIcg8qOay@3H{
z4m*pOQ>7t0Krf})jGbu13i1#u$s;V@a3>bDxC^rh>ct2hr3JQFz2bq*IPyR7hSlj6
z$o3)8g;i+C9OyOnVS$Vf&}*pCD_~iH?<}FNQ`kO<BJiI&Jr~(gdPYThY6T1(gXg2c
zdCb;d@sTlyMNq0?YMrt8$jX1kM+W6>f;!k>dH?c}9`KPi@R1t54cRc}7v;bFqDVuC
z4Gr!m1nCR-z{(Rxra{jZ31U4*P#9v>?pi~Lv5eIOi}8%*!ESjYQGj{yegwA0kio}*
zfVLGADE9wJEM@Q<4H@C7g=LkBM4JD<i?IxU{3g;3cFBK7O#JT&auWDr5F#vr?UVi<
zLCbMA@zdnL-!Orb<t_Q|h>j@7y^C_z{{ncla_nW`y}#4SF`57UAPYGmD(S!UaQzK2
zLQcZF0*4R!A!o^dzd7r_C&)<z{|m4qc>-DUSIejn_}}fQ3FQeJq7OYN55^R6+DAB`
zAxR{L*!}^?#}RG?xfC3i_-Q-H@pqQu+!=Cw9OHcXuKYEG_@+1mTVKM#8WQ~77Wla!
z!VV3|SHx}z#=$s6QxXRL#V=r-iRg)B!u*c0$`$1At-!li;QcG`mn-nu6*xIoPp02b
zB*C=<lLc$Vzv?AUkf+5YmJ?x3!FCl^kk?y*gE{?Q`rTLHkr-zpnjZ-33TC%p1^JsR
z@BxCJKb8q=3Z@6V`{NH?t{eCSPv0<M|L{auW3Yo=82^{N)(YH;py$v0Ls(}pJz*=z
zC$GSZR^ZJm@aHS=4;W|q9pM(PRaki#vFl2v-%srRc?S}Ro%pZ%$`R!M%!l||1!5Tf
zOMW>r^<Ovi?zCS%f#2b4?PKfeXAR#+VQuXc=w)why^}a5I36Ng90UuO03VXzV;A_?
z4L-2fPUt90gAdW=e4-@Q>N@&L|BJLY0m$L|0{)+hO424NqD7_BzR+T6RZ&ExNG0t^
zX`u*_QnF=<v<ao`RF;s)nx#mgP-JVdmVJBYKF_&*$D#N4UoOuxGoLwg?z!ilduHjG
z8B0f>$>Ybn*t+^~?_BZW1V#kF8@~TC%g5K>pX28j6&5xx(kD7P#GgJ$!-u@O+n;%Z
zb|~`>?l3=2Objfu-W~pbeVO;)Rl%#qSqgxV-#SMHM}$R1F}LGTV|cIm=03}U+%e@7
z6cE+DZhlx)2y?d<_ovgLzVm&90wUl==03a|eR}AGKYmrsvIAZg&eccmk7AT@?>zG1
z-XY|}Uj28oi1m@te$0(Vk-TdEdiY0A)-bo0F)u{-Veaf=zo-2F_D1y{ek{HyBs_q&
zoceEGNMsc4%s*IoH23B2A@jQ3$ra^R>k|?c5c($%4-5AR4)FaiO1RPxxINet&b;)U
z=~C|PRXvFKF?YE|u$#>TJxDX14}HOX5k0HxxXUDWX^}6ckUc*+TA=UN9!VfmFt_Ak
zE>~yfsk|eLlWi!U!Q$lngYrlgAHm}JEKY2r@;6yro5g8fA$97qI6b#w(iw9+`=1_a
zKVfn#9>dI&LO97<wBBU|GKJ{ZXFinEb1K3OSo{JrPYTgPo}WVHTM1+e;lwt|zZ1w5
zqQ{W=P%h8xcSs?e9P4&-0+~WM=_AUm31kZ4qnHon>~=}A_&R2u6k-oK3Z?Q}31kY<
z!*1_xF6GIy^^~$Wxh<ONsQ`}kw6WwBSn}U`kRQzQgC0wsKBJcCXLDj3DTK5A!@cPU
zxG6KGcJhu7dGc&dVv-c1$DH|4`I!VVh49hLhjMznKsY--*>R}Ik|%YMLgd+grpL#G
zk7Yho|8!=a6vEl|L~-fg_OSbrJ-+f-^5oc_>Zkok^jola6*Er?;pCW@%GVOe6vEkg
z;~|&wI2mhH{xyqRvA8s=f7yQP4e}&Dm00p*jF3X=W&6#7K&BAR_7B@{?EXsTO7r4b
znVF|{lH+qyu>Jxb=8l(P%siDp2^`B;vgFCx8I@=Ijcq?U4kv}^Vf#UZOL=w@Ur;^t
z7>dZ-vUnemC)|$3g@F@&{b8O=`oTQm1DVe+=nr~iOSmk^kO@5_rd$rz(IY*=2QVKR
z_w)>uaJntogtU<q!b!c(@JtdqE+}shB2v6Ik}2h8f@F!gXOlPS<^e<*Q#^Q+ZvJU7
z4+J9a(TfK{5f_De>G-1c4hKE4NInMYU5$7yoFcD9oa81_XuMJV`OrCgc&oeZR{-Z7
zLA(`C9ca8!JvPvf)kvN`8@UnjDbV3B5kCrk?nHb&4M3=e)++-6*bnhC2$VsHtBLXy
z4@aE7E7%C}L*Rca#Dn1y5xKdM6l#wg#FaPV^xawW5Pt{DixJN!LCq9;eSzw)=V4Ad
zlBe%j+=F;68N^IEhPVa{AbOpG>X!ol+(PoRVc<SQyte>PKYhj})uRoAm|nl2ycF6+
zo|Qrh<yoMYoaeIn6(YbCWyGI=pY;%b1$->xZ-F}^{t5UD#D4-0M*JDX;X=fNz;B6&
zdqE;xhxkj#1N0fU)DLnn?h256FQ~T|@vRX59}pi5@%a_;2pI2z&~LO}`pztQ#06lS
zY9Jl~<6<P@DWKmP@pgy@XUyRM$_w#{;Qu*@Cqg{XcLr1Y(?EU|lBe(bNJBgY`XvYP
zAYQm}_9HF@{y&NM7?8h%IDJQ06XLrd&N~qQ0D1K*;v2zEL5LUHUQh66f5c_L|B8q|
zhJ2`v_&A6YGsK5Nzt|zJ3x04#d=>cL7jgQI>G_DCg8kGI#ET&QlMyclKWs&OGmN`k
zi1&y62z^H>_1jW7&^v?VW1wBv5HEuGr|-O^dZMA9o+J5Ku(K0!`tD%*E=;PY3F?&r
zyC|pcf>T6%84+NLCgQ{3_+b>{&Jb5Ni1&dwnS%Hu$j{!0--h^^i}+;7KQV|af`1Yb
zpA7xJ332+)>s-XGAs!AOz8B*56yj>oUzZVI1%9YS{0hWLGvegBFe$GQr|)L{hWIV0
zR|xdceiVWJl1AJY{HcWaXc*Tzh?C=MQp^#j@4mA~TpIMychXaPa(QYvvyuD`=*KX`
zvthp<hxirnPYU9*Ag<C8Z-Y4Bjd)+k8%Gd-1AaS;_(Z6;3h`7rP7$Z$?HS_rpyxf}
zbpQGbahebN!Z@S;r1?`8ahfMp5l@7?V1T$e_<0=S^xb`qh);ojoQ}9P@F2unVBAF`
zeiY6l5)cmrJJS%~1O1hQ_&LZM`w?Fb{3PNFVf@l}8B%{{Lfqa#^1Hy!Cd5|&??Ai(
zj(ff$UI<(e@-(gYAnfn@Bfc59BI1%@zc%9MATO99ZU%PPAwCGWE8;r9BM_(WtcgK<
zGvt$Hh|_oSu0s4R9RH^xUIOE87vjSpKNKRK1LNcn;%SfvN)Yb?UWT|m>@O-1{{``L
z8SzT!_nV0GLBBjhJRI^v8{$ULU+)mN0)Ku&To%T~55z@b{PKgJXk2}U@z@9PWpLc0
zh<F?LM-6fME*>q!uYjEfh;N4Da}&e^!O!CmmxcY~G{lcX{Le(3zO!jI;xECUA&6H&
zyP^@#1wSMpJ{x!%;s$V`Cl_%a@be+WsUG_5T-q;3!On|F{tb+~+lVK_{;LV`gCPF}
zaeAED8^#l@m!79cA>IytRzRGd?`R=T&yQ>oKL`Cd5%C&`hbf3(f_U&iJObj}AMvf=
zhXsgVfc+^wJ|(Nk5T*W4Me<TGuJ<6`3Vu9_IDJQVIpTX^`8wifpk4P7kAU&=9Pw5d
z&mR!Cfq46k_#)u_V82RMllIz!p23JGfIS+Bmq1<`g?Jt0Ra?X}An&;#z7O(`FXH>b
zpJ9l5!G3%x;=dqHQW2-`1kXUc1oZDkd?PHEBEApevl4L)i2vJ&OM>5;5U2ac*NDr2
zf4(Dr3F4W)Tb=gTOla>w$TyVB16M_S4A^go_&YdHu|%AnFHJ_g0>+US;$;w5a}lqG
z_=`o{3G&!##9P5{TM?)4FyD>%b%=+fi0i{~!Vkpzfq(i#+)=+hgX1eX#N8oJDj-h%
zrHZ&3*rSDb0r<@X@h;GBgE-AgQxK=`y7xxh6ZTVc5nl&+BL;Cxh}%TOX}@nmoL;xx
zkGMRH_oIlPh5T>=apvcm+;SH2A>f~jh;M}BqDI84VEjHoyaW3CCE`bU)pA}V-Us5O
z6LET+{T1;l$dkVj_knf^g1t1ZvLK$N5H|ul6%dz%JfMZRA#hW~Hv%7zcq_Em1@UYc
zr?U|E1Uo|!9}n@o1abPV<`l$5A>Otj{u1IOAMrlmw_?OQK+k!^kAi$P;!~krj}U(b
z`K=xCX%L@Z5nl`WN(kCb`|$+i;Q@$;K)Z$^9uHg}ar*A=afq9O{Z5E40Y7*mt_J-c
zf_M?c)gr{hfhQt98}<vE5&sT65AmnqufvEB0>7O_JOc6z&C}GM^I`nZcOg@*1bOTw
z($fj`enh+q_9Ft2Kd7E1kmn^4Uj_CkARYsGKpS!LZUa)x5&sVDbwGSA#G5<fXTY8S
z#79G1MIycd;$a2iu2Am=#Od`)`tEt^hd^l8ek9L*7&6nYQ;4TPUcG|&1F*9Waa|aX
zEr=h4xP6Z}y*~IG@hs?<elVr>>q1@{jQDkkAA0;n<qtyqj6(7wz#dz~<Dh?C5HEpv
z^F^G#(>x4u7%rTph<|`QkcxN;H>x<C48(I`|FReH`%pnC;+c@gDiK$O__>XE74%mV
z;@^P3MqCc~cf=#X{ytDY_5WvxpMi+ifIn3c*MRY2i1=)X4@<;DNkvSVjJPStdm&EW
z**X_-8Sqam;&Kots}ZMvhu(^~C+OLYcsk^%qljm~csz%AKUltrxHTLfHX`l@{%l2j
z0*s5#h|}vJy<vRN{;GoW+5U*H0Z#KVm3M>vjxLga0`-kSoW7%WBI5L&ywee%3w{ei
zybbJ$Mm!1Hn}E0-T#u#K^Qir1kcV@TyaxD_<_{`w0_{DG<kMh0UPHVd`u85<Gr>R4
z5x)rg<xa%ubyz;AhuZTV@`E_yXCO|7ApQaJ_6Wpn!JnpxuZHs=JH)?&A3PDy1%J*#
zJduts#Fb!worw4&$n%>J9|id&7jaF<+s6>6e<!$#xGHfVQ{E!30n2>g59((-=to(^
zD<Q5%AYKA-XovV*Saw1D6U0Ld;vXUZ(D6s@34(eHko;(fo6Cr+L!3N8d=tb8y*^F#
z)4xy1Kt85C6PA?`zX5v85Eq7ca6<e&>_37L_X0mJLtF}$w<5j>;-M6A1MvS1#Cg5W
z;j|!r1nPYYoP-nXLb#iVL%b6|kPxBk`Xdg*mm>?D>H%{&^f;aR(-suzu;d}-aqFFg
z^pD_D=DjV54+rj!^guXsf>|7fG<S<gmL4)Y8Ty6(E|1s`sgNtbjU`WXPvBAxClhfi
z;O7yK0e%VbaNt$IX}zO>zhrR|YV`MB?^&GKX#?`V5a-?h#{9k##tqe<1@iPA^@Ni{
zG#Ex4Yb1XL<Y%!sk=Fq}hsB9K_kgcvabiFHJy{xy6ZuadzXv#tlksrec!(uWV~T8Y
zlO<33r2zEYMmz`jW5n+Oe~S1G;4fL6xK;$>_C1S}dcT7FN5tO)|Hk4(&nw6ey&%ug
z@imNe1XF|&R{*Zg;zZ9z*k2g1II)M^M@Py?#7%&k11F2bpY(T79xP7!i~fFbHj5K^
zN9IFH7~(YE;t-GFiF2|L&j4P8cs}s+h@S%f0P$PEKO;`#P#p3cZErKk4@aE#*Eq!K
zeRfX3X?zZY{fawFp5{VQ#X^=m>6bw8|6;`H?@gDpIO*R?*ng$4IMK5S^sGaC4e%1g
zY2G-A_(_mI3!E$x`*oQQDOHHi;!@@vM2OS#xX&#8#Qu8n#grc`c{r8g^1(0;X#771
zdlV3F0<Mj?FeG(-#L26ANEwT`3UDjL6@lBaINSeISe*EO49L47ZVG$`ixWNcxXz!&
zi5~i{^<c!Of}T*|r1`{e5N@0##7&uXq~stzmxnpUEd9iu?~upNvgF~Ag1f~-mOQa@
z3E0z&_*~#`5WfWc1L9|ae`axFk0=}`^TCwH!&{K=jrdF8Qiu<Pd`Qo0sUG@wsKG3G
zQZGHOrq>CmygBI6V966d=mXbbad!WjusD$q0{PL1`vJFPaiWLb2R#uu>329ZVdj`;
zIUspAIBxT1aZ+zQ=%0;v9Pl8Pe$wxX%!icah}-cnCkOEi;3rv}>@PL~zsur8|3%<$
zSe(ee0xmLyH$&P><bMGl&f-L#?!WX|oXFGtqZ{I5i9)8V0Z#gt_?iBmV*^VbQY{hZ
z9Ae26f9?do9YZ`F_&LNM1FuB<7VxVqPV6xTJMXYKsh9rVw;u6fa6a3};zSSq{qA!X
zCweGvMcfPYd_kQ4uJ;Gxi$I=_+`PvW>d!r-6PVJM#Yw#xATN%18gOYAC-%1xB}^I0
z;zZ9CkXJ_hEO33qe*rf}{0ne1;Kc2u-&ZmpQruab#2YPfEKcN;VMPk!zkwI9IMHJd
z{1S^3J&MrpuYgm3jwCZo`M{EgO9osnslc6Z{ZIU(3M&U7POmczL)-%7ha)~3xDn!>
zz)cW$2R;TkX%0a&XH7#~ky%HIKT8kk_mOZNU_MJ8x{52mjwMgpy9nw{Lp%(4I*Swi
zbpN}P#fhGLkl%xNHt-@ACwl1qqL{^r9{RiF6Nq02J!e>)=%LqbF0(k%^Bd%=5dR9i
zn#GA8`gh4D#OZlKD~l8TDsVpa8gcsf>u-qD^RHisTY(-SMMf!8NWYW*@*oRLkx=AL
zxbaDjS?DpbB8wAyW`Z6S#Ag84Mtm-CeZ=YCAI%V_zk42wcns*VLwp<XiHL6o?hKr^
z*PFvDL5ME`9*4Ls@U4hD13!d#5%3#`-v-_QoaT)WaGv>uB@c&6ye*V?6CzLiUkdH&
zh4_BpeSnkp5<Pm%hZGsa&3Krj#nMCK^C(=@8G|?-k9LUD@ihf;I$i=1e+L%>=JdeB
z5U1DWA`#yX`8Eb|di^a9@trUpX`bU_+A0A)AQLT^C!Bp<Ya)x2>mIbk!VHlod=4z{
zWpQXKm(=#azac&bmQ{#irjQBI<4zWsVu|=^9_9qGI32rW6@3RiS<U9>k-P@zdBNiB
z^S(Y1lw>uVt0GR%cj*0qR33JV9Csw|2KC0VI2@XA*Ie#_zw3d^!tolZm*`RCYGLl>
zN1V1d7;zd0D-gE>J$Wonjt6L=_nnb?*<1&9ikQzv+z=GSAx`6OM-Tie;?#G)5uXP7
zC1D&8dmv?S*Ql{L%yPM94}2!#BsY;l?@J>3!2~WZV9B%j-5xkK4(m|`qbaBRFFVB3
zxwUdQUWilqc|Gu@J@D;_2ZH|NEDj;bT?3fAKZQdjE~hz%*w2<%<gWd1zYL4r`J2dt
ztGKHyK!9*|ywUv<;WQSA=q&QZ6vEl#H=Ij(oSh%yS)856HnKQ7AMRvvcK$rV;u0`V
zCR8V}hs1+3flPtZ7p|Rb{|x7?=5luY7_d0oKciWk?H@Xhv45tr<k|l5VsW;Af?1rl
zg`h|lXZvRvi?jWc%;IeSC<7<EIdX_V^Q0Q$X|Sw`coQt^Ag)Im&J^l5sy_iZ^&92K
zfm`x6<Hj?wryBTp#9slYd5h|K51jTh<==qQ_EF9coj(KVr~4rv#0P-9KjK4xhagV(
zTk{du2YK3$)Sl76W01Tx@TG{;XLzneJP71hBR(JaTEtfZr~ORrNdr#v9OXH{Gm)Nr
z;5!jN4m=<68sPg7zYqK{;!l8=Al?D|6yl$NR{|$t0EkQI^?SnE<Gl>xg-qDvoyHg8
z?D2jGloHO)hx1tbarStB!s6`lZVE;aJ?!!RgvHt8-4%=@^6c?W&vyxDk9S38nG|9!
z+YfX+62|re%^QTX{jif+CWUaeALw&<2xt3Y7BPe=gtPq+&*E%9Tx4;!A0&tZrjQBS
z4>l~$_JaqDv;Dx)iHr?p9+AdOqat|IU^*8S5EI4G@%N4L<><_29xJC45irkJhfp2v
z1JeHa5J4>T_mk?#v;O|K6g-qqCnAg(K&;c((Py?}Eiz9Y{Li94p5DjeJv_>dh|?FF
z|38za57+zO(yRyS{cmCRL-YQ(H2aZu|67{(FuVUPhn{N(P6qFCpMc0bATThDiG_gK
z(Lp}Gvu8&HEc|0N^K3@)Kt38HAQ#~~KPcc&7BN5QZ^3yX^8=`IrlaXB!Q}am938)~
z&`{>Z^c)@Lk&6L3%yYuEBcpu%=E8E&{Aiu<h_LX0h^SbwDj?V=Fv2%9fICM1|9lN*
zHYP)m9$!*j7IX$pVYqfvC1#E=NORrXqI>So8N59?4kLNx|LgYp%(g^lPxf0f>)7Rw
z+`z2RVm>4fS}-4W35GwY=>gPbrbLeBKyu7N3ONt@SN$8gYvFn9Fi$49{wWOmSN+?e
zeyWGmPuhs<k7L-s>JKN7DVn@V_cyMeT&Mb1{pxT*M-R3n^^>}B{W}>(s-nk#%q+L;
zfchs;08_x+Z3sHdeEzjPJ?_(jybhap*H86S!uGiT6-lF*LjRt|Tl(Ao<;;qIwci8U
zUjZAE_LKb<Zhs@gh%LB&XV{5OpoTIsq+tKoGwfgW%bIh=yZ=5w>L>d_Tz?-%|G(<r
z2?izd)O3I2`g<`O|EqozI8d;MElK@kTU`IB9_rT<;%%4$+tUfI-=K&3<Nr~=)IaL?
z@1gz*sGlD9^;Ex45A|P#`sv>rN&Cq)3EY12I}GOkU;W<<f}d!`Fvaa(*F*i>hdGk^
zh;pWo`em38uD_zE`r)9AUPmE1NWt}!=Ue})|Aoi#<n?$HZv7<Z;rhuqB_`td=bqRx
zoPA73RN?wtdZ^z7>Zf^@w0{uu!S$2pjgk6Mn&2ps6Bwop<4wB16}#tnGfJ?1w_;dt
z58GF>4_29Vw0^2ap4t9i{&NQV)nObH`^mKkx;<@|b`SN_-%(bP#<2?Bo+67Lwtoc`
z^g}yVyuEo3_Qx#d)euY?#}s0}BJ-i!Q~TX|sQ(K&uwcq0-lY4RZcl-85A`?01r9}M
zKdE1t`OxiY{UJTnZ!gcQf$X2zg>Fxoe-HI@;&~G6`c)W2x2N?l>!JRgQ2#e(J-g8D
zDU0o)e#I3$iFeR{r2T5lhi*^nUjy~)(G{SW{+*NF2M)M<dm2_-d)QuY1aFIRR1g%<
zYA7bx0mwYf6SST%a$v<2b>5`=n{G#^<b0aWcMCBy+hBV(BlB3coY|hFdS>!R*$&%d
zyQuwCxE|`q+h2w4>GK1rJl_5`v*EwSzXa@f+4)<WQ9`$;{YTn^>n3&Skq&1{1teC|
z4pruZw<l>H4RMBWIPZ+P6HXLbiTx+Zh#?W~hO$Y#?VFKtcza!gQAUcaqCaY+p0TN+
zp@F`lqJfeANP|(lZ+$(zkw%Q9q3I|xVahC#<+hIF`T73S$j9vT{#)YJPrl<f{5NmG
zowZ={kq*alnx&hitDB2`;wSM{<Oe|ZDV+`}KkZZM>{H9*xy$vx2apZy6D!15{UkG~
zr+F*h@K!jaT(nP3ILXL5B|eK1br@lzB5a?+1%cvkD?W%zaJOfsBzbc_*o$j2a60$k
zE>K+kYM{7lRiL=egGF;0HRPC^+3FgRvR8CSO-yFI`$2prBc*Gvx3KpIaY=hUht#vp
z%udigrQ3qbjCE0R_9<8FQy%lIa!mQmn@Ox#Hp9~~rP<4JrlpsqcV(csf(_RStqP|0
z``pUJB}iN_6}#1tim!eUzwkhivFqUnagXba)cHX1X%||(e*gY$tN+Z?i_r$kHeyq{
zt8Gsu8abA34k<S+T^&+>xG_F;VZ3Xf&>{N|-$sesr?fHFJEpwk*$uwq#vn0@>(EZ|
zW#G(i|243D_<o@wBg$=9Gc=407}Bu&v|&$3!=5t@y8#WWWVzju*zg8=m~3IMNSx1j
z-BCptx;xcY*dcX`3h5Yo0j^a{*D|Y_9-5#B9UtKU=8qxOcU#RU{8!h1UF5;C;g4!3
zFr9ry1@-nN(%S)CXT9YaWuI_SmP8=OliSUtlUI?NNwodH?&ol(pXv7JNMfQ5?>59C
z<&u5M1s-mVV#K+1kuUqyb7XM*=Ef6QPUsM}PhH6L_&L%Du$D1jh6HQEMPZ&~x4rrm
z1Xglf=7xlahs+OB<h><AF)}PV!Y@G4H!vz7LNOx1kGayJ2-l_*%@kGXrE!j>I~mc;
z2<8rIZm4l9_IFG*QdMURa!iR*5q3!V)NP6QsxJ&CgE-|14>ALN{WD^_-+f#C-ypay
zN~ISQoAw#@pTDQn@u0W@CzXdmD5aA0jAv?sEAhciX1)p5j7X?qkb`-mGjj$K;R_Mw
z$g(4<Bq2tfFZxhw0y!SFG)>&e1lY1%hm@wo*Rk7af7quo*~Q;}L@#b*qHRgXJEnZ$
zb-Sgvr4Nj6`*kkP_UpKVhjHmSrZr6A1OK;<XS$4+2bc!7@8{X58mY_p5#FZ}MSQOs
zsTdd$7D}d3VLT`E{0q(vPH|Mx^0!ar8DpPfqvF9-Ml$I~(pV;kCf*TW)ykd!Y)`W4
zJziCgDQ_M9n!BB5oA^w8{cA>S(mIvqD>f>mpP1~%wA3-hUxjJkJQWGDXwoiYpTJNi
zq8wFZ?M<0MC%%e2HJR%bhtx$(m@)sk=^2zWU2ucz*UPC~hnjM|yY!?(syicD>_IkO
z#~q~l6|hO_*+P<BnGUxhmFn>@W0ndrOI#tIOze45O!wQ^uX9vkeC?`Y&yytkiA!9O
zD2AuTsYp;Bea(^CfMH7{98wo{<EUensp%wQ67NLqwM<Q#MP@6avv?L;nkJD8*-O_k
zu1%e2!8M%MvHx|eQ|fpNYQ3Y1o>R&f`;-QIZe1ymAyN~`ZQ+dHw0<)VW<DyW=fx+T
zH)m#+4PyI7e61pD{1f}Z1F17rv`lBJsEe;%^ot}2@WV_M6Z;eh^LAmzO}ySqbye|T
z;#8U!r$d;qRcB%~m=&m0v>hBz+{)}PEK};p{-VpxMZb}kJy7OwuqW9E#;QGS9~pSM
z_NgaH_Hj&k0p4KXBOB9Tbw*5lONIFH3ckwjHPN?8s!6#IDU(}0huKSgbopns%$myX
zYMGs?ZFj516)c!&r6ZlGQj_dMx-DeD6B2@pnC4s*hAdr4{l_5v3Qw;}UiBn@rBqu^
zvrV}SS<ETrM)#gGrJkvV>_5BP5an*4>MR^+DL(%S`MPDF!tAPNpLaBU8pVV+cjsiU
zQRB$h4ErU=6klfW*r+%Mir4emr!a3YXYz-A%2igk@bUr~Va|>zPi;~@*`&}M2s`Mv
zOfB5e`CrHhw;zWFa3@E`@|N_hdDC}rCd(v6URh41ncm_S!(qHBU5?3Gx4mzabe-Il
zpkojGM;5>B2wc>u#<zBKrMc_ACl%*Cr1^U#TZQ&2;p0oQOHSVw+?d>;Hgv=kjq#yd
z=WIw?BU@TpRJvwDXq>#bt<An&M|bVA&EJ~-`0ekdhUS_54lbD#_+ru9MLtbGo0go*
zOnbiLMSYaD%emrLPwH;H>kJ5d8qn;P*6Ljrad5&7HG=||^*OdpLA59J%`=*>hu4l+
zJydSMDW}3-4rAxv+m@DXwB7m05W#CI_io=`*lr%_`78F*=bI^N-@m7?eD*o?YuA{I
zoKt&O`y7urru-!Hz}t?hRRwcrtST3m^?7r{In+<xC%`>#SiDP4NZ0HyqZF^cQ?ST-
zVzhJ1(!AE4B5K)1n=}%N)?B;fdh=P}KHsX@`vR&0_XT};6)WUc+0U_HXsqXyVVfu0
z{dU(+++J_+ysi9f+oK!OwUwg^Kg$%H9O_Z{*fT?_?0wF@&cy}FW5TVb^sSvW=H1%G
zCk)oz9V1kCnyH{DAw;@Xr{K0@wxeHHR(9K?OGfLzKe%aRIqFwY!;)!(Mb2E`Fn!J7
z&+;Wft==&f&0|e00$cg+O5a`k-B3?%pQ6Sl!Htv6rluG@u<tslqVH~4xaE};|9i*2
z;|d>4FiILx>#H7>^KH<i#7ROWy`FDvGyR(I@J>dSRpgF?xmn7FMY&nC$=B3sb<c68
z0-Su&fOwIl2n*FpMOWubdiQ6JZ}2tg>s;x~R~R6>Qlzb~j?XEZ>vAH&%~?<4$0w!5
zyNPa%4@|lpuPy4w(H3pt929NgdoAh~FP4-N?<LyAA7$XkAEh5RxaMZK&MXCM<DIL0
z4VpQX(iM_PMe*KAA>J!nM2#hP<ZL!;=8rEhbb8raCn|5Xk(_jyx|z-N%h5M?YK$uM
zke(qMvfQcUTtT63p>OK^vEQt%d(9e~zV)HgjkEENNjjW~m2v#d0Wne)X8Oy8lJ!RS
zn{|8pIU#9-C;<=47YZB!xnIJwOf#zalk__TjvT)+kmD!k-RnrrjcuIGvfhG6+HRcV
z6c}`IJXXFK5#LwNTj0phoA>ylMTLHzZF8%Brxt%Hq`dd61v^&rX-(=BCQAa$k{wxE
z%1N#5=zYZGrZ`!WW!5bdW!B~Ldt|*B7ZL1m)a0fvhgmaXwaLxH`X(}aV@1M~pEPl%
z?Ta1sZs<rEms-oSj%Ky`Y6EK*6le|Umur-AEc#o0R6L)a?C5yKgg(iJF?{)=V=a0o
zC^%n}=;f-vic=@*YtheIXJ@*SNMX=b0VBPOoOPlLDm0VgEQ)9N3@p0TvNz$;=$F2w
zQ4+rIT&@@jOdc3^Bd~OCrtgEvv32&P(wT$qZ9aapEBWP(=%?56)(x)KD)L?5e#EP?
ztRc)JVav~y{dfJghJH_bIXJ!H&5Yn}WyQr!GM6Iuwoki$r+v(aao;X~dc3jy#L$#z
z&9f<G@((ti`6}6#Wnn2@9;Ck3Vv4A3n)QxSrP$PAB|0(UAJRE7jqlTCrn+mENZMF7
ziAS}_)Jc`JH|`XgpI@#Q>hINgyRGr!v#r@%MDq4qo_iazfB&*^CCoE?W#>(MD?WTn
zj!3=tr=>S@+l^8$9)IbP@Xn6!Vc7Da@uO^)i&mV@9w%1l`%>^i{~OC5?zlF;-?LMN
zz8&A*ueJCwKi5e9>V~PNE0ot}Es<0=mJpDhSvtP2sNN<e|DB>0IigzxPA*xog7dgQ
zAYrY)utXu}U7)<INb}E8ddit*E~$}PdQy^8v~%aInBbgUqrPR|z(J{J1oIZ`RJH2=
z<IMVuTMnb2?oPa6q_N;o<}`!aSp8kvR&_@Q*=k#DuCzI5<?{2c)#;kAJBL^q2OqY6
z#b2Y7_qO7gOR(98vQ;`4${%SP36x9@Rx7kCl!>wkmU)$2Gtc>OjeO05yx5KH4tc4T
zdsoR+#a4HDnZC==+1fw1bxFiCLoc<Uv9-$WHFgyaIpeo1o?#elX|dz{7vHAejhj6R
z&d<I#G}mp;s;1?ar>6guz1Or<x&2Le_~m@bDG}kv(?mlPBG>x=kUC(v>HWm;LuqRx
z6FTLU#cz!ofASTF|8DWq1jm7P4n_m4`W^|?Oq3a4DDGy}ad%GMb&pS0sTQSHsnZ`?
zO{}>hn0HyC&(SHtA(p%6_-?H^HnVE3OqqdE`ZKK(`Mb&`{C71=r2K*hmWkX|DiJK1
z7_43B5<H}EVqu@V+9g9vCKsAc7}GA<5PwF%YOtl<s*$R}HfOEwt!@<^trKOv_EvF!
zD{ZZyyus6NSv7jxQYy&wxMg*4ib!O?yphh%uYx@E7UVTr=36yd4zPN?b3&f^kElDY
zeIE7MC)1G9IC)*oqst=3<umfcoX^&b*(sQ}<aYb`yzl)>_|yB2k;o_#%XYImJ=*_)
zR+plVi07)I{H4M_2i?`|5}pw}u&vi?iH3e{5)GA43M72Q%o4vWJYx51f!MgjFB59C
zyQE)DS1On8=>OF7{4%9-nJ(e?XPcw*f=oOHJe_+%NvV9eyyUn3SN2;~FF2#wHJX`;
z%Qw-vxM)p(tGFT)jf*GNxL7R@%udYsvMG&O617ealkv`Tk8PBGnmXPlIc(5^yis3{
zt8}@S>+~7&?E9vg%s5}E#i_c@R;w-Dtin1csdSAh@7L#S<vpdmMf#bgR(5Ibx?N*~
z^PF{kZYPd?W?oifcVwn&lxWGcS1kr>WHS@TT0Rz3DzBO+X|`UX$o7??$8nKt&Lg$1
z-t9A9jVK@0C;OS_*_wNCky2)t8v4x@Oxz(~r#)@N9g{qV;Cr%~`H8Dtl#D7Q6O*cx
z4>wE+E*yPq^qg${ycNllzpm}mFCt4n@BDg0wJ4c4@8s<hHAj~ugewj(YwRCAeT8dq
z^018}{npJ}JA;{*jTb1Y3BU5l*l5?Rxp&JBC5=~JeRzM~gbJyf9z)VLk94*0T9i`~
zSC+KKD|*UxjhjYg8k(*)LGKQ`hs8dbzjea$`4Op^g0BnYA{DGM{DvMC{jHh#EBAP=
zR%@Qz;lh_!jkg`H`>=6&wa~(8s;bY*cYpt7>mX#jzx3+s`E4;Nn#~2Z0?&Tw%T3u4
zC|{zr`?hdzdBdwx;t{>ay>Q9Mcx74M)b?<sYpKEH#TB8ue9|)KAIaRkykfzMGtm#8
zC7k}S=fc#YmvRYa#~Sz9P0f9p*I4TQp!CYJZ}W4W>m6DhwJ%`6x5e6<-|c?0-A!VM
zY`?dT_0~?u9lT<-N-y;e_M4r1*E4NKkh{C@hT##aWif6y2DQaCwmuo*JjZif{)Lvf
zEq5e~FJFva(DFzl+H}Gtg}RW9Va~q_{fjQWIv-RtMmB!6_mROO&zd%Ws9z*qRCqW%
zu_|}eFx?EFliv9U9=EAWw#+z`c{o4+r+liZap>F1@iQ7GUY8HJvhyq7H@-VD<1?p?
zAMLCg^~vD+H(9rRA-Wgcw(PII>9IQ}TFz<x!%Vld{+mwAoyxo$IqkCG$E??LT#}To
zcb(#!cU&@X?yP#7z>H9@%;JmgW3z*-mfgEwzUJkK>X`>W>@`_Bpv9m#JLh~bf7$YL
zen!vROOw5uyFw(#<V@}FTs|YU)%I3i<CucH>+ze16~r#r&dZNosq$mWg%6u6z3V!v
zPSn1x`aJ%%k+x%>+`Vgm%vkcQvhUsSL-k{GJLF>|ROe*3yx0?MC%;nN`*60sT=e@n
zuT!^#B)#7@{Z@Kfl)<H?8VPT&y*wZG%J8bU+@4wuBm0AjW3t;)2HyX;$29+1#Dpbl
zTx9$`CYc_1p?kz?Ztk<F3C$u0m)1MloqMwBQ_{~6hq<+aXAB<+E!sQ$k!Q@w!pV1*
zwjP@^rTS@pgRWE1*P{zlydH#n9P7Geq{fCP%b(YWJ-nm3<Cn>%nW3jgZgZaDu2kAF
zr`<n}zpkud+0odYZkq0o&HEaMN-Q1iv^V<0^{RWbpHJHL;OO2p>o*MStFL{({A*B9
zZAPcgvG&4Nf5Ggfhm@<f+m5-su%`8D?rsqorRDPj8{a!kzb0=MTrgo$ss6m3`^wIx
z3uzX+*`|93kD6Y2+M)f0);90M$9L~JG~s%F-n530sRKjp(n@tzYg=b^v<=U0Yt=Y5
z@X+g{#n+Y#ItjU+)@mwBiHus-ZeBL=$d+w49XzY9%b0F6=yhatKp*ASwkX??`NNI(
zs!KWC+cVrN^O(4W<=|r;mP<xjUw)aM-1>2ax8305Wow@QbU1oH)G%wQ!{XJmS8d79
z_1txBdRmt9j*rWNvU-&i*tNS{I^#b;qxjUZRY5@syO*ADsm|TE@J-1&#l|sW)2DWH
zW-e>15cP`~JoWgVK1>kTgybFHlXQD2^VJ#j>Eq8`TZ){fFKWq7cp|9l&_^L|VZtbv
zg!a;jFXp{Iea>ssF17usg}H)px!%LwHcT#Byh7X6Y=51{<!VQ{>x)BwYz+xrcW$K9
zsm-+;wuhXo*rVbV^I}-wjrgw4tryB$f9~1*^XalX8Zl=kS*>@Hir6#ZxtRH=(yfoK
zHOz}n@;k1*L?><6O7VHsw<qlzy>0vbE0HOuLUJZ*IhdFCA5{>0$mmg|^{tLm0|Hue
z6thdVno5TW`8W(-vqItM^{H<zk2N0GH2J1<n1c4ie(jr1Nk`;9ow;=0ovlNTj=dS2
za8T>}u-3-k{P|POBK|zTa)S%@|DA7zPW7C6!9t=#Rm*1D1;4E-E1zoW`s|b%kZ5&X
zH-dBM3EzRK`_F8-7pbPCqOMRh;pQ#J&rv7TD<g95x{lfBJXvL9qq=&9NLuIEF^c1M
zZj*7_V^g@|f>m6yuJ)@FCkJi1w$W>a!N^6gd;RdYIivUT*O@YlqBK4}SEKnckGISo
zblUoT$M7*r$K5r|T~Ree-Pk={z$8|Glx@I=y!B;kEBg)TbNyFe_pP2LcV~aISlWBQ
zIm2mAcT;sAFIiPMFuCzl$r1Vd*;<*opNtP?f3+B9T`&D@*^N3U=K#UF{>p1rI(J7K
z6u+t1cwm^+;ps018_1Mw+I=ijY^z7v=ta`=Oi!KFFn_SfQNeNX{vXTR9gZZv4>{8N
z%<f*|ADl<o8u%?N9(B>s;oXby2f2e*zP@L3?{?LkQH>K%sO>B9JrZ$8@YdofIkz+n
zqdIJN^lLt5SL>dpC%xuL1OL+t_lHGP1PUFxCuS3LN${aw+D%cu6YaYkQ~ffo>81`i
za<al}<ARm#pR<y}o<u4RHL=+L+hMVx<geZ?o*v{6^-Q7t;|71Uq02E@OQ$*654M!P
z)wooDsC4L0OO0Pri4sSK_BuRNv&;3Ne?O7S&XZ@T+iGqP4%jafa&$}5FXtmWYZ63;
zj-IgONX_mm({%4d?i_kiajWv|a~avM0vGv-T`!MqiZkq78us|Ix_GaZe52*h9lOw1
zs3Bxy<4g5xk$o@v1cz@O_-e$IJK~L2YA5z++zLrC9x(FF>UEpW-xgIh8Fn=3g4&Ox
z`s;7?&yUGbF)OIiSl%UJr#&cO;_TJZ3-2nJ-?%+}(39yYL#ExAOsgC7YSN(QTTAXc
zKJD{3M_V#yVpmdE$NJ}&r&*t9TkCqm=e}98+bA)<%fsg#RJ$X5M@}y0f#Au8jT5|0
z6ZL~UMpW*azV5zt%i2is_5OzSVL6v??+rS%ElNpr{;i5{H`Yd7&AzfG?!?}hfo{SX
zSNpWrm${$%epFN7bKX!BtwqnjANg5soTNGT%z5FFF&kbFdf2j5zr1>NNBYU+T?(r^
zglww{^!iE{?6M!Aeq*q@s6$$b##;WwJoQbzMf~cPFLrdiSA1AIQ!(jE-r7esi?=T*
zIyZZZLTt+7Rcpt*+>x_1<bBZ3Z8|=^hW61NEwW&D6W=%g_dY*O2R3$jCJZT?o8)0(
z(OY4_%c;uS8ZJK7)f!%{9d^6-(eQV}Hil`B8#Accud??bVV|0n1!ikLId#5O_d0T*
zU25Al-O!Svn%&+9)UPx+&Gi1|@Ul(JywmvVJ)1*iQ*NjC)5)|MbFfDI_R6@sy8Zc$
zk}M^2Y!WtC#8~v*DAW~vXT(8A(a~C;6jyCLRJr(P>ym}Kp1n)=Ej~Q)VVdS@qvvPK
zAMqc0_gd|+vC@%5&7}`CE2d3}ZLtlm>^ScC<e~oax)X|%8^hP1DD?_>erVyVk~_AN
zmo=ZrZ)wSL^3_}uv*LoQ^!usOk}(5JS5A!ccadGAJY}bzwC#ml&auc~uPxWiLQ}-b
zZI|10Z5SJTEclT8DQmySt;a%aoj2CLoe<};W2Z~4#>p?P<}SywLQK8f_Vj%u;xJ?K
zD*oXk8(f2%4hITNYDycp`etLWb>2kz;{vY>S}Z)GX0`b7pWE#>%dWaLqGHT&dq4S^
zw@W&HP91u6#AA{5M>WnkX|LJgu_r+3g+aij+=So5y~JOz#?=ur$e8lqxbm#5sHnKe
z;g=V^s<=Zk@%lUYb=9d=0eW^Vp1X@S1X?|J&nr4?)ADw9g&615u3m|MZr_8xs*3X!
zoPxagM5P`184HYu9TV0~eZ?2(&!;bwU8m0fRO^n2XoudfP&JcIQ^TxleS<P8r=OP8
z3@fh4a0{QNnpK*b#>ZJDE<#^T$nk`~>HcSTsH@XjX<O+x``X?*-K;orqsuYSL)mcl
zedF6*lO6_3ED;@O|H^BbqkY!&=Bqk<DJqQ*)Cb-;5Mg+0kiME)g7??7iWQYBhxVCi
z64P9fk|6l;r2N@0-XG^3{$9I!@y9l|y3b4Bo^9K3t+RRh+wzyO6N;8ElD?$={-ISu
zi|6tg#$8umeKUT}Z?OHw$Ks5^8xI~_I{0BfzS3o>x&6c{6Fz)cY#jX9rG`&>YrJjn
zx51`sHVMBgIUE@K#C)w}n36ePF8{2dNoDG%OMPz7Ha|4HO1OWoduiKTI^{F?O=bu4
z^*hli-L_|1%!em>HA^cjL{x;nIV%{q=!xDo$W>F{Zu8dN`9*26(#_{r4tI^b)v>tY
zv_XUa>A7+JZd#nXcslN5<F`1u&3(Fz)D-e>*i=uBR9_Hv&uD@Vr?2{>=1Yl6`(>1m
zZ&rR~p*&nLI61{#)n2(_esO`JxZF5dql`uVoA?y&3C&fnvOO{7%(Z2i-v(tCj{7YC
zd32HgLYH@m+xpCPymTYyMN;_QXT4kpe;ww$JjrwBj}3cc>>hnsP{h}`<$YVfb9qlY
zHg$eZKC-`K{Cy`k*QV9w+jVwSFA4EAlMn4}sTzK*#nNuH?2HAmYV%j86_3ttF7kh?
z{>jArWw`p2R^xjbZ;lO+-!#~4X6-49HRG-urSnhn;Cw%CaJSG)EWdf%x8$!I6*hbA
z@q8%ua*y0)^Bp5Kepw!U8uVLt&Cj*Ac9N5_?3RxE{#tX=o?RoZYPhaS*|cJ4!je?q
z8|Gsg&u3m(cjH=}w%)?a##LWJwunvC-Y>hTEytwP+(kP{CwauWMFWge8sAPa+_p{C
zI_p$PdxXDEgnFXzuW-{6f%<O)v~sWIw`N4OA6+Y=J#y@HhpP)dPmL=(eg0SeXSa@R
zZblCpzYmMByS+AT^AGQEbJ>=LA-)3}kGUTEbg+Hr%2Sc5&sP0<vtaAZvm?Isb9n0#
zcEom>`<AF-?afJAE1OO)?)$N2u2)F#?J={a6v+P^TUl-5Huh|Uk;o(0ufEb^<11CN
zqLu{7ov4vp6&E$^-957<f*<pZ&m7zNQBQeWSL{cRjpwge$F$zKH>6bPkn`7)w7TK<
z7bZI$e9*B#<b~g5og`1o-&!@wF~cu+=t|z@Tk8}gy6}d*x8I`D$&WaETQ`lIeE9UF
zZFY*sFP^(Pti!3d^6Zi;<NEw^3NBmq`p&wChZ@hNz1idGxNZL~<IXSQkv?g*f98Ye
zA%8B%WF<~-jA$7t^?dIap{#}sr{kL9ojb2~c^Dsic5IL1i$1;6HeNLD6VB&+tn;Jk
zBaZ!q^q~DyZ@+uIt#<F^6KA7zC&diQ>Y5;LcJ@SA#>>s-)9d!#nECO9)YwSx8My<F
zZMA*gbg}&P!*JJWZ&Zuh3QHDcEIxRq;`Pu)CH2x(rnfb{rY+W8lc4E+>|I8<qUP(Z
zW2($L-F9DW-C5Ec_M~?9@l{@Ss_%@(z6c2Y^mLZ|*bgt~rKMhrE6<u#U;Nx^w9eaz
zwBH}~9vrAI9vAukO5itbpK2K&!?1T*>W+Jt#>^?rnABOP87ID8LwADPh{G4;9vqKO
z+~79;iiNE9q|4>%?e}+WJ}9y8V3el$v>AQ&&vaiBm$&EM`=ar4PPtDj$sU+}FmdGG
zd8>m(g3LT?KDs|Scz3>?ZoWs6<6Xf#(`#ii{zAF=9L<N;eDm{l#pZ?j4j9vXCV%6b
zwV`{ee|Qca5}urXf3VBtWWn0R#csAjm0#C9c>T)B)6d&`%beBr#hyL`Gc#M?o@<Kx
z_Ilgob3fW&98WuL5_h{mZ^qNBi)Jh}wO=$fdTHe8bEmwPm7j_(|1q^WqcQu$ghxZ&
zo~-K~70#a{t$QMV<;%?{>jtg6vasRd@zN{f7G~?HH=mgF{&3}~y$_6@wJ#fKcc*@H
zv`)^4OGBQ!hQxTOG_5k5_TzrMsz~_mLDsX%WqN&FyfM2)zH-Md%U){|4j7H|klhp2
z_4?(Hkg=JQcJ-@$87H+ub>V<`jWxHPW|Ym15-iS&<69+XI{jP6@_x=Mriwh+77$WA
z?R>b<!vU+h#yi}b?j|K1KP@gdY~8d21>#>HC23`7z4?-FA2<C$_{Rmux2Jsc|EL`~
z<M^9dXKJLFrw$J5m1HhC=IEJ$oe$;=aoS%M{`~ugub#iO>c{0+6^`0}!1dOZlL3dj
zb~xMjQn0+IdDB=*v+rk)gwV;e2kSmQjm!F>S}$IG{pP*Zdv6Y!H)Z>7{=Uw8tTxR_
z(XGGp#!cAAKXpgN${U}yIzD(}klH%@RjTBu#QPiOJ+5k3Yn(J!GjCS($rBp}4Se#r
z>Qnrlj-th<COG$%PCI|2-Du(ZQ96x-F4dPR2oAS?ao}8Q$^K8AzDwesSYMoMklSLb
z)$dua$R#_Z-V_&Zy|q{|v3X&rgHiQowKq@Or@OSe>diR&ty!){vcFRFirMax+C_>v
zFE)q#+OAvwG$f_}xQl~0UXKLqJD)$(X*8Aa$*}k#?DIBo|22iqA3Af_9<t~yojXgo
zc(<G5StW(@H>1R~<Swi<D4lh!%H`<+ej!a8ue)12r;pxau&c6Jpio&pXWN~hUCS=@
z$(OP-Zt%)|(H!|>yjoh@_>&D;Q;kcKOcq;wOWwI%zPaha2&)diu-Bc}*E`=owKYP5
z|G9fv<U4PE_qZ`e?hi_K84cGK+gBXES97et`u*_F0*=$<U*(sk1?Oa!2H)CU5ShO0
z%9*`&MPX6Bw>R7s3n+g5NufY}C|`4j)5ReE-?w(0TVeU><<Al0S1p(}DDzU>@h@uS
z<DOMqk4W3CV^-~}@>yuw+$q{tD?e|@(<@rKviF@U+Jyto9_VnmZQIY{iCxCf5$)!j
z;n96AR6X8t$oBRegMDjPNvMj>mY$f{v2041`Z2YVA70v@EeGw?-?r=HC;qvamo$BH
z?Os-Hv>IdCwDa!Z-rD|kvzEV|F>Al{>Mj#Stu-fhO>3!`)}V29<nMh#Qghc0US)MW
zA^lbIl<T9S*6mBaJGe-4-*e-I`S)jC`fXOHF?;*u8+r)}@`9^|P2F?de)`oxU**z<
zoqHJFSn%QQ=P&1-Cpa{n9kwshb;0Y+uUaQN55KwZ-KOnMRn~0+R`X8p6O50y%RiQ_
z((i-J43)vvTLpdA?^A0}Fj{=?gU-oq0`@i*mfzI3>3^G9uYCNA<Pzac^{<M}9lkBF
zSFdwX-lG&XCgpM1i_TnE|Agaa`}oZqjmE0Dxxa}&lO((#VNAREt-6(pV&`8L4L<48
z`@MtFis6}uOy6!Q7;NnGr6d3Ha+BABTb|~WT?i9iE>rQrbnvBR>N_oG*bVuqRQu?8
zr{agAa}iBeb)yu^L}O#G+1TB6S@z<3vagW%)L#PL%A7L|wWmC)KP2avZR#Z*cqQ!F
ze5r&H$1j>ZoF4Pkm+!IWSLIikY3CliYwcyD_~L8s*U=&ejrj7zFBi^anwi`A<IR=e
zovqeGw$yACsVmv?e&>G9vogn71ryKr8}w1Ie(Y_>6>m<KO4ZvWC3nOR)OcE-XSYYq
z>a6lH53>Q@Q#8_ts(j8{<L!}o@mA8TEko+ePL#|tZ8_w=Xld%M9eY;{8^8Sfi)$UP
zRE-Quzuua&pg_?}=1uCfZ3;41hdOg&FUsvR8uDDudRnlUTW#Sn<u<ve_cz3iPTZm9
z?B2EFx9&6jO%`{J?;cd%K2>#7{K?s_9S(XTV(A5~d^bE|s`Bz>uGdvQGo5_ow3(Hd
zYo<s<aIj>XtXBWj;Z;igi)Zoe%{rB|W7yX-uNUS?EuRrrW9B84eO39zTI;D}hwZs~
zcg^}V>x;{cih5^Et?BF0)*-#ZpgyFR<+G0yhW(PB8Tj(zC99HSKctt9U7fppb*@ik
zby!At_;BICU%x5}nufQxRzCVL_qgqk$!@LU58}flh9(vs+88O-nK(5-N-(YRmYQV2
z>dy`@_<Szrtc=}k|8z}`(ELxbQ#>NJcv-3raWg4)w0D2?@Qjz_y2jxT%`Z5vdiYg1
zvUeok_c)z(&Z3e|H*RI`nr2?Tp!tki>9UdDk%yLz6{|T}7AG$}B2eG;mVN%k0^=Pf
zN<$^3w=8Zc6I}ds-AIQ$UpPL!UPb9e%S#oj46jXaylyYm{>>z*c52FI@v$mnvIH|G
z9y*)*)Anh$wY+R<gQ|GoQeXW`wS3KU0xtFYc<iTe*L7><rlE88-)w1l_SJ5X*sJs-
z=4%w6I&8n7c~YRy@``|%8K26Z%q<^oHvQ9<in+b^&6~bE?a8Hndy}8EjJ97d6LERh
zwq;jSr>rbik?UN3e_%h?rHA@U*PV#AZc<%lqvR##dG(TJs;GPG)U&(vB!@l`GG9HV
zPBYl?W&f1V{3p_FlXX;F-QqtB%_;lxc=4z08y1Qz=o&P0!(f5(WMyTa4MF{l=1grr
zvcn<B#OI-&<*y&<ic^Q!t!PP~f3TnU?t3>UElJYz$SinX*K%6>M&SF<qd&^8@+Z1K
zPky~A$0>7!<fx3DHO&{Fmkhj~IdZSolIfXSrtnwJnvsx^&UZI;$NP)zNr$9*>8Dv$
zxx04m;@h}C-NrjuL4r>&%RISRL|IU*+A#WvnrT>qg74<~c@7J@@|`z56pGojxKHKp
z=a)s5ybc=b+~S=2{bP-N_I2GCGQ!b|7ytOS$+i7=-pSJs+C1+s>}3_ZSnBiU2XURF
zFDtCmiW7dERJ&1eL3N=^L6VYTsrS}3!3Ty`ri(uvy{>SWl<L5|2i1i^qbEw<k{j~u
z<B{mTYG1Vuh%O0UzhCLX>Q~!5ZN`<K-8`!(QRL0`AnEGT$%dC?TQyvLKf0+tD2~ku
z8nWKRJ>lu>`=!T~la^c$zCNVpaZ|;~w$nEq+`cEcZ<}c&*M7S2<2LhWS8pw_T)S<;
zWc%KBsea+AA#=(P8x88Onbo+%eUs<jJ<lIG9N(p2x8(NtPSMSlO%sJWTOPenNC?z%
z>+2>}8#8i(^`JfDjNeuCU)p+awy(+1sM#9^?>b<T?cHQ|%U<qaeQbo`ub+Gy?tI#j
zw^3xnfrA;sgKu4_%Xqo0{Kw;VVHtx1vDPhbho2kT)&Aps$g5Y`OHywR8#(Syi+AgR
zt+$>WGVrUfQL{e(=BD`yS+jTd_`+mY$?*jQxNXd6_#!Z7(Z<mIMh8bveR4U!D&v=I
zpz_kA+4rk<EX?oY_V8w`z-JxJ&)0)~j14-oRoMC2yEKdUmV%;9(mx$12*?lA9em#~
zZl*v`NP54f?|zZXH%#8M!{K!1vR!#@b-^F!e_GJnRARxVLvO#i$oqfSbkbg(5<ghf
zP~`nX;q~dRUgP37`5k>A#OEo$=kabwi$sob>AKB<uk}0Rq{ml%Sv~%4f}@ywi^KLo
zLu&mkIeXvL>PTIT-q<xN{Za6xQIFNc=CAh69cA3>TK&G3jVsEZU1)ltRlV|nO!8PA
z<6ouc%zp^%Y~+jYzOFF&uj{P`r@o$4sVCaew>0pG(+`U?6Sk^(&rRP@HL0qqc5`5M
zFRQIdB|eKz-QSk_JZ1Fp;m7V9tWPhQv%5`eWZ6oUtNaQ+*7ns)YRr;m1!(k@*qYUz
zQ)eP=7SLa!zIluLm=D9242ivSe(*>BSHt-Xhctg!Ja5DIva6-4xjNBr`(M?Px4I!H
z`mEGR@a=-)yOxJPrnkST>DaONx9npDakDiMZ%Z7tz8M@4+Iw||aj4FPPwQ-~$BwMD
z63sD4=}bPRXgbq!S42x`lGWwWZ&sd|x^PpL%V^z(GKq{|v85&7I$y7uVl~@KYt1{k
zFKZue8kd+^a_H{l6RN_8(jqrG3aVCq+uaoUdi$Y7$8z1>)x#6K+6>JG2pybv`*E4g
z$ogkZ`@=enjfQgUtgX!y)&0We`}=AKhD8JgC<giYDe4>R=<Dcd8)(2B@9c{A`*}rX
zp*Qnk?tNu`56@RYe!5DpkMO}Vz0aK9)5N!UDu*vdf^V>>knl!E*pb-=ZoA-kl8vpz
zB-Zm=iOH@Luo6>T+sjf+J*l^)m|lV)f0Kxqx{a73vyPFm5)-!T8^;h!F-2QStom|H
z7!~uF4=FD}-#UIqVyytPZBj2AG4+Jrc48I+ZhXwf<HZy$>BbZKGQUFP6mqxx?;a>(
z+ZkY^$kawm!b?O<cyizIV&oFBJ@a`;I8)4_z753w^~C;ly==wQ*An}a1TDo(5`=8T
zocUWs#7u0&^q7`060Fv6eW6ZtFvXMnhM#FCTbC8qwUbZ4fS=LE=ttVPuPQTQRK$Qj
z?yW(LKDIBIZ4!Eq7t`bS5mUEjc|wob?g(thea4lgm_!o4jhJi#@gcv5h?wknF$qgC
zVf(%ewC2u|etZVolri%>+Zn&F7qIR21JmjxK^x)+C&mwxdh!F=yr)8{=*4;e-w&W!
zf&$E%e-(kh?{wpe33T6?@#j_o^hUTpF>}v_C?dQ?fxqsUqg=cPc@k-V7Xc2rTk`KB
zz`cv{UmX5u!CJ+;g-eb_c(aP!$={q{0q$LTT!BBn1iDA&ADEGci!6U)hASb$TNL=~
zjy}p&dyrTAi}NI9|LQT`z0&l~oc}h{<<83fb?+h>6MsGhjSD!uTetu2FWwI;#s7*R
z@<U50R=ja@7sF;VpMUjkOb>ib4?L>}zPAT{qz8VQ;ZiK?xjB(x4L!(r^uRy&!1<X0
zDaGm)dhe(bm%|O2%(mRz$xKbToJv8?WVjc@|K&GwukgS4q8|8`9{8>vILUMW(tn=e
zQmi%He9YKM?tT52{F@&5j~=)rli&ZPN3RD??)m(eyj2gJ*!wT}SqztA{?P)rjB?1k
zbN(ft(F5Pd)kF8{91eFs!6>ce^8fM@cVEEpuRZADaG!+|7&0%w2kwOMVV?LhFF?nS
zqvL38M7|8j7xS1EM{7OuWk|k^$=68oHL52KjK0vYg#jENJIBdZmX1D?$B%chb@g$z
zv~sld;RO3e2J>q2nHLr|H#(e6U`z5m7S?QJ$l?GFVg3R00-^$XtT$wSB=gh{wmu+a
zTh^>!M1b%AMGctsw}1S?qM65z{LQ(3^9c-@@9)FAiHEuGWxjt{DA#7*tPf*3_n{@k
zl=;j<b13jx6cQEe6BZcAtl&h2ga$CrG6@a$VIIQ5@$-uc3!4|ow3>O&3de_e_zClr
z6Cc0ex!h;f^k@gYuZ8Ebg}(EmnWwHW4^Cn3bMavgFGGF*@DR_uxdE|kw-Eyw^oMQ4
zaPSPH%r7*YXF#a$eBYpe2%qriC?E2uoB3gjIDruXJ$Dk<i8SOG!x*)JArX<?4&f5E
zhk9&iKn!`vj89}(XuzW2fQX)}Bu}&ni}2~O+hGN7WYRsL2D3Pn`TT$%^3xyo6RyDG
zfy_K9%rN5~jZpddT*~8QR8qc##RszZdEmI-Iu=)C$v<XsB^D>oxFChtL-x+JUPs{A
zem53ZX33LzQm{QEd6>(|F*?<61)S8&Zm$cAlV@^Jc~2H+`(Y)Ev+chHoY+I|PojGG
zSnXxk%k~4iUKy4=yWYtxKd}4VkHyKc5UrQ_Gc~u6_Ok7~!jdPkMCBi|INSa{JT-s$
znYo9FTd@D(_7SeU5+gzN!!784>9OFc`AgoF#mTW8)f2+vL?`8RKSS)%V)4x^d2$OX
zl`m#-wm-#Lej`W4RGu8SkV5q9FdxdvGgC+*oE%$HPUDSmwjU-j%cKyl&wQx-egc_7
zINP3jF6E7vLCidrXOAxf7XJwHM2{hhlUu4uA)FlRQax<@$z6(+Ph!cFF-3VYa1vMK
zoPzQ!mOR@(r7TX4^{D)37B^w>K}0cAh@EUspAAen+t0)XQV3`Jjl=*cgqtxRS}$oM
zDTJFdAIc{X$P}!{pNIdFr$<UyzNh%tW9ebr!@cDZ>Sf!*j+5ccdTOUSOAniGXYsKt
z`NJ$uY@>R}H40M5kvRMKjvj#%PLAT}vomRX2_L|GXdyX`6v|1Al0v71lWm;|WD4DX
z5#FCmcwb~}l0rDCcN26hiB(c4|1HK_rsIopCujuq8|C)UP#@lA-Fo&3@&MgGQu!p3
zESWNwH|dtQAUhML&^$xscf+NHc<$Q&>|7wk1FI2FB^Sn+vX(dL)}I0O?m)bkC=cW!
zt_;gGZ%}*8`|wtrK=QG~sZ6QlO}gvtfDWuiyb?P35#rxrxfSuBWM{>ckGx5@{sssf
zx*w!={sRB^gFHaFIqX;lAwB`xH5~Co2sHYGEUG6J{AP*dbzzz2H!9x+@ir65D~t0Q
zGzW1Rh&Os2jp|7QKO`Y}A;@dwJd_kFPv7}N&O_Neo443~y^YGdkQt_wBl$i8JbnZ5
zE8w37#20~o$TOcvq52yj0enK-8ua&qc2Ifx4r(dH10b#x5nls(br6^A%d>+%OPA`u
z2!5V`<gWv#&kCjTcYp^X`3JzG5N`%fpQTIn?1wnqh~yv9@rd|k$TNEp*M{+4jQ9)i
zPX*#H!JeCle}MR>@4ljT#z8)mf&QWVCfKin_;APr7KrD<ICVn22FAq<#GOG8eJ2*J
zw~QP#F@-*>hVm%TzXIv8hxV>VyqavtluX3egM1<4wh*_ah<|{7xq!F}Pd%p^@z<dL
zA>tY!{|Rvm$PWUrAE50ef5RX}0`VJ=SBD_}73|bRd^-4Z6yn9O^Rz*nz5{j&;#CkQ
z-iTj-IGKyM2=ExhSAc&K5pRI~-6q6`((!^geK+d?#N{E*Pa!@O`u8&8^qn)ch~I*7
z*NnI-wCgqE2H?-{h~I?%?gRR0|2~EO8i@EVuwM`H0;tyv@d;3$4dPcJ{wE=x41T8X
zaH96`o^8b81S9zZXje4iM<M^LL_7=j7aI^i0PV^`+#CE;g!nzk=f@Gh4SuUcTmtr+
zHHiDd_<DqR737mP#GPP#eMVdw{MHMOJE-4=!Z?*g{3X~w6!9qV=Lp2ZpubEIR|0?9
zB5nrbdMe^zKF0@fMOdcqrl9sqfu2|-pUO)=oFv3QLqF1YAW=O7AV2Ix^0&Z02N53t
z`M(VDqY&p;5Eq8LaTjqD@beSI>2cv3#HHytMSLpsw=ncGZPz2Pe*of7VgIU(IL(K;
zh|~Nz8gZH@9T2|`<9Zt6#gNDR5ch|84o94xA1*~)7y369aeK(O8HnG3^NYQR)BIbC
zcpmiE1;oSX`2ym)z#k&62jjOD@s$v_pAe_-q8ETXLHltR*e`*&1mvF~h~I<$)kK`W
zn{E{1^5B0P#3Nu_OhH^2;?EoLTxic+#Fqn)L3}gtbi}hEA7&x$0{LVY;yw^pg@}j1
z@!Mg<e-Xzrg&wz3KW9LH-9Yl|V7V4?OVHDXxI5&TcZj!x-##Jk0r}(y;#Yz5gFb5K
zPUv@G#P2{HiXr|C;%5Njv!Q>r5dRACV1Rf8<QWsh`JrFNBJM`_?})F1{-Wo#v|T58
z-NKoI<bT7s4o18j{4*c%jnLjG#5aMRixGbSaT1SsIrw=s;vG<L4&vj$Z}c6av|Y*&
z&-;+P9>l{@#B)IZRm2B@J+}})1LNo};sxNh2E>O!etUwr3q3wWJOtwME8^E+{~`$E
zfVOuz)Y~6%322uh;`CkQ+KAt!$Bl@efjG27d==Q^hPWo(?;w63>|B6&DO~Sbj`&1~
z&-I8?J@nmsWHo8(H?VULlJ^6D9!1<3+ItT1uh75u5vRxb&k?8Ri60QB=b^t5r{|lZ
za6Cd*6Z`4;sVd^haG*8<adq&UKH~h42k7w*)qj%a2PAI=ewczdjW=(^ssHC9-T`*5
zLVO$Ky)?x6Ab;i{{vQ0bAMvj+9#0}}0D0yT;)XDO?jU{x{MLl{Z{V*HKML{l9q~r6
zrw_z6_461wZXAd>J^oWgybSWEA>zv5H%r9%z(11_p8<Ks3vv2P>$!-J1O2gxi-7*s
zh<}9kZ$&&3`h7RzS)l(Y;`Dd1=MbmICpQrn1OGH4-WSGuE8=CafBB5~YT&&gKhggB
z33;+V;*ViJqJ%ijhq{P|!Z;d(_>>{c;AYB1#O1)B|A)Lc53A{WAHPon8IlG=2x%as
zfzp69Xp~AL4Jyq^rFlYxq!5{fN@&m^Ng|3Q^B5(H43W9WP<Zw_=U(3XeSh?QKEL1d
zT-Wc9-@2}I_TI03uY0X^uVJsf_u6YMM0`J_%LnoCP=CV_e+WDQ@j@sMTM)kq^`#2&
z_q=FwY7q|s`(H!c4D53U@fV=K0r6K*Us@2SYpr)7?giKD9>hJMe(^*3qWPEy_UwoF
zH?YHC#Lb}pISTRJP;L|u?+<oRM|?7HeZ-Few?sS-?CgxV8k7@1#E*mBA`mx#bge<W
z59G^M#H-;xC<AddxZV{a9s>3}gZNp<UwWTP?LQ3c)_~+6Lc97B@#7HB&xp4`zm6aB
zhw8sib{Hp$_)jSRV-TlnVk#nj9m<t9;*WrvAYKjew?}*i*ufL=F_7;eh^s+4jz|0x
z*liQyGSIH3BVG?Y5AjAgE=Qd9t7;MNhW6?n;x8edt%#q6diN3Wb~yfpxCGc!7|JQl
zN7^49iTEJMcLl`h+RM`sr)vexLEIC{tu^9KP~O}S=ZE|aL_877RUG2Op`LC)d;^rv
zU5K|pdwv-4E+{{xhzmh|JdgNG=+E3jd@Sg1Mtm38;Vt4zA>1E`M?!w}gK|OhOCIuN
z7~+Z0F3BOT2=#d?;;Y~~tBd#(XqPMyr|&_X5zmKm=8t$2=#N62*J^M$>kxMUJ8wfg
z96V$pPVfJV5zmDBcouOvs4v$LKM3XRA>zu=4!lC#6?hlot08{{A%AFo(eVf3h&x01
zlt%m#*i#AdF6f`nL_8AO2Q$P=K>q^7hd{i&5l@4Br}s%T{%&BO)kyvZ$fqKn0r#Q%
z5q}1Hjv}50<-P*(iO@f+Lp&Fb?<1ZA<>xu#gTbC1h@S_$(ZMJ*y{DjFi$HmyJO=D9
zg}65GNr=yb>y9SkTj1CT@jS4nE#h9l7bETqb_+)QEW~F8;=drhDTo__{ym8A0{iD6
zUJC6=8R9CC-WtRmp+4S0+zRwRLHq^e(|g1%A^tsxAEeI>p}nE`)d+Hui1!2e@rY|e
zyRC+Jf3T-M;&hE%`aYb7`xWfqiR52EdP5N(1lO;Xh|~N16vXF1`P_{-eg1P8ar!*!
zIO6oVXBFaKAiu67PM=>rM4UdqYC~Ka+L_OYpMiFO55l2#>xBM*2;$Lj-5-T`3g}lr
zd<ob`9q~;Nu0G;@p?z>eoUWPdjreS6XO<#94D?4Mo(Sb|BjT+P|C5Mcg6qoz#C5=q
zuMl4i<*FO;b6`(-D8JOs^PzpVMcfC<KYh<b<z1jWuSN1?%{k)I5q}BsFF~BPch?b@
zg!=d#aes*aN5t1be)Wa(G@iN8kCH%~e2+w&9O84pUfPJqfF3){p<N0_{42Dd$%xbM
zB{LDH&#9{sFNX5-0P$F`PY2?S&<@k_cO;o$dTx40L%tFFkfH{~hcgaw>PH!IU9J{p
zEHUDmz%^N%=(dOW8?ZPDHvr^~5%&ac&f-K5ZTB2loaosF@=l1S0(WC^qKCG7OIV!f
zsRj8U#Lof`V{xK~wtFjCoapHQ`2@t<fv;zAqKCGVyAVGQ<?0}d6aCUqZjT^NzY{nL
zoaVbCgnI??bl_hQKMs5hlwVqpqM`kq2%PALt}WMxDNCNjlYYN34{;NSzcq^!JJ53C
z!s0~FQjm8?oPOuv&EiB4eg40U#fctz9~zGM4$z-~IIX9Nh!=u<3X7Ah(q(?c?PqZk
z?m3XpLc9|A5#Z#I*wdQ%5qAc0Xzn=o5TC#k=e$K+4Y(k*TU5Uu@Dadi{wBbEr7TOH
zoTE;kB~Q|I3*v8tI2~^~m&MunYscb54_RG^xP^$*?@t%8IMGA<GrlZN^bCgg`vHje
z2Of>MGVtYyPX@jLaYNvn5H|px#^NNN{Ll~I$KoWO_8^~$xHa&@EKc;$@=V9^kvt)K
zf<V5MB~SPg;HQ8S^AbPg8!+N-Bd)^3oY#nJ0q28$1l3~!d<5dYz?Fd0ay1^VQ<^M!
zXiB&~99Z%s{+l8GPKYM}_eJ~;@BqYXfiGimV$Xw6sAE~2ggX?TldMFXj-y_~;zZ93
zkl)1OM2{_S`n>|pFLU5KS@J}WE*xjFIMK5b<PRYp3p|g-iJl<1&X%$`(X$Wa%MsrW
zypqL<o_Ua8msp(Wxd!rA5w8VK#|6`Tr~U1RNd7IzHzVE-{27arc9nd?LmVBCPwn{&
z<iD}xNj!f5|H<M+k1|ohIQkrs#xsSSWSlVAkLn)@_ZOmw4+B1w#fjbM^?EFellZ8C
zye#5Vfz$WHG(Jlq{!@{>A;?chTo1Szi<9`!_%B49erM$ioYZSlA7?{5yd24El87-b
z5%K$QU$6z~u?9T{5HI4X;T%Q06*zr<PrO4B<es^T<iCUbbHrsKTtT>RCWj<l+__em
z?HI)A^QajtPQr!DAjgo!iJnuSe;MN4z>^R+V*C)7i8#H!pF(^Lv{$zgr}GIs2Tse$
zM(7Z{XUW4YC^y_eP;qE^_JndGhPX5EVJuF{5ABahvp6ZwbUe2l;u}EEL>4D{==EzF
zixWL(L0$uKI{slMixWMxoEWh<(bEii%n+yVTP<0f=m{Wyj9bX!M9(+S<AQhx@Wm`n
zR9t|15y0X^&nT!D!H7!$4`*?rCmQPeN){)2bU{7=@tMHavpCU1+n=p0PW14WW94vm
zAZ`bG_Odw9L)(Wu7AH+4y&pWz;zWJ}+;3L0I0-ix^j9Mu2)q_JsXnCKo@ai<HL>K0
z{x&GoFIb%DUkQ3%BfcE?2c&-|QO>v?#82`tX9#qVXnf?MUQc0h+BOg`vss)(kzQXM
z5T673gAiW;JPz@t!1p4)9Qbj>Y5P_UoVE{v@I2%yOCC(a)zr?CC-&S5C*LE!33xZ+
z1;BqJPRIQVO7kL2<3syhA}mhAtph#ch}Qrg4xD5MLGXBnBZv3|<{WWTrMa6w->-dw
z=WH{96FpF+xq?o>X*>A@!gWRb5pYiyC*_m2lYuNw($x*}A&ArO5F&xo_|Vr58(H#1
zKOIN4lO+$A3g#?_QwE&IpMIZEfw(vn-b;wP1HX#69q?N$&Q9+`7ANV=2Ki>hcL9IK
z;zSQ^uimjZ(enc2KOx=(yo<$&o*~q5<Cp`+Q9Fo1yCI19VBq~(oamv~DG3%Q@sR`h
z;fRj`E(M&AktO*uiTM$yhPVL_bIcLH2;39#M&PRvZw0;waVtLFi4w#Y0>1>D*oUOo
z5FXy#X34{)h^y!$OP<)l2-5o*aUI}%GF)$e>>mca58?s92e3Ga53NT-Se%5L1@e-J
z?*TrV#fctTt|qWJ(Q^mnCnH`5T!qDn9(m|jX|p)d(-%6YI*9WFH(+t1hnA~(EKc+&
zfc$*KrGVQ5=VN3^zKmyn#04U*&BL6nh~EKTjJOR^$hbPheSp72{3`IDh_?cll;!E8
z<%%B)krd)3&~T4KoW7@!N4%9NWZWdg=R<!(sTWSK4<vfD&qDO*kw3;^POrC^@8*gB
zhy0~pcxNx1&J#lQD}vlS0vJa&?B}R~z3{z=L-(I^3~@cKRt~2MaeCizo5jJzTp#ay
z;be(x;>c;XJehxtILhhsA|u4<^CCK52bJgfX8MUp9=a2pR2FAHFCz1X5l8f}IsM)l
zbM|^#Z25Qru9`o3%z1~L{k?Gd-6z#=2lDTbd=~KEh*SAd(D|TxsJuGjMWDwBaazv2
zSR9%#u8*`{_&LOtL4OP4bAW$G+y}T6^lM1`Nw}2j^}-!{;mZ)G{quOl&qKIrEDpQe
zGljkI%ZSr<;VFwl61jSMdf{WC-$Bv~MUN}LxEFq?7yc4)Bd!)^E)>W-sy`RFJmPi0
zjaeLu823zgFZ^IH{BAE?2(CXQK1BaD2zMgl_C$bjkSuQ7Fqnt9|M2*mTff+LlLi^8
zpL(Isp$TW_i!MtZvWQEpSR9hVC2lOvuJ6Gt&ThxzS)APtr?NQvIzqdfB%UPPwID~^
zEy78-w7#>`MYuo6>%o@DlW=Kyn9t&DyE(HsJKud+oNc#dEY7xDEQ_=4wvNTwcH6?@
zY`g7cakkwKu{hgqGQf!rQWx#vcs$};;dm0_PvBSyaaCeK#!cmIxaE-Or|*fTBYqO(
zbrGlUi3|~!g-kF*d=_v^#Od|V7I90EUx+xpE-pfR5y*QW?ho7-@ets&KSS*t13U!D
z)A>yz5#I#zafp-oJ&9Yz+x)R}0dQJ=Xt<@olac&I;Iw{G`3B(Ik$fBQJ&1P#KY%!y
zKa{v^-sVp{X}>fV@xf4;3K5q9ejITX;N^&G0<T1T4)9CBN%4aya>)uPk7NU)T&@K|
zgtO~4eSb(eyIyZ)$+PSA8c<5)+4cH4C?%Za0d+2*lyG*vZeVeCy_N=#BzShZXnRW-
zJ6%Uv^6Yd~u{b+jPgtCtE=3YS#u5GObj7haJ6)wL&Q2Gd?}+GOr;DQ$8oiX6DV5oV
zh48k%bT5pVZ<M3t=^p0JQCb`t%25jO3UF5<RH?VwR$+SB|3VTbe*G^bVS3a5QIa<Y
ztWro2i7iQrs*>h^6JPf1u>bPS%&+_3q&7If&x1@_`(Fs78CL%bAOA6v>VM(q-;=7+
zBzc5}5p(dY!yKqGQw4LA$DPEMnS|Fnh{<R&p{=X?;>96e5&t?J5aba+=5+lRbZ4fh
z^<k#4W$OtE^!ZQ00KY)SK0M`2#?W1YnYnYBV~?Pv+&Ora0)xW5l$ga6rf{d!<?xPu
z0>hPpLxO^tDTJdTFfU(M?-2K;UZh_9e|4i61*FRKMT&IMF+GIpMGv`iToT5v`{bl9
z`TL8*{wFXpq|5og>tB`e`#;6s2?Z#M;-ttNllDm$abLL6?Fas;9CVMlbE^_BPR#Fb
z;b(w9I=+Rf$KjLy(ci)kh6g^rtnf)5;qce?5`HQel=fqL3qPJY@wf0BX7GH#urco3
zsw8Y2KDmGWYx*I44W61m|2X}5%$dK1{}IAh0iVSFq@Bm%UuPHzpY{uxU9M|@@Jab#
zJL(_I%6ZD1{9F9#{9W|D3)O++|A;y9xA;rX<oWmr9!dO3UeNHVT?aCOlkjo;=fcHN
z7W~r<ktL39$^5QlAJ<>{UXH$3=6YiOaQw-9i+_v1=q#QOcKIWIas0{nzrTfl3oha@
zG+@}`@Qr&3KT3z^AqxBv`-w9@96sq+{VjYe5R3-@bc4f>?j`(>e+i#F=f&Zd^b-Cp
z5Uij9!xo2M&`bEfvw0p&z#mCJc@~JnZ-(%RZP+dqI!m;i(R0*4-M;C?e=+#S@ukOf
z`wRU4i5LV_1^)d}14P56@%i3M`imj`b-FxBlKzp*kNT(S8o+eu7#07VAp49{8P410
zaZmF0$v^c^$>?7EKY;+~b44nT{Yx_b|5ksZ;(0!3JtXlbuNtU-8vm)igs&;Z^KZu6
z{Q0N;DVWkr_^-%?fpH&s8*ckeo?TG?G<<R&`#1Zohwy#DKiyFO^jNQ#@EhPpQ4{P>
z(m#&*QU5f2(mwqy{ErZR7PR9uJnEkwll!E<*<W-$Pl8?tNcf~JrT%I7J`lbNJpqb$
zN%MAugaN>Yib1kC<bIs&WB(Z>K*niNLEhn?@F^zu=Uo4Ao^Bea@b(lafGzb$x5?li
ziE;So0~B<E`lEO+<DWFu%;sONANW`K7yZY66qET)iB9Zalln&|sQsw_LgxJ6^6wQq
zP-p-_V$Mm-kNT(i_qVW#7hj0@E4YplbCM#3{gY-26)}b|^H#$HC2@2T+fS?)|5Yhm
zHJnP6e(axjBkArJq7<Yo%{Wz!=_=}4)22;Tm6o2WraFD92Jc^0MP<608etmKHHo0K
z+klmZ=0^N{|7hgn=<w<iFX%u2@$_L7Lv*=RmuZWnIP-XmWJr5@g?fbe1&8?s1#)2F
z3{!GPq#H<XGIaesIpNF-CZ?YBqy@o&WX+BMitIwYJk5hV+ykt=LW9CXJeV6JTldf<
z_T=8jAZRJG42M^UIdj7l&aBG8;i(Oa4))?OYjbe?JiP+L{Jj0VLO8lUA@0Gx99?GB
zIquCjS+~SHAShDFKa`0ZeTL;578b0ntnA?tpyUzir4;C?<mDNz92(>u7U>@1r5wft
zOw7t5a-oc1<TO7|C1wRX<&Yp{j}Yc|RasR@RhfptVImkF;3>`AeMvL7S%K0^g981+
zf<mMNf_$XOLNwCM@+8ucA%0=ZQYG5b6XZiDkd7$h^c?i;_3ZR)?QBevx=l86drT$?
zZ~Ofw4<<PjBwgek8>&{BB)vA_eF$cfR14=-t3aH}nXIh}8$ng5b2TM>FiAQOC|SZ}
z?VT`Dla2Hgk0&PtFhy}~)!?<>Oo0I1yi=-o{zRqrPiVZ@nkLo$7c!6l&|;c&38F%E
z)W9*5^m$3&O?XqB`E$%Sa_b(GRMjdydzx^br}-eIXE)zG=_&Y6de1~P=@Mh7gc_B9
zg<<l?I7zRG9eX!o3mC>UiN=Z=>LR0>26TZj^58Y;jB(AA+L#DZ-a>aiz)nI<KSsjI
zMbBB!MQ@Rw>u-6IA%n-plMPRXiF5Mlc*gitjd}7xa%h?mC#T5?TYQ#OP(}%8L`E}D
zYBeF*3sHEj|Lgbf!DH7D^&FF=c1R7A<a1oa)Nh`i*9({hU?3j<%5Br6IdYm1g*ORY
zPqc-ohenegN2MQXhz+wf9xe1SHd5nq<&3?a$M;@Zr#ook=6=2s3Tky1d|h+zja;N&
za8Ks^II9dT`8B13)T}oP#eJS*S#V6hPu}V>e@&UiZ)ENBY*nqVzRoP=GwWkBaQy)J
z#J-<?oo#7({FsyZW!LPNH+;O`Uwah0a`*1%7uR@sEhzJdp6y^Neyr~|)l9`xnq$9g
z{c2~nYTv{@Nv64H`g_(LQrmXScj3VoW;#}5igu0^QeP*#oAYCF!W*;unR<B&QKi27
z4h&v?s$6IHZ!^<LzfC^9_55{P&syi+vhm*yN8DY!?{d%Pj<W9W*LoTz%|2i^U#fJ<
zWaEzReJ3^goVol&?56ki+H3JTC+8~FL`$3X2$_fukGGzA$fMCp%gbh{ZG2wVYFqW~
zdi7SjZKrHEte;=#((rE3%$-vseu-Iru`S#9UBfEcR(9yg;}2pVc<0q^QjdOMKgqqV
z`K`+XtBYlw8bvn~bH_!zUud}`S1jVa{fCD}E*__2&n%f?r?)hFQf|S$1$hZ0eG;3_
zys_|~+16<4;xl7;bJXdhQ$IRseKYItV-wjid1>t^tC>l|GhF=!#%yrB@l_z|;*Ozd
zRjEP>JE}Scyzn@vB7X0D)KsGpNv96VSs2~yY)>c`%H60IueM%ojhcYp_&Z0XXBT8E
z8C>5dDmCO@acF+W%LOANUcAqKthc;xWXTAx?}MLPEVFiRv$(D^{PTqyKUJz2p}9&?
z3MUE|Jqp-fF*!Z-a`PUUso@vR!bWc>Dt@FsuD`^k5Kp(ZRT($3?^S-PO>OBp{CW4I
zluu#f)g>)`LgtzWnl7+V*cP|H>0w%B-0I4j4-13Oy|`a{CuaAUxv~34ys|#v<8A(4
z`9%8WwLO->v8J`ZzxGdEw`F9uSazdHXzELujWX8_M&8|gLbJSjW%-)Za~6%BP@y*I
zuC?N`H}dc2t#lpK6LP<JO_NlVmcfGu-C`MaI-(1Q-Futx)H7j6@Xi)DyGf_Dl|GDW
zOl*C(qU=O)c4X7XK3^aEoH}rI%hNNWB2P!iRawStmzAqhe(w1F+ntE0TW1yb#Y7dq
zHe1pDQ8aBp#YemGC+@GE>#}>)Z0jfmE3<8UFKX&_`>0BdwiT025nQgWDxNd$$|}dj
zL$q^}l^0BJ8L+wU%aWG@y0exIx}|H&xn8p%W4ol#QTbYdr8R;X`*QfFi%YC3s7Z_$
zSv<8kZ5Mx-xXr4^bJUA>e(P6!pnQy``6JF}Q4K@EBkT9{IGnk8cZtAB&W?HWo_S|i
z)NlVXE$>HEwO*0e`7-g2%cJE&f^7ZwX>2_uarx0g<-}Cq6W1-rkKD-LdH34AE}saF
z@Y3TFZgIN~2#B?gh_7C}qW^P=bNrH8FCSF7Wl6Y6?rz~+Sl_~*GV%C8NrSh2CEZ^3
zdE&^-EOYRBkJv8rFh1c~ojy<cE>^D6R8!_ZDXz>XY<7I`E<>rh=&Psii52muSlu0@
zqJLd4Ud&%aAjK+F&~440gB;m=QUa2hhlQ8}4L+kBEfGefKO^#skJ&kQp(FNUKXo4t
zb7JqX%$K8QO3B{)%vU7V#<wp26sKqVjBGE1SuuwXZnDv9AF|!g<4JR|!qpvTyaYs^
zh$@N73#UrU=uX@+Xq$wVZXdBedFy9p>{-vJK1V7?en7l-mgugzL-@YT;rEs9%Xhs@
zW0|pr!nA_hJ<6koXbhV+O|$;ntfQ}@HqUxhxmnOD?W@j;CnaC~uTEHf?xT~Dj^rj`
zO|$jyWS_0Rl%h0X-?6%-k+or?*Ix^^?w;d$IL%Q==6L!&ZPDHDvZrsXduP!eFZDh9
z?v%ZK@8_9}_BT6tZ*-sE9rjrv^+!TJbQu*`UBBG&B-bo__{!~e2lSNH^P;T^+K*f9
z^VfN)>0o!@LEA=$B1hYji=#62PG~BHU(bu}h?#jJZ-?#@ySbUu>!;2%INiR;_n^O4
zsa<`)@Em*H8Furmj`+)$I@LQ%PixBe*L%F8e$uOA|L|io=WlL*x~rybVtre(+<lAu
z`>o5n^6u*`&r=Q=Rd?`g&2rs(d+DaN2Y*Z&Vz+#BvX%Z9N!z?1eQgW<6DQfWT#LSZ
z+BSDgVxFDl6NUK)f0T8WevLbkw~>jegqp*N5yuN1mKQBpA+RH-?D>b(4}}lg&8~Xa
z4=#RFmbZWP{k;9_9@@^X?e{KE#JAFaRO$Q^`>vL4*c*_z;q=>x`kUn``Q;}f^7gNd
z$Spth-hNr+<AbeT6%H4Fh979xQu;9|@MKYLdCM64SvSL7zsxA?&T9#M?67Q!&Y{-k
zILC|EPdQwCe9H36gxZBEt=^-pmz|8TeUvGickW|dX6w3rMXj6mSyf)MNo*fFW`?a$
z)O)MSD+!5tdyg!v*UK>rUq5+Ed-(oIw#HFMttwX)EzH;6P@!F~>bof~vCXA^@63;R
z&H7jS)-TJMAD(6274KbddhbL|l$@{KzVm@+?7vu+2H5OdH^y$CyL0}Hj-Jf+7h(&)
zh*(PJ>C^_AZ{Ah1DrK9qTDM-)mP1l)tKSYAm4C*6=uP3C?isP_Lyx6@SN)w+p*6nE
z?rPig&3(3pTE72Ovin=UPwJ58Qpb)DHr>*5aMjX~bDd>F>e76!%q|>I5HRtEwpg{w
zvZ4j|g{N<Nx%1))gB?3EmfpJ|Hg9`H{~hCxPV?HmutfXu#Bh^Is+aVG3aWMA+kBHP
zzWl-AQshmax^J816X%XUI{4=1er2Y!#C!H=b{rYi-g!mk?f&QM6*hVueDKVA(i_{C
z<F1|yFP7W5>Q%&Vms4Uhj!U<UJ#}a0?0|BWU3XtZw(BHJ*tPY8#@v-DMVWzzU46FC
zUEJ0>c6CRmXS_q~&w>4~#{9M}3d}k){`Z8S*D{koII9%6ElX2B<65nsUvj{~(c|u{
zIa`;UKALP+`>gx5<&Fbe5`)iJjxO;zU47MIvs8IZj>FH_$@vCdpTn;8Q;YW7=i)x}
z``V5j-QybFi@uJZUTpAa`kRo0W(V7v3$|SA`7-(D%!42A?2f(r_QA#C<fhLbvR=*#
zI~M#zDf`Djhr(a)w@>)^^{RQs@1~$FCl4$NGk%g;YVp2nk+=PpZ8y(fJ>&U9c0-}&
zs?$n^V?K6H2ukzv7!)*6aqO$^%N55Dy>ihhIck4%$-!YW&v%qME^MnvdzO9W#qba2
zB}<lUbNv;dI7QLxvPtu}{448g<Xs(x<-d{eyU?`#XUpR=HSr%T?w`9qr~Uik*jd^B
zUe|w(TVhauW0(8S{jMWpJIB0>HSTGhe^hlv?cSP|e2-ICJpOYpmIC*H|Ma`;tedRQ
zs|<N$&|h$|fV|l#J=H7MuRa+#ZPL_N-{#D&YWXOTKHsNj;>w%OjtZ9ZzNR1diImtN
zc6oc$FiRPS&B8gOIsEHi4wHOnFw1yK_YIDHX>rM+>eR^@rw%FqnD4pyjDUN&fYZ+b
zV{dgGuN|~EqCufnbg`^Vf2p<p`ENH3|D1L8)9xGfjx!>16}IX}H3TPywU?^Sb8kO2
zAScY%VPVCIzFXyG&Q5(kX<4EF>lUX0pVx;J*<UPl{uK9ic=46hX&c1v?s_eq9duW>
zV(sxko;G6>rgwz~EwqT7b}e_XY=S{?shV@u1*3P%o&>z^{8;hb;%l_NMD855ktxl0
z*HjD}IqO^faKmj<DqVe#uDiOtr)v9&i^-4HG-+Gp{+N;bl4D*e7He?arCCw!#^4X~
znTtBryFVKhE?j$1H13)B5BYcc6@xYlmWOV7@WY_*m{HGX-?5#|z4xN_9SuA5I4V8O
z)6>n(>xrALP=HF`feHOQ6q4%#y=&ceJia!2_rhV**4^;=emO3ok3w+5p)EsYZq-%n
z+O8_OH^RP_Gwl8;^AvZ*$-8GPh`(pF<Erieml4CQM(kAaP_TbzVfCfqd5@&Wf*zSw
zfsZbKTfarMugy>)tD%X5>Q>awO=%b;&NoTywor_((la9?=~&rkszw<>oG+52d&mO~
zUb&!;BzPVCgXn<)kMag{_kqV3e_oIu<lbS?bV~e3Ia|7AmW6<x@Y+lJqi-nk+jl3-
z*{LvvKS@V#qFylHnmIdPa4wI?G1XhO<_W(RpR=^HbgPW5T7$%~V(YSxKVok_I~Exl
zA)-_<p-oC``G*gU$thcJB{p@ae9@Zy%72^iz_S-`d9ReLxO9G)M%W;skP*MfeAHSs
zIdzD_Y~5+wc5V_-4^5UG^eBF9qWYYECS%Sxd*r;*s1vumJuP;d;xGPf3wmyhJd|oz
zaMZ4Joo7Mg)E3`<rk}_6y_!15Kyt%4;fuvSC%?Pw7afqf^TF=chCA2g?0V+7zdqjX
zlM}Y#he-Y5ykRjWNrT$FK8dVwe)V$bH-5D-!WLCF>OJoUw7rWEU*c&t)!|LE+``}8
znyrJMSvQN;SUwZK<QToJ>tg*NpC30@a)OG-H^cKs#?HFr0XyTUJ)_dsE@%pA(iFdV
z<eSjU6PIrU)X%(@uvm4|_>$+_51DtYS#4sXZ_e+`DSi9>$E?R3lg7RG>`y6fk%>Q>
zuCsj4{I!>)52ooEPO(gw^<%i$_m_IR?KNa}ojZ{tGv~#@9J?Za3D@Vx#_~T-){Agl
zTm9zs$=Wr>Prsy<sji=W?#h=+=fVdEBERa--mBm@blBJCdTqhRB~6mC+rF4S*etU!
zRVn+}{O$?$8+^5=+?=pfelK7C^TmVG4wTmTr%Tzr+0^lz-=e2vfn7+Mb77Eo)5RG1
z5BEFG>|JMHj~Lu^ai`gehR1P*Wy$pg-+n1R{&l+WnT__i!-MO;7F6%AZIl||^P=&)
z@jHRBab10@ALeIV<Wt>RJ?QNH5}TV-W4tb`8gta;!N3Pgl;ei4E3^q7xa`-M;{1To
zakKKvwudbqASaV`Z0q?4`3nxzomn(Oxpi()nipU5m4l)4Hkp)|w)?mYE?&QKgzSZ`
z$Au9N8s~nm`11awYxB>J&G}1q%|Gy~xG=*0=_C>R-^;9@9&PGs{}B~lxngDb=*6AJ
z8`U2qzB+Msg?@ax(12ipb@w+vFmZXlH|pMuWG|sNh27Izueukj8@|`}{Uux;d9GaS
z;TWkt6B`x3q&+=wMCyW5NU7Y@f}kJYv)5H=@o8^6w)(uwjG`@RF(1D@6xlb_>v5!y
zV(`}LMyndT$)D8PCLMhK^rek@%aqBdb{D)nGsGl7G(^9z^^qsC?k#yb>CW5i$1T+T
z99P+0e6%JraP;DoZ~HuLyX}8V#zr153hDMc-u!q)Ma$B(*n$CKzk9?)rqzh|IBgiO
zfBwe8<zw83kCxv5c=W)H4g+Q{nA>NYqRAKgpH5Ph?UupaCZb-p(q9|qnjiU9er=J^
z{^@ZIfjQ1AUZzWLTPOZKpnCBauQKOr7bQPE@3^HgM=j;YjRmR3ZB?4~voCpW^$WRP
zf91Zed`MkeU|#o&R`2m2b{^l`Ug)^=#m|u%XD?3)`TFtL!*~zx&}IGZR2+W(RmA?r
z@WIpMmMCfa40<84$!pZuVm-rC)2I6uJE<7Ey&UkdL%~8~V%{R-Ahj%6CyA`Ooq`G#
z=Hmq(zV1-Z(P@s0ds4O1nWGqg*WKJWMD@V97~?s?Th2DMi?1p=V6p6)`M$9&8>$zL
zwA|vgZiT*BU5!$$h@Na-o!0OD3mn5M10FSANgFfMSw%g=;ehYLH?|k5lPV<EY>{mr
zwo0<p<o9=lB0HN@Necr{2|wem^eB-&wkj{elVh?=1kW^bL{@B@*d?ep;MMKZnL_+i
z)@EOBxcQSm*K7ZwHeK7mjCHMNw8y8UX_ajLHE&Wxexm=3`=8d^T~<|2-+0ly$JaC?
zZReg9F=aOWzbKij3BO!<qjYPu`7fVa0zSbfoRkcePD+nC@!oDpRh>=dGW`q1AI!4@
zYx}htlpl~&*jCszJKR7w)$Q&UsjBlszHA$sX5V)HhlNyQ=JAZ^zA`uM$7ZF5%-%ID
zcdL-fnbh~e{j_&1a@nrjG|<!R4qw)7A@$Pv7UL4^!b}pbwL0;Af8M?zaqL6|kAlmd
zp*ntNzimCY%0}tdol_HBzDeJ8&Z-l8U$cE&X~+C?8P8g+KALEbDz)U_aP07?ip!1z
z#)?i;RY*y?(mMF$1wp}?cSpvJ84|8FZg7G2y04y#Pc$CYkhoKRDP&9d75)S_2j^So
zjK>M(mA|YsIeq4NX~*5V0-ZaRBA$j*HjlHotlY3IHgB}|(1#mM$6xZblOK1nBI7~(
z{5x8wN;hkFJ-K!CpqXHa>}=1EP4n!opL40pQq|6VY<~N$i{--HEkkwZR+LSw%RI34
zd-k%B(T1xhP2~%G6uWiysjVSH-DNlCx$PEkyck_ML5VZ9v|TW!B5}2+-FE%0kBxhB
zCoDhRUA)M9b;7gjx@%?6XziEjbeg*V_S6Ww=8T8e${GZWMVdFg_Z%Q=EtB_pUt5X2
zrB!vx%5R37*Z-V*FH^FmpNgngeb~N0;q9-69GE{*+@(0vL`2Tzd6_xC>h_h>)z5^*
zJ{Z5TIx_g1YQp3bN|QQ-cUjA3hPSQWHTKG_q~!y?P1taK{TksZiuUb$Eld}->W}vx
zAK7(boZbq_c-8kRMUy|RDV`^^MQmM2PNk5`#&j!f^LeATO;7FrG^4-jDbElWPo=c=
zE}crt&sdKAZ9ewg;ms{;gjMEea71NZ&eMsO$vo%XwAZrpOF_frru2CdmW$61pS!cs
zds_Fptp@%k0`-m>bs>jyzf2F+bI*TlEjL;>Q>H|2xKh?m@6nBGmt7tZE7vbGdB~N0
z*V~f5hmN;dq&R<g=-9OBV_c4w)h|6U;?On8`Hqp&3Nt4LjhFvnb9+uq<Z=zWm`%a_
zt(ryab463vc3wWQuwc_ikFEM~3!X{~Nqy_-w{c0jK(L@+Qr7e4j+>V*I^-N5QfOOu
zG->^VS1;FYi*0!P`1<q~1@W=>-*~Az4fXT1vQZg*>$?24@X62mYq&>D8!4=l;?Y0f
zTXA%0k=o{*VP{g_RXE6PH_A^kUzE9jz=+_O{9mHtb+bDb)tVkRk7-!aZ=LSD154tD
zj4j9uH?|X)xqD>IXYXh4S_>;AWlF>qMY8%kmalfvo1QUZ+QvCj^4^}oA{VCQZkV`F
z(nmM5k4tpKq$^AANn2Ql)Z7#vmgFS->7g#iP_!dz<7!Ls!>Qf(oFq#N+oVzoHosn)
zZep~^-P)~d;_YjWW)ZsauX7_OoIPJUz-Cv8T$;pf1IL?ZE-cU2Jpa<d#LvWV+|om_
z@~?kKg!C+_jOI+f#Yx-xv&i-7t2bR&!v$}9DCy5@(vVZD;XBv(+onizvCa`bAG4X4
zb#*UYa?h$$lV}oeHk~%S>#%)kq=Ki{@kQpsVbkWen@1Ndy7NXfc=&3GJ{s8$HFMId
z-l|P%IJq<|+u^dg<I94_iT7m617e2qmo2S{pS<beJu$6QsRFhel!t%S@{?V%Pdz;L
zXIY2B0@<HgV=JRyq-x2Yv#L5gNnE%}N_y2MSI5govZIqLp7z<8P%`(OPNGuP)ymkz
z-Z4tzlhf^7OH{L_B^eZM*-|p$NXOmA6w~W!6~-&C*nRbnP*Kx6*1Szo{dnTDqZ=Ch
zuGr7#d#3Q^nb-=wji20|h8lMcREYWRF#fQ!)S+Q@cXs4@$PH|dR-3fWbhJc6t%d5E
zo#tocHe^{S2W#FoH@ctH=CeND`_=31ecOsu7fl%F<}!0jk5=xOdi?~4iK}MjR{GoB
zU9!K@|Me{WYR=cbV*;W-n!3dqyev}{PRqL8cq9EF|K*u)=811Mx-s%_#g4w=LCP&1
zZc>wEqs~VM{>azbtR$}ycFnNw>&(F`?KPYNXUKkk@gVP-Mx%b#(1$sPBPAcr6}j>)
zV8Q&pe(}-|R6Dh{DXok27m%2K$84m2^phvIH&0!Vx?_=L%>DdF9ttME`?w1jFz>`@
zKaY-)rpHm~1zR2mUXT`E+pVAU;EVC;U0svJ`1Vxvk#LugkNu&gHoS88J=4=qr4(-@
zdRdyBJuP{y;IW?jff0c%4{Vz^yA@;)DZjeHTzcJy>#5hH3L@@E2A7Er+FjlD`<jtl
zX;QjY{E?*Uc@uWczVY~b!@UrR)GLpKZR3aEn3%*rRl3nCedXF=#fjAqTXMQ>P6xI8
z;*YDG^=kgNdOxk)FX0PLzxJDdbN|J0rm-#?JBO>6r0jRN_)5cFby?h*>g+s$oS3~|
z>bA^H8L#~2+0xnmZzeQt@L%(O@alE-nk_psWhzu-w-~;-T{qKMLce6_zJBsA0?o(0
zsuZ21d)>!X#U$bLiEh3RGuk{k#s&u3(hAHwGEes@%=<4NFKHhS4{23(B~>MrDN`rH
z9=E&9eSa&>?2?-iX80m=Tf<jH-sw`u2glUDWE>4~d@<G>z9><?QNlv~Qkj#U41?GH
z9PVw9zKG~%eti+iO#=EN(i;W!MHEu{=!vMT>#HZCnIL2#qRZbcVqz|0Wg)V_QpC+v
z#8*!w*ny!*14K0Eh^Xj^C@}sQ|BN1ek$&^o<AJ#mKz}5Df}Bsk5#}BWa8vo8X9WH=
zI{TmV0{<~0i+4`o&l~7}WXYbuzeZ>Ob57u2qqEtZ{S^+IlQ+`;=>+IRx9F6>pP2#w
zIl&vU!_Gn8Io=o}!T<2V8)_rSk^V;ocaN8sf`7hgrKiVncLe`@LrwX3;HnhBb~1O%
zz198K8Qv>?K@R<<f}Z5Q8D;XzhXUC0h7<~NcyGo2IjP6p734(ygSdOfz?UOF4|pQt
zHr(Sr90kOAuiphZTM>8V9t(1IBklz}3-KkuixFQ2d=BCf+~Yof*5Ib6<3OJK(1b!}
zyNdaVv&t=f6mfvzqAWSOd!iS9t`~l#7k;-F{=66dz86j!^uNWkZ!erYC;FSbTrYfL
zFML`rT)P*(xECJQ3nyb7{}#{WUO4BUK_wm>C36E6^2ZG5H#e9{{-%*XHS(uU{+NOB
z<_22iPn9RgJ+I1@SLJ$8<qE5ErOC*7MpA?O&-JRx^~(iQxeBKL6TT}MHsR$;hjH)*
z+PfN?Tk7kXyIL9<*%;co+Un_>8@h7*qsVA@W{3sZ3tH^&<q;OaVMg;aqcHpe3FCb*
z!4h&032~2(-~~p8{Rg{;`MNUV9B(p=gLnxJ@d^uzW;T9-VZ@`C`%;d#M?g@h7sorq
z%ZrG3dIfkf-!Cx!gPCzIAu#sCb*YzoXn2Sh<28sG%M$7u9?X1L;pG|@<QnYdzJ!qr
z4PUy{JtUeC?%0$+5#)Gygari!gt{_gQ35$pQB1I&;lWIa{U;B}V>)5x*TcNRCytD3
zByJ+}lVyICk0X$AM4q(Cl#_8##9?_29_Gr6F#A+qkHyJVgK|^gM2{ScTeG-4i@Wr~
zJ%N*Wl5$G*^HR-=Cu!R$U&)duS1Zcb11Ire%kN{!lWP!_Kgg12+wCYzo}J#4EO~Z%
z&$8s%`Y*BM+4^s><k|Y0Sn_QBtt@#7W}n9Y4NIP_zk?-D`bt#3yBB#n$1$-#JN{&B
zIdQn0i~vsLhcZ8^UxvlWqfp9KSe#tzDc4|ewjJmkb3{KGazf?jf;=v7t}H%*B~L~&
z5l8flV186j5KEqIH}*GSq)t)!bu2xjSbP&p4?DkhvE)e~hU&>=$&+h5<vA?*(JW5C
zMI-4YKPpe>P9==gWy<SW`bnRMax%u7I3iD88&Lj*#mV?a%K3@G7)RvEFigtn`vJn0
zS)9)CK)4EvYk(fI8N=ebEd6Zz({Epi9@2-S;d-<5jAijCmY%6BPR6tnM>f*TkLuaN
zlAp%n^aTnTme-g0QOE1Y^1d4(=bnJQNF5=Luz}n?-XA>v|HDZeO&o2Xi9895a$bLx
zr>8#=1V{3MI3iDedf-8aK*mu%6C!KI!+-c7=<3c#d>KTXw!>7<Qc{T-$Lk;dqkppi
zkB9I!fArJ2xS|pN1vh3Z5MKk~rXXGdhTnp?3>?#To5s_PG!l%<<!%1NXCAo-Fpl&m
ziKFu7<RZqnYTo7#_aYY=#@*v>{&4!O))U0*!TxU%9}emIhPW|=D+uL<#>XA<MHF#W
zC}{M(BbC1f`8x^8+k%~G`$^@eLm`@j<mtEX^AXp9e5dUv)#C((dMT2h1a^o;oUU<`
zg!mme-ii1_u>T>%%fXJv5qA{gov22femi~>@wH%|$B4^=eaJT}#L@K5AUljB-;xkV
zIsFD*2-*$Ghmngg<Ax&M4(XCbJOcEpBHjne|7^sMf}Q6fejGUcCX2?W0=OTNuLd58
zcpdPyh}%LrOheoW?3RT&l+QfG>DqvFjT0JAW2mPWko--E&n?6!L%!2*@2Q?AWQTEd
zE+5LLK>IKr+AYehL60KhC!n5AMLZwuK)=<edZvM#4w9D<<i&@6!%yYQ$PVMokh}=!
zw?cdm)JJ>7--8}!#HT>Mcp$z3>==Z2JmeRh8=A)R3D}3O0Y*7pOL`m9a|`01iTEI>
z7lnw6LAp*OUJkq-@ocCst%%e3^Z|R*cuGUM#1N<QV-TMX@{<vFgm5(xr}3PNcsj^C
zAWp+whBys(1>!W^WW;H>xrpBeyA&Z_2<71f;)9@_IgR)*;MIty!gcBr;^%;0M?4<N
z!(GIE;QH8zxF*QcIi+Ym#zTBwAo&fz-yj|i<>wRP1w<j^z9PN^!li3W(s12*;v4};
zALaZI|Ne+my@L^-0Q!d_ZUgb4b7E2b!yz9Pko;~qRzsZD3p$4u)kDjh1(N>+_1X#X
zTf`&d=$iCY&u3_#>D;)KD?oi&kMyWOeW!D7QTdAyE?xVU@?_{&(79hJw}9()DbjBU
zcBAEv%G3TzBa+tx{T~n?0_{AVyNl|fYeMyh^ie(st|P+`FM;&RA}#{@>6-LZ&rG<k
z%|h~xU>`HYSA)C*;wPbAdm^3$$IB28<Yg~s1>$tg<z&Psf;^p*jK+T_*s}!5)BEIe
zh|@JUX}^`~se*FVh~(#kJ?WfhRQ?OtvlGb&LOJ1p{iys@i02^0>DtO85&s5uo`85b
zaJq&r)lb(x)kE^vpk1;+{3fK=32{32tuNw<kiT?pHX80NDF3UGJiQKWMtnH5Kk10?
z27BfqE)VTbIpSl%&b5fYgZy}oxITpY9&y?q`i3~2W0lT@O4Hi{^>#4WmGa9_AL*Q@
zl)r*>(K+WR7YF-KM|#{LT?UAMg>=zx{;8hZ(2sIK^4s9pA8~Kc6N&gTh|e0t>7315
z5Z8co?MJ*X++XA)9tn0UM_d~ECl?XVhT}VkS3$Tfh(|#Fy+vFE?D-vWd8pTYp<GjY
z!sVJHf%rBk=hBFOhU+iw=Tbd~p}o>Z@+uHdW5gqfN5<JAo(uMIM|>2Nw?M=lp`6De
zE(Ptzdc=)EemmlWA>1s)lfeE(hz|n$oI$)C^jt=K8<gAoh|~7)8RE44{D?ShCx0Sd
zO8eztSDG(F;CMLVbnQ?%#OLy|g`<kNGVs}mcR@Luhj=NJ6DP!TAfA4RAAtO#<$|0h
zzt2#=5|BJy(>WFKSh()&Lp%n`e;(q8Af6`?-w3=0@zaoxw-J|viqwoaUGw=3;&D(<
zzadW7VDAIzAg9SM4$7N2;$6_rj76NT@uG-$JII?MPWu5?h|~V7J>uq2ADt0D1bi{#
zbZ$Ri#HT?!9Ef-=*gqWcDzH}y;(<_4w<4|xcB5-`Q+s}Z@~|JtTSEEFM*Kb0w>-q}
zGI>MXF~mbaz7Fw5Xn$@Xo&<Kdhj=!`zX|cRVCN3R>3!Wd#IwOZzYuqa`YQ<akJ^W>
z`8g2rOz=M(ak_@B9OAN&kE)2P1J^-39r#?tFY?UHS%A1KJmB|2Tp02(1aS>Gjz`=Z
z?7s=|Q&3LQ5nl`SC=c<mV9#>IV<BC&h}VGpJ;dvvJ!wUJCGd}k+tU0+To3v`!cgvL
z{$2q4j6{3{q)P#D72wkmpACEt;*}6jYs8hI-E%`+0qhfqcpB8BIK(}HZ$SJx)Qeq+
zN5XaFFyft1o=Xu=g?<ZNQ=Hn3hDV>bQEp6j7}t#Sa3DT!5vTR-2jYoP-}^y+QvKQx
zpJ9lngMT^1bHL715vT7>brGM%i$2E!@ncXgoDp9L`Rk8(D3q%x#D_vXU5EHyNY^&R
z-N6o7i0^=O6(jBs<?t-xV?qBl#2-RDA0loE^^xAkQ2XmaxLrt|KK~Mge5UeckT2qh
zKY{*(G~#=p{3s#r3&%4NZ-92m3~^oPe=b1$B9wD)#LMA03~?w9oYjaQ0z0Q7o(dlJ
zV-D@lQN(SbK2{)Z0qs{E;@ME%?j!yf@{87cYX3pdK6D^?Wss+Xuc&+s#9svBMY#u*
zA1TD2f;}f8?f~^g6Y&O!j}hXfpr6`<hRYA-XEBmbhI|jk9PG0K@mi2iK|BS@$sWW%
zfSw%0w?Mv>A$}R^MGfL(pq|`8{5O=JCy1MXJ>MfPOANxe9>fK~ZUeyH)Na2)P7?8R
zz{ex*0M{Kg#P34<^%2hkds-px0(=qT&R{n(lMit;o@3!S260zN?|Q^%f&Lwci-O&<
z5&r>tN)XqE^wQ^lG(I!HJ~xp36Ug63h&zIP+7YjYa{dkRdC(5@h45*(rND<Ez6;uC
z8N@q*t02A!;;(}^egA5Xcq1G;A#M-x_d+}ycqrmjeih=!pdM{ToHuTmS<4o2WsomH
zd>~vm&me9H?bvn1ze9dKLEIele?@#2*pt2|r1?Vcw`HN+{o#<Wvk~`$a_ENmAP6rK
zar$0oC*q#aE}cYtBc$s(;u4VW?-0KY`Sl&~Ah6po&_~nN1lI`}#DDUtEk_6OM5xzv
z+y~Wj8|>@^@+3LXmEmfNW$7VJ7#T}P+)BhjJtqZm2c9@56>&@8`w*w&eliiK*SiA5
zcYvN_h;Id6iFgU{YQ*z^*RnXV(IvR9-DGiMhX#<pi})Sj4J=Odtb_LdDT@<C$5XyQ
zyc6`a1E={y#=sHxo5i7v#^wDXKdHPDmoj7LSe(d%ca8#!lYE~C^0Qc+$d3nZhPX6v
zR~9FF?12X$?hZT}@i5@qSe%4A3HW{%C;C%>pJH($uL}GEixc@Hz#CW`niB4rRu(7n
zr$PQJi?i*}7uq>$=c^z;ipAOb<yoBQZvlC27H8`>WpN_^0pu64IFVlj+?U0P{BPjP
zS)9oG08eCbB2S+ur?WUa{)btd$Xk+xGww8tv*TZf_;Q{&rwQ>W;BQ!*==T8q{m5Wn
z#!)+m0w2xdB%TUfDGp}>ixWLtL4GESlX%kaT}%<D?ZzS&Cwk~OvuGA4da{@waS1F=
z<mq$u{VY!8i-|Dfa#)<m--3A7BHjqR8Sz%&U5L~1X9Cbr6EUK{FA1D+qKFR%J^^tx
z;Bye41AHNi6Eugboyj*AC*j(F{3^ubfbVB<l8;uPr;x>op6wuij>QS0&jGFgCv7eH
z(SF4Z#Jiv!CS$pYqxRt)aX1TLhjJPp`n>?<wEXWx@^rl8al{W0kBn>NZT^H?1iT0F
z)4-v-$xRd7if|>N8}UaEc;|kjLH21pDVKpAVjI%+F@a;+u2a4S_$1g;POoe9dO|r}
z3w<h*r{fi8B2M3z=^=gs(rbh`9j`eT@hc!t^M}UgE^s>}-vrzdaaxaD5vOYudLrHh
zdi)S4bC44k$lGx9i`ZEJ%55m(gMmjOJ`y->FKN0a0$+{f>A3ks#Oazo^g2oPkh!vn
z+rr!Yi6^b6I}oR9L+wR85cFgqPREJn0Vif5^_Mzn*dgB8{C{l?9M%#uWRV!w;a^sq
zVJ0^I>o;KRRa5@2U44aoi$d~<wlk1D99_DDwouIf&~eNjVeGyFIjKwj{^GFz35*Q6
z#rfa$ugLf%I%)gE>~fthY)fEEH#B^@oxz;=oBwa%A%S{?E!>WA{SZX%V~Brjzjz3M
ze!og&iKFc{?}!=K%j}SPpi2R4i)DE`3!u>_-+z!WX!vkh<9;v94T_!s{|ZpKBH_Lg
z@E`y5n6yiO3%}n)o<#9v-j;+<f}p|B@YgWxZ{cUaeNzC~fv4pk|MZw#KmX=m6z*>e
zs32@<_!MttcK#Osa$BB64hWL?llGYUr}00^Fcd|uk4gw%g?seRAC^7Bocde%Zg2sj
z{z>@6BslykhGCry;=F_KX*>xd4$G4Jl)r_a3gJ`#Bz&S0hhI;1(i6-vas8m6>YxCT
z80Quv`?v6OApG^Dp=TTkpFE18{%O3PGK>U)*Df%D=QdrvlwTUHx4rn+B@G+nMo~fD
z;h*p+CjBmM_;8+XoXAIaj8ouk{`^yablZp7q5FS?n4JXh&t_yF%MN7#>5_t({)p4H
zFKGFpC#e1C@e~Lj`!9#^<EbEQv3~`||KIXYWdY9v%_ow7WS{z{oTLYbO?+yOCjZR$
zZbUibNOp{4e%L?BUflLGh$AUO{yCg&BmkB}hukvtH~%IOfBJnBRe}90Pg7BqX1V{j
zwGXC|r4YFC|NYtr86h-u+Rp1T-#99BOp>{GFD7e$hXvU1rc{3;K6orgwaX+4W`Sqs
z;nxE(o`6XbnKwTC(Z3;25l_O&<kFuTg$skn&LMNSgSI!N+~W%n9cG;XNs|QL9h6DZ
zkFc>ONe>_th*?67B$*aoo_O$1HA#w-qYDdwKoU17>d98F-<#9+rWS^-)^--Qrt=J4
zO)ZQpUFVoubL2yn$&3I~m~Z1l$pN#x9P>@R57|{x;+^tv_we;1Ai!^N2=iS#Pj+cg
zXxNkxFArvY2J*ouTaSFGJX;q%WP7LVUtw_J97B6Ub4#mvh8DKG&-X*ZnH3<GdbxTs
z>tJ|r$cOx#Ft4S-0c2@G`Gr&DmrjxQw3RoJpC@m_^)Q9;FooN1q`Awi!LaJBf;2OU
zj7joLc?AZWB%P6yWPs{#FwsWFf+o!D_+ZAfq(5N7Kv9$Ap+t>IQuRNQqP*RBO=Tw6
zncSf^|7WQH)|v!wOp=;m68;KO$a#LxzGL?P<Ud((fK&*RjYs7~nUKj+2Q4N^?;%K9
zOqj(0Xe4+AlvyYu=>lE00aX68lmXHDlpA;I?N3bpM?d7!{!dVU!u)SMhlQ~`(q#V+
zfrZWaM;_K<U{@K&jI4zj*cO2lz3Dr6tS(2j$s~CVH$Od1CJS;iIDC-Fsv45zCP@uW
zE*E%aW75TSCP|;@DiLeD!bX@RpCnf`vUCL3taKd*COf#DC6lBpZ<?rIvi(2ppIe?K
znR3FEXI^qmlGezPo&l2vCPhB12;#JHOEb41nk2paw|)PV61p5k@;0tg#;8MhMjgo*
zm4wS!l-QkRpPg(A%ZF-9Ge3DxC;3npZE3wwW`!8CfDCti6lrgFX5AD|C352nj;xD9
z8e4H%-noqzv(QJs3sxq)g+k1ES)o^cknv+>lFXBU{DBoeXaUls1&)d(Yw{G+IR3AM
zm;3)ic-$#hLYY}eXj4X7C)YoX7_XW8kMrD?j+*FSThfdWmjZnWdK{I$y>Vc$ZT$#l
z&5n}Ij~<`i>p6DZUO_p2v-ac{;{=VJ(jCo&{B7nZ*)(OHSU*^0nxOFL{M<72Z@QxS
z6J-Wz+m~M3wrRn^(Mud}w;p#Zur@s8IC@BK>Edd!xi`Q5UK#trWouZl53^K9TYC4t
z(Dy68rjL3%=DnusrSeTbQ??gvn^rSnqU+EP_vY;|3OtmfHS)BldtzGai`)T24rk5W
zr8&?;vs`ty(eridj`wu#ZCCEP85AgdBWOu#r*irGO1-1kD)r<d4RZa$Vj|pM&zwFj
zHeW67VNu*2XQ`CohMyMyoX{0qnjZA~=DVR0)*+6k&UL6=6V=@HYP-eyoAD!C&*`qx
z6jXB$+rDYlo{0uSa|h(D-C%V$M^ZgugH3_0e7%wUwc@2^&rWUg=}>mMe&kNyXF*4%
z+6rx-_IhlC#{@f{l4<XbB~RMb-ud>EV_tK4QRA)$^JUGy1m*{}FR=M(6YH$Eaaz)e
zt_DW+BLA5u_V3YMnmvBc^JQHP#`~@<>$0&)IsKsPWTTeInd1XyTf0A={@b`>l!orI
z!7qzu-&x+z_F4IoL*^@<9?ecpnXNo=$-oyUjWQ)}pHB~+Y2CUiCTUy9L5tTFs%4k^
z-+6AOez$ht9fg_4JXYNm?@sD=o?|R_T4$Tau|R1vMFGvT4TE$yly6Cp59IHtxz4#e
zxlBsZ;t{`^*vZ3k1$&e1>X&y}g-yM<{$-TRf$ja(u0*GqPM;}umv4MxY~?TCG+B;_
zO7xH_Rr$T*xh8&+mk;uFrAzfGZhP*VVIq~lnNoACIloI~qvXJA(tB3fw`vOd&UoED
zP&s7lC4ta|p)x85B!x;P3^USpal*tTRt2_ty7f^V@oJo7{G!E^iuY^wX)sA2@LB8#
z-_M%itESYbxlLZCUA*rbv%H0-Km&7S@82apt)rt;N~P)n=aSX5Q^L94^3PA@%wJv^
zk-T)F%BJp$jW4cv)tlUF`+3~q?Lv$D5AVG)ceYpf{-o*2-hmN<EzT!AVh*VpGY$8L
z>c;-_BtK+ErM_tndZt$xyZn>%gG%F8W^Z$Cg7eog$wH^z|I``tyy9!r%)0QR*<?@1
zP56^w)#uLX0uw}?I4`rls;MMJ^>teubCdswxH9LO^@p2PBWmp9C%#!K;4QY2Z`Zlz
zxmArd`F2fmyOSPp#vlKxUFF%;%-MCV*&_b(+sZyFyDK9JR$_1jpSkykSqxszVel+Y
zT4T4U+tk>x@-M_ZnT>$CchE|O-IbQATH}vLiZ<xQ^;J1uX;3x0cunl4RT1;o{fOUS
z6`NbGcS%S*%S^T{LTG!?@ZcmtD}yNARVIA%=8W_mpBFDPU!YWUgxkn1eY{1rGPdXR
zdAQ!a$~jA9m*tT7h%CNWr8hl1oX5@xdf8F4Wmd$uO`)H<yp11<AL^HUK<j+Jn0Fm@
z{=XmAclWKdcPiX?#@T<jj-Po*-J-031N$YnNGJ~Y+4y<)X!Qz_?3*F6BOFwk2Hjuv
zxiPSqIo6w2DDXOzPv^&Ltw4*e;fhOMPrs*DZ`D@+zIe%k<LyrMbC(tw)_?#0=BT4>
z%gcjDD>(DLbClLN+O;G+v>ooA5^C2u?ZVs58m{4{&#spxM${kD%6((&vLpKTrlWJi
zweA%-atf@b)JVnHI_OsB8QzMq6Ji#TkZiY^vg(JOgT9mPz7tbR3i9%;PP%+C@IBJr
z9<%$lQhoTs%Qq|Y#y&7Dd}kB>Y{eL>DG4HZflsEVW(Gdj$#9%MxoK^_WB>Y`73&Oh
zGAc&<TR-Mg&yUH-YHzda&~M3d95m0S;G)wd;d<pqPVagg?JBMI`j1v~2-h&0<@)7n
zOf<ie!{eQ<vgc0wFV}aB$Qx7D_wk`0L+=$lWFq@><gCv*)Ag6wo?8`Tx3@eXzx;Bb
z?XsPZvtxE$E#Kg@<Xn5?E$^Wk52j3dUwAXOyfV;k*~;anUyQlSUCgk36cm}a|9M4G
z%!W5-+bx~H+CAFyHLqObgUzx~os8D^aaLbub}G(Yc6?J_xzp)M?{7`4PmX(Gwd}%;
z{Bn=sw#uCa246JJM&vAd5u4bqel{v+QCo6R`=A`dFXJ6#>RZ0sXT~HK4b40GX-QdL
zv!2V|c9&Oi^-5<)<~Kh(eav6Ou`FLFUfVX-=<=9bxj!bf7g~SXo-y~t@YBmqw!8YC
z(mye{V%`_kPRA1mK8(#1h}&zw{ECKXz23_}dskI2fv1i2zZRaH75Y_EzS(`@WS<Lp
zG4CQ}T3-pR4Nn+)|G||zqlRoU;J35Qz8fO`JJPInMP2R2D~q4lW`34QXni_j%BCwV
zHV4z6S}(MjC4W$U{%hq8+iJq?Y-Gy=%UUv&bC!5LK6FT1NFZmC^F+NB+q90R-P@z5
zT|IR7!(C6@&;3$8xB0EZWb3#E7k+j=6!ZPK!}P<BD<@Wz@3B#dk17kO%h@o?b;?Rt
zsRL66EiM^reMPG0`qdp{UmR`{|E{bpVb`(qNVmgm>y;-IZ+B*|7}I`0X``0LLpPlV
zbNBVwW*&QC>>d#5b@jdH^cxEUx3<n(-?jdy(kA2b&V0Fkfs5a#Ihg5b{Y+mzVtI@5
z;;)YnTWhPGvQ~{LTw0US9`fScQ<Ik$YaUfO?LB>`=18~Rrmb1sQa=^%9bEYA<%<Jy
z*@1BfB;t&&I*c28<L-jja{{kvkJ4OxBk7UHjsBC)dQ3PaG}K3Er{Oh?3!0Nt$_9M>
zwO&hEp(Lp7M|9EnHOVjDduhB%{rEw~SZl-x?ZYPmpOiK$&Rg<0N#O98r?>95UmL7i
zaQ*vDje=O6mQo$XdHL0s>ux2QhFb>tKF|M|`>r_O<T3w|BjpFD=hQmKo*lCPP2E5x
z=jTTYw+(+#ccq|ZN|>T=<omD-sy|0u5ic$sW;1xu!=fE_ZA$hIid&kbKfN8K@+@Kc
zy9lMh-<Mwb&^}OcXa4HT%G)oWzL;$hVHf3=)^mBkj&PcbdUTbi!*cnVjfX$lUO7_z
z?W)k`bDKWxw3HNG`Tg~Q$-hdfpY7GIagDeW|Lv;9j62^XME(7}%7uP?mzkAPyz)cJ
zmb<&X&b^y+@5Xr}U!z6kQTs#3TaT*<dGqW+igVP(?Kd>UOP(7#1V;CabZ*(RqrT*G
zb+EF+&Hd3{v!raaN910b6;bG`F+nV_?a1n*olS2(O4%uvbi3s`TN~f;p0D}pa?F{-
z8G5JJiD>5rH(VHDd$m?0Uqxk#*QGP1R_zW(rJku`Q~D?RpNMRWShRS9-m=@nf;?5<
zds&4RY%D3T_4rURQ`5Bj+0I#`P8$qbJ+g7`k~f2|3O1j-uzyD5_6hZg<Hb$itLmKy
zcoy1zwQZu<h8LFahptHLxb5OP`{RAnb%By`0WU7Zl<A!D+%{<LkGR<N4S^TLYQ{9F
zcm_mEpS`D|QubNPCpF}CXP)fq&KsHC+ZqOoh{bkqscHWG+rvTQ$FZx!t=_JDW@gyd
ze*5UDL-Tj;UgmM(YRbxEJ>`e&uAEXFl^3lxDn|6VVOw#1zrlz7QucN)9saFl*h}BS
zfi{7D!h5ECNt9`7JGMmMZpzaLqYEd-G+#Mz?o7w?#6;_c@kO&Ae!XC@Qa<I#`A(Hn
zZb_e<>gJ|B4*oLjqi1`(c-zXaF*UnL|C9DR6W~D)J&sCWYTabfq&p;C;!;EKNP`mj
z8^e4TNUzy3U9F%gBq^h{|2cd8D$9?2Ch_-nuCVTop5?ReYDMei`)}Xw);ex5WlrP7
z1E2cue5u)Yq<Z|SoH+---V@lPY9>(Q@Y&?%y62I8S2p@QdafHk@4Kl(wUXVBk~U5G
zQ`^lJ9~x!CiR&}E-<gL3om$2tZjHRXcHfqDWoi=ns~e>@8AR3BRVDSgzgXF*{*}?M
zwy8o7yPG2ub3PZ&OS|E6zHs5l*)3ih&PJTq7Ju``aOpb5=6!iF*W~k>4qJ2_{Q9Im
zRBYbw;qQhj$CqsoiJEqP?Y@R?^CJ;ArQ!z}%&%ScLZSZDUcJ77e!lrGC)>qrpET_;
zc)IS_kMPMQx5|EeGqf+zEV_C`Y4^Yn{ra39Y2Y^?e|Xo1;US|{a#NZclvVauUzk2<
z>V^3$53byI(r;cy!s`o%t7c4Gx29*se7+~e{eEPe;*9NCV&b5)q0;v4cbn}aPlWBw
zIAFZzg-mM8bD=oLOIAA1zCS%<T-8?W{N-eixZ`b^;f^=_Y+WzJHZ@;AnPvatgY3u$
zFGmOU|Csh`QAhZStC4Zfg7zuycis9+$ZfO>dG<u}?=3tyq{mU|vDGzIRadI2<AodC
zgopLjskIuW<G15tN@nN6Y=QXn_?aq+)+g@k`n?%uw7zv%?Zgz_UqhI6nl#lVRo4|u
zu2Ns4tG=d6ZOyeywl}IJtIoUMkgRQedP#EK#3_SIEfx)3d^)echr;wx7vra|&(&A7
zt@jaLd|Sg^c*Gea)v1do4HI0qIz!4sB{^M2MPbOO5v#5l)p{Fc1W)srJk3MJYUs>%
z`4Iw=xA<b#@8N7zJ;qlOFkscu^JdcdA>(9IPo*xCue-NBrA;#P>Bj8sLlrJuNt!4!
z-I{OAY+sAPUSjtW)~ww>)I&PiPV#Pza9^V}v3GY1i%#rgsH}X;dC|BG*X=2*6g?(L
zUsV=)wU9IGo$2>Kb}A;7fN}rW$>~B>RaFg#UrM+xV=Ld#HJP8Zc3FKNFP#0!C-YNh
zzmM)5j{io1ES|SN{^HPaRC>M}<CryR+&Fiws?I;T*4lbgd{1qah(zB1L)^Q7Q}IQQ
z-v<d@+@qujxt6FTiXwz4qEha6$t|Hss3f8!-9w^;Qjw$(MJXgoMN(3shzcd8-r47@
zt!aPj{r`T?|9PKxKb_9ZXV$E}_S%=3Iri)odHGiBd0vtEk4DYfAR?V~Y`23dgAsO*
zbL8&@l&<CQ+wO0>&aBK`K3Rvq<=DXFiwT#K#rNrOuNBrwyUD3*d~klCU@Y(Ug#DeN
z5)lc4nv3;}g}$X4CCE<L8{7YleUPDDq43DXZN)|xFLuE-H9f`0zPj~(xG`%!m+12|
zoAyPA9dY-bRxMS>zqzuqq1AYsc)Hc4)|tW?qvCc<e%X@Urd+e#CgxWj6$D2pn!k>t
z+Kyc?{B-M{*X%~3ZHokpX9e=-8;zS15$G6vuD;sr%f$<a4y8Vs7$GQJ5#Cv~-)Q_q
zi6?R8hA9m1I@P*|30+$*+{!TAR_AzQ>yZba@^%I13<*CNr(yPHzq?$dy`W;-hHVYy
z3dT>arB@YYp2#~rZOP-GAGxw;%?+Q!bu@GCp)*~xEbZ1mF`l_CXZ)2qgL>|afb_Dn
zGTrTBZ#P+%9vfYyyForfzB%(r>CYP(?j7|xPF4m-SJ(cue_4FBJMl-S;KOdYLH6nQ
z-9pcf{d{giNbuDuLnhL__a*W}#FkX*J|FmCFw-zz_2$pd@?UPJH`>R@{0#Dtb-S*R
z6jykSVbyyxsIq<aVf_X2V|PY>UfnSIL$1l)@c7;7TQq%^$=yuz7p>{)>C~tSiYxv!
zS37ia?{13<Ww{D5#e#mb+(pwh&Du~?!Sy<uHpd8Y6qBajzqx=Jljixgd)^Bk?OvE!
z(Cy)AJ;~Z9QEr@`u9Tu+E9c_s_fNlevrA6DU7LK*N<g1I_Hsv3i>sxhs7t`?%uLrg
zjX8^=?~1Bd<zE-M`6Jy`c&GQ?mYBwScgEXAW`+ve`I<&QTNc_PR&?mfr?izN*(M9`
zdM}E6XYGA!dFL9TckR*kA-#%Ic649KdDoO(|9JUn{)eLLXNZKG=X9>}a(Vk~^?*(+
z6`AJi-hu<=i}(BIR`A&6SF8)2^JQ;#ptas)C;o8dsqOwjo39oh&k?ES3N9^9ss8r#
z!R3y#kJ}zx`!W3Oef&4iPku^%<v)VH4Spyp>UFo@b@0T^)hqY-bqb0L8<|LC_gYg%
zU!J7n{`SSU<S*Mfo^R!ddpbt0k+E(P!{v<YSv%MMs;KcV8#Plet?^b`zlvS#Q|aW#
zA6|!s4S$gT`C`NQB_146**E)A%39{X%o6ut82WeFBqu7CTo^4;vrK2+?HL0~7o?qT
zsC8z3s2(*};`NtT-`d_^eW|Sd<MX54Cx33**rZ^ucJlnWq*a3=T;~?4DRu`o+u8Wc
zQa&OvOL@upMXR>7`wNvkIWp_|p4y$xg%Oum7cKiJ^;!S<`{disle?6ua5alYEn*9u
zG&g*-&G)=Q!Dnp|t9WeRi<U21F-mIxf))*@uh#Aj7x#*>ckn*9xbs=)P@kAWLf6gw
zdj6IlQJ3>B`}oGMjW3FrW**RaUjE##4{@9e7UbM&4K%&BYG&*5V-NB}uMaIO4ZCro
zy0WQUZP6YzBg30JKJ1NssOZHbK6%pP>yLdePx^82+=KY)j^+pUDQn&xq+->C{}7RJ
zHIUtVB~mdp_~dH!*o%D|1dDhAqZ6ZpC%od?@b0<7@tif=cBXsBG_-NbjV@2CFcsga
z<0-T3Kp{sIW0LCafD8Rs^ZI(WkF9fxoI54Bb3@*o<*RlVzpZh9T*aHR`1I3=viDDq
zva1Fj_CDjqc}HqvaqsIN)h%tFvZc@OUugf@xBJkKyoz1E{<|WzT52TTw)h9loTsyH
z&5_eDq^r7aKkELvptVtBLz%lKZ+F00W19%)sfy|ee*I!nkLQ<oIi8gYpMIn6sj&E|
zyY?$IHf;**t0;Rhqo+OXY1kY$sVTC((;A-LytH-cja%y%eABpj_`@&T)y3<N?$pv2
zJazxZ$t`8=uHF1|&Ga+AZN4zdF0kahk^bJP3whlX4KH|h=03?fKHxqO7GP$lJ$K2Q
zE$@u9)tjb^7pmOp5^+k;J9K+zfTl{qMy?XYiLo0vmMCa^{rHBrerP`9my^J#Z%?Q=
zHC!`qa{9~{7Csg$^3cXndO^RtEW_uqjeurMx__kIxpiOaPrCMed$s<?@mu06_8&;>
zVw>8YwnK_%lZIvgqjOU%W^5IeUGdBDgXWj0y}|e04w|m~>08Hfc-i}LPG<uzt`m-w
zww-Nz>r#)&={?mGW~gSVZMbN5na$;;?q;1!4|0c$C;eQ0SZ`srv2&Q|x*6`R-jfv;
zaNo)=tao`ZSy)(i>TMmvt4*!nB6;gm^vXgHHtmbAkj%O#aOFkjslEQ}CkqshA5Wdg
z8P*rNd2>Z^ZAoX_v?i&<$NL1QJs5xL(1LCJnF$GlqF+V_iluI!Ma8FCzjaK@_@zA?
zX7D<E;yY4aA@H1vPvaxJ%5<7~&a<d^p|6FOb5fJ@JePf0RuU_2cw}H{Ldt?SUZ3|G
zo_O)_imtotqPGh_mM85C4Y(#dK2Lq)R#85!QyD=A4nMg5z}r^CnfJ<?uFWBrdxwq-
zL|P`w?O)8pUdle$x;MaED`V=SGe@&--Z$Q(r^QenyW#TTynUI9X3~*PJ?2vjHI`MH
zlzHjgYl!=td-_cZr@mL^uz&l^uxze}T;FZ?96hG8+U_$~zu2Xro6V{}YC3c8TS=s5
z2wH3txmnMq_hEEZ@;go2$qySx-EG`*U`bL=gq+gT>G~Zi-!59tYOXnIdHrtd><MFD
zF6sKRi_JGEFEK_~YDK~EYf;KqkD3Wce2~g(JEi`)TYCG~Xc?bDvo6QPqgvxKpWAF&
z9{41+)zsR;Dr$Ci$?h(3wWzFi%Y4R~jJ>iUF6Pno{s%_oX&EuB!VM)P9#w`vs(kS7
zwdgbsDdFy|#cy3Ehu>el=H$gASDkXaO4QZXrN_9Po+T3*a?-f#xZC6>mmRiGxtW+D
z-^BUj@D{<$llRs-ZLMv(H*jNF+7%boZu6WMdM}RMR5GnHs;-InQ8+g3LSXQscXOl<
zHohrR3CL9BI{qa@W>nVbJ>TzKxi)>uw+iJQul=PH!_x%f1tQb36y#?%E%=~VejtD8
zi)CWx9y_xCeE02V*q6baeC^SKRJ0`9s)bg3Jk^b@Qtam|>m1f?Y)H#q`Xv3Sp>vd{
z<6)}{&UHuICvGZR5IUc)T1)lFTr<-!KV9pG(jFUMw6h8K2S@IVdn9Yo+@)r`CHl6^
zoq|)V4)sKTkq^q)aWiRV@w(>^;@x(AW=~Drs@rqgI(wr{XDa(BKOr%*G1~I3B8Htj
zs&@`=6S;HC#^g%4@#Ze}qSozSj8r>};|~QY8m?FR^ukduPtfA52%pGI*Qs|;wKup4
zOPqYq8GCae>1wWj?uot5l~!Bg<4^81npd_*p|j(HVUWXtcUi)6J9QlwZ|OEa&=Ngv
zn%0BsZ9|s4N3J&{Y*f3VYq&}E+gzcf6>;G+B~Gs1@x4)RpMCh9S1UHmR9dklcxmgS
z&uRnXe=Ti3>hRO>(S1Du&*z{0yvAO)SYwm)?YmRrcbA^<J1Ju4+B6-?Bn_7I#5hm5
zD)-W%S*++m-wqA2ESEkRJMSXyh087O4o{2ZS+xA^_6bkV@n7<tIXcvtarXG#V1tRL
zd&=trYhQW<Z}l!PZRkjw-d}Y>DR#D8*~v9ROTQZgYi_kqNLDC~E7MjKG-_S(dAeHm
znJcfpd%AC&nzZeMUDk!3W%d)kWFM(a?%!(LZ&jEz%VquEFN>zkn|09n*!2_ZzV@em
z809!lC-`*L{h#+3jvnV<i&*-PJs!WPwzO=W#n3W7Rl&C(L>XhV&#XA7@%FpKEvfPY
zFSosuFx7i~d1=9%CyOuSC27pfyl`d>zq7h&&D0G~_<66Xn8i;}lhyWL&{ff;biFX7
z^Y-Qf+4HgE)hzeE-|D?yQ0aP=^b4b$q!%JNtCso7j#*#m@+q_C{=5xF2L(D)SG^iE
z3VyXaW5D8`v)d_s*+ISa!%LqXdFAINv;MGFNJ(V9{QYnDp4GlQc1D!X>yEyCw$xPz
zAr0eUo`lpQgL#%-S$b3V>WYg8Pts(6ULLga=8G4t8l?eJ5t5-?Up<6Nb~c-wZ(F)$
zfBUhh4jp6PR~{ip-d|I1AG1_&Skxi^JZqK)zK>)7&+~K6fo7j_74E1$U7iK`kCih@
zjNd%7yY+s_sQJcU`^#6$nOexLT6Zx*qHlYdS))*SWk*u=Bi{3ek~reu92w^{*s#Lo
z@U?47vV0~YX-00J8&)}<J}@d>V#-5@1%q5YYrHEW=gGOJ+&p{eX3kdbEs^)uHQMpM
zc6@p@KtknE&dHVAD~CVMU&xT1yr=If^}@oZV+!u(jBSrvqi=0C$PTh^%lW?fVgL1?
z8`cy{<<9STx%*mTU)#5{kJUZr#;?t>%WM*pyY^<SiA}@VyVDJpbY$D#h`9bF`lP>w
zbw~B?x=S*aX5|7IS>to+om?&izPXY&zERAxcOKi*8_go7+)eZLD1SJ;?9#4@PoI4r
zuu?IMf0y%}{p^tF|03)Rdi;^3KIo5x|2HvbkPi408zY$7W|;Ew?__5;9>dFRKGuwv
z8$C0lnp{kMP+E=t)8mzNqy&~xliJW6NE^hc#EqV*b$I!s*mZa(?xez%l`ZDzV;jRe
zQID5jhnJhVydCwI)sgpS=Ax6Rgjg!tpc0+sv(N}bvl{LKJC45Td0moZ-$G?YAu22V
zv8YV_Aj_N=P1&%TvRP*=W!oxVNpxHo8t31R!>RxILZ|#YMh-M`;;g^L&Jm_$*l4ql
z@Z2PH>i<4=4w}jIXF_vZ*_f-wvpCkT3mos`ZzT2aSUb!)0xU(e|2go24K#)}IhZq}
z2*~6@|AkDByzysROYO2zEl(0KOsQk;aWLS89XN)*T&NF{$4LTjP~RLhPQw(RMBg3R
z=3vek8`&M%;9yJ{*`{xBFjt4C6V^5dL+ZbfA{@+U6aPKLG4iI{pT{^Ds5bvhzRX>E
z?Xivr04F`f?Az1~IO#vtFj((Aax>S-rytr0dKS?kwH*z71;O_Mw<b86Ba3F<;djOG
zVb;4V+zeX`;5&)=&COty@Att|z*+YG=4cKq($C80H%AkE5Wn*qF}GOn#&D0klZOvq
zV{ULWSjRDCFiM%5|82LoLB9I8D02(#3o>UlvJSBPPR&K6cF{OTrY{uu8|S44n!j;0
zXY+4-#y>ckL;E-RmH*)A-8Xs+B<6Te*|_B&^4tHxkN$(7{|CQJaY4rKag2E_q4ItC
z5Bd6kaP+Rt-^%;uA6(-f{Nq3P*MD#nbK-CL^8bTR{Rf}^4?goBT$|#8v?va9p@Eq(
z`R{QXa}<k0kTz~(9>L@=@tM-WyuMQ3Xf3|Kl?$z<E;#Zg@9%eyO8y~V@ef|}5B}&M
zyout1wDBLm^YpiQlpB0}H~Ua=kC?MP(cH>Se@gv1MTt3s>5th<%-Koy_HKbb&i3}o
zs*I6MW|*h{_o!0LFj36-P|V0s^!QS&$Wp9mQmpt=tcX*rC{yzo&R(vLK7oFJ8vgg7
zQ8?C;*ZNHX_HI-G1MI1IQ{D_mXB4$*Boq_#u#f8&IQr*VC=k>i1VTau`gpDP*<epi
ze+~5Cv_8m{;qU5BW#j5kH|%$Sr$1Eq1#a@N_i%M|`BSqq6@iMH(Mo-`tPl9JE~wg}
zB3}7Y5v4%L%h%b_3r&h;P!Xium>bLhS5!zwXU6~rHI>ZOCy2okMs>@aHEZwaw8_^i
zkjjG<OUs@L-RMn8v&zEQ6zq-4L{%i!D4aLgJ9})fM^p7!ru-2@i`g1R2%a(gCxywr
z%$Qq$9$`%<27A4{9Q~+>TTF?+&w$$$;Nt4<&v0V~>T+Yaxp`6kV>mkb`h%DLbK1zn
zI()}TbqnTPcpNK+55@rn>U$RT!5rTgA+AE>iqtkrq#h)L5|XF>3NxYy-xrYb`bd~c
zNPaf;!TFjXNF`E!B?~j<=TO^NejRWuKgbFd_RE_lkH#)6&qc_82YGxSgzT9|lgD>*
zSU=W-{ea}vY4T_rCB)}bA1tqpAeGR0GpP^e*bk)sWk{GxNRI~f!SYiPq!Qu_s1N4K
z2vQ00h13Ugy8ne~+>qKv3CU|wA1rTyAe9iO`@xAxS@nYSz@ODdV(B1xR7R|4Gsq*3
zY`{DcI4UoCw!%CfIFesX<H<CxL*qp>u1n(;G)~X=K8@4M)c_pXgX$XF(?*kDLgRfj
zPPb<ib-hQ4EHAo0Lka0eb%*tf(B$d*<!D@oCO@CX)o5IY#_8q7F~m^55;S=Wnmj#U
zyhaSNpPuhVnmk?qR^Uj#Bu)QLnmk=Uen*DXe~Kng*H4cXHjSnqzl)CYrME-;ZZ^_S
zZ-+N&`t@jf?$bExgScLv&^X<mQ7A(yA^ir_2g{@P9Z^DurKk_)_&F4DX&OgmK?&)h
z`$vgMS$brsZLH^iqJKI~{{IX8vi}$Q@e?WOA3RPXj%09o(O85M=^t|zW^yz(VtG9N
zBYAp#In(6n{XG^q%9rlv!!&t%{f?z^x*kEA9(p^JpmBL>8{3I|h!V;d*^2pG1gV6s
z3#QZub2PT2gyhjN%yki@65{A-6OExL8L_^Y9JM7ZZwVabxtzwWfs^^V(BxOp<UMKJ
zjK=?`{=xRp{eylJ#Qgs&|6u+9fB6U8M*Zf*dN;ZO0RBY=^EU(^L+y(ILto=z8*wq}
zgP!M5!tD@oH0GddKT7yq%vto$7=7qhFkBzl|44ok7N)*YTS5uvE5+Jn-jmR|0}t!K
zQaFy~bw{%RYI`VQ-okwOhQV0H!Xy0tI2N!W_(o0^!2KHQ`34T~B;*G;SiqOyE8qrj
zE5UR4SYS87tKd;Lk>IuPu$xKnY$$I&!9Ag)+#q;8RBRQ&7omnhrDoRGh=07HV&4%w
z1nlo2_yJxP7$W#>@F#jV7$xk_bg)N|;P&7*34$v?J)+;0=z5x=J)qxB=-dPL4G69X
z<+3C=UK7-b;04f5{0MFa?IDcdcny*`g5$MCj}yF-Wi|ufhhYEU7*hp=yb!dv3WA%1
ze{hUItmhH<r<IV$F^llpE?6GNR{KH7XQGP$mBzq$faTqx-A*KU0-P^P@Fp0L@R~|k
zk2<smT|!<PIQspFnLqU(8kh8e<26~Z9uweRguDgt5Q1L>j^EA4dcK3-ju7%C(C<zX
z+-nrmJO({>AF{Io{BxC%$FVQa?@%b=d~ZPeXM=ji{4=ySdh9-=zY_X8jy;3r$3cDJ
zH6k&`F-mYfV{Qfct|9Wp&)Y5pe-8b9Bf+<TJz)fY4DB<P;36=-;Wb0CJ$NnLGlcvU
z@N*u)pMZZ#369q=d`R#xkbgmNdni{I!3AO57$kTCjED3XdZ=DJg;A|i*G;e&muoHP
zmmoNfA&FxiV0j$NMuU*YF%Jz0z8sxMB^)CS>v;$5)`5`6*DY^?JK+98aP(UPN;t+0
z)-M3#<S9b_2#f<42>ul6ogPCE`Hc(O;ax)h3AE?O1Xl$Aw-I~^w6|V@<CqaY2!033
z%LCUdT&``vMF`FYT$<o}!OwWjeXJ)0#uF_<ULD$@F~Jpae<ZjZQb;8ig5&e?{R_^w
z6v`P!$R~pRthai9k3YA;Z#ZTi){_M7{w$#f#~!&t@CdNKmf+ctZzIV;{|AEq1l~t*
z0ccm>2>ufK9bT&%+kYSI;e`6Z{4D4hOK@S>7bG~2ohVN5wXm;1a4l%(I94UjcM7!I
zC4_uDTrbQBJ`d`}mf(A!T%H8SF;8&}8=S8$w8Kb3{x0k%5WENMNg?=b=<nwUz5~X$
zLV|AuKinpGGt}Qhg0F#kc}eh<V1GBkag4if1jn(=MuVTQA8MhU2oW5wT`Wm(a6e-v
z!Fj=c9OD7&kB9MUDItG_)qNS31TTkuM}m)q>!}aHd%-_j365h9L=*f9^t(d@KMeJl
zM(|f~pLUVp_<p*W;5bIZJ%T5|`16F|c+J1p1n-0Up^pT|<MS}V@pwK4?8W}a<F+Wl
zWx*a9f@h%<siaD9BWTas1b1YKGnNtD0{B{j<2A_L3BC~8Ng%;Z;C^E#!4;t%_Y)k)
z#7ic)D)irMg0n%rUnRI0^ot6D&jdT`2|fY%3xbQmxZOqYPN?5Of=>oNb3*^d^~eTX
zkl+r`FC++#?*nEK+z-YD4T9rw)_~wRHYko&gYEHx_UB2+=fODONAP1X&Ib`3$F>M1
zIKFS*LGVjZkMx*$=zeKA_&=VI$FaaN2%Zc6JWucp=ofheKMU=lkl<IKes2&QuRUKu
z@DAt~)dUxWe%D5D922LL;P{6q9McQe%T)0H03rVn{67xz!SWU$kMqa;4ftmwAwL)N
zP9->wfjphylc9gnWAUN-dIx&63Hd#6AGnO*r-54$Tn6ghmEcX_XMciE5M><*CwKzX
zV;sTD!G0Xu1|3HBzlL_0Nyu-6c7kKHV|g4qm>!D{>G=Wu{~@7=1IpD(a2%5j$8N{^
zZ^AhFgOmrqje&6j%OAn@OK?06$`V`+`o&y=<CxC61V0Gv3im&pZ#r;0LjEGy??rGu
z@J|TAaZHM6f@?wf4-<S8aC%HU<o^|LKbA+xw*oICxHq&1dh9!-M+5A9PRKXHb?QCA
zpMyR07<WjI8uZiAkPr4-80-rZoDKXbMeqR_pH&F{8SJ6QtV8(*z>S>=A&>uFxQ^gG
zP+kv$;}~c`1fLJ}8%gjc=ywMQ&ISE6mEaDL?*)S6nDWI0cY<<N5gb2{H4;1z{Dxx(
zV*f9J_TNv)OTjpXV;y06UdWdp{EfLQ)YnvkkAeO;gW#^<A5DT!g!W`e@GH=MRude@
z+HfKGX1IU$C-@>LX9U4Hp<nDHIMsxh3CD87<sE|Z;^$q=6F|O@&?5r=$M?Bdz6A1Z
zAmpEcooxh9gZB23;IU9&ICd=7Uj%#{)C1<@fQu0v|2;#V;3CjI=Mmf*?9?N816)T|
z65InBKqUu)2ZMebD-_$g8_F3<$ScA1Xb-_d!9Pa{9tQFm1V{5aQOYOyE6{U`;6h+e
z9l;Mlzj#6L^|0Sf@L;%K9U?d$f4QN(V?Pvv-$V$01lpAh!9&6SvkATs_+o<Nn6AqS
zj_t4^_&V^XC&7o|`o4wWozPCA2%ZG?93*%@lsApww?O|Tf`0`6-ynE6j3+e&&w~4h
zX9PbD{jrna=RyA$f+s`$je_%Vec}5#L4sd|dY2@)8R%6e_;HY5Nbt=tZW|N)E9_el
zyb_+v+z1{3{tP5IUW+)K;B%l}VhE07!5k&{F!ZA|f>!~*033Bg)TCe-U|c2S+rZ9p
zLLT*9lxhfhb-2DX(&WJfO!-%Y{5u%W-xK^g*oj{;!S#z{;ZA|}i}_imc52QZ!PQ}$
zu_U+x$ZsI{E0Eto@X62)lL<Z>>@FlYj-}8<@H)`bO>jr>GZ((UrtCxaQHP)(sS<oO
zRG2xzaf}`>g2#eCqX~{<mZlKg8|*0}IQDxb!KZ>B8VTMC`&|V82>pv4^1=1^6Z}7s
z;DKQOT!QPuc(|0{N5MZPz>!*TIkV=S3HfPoeZl2M_MlrvP|w&%lSdqeRYnkvqxw<?
z`y*)i!X|Z;!HA)8WDg8Kj5LB<F{K#{{JSYq3qv0BNCi!vuD_nfk&7>bo;L)?{iTP-
zkv$$D|DE7Iz^8&kaDAD>cqk1V*@?@9PSGUf8$gd9jU#_925v}j{C6=^8mIet4RDk%
zGFcMzIM6t<2ip`(aO~%OG*0*P2^y#C$FYP_zH~nq(c}@we!flP$QJD9hXlud9srL0
ztOVo0PntY5SxOr<_Z7w!+-|*?lv)p+;4Z*rX&m{p0k{f{qk6&fcjprP5Xi42cn$E?
z1iu5^8aVPBvR?<dAB`iw9RMCe<4ArLaC)pZ#O;6=5c2N89}xUF@HXJs&pF`dE}A^<
z>*$m*Fb-iqcYz*Wg1-eWMB{WnPoZ(-XFlW*DorCe7jRkNXcyTt9SKuOoyL*h!kCo7
z(52}?`P#tvyNo6eMP;7hNs~wR%!7P=2(AKr6OGf$g=4{C|EvS~?KF9$AHA1`QWS8s
zi|oPWIzr>9T)xx?CHx$Q>#G+EagHXBj^Tvwcd$L%A>UfU9y}lV5slN!)k5RQejKX}
zKd)f@$)LZTum_jxD~+Ra;daZ8lu`+oD+;cs<AEc!Tucepe=>wTJG5728b_OW-V$D4
z3EO!G>{O@8qw;=$@!W;r?_sd<p>edy1~+&91pfv4H`6%MABGH|(ta98o9I0`lnxS{
z7x*#Y*bnwBaYi8_zZT?+3BC&WO+pWDS4{-R&*MD=$MrsbBFg~m&yAp8fZ*Q1MSx@b
zuYrG*XdJbN6;LiU8b|eh8{|z1j-R795d0a)M-W^J^dBMkY~Z;BHv#^T;A?<)6Fd<(
z8%#n)W}tH6Btqk;T&LiG8o^6}TM_&&a6f|A1CJ(nJMd&0NA^HBWaQ8|vga$v*ASc=
z{P~99V!*%AIMOc-dU#NyrxFrF`jtRlp5P0CFDAG?a4Ul2zvFw;ILcR<`k=Ip#!<d_
z-ewZP13`a2!FL0{N8?EUBBY#3O*D@5qxXPO8YDRGFZ`2P$B`J4$M5}41&+r(ZI&2A
znkLT)41H-5^7y_*kH%4#-3$HBkl?$3n-coLY{oi*V}H66d;!=LKyciDchUGvkVRkn
zf#dSx`3=bg$K|>}(*uvzOl|jQ@~FJIP_Fv~zX<#Zp$Bg7882z_s4L@pon9J8`tO0B
zK7yA5A0+hS_CEn$a6t8r?4L`0P?93J5eqYB5qvf9g#_OS+??RJT=u}RpYiVo&ICUV
z1@<5~{$0Y0;8rkjY$P~-t`8)5IXs7k5PT8bw}kzJ<JeBve*8PYZbDuL8U<Ybnd1z4
zj>Aa@Hjw}MFr>b{X&f%?Op@{sexKm@y3kGIxa}ask20hZ`l56Edko_A`%i0{Je}{L
zapVh}GXB9I(Ks4sY~cj--abm`Fyi=nCqeKYBt)fk1P^3khCjiJA-{bzP9LxGXdG1)
z_C*!Jas8n&79~_x%+NmE4l?bBDo2<h$^4&HE_%KyG>*!P(_+{_X4Cy?M&oq<JJ2|`
z9U(s&r?;O78mG6n{WMN*pZHv44=NY#zmhb0dU+LToL*i$t{^@1^5W|iSzbKeAWko@
z1x-J_yto}9d2BNh#n17G)646R4pIqmdU>Uol;wLgWa8_EEWu-8AD0)^6_S4r9AB3(
zpM^4_5^mR+<L8}uti#MYM|vKB{9=ORexgtC3D91R2`&#Dmjmak3fz*A$1!8q5*){j
z#m_@nk0I!BCgkyZ3)ufy-U{Ts33*50xL&Y4zCYhg$OnUbD8VCvZzp&>@F;?(0LS%-
z^F0e3_Y2Ig06#?NDF%L=;P|?HlHd<P{xreSx*8~DvA#yy!yDii2>um#A#l`e=>2gz
zv?KII?~nNX9mMJVF%|S7j>?SF3mT{QM{&pu$<zDeIvS_<$7?iB?~kM5xfbc6_eV)E
z0A)`vmmZDN%jH1h^m5^PM0)7u!v05`UM}oU#OdX#q3NfWYmmn2<(h~JL?xt$UatRL
ztYcR%M`dcUjsWGqu1UfQV$3}L*R?_Z2#$<mC6B0Mu7!cuTKUh?AEe;OG8|L@zyD|%
zIf&Qj`1jeY(0<J2I{qodTDjv7%l{kJ`9I5XFjtBpb^b?cWYG>#4`p$23~)r}Dl?Zn
z!O+zy(A}OH;!oLyx$WrW<nJ2v$6@LOw6x2nKcJ((qmR4mpUmIK{l9|LQYfwrP);qE
zf;SPS)<>cCoqfH%QRqWuAKw61WonhdnapKVVBg&*P}$Gl*N=*O77PZsdf2=9J5o!w
z{NE>ZEkaEg-}hjRi}42W4b6RoPNTLEqxW5Oa54JtFNr)~j*>yQ=>Iw&Zr?{Vk^8FD
z5v229_6Lug$=cv2_GeK0XlPnYaBjH3<KG=-f*j5tJ*%N)PJRBCe;GPRCH(xv+WUPU
ziT6#Yjlbp3KZ_+%27)MmR7Ns?FN&f3@qGui$xL{CjL#UrH}*gNj-dG8?B_=V8kO+x
z1gyRP+P{@L@HhMG!2bPEvB-WNqz@Ef|Do&P-}0A4N~whJD_ML0&HprY;BWam%we73
z04JjS(fCj1e}`g!%irODnEy@c{J-U2_Luy}|0Vy9f8?L~Kg_@FANfmy;~c2tD53JB
z>lRu5aa7^|R{mDVAK&jF9Vn6g2mO8IZ{?4G{L7eUvGPaPM>2m|$e(P#5pdB*;{!e6
z^O4OcX~Owr|Gxz1`>@1D{wM8M`-lCD)mW!ULPp4c!qf-nkK3=qKk}CZgZ@wXqv!6w
z`Og6!80h(<pFYU^cR~KpU0Fs`|L=$V7mN_r23h_Ca6UQy*1`FtJkB4h-TM#wBh*<E
zDj<mbhkl~P=VSk&_tdC=zYm~oDz!rXk@TB6isSQ{Lezh0|H%Im<i7<BK>4F<9X=oD
zkJdx{TmBw!Gl$o?!TI6y@jm)H&fm_T4-e9E%!63^cm9~%q>lfs{^dPb5_jQzWdBs^
zgY(DsH&e%%BKQC(#(#g;fqnc%h%wN5J%7vp<9gN^AK^rlza;g+=i~g*`&!h$-v`h(
zmGIx^O<B7m|Ksy9c>j<5TRmA4^!%kLgwMzMqjiP;mj58?tW-klQPLAWA2alKvcHwT
zZUak#e*Kc65I!I0kFJv_3o^ESE9$INDn}PRTEgdJvnK!J{7gyKNq9aBRzaSxgwMwU
z@cm>OYeSykIA8pY)+@l<bkU!1KAoX$QdW;TA3cXrUw<Yk)-LY<_#n0)@7qBB<oPQ2
zd?G{g{58~xf2%(SUseu{kP&LXO4J9RkLwSqC-X+9I7p-a8H`J)a8yFKgGdK?KB``F
z?4%HbA7w_RK|(oE9Og6Q-_D=!$2uRaBT7%?`LpKCR+Xfs|5I%H+4I!r&SlE~&tuzf
zarkY)V&>*zh9tG}4T`fo7Du?&quM$Zoq4^xkE@Ghfa9hOk^#Pw?*6`kev;E&7)zKd
zQnL8w^#LBgkNj56&{?HpX%zEgm0`?)1v9R4Y?vV{&T<z&Ge&eQ$Ikg2e33Gg6AWXw
z!7(aqx#6y|z&3r=4-_<m6UOpU_Qf(N`2fG)7zw`9-}NC-7)6BEi|Mqs)v?jBEqCLS
zpzJq{<uHt0Y#4j=G?l@wX1-n3lyR|#&>jlt&AcNpgg=b3LGbmz=|LG>)`?A$L5pPU
zUBaeAMbt){EYo6=kwPj~xlzn*7BPwGHH?9P??$o3GIjjaapyjhnD?yXIwjNzlnE?T
z{zrx|%fmYFUHi{pzgXpS?!)R?iYX&l))>W9U{g9qOnJvft?fvw9?CzZOw(ANU{yRi
zj;uo|8eL$ig!ic!(v4dKgdb1g`gqJF?^sJsZHre>pG;vS<5h`_te(K$w28r!mhG3c
zT5{?vTSAoJ^nz&f`C1AMf+3k^8)oX}Bo&-}XmKS!e}eUSha9I3TEY@%3j98D&pcz*
z$+oN`thBT#Ioj{puycD@PtEh-;r16VTht~*CAc3gcr~p2Xl!NS-HVdy_7`=90-MIY
z^Ut1Ut$g?1qjNgff@2Q{O_J|u5T03Q?UflJr*Kzi&U44m+hX1ObMknPoc~mPZA0}^
zmnwT@>-`FgEE8t>&UpG(aX~}tnzyEVdp}p7(kpJB)p53ZdB`~_TWyD5=Vn!^nAjGq
z=(yUcwo$ow#l>j8?Gryqq#m5lciNw=JknD>(bz)6Qrgwr)N<-$lU<o2iYGnOZ@GP{
zelbvB!RgkfwqlB9L&d=6mAfoOSGgEm4es*Eu85n}_e9GwE9*kv6TX$M8N*Re+dZ=%
zS}t8UuyTp%z`?6M>35F55-k~UQ#AEHb;rCpYn><8DtCh?!ClFgS{FB|tG&p7`L*_H
z<-~De<+rUBuSkSz^c^l}<KZrN#dg;^L~!QqxH`9s%BNp$jNu)<je{dVCHT;gYx?K&
z_G{l%P8WG~?~|#4tl*NjhaD|N8w=-&ukKhiu6}p&8Ux*@88wE%Yg25NyDYwW!(^1c
z;@CU^;Yn8e_of;u+Bklrwnv?gR!ohWIPP@JG>_DTiR)CXm-4BO^N{t75OEqM=5g*v
z|HEAdE;4nsGt;;8I?bpvI=$T|O{8<$`v|+Vsh!ed5%=|^FYPL1Z(MG}(=B;{JxEY!
zdrQURGP^XM#uYYW#U*9gc1L$@Pp@!U`g&A-Qr*Q46J9?dhocRa-zu`!zY5&4q@n*!
z*}~$q{b6sXZJQWUQP*m+K7Y-aj;@rf)WUKlYwp~#hZVEAmW{2pF<7f}Mos&X$&od>
z@&iX}<5R9o4@q*@ZK}N+EOK{x5PO_bhg`&xAHoj%H5PFRR?K1;BvBEkBO1r6{7CB9
z?%B46;auOu5hwM9eVmEAgrCMI!7};4Fb*62Vs;gm<Tcy7Vul&7p9YUVYVc#KgUW)7
z961#_UsJDoO1~I2v8lG1A>ACz<>0blH^ZQyPr2-F5HClZR|hw>v5%eF(27X-AkIMv
zZlpGTOrZpS#dY>3Bzy>EsN^L-+I}~vwym8ytkF8NZApY<PZHP9JwNZNnsmy$uB?=g
z)zsN#k~BDO^ovl7Bd(cO*-mhCs7^Y$edR5-m3qRN(`+P7D<TZi>Rco^D@?zbFHX3p
zJ;spTTTiua`9a1MJ%u`>gB&kTjLWGC-B~NYZL8?FA^+U`+&IT$xAJ0Mra$udkT++%
z>BOlw2Hj_H&0Tx#RSjFBTjcj%#RY2C15L>pK81Scw#U|#&z3Q*$@i(Ar+Rk&=kVu_
z>sz%qTrzQPy1Sq<Z&J0$jOI&Tm3bW1%dbVdK2g6cy76mGti4|8_x(FdomT13=JK_g
z{7r(d*`*~xt2@D6`%6+@m-CbIW47te`)t}KeTwi%9thPNdfxJ>GcHQ^om=|JOP9+x
z2V^9Fa7)h#DmbyXHt(`?aR2HBC&nANH?InrQOPgpU4Gay?s($)fm%E1<L6|zxSPhd
zPxtxQAb&ks>x_r?y7eO4#&`<MjCiIucH`a;Y5Q(%E$Iu47FqSYJNcAFexadnmq^Q6
ztJhge^GCg((84(obGU8lyjbnA-U2gs7sOsqosw2`DmiUyYD?OLIy>{tEA5-Y>W#e?
zNM7gDlv%ebqqj5DBhV(?PEK!walrl*!GX5m6oG9#nsV!^%?tLgt8`r5aHJtUcjhz3
zZ9V%X684HA6OCi$>8PdMH(S>q_;rHsWBHI#o`PCY<1Vi4pIP*{s8pn0B-6BieuMI}
zJ?DD(x1BW!XIrMXLRPHp#a2;ozAmjI{g?W)8>EM(HYg2gH^_yIac`XQj7>{%Xj;C0
z|J<ee0-KIbk&;zi5gS%xzOtgm^{R(x{?dx)t{0>4RaZ;7&HAoyVs9rpe84$7x~axm
zDr3%Wy;*)%6NZnMXLsuJo|AIZmeVuYwmjzO_ap(;ZyIt#GhfeGt}0qJL3L7|zDb05
zeecown4^5t^-Q9T^?g;cgoYE=CU;6c(yTvG)1~LT>A<uQE>Gd%7_EfP2PV(-dS`DC
z8s_x9tRFD3`I+9*)Zn!Aq^Rf@uNUg|Yk%n$p0e}0Ugf!d$-0?ClM8Z$RbRgsNM4-x
zNNI@cOSe$+j(K~u9c*Hk&nXc~epRC%aF{2hQ`}iyc~bGz#a5nG2Q#*usS{Z8)2-9b
zVrW5y<SSm|PIEJ}Lv{B!=4{>Um!{Ukr{NR0vSXUK|MO|vr&Uf7o9O@C@o0fc_~s3_
zt}k({>fz<<aLI`8;a;#{TfkCTJHw%Cg$u?w41L(g>+-zk=$<u+VFy0!yDcKy<RfO~
z5!o(0Bz@8P)J3iNpZ)U#xz-7_&3@LS^4MzI?73;4<xP|JWh-6JYYgXo?{9P7wn^>R
zoTzNR=hr>Csm~k6GMnuw`>tM)br|bwYdfJZP_4dp`I3gmkF8^e*GGG<49R@G$?Pe6
zDDQjChzB~R?1SPB<IjY&Ro;s_9;fQTv(edMdCu`qh4cH&)Kvpw6rxvACtHqI-nhw0
zKX=i1^O;+OlA<!Ljr-@knX9Mj`f9G;eV6cM`FTat-Pn>6Gp)Cu6u8{fC+OY1B}Sur
zb4+vN2f>qZ?@SI_hz4>kuuaoai8t@txG3qmyqj{;DJ5CzzjM17?wy{h+B1)xI=5gN
z^<R-B_1_us9s0@C=j3bt8P`uNxzsr|)4XB4T1?Nb<N7Dv&&m$%Fww~RE|rvJc1|iO
z+wAMo`D;#1Ei-#IGi3kH3m$4*w)JAX*VATIom3P~JUUZKR`I2X)~H}re$V*t!w;4j
zy$e~HtCweWBhN}uA||!5_UEDrN=EPB36<tqDFi7Unq__H-HN`4LQ-mV58V?uRw^lP
zEZcSOhM1e_6RwVT&1U5T>Kc|$Uxqv8T{N&h7dvn!xb#-|qK*lD108qw4623KP0-v~
z^K`m&K%F)3g7ZoPzv2xheL23f@6DmXqW6oU`Vxm`ybby8Ak=Iz{oy>moSTz6u3aBp
zq~>>Z^7r1TIhhyJmX+B0KIGKs4efr|(py~oF>RnLFlXQK9~)md&0kT!p)FeOhs8u`
zKLMqhx>}RRh6~fK4R+c763m+?aiusTu{!SBmDO1Z-^TZk9je!_d2;Dci-_jCZ4K#u
zej6Gt&Zx;(x4n9`!eh$rzOeifiPVy{Pv&hp>=<`PVEsbLUsvn<Cu`d68@nu?&(12Z
z+HggA`GJ#R;RfEHw|rZg{a*QeHXrAT$n2=FRnE&t^WF?RYH?n!_-fjL2~Fdx#@ynO
z)KrPcRb#X1=~Z1=xOE#twKTQdQGZg(^^)h8EFK4WdIX)@mp;&_snjvG{O(+p?8rbR
zwTDkfi_IIpWm)QU{Ypd8gN+|vEcZ0{Xy?W?%g3C*dZ*Q-h+i*0P3bSH8v0zb%I*C?
z<y_nMy<=^LU$y=GI$71XzWH)aS7WWiwtHs^T$X2)rfyrf)+bRb`+E4qHKR6vAGD3D
z>#|FI+;(i0rly(6utSTh!CN&=*%syWyj7KHTaTDuv)XMPTCe+hcBJK$7lmslJhIm*
z-mu*~*`?u0`U}@hb`}?29_&(o>vnw4sjNZ4bhB^wWrV!iOLY!K!%x;D_piM0VD|fd
z)_bMxid&2Mlg?Nwj=deCn-$>~#t7T)VJgfcmeP5S$NblxnB#+I`#XX+&#V(X8IpXg
zBsp12vE0A%N7+~Lm<6N#CzXvpe}nz_o_lg}B?q5fIVjwi9dRao1?S|U*GJjcuAGoJ
z(Y_%0tit7*rMDW4jvTx&aoU<+=Q%>hwJTUFn+awI2{PXDODFV&yJ@#RyOflB+O={|
zNqbOxzmC1`%Z~e};>&!FJ|3%cxLW*bP=3Gz$)GV=ZXq&9p6bpq66ueTdUR1cwNlbZ
z*JogdQEI*9F8^84dgFTKF7*fO-%u>@o$L6@UFw#f3aXwNd8%=(`)s;>^%X76jhxmW
z47R@7nxFn7;JR$!vB*xwZcpj#9*+{a*21x^75!%4JCDCTyxs0l$epF(5vI*$S?hRf
zS945yo%^A$`{2|MA}Q~CqpnY^`&IGQZT5Qqy0nBX880Wz`mrYLwdj-1{S&fX%N`r2
z{(5>KA#7Y(;PnkMno&iL?6*|<Y<$&sc~&eEOj@4w$8!b#8~yKk2{h03yk#c5tz&4e
z)8WGz!U_8{ubymuuCKx~CEt2c>dxr3Q-(OM7rMv?%$%~oP<1Ew_MZ_J;irn~`i7!S
z)3kM8XnjrDTKKhivw3#*d&LD;X4F;bq)u5;DjCfeJ6>dRkG*+O2Y17(d%0S9C90!C
z#G4L#@TO@9S|vG1n|R4gIAQ4OF1X;>s?S2=t9)-gy)U4vHT%8x<0F#m)&;)Iytpgo
z%Brt>htBW#n4h*YC8)OU=~Him4_giRR{SVw<0yXd#-eVP`eVbA?$pYUr~TIWIJG1@
zWXcJ=s~<CNjrc*yoAEkXUbin5xZRm1aaKm)n9~l+H}h)m8vi``aYv%gv5R$2(oW<Y
zR{J{H!nwy%<cT-u!NO@8V^u{aC<Xfb+SMW5yylwDz!;7l!}7}a8DBo`d(1wr@6FP4
zF?nvgWe?5`XX75SsQSadX3RbMb6lSz6+_yI!Nxn<Me=UMm<*M)&-xQDaWK@cvI%HX
z(wy+S$jD#nM=>UhYGtE>n!wK|)E~!3whnTPY_fi&!}W;&=7jgRBn6t67<1_GryMJp
zq`XCTzt%J(N8XArmjp%$-JF*ruUK&W@*=b5F0YD*ii7M!j3IXIh~z=RAg9;e6Z!b=
ziCpg6*0*iW_e6fil5v|E5z+P^-d=KCY%q>fWX7#&fe&SOujan_SS5STSes4tX|;6+
z_2TN%>|d0y&klCe3G%OykB<y_nBgJq5&GUDr$~wOq);mN+Zr3ruK`B{5)a6zizOFd
z>Yfv0Eynq_CbIJRFQtVluS{&Z>e|y~T@Sy#X58X>FQ)mCxx(fS*=y>P?p+Dow81lB
za5zY?-R5B5f}~8}r=c-zkBwvby4AczpU-OaRme?zW@NahW6O_6UKZ1GE_y7rch%V3
z5<H>v-ELbS{<F`U+FxY(J3rv)GkF^`_|m$hX{WK#tFBVEQX%Q9R4rh?O_X3&Al|29
zIj?Q@Pd5~NYca&NF!#}d%L09Me4aebk*<E74}BJ`I(SMZH)_Y3vb?WdUtOMXUV404
zKq!44d$wZV8x1*&-5GN}>#t8x-`SIHcU)9@$Y5fV(nhiV+^w5M`SQ+N3LN`fYTTdj
z&h_ci-8voHnmin{Gt|=>cAA?jTOT_zTr|I6=cHeX#(jbVt~nLg-q~5YM}}B@i*Qw3
zAL3}A`NH_8d%WDD;$q*Bwff#q-&9SkSF}AiB>y?F%3i9-{5w}r{kfhAU!UDxK3}|4
z{Di1cRAPzZ_OrQjiZ5yGv2YF%nv@mW(QevceEd{-$)W>uMPdgut(Aj}4)6KyH6eDe
z<AYOa%k)J~pSG12$8I(X5h^*nF6P;t_`}^FE*IVYvb;NGs#EUr8@?hZ<Z@$sC7#6E
zdif@LTOVp1wa-JM&`zdnSXN~1^)P>(%6GQ;TY5V#=oP0-PYYc<FLHg9a^<tnrv1qc
z?Tgh{4mMmY*nhgYMauS0LZ;ZLo*Czi>wE?kc79YW-s%6iN_&y1?p-6Pagy`Rf4xxr
zo~$EtJ9qt_>a4fEx(&gv)!+TB{(Q0Y#*d#JzNNpu#LrrDrTg<E^_Dk#4-cM`$R7$i
z(0)Gqef8r{)vLY?R3Ca5>#LD+O|w6F<(i9%y(f4VS8#SO2*1WYBjiT3b&<jA+?_rb
zo@G}qTDb2*T-%DB8~E<c_KdnQCFIEb6A>;`##XqC#_pbPYwq)HNcKg~(<1)zLHE4a
zgW7Y2w{CShWw&hXlL&2N<DB<VV>(xQG&CFWMqTD>ty<Y96#Pg*=uk<hLCCp`;7QMn
z6fb^#Cs<v%EcTAfaITe{(!xanTk^y_wXOvV_0BW;A#JB0_AXp~v8O<Aw9qJ*>6awS
z?>4$$t#00OWvS%6*Z}>3FY83AqO(JLWNLMLbze<zb@we@@i6jfY~0}-4YiUw!7XiR
zlKf-Y$9l3?k9(Xycd97Qq4<{_PFgMBwM`dA{R;bJA*tka<awn4zrUdPnd)7}>b*Yd
zO+VYeIF^>T1@~ny7RZ-A!8bZ!dQo~y#zxDP0wMb=?y(i7hOSyM&sqJ(-lNBC+Ql<3
zr6}5K#TL33+%w%{G1}mbYr0R}@uM|U+Z*qFiL4OMx^d0lOv2D^ZcqR0`}gYys#6Qc
z?^v8`y~{Zy<Xf5Oi7m&5qt#cKFWx=Au}(yMT-rD;p0neY>%3pNwQ<A1ljbQ$cD=rA
z^Im+{@HCadyI)ScHN3c1Y)V|6=_{S!c<J*8KD2!o^SdzFHm%{^d4YYRFJ0uT?ydEm
zx3M_nIDfuEeA%$5<yx*gN?XTlK09>5GFoE4H+S+6xe1)Z>o@Neyc%9R_H{^b$=e2g
zd%c|Zywe=N9Q4`SH0kR*+v8dpmp2%V@k-lKVExQBi$|khOxn;jy<nRER8{R$XWz=+
zsr0;&a(}<j2b~oww03-JR9h0OXF2AG!rJo>f0P_zh-{P@Bj1<%@@(VV7R9EI95db|
zpSL!j>ppY2XD5I9?2|Ke4_2FvDiX2ORI^+9a`oOBM?3O0xm+jfXL!s#=&|Ka*HA>8
z(QPfM>Vlt}_HVP8WS-gaYJTt%!wnT31s;5c)35Emlq{PW#n{1lPrUG9&Oz-qUb~Q!
z7ZQa{0w;5Xtrc6^KDS@oQ&ZD9!o@Oj_N^iA^V3egX{;-}p6XS1;rR`o)jP(H+G8gj
zV7rJBYo{W6Y~^u&v-yWN{^SaD<WsT8l@vcSZ;X%e;719?;C$XRi#&esm)p*7_UAlz
z+iigD{r7;$z0X%F+rPed>(r#Q7ZDCTU(_yn@SpkmJpJp&T<aGG!zZRT<#=mfD_%bA
zZWi@Wp!>EsXMt6*$oJl<Pwx3obGUH$)3$N>+Af8Ra?bJ1c9oNJYekf-GSuZlmS=H3
z5lgbnJ=r#Yn%%yD@kKK}9#u483pg`4$ByU0{0rmQo?q`?-}_^>^|cqSVNNR)*Rk;l
zRF$<W`}3#j1;;qZ@W<3PxLmE0?Y_CYHJfvX{VM&l9=u%XNea_vPg~w5^;LPZuIgd`
zF@gKd)~m`U7N0&_XugSE!M^wDhDsaW9gnnX%Z0yaiY#l{Z}{w^#<ct~;+?Ul8;=?n
zXMW`t$vt~OwL`F7SdF2n*mY{^)n!Zd_2a~1jXTfW2`}_Ah-*v9uISJ?us*3*quEPz
z^G30?b3;qyRYku?81+}KbAGUF)F!>vTFv}FlFBpB9A5hH>&joYTlE4ZN2j&7ZE)E<
z+{52KyLYwU1mC6|w<GQEJGHaVN{Pw0YAk%|r2bOzn^fn3#d~|@#iN|Y3tbb5Z)#V5
zF}S*VX_#19e9-GeUhCRVYS*k5DW?>OJa@izey^BN_WQ#TP9G*q+D>45GFWwQy4dPU
zO|1zcWz%F2`lgrV2Hx;mUe3Sx^MUD&!JV2%rF=5Qn{8`;x+Qwc`pd<#Z%Y(1A9Zn}
zqDaZgqSq>?cU}&tl{j@+Yf75BX#b?vQ$J&Na+punoarVTWar_qBkRzhYb9fR{E?#0
zZzXHo=4R>7;ot8!`rIm4+jD8B2P(^U_as_(WE7Zm)K>ly{XEdQ)p4H3=|tXrQy)ow
zyWG;UWE}VDrY}LcF<Q#A3NFtwzLIxKd&$Q5js6o<vJ_W1<SU!?_jHII40W3&=%`uK
z=XdFf#yH8<^K>@VYN**RQZ{N<;1SF2Dr-tqejs)t$*!!n(?apgsi)6sU#D`PxDY0%
zEMqdot3`9X-z0<EGZNYk9vH8d60{}uv5@7BL$`asygoNPcy@TOJnY9Lo}I4^4jX#>
zk`BMDcroup=i2veHX?r7(u4O8HkDlUt4(OLKD3xkU={DK)1USXOcG~1vN9vNK4opI
zN>oI=b5_n7g{UOYmMde@-+ozn)n57a%!OC)D^BJ}5r}!_p!F+BUv0D6<sSA9lc1(M
zhjOm!$<+HKis+ZhyfjR#xMZ;Eecg(O^R6FKRp=H{h>BBqd9LOTdt74aX61%Z_pj13
zHTC8P{g}97!NM-jISp#T!jbu$q2~P2z26!vFI0{XygMesdlT2|8)Gb{epLF_Z-2kc
zs=-!dMpJ_4<*+*aqq1hAWee9QbFXh69@f&B_cZU|uu)?|S>$lxjxy<1r}~p0)e5vX
zYb_JA%Xyl3YII~KUu0CztxY^}g=&ZMcBnXAJMP@88DchdSI#@h8w(%B-HnrcwXpc8
z=dNVOz2mf<dCu5>P*o6kxb<<ah29o6>phvBvp8zv8*aT&J{8L$92z)%(<&j+n<a<7
z6&*FXsD1uH&cpd1{BmA(Zf@~#%ZTD+U#j^23(tcy0*0$1m69|?)_z=6dgs|Qg;iXI
z-*;z6o#?KX;~xDqPt9@-x4IGM#dSs9XMzJp+vLwJetR%?gM!!4@xwwAUcA-IqeDMN
z&vTuB<);Jp`9V$P_Ss*IHcqu~DD!SQuq)q5s!vorVnFYbKmW^T9o|LVCpT*(*TgM(
zbTjPE?z>g1%eI)Wjoh-vxtY4HO`h?ksGEbgwWXja`nzfDo$%r9oE@w88FAQ3mjqq+
z(Q*6s>(XOIwoe=5-`YGf+|5&{zV^JF{OLQD_cgCPc;EOW#G7~T%Z8oLG^DSyy%b(C
zTDbY_R?jCb_i~&X%{8a^iT~KHB;dYZbDC?$?9}JIO%LAjduH%eWX|9`_27Hw-5pV5
zR^O@S<h$I~S+(R?z{z5#qoV|0C@j{lj+1Ynyx>sd`E<7Mje<*+?kx5$I&imVn}0If
z#K<@2t6nR}uU^dUsv@rx_h5H!f%Av4wX2HPS+|;MymarF-y=Ff_-oTwp7t5m0-DcT
zzh-heX>%8=`n+uUAR;~-cxv6zLu*^6R@D}6uR3!p_0w4{8!PbzaW>Z4%PluXA85CH
zew@eWzRluWp**Knj~d@=!6CCPW_GJ`yra-(+h*JD^tWN&H_IE0RBCTo`*rTQcg4-h
z#;f|m(<Wy>vF-%j?~|&c!?udO4Oi*qjdXdx^-Q|Ryb1QAue2PK9?aRl^H;K;$wJ$w
zriCxZr|rqJsBPJCliTd|gqD6e_Cce9oQHE`KZUlA)}Qlo_D|)F3df%Em_KvBY%AO_
z{@IOpYgf<p{o>%Z>88-#73O-6;vd{UlcLyv?uquZbxFq<imN0fx*YCovYJyqVTZS>
zZ0I>3(eF1(?^G{oS-x~-qIPA>=f++2+`gaZ7;Fl7)NJ1DUb@caJ?F;uqPvgohB_^9
zl!zMY2>PbCx=Uv7QNG7<$?|Xd_x+F=5O_S^Zt0|i87XStGgHelHQ$xrT*&42V7=eF
zANyXJTk0tY?Y_X)mm)Ll6FBkQ%%rEwHMXSaA3gcw%j69I=QVMqp@W|bN`r%**W^8&
zcH_H*)(jgosgX+f`J);BhK={PB;~BMreczh>)Iul)5TF_+S-_%em}nKz)rWbCqG;n
zZW`^fxYY2G@O18V@~x747L7jPlydFqg1d1suZB16`8L44Zdu&E-I1Fj-*<bh>}%*;
znY}%6^u--{M^n~zDeT{OGn2!?YGRH5j;`k5`4UC4oA>G72%6{8ddMPfCA*+mo$}=8
z2iiSGog1*v`fgF$YyVTIaNEL(Mq9cH;^vkpcipoP_P+X~IKo~=WQopDmf+4Kx-Q8H
zN(U+@Uy@%GzExgi##o;%S7jeGZ9Vkl))m40-1_fo!p}5c^0xgf-oG_;Rad#lrW1Ds
z)<~K=&k+;9Jadp!>KBg^W9gD5nv(KVR7DrZnN+kycUMVwXJ<)OHDy(0m6@{@V2kND
zG@n6|`k<%j|C^ZO)Sr<@;v2zqCT0wA6^f(8j47te%fFXhmv>?u2Ni8RYLp(Y{7z0i
zUKMtSF}(5=p`v(G61u$HOUF`SzX`$~Odx}?D9`;&?Z4M<f!+Unq4x0a7~jYXe<t*6
z0XuWH2aDq}p}l{{@*erIfprr6&q0fUOF!_xkIl_XKYe7I125=0LRcFdBP-hcdEjrc
zwvhw}a}}IFWm!{8V1gX&5UXBCGuJJmVFsGGfa--z%P8<SZclN+-@n|j+6l$byEuQ7
zKll%R?jQWxKluHB@E8B!1OMP0RKxn4ooH?Szj1kr(_<pT)G@}Qf5@{!jG{R%_RI+`
zo0OeNWDmhzl}(mF{M!FPU|Bea`O*eWyS*cGT8%wIf5v&GMWS`4g1Y*8ZL<GI2wLW=
z4S${t@n3)E=IG+$@9Ora(C+}V>jNB}yj-a_B{oqnA~0aj%hz{9px<9k2^fj?N-qd{
zyTu=$%i5u;aHORvP}`_a<CtSGg^n5T4Na%S9M2U-@~EybUrKGGgg9Luztcv_ry^l0
zq01BM#aPcJ1gV7NCr}^E+YqD@;>b44`w^rP;-b_Cb9@0r9L+bwT$pNCC?SsK#A2=h
z9NB~BYGaOLKp}a$J>E1u=>2&tA5P<RdtzxEP1V8jc#18`7kx0teFfz^g~st5ICLJ~
zrZz|3%S3z}^}+Az3ZjElLVP@Pi}fF_U(8|3?8x|qIQpP@uPDi~zL;z*Y@;tUFApUo
zi}D=@7X}Rksf776Fjk+1NBCP9O5wI;gr7l`LnSNL*9gZ3xe;6de*X3*coSTL0tl{(
zoJyr&*4K#sLdbVF!4py8s1(Qg8j)9p{i6hL;bDQ(1b0D=h)TGfWB+_cjfG0ZtgjLM
zcrBm@1YZH|shQwCFuAgW;J=`P`v|T9{=t*Yusx>GaL_vnC}G|W<(fqBr!fBvy;DG!
zw}M7Dhv3<;znI_`pk9^}Tpl`v4Z#P1dlEbW{IG@KE~t}HDT?5_;C~$J6_>Y%CC;4d
zjy5qDflhFV(6bBvZh3>?n&K=)H3Xjw{=sY3VEq^2)~1t?zYY4o5L^chLR3O?vQff%
zRzkT13H}Yvmn1k|b6c6<<<PGe5*)`EG$wdG$m4gCu|18z@!VR>Ujh#x^yEN0+(Gd3
z;I{;VYeD-wM(`9EAI=cG8~lUUD!}%%gFSeS56nZ+29<sidfd=OgGwAwKUf~eSQ8+)
zJd6WV369r<o=fl==)XDy--P=M!3{ybHNhu9KlLE^MbIBea4zt}4uT(m_8(7hQ;^58
zov<H%L49Qr^6R0#3J4z0awnsl;CSuOI)cv!`S%1jfbrog!O^=1D2;+g9c*VRTo?ri
zz8mbEN^oE3cS;1Wgd5rU1pf~H*C#k$<98*&YoPtx6PyP)juD9MUkv^aCggF9m?(nh
zz;!K=;9Fq)OeJ_W_#ubjcy0dc1V0AXcf6)Nwv!Eb10k;k<$6VMBk(6Z_8KyM8ORM2
z@@v7)vC!{vzIZKR8G;{#e3c1a2zvDheg?*K93u_uFNN{MjF4}HcCwn_(_q}NA$S@1
z$BE$5(2v#=+zogj!DFGHh7+6%?#JQ?J_*`CJysj?^L6ll1|gpU<-JVs9%$!f1jjKY
z?i2hi^v`Dm4}|vFL2yH;-+qFRtThMz!}a10;{Y$gdtuz0OmGMAgFL};3|=*YAA|7(
z#|*~#?gIN)5c2-uPaA?8Kz*$zco_IIh~Q?>u67b!1`Tdh!tWwtd$8VQLLRTlhGPI@
z`R6P(jH`q^j^R>4@b_@vQcv&&aJ_s%a1pppbrJkB^v6MhcR)RI!hI{Y^9}e-kl;a3
zFA@aT0RPV*csaBud|!<9<NF%}LLSGIupl@dw;c$M$9Zpp<MBL%;G4jn-2{&YKOZFc
zNodcf2<`~=c!A&+!0EBqP?LQM?Y4@L?}X>0MuOw<v7O-i;d<0Za2psm@Ix&2vp8@Z
zs~GcnQ14<eZee~D+P@sZo50Sw1iuMfhv0EA{wyarUTejg;CM}J4}!13_fZ7Lu?%()
z+#K3>Ji%wdeiFfdf*-R8E(rT~3GNN;q?X{bp}#Z`9LIjb&+FLFcumAsLLRS;*-mi0
zR(v<XOX0raGr_0A{x^bef%YH(<2|+~8T5z}{1S|lQwTl@{2)#6FK``KB=|k>4~}h#
z^9_J@h_64GPlEGT5PC*|9(RHZpcAR&O>kML-%SKJgK;vL;CSu5aDtDA`<7h<Zv=nh
z*e%%pA?Oze2ze8@Kf(8XSpFD{&zA`KjbMKP!HYmoF~Ki@e{K=n0mi+%1jjK<Y6*T4
z%G*G2Td?OD!AHaWQY*n{K)&q+Pl0xcfB(RKcnW^_Ovv-WbJ-xlSHigZli;V}dW2(Z
zVf~W$xdj0#Vg3u+KR>}w!@elN55o_6vj~pYv{xfIj-|VR;P%kJbO>G!{$EP)rO@w8
z369r}wIp~s)QcCv??C&f$Dl*5ya?@f3nBjo?8Iv>qr*r(6zT=9ZGibgus@d2(+~Nk
z6FdaQc^u;t>yd|gxk$*D!9G2f9kM3_^w$#dX>eU=Ah;v6lV=21hj!IU@UL+F?I5@r
zjAMNS4+a0@1-sB;q<RR-H6Hpa=1SmyF@o0tmm~OhN*7A>*mp?(cW9qFguE)$%W{IV
zL%D1SJ{IisB)B-V2OLWt+n)sELlhzZ3-%8ZoCmHKX#_t5{=Y=<y-=<j1iuV+))0IY
zu3v&5gZ)l|?||{@3&B4@`xymx;qr1rc?AhB3S5%lJHUQrf*%EcE+qI=sCQ$6_dvU{
zA~=pA>_%`Uc>W3?coy&-1kZ=|yr1B!!7nKU{|4jsd4d<gcy*oNI9A17g5QRGpAZ~B
z*S#TlH>wCKeJ1#H7*FsYX>fgcLwn-||6$Gp&r{+A{{-d5F@3T8dT4L+3Hf3e4-E)D
z0R7IA;8oBboCxj+`T7xj8nnYOf?Gqm;s~w_?eI9k{lIUT1m6$szkuM=!M_y*uYz{_
zkl^`XXDh)Spk8qM#s2Jv>+%mmo)_+Oa125$9|Pn3L}*`_F93UF34RTpTjvrS$41a4
z_-oK_MsP5PVMp*%@Us`e@35LDBZT0G;eG`_cVhc-42#2r{3IBkPZQh^+D{(AZ$N#O
z5xfU@Ey4MKKPUJlupj>pf$cPfabu8>$1%c2<9egcN2-6oeX=mYRpERog5#K~Dg+mT
zaYmcqS@7J7@2|0)qTru(guDW@6C8^j%j1~mL4^Ei&=W~;U#OP@1m6e!F_qv?p#5JU
z_<Xn@E++T{7!Rumj$`CD65JRSgi7rMj|Knt6I>2BJLH4?U<%hAeuBrt^%TeG!t$Kp
z&l!aLR;U+Eg3E#53<-V?>{(6lN6=1O2yPAf{RwUk<8TDQ&p`S25nKhzn?!JLXy@4k
zZ-M$PB={Kc&mDsEfc*^wp9SMU8^J$-o{t0%fOhhe;8`$k<M{&rPkCn^SJU@3{+kSu
z26N^#kSG-mGE@|m6b)vjd64FWlv1HdQD)IZBaw<SMUs>VC6p2=C6OufbN0P!=X};D
z&+~nr-=Dwzl6%hkti9IS^EvmPa~5rvD)4_4)HmfbVZN0?TnOq@74cA*m$eXo349Ua
zyP*D8AzldM$PRH8Sbsecr`L@Eh|_noM<Q+j{v1ZU0O~mf@lvRt9K`#;{C^Gcbm-?5
zh^xW8^b~PFC~phmFX8;*6XMNqp3n>Q(e~N``yz<bnC4>;Uk!FABR&xNjV|H>^!qx*
zQ(#>)L;N1JuO;Fk&~IH3zXAKch|_jw#}Xv##dm0zL?lmtpUpyi9*oCJhz|x{intV<
zUsWS64)y;6@j%iLOnQg70MzqO#C2dj9RTw^ZO3cS4@V%b0sW1}jHmLZP@jrO-X7-3
zxro#A>P3jt>&F#{AA)($7IAH8Uk}7-Oq^|qheJP!K%9=#Lx?Yd{(lm2V;EoO5U1aV
z79w5;{rL{!yw>7yo*+IO&P$sS_kwldBjPg9fB2vsXuEX({)PAvFgzOZxxi%*cY^+=
zjQCRMS2QLiwM%~oHA3=&(681YUJvVqBjQm|&l?dhgmD*ycn$co2k~Ige;n~#sK--?
z+rl`Zu?=atZi1dtBu`^%JVM+R>az*)-7x=uKwJ>~;e&BT?XHFXFM>Gz9f}<bkql{P
zkeh<!>F-c85vRXfEkt}H*fm4^3)F)(;(oABxFb$um~KP-9jxP#i1&x<pd*OSf%Z*9
z`~=LC=MkstNEza$(7siOYlGeAh>r*TZxJ5=``;0#=K})JPiZ^GK)p#I{uRcB4C4J^
z9*{?T8NE(K{4wxZh_8h4Yl8T4nBP_+eh%8v0`W-DV~e;u@b!pS!g}qFxGwbbO^A<z
z^TTMwlR?jZ#H(RGJc@WDtP4qq8$kVMA>Ie}>AXVQYYOxe8rzWayU<>JVSS@~BJ|G*
zhzr2J9O7T#d|MasSx_!>#P>rzY)1S7l#3l>kjw*a;O9vsUkKwaAMs{b9}9t#?gU+s
zJCoJ3<cVrn);KQ^htmp93(^DA9p@{H!zndae}CwYv_20&JBk7){;=hzvE+$Aa$GGO
z&UC~l0artMU|4euS@OhpW9a`YS@O^|xti#GQp8VUcQuzXzcaA(5UvM26!CoEk%*@O
z-^=2}pYhNSkFq$?F9_p39`T=`=LCxrJ>Q}7vRItxq4(p`@26?GXpFuKEP0~m4fONt
zEKc;;fIl}8Hw9kC;zZATsMIPJCwj;`s!4i`cmnW7;AEGm2w?t5YGcXMK1BF;7AN{k
zK@a^sjh43rxB#qsls^ML5OMM@XOe~?J^<=@B;tL6OCT-<d?MoXKHX`+i8)f<bzoN;
z$<GBnx`?X-Uy8UXa5Kb>fv*Bi?Ye{AO^62pk48KScsk;DNTo69++X-Z;I#g&!Jit$
zX^f-ih|}jFnh<vbJ#P^Y1m21GHsIe8-wXUV;xs0j0L-t{|5T74i1<n1gMia|e#NUE
z&N#%ofU6+h8|v8*aT+U!-mgmagBWKkl2-x!p@=U6z8`Tb;7N$*0H^B=u?wdN+#|P<
z{2cKA1&b4T*yVhH4N{+E-na_aJF;+nK>2o9Pv;@N6V_9h*13-fvDY<uu2;P0XQ4^B
zWDSe6=l_DgaQfT?t!HqPqXp%od@<y=MI10E^)LK3;#(j?{a?5s6owoo{!@8r#3MnE
z2I798m&OvNdgyqk&s9)P$F(QYLpi;lpUO9Y-54a_2|NvP+W%?Wk#>hu7H$rDK0@?E
zRxTIk{?BV)b~`GtIMqpz5Q`J}0N97uJaPLETmNJv54)ThEY8+10i5_xY#G7+M8v~k
zUl#GluuuCf)gwy^&Lkz?2lu`aqMx=S9p6-*KF6Yo<a>&VNA&a*6OZtoV&W0rQ%pR<
z>3X!1*(QnlGY=}&oQJ!)9&l^KX}@$pd@aatK-?C%2jV@&#3O$86cdl|V9*nY^z;-H
zkI45F6OZt8&=ZaH<N@D@coFc!h~EZ&9PtOh(}3e~QNiNuaq$iM5&2;ETXB#lYC$!Z
z(0)!BTTd)Yo~`Hq7_05ile65XfV&_0^>F1z8e>9xDa!vl8XNn0SoVXxII0<2j`yf6
zPl6Yu?El|@WlS5A<rMb?(zKf7zaA2FpY9_Qm@UHK^0k|5c5nT21Lr5#Z{!m9|C(Qs
z$xC$pqYpCsn#><b^t^z#_vgBn?oVYl$oYsS1@O5`injrm7u;udi5y&xbDu#b5{Aql
zu}|k^!bn=m`{-ULV3#XPwrM?B!8Z1v&KvakMVg<kgLHo_v(c0P@!-D$7$TS3WIe_H
zhcT?D`cvq|9AMH=-beTU*nS9eq$m3V6M0z_ASba;uFtUjOonk?qz6Er#!4+E3kWMA
zF-{6|tS9?wU|)ASFEg=Ez7wGNX}exvSWouF$Ry6B7^pwq-k<z*zl_=FDgPN^o&=2r
zP35V5x_^_|=*j;8SU_)qed0e+N%K?x8yMD;efqmOJuhIyxQXVc`%jsTp6u(c=1Hsr
zL1Le@J<U(;e`FY{B5n@)oZejS-k<-lYzK3wC;O>A*dNTuV*BL#<etjE3p%O}GD!1N
zkI3~^Pxb}i0^tIT15$o67HEE2{$XGr$1J)B6Hgeqs9`0VpSmUfm;CGCdl-7%K~>=V
z3N$|zfKO*Qp_M_L+NGZ}AwLr1#L^RDbb#igSdRf@UV&<&m~#;F)A3IaQ2*(^CD_OL
zZ$bWeDhQuAKY4z<r}is^6HQ&nN7|39bu>S1KT;lSn`ChiC;xLe_uwFDj-L8InbYvv
zMe?ahlK(jz17d)c&@Oj<>M6f~1uxTjlmYF+yHad7xXHUtBcX`?r<g_4XQ(JB5JB<(
zJZ6!D-=6|#ayK<OlbAP1NPA9`_WW~*8^g#~H{`R|#-O?U-tM{~_r08TLrT5uwU+CJ
zR_cY`RV>t6rWg84H*yZiMdA{P>V_{9(+%~K63`1jyMig4LFhm!8b0TXLAbV*fB}<%
z2}=|{R7yAW8t)JjC`eQ{w0^agxt0YxW)jO6vZ=LPYZ-}yWJWBh+31G%mX=|#Zm71D
z3=@QiiMS-hghwI{_hB6NA}rigO2$Ta%22MLNQgGm`iwC(UT7m?u8128X(QwFcP4~S
z1JfmVF6o8d)C(<PVj_9vEB@{-KzA%4Zp<KqP&lF+dYwqxhi8+oPZ|47;bH5@R;l;X
z@Su2R>X^BGC}Z01j&7)_lz?uyH)HP+l%2_#7qm%+kN7I!oe|EJv=iwl)D5jR2yOmS
z(<vfb$dhf01iQ`Dqh_w35G!eM$Y+t@eoSDZAU_VjNXSnnwh{GRH~eBMQ#PhZyqvt4
zM?9z-X(}bI8|ft_#yb{LC=#4N>NR|;lz8|7ZjtVL-4EZ%EmEQPEhy4X@=j{M0#X`Y
zMiN0PgPRNXXX%J<J<JrPR5#p9N}Q>#PF)e%Tb&|<45S3?L}Z}#!-F<4D?v~fpO<q`
zS1*y^t&DBPhmf^QNk9=~=k2}LW;ls?)m{J02I&L>RGLxG^iz@G?>~S4W+FxDhQ4Kb
z7w_N&rdc?zUor<eMMRk_)H6{1nyE7`A`QT(4c|cu$!>$!HyIHy#PqlU-QBIfVj;xJ
z3i21=^L}rl8~TAeB0{%P&zPnbBK0FMbEgbb<ZZ%C4`sUkYRLDchTH7nS6i5-(hYs~
zr{TF?w>@B7XD2cqbQC{#4+*BwzeR${HxA*)yO>U=8~T&!(?l81-<d@sk@uLR+ToYU
zVII^`e97ow;%(VQ>xN(cBg_jO=H;U^^M{{@*6$lZv-rKA1^F^1t6^MYqGN&15K<EV
z8%)ud(dH>uK<c;qC_~fP(#*cS*6*8a)E3GF7z^eWi;1q)os)_CMJu_``_-SlAQGDF
z9Ui|dzqLY3UP~}7#MtQ0#RZI8Onc2D?WMxB3o`=0F||{}t!ifEbzAciWCEjk_YK-4
zz~?oL+dyK_K1>6{xM7;GI}{kNZEBbjnAm!GIl9=3d)T@;J6c<cyE$80+mh(j;%=@C
z*i53n8EYA88!hG*_dk-?)-zdTVPK@C{U7Q#Wek`s&@rZYh$TIjjh4=iHh=X?okXEy
z61V#tXEvCw`#tCvpO;I}uU=l0Lq2;ihQMk}bzCK@GdV}&Ragmk@Dj4R=zkDm1`;F0
z%(tPP+_!dgi?8O*`O)2=XCtI%aq|}ub4((Dq%Y#!kM8|VN8=vT*lNz>&K<gQCHqL-
z?EW3^ggazJ&Mq0Pvtg5-^R>R({ku5Ad?sOoGmgbLRozIBZxU}9wA6Ri?A%>Xsvq9p
zpI)4!X_RiYC%rf+$Mi&^)$1Qu>g&r51x$@Tl)Tycwl@DuMY-$SpY5-T^oy9NQe|$x
z`j$?#IofnLFZ=zTxJl!yXFOK*wB7bDx%^7pKFRU(vpx5(skiBEtC5lJHo2l?&=J4K
zD;;(WyLsSQ;DAGkg-_FF)&6|*bkTw>-|MHDx3<@>JpB0TdF{_TS5-@$m$BdSqmPe<
z>L82ex6NiFwl!{*vb|dN?aQ~R_M8ieQ6FAe%_uBgm$Fs#IRDZ{4b8)9eM}qg%M}Hu
z%fzIg%uXF8tGPJABXyPRf%K%#)Ge|O!`nU8UE-amS2m^YkyTLq)nppslsMqd_L8`}
zcCxlNkHp;_F1ulYyw}{Ti-sMk)=IgvI@M#k$HS#llnW!?c+Gv9I>^o~>qCBE`biZN
z$+Y%|GEV)JpOjxM`C6+J*`zir_5I0Dfe-3kti`&D6pk4`d6IqCSAVs8zo8;8`nH&C
z87ikE)HY#qjQyIa*ThFGk-zqG=<T8fmdi8+1?w(oJNKTp%T?);uJ#>E!#mH7KbYQ-
z*>hii`qgBGg$tuC?0mLp#aOu5Z=ZPedPVQW{<dysM$GtnIZ!`QWQoqlKIx&q9GK{8
z>ntYl%^%p?DO5Iow^&5q)+wh8{P*n9=<U$3$5K;LvDXSiQ~o<QWa2}_gmMO32dY?&
zITM)5r!u6O^EA{maO@53bt4q}w}?;V_uVyFbCUbqdpZVvga<tcki5}n!ZpQ2l?hSJ
z!Tr|=h)q<EbIomSjPGq_>aC~L{?Opa4(X`cy$`}fXEZ%~rs?XMd~T<MgJS#f(>XIZ
zZ;m(FofP$*6utOOFR@Xdr)%!oG<@CBnyVZpavERX$e**9Eb!t)h<{(MsnPg|Q&jp)
zXrT0GPK4a|FNI=_Ist)pS9=>seeM;Z{(acGQI-7_dbexz8ZqQM=VsF7@dp=Q8s-1s
zYw9F(ezBvUwF0g=Ugc9zYoE^vdN6k&vvHoUZ^}>M!iJnE&OpQOYsqmD1}8Dce@$Yr
zM)`r|Vb>hT_hWLGTw(T$iWSw`V+z}DG;<`Y=JvT%+*GNMAQ`K7*{Dydwdv{5-9|6N
zI}IMI8Wi@LDj}fVf3)t93GsVnIO)3-mMqo|93|1$U_zs&+){yugY@E$$@ChvYv?`Q
z<iIBF{`cNovKVsoz$B?f1#>KuKD3ITYN)=UBKVY(V&khH|Jb9=sQpaAqlfCbf$ipT
zuUB3>cRqB3O5V(xS5AWGdQJ0{%RKx;di6cejsd|zZ}Zz1Uz@hM`dgvSvy~z)>ef-K
zJWb+@PmR>?_<jBC`^+Ue4elM8&mVuapHp^9L)}d#HD=Yq*<P>Tq*hob99m`<DtISb
z>B9<#ynTmC=6Pn8Zy8Zgep^Z}A%EFQ&0d32OZMEB@!sr_I%J?(y6XaYpDm}B-C30B
zW14jMZklc`=hVaW;q$!HrzC8tl888~RV6mM`QxM1RmKIyuPyVP923T@U$%Bg+ly2k
zZ@Gu*1;S1yYopfJ#INeRVcDtRyo|%~W7Ey<$yYh0&iCfeSy**6c8_;@b>oTytqWSB
zTTfc$CrYNTZtRpFV^Vi`?}cBwRbk&Z&-*l|CAoE@ytQJh@M-JxyyU4q`_spUrN1qb
zI=rk-#4NpfzFE4^lHAt7cYMuB3qFa@(8=w;a>=RI3G0t|`gy0{S#sG)@L~Luu%)W$
zdBe&^yPayS)Lvh{`E7c;R@&ptEo1u64{z<CYW7Job@8VmAJ1sz@;^!4GWbd6mawwj
zVS3kvhn)*fF*WiWX{@N+vSd!b_GOAQYm%%szRM1Kt(6k?^_qW`;F=s$gAwM-6)n_~
zzX?5(t8&eEN%Jr9UR3<B@nBef@j}^&BPN-a%NwTuDpU(MF;K}iD_5C1Y<fg=tC7JW
zQv<cZvUXz}tBxO1PWyE|NAHvDhly3|4UU@jJG3j~S%8!2wkCt*Eio(iv?@H1sH%TA
zqs`Ry#fr<VV;zpQ3Yd6TT`aFM>qvOzQT2UEOsm8Al`{{U{VqJ4D|>Q=T)OqGiL1<h
z&%2{iwea5M^cNB9t4hj`n@&1dmoeA6?+NwNn#lEGQw47cJPseewIs(zcA>e+nd%!;
zvkLaijMAyo4jI@MmU_g=)$4O+(hh%X*MZA#UkneCuAMa@<5Z$iuTs8B)%UvPYfoPP
zxp%Lf+o1tpzQ~z8=euGnJ6qJE-$B!z8QYcmD@F;64Cu@6(mH0Gv+b4rAv>iu-mL9C
zbN0}6hGWLPS`<`Nw8*5t>Ib2y!a;Udo;$7EV>xF~Rk8XS+4*0lRj-LJ8WuRq`t9P)
zN+%b2t54axKd*9CveefP!M^h)nl9YE)NhZz`NrbxeG8J$cce@DT^KjSkI&pYd3<5U
z?vG#AdM6KPFk868ZSuq&&Fy-+`voEjM|7(DUkx*zf6h!YUpM1s!-^oMsX4mJbIT+4
z9$r$rFFJPb;T2QEEzY%GicQr~mX;2;%V_;^A$75`T!iRyKcOe7={nnvn2nhC)NDk;
zE8!}yF;7nv^nPBSP%!jK(l_;oY3V@)rqko+rysgEsA_7<!B!>16X|6$_ocsjt!m_S
z#s5?C>3bc=9-jYLHYr#0s-Ll7UDokxPes4yiIv;aT(;^I9n>B=sL(3+o5R)^lT(R~
z*Q_L0wPfwr-6vhE5HXQ&hk1^`x*Q!74*%4{eVx9}({3F6(7tT7qz>O}v8z?O4h_rW
zOm;{I-F$sE`p}QWX(P|BXjnII+6DDxmt@m|qV{#!9b7T_)u0N6v)R2*ACoZ}qfo0S
zy=;%>aP5!1y0#R{mf6Ud^{v;K99CcVHuj~i$xLPAJ;fo%o%dOlDn%L(9jNr-rD~47
z;goUquWk*Q)iAtSS2{^kCG?k?*BW6<$@b=3oPkpgX9?9zI=3Vv_0}ora~YMRBku|>
zigB2lFIMH0eAwpTRJnqYCq5a=W|{A<y)Y)hvfcZLUSxLPi!X#Cm4iG^$$9KBSbeEB
z@#Mzy{fA4<I=``Fa{j0TS2KJazbVGP-FN?Ti}&$!r_48-#T?5W^J3QXV<8t~rmJ~|
z>n{>CsR%jgHRFQL4zuWomdWP_>gO*$cdd`3WAp6Eac#;bUeY_>N5=Y&z87)h*wU>v
zQ!mI@wdco54e1=~;&=P<i<ZZ2$3!^Fi<UR(#s5%i>Qf?fW7;<T=&L0kAJldQOmDa`
z;KeDul9(M|9xYUHRdya=7uH!Dr)+rHxH&msW=YtyClcFCdcAU9*-~NpY5VV$-Z@uW
z2P{)w=$$b{!M^u675mX4ztZhpD`jHt{K`Mn%leAXS=-_ZH9xI=*Sz^v8h2&-H}egb
z!k%vaHmsDtTyFm_d!O;9BL_71e$uqid!Xg{Z30s+O_+Us!kf7z8o@WJZoXagbF9^Y
zk#13nTU(FT?0;P`QomYXa{AuW5(ABHt3_Y@d1|0)UEtJd#hP!&HIEngb~$VHRhfdT
z_Lbj`>5P^*X!-GOeyGT|EXN4vxl=0(R(EbWdPS}y^U=lAy&oOPeR6q5M{4=H(S8f<
z4@yq&*EH(*oVK*i@&ZGR*18gVF}szjTYRQBj%zh}Ie*W1rSD$rx0$9r^*_1hWJ|by
zUG?-PrKD-)u|93PqdX#i_kF)`(dO8!<qb<ukKDG(;8gyFg$B9e32&Bptv;XVFLzl<
z^Gwb_z1UeRU#`8<dA4n=w(58NM5C^=52Bj=#J(hogn#<buOe5+qI2xKx4R4qGs@f+
zW<OQUESoducC*c?eJMrOhel6yO?$MX{D#pvp>ygcM>mF9Sh`m)zS5d){Nv}qrcN89
zefe>Aeeb^&x{>eGlv023Y2OW}qMhrPj~n;m>dcs}Ef#I!_pbP@{k^j0@mYEGyFQzK
zSQYE0lsY6`-M4S<CZFfQ8VU!x_)T1%1$ylEjXSqCx~;ZwLxoeD+3{^#J{etZtt%^&
zt+;0pl_K?fe*0%lrzy4l8oeJkb{Kbtm<>B>A2(WJeSqhz0*%O7mrwi7jdU4%yY1}q
zDOoq3Muhfq{cLb^w`y3?zWW#794hlzy!lw#u$xK-)oB@#wg;2@-Fj}jsOi-6w{x;b
zAE-0?QR*4*JW=0KaP>j8wW|--h|9&lUH&d+b=LaR-|`fNQa%-2>vBqa^l<Q-WtQ6(
z<R_1+xjgW9?gRNo;}hX)Z%nI{Zxp;Nf8SD1>&)tkXD$k|N^2uNcq@vn6}vgp<9zMa
zBcC4B%6yUjak^tk7r(~b50Z~YL^j_XWAN_0W6PbN+g63&teCM#cR|jH!FRtHtlX8n
z^t)`G>Z)<S)uo2DdsjS}Ib_h%@eWycl_wV1Us^u-sh<3#i?b@)ep~GCr}%|lw;X{l
z3hDl)qZ^E$8aHZ+&RHy0`eYHOMB3(Zp-h;sVA&|2%i=EYwaw3m8E?BTaz_7DXUfM9
zN00T^&GcJj=yUvm=eH$e&D|<SY`vK_*G%(7Z-s^vsb1q|X@0u3EKe?RsIgFHQ=C)f
z$|IHha~!jkukxu}@$z#R(G}pWYGZRd(>|=W--qDKoURooLetKsoqQ5`Q1e!+;#wWS
zy;`xY?ow{?3itQDvmMnda-{Yshlx|p>{FAwo#W}2)Vr7Z>QObO?|yu#J3eDGpJ!gg
zwDb)dnwh9W`@aPmS}r=LvMXC!GV$Te&c}*ry&hD1XbwA`8&|aZvCQNghosNvJv(mC
zx_MY5$EBlM=c-$(i?MmCy=&hgFE0BO9{U!h_&vk@T)y`ASu^hcZt=eT;oZ%9au(;D
z-5Z?qdhJYiZWce;^mf6=Ejw%)cJ=SNpBSWh?onN9MbU6&x!;fGA2{K<x$oA7i;=ti
z?nIfn1k}uVVrP5d(#}r?o3=gi?CLzZ^zohYGK;2{L;Ys&zo=mn+oWuHcxR`(L_#nB
zbAEX_f}a=qXLmXtI@7#SE&Ri)K3_IB>dJ>bJG-J^gmkLm@C&g|Ba$v^CTgtwDR6O4
z-RQvS7B9Q6Kk2*E{<Ld|siKj|QZc_~4-0qkJr0Sw3i?N!di5RE@4i<cr+>oBko#ZE
zlk~2IY)=Z-oagjJZHD%W%$QLApi6-#Vlsk)g2KNEMkp1iolz9Kd-1?r^Y7;KcRu@G
z*Ri$U=k3h%Kb=PHa9lHei{Ie($QctGZihP7cx+kVAK)uxUp+E&x!01%)@PPK()uYD
zvHQ7J$v8vKmvlZoHKo^IHrDtCUYn=WZ{J!bBxmNWRcntw{BkYHZ%$#pSi_C;V<kEg
zq{3rnR&JH|^o(d;mfv1FA?3*6*P?0LU227fzWiAt<8|D=X7;(Nq|G~iDutWcDP~Q2
zd4AnOOV!8UD`c)NIM*5CZgi)wx}x>b=^OjTz8pDfUPi5`T;N_UsRH%g;pKbA{N~Fn
zH91-oRpBmk#%|Z9J6_kO-u6(b|1#J{e_>f%v90nX(~pBTP2AQvZG=v~q~p7}JNjkb
z?&vC(_IC+OeK>L0lT43Cg{$4Z2D>g%?{oL#>A`aavMjnpCDrQOa@F7V4T|KCxg%1p
zdQ$z3SyPLw`pf+zV^^9vEq^cPwb@-_Q^x+TqL8$Js-i2eE~-Zg3eQbySD9DEf9ZKZ
z^XeA~Rr}>*RS&7woA|XmsXh+wC~2R({p9|yHxI1;Wx8@!aJAI^$qC6KYIPC=;|za(
z*mm()m)tFt!?LeU^^`kw(?6&D8of#G%C2!E^kkMwJnQp3D0*MQ6TK~}`HLg-GM?ON
z%_!4|6?Hl0a%Z{DhtOVX?x(U%C$E2=ma}V$Os)Qyig`;{&AN1Fw?=mA!r@65{Egcz
zByy#{cP<X;luVvs6=R&^6>Zx0LGoU^E24K&^d@ZBv)y*efTcGSl*bxYW<8X={eJx2
zu=M@BuSL51WdPdWbTs2n?819Y?81o(37vwKFF%Pb{d(4+bIM32ieaZ5zb5U+S^vtv
z`c7eC;qAg}g`ATK0U?2*A#qVUH9^HC$EBtCR&I|A`Po}CyHI1n{u2fwhoVD<D`nT(
zAB~iVEzb^oFD}VH%OH8rpo*h~1MG)iU)grBp?rnfdTB|1PL6>P`5C&~ZxOgrh5Et7
zJ~WwQFm$Qtv(2to-8;HWmQT}^7$X%n^sQq;==FpX<_4(|B~g)wAFN9%wS2fESZ3%%
zi5oSg(mC_2>}L<2VsJ)PH#PF?^gV{7?VpYF$-Xt*)$WR_>nq>-OB=Q~UlY7!bgX$$
z<?-s_%E^293m!jhp8jydlilq%Z*6F?YD=*AQoCKfx@)kdRnc#wniVoj`@B3+E^M=H
zOYb4Q3>-d07=^1%yE#<LHTqDWPeEVR4Q44B*e(%NQXOC>c3R-w@QHViYmK?ShOg<|
zpz<`^`4VMsCtjUn^(5NlY2<=7-Kc;!*96)>e~q1~)#vefjZ0b|YeFVZ@RkbN*zUNg
zDo$zk?xRmqZmo@$8Sivxul1DhCfTV`{nyT0c1@@Mff-Xnrw7fwCf9F{{5AbkHCH^9
zH}s!b8nwO1xJ%|+?w#4+`t{AdyLMt;TcSyM<37=?9RfE;xHk-z$eq6H?V=e&C+7Fj
zZyag7_eODVjkBwjx9n5DXl}pU>Am)u$X5qb?p{k>zq&E&hq3Y^liIE0Dg$mv?sjb!
zt~=H7Bv+>SO|Dh+_~Ma)KP5bDyB@3=q+(;V_xYUptCL=qx$&<LyO;8D!^(xzCp>V~
zdX#x#ihS-u6G7dq{D+ARB5un<wa3gho%pKon4zcpq{jK0q7qx>Qp|%JZ*|4(Ue~TB
z_fAUP^!ii&mJ2PxH<tu23*0f|{qi4PSvPNbjC1t1y|_Fx>)sr%Svt$zPv_ZwmE7Io
zKc+|^CwzZq!9B;j2W%paYPANn9lXC`Y+=pz?|r;pR`2fJXP^3zq059m*M3|y-{kAn
zff~;?H=f;e+NRP`=Enn7>-+~BJ!XC$SpTGUVUg=^(_=9=ENd3aFaK)Ter4Emha;1x
zoc7z>lx?1OHfHG$CD#DMqK#+$ObzY4>;&JI{1QAg#?7DhQ)TiaC95BAI_k&7ntZA@
zxHzS&-|XDd3g@cXFSYi(UNLN?$4X;)Bbi;n+Nbpb76t6TY@v}dnxj{0n9f{s2;MvJ
zAjN3DdH$qHm-iWNmMeQU=Hl|_UmLZ|a^-_Fer25)QISy*e!I<Zc)_O=YEILP@_euN
z`4q9R>PmHXYHdvI)h+GXr&sM;{>yCKQ~%D$W1?~X)i-A)SjbL0n_V(wgS}__QRm#r
zvYxS<(>_cZG<5)Tv(}lP=h8#6M#&kSP}zHD`#$FtF1{~9)?_}vb8i0%f$v+)o+eE_
zRpehkJj0-3f7z$4d22J5cl!Iql)fpcb3XrA{)%nq2bW*UPvw_cT#q?YxAoWt70X%U
z=bApP9=7aMW~h7i#GBXNSEmT)-MZ|tYWDI4Wri28d_Hq3Ub)LSDMJ1Fv%D|a9ZrsK
z^u~xfzjm%~^7^gw&2Xeoyw2pgt8P7!7&FQ2(cU)=8AE6I#YdQ)Hk&)mJvXUltn(uo
zu^&%b*X7Qi`m*wg#18qIDWAeCd{>nD?6`2Y-D26rjIZ_EEd09KqC~d+XlpH4y4KuZ
zN#*>4=SMmsf0@eq-1qkL_PbPIzU@-M#w%U1FXGyQI&!Y~SLdG}+YltEpt`MK!R|R0
zH<IF%H?^;O<GtGVhkMIn!=;xu9@ZFpdd}2W6Na1*m%e{CZo~Ai(WhKw=07PcoBdVd
zlV@>Oq<DgiO2OIQEnkjSPdm{%cGBQ3<9*LnJ;H+*tN4|V+aLaQs>|GM<#rJwhrR@#
zFK~?r7;89(FCwDfp3h&ibWShTn2?e#qh9II^v!TYtby5(8C`a@uG6oUxopg7cJ?kR
z6F;C+6>{-Qc-1@?`y*M`M^+Ww-{LqlAUa^4?f@eRO%J~*2g2{Dj4~Ov=Cp77*6S-S
z3^MP!;{W6DoZIbpcZ$BOTQKya!`4?J%f1W`xuLnoD@$ojuY{NH2F5SBzRj)hyUs?9
z?-S1ZM77l&xVW=!c<<<^_L0|5Mu&WSIAB(F`m9#b5?zk+wcay_={lNex5fRi$nx!~
zSP&BHZmXjp`fjN+|Lfoz20v;tzSOmBu}%%xKI!@6359EXN(^(QJAIP3HyzfpT@t(C
zLA`y3=f}mpCW@Ff|A_JbY5P)ME^4yD0?(JbPVt>uXVaLJm$4*3fU|Q^UfwYNSMv(L
z=ZQBqpC7#Ty<es2#C=hf)8=mKD_;CkCMM})psR|yS!t1n%H6l;s+P^obbp>w+pFxz
z>VWn6$Le+k@jn{YzvGMBd%LrT{LJlC6VIOPrMP74_6Y{N;_UJw1Fd#GP!_fJ)(%{o
zuyK~Cb<<?`xW4>O+H0%#eUR`!5tfv7t)J+^t}W)?=RZ6ZniSh=o>MSupri2Ik~zWi
z(nr5`^3@-<_x6Qc?Yq{)3>?A_@%tZ>8|EQ;(Z%(oaGwiC3ax6AwFWciCh(b_^bv^Y
z^|H&~AuHX{*3xLf{(_DM$9=!|R<5hQW29hVem^nStazsIm~)AhDG8-b;%=*F)#P<V
zZI85_^6cb>0i92tq+AiQd$X*pxHaR4{{cQuo7u!Qk9~Ld8#za5)%sb}hB^G4X*w!b
zGuB)7gyEwGlf)X`UGlP=Fv-@p`K?<;q>?9UmTGLwb6py;BSO|HWZ`Q*3(3!=F0#6l
zkKD@>$yML+`I+O;b!`^~-@RFO#Cb|ZzPG~qGiqn_J*EX-lz!cL_`#_W(~TFcudBIK
ztTkVH(A{BK@jqpwq(=4^?0hbr$ApQMoWFaf<%kCTms2Jk%W>gTn(<>#+NQ;iI*#0q
zNpBp%e=H_?OVOy_wu8s;&rN?fFG9U|${>X;b}9MWU$64ec=;w?cf_R~$8Ij0o@yJ}
zdaBgfS52+Genyg@{L6r)BaN3_s9&rvvuonWi|>+GNr$facqvFCO=aS);N=qA74`Wy
z*S+0e)_>IKoSYj`*5(FH`pFZu11>&Z((<tSXoj?wP{HjXcM44UOi0Opl5x_t;%QX-
zq_wA%-jy_rm%lh@*`|}H-;I=zo!6)lrl+=0JW5H~>Apqhjm3EbZ;R<g*NQIj6Uv?}
z+B#{1Z(=~>i|7*0_Jg`vQC@PxO>T{|EPG#8eoJw;hmlUjoAM&QMK#MZCh3(eOtc=&
zoJky8V^^PTJ5<4Oh3=kkzD?&d{5O|pA2~kcnufM=YN%psf#c+Stt`$C?>+Hq*EbKa
z*)l<Gp|#ni<}}0T<sakxQr1~#cCL87!hA?+WbzT+{StvQ108eHcglsvNR}lpvTPdA
zp<n7WTIpq|t=5|nyVg{i%<)VTa8Vl9FH~o+hTTs43w*xOnGf~9SKON3^y;3If#v9T
z8;xFH5$mlO8(>gmTv<Ht#zMsl!JEt$CxwT#*bMAcSnyuJ{)pznO1od<r#CD1QWfae
zI&P3fnnc?Ct4Y$=^CH4_4!muX`>giPxO2S=eeBQdnPM_*cb(L{u`w&H>b0e8jC2(|
z`+bt~*ib)y-t(V%)$zl=9Sff2{loLNOxiTz9npJ+O<?Zc7BYHu{N4l4RRP}Dw1)Jy
z4!Nnl@bDGWFwHRq>hp};Z7UWJoMM|1Ci47+byt^9SJ(8dKctg`!nO8iFP60SKfa;a
zN40I5l}PQ;^y>$#f|b;wdhO@L3G^zR^!VudwaL53>a`num>zoRj*8J;rO!eJaoW-y
z4i0MDv=6M4Tk>({F#m@a%XMN*cf1(zSnbXD`1W0WhMbQR5_Hx(tS2VDLo9BV_9>BL
zam~Faef3qj>~Y^eE6dSzO?}jxVGl-T_}<U3bUl-{eoeh5|B?#1$y3FL`yba|-Ddi5
z>6H`ntPB^tSt(XB;efEkCco$jX*Xx|Uo*J9y|G`K`R+CA#GS&+Tf7F{dZV!AK`x)v
zk-DEh-@Lcqdwbus7Zdai)b2(YD3q(-KX5_lLwMS=<l#Dg%3lNK{Ls`9%};w$S$v)O
z{VmFr&$cL``OPem>_mRqrwOXRJf?=;->-Zlwxa0lZQZlYI+=cAKX%L=wKeIj;*7{M
zt4|3eXa~t0E=%Y$`P##IE2I5$wjS+Nj||%=^(rwl>hQU~$`A6S_NR~Wnwwo&Jp5^~
zpUTL}7dc9OC54_o*lkug`QvQ=!04U3W*?6{DKpzzbo1JQ%hf7trL{g?@(6e<b9{Z7
zWZn01$&Pa(Qt})hZ&z&|eX;6M)wl2Zy<1O*_0KA{p8L*LL3vQ+iU(`1d&S<8-B+wT
zXxNlDk|B<(`#y-bI%%CaTDo?|vYGE%9$50nXx%n9ZOrEToUvbfZOeFvw`by3?|Nyc
z={5S9{q2L>W%4cx`bT{o8I~k|P57PE=E1M*RF92Xd^f1#d0>M}-u5=RhIbm<Bz83$
zN2DzXa++A0JV$VFhQzCmFWNrmYPJgP6c}+j`JE8wM4;5TrbDsU-LEeaT9IOWxb>FX
zrM^1HUKMFNiimV>%v<qReDJM=_xA=|=Ir?_G3JI)*AWRn+2HyqF6!T<hrg;&Ffc!$
zwBF&s-tW&xX2v*1^nSHp!A3(~C(8Bc?xph;3ylT(j1}ycDI%h<eTTot{i?GczwO;9
zGkVDJuA%<#BBE|uXT15*#J3^&)244>Li<vbHQ#p5eCHVZ=z0G2QF3Ey>z|IezdA*#
ztxhl3Lrke()dG`&=dRz=TllE)fqT)?K|9CKuu7UedPn8&2bOc9W>y|}9@{_RVeAX3
zq0<69H^-hA@00V`uJrsS=cwk_n+{q=%SIby9{M@T@ZQDgciTOF`b7&*T`KSCVfRe!
zi%?6w-4_w-;~jMw0S`6^hR@5A8u>PN&?yh$s9`Ze`cfwh<-!iGv<e(xVEZ!R!MAL~
z{5hQuZVrh3S$Sp8{^t2n#ls(_1<7|Q^%{FlxhNx5eQa{(*(=Fa`h6Y<jSZHP*wt@}
zy|Mk#?9b^ZJ<EG9tsc6y_veXE&bKYxI(NWlXOG?E{6~aql)CX9^WJRkUc0q((MY@b
zCkN$uwJ5wFx;%N$OtH?*KEC0X@A9i3+S{V$<gvpg>b;xWn@YVtR~>h{dl>#$u`5u~
z_=Dgi)rYMIn|7_3^zLrpcF9)ZX-WF2qvHlHI+pOL`1rRat7Y@e7WZ>@N-575tqagd
z6zN)*>~$j1LSHzhsNi*eL(3Yq`3*&5wtI_h%>8}h;YeBaADgP*uPe0*u6gZYxT$0L
z_HCR4Ki~Z9zCJbm*Y|j*mbM!*F&t|Jb1ly-{-JqEKX#(a`u$N>lWdz_>&;VLERZ~*
z{lK&XABtz*ZP8lbW|E;Qp(q-D{;pzjN!&g49qU#OHqg>8F0m6=jvQ8zzgWTXdF*oj
zdvkopZh3fZ^e3spyHm?AjYw$@n*HXmzUpv4b>$$V?ITW#TB(Q!nm@H^7_J%~CzkW8
z%=@D2`Szl116{`(d5L|k&N0Z`+P|&B#KvX1#i?JTJZH36&l<ii{;s(E5Vy3Jb#i0O
zhA$V|vBonw_t=S-YBN(DCf62x9N0Fi?b-SR8pj@wYu9-{s6{}k^2>9BL2kOq8DDiQ
z2A@kcdo|F@F?Ii#Z85h}3%(U<iwV4ts2`F%FCwg@Om4F4_9^3ol(+vlH$JFrvS0n6
zZwW3k$IT0ZRa9CmR4rx{Di8Y4qd$^6PsEu&@^t_^_9MOC;^XiY5*cz2CrR{PcfKvg
z9KKDWe4_{U6NqMn6_{i6dA~p+xLQ~=s+Yd7*lzws!s0<poJWPt!s6OROnAo%Ccfic
zVdf@Na^L9^BFm&`awiKD`7w&bhTP3RPgp#%_dH>lh(21v3Oo9039AM5(-wByIzU*B
z0b0T`i~u9Z3l*u&+_WyvWIxLMk>pPPvk(>y>a|c<+-iWZs1^w)$+K5TjxkA|6!4Ed
zogVFJ_Ikw_WL*EZL2_>_z3+G}QD`VEzFt_sNLZX#7cxXYlhVk4`otIS0m1@Wf;P<m
z+JZ|56cLwfm~DFF4Uy|15jFptn3Y5Y|398W`lFQpA5ROiIc?oPjBNeyV^fO!QvvMp
zcfTp&pNIeVF)QIkBmY#x_&E|0-Y!4)Zsva<;^#i8(i4Xp%2|hak2vt|&thSSw)yY!
z@?PyA!db@_X0~}_Lxgh>@d@005$^b5A0m%t3}&@sARN?YKAGF={*_k!g**I(6Ma4D
z*}-sjEKcsYWLVN)<a7VR$ul24>96|>fBP3M#0-F*^i22*pYa#2{}*ol7fzn_@5%0-
zzwqOK;p7=pcC1hC+{Bdi?qB4ax$?|p1&KRPG28si{MeH}BmTmt{DqTu8}y{d;V*pa
zUpRSYd2siW!W<5F4rKg1&E<bAaOXdU-}{Rm*3J3WoIlY^nXTz$cLw=S>5q_wr<bLN
zmxY_Ht%rq|hoy_BovjC_=TN82^N`GqqZUl;;|-QxJPjKxT`cXHoNnG;7TzAt7A~$n
z96JwNTb6#f&(zD-!p@NiKT0GVEIl2VV5lS-Da0Rj^Kf+aaP-=2;qGngZEFFMO+9VB
zm`om?UKX~_+*?#Rgt*vl`UAL+aB>xco&Q!Z35Lo+w%lCZFoH0yEH}Acthe3FcAfY^
zkUis*kE_RerW!0aGEq~x<+5>PV#``>_OkWlFqLZKy1~N6)tf0W$AVP2^?D0yhxHbA
ze`2gM&r(>RnsT=EVw&RL1+;ecc7f{mBH4HiNHaUSy5Qn?I&QK3XM|UF<k%i6k86Rt
z<N435Om$f}*jn2BlR}MIvt!tDBhRwJ$P!;2n7UwEoomzC)f0+AT9r0m_wC3QyxWnx
z?eGHNayV0995daY`y306b*c}1GV@8!B`CLLak8pW?!)4vSe(r7BoRGijiK_s1Tu+m
z@|8K|I|*bG;bgU=oIYz!IC-py@=9i#B*Mj+KgxeH+awV_f%&7H%-19lF2Vd!K8D35
zSzMLH*?ul$aVeI(HH%BL_)!)YXYouHCu=J8hraU=`~Qh0KZzwz=3kPqJbfnsF0Uj@
zo?Tu|79Y;&qyCt)_yiWG?`FYvBUth>EO|L*n<OGH%luLOb_6mB>mkqfl0-P!rt(?@
zGKp}alX7_ElFKDnJb>9I3EMr!!(1-UY*Rg_S)4p`M)@@sC%Pyn&jOG{7@I%mQXZSe
zY*YCT7FS^LL43ReL<hUP(k!mXl7~m^xHj42%b2I;U;fZDNYXsaLmb`y5Fbb)c4shu
z)X(_@GKt8O*TPY5Mj(^0yax|+<;k@em1mE4w*DZNJUM%&^6c@>mKOkd@<{QYvyeaU
z1R<Q9^^S!8N6JVN;eS?rUc72Hr;m7&xr=ggZtcR`{YR{2VPNEg_GfC>0}c|ONuoRj
zPQ^93^be;ouM7~s)RzZL5HEvwv%#Z<-TDXdPT)BkkbDAM8h9a2-?d8Hh5BhgIy;jB
zxc~q0^BLIPjkqf`LJZ<$?2$wsEg^~OAJ?C^pTYa+<~K>_V$yluM>jVllMs`Ncpu%I
zzT2@HaXL;K5myKQ-y$vt9poG0qU3>CCiR7JNBut!ooEQ+a!@XD#Ob@N<PfK^LDUha
zF_!82LhW9Jb}>Wp`=Gzkb%)BkL4PCH2_#Ye9_n)&;`Ciak%*rmgOW){5P!hKoHWE~
z%%$^)_vPnhC`O#V`--l2)XzrfSI?2W0vVJ{>Ofo#^#4RWf}FfCiI$J*FNAW@d4h6U
zo=Gr&baS%7BxS^vpg+t<d?xUvh-(73Kzt!^`mP&l*ATcblBe&!4@F!TCbENw)7W(J
zh-<)oHkpX)LO;nz+zkA=iTGjY|9zkxsQ)y^@Bqa12Jz}s3~?)%2jmg&1o>HrAAoV8
zi+DQdF++Sbd=+Db_#@Eoig+T7qpgUqg8mSScniqWcY)G+I0EgGgygGWL1S*a;wCEZ
z&)el(Mtn8Y|82y{I!w|_#LvO}@E-9j7$?6F9|Ge-5Y`RqPc8T<hIj#tFKNWz!n~@4
z_$XLlH4wK3KMfF{3++PRkxTvA1odEt<ex(Qdm>I_>joem3iAwocP`am1O5LnlK&0$
zkb*dkiIju53#{YU5U+-DSAlo}l<O(tK2V>p5zm44`+|5e_}K^S&~mMTaXJoh38-fo
z#C1Wh65=LAA(Lh!o(t=y9^&ppdGhR7%cQBEL%FPx{4eN-Zix4R{^N(Z9h55!aTBPY
z1BlOqc27n;2kPxC;vUc+t|0yp`fVBFW1(C$W*@Ep6HpILNS?-+>_nWtd+|5o#^C=z
z=wDR-QLsA_abak$iHQ5ad^jEPBQUNt5r<~sEJj=j_E#b933}`i&*OCmju+y`p&bJe
z4}^7pH{y*jj~zjL3C#bgh|57g&qdq{=8fx!--CL)i}+NqTZ_0o9jA!fK>K}0{5|O5
zhjByO@fEDE^gNVuIv<Wj@^t=`MV!u)s)*OYxYkCzKh*P5#7m&w%n^5hc3hA6D&U(D
zKL`Dm9Xpv+{RrqM`;hz<@G}YV@6cXn5Wfu_^fKaMz}c~riHal`zmJgo3-IS9;sU_m
zBi;<x7c>?yZ7(61e*|G(q5LVduNdNopq`}>-v(R>@lViR8i<dAen#J^PVJV1-z$-P
zCU85%3xU%Z4OGuhm=D8{d>YIr(TL~5`OkjDN5J`89OC<lAturJnA-gc?Nxx}-C+M3
z;xv|Q4dUuB&pbo?C)C?Z#Is>OX+?Y(%;)bA-wEyh8SxoVZ$A*94E>59{G#P;g7zJS
zxB<*F;)qAWJTnpT70@nI5jUahJK`^(z0?qY%WD>n2I3YVzYK9fs2_UXLCaMI<HZWe
z(|0*LARZ6>#0BvaP|x0o(^&Emh$q50V#ib_^FTPX%RwYR5BdXLm#F`3&>z?_m5ClP
zn9tcUl?gu&<z>fICVV__c1&f$={uX*F_j6w3+1gsey#<(>{!S|-Us}r*X7jzaOgkm
zSja@4#(-tVLMGe}&P)3c1x%uPF2i`Fv9l?sF;2%J`2|qkDTs#vS3~?Wa2>=OxLz=^
z01*EO--B5oei-VF9mANED~|lfq%BC^9{R&B#Ob@?>HI_v6BULqPtsV=l>dPI*+`EJ
zoW~X-9ti6rJN7WqzZ1$;i{ytu{j?&kMB5i}OW5xVcE~Q#PoK9Liuf()KN5)716M%&
zE%3RByMX@&i0^@UX%*tDp<E7#(|7T0M0_dCKf#F87({y!9|PwD@rcia{y<}()B2(P
z_!5#ghxz0-;>Iv<*C0+~+`d9wAMAcaTpH@L7nG0sL+1-o#NEK3afsi9{x%hH8q-uA
z@wd=V==Vv~E{%1!49S<m{A`1G2&^w2h~I$z5P<k(u)7;^8jIp6;yF;Rbi_x(c)Wo4
zZkRW3BCZJQ=0n73zi&jm2>R_i#6zLIej&aK+GQa03tFEpFfWZlJPY<^5U+rBM+I>$
z@JAc*P*@jef24K=p}(y|@-()X3*yWa!A&$4Io0D1^&E!e<3au);%#u=a}x2daGsEZ
zcn<h^9dR@0Klczn4CCh+;&gnzL3|*{e?vSB{1<@rjh6R2^q=8~PXa%s5MKf7h!Wy=
zpnqs0K93k;k|E;TVf|f$_(wQzbV6Ja>Sq(;G*-zD#IHg>iA6jb^dutQ4&|lq$ffnu
z4CC<%lK%nyzZ~%@=s!;or?Dbh5U20-{fxLLv`cUBi~2)jhz&-3AI$&ah^N51Bae7K
ztf#XP7ld&~=WlA4#@Jbb<gdfN9pZw}PiPE5s>ccX<#r^0652f)aSND-nOAvm6V)RN
z^_7Wu7?igF@oX56w-EmY?Mq{OQT;S_=}RPk0{VF;;yYj-pg+n|JwsuB6Ndgyxg^Ms
zL0li^ZCS*ZK>Mm8UI5qK^xei({|cy2`uhgu^TB@$q=&9s8xW`RzKC1FI0{94Bd?h_
zafoL^J7ywY0D3MUUI*j181YFkF76|q1oHKWx59k*25}M4^A+*gP|tl~eA9ZPu|tO-
zo&@7X9B~>;nSMV<^*BO#)segc^xK7q`@s2zDdGaKZ;7}el*<KiO|a{W_+}VK^m`iW
zXCm~g<4Arb%x@<VuY>l@Mx4f^y@dD`sP|IDX}eb=PW#~t#HT}h(fOGAF9hZ45Az)5
zx*$Is@lYbbBuT^@;Cw~_aT@b=4&uY1{`C>x4E4Vp@l4<}1}OD27Ul;}B!3<J2}FE5
z>_;I!1KKMN@!!zjG7zV+Lh1TI{Yiszl_2>TXvZqVM?$&SF@wpJNzZ%UBl&F5{~Pgj
zFn)z#9;N=2!F)a%@xjpUlM&a3dQ(N5ejliV_#&tu6U4{D{A`JMAoPD%#I=C?A#M)-
zha+AG{hJ*dnAF=1u$zM9Uqk)V*s`>K29cZlm{f%1&k_M9RU&>8^w%RU1@lik;%|U|
zN1U!_{h@r+A0Jp}$0AOD@0pDF0_guLh@XY>Y9l@r<kuojf0uMZoc^xugE;-&JQ#8M
z`#3w+FKHM0dwM#OZ-D(Xh<8AL$U~fY=!BatBYqqBYs5!Df9^p1HH`O9h!28w|2yJ-
za30eO=0)0GccGqz5vSk3k3yWz+mjHd>+cN2>3XV#I9*Q-5nlr1Vm0D)TsR<3&j)-F
zpAP+GFXH-8FG+|;Lcc9QoL&c3Bfbx=m)S9TNfkebd1(Zk7t?y)2>B%uUk!F=B3=RW
zqdDUAy2}Z1bzZmP1R}l}#`|8xTfiT7EL-CLGmy_m@=DOJ9wROQ{pTy<Q(?Xs3G*wh
zht0rc5kCj{H4!(5cBJ2{Q9TMUzFd&J8=M~=M4UVqLQ)pu_hJ3Y15U(XiQ>xB@B4{e
zQU&5%%ES<5=^-4dhePi-q<#iNxoFH<swWWiyg_<40Dq7CnE`w-obMAqp=!8C#;`c?
ze<jGzVR0hA4){VAC-U2XTe3KjKM34|#fkhO;8842<Q0G)22Sfi5&C%&OCF{$ZVq<L
zS5lWXpod<M(t4`^&W`y?`t2lWM|R9tqNfk3C?>IEz7kIFvu|SgNjSaV@ipR;LC;&{
zza&x4q<(OHK*UJ7mJ!ILvA}6P(DMKqla<KBkmJhhu;ht9I$&21aV_A>5VrzOW31A8
zTLs*LB~R*YHe9DWvN*9zzkl0+co69E08Vy^|BB2XN%VVh%AI(abCRWpYZvM<i=_vq
zRBnz6mOSz26xh9w_zB>TSe)qZ2mOH^!<FcH3i9k2u7uP3I9rjPTg)+%KC(EG9|+e?
zU5ImUAZL#MWO3rpH0F<_elQMbyJ&$PLB!_(7iDpxXE5y3`_ZT#`kVue?MnFy&?C#z
zL;R<)2IUdo0`k*YoOF>j%pXa!S)BMo`_BRvC;Cr;9(}|!fE%$m(X)X#%%qhpPV`&?
z`L&4C??bGBlV&CTCz$yoDFE?A9_GX$o(=pW;>ExpBTnamkBHNGj}O)*>W>cS5k`D1
z@X?6Z0-ug}6Yxcde*kWcIEf8Kk~?rxy`-KUU|re5l7~}IBF;I)k|*^~V?D+pUJC7!
zj(C4KUp<ZZZ;(I7;=~{NJ;r4gCw6Coo@<CJ1HZ}QL=U~c^B#*6J;osa5b-6z>Gv6=
zx=20H=M!GB<VpXRX8uU}#NtH1HR$<@xFv8p57F`H16&a1C(7M{4@LX{a52PVfKNa?
z54beqnZV@{e-2y;@jBqMfYbU(;MM|%V~XUzfcy%?KLKBh^i+W!AH?~f-^L>D4Dtzx
z)AN=Kh=+sxJ;V<IZ$X?szeFElr{$&3MT~^&Y|808AOW1TBk3n9pkI;2Nk0*QK}O%R
zN87zO@VQ7{68JpC#{*x4xF&ET#MOa2A-)c{3*u{l`>;4EmmZWWn8iuCHi7&u#5V%p
zgZNJ1`w*wUw;l#g>p33!Lki;L`EQbP5Pt-`8u72dUm)HO=B4k5TLB*n51x_i#Pty1
zN{G(_{d$Nm0=^7!d*B-pr_XilMw~v^k%Tyj5=PQp#OeD5>VT8}M&`+Ta9;8QaXJt8
z8&9<Txle}9tAi1z&moLMd^}w5%tibVob0bfypA}=BuB)D!S$~f;`H~$K*V3eJd=R<
z0<fEjcslgMLd2C}9xq3n`cns-G#{Ac`rpNpC*$HM=>LIuEbu<!+-%(Yk%;^a;QbM&
z_mK`pycy(&BVG@DJmT~|8A-(Z_2F=nB5+zR86M`S1E=#F@s*?n;@ppJ|5ZVcKH~KL
z1QW!UgZy&DO@OaM+yl4`;?BS~Aifv4JK_<*w;-Ma+#m7Nz=MF(`Z472(m@u7p~yXu
z$l|1*IC3e6^AK@g;4gsFar%%<x=d;o=YDkGw?_FJ#Oe1T?+`bD^VA7EH5}qUxqhc<
zJ8WS7n8jfTaS45{kjS$+eV+#9l8}D^0ZbwvP?g+$`rIGpVMv}{SDt2Z_H|+{;?%AX
zGzK|L<SD1I;3?POdc&OeA$i)qbiSwZ>p-5okAo!2gL%80%ZMief5_r6M7c-k^JPR2
zo2!#f!z9YZ$p(|?b0L(|b-@P7Tkym=n-KQ^eh~2x;OGCs8xbD`{&XQu&+Ga_VW^+<
ze2M<ffVmcur{8;6B0d4?aWmra;Lk3^>3KpNi-XJD5*Po4xBP{RLMJBX*m~3ur}O8E
zzi`jL@R+~wT*PVrq+@~18?cme%O%SFpVxobeu}d=6p>51uV0xxFvaDX-2eadbJ*>E
zzZj_p_B^nTCC{E`U^?UWXX4KUkekSoC;qH}eO1J1|ItU>7216*i<3Ip0Q;^i&aQ_o
zEY7Zn5Ef_GLlleCIw$Bbi?iz?nZ?=lAOW1T6=@?~*r)YCc`$HU_@w+k?8_rA3H6|a
z_(tILx`gUU1FnhWzXR7noSrA^BR&MiqY>g`fSV#N4SXfya=^_Ip8?z&aZTV3h|}2Z
zwEby$mw-H-|0t*5kNF@yHXy$haaZ7hi2DQIfjC`1==CVIy9eZ>k$f`neTe4*r~QrU
zq2I$CNAi^*Px~R2uK}Kh<U4_%Mw}l8%{jzHfnPv;B=F0Kj|YAoaT(wxh|}k#%MsTD
z`D);#y8_}8dL2eMdtASR@)6D+*Q+2i;p}m(4VejNkLzPB&K}p|j2ubC4BH>t{|RUN
z6VL3EL^#`@8(hlcY=1<FBTORlY=7wUe1x<8;mCV#-oU(Ei~02O;C(vKEidMkRUCO6
zOD{`~yp^XXN8ZDg><~#sc|~T|*4a{?2+4C_JH>jv)IZ-3)}tVO0~PB<U;l|5?=@FF
zO8)!JRy~US>!nivD3;p4iuK>VZi;7t`?4tuM;AL+rn+pcyzMP4t*kt3H-au6a(1<L
zcJ%Zj)kx|M<e1le*)wnbVlxjH`+o~MJG$6X<xKt4O@f(MdNKRft{X^LUXHwrtCy`j
z^D0p}?wiA4-`>Sr-p#|+&DO(fGZ?dVu(0#6++a(3%l~^Km&15$5UrZzzaA2F)9xb^
zm@UHCV}cyiB>(l0aQ;b*i~#fZf6YIY$xC$7b&=WRCQbNck1>L%efmk{$TpT+!Z4Bo
zc^}>XlQo^4W-&Wt+-tHS*$0Q#0heMv$vi;HN)r4$#=UOr$$kS@3f}Ju+vEe=w_#XM
z_T$06D495zMC_A!1>4`lu%7I@L4&w6$Jq(nk6;e=Wd98OpsfIziG4DEVfz;u)|35r
zV4q%hf|`GoKaV-kll=y;FHV#*iP$H%pke!s4C~3hI855~yps{*CS3kHhW2Eieo@RW
zKRHLn_W2p(#6Ir70brl5vs~k>{7@{;2*{87uO<L`9zgSB{|7Vqd-7iaPACf@BdI@<
z7yGXb_PY;&{5!BupK}3>#W)&&vHuS22dMLM68nRhKWu-=U+kyCeJJ$%;=kD^-%~LE
z{wM~)fML81dL9S3+dkbV??LUU{@h^T)IdKb{u7nh|4o0fF9s8YCN%_~G(W|jf3dIY
z&67w4L1Lf$G)VK)`6uEp_UV1+UXY)D(EN0N=U?o<1N#EZagvCA^3^oWPwglC#r{1I
zxB&AP(LoZ;&)Z|Zhy9EFu8lkicKwsJj^?NK$$baJMFn~Q6z?L!Oll^R1}jl9l82-V
zf64Dg7B(i)@5gw1f9%uzw`hJU0H1j>ybbv1K1%b^&q~POEdU$Oa7N%XAC-U30J1Ki
zYUVURemZ|qc>%fspX7HJq7&yAoy-$hfehmOADQDljh}mP0Ur%^NdJ*w{%C&Mem&VH
zSsY}^{~S&iQO+c3=5ILjhx3y)37>l~h_h}Q`JcI84iyX)hx=~Q9`pP1^3(TU^7de^
Jp*zgye*s{hI)?xN

literal 0
HcmV?d00001

diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index ff75a8f6d2..af5f9faec5 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -173,7 +173,7 @@ typedef enum {
     VINE_TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
     VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
     VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
-} vine_task_node_priority_mode_t;
+} vine_task_priority_mode_t;
 
 /** Statistics describing a manager. */
 struct vine_stats {
@@ -1613,14 +1613,12 @@ void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *pare
 @param node_key Reference to the node key.
 @param staging_dir Reference to the staging directory.
 @param prune_depth Reference to the prune depth.
-@param priority_mode Reference to the priority mode.
 @return A new node object.
 */
 struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
 	const char *node_key,
 	const char *staging_dir,
-	int prune_depth,
-	vine_task_node_priority_mode_t priority_mode);
+	int prune_depth);
 
 /** Set the replica placement policy (which worker do we prefer to place the redundant file replicas).
 @param q Reference to the current manager object.
@@ -1628,6 +1626,12 @@ struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
 */
 void vine_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
 
+/** Set the task priority mode for the task graph.
+@param tg Reference to the task graph object.
+@param priority_mode Reference to the priority mode.
+*/
+void vine_task_graph_set_task_priority_mode(struct vine_task_graph *tg, vine_task_priority_mode_t priority_mode);
+
 /** Set the type of the node-output file.
 @param tg Reference to the task graph object.
 @param node_key Reference to the node key.
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 3ff5965403..9ecde5a14a 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -6132,10 +6132,12 @@ int vine_tune(struct vine_manager *q, const char *name, double value)
 
 	} else if (!strcmp(name, "max-library-retries")) {
 		q->max_library_retries = MIN(1, value);
+
 	} else if (!strcmp(name, "disk-proportion-available-to-task")) {
 		if (value < 1 && value > 0) {
 			q->disk_proportion_available_to_task = value;
 		}
+
 	} else if (!strcmp(name, "enforce-worker-eviction-interval")) {
 		q->enforce_worker_eviction_interval = (timestamp_t)(MAX(0, (int)value) * ONE_SECOND);
 
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index 12be13a26c..f6663d0989 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -233,14 +233,15 @@ void vine_set_replica_placement_policy(struct vine_manager *q, vine_replica_plac
 
 	switch (policy) {
 	case VINE_REPLICA_PLACEMENT_POLICY_RANDOM:
-		debug(D_VINE, "Setting replica placement policy to RANDOM");
+		debug(D_VINE | D_NOTICE, "Setting replica placement policy to RANDOM");
 		q->replica_placement_policy = policy;
 		break;
 	case VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD:
-		debug(D_VINE, "Setting replica placement policy to DISK_LOAD");
+		debug(D_VINE | D_NOTICE, "Setting replica placement policy to DISK_LOAD");
 		q->replica_placement_policy = policy;
 		break;
 	case VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD:
+		debug(D_VINE | D_NOTICE, "Setting replica placement policy to TRANSFER_LOAD");
 		q->replica_placement_policy = policy;
 		break;
 	default:

From 38c7cff0f2c7956f291e7da97c94311e1de7aa9a Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 16 Oct 2025 02:35:30 -0400
Subject: [PATCH 036/113] new interface

---
 taskvine/src/graph/dagvine/graph_executor.py | 110 ++++++++-----------
 taskvine/src/graph/dagvine/params.py         |  39 ++++++-
 2 files changed, 85 insertions(+), 64 deletions(-)

diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index 7b2f4c7323..ac910b8d35 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -5,7 +5,7 @@
 from ndcctools.taskvine.dagvine.graph_definition import GraphKeyResult, TaskGraph
 from ndcctools.taskvine.dagvine.params import ManagerTuningParams
 from ndcctools.taskvine.dagvine.params import VineConstantParams
-
+from ndcctools.taskvine.dagvine.params import RegularParams
 
 import cloudpickle
 import os
@@ -69,95 +69,81 @@ def ensure_task_dict(collection_dict):
 class GraphExecutor(Manager):
     def __init__(self,
                  *args,
-                 manager_tuning_params=None,
-                 library=None,
-                 worker_cores=16,
+                 manager_tuning_params=ManagerTuningParams(),
+                 regular_params=RegularParams(),
+                 vine_constant_params=VineConstantParams(),
                  **kwargs):
 
         signal.signal(signal.SIGINT, self._on_sigint)
 
-        # delete all files in the run info template directory, do this before super().__init__()
-        self.run_info_path = kwargs.get('run_info_path')
-        self.run_info_template = kwargs.get('run_info_template')
-        self.run_info_path_absolute = os.path.join(self.run_info_path, self.run_info_template)
-        if self.run_info_path and self.run_info_template:
-            delete_all_files(self.run_info_path_absolute)
+        self.manager_tuning_params = manager_tuning_params
+        self.vine_constant_params = vine_constant_params
+        self.regular_params = regular_params
 
-        # initialize the manager
-        super_params = set(inspect.signature(Manager.__init__).parameters)
-        super_kwargs = {k: v for k, v in kwargs.items() if k in super_params}
+        # delete all files in the run info directory, do this before super().__init__()
+        run_info_path = self.regular_params.run_info_path
+        run_info_template = self.regular_params.run_info_template
+        self.run_info_path_absolute = os.path.join(run_info_path, run_info_template)
+        if run_info_path and run_info_template:
+            delete_all_files(self.run_info_path_absolute)
 
-        super().__init__(*args, **super_kwargs)
+        kwargs["run_info_path"] = run_info_path
+        kwargs["run_info_template"] = run_info_template
+        super().__init__(*args, **kwargs)
         print(f"TaskVine Manager \033[92m{self.name}\033[0m listening on port \033[92m{self.port}\033[0m")
 
-        # tune the manager
-        if manager_tuning_params:
-            assert isinstance(manager_tuning_params, ManagerTuningParams), "manager_tuning_params must be an instance of ManagerTuningParams"
-            for k, v in manager_tuning_params.to_dict().items():
-                print(f"Tuning {k} to {v}")
-                self.tune(k, v)
-
         # initialize the task graph
         self._vine_task_graph = cvine.vine_task_graph_create(self._taskvine)
 
-        # create library task
-        self.library = library
-        self.library.install(self, worker_cores, self._vine_task_graph)
+    def tune_manager(self):
+        for k, v in self.manager_tuning_params.to_dict().items():
+            print(f"Tuning {k} to {v}")
+            self.tune(k, v)
+
+    def set_policy(self):
+        # set replica placement policy
+        cvine.vine_set_replica_placement_policy(self._taskvine, self.vine_constant_params.get_c_constant_of("replica_placement_policy"))
+        # set worker scheduling algorithm
+        cvine.vine_set_scheduler(self._taskvine, self.vine_constant_params.get_c_constant_of("schedule"))
+        # set task priority mode
+        cvine.vine_task_graph_set_task_priority_mode(self._vine_task_graph, self.vine_constant_params.get_c_constant_of("task_priority_mode"))
 
     def run(self,
             collection_dict,
             target_keys=[],
-            replica_placement_policy="random",
-            priority_mode="largest-input-first",
-            # scheduling_mode="files",
-            extra_task_output_size_mb=["uniform", 0, 0],
-            extra_task_sleep_time=["uniform", 0, 0],
-            prune_depth=1,
-            shared_file_system_dir="/project01/ndcms/jzhou24/shared_file_system",
-            staging_dir="/project01/ndcms/jzhou24/staging",
-            failure_injection_step_percent=-1,
-            vine_constant_params=None,
-            outfile_type={
-                "temp": 1.0,
-                "shared-file-system": 0.0,
-            }):
+            library=None,
+            ):
+
+        # tune the manager every time we start a new run as the parameters may have changed
+        self.tune_manager()
+        # set the policy every time we start a new run as the parameters may have changed
+        self.set_policy()
+
         self.target_keys = target_keys
         self.task_dict = ensure_task_dict(collection_dict)
 
-        cvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, failure_injection_step_percent)
+        # create library task
+        self.library = library
+        self.library.install(self, self.regular_params.libcores, self._vine_task_graph)
 
-        # self.set_scheduler(scheduling_mode)
+        cvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, self.regular_params.failure_injection_step_percent)
 
         # create task graph in the python side
         print("Initializing TaskGraph object")
-        self.shared_file_system_dir = shared_file_system_dir
-        self.staging_dir = staging_dir
         self.task_graph = TaskGraph(self.task_dict,
-                                    staging_dir=self.staging_dir,
-                                    shared_file_system_dir=self.shared_file_system_dir,
-                                    extra_task_output_size_mb=extra_task_output_size_mb,
-                                    extra_task_sleep_time=extra_task_sleep_time)
+                                    staging_dir=self.regular_params.staging_dir,
+                                    shared_file_system_dir=self.regular_params.shared_file_system_dir,
+                                    extra_task_output_size_mb=self.regular_params.extra_task_output_size_mb,
+                                    extra_task_sleep_time=self.regular_params.extra_task_sleep_time)
         topo_order = self.task_graph.get_topological_order()
 
-        # the sum of the values in outfile_type must be 1.0
-        assert sum(list(outfile_type.values())) == 1.0
-
-        if vine_constant_params:
-            assert isinstance(vine_constant_params, VineConstantParams), "vine_constant_params must be an instance of VineConstantParams"
-            # set replica placement policy
-            cvine.vine_set_replica_placement_policy(self._taskvine, vine_constant_params.get_c_constant_of("replica_placement_policy"))
-            # set worker scheduling algorithm
-            cvine.vine_set_scheduler(self._taskvine, vine_constant_params.get_c_constant_of("schedule"))
-            # set task priority mode
-            cvine.vine_task_graph_set_task_priority_mode(self._vine_task_graph, vine_constant_params.get_c_constant_of("task_priority_mode"))
-
         # create task graph in the python side
         print("Initializing task graph in TaskVine")
         for k in topo_order:
             cvine.vine_task_graph_add_node(self._vine_task_graph,
                                            self.task_graph.vine_key_of[k],
-                                           self.staging_dir,
-                                           prune_depth)
+                                           self.regular_params.staging_dir,
+                                           self.regular_params.prune_depth)
             for pk in self.task_graph.parents_of.get(k, []):
                 cvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
 
@@ -172,7 +158,7 @@ def run(self,
 
         # keys with larger heavy score should be stored into the shared file system
         sorted_keys = sorted(heavy_scores, key=lambda x: heavy_scores[x], reverse=True)
-        shared_file_system_size = round(len(sorted_keys) * outfile_type["shared-file-system"])
+        shared_file_system_size = round(len(sorted_keys) * self.regular_params.outfile_type["shared-file-system"])
         for i, k in enumerate(sorted_keys):
             if k in self.target_keys:
                 choice = "local"
@@ -195,7 +181,7 @@ def run(self,
             cloudpickle.dump(self.task_graph, f)
 
         # now execute the vine graph
-        print(f"Executing task graph, logs will be written into {self.run_info_path_absolute}")
+        print(f"\033[92mExecuting task graph, logs will be written into {self.run_info_path_absolute}\033[0m")
         cvine.vine_task_graph_execute(self._vine_task_graph)
 
         # after execution, we need to load results of target keys
diff --git a/taskvine/src/graph/dagvine/params.py b/taskvine/src/graph/dagvine/params.py
index 4e21e10916..1f4a363760 100644
--- a/taskvine/src/graph/dagvine/params.py
+++ b/taskvine/src/graph/dagvine/params.py
@@ -1,9 +1,11 @@
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from ndcctools.taskvine.utils import get_c_constant
 
 
 @dataclass
 class ManagerTuningParams:
+    """These parameters are used to tune the manager at the C level 
+    and should comply with the TaskVine manager API."""
     worker_source_max_transfers: int = 100
     max_retrievals: int = -1
     prefer_dispatch: int = 1
@@ -75,4 +77,37 @@ def get_c_constant_of(self, key):
         normalized_key = self.normalize(key)
         if normalized_key not in self.valid_normalized_values:
             raise ValueError(f"Invalid key: {normalized_key}")
-        return get_c_constant(f"{normalized_key.upper()}_{getattr(self, normalized_key).upper()}")
\ No newline at end of file
+        return get_c_constant(f"{normalized_key.upper()}_{getattr(self, normalized_key).upper()}")
+
+
+@dataclass
+class RegularParams:
+    """Regular parameters that will be used directly by the graph executor."""
+    run_info_path: str = None
+    run_info_template: str = None
+    libcores: int = 16
+    failure_injection_step_percent: int = -1
+    prune_depth: int = 1
+    staging_dir: str = "./staging"
+    shared_file_system_dir: str = "./shared_file_system"
+    extra_task_output_size_mb: list[str, float, float] = field(default_factory=lambda: ["uniform", 0, 0])
+    extra_task_sleep_time: list[str, float, float] = field(default_factory=lambda: ["uniform", 0, 0])
+    outfile_type: dict[str, float] = field(default_factory=lambda: {
+        "temp": 1.0,
+        "shared-file-system": 0.0,
+    })
+
+    def update(self, params: dict):
+        """Update configuration from a dict.
+        - Convert '-' in keys to '_', values are as is.
+        """
+        if not isinstance(params, dict):
+            raise TypeError(f"update() expects a dict, got {type(params).__name__}")
+
+        for k, v in params.items():
+            normalized_key = k.replace("-", "_")
+            if normalized_key not in self.__dict__.keys():
+                raise ValueError(f"Invalid param key: {normalized_key}")
+
+            setattr(self, normalized_key, v)
+        return self

From dbe57a8f96026761146ff3c42270a46d0dddfb04 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 16 Oct 2025 14:12:26 -0400
Subject: [PATCH 037/113] api change

---
 taskvine/src/Makefile                        |   1 +
 taskvine/src/bindings/python3/taskvine.i     |   2 +-
 taskvine/src/graph/dagvine/.gitignore        |   5 +
 taskvine/src/graph/dagvine/Makefile          |  27 ++++-
 taskvine/src/graph/dagvine/cdagvine.py       | 107 ++++++++++++++++++
 taskvine/src/graph/dagvine/cvine_dagvine.py  | 107 ++++++++++++++++++
 taskvine/src/graph/dagvine/graph_executor.py |  27 ++---
 taskvine/src/graph/dagvine/vine_task_graph.c |  40 +++++--
 taskvine/src/graph/dagvine/vine_task_graph.h | 113 +++++++++++++++++--
 taskvine/src/graph/dagvine/vine_task_graph.i |  18 +++
 taskvine/src/manager/taskvine.h              |  96 +---------------
 taskvine/src/manager/vine_manager.c          |   2 +-
 taskvine/src/manager/vine_temp.c             |   2 +-
 13 files changed, 410 insertions(+), 137 deletions(-)
 create mode 100644 taskvine/src/graph/dagvine/cdagvine.py
 create mode 100644 taskvine/src/graph/dagvine/cvine_dagvine.py
 create mode 100644 taskvine/src/graph/dagvine/vine_task_graph.i

diff --git a/taskvine/src/Makefile b/taskvine/src/Makefile
index 5c8858a2e4..1bd3ef4f43 100644
--- a/taskvine/src/Makefile
+++ b/taskvine/src/Makefile
@@ -6,6 +6,7 @@ TARGETS=manager worker tools bindings examples graph
 all: $(TARGETS)
 
 worker: manager
+graph: manager
 bindings: manager graph
 tools: manager
 examples: manager worker tools bindings
diff --git a/taskvine/src/bindings/python3/taskvine.i b/taskvine/src/bindings/python3/taskvine.i
index ba4e66cb74..1d875f97be 100644
--- a/taskvine/src/bindings/python3/taskvine.i
+++ b/taskvine/src/bindings/python3/taskvine.i
@@ -1,5 +1,5 @@
 /* taskvine.i */
-%module cvine
+%module(package="ndcctools.taskvine") cvine
 
 %include carrays.i
 %array_functions(struct rmsummary *, rmsummayArray);
diff --git a/taskvine/src/graph/dagvine/.gitignore b/taskvine/src/graph/dagvine/.gitignore
index e69de29bb2..3e98d74473 100644
--- a/taskvine/src/graph/dagvine/.gitignore
+++ b/taskvine/src/graph/dagvine/.gitignore
@@ -0,0 +1,5 @@
+*.a
+*.so
+*.o
+*_wrap.c
+*_wrap.0
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index 497c798a4f..ba1b84c43b 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -7,10 +7,14 @@ LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 SOURCES = vine_task_node.c vine_task_graph.c
 OBJECTS = $(SOURCES:%.c=%.o)
 
+SWIG_I = vine_task_graph.i
+SWIG_WRAP = vine_task_graph_wrap.c
+PYMODULE = _cdagvine.$(CCTOOLS_DYNAMIC_SUFFIX)
+
 LIBRARIES = libdagvine.a
 PROGRAMS =
 SCRIPTS =
-TARGETS = $(LIBRARIES) $(PROGRAMS)
+TARGETS = $(LIBRARIES) $(PYMODULE) $(PROGRAMS)
 
 all: $(TARGETS)
 
@@ -18,14 +22,33 @@ libdagvine.a: $(OBJECTS)
 
 $(PROGRAMS): $(EXTERNALS)
 
+$(SWIG_WRAP): $(SWIG_I) vine_task_graph.h
+	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -o $@ $<
+
+# Build Python module
+vine_task_graph_wrap.o: $(SWIG_WRAP)
+	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) $(LOCAL_CCFLAGS) $<
+
+$(PYMODULE): vine_task_graph_wrap.o libdagvine.a
+ifeq ($(CCTOOLS_STATIC),1)
+	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $^ $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
+else
+	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $^ $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
+endif
+
+
+
 install: all
 	mkdir -p $(CCTOOLS_INSTALL_DIR)/lib
 	cp $(LIBRARIES) $(CCTOOLS_INSTALL_DIR)/lib/
 	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include
 	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include/
+	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
+	cp $(PYMODULE) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
+	cp cdagvine.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
 
 clean:
-	rm -rf $(PROGRAMS) $(OBJECTS) *.o
+	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(SWIG_WRAP) vine_task_graph_wrap.o $(PYMODULE) cdagvine.py
 
 test: all
 
diff --git a/taskvine/src/graph/dagvine/cdagvine.py b/taskvine/src/graph/dagvine/cdagvine.py
new file mode 100644
index 0000000000..920389fda9
--- /dev/null
+++ b/taskvine/src/graph/dagvine/cdagvine.py
@@ -0,0 +1,107 @@
+# This file was automatically generated by SWIG (https://www.swig.org).
+# Version 4.3.1
+#
+# Do not make changes to this file unless you know what you are doing - modify
+# the SWIG interface file instead.
+
+from sys import version_info as _swig_python_version_info
+# Import the low-level C/C++ module
+if __package__ or "." in __name__:
+    from . import _cdagvine
+else:
+    import _cdagvine
+
+try:
+    import builtins as __builtin__
+except ImportError:
+    import __builtin__
+
+def _swig_repr(self):
+    try:
+        strthis = "proxy of " + self.this.__repr__()
+    except __builtin__.Exception:
+        strthis = ""
+    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
+
+
+def _swig_setattr_nondynamic_instance_variable(set):
+    def set_instance_attr(self, name, value):
+        if name == "this":
+            set(self, name, value)
+        elif name == "thisown":
+            self.this.own(value)
+        elif hasattr(self, name) and isinstance(getattr(type(self), name), property):
+            set(self, name, value)
+        else:
+            raise AttributeError("You cannot add instance attributes to %s" % self)
+    return set_instance_attr
+
+
+def _swig_setattr_nondynamic_class_variable(set):
+    def set_class_attr(cls, name, value):
+        if hasattr(cls, name) and not isinstance(getattr(cls, name), property):
+            set(cls, name, value)
+        else:
+            raise AttributeError("You cannot add class attributes to %s" % cls)
+    return set_class_attr
+
+
+def _swig_add_metaclass(metaclass):
+    """Class decorator for adding a metaclass to a SWIG wrapped class - a slimmed down version of six.add_metaclass"""
+    def wrapper(cls):
+        return metaclass(cls.__name__, cls.__bases__, cls.__dict__.copy())
+    return wrapper
+
+
+class _SwigNonDynamicMeta(type):
+    """Meta class to enforce nondynamic attributes (no new attributes) for a class"""
+    __setattr__ = _swig_setattr_nondynamic_class_variable(type.__setattr__)
+
+
+import ndcctools.taskvine.cvine
+class vine_task_graph(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    manager = property(_cdagvine.vine_task_graph_manager_get, _cdagvine.vine_task_graph_manager_set)
+    nodes = property(_cdagvine.vine_task_graph_nodes_get, _cdagvine.vine_task_graph_nodes_set)
+    task_id_to_node = property(_cdagvine.vine_task_graph_task_id_to_node_get, _cdagvine.vine_task_graph_task_id_to_node_set)
+    outfile_cachename_to_node = property(_cdagvine.vine_task_graph_outfile_cachename_to_node_get, _cdagvine.vine_task_graph_outfile_cachename_to_node_set)
+    proxy_library_name = property(_cdagvine.vine_task_graph_proxy_library_name_get, _cdagvine.vine_task_graph_proxy_library_name_set)
+    proxy_function_name = property(_cdagvine.vine_task_graph_proxy_function_name_get, _cdagvine.vine_task_graph_proxy_function_name_set)
+    task_priority_mode = property(_cdagvine.vine_task_graph_task_priority_mode_get, _cdagvine.vine_task_graph_task_priority_mode_set)
+    failure_injection_step_percent = property(_cdagvine.vine_task_graph_failure_injection_step_percent_get, _cdagvine.vine_task_graph_failure_injection_step_percent_set)
+
+    def __init__(self):
+        _cdagvine.vine_task_graph_swiginit(self, _cdagvine.new_vine_task_graph())
+    __swig_destroy__ = _cdagvine.delete_vine_task_graph
+
+# Register vine_task_graph in _cdagvine:
+_cdagvine.vine_task_graph_swigregister(vine_task_graph)
+
+def vine_task_graph_create(q):
+    return _cdagvine.vine_task_graph_create(q)
+
+def vine_task_graph_set_task_priority_mode(tg, priority_mode):
+    return _cdagvine.vine_task_graph_set_task_priority_mode(tg, priority_mode)
+
+def vine_task_graph_set_failure_injection_step_percent(tg, percent):
+    return _cdagvine.vine_task_graph_set_failure_injection_step_percent(tg, percent)
+
+def vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth):
+    return _cdagvine.vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth)
+
+def vine_task_graph_add_dependency(tg, parent_key, child_key):
+    return _cdagvine.vine_task_graph_add_dependency(tg, parent_key, child_key)
+
+def vine_task_graph_compute_topology_metrics(tg):
+    return _cdagvine.vine_task_graph_compute_topology_metrics(tg)
+
+def vine_task_graph_get_node_heavy_score(tg, node_key):
+    return _cdagvine.vine_task_graph_get_node_heavy_score(tg, node_key)
+
+def vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name):
+    return _cdagvine.vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name)
+
+def vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name):
+    return _cdagvine.vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name)
+
diff --git a/taskvine/src/graph/dagvine/cvine_dagvine.py b/taskvine/src/graph/dagvine/cvine_dagvine.py
new file mode 100644
index 0000000000..c705763a26
--- /dev/null
+++ b/taskvine/src/graph/dagvine/cvine_dagvine.py
@@ -0,0 +1,107 @@
+# This file was automatically generated by SWIG (https://www.swig.org).
+# Version 4.3.1
+#
+# Do not make changes to this file unless you know what you are doing - modify
+# the SWIG interface file instead.
+
+from sys import version_info as _swig_python_version_info
+# Import the low-level C/C++ module
+if __package__ or "." in __name__:
+    from . import _cvine_dagvine
+else:
+    import _cvine_dagvine
+
+try:
+    import builtins as __builtin__
+except ImportError:
+    import __builtin__
+
+def _swig_repr(self):
+    try:
+        strthis = "proxy of " + self.this.__repr__()
+    except __builtin__.Exception:
+        strthis = ""
+    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
+
+
+def _swig_setattr_nondynamic_instance_variable(set):
+    def set_instance_attr(self, name, value):
+        if name == "this":
+            set(self, name, value)
+        elif name == "thisown":
+            self.this.own(value)
+        elif hasattr(self, name) and isinstance(getattr(type(self), name), property):
+            set(self, name, value)
+        else:
+            raise AttributeError("You cannot add instance attributes to %s" % self)
+    return set_instance_attr
+
+
+def _swig_setattr_nondynamic_class_variable(set):
+    def set_class_attr(cls, name, value):
+        if hasattr(cls, name) and not isinstance(getattr(cls, name), property):
+            set(cls, name, value)
+        else:
+            raise AttributeError("You cannot add class attributes to %s" % cls)
+    return set_class_attr
+
+
+def _swig_add_metaclass(metaclass):
+    """Class decorator for adding a metaclass to a SWIG wrapped class - a slimmed down version of six.add_metaclass"""
+    def wrapper(cls):
+        return metaclass(cls.__name__, cls.__bases__, cls.__dict__.copy())
+    return wrapper
+
+
+class _SwigNonDynamicMeta(type):
+    """Meta class to enforce nondynamic attributes (no new attributes) for a class"""
+    __setattr__ = _swig_setattr_nondynamic_class_variable(type.__setattr__)
+
+
+import cvine
+class vine_task_graph(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    manager = property(_cvine_dagvine.vine_task_graph_manager_get, _cvine_dagvine.vine_task_graph_manager_set)
+    nodes = property(_cvine_dagvine.vine_task_graph_nodes_get, _cvine_dagvine.vine_task_graph_nodes_set)
+    task_id_to_node = property(_cvine_dagvine.vine_task_graph_task_id_to_node_get, _cvine_dagvine.vine_task_graph_task_id_to_node_set)
+    outfile_cachename_to_node = property(_cvine_dagvine.vine_task_graph_outfile_cachename_to_node_get, _cvine_dagvine.vine_task_graph_outfile_cachename_to_node_set)
+    proxy_library_name = property(_cvine_dagvine.vine_task_graph_proxy_library_name_get, _cvine_dagvine.vine_task_graph_proxy_library_name_set)
+    proxy_function_name = property(_cvine_dagvine.vine_task_graph_proxy_function_name_get, _cvine_dagvine.vine_task_graph_proxy_function_name_set)
+    task_priority_mode = property(_cvine_dagvine.vine_task_graph_task_priority_mode_get, _cvine_dagvine.vine_task_graph_task_priority_mode_set)
+    failure_injection_step_percent = property(_cvine_dagvine.vine_task_graph_failure_injection_step_percent_get, _cvine_dagvine.vine_task_graph_failure_injection_step_percent_set)
+
+    def __init__(self):
+        _cvine_dagvine.vine_task_graph_swiginit(self, _cvine_dagvine.new_vine_task_graph())
+    __swig_destroy__ = _cvine_dagvine.delete_vine_task_graph
+
+# Register vine_task_graph in _cvine_dagvine:
+_cvine_dagvine.vine_task_graph_swigregister(vine_task_graph)
+
+def vine_task_graph_create(q):
+    return _cvine_dagvine.vine_task_graph_create(q)
+
+def vine_task_graph_set_task_priority_mode(tg, priority_mode):
+    return _cvine_dagvine.vine_task_graph_set_task_priority_mode(tg, priority_mode)
+
+def vine_task_graph_set_failure_injection_step_percent(tg, percent):
+    return _cvine_dagvine.vine_task_graph_set_failure_injection_step_percent(tg, percent)
+
+def vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth):
+    return _cvine_dagvine.vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth)
+
+def vine_task_graph_add_dependency(tg, parent_key, child_key):
+    return _cvine_dagvine.vine_task_graph_add_dependency(tg, parent_key, child_key)
+
+def vine_task_graph_compute_topology_metrics(tg):
+    return _cvine_dagvine.vine_task_graph_compute_topology_metrics(tg)
+
+def vine_task_graph_get_node_heavy_score(tg, node_key):
+    return _cvine_dagvine.vine_task_graph_get_node_heavy_score(tg, node_key)
+
+def vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name):
+    return _cvine_dagvine.vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name)
+
+def vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name):
+    return _cvine_dagvine.vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name)
+
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index ac910b8d35..c0ae5757a6 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -1,4 +1,5 @@
 from ndcctools.taskvine import cvine
+from ndcctools.taskvine.dagvine import cdagvine
 from ndcctools.taskvine.manager import Manager
 from ndcctools.taskvine.utils import delete_all_files, get_c_constant
 
@@ -74,7 +75,7 @@ def __init__(self,
                  vine_constant_params=VineConstantParams(),
                  **kwargs):
 
-        signal.signal(signal.SIGINT, self._on_sigint)
+        # Use C-side SIGINT handler in cdagvine to handle Ctrl+C gracefully
 
         self.manager_tuning_params = manager_tuning_params
         self.vine_constant_params = vine_constant_params
@@ -93,7 +94,7 @@ def __init__(self,
         print(f"TaskVine Manager \033[92m{self.name}\033[0m listening on port \033[92m{self.port}\033[0m")
 
         # initialize the task graph
-        self._vine_task_graph = cvine.vine_task_graph_create(self._taskvine)
+        self._vine_task_graph = cdagvine.vine_task_graph_create(self._taskvine)
 
     def tune_manager(self):
         for k, v in self.manager_tuning_params.to_dict().items():
@@ -102,11 +103,11 @@ def tune_manager(self):
 
     def set_policy(self):
         # set replica placement policy
-        cvine.vine_set_replica_placement_policy(self._taskvine, self.vine_constant_params.get_c_constant_of("replica_placement_policy"))
+        cvine.vine_temp_set_replica_placement_policy(self._taskvine, self.vine_constant_params.get_c_constant_of("replica_placement_policy"))
         # set worker scheduling algorithm
         cvine.vine_set_scheduler(self._taskvine, self.vine_constant_params.get_c_constant_of("schedule"))
         # set task priority mode
-        cvine.vine_task_graph_set_task_priority_mode(self._vine_task_graph, self.vine_constant_params.get_c_constant_of("task_priority_mode"))
+        cdagvine.vine_task_graph_set_task_priority_mode(self._vine_task_graph, self.vine_constant_params.get_c_constant_of("task_priority_mode"))
 
     def run(self,
             collection_dict,
@@ -126,7 +127,7 @@ def run(self,
         self.library = library
         self.library.install(self, self.regular_params.libcores, self._vine_task_graph)
 
-        cvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, self.regular_params.failure_injection_step_percent)
+        cdagvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, self.regular_params.failure_injection_step_percent)
 
         # create task graph in the python side
         print("Initializing TaskGraph object")
@@ -140,21 +141,21 @@ def run(self,
         # create task graph in the python side
         print("Initializing task graph in TaskVine")
         for k in topo_order:
-            cvine.vine_task_graph_add_node(self._vine_task_graph,
+            cdagvine.vine_task_graph_add_node(self._vine_task_graph,
                                            self.task_graph.vine_key_of[k],
                                            self.regular_params.staging_dir,
                                            self.regular_params.prune_depth)
             for pk in self.task_graph.parents_of.get(k, []):
-                cvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
+                cdagvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
 
         # we must finalize the graph in c side after all nodes and dependencies are added
         # this includes computing various metrics for each node, such as depth, height, heavy score, etc.
-        cvine.vine_task_graph_compute_topology_metrics(self._vine_task_graph)
+        cdagvine.vine_task_graph_compute_topology_metrics(self._vine_task_graph)
 
         # then we can use the heavy score to sort the nodes and specify their outfile remote names
         heavy_scores = {}
         for k in self.task_graph.task_dict.keys():
-            heavy_scores[k] = cvine.vine_task_graph_get_node_heavy_score(self._vine_task_graph, self.task_graph.vine_key_of[k])
+            heavy_scores[k] = cdagvine.vine_task_graph_get_node_heavy_score(self._vine_task_graph, self.task_graph.vine_key_of[k])
 
         # keys with larger heavy score should be stored into the shared file system
         sorted_keys = sorted(heavy_scores, key=lambda x: heavy_scores[x], reverse=True)
@@ -171,7 +172,7 @@ def run(self,
             self.task_graph.set_outfile_type_of(k, choice)
             # set on the C side, so the manager knows where the data is stored
             outfile_type_str = f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}"
-            cvine.vine_task_graph_set_node_outfile(self._vine_task_graph,
+            cdagvine.vine_task_graph_set_node_outfile(self._vine_task_graph,
                                                    self.task_graph.vine_key_of[k],
                                                    get_c_constant(outfile_type_str),
                                                    self.task_graph.outfile_remote_name[k])
@@ -182,12 +183,12 @@ def run(self,
 
         # now execute the vine graph
         print(f"\033[92mExecuting task graph, logs will be written into {self.run_info_path_absolute}\033[0m")
-        cvine.vine_task_graph_execute(self._vine_task_graph)
+        cdagvine.vine_task_graph_execute(self._vine_task_graph)
 
         # after execution, we need to load results of target keys
         results = {}
         for k in self.target_keys:
-            local_outfile_path = cvine.vine_task_graph_get_node_local_outfile_source(self._vine_task_graph, self.task_graph.vine_key_of[k])
+            local_outfile_path = cdagvine.vine_task_graph_get_node_local_outfile_source(self._vine_task_graph, self.task_graph.vine_key_of[k])
             if not os.path.exists(local_outfile_path):
                 results[k] = "NOT_FOUND"
                 continue
@@ -202,7 +203,7 @@ def _on_sigint(self, signum, frame):
 
     def __del__(self):
         if hasattr(self, '_vine_task_graph') and self._vine_task_graph:
-            cvine.vine_task_graph_delete(self._vine_task_graph)
+            cdagvine.vine_task_graph_delete(self._vine_task_graph)
 
         if hasattr(self, 'library') and self.library.local_path and os.path.exists(self.library.local_path):
             os.remove(self.library.local_path)
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.c b/taskvine/src/graph/dagvine/vine_task_graph.c
index cdc37dddc4..829a3fb4e9 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.c
+++ b/taskvine/src/graph/dagvine/vine_task_graph.c
@@ -27,6 +27,7 @@
 #include "vine_task.h"
 #include "vine_file.h"
 #include "vine_mount.h"
+#include "taskvine.h"
 
 
 static volatile sig_atomic_t interrupted = 0;
@@ -134,7 +135,7 @@ static void submit_unblocked_children(struct vine_task_graph *tg, struct vine_ta
 		return;
 	}
 
-	struct vine_task_node *child_node;
+	struct vine_task_node *child_node; 
 	LIST_ITERATE(node->children, child_node)
 	{
 		/* Remove this parent from the child's pending set if it exists */
@@ -348,30 +349,45 @@ static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struc
 /*************************************************************/
 
 /**
- * Set the proxy library and function names (Python-side), shared by all tasks.
+ * Set the proxy library name (Python-side), shared by all tasks.
  * @param tg Reference to the task graph object.
  * @param proxy_library_name Reference to the proxy library name.
- * @param proxy_function_name Reference to the proxy function name.
  */
-void vine_task_graph_set_proxy_library_and_function_names(struct vine_task_graph *tg,
-	const char *proxy_library_name,
-	const char *proxy_function_name)
+void vine_task_graph_set_proxy_library_name(struct vine_task_graph *tg, const char *proxy_library_name)
 {
-	if (!tg || !proxy_library_name || !proxy_function_name) {
+	if (!tg || !proxy_library_name) {
 		return;
 	}
 
-	/* free the existing proxy library and function names if they exist */
+	/* free the existing proxy library name if it exists */
 	if (tg->proxy_library_name) {
 		free(tg->proxy_library_name);
 	}
+
+	tg->proxy_library_name = xxstrdup(proxy_library_name);
+
+	return;
+}
+
+/**
+ * Set the proxy function name (Python-side), shared by all tasks.
+ * @param tg Reference to the task graph object.
+ * @param proxy_function_name Reference to the proxy function name.
+ */
+void vine_task_graph_set_proxy_function_name(struct vine_task_graph *tg, const char *proxy_function_name)
+{
+	if (!tg || !proxy_function_name) {
+		return;
+	}
+
+	/* free the existing proxy function name if it exists */
 	if (tg->proxy_function_name) {
 		free(tg->proxy_function_name);
 	}
 
-	/* set the new proxy library and function names */
-	tg->proxy_library_name = xxstrdup(proxy_library_name);
 	tg->proxy_function_name = xxstrdup(proxy_function_name);
+
+	return;
 }
 
 /**
@@ -619,8 +635,6 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	vine_enable_debug_log(debug_tmp);
 	free(debug_tmp);
 
-	signal(SIGINT, handle_sigint);
-
 	return tg;
 }
 
@@ -724,6 +738,8 @@ void vine_task_graph_execute(struct vine_task_graph *tg)
 		return;
 	}
 
+	signal(SIGINT, handle_sigint);
+
 	debug(D_VINE, "start executing task graph");
 
 	/* print the info of all nodes */
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.h b/taskvine/src/graph/dagvine/vine_task_graph.h
index 488d520bca..5fd81fdd6c 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.h
+++ b/taskvine/src/graph/dagvine/vine_task_graph.h
@@ -9,6 +9,14 @@
 #include "vine_task_node.h"
 #include "taskvine.h"
 
+/** Select the type of the node-output file. */
+typedef enum {
+	VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
+    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
+    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
+} vine_task_node_outfile_type_t;
+
+/** The task graph object. */
 struct vine_task_graph {
     struct vine_manager *manager;
 	struct hash_table *nodes;
@@ -24,23 +32,104 @@ struct vine_task_graph {
 
 
 /* Public APIs for operating the task graph */
-const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg);
-const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
-double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key);
-const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key);
-void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
-struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
-    const char *node_key,
-    const char *staging_dir,
-    int prune_depth);
+
+/** Create a task graph object and return it.
+@param q Reference to the current manager object.
+@return A new task graph object.
+*/
 struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
+
+/** Set the task priority mode for the task graph.
+@param tg Reference to the task graph object.
+@param priority_mode Reference to the priority mode.
+*/
+void vine_task_graph_set_task_priority_mode(struct vine_task_graph *tg, vine_task_priority_mode_t priority_mode);
+
+/** Set the failure injection step percent.
+@param tg Reference to the task graph object.
+@param percent Reference to the failure injection step percent.
+*/
 void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent);
+
+/** Create a new node in the task graph.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@param staging_dir Reference to the staging directory.
+@param prune_depth Reference to the prune depth.
+@return A new node object.
+*/
+struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
+	const char *node_key,
+	const char *staging_dir,
+	int prune_depth);
+
+/** Add a dependency between two nodes in the task graph.
+@param tg Reference to the task graph object.
+@param parent_key Reference to the parent node key.
+@param child_key Reference to the child node key.
+*/
 void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key);
+
+/** Finalize the metrics of the task graph.
+@param tg Reference to the task graph object.
+*/
+void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
+
+/** Get the heavy score of a node in the task graph.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@return The heavy score.
+*/
+double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key);
+
+/** Set the type of the node-output file.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@param outfile_type Reference to the output file type.
+@param outfile_remote_name Reference to the output file remote name.
+*/
 void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
+
+/** Execute the task graph.
+@param tg Reference to the task graph object.
+*/
 void vine_task_graph_execute(struct vine_task_graph *tg);
+
+/** Get the local outfile source of a node in the task graph.
+@param tg Reference to the task graph object.
+@param node_key Reference to the node key.
+@return The local outfile source.
+*/
+const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key);
+
+/** Delete a task graph object.
+@param tg Reference to the task graph object.
+*/
 void vine_task_graph_delete(struct vine_task_graph *tg);
-void vine_task_graph_set_proxy_library_and_function_names(struct vine_task_graph *tg,
-	const char *proxy_library_name,
-	const char *proxy_function_name);
+
+/** Get the library name of the task graph.
+@param tg Reference to the task graph object.
+@return The library name.
+*/
+const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg);
+
+/** Get the function name of the task graph.
+@param tg Reference to the task graph object.
+@return The function name.
+*/
+const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
+
+/** Set the proxy library name (Python-side), shared by all tasks.
+@param tg Reference to the task graph object.
+@param proxy_library_name Reference to the proxy library name.
+*/
+void vine_task_graph_set_proxy_library_name(struct vine_task_graph *tg, const char *proxy_library_name);
+
+/** Set the proxy function name (Python-side), shared by all tasks.
+@param tg Reference to the task graph object.
+@param proxy_function_name Reference to the proxy function name.
+*/
+void vine_task_graph_set_proxy_function_name(struct vine_task_graph *tg, const char *proxy_function_name);
+
 
 #endif // VINE_TASK_GRAPH_H
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.i b/taskvine/src/graph/dagvine/vine_task_graph.i
new file mode 100644
index 0000000000..b2a86b0c69
--- /dev/null
+++ b/taskvine/src/graph/dagvine/vine_task_graph.i
@@ -0,0 +1,18 @@
+/* SWIG interface for local dagvine graph bindings */
+%module cdagvine
+
+%{
+#include "int_sizes.h"
+#include "vine_task_graph.h"
+%}
+
+%include "stdint.i"
+%include "int_sizes.h"
+
+/* Import existing SWIG interface for type information (do not wrap again) */
+%import "../../bindings/python3/taskvine.i"
+
+/* Expose only the dagvine task graph APIs */
+%include "vine_task_graph.h"
+
+
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index af5f9faec5..380d584d60 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -15,7 +15,6 @@ See the file COPYING for details.
 struct vine_manager;
 struct vine_task;
 struct vine_file;
-struct vine_task_graph;
 
 /** @file taskvine.h The public API for the taskvine distributed application framework.
 A taskvine application consists of a manager process and a larger number of worker
@@ -157,13 +156,6 @@ typedef enum {
 	VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD      /* select a worker with the least incoming transfer load */
 } vine_replica_placement_policy_t;
 
-/** Select the type of the node-output file. */
-typedef enum {
-	VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
-    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
-    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
-} vine_task_node_outfile_type_t;
-
 /** Select priority algorithm for task graph task scheduling. */
 typedef enum {
     VINE_TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
@@ -1590,97 +1582,11 @@ char *vine_get_path_library_log(struct vine_manager *m, const char *path);
 */
 char *vine_get_path_cache(struct vine_manager *m, const char *path);
 
-/** Create a task graph object and return it.
-@param q Reference to the current manager object.
-@return A new task graph object.
-*/
-struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
-
-/** Delete a task graph object.
-@param tg Reference to the task graph object.
-*/
-void vine_task_graph_delete(struct vine_task_graph *tg);
-
-/** Add a dependency between two nodes in the task graph.
-@param tg Reference to the task graph object.
-@param parent_key Reference to the parent node key.
-@param child_key Reference to the child node key.
-*/
-void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key);
-
-/** Create a new node in the task graph.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@param staging_dir Reference to the staging directory.
-@param prune_depth Reference to the prune depth.
-@return A new node object.
-*/
-struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
-	const char *node_key,
-	const char *staging_dir,
-	int prune_depth);
-
 /** Set the replica placement policy (which worker do we prefer to place the redundant file replicas).
 @param q Reference to the current manager object.
 @param policy Reference to the replica placement policy.
 */
-void vine_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
-
-/** Set the task priority mode for the task graph.
-@param tg Reference to the task graph object.
-@param priority_mode Reference to the priority mode.
-*/
-void vine_task_graph_set_task_priority_mode(struct vine_task_graph *tg, vine_task_priority_mode_t priority_mode);
-
-/** Set the type of the node-output file.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@param outfile_type Reference to the output file type.
-@param outfile_remote_name Reference to the output file remote name.
-*/
-void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
-
-/** Finalize the metrics of the task graph.
-@param tg Reference to the task graph object.
-*/
-void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
-
-/** Get the library name of the task graph.
-@param tg Reference to the task graph object.
-@return The library name.
-*/
-const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg);
-
-/** Get the function name of the task graph.
-@param tg Reference to the task graph object.
-@return The function name.
-*/
-const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
-
-/** Get the heavy score of a node in the task graph.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@return The heavy score.
-*/
-double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key);
-
-/** Execute the task graph.
-@param tg Reference to the task graph object.
-*/
-void vine_task_graph_execute(struct vine_task_graph *tg);
-
-/** Get the local outfile source of a node in the task graph.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@return The local outfile source.
-*/
-const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key);
-
-/** Set the failure injection step percent.
-@param tg Reference to the task graph object.
-@param percent Reference to the failure injection step percent.
-*/
-void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent);
+void vine_temp_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
 
 //@}
 
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 9ecde5a14a..44841b4534 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -4375,7 +4375,7 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->when_last_offloaded = 0;
 	q->peak_used_cache = 0;
 	q->shutting_down = 0;
-	vine_set_replica_placement_policy(q, VINE_REPLICA_PLACEMENT_POLICY_RANDOM);
+	vine_temp_set_replica_placement_policy(q, VINE_REPLICA_PLACEMENT_POLICY_RANDOM);
 
 	if ((envstring = getenv("VINE_BANDWIDTH"))) {
 		q->bandwidth_limit = string_metric_parse(envstring);
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index f6663d0989..3d14dd0e91 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -225,7 +225,7 @@ int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
 	return 1;
 }
 
-void vine_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy)
+void vine_temp_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy)
 {
 	if (!q) {
 		return;

From 6bf5de352f5dcdbb0434f0433dc002615e05b0aa Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 16 Oct 2025 15:17:49 -0400
Subject: [PATCH 038/113] new

---
 .../python3/ndcctools/taskvine/utils.py       | 17 +++-
 taskvine/src/graph/dagvine/cdagvine.py        | 96 ++++++++++++++++++-
 taskvine/src/graph/dagvine/library.py         |  5 +-
 taskvine/src/graph/dagvine/vine_task_graph.h  | 15 ++-
 taskvine/src/graph/dagvine/vine_task_graph.i  |  2 +
 taskvine/src/graph/dagvine/vine_task_node.h   | 10 +-
 taskvine/src/manager/taskvine.h               | 23 ++---
 7 files changed, 139 insertions(+), 29 deletions(-)

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index 4ced92406a..aa2c588357 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -3,6 +3,11 @@
 # See the file COPYING for details.
 
 from . import cvine
+try:
+    # cdagvine contains DAG-specific enums (e.g., VINE_TASK_PRIORITY_MODE_*)
+    from .dagvine import cdagvine  # type: ignore
+except Exception:
+    cdagvine = None
 
 import os
 
@@ -12,7 +17,17 @@ def get_c_constant(constant):
         "result_success" -> VINE_RESULT_SUCCESS
     """
     constant = f"VINE_{constant.upper()}"
-    return getattr(cvine, constant)
+    # First try the base cvine module
+    value = getattr(cvine, constant, None)
+    if value is not None:
+        return value
+    # Fallback to cdagvine if available (for DAG-specific constants)
+    if cdagvine is not None:
+        value = getattr(cdagvine, constant, None)
+        if value is not None:
+            return value
+    # If still missing, raise a clear error
+    raise AttributeError(f"C constant {constant} not found in cvine or cdagvine")
 
 
 def set_port_range(port):
diff --git a/taskvine/src/graph/dagvine/cdagvine.py b/taskvine/src/graph/dagvine/cdagvine.py
index 920389fda9..5222c14fa6 100644
--- a/taskvine/src/graph/dagvine/cdagvine.py
+++ b/taskvine/src/graph/dagvine/cdagvine.py
@@ -59,6 +59,80 @@ class _SwigNonDynamicMeta(type):
 
 
 import ndcctools.taskvine.cvine
+VINE_NODE_OUTFILE_TYPE_LOCAL = _cdagvine.VINE_NODE_OUTFILE_TYPE_LOCAL
+VINE_NODE_OUTFILE_TYPE_TEMP = _cdagvine.VINE_NODE_OUTFILE_TYPE_TEMP
+VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM = _cdagvine.VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM
+PRUNE_STATUS_NOT_PRUNED = _cdagvine.PRUNE_STATUS_NOT_PRUNED
+PRUNE_STATUS_SAFE = _cdagvine.PRUNE_STATUS_SAFE
+PRUNE_STATUS_UNSAFE = _cdagvine.PRUNE_STATUS_UNSAFE
+class vine_task_node(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+    node_key = property(_cdagvine.vine_task_node_node_key_get, _cdagvine.vine_task_node_node_key_set)
+    manager = property(_cdagvine.vine_task_node_manager_get, _cdagvine.vine_task_node_manager_set)
+    task = property(_cdagvine.vine_task_node_task_get, _cdagvine.vine_task_node_task_set)
+    infile = property(_cdagvine.vine_task_node_infile_get, _cdagvine.vine_task_node_infile_set)
+    outfile = property(_cdagvine.vine_task_node_outfile_get, _cdagvine.vine_task_node_outfile_set)
+    outfile_remote_name = property(_cdagvine.vine_task_node_outfile_remote_name_get, _cdagvine.vine_task_node_outfile_remote_name_set)
+    staging_dir = property(_cdagvine.vine_task_node_staging_dir_get, _cdagvine.vine_task_node_staging_dir_set)
+    outfile_size_bytes = property(_cdagvine.vine_task_node_outfile_size_bytes_get, _cdagvine.vine_task_node_outfile_size_bytes_set)
+    parents = property(_cdagvine.vine_task_node_parents_get, _cdagvine.vine_task_node_parents_set)
+    children = property(_cdagvine.vine_task_node_children_get, _cdagvine.vine_task_node_children_set)
+    pending_parents = property(_cdagvine.vine_task_node_pending_parents_get, _cdagvine.vine_task_node_pending_parents_set)
+    retry_attempts_left = property(_cdagvine.vine_task_node_retry_attempts_left_get, _cdagvine.vine_task_node_retry_attempts_left_set)
+    completed = property(_cdagvine.vine_task_node_completed_get, _cdagvine.vine_task_node_completed_set)
+    prune_depth = property(_cdagvine.vine_task_node_prune_depth_get, _cdagvine.vine_task_node_prune_depth_set)
+    depth = property(_cdagvine.vine_task_node_depth_get, _cdagvine.vine_task_node_depth_set)
+    height = property(_cdagvine.vine_task_node_height_get, _cdagvine.vine_task_node_height_set)
+    upstream_subgraph_size = property(_cdagvine.vine_task_node_upstream_subgraph_size_get, _cdagvine.vine_task_node_upstream_subgraph_size_set)
+    downstream_subgraph_size = property(_cdagvine.vine_task_node_downstream_subgraph_size_get, _cdagvine.vine_task_node_downstream_subgraph_size_set)
+    fan_in = property(_cdagvine.vine_task_node_fan_in_get, _cdagvine.vine_task_node_fan_in_set)
+    fan_out = property(_cdagvine.vine_task_node_fan_out_get, _cdagvine.vine_task_node_fan_out_set)
+    heavy_score = property(_cdagvine.vine_task_node_heavy_score_get, _cdagvine.vine_task_node_heavy_score_set)
+    critical_time = property(_cdagvine.vine_task_node_critical_time_get, _cdagvine.vine_task_node_critical_time_set)
+    time_spent_on_unlink_local_files = property(_cdagvine.vine_task_node_time_spent_on_unlink_local_files_get, _cdagvine.vine_task_node_time_spent_on_unlink_local_files_set)
+    time_spent_on_prune_ancestors_of_temp_node = property(_cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_temp_node_get, _cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_temp_node_set)
+    time_spent_on_prune_ancestors_of_persisted_node = property(_cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_persisted_node_get, _cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_persisted_node_set)
+    outfile_type = property(_cdagvine.vine_task_node_outfile_type_get, _cdagvine.vine_task_node_outfile_type_set)
+    prune_status = property(_cdagvine.vine_task_node_prune_status_get, _cdagvine.vine_task_node_prune_status_set)
+
+    def __init__(self):
+        _cdagvine.vine_task_node_swiginit(self, _cdagvine.new_vine_task_node())
+    __swig_destroy__ = _cdagvine.delete_vine_task_node
+
+# Register vine_task_node in _cdagvine:
+_cdagvine.vine_task_node_swigregister(vine_task_node)
+
+def vine_task_node_create(manager, node_key, proxy_library_name, proxy_function_name, staging_dir, prune_depth):
+    return _cdagvine.vine_task_node_create(manager, node_key, proxy_library_name, proxy_function_name, staging_dir, prune_depth)
+
+def vine_task_node_delete(node):
+    return _cdagvine.vine_task_node_delete(node)
+
+def compute_lex_priority(key):
+    return _cdagvine.compute_lex_priority(key)
+
+def vine_task_node_prune_ancestors(node):
+    return _cdagvine.vine_task_node_prune_ancestors(node)
+
+def vine_task_node_print_info(node):
+    return _cdagvine.vine_task_node_print_info(node)
+
+def vine_task_node_update_critical_time(node, execution_time):
+    return _cdagvine.vine_task_node_update_critical_time(node, execution_time)
+
+def vine_task_node_replicate_outfile(node):
+    return _cdagvine.vine_task_node_replicate_outfile(node)
+
+def vine_task_node_set_outfile(node, outfile_type, outfile_remote_name):
+    return _cdagvine.vine_task_node_set_outfile(node, outfile_type, outfile_remote_name)
+VINE_TASK_PRIORITY_MODE_RANDOM = _cdagvine.VINE_TASK_PRIORITY_MODE_RANDOM
+VINE_TASK_PRIORITY_MODE_DEPTH_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_DEPTH_FIRST
+VINE_TASK_PRIORITY_MODE_BREADTH_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_BREADTH_FIRST
+VINE_TASK_PRIORITY_MODE_FIFO = _cdagvine.VINE_TASK_PRIORITY_MODE_FIFO
+VINE_TASK_PRIORITY_MODE_LIFO = _cdagvine.VINE_TASK_PRIORITY_MODE_LIFO
+VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST
+VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST
 class vine_task_graph(object):
     thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
     __repr__ = _swig_repr
@@ -102,6 +176,24 @@ def vine_task_graph_get_node_heavy_score(tg, node_key):
 def vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name):
     return _cdagvine.vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name)
 
-def vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name):
-    return _cdagvine.vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name)
+def vine_task_graph_execute(tg):
+    return _cdagvine.vine_task_graph_execute(tg)
+
+def vine_task_graph_get_node_local_outfile_source(tg, node_key):
+    return _cdagvine.vine_task_graph_get_node_local_outfile_source(tg, node_key)
+
+def vine_task_graph_delete(tg):
+    return _cdagvine.vine_task_graph_delete(tg)
+
+def vine_task_graph_get_proxy_library_name(tg):
+    return _cdagvine.vine_task_graph_get_proxy_library_name(tg)
+
+def vine_task_graph_get_proxy_function_name(tg):
+    return _cdagvine.vine_task_graph_get_proxy_function_name(tg)
+
+def vine_task_graph_set_proxy_library_name(tg, proxy_library_name):
+    return _cdagvine.vine_task_graph_set_proxy_library_name(tg, proxy_library_name)
+
+def vine_task_graph_set_proxy_function_name(tg, proxy_function_name):
+    return _cdagvine.vine_task_graph_set_proxy_function_name(tg, proxy_function_name)
 
diff --git a/taskvine/src/graph/dagvine/library.py b/taskvine/src/graph/dagvine/library.py
index f66badf033..7a441e5aba 100644
--- a/taskvine/src/graph/dagvine/library.py
+++ b/taskvine/src/graph/dagvine/library.py
@@ -1,5 +1,6 @@
 import os, uuid, cloudpickle, types, time, random, hashlib, collections
 from ndcctools.taskvine import cvine
+from ndcctools.taskvine.dagvine import cdagvine
 from ndcctools.taskvine.graph_definition import (
     GraphKeyResult, TaskGraph, compute_dts_key, compute_sexpr_key, 
     compute_single_key, hash_name, hashable, init_task_graph_context
@@ -29,7 +30,7 @@ def add_env_files(self, new_env_files):
     def install(self, manager, libcores, vine_graph):
         self.libcores = libcores
 
-        assert cvine.vine_task_graph_get_proxy_function_name(vine_graph) == compute_single_key.__name__
+        assert cdagvine.vine_task_graph_get_proxy_function_name(vine_graph) == compute_single_key.__name__
 
         self.local_path = f"library-task-graph-{uuid.uuid4()}.pkl"
         self.remote_path = self.local_path
@@ -38,7 +39,7 @@ def install(self, manager, libcores, vine_graph):
             os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
             load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
         ]
-        lib_name = cvine.vine_task_graph_get_proxy_library_name(vine_graph)
+        lib_name = cdagvine.vine_task_graph_get_proxy_library_name(vine_graph)
         self.libtask = manager.create_library_from_functions(
             lib_name,
             compute_single_key,
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.h b/taskvine/src/graph/dagvine/vine_task_graph.h
index 5fd81fdd6c..d0160d9051 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.h
+++ b/taskvine/src/graph/dagvine/vine_task_graph.h
@@ -9,12 +9,17 @@
 #include "vine_task_node.h"
 #include "taskvine.h"
 
-/** Select the type of the node-output file. */
+
+/** Select priority algorithm for task graph task scheduling. */
 typedef enum {
-	VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
-    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
-    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
-} vine_task_node_outfile_type_t;
+    VINE_TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
+    VINE_TASK_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
+    VINE_TASK_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
+    VINE_TASK_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
+    VINE_TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
+    VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
+    VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+} vine_task_priority_mode_t;
 
 /** The task graph object. */
 struct vine_task_graph {
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.i b/taskvine/src/graph/dagvine/vine_task_graph.i
index b2a86b0c69..adc36a9b93 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.i
+++ b/taskvine/src/graph/dagvine/vine_task_graph.i
@@ -4,6 +4,7 @@
 %{
 #include "int_sizes.h"
 #include "vine_task_graph.h"
+#include "vine_task_node.h"  /* expose outfile type enum to SWIG */
 %}
 
 %include "stdint.i"
@@ -13,6 +14,7 @@
 %import "../../bindings/python3/taskvine.i"
 
 /* Expose only the dagvine task graph APIs */
+%include "vine_task_node.h"    /* export vine_task_node_outfile_type_t values */
 %include "vine_task_graph.h"
 
 
diff --git a/taskvine/src/graph/dagvine/vine_task_node.h b/taskvine/src/graph/dagvine/vine_task_node.h
index 12fea69230..5b6b00272a 100644
--- a/taskvine/src/graph/dagvine/vine_task_node.h
+++ b/taskvine/src/graph/dagvine/vine_task_node.h
@@ -8,9 +8,16 @@
 #include "set.h"
 #include "taskvine.h"
 
+/** Select the type of the node-output file. */
+typedef enum {
+    VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
+    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
+    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
+} vine_task_node_outfile_type_t;
+
 typedef enum {
     PRUNE_STATUS_NOT_PRUNED = 0,
-    PRUNE_STATUS_SAFE,
+    PRUNE_STATUS_SAFE, 
     PRUNE_STATUS_UNSAFE
 } prune_status_t;
 
@@ -66,6 +73,5 @@ void vine_task_node_print_info(struct vine_task_node *node);
 void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time);
 void vine_task_node_replicate_outfile(struct vine_task_node *node);
 void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
-void vine_task_node_checkpoint_outfile(struct vine_task_node *node);
 
 #endif
\ No newline at end of file
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index 380d584d60..eb2ed880e0 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -156,17 +156,6 @@ typedef enum {
 	VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD      /* select a worker with the least incoming transfer load */
 } vine_replica_placement_policy_t;
 
-/** Select priority algorithm for task graph task scheduling. */
-typedef enum {
-    VINE_TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
-    VINE_TASK_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
-    VINE_TASK_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
-    VINE_TASK_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
-    VINE_TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
-    VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
-    VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
-} vine_task_priority_mode_t;
-
 /** Statistics describing a manager. */
 struct vine_stats {
 	/* Stats for the current state of workers: */
@@ -1143,6 +1132,12 @@ int vine_enable_return_recovery_tasks(struct vine_manager *m);
 Recovery tasks will be handled internally by the manager. **/
 int vine_disable_return_recovery_tasks(struct vine_manager *m);
 
+/** Set the replica placement policy (which worker do we prefer to place the redundant file replicas).
+@param q Reference to the current manager object.
+@param policy Reference to the replica placement policy.
+*/
+void vine_temp_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
+
 /** When enabled, resources to tasks in are assigned in proportion to the size
 of the worker. If a resource is specified (e.g. with @ref vine_task_set_cores),
 proportional resources never go below explicit specifications. This mode is most
@@ -1582,12 +1577,6 @@ char *vine_get_path_library_log(struct vine_manager *m, const char *path);
 */
 char *vine_get_path_cache(struct vine_manager *m, const char *path);
 
-/** Set the replica placement policy (which worker do we prefer to place the redundant file replicas).
-@param q Reference to the current manager object.
-@param policy Reference to the replica placement policy.
-*/
-void vine_temp_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
-
 //@}
 
 #endif

From 20328154c137f6b4ddc6c5bdc7840bcd5a5f4a27 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 16 Oct 2025 16:12:17 -0400
Subject: [PATCH 039/113] vine task graph tuning

---
 taskvine/src/bindings/python3/Makefile        |   2 +-
 .../python3/ndcctools/taskvine/utils.py       |   2 +-
 taskvine/src/graph/dagvine/.gitignore         |   3 +-
 taskvine/src/graph/dagvine/Makefile           |  41 ++--
 taskvine/src/graph/dagvine/cdagvine.py        | 199 ------------------
 taskvine/src/graph/dagvine/config.py          |  37 ----
 taskvine/src/graph/dagvine/cvine_dagvine.py   |   4 +-
 taskvine/src/graph/dagvine/graph_executor.py  |  38 ++--
 taskvine/src/graph/dagvine/params.py          |   8 +-
 taskvine/src/graph/dagvine/vine_task_graph.c  |  94 +++++----
 taskvine/src/graph/dagvine/vine_task_graph.h  |  37 ++--
 taskvine/src/graph/dagvine/vine_task_graph.i  |   1 +
 taskvine/src/manager/taskvine.h               |  13 --
 taskvine/src/manager/vine_manager.c           |   1 -
 taskvine/src/manager/vine_manager.h           |   1 -
 taskvine/src/manager/vine_temp.c              |  37 +---
 16 files changed, 116 insertions(+), 402 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/cdagvine.py

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index 8b9f1bf14e..24557af1b0 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -7,7 +7,7 @@ GRAPH_EXECUTOR_MODULE_NAME = dagvine
 CCTOOLS_DYNAMIC_SUFFIX = so
 # SWIG produces code that causes a lot of warnings, so use -w to turn those off.
 LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager -I ../../graph/${GRAPH_EXECUTOR_MODULE_NAME}
-LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/lib${GRAPH_EXECUTOR_MODULE_NAME}.a $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
+LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
 
 CCTOOLS_FLAKE8_IGNORE_FILES = "cvine.py"
 
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index aa2c588357..bd909b664b 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -4,7 +4,7 @@
 
 from . import cvine
 try:
-    # cdagvine contains DAG-specific enums (e.g., VINE_TASK_PRIORITY_MODE_*)
+    # cdagvine contains DAG-specific enums (e.g., VINE_TASK_GRAPH_PRIORITY_MODE_*)
     from .dagvine import cdagvine  # type: ignore
 except Exception:
     cdagvine = None
diff --git a/taskvine/src/graph/dagvine/.gitignore b/taskvine/src/graph/dagvine/.gitignore
index 3e98d74473..38280b8491 100644
--- a/taskvine/src/graph/dagvine/.gitignore
+++ b/taskvine/src/graph/dagvine/.gitignore
@@ -2,4 +2,5 @@
 *.so
 *.o
 *_wrap.c
-*_wrap.0
\ No newline at end of file
+*_wrap.0
+build/
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index ba1b84c43b..018a48a227 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -4,51 +4,62 @@ include ../../../../rules.mk
 LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
 LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 
+ 
+
 SOURCES = vine_task_node.c vine_task_graph.c
 OBJECTS = $(SOURCES:%.c=%.o)
 
 SWIG_I = vine_task_graph.i
-SWIG_WRAP = vine_task_graph_wrap.c
-PYMODULE = _cdagvine.$(CCTOOLS_DYNAMIC_SUFFIX)
 
-LIBRARIES = libdagvine.a
+# put SWIG generated sources and Python extension artifacts into build/ directory
+BUILD_DIR := build
+SWIG_WRAP = $(BUILD_DIR)/vine_task_graph_wrap.c
+WRAP_OBJ = $(BUILD_DIR)/vine_task_graph_wrap.o
+PYMODULE = $(BUILD_DIR)/_cdagvine.$(CCTOOLS_DYNAMIC_SUFFIX)
+
+LIBRARIES =
+PYDEPS = $(WRAP_OBJ) $(OBJECTS)
+PYLINK_INPUT = $(WRAP_OBJ) $(OBJECTS)
 PROGRAMS =
 SCRIPTS =
 TARGETS = $(LIBRARIES) $(PYMODULE) $(PROGRAMS)
 
 all: $(TARGETS)
 
-libdagvine.a: $(OBJECTS)
+ 
 
 $(PROGRAMS): $(EXTERNALS)
 
-$(SWIG_WRAP): $(SWIG_I) vine_task_graph.h
-	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -o $@ $<
+$(BUILD_DIR):
+	mkdir -p $(BUILD_DIR)
+
+$(SWIG_WRAP): $(SWIG_I) vine_task_graph.h | $(BUILD_DIR)
+	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -outdir $(BUILD_DIR) -o $@ $<
 
 # Build Python module
-vine_task_graph_wrap.o: $(SWIG_WRAP)
-	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) $(LOCAL_CCFLAGS) $<
+$(WRAP_OBJ): $(SWIG_WRAP)
+	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) $(LOCAL_CCFLAGS) -Wno-error=cast-function-type $<
 
-$(PYMODULE): vine_task_graph_wrap.o libdagvine.a
+$(PYMODULE): $(PYDEPS)
 ifeq ($(CCTOOLS_STATIC),1)
-	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $^ $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
+	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $(PYLINK_INPUT) $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
 else
-	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $^ $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
+	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $(PYLINK_INPUT) $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
 endif
 
 
 
 install: all
-	mkdir -p $(CCTOOLS_INSTALL_DIR)/lib
-	cp $(LIBRARIES) $(CCTOOLS_INSTALL_DIR)/lib/
 	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include
 	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include/
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
 	cp $(PYMODULE) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
-	cp cdagvine.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
+	cp $(BUILD_DIR)/cdagvine.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
+	# remove build artifacts after installation
+	rm -rf $(BUILD_DIR)
 
 clean:
-	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(SWIG_WRAP) vine_task_graph_wrap.o $(PYMODULE) cdagvine.py
+	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(BUILD_DIR) $(PYMODULE) cdagvine.py
 
 test: all
 
diff --git a/taskvine/src/graph/dagvine/cdagvine.py b/taskvine/src/graph/dagvine/cdagvine.py
deleted file mode 100644
index 5222c14fa6..0000000000
--- a/taskvine/src/graph/dagvine/cdagvine.py
+++ /dev/null
@@ -1,199 +0,0 @@
-# This file was automatically generated by SWIG (https://www.swig.org).
-# Version 4.3.1
-#
-# Do not make changes to this file unless you know what you are doing - modify
-# the SWIG interface file instead.
-
-from sys import version_info as _swig_python_version_info
-# Import the low-level C/C++ module
-if __package__ or "." in __name__:
-    from . import _cdagvine
-else:
-    import _cdagvine
-
-try:
-    import builtins as __builtin__
-except ImportError:
-    import __builtin__
-
-def _swig_repr(self):
-    try:
-        strthis = "proxy of " + self.this.__repr__()
-    except __builtin__.Exception:
-        strthis = ""
-    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
-
-
-def _swig_setattr_nondynamic_instance_variable(set):
-    def set_instance_attr(self, name, value):
-        if name == "this":
-            set(self, name, value)
-        elif name == "thisown":
-            self.this.own(value)
-        elif hasattr(self, name) and isinstance(getattr(type(self), name), property):
-            set(self, name, value)
-        else:
-            raise AttributeError("You cannot add instance attributes to %s" % self)
-    return set_instance_attr
-
-
-def _swig_setattr_nondynamic_class_variable(set):
-    def set_class_attr(cls, name, value):
-        if hasattr(cls, name) and not isinstance(getattr(cls, name), property):
-            set(cls, name, value)
-        else:
-            raise AttributeError("You cannot add class attributes to %s" % cls)
-    return set_class_attr
-
-
-def _swig_add_metaclass(metaclass):
-    """Class decorator for adding a metaclass to a SWIG wrapped class - a slimmed down version of six.add_metaclass"""
-    def wrapper(cls):
-        return metaclass(cls.__name__, cls.__bases__, cls.__dict__.copy())
-    return wrapper
-
-
-class _SwigNonDynamicMeta(type):
-    """Meta class to enforce nondynamic attributes (no new attributes) for a class"""
-    __setattr__ = _swig_setattr_nondynamic_class_variable(type.__setattr__)
-
-
-import ndcctools.taskvine.cvine
-VINE_NODE_OUTFILE_TYPE_LOCAL = _cdagvine.VINE_NODE_OUTFILE_TYPE_LOCAL
-VINE_NODE_OUTFILE_TYPE_TEMP = _cdagvine.VINE_NODE_OUTFILE_TYPE_TEMP
-VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM = _cdagvine.VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM
-PRUNE_STATUS_NOT_PRUNED = _cdagvine.PRUNE_STATUS_NOT_PRUNED
-PRUNE_STATUS_SAFE = _cdagvine.PRUNE_STATUS_SAFE
-PRUNE_STATUS_UNSAFE = _cdagvine.PRUNE_STATUS_UNSAFE
-class vine_task_node(object):
-    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
-    __repr__ = _swig_repr
-    node_key = property(_cdagvine.vine_task_node_node_key_get, _cdagvine.vine_task_node_node_key_set)
-    manager = property(_cdagvine.vine_task_node_manager_get, _cdagvine.vine_task_node_manager_set)
-    task = property(_cdagvine.vine_task_node_task_get, _cdagvine.vine_task_node_task_set)
-    infile = property(_cdagvine.vine_task_node_infile_get, _cdagvine.vine_task_node_infile_set)
-    outfile = property(_cdagvine.vine_task_node_outfile_get, _cdagvine.vine_task_node_outfile_set)
-    outfile_remote_name = property(_cdagvine.vine_task_node_outfile_remote_name_get, _cdagvine.vine_task_node_outfile_remote_name_set)
-    staging_dir = property(_cdagvine.vine_task_node_staging_dir_get, _cdagvine.vine_task_node_staging_dir_set)
-    outfile_size_bytes = property(_cdagvine.vine_task_node_outfile_size_bytes_get, _cdagvine.vine_task_node_outfile_size_bytes_set)
-    parents = property(_cdagvine.vine_task_node_parents_get, _cdagvine.vine_task_node_parents_set)
-    children = property(_cdagvine.vine_task_node_children_get, _cdagvine.vine_task_node_children_set)
-    pending_parents = property(_cdagvine.vine_task_node_pending_parents_get, _cdagvine.vine_task_node_pending_parents_set)
-    retry_attempts_left = property(_cdagvine.vine_task_node_retry_attempts_left_get, _cdagvine.vine_task_node_retry_attempts_left_set)
-    completed = property(_cdagvine.vine_task_node_completed_get, _cdagvine.vine_task_node_completed_set)
-    prune_depth = property(_cdagvine.vine_task_node_prune_depth_get, _cdagvine.vine_task_node_prune_depth_set)
-    depth = property(_cdagvine.vine_task_node_depth_get, _cdagvine.vine_task_node_depth_set)
-    height = property(_cdagvine.vine_task_node_height_get, _cdagvine.vine_task_node_height_set)
-    upstream_subgraph_size = property(_cdagvine.vine_task_node_upstream_subgraph_size_get, _cdagvine.vine_task_node_upstream_subgraph_size_set)
-    downstream_subgraph_size = property(_cdagvine.vine_task_node_downstream_subgraph_size_get, _cdagvine.vine_task_node_downstream_subgraph_size_set)
-    fan_in = property(_cdagvine.vine_task_node_fan_in_get, _cdagvine.vine_task_node_fan_in_set)
-    fan_out = property(_cdagvine.vine_task_node_fan_out_get, _cdagvine.vine_task_node_fan_out_set)
-    heavy_score = property(_cdagvine.vine_task_node_heavy_score_get, _cdagvine.vine_task_node_heavy_score_set)
-    critical_time = property(_cdagvine.vine_task_node_critical_time_get, _cdagvine.vine_task_node_critical_time_set)
-    time_spent_on_unlink_local_files = property(_cdagvine.vine_task_node_time_spent_on_unlink_local_files_get, _cdagvine.vine_task_node_time_spent_on_unlink_local_files_set)
-    time_spent_on_prune_ancestors_of_temp_node = property(_cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_temp_node_get, _cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_temp_node_set)
-    time_spent_on_prune_ancestors_of_persisted_node = property(_cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_persisted_node_get, _cdagvine.vine_task_node_time_spent_on_prune_ancestors_of_persisted_node_set)
-    outfile_type = property(_cdagvine.vine_task_node_outfile_type_get, _cdagvine.vine_task_node_outfile_type_set)
-    prune_status = property(_cdagvine.vine_task_node_prune_status_get, _cdagvine.vine_task_node_prune_status_set)
-
-    def __init__(self):
-        _cdagvine.vine_task_node_swiginit(self, _cdagvine.new_vine_task_node())
-    __swig_destroy__ = _cdagvine.delete_vine_task_node
-
-# Register vine_task_node in _cdagvine:
-_cdagvine.vine_task_node_swigregister(vine_task_node)
-
-def vine_task_node_create(manager, node_key, proxy_library_name, proxy_function_name, staging_dir, prune_depth):
-    return _cdagvine.vine_task_node_create(manager, node_key, proxy_library_name, proxy_function_name, staging_dir, prune_depth)
-
-def vine_task_node_delete(node):
-    return _cdagvine.vine_task_node_delete(node)
-
-def compute_lex_priority(key):
-    return _cdagvine.compute_lex_priority(key)
-
-def vine_task_node_prune_ancestors(node):
-    return _cdagvine.vine_task_node_prune_ancestors(node)
-
-def vine_task_node_print_info(node):
-    return _cdagvine.vine_task_node_print_info(node)
-
-def vine_task_node_update_critical_time(node, execution_time):
-    return _cdagvine.vine_task_node_update_critical_time(node, execution_time)
-
-def vine_task_node_replicate_outfile(node):
-    return _cdagvine.vine_task_node_replicate_outfile(node)
-
-def vine_task_node_set_outfile(node, outfile_type, outfile_remote_name):
-    return _cdagvine.vine_task_node_set_outfile(node, outfile_type, outfile_remote_name)
-VINE_TASK_PRIORITY_MODE_RANDOM = _cdagvine.VINE_TASK_PRIORITY_MODE_RANDOM
-VINE_TASK_PRIORITY_MODE_DEPTH_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_DEPTH_FIRST
-VINE_TASK_PRIORITY_MODE_BREADTH_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_BREADTH_FIRST
-VINE_TASK_PRIORITY_MODE_FIFO = _cdagvine.VINE_TASK_PRIORITY_MODE_FIFO
-VINE_TASK_PRIORITY_MODE_LIFO = _cdagvine.VINE_TASK_PRIORITY_MODE_LIFO
-VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST
-VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST = _cdagvine.VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST
-class vine_task_graph(object):
-    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
-    __repr__ = _swig_repr
-    manager = property(_cdagvine.vine_task_graph_manager_get, _cdagvine.vine_task_graph_manager_set)
-    nodes = property(_cdagvine.vine_task_graph_nodes_get, _cdagvine.vine_task_graph_nodes_set)
-    task_id_to_node = property(_cdagvine.vine_task_graph_task_id_to_node_get, _cdagvine.vine_task_graph_task_id_to_node_set)
-    outfile_cachename_to_node = property(_cdagvine.vine_task_graph_outfile_cachename_to_node_get, _cdagvine.vine_task_graph_outfile_cachename_to_node_set)
-    proxy_library_name = property(_cdagvine.vine_task_graph_proxy_library_name_get, _cdagvine.vine_task_graph_proxy_library_name_set)
-    proxy_function_name = property(_cdagvine.vine_task_graph_proxy_function_name_get, _cdagvine.vine_task_graph_proxy_function_name_set)
-    task_priority_mode = property(_cdagvine.vine_task_graph_task_priority_mode_get, _cdagvine.vine_task_graph_task_priority_mode_set)
-    failure_injection_step_percent = property(_cdagvine.vine_task_graph_failure_injection_step_percent_get, _cdagvine.vine_task_graph_failure_injection_step_percent_set)
-
-    def __init__(self):
-        _cdagvine.vine_task_graph_swiginit(self, _cdagvine.new_vine_task_graph())
-    __swig_destroy__ = _cdagvine.delete_vine_task_graph
-
-# Register vine_task_graph in _cdagvine:
-_cdagvine.vine_task_graph_swigregister(vine_task_graph)
-
-def vine_task_graph_create(q):
-    return _cdagvine.vine_task_graph_create(q)
-
-def vine_task_graph_set_task_priority_mode(tg, priority_mode):
-    return _cdagvine.vine_task_graph_set_task_priority_mode(tg, priority_mode)
-
-def vine_task_graph_set_failure_injection_step_percent(tg, percent):
-    return _cdagvine.vine_task_graph_set_failure_injection_step_percent(tg, percent)
-
-def vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth):
-    return _cdagvine.vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth)
-
-def vine_task_graph_add_dependency(tg, parent_key, child_key):
-    return _cdagvine.vine_task_graph_add_dependency(tg, parent_key, child_key)
-
-def vine_task_graph_compute_topology_metrics(tg):
-    return _cdagvine.vine_task_graph_compute_topology_metrics(tg)
-
-def vine_task_graph_get_node_heavy_score(tg, node_key):
-    return _cdagvine.vine_task_graph_get_node_heavy_score(tg, node_key)
-
-def vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name):
-    return _cdagvine.vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name)
-
-def vine_task_graph_execute(tg):
-    return _cdagvine.vine_task_graph_execute(tg)
-
-def vine_task_graph_get_node_local_outfile_source(tg, node_key):
-    return _cdagvine.vine_task_graph_get_node_local_outfile_source(tg, node_key)
-
-def vine_task_graph_delete(tg):
-    return _cdagvine.vine_task_graph_delete(tg)
-
-def vine_task_graph_get_proxy_library_name(tg):
-    return _cdagvine.vine_task_graph_get_proxy_library_name(tg)
-
-def vine_task_graph_get_proxy_function_name(tg):
-    return _cdagvine.vine_task_graph_get_proxy_function_name(tg)
-
-def vine_task_graph_set_proxy_library_name(tg, proxy_library_name):
-    return _cdagvine.vine_task_graph_set_proxy_library_name(tg, proxy_library_name)
-
-def vine_task_graph_set_proxy_function_name(tg, proxy_function_name):
-    return _cdagvine.vine_task_graph_set_proxy_function_name(tg, proxy_function_name)
-
diff --git a/taskvine/src/graph/dagvine/config.py b/taskvine/src/graph/dagvine/config.py
index e3b8a41fec..e69de29bb2 100644
--- a/taskvine/src/graph/dagvine/config.py
+++ b/taskvine/src/graph/dagvine/config.py
@@ -1,37 +0,0 @@
-# config.py
-# Copyright (C) 2025 The University of Notre Dame
-# This software is distributed under the GNU General Public License.
-# See the file COPYING for details.
-
-from dataclasses import dataclass, field
-
-
-@dataclass(frozen=True)
-class DefaultTuneParams:
-    worker_source_max_transfers: int = 100
-    max_retrievals: int = -1
-    prefer_dispatch: int = 1
-    transient_error_interval: int = 1
-    attempt_schedule_depth: int = 1000
-
-
-@dataclass(frozen=True)
-class DefaultPaths:
-    shared_file_system_dir: str = "/project01/ndcms/jzhou24/shared_file_system"
-    staging_dir: str = "/project01/ndcms/jzhou24/staging"
-
-
-@dataclass(frozen=True)
-class DefaultPolicies:
-    replica_placement_policy: str = "random"
-    priority_mode: str = "largest-input-first"
-    scheduling_mode: str = "files"
-    prune_depth: int = 1
-
-
-@dataclass(frozen=True)
-class DefaultOutfileType:
-    outfile_type: dict = field(default_factory=lambda: {
-        "temp": 1.0,
-        "shared-file-system": 0.0,
-    })
diff --git a/taskvine/src/graph/dagvine/cvine_dagvine.py b/taskvine/src/graph/dagvine/cvine_dagvine.py
index c705763a26..df154836f1 100644
--- a/taskvine/src/graph/dagvine/cvine_dagvine.py
+++ b/taskvine/src/graph/dagvine/cvine_dagvine.py
@@ -81,8 +81,8 @@ def __init__(self):
 def vine_task_graph_create(q):
     return _cvine_dagvine.vine_task_graph_create(q)
 
-def vine_task_graph_set_task_priority_mode(tg, priority_mode):
-    return _cvine_dagvine.vine_task_graph_set_task_priority_mode(tg, priority_mode)
+def vine_task_graph_set_priority_mode(tg, priority_mode):
+    return _cvine_dagvine.vine_task_graph_set_priority_mode(tg, priority_mode)
 
 def vine_task_graph_set_failure_injection_step_percent(tg, percent):
     return _cvine_dagvine.vine_task_graph_set_failure_injection_step_percent(tg, percent)
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index c0ae5757a6..34e1c0a64a 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -75,39 +75,30 @@ def __init__(self,
                  vine_constant_params=VineConstantParams(),
                  **kwargs):
 
-        # Use C-side SIGINT handler in cdagvine to handle Ctrl+C gracefully
+        # handle SIGINT correctly
+        signal.signal(signal.SIGINT, self._on_sigint)
 
         self.manager_tuning_params = manager_tuning_params
         self.vine_constant_params = vine_constant_params
         self.regular_params = regular_params
 
         # delete all files in the run info directory, do this before super().__init__()
-        run_info_path = self.regular_params.run_info_path
-        run_info_template = self.regular_params.run_info_template
-        self.run_info_path_absolute = os.path.join(run_info_path, run_info_template)
-        if run_info_path and run_info_template:
-            delete_all_files(self.run_info_path_absolute)
-
-        kwargs["run_info_path"] = run_info_path
-        kwargs["run_info_template"] = run_info_template
-        super().__init__(*args, **kwargs)
-        print(f"TaskVine Manager \033[92m{self.name}\033[0m listening on port \033[92m{self.port}\033[0m")
+        run_info_path = kwargs.get("run_info_path", None)
+        run_info_template = kwargs.get("run_info_template", None)
+        self.run_info_template_path = os.path.join(run_info_path, run_info_template)
+        if self.run_info_template_path:
+            delete_all_files(self.run_info_template_path)
 
-        # initialize the task graph
-        self._vine_task_graph = cdagvine.vine_task_graph_create(self._taskvine)
+        # initialize the manager
+        super().__init__(*args, **kwargs)
 
     def tune_manager(self):
         for k, v in self.manager_tuning_params.to_dict().items():
             print(f"Tuning {k} to {v}")
             self.tune(k, v)
 
-    def set_policy(self):
-        # set replica placement policy
-        cvine.vine_temp_set_replica_placement_policy(self._taskvine, self.vine_constant_params.get_c_constant_of("replica_placement_policy"))
         # set worker scheduling algorithm
         cvine.vine_set_scheduler(self._taskvine, self.vine_constant_params.get_c_constant_of("schedule"))
-        # set task priority mode
-        cdagvine.vine_task_graph_set_task_priority_mode(self._vine_task_graph, self.vine_constant_params.get_c_constant_of("task_priority_mode"))
 
     def run(self,
             collection_dict,
@@ -115,10 +106,13 @@ def run(self,
             library=None,
             ):
 
+        # initialize the task graph (note: the lifetime of this object is limited to this function)
+        self._vine_task_graph = cdagvine.vine_task_graph_create(self._taskvine)
+        cdagvine.vine_task_graph_tune(self._vine_task_graph, "failure-injection-step-percent", str(self.regular_params.failure_injection_step_percent))
+        cdagvine.vine_task_graph_tune(self._vine_task_graph, "task-priority-mode", self.vine_constant_params.task_priority_mode)
+
         # tune the manager every time we start a new run as the parameters may have changed
         self.tune_manager()
-        # set the policy every time we start a new run as the parameters may have changed
-        self.set_policy()
 
         self.target_keys = target_keys
         self.task_dict = ensure_task_dict(collection_dict)
@@ -127,8 +121,6 @@ def run(self,
         self.library = library
         self.library.install(self, self.regular_params.libcores, self._vine_task_graph)
 
-        cdagvine.vine_task_graph_set_failure_injection_step_percent(self._vine_task_graph, self.regular_params.failure_injection_step_percent)
-
         # create task graph in the python side
         print("Initializing TaskGraph object")
         self.task_graph = TaskGraph(self.task_dict,
@@ -182,7 +174,7 @@ def run(self,
             cloudpickle.dump(self.task_graph, f)
 
         # now execute the vine graph
-        print(f"\033[92mExecuting task graph, logs will be written into {self.run_info_path_absolute}\033[0m")
+        print(f"\033[92mExecuting task graph, logs will be written into {self.run_info_template_path}\033[0m")
         cdagvine.vine_task_graph_execute(self._vine_task_graph)
 
         # after execution, we need to load results of target keys
diff --git a/taskvine/src/graph/dagvine/params.py b/taskvine/src/graph/dagvine/params.py
index 1f4a363760..41a81e23fc 100644
--- a/taskvine/src/graph/dagvine/params.py
+++ b/taskvine/src/graph/dagvine/params.py
@@ -42,14 +42,12 @@ class VineConstantParams:
     If there is a need to use these values in the C code, convert them to uppercase and call the get_c_constant_of method to get the C constant.
     """
 
-    replica_placement_policy: str = "random"
     schedule: str = "worst"
-    task_priority_mode: str = "largest_input_first"
+    task_priority_mode: str = "largest-input-first"
 
     valid_normalized_values = {
-        "replica_placement_policy": {"random", "disk_load", "transfer_load"},
         "schedule": {"files", "time", "rand", "worst", "disk"},
-        "task_priority_mode": {"random", "depth_first", "breadth_first", "fifo", "lifo", "largest_input_first", "largest_storage_footprint_first"},
+        "task_priority_mode": {"random", "depth-first", "breadth-first", "fifo", "lifo", "largest-input-first", "largest-storage-footprint-first"},
     }
 
     def normalize(self, obj):
@@ -83,8 +81,6 @@ def get_c_constant_of(self, key):
 @dataclass
 class RegularParams:
     """Regular parameters that will be used directly by the graph executor."""
-    run_info_path: str = None
-    run_info_template: str = None
     libcores: int = 16
     failure_injection_step_percent: int = -1
     prune_depth: int = 1
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.c b/taskvine/src/graph/dagvine/vine_task_graph.c
index 829a3fb4e9..2cb1574a73 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.c
+++ b/taskvine/src/graph/dagvine/vine_task_graph.c
@@ -51,7 +51,7 @@ static void handle_sigint(int signal)
  * @param priority_mode Reference to the priority mode.
  * @return The priority.
  */
-static double vine_task_node_calculate_priority(struct vine_task_node *node, vine_task_priority_mode_t priority_mode)
+static double vine_task_node_calculate_priority(struct vine_task_node *node, vine_task_graph_priority_mode_t priority_mode)
 {
 	if (!node) {
 		return 0;
@@ -63,22 +63,22 @@ static double vine_task_node_calculate_priority(struct vine_task_node *node, vin
 	struct vine_task_node *parent_node;
 
 	switch (priority_mode) {
-	case VINE_TASK_PRIORITY_MODE_RANDOM:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_RANDOM:
 		priority = random_double();
 		break;
-	case VINE_TASK_PRIORITY_MODE_DEPTH_FIRST:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_DEPTH_FIRST:
 		priority = (double)node->depth;
 		break;
-	case VINE_TASK_PRIORITY_MODE_BREADTH_FIRST:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_BREADTH_FIRST:
 		priority = -(double)node->depth;
 		break;
-	case VINE_TASK_PRIORITY_MODE_FIFO:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_FIFO:
 		priority = -(double)current_time;
 		break;
-	case VINE_TASK_PRIORITY_MODE_LIFO:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_LIFO:
 		priority = (double)current_time;
 		break;
-	case VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST:
 		LIST_ITERATE(node->parents, parent_node)
 		{
 			if (!parent_node->outfile) {
@@ -87,7 +87,7 @@ static double vine_task_node_calculate_priority(struct vine_task_node *node, vin
 			priority += (double)vine_file_size(parent_node->outfile);
 		}
 		break;
-	case VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
+	case VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
 		LIST_ITERATE(node->parents, parent_node)
 		{
 			if (!parent_node->outfile) {
@@ -348,6 +348,46 @@ static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struc
 /* Public APIs */
 /*************************************************************/
 
+/** Tune the task graph.
+ *@param tg Reference to the task graph object.
+ *@param name Reference to the name of the parameter to tune.
+ *@param value Reference to the value of the parameter to tune.
+ *@return 0 on success, -1 on failure.
+ */
+int vine_task_graph_tune(struct vine_task_graph *tg, const char *name, const char *value)
+{
+	if (!tg || !name || !value) {
+		return -1;
+	}
+
+	if (strcmp(name, "failure-injection-step-percent") == 0) {
+		tg->failure_injection_step_percent = atof(value);
+
+	} else if (strcmp(name, "task-priority-mode") == 0) {
+		if (strcmp(value, "random") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_RANDOM;
+		} else if (strcmp(value, "depth-first") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_DEPTH_FIRST;
+		} else if (strcmp(value, "breadth-first") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_BREADTH_FIRST;
+		} else if (strcmp(value, "fifo") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_FIFO;
+		} else if (strcmp(value, "lifo") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LIFO;
+		} else if (strcmp(value, "largest-input-first") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST;
+		} else if (strcmp(value, "largest-storage-footprint-first") == 0) {
+			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST;
+		} else {
+			debug(D_ERROR, "invalid priority mode: %s", value);
+			return -1;
+		}		
+
+	}
+
+	return 0;
+}
+
 /**
  * Set the proxy library name (Python-side), shared by all tasks.
  * @param tg Reference to the task graph object.
@@ -626,7 +666,7 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	tg->proxy_function_name = xxstrdup("compute_single_key");       // Python-side proxy function name (shared by all tasks)
 	tg->manager = q;
 
-	tg->task_priority_mode = VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
+	tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST;
 	tg->failure_injection_step_percent = -1.0;
 
 	/* enable debug system for C code since it uses a separate debug system instance
@@ -638,42 +678,6 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 	return tg;
 }
 
-/**
- * Set the failure injection step percent, meaning we will evict a randome worker at every X% of the DAG completion.
- * @param tg Reference to the task graph object.
- * @param percent Reference to the failure injection step percent.
- */
-void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent)
-{
-	if (!tg) {
-		return;
-	}
-
-	if (percent <= 0 || percent > 100) {
-		return;
-	}
-
-	debug(D_VINE, "setting failure injection step percent to %lf", percent);
-	tg->failure_injection_step_percent = percent;
-
-	return;
-}
-
-/**
- * Set the task priority mode for the task graph.
- * @param tg Reference to the task graph object.
- * @param priority_mode Reference to the priority mode.
- */
-void vine_task_graph_set_task_priority_mode(struct vine_task_graph *tg, vine_task_priority_mode_t priority_mode)
-{
-	if (!tg) {
-		return;
-	}
-
-	tg->task_priority_mode = priority_mode;
-	return;
-}
-
 /**
  * Add a dependency between two nodes in the task graph. Note that the input-output file relationship
  * is not handled here, because their file names may have not been determined yet.
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.h b/taskvine/src/graph/dagvine/vine_task_graph.h
index d0160d9051..6f4b39b398 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.h
+++ b/taskvine/src/graph/dagvine/vine_task_graph.h
@@ -12,14 +12,14 @@
 
 /** Select priority algorithm for task graph task scheduling. */
 typedef enum {
-    VINE_TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
-    VINE_TASK_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
-    VINE_TASK_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
-    VINE_TASK_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
-    VINE_TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
-    VINE_TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
-    VINE_TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
-} vine_task_priority_mode_t;
+    VINE_TASK_GRAPH_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
+    VINE_TASK_GRAPH_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
+    VINE_TASK_GRAPH_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
+    VINE_TASK_GRAPH_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
+    VINE_TASK_GRAPH_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
+    VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
+    VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+} vine_task_graph_priority_mode_t;
 
 /** The task graph object. */
 struct vine_task_graph {
@@ -31,7 +31,7 @@ struct vine_task_graph {
     char *proxy_library_name;
     char *proxy_function_name;
 
-    vine_task_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
+    vine_task_graph_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
     double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
 };
 
@@ -44,18 +44,6 @@ struct vine_task_graph {
 */
 struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
 
-/** Set the task priority mode for the task graph.
-@param tg Reference to the task graph object.
-@param priority_mode Reference to the priority mode.
-*/
-void vine_task_graph_set_task_priority_mode(struct vine_task_graph *tg, vine_task_priority_mode_t priority_mode);
-
-/** Set the failure injection step percent.
-@param tg Reference to the task graph object.
-@param percent Reference to the failure injection step percent.
-*/
-void vine_task_graph_set_failure_injection_step_percent(struct vine_task_graph *tg, double percent);
-
 /** Create a new node in the task graph.
 @param tg Reference to the task graph object.
 @param node_key Reference to the node key.
@@ -136,5 +124,12 @@ void vine_task_graph_set_proxy_library_name(struct vine_task_graph *tg, const ch
 */
 void vine_task_graph_set_proxy_function_name(struct vine_task_graph *tg, const char *proxy_function_name);
 
+/** Tune the task graph.
+@param tg Reference to the task graph object.
+@param name Reference to the name of the parameter to tune.
+@param value Reference to the value of the parameter to tune.
+@return 0 on success, -1 on failure.
+*/
+int vine_task_graph_tune(struct vine_task_graph *tg, const char *name, const char *value);
 
 #endif // VINE_TASK_GRAPH_H
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.i b/taskvine/src/graph/dagvine/vine_task_graph.i
index adc36a9b93..4f1f2d95fd 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.i
+++ b/taskvine/src/graph/dagvine/vine_task_graph.i
@@ -14,6 +14,7 @@
 %import "../../bindings/python3/taskvine.i"
 
 /* Expose only the dagvine task graph APIs */
+%ignore vine_task_node_checkpoint_outfile;  /* avoid exporting unimplemented/optional symbol */
 %include "vine_task_node.h"    /* export vine_task_node_outfile_type_t values */
 %include "vine_task_graph.h"
 
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index eb2ed880e0..eda05ebc4d 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -149,13 +149,6 @@ typedef enum {
 	VINE_MINI_TASK,             /**< A file obtained by executing a Unix command line. */
 } vine_file_type_t;
 
-/* Select while type of workers to place the redundant file replicas */
-typedef enum {
-	VINE_REPLICA_PLACEMENT_POLICY_RANDOM = 0,        /* select a random worker */
-	VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD,         /* select a worker with the most free disk space */
-	VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD      /* select a worker with the least incoming transfer load */
-} vine_replica_placement_policy_t;
-
 /** Statistics describing a manager. */
 struct vine_stats {
 	/* Stats for the current state of workers: */
@@ -1132,12 +1125,6 @@ int vine_enable_return_recovery_tasks(struct vine_manager *m);
 Recovery tasks will be handled internally by the manager. **/
 int vine_disable_return_recovery_tasks(struct vine_manager *m);
 
-/** Set the replica placement policy (which worker do we prefer to place the redundant file replicas).
-@param q Reference to the current manager object.
-@param policy Reference to the replica placement policy.
-*/
-void vine_temp_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy);
-
 /** When enabled, resources to tasks in are assigned in proportion to the size
 of the worker. If a resource is specified (e.g. with @ref vine_task_set_cores),
 proportional resources never go below explicit specifications. This mode is most
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 44841b4534..9953df9450 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -4375,7 +4375,6 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->when_last_offloaded = 0;
 	q->peak_used_cache = 0;
 	q->shutting_down = 0;
-	vine_temp_set_replica_placement_policy(q, VINE_REPLICA_PLACEMENT_POLICY_RANDOM);
 
 	if ((envstring = getenv("VINE_BANDWIDTH"))) {
 		q->bandwidth_limit = string_metric_parse(envstring);
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index 8b4fb9826a..92482dc08c 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -234,7 +234,6 @@ struct vine_manager {
 
 	int return_recovery_tasks; /* If true, recovery tasks are returned by vine_wait to the user. By default they are handled internally. */
 	int num_submitted_recovery_tasks;
-	vine_replica_placement_policy_t replica_placement_policy; /* Mode for selecting best worker for placing a new replica of a temp file */
 	int balance_worker_disk_load; /* If true, offload replicas from workers that are overloaded with temp files. */
 	timestamp_t when_last_offloaded;
 	int64_t peak_used_cache;
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index 3d14dd0e91..2f171f5efe 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -87,19 +87,8 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 		if ((int64_t)f->size > available_disk_space) {
 			continue;
 		}
-		/* workers with more available disk space are preferred */
+		/* workers with more available disk space are preferred to hold the file */
 		priority_queue_push(valid_destinations, w, available_disk_space);
-		switch (q->replica_placement_policy) {
-		case VINE_REPLICA_PLACEMENT_POLICY_RANDOM:
-			priority_queue_push(valid_destinations, w, random_double());
-			break;
-		case VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD:
-			priority_queue_push(valid_destinations, w, available_disk_space);
-			break;
-		case VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD:
-			priority_queue_push(valid_destinations, w, -w->incoming_xfer_counter);
-			break;
-		}
 	}
 
 	struct vine_worker_info *best_destination = priority_queue_pop(valid_destinations);
@@ -224,27 +213,3 @@ int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
 
 	return 1;
 }
-
-void vine_temp_set_replica_placement_policy(struct vine_manager *q, vine_replica_placement_policy_t policy)
-{
-	if (!q) {
-		return;
-	}
-
-	switch (policy) {
-	case VINE_REPLICA_PLACEMENT_POLICY_RANDOM:
-		debug(D_VINE | D_NOTICE, "Setting replica placement policy to RANDOM");
-		q->replica_placement_policy = policy;
-		break;
-	case VINE_REPLICA_PLACEMENT_POLICY_DISK_LOAD:
-		debug(D_VINE | D_NOTICE, "Setting replica placement policy to DISK_LOAD");
-		q->replica_placement_policy = policy;
-		break;
-	case VINE_REPLICA_PLACEMENT_POLICY_TRANSFER_LOAD:
-		debug(D_VINE | D_NOTICE, "Setting replica placement policy to TRANSFER_LOAD");
-		q->replica_placement_policy = policy;
-		break;
-	default:
-		debug(D_ERROR, "Invalid replica placement policy: %d", policy);
-	}
-}

From 642d144e1e0653dc186dd55fcc69897cccdffb6b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Fri, 17 Oct 2025 16:47:34 -0400
Subject: [PATCH 040/113] new version

---
 .../src/graph/dagvine/graph_definition.py     |  28 +-
 taskvine/src/graph/dagvine/graph_executor.py  | 276 ++++++++++++------
 taskvine/src/graph/dagvine/library.py         |  64 ++--
 taskvine/src/graph/dagvine/vine_task_graph.c  | 103 +++----
 taskvine/src/graph/dagvine/vine_task_graph.h  |  31 +-
 taskvine/src/graph/dagvine/vine_task_node.c   |  39 ++-
 taskvine/src/graph/dagvine/vine_task_node.h   |   4 +-
 7 files changed, 333 insertions(+), 212 deletions(-)

diff --git a/taskvine/src/graph/dagvine/graph_definition.py b/taskvine/src/graph/dagvine/graph_definition.py
index 1bf509f72d..3dcead36df 100644
--- a/taskvine/src/graph/dagvine/graph_definition.py
+++ b/taskvine/src/graph/dagvine/graph_definition.py
@@ -93,12 +93,10 @@ def __init__(self, result, extra_size_mb=None):
 class TaskGraph:
     def __init__(self, task_dict,
                  shared_file_system_dir=None,
-                 staging_dir=None,
                  extra_task_output_size_mb=["uniform", 0, 0],
                  extra_task_sleep_time=["uniform", 0, 0]):
         self.task_dict = task_dict
         self.shared_file_system_dir = shared_file_system_dir
-        self.staging_dir = staging_dir
 
         if self.shared_file_system_dir:
             os.makedirs(self.shared_file_system_dir, exist_ok=True)
@@ -248,6 +246,18 @@ def get_topological_order(self):
 
         return topo_order
 
+    def load_result_of_target_key(self, target_results_dir, key):
+        assert self.outfile_type[key] == "local", "Only local output files are supported for target keys"
+        outfile_path = os.path.join(target_results_dir, self.outfile_remote_name[key])
+        if not os.path.exists(outfile_path):
+            result = "NOT_FOUND"
+        else:
+            with open(outfile_path, "rb") as f:
+                result_obj = cloudpickle.load(f)
+                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
+                result = result_obj.result
+        return result
+
     def __del__(self):
         if hasattr(self, 'outfile_remote_name') and self.outfile_remote_name:
             for k in self.outfile_remote_name.keys():
@@ -255,18 +265,14 @@ def __del__(self):
                     os.remove(self.outfile_remote_name[k])
 
 
-def init_task_graph_context(task_graph_path=None):
-    if task_graph_path is None:
-
-        raise ValueError("task_graph_path must be provided to initialize the task graph context")
-    if not os.path.exists(task_graph_path):
-        raise FileNotFoundError(f"Task graph file not found at {task_graph_path}")
+def task_graph_loader(task_graph_pkl):
+    task_graph = cloudpickle.loads(task_graph_pkl)
 
-    with open(task_graph_path, 'rb') as f:
-        task_graph = cloudpickle.load(f)
+    if not isinstance(task_graph, TaskGraph):
+        raise TypeError("Task graph is not of type TaskGraph")
 
     return {
-        'task_graph': task_graph,
+        "task_graph": task_graph,
     }
 
 
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index 34e1c0a64a..8393323359 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -1,12 +1,15 @@
+
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.dagvine import cdagvine
 from ndcctools.taskvine.manager import Manager
 from ndcctools.taskvine.utils import delete_all_files, get_c_constant
 
 from ndcctools.taskvine.dagvine.graph_definition import GraphKeyResult, TaskGraph
-from ndcctools.taskvine.dagvine.params import ManagerTuningParams
-from ndcctools.taskvine.dagvine.params import VineConstantParams
-from ndcctools.taskvine.dagvine.params import RegularParams
+from ndcctools.taskvine.dagvine.library import Library
+from ndcctools.taskvine.dagvine.graph_definition import (
+    GraphKeyResult, TaskGraph, compute_dts_key, compute_sexpr_key, 
+    compute_single_key, hash_name, hashable, task_graph_loader
+)
 
 import cloudpickle
 import os
@@ -67,20 +70,69 @@ def ensure_task_dict(collection_dict):
         return task_dict
 
 
+class GraphParams:
+    def __init__(self):
+        self.vine_manager_tuning_params = {
+            "worker-source-max-transfers": 100,
+            "max-retrievals": -1,
+            "prefer-dispatch": 1,
+            "transient-error-interval": 1,
+            "attempt-schedule-depth": 10000,
+            "temp-replica-count": 1,
+            "enforce-worker-eviction-interval": -1,
+            "balance-worker-disk-load": 0,
+        }
+        self.vine_task_graph_tuning_params = {
+            "failure-injection-step-percent": -1,
+            "task-priority-mode": "largest-input-first",
+            "proxy-library-name": "vine_task_graph_library",
+            "proxy-function-name": "compute_single_key",
+            "prune-depth": 1,
+        }
+        self.other_params = {
+            "schedule": "worst",
+            "libcores": 16,
+            "failure-injection-step-percent": -1,
+            "target-results-dir": "./target_results",
+            "shared-file-system-dir": "./shared_file_system",
+            "extra-task-output-size-mb": ["uniform", 0, 0],
+            "extra-task-sleep-time": ["uniform", 0, 0],
+            "outfile-type": {
+                "temp": 1.0,
+                "shared-file-system": 0.0,
+            },
+        }
+
+    def update_param(self, param_name, new_value):
+        if param_name in self.vine_manager_tuning_params:
+            self.vine_manager_tuning_params[param_name] = new_value
+        elif param_name in self.vine_task_graph_tuning_params:
+            self.vine_task_graph_tuning_params[param_name] = new_value
+        elif param_name in self.other_params:
+            self.other_params[param_name] = new_value
+        else:
+            self.vine_manager_tuning_params[param_name] = new_value
+
+    def get_value_of(self, param_name):
+        if param_name in self.vine_manager_tuning_params:
+            return self.vine_manager_tuning_params[param_name]
+        elif param_name in self.vine_task_graph_tuning_params:
+            return self.vine_task_graph_tuning_params[param_name]
+        elif param_name in self.other_params:
+            return self.other_params[param_name]
+        else:
+            raise ValueError(f"Invalid param name: {param_name}")
+
+
 class GraphExecutor(Manager):
     def __init__(self,
                  *args,
-                 manager_tuning_params=ManagerTuningParams(),
-                 regular_params=RegularParams(),
-                 vine_constant_params=VineConstantParams(),
                  **kwargs):
 
         # handle SIGINT correctly
         signal.signal(signal.SIGINT, self._on_sigint)
 
-        self.manager_tuning_params = manager_tuning_params
-        self.vine_constant_params = vine_constant_params
-        self.regular_params = regular_params
+        self.params = GraphParams()
 
         # delete all files in the run info directory, do this before super().__init__()
         run_info_path = kwargs.get("run_info_path", None)
@@ -92,6 +144,8 @@ def __init__(self,
         # initialize the manager
         super().__init__(*args, **kwargs)
 
+        self._vine_task_graph = None
+
     def tune_manager(self):
         for k, v in self.manager_tuning_params.to_dict().items():
             print(f"Tuning {k} to {v}")
@@ -100,102 +154,138 @@ def tune_manager(self):
         # set worker scheduling algorithm
         cvine.vine_set_scheduler(self._taskvine, self.vine_constant_params.get_c_constant_of("schedule"))
 
-    def run(self,
-            collection_dict,
-            target_keys=[],
-            library=None,
-            ):
+        if self._vine_task_graph:
+            cdagvine.vine_task_graph_tune(self._vine_task_graph, "failure-injection-step-percent", str(self.regular_params.failure_injection_step_percent))
+            cdagvine.vine_task_graph_tune(self._vine_task_graph, "task-priority-mode", self.vine_constant_params.task_priority_mode)
 
-        # initialize the task graph (note: the lifetime of this object is limited to this function)
-        self._vine_task_graph = cdagvine.vine_task_graph_create(self._taskvine)
-        cdagvine.vine_task_graph_tune(self._vine_task_graph, "failure-injection-step-percent", str(self.regular_params.failure_injection_step_percent))
-        cdagvine.vine_task_graph_tune(self._vine_task_graph, "task-priority-mode", self.vine_constant_params.task_priority_mode)
+    def param(self, param_name):
+        return self.params.get_value_of(param_name)
 
-        # tune the manager every time we start a new run as the parameters may have changed
-        self.tune_manager()
+    def update_params(self, new_params):
+        assert isinstance(new_params, dict), "new_params must be a dict"
+        for k, new_v in new_params.items():
+            self.params.update_param(k, new_v)
 
-        self.target_keys = target_keys
-        self.task_dict = ensure_task_dict(collection_dict)
+    def get_run_info_path(self):
+        return os.path.join(self.param("run-info-path"), self.param("run-info-template"))
 
-        # create library task
-        self.library = library
-        self.library.install(self, self.regular_params.libcores, self._vine_task_graph)
-
-        # create task graph in the python side
-        print("Initializing TaskGraph object")
-        self.task_graph = TaskGraph(self.task_dict,
-                                    staging_dir=self.regular_params.staging_dir,
-                                    shared_file_system_dir=self.regular_params.shared_file_system_dir,
-                                    extra_task_output_size_mb=self.regular_params.extra_task_output_size_mb,
-                                    extra_task_sleep_time=self.regular_params.extra_task_sleep_time)
-        topo_order = self.task_graph.get_topological_order()
-
-        # create task graph in the python side
-        print("Initializing task graph in TaskVine")
-        for k in topo_order:
-            cdagvine.vine_task_graph_add_node(self._vine_task_graph,
-                                           self.task_graph.vine_key_of[k],
-                                           self.regular_params.staging_dir,
-                                           self.regular_params.prune_depth)
-            for pk in self.task_graph.parents_of.get(k, []):
-                cdagvine.vine_task_graph_add_dependency(self._vine_task_graph, self.task_graph.vine_key_of[pk], self.task_graph.vine_key_of[k])
-
-        # we must finalize the graph in c side after all nodes and dependencies are added
-        # this includes computing various metrics for each node, such as depth, height, heavy score, etc.
-        cdagvine.vine_task_graph_compute_topology_metrics(self._vine_task_graph)
-
-        # then we can use the heavy score to sort the nodes and specify their outfile remote names
+    def tune_vine_manager(self):
+        for k, v in self.params.vine_manager_tuning_params.items():
+            print(f"Tuning {k} to {v}")
+            self.tune(k, v)
+
+    def tune_vine_task_graph(self, c_graph):
+        for k, v in self.params.vine_task_graph_tuning_params.items():
+            print(f"Tuning {k} to {v}")
+            cdagvine.vine_task_graph_tune(c_graph, k, str(v))
+
+    def assign_outfile_types(self, target_keys, py_graph, c_graph):
+        assert py_graph is not None, "Python graph must be built first"
+        assert c_graph is not None, "C graph must be built first"
+
+        # get heavy score from C side
         heavy_scores = {}
-        for k in self.task_graph.task_dict.keys():
-            heavy_scores[k] = cdagvine.vine_task_graph_get_node_heavy_score(self._vine_task_graph, self.task_graph.vine_key_of[k])
+        for k in py_graph.task_dict.keys():
+            heavy_scores[k] = cdagvine.vine_task_graph_get_node_heavy_score(c_graph, py_graph.vine_key_of[k])
+
+        # sort keys by heavy score descending
+        sorted_keys = sorted(heavy_scores, key=lambda k: heavy_scores[k], reverse=True)
 
-        # keys with larger heavy score should be stored into the shared file system
-        sorted_keys = sorted(heavy_scores, key=lambda x: heavy_scores[x], reverse=True)
-        shared_file_system_size = round(len(sorted_keys) * self.regular_params.outfile_type["shared-file-system"])
+        # determine how many go to shared FS
+        sharedfs_count = round(self.param("outfile-type")["shared-file-system"] * len(sorted_keys))
+
+        # assign outfile types
         for i, k in enumerate(sorted_keys):
-            if k in self.target_keys:
+            if k in target_keys:
                 choice = "local"
+            elif i < sharedfs_count:
+                choice = "shared-file-system"
             else:
-                if i < shared_file_system_size:
-                    choice = "shared-file-system"
-                else:
-                    choice = "temp"
-            # set on the Python side, will be installed on the remote workers
-            self.task_graph.set_outfile_type_of(k, choice)
-            # set on the C side, so the manager knows where the data is stored
-            outfile_type_str = f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}"
-            cdagvine.vine_task_graph_set_node_outfile(self._vine_task_graph,
-                                                   self.task_graph.vine_key_of[k],
-                                                   get_c_constant(outfile_type_str),
-                                                   self.task_graph.outfile_remote_name[k])
-
-        # save the task graph to a pickle file, will be sent to the remote workers
-        with open(self.library.local_path, 'wb') as f:
-            cloudpickle.dump(self.task_graph, f)
-
-        # now execute the vine graph
-        print(f"\033[92mExecuting task graph, logs will be written into {self.run_info_template_path}\033[0m")
-        cdagvine.vine_task_graph_execute(self._vine_task_graph)
-
-        # after execution, we need to load results of target keys
+                choice = "temp"
+
+            py_graph.set_outfile_type_of(k, choice)
+            outfile_type_enum = get_c_constant(f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}")
+            cdagvine.vine_task_graph_set_node_outfile(
+                c_graph,
+                py_graph.vine_key_of[k],
+                outfile_type_enum,
+                py_graph.outfile_remote_name[k]
+            )
+
+    def build_python_graph(self):
+        py_graph = TaskGraph(
+            self.task_dict,
+            shared_file_system_dir=self.param("shared-file-system-dir"),
+            extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
+            extra_task_sleep_time=self.param("extra-task-sleep-time")
+        )
+
+        return py_graph
+
+    def build_c_graph(self, py_graph):
+        assert py_graph is not None, "Python graph must be built before building the C graph"
+
+        c_graph = cdagvine.vine_task_graph_create(self._taskvine)
+
+        # C side vine task graph must be tuned before adding nodes and dependencies
+        self.tune_vine_manager()
+        self.tune_vine_task_graph(c_graph)
+
+        topo_order = py_graph.get_topological_order()
+        for k in topo_order:
+            cdagvine.vine_task_graph_add_node(
+                c_graph,
+                py_graph.vine_key_of[k],
+            )
+            for pk in py_graph.parents_of[k]:
+                cdagvine.vine_task_graph_add_dependency(c_graph, py_graph.vine_key_of[pk], py_graph.vine_key_of[k])
+
+        cdagvine.vine_task_graph_compute_topology_metrics(c_graph)
+
+        return c_graph
+
+    def build_graphs(self, target_keys):
+        # build Python DAG (logical topology)
+        py_graph = self.build_python_graph()
+
+        # build C DAG (physical topology)
+        c_graph = self.build_c_graph(py_graph)
+
+        # assign outfile types
+        self.assign_outfile_types(target_keys, py_graph, c_graph)
+
+        return py_graph, c_graph
+
+    def new_run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[], env_files={}):
+        # first update the params so that they can be used for the following construction
+        self.update_params(params)
+
+        self.task_dict = ensure_task_dict(collection_dict)
+        
+        # build graphs in both Python and C sides
+        py_graph, c_graph = self.build_graphs(target_keys)
+
+        library = Library(self, self.param("proxy-library-name"), self.param("libcores"))
+
+        library.add_hoisting_modules(hoisting_modules)
+        library.add_env_files(env_files)
+        library.set_context_loader(task_graph_loader, context_loader_args=[cloudpickle.dumps(py_graph)])
+        library.install()
+
+        cdagvine.vine_task_graph_execute(c_graph)
+
+        # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
+        cdagvine.vine_task_graph_delete(c_graph)
+
+        # clean up the library instances and template on the manager
+        library.uninstall()
+
+        # load results of target keys
         results = {}
-        for k in self.target_keys:
-            local_outfile_path = cdagvine.vine_task_graph_get_node_local_outfile_source(self._vine_task_graph, self.task_graph.vine_key_of[k])
-            if not os.path.exists(local_outfile_path):
-                results[k] = "NOT_FOUND"
-                continue
-            with open(local_outfile_path, 'rb') as f:
-                result_obj = cloudpickle.load(f)
-                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
-                results[k] = result_obj.result
+        for k in target_keys:
+            results[k] = py_graph.load_result_of_target_key(self.param("target-results-dir"), k)
         return results
 
     def _on_sigint(self, signum, frame):
         self.__del__()
 
-    def __del__(self):
-        if hasattr(self, '_vine_task_graph') and self._vine_task_graph:
-            cdagvine.vine_task_graph_delete(self._vine_task_graph)
-
-        if hasattr(self, 'library') and self.library.local_path and os.path.exists(self.library.local_path):
-            os.remove(self.library.local_path)
diff --git a/taskvine/src/graph/dagvine/library.py b/taskvine/src/graph/dagvine/library.py
index 7a441e5aba..3e4a431483 100644
--- a/taskvine/src/graph/dagvine/library.py
+++ b/taskvine/src/graph/dagvine/library.py
@@ -3,19 +3,38 @@
 from ndcctools.taskvine.dagvine import cdagvine
 from ndcctools.taskvine.graph_definition import (
     GraphKeyResult, TaskGraph, compute_dts_key, compute_sexpr_key, 
-    compute_single_key, hash_name, hashable, init_task_graph_context
+    compute_single_key, hash_name, hashable
 )
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
 class Library:
-    def __init__(self, hoisting_modules=[], env_files={}):
+    def __init__(self, py_manager, libname, libcores):
+        self.py_manager = py_manager
+        self.libname = libname
+        assert self.libname is not None, "libname must be provided"
+
+        self.libcores = libcores
+        assert self.libcores is not None, "libcores must be provided"
+
         self.libtask = None
 
-        self.hoisting_modules = hoisting_modules
-        self.env_files = env_files
+        # these modules are always included in the preamble of the library task, so that function calls can execute directly
+        # using the loaded context without importing them over and over again
+        self.hoisting_modules = [
+            os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
+            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
+        ]
+
+        # environment files serve as additional inputs to the library task, where each key is the local path and the value is the remote path
+        # those local files will be sent remotely to the workers so tasks can access them as appropriate
+        self.env_files = {}
+
+        # context loader is a function that will be used to load the library context on remote nodes.
+        self.context_loader_func = None
+        self.context_loader_args = []
+        self.context_loader_kwargs = {}
 
-        self.libcores = -1
         self.local_path = None
         self.remote_path = None
 
@@ -27,30 +46,29 @@ def add_env_files(self, new_env_files):
         assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
         self.env_files.update(new_env_files)
 
-    def install(self, manager, libcores, vine_graph):
-        self.libcores = libcores
-
-        assert cdagvine.vine_task_graph_get_proxy_function_name(vine_graph) == compute_single_key.__name__
+    def set_context_loader(self, context_loader_func, context_loader_args=[], context_loader_kwargs={}):
+        self.context_loader_func = context_loader_func
+        self.context_loader_args = context_loader_args
+        self.context_loader_kwargs = context_loader_kwargs
 
-        self.local_path = f"library-task-graph-{uuid.uuid4()}.pkl"
-        self.remote_path = self.local_path
-
-        self.hoisting_modules += [
-            os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
-            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
-        ]
-        lib_name = cdagvine.vine_task_graph_get_proxy_library_name(vine_graph)
-        self.libtask = manager.create_library_from_functions(
-            lib_name,
+    def install(self):
+        self.libtask = self.py_manager.create_library_from_functions(
+            self.libname,
             compute_single_key,
-            library_context_info=[init_task_graph_context, [], {"task_graph_path": self.remote_path}],
+            library_context_info=[self.context_loader_func, self.context_loader_args, self.context_loader_kwargs],
             add_env=False,
             function_infile_load_mode="json",
             hoisting_modules=self.hoisting_modules,
         )
-        self.libtask.add_input(manager.declare_file(self.local_path), self.remote_path)
         for local, remote in self.env_files.items():
-            self.libtask.add_input(manager.declare_file(local, cache=True, peer_transfer=True), remote)
+            # check if the local file exists
+            if not os.path.exists(local):
+                raise FileNotFoundError(f"Local file {local} not found")
+            # attach as the input file to the library task
+            self.libtask.add_input(self.py_manager.declare_file(local, cache=True, peer_transfer=True), remote)
         self.libtask.set_cores(self.libcores)
         self.libtask.set_function_slots(self.libcores)
-        manager.install_library(self.libtask)
\ No newline at end of file
+        self.py_manager.install_library(self.libtask)
+
+    def uninstall(self):
+        self.py_manager.remove_library(self.libname)
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.c b/taskvine/src/graph/dagvine/vine_task_graph.c
index 2cb1574a73..8bbd01a0f2 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.c
+++ b/taskvine/src/graph/dagvine/vine_task_graph.c
@@ -4,6 +4,7 @@
 #include <assert.h>
 #include <math.h>
 #include <signal.h>
+#include <errno.h>
 #include <stdio.h>
 #include <sys/stat.h>
 
@@ -383,51 +384,38 @@ int vine_task_graph_tune(struct vine_task_graph *tg, const char *name, const cha
 			return -1;
 		}		
 
-	}
-
-	return 0;
-}
-
-/**
- * Set the proxy library name (Python-side), shared by all tasks.
- * @param tg Reference to the task graph object.
- * @param proxy_library_name Reference to the proxy library name.
- */
-void vine_task_graph_set_proxy_library_name(struct vine_task_graph *tg, const char *proxy_library_name)
-{
-	if (!tg || !proxy_library_name) {
-		return;
-	}
-
-	/* free the existing proxy library name if it exists */
-	if (tg->proxy_library_name) {
-		free(tg->proxy_library_name);
-	}
+	} else if (strcmp(name, "target-results-dir") == 0) {
+		if (tg->target_results_dir) {
+			free(tg->target_results_dir);
+		}
+		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
+			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
+			return -1;
+		}
+		tg->target_results_dir = xxstrdup(value);
 
-	tg->proxy_library_name = xxstrdup(proxy_library_name);
+	} else if (strcmp(name, "proxy-library-name") == 0) {
+		if (tg->proxy_library_name) {
+			free(tg->proxy_library_name);
+		}
+		tg->proxy_library_name = xxstrdup(value);
 
-	return;
-}
+	} else if (strcmp(name, "proxy-function-name") == 0) {
+		if (tg->proxy_function_name) {
+			free(tg->proxy_function_name);
+		}
+		tg->proxy_function_name = xxstrdup(value);
 
-/**
- * Set the proxy function name (Python-side), shared by all tasks.
- * @param tg Reference to the task graph object.
- * @param proxy_function_name Reference to the proxy function name.
- */
-void vine_task_graph_set_proxy_function_name(struct vine_task_graph *tg, const char *proxy_function_name)
-{
-	if (!tg || !proxy_function_name) {
-		return;
-	}
+	} else if (strcmp(name, "prune-depth") == 0) {
+		tg->prune_depth = atoi(value);
+		
+	} else {
+		debug(D_ERROR, "invalid parameter name: %s", name);
+		return -1;
 
-	/* free the existing proxy function name if it exists */
-	if (tg->proxy_function_name) {
-		free(tg->proxy_function_name);
 	}
 
-	tg->proxy_function_name = xxstrdup(proxy_function_name);
-
-	return;
+	return 0;
 }
 
 /**
@@ -621,15 +609,9 @@ void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
  * Create a new node and track it in the task graph.
  * @param tg Reference to the task graph object.
  * @param node_key Reference to the node key.
- * @param staging_dir Reference to the staging directory.
- * @param prune_depth Reference to the prune depth.
  * @return A new node object.
  */
-struct vine_task_node *vine_task_graph_add_node(
-		struct vine_task_graph *tg,
-		const char *node_key,
-		const char *staging_dir,
-		int prune_depth)
+struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg, const char *node_key)
 {
 	if (!tg || !node_key) {
 		return NULL;
@@ -642,8 +624,15 @@ struct vine_task_node *vine_task_graph_add_node(
 				node_key,
 				tg->proxy_library_name,
 				tg->proxy_function_name,
-				staging_dir,
-				prune_depth);
+				tg->target_results_dir,
+				tg->prune_depth);
+
+		if (!node) {
+			debug(D_ERROR, "failed to create node %s", node_key);
+			vine_task_graph_delete(tg);
+			exit(1);
+		}
+
 		hash_table_insert(tg->nodes, node_key, node);
 	}
 
@@ -658,13 +647,18 @@ struct vine_task_node *vine_task_graph_add_node(
 struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
 {
 	struct vine_task_graph *tg = xxmalloc(sizeof(struct vine_task_graph));
+
+	tg->manager = q;
+	
 	tg->nodes = hash_table_create(0, 0);
 	tg->task_id_to_node = itable_create(0);
 	tg->outfile_cachename_to_node = hash_table_create(0, 0);
 
-	tg->proxy_library_name = xxstrdup("vine_task_graph_library");   // Python-side proxy library name (shared by all tasks)
-	tg->proxy_function_name = xxstrdup("compute_single_key");       // Python-side proxy function name (shared by all tasks)
-	tg->manager = q;
+	tg->target_results_dir = xxstrdup(tg->manager->runtime_directory);  // default to current working directory
+	tg->proxy_library_name = NULL;
+	tg->proxy_function_name = NULL;
+
+	tg->prune_depth = 1;
 
 	tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST;
 	tg->failure_injection_step_percent = -1.0;
@@ -695,6 +689,13 @@ void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *pare
 	struct vine_task_node *child_node = hash_table_lookup(tg->nodes, child_key);
 	if (!parent_node) {
 		debug(D_ERROR, "parent node %s not found", parent_key);
+		char *node_key = NULL;
+		struct vine_task_node *node;
+		printf("parent_keys:\n");
+		HASH_TABLE_ITERATE(tg->nodes, node_key, node)
+		{
+			printf("  %s\n", node->node_key);
+		}
 		exit(1);
 	}
 	if (!child_node) {
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.h b/taskvine/src/graph/dagvine/vine_task_graph.h
index 6f4b39b398..47990e7211 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.h
+++ b/taskvine/src/graph/dagvine/vine_task_graph.h
@@ -28,8 +28,16 @@ struct vine_task_graph {
 	struct itable *task_id_to_node;
 	struct hash_table *outfile_cachename_to_node;
 
-    char *proxy_library_name;
-    char *proxy_function_name;
+    /* Results of target keys will be stored in this directory. 
+     * This dir path can not necessarily be a shared file system directory,
+     * output files will be retrieved through the network instead,
+     * as long as the manager can access it. */
+    char *target_results_dir;
+
+    char *proxy_library_name;    // Python-side proxy library name (shared by all tasks)
+    char *proxy_function_name;   // Python-side proxy function name (shared by all tasks)
+
+    int prune_depth;
 
     vine_task_graph_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
     double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
@@ -47,14 +55,9 @@ struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
 /** Create a new node in the task graph.
 @param tg Reference to the task graph object.
 @param node_key Reference to the node key.
-@param staging_dir Reference to the staging directory.
-@param prune_depth Reference to the prune depth.
 @return A new node object.
 */
-struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg,
-	const char *node_key,
-	const char *staging_dir,
-	int prune_depth);
+struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg, const char *node_key);
 
 /** Add a dependency between two nodes in the task graph.
 @param tg Reference to the task graph object.
@@ -112,18 +115,6 @@ const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph
 */
 const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
 
-/** Set the proxy library name (Python-side), shared by all tasks.
-@param tg Reference to the task graph object.
-@param proxy_library_name Reference to the proxy library name.
-*/
-void vine_task_graph_set_proxy_library_name(struct vine_task_graph *tg, const char *proxy_library_name);
-
-/** Set the proxy function name (Python-side), shared by all tasks.
-@param tg Reference to the task graph object.
-@param proxy_function_name Reference to the proxy function name.
-*/
-void vine_task_graph_set_proxy_function_name(struct vine_task_graph *tg, const char *proxy_function_name);
-
 /** Tune the task graph.
 @param tg Reference to the task graph object.
 @param name Reference to the name of the parameter to tune.
diff --git a/taskvine/src/graph/dagvine/vine_task_node.c b/taskvine/src/graph/dagvine/vine_task_node.c
index c563ff459f..0539c59f94 100644
--- a/taskvine/src/graph/dagvine/vine_task_node.c
+++ b/taskvine/src/graph/dagvine/vine_task_node.c
@@ -3,7 +3,6 @@
 #include <stdlib.h>
 #include <unistd.h>
 #include <string.h>
-#include <errno.h>
 #include <sys/types.h>
 #include <sys/stat.h>
 
@@ -58,10 +57,27 @@ struct vine_task_node *vine_task_node_create(
 		const char *node_key,
 		const char *proxy_library_name,
 		const char *proxy_function_name,
-		const char *staging_dir,
+		const char *target_results_dir,
 		int prune_depth)
 {
-	if (!manager || !node_key || !proxy_library_name || !proxy_function_name || !staging_dir) {
+	if (!manager) {
+		debug(D_ERROR, "Cannot create node because manager is NULL");
+		return NULL;
+	}
+	if (!node_key) {
+		debug(D_ERROR, "Cannot create node because node_key is NULL");
+		return NULL;
+	}
+	if (!proxy_library_name) {
+		debug(D_ERROR, "Cannot create node because proxy_library_name is NULL");
+		return NULL;
+	}
+	if (!proxy_function_name) {
+		debug(D_ERROR, "Cannot create node because proxy_function_name is NULL");
+		return NULL;
+	}
+	if (!target_results_dir) {
+		debug(D_ERROR, "Cannot create node because target_results_dir is NULL");
 		return NULL;
 	}
 
@@ -69,7 +85,7 @@ struct vine_task_node *vine_task_node_create(
 
 	node->manager = manager;
 	node->node_key = xxstrdup(node_key);
-	node->staging_dir = xxstrdup(staging_dir);
+	node->target_results_dir = xxstrdup(target_results_dir);
 
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
 	node->parents = list_create();
@@ -137,13 +153,12 @@ void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outf
 	/* create the output file */
 	switch (node->outfile_type) {
 	case VINE_NODE_OUTFILE_TYPE_LOCAL: {
-		char *local_output_dir = string_format("%s/outputs", node->staging_dir);
-		if (mkdir(local_output_dir, 0777) != 0 && errno != EEXIST) {
-			debug(D_ERROR, "failed to mkdir %s (errno=%d)", local_output_dir, errno);
+		if (!node->target_results_dir) {
+			debug(D_ERROR, "Cannot create local output file for node %s because target_results_dir is NULL", node->node_key);
+			exit(1);
 		}
-		char *local_output_path = string_format("%s/%s", local_output_dir, node->outfile_remote_name);
+		char *local_output_path = string_format("%s/%s", node->target_results_dir, node->outfile_remote_name);
 		node->outfile = vine_declare_file(node->manager, local_output_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
-		free(local_output_dir);
 		free(local_output_path);
 		break;
 	}
@@ -471,7 +486,7 @@ void vine_task_node_print_info(struct vine_task_node *node)
 	debug(D_VINE, "---------------- Node Info ----------------");
 	debug(D_VINE, "key: %s", node->node_key);
 	debug(D_VINE, "task_id: %d", node->task->task_id);
-	debug(D_VINE, "staging_dir: %s", node->staging_dir ? node->staging_dir : "(null)");
+	debug(D_VINE, "target_results_dir: %s", node->target_results_dir ? node->target_results_dir : "(null)");
 	debug(D_VINE, "depth: %d", node->depth);
 	debug(D_VINE, "height: %d", node->height);
 	debug(D_VINE, "prune_depth: %d", node->prune_depth);
@@ -599,8 +614,8 @@ void vine_task_node_delete(struct vine_task_node *node)
 	if (node->outfile_remote_name) {
 		free(node->outfile_remote_name);
 	}
-	if (node->staging_dir) {
-		free(node->staging_dir);
+	if (node->target_results_dir) {
+		free(node->target_results_dir);
 	}
 
 	vine_task_delete(node->task);
diff --git a/taskvine/src/graph/dagvine/vine_task_node.h b/taskvine/src/graph/dagvine/vine_task_node.h
index 5b6b00272a..c9d58bf520 100644
--- a/taskvine/src/graph/dagvine/vine_task_node.h
+++ b/taskvine/src/graph/dagvine/vine_task_node.h
@@ -29,7 +29,7 @@ struct vine_task_node {
     struct vine_file *infile;
     struct vine_file *outfile;
     char *outfile_remote_name;
-    char *staging_dir;
+    char *target_results_dir;
     size_t outfile_size_bytes;
         
     struct list *parents;
@@ -62,7 +62,7 @@ struct vine_task_node *vine_task_node_create(
     const char *node_key,
     const char *proxy_library_name,
     const char *proxy_function_name,
-    const char *staging_dir,
+    const char *target_results_dir,
     int prune_depth
 );
 

From 3fab11052e6a54747cba77ebc8c478b546e3a47b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 18 Oct 2025 00:20:25 -0400
Subject: [PATCH 041/113] remove _task_graph

---
 taskvine/src/graph/dagvine/graph_executor.py | 30 ++++++--------------
 taskvine/src/graph/dagvine/vine_task_graph.c |  2 --
 taskvine/src/manager/taskvine.h              |  6 ++++
 taskvine/src/manager/vine_manager.c          |  1 +
 taskvine/src/manager/vine_runtime_dir.c      |  5 ++++
 5 files changed, 21 insertions(+), 23 deletions(-)

diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index 8393323359..a06c904270 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -4,23 +4,12 @@
 from ndcctools.taskvine.manager import Manager
 from ndcctools.taskvine.utils import delete_all_files, get_c_constant
 
-from ndcctools.taskvine.dagvine.graph_definition import GraphKeyResult, TaskGraph
 from ndcctools.taskvine.dagvine.library import Library
-from ndcctools.taskvine.dagvine.graph_definition import (
-    GraphKeyResult, TaskGraph, compute_dts_key, compute_sexpr_key, 
-    compute_single_key, hash_name, hashable, task_graph_loader
-)
+from ndcctools.taskvine.dagvine.graph_definition import TaskGraph, task_graph_loader
 
 import cloudpickle
 import os
-import collections
-import inspect
-import types
 import signal
-import hashlib
-import time
-import random
-import uuid
 
 try:
     import dask
@@ -38,6 +27,7 @@
     dts = None
 
 
+# convert Dask collection to task dictionary
 def dask_collections_to_task_dict(collection_dict):
     assert is_dask_collection is not None
     from dask.highlevelgraph import HighLevelGraph, ensure_dict
@@ -58,6 +48,7 @@ def dask_collections_to_task_dict(collection_dict):
     return ensure_dict(hlg)
 
 
+# compatibility for Dask-created collections
 def ensure_task_dict(collection_dict):
     if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
         task_dict = dask_collections_to_task_dict(collection_dict)
@@ -144,7 +135,7 @@ def __init__(self,
         # initialize the manager
         super().__init__(*args, **kwargs)
 
-        self._vine_task_graph = None
+        self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
 
     def tune_manager(self):
         for k, v in self.manager_tuning_params.to_dict().items():
@@ -154,10 +145,6 @@ def tune_manager(self):
         # set worker scheduling algorithm
         cvine.vine_set_scheduler(self._taskvine, self.vine_constant_params.get_c_constant_of("schedule"))
 
-        if self._vine_task_graph:
-            cdagvine.vine_task_graph_tune(self._vine_task_graph, "failure-injection-step-percent", str(self.regular_params.failure_injection_step_percent))
-            cdagvine.vine_task_graph_tune(self._vine_task_graph, "task-priority-mode", self.vine_constant_params.task_priority_mode)
-
     def param(self, param_name):
         return self.params.get_value_of(param_name)
 
@@ -256,7 +243,7 @@ def build_graphs(self, target_keys):
 
         return py_graph, c_graph
 
-    def new_run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[], env_files={}):
+    def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[], env_files={}):
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
@@ -272,13 +259,14 @@ def new_run(self, collection_dict, target_keys=None, params={}, hoisting_modules
         library.set_context_loader(task_graph_loader, context_loader_args=[cloudpickle.dumps(py_graph)])
         library.install()
 
+        # execute the graph on the C side
+        print(f"Executing task graph, logs will be written to {self.runtime_directory}")
         cdagvine.vine_task_graph_execute(c_graph)
 
-        # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
-        cdagvine.vine_task_graph_delete(c_graph)
-
         # clean up the library instances and template on the manager
         library.uninstall()
+        # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
+        cdagvine.vine_task_graph_delete(c_graph)
 
         # load results of target keys
         results = {}
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.c b/taskvine/src/graph/dagvine/vine_task_graph.c
index 8bbd01a0f2..5e376812b7 100644
--- a/taskvine/src/graph/dagvine/vine_task_graph.c
+++ b/taskvine/src/graph/dagvine/vine_task_graph.c
@@ -972,8 +972,6 @@ void vine_task_graph_delete(struct vine_task_graph *tg)
 		vine_task_node_delete(node);
 	}
 
-	vine_delete(tg->manager);
-
 	free(tg->proxy_library_name);
 	free(tg->proxy_function_name);
 
diff --git a/taskvine/src/manager/taskvine.h b/taskvine/src/manager/taskvine.h
index eda05ebc4d..ebce1899a2 100644
--- a/taskvine/src/manager/taskvine.h
+++ b/taskvine/src/manager/taskvine.h
@@ -1536,6 +1536,12 @@ void vine_counters_print();
  */
 char *vine_version_string();
 
+/** Returns the runtime directory
+@param m Reference to the current manager object.
+@return A string.
+*/
+char *vine_get_runtime_directory(struct vine_manager *m);
+
 /** Returns path relative to the logs runtime directory
 @param m Reference to the current manager object.
 @param path Target filename.
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 9953df9450..27832876f9 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -5157,6 +5157,7 @@ void vine_manager_remove_library(struct vine_manager *q, const char *name)
 		struct vine_task *library = vine_schedule_find_library(q, w, name);
 		while (library) {
 			vine_cancel_by_task_id(q, library->task_id);
+			itable_remove(w->current_libraries, library->task_id);
 			library = vine_schedule_find_library(q, w, name);
 		}
 		hash_table_remove(q->library_templates, name);
diff --git a/taskvine/src/manager/vine_runtime_dir.c b/taskvine/src/manager/vine_runtime_dir.c
index a2bc4194a0..5f5f586b32 100644
--- a/taskvine/src/manager/vine_runtime_dir.c
+++ b/taskvine/src/manager/vine_runtime_dir.c
@@ -134,6 +134,11 @@ char *vine_runtime_directory_create()
 	return runtime_dir;
 }
 
+char *vine_get_runtime_directory(struct vine_manager *m)
+{
+	return m->runtime_directory;
+}
+
 char *vine_get_path_log(struct vine_manager *m, const char *path)
 {
 	return string_format("%s/vine-logs%s%s", m->runtime_directory, path ? "/" : "", path ? path : "");

From 5b85f46ad5e860188ff046f2230757209c6c6648 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 18 Oct 2025 02:32:35 -0400
Subject: [PATCH 042/113] new

---
 .../src/graph/dagvine/graph_definition.py     | 28 +++++++++----------
 taskvine/src/graph/dagvine/graph_executor.py  |  6 ++--
 2 files changed, 16 insertions(+), 18 deletions(-)

diff --git a/taskvine/src/graph/dagvine/graph_definition.py b/taskvine/src/graph/dagvine/graph_definition.py
index 3dcead36df..0b22fa4e7e 100644
--- a/taskvine/src/graph/dagvine/graph_definition.py
+++ b/taskvine/src/graph/dagvine/graph_definition.py
@@ -216,14 +216,24 @@ def save_result_of_key(self, key, result):
             result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
             cloudpickle.dump(result_obj, f)
 
-    def load_result_of_key(self, key):
+    def load_result_of_key(self, key, target_results_dir=None):
+        if self.outfile_type[key] == "local":
+            # nodes with local outfile type will have their results stored in the target results directory
+            # when the execution is done, users can call this function to load the results from the target results directory
+            # note that data is transferred through the link in sequence, not in parallel through the shared file system
+            outfile_path = os.path.join(target_results_dir, self.outfile_remote_name[key])
+        else:
+            # workers user this branch to load results from either local or shared file system
+            # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
+            # if a shared file system output, then remote name is the full path to the file
+            outfile_path = self.outfile_remote_name[key]
         try:
-            with open(self.outfile_remote_name[key], "rb") as f:
+            with open(outfile_path, "rb") as f:
                 result_obj = cloudpickle.load(f)
                 assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
                 return result_obj.result
         except FileNotFoundError:
-            raise FileNotFoundError(f"Output file for key {key} not found at {self.outfile_remote_name[key]}")
+            raise FileNotFoundError(f"Output file for key {key} not found at {outfile_path}")
 
     def get_topological_order(self):
         in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
@@ -246,18 +256,6 @@ def get_topological_order(self):
 
         return topo_order
 
-    def load_result_of_target_key(self, target_results_dir, key):
-        assert self.outfile_type[key] == "local", "Only local output files are supported for target keys"
-        outfile_path = os.path.join(target_results_dir, self.outfile_remote_name[key])
-        if not os.path.exists(outfile_path):
-            result = "NOT_FOUND"
-        else:
-            with open(outfile_path, "rb") as f:
-                result_obj = cloudpickle.load(f)
-                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
-                result = result_obj.result
-        return result
-
     def __del__(self):
         if hasattr(self, 'outfile_remote_name') and self.outfile_remote_name:
             for k in self.outfile_remote_name.keys():
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index a06c904270..733fe845f8 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -79,12 +79,12 @@ def __init__(self):
             "proxy-library-name": "vine_task_graph_library",
             "proxy-function-name": "compute_single_key",
             "prune-depth": 1,
+            "target-results-dir": "./target_results",
         }
         self.other_params = {
             "schedule": "worst",
             "libcores": 16,
             "failure-injection-step-percent": -1,
-            "target-results-dir": "./target_results",
             "shared-file-system-dir": "./shared_file_system",
             "extra-task-output-size-mb": ["uniform", 0, 0],
             "extra-task-sleep-time": ["uniform", 0, 0],
@@ -252,8 +252,8 @@ def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[],
         # build graphs in both Python and C sides
         py_graph, c_graph = self.build_graphs(target_keys)
 
+        # create and install the library template on the manager
         library = Library(self, self.param("proxy-library-name"), self.param("libcores"))
-
         library.add_hoisting_modules(hoisting_modules)
         library.add_env_files(env_files)
         library.set_context_loader(task_graph_loader, context_loader_args=[cloudpickle.dumps(py_graph)])
@@ -271,7 +271,7 @@ def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[],
         # load results of target keys
         results = {}
         for k in target_keys:
-            results[k] = py_graph.load_result_of_target_key(self.param("target-results-dir"), k)
+            results[k] = py_graph.load_result_of_key(k, target_results_dir=self.param("target-results-dir"))
         return results
 
     def _on_sigint(self, signum, frame):

From ec96041caf881d3172c11577a112411f1cfc0c07 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 18 Oct 2025 14:45:46 -0400
Subject: [PATCH 043/113] reg

---
 taskvine/src/bindings/python3/Makefile        |   2 +-
 .../src/graph/dagvine/graph_definition.py     | 340 ------------------
 taskvine/src/graph/dagvine/graph_executor.py  |  46 +--
 taskvine/src/graph/dagvine/library.py         |   6 +-
 4 files changed, 27 insertions(+), 367 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/graph_definition.py

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index 24557af1b0..c81a88efb1 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -39,7 +39,7 @@ install: all
 	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
 
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/graph_definition.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/graph_definition.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/library.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/library.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/params.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/params.py
diff --git a/taskvine/src/graph/dagvine/graph_definition.py b/taskvine/src/graph/dagvine/graph_definition.py
deleted file mode 100644
index 0b22fa4e7e..0000000000
--- a/taskvine/src/graph/dagvine/graph_definition.py
+++ /dev/null
@@ -1,340 +0,0 @@
-# Copyright (C) 2025 The University of Notre Dame
-# This software is distributed under the GNU General Public License.
-# See the file COPYING for details.
-
-from ndcctools.taskvine.utils import load_variable_from_library
-
-import os
-import hashlib
-import time
-import cloudpickle
-import collections
-import uuid
-import random
-from collections import deque
-
-try:
-    import dask
-except ImportError:
-    dask = None
-
-try:
-    import dask._task_spec as dts
-except ImportError:
-    dts = None
-
-
-def hash_name(*args):
-    out_str = ""
-    for arg in args:
-        out_str += str(arg)
-    return hashlib.sha256(out_str.encode('utf-8')).hexdigest()[:32]
-
-
-def hashable(s):
-    try:
-        hash(s)
-        return True
-    except TypeError:
-        return False
-
-
-def dist_func(mode, low, high):
-    if not mode:
-        return 0
-
-    assert mode in ["uniform", "normal", "lognormal", "pareto", "mix"]
-
-    # uniform distribution, flat spread
-    def uniform_dist():
-        return random.uniform(low, high)
-
-    # normal distribution, centered in the middle
-    def normal_dist():
-        mu, sigma = (low + high) / 2, (high - low) / 6
-        return min(max(random.gauss(mu, sigma), low), high)
-
-    # lognormal distribution, long tail
-    def lognormal_dist():
-        val = random.lognormvariate(0, 1)
-        val = val / (1 + val)
-        return low + (high - low) * val
-
-    # pareto distribution, very heavy tail
-    def pareto_dist(alpha=2.0):
-        val = random.paretovariate(alpha)
-        val = val / (1 + val)
-        return low + (high - low) * val
-
-    # mixture: most small values, few large ones
-    def mix_dist():
-        if random.random() < 0.9:
-            return random.uniform(low, (low + high) / 2)
-        else:
-            return random.uniform((low + high) / 2, high)
-
-    return {
-        "uniform": uniform_dist,
-        "normal": normal_dist,
-        "lognormal": lognormal_dist,
-        "pareto": pareto_dist,
-        "mix": mix_dist,
-    }[mode]()
-
-
-class GraphKeyResult:
-    # extra_size_mb is used to allocate more space for this object in testing mode to evaluate storage consumption
-    # and peer transfer performance across all workers.
-    def __init__(self, result, extra_size_mb=None):
-        self.result = result
-        self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
-
-
-class TaskGraph:
-    def __init__(self, task_dict,
-                 shared_file_system_dir=None,
-                 extra_task_output_size_mb=["uniform", 0, 0],
-                 extra_task_sleep_time=["uniform", 0, 0]):
-        self.task_dict = task_dict
-        self.shared_file_system_dir = shared_file_system_dir
-
-        if self.shared_file_system_dir:
-            os.makedirs(self.shared_file_system_dir, exist_ok=True)
-
-        if dts:
-            for k, v in self.task_dict.items():
-                if isinstance(v, dts.GraphNode):
-                    assert isinstance(v, (dts.Alias, dts.Task, dts.DataNode)), f"Unsupported task type for key {k}: {v.__class__}"
-
-        self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
-        self.depth_of = self._calculate_depths()
-
-        self.vine_key_of = {k: hash_name(k) for k in task_dict.keys()}
-        self.key_of_vine_key = {hash_name(k): k for k in task_dict.keys()}
-
-        self.outfile_remote_name = {key: f"{uuid.uuid4()}.pkl" for key in self.task_dict.keys()}
-        self.outfile_type = {key: None for key in self.task_dict.keys()}
-
-        # testing params
-        self.extra_task_output_size_mb = self._calculate_extra_size_mb_of(extra_task_output_size_mb)
-        self.extra_sleep_time_of = self._calculate_extra_sleep_time_of(extra_task_sleep_time)
-
-    def set_outfile_type_of(self, k, outfile_type_str):
-        assert outfile_type_str in ["local", "shared-file-system", "temp"]
-        self.outfile_type[k] = outfile_type_str
-        if outfile_type_str == "shared-file-system":
-            self.outfile_remote_name[k] = os.path.join(self.shared_file_system_dir, self.outfile_remote_name[k])
-
-    def _calculate_extra_size_mb_of(self, extra_task_output_size_mb):
-        assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 3
-        mode, low, high = extra_task_output_size_mb
-        low, high = int(low), int(high)
-        assert low <= high
-
-        max_depth = max(depth for depth in self.depth_of.values())
-        extra_size_mb_of = {}
-        for k in self.task_dict.keys():
-            if self.depth_of[k] == max_depth or self.depth_of[k] == max_depth - 1:
-                extra_size_mb_of[k] = 0
-                continue
-            extra_size_mb_of[k] = dist_func(mode, low, high)
-
-        return extra_size_mb_of
-
-    def _calculate_extra_sleep_time_of(self, extra_task_sleep_time):
-        assert isinstance(extra_task_sleep_time, list) and len(extra_task_sleep_time) == 3
-        mode, low, high = extra_task_sleep_time
-        low, high = int(low), int(high)
-        assert low <= high
-
-        extra_sleep_time_of = {}
-        for k in self.task_dict.keys():
-            extra_sleep_time_of[k] = dist_func(mode, low, high)
-
-        return extra_sleep_time_of
-
-    def _calculate_depths(self):
-        depth_of = {key: 0 for key in self.task_dict.keys()}
-
-        topo_order = self.get_topological_order()
-        for key in topo_order:
-            if self.parents_of[key]:
-                depth_of[key] = max(depth_of[parent] for parent in self.parents_of[key]) + 1
-            else:
-                depth_of[key] = 0
-
-        return depth_of
-
-    def set_outfile_remote_name_of(self, key, outfile_remote_name):
-        self.outfile_remote_name[key] = outfile_remote_name
-
-    def is_dts_key(self, k):
-        if not hasattr(dask, "_task_spec"):
-            return False
-        import dask._task_spec as dts
-        return isinstance(self.task_dict[k], (dts.Task, dts.TaskRef, dts.Alias, dts.DataNode, dts.NestedContainer))
-
-    def _build_dependencies(self, task_dict):
-        def _find_sexpr_parents(sexpr):
-            if hashable(sexpr) and sexpr in task_dict.keys():
-                return {sexpr}
-            elif isinstance(sexpr, (list, tuple)):
-                deps = set()
-                for x in sexpr:
-                    deps |= _find_sexpr_parents(x)
-                return deps
-            elif isinstance(sexpr, dict):
-                deps = set()
-                for k, v in sexpr.items():
-                    deps |= _find_sexpr_parents(k)
-                    deps |= _find_sexpr_parents(v)
-                return deps
-            else:
-                return set()
-
-        parents_of = collections.defaultdict(set)
-        children_of = collections.defaultdict(set)
-
-        for k, value in task_dict.items():
-            if self.is_dts_key(k):
-                # in the new Dask expression, each value is an object from dask._task_spec, could be
-                # a Task, Alias, TaskRef, etc., but they all share the same base class the dependencies
-                # field is of type frozenset(), without recursive ancestor dependencies involved
-                parents_of[k] = value.dependencies
-            else:
-                # the value could be a sexpr, e.g., the old Dask representation
-                parents_of[k] = _find_sexpr_parents(value)
-
-        for k, deps in parents_of.items():
-            for dep in deps:
-                children_of[dep].add(k)
-
-        return parents_of, children_of
-
-    def save_result_of_key(self, key, result):
-        with open(self.outfile_remote_name[key], "wb") as f:
-            result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
-            cloudpickle.dump(result_obj, f)
-
-    def load_result_of_key(self, key, target_results_dir=None):
-        if self.outfile_type[key] == "local":
-            # nodes with local outfile type will have their results stored in the target results directory
-            # when the execution is done, users can call this function to load the results from the target results directory
-            # note that data is transferred through the link in sequence, not in parallel through the shared file system
-            outfile_path = os.path.join(target_results_dir, self.outfile_remote_name[key])
-        else:
-            # workers user this branch to load results from either local or shared file system
-            # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
-            # if a shared file system output, then remote name is the full path to the file
-            outfile_path = self.outfile_remote_name[key]
-        try:
-            with open(outfile_path, "rb") as f:
-                result_obj = cloudpickle.load(f)
-                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
-                return result_obj.result
-        except FileNotFoundError:
-            raise FileNotFoundError(f"Output file for key {key} not found at {outfile_path}")
-
-    def get_topological_order(self):
-        in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
-        queue = deque([key for key, degree in in_degree.items() if degree == 0])
-        topo_order = []
-
-        while queue:
-            current = queue.popleft()
-            topo_order.append(current)
-
-            for child in self.children_of[current]:
-                in_degree[child] -= 1
-                if in_degree[child] == 0:
-                    queue.append(child)
-
-        if len(topo_order) != len(self.task_dict):
-            print(f"len(topo_order): {len(topo_order)}")
-            print(f"len(self.task_dict): {len(self.task_dict)}")
-            raise ValueError("Failed to create topo order, the dependencies may be cyclic or problematic")
-
-        return topo_order
-
-    def __del__(self):
-        if hasattr(self, 'outfile_remote_name') and self.outfile_remote_name:
-            for k in self.outfile_remote_name.keys():
-                if self.outfile_type.get(k) == "shared-file-system" and os.path.exists(self.outfile_remote_name[k]):
-                    os.remove(self.outfile_remote_name[k])
-
-
-def task_graph_loader(task_graph_pkl):
-    task_graph = cloudpickle.loads(task_graph_pkl)
-
-    if not isinstance(task_graph, TaskGraph):
-        raise TypeError("Task graph is not of type TaskGraph")
-
-    return {
-        "task_graph": task_graph,
-    }
-
-
-def compute_dts_key(task_graph, k, v):
-    try:
-        import dask._task_spec as dts
-    except ImportError:
-        raise ImportError("Dask is not installed")
-
-    input_dict = {dep: task_graph.load_result_of_key(dep) for dep in v.dependencies}
-
-    try:
-        if isinstance(v, dts.Alias):
-            assert len(v.dependencies) == 1, "Expected exactly one dependency"
-            return task_graph.load_result_of_key(next(iter(v.dependencies)))
-        elif isinstance(v, dts.Task):
-            return v(input_dict)
-        elif isinstance(v, dts.DataNode):
-            return v.value
-        else:
-            raise TypeError(f"unexpected node type: {type(v)} for key {k}")
-    except Exception as e:
-        raise Exception(f"Error while executing task {k}: {e}")
-
-
-def compute_sexpr_key(task_graph, k, v):
-    input_dict = {parent: task_graph.load_result_of_key(parent) for parent in task_graph.parents_of[k]}
-
-    def _rec_call(expr):
-        try:
-            if expr in input_dict.keys():
-                return input_dict[expr]
-        except TypeError:
-            pass
-        if isinstance(expr, list):
-            return [_rec_call(e) for e in expr]
-        if isinstance(expr, tuple) and len(expr) > 0 and callable(expr[0]):
-            res = expr[0](*[_rec_call(a) for a in expr[1:]])
-            return res
-        return expr
-
-    try:
-        return _rec_call(v)
-    except Exception as e:
-        raise Exception(f"Failed to invoke _rec_call(): {e}")
-
-
-def compute_single_key(vine_key):
-    task_graph = load_variable_from_library('task_graph')
-
-    k = task_graph.key_of_vine_key[vine_key]
-    v = task_graph.task_dict[k]
-
-    if task_graph.is_dts_key(k):
-        result = compute_dts_key(task_graph, k, v)
-    else:
-        result = compute_sexpr_key(task_graph, k, v)
-
-    task_graph.save_result_of_key(k, result)
-    if not os.path.exists(task_graph.outfile_remote_name[k]):
-        raise Exception(f"Output file {task_graph.outfile_remote_name[k]} does not exist after writing")
-    if os.stat(task_graph.outfile_remote_name[k]).st_size == 0:
-        raise Exception(f"Output file {task_graph.outfile_remote_name[k]} is empty after writing")
-
-    time.sleep(task_graph.extra_sleep_time_of[k])
-
-    return True
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index 733fe845f8..d9846463fb 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -5,7 +5,7 @@
 from ndcctools.taskvine.utils import delete_all_files, get_c_constant
 
 from ndcctools.taskvine.dagvine.library import Library
-from ndcctools.taskvine.dagvine.graph_definition import TaskGraph, task_graph_loader
+from ndcctools.taskvine.dagvine.runtime_execution_graph import RuntimeExecutionGraph
 
 import cloudpickle
 import os
@@ -166,14 +166,14 @@ def tune_vine_task_graph(self, c_graph):
             print(f"Tuning {k} to {v}")
             cdagvine.vine_task_graph_tune(c_graph, k, str(v))
 
-    def assign_outfile_types(self, target_keys, py_graph, c_graph):
-        assert py_graph is not None, "Python graph must be built first"
+    def assign_outfile_types(self, target_keys, reg, c_graph):
+        assert reg is not None, "Python graph must be built first"
         assert c_graph is not None, "C graph must be built first"
 
         # get heavy score from C side
         heavy_scores = {}
-        for k in py_graph.task_dict.keys():
-            heavy_scores[k] = cdagvine.vine_task_graph_get_node_heavy_score(c_graph, py_graph.vine_key_of[k])
+        for k in reg.task_dict.keys():
+            heavy_scores[k] = cdagvine.vine_task_graph_get_node_heavy_score(c_graph, reg.vine_key_of[k])
 
         # sort keys by heavy score descending
         sorted_keys = sorted(heavy_scores, key=lambda k: heavy_scores[k], reverse=True)
@@ -190,27 +190,27 @@ def assign_outfile_types(self, target_keys, py_graph, c_graph):
             else:
                 choice = "temp"
 
-            py_graph.set_outfile_type_of(k, choice)
+            reg.set_outfile_type_of(k, choice)
             outfile_type_enum = get_c_constant(f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}")
             cdagvine.vine_task_graph_set_node_outfile(
                 c_graph,
-                py_graph.vine_key_of[k],
+                reg.vine_key_of[k],
                 outfile_type_enum,
-                py_graph.outfile_remote_name[k]
+                reg.outfile_remote_name[k]
             )
 
     def build_python_graph(self):
-        py_graph = TaskGraph(
+        reg = RuntimeExecutionGraph(
             self.task_dict,
             shared_file_system_dir=self.param("shared-file-system-dir"),
             extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
             extra_task_sleep_time=self.param("extra-task-sleep-time")
         )
 
-        return py_graph
+        return reg
 
-    def build_c_graph(self, py_graph):
-        assert py_graph is not None, "Python graph must be built before building the C graph"
+    def build_c_graph(self, reg):
+        assert reg is not None, "Python graph must be built before building the C graph"
 
         c_graph = cdagvine.vine_task_graph_create(self._taskvine)
 
@@ -218,14 +218,14 @@ def build_c_graph(self, py_graph):
         self.tune_vine_manager()
         self.tune_vine_task_graph(c_graph)
 
-        topo_order = py_graph.get_topological_order()
+        topo_order = reg.get_topological_order()
         for k in topo_order:
             cdagvine.vine_task_graph_add_node(
                 c_graph,
-                py_graph.vine_key_of[k],
+                reg.vine_key_of[k],
             )
-            for pk in py_graph.parents_of[k]:
-                cdagvine.vine_task_graph_add_dependency(c_graph, py_graph.vine_key_of[pk], py_graph.vine_key_of[k])
+            for pk in reg.parents_of[k]:
+                cdagvine.vine_task_graph_add_dependency(c_graph, reg.vine_key_of[pk], reg.vine_key_of[k])
 
         cdagvine.vine_task_graph_compute_topology_metrics(c_graph)
 
@@ -233,15 +233,15 @@ def build_c_graph(self, py_graph):
 
     def build_graphs(self, target_keys):
         # build Python DAG (logical topology)
-        py_graph = self.build_python_graph()
+        reg = self.build_python_graph()
 
         # build C DAG (physical topology)
-        c_graph = self.build_c_graph(py_graph)
+        c_graph = self.build_c_graph(reg)
 
         # assign outfile types
-        self.assign_outfile_types(target_keys, py_graph, c_graph)
+        self.assign_outfile_types(target_keys, reg, c_graph)
 
-        return py_graph, c_graph
+        return reg, c_graph
 
     def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[], env_files={}):
         # first update the params so that they can be used for the following construction
@@ -250,13 +250,13 @@ def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[],
         self.task_dict = ensure_task_dict(collection_dict)
         
         # build graphs in both Python and C sides
-        py_graph, c_graph = self.build_graphs(target_keys)
+        reg, c_graph = self.build_graphs(target_keys)
 
         # create and install the library template on the manager
         library = Library(self, self.param("proxy-library-name"), self.param("libcores"))
         library.add_hoisting_modules(hoisting_modules)
         library.add_env_files(env_files)
-        library.set_context_loader(task_graph_loader, context_loader_args=[cloudpickle.dumps(py_graph)])
+        library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
         library.install()
 
         # execute the graph on the C side
@@ -271,7 +271,7 @@ def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[],
         # load results of target keys
         results = {}
         for k in target_keys:
-            results[k] = py_graph.load_result_of_key(k, target_results_dir=self.param("target-results-dir"))
+            results[k] = reg.load_result_of_key(k, target_results_dir=self.param("target-results-dir"))
         return results
 
     def _on_sigint(self, signum, frame):
diff --git a/taskvine/src/graph/dagvine/library.py b/taskvine/src/graph/dagvine/library.py
index 3e4a431483..cd8f7d498e 100644
--- a/taskvine/src/graph/dagvine/library.py
+++ b/taskvine/src/graph/dagvine/library.py
@@ -1,8 +1,8 @@
 import os, uuid, cloudpickle, types, time, random, hashlib, collections
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.dagvine import cdagvine
-from ndcctools.taskvine.graph_definition import (
-    GraphKeyResult, TaskGraph, compute_dts_key, compute_sexpr_key, 
+from ndcctools.taskvine.dagvine.runtime_execution_graph import (
+    GraphKeyResult, RuntimeExecutionGraph, compute_dts_key, compute_sexpr_key, 
     compute_single_key, hash_name, hashable
 )
 from ndcctools.taskvine.utils import load_variable_from_library
@@ -22,7 +22,7 @@ def __init__(self, py_manager, libname, libcores):
         # these modules are always included in the preamble of the library task, so that function calls can execute directly
         # using the loaded context without importing them over and over again
         self.hoisting_modules = [
-            os, cloudpickle, GraphKeyResult, TaskGraph, uuid, hashlib, random, types, collections, time,
+            os, cloudpickle, GraphKeyResult, RuntimeExecutionGraph, uuid, hashlib, random, types, collections, time,
             load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
         ]
 

From 767988fdb9e9ab3d19d157b2187d60146dcc7d46 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 18 Oct 2025 15:43:30 -0400
Subject: [PATCH 044/113] sog && reg

---
 .../python3/ndcctools/taskvine/utils.py       |   3 +-
 taskvine/src/graph/dagvine/Makefile           |  10 +-
 taskvine/src/graph/dagvine/graph_executor.py  |  62 +-
 taskvine/src/graph/dagvine/library.py         |  10 +-
 taskvine/src/graph/dagvine/vine_task_graph.c  | 982 ------------------
 taskvine/src/graph/dagvine/vine_task_graph.h  | 126 ---
 taskvine/src/graph/dagvine/vine_task_graph.i  |  21 -
 7 files changed, 42 insertions(+), 1172 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/vine_task_graph.c
 delete mode 100644 taskvine/src/graph/dagvine/vine_task_graph.h
 delete mode 100644 taskvine/src/graph/dagvine/vine_task_graph.i

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index bd909b664b..e493e7c04a 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -4,8 +4,7 @@
 
 from . import cvine
 try:
-    # cdagvine contains DAG-specific enums (e.g., VINE_TASK_GRAPH_PRIORITY_MODE_*)
-    from .dagvine import cdagvine  # type: ignore
+    from .dagvine import cdagvine
 except Exception:
     cdagvine = None
 
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index 018a48a227..4286e36cad 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -6,15 +6,15 @@ LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 
  
 
-SOURCES = vine_task_node.c vine_task_graph.c
+SOURCES = vine_task_node.c strategic_orchestration_graph.c
 OBJECTS = $(SOURCES:%.c=%.o)
 
-SWIG_I = vine_task_graph.i
+SWIG_I = strategic_orchestration_graph.i
 
 # put SWIG generated sources and Python extension artifacts into build/ directory
 BUILD_DIR := build
-SWIG_WRAP = $(BUILD_DIR)/vine_task_graph_wrap.c
-WRAP_OBJ = $(BUILD_DIR)/vine_task_graph_wrap.o
+SWIG_WRAP = $(BUILD_DIR)/strategic_orchestration_graph_wrap.c
+WRAP_OBJ = $(BUILD_DIR)/strategic_orchestration_graph_wrap.o
 PYMODULE = $(BUILD_DIR)/_cdagvine.$(CCTOOLS_DYNAMIC_SUFFIX)
 
 LIBRARIES =
@@ -33,7 +33,7 @@ $(PROGRAMS): $(EXTERNALS)
 $(BUILD_DIR):
 	mkdir -p $(BUILD_DIR)
 
-$(SWIG_WRAP): $(SWIG_I) vine_task_graph.h | $(BUILD_DIR)
+$(SWIG_WRAP): $(SWIG_I) strategic_orchestration_graph.h | $(BUILD_DIR)
 	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -outdir $(BUILD_DIR) -o $@ $<
 
 # Build Python module
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index d9846463fb..0554074c4f 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -73,10 +73,9 @@ def __init__(self):
             "enforce-worker-eviction-interval": -1,
             "balance-worker-disk-load": 0,
         }
-        self.vine_task_graph_tuning_params = {
+        self.sog_tuning_params = {
             "failure-injection-step-percent": -1,
-            "task-priority-mode": "largest-input-first",
-            "proxy-library-name": "vine_task_graph_library",
+            "priority-mode": "largest-input-first",
             "proxy-function-name": "compute_single_key",
             "prune-depth": 1,
             "target-results-dir": "./target_results",
@@ -97,8 +96,8 @@ def __init__(self):
     def update_param(self, param_name, new_value):
         if param_name in self.vine_manager_tuning_params:
             self.vine_manager_tuning_params[param_name] = new_value
-        elif param_name in self.vine_task_graph_tuning_params:
-            self.vine_task_graph_tuning_params[param_name] = new_value
+        elif param_name in self.sog_tuning_params:
+            self.sog_tuning_params[param_name] = new_value
         elif param_name in self.other_params:
             self.other_params[param_name] = new_value
         else:
@@ -107,8 +106,8 @@ def update_param(self, param_name, new_value):
     def get_value_of(self, param_name):
         if param_name in self.vine_manager_tuning_params:
             return self.vine_manager_tuning_params[param_name]
-        elif param_name in self.vine_task_graph_tuning_params:
-            return self.vine_task_graph_tuning_params[param_name]
+        elif param_name in self.sog_tuning_params:
+            return self.sog_tuning_params[param_name]
         elif param_name in self.other_params:
             return self.other_params[param_name]
         else:
@@ -161,19 +160,19 @@ def tune_vine_manager(self):
             print(f"Tuning {k} to {v}")
             self.tune(k, v)
 
-    def tune_vine_task_graph(self, c_graph):
-        for k, v in self.params.vine_task_graph_tuning_params.items():
+    def tune_sog(self, sog):
+        for k, v in self.params.sog_tuning_params.items():
             print(f"Tuning {k} to {v}")
-            cdagvine.vine_task_graph_tune(c_graph, k, str(v))
+            cdagvine.sog_tune(sog, k, str(v))
 
-    def assign_outfile_types(self, target_keys, reg, c_graph):
-        assert reg is not None, "Python graph must be built first"
-        assert c_graph is not None, "C graph must be built first"
+    def assign_outfile_types(self, target_keys, reg, sog):
+        assert reg is not None, "Runtime execution graph must be built first"
+        assert sog is not None, "Strategic orchestration graph must be built first"
 
         # get heavy score from C side
         heavy_scores = {}
         for k in reg.task_dict.keys():
-            heavy_scores[k] = cdagvine.vine_task_graph_get_node_heavy_score(c_graph, reg.vine_key_of[k])
+            heavy_scores[k] = cdagvine.sog_get_node_heavy_score(sog, reg.vine_key_of[k])
 
         # sort keys by heavy score descending
         sorted_keys = sorted(heavy_scores, key=lambda k: heavy_scores[k], reverse=True)
@@ -192,8 +191,8 @@ def assign_outfile_types(self, target_keys, reg, c_graph):
 
             reg.set_outfile_type_of(k, choice)
             outfile_type_enum = get_c_constant(f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}")
-            cdagvine.vine_task_graph_set_node_outfile(
-                c_graph,
+            cdagvine.sog_set_node_outfile(
+                sog,
                 reg.vine_key_of[k],
                 outfile_type_enum,
                 reg.outfile_remote_name[k]
@@ -209,39 +208,39 @@ def build_python_graph(self):
 
         return reg
 
-    def build_c_graph(self, reg):
+    def build_sog(self, reg):
         assert reg is not None, "Python graph must be built before building the C graph"
 
-        c_graph = cdagvine.vine_task_graph_create(self._taskvine)
+        sog = cdagvine.sog_create(self._taskvine)
 
         # C side vine task graph must be tuned before adding nodes and dependencies
         self.tune_vine_manager()
-        self.tune_vine_task_graph(c_graph)
+        self.tune_sog(sog)
 
         topo_order = reg.get_topological_order()
         for k in topo_order:
-            cdagvine.vine_task_graph_add_node(
-                c_graph,
+            cdagvine.sog_add_node(
+                sog,
                 reg.vine_key_of[k],
             )
             for pk in reg.parents_of[k]:
-                cdagvine.vine_task_graph_add_dependency(c_graph, reg.vine_key_of[pk], reg.vine_key_of[k])
+                cdagvine.sog_add_dependency(sog, reg.vine_key_of[pk], reg.vine_key_of[k])
 
-        cdagvine.vine_task_graph_compute_topology_metrics(c_graph)
+        cdagvine.sog_compute_topology_metrics(sog)
 
-        return c_graph
+        return sog
 
     def build_graphs(self, target_keys):
         # build Python DAG (logical topology)
         reg = self.build_python_graph()
 
         # build C DAG (physical topology)
-        c_graph = self.build_c_graph(reg)
+        sog = self.build_sog(reg)
 
         # assign outfile types
-        self.assign_outfile_types(target_keys, reg, c_graph)
+        self.assign_outfile_types(target_keys, reg, sog)
 
-        return reg, c_graph
+        return reg, sog
 
     def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[], env_files={}):
         # first update the params so that they can be used for the following construction
@@ -250,23 +249,24 @@ def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[],
         self.task_dict = ensure_task_dict(collection_dict)
         
         # build graphs in both Python and C sides
-        reg, c_graph = self.build_graphs(target_keys)
+        reg, sog = self.build_graphs(target_keys)
 
         # create and install the library template on the manager
-        library = Library(self, self.param("proxy-library-name"), self.param("libcores"))
+        library = Library(self, self.param("libcores"))
         library.add_hoisting_modules(hoisting_modules)
         library.add_env_files(env_files)
         library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
         library.install()
+        cdagvine.sog_set_proxy_library_name(sog, library.get_name())
 
         # execute the graph on the C side
         print(f"Executing task graph, logs will be written to {self.runtime_directory}")
-        cdagvine.vine_task_graph_execute(c_graph)
+        cdagvine.sog_execute(sog)
 
         # clean up the library instances and template on the manager
         library.uninstall()
         # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
-        cdagvine.vine_task_graph_delete(c_graph)
+        cdagvine.sog_delete(sog)
 
         # load results of target keys
         results = {}
diff --git a/taskvine/src/graph/dagvine/library.py b/taskvine/src/graph/dagvine/library.py
index cd8f7d498e..f5158d6656 100644
--- a/taskvine/src/graph/dagvine/library.py
+++ b/taskvine/src/graph/dagvine/library.py
@@ -1,6 +1,4 @@
 import os, uuid, cloudpickle, types, time, random, hashlib, collections
-from ndcctools.taskvine import cvine
-from ndcctools.taskvine.dagvine import cdagvine
 from ndcctools.taskvine.dagvine.runtime_execution_graph import (
     GraphKeyResult, RuntimeExecutionGraph, compute_dts_key, compute_sexpr_key, 
     compute_single_key, hash_name, hashable
@@ -9,10 +7,9 @@
 
 
 class Library:
-    def __init__(self, py_manager, libname, libcores):
+    def __init__(self, py_manager, libcores):
         self.py_manager = py_manager
-        self.libname = libname
-        assert self.libname is not None, "libname must be provided"
+        self.libname = f"proxy-library-{str(uuid.uuid4())}"
 
         self.libcores = libcores
         assert self.libcores is not None, "libcores must be provided"
@@ -38,6 +35,9 @@ def __init__(self, py_manager, libname, libcores):
         self.local_path = None
         self.remote_path = None
 
+    def get_name(self):
+        return self.libname
+
     def add_hoisting_modules(self, new_modules):
         assert isinstance(new_modules, list), "new_modules must be a list of modules"
         self.hoisting_modules.extend(new_modules)
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.c b/taskvine/src/graph/dagvine/vine_task_graph.c
deleted file mode 100644
index 5e376812b7..0000000000
--- a/taskvine/src/graph/dagvine/vine_task_graph.c
+++ /dev/null
@@ -1,982 +0,0 @@
-#include <stdlib.h>
-#include <string.h>
-#include <stdint.h>
-#include <assert.h>
-#include <math.h>
-#include <signal.h>
-#include <errno.h>
-#include <stdio.h>
-#include <sys/stat.h>
-
-#include "priority_queue.h"
-#include "list.h"
-#include "debug.h"
-#include "itable.h"
-#include "xxmalloc.h"
-#include "stringtools.h"
-#include "random.h"
-#include "hash_table.h"
-#include "set.h"
-#include "timestamp.h"
-#include "progress_bar.h"
-#include "macros.h"
-
-#include "vine_task_graph.h"
-#include "vine_manager.h"
-#include "vine_task_node.h"
-#include "vine_worker_info.h"
-#include "vine_task.h"
-#include "vine_file.h"
-#include "vine_mount.h"
-#include "taskvine.h"
-
-
-static volatile sig_atomic_t interrupted = 0;
-
-/*************************************************************/
-/* Private Functions */
-/*************************************************************/
-
-/**
- * Handle the SIGINT signal.
- * @param signal Reference to the signal.
- */
-static void handle_sigint(int signal)
-{
-	interrupted = 1;
-}
-
-/**
- * Calculate the priority of a node given the priority mode.
- * @param node Reference to the node object.
- * @param priority_mode Reference to the priority mode.
- * @return The priority.
- */
-static double vine_task_node_calculate_priority(struct vine_task_node *node, vine_task_graph_priority_mode_t priority_mode)
-{
-	if (!node) {
-		return 0;
-	}
-
-	double priority = 0;
-	timestamp_t current_time = timestamp_get();
-
-	struct vine_task_node *parent_node;
-
-	switch (priority_mode) {
-	case VINE_TASK_GRAPH_PRIORITY_MODE_RANDOM:
-		priority = random_double();
-		break;
-	case VINE_TASK_GRAPH_PRIORITY_MODE_DEPTH_FIRST:
-		priority = (double)node->depth;
-		break;
-	case VINE_TASK_GRAPH_PRIORITY_MODE_BREADTH_FIRST:
-		priority = -(double)node->depth;
-		break;
-	case VINE_TASK_GRAPH_PRIORITY_MODE_FIFO:
-		priority = -(double)current_time;
-		break;
-	case VINE_TASK_GRAPH_PRIORITY_MODE_LIFO:
-		priority = (double)current_time;
-		break;
-	case VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST:
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (!parent_node->outfile) {
-				continue;
-			}
-			priority += (double)vine_file_size(parent_node->outfile);
-		}
-		break;
-	case VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (!parent_node->outfile) {
-				continue;
-			}
-			timestamp_t parent_task_completion_time = parent_node->task->time_workers_execute_last;
-			priority += (double)vine_file_size(parent_node->outfile) * (double)parent_task_completion_time;
-		}
-		break;
-	}
-
-	return priority;
-}
-
-/**
- * Submit a node to the taskvine manager.
- * @param tg Reference to the task graph object.
- * @param node Reference to the node object.
- */
-static void submit_node_task(struct vine_task_graph *tg, struct vine_task_node *node)
-{
-	if (!tg || !node) {
-		return;
-	}
-
-	/* calculate the priority of the node */
-	double priority = vine_task_node_calculate_priority(node, tg->task_priority_mode);
-	vine_task_set_priority(node->task, priority);
-	/* submit the task to the manager */
-	int task_id = vine_submit(node->manager, node->task);
-	/* insert the task id to the task id to node map */
-	itable_insert(tg->task_id_to_node, task_id, node);
-
-	return;
-}
-
-/**
- * Submit the children of a node if all its dependencies are resolved.
- * @param tg Reference to the task graph object.
- * @param node Reference to the node object.
- */
-static void submit_unblocked_children(struct vine_task_graph *tg, struct vine_task_node *node)
-{
-	if (!tg || !node) {
-		return;
-	}
-
-	struct vine_task_node *child_node; 
-	LIST_ITERATE(node->children, child_node)
-	{
-		/* Remove this parent from the child's pending set if it exists */
-		if (child_node->pending_parents) {
-			/* Assert that this parent is indeed pending for the child */
-			if (child_node->pending_parents && set_lookup(child_node->pending_parents, node)) {
-				set_remove(child_node->pending_parents, node);
-			} else {
-				debug(D_ERROR, "inconsistent pending set: child=%s missing parent=%s", child_node->node_key, node->node_key);
-			}
-		}
-
-		/* If no more parents are pending, submit the child */
-		if (!child_node->pending_parents || set_size(child_node->pending_parents) == 0) {
-			submit_node_task(tg, child_node);
-		}
-	}
-
-	return;
-}
-
-/**
- * Get the topological order of the task graph.
- * Must be called after all nodes and dependencies are added and the topology metrics are computed.
- * @param tg Reference to the task graph object.
- * @return The list of nodes in topological order.
- */
-static struct list *get_topological_order(struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return NULL;
-	}
-
-	int total_nodes = hash_table_size(tg->nodes);
-	struct list *topo_order = list_create();
-	struct hash_table *in_degree_map = hash_table_create(0, 0);
-	struct priority_queue *pq = priority_queue_create(total_nodes);
-
-	char *key;
-	struct vine_task_node *node;
-	HASH_TABLE_ITERATE(tg->nodes, key, node)
-	{
-		int deg = list_size(node->parents);
-		hash_table_insert(in_degree_map, key, (void *)(intptr_t)deg);
-		if (deg == 0) {
-			priority_queue_push(pq, node, compute_lex_priority(node->node_key));
-		}
-	}
-
-	while (priority_queue_size(pq) > 0) {
-		struct vine_task_node *current = priority_queue_pop(pq);
-		list_push_tail(topo_order, current);
-
-		struct vine_task_node *child;
-		LIST_ITERATE(current->children, child)
-		{
-			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, child->node_key);
-			int deg = (int)raw_deg - 1;
-
-			hash_table_remove(in_degree_map, child->node_key);
-			hash_table_insert(in_degree_map, child->node_key, (void *)(intptr_t)deg);
-
-			if (deg == 0) {
-				priority_queue_push(pq, child, compute_lex_priority(child->node_key));
-			}
-		}
-	}
-
-	if (list_size(topo_order) != total_nodes) {
-		debug(D_ERROR, "Error: task graph contains cycles or is malformed.\n");
-		debug(D_ERROR, "Expected %d nodes, but only sorted %d.\n", total_nodes, list_size(topo_order));
-
-		HASH_TABLE_ITERATE(tg->nodes, key, node)
-		{
-			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, key);
-			int deg = (int)raw_deg;
-			if (deg > 0) {
-				debug(D_ERROR, "  Node %s has in-degree %d. Parents:\n", key, deg);
-				struct vine_task_node *p;
-				LIST_ITERATE(node->parents, p)
-				{
-					debug(D_ERROR, "    -> %s\n", p->node_key);
-				}
-			}
-		}
-
-		list_delete(topo_order);
-		hash_table_delete(in_degree_map);
-		priority_queue_delete(pq);
-		exit(1);
-	}
-
-	hash_table_delete(in_degree_map);
-	priority_queue_delete(pq);
-	return topo_order;
-}
-
-/**
- * Extract the weakly connected components of the task graph.
- * This function is used only for debugging purposes at the moment.
- * @param tg Reference to the task graph object.
- * @return The list of weakly connected components.
- */
-static struct list *extract_weakly_connected_components(struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return NULL;
-	}
-
-	struct set *visited = set_create(0);
-	struct list *components = list_create();
-
-	char *node_key;
-	struct vine_task_node *node;
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		if (set_lookup(visited, node)) {
-			continue;
-		}
-
-		struct list *component = list_create();
-		struct list *queue = list_create();
-
-		list_push_tail(queue, node);
-		set_insert(visited, node);
-		list_push_tail(component, node);
-
-		while (list_size(queue) > 0) {
-			struct vine_task_node *curr = list_pop_head(queue);
-
-			struct vine_task_node *p;
-			LIST_ITERATE(curr->parents, p)
-			{
-				if (!set_lookup(visited, p)) {
-					list_push_tail(queue, p);
-					set_insert(visited, p);
-					list_push_tail(component, p);
-				}
-			}
-
-			struct vine_task_node *c;
-			LIST_ITERATE(curr->children, c)
-			{
-				if (!set_lookup(visited, c)) {
-					list_push_tail(queue, c);
-					set_insert(visited, c);
-					list_push_tail(component, c);
-				}
-			}
-		}
-
-		list_push_tail(components, component);
-		list_delete(queue);
-	}
-
-	set_delete(visited);
-	return components;
-}
-
-/**
- * Compute the heavy score of a node in the task graph.
- * @param node Reference to the node object.
- * @return The heavy score.
- */
-static double compute_node_heavy_score(struct vine_task_node *node)
-{
-	if (!node) {
-		return 0;
-	}
-
-	double up_score = node->depth * node->upstream_subgraph_size * node->fan_in;
-	double down_score = node->height * node->downstream_subgraph_size * node->fan_out;
-
-	return up_score / (down_score + 1);
-}
-
-/**
- * Map a task to a node in the task graph.
- * @param tg Reference to the task graph object.
- * @param task Reference to the task object.
- * @return The node object.
- */
-static struct vine_task_node *get_node_by_task(struct vine_task_graph *tg, struct vine_task *task)
-{
-	if (!tg || !task) {
-		return NULL;
-	}
-
-	if (task->type == VINE_TASK_TYPE_STANDARD) {
-		/* standard tasks are mapped directly to a node */
-		return itable_lookup(tg->task_id_to_node, task->task_id);
-	} else if (task->type == VINE_TASK_TYPE_RECOVERY) {
-		/* note that recovery tasks are not mapped to any node but we still need the original node for pruning,
-		 * so we look up the outfile of the task, then map it back to get the original node */
-		struct vine_mount *mount;
-		LIST_ITERATE(task->output_mounts, mount)
-		{
-			if (mount->file->original_producer_task_id > 0) {
-				return itable_lookup(tg->task_id_to_node, mount->file->original_producer_task_id);
-			}
-		}
-	}
-
-	debug(D_ERROR, "task %d has no original producer task id", task->task_id);
-
-	return NULL;
-}
-
-/*************************************************************/
-/* Public APIs */
-/*************************************************************/
-
-/** Tune the task graph.
- *@param tg Reference to the task graph object.
- *@param name Reference to the name of the parameter to tune.
- *@param value Reference to the value of the parameter to tune.
- *@return 0 on success, -1 on failure.
- */
-int vine_task_graph_tune(struct vine_task_graph *tg, const char *name, const char *value)
-{
-	if (!tg || !name || !value) {
-		return -1;
-	}
-
-	if (strcmp(name, "failure-injection-step-percent") == 0) {
-		tg->failure_injection_step_percent = atof(value);
-
-	} else if (strcmp(name, "task-priority-mode") == 0) {
-		if (strcmp(value, "random") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_RANDOM;
-		} else if (strcmp(value, "depth-first") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_DEPTH_FIRST;
-		} else if (strcmp(value, "breadth-first") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_BREADTH_FIRST;
-		} else if (strcmp(value, "fifo") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_FIFO;
-		} else if (strcmp(value, "lifo") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LIFO;
-		} else if (strcmp(value, "largest-input-first") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST;
-		} else if (strcmp(value, "largest-storage-footprint-first") == 0) {
-			tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST;
-		} else {
-			debug(D_ERROR, "invalid priority mode: %s", value);
-			return -1;
-		}		
-
-	} else if (strcmp(name, "target-results-dir") == 0) {
-		if (tg->target_results_dir) {
-			free(tg->target_results_dir);
-		}
-		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
-			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
-			return -1;
-		}
-		tg->target_results_dir = xxstrdup(value);
-
-	} else if (strcmp(name, "proxy-library-name") == 0) {
-		if (tg->proxy_library_name) {
-			free(tg->proxy_library_name);
-		}
-		tg->proxy_library_name = xxstrdup(value);
-
-	} else if (strcmp(name, "proxy-function-name") == 0) {
-		if (tg->proxy_function_name) {
-			free(tg->proxy_function_name);
-		}
-		tg->proxy_function_name = xxstrdup(value);
-
-	} else if (strcmp(name, "prune-depth") == 0) {
-		tg->prune_depth = atoi(value);
-		
-	} else {
-		debug(D_ERROR, "invalid parameter name: %s", name);
-		return -1;
-
-	}
-
-	return 0;
-}
-
-/**
- * Get the proxy library name (Python-side), shared by all tasks.
- * @param tg Reference to the task graph object.
- * @return The library name.
- */
-const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return NULL;
-	}
-
-	return tg->proxy_library_name;
-}
-
-/**
- * Get the proxy function name (Python-side), shared by all tasks.
- * @param tg Reference to the task graph object.
- * @return The function name.
- */
-const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return NULL;
-	}
-
-	return tg->proxy_function_name;
-}
-
-/**
- * Get the heavy score of a node in the task graph.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @return The heavy score.
- */
-double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key)
-{
-	if (!tg) {
-		return -1;
-	}
-
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		return -1;
-	}
-
-	return node->heavy_score;
-}
-
-/**
- * Get the local outfile source of a node in the task graph, only valid for local output files.
- * The source of a local output file is the path on the local filesystem.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @return The local outfile source.
- */
-const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key)
-{
-	if (!tg || !node_key) {
-		return NULL;
-	}
-
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		debug(D_ERROR, "node %s not found", node_key);
-		exit(1);
-	}
-
-	if (node->outfile_type != VINE_NODE_OUTFILE_TYPE_LOCAL) {
-		debug(D_ERROR, "node %s is not a local output file", node_key);
-		exit(1);
-	}
-
-	return node->outfile->source;
-}
-
-/**
- * Compute the topology metrics of the task graph, including depth, height, upstream and downstream counts,
- * heavy scores, and weakly connected components.
- * @param tg Reference to the task graph object.
- */
-void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return;
-	}
-
-	/* get nodes in topological order */
-	struct list *topo_order = get_topological_order(tg);
-	if (!topo_order) {
-		return;
-	}
-
-	char *node_key;
-	struct vine_task_node *node;
-	struct vine_task_node *parent_node;
-	struct vine_task_node *child_node;
-
-	/* compute the depth of the node */
-	LIST_ITERATE(topo_order, node)
-	{
-		node->depth = 0;
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (node->depth < parent_node->depth + 1) {
-				node->depth = parent_node->depth + 1;
-			}
-		}
-	}
-
-	/* compute the height of the node */
-	LIST_ITERATE_REVERSE(topo_order, node)
-	{
-		node->height = 0;
-		LIST_ITERATE(node->children, child_node)
-		{
-			if (node->height < child_node->height + 1) {
-				node->height = child_node->height + 1;
-			}
-		}
-	}
-
-	/* compute the upstream and downstream counts for each node */
-	struct hash_table *upstream_map = hash_table_create(0, 0);
-	struct hash_table *downstream_map = hash_table_create(0, 0);
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		struct set *upstream = set_create(0);
-		struct set *downstream = set_create(0);
-		hash_table_insert(upstream_map, node_key, upstream);
-		hash_table_insert(downstream_map, node_key, downstream);
-	}
-	LIST_ITERATE(topo_order, node)
-	{
-		struct set *upstream = hash_table_lookup(upstream_map, node->node_key);
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			struct set *parent_upstream = hash_table_lookup(upstream_map, parent_node->node_key);
-			set_union(upstream, parent_upstream);
-			set_insert(upstream, parent_node);
-		}
-	}
-	LIST_ITERATE_REVERSE(topo_order, node)
-	{
-		struct set *downstream = hash_table_lookup(downstream_map, node->node_key);
-		LIST_ITERATE(node->children, child_node)
-		{
-			struct set *child_downstream = hash_table_lookup(downstream_map, child_node->node_key);
-			set_union(downstream, child_downstream);
-			set_insert(downstream, child_node);
-		}
-	}
-	LIST_ITERATE(topo_order, node)
-	{
-		node->upstream_subgraph_size = set_size(hash_table_lookup(upstream_map, node->node_key));
-		node->downstream_subgraph_size = set_size(hash_table_lookup(downstream_map, node->node_key));
-		node->fan_in = list_size(node->parents);
-		node->fan_out = list_size(node->children);
-		set_delete(hash_table_lookup(upstream_map, node->node_key));
-		set_delete(hash_table_lookup(downstream_map, node->node_key));
-	}
-	hash_table_delete(upstream_map);
-	hash_table_delete(downstream_map);
-
-	/* compute the heavy score for each node */
-	LIST_ITERATE(topo_order, node)
-	{
-		node->heavy_score = compute_node_heavy_score(node);
-	}
-
-	/* extract weakly connected components */
-	struct list *weakly_connected_components = extract_weakly_connected_components(tg);
-	struct list *component;
-	int component_index = 0;
-	debug(D_VINE, "graph has %d weakly connected components\n", list_size(weakly_connected_components));
-	LIST_ITERATE(weakly_connected_components, component)
-	{
-		debug(D_VINE, "component %d size: %d\n", component_index, list_size(component));
-		list_delete(component);
-		component_index++;
-	}
-	list_delete(weakly_connected_components);
-
-	list_delete(topo_order);
-
-	return;
-}
-
-/**
- * Create a new node and track it in the task graph.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @return A new node object.
- */
-struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg, const char *node_key)
-{
-	if (!tg || !node_key) {
-		return NULL;
-	}
-
-	/* if the node already exists, skip creating a new one */
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		node = vine_task_node_create(tg->manager,
-				node_key,
-				tg->proxy_library_name,
-				tg->proxy_function_name,
-				tg->target_results_dir,
-				tg->prune_depth);
-
-		if (!node) {
-			debug(D_ERROR, "failed to create node %s", node_key);
-			vine_task_graph_delete(tg);
-			exit(1);
-		}
-
-		hash_table_insert(tg->nodes, node_key, node);
-	}
-
-	return node;
-}
-
-/**
- * Create a new task graph object and bind a manager to it.
- * @param q Reference to the manager object.
- * @return A new task graph object.
- */
-struct vine_task_graph *vine_task_graph_create(struct vine_manager *q)
-{
-	struct vine_task_graph *tg = xxmalloc(sizeof(struct vine_task_graph));
-
-	tg->manager = q;
-	
-	tg->nodes = hash_table_create(0, 0);
-	tg->task_id_to_node = itable_create(0);
-	tg->outfile_cachename_to_node = hash_table_create(0, 0);
-
-	tg->target_results_dir = xxstrdup(tg->manager->runtime_directory);  // default to current working directory
-	tg->proxy_library_name = NULL;
-	tg->proxy_function_name = NULL;
-
-	tg->prune_depth = 1;
-
-	tg->task_priority_mode = VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST;
-	tg->failure_injection_step_percent = -1.0;
-
-	/* enable debug system for C code since it uses a separate debug system instance
-	 * from the Python bindings. Use the same function that the manager uses. */
-	char *debug_tmp = string_format("%s/vine-logs/debug", tg->manager->runtime_directory);
-	vine_enable_debug_log(debug_tmp);
-	free(debug_tmp);
-
-	return tg;
-}
-
-/**
- * Add a dependency between two nodes in the task graph. Note that the input-output file relationship
- * is not handled here, because their file names may have not been determined yet.
- * @param tg Reference to the task graph object.
- * @param parent_key Reference to the parent node key.
- * @param child_key Reference to the child node key.
- */
-void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key)
-{
-	if (!tg || !parent_key || !child_key) {
-		return;
-	}
-
-	struct vine_task_node *parent_node = hash_table_lookup(tg->nodes, parent_key);
-	struct vine_task_node *child_node = hash_table_lookup(tg->nodes, child_key);
-	if (!parent_node) {
-		debug(D_ERROR, "parent node %s not found", parent_key);
-		char *node_key = NULL;
-		struct vine_task_node *node;
-		printf("parent_keys:\n");
-		HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-		{
-			printf("  %s\n", node->node_key);
-		}
-		exit(1);
-	}
-	if (!child_node) {
-		debug(D_ERROR, "child node %s not found", child_key);
-		exit(1);
-	}
-
-	list_push_tail(child_node->parents, parent_node);
-	list_push_tail(parent_node->children, child_node);
-
-	return;
-}
-
-/**
- * Set the outfile of a node in the task graph.
- * This involves declaring the output file and adding it to the task.
- * @param tg Reference to the task graph object.
- * @param node_key Reference to the node key.
- * @param outfile_type Reference to the outfile type.
- * @param outfile_remote_name Reference to the outfile remote name that the task will generate remotely.
- */
-void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
-{
-	if (!tg || !node_key || !outfile_remote_name) {
-		return;
-	}
-
-	struct vine_task_node *node = hash_table_lookup(tg->nodes, node_key);
-	if (!node) {
-		return;
-	}
-
-	vine_task_node_set_outfile(node, outfile_type, outfile_remote_name);
-
-	return;
-}
-
-/**
- * Execute the task graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
- * @param tg Reference to the task graph object.
- */
-void vine_task_graph_execute(struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return;
-	}
-
-	signal(SIGINT, handle_sigint);
-
-	debug(D_VINE, "start executing task graph");
-
-	/* print the info of all nodes */
-	char *node_key;
-	struct vine_task_node *node;
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		vine_task_node_print_info(node);
-	}
-
-	/* enable return recovery tasks */
-	vine_enable_return_recovery_tasks(tg->manager);
-
-	/* create mapping from task_id and outfile cached_name to node */
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		if (node->outfile) {
-			hash_table_insert(tg->outfile_cachename_to_node, node->outfile->cached_name, node);
-		}
-	}
-
-	/* add the parents' outfiles as inputs to the task */
-	struct list *topo_order = get_topological_order(tg);
-	LIST_ITERATE(topo_order, node)
-	{
-		struct vine_task_node *parent_node;
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (parent_node->outfile) {
-				vine_task_add_input(node->task, parent_node->outfile, parent_node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
-			}
-		}
-	}
-
-	/* initialize pending_parents for all nodes */
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		struct vine_task_node *parent_node;
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (node->pending_parents) {
-				/* Use parent_node->node_key to ensure pointer consistency */
-				set_insert(node->pending_parents, parent_node);
-			}
-		}
-	}
-
-	/* enqueue those without dependencies */
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
-			submit_node_task(tg, node);
-		}
-	}
-
-	/* calculate steps to inject failure */
-	double next_failure_threshold = -1.0;
-	if (tg->failure_injection_step_percent > 0) {
-		next_failure_threshold = tg->failure_injection_step_percent / 100.0;
-	}
-
-	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
-	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(tg->nodes));
-	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
-	progress_bar_bind_part(pbar, regular_tasks_part);
-	progress_bar_bind_part(pbar, recovery_tasks_part);
-
-	int wait_timeout = 2;
-
-	while (regular_tasks_part->current < regular_tasks_part->total) {
-		if (interrupted) {
-			break;
-		}
-
-		struct vine_task *task = vine_wait(tg->manager, wait_timeout);
-		progress_bar_set_part_total(pbar, recovery_tasks_part, tg->manager->num_submitted_recovery_tasks);
-		if (task) {
-			/* retrieve all possible tasks */
-			wait_timeout = 0;
-
-			/* get the original node by task id */
-			struct vine_task_node *node = get_node_by_task(tg, task);
-			if (!node) {
-				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
-				exit(1);
-			}
-
-			/* in case of failure, resubmit this task */
-			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
-				if (node->retry_attempts_left <= 0) {
-					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %s has no retries left. Aborting.", task->task_id, node->task->result, node->task->exit_code, node->node_key);
-					vine_task_graph_delete(tg);
-					exit(1);
-				}
-				node->retry_attempts_left--;
-				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %s (remaining=%d)...", task->task_id, node->task->result, node->task->exit_code, node->node_key, node->retry_attempts_left);
-				vine_task_reset(node->task);
-				submit_node_task(tg, node);
-				continue;
-			}
-
-			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
-			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
-				struct stat info;
-				int result = stat(node->outfile_remote_name, &info);
-				if (result < 0) {
-					if (node->retry_attempts_left <= 0) {
-						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %s. Aborting.", task->task_id, node->outfile_remote_name, node->node_key);
-						vine_task_graph_delete(tg);
-						exit(1);
-					}
-					node->retry_attempts_left--;
-					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %s (remaining=%d)...", task->task_id, node->outfile_remote_name, node->node_key, node->retry_attempts_left);
-					vine_task_reset(node->task);
-					submit_node_task(tg, node);
-					continue;
-				}
-				node->outfile_size_bytes = info.st_size;
-				break;
-			}
-			case VINE_NODE_OUTFILE_TYPE_LOCAL:
-			case VINE_NODE_OUTFILE_TYPE_TEMP:
-				node->outfile_size_bytes = node->outfile->size;
-				break;
-			}
-			debug(D_VINE, "Node %s completed with outfile %s size: %zu bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
-
-			/* mark the node as completed */
-			node->completed = 1;
-
-			/* prune nodes on task completion */
-			vine_task_node_prune_ancestors(node);
-
-			/* skip recovery tasks */
-			if (task->type == VINE_TASK_TYPE_RECOVERY) {
-				progress_bar_update_part(pbar, recovery_tasks_part, 1);
-				continue;
-			}
-
-			/* set the start time to the submit time of the first regular task */
-			if (regular_tasks_part->current == 0) {
-				progress_bar_set_start_time(pbar, task->time_when_commit_start);
-			}
-
-			/* update critical time */
-			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
-
-			/* mark this regular task as completed */
-			progress_bar_update_part(pbar, regular_tasks_part, 1);
-
-			/* inject failure */
-			if (tg->failure_injection_step_percent > 0) {
-				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
-				if (progress >= next_failure_threshold && evict_random_worker(tg->manager)) {
-					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
-					next_failure_threshold += tg->failure_injection_step_percent / 100.0;
-				}
-			}
-
-			/* enqueue the output file for replication */
-			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_TEMP:
-				vine_task_node_replicate_outfile(node);
-				break;
-			case VINE_NODE_OUTFILE_TYPE_LOCAL:
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
-				break;
-			}
-
-			/* submit children nodes with dependencies all resolved */
-			submit_unblocked_children(tg, node);
-		} else {
-			wait_timeout = 2;
-			progress_bar_update_part(pbar, recovery_tasks_part, 0); // refresh the time and total for recovery tasks
-		}
-	}
-
-	progress_bar_finish(pbar);
-	progress_bar_delete(pbar);
-
-	double total_time_spent_on_unlink_local_files = 0;
-	double total_time_spent_on_prune_ancestors_of_temp_node = 0;
-	double total_time_spent_on_prune_ancestors_of_persisted_node = 0;
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
-		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
-		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
-	}
-	total_time_spent_on_unlink_local_files /= 1e6;
-	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
-	total_time_spent_on_prune_ancestors_of_persisted_node /= 1e6;
-
-	debug(D_VINE, "total time spent on prune ancestors of temp node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_temp_node);
-	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
-	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
-
-	return;
-}
-
-/**
- * Delete a task graph object.
- * @param tg Reference to the task graph object.
- */
-void vine_task_graph_delete(struct vine_task_graph *tg)
-{
-	if (!tg) {
-		return;
-	}
-
-	char *node_key;
-	struct vine_task_node *node;
-	HASH_TABLE_ITERATE(tg->nodes, node_key, node)
-	{
-		if (node->infile) {
-			vine_prune_file(tg->manager, node->infile);
-			hash_table_remove(tg->manager->file_table, node->infile->cached_name);
-		}
-		if (node->outfile) {
-			vine_prune_file(tg->manager, node->outfile);
-			hash_table_remove(tg->outfile_cachename_to_node, node->outfile->cached_name);
-			hash_table_remove(tg->manager->file_table, node->outfile->cached_name);
-		}
-		vine_task_node_delete(node);
-	}
-
-	free(tg->proxy_library_name);
-	free(tg->proxy_function_name);
-
-	hash_table_delete(tg->nodes);
-	itable_delete(tg->task_id_to_node);
-	hash_table_delete(tg->outfile_cachename_to_node);
-	free(tg);
-}
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.h b/taskvine/src/graph/dagvine/vine_task_graph.h
deleted file mode 100644
index 47990e7211..0000000000
--- a/taskvine/src/graph/dagvine/vine_task_graph.h
+++ /dev/null
@@ -1,126 +0,0 @@
-#ifndef VINE_TASK_GRAPH_H
-#define VINE_TASK_GRAPH_H
-
-#include "vine_task.h"
-#include "hash_table.h"
-#include "list.h"
-#include "vine_manager.h"
-#include "set.h"
-#include "vine_task_node.h"
-#include "taskvine.h"
-
-
-/** Select priority algorithm for task graph task scheduling. */
-typedef enum {
-    VINE_TASK_GRAPH_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
-    VINE_TASK_GRAPH_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
-    VINE_TASK_GRAPH_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
-    VINE_TASK_GRAPH_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
-    VINE_TASK_GRAPH_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
-    VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
-    VINE_TASK_GRAPH_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
-} vine_task_graph_priority_mode_t;
-
-/** The task graph object. */
-struct vine_task_graph {
-    struct vine_manager *manager;
-	struct hash_table *nodes;
-	struct itable *task_id_to_node;
-	struct hash_table *outfile_cachename_to_node;
-
-    /* Results of target keys will be stored in this directory. 
-     * This dir path can not necessarily be a shared file system directory,
-     * output files will be retrieved through the network instead,
-     * as long as the manager can access it. */
-    char *target_results_dir;
-
-    char *proxy_library_name;    // Python-side proxy library name (shared by all tasks)
-    char *proxy_function_name;   // Python-side proxy function name (shared by all tasks)
-
-    int prune_depth;
-
-    vine_task_graph_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
-    double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
-};
-
-
-/* Public APIs for operating the task graph */
-
-/** Create a task graph object and return it.
-@param q Reference to the current manager object.
-@return A new task graph object.
-*/
-struct vine_task_graph *vine_task_graph_create(struct vine_manager *q);
-
-/** Create a new node in the task graph.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@return A new node object.
-*/
-struct vine_task_node *vine_task_graph_add_node(struct vine_task_graph *tg, const char *node_key);
-
-/** Add a dependency between two nodes in the task graph.
-@param tg Reference to the task graph object.
-@param parent_key Reference to the parent node key.
-@param child_key Reference to the child node key.
-*/
-void vine_task_graph_add_dependency(struct vine_task_graph *tg, const char *parent_key, const char *child_key);
-
-/** Finalize the metrics of the task graph.
-@param tg Reference to the task graph object.
-*/
-void vine_task_graph_compute_topology_metrics(struct vine_task_graph *tg);
-
-/** Get the heavy score of a node in the task graph.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@return The heavy score.
-*/
-double vine_task_graph_get_node_heavy_score(const struct vine_task_graph *tg, const char *node_key);
-
-/** Set the type of the node-output file.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@param outfile_type Reference to the output file type.
-@param outfile_remote_name Reference to the output file remote name.
-*/
-void vine_task_graph_set_node_outfile(struct vine_task_graph *tg, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
-
-/** Execute the task graph.
-@param tg Reference to the task graph object.
-*/
-void vine_task_graph_execute(struct vine_task_graph *tg);
-
-/** Get the local outfile source of a node in the task graph.
-@param tg Reference to the task graph object.
-@param node_key Reference to the node key.
-@return The local outfile source.
-*/
-const char *vine_task_graph_get_node_local_outfile_source(const struct vine_task_graph *tg, const char *node_key);
-
-/** Delete a task graph object.
-@param tg Reference to the task graph object.
-*/
-void vine_task_graph_delete(struct vine_task_graph *tg);
-
-/** Get the library name of the task graph.
-@param tg Reference to the task graph object.
-@return The library name.
-*/
-const char *vine_task_graph_get_proxy_library_name(const struct vine_task_graph *tg);
-
-/** Get the function name of the task graph.
-@param tg Reference to the task graph object.
-@return The function name.
-*/
-const char *vine_task_graph_get_proxy_function_name(const struct vine_task_graph *tg);
-
-/** Tune the task graph.
-@param tg Reference to the task graph object.
-@param name Reference to the name of the parameter to tune.
-@param value Reference to the value of the parameter to tune.
-@return 0 on success, -1 on failure.
-*/
-int vine_task_graph_tune(struct vine_task_graph *tg, const char *name, const char *value);
-
-#endif // VINE_TASK_GRAPH_H
diff --git a/taskvine/src/graph/dagvine/vine_task_graph.i b/taskvine/src/graph/dagvine/vine_task_graph.i
deleted file mode 100644
index 4f1f2d95fd..0000000000
--- a/taskvine/src/graph/dagvine/vine_task_graph.i
+++ /dev/null
@@ -1,21 +0,0 @@
-/* SWIG interface for local dagvine graph bindings */
-%module cdagvine
-
-%{
-#include "int_sizes.h"
-#include "vine_task_graph.h"
-#include "vine_task_node.h"  /* expose outfile type enum to SWIG */
-%}
-
-%include "stdint.i"
-%include "int_sizes.h"
-
-/* Import existing SWIG interface for type information (do not wrap again) */
-%import "../../bindings/python3/taskvine.i"
-
-/* Expose only the dagvine task graph APIs */
-%ignore vine_task_node_checkpoint_outfile;  /* avoid exporting unimplemented/optional symbol */
-%include "vine_task_node.h"    /* export vine_task_node_outfile_type_t values */
-%include "vine_task_graph.h"
-
-

From fa5095877d44ce31eac0f426ed6ca17452ac9404 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 18 Oct 2025 15:43:54 -0400
Subject: [PATCH 045/113] sog

---
 .../graph/dagvine/runtime_execution_graph.py  | 386 +++++++
 .../dagvine/strategic_orchestration_graph.c   | 987 ++++++++++++++++++
 .../dagvine/strategic_orchestration_graph.h   | 132 +++
 .../dagvine/strategic_orchestration_graph.i   |  21 +
 4 files changed, 1526 insertions(+)
 create mode 100644 taskvine/src/graph/dagvine/runtime_execution_graph.py
 create mode 100644 taskvine/src/graph/dagvine/strategic_orchestration_graph.c
 create mode 100644 taskvine/src/graph/dagvine/strategic_orchestration_graph.h
 create mode 100644 taskvine/src/graph/dagvine/strategic_orchestration_graph.i

diff --git a/taskvine/src/graph/dagvine/runtime_execution_graph.py b/taskvine/src/graph/dagvine/runtime_execution_graph.py
new file mode 100644
index 0000000000..24e246f152
--- /dev/null
+++ b/taskvine/src/graph/dagvine/runtime_execution_graph.py
@@ -0,0 +1,386 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+from ndcctools.taskvine.utils import load_variable_from_library
+
+import os
+import hashlib
+import time
+import cloudpickle
+import collections
+import uuid
+import random
+from collections import deque
+
+try:
+    import dask
+except ImportError:
+    dask = None
+
+try:
+    import dask._task_spec as dts
+except ImportError:
+    dts = None
+
+
+def hash_name(*args):
+    out_str = ""
+    for arg in args:
+        out_str += str(arg)
+    return hashlib.sha256(out_str.encode('utf-8')).hexdigest()[:32]
+
+
+def hashable(s):
+    try:
+        hash(s)
+        return True
+    except TypeError:
+        return False
+
+
+def dist_func(mode, low, high):
+    """ Generate a random value from a distribution. """
+    if not mode:
+        return 0
+
+    assert mode in ["uniform", "normal", "lognormal", "pareto", "mix"]
+
+    # uniform distribution, flat spread
+    def uniform_dist():
+        return random.uniform(low, high)
+
+    # normal distribution, centered in the middle
+    def normal_dist():
+        mu, sigma = (low + high) / 2, (high - low) / 6
+        return min(max(random.gauss(mu, sigma), low), high)
+
+    # lognormal distribution, long tail
+    def lognormal_dist():
+        val = random.lognormvariate(0, 1)
+        val = val / (1 + val)
+        return low + (high - low) * val
+
+    # pareto distribution, very heavy tail
+    def pareto_dist(alpha=2.0):
+        val = random.paretovariate(alpha)
+        val = val / (1 + val)
+        return low + (high - low) * val
+
+    # mixture: most small values, few large ones
+    def mix_dist():
+        if random.random() < 0.9:
+            return random.uniform(low, (low + high) / 2)
+        else:
+            return random.uniform((low + high) / 2, high)
+
+    return {
+        "uniform": uniform_dist,
+        "normal": normal_dist,
+        "lognormal": lognormal_dist,
+        "pareto": pareto_dist,
+        "mix": mix_dist,
+    }[mode]()
+
+
+class GraphKeyResult:
+    """ A wrapper class to store the result of a task and the extra size in MB to allocate for this object in testing mode to evaluate storage consumption
+    and peer transfer performance across all workers. """
+    def __init__(self, result, extra_size_mb=None):
+        self.result = result
+        self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
+
+
+class RuntimeExecutionGraph:
+    """
+    The RuntimeExecutionGraph class constructs the task graph and manages task dependencies.
+    This class is cloudpickled and sent to workers, where it is hoisted by the library instance.
+    The global RuntimeExecutionGraph object then serves as the execution context: whenever a task key is invoked,
+    the system resolves the corresponding graph key from the Vine key and executes the mapped function
+    to produce the result.
+    """
+    def __init__(self, task_dict,
+                 shared_file_system_dir=None,
+                 extra_task_output_size_mb=["uniform", 0, 0],
+                 extra_task_sleep_time=["uniform", 0, 0]):
+        self.task_dict = task_dict
+        self.shared_file_system_dir = shared_file_system_dir
+
+        if self.shared_file_system_dir:
+            os.makedirs(self.shared_file_system_dir, exist_ok=True)
+
+        if dts:
+            for k, v in self.task_dict.items():
+                if isinstance(v, dts.GraphNode):
+                    assert isinstance(v, (dts.Alias, dts.Task, dts.DataNode)), f"Unsupported task type for key {k}: {v.__class__}"
+
+        self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
+        self.depth_of = self._calculate_depths()
+
+        self.vine_key_of = {k: hash_name(k) for k in task_dict.keys()}
+        self.key_of_vine_key = {hash_name(k): k for k in task_dict.keys()}
+
+        self.outfile_remote_name = {key: f"{uuid.uuid4()}.pkl" for key in self.task_dict.keys()}
+        self.outfile_type = {key: None for key in self.task_dict.keys()}
+
+        # testing params
+        self.extra_task_output_size_mb = self._calculate_extra_size_mb_of(extra_task_output_size_mb)
+        self.extra_sleep_time_of = self._calculate_extra_sleep_time_of(extra_task_sleep_time)
+
+    def set_outfile_type_of(self, k, outfile_type_str):
+        assert outfile_type_str in ["local", "shared-file-system", "temp"]
+        self.outfile_type[k] = outfile_type_str
+        if outfile_type_str == "shared-file-system":
+            self.outfile_remote_name[k] = os.path.join(self.shared_file_system_dir, self.outfile_remote_name[k])
+
+    def _calculate_extra_size_mb_of(self, extra_task_output_size_mb):
+        assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 3
+        mode, low, high = extra_task_output_size_mb
+        low, high = int(low), int(high)
+        assert low <= high
+
+        max_depth = max(depth for depth in self.depth_of.values())
+        extra_size_mb_of = {}
+        for k in self.task_dict.keys():
+            if self.depth_of[k] == max_depth or self.depth_of[k] == max_depth - 1:
+                extra_size_mb_of[k] = 0
+                continue
+            extra_size_mb_of[k] = dist_func(mode, low, high)
+
+        return extra_size_mb_of
+
+    def _calculate_extra_sleep_time_of(self, extra_task_sleep_time):
+        assert isinstance(extra_task_sleep_time, list) and len(extra_task_sleep_time) == 3
+        mode, low, high = extra_task_sleep_time
+        low, high = int(low), int(high)
+        assert low <= high
+
+        extra_sleep_time_of = {}
+        for k in self.task_dict.keys():
+            extra_sleep_time_of[k] = dist_func(mode, low, high)
+
+        return extra_sleep_time_of
+
+    def _calculate_depths(self):
+        depth_of = {key: 0 for key in self.task_dict.keys()}
+
+        topo_order = self.get_topological_order()
+        for key in topo_order:
+            if self.parents_of[key]:
+                depth_of[key] = max(depth_of[parent] for parent in self.parents_of[key]) + 1
+            else:
+                depth_of[key] = 0
+
+        return depth_of
+
+    def set_outfile_remote_name_of(self, key, outfile_remote_name):
+        self.outfile_remote_name[key] = outfile_remote_name
+
+    def is_dts_key(self, k):
+        if not hasattr(dask, "_task_spec"):
+            return False
+        import dask._task_spec as dts
+        return isinstance(self.task_dict[k], (dts.Task, dts.TaskRef, dts.Alias, dts.DataNode, dts.NestedContainer))
+
+    def _build_dependencies(self, task_dict):
+        def _find_sexpr_parents(sexpr):
+            if hashable(sexpr) and sexpr in task_dict.keys():
+                return {sexpr}
+            elif isinstance(sexpr, (list, tuple)):
+                deps = set()
+                for x in sexpr:
+                    deps |= _find_sexpr_parents(x)
+                return deps
+            elif isinstance(sexpr, dict):
+                deps = set()
+                for k, v in sexpr.items():
+                    deps |= _find_sexpr_parents(k)
+                    deps |= _find_sexpr_parents(v)
+                return deps
+            else:
+                return set()
+
+        parents_of = collections.defaultdict(set)
+        children_of = collections.defaultdict(set)
+
+        for k, value in task_dict.items():
+            if self.is_dts_key(k):
+                # in the new Dask expression, each value is an object from dask._task_spec, could be
+                # a Task, Alias, TaskRef, etc., but they all share the same base class the dependencies
+                # field is of type frozenset(), without recursive ancestor dependencies involved
+                parents_of[k] = value.dependencies
+            else:
+                # the value could be a sexpr, e.g., the old Dask representation
+                parents_of[k] = _find_sexpr_parents(value)
+
+        for k, deps in parents_of.items():
+            for dep in deps:
+                children_of[dep].add(k)
+
+        return parents_of, children_of
+
+    def save_result_of_key(self, key, result):
+        with open(self.outfile_remote_name[key], "wb") as f:
+            result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
+            cloudpickle.dump(result_obj, f)
+
+    def load_result_of_key(self, key, target_results_dir=None):
+        if self.outfile_type[key] == "local":
+            # nodes with local outfile type will have their results stored in the target results directory
+            # when the execution is done, users can call this function to load the results from the target results directory
+            # note that data is transferred through the link in sequence, not in parallel through the shared file system
+            outfile_path = os.path.join(target_results_dir, self.outfile_remote_name[key])
+        else:
+            # workers user this branch to load results from either local or shared file system
+            # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
+            # if a shared file system output, then remote name is the full path to the file
+            outfile_path = self.outfile_remote_name[key]
+        try:
+            with open(outfile_path, "rb") as f:
+                result_obj = cloudpickle.load(f)
+                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
+                return result_obj.result
+        except FileNotFoundError:
+            raise FileNotFoundError(f"Output file for key {key} not found at {outfile_path}")
+
+    def get_topological_order(self):
+        in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
+        queue = deque([key for key, degree in in_degree.items() if degree == 0])
+        topo_order = []
+
+        while queue:
+            current = queue.popleft()
+            topo_order.append(current)
+
+            for child in self.children_of[current]:
+                in_degree[child] -= 1
+                if in_degree[child] == 0:
+                    queue.append(child)
+
+        if len(topo_order) != len(self.task_dict):
+            print(f"len(topo_order): {len(topo_order)}")
+            print(f"len(self.task_dict): {len(self.task_dict)}")
+            raise ValueError("Failed to create topo order, the dependencies may be cyclic or problematic")
+
+        return topo_order
+
+    def __del__(self):
+        if hasattr(self, 'outfile_remote_name') and self.outfile_remote_name:
+            for k in self.outfile_remote_name.keys():
+                if self.outfile_type.get(k) == "shared-file-system" and os.path.exists(self.outfile_remote_name[k]):
+                    os.remove(self.outfile_remote_name[k])
+
+    @staticmethod
+    def context_loader_func(reg_pkl):
+        reg = cloudpickle.loads(reg_pkl)
+
+        if not isinstance(reg, RuntimeExecutionGraph):
+            raise TypeError("reg_pkl is not of type RuntimeExecutionGraph")
+
+        return {
+            "reg": reg,
+        }
+
+
+def compute_dts_key(reg, k, v):
+    """
+    Compute the result of a Dask task node from dask._task_spec.
+
+    Each value `v` may be an instance of Task, Alias, or DataNode, all of which
+    inherit from the same base class. The `dependencies` field is a frozenset
+    containing direct dependencies only (no recursive ancestry).
+
+    The function resolves each dependency from the reg, constructs an
+    input dictionary, and then executes the node according to its type.
+    """
+    try:
+        import dask._task_spec as dts
+    except ImportError:
+        raise ImportError("Dask is not installed")
+
+    input_dict = {dep: reg.load_result_of_key(dep) for dep in v.dependencies}
+
+    try:
+        if isinstance(v, dts.Alias):
+            assert len(v.dependencies) == 1, "Expected exactly one dependency"
+            return reg.load_result_of_key(next(iter(v.dependencies)))
+        elif isinstance(v, dts.Task):
+            return v(input_dict)
+        elif isinstance(v, dts.DataNode):
+            return v.value
+        else:
+            raise TypeError(f"unexpected node type: {type(v)} for key {k}")
+    except Exception as e:
+        raise Exception(f"Error while executing task {k}: {e}")
+
+
+def compute_sexpr_key(reg, k, v):
+    """
+    Evaluate a symbolic expression (S-expression) task within the task graph.
+
+    Both DAGVine and legacy Dask represent computations as symbolic
+    expression trees (S-expressions). Each task value `v` encodes a nested
+    structure where:
+      - Leaf nodes are constants or task keys referencing parent results.
+      - Lists are recursively evaluated.
+      - Tuples of the form (func, arg1, arg2, ...) represent function calls.
+
+    This function builds an input dictionary from all parent keys, then
+    recursively resolves and executes the expression until a final value
+    is produced.
+    """
+    input_dict = {parent: reg.load_result_of_key(parent) for parent in reg.parents_of[k]}
+
+    def _rec_call(expr):
+        try:
+            if expr in input_dict.keys():
+                return input_dict[expr]
+        except TypeError:
+            pass
+        if isinstance(expr, list):
+            return [_rec_call(e) for e in expr]
+        if isinstance(expr, tuple) and len(expr) > 0 and callable(expr[0]):
+            res = expr[0](*[_rec_call(a) for a in expr[1:]])
+            return res
+        return expr
+
+    try:
+        return _rec_call(v)
+    except Exception as e:
+        raise Exception(f"Failed to invoke _rec_call(): {e}")
+
+
+def compute_single_key(vine_key):
+    """
+    Compute a single task identified by a Vine key within the current RuntimeExecutionGraph.
+
+    The function retrieves the corresponding graph key and task object from the
+    global reg, determines the task type, and dispatches to the appropriate
+    execution interface — e.g., `compute_dts_key` for Dask-style task specs or
+    `compute_sexpr_key` for S-expression graphs.
+
+    This design allows extensibility: for new graph representations, additional
+    compute interfaces can be introduced and registered here to handle new key types.
+
+    After computation, the result is saved, the output file is validated, and
+    an optional delay (`extra_sleep_time_of`) is applied before returning.
+    """
+    reg = load_variable_from_library('reg')
+
+    k = reg.key_of_vine_key[vine_key]
+    v = reg.task_dict[k]
+
+    if reg.is_dts_key(k):
+        result = compute_dts_key(reg, k, v)
+    else:
+        result = compute_sexpr_key(reg, k, v)
+
+    reg.save_result_of_key(k, result)
+    if not os.path.exists(reg.outfile_remote_name[k]):
+        raise Exception(f"Output file {reg.outfile_remote_name[k]} does not exist after writing")
+    if os.stat(reg.outfile_remote_name[k]).st_size == 0:
+        raise Exception(f"Output file {reg.outfile_remote_name[k]} is empty after writing")
+
+    time.sleep(reg.extra_sleep_time_of[k])
+
+    return True
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
new file mode 100644
index 0000000000..c9c84eb9d2
--- /dev/null
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
@@ -0,0 +1,987 @@
+#include <stdlib.h>
+#include <string.h>
+#include <stdint.h>
+#include <assert.h>
+#include <math.h>
+#include <signal.h>
+#include <errno.h>
+#include <stdio.h>
+#include <sys/stat.h>
+
+#include "priority_queue.h"
+#include "list.h"
+#include "debug.h"
+#include "itable.h"
+#include "xxmalloc.h"
+#include "stringtools.h"
+#include "random.h"
+#include "hash_table.h"
+#include "set.h"
+#include "timestamp.h"
+#include "progress_bar.h"
+#include "macros.h"
+
+#include "strategic_orchestration_graph.h"
+#include "vine_manager.h"
+#include "vine_task_node.h"
+#include "vine_worker_info.h"
+#include "vine_task.h"
+#include "vine_file.h"
+#include "vine_mount.h"
+#include "taskvine.h"
+
+
+static volatile sig_atomic_t interrupted = 0;
+
+/*************************************************************/
+/* Private Functions */
+/*************************************************************/
+
+/**
+ * Handle the SIGINT signal.
+ * @param signal Reference to the signal.
+ */
+static void handle_sigint(int signal)
+{
+	interrupted = 1;
+}
+
+/**
+ * Calculate the priority of a node given the priority mode.
+ * @param node Reference to the node object.
+ * @param priority_mode Reference to the priority mode.
+ * @return The priority.
+ */
+static double vine_task_node_calculate_priority(struct vine_task_node *node, task_priority_mode_t priority_mode)
+{
+	if (!node) {
+		return 0;
+	}
+
+	double priority = 0;
+	timestamp_t current_time = timestamp_get();
+
+	struct vine_task_node *parent_node;
+
+	switch (priority_mode) {
+	case TASK_PRIORITY_MODE_RANDOM:
+		priority = random_double();
+		break;
+	case TASK_PRIORITY_MODE_DEPTH_FIRST:
+		priority = (double)node->depth;
+		break;
+	case TASK_PRIORITY_MODE_BREADTH_FIRST:
+		priority = -(double)node->depth;
+		break;
+	case TASK_PRIORITY_MODE_FIFO:
+		priority = -(double)current_time;
+		break;
+	case TASK_PRIORITY_MODE_LIFO:
+		priority = (double)current_time;
+		break;
+	case TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST:
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (!parent_node->outfile) {
+				continue;
+			}
+			priority += (double)vine_file_size(parent_node->outfile);
+		}
+		break;
+	case TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST:
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (!parent_node->outfile) {
+				continue;
+			}
+			timestamp_t parent_task_completion_time = parent_node->task->time_workers_execute_last;
+			priority += (double)vine_file_size(parent_node->outfile) * (double)parent_task_completion_time;
+		}
+		break;
+	}
+
+	return priority;
+}
+
+/**
+ * Submit a node to the taskvine manager.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node Reference to the node object.
+ */
+static void submit_node_task(struct strategic_orchestration_graph *sog, struct vine_task_node *node)
+{
+	if (!sog || !node) {
+		return;
+	}
+
+	/* calculate the priority of the node */
+	double priority = vine_task_node_calculate_priority(node, sog->task_priority_mode);
+	vine_task_set_priority(node->task, priority);
+	/* submit the task to the manager */
+	int task_id = vine_submit(sog->manager, node->task);
+	/* insert the task id to the task id to node map */
+	itable_insert(sog->task_id_to_node, task_id, node);
+
+	return;
+}
+
+/**
+ * Submit the children of a node if all its dependencies are resolved.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node Reference to the node object.
+ */
+static void submit_unblocked_children(struct strategic_orchestration_graph *sog, struct vine_task_node *node)
+{
+	if (!sog || !node) {
+		return;
+	}
+
+	struct vine_task_node *child_node; 
+	LIST_ITERATE(node->children, child_node)
+	{
+		/* Remove this parent from the child's pending set if it exists */
+		if (child_node->pending_parents) {
+			/* Assert that this parent is indeed pending for the child */
+			if (child_node->pending_parents && set_lookup(child_node->pending_parents, node)) {
+				set_remove(child_node->pending_parents, node);
+			} else {
+				debug(D_ERROR, "inconsistent pending set: child=%s missing parent=%s", child_node->node_key, node->node_key);
+			}
+		}
+
+		/* If no more parents are pending, submit the child */
+		if (!child_node->pending_parents || set_size(child_node->pending_parents) == 0) {
+			submit_node_task(sog, child_node);
+		}
+	}
+
+	return;
+}
+
+/**
+ * Get the topological order of the strategic orchestration graph.
+ * Must be called after all nodes and dependencies are added and the topology metrics are computed.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @return The list of nodes in topological order.
+ */
+static struct list *get_topological_order(struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return NULL;
+	}
+
+	int total_nodes = hash_table_size(sog->nodes);
+	struct list *topo_order = list_create();
+	struct hash_table *in_degree_map = hash_table_create(0, 0);
+	struct priority_queue *pq = priority_queue_create(total_nodes);
+
+	char *key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(sog->nodes, key, node)
+	{
+		int deg = list_size(node->parents);
+		hash_table_insert(in_degree_map, key, (void *)(intptr_t)deg);
+		if (deg == 0) {
+			priority_queue_push(pq, node, compute_lex_priority(node->node_key));
+		}
+	}
+
+	while (priority_queue_size(pq) > 0) {
+		struct vine_task_node *current = priority_queue_pop(pq);
+		list_push_tail(topo_order, current);
+
+		struct vine_task_node *child;
+		LIST_ITERATE(current->children, child)
+		{
+			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, child->node_key);
+			int deg = (int)raw_deg - 1;
+
+			hash_table_remove(in_degree_map, child->node_key);
+			hash_table_insert(in_degree_map, child->node_key, (void *)(intptr_t)deg);
+
+			if (deg == 0) {
+				priority_queue_push(pq, child, compute_lex_priority(child->node_key));
+			}
+		}
+	}
+
+	if (list_size(topo_order) != total_nodes) {
+		debug(D_ERROR, "Error: strategic orchestration graph contains cycles or is malformed.\n");
+		debug(D_ERROR, "Expected %d nodes, but only sorted %d.\n", total_nodes, list_size(topo_order));
+
+		HASH_TABLE_ITERATE(sog->nodes, key, node)
+		{
+			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, key);
+			int deg = (int)raw_deg;
+			if (deg > 0) {
+				debug(D_ERROR, "  Node %s has in-degree %d. Parents:\n", key, deg);
+				struct vine_task_node *p;
+				LIST_ITERATE(node->parents, p)
+				{
+					debug(D_ERROR, "    -> %s\n", p->node_key);
+				}
+			}
+		}
+
+		list_delete(topo_order);
+		hash_table_delete(in_degree_map);
+		priority_queue_delete(pq);
+		exit(1);
+	}
+
+	hash_table_delete(in_degree_map);
+	priority_queue_delete(pq);
+	return topo_order;
+}
+
+/**
+ * Extract the weakly connected components of the strategic orchestration graph.
+ * This function is used only for debugging purposes at the moment.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @return The list of weakly connected components.
+ */
+static struct list *extract_weakly_connected_components(struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return NULL;
+	}
+
+	struct set *visited = set_create(0);
+	struct list *components = list_create();
+
+	char *node_key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		if (set_lookup(visited, node)) {
+			continue;
+		}
+
+		struct list *component = list_create();
+		struct list *queue = list_create();
+
+		list_push_tail(queue, node);
+		set_insert(visited, node);
+		list_push_tail(component, node);
+
+		while (list_size(queue) > 0) {
+			struct vine_task_node *curr = list_pop_head(queue);
+
+			struct vine_task_node *p;
+			LIST_ITERATE(curr->parents, p)
+			{
+				if (!set_lookup(visited, p)) {
+					list_push_tail(queue, p);
+					set_insert(visited, p);
+					list_push_tail(component, p);
+				}
+			}
+
+			struct vine_task_node *c;
+			LIST_ITERATE(curr->children, c)
+			{
+				if (!set_lookup(visited, c)) {
+					list_push_tail(queue, c);
+					set_insert(visited, c);
+					list_push_tail(component, c);
+				}
+			}
+		}
+
+		list_push_tail(components, component);
+		list_delete(queue);
+	}
+
+	set_delete(visited);
+	return components;
+}
+
+/**
+ * Compute the heavy score of a node in the strategic orchestration graph.
+ * @param node Reference to the node object.
+ * @return The heavy score.
+ */
+static double compute_node_heavy_score(struct vine_task_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	double up_score = node->depth * node->upstream_subgraph_size * node->fan_in;
+	double down_score = node->height * node->downstream_subgraph_size * node->fan_out;
+
+	return up_score / (down_score + 1);
+}
+
+/**
+ * Map a task to a node in the strategic orchestration graph.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param task Reference to the task object.
+ * @return The node object.
+ */
+static struct vine_task_node *get_node_by_task(struct strategic_orchestration_graph *sog, struct vine_task *task)
+{
+	if (!sog || !task) {
+		return NULL;
+	}
+
+	if (task->type == VINE_TASK_TYPE_STANDARD) {
+		/* standard tasks are mapped directly to a node */
+		return itable_lookup(sog->task_id_to_node, task->task_id);
+	} else if (task->type == VINE_TASK_TYPE_RECOVERY) {
+		/* note that recovery tasks are not mapped to any node but we still need the original node for pruning,
+		 * so we look up the outfile of the task, then map it back to get the original node */
+		struct vine_mount *mount;
+		LIST_ITERATE(task->output_mounts, mount)
+		{
+			if (mount->file->original_producer_task_id > 0) {
+				return itable_lookup(sog->task_id_to_node, mount->file->original_producer_task_id);
+			}
+		}
+	}
+
+	debug(D_ERROR, "task %d has no original producer task id", task->task_id);
+
+	return NULL;
+}
+
+/*************************************************************/
+/* Public APIs */
+/*************************************************************/
+
+/** Tune the strategic orchestration graph.
+*@param sog Reference to the strategic orchestration graph object.
+ *@param name Reference to the name of the parameter to tune.
+ *@param value Reference to the value of the parameter to tune.
+ *@return 0 on success, -1 on failure.
+ */
+int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const char *value)
+{
+	if (!sog || !name || !value) {
+		return -1;
+	}
+
+	if (strcmp(name, "failure-injection-step-percent") == 0) {
+		sog->failure_injection_step_percent = atof(value);
+
+	} else if (strcmp(name, "task-priority-mode") == 0) {
+		if (strcmp(value, "random") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_RANDOM;
+		} else if (strcmp(value, "depth-first") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_DEPTH_FIRST;
+		} else if (strcmp(value, "breadth-first") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_BREADTH_FIRST;
+		} else if (strcmp(value, "fifo") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_FIFO;
+		} else if (strcmp(value, "lifo") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_LIFO;
+		} else if (strcmp(value, "largest-input-first") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
+		} else if (strcmp(value, "largest-storage-footprint-first") == 0) {
+			sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST;
+		} else {
+			debug(D_ERROR, "invalid priority mode: %s", value);
+			return -1;
+		}		
+
+	} else if (strcmp(name, "target-results-dir") == 0) {
+		if (sog->target_results_dir) {
+			free(sog->target_results_dir);
+		}
+		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
+			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
+			return -1;
+		}
+		sog->target_results_dir = xxstrdup(value);
+
+	} else if (strcmp(name, "proxy-function-name") == 0) {
+		if (sog->proxy_function_name) {
+			free(sog->proxy_function_name);
+		}
+		sog->proxy_function_name = xxstrdup(value);
+
+	} else if (strcmp(name, "prune-depth") == 0) {
+		sog->prune_depth = atoi(value);
+		
+	} else {
+		debug(D_ERROR, "invalid parameter name: %s", name);
+		return -1;
+
+	}
+
+	return 0;
+}
+
+void sog_set_proxy_library_name(struct strategic_orchestration_graph *sog, const char *proxy_library_name)
+{
+	if (!sog || !proxy_library_name) {
+		return;
+	}
+
+	if (sog->proxy_library_name) {
+		free(sog->proxy_library_name);
+	}
+
+	sog->proxy_library_name = xxstrdup(proxy_library_name);
+}
+
+/**
+ * Get the proxy library name (Python-side), shared by all tasks.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @return The library name.
+ */
+const char *sog_get_proxy_library_name(const struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return NULL;
+	}
+
+	return sog->proxy_library_name;
+}
+
+/**
+ * Get the proxy function name (Python-side), shared by all tasks.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @return The function name.
+ */
+const char *sog_get_proxy_function_name(const struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return NULL;
+	}
+
+	return sog->proxy_function_name;
+}
+
+/**
+ * Get the heavy score of a node in the strategic orchestration graph.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node_key Reference to the node key.
+ * @return The heavy score.
+ */
+double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog, const char *node_key)
+{
+	if (!sog) {
+		return -1;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	if (!node) {
+		return -1;
+	}
+
+	return node->heavy_score;
+}
+
+/**
+ * Get the local outfile source of a node in the strategic orchestration graph, only valid for local output files.
+ * The source of a local output file is the path on the local filesystem.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node_key Reference to the node key.
+ * @return The local outfile source.
+ */
+const char *sog_get_node_local_outfile_source(const struct strategic_orchestration_graph *sog, const char *node_key)
+{
+	if (!sog || !node_key) {
+		return NULL;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	if (!node) {
+		debug(D_ERROR, "node %s not found", node_key);
+		exit(1);
+	}
+
+	if (node->outfile_type != VINE_NODE_OUTFILE_TYPE_LOCAL) {
+		debug(D_ERROR, "node %s is not a local output file", node_key);
+		exit(1);
+	}
+
+	return node->outfile->source;
+}
+
+/**
+ * Compute the topology metrics of the strategic orchestration graph, including depth, height, upstream and downstream counts,
+ * heavy scores, and weakly connected components.
+ * @param sog Reference to the strategic orchestration graph object.
+ */
+void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return;
+	}
+
+	/* get nodes in topological order */
+	struct list *topo_order = get_topological_order(sog);
+	if (!topo_order) {
+		return;
+	}
+
+	char *node_key;
+	struct vine_task_node *node;
+	struct vine_task_node *parent_node;
+	struct vine_task_node *child_node;
+
+	/* compute the depth of the node */
+	LIST_ITERATE(topo_order, node)
+	{
+		node->depth = 0;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (node->depth < parent_node->depth + 1) {
+				node->depth = parent_node->depth + 1;
+			}
+		}
+	}
+
+	/* compute the height of the node */
+	LIST_ITERATE_REVERSE(topo_order, node)
+	{
+		node->height = 0;
+		LIST_ITERATE(node->children, child_node)
+		{
+			if (node->height < child_node->height + 1) {
+				node->height = child_node->height + 1;
+			}
+		}
+	}
+
+	/* compute the upstream and downstream counts for each node */
+	struct hash_table *upstream_map = hash_table_create(0, 0);
+	struct hash_table *downstream_map = hash_table_create(0, 0);
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		struct set *upstream = set_create(0);
+		struct set *downstream = set_create(0);
+		hash_table_insert(upstream_map, node_key, upstream);
+		hash_table_insert(downstream_map, node_key, downstream);
+	}
+	LIST_ITERATE(topo_order, node)
+	{
+		struct set *upstream = hash_table_lookup(upstream_map, node->node_key);
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			struct set *parent_upstream = hash_table_lookup(upstream_map, parent_node->node_key);
+			set_union(upstream, parent_upstream);
+			set_insert(upstream, parent_node);
+		}
+	}
+	LIST_ITERATE_REVERSE(topo_order, node)
+	{
+		struct set *downstream = hash_table_lookup(downstream_map, node->node_key);
+		LIST_ITERATE(node->children, child_node)
+		{
+			struct set *child_downstream = hash_table_lookup(downstream_map, child_node->node_key);
+			set_union(downstream, child_downstream);
+			set_insert(downstream, child_node);
+		}
+	}
+	LIST_ITERATE(topo_order, node)
+	{
+		node->upstream_subgraph_size = set_size(hash_table_lookup(upstream_map, node->node_key));
+		node->downstream_subgraph_size = set_size(hash_table_lookup(downstream_map, node->node_key));
+		node->fan_in = list_size(node->parents);
+		node->fan_out = list_size(node->children);
+		set_delete(hash_table_lookup(upstream_map, node->node_key));
+		set_delete(hash_table_lookup(downstream_map, node->node_key));
+	}
+	hash_table_delete(upstream_map);
+	hash_table_delete(downstream_map);
+
+	/* compute the heavy score for each node */
+	LIST_ITERATE(topo_order, node)
+	{
+		node->heavy_score = compute_node_heavy_score(node);
+	}
+
+	/* extract weakly connected components */
+	struct list *weakly_connected_components = extract_weakly_connected_components(sog);
+	struct list *component;
+	int component_index = 0;
+	debug(D_VINE, "graph has %d weakly connected components\n", list_size(weakly_connected_components));
+	LIST_ITERATE(weakly_connected_components, component)
+	{
+		debug(D_VINE, "component %d size: %d\n", component_index, list_size(component));
+		list_delete(component);
+		component_index++;
+	}
+	list_delete(weakly_connected_components);
+
+	list_delete(topo_order);
+
+	return;
+}
+
+/**
+ * Create a new node and track it in the strategic orchestration graph.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node_key Reference to the node key.
+ * @return A new node object.
+ */
+void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key)
+{
+	if (!sog || !node_key) {
+		return;
+	}
+
+	/* if the node already exists, skip creating a new one */
+	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	if (!node) {
+		node = vine_task_node_create(sog->manager,
+				node_key,
+				sog->proxy_library_name,
+				sog->proxy_function_name,
+				sog->target_results_dir,
+				sog->prune_depth);
+
+		if (!node) {
+			debug(D_ERROR, "failed to create node %s", node_key);
+			sog_delete(sog);
+			exit(1);
+		}
+
+		hash_table_insert(sog->nodes, node_key, node);
+	}
+}
+
+/**
+ * Create a new strategic orchestration graph object and bind a manager to it.
+ * @param q Reference to the manager object.
+ * @return A new strategic orchestration graph object.
+ */
+struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
+{
+	struct strategic_orchestration_graph *sog = xxmalloc(sizeof(struct strategic_orchestration_graph));
+
+	sog->manager = q;
+	
+	sog->nodes = hash_table_create(0, 0);
+	sog->task_id_to_node = itable_create(0);
+	sog->outfile_cachename_to_node = hash_table_create(0, 0);
+
+	sog->target_results_dir = xxstrdup(sog->manager->runtime_directory);  // default to current working directory
+	sog->proxy_library_name = NULL;
+	sog->proxy_function_name = NULL;
+
+	sog->prune_depth = 1;
+
+	sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
+	sog->failure_injection_step_percent = -1.0;
+
+	/* enable debug system for C code since it uses a separate debug system instance
+	 * from the Python bindings. Use the same function that the manager uses. */
+	char *debug_tmp = string_format("%s/vine-logs/debug", sog->manager->runtime_directory);
+	vine_enable_debug_log(debug_tmp);
+	free(debug_tmp);
+
+	return sog;
+}
+
+/**
+ * Add a dependency between two nodes in the strategic orchestration graph. Note that the input-output file relationship
+ * is not handled here, because their file names may have not been determined yet.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param parent_key Reference to the parent node key.
+ * @param child_key Reference to the child node key.
+ */
+void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *parent_key, const char *child_key)
+{
+	if (!sog || !parent_key || !child_key) {
+		return;
+	}
+
+	struct vine_task_node *parent_node = hash_table_lookup(sog->nodes, parent_key);
+	struct vine_task_node *child_node = hash_table_lookup(sog->nodes, child_key);
+	if (!parent_node) {
+		debug(D_ERROR, "parent node %s not found", parent_key);
+		char *node_key = NULL;
+		struct vine_task_node *node;
+		printf("parent_keys:\n");
+		HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+		{
+			printf("  %s\n", node->node_key);
+		}
+		exit(1);
+	}
+	if (!child_node) {
+		debug(D_ERROR, "child node %s not found", child_key);
+		exit(1);
+	}
+
+	list_push_tail(child_node->parents, parent_node);
+	list_push_tail(parent_node->children, child_node);
+
+	return;
+}
+
+/**
+ * Set the outfile of a node in the strategic orchestration graph.
+ * This involves declaring the output file and adding it to the task.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node_key Reference to the node key.
+ * @param outfile_type Reference to the outfile type.
+ * @param outfile_remote_name Reference to the outfile remote name that the task will generate remotely.
+ */
+void sog_set_node_outfile(struct strategic_orchestration_graph *sog, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
+{
+	if (!sog || !node_key || !outfile_remote_name) {
+		return;
+	}
+
+	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	if (!node) {
+		return;
+	}
+
+	vine_task_node_set_outfile(node, outfile_type, outfile_remote_name);
+
+	return;
+}
+
+/**
+ * Execute the strategic orchestration graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
+ * @param sog Reference to the strategic orchestration graph object.
+ */
+void sog_execute(struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return;
+	}
+
+	signal(SIGINT, handle_sigint);
+
+	debug(D_VINE, "start executing strategic orchestration graph");
+
+	/* print the info of all nodes */
+	char *node_key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		vine_task_node_print_info(node);
+	}
+
+	/* enable return recovery tasks */
+	vine_enable_return_recovery_tasks(sog->manager);
+
+	/* create mapping from task_id and outfile cached_name to node */
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		if (node->outfile) {
+			hash_table_insert(sog->outfile_cachename_to_node, node->outfile->cached_name, node);
+		}
+	}
+
+	/* add the parents' outfiles as inputs to the task */
+	struct list *topo_order = get_topological_order(sog);
+	LIST_ITERATE(topo_order, node)
+	{
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (parent_node->outfile) {
+				vine_task_add_input(node->task, parent_node->outfile, parent_node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
+			}
+		}
+	}
+
+	/* initialize pending_parents for all nodes */
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		struct vine_task_node *parent_node;
+		LIST_ITERATE(node->parents, parent_node)
+		{
+			if (node->pending_parents) {
+				/* Use parent_node->node_key to ensure pointer consistency */
+				set_insert(node->pending_parents, parent_node);
+			}
+		}
+	}
+
+	/* enqueue those without dependencies */
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
+			submit_node_task(sog, node);
+		}
+	}
+
+	/* calculate steps to inject failure */
+	double next_failure_threshold = -1.0;
+	if (sog->failure_injection_step_percent > 0) {
+		next_failure_threshold = sog->failure_injection_step_percent / 100.0;
+	}
+
+	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
+	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(sog->nodes));
+	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
+	progress_bar_bind_part(pbar, regular_tasks_part);
+	progress_bar_bind_part(pbar, recovery_tasks_part);
+
+	int wait_timeout = 2;
+
+	while (regular_tasks_part->current < regular_tasks_part->total) {
+		if (interrupted) {
+			break;
+		}
+
+		struct vine_task *task = vine_wait(sog->manager, wait_timeout);
+		progress_bar_set_part_total(pbar, recovery_tasks_part, sog->manager->num_submitted_recovery_tasks);
+		if (task) {
+			/* retrieve all possible tasks */
+			wait_timeout = 0;
+
+			/* get the original node by task id */
+			struct vine_task_node *node = get_node_by_task(sog, task);
+			if (!node) {
+				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
+				exit(1);
+			}
+
+			/* in case of failure, resubmit this task */
+			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
+				if (node->retry_attempts_left <= 0) {
+					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %s has no retries left. Aborting.", task->task_id, node->task->result, node->task->exit_code, node->node_key);
+					sog_delete(sog);
+					exit(1);
+				}
+				node->retry_attempts_left--;
+				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %s (remaining=%d)...", task->task_id, node->task->result, node->task->exit_code, node->node_key, node->retry_attempts_left);
+				vine_task_reset(node->task);
+				submit_node_task(sog, node);
+				continue;
+			}
+
+			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
+			switch (node->outfile_type) {
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
+				struct stat info;
+				int result = stat(node->outfile_remote_name, &info);
+				if (result < 0) {
+					if (node->retry_attempts_left <= 0) {
+						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %s. Aborting.", task->task_id, node->outfile_remote_name, node->node_key);
+						sog_delete(sog);
+						exit(1);
+					}
+					node->retry_attempts_left--;
+					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %s (remaining=%d)...", task->task_id, node->outfile_remote_name, node->node_key, node->retry_attempts_left);
+					vine_task_reset(node->task);
+					submit_node_task(sog, node);
+					continue;
+				}
+				node->outfile_size_bytes = info.st_size;
+				break;
+			}
+			case VINE_NODE_OUTFILE_TYPE_LOCAL:
+			case VINE_NODE_OUTFILE_TYPE_TEMP:
+				node->outfile_size_bytes = node->outfile->size;
+				break;
+			}
+			debug(D_VINE, "Node %s completed with outfile %s size: %zu bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
+
+			/* mark the node as completed */
+			node->completed = 1;
+
+			/* prune nodes on task completion */
+			vine_task_node_prune_ancestors(node);
+
+			/* skip recovery tasks */
+			if (task->type == VINE_TASK_TYPE_RECOVERY) {
+				progress_bar_update_part(pbar, recovery_tasks_part, 1);
+				continue;
+			}
+
+			/* set the start time to the submit time of the first regular task */
+			if (regular_tasks_part->current == 0) {
+				progress_bar_set_start_time(pbar, task->time_when_commit_start);
+			}
+
+			/* update critical time */
+			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
+
+			/* mark this regular task as completed */
+			progress_bar_update_part(pbar, regular_tasks_part, 1);
+
+			/* inject failure */
+			if (sog->failure_injection_step_percent > 0) {
+				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
+				if (progress >= next_failure_threshold && evict_random_worker(sog->manager)) {
+					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
+					next_failure_threshold += sog->failure_injection_step_percent / 100.0;
+				}
+			}
+
+			/* enqueue the output file for replication */
+			switch (node->outfile_type) {
+			case VINE_NODE_OUTFILE_TYPE_TEMP:
+				vine_task_node_replicate_outfile(node);
+				break;
+			case VINE_NODE_OUTFILE_TYPE_LOCAL:
+			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+				break;
+			}
+
+			/* submit children nodes with dependencies all resolved */
+			submit_unblocked_children(sog, node);
+		} else {
+			wait_timeout = 2;
+			progress_bar_update_part(pbar, recovery_tasks_part, 0); // refresh the time and total for recovery tasks
+		}
+	}
+
+	progress_bar_finish(pbar);
+	progress_bar_delete(pbar);
+
+	double total_time_spent_on_unlink_local_files = 0;
+	double total_time_spent_on_prune_ancestors_of_temp_node = 0;
+	double total_time_spent_on_prune_ancestors_of_persisted_node = 0;
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
+		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
+		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
+	}
+	total_time_spent_on_unlink_local_files /= 1e6;
+	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
+	total_time_spent_on_prune_ancestors_of_persisted_node /= 1e6;
+
+	debug(D_VINE, "total time spent on prune ancestors of temp node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_temp_node);
+	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
+	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
+
+	return;
+}
+
+/**
+ * Delete a strategic orchestration graph object.
+ * @param sog Reference to the strategic orchestration graph object.
+ */
+void sog_delete(struct strategic_orchestration_graph *sog)
+{
+	if (!sog) {
+		return;
+	}
+
+	char *node_key;
+	struct vine_task_node *node;
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		if (node->infile) {
+			vine_prune_file(sog->manager, node->infile);
+			hash_table_remove(sog->manager->file_table, node->infile->cached_name);
+		}
+		if (node->outfile) {
+			vine_prune_file(sog->manager, node->outfile);
+			hash_table_remove(sog->outfile_cachename_to_node, node->outfile->cached_name);
+			hash_table_remove(sog->manager->file_table, node->outfile->cached_name);
+		}
+		vine_task_node_delete(node);
+	}
+
+	free(sog->proxy_library_name);
+	free(sog->proxy_function_name);
+
+	hash_table_delete(sog->nodes);
+	itable_delete(sog->task_id_to_node);
+	hash_table_delete(sog->outfile_cachename_to_node);
+	free(sog);
+}
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
new file mode 100644
index 0000000000..2cbbcbcce1
--- /dev/null
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
@@ -0,0 +1,132 @@
+#ifndef STRATEGIC_ORCHESTRATION_GRAPH_H
+#define STRATEGIC_ORCHESTRATION_GRAPH_H
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "list.h"
+#include "vine_manager.h"
+#include "set.h"
+#include "vine_task_node.h"
+#include "taskvine.h"
+
+
+/** Select priority algorithm for strategic orchestration graph task scheduling. */
+typedef enum {
+    TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
+    TASK_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
+    TASK_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
+    TASK_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
+    TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
+    TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
+    TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+} task_priority_mode_t;
+
+
+/** The strategic orchestration graph object (logical scheduling layer). */
+struct strategic_orchestration_graph {
+    struct vine_manager *manager;
+	struct hash_table *nodes;
+	struct itable *task_id_to_node;
+	struct hash_table *outfile_cachename_to_node;
+
+    /* Results of target keys will be stored in this directory. 
+     * This dir path can not necessarily be a shared file system directory,
+     * output files will be retrieved through the network instead,
+     * as long as the manager can access it. */
+    char *target_results_dir;
+
+    char *proxy_library_name;    // Python-side proxy library name (shared by all tasks)
+    char *proxy_function_name;   // Python-side proxy function name (shared by all tasks)
+
+    int prune_depth;
+
+    task_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
+    double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
+};
+
+
+/* Public APIs for operating the strategic orchestration graph */
+
+/** Create a strategic orchestration graph object and return it.
+@param q Reference to the current manager object.
+@return A new strategic orchestration graph object.
+*/
+struct strategic_orchestration_graph *sog_create(struct vine_manager *q);
+
+/** Create a new node in the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@param node_key Reference to the node key.
+*/
+void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key);
+
+/** Add a dependency between two nodes in the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@param parent_key Reference to the parent node key.
+@param child_key Reference to the child node key.
+*/
+void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *parent_key, const char *child_key);
+
+/** Finalize the metrics of the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+*/
+void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog);
+
+/** Get the heavy score of a node in the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@param node_key Reference to the node key.
+@return The heavy score.
+*/
+double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog, const char *node_key);
+
+/** Set the type of the node-output file.
+@param sog Reference to the strategic orchestration graph object.
+@param node_key Reference to the node key.
+@param outfile_type Reference to the output file type.
+@param outfile_remote_name Reference to the output file remote name.
+*/
+void sog_set_node_outfile(struct strategic_orchestration_graph *sog, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
+
+/** Execute the task graph.
+@param sog Reference to the strategic orchestration graph object.
+*/
+void sog_execute(struct strategic_orchestration_graph *sog);
+
+/** Get the local outfile source of a node in the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@param node_key Reference to the node key.
+@return The local outfile source.
+*/
+const char *sog_get_node_local_outfile_source(const struct strategic_orchestration_graph *sog, const char *node_key);
+
+/** Delete a strategic orchestration graph object.
+@param sog Reference to the strategic orchestration graph object.
+*/
+void sog_delete(struct strategic_orchestration_graph *sog);
+
+/** Set the Python-side proxy library name of the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@param proxy_library_name Reference to the Python-side proxy library name.
+*/
+void sog_set_proxy_library_name(struct strategic_orchestration_graph *sog, const char *proxy_library_name);
+
+/** Get the library name of the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@return The library name.
+*/
+const char *sog_get_proxy_library_name(const struct strategic_orchestration_graph *sog);
+
+/** Get the function name of the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@return The function name.
+*/
+const char *sog_get_proxy_function_name(const struct strategic_orchestration_graph *sog);
+
+/** Tune the strategic orchestration graph.
+@param sog Reference to the strategic orchestration graph object.
+@param name Reference to the name of the parameter to tune.
+@param value Reference to the value of the parameter to tune.
+@return 0 on success, -1 on failure.
+*/
+int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const char *value);
+
+#endif // STRATEGIC_ORCHESTRATION_GRAPH_H
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i b/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
new file mode 100644
index 0000000000..2ac5e9a3f4
--- /dev/null
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
@@ -0,0 +1,21 @@
+/* SWIG interface for local dagvine graph bindings */
+%module cdagvine
+
+%{
+#include "int_sizes.h"
+#include "strategic_orchestration_graph.h"
+#include "vine_task_node.h"  /* expose outfile type enum to SWIG */
+%}
+
+%include "stdint.i"
+%include "int_sizes.h"
+
+/* Import existing SWIG interface for type information (do not wrap again) */
+%import "../../bindings/python3/taskvine.i"
+
+/* Expose only the dagvine task graph APIs */
+%ignore vine_task_node_checkpoint_outfile;  /* avoid exporting unimplemented/optional symbol */
+%include "vine_task_node.h"    /* export vine_task_node_outfile_type_t values */
+%include "strategic_orchestration_graph.h"
+
+

From 0a0dd4094aa823523cb9295903d275b7dbdb4949 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 03:55:44 -0400
Subject: [PATCH 046/113] milestone

---
 taskvine/src/bindings/python3/Makefile        |   4 +-
 taskvine/src/graph/dagvine/Makefile           |   2 +-
 taskvine/src/graph/dagvine/graph_executor.py  | 114 ++--
 taskvine/src/graph/dagvine/library.py         |  74 --
 .../graph/dagvine/runtime_execution_graph.py  | 159 +----
 .../dagvine/strategic_orchestration_graph.c   | 226 ++++---
 .../dagvine/strategic_orchestration_graph.h   |  35 +-
 .../dagvine/strategic_orchestration_graph.i   |   6 +-
 taskvine/src/graph/dagvine/vine_task_node.c   | 640 ------------------
 taskvine/src/graph/dagvine/vine_task_node.h   |  77 ---
 taskvine/src/manager/vine_manager.c           |   1 +
 11 files changed, 229 insertions(+), 1109 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/library.py
 delete mode 100644 taskvine/src/graph/dagvine/vine_task_node.c
 delete mode 100644 taskvine/src/graph/dagvine/vine_task_node.h

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index c81a88efb1..3289a4da46 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -41,7 +41,9 @@ install: all
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/library.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/library.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_library.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_library.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_functions.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_functions.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/strategic_orchestration_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/strategic_orchestration_graph.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/params.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/params.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/utils.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/utils.py
 	@echo "# ${GRAPH_EXECUTOR_MODULE_NAME} package" > $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/__init__.py
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index 4286e36cad..c2e3a38236 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -6,7 +6,7 @@ LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 
  
 
-SOURCES = vine_task_node.c strategic_orchestration_graph.c
+SOURCES = strategic_orchestration_node.c strategic_orchestration_graph.c
 OBJECTS = $(SOURCES:%.c=%.o)
 
 SWIG_I = strategic_orchestration_graph.i
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
index 0554074c4f..163992ba68 100644
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ b/taskvine/src/graph/dagvine/graph_executor.py
@@ -1,11 +1,11 @@
 
 from ndcctools.taskvine import cvine
-from ndcctools.taskvine.dagvine import cdagvine
 from ndcctools.taskvine.manager import Manager
-from ndcctools.taskvine.utils import delete_all_files, get_c_constant
+from ndcctools.taskvine.utils import delete_all_files
 
-from ndcctools.taskvine.dagvine.library import Library
-from ndcctools.taskvine.dagvine.runtime_execution_graph import RuntimeExecutionGraph
+from ndcctools.taskvine.dagvine.proxy_library import ProxyLibrary
+from ndcctools.taskvine.dagvine.runtime_execution_graph import RuntimeExecutionGraph, GraphKeyResult
+from ndcctools.taskvine.dagvine.strategic_orchestration_graph import StrategicOrchestrationGraph
 
 import cloudpickle
 import os
@@ -76,9 +76,9 @@ def __init__(self):
         self.sog_tuning_params = {
             "failure-injection-step-percent": -1,
             "priority-mode": "largest-input-first",
-            "proxy-function-name": "compute_single_key",
             "prune-depth": 1,
             "target-results-dir": "./target_results",
+            "checkpoint-fraction": 0,
         }
         self.other_params = {
             "schedule": "worst",
@@ -163,42 +163,9 @@ def tune_vine_manager(self):
     def tune_sog(self, sog):
         for k, v in self.params.sog_tuning_params.items():
             print(f"Tuning {k} to {v}")
-            cdagvine.sog_tune(sog, k, str(v))
-
-    def assign_outfile_types(self, target_keys, reg, sog):
-        assert reg is not None, "Runtime execution graph must be built first"
-        assert sog is not None, "Strategic orchestration graph must be built first"
-
-        # get heavy score from C side
-        heavy_scores = {}
-        for k in reg.task_dict.keys():
-            heavy_scores[k] = cdagvine.sog_get_node_heavy_score(sog, reg.vine_key_of[k])
-
-        # sort keys by heavy score descending
-        sorted_keys = sorted(heavy_scores, key=lambda k: heavy_scores[k], reverse=True)
-
-        # determine how many go to shared FS
-        sharedfs_count = round(self.param("outfile-type")["shared-file-system"] * len(sorted_keys))
-
-        # assign outfile types
-        for i, k in enumerate(sorted_keys):
-            if k in target_keys:
-                choice = "local"
-            elif i < sharedfs_count:
-                choice = "shared-file-system"
-            else:
-                choice = "temp"
-
-            reg.set_outfile_type_of(k, choice)
-            outfile_type_enum = get_c_constant(f"NODE_OUTFILE_TYPE_{choice.upper().replace('-', '_')}")
-            cdagvine.sog_set_node_outfile(
-                sog,
-                reg.vine_key_of[k],
-                outfile_type_enum,
-                reg.outfile_remote_name[k]
-            )
-
-    def build_python_graph(self):
+            sog.tune(k, str(v))
+
+    def build_reg(self):
         reg = RuntimeExecutionGraph(
             self.task_dict,
             shared_file_system_dir=self.param("shared-file-system-dir"),
@@ -208,10 +175,12 @@ def build_python_graph(self):
 
         return reg
 
-    def build_sog(self, reg):
+    def build_sog(self, reg, target_keys):
         assert reg is not None, "Python graph must be built before building the C graph"
 
-        sog = cdagvine.sog_create(self._taskvine)
+        sog = StrategicOrchestrationGraph(self._taskvine)
+
+        sog.set_proxy_function_name("compute_single_key")
 
         # C side vine task graph must be tuned before adding nodes and dependencies
         self.tune_vine_manager()
@@ -219,59 +188,66 @@ def build_sog(self, reg):
 
         topo_order = reg.get_topological_order()
         for k in topo_order:
-            cdagvine.sog_add_node(
-                sog,
-                reg.vine_key_of[k],
-            )
-            for pk in reg.parents_of[k]:
-                cdagvine.sog_add_dependency(sog, reg.vine_key_of[pk], reg.vine_key_of[k])
+            sog.add_node(reg.sog_node_key_of[k], int(k in target_keys))
+            for pk in reg.parents_of[k]:      #!!!!!!!!!!!!!!!!!!!!!!! TODO: fix sog-reg key mapping
+                sog.add_dependency(reg.sog_node_key_of[pk], reg.sog_node_key_of[k])
 
-        cdagvine.sog_compute_topology_metrics(sog)
+        sog.compute_topology_metrics()
 
         return sog
 
     def build_graphs(self, target_keys):
         # build Python DAG (logical topology)
-        reg = self.build_python_graph()
-
+        reg = self.build_reg()
         # build C DAG (physical topology)
-        sog = self.build_sog(reg)
+        sog = self.build_sog(reg, target_keys)
 
-        # assign outfile types
-        self.assign_outfile_types(target_keys, reg, sog)
+        # set outfile remote names in reg from sog, note that these names are automatically generated
+        # with regard to the checkpointing strategy and the shared file system directory
+        for sog_node_key in reg.sog_node_key_of.values():
+            outfile_remote_name = sog.get_node_outfile_remote_name(sog_node_key)
+            reg.set_outfile_remote_name_of(reg.reg_node_key_of[sog_node_key], outfile_remote_name)
 
         return reg, sog
 
-    def run(self, collection_dict, target_keys=None, params={}, hoisting_modules=[], env_files={}):
+    def create_proxy_library(self, reg, sog, hoisting_modules, env_files):
+        proxy_library = ProxyLibrary(self)
+        proxy_library.add_hoisting_modules(hoisting_modules)
+        proxy_library.add_env_files(env_files)
+        proxy_library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
+        proxy_library.set_libcores(self.param("libcores"))
+        proxy_library.set_name(sog.get_proxy_library_name())
+        proxy_library.install()
+
+        return proxy_library
+
+    def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}):
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
         self.task_dict = ensure_task_dict(collection_dict)
-        
-        # build graphs in both Python and C sides
+
+        # build graphs from both sides
         reg, sog = self.build_graphs(target_keys)
 
-        # create and install the library template on the manager
-        library = Library(self, self.param("libcores"))
-        library.add_hoisting_modules(hoisting_modules)
-        library.add_env_files(env_files)
-        library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
-        library.install()
-        cdagvine.sog_set_proxy_library_name(sog, library.get_name())
+        # create and install the proxy library on the manager
+        proxy_library = self.create_proxy_library(reg, sog, hoisting_modules, env_files)
 
         # execute the graph on the C side
         print(f"Executing task graph, logs will be written to {self.runtime_directory}")
-        cdagvine.sog_execute(sog)
+        sog.execute()
 
         # clean up the library instances and template on the manager
-        library.uninstall()
+        proxy_library.uninstall()
+
         # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
-        cdagvine.sog_delete(sog)
+        sog.delete()
 
         # load results of target keys
         results = {}
         for k in target_keys:
-            results[k] = reg.load_result_of_key(k, target_results_dir=self.param("target-results-dir"))
+            outfile_path = os.path.join(self.param("target-results-dir"), reg.outfile_remote_name[k])
+            results[k] = GraphKeyResult.load_from_path(outfile_path)
         return results
 
     def _on_sigint(self, signum, frame):
diff --git a/taskvine/src/graph/dagvine/library.py b/taskvine/src/graph/dagvine/library.py
deleted file mode 100644
index f5158d6656..0000000000
--- a/taskvine/src/graph/dagvine/library.py
+++ /dev/null
@@ -1,74 +0,0 @@
-import os, uuid, cloudpickle, types, time, random, hashlib, collections
-from ndcctools.taskvine.dagvine.runtime_execution_graph import (
-    GraphKeyResult, RuntimeExecutionGraph, compute_dts_key, compute_sexpr_key, 
-    compute_single_key, hash_name, hashable
-)
-from ndcctools.taskvine.utils import load_variable_from_library
-
-
-class Library:
-    def __init__(self, py_manager, libcores):
-        self.py_manager = py_manager
-        self.libname = f"proxy-library-{str(uuid.uuid4())}"
-
-        self.libcores = libcores
-        assert self.libcores is not None, "libcores must be provided"
-
-        self.libtask = None
-
-        # these modules are always included in the preamble of the library task, so that function calls can execute directly
-        # using the loaded context without importing them over and over again
-        self.hoisting_modules = [
-            os, cloudpickle, GraphKeyResult, RuntimeExecutionGraph, uuid, hashlib, random, types, collections, time,
-            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
-        ]
-
-        # environment files serve as additional inputs to the library task, where each key is the local path and the value is the remote path
-        # those local files will be sent remotely to the workers so tasks can access them as appropriate
-        self.env_files = {}
-
-        # context loader is a function that will be used to load the library context on remote nodes.
-        self.context_loader_func = None
-        self.context_loader_args = []
-        self.context_loader_kwargs = {}
-
-        self.local_path = None
-        self.remote_path = None
-
-    def get_name(self):
-        return self.libname
-
-    def add_hoisting_modules(self, new_modules):
-        assert isinstance(new_modules, list), "new_modules must be a list of modules"
-        self.hoisting_modules.extend(new_modules)
-
-    def add_env_files(self, new_env_files):
-        assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
-        self.env_files.update(new_env_files)
-
-    def set_context_loader(self, context_loader_func, context_loader_args=[], context_loader_kwargs={}):
-        self.context_loader_func = context_loader_func
-        self.context_loader_args = context_loader_args
-        self.context_loader_kwargs = context_loader_kwargs
-
-    def install(self):
-        self.libtask = self.py_manager.create_library_from_functions(
-            self.libname,
-            compute_single_key,
-            library_context_info=[self.context_loader_func, self.context_loader_args, self.context_loader_kwargs],
-            add_env=False,
-            function_infile_load_mode="json",
-            hoisting_modules=self.hoisting_modules,
-        )
-        for local, remote in self.env_files.items():
-            # check if the local file exists
-            if not os.path.exists(local):
-                raise FileNotFoundError(f"Local file {local} not found")
-            # attach as the input file to the library task
-            self.libtask.add_input(self.py_manager.declare_file(local, cache=True, peer_transfer=True), remote)
-        self.libtask.set_cores(self.libcores)
-        self.libtask.set_function_slots(self.libcores)
-        self.py_manager.install_library(self.libtask)
-
-    def uninstall(self):
-        self.py_manager.remove_library(self.libname)
diff --git a/taskvine/src/graph/dagvine/runtime_execution_graph.py b/taskvine/src/graph/dagvine/runtime_execution_graph.py
index 24e246f152..4e4f7c81b5 100644
--- a/taskvine/src/graph/dagvine/runtime_execution_graph.py
+++ b/taskvine/src/graph/dagvine/runtime_execution_graph.py
@@ -2,8 +2,6 @@
 # This software is distributed under the GNU General Public License.
 # See the file COPYING for details.
 
-from ndcctools.taskvine.utils import load_variable_from_library
-
 import os
 import hashlib
 import time
@@ -90,6 +88,16 @@ def __init__(self, result, extra_size_mb=None):
         self.result = result
         self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
 
+    @staticmethod
+    def load_from_path(path):
+        try:
+            with open(path, "rb") as f:
+                result_obj = cloudpickle.load(f)
+                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
+                return result_obj.result
+        except FileNotFoundError:
+            raise FileNotFoundError(f"Output file not found at {path}")
+
 
 class RuntimeExecutionGraph:
     """
@@ -117,22 +125,16 @@ def __init__(self, task_dict,
         self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
         self.depth_of = self._calculate_depths()
 
-        self.vine_key_of = {k: hash_name(k) for k in task_dict.keys()}
-        self.key_of_vine_key = {hash_name(k): k for k in task_dict.keys()}
+        self.sog_node_key_of = {k: hash_name(k) for k in task_dict.keys()}
+        self.reg_node_key_of = {hash_name(k): k for k in task_dict.keys()}
 
-        self.outfile_remote_name = {key: f"{uuid.uuid4()}.pkl" for key in self.task_dict.keys()}
-        self.outfile_type = {key: None for key in self.task_dict.keys()}
+        # will be set from sog
+        self.outfile_remote_name = {key: None for key in self.task_dict.keys()}
 
         # testing params
         self.extra_task_output_size_mb = self._calculate_extra_size_mb_of(extra_task_output_size_mb)
         self.extra_sleep_time_of = self._calculate_extra_sleep_time_of(extra_task_sleep_time)
 
-    def set_outfile_type_of(self, k, outfile_type_str):
-        assert outfile_type_str in ["local", "shared-file-system", "temp"]
-        self.outfile_type[k] = outfile_type_str
-        if outfile_type_str == "shared-file-system":
-            self.outfile_remote_name[k] = os.path.join(self.shared_file_system_dir, self.outfile_remote_name[k])
-
     def _calculate_extra_size_mb_of(self, extra_task_output_size_mb):
         assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 3
         mode, low, high = extra_task_output_size_mb
@@ -224,24 +226,12 @@ def save_result_of_key(self, key, result):
             result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
             cloudpickle.dump(result_obj, f)
 
-    def load_result_of_key(self, key, target_results_dir=None):
-        if self.outfile_type[key] == "local":
-            # nodes with local outfile type will have their results stored in the target results directory
-            # when the execution is done, users can call this function to load the results from the target results directory
-            # note that data is transferred through the link in sequence, not in parallel through the shared file system
-            outfile_path = os.path.join(target_results_dir, self.outfile_remote_name[key])
-        else:
-            # workers user this branch to load results from either local or shared file system
-            # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
-            # if a shared file system output, then remote name is the full path to the file
-            outfile_path = self.outfile_remote_name[key]
-        try:
-            with open(outfile_path, "rb") as f:
-                result_obj = cloudpickle.load(f)
-                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
-                return result_obj.result
-        except FileNotFoundError:
-            raise FileNotFoundError(f"Output file for key {key} not found at {outfile_path}")
+    def load_result_of_key(self, key):
+        # workers user this function to load results from either local or shared file system
+        # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
+        # if a shared file system output, then remote name is the full path to the file
+        outfile_path = self.outfile_remote_name[key]
+        return GraphKeyResult.load_from_path(outfile_path)
 
     def get_topological_order(self):
         in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
@@ -264,12 +254,6 @@ def get_topological_order(self):
 
         return topo_order
 
-    def __del__(self):
-        if hasattr(self, 'outfile_remote_name') and self.outfile_remote_name:
-            for k in self.outfile_remote_name.keys():
-                if self.outfile_type.get(k) == "shared-file-system" and os.path.exists(self.outfile_remote_name[k]):
-                    os.remove(self.outfile_remote_name[k])
-
     @staticmethod
     def context_loader_func(reg_pkl):
         reg = cloudpickle.loads(reg_pkl)
@@ -281,106 +265,3 @@ def context_loader_func(reg_pkl):
             "reg": reg,
         }
 
-
-def compute_dts_key(reg, k, v):
-    """
-    Compute the result of a Dask task node from dask._task_spec.
-
-    Each value `v` may be an instance of Task, Alias, or DataNode, all of which
-    inherit from the same base class. The `dependencies` field is a frozenset
-    containing direct dependencies only (no recursive ancestry).
-
-    The function resolves each dependency from the reg, constructs an
-    input dictionary, and then executes the node according to its type.
-    """
-    try:
-        import dask._task_spec as dts
-    except ImportError:
-        raise ImportError("Dask is not installed")
-
-    input_dict = {dep: reg.load_result_of_key(dep) for dep in v.dependencies}
-
-    try:
-        if isinstance(v, dts.Alias):
-            assert len(v.dependencies) == 1, "Expected exactly one dependency"
-            return reg.load_result_of_key(next(iter(v.dependencies)))
-        elif isinstance(v, dts.Task):
-            return v(input_dict)
-        elif isinstance(v, dts.DataNode):
-            return v.value
-        else:
-            raise TypeError(f"unexpected node type: {type(v)} for key {k}")
-    except Exception as e:
-        raise Exception(f"Error while executing task {k}: {e}")
-
-
-def compute_sexpr_key(reg, k, v):
-    """
-    Evaluate a symbolic expression (S-expression) task within the task graph.
-
-    Both DAGVine and legacy Dask represent computations as symbolic
-    expression trees (S-expressions). Each task value `v` encodes a nested
-    structure where:
-      - Leaf nodes are constants or task keys referencing parent results.
-      - Lists are recursively evaluated.
-      - Tuples of the form (func, arg1, arg2, ...) represent function calls.
-
-    This function builds an input dictionary from all parent keys, then
-    recursively resolves and executes the expression until a final value
-    is produced.
-    """
-    input_dict = {parent: reg.load_result_of_key(parent) for parent in reg.parents_of[k]}
-
-    def _rec_call(expr):
-        try:
-            if expr in input_dict.keys():
-                return input_dict[expr]
-        except TypeError:
-            pass
-        if isinstance(expr, list):
-            return [_rec_call(e) for e in expr]
-        if isinstance(expr, tuple) and len(expr) > 0 and callable(expr[0]):
-            res = expr[0](*[_rec_call(a) for a in expr[1:]])
-            return res
-        return expr
-
-    try:
-        return _rec_call(v)
-    except Exception as e:
-        raise Exception(f"Failed to invoke _rec_call(): {e}")
-
-
-def compute_single_key(vine_key):
-    """
-    Compute a single task identified by a Vine key within the current RuntimeExecutionGraph.
-
-    The function retrieves the corresponding graph key and task object from the
-    global reg, determines the task type, and dispatches to the appropriate
-    execution interface — e.g., `compute_dts_key` for Dask-style task specs or
-    `compute_sexpr_key` for S-expression graphs.
-
-    This design allows extensibility: for new graph representations, additional
-    compute interfaces can be introduced and registered here to handle new key types.
-
-    After computation, the result is saved, the output file is validated, and
-    an optional delay (`extra_sleep_time_of`) is applied before returning.
-    """
-    reg = load_variable_from_library('reg')
-
-    k = reg.key_of_vine_key[vine_key]
-    v = reg.task_dict[k]
-
-    if reg.is_dts_key(k):
-        result = compute_dts_key(reg, k, v)
-    else:
-        result = compute_sexpr_key(reg, k, v)
-
-    reg.save_result_of_key(k, result)
-    if not os.path.exists(reg.outfile_remote_name[k]):
-        raise Exception(f"Output file {reg.outfile_remote_name[k]} does not exist after writing")
-    if os.stat(reg.outfile_remote_name[k]).st_size == 0:
-        raise Exception(f"Output file {reg.outfile_remote_name[k]} is empty after writing")
-
-    time.sleep(reg.extra_sleep_time_of[k])
-
-    return True
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
index c9c84eb9d2..45a6e2246b 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
@@ -20,10 +20,11 @@
 #include "timestamp.h"
 #include "progress_bar.h"
 #include "macros.h"
+#include "uuid.h"
 
+#include "strategic_orchestration_node.h"
 #include "strategic_orchestration_graph.h"
 #include "vine_manager.h"
-#include "vine_task_node.h"
 #include "vine_worker_info.h"
 #include "vine_task.h"
 #include "vine_file.h"
@@ -52,7 +53,7 @@ static void handle_sigint(int signal)
  * @param priority_mode Reference to the priority mode.
  * @return The priority.
  */
-static double vine_task_node_calculate_priority(struct vine_task_node *node, task_priority_mode_t priority_mode)
+static double calculate_task_priority(struct strategic_orchestration_node *node, task_priority_mode_t priority_mode)
 {
 	if (!node) {
 		return 0;
@@ -61,7 +62,7 @@ static double vine_task_node_calculate_priority(struct vine_task_node *node, tas
 	double priority = 0;
 	timestamp_t current_time = timestamp_get();
 
-	struct vine_task_node *parent_node;
+	struct strategic_orchestration_node *parent_node;
 
 	switch (priority_mode) {
 	case TASK_PRIORITY_MODE_RANDOM:
@@ -108,20 +109,24 @@ static double vine_task_node_calculate_priority(struct vine_task_node *node, tas
  * @param sog Reference to the strategic orchestration graph object.
  * @param node Reference to the node object.
  */
-static void submit_node_task(struct strategic_orchestration_graph *sog, struct vine_task_node *node)
+static void submit_node_task(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
 {
 	if (!sog || !node) {
 		return;
 	}
 
 	/* calculate the priority of the node */
-	double priority = vine_task_node_calculate_priority(node, sog->task_priority_mode);
+	double priority = calculate_task_priority(node, sog->task_priority_mode);
 	vine_task_set_priority(node->task, priority);
+
 	/* submit the task to the manager */
 	int task_id = vine_submit(sog->manager, node->task);
+
 	/* insert the task id to the task id to node map */
 	itable_insert(sog->task_id_to_node, task_id, node);
 
+	debug(D_VINE, "submitted node %s with task id %d", node->node_key, task_id);
+
 	return;
 }
 
@@ -130,13 +135,13 @@ static void submit_node_task(struct strategic_orchestration_graph *sog, struct v
  * @param sog Reference to the strategic orchestration graph object.
  * @param node Reference to the node object.
  */
-static void submit_unblocked_children(struct strategic_orchestration_graph *sog, struct vine_task_node *node)
+static void submit_unblocked_children(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
 {
 	if (!sog || !node) {
 		return;
 	}
 
-	struct vine_task_node *child_node; 
+	struct strategic_orchestration_node *child_node; 
 	LIST_ITERATE(node->children, child_node)
 	{
 		/* Remove this parent from the child's pending set if it exists */
@@ -176,7 +181,7 @@ static struct list *get_topological_order(struct strategic_orchestration_graph *
 	struct priority_queue *pq = priority_queue_create(total_nodes);
 
 	char *key;
-	struct vine_task_node *node;
+	struct strategic_orchestration_node *node;
 	HASH_TABLE_ITERATE(sog->nodes, key, node)
 	{
 		int deg = list_size(node->parents);
@@ -187,10 +192,10 @@ static struct list *get_topological_order(struct strategic_orchestration_graph *
 	}
 
 	while (priority_queue_size(pq) > 0) {
-		struct vine_task_node *current = priority_queue_pop(pq);
+		struct strategic_orchestration_node *current = priority_queue_pop(pq);
 		list_push_tail(topo_order, current);
 
-		struct vine_task_node *child;
+		struct strategic_orchestration_node *child;
 		LIST_ITERATE(current->children, child)
 		{
 			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, child->node_key);
@@ -215,7 +220,7 @@ static struct list *get_topological_order(struct strategic_orchestration_graph *
 			int deg = (int)raw_deg;
 			if (deg > 0) {
 				debug(D_ERROR, "  Node %s has in-degree %d. Parents:\n", key, deg);
-				struct vine_task_node *p;
+				struct strategic_orchestration_node *p;
 				LIST_ITERATE(node->parents, p)
 				{
 					debug(D_ERROR, "    -> %s\n", p->node_key);
@@ -250,7 +255,7 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
 	struct list *components = list_create();
 
 	char *node_key;
-	struct vine_task_node *node;
+	struct strategic_orchestration_node *node;
 	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 	{
 		if (set_lookup(visited, node)) {
@@ -265,9 +270,9 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
 		list_push_tail(component, node);
 
 		while (list_size(queue) > 0) {
-			struct vine_task_node *curr = list_pop_head(queue);
+			struct strategic_orchestration_node *curr = list_pop_head(queue);
 
-			struct vine_task_node *p;
+			struct strategic_orchestration_node *p;
 			LIST_ITERATE(curr->parents, p)
 			{
 				if (!set_lookup(visited, p)) {
@@ -277,7 +282,7 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
 				}
 			}
 
-			struct vine_task_node *c;
+			struct strategic_orchestration_node *c;
 			LIST_ITERATE(curr->children, c)
 			{
 				if (!set_lookup(visited, c)) {
@@ -301,7 +306,7 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
  * @param node Reference to the node object.
  * @return The heavy score.
  */
-static double compute_node_heavy_score(struct vine_task_node *node)
+static double compute_node_heavy_score(struct strategic_orchestration_node *node)
 {
 	if (!node) {
 		return 0;
@@ -319,7 +324,7 @@ static double compute_node_heavy_score(struct vine_task_node *node)
  * @param task Reference to the task object.
  * @return The node object.
  */
-static struct vine_task_node *get_node_by_task(struct strategic_orchestration_graph *sog, struct vine_task *task)
+static struct strategic_orchestration_node *get_node_by_task(struct strategic_orchestration_graph *sog, struct vine_task *task)
 {
 	if (!sog || !task) {
 		return NULL;
@@ -394,15 +399,17 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		}
 		sog->target_results_dir = xxstrdup(value);
 
-	} else if (strcmp(name, "proxy-function-name") == 0) {
-		if (sog->proxy_function_name) {
-			free(sog->proxy_function_name);
-		}
-		sog->proxy_function_name = xxstrdup(value);
-
 	} else if (strcmp(name, "prune-depth") == 0) {
 		sog->prune_depth = atoi(value);
 		
+	} else if (strcmp(name, "checkpoint-fraction") == 0) {
+		double fraction = atof(value);
+		if (fraction < 0.0 || fraction > 1.0) {
+			debug(D_ERROR, "invalid checkpoint fraction: %s (must be between 0.0 and 1.0)", value);
+			return -1;
+		}
+		sog->checkpoint_fraction = fraction;
+
 	} else {
 		debug(D_ERROR, "invalid parameter name: %s", name);
 		return -1;
@@ -412,23 +419,30 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 	return 0;
 }
 
-void sog_set_proxy_library_name(struct strategic_orchestration_graph *sog, const char *proxy_library_name)
+/**
+ * Get the outfile remote name of a node in the strategic orchestration graph.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node_key Reference to the node key.
+ * @return The outfile remote name.
+ */
+const char *sog_get_node_outfile_remote_name(const struct strategic_orchestration_graph *sog, const char *node_key)
 {
-	if (!sog || !proxy_library_name) {
-		return;
+	if (!sog || !node_key) {
+		return NULL;
 	}
 
-	if (sog->proxy_library_name) {
-		free(sog->proxy_library_name);
+	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
+	if (!node) {
+		return NULL;
 	}
 
-	sog->proxy_library_name = xxstrdup(proxy_library_name);
+	return node->outfile_remote_name;
 }
 
 /**
- * Get the proxy library name (Python-side), shared by all tasks.
+ * Get the proxy library name of the strategic orchestration graph.
  * @param sog Reference to the strategic orchestration graph object.
- * @return The library name.
+ * @return The proxy library name.
  */
 const char *sog_get_proxy_library_name(const struct strategic_orchestration_graph *sog)
 {
@@ -440,17 +454,21 @@ const char *sog_get_proxy_library_name(const struct strategic_orchestration_grap
 }
 
 /**
- * Get the proxy function name (Python-side), shared by all tasks.
+ * Set the proxy function name of the strategic orchestration graph.
  * @param sog Reference to the strategic orchestration graph object.
- * @return The function name.
+ * @param proxy_function_name Reference to the proxy function name.
  */
-const char *sog_get_proxy_function_name(const struct strategic_orchestration_graph *sog)
+void sog_set_proxy_function_name(struct strategic_orchestration_graph *sog, const char *proxy_function_name)
 {
-	if (!sog) {
-		return NULL;
+	if (!sog || !proxy_function_name) {
+		return;
 	}
 
-	return sog->proxy_function_name;
+	if (sog->proxy_function_name) {
+		free(sog->proxy_function_name);
+	}
+
+	sog->proxy_function_name = xxstrdup(proxy_function_name);
 }
 
 /**
@@ -465,7 +483,7 @@ double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog,
 		return -1;
 	}
 
-	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
 	if (!node) {
 		return -1;
 	}
@@ -486,7 +504,7 @@ const char *sog_get_node_local_outfile_source(const struct strategic_orchestrati
 		return NULL;
 	}
 
-	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
 	if (!node) {
 		debug(D_ERROR, "node %s not found", node_key);
 		exit(1);
@@ -502,7 +520,7 @@ const char *sog_get_node_local_outfile_source(const struct strategic_orchestrati
 
 /**
  * Compute the topology metrics of the strategic orchestration graph, including depth, height, upstream and downstream counts,
- * heavy scores, and weakly connected components.
+ * heavy scores, and weakly connected components. Must be called after all nodes and dependencies are added.
  * @param sog Reference to the strategic orchestration graph object.
  */
 void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
@@ -518,9 +536,9 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 	}
 
 	char *node_key;
-	struct vine_task_node *node;
-	struct vine_task_node *parent_node;
-	struct vine_task_node *child_node;
+	struct strategic_orchestration_node *node;
+	struct strategic_orchestration_node *parent_node;
+	struct strategic_orchestration_node *child_node;
 
 	/* compute the depth of the node */
 	LIST_ITERATE(topo_order, node)
@@ -594,6 +612,57 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 		node->heavy_score = compute_node_heavy_score(node);
 	}
 
+	/* sort nodes using priority queue */
+	int total_nodes = list_size(topo_order);
+	int total_target_nodes = 0;
+	struct priority_queue *sorted_nodes = priority_queue_create(total_nodes);
+	LIST_ITERATE(topo_order, node)
+	{
+		if (node->is_target_key) {
+			total_target_nodes++;
+		}
+		priority_queue_push(sorted_nodes, node, node->heavy_score);
+	}
+	/* calculate the number of nodes to be checkpointed */
+	int checkpoint_count = (int)((total_nodes - total_target_nodes) * sog->checkpoint_fraction);
+	if (checkpoint_count < 0) {
+		checkpoint_count = 0;
+	}
+
+	/* assign outfile types to each node */
+	int assigned_checkpoint_count = 0;
+	while ((node = priority_queue_pop(sorted_nodes))) {
+		if (node->is_target_key) {
+			/* declare the output file as a vine_file so that it can be retrieved by the manager as usual */
+			node->outfile_type = VINE_NODE_OUTFILE_TYPE_LOCAL;
+			char *local_outfile_path = string_format("%s/%s", sog->target_results_dir, node->outfile_remote_name);
+			node->outfile = vine_declare_file(node->manager, local_outfile_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
+			free(local_outfile_path);
+			continue;
+		}
+		if (assigned_checkpoint_count < checkpoint_count) {
+			/* checkpointed files will be written directly to the shared file system, no need to manage them in the manager */
+			node->outfile_type = VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM;
+			char *shared_file_system_outfile_path = string_format("%s/%s", sog->target_results_dir, node->outfile_remote_name);
+			free(node->outfile_remote_name);
+			node->outfile_remote_name = shared_file_system_outfile_path;
+			node->outfile = NULL;
+			assigned_checkpoint_count++;
+		} else {
+			/* other nodes will be declared as temp files to leverage node-local storage */
+			node->outfile_type = VINE_NODE_OUTFILE_TYPE_TEMP;
+			node->outfile = vine_declare_temp(sog->manager);
+		}
+	}
+	/* track the output dependencies of regular and vine_temp nodes */
+	LIST_ITERATE(topo_order, node)
+	{
+		if (node->outfile) {
+			vine_task_add_output(node->task, node->outfile, node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
+		}
+	}
+	priority_queue_delete(sorted_nodes);
+
 	/* extract weakly connected components */
 	struct list *weakly_connected_components = extract_weakly_connected_components(sog);
 	struct list *component;
@@ -616,19 +685,21 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
  * Create a new node and track it in the strategic orchestration graph.
  * @param sog Reference to the strategic orchestration graph object.
  * @param node_key Reference to the node key.
+ * @param is_target_key Reference to whether the node is a target key.
  * @return A new node object.
  */
-void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key)
+void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key, int is_target_key)
 {
 	if (!sog || !node_key) {
 		return;
 	}
 
 	/* if the node already exists, skip creating a new one */
-	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
+	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
 	if (!node) {
-		node = vine_task_node_create(sog->manager,
+		node = son_create(sog->manager,
 				node_key,
+				is_target_key,
 				sog->proxy_library_name,
 				sog->proxy_function_name,
 				sog->target_results_dir,
@@ -651,6 +722,10 @@ void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_ke
  */
 struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
 {
+	if (!q) {
+		return NULL;
+	}
+
 	struct strategic_orchestration_graph *sog = xxmalloc(sizeof(struct strategic_orchestration_graph));
 
 	sog->manager = q;
@@ -660,7 +735,11 @@ struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
 	sog->outfile_cachename_to_node = hash_table_create(0, 0);
 
 	sog->target_results_dir = xxstrdup(sog->manager->runtime_directory);  // default to current working directory
-	sog->proxy_library_name = NULL;
+
+	cctools_uuid_t proxy_library_name_id;
+	cctools_uuid_create(&proxy_library_name_id);
+	sog->proxy_library_name = xxstrdup(proxy_library_name_id.str);
+
 	sog->proxy_function_name = NULL;
 
 	sog->prune_depth = 1;
@@ -690,12 +769,12 @@ void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *p
 		return;
 	}
 
-	struct vine_task_node *parent_node = hash_table_lookup(sog->nodes, parent_key);
-	struct vine_task_node *child_node = hash_table_lookup(sog->nodes, child_key);
+	struct strategic_orchestration_node *parent_node = hash_table_lookup(sog->nodes, parent_key);
+	struct strategic_orchestration_node *child_node = hash_table_lookup(sog->nodes, child_key);
 	if (!parent_node) {
 		debug(D_ERROR, "parent node %s not found", parent_key);
 		char *node_key = NULL;
-		struct vine_task_node *node;
+		struct strategic_orchestration_node *node;
 		printf("parent_keys:\n");
 		HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 		{
@@ -714,30 +793,6 @@ void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *p
 	return;
 }
 
-/**
- * Set the outfile of a node in the strategic orchestration graph.
- * This involves declaring the output file and adding it to the task.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node_key Reference to the node key.
- * @param outfile_type Reference to the outfile type.
- * @param outfile_remote_name Reference to the outfile remote name that the task will generate remotely.
- */
-void sog_set_node_outfile(struct strategic_orchestration_graph *sog, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
-{
-	if (!sog || !node_key || !outfile_remote_name) {
-		return;
-	}
-
-	struct vine_task_node *node = hash_table_lookup(sog->nodes, node_key);
-	if (!node) {
-		return;
-	}
-
-	vine_task_node_set_outfile(node, outfile_type, outfile_remote_name);
-
-	return;
-}
-
 /**
  * Execute the strategic orchestration graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
  * @param sog Reference to the strategic orchestration graph object.
@@ -754,10 +809,10 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 	/* print the info of all nodes */
 	char *node_key;
-	struct vine_task_node *node;
+	struct strategic_orchestration_node *node;
 	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 	{
-		vine_task_node_print_info(node);
+		son_print_info(node);
 	}
 
 	/* enable return recovery tasks */
@@ -775,7 +830,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	struct list *topo_order = get_topological_order(sog);
 	LIST_ITERATE(topo_order, node)
 	{
-		struct vine_task_node *parent_node;
+		struct strategic_orchestration_node *parent_node;
 		LIST_ITERATE(node->parents, parent_node)
 		{
 			if (parent_node->outfile) {
@@ -787,7 +842,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	/* initialize pending_parents for all nodes */
 	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 	{
-		struct vine_task_node *parent_node;
+		struct strategic_orchestration_node *parent_node;
 		LIST_ITERATE(node->parents, parent_node)
 		{
 			if (node->pending_parents) {
@@ -831,7 +886,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			wait_timeout = 0;
 
 			/* get the original node by task id */
-			struct vine_task_node *node = get_node_by_task(sog, task);
+			struct strategic_orchestration_node *node = get_node_by_task(sog, task);
 			if (!node) {
 				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
 				exit(1);
@@ -882,7 +937,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			node->completed = 1;
 
 			/* prune nodes on task completion */
-			vine_task_node_prune_ancestors(node);
+			son_prune_ancestors(node);
 
 			/* skip recovery tasks */
 			if (task->type == VINE_TASK_TYPE_RECOVERY) {
@@ -896,7 +951,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			}
 
 			/* update critical time */
-			vine_task_node_update_critical_time(node, task->time_workers_execute_last);
+			son_update_critical_time(node, task->time_workers_execute_last);
 
 			/* mark this regular task as completed */
 			progress_bar_update_part(pbar, regular_tasks_part, 1);
@@ -913,7 +968,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			/* enqueue the output file for replication */
 			switch (node->outfile_type) {
 			case VINE_NODE_OUTFILE_TYPE_TEMP:
-				vine_task_node_replicate_outfile(node);
+				son_replicate_outfile(node);
 				break;
 			case VINE_NODE_OUTFILE_TYPE_LOCAL:
 			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
@@ -962,7 +1017,7 @@ void sog_delete(struct strategic_orchestration_graph *sog)
 	}
 
 	char *node_key;
-	struct vine_task_node *node;
+	struct strategic_orchestration_node *node;
 	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 	{
 		if (node->infile) {
@@ -974,7 +1029,10 @@ void sog_delete(struct strategic_orchestration_graph *sog)
 			hash_table_remove(sog->outfile_cachename_to_node, node->outfile->cached_name);
 			hash_table_remove(sog->manager->file_table, node->outfile->cached_name);
 		}
-		vine_task_node_delete(node);
+		if (node->outfile_type == VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM) {
+			unlink(node->outfile_remote_name);
+		}
+		son_delete(node);
 	}
 
 	free(sog->proxy_library_name);
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
index 2cbbcbcce1..db8009c9fa 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
@@ -6,7 +6,7 @@
 #include "list.h"
 #include "vine_manager.h"
 #include "set.h"
-#include "vine_task_node.h"
+#include "strategic_orchestration_node.h"
 #include "taskvine.h"
 
 
@@ -39,6 +39,7 @@ struct strategic_orchestration_graph {
     char *proxy_function_name;   // Python-side proxy function name (shared by all tasks)
 
     int prune_depth;
+    double checkpoint_fraction;  // 0 - 1, the fraction of intermediate results to checkpoint
 
     task_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
     double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
@@ -56,8 +57,9 @@ struct strategic_orchestration_graph *sog_create(struct vine_manager *q);
 /** Create a new node in the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
 @param node_key Reference to the node key.
+@param is_target_key Reference to whether the node is a target key.
 */
-void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key);
+void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key, int is_target_key);
 
 /** Add a dependency between two nodes in the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
@@ -78,18 +80,17 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog);
 */
 double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog, const char *node_key);
 
-/** Set the type of the node-output file.
+/** Execute the task graph.
 @param sog Reference to the strategic orchestration graph object.
-@param node_key Reference to the node key.
-@param outfile_type Reference to the output file type.
-@param outfile_remote_name Reference to the output file remote name.
 */
-void sog_set_node_outfile(struct strategic_orchestration_graph *sog, const char *node_key, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
+void sog_execute(struct strategic_orchestration_graph *sog);
 
-/** Execute the task graph.
+/** Get the outfile remote name of a node in the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
+@param node_key Reference to the node key.
+@return The outfile remote name.
 */
-void sog_execute(struct strategic_orchestration_graph *sog);
+const char *sog_get_node_outfile_remote_name(const struct strategic_orchestration_graph *sog, const char *node_key);
 
 /** Get the local outfile source of a node in the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
@@ -103,23 +104,17 @@ const char *sog_get_node_local_outfile_source(const struct strategic_orchestrati
 */
 void sog_delete(struct strategic_orchestration_graph *sog);
 
-/** Set the Python-side proxy library name of the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param proxy_library_name Reference to the Python-side proxy library name.
-*/
-void sog_set_proxy_library_name(struct strategic_orchestration_graph *sog, const char *proxy_library_name);
-
-/** Get the library name of the strategic orchestration graph.
+/** Get the proxy library name of the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
-@return The library name.
+@return The proxy library name.
 */
 const char *sog_get_proxy_library_name(const struct strategic_orchestration_graph *sog);
 
-/** Get the function name of the strategic orchestration graph.
+/** Set the proxy function name of the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
-@return The function name.
+@param proxy_function_name Reference to the proxy function name.
 */
-const char *sog_get_proxy_function_name(const struct strategic_orchestration_graph *sog);
+void sog_set_proxy_function_name(struct strategic_orchestration_graph *sog, const char *proxy_function_name);
 
 /** Tune the strategic orchestration graph.
 @param sog Reference to the strategic orchestration graph object.
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i b/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
index 2ac5e9a3f4..86295b3949 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
@@ -3,8 +3,8 @@
 
 %{
 #include "int_sizes.h"
+#include "strategic_orchestration_node.h"
 #include "strategic_orchestration_graph.h"
-#include "vine_task_node.h"  /* expose outfile type enum to SWIG */
 %}
 
 %include "stdint.i"
@@ -13,9 +13,7 @@
 /* Import existing SWIG interface for type information (do not wrap again) */
 %import "../../bindings/python3/taskvine.i"
 
-/* Expose only the dagvine task graph APIs */
-%ignore vine_task_node_checkpoint_outfile;  /* avoid exporting unimplemented/optional symbol */
-%include "vine_task_node.h"    /* export vine_task_node_outfile_type_t values */
+%include "strategic_orchestration_node.h"
 %include "strategic_orchestration_graph.h"
 
 
diff --git a/taskvine/src/graph/dagvine/vine_task_node.c b/taskvine/src/graph/dagvine/vine_task_node.c
deleted file mode 100644
index 0539c59f94..0000000000
--- a/taskvine/src/graph/dagvine/vine_task_node.c
+++ /dev/null
@@ -1,640 +0,0 @@
-#include <assert.h>
-#include <inttypes.h>
-#include <stdlib.h>
-#include <unistd.h>
-#include <string.h>
-#include <sys/types.h>
-#include <sys/stat.h>
-
-#include "jx.h"
-#include "jx_print.h"
-#include "xxmalloc.h"
-#include "stringtools.h"
-#include "timestamp.h"
-#include "set.h"
-#include "hash_table.h"
-#include "debug.h"
-#include "random.h"
-
-#include "vine_manager.h"
-#include "vine_file.h"
-#include "vine_task.h"
-#include "vine_worker_info.h"
-#include "vine_temp.h"
-#include "vine_task_node.h"
-#include "taskvine.h"
-
-
-/**
- * Compute a lexicographic priority score from the node key.
- * Used during topological sorting to break ties deterministically.
- * @param key Reference to the node key.
- * @return The lexical priority.
- */
-double compute_lex_priority(const char *key)
-{
-	double score = 0.0;
-	double factor = 1.0;
-	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
-		score += (unsigned char)key[i] * factor;
-		factor *= 0.01;
-	}
-	return -score;
-}
-
-/**
- * Create a new node object.
- * @param manager Reference to the manager object.
- * @param node_key Reference to the node key.
- * @param proxy_library_name Reference to the proxy library name.
- * @param proxy_function_name Reference to the proxy function name.
- * @param staging_dir Reference to the staging directory.
- * @param prune_depth Reference to the prune depth.
- * @return A new node object.
- */
-struct vine_task_node *vine_task_node_create(
-		struct vine_manager *manager,
-		const char *node_key,
-		const char *proxy_library_name,
-		const char *proxy_function_name,
-		const char *target_results_dir,
-		int prune_depth)
-{
-	if (!manager) {
-		debug(D_ERROR, "Cannot create node because manager is NULL");
-		return NULL;
-	}
-	if (!node_key) {
-		debug(D_ERROR, "Cannot create node because node_key is NULL");
-		return NULL;
-	}
-	if (!proxy_library_name) {
-		debug(D_ERROR, "Cannot create node because proxy_library_name is NULL");
-		return NULL;
-	}
-	if (!proxy_function_name) {
-		debug(D_ERROR, "Cannot create node because proxy_function_name is NULL");
-		return NULL;
-	}
-	if (!target_results_dir) {
-		debug(D_ERROR, "Cannot create node because target_results_dir is NULL");
-		return NULL;
-	}
-
-	struct vine_task_node *node = xxmalloc(sizeof(struct vine_task_node));
-
-	node->manager = manager;
-	node->node_key = xxstrdup(node_key);
-	node->target_results_dir = xxstrdup(target_results_dir);
-
-	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
-	node->parents = list_create();
-	node->children = list_create();
-	node->pending_parents = set_create(0);
-	node->completed = 0;
-	node->prune_depth = prune_depth;
-	node->retry_attempts_left = 1;
-	node->outfile_size_bytes = 0;
-
-	node->depth = -1;
-	node->height = -1;
-	node->upstream_subgraph_size = -1;
-	node->downstream_subgraph_size = -1;
-	node->fan_in = -1;
-	node->fan_out = -1;
-	node->heavy_score = -1;
-
-	node->time_spent_on_unlink_local_files = 0;
-	node->time_spent_on_prune_ancestors_of_temp_node = 0;
-	node->time_spent_on_prune_ancestors_of_persisted_node = 0;
-
-	node->critical_time = -1;
-
-	/* create the task */
-	node->task = vine_task_create(proxy_function_name);
-	vine_task_set_library_required(node->task, proxy_library_name);
-	vine_task_addref(node->task);
-
-	/* build JSON infile expected by library: {"fn_args": [key], "fn_kwargs": {}} */
-	struct jx *event = jx_object(NULL);
-	struct jx *args = jx_array(NULL);
-	jx_array_append(args, jx_string(node->node_key));
-	jx_insert(event, jx_string("fn_args"), args);
-	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
-
-	char *infile_content = jx_print_string(event);
-	jx_delete(event);
-
-	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
-	free(infile_content);
-	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
-
-	return node;
-}
-
-/**
- * Set the outfile of a node in the task graph.
- * This involves declaring the output file and adding it to the task.
- * @param node Reference to the node object.
- * @param outfile_type Reference to the outfile type.
- * @param outfile_remote_name Reference to the outfile remote name.
- */
-void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name)
-{
-	if (!node) {
-		return;
-	}
-
-	assert(outfile_remote_name != NULL);
-
-	node->outfile_type = outfile_type;
-	node->outfile_remote_name = xxstrdup(outfile_remote_name);
-
-	/* create the output file */
-	switch (node->outfile_type) {
-	case VINE_NODE_OUTFILE_TYPE_LOCAL: {
-		if (!node->target_results_dir) {
-			debug(D_ERROR, "Cannot create local output file for node %s because target_results_dir is NULL", node->node_key);
-			exit(1);
-		}
-		char *local_output_path = string_format("%s/%s", node->target_results_dir, node->outfile_remote_name);
-		node->outfile = vine_declare_file(node->manager, local_output_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
-		free(local_output_path);
-		break;
-	}
-	case VINE_NODE_OUTFILE_TYPE_TEMP:
-		node->outfile = vine_declare_temp(node->manager);
-		break;
-	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
-		/* no explicit output file declaration needed */
-		node->outfile = NULL;
-		break;
-	}
-	if (node->outfile) {
-		vine_task_add_output(node->task, node->outfile, node->outfile_remote_name, VINE_TRANSFER_ALWAYS);
-	}
-
-	return;
-}
-
-/**
- * Check if the outfile of a node is persisted.
- * A node is considered persisted if it has completed and 1) the outfile is written to the shared file system,
- * 2) the outfile is written to the local staging directory.
- * @param node Reference to the node object.
- * @return 1 if the outfile is persisted, 0 otherwise.
- */
-static int _node_outfile_is_persisted(struct vine_task_node *node)
-{
-	if (!node) {
-		return 0;
-	}
-
-	/* if the node is not completed then the outfile is definitely not persisted */
-	if (!node->completed) {
-		return 0;
-	}
-
-	switch (node->outfile_type) {
-	case VINE_NODE_OUTFILE_TYPE_LOCAL:
-		return 1;
-	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
-		return 1;
-	case VINE_NODE_OUTFILE_TYPE_TEMP:
-		return 0;
-	}
-
-	return 0;
-}
-
-/**
- * Update the critical time of a node.
- * @param node Reference to the node object.
- * @param execution_time Reference to the execution time of the node.
- */
-void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time)
-{
-	timestamp_t max_parent_critical_time = 0;
-	struct vine_task_node *parent_node;
-	LIST_ITERATE(node->parents, parent_node)
-	{
-		if (parent_node->critical_time > max_parent_critical_time) {
-			max_parent_critical_time = parent_node->critical_time;
-		}
-	}
-	node->critical_time = max_parent_critical_time + execution_time;
-}
-
-/**
- * The dfs helper function for finding parents in a specific depth.
- * @param node Reference to the node object.
- * @param remaining_depth Reference to the remaining depth.
- * @param result Reference to the result list.
- * @param visited Reference to the visited set.
- */
-static void _find_parents_dfs(struct vine_task_node *node, int remaining_depth, struct list *result, struct set *visited)
-{
-	if (!node || set_lookup(visited, node)) {
-		return;
-	}
-
-	set_insert(visited, node);
-	if (remaining_depth == 0) {
-		list_push_tail(result, node);
-		return;
-	}
-	struct vine_task_node *parent_node;
-	LIST_ITERATE(node->parents, parent_node)
-	{
-		_find_parents_dfs(parent_node, remaining_depth - 1, result, visited);
-	}
-}
-
-/**
- * Find all parents in a specific depth of the node.
- * @param node Reference to the node object.
- * @param depth Reference to the depth.
- * @return The list of parents.
- */
-static struct list *_find_parents_in_depth(struct vine_task_node *node, int depth)
-{
-	if (!node || depth < 0) {
-		return NULL;
-	}
-
-	struct list *result = list_create();
-
-	struct set *visited = set_create(0);
-	_find_parents_dfs(node, depth, result, visited);
-	set_delete(visited);
-
-	return result;
-}
-
-/**
- * Prune the ancestors of a temp node. This is only used for temp nodes that produce temp files.
- * All ancestors of this node we consider here are temp nodes, we can not safely prune those stored in the shared file system
- * because temp nodes are not considered safe enough to trigger the deletion of upstream persisted files.
- * @param node Reference to the node object.
- * @return The number of pruned replicas.
- */
-static int prune_ancestors_of_temp_node(struct vine_task_node *node)
-{
-	if (!node || !node->outfile || node->prune_depth <= 0) {
-		return 0;
-	}
-
-	timestamp_t start_time = timestamp_get();
-
-	int pruned_replica_count = 0;
-
-	struct list *parents = _find_parents_in_depth(node, node->prune_depth);
-
-	struct vine_task_node *parent_node;
-	LIST_ITERATE(parents, parent_node)
-	{
-		/* skip if the parent produces a shared file system file */
-		if (!parent_node->outfile) {
-			continue;
-		}
-		/* skip if the parent produces a non-temp file */
-		if (parent_node->outfile->type != VINE_TEMP) {
-			continue;
-		}
-
-		/* a file is prunable if its outfile is no longer needed by any child node:
-		 * 1. it has no pending dependents
-		 * 2. all completed dependents have also completed their corresponding recovery tasks, if any */
-		int all_children_completed = 1;
-		struct vine_task_node *child_node;
-		LIST_ITERATE(parent_node->children, child_node)
-		{
-			/* break early if the child node is not completed */
-			if (!child_node->completed) {
-				all_children_completed = 0;
-				break;
-			}
-			/* if the task produces a temp file and the recovery task is running, the parent is not prunable */
-			if (child_node->outfile && child_node->outfile->type == VINE_TEMP) {
-				struct vine_task *child_node_recovery_task = child_node->outfile->recovery_task;
-				if (child_node_recovery_task && (child_node_recovery_task->state != VINE_TASK_INITIAL && child_node_recovery_task->state != VINE_TASK_DONE)) {
-					all_children_completed = 0;
-					break;
-				}
-			}
-		}
-		if (!all_children_completed) {
-			continue;
-		}
-
-		pruned_replica_count += vine_prune_file(node->manager, parent_node->outfile);
-		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
-		 * manager may submit a recovery task to bring it back in case of worker failures. */
-		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
-	}
-
-	list_delete(parents);
-
-	node->time_spent_on_prune_ancestors_of_temp_node += timestamp_get() - start_time;
-
-	return pruned_replica_count;
-}
-
-/**
- * Find all safe ancestors of a node.
- * @param start_node Reference to the start node.
- * @return The set of safe ancestors.
- */
-static struct set *_find_safe_ancestors(struct vine_task_node *start_node)
-{
-	if (!start_node) {
-		return NULL;
-	}
-
-	struct set *visited_nodes = set_create(0);
-	struct list *bfs_nodes = list_create();
-
-	list_push_tail(bfs_nodes, start_node);
-	set_insert(visited_nodes, start_node);
-
-	while (list_size(bfs_nodes) > 0) {
-		struct vine_task_node *current = list_pop_head(bfs_nodes);
-
-		struct vine_task_node *parent_node;
-		LIST_ITERATE(current->parents, parent_node)
-		{
-			if (set_lookup(visited_nodes, parent_node)) {
-				continue;
-			}
-
-			/* shortcut if this parent was already safely pruned */
-			if (parent_node->prune_status == PRUNE_STATUS_SAFE) {
-				continue;
-			}
-
-			/* check if all children are safe */
-			int all_children_safe = 1;
-			struct vine_task_node *child_node;
-			LIST_ITERATE(parent_node->children, child_node)
-			{
-				/* shortcut if this child is part of the recovery subgraph */
-				if (set_lookup(visited_nodes, child_node)) {
-					continue;
-				}
-				/* shortcut if this outside child is not persisted */
-				if (!_node_outfile_is_persisted(child_node)) {
-					all_children_safe = 0;
-					break;
-				}
-				/* shortcut if this outside child is unsafely pruned */
-				if (child_node->prune_status == PRUNE_STATUS_UNSAFE) {
-					all_children_safe = 0;
-					break;
-				}
-			}
-
-			if (!all_children_safe) {
-				continue;
-			}
-
-			set_insert(visited_nodes, parent_node);
-			list_push_tail(bfs_nodes, parent_node);
-		}
-	}
-
-	list_delete(bfs_nodes);
-	set_remove(visited_nodes, start_node);
-
-	return visited_nodes;
-}
-
-/**
- * Prune the ancestors of a persisted node. This is only used for persisted nodes that produce persisted files.
- * All ancestors we consider here include both temp nodes and persisted nodes, becasue data written to shared file system
- * is safe and can definitely trigger upstream data redundancy to be released.
- * @param node Reference to the node object.
- * @return The number of pruned replicas.
- */
-static int prune_ancestors_of_persisted_node(struct vine_task_node *node)
-{
-	if (!node) {
-		return 0;
-	}
-
-	timestamp_t start_time = timestamp_get();
-
-	int pruned_replica_count = 0;
-
-	/* find all safe ancestors */
-	struct set *safe_ancestors = _find_safe_ancestors(node);
-	if (!safe_ancestors) {
-		return 0;
-	}
-
-	/* prune all safe ancestors */
-	struct vine_task_node *ancestor_node;
-	SET_ITERATE(safe_ancestors, ancestor_node)
-	{
-		/* unlink the shared file system file */
-		if (!ancestor_node->outfile) {
-			timestamp_t unlink_start = timestamp_get();
-			if (ancestor_node->outfile_remote_name) {
-				unlink(ancestor_node->outfile_remote_name); // system call
-			}
-			node->time_spent_on_unlink_local_files += timestamp_get() - unlink_start;
-			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64, ancestor_node->outfile_remote_name ? ancestor_node->outfile_remote_name : "(null)", ancestor_node->outfile_size_bytes, (uint64_t)node->time_spent_on_unlink_local_files);
-		} else {
-			switch (ancestor_node->outfile->type) {
-			case VINE_FILE:
-				/* do not prune the staging dir file */
-				break;
-			case VINE_TEMP:
-				/* prune the temp file */
-				vine_prune_file(node->manager, ancestor_node->outfile);
-				break;
-			default:
-				debug(D_ERROR, "unsupported outfile type: %d", ancestor_node->outfile->type);
-				break;
-			}
-		}
-		ancestor_node->prune_status = PRUNE_STATUS_SAFE;
-		pruned_replica_count++;
-	}
-
-	set_delete(safe_ancestors);
-
-	node->time_spent_on_prune_ancestors_of_persisted_node += timestamp_get() - start_time;
-
-	return pruned_replica_count;
-}
-
-/**
- * Print the info of the node.
- * @param node Reference to the node object.
- */
-void vine_task_node_print_info(struct vine_task_node *node)
-{
-	if (!node) {
-		return;
-	}
-
-	if (!node->task) {
-		debug(D_ERROR, "node %s has no task", node->node_key);
-		return;
-	}
-
-	debug(D_VINE, "---------------- Node Info ----------------");
-	debug(D_VINE, "key: %s", node->node_key);
-	debug(D_VINE, "task_id: %d", node->task->task_id);
-	debug(D_VINE, "target_results_dir: %s", node->target_results_dir ? node->target_results_dir : "(null)");
-	debug(D_VINE, "depth: %d", node->depth);
-	debug(D_VINE, "height: %d", node->height);
-	debug(D_VINE, "prune_depth: %d", node->prune_depth);
-
-	if (node->outfile_remote_name) {
-		debug(D_VINE, "outfile_remote_name: %s", node->outfile_remote_name);
-	}
-
-	if (node->outfile) {
-		const char *type_str = "UNKNOWN";
-		switch (node->outfile->type) {
-		case VINE_FILE:
-			type_str = "VINE_FILE";
-			break;
-		case VINE_TEMP:
-			type_str = "VINE_TEMP";
-			break;
-		case VINE_URL:
-			type_str = "VINE_URL";
-			break;
-		case VINE_BUFFER:
-			type_str = "VINE_BUFFER";
-			break;
-		case VINE_MINI_TASK:
-			type_str = "VINE_MINI_TASK";
-			break;
-		}
-		debug(D_VINE, "outfile_type: %s", type_str);
-		debug(D_VINE, "outfile_cached_name: %s", node->outfile->cached_name ? node->outfile->cached_name : "(null)");
-	} else {
-		debug(D_VINE, "outfile_type: SHARED_FILE_SYSTEM or none");
-	}
-
-	/* print parent and child node keys */
-	char *parent_keys = NULL;
-	struct vine_task_node *p;
-	LIST_ITERATE(node->parents, p)
-	{
-		if (!parent_keys) {
-			parent_keys = string_format("%s", p->node_key);
-		} else {
-			char *tmp = string_format("%s, %s", parent_keys, p->node_key);
-			free(parent_keys);
-			parent_keys = tmp;
-		}
-	}
-
-	char *child_keys = NULL;
-	struct vine_task_node *c;
-	LIST_ITERATE(node->children, c)
-	{
-		if (!child_keys) {
-			child_keys = string_format("%s", c->node_key);
-		} else {
-			char *tmp = string_format("%s, %s", child_keys, c->node_key);
-			free(child_keys);
-			child_keys = tmp;
-		}
-	}
-
-	debug(D_VINE, "parents: %s", parent_keys ? parent_keys : "(none)");
-	debug(D_VINE, "children: %s", child_keys ? child_keys : "(none)");
-
-	free(parent_keys);
-	free(child_keys);
-
-	debug(D_VINE, "-------------------------------------------");
-}
-
-/**
- * Prune the ancestors of a node when it is completed.
- * @param node Reference to the node object.
- */
-void vine_task_node_prune_ancestors(struct vine_task_node *node)
-{
-	if (!node) {
-		return;
-	}
-
-	timestamp_t start_time = timestamp_get();
-
-	int pruned_replica_count = 0;
-
-	if (_node_outfile_is_persisted(node)) {
-		pruned_replica_count = prune_ancestors_of_persisted_node(node);
-	} else {
-		pruned_replica_count = prune_ancestors_of_temp_node(node);
-	}
-
-	timestamp_t elapsed_time = timestamp_get() - start_time;
-
-	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
-}
-
-/**
- * Replicate the outfile of a node if it is a temp file.
- * @param node Reference to the node object.
- */
-void vine_task_node_replicate_outfile(struct vine_task_node *node)
-{
-	if (!node || !node->outfile) {
-		return;
-	}
-
-	if (node->outfile->type != VINE_TEMP) {
-		return;
-	}
-
-	vine_temp_replicate_file_later(node->manager, node->outfile);
-}
-
-/**
- * Delete the node and all of its associated resources.
- * @param node Reference to the node object.
- */
-void vine_task_node_delete(struct vine_task_node *node)
-{
-	if (!node) {
-		return;
-	}
-
-	if (node->node_key) {
-		free(node->node_key);
-	}
-	if (node->outfile_remote_name) {
-		free(node->outfile_remote_name);
-	}
-	if (node->target_results_dir) {
-		free(node->target_results_dir);
-	}
-
-	vine_task_delete(node->task);
-	node->task = NULL;
-
-	if (node->infile) {
-		vine_file_delete(node->infile);
-		node->infile = NULL;
-	}
-	if (node->outfile) {
-		vine_file_delete(node->outfile);
-		node->outfile = NULL;
-	}
-
-	list_delete(node->parents);
-	list_delete(node->children);
-
-	if (node->pending_parents) {
-		set_delete(node->pending_parents);
-	}
-	free(node);
-}
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/vine_task_node.h b/taskvine/src/graph/dagvine/vine_task_node.h
deleted file mode 100644
index c9d58bf520..0000000000
--- a/taskvine/src/graph/dagvine/vine_task_node.h
+++ /dev/null
@@ -1,77 +0,0 @@
-#ifndef VINE_TASK_NODE_H
-#define VINE_TASK_NODE_H
-
-#include "vine_task.h"
-#include "hash_table.h"
-#include "list.h"
-#include "vine_manager.h"
-#include "set.h"
-#include "taskvine.h"
-
-/** Select the type of the node-output file. */
-typedef enum {
-    VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
-    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
-    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
-} vine_task_node_outfile_type_t;
-
-typedef enum {
-    PRUNE_STATUS_NOT_PRUNED = 0,
-    PRUNE_STATUS_SAFE, 
-    PRUNE_STATUS_UNSAFE
-} prune_status_t;
-
-struct vine_task_node {
-    char *node_key;
-
-    struct vine_manager *manager;
-    struct vine_task *task;
-    struct vine_file *infile;
-    struct vine_file *outfile;
-    char *outfile_remote_name;
-    char *target_results_dir;
-    size_t outfile_size_bytes;
-        
-    struct list *parents;
-    struct list *children;
-    struct set *pending_parents;
-    
-    int retry_attempts_left;
-    int completed;
-    int prune_depth;
-
-    int depth;
-    int height;
-    int upstream_subgraph_size;
-    int downstream_subgraph_size;
-    int fan_in;
-    int fan_out;
-    double heavy_score;
-
-    timestamp_t critical_time;
-    timestamp_t time_spent_on_unlink_local_files;
-    timestamp_t time_spent_on_prune_ancestors_of_temp_node;
-    timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
-
-    vine_task_node_outfile_type_t outfile_type;
-    prune_status_t prune_status;
-};
-
-struct vine_task_node *vine_task_node_create(
-    struct vine_manager *manager,
-    const char *node_key,
-    const char *proxy_library_name,
-    const char *proxy_function_name,
-    const char *target_results_dir,
-    int prune_depth
-);
-
-void vine_task_node_delete(struct vine_task_node *node);
-double compute_lex_priority(const char *key);
-void vine_task_node_prune_ancestors(struct vine_task_node *node);
-void vine_task_node_print_info(struct vine_task_node *node);
-void vine_task_node_update_critical_time(struct vine_task_node *node, timestamp_t execution_time);
-void vine_task_node_replicate_outfile(struct vine_task_node *node);
-void vine_task_node_set_outfile(struct vine_task_node *node, vine_task_node_outfile_type_t outfile_type, const char *outfile_remote_name);
-
-#endif
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 27832876f9..20fda511f8 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3686,6 +3686,7 @@ static int vine_manager_check_inputs_available(struct vine_manager *q, struct vi
 			all_available = 0;
 		}
 	}
+
 	return all_available;
 }
 

From 73308fb528f51b4f4947a1b895579d51ee532b89 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 03:56:06 -0400
Subject: [PATCH 047/113] new files

---
 taskvine/src/graph/dagvine/proxy_functions.py | 106 +++
 taskvine/src/graph/dagvine/proxy_library.py   |  79 +++
 .../dagvine/strategic_orchestration_graph.py  |  33 +
 .../dagvine/strategic_orchestration_node.c    | 608 ++++++++++++++++++
 .../dagvine/strategic_orchestration_node.h    |  92 +++
 5 files changed, 918 insertions(+)
 create mode 100644 taskvine/src/graph/dagvine/proxy_functions.py
 create mode 100644 taskvine/src/graph/dagvine/proxy_library.py
 create mode 100644 taskvine/src/graph/dagvine/strategic_orchestration_graph.py
 create mode 100644 taskvine/src/graph/dagvine/strategic_orchestration_node.c
 create mode 100644 taskvine/src/graph/dagvine/strategic_orchestration_node.h

diff --git a/taskvine/src/graph/dagvine/proxy_functions.py b/taskvine/src/graph/dagvine/proxy_functions.py
new file mode 100644
index 0000000000..c415cf9d40
--- /dev/null
+++ b/taskvine/src/graph/dagvine/proxy_functions.py
@@ -0,0 +1,106 @@
+import os, time
+from ndcctools.taskvine.utils import load_variable_from_library
+
+
+def compute_dts_key(reg, k, v):
+    """
+    Compute the result of a Dask task node from dask._task_spec.
+
+    Each value `v` may be an instance of Task, Alias, or DataNode, all of which
+    inherit from the same base class. The `dependencies` field is a frozenset
+    containing direct dependencies only (no recursive ancestry).
+
+    The function resolves each dependency from the reg, constructs an
+    input dictionary, and then executes the node according to its type.
+    """
+    try:
+        import dask._task_spec as dts
+    except ImportError:
+        raise ImportError("Dask is not installed")
+
+    input_dict = {dep: reg.load_result_of_key(dep) for dep in v.dependencies}
+
+    try:
+        if isinstance(v, dts.Alias):
+            assert len(v.dependencies) == 1, "Expected exactly one dependency"
+            return reg.load_result_of_key(next(iter(v.dependencies)))
+        elif isinstance(v, dts.Task):
+            return v(input_dict)
+        elif isinstance(v, dts.DataNode):
+            return v.value
+        else:
+            raise TypeError(f"unexpected node type: {type(v)} for key {k}")
+    except Exception as e:
+        raise Exception(f"Error while executing task {k}: {e}")
+
+
+def compute_sexpr_key(reg, k, v):
+    """
+    Evaluate a symbolic expression (S-expression) task within the task graph.
+
+    Both DAGVine and legacy Dask represent computations as symbolic
+    expression trees (S-expressions). Each task value `v` encodes a nested
+    structure where:
+      - Leaf nodes are constants or task keys referencing parent results.
+      - Lists are recursively evaluated.
+      - Tuples of the form (func, arg1, arg2, ...) represent function calls.
+
+    This function builds an input dictionary from all parent keys, then
+    recursively resolves and executes the expression until a final value
+    is produced.
+    """
+    input_dict = {parent: reg.load_result_of_key(parent) for parent in reg.parents_of[k]}
+
+    def _rec_call(expr):
+        try:
+            if expr in input_dict.keys():
+                return input_dict[expr]
+        except TypeError:
+            pass
+        if isinstance(expr, list):
+            return [_rec_call(e) for e in expr]
+        if isinstance(expr, tuple) and len(expr) > 0 and callable(expr[0]):
+            res = expr[0](*[_rec_call(a) for a in expr[1:]])
+            return res
+        return expr
+
+    try:
+        return _rec_call(v)
+    except Exception as e:
+        raise Exception(f"Failed to invoke _rec_call(): {e}")
+
+
+def compute_single_key(vine_key):
+    """
+    Compute a single task identified by a Vine key within the current RuntimeExecutionGraph.
+
+    The function retrieves the corresponding graph key and task object from the
+    global reg, determines the task type, and dispatches to the appropriate
+    execution interface — e.g., `compute_dts_key` for Dask-style task specs or
+    `compute_sexpr_key` for S-expression graphs.
+
+    This design allows extensibility: for new graph representations, additional
+    compute interfaces can be introduced and registered here to handle new key types.
+
+    After computation, the result is saved, the output file is validated, and
+    an optional delay (`extra_sleep_time_of`) is applied before returning.
+    """
+    reg = load_variable_from_library('reg')
+
+    k = reg.reg_node_key_of[vine_key]
+    v = reg.task_dict[k]
+
+    if reg.is_dts_key(k):
+        result = compute_dts_key(reg, k, v)
+    else:
+        result = compute_sexpr_key(reg, k, v)
+
+    reg.save_result_of_key(k, result)
+    if not os.path.exists(reg.outfile_remote_name[k]):
+        raise Exception(f"Output file {reg.outfile_remote_name[k]} does not exist after writing")
+    if os.stat(reg.outfile_remote_name[k]).st_size == 0:
+        raise Exception(f"Output file {reg.outfile_remote_name[k]} is empty after writing")
+
+    time.sleep(reg.extra_sleep_time_of[k])
+
+    return True
diff --git a/taskvine/src/graph/dagvine/proxy_library.py b/taskvine/src/graph/dagvine/proxy_library.py
new file mode 100644
index 0000000000..aa14b4a607
--- /dev/null
+++ b/taskvine/src/graph/dagvine/proxy_library.py
@@ -0,0 +1,79 @@
+import os, uuid, cloudpickle, types, time, random, hashlib, collections
+from ndcctools.taskvine.dagvine.runtime_execution_graph import (
+    GraphKeyResult, RuntimeExecutionGraph, hash_name, hashable
+)
+from ndcctools.taskvine.dagvine.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
+from ndcctools.taskvine.utils import load_variable_from_library
+
+
+class ProxyLibrary:
+    def __init__(self, py_manager):
+        self.py_manager = py_manager
+
+        self.name = None
+        self.libcores = None
+
+        self.libtask = None
+
+        # these modules are always included in the preamble of the library task, so that function calls can execute directly
+        # using the loaded context without importing them over and over again
+        self.hoisting_modules = [
+            os, cloudpickle, GraphKeyResult, RuntimeExecutionGraph, uuid, hashlib, random, types, collections, time,
+            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
+        ]
+
+        # environment files serve as additional inputs to the library task, where each key is the local path and the value is the remote path
+        # those local files will be sent remotely to the workers so tasks can access them as appropriate
+        self.env_files = {}
+
+        # context loader is a function that will be used to load the library context on remote nodes.
+        self.context_loader_func = None
+        self.context_loader_args = []
+        self.context_loader_kwargs = {}
+
+        self.local_path = None
+        self.remote_path = None
+
+    def set_libcores(self, libcores):
+        self.libcores = libcores
+
+    def set_name(self, name):
+        self.name = name
+
+    def add_hoisting_modules(self, new_modules):
+        assert isinstance(new_modules, list), "new_modules must be a list of modules"
+        self.hoisting_modules.extend(new_modules)
+
+    def add_env_files(self, new_env_files):
+        assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
+        self.env_files.update(new_env_files)
+
+    def set_context_loader(self, context_loader_func, context_loader_args=[], context_loader_kwargs={}):
+        self.context_loader_func = context_loader_func
+        self.context_loader_args = context_loader_args
+        self.context_loader_kwargs = context_loader_kwargs
+
+    def install(self):
+        assert self.name is not None, "Library name must be set before installing (use set_name method)"
+        assert self.libcores is not None, "Library cores must be set before installing (use set_libcores method)"
+
+        self.libtask = self.py_manager.create_library_from_functions(
+            self.name,
+            compute_single_key,
+            library_context_info=[self.context_loader_func, self.context_loader_args, self.context_loader_kwargs],
+            add_env=False,
+            function_infile_load_mode="json",
+            hoisting_modules=self.hoisting_modules,
+        )
+        for local, remote in self.env_files.items():
+            # check if the local file exists
+            if not os.path.exists(local):
+                raise FileNotFoundError(f"Local file {local} not found")
+            # attach as the input file to the library task
+            self.libtask.add_input(self.py_manager.declare_file(local, cache=True, peer_transfer=True), remote)
+        self.libtask.set_cores(self.libcores)
+        self.libtask.set_function_slots(self.libcores)
+        self.py_manager.install_library(self.libtask)
+
+    def uninstall(self):
+        self.py_manager.remove_library(self.name)
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.py b/taskvine/src/graph/dagvine/strategic_orchestration_graph.py
new file mode 100644
index 0000000000..c441997a14
--- /dev/null
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.py
@@ -0,0 +1,33 @@
+from ndcctools.taskvine.dagvine import cdagvine
+
+
+class StrategicOrchestrationGraph:
+    def __init__(self, c_taskvine):
+        self._c_sog = cdagvine.sog_create(c_taskvine)
+
+    def tune(self, name, value):
+        cdagvine.sog_tune(self._c_sog, name, value)
+
+    def add_node(self, key, is_target_key):
+        cdagvine.sog_add_node(self._c_sog, key, is_target_key)
+
+    def add_dependency(self, parent_key, child_key):
+        cdagvine.sog_add_dependency(self._c_sog, parent_key, child_key)
+
+    def compute_topology_metrics(self):
+        cdagvine.sog_compute_topology_metrics(self._c_sog)
+
+    def get_node_outfile_remote_name(self, key):
+        return cdagvine.sog_get_node_outfile_remote_name(self._c_sog, key)
+
+    def get_proxy_library_name(self):
+        return cdagvine.sog_get_proxy_library_name(self._c_sog)
+
+    def set_proxy_function_name(self, proxy_function_name):
+        cdagvine.sog_set_proxy_function_name(self._c_sog, proxy_function_name)
+
+    def execute(self):
+        cdagvine.sog_execute(self._c_sog)
+
+    def delete(self):
+        cdagvine.sog_delete(self._c_sog)
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.c b/taskvine/src/graph/dagvine/strategic_orchestration_node.c
new file mode 100644
index 0000000000..a9ec6209e6
--- /dev/null
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_node.c
@@ -0,0 +1,608 @@
+#include <assert.h>
+#include <inttypes.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+
+#include "jx.h"
+#include "jx_print.h"
+#include "xxmalloc.h"
+#include "stringtools.h"
+#include "timestamp.h"
+#include "set.h"
+#include "hash_table.h"
+#include "debug.h"
+#include "random.h"
+#include "uuid.h"
+
+#include "vine_manager.h"
+#include "vine_file.h"
+#include "vine_task.h"
+#include "vine_worker_info.h"
+#include "vine_temp.h"
+#include "strategic_orchestration_node.h"
+#include "taskvine.h"
+
+
+/**
+ * Compute a lexicographic priority score from the node key.
+ * Used during topological sorting to break ties deterministically.
+ * @param key Reference to the node key.
+ * @return The lexical priority.
+ */
+double compute_lex_priority(const char *key)
+{
+	double score = 0.0;
+	double factor = 1.0;
+	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
+		score += (unsigned char)key[i] * factor;
+		factor *= 0.01;
+	}
+	return -score;
+}
+
+/**
+ * Create a new node object.
+ * @param manager Reference to the manager object.
+ * @param node_key Reference to the node key.
+ * @param is_target_key Reference to whether the node is a target key.
+ * @param proxy_library_name Reference to the proxy library name.
+ * @param proxy_function_name Reference to the proxy function name.
+ * @param staging_dir Reference to the staging directory.
+ * @param prune_depth Reference to the prune depth.
+ * @return A new node object.
+ */
+struct strategic_orchestration_node *son_create(
+		struct vine_manager *manager,
+		const char *node_key,
+		int is_target_key,
+		const char *proxy_library_name,
+		const char *proxy_function_name,
+		const char *target_results_dir,
+		int prune_depth)
+{
+	if (!manager) {
+		debug(D_ERROR, "Cannot create node because manager is NULL");
+		return NULL;
+	}
+	if (!node_key) {
+		debug(D_ERROR, "Cannot create node because node_key is NULL");
+		return NULL;
+	}
+	if (!proxy_library_name) {
+		debug(D_ERROR, "Cannot create node because proxy_library_name is NULL");
+		return NULL;
+	}
+	if (!proxy_function_name) {
+		debug(D_ERROR, "Cannot create node because proxy_function_name is NULL");
+		return NULL;
+	}
+	if (!target_results_dir) {
+		debug(D_ERROR, "Cannot create node because target_results_dir is NULL");
+		return NULL;
+	}
+	if (is_target_key != 0 && is_target_key != 1) {
+		debug(D_ERROR, "Cannot create node because is_target_key is not 0 or 1");
+		return NULL;
+	}
+
+	struct strategic_orchestration_node *node = xxmalloc(sizeof(struct strategic_orchestration_node));
+
+	node->manager = manager;
+	node->is_target_key = is_target_key;
+	node->node_key = xxstrdup(node_key);
+	node->target_results_dir = xxstrdup(target_results_dir);
+
+	/* create a unique outfile remote name for the node */
+	cctools_uuid_t id;
+	cctools_uuid_create(&id);
+	node->outfile_remote_name = xxstrdup(id.str);
+
+	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
+	node->parents = list_create();
+	node->children = list_create();
+	node->pending_parents = set_create(0);
+	node->completed = 0;
+	node->prune_depth = prune_depth;
+	node->retry_attempts_left = 1;
+	node->outfile_size_bytes = 0;
+
+	node->depth = -1;
+	node->height = -1;
+	node->upstream_subgraph_size = -1;
+	node->downstream_subgraph_size = -1;
+	node->fan_in = -1;
+	node->fan_out = -1;
+	node->heavy_score = -1;
+
+	node->time_spent_on_unlink_local_files = 0;
+	node->time_spent_on_prune_ancestors_of_temp_node = 0;
+	node->time_spent_on_prune_ancestors_of_persisted_node = 0;
+
+	node->critical_time = -1;
+
+	/* create the task */
+	node->task = vine_task_create(proxy_function_name);
+	vine_task_set_library_required(node->task, proxy_library_name);
+	vine_task_addref(node->task);
+
+	/* build JSON infile expected by library: {"fn_args": [key], "fn_kwargs": {}} */
+	struct jx *event = jx_object(NULL);
+	struct jx *args = jx_array(NULL);
+	jx_array_append(args, jx_string(node->node_key));
+	jx_insert(event, jx_string("fn_args"), args);
+	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
+
+	char *infile_content = jx_print_string(event);
+	jx_delete(event);
+
+	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
+	free(infile_content);
+	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
+
+	return node;
+}
+
+/**
+ * Check if the outfile of a node is persisted.
+ * A node is considered persisted if it has completed and 1) the outfile is written to the shared file system,
+ * 2) the outfile is written to the local staging directory.
+ * @param node Reference to the node object.
+ * @return 1 if the outfile is persisted, 0 otherwise.
+ */
+static int _node_outfile_is_persisted(struct strategic_orchestration_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	/* if the node is not completed then the outfile is definitely not persisted */
+	if (!node->completed) {
+		return 0;
+	}
+
+	switch (node->outfile_type) {
+	case VINE_NODE_OUTFILE_TYPE_LOCAL:
+		return 1;
+	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+		return 1;
+	case VINE_NODE_OUTFILE_TYPE_TEMP:
+		return 0;
+	}
+
+	return 0;
+}
+
+/**
+ * Update the critical time of a node.
+ * @param node Reference to the node object.
+ * @param execution_time Reference to the execution time of the node.
+ */
+void son_update_critical_time(struct strategic_orchestration_node *node, timestamp_t execution_time)
+{
+	timestamp_t max_parent_critical_time = 0;
+	struct strategic_orchestration_node *parent_node;
+	LIST_ITERATE(node->parents, parent_node)
+	{
+		if (parent_node->critical_time > max_parent_critical_time) {
+			max_parent_critical_time = parent_node->critical_time;
+		}
+	}
+	node->critical_time = max_parent_critical_time + execution_time;
+}
+
+/**
+ * The dfs helper function for finding parents in a specific depth.
+ * @param node Reference to the node object.
+ * @param remaining_depth Reference to the remaining depth.
+ * @param result Reference to the result list.
+ * @param visited Reference to the visited set.
+ */
+static void _find_parents_dfs(struct strategic_orchestration_node *node, int remaining_depth, struct list *result, struct set *visited)
+{
+	if (!node || set_lookup(visited, node)) {
+		return;
+	}
+
+	set_insert(visited, node);
+	if (remaining_depth == 0) {
+		list_push_tail(result, node);
+		return;
+	}
+	struct strategic_orchestration_node *parent_node;
+	LIST_ITERATE(node->parents, parent_node)
+	{
+		_find_parents_dfs(parent_node, remaining_depth - 1, result, visited);
+	}
+}
+
+/**
+ * Find all parents in a specific depth of the node.
+ * @param node Reference to the node object.
+ * @param depth Reference to the depth.
+ * @return The list of parents.
+ */
+static struct list *_find_parents_in_depth(struct strategic_orchestration_node *node, int depth)
+{
+	if (!node || depth < 0) {
+		return NULL;
+	}
+
+	struct list *result = list_create();
+
+	struct set *visited = set_create(0);
+	_find_parents_dfs(node, depth, result, visited);
+	set_delete(visited);
+
+	return result;
+}
+
+/**
+ * Prune the ancestors of a temp node. This is only used for temp nodes that produce temp files.
+ * All ancestors of this node we consider here are temp nodes, we can not safely prune those stored in the shared file system
+ * because temp nodes are not considered safe enough to trigger the deletion of upstream persisted files.
+ * @param node Reference to the node object.
+ * @return The number of pruned replicas.
+ */
+static int prune_ancestors_of_temp_node(struct strategic_orchestration_node *node)
+{
+	if (!node || !node->outfile || node->prune_depth <= 0) {
+		return 0;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	struct list *parents = _find_parents_in_depth(node, node->prune_depth);
+
+	struct strategic_orchestration_node *parent_node;
+	LIST_ITERATE(parents, parent_node)
+	{
+		/* skip if the parent produces a shared file system file */
+		if (!parent_node->outfile) {
+			continue;
+		}
+		/* skip if the parent produces a non-temp file */
+		if (parent_node->outfile->type != VINE_TEMP) {
+			continue;
+		}
+
+		/* a file is prunable if its outfile is no longer needed by any child node:
+		 * 1. it has no pending dependents
+		 * 2. all completed dependents have also completed their corresponding recovery tasks, if any */
+		int all_children_completed = 1;
+		struct strategic_orchestration_node *child_node;
+		LIST_ITERATE(parent_node->children, child_node)
+		{
+			/* break early if the child node is not completed */
+			if (!child_node->completed) {
+				all_children_completed = 0;
+				break;
+			}
+			/* if the task produces a temp file and the recovery task is running, the parent is not prunable */
+			if (child_node->outfile && child_node->outfile->type == VINE_TEMP) {
+				struct vine_task *child_node_recovery_task = child_node->outfile->recovery_task;
+				if (child_node_recovery_task && (child_node_recovery_task->state != VINE_TASK_INITIAL && child_node_recovery_task->state != VINE_TASK_DONE)) {
+					all_children_completed = 0;
+					break;
+				}
+			}
+		}
+		if (!all_children_completed) {
+			continue;
+		}
+
+		pruned_replica_count += vine_prune_file(node->manager, parent_node->outfile);
+		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
+		 * manager may submit a recovery task to bring it back in case of worker failures. */
+		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
+	}
+
+	list_delete(parents);
+
+	node->time_spent_on_prune_ancestors_of_temp_node += timestamp_get() - start_time;
+
+	return pruned_replica_count;
+}
+
+/**
+ * Find all safe ancestors of a node.
+ * @param start_node Reference to the start node.
+ * @return The set of safe ancestors.
+ */
+static struct set *_find_safe_ancestors(struct strategic_orchestration_node *start_node)
+{
+	if (!start_node) {
+		return NULL;
+	}
+
+	struct set *visited_nodes = set_create(0);
+	struct list *bfs_nodes = list_create();
+
+	list_push_tail(bfs_nodes, start_node);
+	set_insert(visited_nodes, start_node);
+
+	while (list_size(bfs_nodes) > 0) {
+		struct strategic_orchestration_node *current = list_pop_head(bfs_nodes);
+
+		struct strategic_orchestration_node *parent_node;
+		LIST_ITERATE(current->parents, parent_node)
+		{
+			if (set_lookup(visited_nodes, parent_node)) {
+				continue;
+			}
+
+			/* shortcut if this parent was already safely pruned */
+			if (parent_node->prune_status == PRUNE_STATUS_SAFE) {
+				continue;
+			}
+
+			/* check if all children are safe */
+			int all_children_safe = 1;
+			struct strategic_orchestration_node *child_node;
+			LIST_ITERATE(parent_node->children, child_node)
+			{
+				/* shortcut if this child is part of the recovery subgraph */
+				if (set_lookup(visited_nodes, child_node)) {
+					continue;
+				}
+				/* shortcut if this outside child is not persisted */
+				if (!_node_outfile_is_persisted(child_node)) {
+					all_children_safe = 0;
+					break;
+				}
+				/* shortcut if this outside child is unsafely pruned */
+				if (child_node->prune_status == PRUNE_STATUS_UNSAFE) {
+					all_children_safe = 0;
+					break;
+				}
+			}
+
+			if (!all_children_safe) {
+				continue;
+			}
+
+			set_insert(visited_nodes, parent_node);
+			list_push_tail(bfs_nodes, parent_node);
+		}
+	}
+
+	list_delete(bfs_nodes);
+	set_remove(visited_nodes, start_node);
+
+	return visited_nodes;
+}
+
+/**
+ * Prune the ancestors of a persisted node. This is only used for persisted nodes that produce persisted files.
+ * All ancestors we consider here include both temp nodes and persisted nodes, becasue data written to shared file system
+ * is safe and can definitely trigger upstream data redundancy to be released.
+ * @param node Reference to the node object.
+ * @return The number of pruned replicas.
+ */
+static int prune_ancestors_of_persisted_node(struct strategic_orchestration_node *node)
+{
+	if (!node) {
+		return 0;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	/* find all safe ancestors */
+	struct set *safe_ancestors = _find_safe_ancestors(node);
+	if (!safe_ancestors) {
+		return 0;
+	}
+
+	/* prune all safe ancestors */
+	struct strategic_orchestration_node *ancestor_node;
+	SET_ITERATE(safe_ancestors, ancestor_node)
+	{
+		/* unlink the shared file system file */
+		if (!ancestor_node->outfile) {
+			timestamp_t unlink_start = timestamp_get();
+			if (ancestor_node->outfile_remote_name) {
+				unlink(ancestor_node->outfile_remote_name); // system call
+			}
+			node->time_spent_on_unlink_local_files += timestamp_get() - unlink_start;
+			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64, ancestor_node->outfile_remote_name ? ancestor_node->outfile_remote_name : "(null)", ancestor_node->outfile_size_bytes, (uint64_t)node->time_spent_on_unlink_local_files);
+		} else {
+			switch (ancestor_node->outfile->type) {
+			case VINE_FILE:
+				/* do not prune the staging dir file */
+				break;
+			case VINE_TEMP:
+				/* prune the temp file */
+				vine_prune_file(node->manager, ancestor_node->outfile);
+				break;
+			default:
+				debug(D_ERROR, "unsupported outfile type: %d", ancestor_node->outfile->type);
+				break;
+			}
+		}
+		ancestor_node->prune_status = PRUNE_STATUS_SAFE;
+		pruned_replica_count++;
+	}
+
+	set_delete(safe_ancestors);
+
+	node->time_spent_on_prune_ancestors_of_persisted_node += timestamp_get() - start_time;
+
+	return pruned_replica_count;
+}
+
+/**
+ * Print the info of the node.
+ * @param node Reference to the node object.
+ */
+void son_print_info(struct strategic_orchestration_node *node)
+{
+	if (!node) {
+		return;
+	}
+
+	if (!node->task) {
+		debug(D_ERROR, "node %s has no task", node->node_key);
+		return;
+	}
+
+	debug(D_VINE, "---------------- Node Info ----------------");
+	debug(D_VINE, "key: %s", node->node_key);
+	debug(D_VINE, "task_id: %d", node->task->task_id);
+	debug(D_VINE, "target_results_dir: %s", node->target_results_dir ? node->target_results_dir : "(null)");
+	debug(D_VINE, "depth: %d", node->depth);
+	debug(D_VINE, "height: %d", node->height);
+	debug(D_VINE, "prune_depth: %d", node->prune_depth);
+
+	if (node->outfile_remote_name) {
+		debug(D_VINE, "outfile_remote_name: %s", node->outfile_remote_name);
+	}
+
+	if (node->outfile) {
+		const char *type_str = "UNKNOWN";
+		switch (node->outfile->type) {
+		case VINE_FILE:
+			type_str = "VINE_FILE";
+			break;
+		case VINE_TEMP:
+			type_str = "VINE_TEMP";
+			break;
+		case VINE_URL:
+			type_str = "VINE_URL";
+			break;
+		case VINE_BUFFER:
+			type_str = "VINE_BUFFER";
+			break;
+		case VINE_MINI_TASK:
+			type_str = "VINE_MINI_TASK";
+			break;
+		}
+		debug(D_VINE, "outfile_type: %s", type_str);
+		debug(D_VINE, "outfile_cached_name: %s", node->outfile->cached_name ? node->outfile->cached_name : "(null)");
+	} else {
+		debug(D_VINE, "outfile_type: SHARED_FILE_SYSTEM or none");
+	}
+
+	/* print parent and child node keys */
+	char *parent_keys = NULL;
+	struct strategic_orchestration_node *p;
+	LIST_ITERATE(node->parents, p)
+	{
+		if (!parent_keys) {
+			parent_keys = string_format("%s", p->node_key);
+		} else {
+			char *tmp = string_format("%s, %s", parent_keys, p->node_key);
+			free(parent_keys);
+			parent_keys = tmp;
+		}
+	}
+
+	char *child_keys = NULL;
+	struct strategic_orchestration_node *c;
+	LIST_ITERATE(node->children, c)
+	{
+		if (!child_keys) {
+			child_keys = string_format("%s", c->node_key);
+		} else {
+			char *tmp = string_format("%s, %s", child_keys, c->node_key);
+			free(child_keys);
+			child_keys = tmp;
+		}
+	}
+
+	debug(D_VINE, "parents: %s", parent_keys ? parent_keys : "(none)");
+	debug(D_VINE, "children: %s", child_keys ? child_keys : "(none)");
+
+	free(parent_keys);
+	free(child_keys);
+
+	debug(D_VINE, "-------------------------------------------");
+}
+
+/**
+ * Prune the ancestors of a node when it is completed.
+ * @param node Reference to the node object.
+ */
+void son_prune_ancestors(struct strategic_orchestration_node *node)
+{
+	if (!node) {
+		return;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	if (_node_outfile_is_persisted(node)) {
+		pruned_replica_count = prune_ancestors_of_persisted_node(node);
+	} else {
+		pruned_replica_count = prune_ancestors_of_temp_node(node);
+	}
+
+	timestamp_t elapsed_time = timestamp_get() - start_time;
+
+	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
+}
+
+/**
+ * Replicate the outfile of a node if it is a temp file.
+ * @param node Reference to the node object.
+ */
+void son_replicate_outfile(struct strategic_orchestration_node *node)
+{
+	if (!node || !node->outfile) {
+		return;
+	}
+
+	if (node->outfile->type != VINE_TEMP) {
+		return;
+	}
+
+	vine_temp_replicate_file_later(node->manager, node->outfile);
+}
+
+/**
+ * Delete the node and all of its associated resources.
+ * @param node Reference to the node object.
+ */
+void son_delete(struct strategic_orchestration_node *node)
+{
+	if (!node) {
+		return;
+	}
+
+	if (node->node_key) {
+		free(node->node_key);
+	}
+	if (node->outfile_remote_name) {
+		free(node->outfile_remote_name);
+	}
+	if (node->target_results_dir) {
+		free(node->target_results_dir);
+	}
+
+	vine_task_delete(node->task);
+	node->task = NULL;
+
+	if (node->infile) {
+		vine_file_delete(node->infile);
+		node->infile = NULL;
+	}
+	if (node->outfile) {
+		vine_file_delete(node->outfile);
+		node->outfile = NULL;
+	}
+
+	list_delete(node->parents);
+	list_delete(node->children);
+
+	if (node->pending_parents) {
+		set_delete(node->pending_parents);
+	}
+	free(node);
+}
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.h b/taskvine/src/graph/dagvine/strategic_orchestration_node.h
new file mode 100644
index 0000000000..ac5bc70ec0
--- /dev/null
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_node.h
@@ -0,0 +1,92 @@
+#ifndef STRATEGIC_ORCHESTRATION_NODE_H
+#define STRATEGIC_ORCHESTRATION_NODE_H
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "list.h"
+#include "vine_manager.h"
+#include "set.h"
+#include "taskvine.h"
+
+/** Select the type of the node-output file. */
+typedef enum {
+    VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
+    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
+    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
+} node_outfile_type_t;
+
+typedef enum {
+    PRUNE_STATUS_NOT_PRUNED = 0,
+    PRUNE_STATUS_SAFE, 
+    PRUNE_STATUS_UNSAFE
+} prune_status_t;
+
+struct strategic_orchestration_node {
+    char *node_key;
+
+    /* Whether the node is a target key.
+     * If true, the output of the node will be declared as a vine_file and retrieved through the network. */
+    int is_target_key;
+
+    struct vine_manager *manager;
+    struct vine_task *task;
+    struct vine_file *infile;
+    struct vine_file *outfile;
+    char *outfile_remote_name;
+    char *target_results_dir;
+    size_t outfile_size_bytes;
+        
+    struct list *parents;
+    struct list *children;
+    struct set *pending_parents;
+    
+    int retry_attempts_left;
+    int completed;
+    int prune_depth;
+
+    int depth;
+    int height;
+    int upstream_subgraph_size;
+    int downstream_subgraph_size;
+    int fan_in;
+    int fan_out;
+    double heavy_score;
+
+    timestamp_t critical_time;
+    timestamp_t time_spent_on_unlink_local_files;
+    timestamp_t time_spent_on_prune_ancestors_of_temp_node;
+    timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
+
+    node_outfile_type_t outfile_type;
+    prune_status_t prune_status;
+};
+
+/** Create a new strategic orchestration node object.
+@param manager Reference to the manager object.
+@param node_key Reference to the node key.
+@param is_target_key Reference to whether the node is a target key.
+@param proxy_library_name Reference to the proxy library name.
+@param proxy_function_name Reference to the proxy function name.
+@param target_results_dir Reference to the target results directory.
+@param prune_depth Reference to the prune depth.
+@return A new strategic orchestration node object.
+*/
+struct strategic_orchestration_node *son_create(
+    struct vine_manager *manager,
+    const char *node_key,
+    int is_target_key,
+    const char *proxy_library_name,
+    const char *proxy_function_name,
+    const char *target_results_dir,
+    int prune_depth
+);
+
+double compute_lex_priority(const char *key);
+
+void son_delete(struct strategic_orchestration_node *node);
+void son_prune_ancestors(struct strategic_orchestration_node *node);
+void son_print_info(struct strategic_orchestration_node *node);
+void son_update_critical_time(struct strategic_orchestration_node *node, timestamp_t execution_time);
+void son_replicate_outfile(struct strategic_orchestration_node *node);
+
+#endif
\ No newline at end of file

From 90476b8e2ebacc3d47366a9218251cf24e703fdd Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 14:45:08 -0400
Subject: [PATCH 048/113] lint and format

---
 taskvine/src/bindings/python3/Makefile        |   3 +-
 .../python3/ndcctools/taskvine/utils.py       |   9 -
 taskvine/src/graph/dagvine/Makefile           |  23 +-
 taskvine/src/graph/dagvine/cvine_dagvine.py   | 107 --------
 taskvine/src/graph/dagvine/graph_executor.py  | 255 ------------------
 taskvine/src/graph/dagvine/params.py          |   2 +-
 taskvine/src/graph/dagvine/proxy_functions.py |   9 +-
 taskvine/src/graph/dagvine/proxy_library.py   |  13 +-
 .../graph/dagvine/runtime_execution_graph.py  |   7 +-
 .../dagvine/strategic_orchestration_graph.c   |  31 ++-
 .../dagvine/strategic_orchestration_graph.h   |  41 ++-
 .../dagvine/strategic_orchestration_graph.i   |   8 +-
 .../dagvine/strategic_orchestration_graph.py  |  24 +-
 .../dagvine/strategic_orchestration_node.c    |  18 --
 .../dagvine/strategic_orchestration_node.h    | 123 +++++----
 taskvine/src/graph/dagvine/utils.py           |  17 --
 16 files changed, 166 insertions(+), 524 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/cvine_dagvine.py
 delete mode 100644 taskvine/src/graph/dagvine/graph_executor.py
 delete mode 100644 taskvine/src/graph/dagvine/utils.py

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index 3289a4da46..16d9cd5ceb 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -40,10 +40,9 @@ install: all
 
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/graph_executor.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/executor.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_library.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_library.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_functions.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_functions.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/strategic_orchestration_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/strategic_orchestration_graph.py
 	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/params.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/params.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/utils.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/utils.py
 	@echo "# ${GRAPH_EXECUTOR_MODULE_NAME} package" > $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/__init__.py
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index e493e7c04a..166b2800f2 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -3,10 +3,6 @@
 # See the file COPYING for details.
 
 from . import cvine
-try:
-    from .dagvine import cdagvine
-except Exception:
-    cdagvine = None
 
 import os
 
@@ -20,11 +16,6 @@ def get_c_constant(constant):
     value = getattr(cvine, constant, None)
     if value is not None:
         return value
-    # Fallback to cdagvine if available (for DAG-specific constants)
-    if cdagvine is not None:
-        value = getattr(cdagvine, constant, None)
-        if value is not None:
-            return value
     # If still missing, raise a clear error
     raise AttributeError(f"C constant {constant} not found in cvine or cdagvine")
 
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index c2e3a38236..78eb2b4d7e 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -4,7 +4,9 @@ include ../../../../rules.mk
 LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
 LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 
- 
+
+DAGVINE_SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/dagvine
+
 
 SOURCES = strategic_orchestration_node.c strategic_orchestration_graph.c
 OBJECTS = $(SOURCES:%.c=%.o)
@@ -15,7 +17,7 @@ SWIG_I = strategic_orchestration_graph.i
 BUILD_DIR := build
 SWIG_WRAP = $(BUILD_DIR)/strategic_orchestration_graph_wrap.c
 WRAP_OBJ = $(BUILD_DIR)/strategic_orchestration_graph_wrap.o
-PYMODULE = $(BUILD_DIR)/_cdagvine.$(CCTOOLS_DYNAMIC_SUFFIX)
+PYMODULE = $(BUILD_DIR)/_capi.$(CCTOOLS_DYNAMIC_SUFFIX)
 
 LIBRARIES =
 PYDEPS = $(WRAP_OBJ) $(OBJECTS)
@@ -54,18 +56,27 @@ install: all
 	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include/
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
 	cp $(PYMODULE) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
-	cp $(BUILD_DIR)/cdagvine.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
-	# remove build artifacts after installation
-	rm -rf $(BUILD_DIR)
+	cp $(BUILD_DIR)/capi.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
 
 clean:
-	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(BUILD_DIR) $(PYMODULE) cdagvine.py
+	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(BUILD_DIR) $(PYMODULE) capi.py
 
 test: all
 
 lint:
+	if ( ! clang-format -Werror --dry-run --style='file:${CCTOOLS_HOME}/.clang-format' $(DAGVINE_SOURCE_DIR)/*.c $(DAGVINE_SOURCE_DIR)/*.h);\
+	then\
+		echo  "========================================================";\
+		echo  "NOTICE: Run \`make format\` to format your latest changes.";\
+		echo  "========================================================";\
+		exit 1;\
+	fi
+	flake8 --ignore=$(CCTOOLS_FLAKE8_IGNORE_ERRORS) \
+		--exclude=$(CCTOOLS_FLAKE8_IGNORE_FILES),$(BUILD_DIR) \
+		$(DAGVINE_SOURCE_DIR)/
 
 format:
+	clang-format -i $(DAGVINE_SOURCE_DIR)/*.c $(DAGVINE_SOURCE_DIR)/*.h
 
 .PHONY: all clean install test lint format
 
diff --git a/taskvine/src/graph/dagvine/cvine_dagvine.py b/taskvine/src/graph/dagvine/cvine_dagvine.py
deleted file mode 100644
index df154836f1..0000000000
--- a/taskvine/src/graph/dagvine/cvine_dagvine.py
+++ /dev/null
@@ -1,107 +0,0 @@
-# This file was automatically generated by SWIG (https://www.swig.org).
-# Version 4.3.1
-#
-# Do not make changes to this file unless you know what you are doing - modify
-# the SWIG interface file instead.
-
-from sys import version_info as _swig_python_version_info
-# Import the low-level C/C++ module
-if __package__ or "." in __name__:
-    from . import _cvine_dagvine
-else:
-    import _cvine_dagvine
-
-try:
-    import builtins as __builtin__
-except ImportError:
-    import __builtin__
-
-def _swig_repr(self):
-    try:
-        strthis = "proxy of " + self.this.__repr__()
-    except __builtin__.Exception:
-        strthis = ""
-    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
-
-
-def _swig_setattr_nondynamic_instance_variable(set):
-    def set_instance_attr(self, name, value):
-        if name == "this":
-            set(self, name, value)
-        elif name == "thisown":
-            self.this.own(value)
-        elif hasattr(self, name) and isinstance(getattr(type(self), name), property):
-            set(self, name, value)
-        else:
-            raise AttributeError("You cannot add instance attributes to %s" % self)
-    return set_instance_attr
-
-
-def _swig_setattr_nondynamic_class_variable(set):
-    def set_class_attr(cls, name, value):
-        if hasattr(cls, name) and not isinstance(getattr(cls, name), property):
-            set(cls, name, value)
-        else:
-            raise AttributeError("You cannot add class attributes to %s" % cls)
-    return set_class_attr
-
-
-def _swig_add_metaclass(metaclass):
-    """Class decorator for adding a metaclass to a SWIG wrapped class - a slimmed down version of six.add_metaclass"""
-    def wrapper(cls):
-        return metaclass(cls.__name__, cls.__bases__, cls.__dict__.copy())
-    return wrapper
-
-
-class _SwigNonDynamicMeta(type):
-    """Meta class to enforce nondynamic attributes (no new attributes) for a class"""
-    __setattr__ = _swig_setattr_nondynamic_class_variable(type.__setattr__)
-
-
-import cvine
-class vine_task_graph(object):
-    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
-    __repr__ = _swig_repr
-    manager = property(_cvine_dagvine.vine_task_graph_manager_get, _cvine_dagvine.vine_task_graph_manager_set)
-    nodes = property(_cvine_dagvine.vine_task_graph_nodes_get, _cvine_dagvine.vine_task_graph_nodes_set)
-    task_id_to_node = property(_cvine_dagvine.vine_task_graph_task_id_to_node_get, _cvine_dagvine.vine_task_graph_task_id_to_node_set)
-    outfile_cachename_to_node = property(_cvine_dagvine.vine_task_graph_outfile_cachename_to_node_get, _cvine_dagvine.vine_task_graph_outfile_cachename_to_node_set)
-    proxy_library_name = property(_cvine_dagvine.vine_task_graph_proxy_library_name_get, _cvine_dagvine.vine_task_graph_proxy_library_name_set)
-    proxy_function_name = property(_cvine_dagvine.vine_task_graph_proxy_function_name_get, _cvine_dagvine.vine_task_graph_proxy_function_name_set)
-    task_priority_mode = property(_cvine_dagvine.vine_task_graph_task_priority_mode_get, _cvine_dagvine.vine_task_graph_task_priority_mode_set)
-    failure_injection_step_percent = property(_cvine_dagvine.vine_task_graph_failure_injection_step_percent_get, _cvine_dagvine.vine_task_graph_failure_injection_step_percent_set)
-
-    def __init__(self):
-        _cvine_dagvine.vine_task_graph_swiginit(self, _cvine_dagvine.new_vine_task_graph())
-    __swig_destroy__ = _cvine_dagvine.delete_vine_task_graph
-
-# Register vine_task_graph in _cvine_dagvine:
-_cvine_dagvine.vine_task_graph_swigregister(vine_task_graph)
-
-def vine_task_graph_create(q):
-    return _cvine_dagvine.vine_task_graph_create(q)
-
-def vine_task_graph_set_priority_mode(tg, priority_mode):
-    return _cvine_dagvine.vine_task_graph_set_priority_mode(tg, priority_mode)
-
-def vine_task_graph_set_failure_injection_step_percent(tg, percent):
-    return _cvine_dagvine.vine_task_graph_set_failure_injection_step_percent(tg, percent)
-
-def vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth):
-    return _cvine_dagvine.vine_task_graph_add_node(tg, node_key, staging_dir, prune_depth)
-
-def vine_task_graph_add_dependency(tg, parent_key, child_key):
-    return _cvine_dagvine.vine_task_graph_add_dependency(tg, parent_key, child_key)
-
-def vine_task_graph_compute_topology_metrics(tg):
-    return _cvine_dagvine.vine_task_graph_compute_topology_metrics(tg)
-
-def vine_task_graph_get_node_heavy_score(tg, node_key):
-    return _cvine_dagvine.vine_task_graph_get_node_heavy_score(tg, node_key)
-
-def vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name):
-    return _cvine_dagvine.vine_task_graph_set_node_outfile(tg, node_key, outfile_type, outfile_remote_name)
-
-def vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name):
-    return _cvine_dagvine.vine_task_graph_set_proxy_library_and_function_names(tg, proxy_library_name, proxy_function_name)
-
diff --git a/taskvine/src/graph/dagvine/graph_executor.py b/taskvine/src/graph/dagvine/graph_executor.py
deleted file mode 100644
index 163992ba68..0000000000
--- a/taskvine/src/graph/dagvine/graph_executor.py
+++ /dev/null
@@ -1,255 +0,0 @@
-
-from ndcctools.taskvine import cvine
-from ndcctools.taskvine.manager import Manager
-from ndcctools.taskvine.utils import delete_all_files
-
-from ndcctools.taskvine.dagvine.proxy_library import ProxyLibrary
-from ndcctools.taskvine.dagvine.runtime_execution_graph import RuntimeExecutionGraph, GraphKeyResult
-from ndcctools.taskvine.dagvine.strategic_orchestration_graph import StrategicOrchestrationGraph
-
-import cloudpickle
-import os
-import signal
-
-try:
-    import dask
-except ImportError:
-    dask = None
-
-try:
-    from dask.base import is_dask_collection
-except ImportError:
-    is_dask_collection = None
-
-try:
-    import dask._task_spec as dts
-except ImportError:
-    dts = None
-
-
-# convert Dask collection to task dictionary
-def dask_collections_to_task_dict(collection_dict):
-    assert is_dask_collection is not None
-    from dask.highlevelgraph import HighLevelGraph, ensure_dict
-
-    if not isinstance(collection_dict, dict):
-        raise TypeError("Input must be a dict or a HighLevelGraph")
-
-    for k, v in collection_dict.items():
-        if not is_dask_collection(v):
-            raise TypeError(f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}")
-
-    if dts:
-        sub_hlgs = [v.dask for v in collection_dict.values()]
-        hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
-    else:
-        hlg = dask.base.collections_to_dsk(collection_dict.values())
-
-    return ensure_dict(hlg)
-
-
-# compatibility for Dask-created collections
-def ensure_task_dict(collection_dict):
-    if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
-        task_dict = dask_collections_to_task_dict(collection_dict)
-    else:
-        task_dict = collection_dict
-
-    if dts:
-        return dts.convert_legacy_graph(task_dict)
-    else:
-        return task_dict
-
-
-class GraphParams:
-    def __init__(self):
-        self.vine_manager_tuning_params = {
-            "worker-source-max-transfers": 100,
-            "max-retrievals": -1,
-            "prefer-dispatch": 1,
-            "transient-error-interval": 1,
-            "attempt-schedule-depth": 10000,
-            "temp-replica-count": 1,
-            "enforce-worker-eviction-interval": -1,
-            "balance-worker-disk-load": 0,
-        }
-        self.sog_tuning_params = {
-            "failure-injection-step-percent": -1,
-            "priority-mode": "largest-input-first",
-            "prune-depth": 1,
-            "target-results-dir": "./target_results",
-            "checkpoint-fraction": 0,
-        }
-        self.other_params = {
-            "schedule": "worst",
-            "libcores": 16,
-            "failure-injection-step-percent": -1,
-            "shared-file-system-dir": "./shared_file_system",
-            "extra-task-output-size-mb": ["uniform", 0, 0],
-            "extra-task-sleep-time": ["uniform", 0, 0],
-            "outfile-type": {
-                "temp": 1.0,
-                "shared-file-system": 0.0,
-            },
-        }
-
-    def update_param(self, param_name, new_value):
-        if param_name in self.vine_manager_tuning_params:
-            self.vine_manager_tuning_params[param_name] = new_value
-        elif param_name in self.sog_tuning_params:
-            self.sog_tuning_params[param_name] = new_value
-        elif param_name in self.other_params:
-            self.other_params[param_name] = new_value
-        else:
-            self.vine_manager_tuning_params[param_name] = new_value
-
-    def get_value_of(self, param_name):
-        if param_name in self.vine_manager_tuning_params:
-            return self.vine_manager_tuning_params[param_name]
-        elif param_name in self.sog_tuning_params:
-            return self.sog_tuning_params[param_name]
-        elif param_name in self.other_params:
-            return self.other_params[param_name]
-        else:
-            raise ValueError(f"Invalid param name: {param_name}")
-
-
-class GraphExecutor(Manager):
-    def __init__(self,
-                 *args,
-                 **kwargs):
-
-        # handle SIGINT correctly
-        signal.signal(signal.SIGINT, self._on_sigint)
-
-        self.params = GraphParams()
-
-        # delete all files in the run info directory, do this before super().__init__()
-        run_info_path = kwargs.get("run_info_path", None)
-        run_info_template = kwargs.get("run_info_template", None)
-        self.run_info_template_path = os.path.join(run_info_path, run_info_template)
-        if self.run_info_template_path:
-            delete_all_files(self.run_info_template_path)
-
-        # initialize the manager
-        super().__init__(*args, **kwargs)
-
-        self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
-
-    def tune_manager(self):
-        for k, v in self.manager_tuning_params.to_dict().items():
-            print(f"Tuning {k} to {v}")
-            self.tune(k, v)
-
-        # set worker scheduling algorithm
-        cvine.vine_set_scheduler(self._taskvine, self.vine_constant_params.get_c_constant_of("schedule"))
-
-    def param(self, param_name):
-        return self.params.get_value_of(param_name)
-
-    def update_params(self, new_params):
-        assert isinstance(new_params, dict), "new_params must be a dict"
-        for k, new_v in new_params.items():
-            self.params.update_param(k, new_v)
-
-    def get_run_info_path(self):
-        return os.path.join(self.param("run-info-path"), self.param("run-info-template"))
-
-    def tune_vine_manager(self):
-        for k, v in self.params.vine_manager_tuning_params.items():
-            print(f"Tuning {k} to {v}")
-            self.tune(k, v)
-
-    def tune_sog(self, sog):
-        for k, v in self.params.sog_tuning_params.items():
-            print(f"Tuning {k} to {v}")
-            sog.tune(k, str(v))
-
-    def build_reg(self):
-        reg = RuntimeExecutionGraph(
-            self.task_dict,
-            shared_file_system_dir=self.param("shared-file-system-dir"),
-            extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
-            extra_task_sleep_time=self.param("extra-task-sleep-time")
-        )
-
-        return reg
-
-    def build_sog(self, reg, target_keys):
-        assert reg is not None, "Python graph must be built before building the C graph"
-
-        sog = StrategicOrchestrationGraph(self._taskvine)
-
-        sog.set_proxy_function_name("compute_single_key")
-
-        # C side vine task graph must be tuned before adding nodes and dependencies
-        self.tune_vine_manager()
-        self.tune_sog(sog)
-
-        topo_order = reg.get_topological_order()
-        for k in topo_order:
-            sog.add_node(reg.sog_node_key_of[k], int(k in target_keys))
-            for pk in reg.parents_of[k]:      #!!!!!!!!!!!!!!!!!!!!!!! TODO: fix sog-reg key mapping
-                sog.add_dependency(reg.sog_node_key_of[pk], reg.sog_node_key_of[k])
-
-        sog.compute_topology_metrics()
-
-        return sog
-
-    def build_graphs(self, target_keys):
-        # build Python DAG (logical topology)
-        reg = self.build_reg()
-        # build C DAG (physical topology)
-        sog = self.build_sog(reg, target_keys)
-
-        # set outfile remote names in reg from sog, note that these names are automatically generated
-        # with regard to the checkpointing strategy and the shared file system directory
-        for sog_node_key in reg.sog_node_key_of.values():
-            outfile_remote_name = sog.get_node_outfile_remote_name(sog_node_key)
-            reg.set_outfile_remote_name_of(reg.reg_node_key_of[sog_node_key], outfile_remote_name)
-
-        return reg, sog
-
-    def create_proxy_library(self, reg, sog, hoisting_modules, env_files):
-        proxy_library = ProxyLibrary(self)
-        proxy_library.add_hoisting_modules(hoisting_modules)
-        proxy_library.add_env_files(env_files)
-        proxy_library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
-        proxy_library.set_libcores(self.param("libcores"))
-        proxy_library.set_name(sog.get_proxy_library_name())
-        proxy_library.install()
-
-        return proxy_library
-
-    def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}):
-        # first update the params so that they can be used for the following construction
-        self.update_params(params)
-
-        self.task_dict = ensure_task_dict(collection_dict)
-
-        # build graphs from both sides
-        reg, sog = self.build_graphs(target_keys)
-
-        # create and install the proxy library on the manager
-        proxy_library = self.create_proxy_library(reg, sog, hoisting_modules, env_files)
-
-        # execute the graph on the C side
-        print(f"Executing task graph, logs will be written to {self.runtime_directory}")
-        sog.execute()
-
-        # clean up the library instances and template on the manager
-        proxy_library.uninstall()
-
-        # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
-        sog.delete()
-
-        # load results of target keys
-        results = {}
-        for k in target_keys:
-            outfile_path = os.path.join(self.param("target-results-dir"), reg.outfile_remote_name[k])
-            results[k] = GraphKeyResult.load_from_path(outfile_path)
-        return results
-
-    def _on_sigint(self, signum, frame):
-        self.__del__()
-
diff --git a/taskvine/src/graph/dagvine/params.py b/taskvine/src/graph/dagvine/params.py
index 41a81e23fc..d513f8b2ac 100644
--- a/taskvine/src/graph/dagvine/params.py
+++ b/taskvine/src/graph/dagvine/params.py
@@ -4,7 +4,7 @@
 
 @dataclass
 class ManagerTuningParams:
-    """These parameters are used to tune the manager at the C level 
+    """These parameters are used to tune the manager at the C level
     and should comply with the TaskVine manager API."""
     worker_source_max_transfers: int = 100
     max_retrievals: int = -1
diff --git a/taskvine/src/graph/dagvine/proxy_functions.py b/taskvine/src/graph/dagvine/proxy_functions.py
index c415cf9d40..e79243f987 100644
--- a/taskvine/src/graph/dagvine/proxy_functions.py
+++ b/taskvine/src/graph/dagvine/proxy_functions.py
@@ -1,4 +1,9 @@
-import os, time
+# Copyright (C) 2025- The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+import os
+import time
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
@@ -87,7 +92,7 @@ def compute_single_key(vine_key):
     """
     reg = load_variable_from_library('reg')
 
-    k = reg.reg_node_key_of[vine_key]
+    k = reg.sog_key_to_reg_key[vine_key]
     v = reg.task_dict[k]
 
     if reg.is_dts_key(k):
diff --git a/taskvine/src/graph/dagvine/proxy_library.py b/taskvine/src/graph/dagvine/proxy_library.py
index aa14b4a607..01e9bda3be 100644
--- a/taskvine/src/graph/dagvine/proxy_library.py
+++ b/taskvine/src/graph/dagvine/proxy_library.py
@@ -1,4 +1,15 @@
-import os, uuid, cloudpickle, types, time, random, hashlib, collections
+# Copyright (C) 2025- The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+import os
+import uuid
+import cloudpickle
+import types
+import time
+import random
+import hashlib
+import collections
 from ndcctools.taskvine.dagvine.runtime_execution_graph import (
     GraphKeyResult, RuntimeExecutionGraph, hash_name, hashable
 )
diff --git a/taskvine/src/graph/dagvine/runtime_execution_graph.py b/taskvine/src/graph/dagvine/runtime_execution_graph.py
index 4e4f7c81b5..bc5b8049f4 100644
--- a/taskvine/src/graph/dagvine/runtime_execution_graph.py
+++ b/taskvine/src/graph/dagvine/runtime_execution_graph.py
@@ -4,10 +4,8 @@
 
 import os
 import hashlib
-import time
 import cloudpickle
 import collections
-import uuid
 import random
 from collections import deque
 
@@ -125,8 +123,8 @@ def __init__(self, task_dict,
         self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
         self.depth_of = self._calculate_depths()
 
-        self.sog_node_key_of = {k: hash_name(k) for k in task_dict.keys()}
-        self.reg_node_key_of = {hash_name(k): k for k in task_dict.keys()}
+        self.reg_key_to_sog_key = {k: hash_name(k) for k in task_dict.keys()}
+        self.sog_key_to_reg_key = {hash_name(k): k for k in task_dict.keys()}
 
         # will be set from sog
         self.outfile_remote_name = {key: None for key in self.task_dict.keys()}
@@ -264,4 +262,3 @@ def context_loader_func(reg_pkl):
         return {
             "reg": reg,
         }
-
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
index 45a6e2246b..464cd2a969 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
@@ -31,7 +31,6 @@
 #include "vine_mount.h"
 #include "taskvine.h"
 
-
 static volatile sig_atomic_t interrupted = 0;
 
 /*************************************************************/
@@ -47,6 +46,23 @@ static void handle_sigint(int signal)
 	interrupted = 1;
 }
 
+/**
+ * Compute a lexicographic priority score from the node key.
+ * Used during topological sorting to break ties deterministically.
+ * @param key Reference to the node key.
+ * @return The lexical priority.
+ */
+static double compute_lex_priority(const char *key)
+{
+	double score = 0.0;
+	double factor = 1.0;
+	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
+		score += (unsigned char)key[i] * factor;
+		factor *= 0.01;
+	}
+	return -score;
+}
+
 /**
  * Calculate the priority of a node given the priority mode.
  * @param node Reference to the node object.
@@ -141,7 +157,7 @@ static void submit_unblocked_children(struct strategic_orchestration_graph *sog,
 		return;
 	}
 
-	struct strategic_orchestration_node *child_node; 
+	struct strategic_orchestration_node *child_node;
 	LIST_ITERATE(node->children, child_node)
 	{
 		/* Remove this parent from the child's pending set if it exists */
@@ -355,7 +371,7 @@ static struct strategic_orchestration_node *get_node_by_task(struct strategic_or
 /*************************************************************/
 
 /** Tune the strategic orchestration graph.
-*@param sog Reference to the strategic orchestration graph object.
+ *@param sog Reference to the strategic orchestration graph object.
  *@param name Reference to the name of the parameter to tune.
  *@param value Reference to the value of the parameter to tune.
  *@return 0 on success, -1 on failure.
@@ -387,7 +403,7 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		} else {
 			debug(D_ERROR, "invalid priority mode: %s", value);
 			return -1;
-		}		
+		}
 
 	} else if (strcmp(name, "target-results-dir") == 0) {
 		if (sog->target_results_dir) {
@@ -401,7 +417,7 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 
 	} else if (strcmp(name, "prune-depth") == 0) {
 		sog->prune_depth = atoi(value);
-		
+
 	} else if (strcmp(name, "checkpoint-fraction") == 0) {
 		double fraction = atof(value);
 		if (fraction < 0.0 || fraction > 1.0) {
@@ -413,7 +429,6 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 	} else {
 		debug(D_ERROR, "invalid parameter name: %s", name);
 		return -1;
-
 	}
 
 	return 0;
@@ -729,12 +744,12 @@ struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
 	struct strategic_orchestration_graph *sog = xxmalloc(sizeof(struct strategic_orchestration_graph));
 
 	sog->manager = q;
-	
+
 	sog->nodes = hash_table_create(0, 0);
 	sog->task_id_to_node = itable_create(0);
 	sog->outfile_cachename_to_node = hash_table_create(0, 0);
 
-	sog->target_results_dir = xxstrdup(sog->manager->runtime_directory);  // default to current working directory
+	sog->target_results_dir = xxstrdup(sog->manager->runtime_directory); // default to current working directory
 
 	cctools_uuid_t proxy_library_name_id;
 	cctools_uuid_create(&proxy_library_name_id);
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
index db8009c9fa..affadd39b1 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
@@ -9,43 +9,40 @@
 #include "strategic_orchestration_node.h"
 #include "taskvine.h"
 
-
 /** Select priority algorithm for strategic orchestration graph task scheduling. */
 typedef enum {
-    TASK_PRIORITY_MODE_RANDOM = 0,          /**< Assign random priority to tasks */
-    TASK_PRIORITY_MODE_DEPTH_FIRST,         /**< Prioritize deeper tasks first */
-    TASK_PRIORITY_MODE_BREADTH_FIRST,       /**< Prioritize shallower tasks first */
-    TASK_PRIORITY_MODE_FIFO,                /**< First in, first out priority */
-    TASK_PRIORITY_MODE_LIFO,                /**< Last in, first out priority */
-    TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST, /**< Prioritize tasks with larger inputs first */
-    TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+	TASK_PRIORITY_MODE_RANDOM = 0,			   /**< Assign random priority to tasks */
+	TASK_PRIORITY_MODE_DEPTH_FIRST,			   /**< Prioritize deeper tasks first */
+	TASK_PRIORITY_MODE_BREADTH_FIRST,		   /**< Prioritize shallower tasks first */
+	TASK_PRIORITY_MODE_FIFO,			   /**< First in, first out priority */
+	TASK_PRIORITY_MODE_LIFO,			   /**< Last in, first out priority */
+	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		   /**< Prioritize tasks with larger inputs first */
+	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
 } task_priority_mode_t;
 
-
 /** The strategic orchestration graph object (logical scheduling layer). */
 struct strategic_orchestration_graph {
-    struct vine_manager *manager;
+	struct vine_manager *manager;
 	struct hash_table *nodes;
 	struct itable *task_id_to_node;
 	struct hash_table *outfile_cachename_to_node;
 
-    /* Results of target keys will be stored in this directory. 
-     * This dir path can not necessarily be a shared file system directory,
-     * output files will be retrieved through the network instead,
-     * as long as the manager can access it. */
-    char *target_results_dir;
+	/* Results of target keys will be stored in this directory.
+	 * This dir path can not necessarily be a shared file system directory,
+	 * output files will be retrieved through the network instead,
+	 * as long as the manager can access it. */
+	char *target_results_dir;
 
-    char *proxy_library_name;    // Python-side proxy library name (shared by all tasks)
-    char *proxy_function_name;   // Python-side proxy function name (shared by all tasks)
+	char *proxy_library_name;  // Python-side proxy library name (shared by all tasks)
+	char *proxy_function_name; // Python-side proxy function name (shared by all tasks)
 
-    int prune_depth;
-    double checkpoint_fraction;  // 0 - 1, the fraction of intermediate results to checkpoint
+	int prune_depth;
+	double checkpoint_fraction; // 0 - 1, the fraction of intermediate results to checkpoint
 
-    task_priority_mode_t task_priority_mode;  // priority mode for task graph task scheduling
-    double failure_injection_step_percent;  // 0 - 100, the percentage of steps to inject failure
+	task_priority_mode_t task_priority_mode; // priority mode for task graph task scheduling
+	double failure_injection_step_percent;	 // 0 - 100, the percentage of steps to inject failure
 };
 
-
 /* Public APIs for operating the strategic orchestration graph */
 
 /** Create a strategic orchestration graph object and return it.
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i b/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
index 86295b3949..c2bc74659e 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
@@ -1,9 +1,8 @@
-/* SWIG interface for local dagvine graph bindings */
-%module cdagvine
+/* SWIG interface for local dagvine graph API bindings */
+%module capi
 
 %{
 #include "int_sizes.h"
-#include "strategic_orchestration_node.h"
 #include "strategic_orchestration_graph.h"
 %}
 
@@ -13,7 +12,4 @@
 /* Import existing SWIG interface for type information (do not wrap again) */
 %import "../../bindings/python3/taskvine.i"
 
-%include "strategic_orchestration_node.h"
 %include "strategic_orchestration_graph.h"
-
-
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.py b/taskvine/src/graph/dagvine/strategic_orchestration_graph.py
index c441997a14..c7f9fb04a6 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.py
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.py
@@ -1,33 +1,33 @@
-from ndcctools.taskvine.dagvine import cdagvine
+from ndcctools.taskvine.dagvine import capi
 
 
 class StrategicOrchestrationGraph:
     def __init__(self, c_taskvine):
-        self._c_sog = cdagvine.sog_create(c_taskvine)
+        self._c_sog = capi.sog_create(c_taskvine)
 
     def tune(self, name, value):
-        cdagvine.sog_tune(self._c_sog, name, value)
+        capi.sog_tune(self._c_sog, name, value)
 
     def add_node(self, key, is_target_key):
-        cdagvine.sog_add_node(self._c_sog, key, is_target_key)
+        capi.sog_add_node(self._c_sog, key, is_target_key)
 
     def add_dependency(self, parent_key, child_key):
-        cdagvine.sog_add_dependency(self._c_sog, parent_key, child_key)
+        capi.sog_add_dependency(self._c_sog, parent_key, child_key)
 
     def compute_topology_metrics(self):
-        cdagvine.sog_compute_topology_metrics(self._c_sog)
+        capi.sog_compute_topology_metrics(self._c_sog)
 
     def get_node_outfile_remote_name(self, key):
-        return cdagvine.sog_get_node_outfile_remote_name(self._c_sog, key)
+        return capi.sog_get_node_outfile_remote_name(self._c_sog, key)
 
     def get_proxy_library_name(self):
-        return cdagvine.sog_get_proxy_library_name(self._c_sog)
+        return capi.sog_get_proxy_library_name(self._c_sog)
 
-    def set_proxy_function_name(self, proxy_function_name):
-        cdagvine.sog_set_proxy_function_name(self._c_sog, proxy_function_name)
+    def set_proxy_function(self, proxy_function):
+        capi.sog_set_proxy_function_name(self._c_sog, proxy_function.__name__)
 
     def execute(self):
-        cdagvine.sog_execute(self._c_sog)
+        capi.sog_execute(self._c_sog)
 
     def delete(self):
-        cdagvine.sog_delete(self._c_sog)
\ No newline at end of file
+        capi.sog_delete(self._c_sog)
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.c b/taskvine/src/graph/dagvine/strategic_orchestration_node.c
index a9ec6209e6..ee757a4e8c 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_node.c
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_node.c
@@ -25,24 +25,6 @@
 #include "strategic_orchestration_node.h"
 #include "taskvine.h"
 
-
-/**
- * Compute a lexicographic priority score from the node key.
- * Used during topological sorting to break ties deterministically.
- * @param key Reference to the node key.
- * @return The lexical priority.
- */
-double compute_lex_priority(const char *key)
-{
-	double score = 0.0;
-	double factor = 1.0;
-	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
-		score += (unsigned char)key[i] * factor;
-		factor *= 0.01;
-	}
-	return -score;
-}
-
 /**
  * Create a new node object.
  * @param manager Reference to the manager object.
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.h b/taskvine/src/graph/dagvine/strategic_orchestration_node.h
index ac5bc70ec0..71390e02ca 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_node.h
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_node.h
@@ -10,55 +10,55 @@
 
 /** Select the type of the node-output file. */
 typedef enum {
-    VINE_NODE_OUTFILE_TYPE_LOCAL = 0,               /* Node-output file will be stored locally on the manager's staging directory */
-    VINE_NODE_OUTFILE_TYPE_TEMP,                    /* Node-output file will be stored in the temporary node-local storage */
-    VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,      /* Node-output file will be stored in the persistent shared file system */
+	VINE_NODE_OUTFILE_TYPE_LOCAL = 0,	   /* Node-output file will be stored locally on the manager's staging directory */
+	VINE_NODE_OUTFILE_TYPE_TEMP,		   /* Node-output file will be stored in the temporary node-local storage */
+	VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
 } node_outfile_type_t;
 
 typedef enum {
-    PRUNE_STATUS_NOT_PRUNED = 0,
-    PRUNE_STATUS_SAFE, 
-    PRUNE_STATUS_UNSAFE
+	PRUNE_STATUS_NOT_PRUNED = 0,
+	PRUNE_STATUS_SAFE,
+	PRUNE_STATUS_UNSAFE
 } prune_status_t;
 
 struct strategic_orchestration_node {
-    char *node_key;
-
-    /* Whether the node is a target key.
-     * If true, the output of the node will be declared as a vine_file and retrieved through the network. */
-    int is_target_key;
-
-    struct vine_manager *manager;
-    struct vine_task *task;
-    struct vine_file *infile;
-    struct vine_file *outfile;
-    char *outfile_remote_name;
-    char *target_results_dir;
-    size_t outfile_size_bytes;
-        
-    struct list *parents;
-    struct list *children;
-    struct set *pending_parents;
-    
-    int retry_attempts_left;
-    int completed;
-    int prune_depth;
-
-    int depth;
-    int height;
-    int upstream_subgraph_size;
-    int downstream_subgraph_size;
-    int fan_in;
-    int fan_out;
-    double heavy_score;
-
-    timestamp_t critical_time;
-    timestamp_t time_spent_on_unlink_local_files;
-    timestamp_t time_spent_on_prune_ancestors_of_temp_node;
-    timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
-
-    node_outfile_type_t outfile_type;
-    prune_status_t prune_status;
+	char *node_key;
+
+	/* Whether the node is a target key.
+	 * If true, the output of the node will be declared as a vine_file and retrieved through the network. */
+	int is_target_key;
+
+	struct vine_manager *manager;
+	struct vine_task *task;
+	struct vine_file *infile;
+	struct vine_file *outfile;
+	char *outfile_remote_name;
+	char *target_results_dir;
+	size_t outfile_size_bytes;
+
+	struct list *parents;
+	struct list *children;
+	struct set *pending_parents;
+
+	int retry_attempts_left;
+	int completed;
+	int prune_depth;
+
+	int depth;
+	int height;
+	int upstream_subgraph_size;
+	int downstream_subgraph_size;
+	int fan_in;
+	int fan_out;
+	double heavy_score;
+
+	timestamp_t critical_time;
+	timestamp_t time_spent_on_unlink_local_files;
+	timestamp_t time_spent_on_prune_ancestors_of_temp_node;
+	timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
+
+	node_outfile_type_t outfile_type;
+	prune_status_t prune_status;
 };
 
 /** Create a new strategic orchestration node object.
@@ -72,21 +72,38 @@ struct strategic_orchestration_node {
 @return A new strategic orchestration node object.
 */
 struct strategic_orchestration_node *son_create(
-    struct vine_manager *manager,
-    const char *node_key,
-    int is_target_key,
-    const char *proxy_library_name,
-    const char *proxy_function_name,
-    const char *target_results_dir,
-    int prune_depth
-);
-
-double compute_lex_priority(const char *key);
+		struct vine_manager *manager,
+		const char *node_key,
+		int is_target_key,
+		const char *proxy_library_name,
+		const char *proxy_function_name,
+		const char *target_results_dir,
+		int prune_depth);
 
+/** Delete a strategic orchestration node object.
+@param node Reference to the strategic orchestration node object.
+*/
 void son_delete(struct strategic_orchestration_node *node);
+
+/** Prune the ancestors of a strategic orchestration node object.
+@param node Reference to the strategic orchestration node object.
+*/
 void son_prune_ancestors(struct strategic_orchestration_node *node);
+
+/** Print information about a strategic orchestration node object.
+@param node Reference to the strategic orchestration node object.
+*/
 void son_print_info(struct strategic_orchestration_node *node);
+
+/** Update the critical time of a strategic orchestration node object.
+@param node Reference to the strategic orchestration node object.
+@param execution_time Reference to the execution time of the node.
+*/
 void son_update_critical_time(struct strategic_orchestration_node *node, timestamp_t execution_time);
+
+/** Replicate the outfile of a strategic orchestration node object.
+@param node Reference to the strategic orchestration node object.
+*/
 void son_replicate_outfile(struct strategic_orchestration_node *node);
 
 #endif
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/utils.py b/taskvine/src/graph/dagvine/utils.py
deleted file mode 100644
index d180f368da..0000000000
--- a/taskvine/src/graph/dagvine/utils.py
+++ /dev/null
@@ -1,17 +0,0 @@
-import inspect
-
-def extract_manager_kwargs(kwargs, base_class):
-    params = set(inspect.signature(base_class.__init__).parameters)
-    super_kwargs = {k: v for k, v in kwargs.items() if k in params}
-    leftover_kwargs = {k: v for k, v in kwargs.items() if k not in params}
-    return super_kwargs, leftover_kwargs
-
-def apply_tuning(manager, tune_dict):
-    for k, v in tune_dict.items():
-        try:
-            vine_param = k.replace("_", "-")
-            manager.tune(vine_param, v)
-            print(f"Tuned {vine_param} to {v}")
-        except Exception as e:
-            print(f"Failed to tune {k}={v}: {e}")
-            raise

From 256c02f875baea1d888f4dec3a3de0c33d20aba5 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 14:45:28 -0400
Subject: [PATCH 049/113] rename executor

---
 taskvine/src/graph/dagvine/executor.py | 255 +++++++++++++++++++++++++
 1 file changed, 255 insertions(+)
 create mode 100644 taskvine/src/graph/dagvine/executor.py

diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/executor.py
new file mode 100644
index 0000000000..9879116663
--- /dev/null
+++ b/taskvine/src/graph/dagvine/executor.py
@@ -0,0 +1,255 @@
+
+from ndcctools.taskvine import cvine
+from ndcctools.taskvine.manager import Manager
+from ndcctools.taskvine.utils import delete_all_files
+
+from ndcctools.taskvine.dagvine.proxy_library import ProxyLibrary
+from ndcctools.taskvine.dagvine.proxy_functions import compute_single_key
+from ndcctools.taskvine.dagvine.runtime_execution_graph import RuntimeExecutionGraph, GraphKeyResult
+from ndcctools.taskvine.dagvine.strategic_orchestration_graph import StrategicOrchestrationGraph
+
+import cloudpickle
+import os
+import signal
+import hashlib
+
+try:
+    import dask
+except ImportError:
+    dask = None
+
+try:
+    from dask.base import is_dask_collection
+except ImportError:
+    is_dask_collection = None
+
+try:
+    import dask._task_spec as dts
+except ImportError:
+    dts = None
+
+
+def hash_name(*args):
+    out_str = ""
+    for arg in args:
+        out_str += str(arg)
+    return hashlib.sha256(out_str.encode('utf-8')).hexdigest()[:32]
+
+
+# convert Dask collection to task dictionary
+def dask_collections_to_task_dict(collection_dict):
+    assert is_dask_collection is not None
+    from dask.highlevelgraph import HighLevelGraph, ensure_dict
+
+    if not isinstance(collection_dict, dict):
+        raise TypeError("Input must be a dict or a HighLevelGraph")
+
+    for k, v in collection_dict.items():
+        if not is_dask_collection(v):
+            raise TypeError(f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}")
+
+    if dts:
+        sub_hlgs = [v.dask for v in collection_dict.values()]
+        hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
+    else:
+        hlg = dask.base.collections_to_dsk(collection_dict.values())
+
+    return ensure_dict(hlg)
+
+
+# compatibility for Dask-created collections
+def ensure_task_dict(collection_dict):
+    if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
+        task_dict = dask_collections_to_task_dict(collection_dict)
+    else:
+        task_dict = collection_dict
+
+    if dts:
+        return dts.convert_legacy_graph(task_dict)
+    else:
+        return task_dict
+
+
+class GraphParams:
+    def __init__(self):
+        self.vine_manager_tuning_params = {
+            "worker-source-max-transfers": 100,
+            "max-retrievals": -1,
+            "prefer-dispatch": 1,
+            "transient-error-interval": 1,
+            "attempt-schedule-depth": 10000,
+            "temp-replica-count": 1,
+            "enforce-worker-eviction-interval": -1,
+            "balance-worker-disk-load": 0,
+        }
+        self.sog_tuning_params = {
+            "failure-injection-step-percent": -1,
+            "priority-mode": "largest-input-first",
+            "prune-depth": 1,
+            "target-results-dir": "./target_results",
+            "checkpoint-fraction": 0,
+        }
+        self.other_params = {
+            "schedule": "worst",
+            "libcores": 16,
+            "failure-injection-step-percent": -1,
+            "shared-file-system-dir": "./shared_file_system",
+            "extra-task-output-size-mb": ["uniform", 0, 0],
+            "extra-task-sleep-time": ["uniform", 0, 0],
+            "outfile-type": {
+                "temp": 1.0,
+                "shared-file-system": 0.0,
+            },
+        }
+
+    def update_param(self, param_name, new_value):
+        if param_name in self.vine_manager_tuning_params:
+            self.vine_manager_tuning_params[param_name] = new_value
+        elif param_name in self.sog_tuning_params:
+            self.sog_tuning_params[param_name] = new_value
+        elif param_name in self.other_params:
+            self.other_params[param_name] = new_value
+        else:
+            self.vine_manager_tuning_params[param_name] = new_value
+
+    def get_value_of(self, param_name):
+        if param_name in self.vine_manager_tuning_params:
+            return self.vine_manager_tuning_params[param_name]
+        elif param_name in self.sog_tuning_params:
+            return self.sog_tuning_params[param_name]
+        elif param_name in self.other_params:
+            return self.other_params[param_name]
+        else:
+            raise ValueError(f"Invalid param name: {param_name}")
+
+
+class Executor(Manager):
+    def __init__(self,
+                 *args,
+                 **kwargs):
+
+        # handle SIGINT correctly
+        signal.signal(signal.SIGINT, self._on_sigint)
+
+        self.params = GraphParams()
+
+        # delete all files in the run info directory, do this before super().__init__()
+        run_info_path = kwargs.get("run_info_path", None)
+        run_info_template = kwargs.get("run_info_template", None)
+        self.run_info_template_path = os.path.join(run_info_path, run_info_template)
+        if self.run_info_template_path:
+            delete_all_files(self.run_info_template_path)
+
+        # initialize the manager
+        super().__init__(*args, **kwargs)
+
+        self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
+
+    def param(self, param_name):
+        return self.params.get_value_of(param_name)
+
+    def update_params(self, new_params):
+        assert isinstance(new_params, dict), "new_params must be a dict"
+        for k, new_v in new_params.items():
+            self.params.update_param(k, new_v)
+
+    def get_run_info_path(self):
+        return os.path.join(self.param("run-info-path"), self.param("run-info-template"))
+
+    def tune_manager(self):
+        for k, v in self.params.vine_manager_tuning_params.items():
+            print(f"Tuning {k} to {v}")
+            self.tune(k, v)
+
+    def tune_sog(self, sog):
+        for k, v in self.params.sog_tuning_params.items():
+            print(f"Tuning {k} to {v}")
+            sog.tune(k, str(v))
+
+    def build_reg(self):
+        reg = RuntimeExecutionGraph(
+            self.task_dict,
+            shared_file_system_dir=self.param("shared-file-system-dir"),
+            extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
+            extra_task_sleep_time=self.param("extra-task-sleep-time")
+        )
+
+        return reg
+
+    def build_sog(self, reg, target_keys):
+        assert reg is not None, "Python graph must be built before building the C graph"
+
+        sog = StrategicOrchestrationGraph(self._taskvine)
+
+        sog.set_proxy_function(compute_single_key)
+
+        # C side vine task graph must be tuned before adding nodes and dependencies
+        self.tune_manager()
+        self.tune_sog(sog)
+
+        topo_order = reg.get_topological_order()
+        for k in topo_order:
+            sog.add_node(reg.reg_key_to_sog_key[k], int(k in target_keys))
+            for pk in reg.parents_of[k]:
+                sog.add_dependency(reg.reg_key_to_sog_key[pk], reg.reg_key_to_sog_key[k])
+
+        sog.compute_topology_metrics()
+
+        return sog
+
+    def build_graphs(self, target_keys):
+        # build Python DAG (logical topology)
+        reg = self.build_reg()
+        # build C DAG (physical topology)
+        sog = self.build_sog(reg, target_keys)
+
+        # set outfile remote names in reg from sog, note that these names are automatically generated
+        # with regard to the checkpointing strategy and the shared file system directory
+        for sog_key in reg.reg_key_to_sog_key.values():
+            outfile_remote_name = sog.get_node_outfile_remote_name(sog_key)
+            reg.set_outfile_remote_name_of(reg.sog_key_to_reg_key[sog_key], outfile_remote_name)
+
+        return reg, sog
+
+    def create_proxy_library(self, reg, sog, hoisting_modules, env_files):
+        proxy_library = ProxyLibrary(self)
+        proxy_library.add_hoisting_modules(hoisting_modules)
+        proxy_library.add_env_files(env_files)
+        proxy_library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
+        proxy_library.set_libcores(self.param("libcores"))
+        proxy_library.set_name(sog.get_proxy_library_name())
+
+        return proxy_library
+
+    def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}):
+        # first update the params so that they can be used for the following construction
+        self.update_params(params)
+
+        self.task_dict = ensure_task_dict(collection_dict)
+
+        # build graphs from both sides
+        reg, sog = self.build_graphs(target_keys)
+
+        # create and install the proxy library on the manager
+        proxy_library = self.create_proxy_library(reg, sog, hoisting_modules, env_files)
+        proxy_library.install()
+
+        # execute the graph on the C side
+        print(f"Executing task graph, logs will be written to {self.runtime_directory}")
+        sog.execute()
+
+        # clean up the library instances and template on the manager
+        proxy_library.uninstall()
+
+        # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
+        sog.delete()
+
+        # load results of target keys
+        results = {}
+        for k in target_keys:
+            outfile_path = os.path.join(self.param("target-results-dir"), reg.outfile_remote_name[k])
+            results[k] = GraphKeyResult.load_from_path(outfile_path)
+        return results
+
+    def _on_sigint(self, signum, frame):
+        self.__del__()

From ea9285f14ca3759d2ae89d83530f162b5047a8e0 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 16:52:07 -0400
Subject: [PATCH 050/113] checkpoint works

---
 taskvine/src/graph/dagvine/executor.py        |  18 +-
 .../graph/dagvine/runtime_execution_graph.py  |   5 -
 .../dagvine/strategic_orchestration_graph.c   | 258 +++++++++--
 .../dagvine/strategic_orchestration_graph.h   |  24 +-
 .../dagvine/strategic_orchestration_node.c    | 437 ++++++------------
 .../dagvine/strategic_orchestration_node.h    |  58 ++-
 6 files changed, 410 insertions(+), 390 deletions(-)

diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/executor.py
index 9879116663..ba80833339 100644
--- a/taskvine/src/graph/dagvine/executor.py
+++ b/taskvine/src/graph/dagvine/executor.py
@@ -84,22 +84,18 @@ def __init__(self):
         }
         self.sog_tuning_params = {
             "failure-injection-step-percent": -1,
-            "priority-mode": "largest-input-first",
+            "task-priority-mode": "largest-input-first",
             "prune-depth": 1,
-            "target-results-dir": "./target_results",
+            "output-dir": "./outputs",
+            "checkpoint-dir": "./checkpoints",
             "checkpoint-fraction": 0,
         }
         self.other_params = {
             "schedule": "worst",
             "libcores": 16,
             "failure-injection-step-percent": -1,
-            "shared-file-system-dir": "./shared_file_system",
             "extra-task-output-size-mb": ["uniform", 0, 0],
             "extra-task-sleep-time": ["uniform", 0, 0],
-            "outfile-type": {
-                "temp": 1.0,
-                "shared-file-system": 0.0,
-            },
         }
 
     def update_param(self, param_name, new_value):
@@ -159,7 +155,10 @@ def get_run_info_path(self):
     def tune_manager(self):
         for k, v in self.params.vine_manager_tuning_params.items():
             print(f"Tuning {k} to {v}")
-            self.tune(k, v)
+            try:
+                self.tune(k, v)
+            except:
+                raise ValueError(f"Unrecognized parameter: {k}")
 
     def tune_sog(self, sog):
         for k, v in self.params.sog_tuning_params.items():
@@ -169,7 +168,6 @@ def tune_sog(self, sog):
     def build_reg(self):
         reg = RuntimeExecutionGraph(
             self.task_dict,
-            shared_file_system_dir=self.param("shared-file-system-dir"),
             extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
             extra_task_sleep_time=self.param("extra-task-sleep-time")
         )
@@ -247,7 +245,7 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
         # load results of target keys
         results = {}
         for k in target_keys:
-            outfile_path = os.path.join(self.param("target-results-dir"), reg.outfile_remote_name[k])
+            outfile_path = os.path.join(self.param("output-dir"), reg.outfile_remote_name[k])
             results[k] = GraphKeyResult.load_from_path(outfile_path)
         return results
 
diff --git a/taskvine/src/graph/dagvine/runtime_execution_graph.py b/taskvine/src/graph/dagvine/runtime_execution_graph.py
index bc5b8049f4..50565ae9f0 100644
--- a/taskvine/src/graph/dagvine/runtime_execution_graph.py
+++ b/taskvine/src/graph/dagvine/runtime_execution_graph.py
@@ -106,14 +106,9 @@ class RuntimeExecutionGraph:
     to produce the result.
     """
     def __init__(self, task_dict,
-                 shared_file_system_dir=None,
                  extra_task_output_size_mb=["uniform", 0, 0],
                  extra_task_sleep_time=["uniform", 0, 0]):
         self.task_dict = task_dict
-        self.shared_file_system_dir = shared_file_system_dir
-
-        if self.shared_file_system_dir:
-            os.makedirs(self.shared_file_system_dir, exist_ok=True)
 
         if dts:
             for k, v in self.task_dict.items():
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
index 464cd2a969..c8db15ebde 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
@@ -30,6 +30,7 @@
 #include "vine_file.h"
 #include "vine_mount.h"
 #include "taskvine.h"
+#include "vine_temp.h"
 
 static volatile sig_atomic_t interrupted = 0;
 
@@ -366,6 +367,169 @@ static struct strategic_orchestration_node *get_node_by_task(struct strategic_or
 	return NULL;
 }
 
+/**
+ * Prune the ancestors of a persisted node. This is only used for persisted nodes that produce persisted files.
+ * All ancestors we consider here include both temp nodes and persisted nodes, becasue data written to shared file system
+ * is safe and can definitely trigger upstream data redundancy to be released.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node Reference to the node object.
+ * @return The number of pruned replicas.
+ */
+static int prune_ancestors_of_persisted_node(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+{
+	if (!sog || !node) {
+		return -1;
+	}
+
+	/* find all safe ancestors */
+	struct set *safe_ancestors = son_find_safe_ancestors(node);
+	if (!safe_ancestors) {
+		return 0;
+	}
+
+	int pruned_replica_count = 0;
+
+	timestamp_t start_time = timestamp_get();
+
+	/* prune all safe ancestors */
+	struct strategic_orchestration_node *ancestor_node;
+	SET_ITERATE(safe_ancestors, ancestor_node)
+	{
+		switch (ancestor_node->outfile_type) {
+		case NODE_OUTFILE_TYPE_LOCAL:
+			/* do not prune the local file */
+			break;
+		case NODE_OUTFILE_TYPE_TEMP:
+			/* prune the temp file */
+			vine_prune_file(sog->manager, ancestor_node->outfile);
+			break;
+		case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+			/* unlink directly from the shared file system */
+			unlink(ancestor_node->outfile_remote_name);
+			break;
+		}
+		ancestor_node->prune_status = PRUNE_STATUS_SAFE;
+		pruned_replica_count++;
+	}
+
+	set_delete(safe_ancestors);
+
+	node->time_spent_on_prune_ancestors_of_persisted_node += timestamp_get() - start_time;
+
+	return pruned_replica_count;
+}
+
+/**
+ * Prune the ancestors of a temp node.
+ * This function opportunistically releases upstream temporary files
+ * that are no longer needed once this temp-producing node has completed.
+ *
+ * Only ancestors producing temporary outputs are considered here.
+ * Files stored in the shared filesystem are never pruned by this function,
+ * because temp outputs are not considered sufficiently safe to trigger
+ * deletion of persisted data upstream.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param node Reference to the node object.
+ * @return The number of pruned replicas.
+ */
+static int prune_ancestors_of_temp_node(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+{
+	if (!sog || !node || !node->outfile || node->prune_depth <= 0) {
+		return 0;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	struct list *parents = son_find_parents_by_depth(node, node->prune_depth);
+
+	struct strategic_orchestration_node *parent_node;
+	LIST_ITERATE(parents, parent_node)
+	{
+		/* skip if the parent does not produce a temp file */
+		if (parent_node->outfile_type != NODE_OUTFILE_TYPE_TEMP) {
+			continue;
+		}
+
+		/* a file is prunable if its outfile is no longer needed by any child node:
+		 * 1. it has no pending dependents
+		 * 2. all completed dependents have also completed their corresponding recovery tasks, if any */
+		int all_children_completed = 1;
+		struct strategic_orchestration_node *child_node;
+		LIST_ITERATE(parent_node->children, child_node)
+		{
+			/* break early if the child node is not completed */
+			if (!child_node->completed) {
+				all_children_completed = 0;
+				break;
+			}
+			/* if the task produces a temp file and the recovery task is running, the parent is not prunable */
+			if (child_node->outfile && child_node->outfile->type == VINE_TEMP) {
+				struct vine_task *child_node_recovery_task = child_node->outfile->recovery_task;
+				if (child_node_recovery_task && (child_node_recovery_task->state != VINE_TASK_INITIAL && child_node_recovery_task->state != VINE_TASK_DONE)) {
+					all_children_completed = 0;
+					break;
+				}
+			}
+		}
+		if (!all_children_completed) {
+			continue;
+		}
+
+		pruned_replica_count += vine_prune_file(sog->manager, parent_node->outfile);
+		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
+		 * manager may submit a recovery task to bring it back in case of worker failures. */
+		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
+	}
+
+	list_delete(parents);
+
+	node->time_spent_on_prune_ancestors_of_temp_node += timestamp_get() - start_time;
+
+	return pruned_replica_count;
+}
+
+/**
+ * Prune the ancestors of a node when it is completed.
+ * @param node Reference to the node object.
+ */
+static void prune_ancestors_of_node(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+{
+	if (!sog || !node) {
+		return;
+	}
+
+	/* do not prune if the node is not completed */
+	if (!node->completed) {
+		return;
+	}
+
+	timestamp_t start_time = timestamp_get();
+
+	int pruned_replica_count = 0;
+
+	switch (node->outfile_type) {
+	case NODE_OUTFILE_TYPE_LOCAL:
+	case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+		/* If the outfile was declared as a VINE_FILE or was written to the shared fs, then it is guaranteed to be persisted
+		 * and there is no chance that it will be lost unexpectedly. So we can safely prune all ancestors of this node. */
+		pruned_replica_count = prune_ancestors_of_persisted_node(sog, node);
+		break;
+	case NODE_OUTFILE_TYPE_TEMP:
+		/* Otherwise, if the node outfile is a temp file, we need to be careful about pruning, because temp files are prone
+		 * to failures, while means they can be lost due to node evictions or failures. */
+		pruned_replica_count = prune_ancestors_of_temp_node(sog, node);
+		break;
+	}
+
+	timestamp_t elapsed_time = timestamp_get() - start_time;
+
+	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
+
+	return;
+}
+
 /*************************************************************/
 /* Public APIs */
 /*************************************************************/
@@ -405,15 +569,15 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 			return -1;
 		}
 
-	} else if (strcmp(name, "target-results-dir") == 0) {
-		if (sog->target_results_dir) {
-			free(sog->target_results_dir);
+	} else if (strcmp(name, "output-dir") == 0) {
+		if (sog->output_dir) {
+			free(sog->output_dir);
 		}
 		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
 			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
 			return -1;
 		}
-		sog->target_results_dir = xxstrdup(value);
+		sog->output_dir = xxstrdup(value);
 
 	} else if (strcmp(name, "prune-depth") == 0) {
 		sog->prune_depth = atoi(value);
@@ -426,6 +590,16 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		}
 		sog->checkpoint_fraction = fraction;
 
+	} else if (strcmp(name, "checkpoint-dir") == 0) {
+		if (sog->checkpoint_dir) {
+			free(sog->checkpoint_dir);
+		}
+		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
+			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
+			return -1;
+		}
+		sog->checkpoint_dir = xxstrdup(value);
+
 	} else {
 		debug(D_ERROR, "invalid parameter name: %s", name);
 		return -1;
@@ -525,7 +699,7 @@ const char *sog_get_node_local_outfile_source(const struct strategic_orchestrati
 		exit(1);
 	}
 
-	if (node->outfile_type != VINE_NODE_OUTFILE_TYPE_LOCAL) {
+	if (node->outfile_type != NODE_OUTFILE_TYPE_LOCAL) {
 		debug(D_ERROR, "node %s is not a local output file", node_key);
 		exit(1);
 	}
@@ -649,23 +823,23 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 	while ((node = priority_queue_pop(sorted_nodes))) {
 		if (node->is_target_key) {
 			/* declare the output file as a vine_file so that it can be retrieved by the manager as usual */
-			node->outfile_type = VINE_NODE_OUTFILE_TYPE_LOCAL;
-			char *local_outfile_path = string_format("%s/%s", sog->target_results_dir, node->outfile_remote_name);
-			node->outfile = vine_declare_file(node->manager, local_outfile_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
+			node->outfile_type = NODE_OUTFILE_TYPE_LOCAL;
+			char *local_outfile_path = string_format("%s/%s", sog->output_dir, node->outfile_remote_name);
+			node->outfile = vine_declare_file(sog->manager, local_outfile_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
 			free(local_outfile_path);
 			continue;
 		}
 		if (assigned_checkpoint_count < checkpoint_count) {
 			/* checkpointed files will be written directly to the shared file system, no need to manage them in the manager */
-			node->outfile_type = VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM;
-			char *shared_file_system_outfile_path = string_format("%s/%s", sog->target_results_dir, node->outfile_remote_name);
+			node->outfile_type = NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM;
+			char *shared_file_system_outfile_path = string_format("%s/%s", sog->checkpoint_dir, node->outfile_remote_name);
 			free(node->outfile_remote_name);
 			node->outfile_remote_name = shared_file_system_outfile_path;
 			node->outfile = NULL;
 			assigned_checkpoint_count++;
 		} else {
 			/* other nodes will be declared as temp files to leverage node-local storage */
-			node->outfile_type = VINE_NODE_OUTFILE_TYPE_TEMP;
+			node->outfile_type = NODE_OUTFILE_TYPE_TEMP;
 			node->outfile = vine_declare_temp(sog->manager);
 		}
 	}
@@ -712,13 +886,7 @@ void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_ke
 	/* if the node already exists, skip creating a new one */
 	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
 	if (!node) {
-		node = son_create(sog->manager,
-				node_key,
-				is_target_key,
-				sog->proxy_library_name,
-				sog->proxy_function_name,
-				sog->target_results_dir,
-				sog->prune_depth);
+		node = son_create(node_key, is_target_key);
 
 		if (!node) {
 			debug(D_ERROR, "failed to create node %s", node_key);
@@ -726,6 +894,32 @@ void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_ke
 			exit(1);
 		}
 
+		if (!sog->proxy_function_name) {
+			debug(D_ERROR, "proxy function name is not set");
+			sog_delete(sog);
+			exit(1);
+		}
+
+		if (!sog->proxy_library_name) {
+			debug(D_ERROR, "proxy library name is not set");
+			sog_delete(sog);
+			exit(1);
+		}
+
+		/* create node task */
+		node->task = vine_task_create(sog->proxy_function_name);
+		vine_task_set_library_required(node->task, sog->proxy_library_name);
+		vine_task_addref(node->task);
+
+		/* construct the task arguments and declare the infile */
+		char *task_arguments = son_construct_task_arguments(node);
+		node->infile = vine_declare_buffer(sog->manager, task_arguments, strlen(task_arguments), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
+		free(task_arguments);
+		vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
+
+		/* initialize the pruning depth of each node, currently statically set to the global prune depth */
+		node->prune_depth = sog->prune_depth;
+
 		hash_table_insert(sog->nodes, node_key, node);
 	}
 }
@@ -745,12 +939,13 @@ struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
 
 	sog->manager = q;
 
+	sog->checkpoint_dir = xxstrdup(sog->manager->runtime_directory); // default to current working directory
+	sog->output_dir = xxstrdup(sog->manager->runtime_directory);	 // default to current working directory
+
 	sog->nodes = hash_table_create(0, 0);
 	sog->task_id_to_node = itable_create(0);
 	sog->outfile_cachename_to_node = hash_table_create(0, 0);
 
-	sog->target_results_dir = xxstrdup(sog->manager->runtime_directory); // default to current working directory
-
 	cctools_uuid_t proxy_library_name_id;
 	cctools_uuid_create(&proxy_library_name_id);
 	sog->proxy_library_name = xxstrdup(proxy_library_name_id.str);
@@ -827,7 +1022,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	struct strategic_orchestration_node *node;
 	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 	{
-		son_print_info(node);
+		son_debug_print(node);
 	}
 
 	/* enable return recovery tasks */
@@ -923,7 +1118,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
 			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
+			case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
 				struct stat info;
 				int result = stat(node->outfile_remote_name, &info);
 				if (result < 0) {
@@ -941,8 +1136,8 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 				node->outfile_size_bytes = info.st_size;
 				break;
 			}
-			case VINE_NODE_OUTFILE_TYPE_LOCAL:
-			case VINE_NODE_OUTFILE_TYPE_TEMP:
+			case NODE_OUTFILE_TYPE_LOCAL:
+			case NODE_OUTFILE_TYPE_TEMP:
 				node->outfile_size_bytes = node->outfile->size;
 				break;
 			}
@@ -952,7 +1147,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			node->completed = 1;
 
 			/* prune nodes on task completion */
-			son_prune_ancestors(node);
+			prune_ancestors_of_node(sog, node);
 
 			/* skip recovery tasks */
 			if (task->type == VINE_TASK_TYPE_RECOVERY) {
@@ -966,7 +1161,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			}
 
 			/* update critical time */
-			son_update_critical_time(node, task->time_workers_execute_last);
+			son_update_critical_path_time(node, task->time_workers_execute_last);
 
 			/* mark this regular task as completed */
 			progress_bar_update_part(pbar, regular_tasks_part, 1);
@@ -982,11 +1177,12 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 			/* enqueue the output file for replication */
 			switch (node->outfile_type) {
-			case VINE_NODE_OUTFILE_TYPE_TEMP:
-				son_replicate_outfile(node);
+			case NODE_OUTFILE_TYPE_TEMP:
+				/* replicate the outfile of the temp node */
+				vine_temp_replicate_file_later(sog->manager, node->outfile);
 				break;
-			case VINE_NODE_OUTFILE_TYPE_LOCAL:
-			case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+			case NODE_OUTFILE_TYPE_LOCAL:
+			case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
 				break;
 			}
 
@@ -1044,7 +1240,7 @@ void sog_delete(struct strategic_orchestration_graph *sog)
 			hash_table_remove(sog->outfile_cachename_to_node, node->outfile->cached_name);
 			hash_table_remove(sog->manager->file_table, node->outfile->cached_name);
 		}
-		if (node->outfile_type == VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM) {
+		if (node->outfile_type == NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM) {
 			unlink(node->outfile_remote_name);
 		}
 		son_delete(node);
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
index affadd39b1..f440ba0872 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
@@ -27,20 +27,32 @@ struct strategic_orchestration_graph {
 	struct itable *task_id_to_node;
 	struct hash_table *outfile_cachename_to_node;
 
+	/* The directory to store the checkpointed results.
+	 * Only intermediate results can be checkpointed, the fraction of intermediate results to checkpoint is controlled by the checkpoint-fraction parameter. */
+	char *checkpoint_dir;
+
 	/* Results of target keys will be stored in this directory.
 	 * This dir path can not necessarily be a shared file system directory,
 	 * output files will be retrieved through the network instead,
 	 * as long as the manager can access it. */
-	char *target_results_dir;
+	char *output_dir;
+
+	/* Python-side proxy library name, while is responsible for managing the runtime execution graph (reg),
+	 * receiving function calls emitted by the strategic orchestration graph (sog), and executing them via
+	 * the proxy function. The proxy library name is generated by the sog, and then synchronized to reg. */
+	char *proxy_library_name;
 
-	char *proxy_library_name;  // Python-side proxy library name (shared by all tasks)
-	char *proxy_function_name; // Python-side proxy function name (shared by all tasks)
+	/* The proxy function is hoisted in the proxy library, it receives a key (in string format) in the rog,
+	 * converts it to the reg-based key, looks up the function definition and arguments from reg,
+	 * and then executes the function. This name is generated by reg and synchronized to sog. */
+	char *proxy_function_name;
 
+	/* The depth of the pruning strategy. 0 means no pruning, 1 means the most aggressive pruning. */
 	int prune_depth;
-	double checkpoint_fraction; // 0 - 1, the fraction of intermediate results to checkpoint
+	double checkpoint_fraction; /* 0 - 1, the fraction of intermediate results to checkpoint */
 
-	task_priority_mode_t task_priority_mode; // priority mode for task graph task scheduling
-	double failure_injection_step_percent;	 // 0 - 100, the percentage of steps to inject failure
+	task_priority_mode_t task_priority_mode; /* priority mode for task graph task scheduling */
+	double failure_injection_step_percent;	 /* 0 - 100, the percentage of steps to inject failure */
 };
 
 /* Public APIs for operating the strategic orchestration graph */
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.c b/taskvine/src/graph/dagvine/strategic_orchestration_node.c
index ee757a4e8c..9f2442213d 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_node.c
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_node.c
@@ -17,7 +17,6 @@
 #include "random.h"
 #include "uuid.h"
 
-#include "vine_manager.h"
 #include "vine_file.h"
 #include "vine_task.h"
 #include "vine_worker_info.h"
@@ -25,107 +24,9 @@
 #include "strategic_orchestration_node.h"
 #include "taskvine.h"
 
-/**
- * Create a new node object.
- * @param manager Reference to the manager object.
- * @param node_key Reference to the node key.
- * @param is_target_key Reference to whether the node is a target key.
- * @param proxy_library_name Reference to the proxy library name.
- * @param proxy_function_name Reference to the proxy function name.
- * @param staging_dir Reference to the staging directory.
- * @param prune_depth Reference to the prune depth.
- * @return A new node object.
- */
-struct strategic_orchestration_node *son_create(
-		struct vine_manager *manager,
-		const char *node_key,
-		int is_target_key,
-		const char *proxy_library_name,
-		const char *proxy_function_name,
-		const char *target_results_dir,
-		int prune_depth)
-{
-	if (!manager) {
-		debug(D_ERROR, "Cannot create node because manager is NULL");
-		return NULL;
-	}
-	if (!node_key) {
-		debug(D_ERROR, "Cannot create node because node_key is NULL");
-		return NULL;
-	}
-	if (!proxy_library_name) {
-		debug(D_ERROR, "Cannot create node because proxy_library_name is NULL");
-		return NULL;
-	}
-	if (!proxy_function_name) {
-		debug(D_ERROR, "Cannot create node because proxy_function_name is NULL");
-		return NULL;
-	}
-	if (!target_results_dir) {
-		debug(D_ERROR, "Cannot create node because target_results_dir is NULL");
-		return NULL;
-	}
-	if (is_target_key != 0 && is_target_key != 1) {
-		debug(D_ERROR, "Cannot create node because is_target_key is not 0 or 1");
-		return NULL;
-	}
-
-	struct strategic_orchestration_node *node = xxmalloc(sizeof(struct strategic_orchestration_node));
-
-	node->manager = manager;
-	node->is_target_key = is_target_key;
-	node->node_key = xxstrdup(node_key);
-	node->target_results_dir = xxstrdup(target_results_dir);
-
-	/* create a unique outfile remote name for the node */
-	cctools_uuid_t id;
-	cctools_uuid_create(&id);
-	node->outfile_remote_name = xxstrdup(id.str);
-
-	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
-	node->parents = list_create();
-	node->children = list_create();
-	node->pending_parents = set_create(0);
-	node->completed = 0;
-	node->prune_depth = prune_depth;
-	node->retry_attempts_left = 1;
-	node->outfile_size_bytes = 0;
-
-	node->depth = -1;
-	node->height = -1;
-	node->upstream_subgraph_size = -1;
-	node->downstream_subgraph_size = -1;
-	node->fan_in = -1;
-	node->fan_out = -1;
-	node->heavy_score = -1;
-
-	node->time_spent_on_unlink_local_files = 0;
-	node->time_spent_on_prune_ancestors_of_temp_node = 0;
-	node->time_spent_on_prune_ancestors_of_persisted_node = 0;
-
-	node->critical_time = -1;
-
-	/* create the task */
-	node->task = vine_task_create(proxy_function_name);
-	vine_task_set_library_required(node->task, proxy_library_name);
-	vine_task_addref(node->task);
-
-	/* build JSON infile expected by library: {"fn_args": [key], "fn_kwargs": {}} */
-	struct jx *event = jx_object(NULL);
-	struct jx *args = jx_array(NULL);
-	jx_array_append(args, jx_string(node->node_key));
-	jx_insert(event, jx_string("fn_args"), args);
-	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
-
-	char *infile_content = jx_print_string(event);
-	jx_delete(event);
-
-	node->infile = vine_declare_buffer(node->manager, infile_content, strlen(infile_content), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
-	free(infile_content);
-	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
-
-	return node;
-}
+/*************************************************************/
+/* Private Functions */
+/*************************************************************/
 
 /**
  * Check if the outfile of a node is persisted.
@@ -134,7 +35,7 @@ struct strategic_orchestration_node *son_create(
  * @param node Reference to the node object.
  * @return 1 if the outfile is persisted, 0 otherwise.
  */
-static int _node_outfile_is_persisted(struct strategic_orchestration_node *node)
+static int node_outfile_has_been_persisted(struct strategic_orchestration_node *node)
 {
 	if (!node) {
 		return 0;
@@ -146,11 +47,11 @@ static int _node_outfile_is_persisted(struct strategic_orchestration_node *node)
 	}
 
 	switch (node->outfile_type) {
-	case VINE_NODE_OUTFILE_TYPE_LOCAL:
+	case NODE_OUTFILE_TYPE_LOCAL:
 		return 1;
-	case VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
+	case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
 		return 1;
-	case VINE_NODE_OUTFILE_TYPE_TEMP:
+	case NODE_OUTFILE_TYPE_TEMP:
 		return 0;
 	}
 
@@ -158,21 +59,21 @@ static int _node_outfile_is_persisted(struct strategic_orchestration_node *node)
 }
 
 /**
- * Update the critical time of a node.
+ * Update the critical path time of a node.
  * @param node Reference to the node object.
  * @param execution_time Reference to the execution time of the node.
  */
-void son_update_critical_time(struct strategic_orchestration_node *node, timestamp_t execution_time)
+void son_update_critical_path_time(struct strategic_orchestration_node *node, timestamp_t execution_time)
 {
-	timestamp_t max_parent_critical_time = 0;
+	timestamp_t max_parent_critical_path_time = 0;
 	struct strategic_orchestration_node *parent_node;
 	LIST_ITERATE(node->parents, parent_node)
 	{
-		if (parent_node->critical_time > max_parent_critical_time) {
-			max_parent_critical_time = parent_node->critical_time;
+		if (parent_node->critical_path_time > max_parent_critical_path_time) {
+			max_parent_critical_path_time = parent_node->critical_path_time;
 		}
 	}
-	node->critical_time = max_parent_critical_time + execution_time;
+	node->critical_path_time = max_parent_critical_path_time + execution_time;
 }
 
 /**
@@ -182,7 +83,7 @@ void son_update_critical_time(struct strategic_orchestration_node *node, timesta
  * @param result Reference to the result list.
  * @param visited Reference to the visited set.
  */
-static void _find_parents_dfs(struct strategic_orchestration_node *node, int remaining_depth, struct list *result, struct set *visited)
+static void find_parents_dfs(struct strategic_orchestration_node *node, int remaining_depth, struct list *result, struct set *visited)
 {
 	if (!node || set_lookup(visited, node)) {
 		return;
@@ -196,133 +97,163 @@ static void _find_parents_dfs(struct strategic_orchestration_node *node, int rem
 	struct strategic_orchestration_node *parent_node;
 	LIST_ITERATE(node->parents, parent_node)
 	{
-		_find_parents_dfs(parent_node, remaining_depth - 1, result, visited);
+		find_parents_dfs(parent_node, remaining_depth - 1, result, visited);
 	}
 }
 
+/*************************************************************/
+/* Public APIs */
+/*************************************************************/
+
 /**
- * Find all parents in a specific depth of the node.
- * @param node Reference to the node object.
- * @param depth Reference to the depth.
- * @return The list of parents.
+ * Create a new node object.
+ * @param node_key Reference to the node key.
+ * @param is_target_key Reference to whether the node is a target key.
+ * @return A new node object.
  */
-static struct list *_find_parents_in_depth(struct strategic_orchestration_node *node, int depth)
+struct strategic_orchestration_node *son_create(const char *node_key, int is_target_key)
 {
-	if (!node || depth < 0) {
+	if (!node_key) {
+		debug(D_ERROR, "Cannot create node because node_key is NULL");
+		return NULL;
+	}
+	if (is_target_key != 0 && is_target_key != 1) {
+		debug(D_ERROR, "Cannot create node because is_target_key is not 0 or 1");
 		return NULL;
 	}
 
-	struct list *result = list_create();
+	struct strategic_orchestration_node *node = xxmalloc(sizeof(struct strategic_orchestration_node));
 
-	struct set *visited = set_create(0);
-	_find_parents_dfs(node, depth, result, visited);
-	set_delete(visited);
+	node->is_target_key = is_target_key;
+	node->node_key = xxstrdup(node_key);
 
-	return result;
+	/* create a unique outfile remote name for the node */
+	cctools_uuid_t id;
+	cctools_uuid_create(&id);
+	node->outfile_remote_name = xxstrdup(id.str);
+
+	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
+	node->parents = list_create();
+	node->children = list_create();
+	node->pending_parents = set_create(0);
+	node->completed = 0;
+	node->prune_depth = 0;
+	node->retry_attempts_left = 1;
+	node->outfile_size_bytes = 0;
+
+	node->depth = -1;
+	node->height = -1;
+	node->upstream_subgraph_size = -1;
+	node->downstream_subgraph_size = -1;
+	node->fan_in = -1;
+	node->fan_out = -1;
+	node->heavy_score = -1;
+
+	node->time_spent_on_unlink_local_files = 0;
+	node->time_spent_on_prune_ancestors_of_temp_node = 0;
+	node->time_spent_on_prune_ancestors_of_persisted_node = 0;
+
+	node->critical_path_time = -1;
+
+	return node;
 }
 
 /**
- * Prune the ancestors of a temp node. This is only used for temp nodes that produce temp files.
- * All ancestors of this node we consider here are temp nodes, we can not safely prune those stored in the shared file system
- * because temp nodes are not considered safe enough to trigger the deletion of upstream persisted files.
+ * Construct the task arguments for the node.
  * @param node Reference to the node object.
- * @return The number of pruned replicas.
+ * @return The task arguments in JSON format: {"fn_args": [key], "fn_kwargs": {}}.
  */
-static int prune_ancestors_of_temp_node(struct strategic_orchestration_node *node)
+char *son_construct_task_arguments(struct strategic_orchestration_node *node)
 {
-	if (!node || !node->outfile || node->prune_depth <= 0) {
-		return 0;
+	if (!node) {
+		return NULL;
 	}
 
-	timestamp_t start_time = timestamp_get();
-
-	int pruned_replica_count = 0;
-
-	struct list *parents = _find_parents_in_depth(node, node->prune_depth);
+	struct jx *event = jx_object(NULL);
+	struct jx *args = jx_array(NULL);
+	jx_array_append(args, jx_string(node->node_key));
+	jx_insert(event, jx_string("fn_args"), args);
+	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
 
-	struct strategic_orchestration_node *parent_node;
-	LIST_ITERATE(parents, parent_node)
-	{
-		/* skip if the parent produces a shared file system file */
-		if (!parent_node->outfile) {
-			continue;
-		}
-		/* skip if the parent produces a non-temp file */
-		if (parent_node->outfile->type != VINE_TEMP) {
-			continue;
-		}
+	char *infile_content = jx_print_string(event);
+	jx_delete(event);
 
-		/* a file is prunable if its outfile is no longer needed by any child node:
-		 * 1. it has no pending dependents
-		 * 2. all completed dependents have also completed their corresponding recovery tasks, if any */
-		int all_children_completed = 1;
-		struct strategic_orchestration_node *child_node;
-		LIST_ITERATE(parent_node->children, child_node)
-		{
-			/* break early if the child node is not completed */
-			if (!child_node->completed) {
-				all_children_completed = 0;
-				break;
-			}
-			/* if the task produces a temp file and the recovery task is running, the parent is not prunable */
-			if (child_node->outfile && child_node->outfile->type == VINE_TEMP) {
-				struct vine_task *child_node_recovery_task = child_node->outfile->recovery_task;
-				if (child_node_recovery_task && (child_node_recovery_task->state != VINE_TASK_INITIAL && child_node_recovery_task->state != VINE_TASK_DONE)) {
-					all_children_completed = 0;
-					break;
-				}
-			}
-		}
-		if (!all_children_completed) {
-			continue;
-		}
+	return infile_content;
+}
 
-		pruned_replica_count += vine_prune_file(node->manager, parent_node->outfile);
-		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
-		 * manager may submit a recovery task to bring it back in case of worker failures. */
-		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
+/**
+ * Find all parents in a specific depth of the node.
+ * @param node Reference to the node object.
+ * @param depth Reference to the depth.
+ * @return The list of parents.
+ */
+struct list *son_find_parents_by_depth(struct strategic_orchestration_node *node, int depth)
+{
+	if (!node || depth < 0) {
+		return NULL;
 	}
 
-	list_delete(parents);
+	struct list *result = list_create();
 
-	node->time_spent_on_prune_ancestors_of_temp_node += timestamp_get() - start_time;
+	struct set *visited = set_create(0);
+	find_parents_dfs(node, depth, result, visited);
+	set_delete(visited);
 
-	return pruned_replica_count;
+	return result;
 }
 
 /**
- * Find all safe ancestors of a node.
- * @param start_node Reference to the start node.
- * @return The set of safe ancestors.
+ * Perform a reverse BFS traversal to identify all ancestors of a given node
+ * whose outputs can be safely pruned.
+ *
+ * A parent node is considered "safe" if:
+ *   1. All of its child nodes are either:
+ *        - already persisted (their outputs are stored in a reliable location), or
+ *        - already marked as safely pruned.
+ *   2. None of its child nodes remain in an unsafe or incomplete state.
+ *
+ * This function starts from the given node and iteratively walks up the DAG,
+ * collecting all such "safe" ancestors into a set. Nodes that have already
+ * been marked as PRUNE_STATUS_SAFE are skipped early.
+ *
+ * The returned set contains all ancestors that can be safely pruned once the
+ * current node’s output has been persisted.
+ *
+ * @param start_node  The node from which to begin the reverse search.
+ * @return A set of ancestor nodes that are safe to prune (excluding start_node).
  */
-static struct set *_find_safe_ancestors(struct strategic_orchestration_node *start_node)
+struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_node)
 {
 	if (!start_node) {
 		return NULL;
 	}
 
 	struct set *visited_nodes = set_create(0);
-	struct list *bfs_nodes = list_create();
+	struct set *safe_ancestors = set_create(0);
 
-	list_push_tail(bfs_nodes, start_node);
-	set_insert(visited_nodes, start_node);
+	struct list *queue = list_create();
 
-	while (list_size(bfs_nodes) > 0) {
-		struct strategic_orchestration_node *current = list_pop_head(bfs_nodes);
+	list_push_tail(queue, start_node);
+	set_insert(visited_nodes, start_node);
 
+	while (list_size(queue) > 0) {
+		struct strategic_orchestration_node *current_node = list_pop_head(queue);
 		struct strategic_orchestration_node *parent_node;
-		LIST_ITERATE(current->parents, parent_node)
+
+		LIST_ITERATE(current_node->parents, parent_node)
 		{
 			if (set_lookup(visited_nodes, parent_node)) {
 				continue;
 			}
 
-			/* shortcut if this parent was already safely pruned */
+			set_insert(visited_nodes, parent_node);
+
+			/* shortcut if this parent has already been marked as safely pruned */
 			if (parent_node->prune_status == PRUNE_STATUS_SAFE) {
 				continue;
 			}
 
-			/* check if all children are safe */
+			/* check if all children of this parent are safe */
 			int all_children_safe = 1;
 			struct strategic_orchestration_node *child_node;
 			LIST_ITERATE(parent_node->children, child_node)
@@ -332,7 +263,7 @@ static struct set *_find_safe_ancestors(struct strategic_orchestration_node *sta
 					continue;
 				}
 				/* shortcut if this outside child is not persisted */
-				if (!_node_outfile_is_persisted(child_node)) {
+				if (!node_outfile_has_been_persisted(child_node)) {
 					all_children_safe = 0;
 					break;
 				}
@@ -343,86 +274,24 @@ static struct set *_find_safe_ancestors(struct strategic_orchestration_node *sta
 				}
 			}
 
-			if (!all_children_safe) {
-				continue;
-			}
-
-			set_insert(visited_nodes, parent_node);
-			list_push_tail(bfs_nodes, parent_node);
-		}
-	}
-
-	list_delete(bfs_nodes);
-	set_remove(visited_nodes, start_node);
-
-	return visited_nodes;
-}
-
-/**
- * Prune the ancestors of a persisted node. This is only used for persisted nodes that produce persisted files.
- * All ancestors we consider here include both temp nodes and persisted nodes, becasue data written to shared file system
- * is safe and can definitely trigger upstream data redundancy to be released.
- * @param node Reference to the node object.
- * @return The number of pruned replicas.
- */
-static int prune_ancestors_of_persisted_node(struct strategic_orchestration_node *node)
-{
-	if (!node) {
-		return 0;
-	}
-
-	timestamp_t start_time = timestamp_get();
-
-	int pruned_replica_count = 0;
-
-	/* find all safe ancestors */
-	struct set *safe_ancestors = _find_safe_ancestors(node);
-	if (!safe_ancestors) {
-		return 0;
-	}
-
-	/* prune all safe ancestors */
-	struct strategic_orchestration_node *ancestor_node;
-	SET_ITERATE(safe_ancestors, ancestor_node)
-	{
-		/* unlink the shared file system file */
-		if (!ancestor_node->outfile) {
-			timestamp_t unlink_start = timestamp_get();
-			if (ancestor_node->outfile_remote_name) {
-				unlink(ancestor_node->outfile_remote_name); // system call
-			}
-			node->time_spent_on_unlink_local_files += timestamp_get() - unlink_start;
-			debug(D_VINE, "unlinked %s size: %zu bytes, time: %" PRIu64, ancestor_node->outfile_remote_name ? ancestor_node->outfile_remote_name : "(null)", ancestor_node->outfile_size_bytes, (uint64_t)node->time_spent_on_unlink_local_files);
-		} else {
-			switch (ancestor_node->outfile->type) {
-			case VINE_FILE:
-				/* do not prune the staging dir file */
-				break;
-			case VINE_TEMP:
-				/* prune the temp file */
-				vine_prune_file(node->manager, ancestor_node->outfile);
-				break;
-			default:
-				debug(D_ERROR, "unsupported outfile type: %d", ancestor_node->outfile->type);
-				break;
+			if (all_children_safe) {
+				set_insert(safe_ancestors, parent_node);
+				list_push_tail(queue, parent_node);
 			}
 		}
-		ancestor_node->prune_status = PRUNE_STATUS_SAFE;
-		pruned_replica_count++;
 	}
 
-	set_delete(safe_ancestors);
+	list_delete(queue);
+	set_delete(visited_nodes);
 
-	node->time_spent_on_prune_ancestors_of_persisted_node += timestamp_get() - start_time;
-
-	return pruned_replica_count;
+	return safe_ancestors;
 }
 
 /**
  * Print the info of the node.
  * @param node Reference to the node object.
  */
-void son_print_info(struct strategic_orchestration_node *node)
+void son_debug_print(struct strategic_orchestration_node *node)
 {
 	if (!node) {
 		return;
@@ -436,7 +305,6 @@ void son_print_info(struct strategic_orchestration_node *node)
 	debug(D_VINE, "---------------- Node Info ----------------");
 	debug(D_VINE, "key: %s", node->node_key);
 	debug(D_VINE, "task_id: %d", node->task->task_id);
-	debug(D_VINE, "target_results_dir: %s", node->target_results_dir ? node->target_results_dir : "(null)");
 	debug(D_VINE, "depth: %d", node->depth);
 	debug(D_VINE, "height: %d", node->height);
 	debug(D_VINE, "prune_depth: %d", node->prune_depth);
@@ -506,48 +374,6 @@ void son_print_info(struct strategic_orchestration_node *node)
 	debug(D_VINE, "-------------------------------------------");
 }
 
-/**
- * Prune the ancestors of a node when it is completed.
- * @param node Reference to the node object.
- */
-void son_prune_ancestors(struct strategic_orchestration_node *node)
-{
-	if (!node) {
-		return;
-	}
-
-	timestamp_t start_time = timestamp_get();
-
-	int pruned_replica_count = 0;
-
-	if (_node_outfile_is_persisted(node)) {
-		pruned_replica_count = prune_ancestors_of_persisted_node(node);
-	} else {
-		pruned_replica_count = prune_ancestors_of_temp_node(node);
-	}
-
-	timestamp_t elapsed_time = timestamp_get() - start_time;
-
-	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
-}
-
-/**
- * Replicate the outfile of a node if it is a temp file.
- * @param node Reference to the node object.
- */
-void son_replicate_outfile(struct strategic_orchestration_node *node)
-{
-	if (!node || !node->outfile) {
-		return;
-	}
-
-	if (node->outfile->type != VINE_TEMP) {
-		return;
-	}
-
-	vine_temp_replicate_file_later(node->manager, node->outfile);
-}
-
 /**
  * Delete the node and all of its associated resources.
  * @param node Reference to the node object.
@@ -564,9 +390,6 @@ void son_delete(struct strategic_orchestration_node *node)
 	if (node->outfile_remote_name) {
 		free(node->outfile_remote_name);
 	}
-	if (node->target_results_dir) {
-		free(node->target_results_dir);
-	}
 
 	vine_task_delete(node->task);
 	node->task = NULL;
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.h b/taskvine/src/graph/dagvine/strategic_orchestration_node.h
index 71390e02ca..a2f421dd06 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_node.h
+++ b/taskvine/src/graph/dagvine/strategic_orchestration_node.h
@@ -4,23 +4,24 @@
 #include "vine_task.h"
 #include "hash_table.h"
 #include "list.h"
-#include "vine_manager.h"
 #include "set.h"
 #include "taskvine.h"
 
 /** Select the type of the node-output file. */
 typedef enum {
-	VINE_NODE_OUTFILE_TYPE_LOCAL = 0,	   /* Node-output file will be stored locally on the manager's staging directory */
-	VINE_NODE_OUTFILE_TYPE_TEMP,		   /* Node-output file will be stored in the temporary node-local storage */
-	VINE_NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
+	NODE_OUTFILE_TYPE_LOCAL = 0,	      /* Node-output file will be stored locally on the local staging directory */
+	NODE_OUTFILE_TYPE_TEMP,		      /* Node-output file will be stored in the temporary node-local storage */
+	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
 } node_outfile_type_t;
 
+/** The status of an output file of a node. */
 typedef enum {
 	PRUNE_STATUS_NOT_PRUNED = 0,
 	PRUNE_STATUS_SAFE,
 	PRUNE_STATUS_UNSAFE
 } prune_status_t;
 
+/** The strategic orchestration node object. */
 struct strategic_orchestration_node {
 	char *node_key;
 
@@ -28,12 +29,10 @@ struct strategic_orchestration_node {
 	 * If true, the output of the node will be declared as a vine_file and retrieved through the network. */
 	int is_target_key;
 
-	struct vine_manager *manager;
 	struct vine_task *task;
 	struct vine_file *infile;
 	struct vine_file *outfile;
 	char *outfile_remote_name;
-	char *target_results_dir;
 	size_t outfile_size_bytes;
 
 	struct list *parents;
@@ -52,7 +51,7 @@ struct strategic_orchestration_node {
 	int fan_out;
 	double heavy_score;
 
-	timestamp_t critical_time;
+	timestamp_t critical_path_time;
 	timestamp_t time_spent_on_unlink_local_files;
 	timestamp_t time_spent_on_prune_ancestors_of_temp_node;
 	timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
@@ -62,48 +61,45 @@ struct strategic_orchestration_node {
 };
 
 /** Create a new strategic orchestration node object.
-@param manager Reference to the manager object.
 @param node_key Reference to the node key.
 @param is_target_key Reference to whether the node is a target key.
-@param proxy_library_name Reference to the proxy library name.
-@param proxy_function_name Reference to the proxy function name.
-@param target_results_dir Reference to the target results directory.
-@param prune_depth Reference to the prune depth.
 @return A new strategic orchestration node object.
 */
-struct strategic_orchestration_node *son_create(
-		struct vine_manager *manager,
-		const char *node_key,
-		int is_target_key,
-		const char *proxy_library_name,
-		const char *proxy_function_name,
-		const char *target_results_dir,
-		int prune_depth);
+struct strategic_orchestration_node *son_create(const char *node_key, int is_target_key);
 
-/** Delete a strategic orchestration node object.
+/** Create the task arguments for a strategic orchestration node object.
 @param node Reference to the strategic orchestration node object.
+@return The task arguments in JSON format: {"fn_args": [key], "fn_kwargs": {}}.
 */
-void son_delete(struct strategic_orchestration_node *node);
+char *son_construct_task_arguments(struct strategic_orchestration_node *node);
 
-/** Prune the ancestors of a strategic orchestration node object.
+/** Delete a strategic orchestration node object.
 @param node Reference to the strategic orchestration node object.
 */
-void son_prune_ancestors(struct strategic_orchestration_node *node);
+void son_delete(struct strategic_orchestration_node *node);
 
 /** Print information about a strategic orchestration node object.
 @param node Reference to the strategic orchestration node object.
 */
-void son_print_info(struct strategic_orchestration_node *node);
+void son_debug_print(struct strategic_orchestration_node *node);
 
-/** Update the critical time of a strategic orchestration node object.
-@param node Reference to the strategic orchestration node object.
-@param execution_time Reference to the execution time of the node.
+/** Find all safe ancestors of a strategic orchestration node object.
+@param start_node Reference to the start node.
+@return The set of safe ancestors.
+*/
+struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_node);
+
+/** Find all parents in a specific depth of a strategic orchestration node object.
+@param node Reference to the node object.
+@param depth Reference to the depth.
+@return The list of parents.
 */
-void son_update_critical_time(struct strategic_orchestration_node *node, timestamp_t execution_time);
+struct list *son_find_parents_by_depth(struct strategic_orchestration_node *node, int depth);
 
-/** Replicate the outfile of a strategic orchestration node object.
+/** Update the critical time of a strategic orchestration node object.
 @param node Reference to the strategic orchestration node object.
+@param execution_time Reference to the execution time of the node.
 */
-void son_replicate_outfile(struct strategic_orchestration_node *node);
+void son_update_critical_path_time(struct strategic_orchestration_node *node, timestamp_t execution_time);
 
 #endif
\ No newline at end of file

From 35243c507c2a148890c007dcfbe0f4cf0eafac73 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 16:57:17 -0400
Subject: [PATCH 051/113] update apis

---
 taskvine/src/graph/dagvine/executor.py | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/executor.py
index ba80833339..a02a16cb43 100644
--- a/taskvine/src/graph/dagvine/executor.py
+++ b/taskvine/src/graph/dagvine/executor.py
@@ -29,13 +29,6 @@
     dts = None
 
 
-def hash_name(*args):
-    out_str = ""
-    for arg in args:
-        out_str += str(arg)
-    return hashlib.sha256(out_str.encode('utf-8')).hexdigest()[:32]
-
-
 # convert Dask collection to task dictionary
 def dask_collections_to_task_dict(collection_dict):
     assert is_dask_collection is not None
@@ -165,9 +158,9 @@ def tune_sog(self, sog):
             print(f"Tuning {k} to {v}")
             sog.tune(k, str(v))
 
-    def build_reg(self):
+    def build_reg(self, task_dict):
         reg = RuntimeExecutionGraph(
-            self.task_dict,
+            task_dict,
             extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
             extra_task_sleep_time=self.param("extra-task-sleep-time")
         )
@@ -195,9 +188,9 @@ def build_sog(self, reg, target_keys):
 
         return sog
 
-    def build_graphs(self, target_keys):
+    def build_graphs(self, task_dict, target_keys):
         # build Python DAG (logical topology)
-        reg = self.build_reg()
+        reg = self.build_reg(task_dict)
         # build C DAG (physical topology)
         sog = self.build_sog(reg, target_keys)
 
@@ -223,10 +216,10 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
-        self.task_dict = ensure_task_dict(collection_dict)
+        task_dict = ensure_task_dict(collection_dict)
 
         # build graphs from both sides
-        reg, sog = self.build_graphs(target_keys)
+        reg, sog = self.build_graphs(task_dict, target_keys)
 
         # create and install the proxy library on the manager
         proxy_library = self.create_proxy_library(reg, sog, hoisting_modules, env_files)

From 7ba4fac3cc7e51018514314528991115094fd2cc Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 17:47:40 -0400
Subject: [PATCH 052/113] make

---
 taskvine/src/graph/dagvine/Makefile    | 6 +++---
 taskvine/src/graph/dagvine/executor.py | 2 --
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index 78eb2b4d7e..210d2a1033 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -36,11 +36,11 @@ $(BUILD_DIR):
 	mkdir -p $(BUILD_DIR)
 
 $(SWIG_WRAP): $(SWIG_I) strategic_orchestration_graph.h | $(BUILD_DIR)
-	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -outdir $(BUILD_DIR) -o $@ $<
+	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/graph/dagvine -outdir $(BUILD_DIR) -o $@ $<
 
-# Build Python module
+# Build Python module (mimic bindings: silence SWIG warnings and build PIC)
 $(WRAP_OBJ): $(SWIG_WRAP)
-	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) $(LOCAL_CCFLAGS) -Wno-error=cast-function-type $<
+	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(LOCAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) -w -fPIC -DNDEBUG $<
 
 $(PYMODULE): $(PYDEPS)
 ifeq ($(CCTOOLS_STATIC),1)
diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/executor.py
index a02a16cb43..7141dcde42 100644
--- a/taskvine/src/graph/dagvine/executor.py
+++ b/taskvine/src/graph/dagvine/executor.py
@@ -147,7 +147,6 @@ def get_run_info_path(self):
 
     def tune_manager(self):
         for k, v in self.params.vine_manager_tuning_params.items():
-            print(f"Tuning {k} to {v}")
             try:
                 self.tune(k, v)
             except:
@@ -155,7 +154,6 @@ def tune_manager(self):
 
     def tune_sog(self, sog):
         for k, v in self.params.sog_tuning_params.items():
-            print(f"Tuning {k} to {v}")
             sog.tune(k, str(v))
 
     def build_reg(self, task_dict):

From 728531b5aa0e88b9740b75f787358127c09db54b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 17:50:40 -0400
Subject: [PATCH 053/113] lint

---
 taskvine/src/graph/dagvine/executor.py                | 3 +--
 taskvine/src/graph/dagvine/runtime_execution_graph.py | 1 -
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/executor.py
index 7141dcde42..e89c15de56 100644
--- a/taskvine/src/graph/dagvine/executor.py
+++ b/taskvine/src/graph/dagvine/executor.py
@@ -11,7 +11,6 @@
 import cloudpickle
 import os
 import signal
-import hashlib
 
 try:
     import dask
@@ -149,7 +148,7 @@ def tune_manager(self):
         for k, v in self.params.vine_manager_tuning_params.items():
             try:
                 self.tune(k, v)
-            except:
+            except Exception:
                 raise ValueError(f"Unrecognized parameter: {k}")
 
     def tune_sog(self, sog):
diff --git a/taskvine/src/graph/dagvine/runtime_execution_graph.py b/taskvine/src/graph/dagvine/runtime_execution_graph.py
index 50565ae9f0..37161b1bbc 100644
--- a/taskvine/src/graph/dagvine/runtime_execution_graph.py
+++ b/taskvine/src/graph/dagvine/runtime_execution_graph.py
@@ -2,7 +2,6 @@
 # This software is distributed under the GNU General Public License.
 # See the file COPYING for details.
 
-import os
 import hashlib
 import cloudpickle
 import collections

From ac40b747a9b8ee700b71cba8356ab0582095c01e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 17:53:33 -0400
Subject: [PATCH 054/113] make format

---
 taskvine/src/bindings/python3/Makefile |   7 +-
 taskvine/src/graph/dagvine/params.py   | 109 -------------------------
 2 files changed, 1 insertion(+), 115 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/params.py

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index 16d9cd5ceb..e769fa0f8c 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -39,10 +39,5 @@ install: all
 	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
 
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/runtime_execution_graph.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/executor.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/executor.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_library.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_library.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_functions.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/proxy_functions.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/strategic_orchestration_graph.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/strategic_orchestration_graph.py
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/params.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/params.py
+	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/*.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/
 	@echo "# ${GRAPH_EXECUTOR_MODULE_NAME} package" > $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/__init__.py
diff --git a/taskvine/src/graph/dagvine/params.py b/taskvine/src/graph/dagvine/params.py
deleted file mode 100644
index d513f8b2ac..0000000000
--- a/taskvine/src/graph/dagvine/params.py
+++ /dev/null
@@ -1,109 +0,0 @@
-from dataclasses import dataclass, field
-from ndcctools.taskvine.utils import get_c_constant
-
-
-@dataclass
-class ManagerTuningParams:
-    """These parameters are used to tune the manager at the C level
-    and should comply with the TaskVine manager API."""
-    worker_source_max_transfers: int = 100
-    max_retrievals: int = -1
-    prefer_dispatch: int = 1
-    transient_error_interval: int = 1
-    attempt_schedule_depth: int = 10000
-    temp_replica_count: int = 1
-    enforce_worker_eviction_interval: int = -1
-    balance_worker_disk_load: int = 0
-
-    def update(self, params: dict):
-        """Update configuration from a dict.
-        - Converts '-' to '_' in all keys.
-        - Creates new attributes if they don't exist.
-        """
-        if not isinstance(params, dict):
-            raise TypeError(f"update() expects a dict, got {type(params).__name__}")
-
-        for k, v in params.items():
-            normalized_key = k.replace("-", "_")
-            setattr(self, normalized_key, v)
-        return self
-
-    def to_dict(self):
-        """Convert all current attributes (including dynamically added ones)
-        to a dict, replacing '_' with '-'.
-        """
-        return {k.replace("_", "-"): v for k, v in self.__dict__.items()}
-
-
-@dataclass
-class VineConstantParams:
-    """
-    All attributes are accessed in lower case for the convenience of the users.
-    If there is a need to use these values in the C code, convert them to uppercase and call the get_c_constant_of method to get the C constant.
-    """
-
-    schedule: str = "worst"
-    task_priority_mode: str = "largest-input-first"
-
-    valid_normalized_values = {
-        "schedule": {"files", "time", "rand", "worst", "disk"},
-        "task_priority_mode": {"random", "depth-first", "breadth-first", "fifo", "lifo", "largest-input-first", "largest-storage-footprint-first"},
-    }
-
-    def normalize(self, obj):
-        """Normalize a string by converting '-' to '_' and uppercase the string."""
-        return obj.replace("-", "_").lower()
-
-    def update(self, params: dict):
-        """Update configuration from a dict.
-        - Converts '-' to '_' in all keys and values, and uppercase the values.
-        - Creates new attributes if they don't exist.
-        """
-        if not isinstance(params, dict):
-            raise TypeError(f"update() expects a dict, got {type(params).__name__}")
-
-        for k, v in params.items():
-            normalized_key = self.normalize(k)
-            normalized_value = self.normalize(v)
-            assert normalized_key in self.valid_normalized_values, f"Invalid key: {normalized_key}"
-            assert normalized_value in self.valid_normalized_values[normalized_key], f"Invalid value: {normalized_value} for key: {normalized_key}"
-            setattr(self, normalized_key, normalized_value)
-        return self
-
-    def get_c_constant_of(self, key):
-        """Get the C constant of a key."""
-        normalized_key = self.normalize(key)
-        if normalized_key not in self.valid_normalized_values:
-            raise ValueError(f"Invalid key: {normalized_key}")
-        return get_c_constant(f"{normalized_key.upper()}_{getattr(self, normalized_key).upper()}")
-
-
-@dataclass
-class RegularParams:
-    """Regular parameters that will be used directly by the graph executor."""
-    libcores: int = 16
-    failure_injection_step_percent: int = -1
-    prune_depth: int = 1
-    staging_dir: str = "./staging"
-    shared_file_system_dir: str = "./shared_file_system"
-    extra_task_output_size_mb: list[str, float, float] = field(default_factory=lambda: ["uniform", 0, 0])
-    extra_task_sleep_time: list[str, float, float] = field(default_factory=lambda: ["uniform", 0, 0])
-    outfile_type: dict[str, float] = field(default_factory=lambda: {
-        "temp": 1.0,
-        "shared-file-system": 0.0,
-    })
-
-    def update(self, params: dict):
-        """Update configuration from a dict.
-        - Convert '-' in keys to '_', values are as is.
-        """
-        if not isinstance(params, dict):
-            raise TypeError(f"update() expects a dict, got {type(params).__name__}")
-
-        for k, v in params.items():
-            normalized_key = k.replace("-", "_")
-            if normalized_key not in self.__dict__.keys():
-                raise ValueError(f"Invalid param key: {normalized_key}")
-
-            setattr(self, normalized_key, v)
-        return self

From 76d55c81b56b246894072d1b19fbf351c8ea8afc Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 20:43:19 -0400
Subject: [PATCH 055/113] comment

---
 taskvine/src/graph/dagvine/executor.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/executor.py
index e89c15de56..0ae3d9fbec 100644
--- a/taskvine/src/graph/dagvine/executor.py
+++ b/taskvine/src/graph/dagvine/executor.py
@@ -116,7 +116,7 @@ def __init__(self,
                  *args,
                  **kwargs):
 
-        # handle SIGINT correctly
+        # handle SIGINT
         signal.signal(signal.SIGINT, self._on_sigint)
 
         self.params = GraphParams()

From 945e26f73b1b957447b1fedf1f4e434553913080 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sun, 19 Oct 2025 22:12:48 -0400
Subject: [PATCH 056/113] file name fix

---
 taskvine/src/bindings/python3/Makefile              | 12 +++---------
 taskvine/src/graph/dagvine/Makefile                 | 13 +++++++------
 taskvine/src/graph/dagvine/__init__.py              |  7 +++++++
 .../src/graph/dagvine/{executor.py => dagvine.py}   |  2 +-
 4 files changed, 18 insertions(+), 16 deletions(-)
 create mode 100644 taskvine/src/graph/dagvine/__init__.py
 rename taskvine/src/graph/dagvine/{executor.py => dagvine.py} (99%)

diff --git a/taskvine/src/bindings/python3/Makefile b/taskvine/src/bindings/python3/Makefile
index e769fa0f8c..905b2703ca 100644
--- a/taskvine/src/bindings/python3/Makefile
+++ b/taskvine/src/bindings/python3/Makefile
@@ -1,12 +1,10 @@
 include ../../../../config.mk
 include ../../../../rules.mk
 
-GRAPH_EXECUTOR_MODULE_NAME = dagvine
-
 # Python always uses 'so' for its modules (even on Darwin)
 CCTOOLS_DYNAMIC_SUFFIX = so
 # SWIG produces code that causes a lot of warnings, so use -w to turn those off.
-LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager -I ../../graph/${GRAPH_EXECUTOR_MODULE_NAME}
+LOCAL_CCFLAGS = -w -fPIC -DNDEBUG $(CCTOOLS_PYTHON3_CCFLAGS) -I ../../manager
 LOCAL_LINKAGE = $(CCTOOLS_PYTHON3_LDFLAGS) -lz $(CCTOOLS_OPENSSL_LDFLAGS) $(CCTOOLS_HOME)/taskvine/src/manager/libtaskvine.a $(CCTOOLS_HOME)/dttools/src/libdttools.a
 
 CCTOOLS_FLAKE8_IGNORE_FILES = "cvine.py"
@@ -20,7 +18,7 @@ all: $(TARGETS)
 
 vine_wrap.c: taskvine.i
 	@echo "SWIG taskvine.i (python)"
-	@$(CCTOOLS_SWIG) -o vine_wrap.c -outdir ndcctools/taskvine -python -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME} taskvine.i
+	@$(CCTOOLS_SWIG) -o vine_wrap.c -outdir ndcctools/taskvine -python -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/manager taskvine.i
 
 $(DSPYTHONSO): vine_wrap.o $(EXTERNAL_DEPENDENCIES)
 
@@ -36,8 +34,4 @@ install: all
 	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/compat
 	cp ndcctools/taskvine/*.py $(DSPYTHONSO) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine
 	cp ndcctools/taskvine/compat/*.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/compat
-	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
-
-	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}
-	cp $(CCTOOLS_HOME)/taskvine/src/graph/${GRAPH_EXECUTOR_MODULE_NAME}/*.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/
-	@echo "# ${GRAPH_EXECUTOR_MODULE_NAME} package" > $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/${GRAPH_EXECUTOR_MODULE_NAME}/__init__.py
+	cp taskvine.py $(CCTOOLS_PYTHON3_PATH)/
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index 210d2a1033..95c300402c 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -6,6 +6,7 @@ LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 
 
 DAGVINE_SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/dagvine
+DAGVINE_MODULE_DIR = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
 
 
 SOURCES = strategic_orchestration_node.c strategic_orchestration_graph.c
@@ -28,7 +29,7 @@ TARGETS = $(LIBRARIES) $(PYMODULE) $(PROGRAMS)
 
 all: $(TARGETS)
 
- 
+
 
 $(PROGRAMS): $(EXTERNALS)
 
@@ -54,15 +55,15 @@ endif
 install: all
 	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include
 	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include/
-	mkdir -p $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
-	cp $(PYMODULE) $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
-	cp $(BUILD_DIR)/capi.py $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine/
+	mkdir -p $(DAGVINE_MODULE_DIR)
+	cp $(PYMODULE) $(DAGVINE_MODULE_DIR)
+	cp $(BUILD_DIR)/capi.py $(DAGVINE_MODULE_DIR)
+	# also install pure Python sources for the dagvine package
+	cp $(DAGVINE_SOURCE_DIR)/*.py $(DAGVINE_MODULE_DIR)
 
 clean:
 	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(BUILD_DIR) $(PYMODULE) capi.py
 
-test: all
-
 lint:
 	if ( ! clang-format -Werror --dry-run --style='file:${CCTOOLS_HOME}/.clang-format' $(DAGVINE_SOURCE_DIR)/*.c $(DAGVINE_SOURCE_DIR)/*.h);\
 	then\
diff --git a/taskvine/src/graph/dagvine/__init__.py b/taskvine/src/graph/dagvine/__init__.py
new file mode 100644
index 0000000000..42b763acb3
--- /dev/null
+++ b/taskvine/src/graph/dagvine/__init__.py
@@ -0,0 +1,7 @@
+# Copyright (C) 2025- The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+from .executor import DAGVine
+
+__all__ = ["DAGVine"]
diff --git a/taskvine/src/graph/dagvine/executor.py b/taskvine/src/graph/dagvine/dagvine.py
similarity index 99%
rename from taskvine/src/graph/dagvine/executor.py
rename to taskvine/src/graph/dagvine/dagvine.py
index 0ae3d9fbec..6e6a825121 100644
--- a/taskvine/src/graph/dagvine/executor.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -111,7 +111,7 @@ def get_value_of(self, param_name):
             raise ValueError(f"Invalid param name: {param_name}")
 
 
-class Executor(Manager):
+class DAGVine(Manager):
     def __init__(self,
                  *args,
                  **kwargs):

From c66818400531073c731335223e1a7d93d92cb93e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 20 Oct 2025 21:40:47 -0400
Subject: [PATCH 057/113] rename to vinedag

---
 dttools/src/progress_bar.c                    | 56 +++++++++++++------
 dttools/src/progress_bar.h                    | 20 +++++--
 dttools/src/progress_bar_test.c               |  4 +-
 .../python3/ndcctools/taskvine/utils.py       | 21 +------
 taskvine/src/graph/Makefile                   |  2 +-
 .../src/graph/{dagvine => vinedag}/.gitignore |  0
 .../src/graph/{dagvine => vinedag}/.gitkeep   |  0
 .../src/graph/{dagvine => vinedag}/Makefile   | 26 ++++-----
 .../graph/{dagvine => vinedag}/__init__.py    |  4 +-
 .../src/graph/{dagvine => vinedag}/config.py  |  0
 .../{dagvine => vinedag}/proxy_functions.py   |  2 +-
 .../{dagvine => vinedag}/proxy_library.py     |  9 ++-
 .../runtime_execution_graph.py                |  0
 .../strategic_orchestration_graph.c           | 13 +++++
 .../strategic_orchestration_graph.h           |  2 +
 .../strategic_orchestration_graph.i           |  2 +-
 .../strategic_orchestration_graph.py          |  2 +-
 .../strategic_orchestration_node.c            |  0
 .../strategic_orchestration_node.h            |  0
 .../dagvine.py => vinedag/vinedag.py}         | 45 ++++++++++++---
 20 files changed, 138 insertions(+), 70 deletions(-)
 rename taskvine/src/graph/{dagvine => vinedag}/.gitignore (100%)
 rename taskvine/src/graph/{dagvine => vinedag}/.gitkeep (100%)
 rename taskvine/src/graph/{dagvine => vinedag}/Makefile (77%)
 rename taskvine/src/graph/{dagvine => vinedag}/__init__.py (75%)
 rename taskvine/src/graph/{dagvine => vinedag}/config.py (100%)
 rename taskvine/src/graph/{dagvine => vinedag}/proxy_functions.py (98%)
 rename taskvine/src/graph/{dagvine => vinedag}/proxy_library.py (92%)
 rename taskvine/src/graph/{dagvine => vinedag}/runtime_execution_graph.py (100%)
 rename taskvine/src/graph/{dagvine => vinedag}/strategic_orchestration_graph.c (98%)
 rename taskvine/src/graph/{dagvine => vinedag}/strategic_orchestration_graph.h (98%)
 rename taskvine/src/graph/{dagvine => vinedag}/strategic_orchestration_graph.i (83%)
 rename taskvine/src/graph/{dagvine => vinedag}/strategic_orchestration_graph.py (95%)
 rename taskvine/src/graph/{dagvine => vinedag}/strategic_orchestration_node.c (100%)
 rename taskvine/src/graph/{dagvine => vinedag}/strategic_orchestration_node.h (100%)
 rename taskvine/src/graph/{dagvine/dagvine.py => vinedag/vinedag.py} (85%)

diff --git a/dttools/src/progress_bar.c b/dttools/src/progress_bar.c
index 14e1995b42..012d80e003 100644
--- a/dttools/src/progress_bar.c
+++ b/dttools/src/progress_bar.c
@@ -23,8 +23,13 @@ Implementation of a terminal progress bar with multiple parts.
 
 /* Max bar width (in block characters) for single-line rendering. */
 #define MAX_BAR_WIDTH 30
-/* Minimum redraw interval to avoid flicker. */
-#define PROGRESS_BAR_UPDATE_INTERVAL ((USECOND) * 0.1)
+/* Typed time constants (microseconds). */
+static const timestamp_t SECOND_US      = 1000000ULL;
+static const timestamp_t MILLISECOND_US = 1000ULL;
+static const timestamp_t MICROSECOND_US = 1ULL;
+
+/* Minimum redraw interval to avoid flicker (200ms). */
+#define PROGRESS_BAR_UPDATE_INTERVAL_US (SECOND_US / 5)
 
 #define COLOR_RESET "\033[0m"
 #define COLOR_GREEN "\033[32m"
@@ -75,7 +80,7 @@ static void print_progress_bar(struct ProgressBar *bar)
 		return;
 	}
 
-	bar->last_draw_time = timestamp_get();
+	bar->last_draw_time_us = timestamp_get();
 
 	char part_text[256];
 	char *ptr = part_text;
@@ -114,10 +119,10 @@ static void print_progress_bar(struct ProgressBar *bar)
 		progress = 1.0f;
 	}
 
-	timestamp_t elapsed = timestamp_get() - bar->start_time;
-	int h = elapsed / (3600LL * USECOND);
-	int m = (elapsed % (3600LL * USECOND)) / (60LL * USECOND);
-	int s = (elapsed % (60LL * USECOND)) / USECOND;
+	timestamp_t elapsed = timestamp_get() - bar->start_time_us;
+	int h = elapsed / (3600LL * SECOND_US);
+	int m = (elapsed % (3600LL * SECOND_US)) / (60LL * SECOND_US);
+	int s = (elapsed % (60LL * SECOND_US)) / SECOND_US;
 
 	if (bar->has_drawn_once) {
 		printf("\r\033[2K");
@@ -167,13 +172,34 @@ struct ProgressBar *progress_bar_init(const char *label)
 
 	bar->label = xxstrdup(label);
 	bar->parts = list_create();
-	bar->start_time = timestamp_get();
-	bar->last_draw_time = timestamp_get();
+	bar->start_time_us = timestamp_get();
+	bar->last_draw_time_us = 0;
+	bar->update_interval_us = PROGRESS_BAR_UPDATE_INTERVAL_US;
+	bar->update_interval_sec = (double)bar->update_interval_us / SECOND_US;
 	bar->has_drawn_once = 0;
 
 	return bar;
 }
 
+/** Set the update interval for the progress bar. */
+void progress_bar_set_update_interval(struct ProgressBar *bar, double update_interval_sec)
+{
+	if (!bar) {
+		return;
+	}
+
+	if (update_interval_sec < 0) {
+		update_interval_sec = 0;
+	}
+	bar->update_interval_sec = update_interval_sec;
+	/* Convert seconds to microseconds with saturation to avoid overflow. */
+	if (update_interval_sec >= (double)UINT64_MAX / (double)SECOND_US) {
+		bar->update_interval_us = (timestamp_t)UINT64_MAX;
+	} else {
+		bar->update_interval_us = (timestamp_t)(update_interval_sec * (double)SECOND_US);
+	}
+}
+
 /** Create a new part. */
 struct ProgressBarPart *progress_bar_create_part(const char *label, uint64_t total)
 {
@@ -207,9 +233,8 @@ void progress_bar_set_part_total(struct ProgressBar *bar, struct ProgressBarPart
 	if (!bar || !part) {
 		return;
 	}
-	part->total = new_total;
 
-	print_progress_bar(bar);
+	part->total = new_total;
 }
 
 /** Advance a part's current value, redraw if needed. */
@@ -224,11 +249,10 @@ void progress_bar_update_part(struct ProgressBar *bar, struct ProgressBarPart *p
 		part->current = part->total;
 	}
 
-	if (timestamp_get() - bar->last_draw_time < PROGRESS_BAR_UPDATE_INTERVAL) {
-		return;
+	timestamp_t now_us = timestamp_get();
+	if (!bar->has_drawn_once || (now_us - bar->last_draw_time_us) >= bar->update_interval_us) {
+		print_progress_bar(bar);
 	}
-
-	print_progress_bar(bar);
 }
 
 /** Set the start time for the progress bar. */
@@ -238,7 +262,7 @@ void progress_bar_set_start_time(struct ProgressBar *bar, timestamp_t start_time
 		return;
 	}
 
-	bar->start_time = start_time;
+	bar->start_time_us = start_time;
 }
 
 /** Final render and newline. */
diff --git a/dttools/src/progress_bar.h b/dttools/src/progress_bar.h
index 6a38a95424..7fe3171a3f 100644
--- a/dttools/src/progress_bar.h
+++ b/dttools/src/progress_bar.h
@@ -25,11 +25,15 @@ struct ProgressBarPart {
 
 /** Progress bar object. */
 struct ProgressBar {
-	char *label;
-	struct list *parts;
-	timestamp_t start_time;
-    timestamp_t last_draw_time;
-	int has_drawn_once;
+    /* User-facing interval in seconds; internal comparisons use *_us. */
+    double update_interval_sec;
+    char *label;
+    struct list *parts;
+    /* Timestamps in microseconds. */
+    timestamp_t start_time_us;
+    timestamp_t last_draw_time_us;
+    timestamp_t update_interval_us;
+    int has_drawn_once;
 };
 
 /* Progress Bar Part API */
@@ -40,6 +44,12 @@ struct ProgressBar {
 */
 struct ProgressBar *progress_bar_init(const char *label);
 
+/** Set the update interval for the progress bar.
+@param bar Progress bar.
+@param update_interval_sec Update interval in seconds.
+*/
+void progress_bar_set_update_interval(struct ProgressBar *bar, double update_interval_sec);
+
 /** Create a new part.
 @param label Part label (internally duplicated).
 @param total Total units for the part.
diff --git a/dttools/src/progress_bar_test.c b/dttools/src/progress_bar_test.c
index 4c72d09425..4a7b70ed1c 100644
--- a/dttools/src/progress_bar_test.c
+++ b/dttools/src/progress_bar_test.c
@@ -6,12 +6,14 @@
 
 int main()
 {
-	uint64_t total = 100000;
+	uint64_t total = 1000000;
 	struct ProgressBarPart *part1 = progress_bar_create_part("step", total);
 	struct ProgressBarPart *part2 = progress_bar_create_part("fetch", total);
 	struct ProgressBarPart *part3 = progress_bar_create_part("commit", total);
 
 	struct ProgressBar *bar = progress_bar_init("Compute");
+	progress_bar_set_update_interval(bar, 0.5);
+
 	progress_bar_bind_part(bar, part1);
 	progress_bar_bind_part(bar, part2);
 	progress_bar_bind_part(bar, part3);
diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index 166b2800f2..c11c5d5b0d 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -12,12 +12,7 @@ def get_c_constant(constant):
         "result_success" -> VINE_RESULT_SUCCESS
     """
     constant = f"VINE_{constant.upper()}"
-    # First try the base cvine module
-    value = getattr(cvine, constant, None)
-    if value is not None:
-        return value
-    # If still missing, raise a clear error
-    raise AttributeError(f"C constant {constant} not found in cvine or cdagvine")
+    return getattr(cvine, constant)
 
 
 def set_port_range(port):
@@ -42,16 +37,4 @@ def load_variable_from_library(var_name):
     return globals()[var_name]
 
 
-# helper function that deletes all files in a directory
-def delete_all_files(root_dir):
-    if not os.path.exists(root_dir):
-        return
-    for dirpath, dirnames, filenames in os.walk(root_dir):
-        for filename in filenames:
-            file_path = os.path.join(dirpath, filename)
-            try:
-                os.remove(file_path)
-            except FileNotFoundError:
-                print(f"Failed to delete file {file_path}")
-
-# vim: set sts=4 sw=4 ts=4 expandtab ft=python:
+# vim: set sts=4 sw=4 ts=4 expandtab ft=python:
\ No newline at end of file
diff --git a/taskvine/src/graph/Makefile b/taskvine/src/graph/Makefile
index 04598b4683..fa4c7dc2c5 100644
--- a/taskvine/src/graph/Makefile
+++ b/taskvine/src/graph/Makefile
@@ -1,7 +1,7 @@
 include ../../../config.mk
 include ../../../rules.mk
 
-SUBDIRS = dagvine
+SUBDIRS = vinedag
 
 all clean install test lint format: $(SUBDIRS)
 
diff --git a/taskvine/src/graph/dagvine/.gitignore b/taskvine/src/graph/vinedag/.gitignore
similarity index 100%
rename from taskvine/src/graph/dagvine/.gitignore
rename to taskvine/src/graph/vinedag/.gitignore
diff --git a/taskvine/src/graph/dagvine/.gitkeep b/taskvine/src/graph/vinedag/.gitkeep
similarity index 100%
rename from taskvine/src/graph/dagvine/.gitkeep
rename to taskvine/src/graph/vinedag/.gitkeep
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/vinedag/Makefile
similarity index 77%
rename from taskvine/src/graph/dagvine/Makefile
rename to taskvine/src/graph/vinedag/Makefile
index 95c300402c..f3882a646c 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/vinedag/Makefile
@@ -4,9 +4,10 @@ include ../../../../rules.mk
 LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
 LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
 
+PROJECT_NAME = vinedag
 
-DAGVINE_SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/dagvine
-DAGVINE_MODULE_DIR = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
+SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)
+MODULE_DIR = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
 
 
 SOURCES = strategic_orchestration_node.c strategic_orchestration_graph.c
@@ -37,7 +38,7 @@ $(BUILD_DIR):
 	mkdir -p $(BUILD_DIR)
 
 $(SWIG_WRAP): $(SWIG_I) strategic_orchestration_graph.h | $(BUILD_DIR)
-	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/graph/dagvine -outdir $(BUILD_DIR) -o $@ $<
+	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME) -outdir $(BUILD_DIR) -o $@ $<
 
 # Build Python module (mimic bindings: silence SWIG warnings and build PIC)
 $(WRAP_OBJ): $(SWIG_WRAP)
@@ -53,19 +54,18 @@ endif
 
 
 install: all
-	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include
-	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/dagvine/include/
-	mkdir -p $(DAGVINE_MODULE_DIR)
-	cp $(PYMODULE) $(DAGVINE_MODULE_DIR)
-	cp $(BUILD_DIR)/capi.py $(DAGVINE_MODULE_DIR)
-	# also install pure Python sources for the dagvine package
-	cp $(DAGVINE_SOURCE_DIR)/*.py $(DAGVINE_MODULE_DIR)
+	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/$(PROJECT_NAME)/include
+	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/$(PROJECT_NAME)/include/
+	mkdir -p $(MODULE_DIR)
+	cp $(PYMODULE) $(MODULE_DIR)
+	cp $(BUILD_DIR)/capi.py $(MODULE_DIR)
+	cp $(SOURCE_DIR)/*.py $(MODULE_DIR)
 
 clean:
 	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(BUILD_DIR) $(PYMODULE) capi.py
 
 lint:
-	if ( ! clang-format -Werror --dry-run --style='file:${CCTOOLS_HOME}/.clang-format' $(DAGVINE_SOURCE_DIR)/*.c $(DAGVINE_SOURCE_DIR)/*.h);\
+	if ( ! clang-format -Werror --dry-run --style='file:${CCTOOLS_HOME}/.clang-format' $(SOURCE_DIR)/*.c $(SOURCE_DIR)/*.h);\
 	then\
 		echo  "========================================================";\
 		echo  "NOTICE: Run \`make format\` to format your latest changes.";\
@@ -74,10 +74,10 @@ lint:
 	fi
 	flake8 --ignore=$(CCTOOLS_FLAKE8_IGNORE_ERRORS) \
 		--exclude=$(CCTOOLS_FLAKE8_IGNORE_FILES),$(BUILD_DIR) \
-		$(DAGVINE_SOURCE_DIR)/
+		$(SOURCE_DIR)/
 
 format:
-	clang-format -i $(DAGVINE_SOURCE_DIR)/*.c $(DAGVINE_SOURCE_DIR)/*.h
+	clang-format -i $(SOURCE_DIR)/*.c $(SOURCE_DIR)/*.h
 
 .PHONY: all clean install test lint format
 
diff --git a/taskvine/src/graph/dagvine/__init__.py b/taskvine/src/graph/vinedag/__init__.py
similarity index 75%
rename from taskvine/src/graph/dagvine/__init__.py
rename to taskvine/src/graph/vinedag/__init__.py
index 42b763acb3..0a3da3f715 100644
--- a/taskvine/src/graph/dagvine/__init__.py
+++ b/taskvine/src/graph/vinedag/__init__.py
@@ -2,6 +2,6 @@
 # This software is distributed under the GNU General Public License.
 # See the file COPYING for details.
 
-from .executor import DAGVine
+from .vinedag import VineDAG
 
-__all__ = ["DAGVine"]
+__all__ = ["VineDAG"]
diff --git a/taskvine/src/graph/dagvine/config.py b/taskvine/src/graph/vinedag/config.py
similarity index 100%
rename from taskvine/src/graph/dagvine/config.py
rename to taskvine/src/graph/vinedag/config.py
diff --git a/taskvine/src/graph/dagvine/proxy_functions.py b/taskvine/src/graph/vinedag/proxy_functions.py
similarity index 98%
rename from taskvine/src/graph/dagvine/proxy_functions.py
rename to taskvine/src/graph/vinedag/proxy_functions.py
index e79243f987..2cbbc8d1e1 100644
--- a/taskvine/src/graph/dagvine/proxy_functions.py
+++ b/taskvine/src/graph/vinedag/proxy_functions.py
@@ -43,7 +43,7 @@ def compute_sexpr_key(reg, k, v):
     """
     Evaluate a symbolic expression (S-expression) task within the task graph.
 
-    Both DAGVine and legacy Dask represent computations as symbolic
+    Both VineDAG and legacy Dask represent computations as symbolic
     expression trees (S-expressions). Each task value `v` encodes a nested
     structure where:
       - Leaf nodes are constants or task keys referencing parent results.
diff --git a/taskvine/src/graph/dagvine/proxy_library.py b/taskvine/src/graph/vinedag/proxy_library.py
similarity index 92%
rename from taskvine/src/graph/dagvine/proxy_library.py
rename to taskvine/src/graph/vinedag/proxy_library.py
index 01e9bda3be..0f1d1ea1b4 100644
--- a/taskvine/src/graph/dagvine/proxy_library.py
+++ b/taskvine/src/graph/vinedag/proxy_library.py
@@ -10,10 +10,10 @@
 import random
 import hashlib
 import collections
-from ndcctools.taskvine.dagvine.runtime_execution_graph import (
+from ndcctools.taskvine.vinedag.runtime_execution_graph import (
     GraphKeyResult, RuntimeExecutionGraph, hash_name, hashable
 )
-from ndcctools.taskvine.dagvine.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
+from ndcctools.taskvine.vinedag.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
@@ -64,6 +64,11 @@ def set_context_loader(self, context_loader_func, context_loader_args=[], contex
         self.context_loader_args = context_loader_args
         self.context_loader_kwargs = context_loader_kwargs
 
+    def get_context_size(self):
+        dumped_data = self.context_loader_args[0]
+        serialized = round(len(dumped_data) / 1024 / 1024, 2)
+        return serialized
+
     def install(self):
         assert self.name is not None, "Library name must be set before installing (use set_name method)"
         assert self.libcores is not None, "Library cores must be set before installing (use set_libcores method)"
diff --git a/taskvine/src/graph/dagvine/runtime_execution_graph.py b/taskvine/src/graph/vinedag/runtime_execution_graph.py
similarity index 100%
rename from taskvine/src/graph/dagvine/runtime_execution_graph.py
rename to taskvine/src/graph/vinedag/runtime_execution_graph.py
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
similarity index 98%
rename from taskvine/src/graph/dagvine/strategic_orchestration_graph.c
rename to taskvine/src/graph/vinedag/strategic_orchestration_graph.c
index c8db15ebde..2f3ba66d00 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
@@ -137,7 +137,12 @@ static void submit_node_task(struct strategic_orchestration_graph *sog, struct s
 	vine_task_set_priority(node->task, priority);
 
 	/* submit the task to the manager */
+	timestamp_t time_start = timestamp_get();
 	int task_id = vine_submit(sog->manager, node->task);
+	double time_taken = (double)(timestamp_get() - time_start) / 1e6;
+	FILE *fp = fopen("vinedag_submission_time.txt", "a");
+	fprintf(fp, "%.6f\n", time_taken);
+	fclose(fp);
 
 	/* insert the task id to the task id to node map */
 	itable_insert(sog->task_id_to_node, task_id, node);
@@ -600,6 +605,10 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		}
 		sog->checkpoint_dir = xxstrdup(value);
 
+	} else if (strcmp(name, "progress-bar-update-interval-sec") == 0) {
+		double val = atof(value);
+		sog->progress_bar_update_interval_sec = (val > 0.0) ? val : 0.1;
+
 	} else {
 		debug(D_ERROR, "invalid parameter name: %s", name);
 		return -1;
@@ -957,6 +966,8 @@ struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
 	sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
 	sog->failure_injection_step_percent = -1.0;
 
+	sog->progress_bar_update_interval_sec = 0.1;
+
 	/* enable debug system for C code since it uses a separate debug system instance
 	 * from the Python bindings. Use the same function that the manager uses. */
 	char *debug_tmp = string_format("%s/vine-logs/debug", sog->manager->runtime_directory);
@@ -1077,6 +1088,8 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	}
 
 	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
+	progress_bar_set_update_interval(pbar, sog->progress_bar_update_interval_sec);
+
 	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(sog->nodes));
 	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
 	progress_bar_bind_part(pbar, regular_tasks_part);
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
similarity index 98%
rename from taskvine/src/graph/dagvine/strategic_orchestration_graph.h
rename to taskvine/src/graph/vinedag/strategic_orchestration_graph.h
index f440ba0872..840f64cacd 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.h
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
@@ -53,6 +53,8 @@ struct strategic_orchestration_graph {
 
 	task_priority_mode_t task_priority_mode; /* priority mode for task graph task scheduling */
 	double failure_injection_step_percent;	 /* 0 - 100, the percentage of steps to inject failure */
+
+    double progress_bar_update_interval_sec; /* update interval for the progress bar in seconds */
 };
 
 /* Public APIs for operating the strategic orchestration graph */
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i b/taskvine/src/graph/vinedag/strategic_orchestration_graph.i
similarity index 83%
rename from taskvine/src/graph/dagvine/strategic_orchestration_graph.i
rename to taskvine/src/graph/vinedag/strategic_orchestration_graph.i
index c2bc74659e..1f7f7be8eb 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.i
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.i
@@ -1,4 +1,4 @@
-/* SWIG interface for local dagvine graph API bindings */
+/* SWIG interface for local vinedag graph API bindings */
 %module capi
 
 %{
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_graph.py b/taskvine/src/graph/vinedag/strategic_orchestration_graph.py
similarity index 95%
rename from taskvine/src/graph/dagvine/strategic_orchestration_graph.py
rename to taskvine/src/graph/vinedag/strategic_orchestration_graph.py
index c7f9fb04a6..2c8f30d5f5 100644
--- a/taskvine/src/graph/dagvine/strategic_orchestration_graph.py
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.py
@@ -1,4 +1,4 @@
-from ndcctools.taskvine.dagvine import capi
+from ndcctools.taskvine.vinedag import capi
 
 
 class StrategicOrchestrationGraph:
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.c b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
similarity index 100%
rename from taskvine/src/graph/dagvine/strategic_orchestration_node.c
rename to taskvine/src/graph/vinedag/strategic_orchestration_node.c
diff --git a/taskvine/src/graph/dagvine/strategic_orchestration_node.h b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
similarity index 100%
rename from taskvine/src/graph/dagvine/strategic_orchestration_node.h
rename to taskvine/src/graph/vinedag/strategic_orchestration_node.h
diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/vinedag/vinedag.py
similarity index 85%
rename from taskvine/src/graph/dagvine/dagvine.py
rename to taskvine/src/graph/vinedag/vinedag.py
index 6e6a825121..e1bf7838bd 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/vinedag/vinedag.py
@@ -1,16 +1,16 @@
 
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.manager import Manager
-from ndcctools.taskvine.utils import delete_all_files
 
-from ndcctools.taskvine.dagvine.proxy_library import ProxyLibrary
-from ndcctools.taskvine.dagvine.proxy_functions import compute_single_key
-from ndcctools.taskvine.dagvine.runtime_execution_graph import RuntimeExecutionGraph, GraphKeyResult
-from ndcctools.taskvine.dagvine.strategic_orchestration_graph import StrategicOrchestrationGraph
+from ndcctools.taskvine.vinedag.proxy_library import ProxyLibrary
+from ndcctools.taskvine.vinedag.proxy_functions import compute_single_key
+from ndcctools.taskvine.vinedag.runtime_execution_graph import RuntimeExecutionGraph, GraphKeyResult
+from ndcctools.taskvine.vinedag.strategic_orchestration_graph import StrategicOrchestrationGraph
 
 import cloudpickle
 import os
 import signal
+import json
 
 try:
     import dask
@@ -28,6 +28,23 @@
     dts = None
 
 
+def delete_all_files(root_dir):
+    if not os.path.exists(root_dir):
+        return
+    for dirpath, dirnames, filenames in os.walk(root_dir):
+        for filename in filenames:
+            file_path = os.path.join(dirpath, filename)
+            try:
+                os.remove(file_path)
+            except FileNotFoundError:
+                print(f"Failed to delete file {file_path}")
+
+
+# color the text with the given color code
+def color_text(text, color_code):
+    return f"\033[{color_code}m{text}\033[0m"
+
+
 # convert Dask collection to task dictionary
 def dask_collections_to_task_dict(collection_dict):
     assert is_dask_collection is not None
@@ -81,6 +98,7 @@ def __init__(self):
             "output-dir": "./outputs",
             "checkpoint-dir": "./checkpoints",
             "checkpoint-fraction": 0,
+            "progress-bar-update-interval-sec": 0.1,
         }
         self.other_params = {
             "schedule": "worst",
@@ -90,6 +108,10 @@ def __init__(self):
             "extra-task-sleep-time": ["uniform", 0, 0],
         }
 
+    def print_params(self):
+        all_params = {**self.vine_manager_tuning_params, **self.sog_tuning_params, **self.other_params}
+        print(json.dumps(all_params, indent=4))
+
     def update_param(self, param_name, new_value):
         if param_name in self.vine_manager_tuning_params:
             self.vine_manager_tuning_params[param_name] = new_value
@@ -111,7 +133,7 @@ def get_value_of(self, param_name):
             raise ValueError(f"Invalid param name: {param_name}")
 
 
-class DAGVine(Manager):
+class VineDAG(Manager):
     def __init__(self,
                  *args,
                  **kwargs):
@@ -130,9 +152,12 @@ def __init__(self,
 
         # initialize the manager
         super().__init__(*args, **kwargs)
-
         self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
 
+        print(f"=== Manager name: {color_text(self.name, 92)}")
+        print(f"=== Manager port: {color_text(self.port, 92)}")
+        print(f"=== Runtime directory: {color_text(self.runtime_directory, 92)}")
+
     def param(self, param_name):
         return self.params.get_value_of(param_name)
 
@@ -215,6 +240,9 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
 
         task_dict = ensure_task_dict(collection_dict)
 
+        with open("test_dv5.pkl", "wb") as f:
+            cloudpickle.dump(task_dict, f)
+
         # build graphs from both sides
         reg, sog = self.build_graphs(task_dict, target_keys)
 
@@ -222,8 +250,9 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
         proxy_library = self.create_proxy_library(reg, sog, hoisting_modules, env_files)
         proxy_library.install()
 
+        print(f"=== Library serialized size: {color_text(proxy_library.get_context_size(), 92)} MB")
+
         # execute the graph on the C side
-        print(f"Executing task graph, logs will be written to {self.runtime_directory}")
         sog.execute()
 
         # clean up the library instances and template on the manager

From b8bca0d78a67d64858d45e00deb0d26925461cb6 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 20 Oct 2025 21:51:51 -0400
Subject: [PATCH 058/113] add three fields

---
 taskvine/src/graph/vinedag/strategic_orchestration_graph.c | 6 ++----
 taskvine/src/graph/vinedag/strategic_orchestration_node.c  | 5 +++++
 taskvine/src/graph/vinedag/strategic_orchestration_node.h  | 5 +++++
 3 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
index 2f3ba66d00..216cfe23b5 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
@@ -139,10 +139,7 @@ static void submit_node_task(struct strategic_orchestration_graph *sog, struct s
 	/* submit the task to the manager */
 	timestamp_t time_start = timestamp_get();
 	int task_id = vine_submit(sog->manager, node->task);
-	double time_taken = (double)(timestamp_get() - time_start) / 1e6;
-	FILE *fp = fopen("vinedag_submission_time.txt", "a");
-	fprintf(fp, "%.6f\n", time_taken);
-	fclose(fp);
+	node->submission_time = timestamp_get() - time_start;
 
 	/* insert the task id to the task id to node map */
 	itable_insert(sog->task_id_to_node, task_id, node);
@@ -1158,6 +1155,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 			/* mark the node as completed */
 			node->completed = 1;
+			
 
 			/* prune nodes on task completion */
 			prune_ancestors_of_node(sog, node);
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.c b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
index 9f2442213d..8fb47a8a92 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
@@ -153,6 +153,11 @@ struct strategic_orchestration_node *son_create(const char *node_key, int is_tar
 	node->time_spent_on_prune_ancestors_of_temp_node = 0;
 	node->time_spent_on_prune_ancestors_of_persisted_node = 0;
 
+	node->submission_time = 0;
+	node->scheduling_time = 0;
+	node->execution_time = 0;
+	node->retrieval_time = 0;
+
 	node->critical_path_time = -1;
 
 	return node;
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.h b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
index a2f421dd06..32c347caf4 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.h
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
@@ -56,6 +56,11 @@ struct strategic_orchestration_node {
 	timestamp_t time_spent_on_prune_ancestors_of_temp_node;
 	timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
 
+	timestamp_t submission_time;
+	timestamp_t scheduling_time;
+	timestamp_t execution_time;
+	timestamp_t retrieval_time;
+
 	node_outfile_type_t outfile_type;
 	prune_status_t prune_status;
 };

From 1575045275e17ce1bff965a940d32863ac7aa94c Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 20 Oct 2025 21:56:41 -0400
Subject: [PATCH 059/113] calculate time spent on scheduling

---
 taskvine/src/manager/vine_manager.c | 3 +++
 taskvine/src/manager/vine_task.c    | 2 ++
 taskvine/src/manager/vine_task.h    | 2 ++
 3 files changed, 7 insertions(+)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 9b3cae6a46..4bca134957 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3617,6 +3617,8 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 	struct vine_task *t;
 
 	while (tasks_considered < tasks_to_consider) {
+		timestamp_t time_when_scheduling_start = timestamp_get();
+
 		t = priority_queue_pop(q->ready_tasks);
 		if (!t) {
 			break;
@@ -3649,6 +3651,7 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 		switch (result) {
 		case VINE_SUCCESS:
 			committed_tasks++;
+			t->time_spent_on_scheduling = timestamp_get() - time_when_scheduling_start;
 			break;
 		case VINE_APP_FAILURE:
 		case VINE_WORKER_FAILURE:
diff --git a/taskvine/src/manager/vine_task.c b/taskvine/src/manager/vine_task.c
index c0db71c030..cde256c47a 100644
--- a/taskvine/src/manager/vine_task.c
+++ b/taskvine/src/manager/vine_task.c
@@ -153,6 +153,8 @@ void vine_task_reset(struct vine_task *t)
 	t->time_workers_execute_exhaustion = 0;
 	t->time_workers_execute_failure = 0;
 
+	t->time_spent_on_scheduling = 0;
+
 	rmsummary_delete(t->resources_measured);
 	rmsummary_delete(t->resources_allocated);
 	t->resources_measured = rmsummary_create(-1);
diff --git a/taskvine/src/manager/vine_task.h b/taskvine/src/manager/vine_task.h
index d97e0b9530..d76d38e72b 100644
--- a/taskvine/src/manager/vine_task.h
+++ b/taskvine/src/manager/vine_task.h
@@ -122,6 +122,8 @@ struct vine_task {
 	timestamp_t time_workers_execute_exhaustion;           /**< Accumulated time spent in attempts that exhausted resources. */
 	timestamp_t time_workers_execute_failure;              /**< Accumulated time for runs that terminated in worker failure/disconnection. */
 
+	timestamp_t time_spent_on_scheduling;                 /**< Time spent on scheduling the task, only consider the successful scheduling. */
+
 	int64_t bytes_received;                                /**< Number of bytes received since task has last started receiving input data. */
 	int64_t bytes_sent;                                    /**< Number of bytes sent since task has last started sending input data. */
 	int64_t bytes_transferred;                             /**< Number of bytes transferred since task has last started transferring input data. */

From c107a9cdc516d891748c129b6375edefacab04ed Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 22 Oct 2025 12:05:39 -0400
Subject: [PATCH 060/113] gpus

---
 taskvine/src/manager/vine_schedule.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index b60c86e4d5..f4ce49f2c5 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -189,7 +189,8 @@ int vine_schedule_count_committable_cores(struct vine_manager *q)
 		}
 		/* count the number of free gpus */
 		if (w->resources->gpus.total > 0 && overcommitted_resource_total(q, w->resources->gpus.total) > w->resources->gpus.inuse) {
-			count += overcommitted_resource_total(q, w->resources->gpus.total) - w->resources->gpus.inuse;
+			// Don't count gpus for now, because the manager has not yet fully supported scheduling tasks to GPUs.
+			// count += overcommitted_resource_total(q, w->resources->gpus.total) - w->resources->gpus.inuse;
 		}
 	}
 

From cc2710977fd4b7f68a71185cb4a0325faa4bccc1 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 29 Oct 2025 10:14:43 -0400
Subject: [PATCH 061/113] time metrics

---
 .../vinedag/strategic_orchestration_graph.c   | 106 ++++-
 .../vinedag/strategic_orchestration_graph.h   |   5 +
 .../vinedag/strategic_orchestration_node.c    |   3 +
 .../vinedag/strategic_orchestration_node.h    |   3 +
 taskvine/src/graph/vinedag/vinedag.py         |   3 +
 taskvine/src/manager/vine_manager.c           |   6 +-
 taskvine/src/manager/vine_manager_put.c       | 371 +++++++++++++++++-
 7 files changed, 490 insertions(+), 7 deletions(-)

diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
index 216cfe23b5..895502ef23 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
@@ -532,6 +532,41 @@ static void prune_ancestors_of_node(struct strategic_orchestration_graph *sog, s
 	return;
 }
 
+/**
+ * Print the time metrics of the strategic orchestration graph to a csv file.
+ * @param sog Reference to the strategic orchestration graph object.
+ * @param filename Reference to the filename of the csv file.
+ */
+static void print_time_metrics(struct strategic_orchestration_graph *sog, const char *filename)
+{
+	if (!sog) {
+		return;
+	}
+
+	/* first delete the file if it exists */
+	if (access(filename, F_OK) != -1) {
+		unlink(filename);
+	}
+
+	/* print the header as a csv file */
+	FILE *fp = fopen(filename, "w");
+	if (!fp) {
+		debug(D_ERROR, "failed to open file %s", filename);
+		return;
+	}
+	fprintf(fp, "node_key,submission_time_us,scheduling_time_us,commit_time_us,execution_time_us,retrieval_time_us,pruning_time_us,postprocessing_time_us\n");
+
+	char *node_key;
+	struct strategic_orchestration_node *node;
+	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	{
+		fprintf(fp, "%s,%lu,%lu,%lu,%lu,%lu,%lu,%lu\n", node_key, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->pruning_time, node->postprocessing_time);
+	}
+	fclose(fp);
+
+	return;
+}
+
 /*************************************************************/
 /* Public APIs */
 /*************************************************************/
@@ -606,6 +641,52 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		double val = atof(value);
 		sog->progress_bar_update_interval_sec = (val > 0.0) ? val : 0.1;
 
+	} else if (strcmp(name, "time-metrics-filename") == 0) {
+		if (strcmp(value, "0") == 0) {
+			return 0;
+		}
+
+		if (sog->time_metrics_filename) {
+			free(sog->time_metrics_filename);
+		}
+	
+		sog->time_metrics_filename = xxstrdup(value);
+	
+		/** Extract parent directory inline **/
+		const char *slash = strrchr(sog->time_metrics_filename, '/');
+		if (slash) {
+			size_t len = slash - sog->time_metrics_filename;
+			char *parent = malloc(len + 1);
+			memcpy(parent, sog->time_metrics_filename, len);
+			parent[len] = '\0';
+	
+			/** Ensure the parent directory exists **/
+			if (mkdir(parent, 0777) != 0 && errno != EEXIST) {
+				debug(D_ERROR, "failed to mkdir %s (errno=%d)", parent, errno);
+				free(parent);
+				return -1;
+			}
+			free(parent);
+		}
+	
+		/** Truncate or create the file **/
+		FILE *fp = fopen(sog->time_metrics_filename, "w");
+		if (!fp) {
+			debug(D_ERROR, "failed to create file %s (errno=%d)", sog->time_metrics_filename, errno);
+			return -1;
+		}
+		fclose(fp);
+
+	} else if (strcmp(name, "enable-debug-log") == 0) {
+		if (sog->enable_debug_log == 0) {
+			return -1;
+		}
+		sog->enable_debug_log = (atoi(value) == 1) ? 1 : 0;
+		if (sog->enable_debug_log == 0) {
+			debug_flags_clear();
+			debug_close();
+		}
+
 	} else {
 		debug(D_ERROR, "invalid parameter name: %s", name);
 		return -1;
@@ -971,6 +1052,10 @@ struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
 	vine_enable_debug_log(debug_tmp);
 	free(debug_tmp);
 
+	sog->time_metrics_filename = NULL;
+
+	sog->enable_debug_log = 1;
+
 	return sog;
 }
 
@@ -1092,7 +1177,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	progress_bar_bind_part(pbar, regular_tasks_part);
 	progress_bar_bind_part(pbar, recovery_tasks_part);
 
-	int wait_timeout = 2;
+	int wait_timeout = 1;
 
 	while (regular_tasks_part->current < regular_tasks_part->total) {
 		if (interrupted) {
@@ -1105,6 +1190,8 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			/* retrieve all possible tasks */
 			wait_timeout = 0;
 
+			timestamp_t time_when_postprocessing_start = timestamp_get();
+
 			/* get the original node by task id */
 			struct strategic_orchestration_node *node = get_node_by_task(sog, task);
 			if (!node) {
@@ -1155,7 +1242,10 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 			/* mark the node as completed */
 			node->completed = 1;
-			
+			node->scheduling_time = task->time_spent_on_scheduling;
+			node->commit_time = task->time_when_commit_end - task->time_when_commit_start;
+			node->execution_time = task->time_workers_execute_last;
+			node->retrieval_time = task->time_when_done - task->time_when_retrieval;
 
 			/* prune nodes on task completion */
 			prune_ancestors_of_node(sog, node);
@@ -1172,7 +1262,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			}
 
 			/* update critical time */
-			son_update_critical_path_time(node, task->time_workers_execute_last);
+			son_update_critical_path_time(node, node->execution_time);
 
 			/* mark this regular task as completed */
 			progress_bar_update_part(pbar, regular_tasks_part, 1);
@@ -1199,8 +1289,11 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 			/* submit children nodes with dependencies all resolved */
 			submit_unblocked_children(sog, node);
+
+			timestamp_t time_when_postprocessing_end = timestamp_get();
+			node->postprocessing_time = time_when_postprocessing_end - time_when_postprocessing_start;
 		} else {
-			wait_timeout = 2;
+			wait_timeout = 1;
 			progress_bar_update_part(pbar, recovery_tasks_part, 0); // refresh the time and total for recovery tasks
 		}
 	}
@@ -1216,6 +1309,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
 		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
 		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
+		node->pruning_time = node->time_spent_on_unlink_local_files + node->time_spent_on_prune_ancestors_of_temp_node + node->time_spent_on_prune_ancestors_of_persisted_node;
 	}
 	total_time_spent_on_unlink_local_files /= 1e6;
 	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
@@ -1225,6 +1319,10 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
 	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
 
+	if (sog->time_metrics_filename) {
+		print_time_metrics(sog, sog->time_metrics_filename);
+	}
+
 	return;
 }
 
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.h b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
index 840f64cacd..0cbf29d0ef 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
@@ -55,6 +55,11 @@ struct strategic_orchestration_graph {
 	double failure_injection_step_percent;	 /* 0 - 100, the percentage of steps to inject failure */
 
     double progress_bar_update_interval_sec; /* update interval for the progress bar in seconds */
+
+	/* The filename of the csv file to store the time metrics of the strategic orchestration graph. */
+	char *time_metrics_filename;
+
+	int enable_debug_log; /* whether to enable debug log */
 };
 
 /* Public APIs for operating the strategic orchestration graph */
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.c b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
index 8fb47a8a92..3735a92fd8 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
@@ -155,8 +155,11 @@ struct strategic_orchestration_node *son_create(const char *node_key, int is_tar
 
 	node->submission_time = 0;
 	node->scheduling_time = 0;
+	node->commit_time = 0;
 	node->execution_time = 0;
 	node->retrieval_time = 0;
+	node->pruning_time = 0;
+	node->postprocessing_time = 0;
 
 	node->critical_path_time = -1;
 
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.h b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
index 32c347caf4..6ca4ca1c99 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.h
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
@@ -58,8 +58,11 @@ struct strategic_orchestration_node {
 
 	timestamp_t submission_time;
 	timestamp_t scheduling_time;
+	timestamp_t commit_time;
 	timestamp_t execution_time;
 	timestamp_t retrieval_time;
+	timestamp_t pruning_time;
+	timestamp_t postprocessing_time;
 
 	node_outfile_type_t outfile_type;
 	prune_status_t prune_status;
diff --git a/taskvine/src/graph/vinedag/vinedag.py b/taskvine/src/graph/vinedag/vinedag.py
index e1bf7838bd..ce4a46511a 100644
--- a/taskvine/src/graph/vinedag/vinedag.py
+++ b/taskvine/src/graph/vinedag/vinedag.py
@@ -11,6 +11,7 @@
 import os
 import signal
 import json
+import tqdm
 
 try:
     import dask
@@ -99,6 +100,8 @@ def __init__(self):
             "checkpoint-dir": "./checkpoints",
             "checkpoint-fraction": 0,
             "progress-bar-update-interval-sec": 0.1,
+            "time-metrics-filename": "time_metrics.csv",
+            "enable-debug-log": 1,
         }
         self.other_params = {
             "schedule": "worst",
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index bdc938a088..91495b1308 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3143,7 +3143,7 @@ static vine_result_code_t commit_task_to_worker(struct vine_manager *q, struct v
 
 	/* Kill unused libraries on this worker to reclaim resources. */
 	/* Matches assumption in vine_schedule.c:check_worker_have_enough_resources() */
-	kill_empty_libraries_on_worker(q, w, t);
+	// kill_empty_libraries_on_worker(q, w, t);
 
 	/* If this is a function needing a library, dispatch the library. */
 	if (t->needs_library) {
@@ -3760,6 +3760,8 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 		/* select a worker for the task */
 		struct vine_worker_info *w = vine_schedule_task_to_worker(q, t);
 
+		timestamp_t time_when_scheduling_end = timestamp_get();
+		
 		/* task is runnable but no worker is fit, silently skip it */
 		if (!w) {
 			list_push_tail(skipped_tasks, t);
@@ -3777,7 +3779,7 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 		switch (result) {
 		case VINE_SUCCESS:
 			committed_tasks++;
-			t->time_spent_on_scheduling = timestamp_get() - time_when_scheduling_start;
+			t->time_spent_on_scheduling = time_when_scheduling_end - time_when_scheduling_start;
 			break;
 		case VINE_APP_FAILURE:
 		case VINE_WORKER_FAILURE:
diff --git a/taskvine/src/manager/vine_manager_put.c b/taskvine/src/manager/vine_manager_put.c
index 9076124698..d25223b74d 100644
--- a/taskvine/src/manager/vine_manager_put.c
+++ b/taskvine/src/manager/vine_manager_put.c
@@ -476,7 +476,7 @@ It does not perform any resource management.
 This allows it to be used for both regular tasks and mini tasks.
 */
 
-vine_result_code_t vine_manager_put_task(
+vine_result_code_t vine_manager_put_task_old(
 		struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t, const char *command_line, struct rmsummary *limits, struct vine_file *target)
 {
 	if (target) {
@@ -590,3 +590,372 @@ vine_result_code_t vine_manager_put_task(
 		return VINE_WORKER_FAILURE;
 	}
 }
+
+/*
+ * Extreme-optimized implementation of vine_manager_put_task()
+ *
+ * Key ideas:
+ *  - Build the entire task definition (header + command payload + tail)
+ *    in one contiguous growable buffer.
+ *  - Send the full buffer in one (or very few) link_putlstring() calls.
+ *  - No nested functions, no temp stack buffers, no redundant syscalls.
+ *  - Protocol and API remain fully backward compatible.
+ *  - Achieves order-of-magnitude throughput improvement for short tasks.
+ */
+
+ #include <stdarg.h>
+ #include <stdio.h>
+ #include <stdlib.h>
+ #include <string.h>
+ #include <time.h>
+ #include <inttypes.h>
+ 
+ /* ---------------------------------------------------------------------- */
+ /* Small dynamic buffer utility (local to this file)                      */
+ /* ---------------------------------------------------------------------- */
+ 
+ struct sbuf {
+	 char  *buf;
+	 size_t len;
+	 size_t cap;
+ };
+ 
+ #define SB_INIT_CAP   4096
+ #define SB_MAX_CHUNK  (1024 * 1024)   /* 1 MB max per write */
+ 
+ /* Reserve space for additional bytes. Grows buffer exponentially. */
+ #define SB_RESERVE(B, NEED) do { \
+	 size_t need = (B).len + (size_t)(NEED) + 1; \
+	 if (need > (B).cap) { \
+		 size_t cap = (B).cap ? (B).cap : SB_INIT_CAP; \
+		 while (cap < need) cap <<= 1; \
+		 char *nb = (char*)realloc((B).buf, cap); \
+		 if (!nb) { free((B).buf); return VINE_WORKER_FAILURE; } \
+		 (B).buf = nb; (B).cap = cap; \
+	 } \
+ } while (0)
+ 
+ /* Append formatted text directly into buffer. */
+ static inline int sb_vprintf(struct sbuf *B, const char *fmt, va_list ap0)
+ {
+	 va_list ap;
+	 va_copy(ap, ap0);
+ 
+	 size_t avail = (B->cap > B->len) ? (B->cap - B->len) : 0;
+	 if (avail < 64) { SB_RESERVE((*B), 64); avail = B->cap - B->len; }
+ 
+	 int n = vsnprintf(B->buf + B->len, avail, fmt, ap);
+	 va_end(ap);
+	 if (n < 0) return -1;
+ 
+	 /* If output was truncated, expand and retry */
+	 if ((size_t)n >= avail) {
+		 SB_RESERVE((*B), (size_t)n);
+		 va_copy(ap, ap0);
+		 n = vsnprintf(B->buf + B->len, B->cap - B->len, fmt, ap);
+		 va_end(ap);
+		 if (n < 0) return -1;
+	 }
+ 
+	 B->len += (size_t)n;
+	 return n;
+ }
+ 
+ /* Append formatted string. */
+ static inline int sb_printf(struct sbuf *B, const char *fmt, ...)
+ {
+	 va_list ap; va_start(ap, fmt);
+	 int n = sb_vprintf(B, fmt, ap);
+	 va_end(ap);
+	 return n;
+ }
+ 
+ /* Append raw bytes. */
+ static inline int sb_append(struct sbuf *B, const void *p, size_t n)
+ {
+	 SB_RESERVE((*B), n);
+	 memcpy(B->buf + B->len, p, n);
+	 B->len += n;
+	 B->buf[B->len] = '\0';
+	 return 0;
+ }
+ 
+ /* ---------------------------------------------------------------------- */
+ /* Main function: vine_manager_put_task()                                 */
+ /* ---------------------------------------------------------------------- */
+ 
+ vine_result_code_t vine_manager_put_task_old2(
+	 struct vine_manager *q, struct vine_worker_info *w,
+	 struct vine_task *t, const char *command_line,
+	 struct rmsummary *limits, struct vine_file *target)
+ {
+	 /* Check if target already exists on worker */
+	 if (target && vine_file_replica_table_lookup(w, target->cached_name)) {
+		 debug(D_NOTICE, "mini_task %s already at %s", target->cached_name, w->addrport);
+		 return VINE_SUCCESS;
+	 }
+ 
+	 /* Send input files first (unchanged path) */
+	 vine_result_code_t result = vine_manager_put_input_files(q, w, t);
+	 if (result != VINE_SUCCESS)
+		 return result;
+ 
+	 if (!command_line)
+		 command_line = t->command_line;
+	 const long long cmd_len = (long long)strlen(command_line);
+ 
+	 struct sbuf sb = {0};
+ 
+	 /* -------- Header: task/mini_task + cmd length -------- */
+	 if (target) {
+		 int mode = target->mode ? target->mode : 0755;
+		 sb_printf(&sb, "mini_task %s %s %d %lld 0%o\n",
+				   target->source, target->cached_name,
+				   target->cache_level, (long long)target->size, mode);
+	 } else {
+		 sb_printf(&sb, "task %lld\n", (long long)t->task_id);
+	 }
+	 sb_printf(&sb, "cmd %lld\n", cmd_len);
+ 
+	 /* -------- Append command payload directly -------- */
+	 sb_append(&sb, command_line, (size_t)cmd_len);
+	 sb_printf(&sb, "\n");
+ 
+	 /* -------- Tail: metadata, env, mounts, etc. -------- */
+	 if (t->needs_library)
+		 sb_printf(&sb, "needs_library %s\n", t->needs_library);
+ 
+	 if (t->provides_library) {
+		 sb_printf(&sb, "provides_library %s\n", t->provides_library);
+		 sb_printf(&sb, "function_slots %d\n", t->function_slots_total);
+		 sb_printf(&sb, "func_exec_mode %d\n", t->func_exec_mode);
+	 }
+ 
+	 sb_printf(&sb, "category %s\n", t->category);
+ 
+	 if (limits) {
+		 sb_printf(&sb, "cores %s\n",  rmsummary_resource_to_str("cores",  limits->cores,  0));
+		 sb_printf(&sb, "gpus %s\n",   rmsummary_resource_to_str("gpus",   limits->gpus,   0));
+		 sb_printf(&sb, "memory %s\n", rmsummary_resource_to_str("memory", limits->memory, 0));
+		 sb_printf(&sb, "disk %s\n",   rmsummary_resource_to_str("disk",   limits->disk,   0));
+ 
+		 if (q->monitor_mode == VINE_MON_DISABLED) {
+			 if (limits->end > 0)
+				 sb_printf(&sb, "end_time %s\n", rmsummary_resource_to_str("end", limits->end, 0));
+			 if (limits->wall_time > 0)
+				 sb_printf(&sb, "wall_time %s\n", rmsummary_resource_to_str("wall_time", limits->wall_time, 0));
+		 }
+	 }
+ 
+	 char *var;
+	 LIST_ITERATE(t->env_list, var) {
+		 size_t L = strlen(var);
+		 sb_printf(&sb, "env %zu\n", L);
+		 sb_append(&sb, var, L);
+		 sb_printf(&sb, "\n");
+	 }
+ 
+	 if (t->input_mounts) {
+		 struct vine_mount *m;
+		 LIST_ITERATE(t->input_mounts, m) {
+			 char enc[PATH_MAX];
+			 url_encode(m->remote_name, enc, PATH_MAX);
+			 sb_printf(&sb, "infile %s %s %d\n", m->file->cached_name, enc, m->flags);
+		 }
+	 }
+ 
+	 if (t->output_mounts) {
+		 struct vine_mount *m;
+		 LIST_ITERATE(t->output_mounts, m) {
+			 char enc[PATH_MAX];
+			 url_encode(m->remote_name, enc, PATH_MAX);
+			 sb_printf(&sb, "outfile %s %s %d\n", m->file->cached_name, enc, m->flags);
+		 }
+	 }
+ 
+	 if (t->group_id)
+		 sb_printf(&sb, "groupid %d\n", t->group_id);
+ 
+	 sb_printf(&sb, "end\n");
+ 
+	 // debug(D_VINE, "sending task %lld (%zu bytes)\n", (long long)t->task_id, sb.len);
+ 
+	 /* -------- Send in one or very few chunks -------- */
+	 const char *p = sb.buf;
+	 size_t left = sb.len;
+	 time_t deadline = time(0) + q->short_timeout;
+	 int r = 0;
+ 
+	 while (left > 0) {
+		 size_t chunk = left > SB_MAX_CHUNK ? SB_MAX_CHUNK : left;
+		 r = link_putlstring(w->link, p, chunk, deadline);
+		 if (r < 0)
+			 break;
+		 p += chunk;
+		 left -= chunk;
+	 }
+ 
+	 /* Finalize and cleanup */
+	 if (r >= 0 && left == 0) {
+		 if (target)
+			 vine_file_replica_table_get_or_create(q, w, target->cached_name,
+				 target->type, target->cache_level, target->size, target->mtime);
+		 free(sb.buf);
+		 return VINE_SUCCESS;
+	 } else {
+		 free(sb.buf);
+		 return VINE_WORKER_FAILURE;
+	 }
+ 
+	 #undef SB_RESERVE
+ }
+ 
+
+ vine_result_code_t vine_manager_put_task(
+    struct vine_manager *q, struct vine_worker_info *w,
+    struct vine_task *t, const char *command_line,
+    struct rmsummary *limits, struct vine_file *target)
+{
+    /* If target already on worker */
+    if (target && vine_file_replica_table_lookup(w, target->cached_name)) {
+        debug(D_NOTICE, "mini_task %s already at %s", target->cached_name, w->addrport);
+        return VINE_SUCCESS;
+    }
+
+    /* Send input files first */
+    vine_result_code_t result = vine_manager_put_input_files(q, w, t);
+    if (result != VINE_SUCCESS) return result;
+
+    if (!command_line) command_line = t->command_line;
+    const long long cmd_len = (long long)strlen(command_line);
+
+    struct sbuf sb = {0};
+
+    /* helper: exact same debug prefix format as vine_manager_send() */
+    auto void dbg_tx(struct vine_worker_info *ww, const char *s, size_t n) {
+        if (!s || n == 0) return;
+        debug(D_VINE, "tx to %s (%s): %.*s", ww->hostname, ww->addrport, (int)n, s);
+    }
+
+    /* helper: format one logical line, append to sb, and debug it */
+    #ifndef VINE_LINE_MAX
+    #define VINE_LINE_MAX 65536
+    #endif
+    auto void emitf(const char *fmt, ...) {
+        char line[VINE_LINE_MAX];
+        va_list ap;
+        va_start(ap, fmt);
+        int n = vsnprintf(line, sizeof(line), fmt, ap);
+        va_end(ap);
+        if (n < 0) n = 0;
+        size_t len = (size_t)n;
+        if (len >= sizeof(line)) len = sizeof(line) - 1; /* truncate for debug parity safety */
+        sb_printf(&sb, "%.*s", (int)len, line);
+        dbg_tx(w, line, len);
+    }
+
+    /* Header */
+    if (target) {
+        int mode = target->mode ? target->mode : 0755;
+        emitf("mini_task %s %s %d %lld 0%o\n",
+              target->source, target->cached_name,
+              target->cache_level, (long long)target->size, mode);
+    } else {
+        emitf("task %lld\n", (long long)t->task_id);
+    }
+
+    /* cmd header + payload */
+    emitf("cmd %lld\n", cmd_len);
+    sb_append(&sb, command_line, (size_t)cmd_len);
+    dbg_tx(w, command_line, (size_t)cmd_len);
+    emitf("\n");
+
+    /* extras */
+    if (t->needs_library) {
+        emitf("needs_library %s\n", t->needs_library);
+    }
+
+    if (t->provides_library) {
+        emitf("provides_library %s\n", t->provides_library);
+        emitf("function_slots %d\n", t->function_slots_total);
+        emitf("func_exec_mode %d\n", t->func_exec_mode);
+    }
+
+    emitf("category %s\n", t->category);
+
+    if (limits) {
+        emitf("cores %s\n",  rmsummary_resource_to_str("cores",  limits->cores,  0));
+        emitf("gpus %s\n",   rmsummary_resource_to_str("gpus",   limits->gpus,   0));
+        emitf("memory %s\n", rmsummary_resource_to_str("memory", limits->memory, 0));
+        emitf("disk %s\n",   rmsummary_resource_to_str("disk",   limits->disk,   0));
+
+        if (q->monitor_mode == VINE_MON_DISABLED) {
+            if (limits->end > 0)
+                emitf("end_time %s\n", rmsummary_resource_to_str("end", limits->end, 0));
+            if (limits->wall_time > 0)
+                emitf("wall_time %s\n", rmsummary_resource_to_str("wall_time", limits->wall_time, 0));
+        }
+    }
+
+    /* env list */
+    char *var;
+    LIST_ITERATE(t->env_list, var) {
+        size_t L = strlen(var);
+        emitf("env %zu\n", L);
+        sb_append(&sb, var, L);
+        dbg_tx(w, var, L);
+        emitf("\n");
+    }
+
+    /* infile mounts */
+    if (t->input_mounts) {
+        struct vine_mount *m;
+        LIST_ITERATE(t->input_mounts, m) {
+            char enc[PATH_MAX];
+            url_encode(m->remote_name, enc, PATH_MAX);
+            emitf("infile %s %s %d\n", m->file->cached_name, enc, m->flags);
+        }
+    }
+
+    /* outfile mounts */
+    if (t->output_mounts) {
+        struct vine_mount *m;
+        LIST_ITERATE(t->output_mounts, m) {
+            char enc[PATH_MAX];
+            url_encode(m->remote_name, enc, PATH_MAX);
+            emitf("outfile %s %s %d\n", m->file->cached_name, enc, m->flags);
+        }
+    }
+
+    if (t->group_id) {
+        emitf("groupid %d\n", t->group_id);
+    }
+
+    emitf("end\n");
+
+    /* Send in chunks (no extra debug here to avoid duplicate logs) */
+    const char *p = sb.buf;
+    size_t left = sb.len;
+    time_t deadline = time(0) + q->short_timeout;
+    int r = 0;
+
+    while (left > 0) {
+        size_t chunk = left > SB_MAX_CHUNK ? SB_MAX_CHUNK : left;
+        r = link_putlstring(w->link, p, chunk, deadline);
+        if (r < 0) break;
+        p += chunk;
+        left -= chunk;
+    }
+
+    if (r >= 0 && left == 0) {
+        if (target) {
+            vine_file_replica_table_get_or_create(q, w, target->cached_name,
+                target->type, target->cache_level, target->size, target->mtime);
+        }
+        free(sb.buf);
+        return VINE_SUCCESS;
+    } else {
+        free(sb.buf);
+        return VINE_WORKER_FAILURE;
+    }
+}

From a9b95b20cedbb7e7e1952aa93255855d584077eb Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 29 Oct 2025 12:17:03 -0400
Subject: [PATCH 062/113] optimized put

---
 taskvine/src/manager/vine_manager_put.c | 606 ++++++++++--------------
 1 file changed, 252 insertions(+), 354 deletions(-)

diff --git a/taskvine/src/manager/vine_manager_put.c b/taskvine/src/manager/vine_manager_put.c
index d25223b74d..0b95d62c31 100644
--- a/taskvine/src/manager/vine_manager_put.c
+++ b/taskvine/src/manager/vine_manager_put.c
@@ -603,359 +603,257 @@ vine_result_code_t vine_manager_put_task_old(
  *  - Achieves order-of-magnitude throughput improvement for short tasks.
  */
 
- #include <stdarg.h>
- #include <stdio.h>
- #include <stdlib.h>
- #include <string.h>
- #include <time.h>
- #include <inttypes.h>
- 
- /* ---------------------------------------------------------------------- */
- /* Small dynamic buffer utility (local to this file)                      */
- /* ---------------------------------------------------------------------- */
- 
- struct sbuf {
-	 char  *buf;
-	 size_t len;
-	 size_t cap;
- };
- 
- #define SB_INIT_CAP   4096
- #define SB_MAX_CHUNK  (1024 * 1024)   /* 1 MB max per write */
- 
- /* Reserve space for additional bytes. Grows buffer exponentially. */
- #define SB_RESERVE(B, NEED) do { \
-	 size_t need = (B).len + (size_t)(NEED) + 1; \
-	 if (need > (B).cap) { \
-		 size_t cap = (B).cap ? (B).cap : SB_INIT_CAP; \
-		 while (cap < need) cap <<= 1; \
-		 char *nb = (char*)realloc((B).buf, cap); \
-		 if (!nb) { free((B).buf); return VINE_WORKER_FAILURE; } \
-		 (B).buf = nb; (B).cap = cap; \
-	 } \
- } while (0)
- 
- /* Append formatted text directly into buffer. */
- static inline int sb_vprintf(struct sbuf *B, const char *fmt, va_list ap0)
- {
-	 va_list ap;
-	 va_copy(ap, ap0);
- 
-	 size_t avail = (B->cap > B->len) ? (B->cap - B->len) : 0;
-	 if (avail < 64) { SB_RESERVE((*B), 64); avail = B->cap - B->len; }
- 
-	 int n = vsnprintf(B->buf + B->len, avail, fmt, ap);
-	 va_end(ap);
-	 if (n < 0) return -1;
- 
-	 /* If output was truncated, expand and retry */
-	 if ((size_t)n >= avail) {
-		 SB_RESERVE((*B), (size_t)n);
-		 va_copy(ap, ap0);
-		 n = vsnprintf(B->buf + B->len, B->cap - B->len, fmt, ap);
-		 va_end(ap);
-		 if (n < 0) return -1;
-	 }
- 
-	 B->len += (size_t)n;
-	 return n;
- }
- 
- /* Append formatted string. */
- static inline int sb_printf(struct sbuf *B, const char *fmt, ...)
- {
-	 va_list ap; va_start(ap, fmt);
-	 int n = sb_vprintf(B, fmt, ap);
-	 va_end(ap);
-	 return n;
- }
- 
- /* Append raw bytes. */
- static inline int sb_append(struct sbuf *B, const void *p, size_t n)
- {
-	 SB_RESERVE((*B), n);
-	 memcpy(B->buf + B->len, p, n);
-	 B->len += n;
-	 B->buf[B->len] = '\0';
-	 return 0;
- }
- 
- /* ---------------------------------------------------------------------- */
- /* Main function: vine_manager_put_task()                                 */
- /* ---------------------------------------------------------------------- */
- 
- vine_result_code_t vine_manager_put_task_old2(
-	 struct vine_manager *q, struct vine_worker_info *w,
-	 struct vine_task *t, const char *command_line,
-	 struct rmsummary *limits, struct vine_file *target)
- {
-	 /* Check if target already exists on worker */
-	 if (target && vine_file_replica_table_lookup(w, target->cached_name)) {
-		 debug(D_NOTICE, "mini_task %s already at %s", target->cached_name, w->addrport);
-		 return VINE_SUCCESS;
-	 }
- 
-	 /* Send input files first (unchanged path) */
-	 vine_result_code_t result = vine_manager_put_input_files(q, w, t);
-	 if (result != VINE_SUCCESS)
-		 return result;
- 
-	 if (!command_line)
-		 command_line = t->command_line;
-	 const long long cmd_len = (long long)strlen(command_line);
- 
-	 struct sbuf sb = {0};
- 
-	 /* -------- Header: task/mini_task + cmd length -------- */
-	 if (target) {
-		 int mode = target->mode ? target->mode : 0755;
-		 sb_printf(&sb, "mini_task %s %s %d %lld 0%o\n",
-				   target->source, target->cached_name,
-				   target->cache_level, (long long)target->size, mode);
-	 } else {
-		 sb_printf(&sb, "task %lld\n", (long long)t->task_id);
-	 }
-	 sb_printf(&sb, "cmd %lld\n", cmd_len);
- 
-	 /* -------- Append command payload directly -------- */
-	 sb_append(&sb, command_line, (size_t)cmd_len);
-	 sb_printf(&sb, "\n");
- 
-	 /* -------- Tail: metadata, env, mounts, etc. -------- */
-	 if (t->needs_library)
-		 sb_printf(&sb, "needs_library %s\n", t->needs_library);
- 
-	 if (t->provides_library) {
-		 sb_printf(&sb, "provides_library %s\n", t->provides_library);
-		 sb_printf(&sb, "function_slots %d\n", t->function_slots_total);
-		 sb_printf(&sb, "func_exec_mode %d\n", t->func_exec_mode);
-	 }
- 
-	 sb_printf(&sb, "category %s\n", t->category);
- 
-	 if (limits) {
-		 sb_printf(&sb, "cores %s\n",  rmsummary_resource_to_str("cores",  limits->cores,  0));
-		 sb_printf(&sb, "gpus %s\n",   rmsummary_resource_to_str("gpus",   limits->gpus,   0));
-		 sb_printf(&sb, "memory %s\n", rmsummary_resource_to_str("memory", limits->memory, 0));
-		 sb_printf(&sb, "disk %s\n",   rmsummary_resource_to_str("disk",   limits->disk,   0));
- 
-		 if (q->monitor_mode == VINE_MON_DISABLED) {
-			 if (limits->end > 0)
-				 sb_printf(&sb, "end_time %s\n", rmsummary_resource_to_str("end", limits->end, 0));
-			 if (limits->wall_time > 0)
-				 sb_printf(&sb, "wall_time %s\n", rmsummary_resource_to_str("wall_time", limits->wall_time, 0));
-		 }
-	 }
- 
-	 char *var;
-	 LIST_ITERATE(t->env_list, var) {
-		 size_t L = strlen(var);
-		 sb_printf(&sb, "env %zu\n", L);
-		 sb_append(&sb, var, L);
-		 sb_printf(&sb, "\n");
-	 }
- 
-	 if (t->input_mounts) {
-		 struct vine_mount *m;
-		 LIST_ITERATE(t->input_mounts, m) {
-			 char enc[PATH_MAX];
-			 url_encode(m->remote_name, enc, PATH_MAX);
-			 sb_printf(&sb, "infile %s %s %d\n", m->file->cached_name, enc, m->flags);
-		 }
-	 }
- 
-	 if (t->output_mounts) {
-		 struct vine_mount *m;
-		 LIST_ITERATE(t->output_mounts, m) {
-			 char enc[PATH_MAX];
-			 url_encode(m->remote_name, enc, PATH_MAX);
-			 sb_printf(&sb, "outfile %s %s %d\n", m->file->cached_name, enc, m->flags);
-		 }
-	 }
- 
-	 if (t->group_id)
-		 sb_printf(&sb, "groupid %d\n", t->group_id);
- 
-	 sb_printf(&sb, "end\n");
- 
-	 // debug(D_VINE, "sending task %lld (%zu bytes)\n", (long long)t->task_id, sb.len);
- 
-	 /* -------- Send in one or very few chunks -------- */
-	 const char *p = sb.buf;
-	 size_t left = sb.len;
-	 time_t deadline = time(0) + q->short_timeout;
-	 int r = 0;
- 
-	 while (left > 0) {
-		 size_t chunk = left > SB_MAX_CHUNK ? SB_MAX_CHUNK : left;
-		 r = link_putlstring(w->link, p, chunk, deadline);
-		 if (r < 0)
-			 break;
-		 p += chunk;
-		 left -= chunk;
-	 }
- 
-	 /* Finalize and cleanup */
-	 if (r >= 0 && left == 0) {
-		 if (target)
-			 vine_file_replica_table_get_or_create(q, w, target->cached_name,
-				 target->type, target->cache_level, target->size, target->mtime);
-		 free(sb.buf);
-		 return VINE_SUCCESS;
-	 } else {
-		 free(sb.buf);
-		 return VINE_WORKER_FAILURE;
-	 }
- 
-	 #undef SB_RESERVE
- }
- 
-
- vine_result_code_t vine_manager_put_task(
-    struct vine_manager *q, struct vine_worker_info *w,
-    struct vine_task *t, const char *command_line,
-    struct rmsummary *limits, struct vine_file *target)
+#include <stdarg.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include <inttypes.h>
+
+/* ---------------------------------------------------------------------- */
+/* Small dynamic buffer utility (local to this file)                      */
+/* ---------------------------------------------------------------------- */
+
+struct sbuf {
+	char *buf;
+	size_t len;
+	size_t cap;
+};
+
+#define SB_INIT_CAP 4096
+#define SB_MAX_CHUNK (1024 * 1024) /* 1 MB max per write */
+
+/* Reserve space for additional bytes. Grows buffer exponentially. */
+#define SB_RESERVE(B, NEED) \
+	do { \
+		size_t need = (B).len + (size_t)(NEED) + 1; \
+		if (need > (B).cap) { \
+			size_t cap = (B).cap ? (B).cap : SB_INIT_CAP; \
+			while (cap < need) \
+				cap <<= 1; \
+			char *nb = (char *)realloc((B).buf, cap); \
+			if (!nb) { \
+				free((B).buf); \
+				return VINE_WORKER_FAILURE; \
+			} \
+			(B).buf = nb; \
+			(B).cap = cap; \
+		} \
+	} while (0)
+
+/* Append formatted text directly into buffer. */
+static inline int sb_vprintf(struct sbuf *B, const char *fmt, va_list ap0)
 {
-    /* If target already on worker */
-    if (target && vine_file_replica_table_lookup(w, target->cached_name)) {
-        debug(D_NOTICE, "mini_task %s already at %s", target->cached_name, w->addrport);
-        return VINE_SUCCESS;
-    }
-
-    /* Send input files first */
-    vine_result_code_t result = vine_manager_put_input_files(q, w, t);
-    if (result != VINE_SUCCESS) return result;
-
-    if (!command_line) command_line = t->command_line;
-    const long long cmd_len = (long long)strlen(command_line);
-
-    struct sbuf sb = {0};
-
-    /* helper: exact same debug prefix format as vine_manager_send() */
-    auto void dbg_tx(struct vine_worker_info *ww, const char *s, size_t n) {
-        if (!s || n == 0) return;
-        debug(D_VINE, "tx to %s (%s): %.*s", ww->hostname, ww->addrport, (int)n, s);
-    }
-
-    /* helper: format one logical line, append to sb, and debug it */
-    #ifndef VINE_LINE_MAX
-    #define VINE_LINE_MAX 65536
-    #endif
-    auto void emitf(const char *fmt, ...) {
-        char line[VINE_LINE_MAX];
-        va_list ap;
-        va_start(ap, fmt);
-        int n = vsnprintf(line, sizeof(line), fmt, ap);
-        va_end(ap);
-        if (n < 0) n = 0;
-        size_t len = (size_t)n;
-        if (len >= sizeof(line)) len = sizeof(line) - 1; /* truncate for debug parity safety */
-        sb_printf(&sb, "%.*s", (int)len, line);
-        dbg_tx(w, line, len);
-    }
-
-    /* Header */
-    if (target) {
-        int mode = target->mode ? target->mode : 0755;
-        emitf("mini_task %s %s %d %lld 0%o\n",
-              target->source, target->cached_name,
-              target->cache_level, (long long)target->size, mode);
-    } else {
-        emitf("task %lld\n", (long long)t->task_id);
-    }
-
-    /* cmd header + payload */
-    emitf("cmd %lld\n", cmd_len);
-    sb_append(&sb, command_line, (size_t)cmd_len);
-    dbg_tx(w, command_line, (size_t)cmd_len);
-    emitf("\n");
-
-    /* extras */
-    if (t->needs_library) {
-        emitf("needs_library %s\n", t->needs_library);
-    }
-
-    if (t->provides_library) {
-        emitf("provides_library %s\n", t->provides_library);
-        emitf("function_slots %d\n", t->function_slots_total);
-        emitf("func_exec_mode %d\n", t->func_exec_mode);
-    }
-
-    emitf("category %s\n", t->category);
-
-    if (limits) {
-        emitf("cores %s\n",  rmsummary_resource_to_str("cores",  limits->cores,  0));
-        emitf("gpus %s\n",   rmsummary_resource_to_str("gpus",   limits->gpus,   0));
-        emitf("memory %s\n", rmsummary_resource_to_str("memory", limits->memory, 0));
-        emitf("disk %s\n",   rmsummary_resource_to_str("disk",   limits->disk,   0));
-
-        if (q->monitor_mode == VINE_MON_DISABLED) {
-            if (limits->end > 0)
-                emitf("end_time %s\n", rmsummary_resource_to_str("end", limits->end, 0));
-            if (limits->wall_time > 0)
-                emitf("wall_time %s\n", rmsummary_resource_to_str("wall_time", limits->wall_time, 0));
-        }
-    }
-
-    /* env list */
-    char *var;
-    LIST_ITERATE(t->env_list, var) {
-        size_t L = strlen(var);
-        emitf("env %zu\n", L);
-        sb_append(&sb, var, L);
-        dbg_tx(w, var, L);
-        emitf("\n");
-    }
-
-    /* infile mounts */
-    if (t->input_mounts) {
-        struct vine_mount *m;
-        LIST_ITERATE(t->input_mounts, m) {
-            char enc[PATH_MAX];
-            url_encode(m->remote_name, enc, PATH_MAX);
-            emitf("infile %s %s %d\n", m->file->cached_name, enc, m->flags);
-        }
-    }
-
-    /* outfile mounts */
-    if (t->output_mounts) {
-        struct vine_mount *m;
-        LIST_ITERATE(t->output_mounts, m) {
-            char enc[PATH_MAX];
-            url_encode(m->remote_name, enc, PATH_MAX);
-            emitf("outfile %s %s %d\n", m->file->cached_name, enc, m->flags);
-        }
-    }
-
-    if (t->group_id) {
-        emitf("groupid %d\n", t->group_id);
-    }
-
-    emitf("end\n");
-
-    /* Send in chunks (no extra debug here to avoid duplicate logs) */
-    const char *p = sb.buf;
-    size_t left = sb.len;
-    time_t deadline = time(0) + q->short_timeout;
-    int r = 0;
-
-    while (left > 0) {
-        size_t chunk = left > SB_MAX_CHUNK ? SB_MAX_CHUNK : left;
-        r = link_putlstring(w->link, p, chunk, deadline);
-        if (r < 0) break;
-        p += chunk;
-        left -= chunk;
-    }
-
-    if (r >= 0 && left == 0) {
-        if (target) {
-            vine_file_replica_table_get_or_create(q, w, target->cached_name,
-                target->type, target->cache_level, target->size, target->mtime);
-        }
-        free(sb.buf);
-        return VINE_SUCCESS;
-    } else {
-        free(sb.buf);
-        return VINE_WORKER_FAILURE;
-    }
+	va_list ap;
+	va_copy(ap, ap0);
+
+	size_t avail = (B->cap > B->len) ? (B->cap - B->len) : 0;
+	if (avail < 64) {
+		SB_RESERVE((*B), 64);
+		avail = B->cap - B->len;
+	}
+
+	int n = vsnprintf(B->buf + B->len, avail, fmt, ap);
+	va_end(ap);
+	if (n < 0)
+		return -1;
+
+	/* If output was truncated, expand and retry */
+	if ((size_t)n >= avail) {
+		SB_RESERVE((*B), (size_t)n);
+		va_copy(ap, ap0);
+		n = vsnprintf(B->buf + B->len, B->cap - B->len, fmt, ap);
+		va_end(ap);
+		if (n < 0)
+			return -1;
+	}
+
+	B->len += (size_t)n;
+	return n;
+}
+
+/* Append formatted string. */
+static inline int sb_printf(struct sbuf *B, const char *fmt, ...)
+{
+	va_list ap;
+	va_start(ap, fmt);
+	int n = sb_vprintf(B, fmt, ap);
+	va_end(ap);
+	return n;
+}
+
+/* Append raw bytes. */
+static inline int sb_append(struct sbuf *B, const void *p, size_t n)
+{
+	SB_RESERVE((*B), n);
+	memcpy(B->buf + B->len, p, n);
+	B->len += n;
+	B->buf[B->len] = '\0';
+	return 0;
+}
+
+/* ---------------------------------------------------------------------- */
+/* Main function: vine_manager_put_task()                                 */
+/* ---------------------------------------------------------------------- */
+
+vine_result_code_t vine_manager_put_task(
+		struct vine_manager *q, struct vine_worker_info *w,
+		struct vine_task *t, const char *command_line,
+		struct rmsummary *limits, struct vine_file *target)
+{
+	/* If target already on worker */
+	if (target && vine_file_replica_table_lookup(w, target->cached_name)) {
+		debug(D_NOTICE, "mini_task %s already at %s", target->cached_name, w->addrport);
+		return VINE_SUCCESS;
+	}
+
+	/* Send input files first */
+	vine_result_code_t result = vine_manager_put_input_files(q, w, t);
+	if (result != VINE_SUCCESS)
+		return result;
+
+	if (!command_line)
+		command_line = t->command_line;
+	const long long cmd_len = (long long)strlen(command_line);
+
+	struct sbuf sb = {0};
+
+	/* helper: exact same debug prefix format as vine_manager_send() */
+	auto void dbg_tx(struct vine_worker_info * ww, const char *s, size_t n)
+	{
+		if (!s || n == 0)
+			return;
+		debug(D_VINE, "tx to %s (%s): %.*s", ww->hostname, ww->addrport, (int)n, s);
+	}
+
+/* helper: format one logical line, append to sb, and debug it */
+#ifndef VINE_LINE_MAX
+#define VINE_LINE_MAX 65536
+#endif
+	auto void emitf(const char *fmt, ...)
+	{
+		char line[VINE_LINE_MAX];
+		va_list ap;
+		va_start(ap, fmt);
+		int n = vsnprintf(line, sizeof(line), fmt, ap);
+		va_end(ap);
+		if (n < 0)
+			n = 0;
+		size_t len = (size_t)n;
+		if (len >= sizeof(line))
+			len = sizeof(line) - 1; /* truncate for debug parity safety */
+		sb_printf(&sb, "%.*s", (int)len, line);
+		dbg_tx(w, line, len);
+	}
+
+	/* Header */
+	if (target) {
+		int mode = target->mode ? target->mode : 0755;
+		emitf("mini_task %s %s %d %lld 0%o\n",
+				target->source,
+				target->cached_name,
+				target->cache_level,
+				(long long)target->size,
+				mode);
+	} else {
+		emitf("task %lld\n", (long long)t->task_id);
+	}
+
+	/* cmd header + payload */
+	emitf("cmd %lld\n", cmd_len);
+	sb_append(&sb, command_line, (size_t)cmd_len);
+	dbg_tx(w, command_line, (size_t)cmd_len);
+	emitf("\n");
+
+	/* extras */
+	if (t->needs_library) {
+		emitf("needs_library %s\n", t->needs_library);
+	}
+
+	if (t->provides_library) {
+		emitf("provides_library %s\n", t->provides_library);
+		emitf("function_slots %d\n", t->function_slots_total);
+		emitf("func_exec_mode %d\n", t->func_exec_mode);
+	}
+
+	emitf("category %s\n", t->category);
+
+	if (limits) {
+		emitf("cores %s\n", rmsummary_resource_to_str("cores", limits->cores, 0));
+		emitf("gpus %s\n", rmsummary_resource_to_str("gpus", limits->gpus, 0));
+		emitf("memory %s\n", rmsummary_resource_to_str("memory", limits->memory, 0));
+		emitf("disk %s\n", rmsummary_resource_to_str("disk", limits->disk, 0));
+
+		if (q->monitor_mode == VINE_MON_DISABLED) {
+			if (limits->end > 0)
+				emitf("end_time %s\n", rmsummary_resource_to_str("end", limits->end, 0));
+			if (limits->wall_time > 0)
+				emitf("wall_time %s\n", rmsummary_resource_to_str("wall_time", limits->wall_time, 0));
+		}
+	}
+
+	/* env list */
+	char *var;
+	LIST_ITERATE(t->env_list, var)
+	{
+		size_t L = strlen(var);
+		emitf("env %zu\n", L);
+		sb_append(&sb, var, L);
+		dbg_tx(w, var, L);
+		emitf("\n");
+	}
+
+	/* infile mounts */
+	if (t->input_mounts) {
+		struct vine_mount *m;
+		LIST_ITERATE(t->input_mounts, m)
+		{
+			char enc[PATH_MAX];
+			url_encode(m->remote_name, enc, PATH_MAX);
+			emitf("infile %s %s %d\n", m->file->cached_name, enc, m->flags);
+		}
+	}
+
+	/* outfile mounts */
+	if (t->output_mounts) {
+		struct vine_mount *m;
+		LIST_ITERATE(t->output_mounts, m)
+		{
+			char enc[PATH_MAX];
+			url_encode(m->remote_name, enc, PATH_MAX);
+			emitf("outfile %s %s %d\n", m->file->cached_name, enc, m->flags);
+		}
+	}
+
+	if (t->group_id) {
+		emitf("groupid %d\n", t->group_id);
+	}
+
+	emitf("end\n");
+
+	/* Send in chunks (no extra debug here to avoid duplicate logs) */
+	const char *p = sb.buf;
+	size_t left = sb.len;
+	time_t deadline = time(0) + q->short_timeout;
+	int r = 0;
+
+	while (left > 0) {
+		size_t chunk = left > SB_MAX_CHUNK ? SB_MAX_CHUNK : left;
+		r = link_putlstring(w->link, p, chunk, deadline);
+		if (r < 0)
+			break;
+		p += chunk;
+		left -= chunk;
+	}
+
+	if (r >= 0 && left == 0) {
+		if (target) {
+			vine_file_replica_table_get_or_create(q, w, target->cached_name, target->type, target->cache_level, target->size, target->mtime);
+		}
+		free(sb.buf);
+		return VINE_SUCCESS;
+	} else {
+		free(sb.buf);
+		return VINE_WORKER_FAILURE;
+	}
 }

From 363b5e7e85348b26ed92c444889fa384a1d46bb3 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 29 Oct 2025 12:17:15 -0400
Subject: [PATCH 063/113] lint

---
 taskvine/src/bindings/python3/ndcctools/taskvine/utils.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
index c11c5d5b0d..b54d9c7bf4 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/utils.py
@@ -37,4 +37,4 @@ def load_variable_from_library(var_name):
     return globals()[var_name]
 
 
-# vim: set sts=4 sw=4 ts=4 expandtab ft=python:
\ No newline at end of file
+# vim: set sts=4 sw=4 ts=4 expandtab ft=python:

From c7e9d658fd56588e4a0e3630577c16ad264afce0 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 29 Oct 2025 12:17:46 -0400
Subject: [PATCH 064/113] lint

---
 taskvine/src/graph/vinedag/vinedag.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/taskvine/src/graph/vinedag/vinedag.py b/taskvine/src/graph/vinedag/vinedag.py
index ce4a46511a..9ec10aefc3 100644
--- a/taskvine/src/graph/vinedag/vinedag.py
+++ b/taskvine/src/graph/vinedag/vinedag.py
@@ -11,7 +11,6 @@
 import os
 import signal
 import json
-import tqdm
 
 try:
     import dask

From 2faa0d1061e900197a0c70e0c76b514e1ce747a7 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 29 Oct 2025 12:19:33 -0400
Subject: [PATCH 065/113] time metrics

---
 .../vinedag/strategic_orchestration_graph.c     | 17 ++++++++---------
 .../vinedag/strategic_orchestration_graph.h     |  2 +-
 .../vinedag/strategic_orchestration_node.c      |  1 -
 .../vinedag/strategic_orchestration_node.h      |  1 -
 taskvine/src/manager/vine_manager.c             | 15 ++++++++++-----
 taskvine/src/manager/vine_task.c                | 16 +++++++++++++++-
 taskvine/src/manager/vine_task.h                |  8 ++++++--
 7 files changed, 40 insertions(+), 20 deletions(-)

diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
index 895502ef23..a790c8b39b 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
@@ -554,13 +554,13 @@ static void print_time_metrics(struct strategic_orchestration_graph *sog, const
 		debug(D_ERROR, "failed to open file %s", filename);
 		return;
 	}
-	fprintf(fp, "node_key,submission_time_us,scheduling_time_us,commit_time_us,execution_time_us,retrieval_time_us,pruning_time_us,postprocessing_time_us\n");
+	fprintf(fp, "node_key,submission_time_us,scheduling_time_us,commit_time_us,execution_time_us,retrieval_time_us,postprocessing_time_us\n");
 
 	char *node_key;
 	struct strategic_orchestration_node *node;
 	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
 	{
-		fprintf(fp, "%s,%lu,%lu,%lu,%lu,%lu,%lu,%lu\n", node_key, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->pruning_time, node->postprocessing_time);
+		fprintf(fp, "%s,%lu,%lu,%lu,%lu,%lu,%lu\n", node_key, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
 	}
 	fclose(fp);
 
@@ -649,9 +649,9 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		if (sog->time_metrics_filename) {
 			free(sog->time_metrics_filename);
 		}
-	
+
 		sog->time_metrics_filename = xxstrdup(value);
-	
+
 		/** Extract parent directory inline **/
 		const char *slash = strrchr(sog->time_metrics_filename, '/');
 		if (slash) {
@@ -659,7 +659,7 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 			char *parent = malloc(len + 1);
 			memcpy(parent, sog->time_metrics_filename, len);
 			parent[len] = '\0';
-	
+
 			/** Ensure the parent directory exists **/
 			if (mkdir(parent, 0777) != 0 && errno != EEXIST) {
 				debug(D_ERROR, "failed to mkdir %s (errno=%d)", parent, errno);
@@ -668,7 +668,7 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 			}
 			free(parent);
 		}
-	
+
 		/** Truncate or create the file **/
 		FILE *fp = fopen(sog->time_metrics_filename, "w");
 		if (!fp) {
@@ -1242,10 +1242,10 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 
 			/* mark the node as completed */
 			node->completed = 1;
-			node->scheduling_time = task->time_spent_on_scheduling;
+			node->scheduling_time = task->time_when_scheduling_end - task->time_when_scheduling_start;
 			node->commit_time = task->time_when_commit_end - task->time_when_commit_start;
 			node->execution_time = task->time_workers_execute_last;
-			node->retrieval_time = task->time_when_done - task->time_when_retrieval;
+			node->retrieval_time = task->time_when_get_result_end - task->time_when_get_result_start;
 
 			/* prune nodes on task completion */
 			prune_ancestors_of_node(sog, node);
@@ -1309,7 +1309,6 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
 		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
 		total_time_spent_on_prune_ancestors_of_persisted_node += node->time_spent_on_prune_ancestors_of_persisted_node;
-		node->pruning_time = node->time_spent_on_unlink_local_files + node->time_spent_on_prune_ancestors_of_temp_node + node->time_spent_on_prune_ancestors_of_persisted_node;
 	}
 	total_time_spent_on_unlink_local_files /= 1e6;
 	total_time_spent_on_prune_ancestors_of_temp_node /= 1e6;
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.h b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
index 0cbf29d0ef..65db266b20 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
@@ -54,7 +54,7 @@ struct strategic_orchestration_graph {
 	task_priority_mode_t task_priority_mode; /* priority mode for task graph task scheduling */
 	double failure_injection_step_percent;	 /* 0 - 100, the percentage of steps to inject failure */
 
-    double progress_bar_update_interval_sec; /* update interval for the progress bar in seconds */
+	double progress_bar_update_interval_sec; /* update interval for the progress bar in seconds */
 
 	/* The filename of the csv file to store the time metrics of the strategic orchestration graph. */
 	char *time_metrics_filename;
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.c b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
index 3735a92fd8..517e3333c4 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.c
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_node.c
@@ -158,7 +158,6 @@ struct strategic_orchestration_node *son_create(const char *node_key, int is_tar
 	node->commit_time = 0;
 	node->execution_time = 0;
 	node->retrieval_time = 0;
-	node->pruning_time = 0;
 	node->postprocessing_time = 0;
 
 	node->critical_path_time = -1;
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.h b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
index 6ca4ca1c99..eb1dcb4ad5 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.h
+++ b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
@@ -61,7 +61,6 @@ struct strategic_orchestration_node {
 	timestamp_t commit_time;
 	timestamp_t execution_time;
 	timestamp_t retrieval_time;
-	timestamp_t pruning_time;
 	timestamp_t postprocessing_time;
 
 	node_outfile_type_t outfile_type;
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 91495b1308..7dc74facaa 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -147,6 +147,7 @@ static vine_msg_code_t handle_manager_status(struct vine_manager *q, struct vine
 static vine_msg_code_t handle_resources(struct vine_manager *q, struct vine_worker_info *w, time_t stoptime);
 static vine_msg_code_t handle_feature(struct vine_manager *q, struct vine_worker_info *w, const char *line);
 static void handle_library_update(struct vine_manager *q, struct vine_worker_info *w, const char *line);
+static int receive_tasks_from_worker(struct vine_manager *q, struct vine_worker_info *w, int count_received_so_far);
 
 static struct jx *manager_to_jx(struct vine_manager *q);
 static struct jx *manager_lean_to_jx(struct vine_manager *q);
@@ -588,6 +589,8 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 		return VINE_SUCCESS;
 	}
 
+	t->time_when_get_result_start = timestamp_get();
+
 	if (task_status != VINE_RESULT_SUCCESS) {
 		w->last_failure_time = timestamp_get();
 		t->time_when_last_failure = w->last_failure_time;
@@ -675,6 +678,8 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 		}
 	}
 
+	t->time_when_get_result_end = timestamp_get();
+
 	return VINE_SUCCESS;
 }
 
@@ -687,6 +692,7 @@ static vine_msg_code_t handle_complete(struct vine_manager *q, struct vine_worke
 {
 	vine_result_code_t result = get_completion_result(q, w, line);
 	if (result == VINE_SUCCESS) {
+		receive_tasks_from_worker(q, w, 0);
 		return VINE_MSG_PROCESSED;
 	}
 	return VINE_MSG_NOT_PROCESSED;
@@ -3743,14 +3749,14 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 	struct vine_task *t;
 
 	while (tasks_considered < tasks_to_consider) {
-		timestamp_t time_when_scheduling_start = timestamp_get();
-
 		t = priority_queue_pop(q->ready_tasks);
 		if (!t) {
 			break;
 		}
 		tasks_considered++;
 
+		t->time_when_scheduling_start = timestamp_get();
+
 		/* this task is not runnable at all, put it back in the pending queue */
 		if (!consider_task(q, t)) {
 			list_push_tail(q->pending_tasks, t);
@@ -3760,8 +3766,8 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 		/* select a worker for the task */
 		struct vine_worker_info *w = vine_schedule_task_to_worker(q, t);
 
-		timestamp_t time_when_scheduling_end = timestamp_get();
-		
+		t->time_when_scheduling_end = timestamp_get();
+
 		/* task is runnable but no worker is fit, silently skip it */
 		if (!w) {
 			list_push_tail(skipped_tasks, t);
@@ -3779,7 +3785,6 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 		switch (result) {
 		case VINE_SUCCESS:
 			committed_tasks++;
-			t->time_spent_on_scheduling = time_when_scheduling_end - time_when_scheduling_start;
 			break;
 		case VINE_APP_FAILURE:
 		case VINE_WORKER_FAILURE:
diff --git a/taskvine/src/manager/vine_task.c b/taskvine/src/manager/vine_task.c
index cde256c47a..5c69187345 100644
--- a/taskvine/src/manager/vine_task.c
+++ b/taskvine/src/manager/vine_task.c
@@ -88,8 +88,15 @@ struct vine_task *vine_task_create(const char *command_line)
 
 void vine_task_clean(struct vine_task *t)
 {
+	t->time_when_scheduling_start = 0;
+	t->time_when_scheduling_end = 0;
+
 	t->time_when_commit_start = 0;
 	t->time_when_commit_end = 0;
+
+	t->time_when_get_result_start = 0;
+	t->time_when_get_result_end = 0;
+
 	t->time_when_retrieval = 0;
 	t->time_when_done = 0;
 
@@ -153,7 +160,14 @@ void vine_task_reset(struct vine_task *t)
 	t->time_workers_execute_exhaustion = 0;
 	t->time_workers_execute_failure = 0;
 
-	t->time_spent_on_scheduling = 0;
+	t->time_when_scheduling_start = 0;
+	t->time_when_scheduling_end = 0;
+
+	t->time_when_commit_start = 0;
+	t->time_when_commit_end = 0;
+
+	t->time_when_get_result_start = 0;
+	t->time_when_get_result_end = 0;
 
 	rmsummary_delete(t->resources_measured);
 	rmsummary_delete(t->resources_allocated);
diff --git a/taskvine/src/manager/vine_task.h b/taskvine/src/manager/vine_task.h
index d76d38e72b..4867e4f5a6 100644
--- a/taskvine/src/manager/vine_task.h
+++ b/taskvine/src/manager/vine_task.h
@@ -106,9 +106,15 @@ struct vine_task {
 	timestamp_t time_when_submitted;    /**< The time at which this task was added to the queue. */
 	timestamp_t time_when_done;         /**< The time at which the task is mark as retrieved, after transfering output files and other final processing. */
 
+	timestamp_t time_when_scheduling_start; /**< The time when the task starts to be considered for scheduling. */
+	timestamp_t time_when_scheduling_end;   /**< The time when the task is mapped to a worker and ready to be committed. */
+
 	timestamp_t time_when_commit_start; /**< The time when the task starts to be transfered to a worker. */
 	timestamp_t time_when_commit_end;   /**< The time when the task is completely transfered to a worker. */
 
+	timestamp_t time_when_get_result_start; /**< The time when the task starts to get the result from the worker. */
+	timestamp_t time_when_get_result_end;   /**< The time when the task gets the result from the worker. */
+
 	timestamp_t time_when_retrieval;    /**< The time when output files start to be transfered back to the manager. time_done - time_when_retrieval is the time taken to transfer output files. */
 
 	timestamp_t time_when_last_failure; /**< If larger than 0, the time at which the last task failure was detected. */
@@ -122,8 +128,6 @@ struct vine_task {
 	timestamp_t time_workers_execute_exhaustion;           /**< Accumulated time spent in attempts that exhausted resources. */
 	timestamp_t time_workers_execute_failure;              /**< Accumulated time for runs that terminated in worker failure/disconnection. */
 
-	timestamp_t time_spent_on_scheduling;                 /**< Time spent on scheduling the task, only consider the successful scheduling. */
-
 	int64_t bytes_received;                                /**< Number of bytes received since task has last started receiving input data. */
 	int64_t bytes_sent;                                    /**< Number of bytes sent since task has last started sending input data. */
 	int64_t bytes_transferred;                             /**< Number of bytes transferred since task has last started transferring input data. */

From fd06a2658eefa794f9d0999d0db2ee02ac9c3913 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Fri, 31 Oct 2025 23:59:17 -0400
Subject: [PATCH 066/113] new structure

---
 taskvine/src/graph/Makefile                   |   2 -
 taskvine/src/graph/vinedag/Makefile           |  90 +--
 taskvine/src/graph/vinedag/config.py          |   0
 .../src/graph/vinedag/context_graph/Makefile  |  31 +
 .../graph/vinedag/context_graph/__init__.py   |  18 +
 .../core.py}                                  | 151 ++--
 .../{ => context_graph}/proxy_functions.py    |  40 +-
 .../{ => context_graph}/proxy_library.py      |  11 +-
 .../vinedag/strategic_orchestration_graph.h   | 143 ----
 .../vinedag/strategic_orchestration_graph.py  |  33 -
 .../vinedag/strategic_orchestration_node.h    | 112 ---
 .../src/graph/vinedag/vine_graph/Makefile     |  90 +++
 .../src/graph/vinedag/vine_graph/__init__.py  |  14 +
 .../vine_graph.c}                             | 717 +++++++++---------
 .../src/graph/vinedag/vine_graph/vine_graph.h | 150 ++++
 .../vine_graph.i}                             |   6 +-
 .../vinedag/vine_graph/vine_graph_client.py   |  75 ++
 .../vine_node.c}                              | 109 ++-
 .../src/graph/vinedag/vine_graph/vine_node.h  | 115 +++
 taskvine/src/graph/vinedag/vinedag.py         | 173 +++--
 taskvine/src/manager/vine_manager.c           |   6 +
 taskvine/src/worker/vine_worker.c             |   2 +-
 22 files changed, 1108 insertions(+), 980 deletions(-)
 delete mode 100644 taskvine/src/graph/vinedag/config.py
 create mode 100644 taskvine/src/graph/vinedag/context_graph/Makefile
 create mode 100644 taskvine/src/graph/vinedag/context_graph/__init__.py
 rename taskvine/src/graph/vinedag/{runtime_execution_graph.py => context_graph/core.py} (58%)
 rename taskvine/src/graph/vinedag/{ => context_graph}/proxy_functions.py (70%)
 rename taskvine/src/graph/vinedag/{ => context_graph}/proxy_library.py (89%)
 delete mode 100644 taskvine/src/graph/vinedag/strategic_orchestration_graph.h
 delete mode 100644 taskvine/src/graph/vinedag/strategic_orchestration_graph.py
 delete mode 100644 taskvine/src/graph/vinedag/strategic_orchestration_node.h
 create mode 100644 taskvine/src/graph/vinedag/vine_graph/Makefile
 create mode 100644 taskvine/src/graph/vinedag/vine_graph/__init__.py
 rename taskvine/src/graph/vinedag/{strategic_orchestration_graph.c => vine_graph/vine_graph.c} (53%)
 create mode 100644 taskvine/src/graph/vinedag/vine_graph/vine_graph.h
 rename taskvine/src/graph/vinedag/{strategic_orchestration_graph.i => vine_graph/vine_graph.i} (72%)
 create mode 100644 taskvine/src/graph/vinedag/vine_graph/vine_graph_client.py
 rename taskvine/src/graph/vinedag/{strategic_orchestration_node.c => vine_graph/vine_node.c} (74%)
 create mode 100644 taskvine/src/graph/vinedag/vine_graph/vine_node.h

diff --git a/taskvine/src/graph/Makefile b/taskvine/src/graph/Makefile
index fa4c7dc2c5..f961ec9e86 100644
--- a/taskvine/src/graph/Makefile
+++ b/taskvine/src/graph/Makefile
@@ -9,5 +9,3 @@ $(SUBDIRS): %:
 	$(MAKE) -C $@ $(MAKECMDGOALS)
 
 .PHONY: all clean install test lint format $(SUBDIRS)
-
-
diff --git a/taskvine/src/graph/vinedag/Makefile b/taskvine/src/graph/vinedag/Makefile
index f3882a646c..32dff04894 100644
--- a/taskvine/src/graph/vinedag/Makefile
+++ b/taskvine/src/graph/vinedag/Makefile
@@ -1,84 +1,36 @@
 include ../../../../config.mk
 include ../../../../rules.mk
 
-LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
-LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
+MODULE_DIR := $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/vinedag
+SUBDIRS    := context_graph vine_graph
 
-PROJECT_NAME = vinedag
-
-SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)
-MODULE_DIR = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
-
-
-SOURCES = strategic_orchestration_node.c strategic_orchestration_graph.c
-OBJECTS = $(SOURCES:%.c=%.o)
-
-SWIG_I = strategic_orchestration_graph.i
-
-# put SWIG generated sources and Python extension artifacts into build/ directory
-BUILD_DIR := build
-SWIG_WRAP = $(BUILD_DIR)/strategic_orchestration_graph_wrap.c
-WRAP_OBJ = $(BUILD_DIR)/strategic_orchestration_graph_wrap.o
-PYMODULE = $(BUILD_DIR)/_capi.$(CCTOOLS_DYNAMIC_SUFFIX)
-
-LIBRARIES =
-PYDEPS = $(WRAP_OBJ) $(OBJECTS)
-PYLINK_INPUT = $(WRAP_OBJ) $(OBJECTS)
-PROGRAMS =
-SCRIPTS =
-TARGETS = $(LIBRARIES) $(PYMODULE) $(PROGRAMS)
-
-all: $(TARGETS)
-
-
-
-$(PROGRAMS): $(EXTERNALS)
-
-$(BUILD_DIR):
-	mkdir -p $(BUILD_DIR)
-
-$(SWIG_WRAP): $(SWIG_I) strategic_orchestration_graph.h | $(BUILD_DIR)
-	$(CCTOOLS_SWIG) -python -threads -relativeimport -I$(CCTOOLS_HOME)/taskvine/src/manager -I$(CCTOOLS_HOME)/dttools/src -I$(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME) -outdir $(BUILD_DIR) -o $@ $<
-
-# Build Python module (mimic bindings: silence SWIG warnings and build PIC)
-$(WRAP_OBJ): $(SWIG_WRAP)
-	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(LOCAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) -w -fPIC -DNDEBUG $<
-
-$(PYMODULE): $(PYDEPS)
-ifeq ($(CCTOOLS_STATIC),1)
-	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $(PYLINK_INPUT) $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
-else
-	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $(PYLINK_INPUT) $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
-endif
+.PHONY: all install clean lint format $(SUBDIRS)
 
+all: $(SUBDIRS)
 
+$(SUBDIRS):
+	$(MAKE) -C $@ all
 
 install: all
-	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/$(PROJECT_NAME)/include
-	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/$(PROJECT_NAME)/include/
 	mkdir -p $(MODULE_DIR)
-	cp $(PYMODULE) $(MODULE_DIR)
-	cp $(BUILD_DIR)/capi.py $(MODULE_DIR)
-	cp $(SOURCE_DIR)/*.py $(MODULE_DIR)
+	cp vinedag.py $(MODULE_DIR)
+	cp __init__.py $(MODULE_DIR)
+	@for dir in $(SUBDIRS); do \
+		$(MAKE) -C $$dir install; \
+	done
 
 clean:
-	rm -rf $(PROGRAMS) $(OBJECTS) *.o $(BUILD_DIR) $(PYMODULE) capi.py
+	@for dir in $(SUBDIRS); do \
+		$(MAKE) -C $$dir clean; \
+	done
+	rm -rf build
 
 lint:
-	if ( ! clang-format -Werror --dry-run --style='file:${CCTOOLS_HOME}/.clang-format' $(SOURCE_DIR)/*.c $(SOURCE_DIR)/*.h);\
-	then\
-		echo  "========================================================";\
-		echo  "NOTICE: Run \`make format\` to format your latest changes.";\
-		echo  "========================================================";\
-		exit 1;\
-	fi
-	flake8 --ignore=$(CCTOOLS_FLAKE8_IGNORE_ERRORS) \
-		--exclude=$(CCTOOLS_FLAKE8_IGNORE_FILES),$(BUILD_DIR) \
-		$(SOURCE_DIR)/
+	@for dir in $(SUBDIRS); do \
+		$(MAKE) -C $$dir lint; \
+	done
 
 format:
-	clang-format -i $(SOURCE_DIR)/*.c $(SOURCE_DIR)/*.h
-
-.PHONY: all clean install test lint format
-
-
+	@for dir in $(SUBDIRS); do \
+		$(MAKE) -C $$dir format; \
+	done
diff --git a/taskvine/src/graph/vinedag/config.py b/taskvine/src/graph/vinedag/config.py
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/taskvine/src/graph/vinedag/context_graph/Makefile b/taskvine/src/graph/vinedag/context_graph/Makefile
new file mode 100644
index 0000000000..bdee79013e
--- /dev/null
+++ b/taskvine/src/graph/vinedag/context_graph/Makefile
@@ -0,0 +1,31 @@
+include ../../../../../config.mk
+include ../../../../../rules.mk
+
+PROJECT_NAME = vinedag
+
+SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)/context_graph
+MODULE_ROOT = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
+MODULE_DIR = $(MODULE_ROOT)/context_graph
+
+PY_SOURCES = $(wildcard $(SOURCE_DIR)/*.py)
+
+.PHONY: all install clean lint format
+
+all:
+	@true
+
+install:
+	mkdir -p $(MODULE_DIR)
+	cp $(PY_SOURCES) $(MODULE_DIR)
+
+clean:
+	rm -rf __pycache__
+
+lint:
+	flake8 --ignore=$(CCTOOLS_FLAKE8_IGNORE_ERRORS) \
+		--exclude=$(CCTOOLS_FLAKE8_IGNORE_FILES) \
+		$(SOURCE_DIR)/
+
+format:
+	@true
+
diff --git a/taskvine/src/graph/vinedag/context_graph/__init__.py b/taskvine/src/graph/vinedag/context_graph/__init__.py
new file mode 100644
index 0000000000..cbb2cafd99
--- /dev/null
+++ b/taskvine/src/graph/vinedag/context_graph/__init__.py
@@ -0,0 +1,18 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+
+from .core import ContextGraph, GraphKeyResult
+from .proxy_functions import compute_single_key, compute_dts_key, compute_sexpr_key
+from .proxy_library import ProxyLibrary
+
+
+__all__ = [
+    "ContextGraph",
+    "GraphKeyResult",
+    "compute_single_key",
+    "compute_dts_key",
+    "compute_sexpr_key",
+    "ProxyLibrary",
+]
diff --git a/taskvine/src/graph/vinedag/runtime_execution_graph.py b/taskvine/src/graph/vinedag/context_graph/core.py
similarity index 58%
rename from taskvine/src/graph/vinedag/runtime_execution_graph.py
rename to taskvine/src/graph/vinedag/context_graph/core.py
index 37161b1bbc..c3708c590c 100644
--- a/taskvine/src/graph/vinedag/runtime_execution_graph.py
+++ b/taskvine/src/graph/vinedag/context_graph/core.py
@@ -2,31 +2,27 @@
 # This software is distributed under the GNU General Public License.
 # See the file COPYING for details.
 
-import hashlib
 import cloudpickle
 import collections
 import random
 from collections import deque
 
+# Attempt to import Dask helpers. When they are unavailable we fall back to
+# None so environments without Dask continue to work. If Dask is present—either
+# the legacy graph or the newer TaskSpec API—we normalize it into our internal
+# task representation.
 try:
     import dask
 except ImportError:
     dask = None
-
 try:
     import dask._task_spec as dts
 except ImportError:
     dts = None
 
 
-def hash_name(*args):
-    out_str = ""
-    for arg in args:
-        out_str += str(arg)
-    return hashlib.sha256(out_str.encode('utf-8')).hexdigest()[:32]
-
-
 def hashable(s):
+    """Used while wiring dependencies to spot values we can treat as node keys."""
     try:
         hash(s)
         return True
@@ -34,59 +30,20 @@ def hashable(s):
         return False
 
 
-def dist_func(mode, low, high):
-    """ Generate a random value from a distribution. """
-    if not mode:
-        return 0
-
-    assert mode in ["uniform", "normal", "lognormal", "pareto", "mix"]
-
-    # uniform distribution, flat spread
-    def uniform_dist():
-        return random.uniform(low, high)
-
-    # normal distribution, centered in the middle
-    def normal_dist():
-        mu, sigma = (low + high) / 2, (high - low) / 6
-        return min(max(random.gauss(mu, sigma), low), high)
-
-    # lognormal distribution, long tail
-    def lognormal_dist():
-        val = random.lognormvariate(0, 1)
-        val = val / (1 + val)
-        return low + (high - low) * val
-
-    # pareto distribution, very heavy tail
-    def pareto_dist(alpha=2.0):
-        val = random.paretovariate(alpha)
-        val = val / (1 + val)
-        return low + (high - low) * val
-
-    # mixture: most small values, few large ones
-    def mix_dist():
-        if random.random() < 0.9:
-            return random.uniform(low, (low + high) / 2)
-        else:
-            return random.uniform((low + high) / 2, high)
-
-    return {
-        "uniform": uniform_dist,
-        "normal": normal_dist,
-        "lognormal": lognormal_dist,
-        "pareto": pareto_dist,
-        "mix": mix_dist,
-    }[mode]()
-
-
+# Lightweight wrapper around task results that optionally pads the payload. The
+# padding lets tests model large outputs without altering the logical result.
 class GraphKeyResult:
-    """ A wrapper class to store the result of a task and the extra size in MB to allocate for this object in testing mode to evaluate storage consumption
-    and peer transfer performance across all workers. """
     def __init__(self, result, extra_size_mb=None):
+        """Store the real user result plus optional padding used during regression tests."""
         self.result = result
         self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
 
     @staticmethod
     def load_from_path(path):
+        """Workers call this while recovering an output produced by save_result_of_key from disk.
+        If a node-local output, then data is stored in the task sandbox and the path is just the filename
+        If a shared file system output, then path is the full path to the file
+        If a target result, the path is the full path to the file in the manager's output directory"""
         try:
             with open(path, "rb") as f:
                 result_obj = cloudpickle.load(f)
@@ -96,17 +53,15 @@ def load_from_path(path):
             raise FileNotFoundError(f"Output file not found at {path}")
 
 
-class RuntimeExecutionGraph:
-    """
-    The RuntimeExecutionGraph class constructs the task graph and manages task dependencies.
-    This class is cloudpickled and sent to workers, where it is hoisted by the library instance.
-    The global RuntimeExecutionGraph object then serves as the execution context: whenever a task key is invoked,
-    the system resolves the corresponding graph key from the Vine key and executes the mapped function
-    to produce the result.
-    """
+# ContextGraph builds the logical DAG and manages dependencies. The
+# object is cloudpickled, shipped with the proxy library, and hoisted on worker
+# nodes. When a task key executes we map from the Vine key back to the original
+# graph key, run the user function, and persist the result.
+class ContextGraph:
     def __init__(self, task_dict,
-                 extra_task_output_size_mb=["uniform", 0, 0],
-                 extra_task_sleep_time=["uniform", 0, 0]):
+                 extra_task_output_size_mb=[0, 0],
+                 extra_task_sleep_time=[0, 0]):
+        """Capture the Python DAG that VineDAG hands us before we mirror it in C."""
         self.task_dict = task_dict
 
         if dts:
@@ -115,12 +70,12 @@ def __init__(self, task_dict,
                     assert isinstance(v, (dts.Alias, dts.Task, dts.DataNode)), f"Unsupported task type for key {k}: {v.__class__}"
 
         self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
-        self.depth_of = self._calculate_depths()
 
-        self.reg_key_to_sog_key = {k: hash_name(k) for k in task_dict.keys()}
-        self.sog_key_to_reg_key = {hash_name(k): k for k in task_dict.keys()}
+        # these mappings are set after node ids are assigned in the C vine graph
+        self.ckey2vid = {}
+        self.vid2ckey = {}
 
-        # will be set from sog
+        # will be set from vine graph
         self.outfile_remote_name = {key: None for key in self.task_dict.keys()}
 
         # testing params
@@ -128,56 +83,34 @@ def __init__(self, task_dict,
         self.extra_sleep_time_of = self._calculate_extra_sleep_time_of(extra_task_sleep_time)
 
     def _calculate_extra_size_mb_of(self, extra_task_output_size_mb):
-        assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 3
-        mode, low, high = extra_task_output_size_mb
+        """Sample a uniform byte budget between low/high for every node."""
+        assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 2
+        low, high = extra_task_output_size_mb
         low, high = int(low), int(high)
         assert low <= high
 
-        max_depth = max(depth for depth in self.depth_of.values())
-        extra_size_mb_of = {}
-        for k in self.task_dict.keys():
-            if self.depth_of[k] == max_depth or self.depth_of[k] == max_depth - 1:
-                extra_size_mb_of[k] = 0
-                continue
-            extra_size_mb_of[k] = dist_func(mode, low, high)
-
-        return extra_size_mb_of
+        return {k: random.uniform(low, high) for k in self.task_dict.keys()}
 
     def _calculate_extra_sleep_time_of(self, extra_task_sleep_time):
-        assert isinstance(extra_task_sleep_time, list) and len(extra_task_sleep_time) == 3
-        mode, low, high = extra_task_sleep_time
+        """Pick a uniform delay between low/high so tests can fake runtime."""
+        assert isinstance(extra_task_sleep_time, list) and len(extra_task_sleep_time) == 2
+        low, high = extra_task_sleep_time
         low, high = int(low), int(high)
         assert low <= high
 
-        extra_sleep_time_of = {}
-        for k in self.task_dict.keys():
-            extra_sleep_time_of[k] = dist_func(mode, low, high)
-
-        return extra_sleep_time_of
-
-    def _calculate_depths(self):
-        depth_of = {key: 0 for key in self.task_dict.keys()}
-
-        topo_order = self.get_topological_order()
-        for key in topo_order:
-            if self.parents_of[key]:
-                depth_of[key] = max(depth_of[parent] for parent in self.parents_of[key]) + 1
-            else:
-                depth_of[key] = 0
-
-        return depth_of
-
-    def set_outfile_remote_name_of(self, key, outfile_remote_name):
-        self.outfile_remote_name[key] = outfile_remote_name
+        return {k: random.uniform(low, high) for k in self.task_dict.keys()}
 
     def is_dts_key(self, k):
+        """Gate the Dask-specific branch when we parse task definitions."""
         if not hasattr(dask, "_task_spec"):
             return False
         import dask._task_spec as dts
         return isinstance(self.task_dict[k], (dts.Task, dts.TaskRef, dts.Alias, dts.DataNode, dts.NestedContainer))
 
     def _build_dependencies(self, task_dict):
+        """Normalize mixed Dask/s-expression inputs into our parent/child lookup tables."""
         def _find_sexpr_parents(sexpr):
+            """Resolve the immediate parents inside one symbolic expression node."""
             if hashable(sexpr) and sexpr in task_dict.keys():
                 return {sexpr}
             elif isinstance(sexpr, (list, tuple)):
@@ -214,11 +147,13 @@ def _find_sexpr_parents(sexpr):
         return parents_of, children_of
 
     def save_result_of_key(self, key, result):
+        """Called from the proxy function to persist a result into disk after the worker finishes."""
         with open(self.outfile_remote_name[key], "wb") as f:
             result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
             cloudpickle.dump(result_obj, f)
 
     def load_result_of_key(self, key):
+        """Used by downstream tasks to pull inputs from disk or the shared store."""
         # workers user this function to load results from either local or shared file system
         # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
         # if a shared file system output, then remote name is the full path to the file
@@ -226,6 +161,7 @@ def load_result_of_key(self, key):
         return GraphKeyResult.load_from_path(outfile_path)
 
     def get_topological_order(self):
+        """Produce the order VineDAG uses when assigning node IDs to the C graph."""
         in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
         queue = deque([key for key, degree in in_degree.items() if degree == 0])
         topo_order = []
@@ -247,12 +183,13 @@ def get_topological_order(self):
         return topo_order
 
     @staticmethod
-    def context_loader_func(reg_pkl):
-        reg = cloudpickle.loads(reg_pkl)
+    def context_loader_func(context_graph_pkl):
+        """Entry point the proxy library invokes to restore the serialized ContextGraph."""
+        context_graph = cloudpickle.loads(context_graph_pkl)
 
-        if not isinstance(reg, RuntimeExecutionGraph):
-            raise TypeError("reg_pkl is not of type RuntimeExecutionGraph")
+        if not isinstance(context_graph, ContextGraph):
+            raise TypeError("context_graph_pkl is not of type ContextGraph")
 
         return {
-            "reg": reg,
+            "context_graph": context_graph,
         }
diff --git a/taskvine/src/graph/vinedag/proxy_functions.py b/taskvine/src/graph/vinedag/context_graph/proxy_functions.py
similarity index 70%
rename from taskvine/src/graph/vinedag/proxy_functions.py
rename to taskvine/src/graph/vinedag/context_graph/proxy_functions.py
index 2cbbc8d1e1..4218756007 100644
--- a/taskvine/src/graph/vinedag/proxy_functions.py
+++ b/taskvine/src/graph/vinedag/context_graph/proxy_functions.py
@@ -7,7 +7,7 @@
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
-def compute_dts_key(reg, k, v):
+def compute_dts_key(context_graph, k, v):
     """
     Compute the result of a Dask task node from dask._task_spec.
 
@@ -15,7 +15,7 @@ def compute_dts_key(reg, k, v):
     inherit from the same base class. The `dependencies` field is a frozenset
     containing direct dependencies only (no recursive ancestry).
 
-    The function resolves each dependency from the reg, constructs an
+    The function resolves each dependency from the context_graph, constructs an
     input dictionary, and then executes the node according to its type.
     """
     try:
@@ -23,12 +23,12 @@ def compute_dts_key(reg, k, v):
     except ImportError:
         raise ImportError("Dask is not installed")
 
-    input_dict = {dep: reg.load_result_of_key(dep) for dep in v.dependencies}
+    input_dict = {dep: context_graph.load_result_of_key(dep) for dep in v.dependencies}
 
     try:
         if isinstance(v, dts.Alias):
             assert len(v.dependencies) == 1, "Expected exactly one dependency"
-            return reg.load_result_of_key(next(iter(v.dependencies)))
+            return context_graph.load_result_of_key(next(iter(v.dependencies)))
         elif isinstance(v, dts.Task):
             return v(input_dict)
         elif isinstance(v, dts.DataNode):
@@ -39,7 +39,7 @@ def compute_dts_key(reg, k, v):
         raise Exception(f"Error while executing task {k}: {e}")
 
 
-def compute_sexpr_key(reg, k, v):
+def compute_sexpr_key(context_graph, k, v):
     """
     Evaluate a symbolic expression (S-expression) task within the task graph.
 
@@ -54,7 +54,7 @@ def compute_sexpr_key(reg, k, v):
     recursively resolves and executes the expression until a final value
     is produced.
     """
-    input_dict = {parent: reg.load_result_of_key(parent) for parent in reg.parents_of[k]}
+    input_dict = {parent: context_graph.load_result_of_key(parent) for parent in context_graph.parents_of[k]}
 
     def _rec_call(expr):
         try:
@@ -77,10 +77,10 @@ def _rec_call(expr):
 
 def compute_single_key(vine_key):
     """
-    Compute a single task identified by a Vine key within the current RuntimeExecutionGraph.
+    Compute a single task identified by a Vine key within the current ContextGraph.
 
     The function retrieves the corresponding graph key and task object from the
-    global reg, determines the task type, and dispatches to the appropriate
+    global context_graph, determines the task type, and dispatches to the appropriate
     execution interface — e.g., `compute_dts_key` for Dask-style task specs or
     `compute_sexpr_key` for S-expression graphs.
 
@@ -90,22 +90,22 @@ def compute_single_key(vine_key):
     After computation, the result is saved, the output file is validated, and
     an optional delay (`extra_sleep_time_of`) is applied before returning.
     """
-    reg = load_variable_from_library('reg')
+    context_graph = load_variable_from_library('context_graph')
 
-    k = reg.sog_key_to_reg_key[vine_key]
-    v = reg.task_dict[k]
+    k = context_graph.vid2ckey[vine_key]
+    v = context_graph.task_dict[k]
 
-    if reg.is_dts_key(k):
-        result = compute_dts_key(reg, k, v)
+    if context_graph.is_dts_key(k):
+        result = compute_dts_key(context_graph, k, v)
     else:
-        result = compute_sexpr_key(reg, k, v)
+        result = compute_sexpr_key(context_graph, k, v)
 
-    reg.save_result_of_key(k, result)
-    if not os.path.exists(reg.outfile_remote_name[k]):
-        raise Exception(f"Output file {reg.outfile_remote_name[k]} does not exist after writing")
-    if os.stat(reg.outfile_remote_name[k]).st_size == 0:
-        raise Exception(f"Output file {reg.outfile_remote_name[k]} is empty after writing")
+    context_graph.save_result_of_key(k, result)
+    if not os.path.exists(context_graph.outfile_remote_name[k]):
+        raise Exception(f"Output file {context_graph.outfile_remote_name[k]} does not exist after writing")
+    if os.stat(context_graph.outfile_remote_name[k]).st_size == 0:
+        raise Exception(f"Output file {context_graph.outfile_remote_name[k]} is empty after writing")
 
-    time.sleep(reg.extra_sleep_time_of[k])
+    time.sleep(context_graph.extra_sleep_time_of[k])
 
     return True
diff --git a/taskvine/src/graph/vinedag/proxy_library.py b/taskvine/src/graph/vinedag/context_graph/proxy_library.py
similarity index 89%
rename from taskvine/src/graph/vinedag/proxy_library.py
rename to taskvine/src/graph/vinedag/context_graph/proxy_library.py
index 0f1d1ea1b4..2bc4dd3c7c 100644
--- a/taskvine/src/graph/vinedag/proxy_library.py
+++ b/taskvine/src/graph/vinedag/context_graph/proxy_library.py
@@ -10,10 +10,9 @@
 import random
 import hashlib
 import collections
-from ndcctools.taskvine.vinedag.runtime_execution_graph import (
-    GraphKeyResult, RuntimeExecutionGraph, hash_name, hashable
-)
-from ndcctools.taskvine.vinedag.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
+
+from ndcctools.taskvine.vinedag.context_graph.core import GraphKeyResult, ContextGraph
+from ndcctools.taskvine.vinedag.context_graph.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
@@ -29,8 +28,8 @@ def __init__(self, py_manager):
         # these modules are always included in the preamble of the library task, so that function calls can execute directly
         # using the loaded context without importing them over and over again
         self.hoisting_modules = [
-            os, cloudpickle, GraphKeyResult, RuntimeExecutionGraph, uuid, hashlib, random, types, collections, time,
-            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key, hash_name, hashable
+            os, cloudpickle, GraphKeyResult, ContextGraph, uuid, hashlib, random, types, collections, time,
+            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key
         ]
 
         # environment files serve as additional inputs to the library task, where each key is the local path and the value is the remote path
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.h b/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
deleted file mode 100644
index 65db266b20..0000000000
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.h
+++ /dev/null
@@ -1,143 +0,0 @@
-#ifndef STRATEGIC_ORCHESTRATION_GRAPH_H
-#define STRATEGIC_ORCHESTRATION_GRAPH_H
-
-#include "vine_task.h"
-#include "hash_table.h"
-#include "list.h"
-#include "vine_manager.h"
-#include "set.h"
-#include "strategic_orchestration_node.h"
-#include "taskvine.h"
-
-/** Select priority algorithm for strategic orchestration graph task scheduling. */
-typedef enum {
-	TASK_PRIORITY_MODE_RANDOM = 0,			   /**< Assign random priority to tasks */
-	TASK_PRIORITY_MODE_DEPTH_FIRST,			   /**< Prioritize deeper tasks first */
-	TASK_PRIORITY_MODE_BREADTH_FIRST,		   /**< Prioritize shallower tasks first */
-	TASK_PRIORITY_MODE_FIFO,			   /**< First in, first out priority */
-	TASK_PRIORITY_MODE_LIFO,			   /**< Last in, first out priority */
-	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		   /**< Prioritize tasks with larger inputs first */
-	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
-} task_priority_mode_t;
-
-/** The strategic orchestration graph object (logical scheduling layer). */
-struct strategic_orchestration_graph {
-	struct vine_manager *manager;
-	struct hash_table *nodes;
-	struct itable *task_id_to_node;
-	struct hash_table *outfile_cachename_to_node;
-
-	/* The directory to store the checkpointed results.
-	 * Only intermediate results can be checkpointed, the fraction of intermediate results to checkpoint is controlled by the checkpoint-fraction parameter. */
-	char *checkpoint_dir;
-
-	/* Results of target keys will be stored in this directory.
-	 * This dir path can not necessarily be a shared file system directory,
-	 * output files will be retrieved through the network instead,
-	 * as long as the manager can access it. */
-	char *output_dir;
-
-	/* Python-side proxy library name, while is responsible for managing the runtime execution graph (reg),
-	 * receiving function calls emitted by the strategic orchestration graph (sog), and executing them via
-	 * the proxy function. The proxy library name is generated by the sog, and then synchronized to reg. */
-	char *proxy_library_name;
-
-	/* The proxy function is hoisted in the proxy library, it receives a key (in string format) in the rog,
-	 * converts it to the reg-based key, looks up the function definition and arguments from reg,
-	 * and then executes the function. This name is generated by reg and synchronized to sog. */
-	char *proxy_function_name;
-
-	/* The depth of the pruning strategy. 0 means no pruning, 1 means the most aggressive pruning. */
-	int prune_depth;
-	double checkpoint_fraction; /* 0 - 1, the fraction of intermediate results to checkpoint */
-
-	task_priority_mode_t task_priority_mode; /* priority mode for task graph task scheduling */
-	double failure_injection_step_percent;	 /* 0 - 100, the percentage of steps to inject failure */
-
-	double progress_bar_update_interval_sec; /* update interval for the progress bar in seconds */
-
-	/* The filename of the csv file to store the time metrics of the strategic orchestration graph. */
-	char *time_metrics_filename;
-
-	int enable_debug_log; /* whether to enable debug log */
-};
-
-/* Public APIs for operating the strategic orchestration graph */
-
-/** Create a strategic orchestration graph object and return it.
-@param q Reference to the current manager object.
-@return A new strategic orchestration graph object.
-*/
-struct strategic_orchestration_graph *sog_create(struct vine_manager *q);
-
-/** Create a new node in the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param node_key Reference to the node key.
-@param is_target_key Reference to whether the node is a target key.
-*/
-void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key, int is_target_key);
-
-/** Add a dependency between two nodes in the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param parent_key Reference to the parent node key.
-@param child_key Reference to the child node key.
-*/
-void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *parent_key, const char *child_key);
-
-/** Finalize the metrics of the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-*/
-void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog);
-
-/** Get the heavy score of a node in the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param node_key Reference to the node key.
-@return The heavy score.
-*/
-double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog, const char *node_key);
-
-/** Execute the task graph.
-@param sog Reference to the strategic orchestration graph object.
-*/
-void sog_execute(struct strategic_orchestration_graph *sog);
-
-/** Get the outfile remote name of a node in the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param node_key Reference to the node key.
-@return The outfile remote name.
-*/
-const char *sog_get_node_outfile_remote_name(const struct strategic_orchestration_graph *sog, const char *node_key);
-
-/** Get the local outfile source of a node in the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param node_key Reference to the node key.
-@return The local outfile source.
-*/
-const char *sog_get_node_local_outfile_source(const struct strategic_orchestration_graph *sog, const char *node_key);
-
-/** Delete a strategic orchestration graph object.
-@param sog Reference to the strategic orchestration graph object.
-*/
-void sog_delete(struct strategic_orchestration_graph *sog);
-
-/** Get the proxy library name of the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@return The proxy library name.
-*/
-const char *sog_get_proxy_library_name(const struct strategic_orchestration_graph *sog);
-
-/** Set the proxy function name of the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param proxy_function_name Reference to the proxy function name.
-*/
-void sog_set_proxy_function_name(struct strategic_orchestration_graph *sog, const char *proxy_function_name);
-
-/** Tune the strategic orchestration graph.
-@param sog Reference to the strategic orchestration graph object.
-@param name Reference to the name of the parameter to tune.
-@param value Reference to the value of the parameter to tune.
-@return 0 on success, -1 on failure.
-*/
-int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const char *value);
-
-#endif // STRATEGIC_ORCHESTRATION_GRAPH_H
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.py b/taskvine/src/graph/vinedag/strategic_orchestration_graph.py
deleted file mode 100644
index 2c8f30d5f5..0000000000
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.py
+++ /dev/null
@@ -1,33 +0,0 @@
-from ndcctools.taskvine.vinedag import capi
-
-
-class StrategicOrchestrationGraph:
-    def __init__(self, c_taskvine):
-        self._c_sog = capi.sog_create(c_taskvine)
-
-    def tune(self, name, value):
-        capi.sog_tune(self._c_sog, name, value)
-
-    def add_node(self, key, is_target_key):
-        capi.sog_add_node(self._c_sog, key, is_target_key)
-
-    def add_dependency(self, parent_key, child_key):
-        capi.sog_add_dependency(self._c_sog, parent_key, child_key)
-
-    def compute_topology_metrics(self):
-        capi.sog_compute_topology_metrics(self._c_sog)
-
-    def get_node_outfile_remote_name(self, key):
-        return capi.sog_get_node_outfile_remote_name(self._c_sog, key)
-
-    def get_proxy_library_name(self):
-        return capi.sog_get_proxy_library_name(self._c_sog)
-
-    def set_proxy_function(self, proxy_function):
-        capi.sog_set_proxy_function_name(self._c_sog, proxy_function.__name__)
-
-    def execute(self):
-        capi.sog_execute(self._c_sog)
-
-    def delete(self):
-        capi.sog_delete(self._c_sog)
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.h b/taskvine/src/graph/vinedag/strategic_orchestration_node.h
deleted file mode 100644
index eb1dcb4ad5..0000000000
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.h
+++ /dev/null
@@ -1,112 +0,0 @@
-#ifndef STRATEGIC_ORCHESTRATION_NODE_H
-#define STRATEGIC_ORCHESTRATION_NODE_H
-
-#include "vine_task.h"
-#include "hash_table.h"
-#include "list.h"
-#include "set.h"
-#include "taskvine.h"
-
-/** Select the type of the node-output file. */
-typedef enum {
-	NODE_OUTFILE_TYPE_LOCAL = 0,	      /* Node-output file will be stored locally on the local staging directory */
-	NODE_OUTFILE_TYPE_TEMP,		      /* Node-output file will be stored in the temporary node-local storage */
-	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
-} node_outfile_type_t;
-
-/** The status of an output file of a node. */
-typedef enum {
-	PRUNE_STATUS_NOT_PRUNED = 0,
-	PRUNE_STATUS_SAFE,
-	PRUNE_STATUS_UNSAFE
-} prune_status_t;
-
-/** The strategic orchestration node object. */
-struct strategic_orchestration_node {
-	char *node_key;
-
-	/* Whether the node is a target key.
-	 * If true, the output of the node will be declared as a vine_file and retrieved through the network. */
-	int is_target_key;
-
-	struct vine_task *task;
-	struct vine_file *infile;
-	struct vine_file *outfile;
-	char *outfile_remote_name;
-	size_t outfile_size_bytes;
-
-	struct list *parents;
-	struct list *children;
-	struct set *pending_parents;
-
-	int retry_attempts_left;
-	int completed;
-	int prune_depth;
-
-	int depth;
-	int height;
-	int upstream_subgraph_size;
-	int downstream_subgraph_size;
-	int fan_in;
-	int fan_out;
-	double heavy_score;
-
-	timestamp_t critical_path_time;
-	timestamp_t time_spent_on_unlink_local_files;
-	timestamp_t time_spent_on_prune_ancestors_of_temp_node;
-	timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
-
-	timestamp_t submission_time;
-	timestamp_t scheduling_time;
-	timestamp_t commit_time;
-	timestamp_t execution_time;
-	timestamp_t retrieval_time;
-	timestamp_t postprocessing_time;
-
-	node_outfile_type_t outfile_type;
-	prune_status_t prune_status;
-};
-
-/** Create a new strategic orchestration node object.
-@param node_key Reference to the node key.
-@param is_target_key Reference to whether the node is a target key.
-@return A new strategic orchestration node object.
-*/
-struct strategic_orchestration_node *son_create(const char *node_key, int is_target_key);
-
-/** Create the task arguments for a strategic orchestration node object.
-@param node Reference to the strategic orchestration node object.
-@return The task arguments in JSON format: {"fn_args": [key], "fn_kwargs": {}}.
-*/
-char *son_construct_task_arguments(struct strategic_orchestration_node *node);
-
-/** Delete a strategic orchestration node object.
-@param node Reference to the strategic orchestration node object.
-*/
-void son_delete(struct strategic_orchestration_node *node);
-
-/** Print information about a strategic orchestration node object.
-@param node Reference to the strategic orchestration node object.
-*/
-void son_debug_print(struct strategic_orchestration_node *node);
-
-/** Find all safe ancestors of a strategic orchestration node object.
-@param start_node Reference to the start node.
-@return The set of safe ancestors.
-*/
-struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_node);
-
-/** Find all parents in a specific depth of a strategic orchestration node object.
-@param node Reference to the node object.
-@param depth Reference to the depth.
-@return The list of parents.
-*/
-struct list *son_find_parents_by_depth(struct strategic_orchestration_node *node, int depth);
-
-/** Update the critical time of a strategic orchestration node object.
-@param node Reference to the strategic orchestration node object.
-@param execution_time Reference to the execution time of the node.
-*/
-void son_update_critical_path_time(struct strategic_orchestration_node *node, timestamp_t execution_time);
-
-#endif
\ No newline at end of file
diff --git a/taskvine/src/graph/vinedag/vine_graph/Makefile b/taskvine/src/graph/vinedag/vine_graph/Makefile
new file mode 100644
index 0000000000..45fc3f7b42
--- /dev/null
+++ b/taskvine/src/graph/vinedag/vine_graph/Makefile
@@ -0,0 +1,90 @@
+include ../../../../../config.mk
+include ../../../../../rules.mk
+
+PROJECT_NAME = vinedag
+
+LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
+LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
+LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/graph/$(PROJECT_NAME)/vine_graph
+
+SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)/vine_graph
+MODULE_ROOT = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
+MODULE_DIR = $(MODULE_ROOT)/vine_graph
+
+SOURCES = vine_node.c vine_graph.c
+OBJECTS = $(SOURCES:%.c=%.o)
+
+BUILD_DIR := ../build
+
+# put SWIG generated sources and Python extension artifacts into ../build/
+SWIG_I = vine_graph.i
+
+WRAP_NAME = vine_graph_wrap
+MODULE_NAME = vine_graph_capi
+
+SWIG_WRAP = $(BUILD_DIR)/$(WRAP_NAME).c
+WRAP_OBJ = $(BUILD_DIR)/$(WRAP_NAME).o
+PYMODULE = $(BUILD_DIR)/_$(MODULE_NAME).$(CCTOOLS_DYNAMIC_SUFFIX)
+
+LIBRARIES =
+PYDEPS = $(WRAP_OBJ) $(OBJECTS)
+PYLINK_INPUT = $(WRAP_OBJ) $(OBJECTS)
+PROGRAMS =
+SCRIPTS =
+TARGETS = $(LIBRARIES) $(PYMODULE) $(PROGRAMS)
+
+.PHONY: all install clean lint format
+
+all: $(TARGETS)
+
+$(PROGRAMS): $(EXTERNALS)
+
+$(BUILD_DIR):
+	mkdir -p $(BUILD_DIR)
+
+$(SWIG_WRAP): $(SWIG_I) vine_graph.h | $(BUILD_DIR)
+	$(CCTOOLS_SWIG) -python -threads -relativeimport \
+		-I$(CCTOOLS_HOME)/taskvine/src/manager \
+		-I$(CCTOOLS_HOME)/dttools/src \
+		-I$(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME) \
+		-I$(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)/vine_graph \
+		-outdir $(BUILD_DIR) -o $@ $<
+
+# Build Python module (mimic bindings: silence SWIG warnings and build PIC)
+$(WRAP_OBJ): $(SWIG_WRAP)
+	$(CCTOOLS_CC) -o $@ -c $(CCTOOLS_INTERNAL_CCFLAGS) $(LOCAL_CCFLAGS) $(CCTOOLS_PYTHON3_CCFLAGS) -w -fPIC -DNDEBUG $<
+
+$(PYMODULE): $(PYDEPS)
+ifeq ($(CCTOOLS_STATIC),1)
+	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $(PYLINK_INPUT) $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
+else
+	$(CCTOOLS_LD) -o $@ $(CCTOOLS_DYNAMIC_FLAG) $(CCTOOLS_INTERNAL_LDFLAGS) $(LOCAL_LDFLAGS) $(PYLINK_INPUT) $(LOCAL_LINKAGE) $(CCTOOLS_PYTHON3_LDFLAGS) $(CCTOOLS_EXTERNAL_LINKAGE)
+endif
+
+install: all
+	mkdir -p $(CCTOOLS_INSTALL_DIR)/graph/$(PROJECT_NAME)/include
+	cp ${CCTOOLS_HOME}/taskvine/src/manager/taskvine.h $(CCTOOLS_INSTALL_DIR)/graph/$(PROJECT_NAME)/include/
+	mkdir -p $(MODULE_DIR)
+	cp $(PYMODULE) $(MODULE_DIR)
+	cp $(BUILD_DIR)/$(MODULE_NAME).py $(MODULE_DIR)
+	cp $(SOURCE_DIR)/__init__.py $(MODULE_DIR)
+	cp $(SOURCE_DIR)/vine_graph_client.py $(MODULE_DIR)
+
+clean:
+	rm -f $(PROGRAMS) $(OBJECTS) $(WRAP_OBJ)
+	rm -f $(PYMODULE) $(BUILD_DIR)/$(MODULE_NAME).py
+	rm -rf $(BUILD_DIR)
+
+lint:
+	if ( ! clang-format -Werror --dry-run --style='file:${CCTOOLS_HOME}/.clang-format' $(SOURCE_DIR)/*.c $(SOURCE_DIR)/*.h); \
+	then \
+		echo  "========================================================"; \
+		echo  "NOTICE: Run \`make format\` to format your latest changes."; \
+		echo  "========================================================"; \
+		exit 1; \
+	fi
+
+format:
+	clang-format -i $(SOURCE_DIR)/*.c $(SOURCE_DIR)/*.h
+
+
diff --git a/taskvine/src/graph/vinedag/vine_graph/__init__.py b/taskvine/src/graph/vinedag/vine_graph/__init__.py
new file mode 100644
index 0000000000..4dd6f218ce
--- /dev/null
+++ b/taskvine/src/graph/vinedag/vine_graph/__init__.py
@@ -0,0 +1,14 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+"""Namespace for the C vine graph bindings and Python client."""
+
+try:  # pragma: no cover - module only exists after building the SWIG bindings
+    from . import vine_graph_capi
+except ImportError:
+    vine_graph_capi = None
+
+from .vine_graph_client import VineGraphClient
+
+__all__ = ["vine_graph_capi", "VineGraphClient"]
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c b/taskvine/src/graph/vinedag/vine_graph/vine_graph.c
similarity index 53%
rename from taskvine/src/graph/vinedag/strategic_orchestration_graph.c
rename to taskvine/src/graph/vinedag/vine_graph/vine_graph.c
index a790c8b39b..3ef646c768 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.c
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_graph.c
@@ -1,6 +1,7 @@
 #include <stdlib.h>
 #include <string.h>
 #include <stdint.h>
+#include <inttypes.h>
 #include <assert.h>
 #include <math.h>
 #include <signal.h>
@@ -22,8 +23,8 @@
 #include "macros.h"
 #include "uuid.h"
 
-#include "strategic_orchestration_node.h"
-#include "strategic_orchestration_graph.h"
+#include "vine_node.h"
+#include "vine_graph.h"
 #include "vine_manager.h"
 #include "vine_worker_info.h"
 #include "vine_task.h"
@@ -47,30 +48,13 @@ static void handle_sigint(int signal)
 	interrupted = 1;
 }
 
-/**
- * Compute a lexicographic priority score from the node key.
- * Used during topological sorting to break ties deterministically.
- * @param key Reference to the node key.
- * @return The lexical priority.
- */
-static double compute_lex_priority(const char *key)
-{
-	double score = 0.0;
-	double factor = 1.0;
-	for (int i = 0; i < 8 && key[i] != '\0'; i++) {
-		score += (unsigned char)key[i] * factor;
-		factor *= 0.01;
-	}
-	return -score;
-}
-
 /**
  * Calculate the priority of a node given the priority mode.
  * @param node Reference to the node object.
  * @param priority_mode Reference to the priority mode.
  * @return The priority.
  */
-static double calculate_task_priority(struct strategic_orchestration_node *node, task_priority_mode_t priority_mode)
+static double calculate_task_priority(struct vine_node *node, task_priority_mode_t priority_mode)
 {
 	if (!node) {
 		return 0;
@@ -79,7 +63,7 @@ static double calculate_task_priority(struct strategic_orchestration_node *node,
 	double priority = 0;
 	timestamp_t current_time = timestamp_get();
 
-	struct strategic_orchestration_node *parent_node;
+	struct vine_node *parent_node;
 
 	switch (priority_mode) {
 	case TASK_PRIORITY_MODE_RANDOM:
@@ -122,45 +106,45 @@ static double calculate_task_priority(struct strategic_orchestration_node *node,
 }
 
 /**
- * Submit a node to the taskvine manager.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node Reference to the node object.
+ * Submit a node to the TaskVine manager via the vine graph.
+ * @param vg Reference to the vine graph.
+ * @param node Reference to the node.
  */
-static void submit_node_task(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+static void submit_node_task(struct vine_graph *vg, struct vine_node *node)
 {
-	if (!sog || !node) {
+	if (!vg || !node) {
 		return;
 	}
 
 	/* calculate the priority of the node */
-	double priority = calculate_task_priority(node, sog->task_priority_mode);
+	double priority = calculate_task_priority(node, vg->task_priority_mode);
 	vine_task_set_priority(node->task, priority);
 
 	/* submit the task to the manager */
 	timestamp_t time_start = timestamp_get();
-	int task_id = vine_submit(sog->manager, node->task);
+	int task_id = vine_submit(vg->manager, node->task);
 	node->submission_time = timestamp_get() - time_start;
 
 	/* insert the task id to the task id to node map */
-	itable_insert(sog->task_id_to_node, task_id, node);
+	itable_insert(vg->task_id_to_node, (uint64_t)task_id, node);
 
-	debug(D_VINE, "submitted node %s with task id %d", node->node_key, task_id);
+	debug(D_VINE, "submitted node %" PRIu64 " with task id %d", node->node_id, task_id);
 
 	return;
 }
 
 /**
- * Submit the children of a node if all its dependencies are resolved.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node Reference to the node object.
+ * Submit the children of a node once every dependency has completed.
+ * @param vg Reference to the vine graph.
+ * @param node Reference to the node.
  */
-static void submit_unblocked_children(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+static void submit_unblocked_children(struct vine_graph *vg, struct vine_node *node)
 {
-	if (!sog || !node) {
+	if (!vg || !node) {
 		return;
 	}
 
-	struct strategic_orchestration_node *child_node;
+	struct vine_node *child_node;
 	LIST_ITERATE(node->children, child_node)
 	{
 		/* Remove this parent from the child's pending set if it exists */
@@ -169,13 +153,13 @@ static void submit_unblocked_children(struct strategic_orchestration_graph *sog,
 			if (child_node->pending_parents && set_lookup(child_node->pending_parents, node)) {
 				set_remove(child_node->pending_parents, node);
 			} else {
-				debug(D_ERROR, "inconsistent pending set: child=%s missing parent=%s", child_node->node_key, node->node_key);
+				debug(D_ERROR, "inconsistent pending set: child=%" PRIu64 " missing parent=%" PRIu64, child_node->node_id, node->node_id);
 			}
 		}
 
 		/* If no more parents are pending, submit the child */
 		if (!child_node->pending_parents || set_size(child_node->pending_parents) == 0) {
-			submit_node_task(sog, child_node);
+			submit_node_task(vg, child_node);
 		}
 	}
 
@@ -183,99 +167,98 @@ static void submit_unblocked_children(struct strategic_orchestration_graph *sog,
 }
 
 /**
- * Get the topological order of the strategic orchestration graph.
- * Must be called after all nodes and dependencies are added and the topology metrics are computed.
- * @param sog Reference to the strategic orchestration graph object.
- * @return The list of nodes in topological order.
+ * Compute a topological ordering of the vine graph.
+ * Call only after all nodes, edges, and metrics have been populated.
+ * @param vg Reference to the vine graph.
+ * @return Nodes in topological order.
  */
-static struct list *get_topological_order(struct strategic_orchestration_graph *sog)
+static struct list *get_topological_order(struct vine_graph *vg)
 {
-	if (!sog) {
+	if (!vg) {
 		return NULL;
 	}
 
-	int total_nodes = hash_table_size(sog->nodes);
+	int total_nodes = itable_size(vg->nodes);
 	struct list *topo_order = list_create();
-	struct hash_table *in_degree_map = hash_table_create(0, 0);
+	struct itable *in_degree_map = itable_create(0);
 	struct priority_queue *pq = priority_queue_create(total_nodes);
 
-	char *key;
-	struct strategic_orchestration_node *node;
-	HASH_TABLE_ITERATE(sog->nodes, key, node)
+	uint64_t nid;
+	struct vine_node *node;
+	ITABLE_ITERATE(vg->nodes, nid, node)
 	{
 		int deg = list_size(node->parents);
-		hash_table_insert(in_degree_map, key, (void *)(intptr_t)deg);
+		itable_insert(in_degree_map, nid, (void *)(intptr_t)deg);
 		if (deg == 0) {
-			priority_queue_push(pq, node, compute_lex_priority(node->node_key));
+			priority_queue_push(pq, node, -(double)node->node_id);
 		}
 	}
 
 	while (priority_queue_size(pq) > 0) {
-		struct strategic_orchestration_node *current = priority_queue_pop(pq);
+		struct vine_node *current = priority_queue_pop(pq);
 		list_push_tail(topo_order, current);
 
-		struct strategic_orchestration_node *child;
+		struct vine_node *child;
 		LIST_ITERATE(current->children, child)
 		{
-			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, child->node_key);
+			intptr_t raw_deg = (intptr_t)itable_lookup(in_degree_map, child->node_id);
 			int deg = (int)raw_deg - 1;
-
-			hash_table_remove(in_degree_map, child->node_key);
-			hash_table_insert(in_degree_map, child->node_key, (void *)(intptr_t)deg);
+			itable_insert(in_degree_map, child->node_id, (void *)(intptr_t)deg);
 
 			if (deg == 0) {
-				priority_queue_push(pq, child, compute_lex_priority(child->node_key));
+				priority_queue_push(pq, child, -(double)child->node_id);
 			}
 		}
 	}
 
 	if (list_size(topo_order) != total_nodes) {
-		debug(D_ERROR, "Error: strategic orchestration graph contains cycles or is malformed.\n");
-		debug(D_ERROR, "Expected %d nodes, but only sorted %d.\n", total_nodes, list_size(topo_order));
+		debug(D_ERROR, "Error: vine graph contains cycles or is malformed.");
+		debug(D_ERROR, "Expected %d nodes, but only sorted %d.", total_nodes, list_size(topo_order));
 
-		HASH_TABLE_ITERATE(sog->nodes, key, node)
+		uint64_t id;
+		ITABLE_ITERATE(vg->nodes, id, node)
 		{
-			intptr_t raw_deg = (intptr_t)hash_table_lookup(in_degree_map, key);
+			intptr_t raw_deg = (intptr_t)itable_lookup(in_degree_map, id);
 			int deg = (int)raw_deg;
 			if (deg > 0) {
-				debug(D_ERROR, "  Node %s has in-degree %d. Parents:\n", key, deg);
-				struct strategic_orchestration_node *p;
+				debug(D_ERROR, "  Node %" PRIu64 " has in-degree %d. Parents:", id, deg);
+				struct vine_node *p;
 				LIST_ITERATE(node->parents, p)
 				{
-					debug(D_ERROR, "    -> %s\n", p->node_key);
+					debug(D_ERROR, "    -> %" PRIu64, p->node_id);
 				}
 			}
 		}
 
 		list_delete(topo_order);
-		hash_table_delete(in_degree_map);
+		itable_delete(in_degree_map);
 		priority_queue_delete(pq);
 		exit(1);
 	}
 
-	hash_table_delete(in_degree_map);
+	itable_delete(in_degree_map);
 	priority_queue_delete(pq);
 	return topo_order;
 }
 
 /**
- * Extract the weakly connected components of the strategic orchestration graph.
- * This function is used only for debugging purposes at the moment.
- * @param sog Reference to the strategic orchestration graph object.
- * @return The list of weakly connected components.
+ * Extract weakly connected components of the vine graph.
+ * Currently used for debugging and instrumentation only.
+ * @param vg Reference to the vine graph.
+ * @return List of weakly connected components.
  */
-static struct list *extract_weakly_connected_components(struct strategic_orchestration_graph *sog)
+static struct list *extract_weakly_connected_components(struct vine_graph *vg)
 {
-	if (!sog) {
+	if (!vg) {
 		return NULL;
 	}
 
 	struct set *visited = set_create(0);
 	struct list *components = list_create();
 
-	char *node_key;
-	struct strategic_orchestration_node *node;
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	uint64_t nid;
+	struct vine_node *node;
+	ITABLE_ITERATE(vg->nodes, nid, node)
 	{
 		if (set_lookup(visited, node)) {
 			continue;
@@ -289,9 +272,9 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
 		list_push_tail(component, node);
 
 		while (list_size(queue) > 0) {
-			struct strategic_orchestration_node *curr = list_pop_head(queue);
+			struct vine_node *curr = list_pop_head(queue);
 
-			struct strategic_orchestration_node *p;
+			struct vine_node *p;
 			LIST_ITERATE(curr->parents, p)
 			{
 				if (!set_lookup(visited, p)) {
@@ -301,7 +284,7 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
 				}
 			}
 
-			struct strategic_orchestration_node *c;
+			struct vine_node *c;
 			LIST_ITERATE(curr->children, c)
 			{
 				if (!set_lookup(visited, c)) {
@@ -321,11 +304,11 @@ static struct list *extract_weakly_connected_components(struct strategic_orchest
 }
 
 /**
- * Compute the heavy score of a node in the strategic orchestration graph.
- * @param node Reference to the node object.
- * @return The heavy score.
+ * Compute the heavy score of a node in the vine graph.
+ * @param node Reference to the node.
+ * @return Heavy score.
  */
-static double compute_node_heavy_score(struct strategic_orchestration_node *node)
+static double compute_node_heavy_score(struct vine_node *node)
 {
 	if (!node) {
 		return 0;
@@ -338,28 +321,29 @@ static double compute_node_heavy_score(struct strategic_orchestration_node *node
 }
 
 /**
- * Map a task to a node in the strategic orchestration graph.
- * @param sog Reference to the strategic orchestration graph object.
- * @param task Reference to the task object.
- * @return The node object.
+ * Map a TaskVine task back to its vine node.
+ * @param vg Reference to the vine graph.
+ * @param task Task reported by the manager.
+ * @return Matching node.
  */
-static struct strategic_orchestration_node *get_node_by_task(struct strategic_orchestration_graph *sog, struct vine_task *task)
+static struct vine_node *get_node_by_task(struct vine_graph *vg, struct vine_task *task)
 {
-	if (!sog || !task) {
+	if (!vg || !task) {
 		return NULL;
 	}
 
 	if (task->type == VINE_TASK_TYPE_STANDARD) {
 		/* standard tasks are mapped directly to a node */
-		return itable_lookup(sog->task_id_to_node, task->task_id);
+		return itable_lookup(vg->task_id_to_node, (uint64_t)task->task_id);
 	} else if (task->type == VINE_TASK_TYPE_RECOVERY) {
 		/* note that recovery tasks are not mapped to any node but we still need the original node for pruning,
 		 * so we look up the outfile of the task, then map it back to get the original node */
 		struct vine_mount *mount;
 		LIST_ITERATE(task->output_mounts, mount)
 		{
-			if (mount->file->original_producer_task_id > 0) {
-				return itable_lookup(sog->task_id_to_node, mount->file->original_producer_task_id);
+			uint64_t original_producer_task_id = mount->file->original_producer_task_id;
+			if (original_producer_task_id > 0) {
+				return itable_lookup(vg->task_id_to_node, original_producer_task_id);
 			}
 		}
 	}
@@ -371,20 +355,20 @@ static struct strategic_orchestration_node *get_node_by_task(struct strategic_or
 
 /**
  * Prune the ancestors of a persisted node. This is only used for persisted nodes that produce persisted files.
- * All ancestors we consider here include both temp nodes and persisted nodes, becasue data written to shared file system
+ * All ancestors we consider here include both temp nodes and persisted nodes, because data written to the shared file system
  * is safe and can definitely trigger upstream data redundancy to be released.
- * @param sog Reference to the strategic orchestration graph object.
+ * @param vg Reference to the vine graph.
  * @param node Reference to the node object.
  * @return The number of pruned replicas.
  */
-static int prune_ancestors_of_persisted_node(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+static int prune_ancestors_of_persisted_node(struct vine_graph *vg, struct vine_node *node)
 {
-	if (!sog || !node) {
+	if (!vg || !node) {
 		return -1;
 	}
 
 	/* find all safe ancestors */
-	struct set *safe_ancestors = son_find_safe_ancestors(node);
+	struct set *safe_ancestors = vine_node_find_safe_ancestors(node);
 	if (!safe_ancestors) {
 		return 0;
 	}
@@ -394,7 +378,7 @@ static int prune_ancestors_of_persisted_node(struct strategic_orchestration_grap
 	timestamp_t start_time = timestamp_get();
 
 	/* prune all safe ancestors */
-	struct strategic_orchestration_node *ancestor_node;
+	struct vine_node *ancestor_node;
 	SET_ITERATE(safe_ancestors, ancestor_node)
 	{
 		switch (ancestor_node->outfile_type) {
@@ -403,7 +387,7 @@ static int prune_ancestors_of_persisted_node(struct strategic_orchestration_grap
 			break;
 		case NODE_OUTFILE_TYPE_TEMP:
 			/* prune the temp file */
-			vine_prune_file(sog->manager, ancestor_node->outfile);
+			vine_prune_file(vg->manager, ancestor_node->outfile);
 			break;
 		case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
 			/* unlink directly from the shared file system */
@@ -430,13 +414,13 @@ static int prune_ancestors_of_persisted_node(struct strategic_orchestration_grap
  * Files stored in the shared filesystem are never pruned by this function,
  * because temp outputs are not considered sufficiently safe to trigger
  * deletion of persisted data upstream.
- * @param sog Reference to the strategic orchestration graph object.
+ * @param vg Reference to the vine graph.
  * @param node Reference to the node object.
  * @return The number of pruned replicas.
  */
-static int prune_ancestors_of_temp_node(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+static int prune_ancestors_of_temp_node(struct vine_graph *vg, struct vine_node *node)
 {
-	if (!sog || !node || !node->outfile || node->prune_depth <= 0) {
+	if (!vg || !node || !node->outfile || node->prune_depth <= 0) {
 		return 0;
 	}
 
@@ -444,9 +428,9 @@ static int prune_ancestors_of_temp_node(struct strategic_orchestration_graph *so
 
 	int pruned_replica_count = 0;
 
-	struct list *parents = son_find_parents_by_depth(node, node->prune_depth);
+	struct list *parents = vine_node_find_parents_by_depth(node, node->prune_depth);
 
-	struct strategic_orchestration_node *parent_node;
+	struct vine_node *parent_node;
 	LIST_ITERATE(parents, parent_node)
 	{
 		/* skip if the parent does not produce a temp file */
@@ -458,7 +442,7 @@ static int prune_ancestors_of_temp_node(struct strategic_orchestration_graph *so
 		 * 1. it has no pending dependents
 		 * 2. all completed dependents have also completed their corresponding recovery tasks, if any */
 		int all_children_completed = 1;
-		struct strategic_orchestration_node *child_node;
+		struct vine_node *child_node;
 		LIST_ITERATE(parent_node->children, child_node)
 		{
 			/* break early if the child node is not completed */
@@ -479,7 +463,7 @@ static int prune_ancestors_of_temp_node(struct strategic_orchestration_graph *so
 			continue;
 		}
 
-		pruned_replica_count += vine_prune_file(sog->manager, parent_node->outfile);
+		pruned_replica_count += vine_prune_file(vg->manager, parent_node->outfile);
 		/* this parent is pruned because a successor that produces a temp file is completed, it is unsafe because the
 		 * manager may submit a recovery task to bring it back in case of worker failures. */
 		parent_node->prune_status = PRUNE_STATUS_UNSAFE;
@@ -496,13 +480,13 @@ static int prune_ancestors_of_temp_node(struct strategic_orchestration_graph *so
  * Prune the ancestors of a node when it is completed.
  * @param node Reference to the node object.
  */
-static void prune_ancestors_of_node(struct strategic_orchestration_graph *sog, struct strategic_orchestration_node *node)
+static void prune_ancestors_of_node(struct vine_graph *vg, struct vine_node *node)
 {
-	if (!sog || !node) {
+	if (!vg || !node) {
 		return;
 	}
 
-	/* do not prune if the node is not completed */
+	/* do not prune if the node has not completed */
 	if (!node->completed) {
 		return;
 	}
@@ -516,30 +500,30 @@ static void prune_ancestors_of_node(struct strategic_orchestration_graph *sog, s
 	case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
 		/* If the outfile was declared as a VINE_FILE or was written to the shared fs, then it is guaranteed to be persisted
 		 * and there is no chance that it will be lost unexpectedly. So we can safely prune all ancestors of this node. */
-		pruned_replica_count = prune_ancestors_of_persisted_node(sog, node);
+		pruned_replica_count = prune_ancestors_of_persisted_node(vg, node);
 		break;
 	case NODE_OUTFILE_TYPE_TEMP:
 		/* Otherwise, if the node outfile is a temp file, we need to be careful about pruning, because temp files are prone
 		 * to failures, while means they can be lost due to node evictions or failures. */
-		pruned_replica_count = prune_ancestors_of_temp_node(sog, node);
+		pruned_replica_count = prune_ancestors_of_temp_node(vg, node);
 		break;
 	}
 
 	timestamp_t elapsed_time = timestamp_get() - start_time;
 
-	debug(D_VINE, "pruned %d ancestors of node %s in %.6f seconds", pruned_replica_count, node->node_key, elapsed_time / 1000000.0);
+	debug(D_VINE, "pruned %d ancestors of node %" PRIu64 " in %.6f seconds", pruned_replica_count, node->node_id, elapsed_time / 1000000.0);
 
 	return;
 }
 
 /**
- * Print the time metrics of the strategic orchestration graph to a csv file.
- * @param sog Reference to the strategic orchestration graph object.
+ * Print the time metrics of the vine graph to a csv file.
+ * @param vg Reference to the vine graph.
  * @param filename Reference to the filename of the csv file.
  */
-static void print_time_metrics(struct strategic_orchestration_graph *sog, const char *filename)
+static void print_time_metrics(struct vine_graph *vg, const char *filename)
 {
-	if (!sog) {
+	if (!vg) {
 		return;
 	}
 
@@ -554,13 +538,13 @@ static void print_time_metrics(struct strategic_orchestration_graph *sog, const
 		debug(D_ERROR, "failed to open file %s", filename);
 		return;
 	}
-	fprintf(fp, "node_key,submission_time_us,scheduling_time_us,commit_time_us,execution_time_us,retrieval_time_us,postprocessing_time_us\n");
+	fprintf(fp, "node_id,submission_time_us,scheduling_time_us,commit_time_us,execution_time_us,retrieval_time_us,postprocessing_time_us\n");
 
-	char *node_key;
-	struct strategic_orchestration_node *node;
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	uint64_t nid;
+	struct vine_node *node;
+	ITABLE_ITERATE(vg->nodes, nid, node)
 	{
-		fprintf(fp, "%s,%lu,%lu,%lu,%lu,%lu,%lu\n", node_key, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
+		fprintf(fp, "%" PRIu64 ",%lu,%lu,%lu,%lu,%lu,%lu\n", node->node_id, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
 	}
 	fclose(fp);
 
@@ -571,53 +555,53 @@ static void print_time_metrics(struct strategic_orchestration_graph *sog, const
 /* Public APIs */
 /*************************************************************/
 
-/** Tune the strategic orchestration graph.
- *@param sog Reference to the strategic orchestration graph object.
+/** Tune the vine graph.
+ *@param vg Reference to the vine graph.
  *@param name Reference to the name of the parameter to tune.
  *@param value Reference to the value of the parameter to tune.
  *@return 0 on success, -1 on failure.
  */
-int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const char *value)
+int vine_graph_tune(struct vine_graph *vg, const char *name, const char *value)
 {
-	if (!sog || !name || !value) {
+	if (!vg || !name || !value) {
 		return -1;
 	}
 
 	if (strcmp(name, "failure-injection-step-percent") == 0) {
-		sog->failure_injection_step_percent = atof(value);
+		vg->failure_injection_step_percent = atof(value);
 
 	} else if (strcmp(name, "task-priority-mode") == 0) {
 		if (strcmp(value, "random") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_RANDOM;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_RANDOM;
 		} else if (strcmp(value, "depth-first") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_DEPTH_FIRST;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_DEPTH_FIRST;
 		} else if (strcmp(value, "breadth-first") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_BREADTH_FIRST;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_BREADTH_FIRST;
 		} else if (strcmp(value, "fifo") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_FIFO;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_FIFO;
 		} else if (strcmp(value, "lifo") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_LIFO;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_LIFO;
 		} else if (strcmp(value, "largest-input-first") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
 		} else if (strcmp(value, "largest-storage-footprint-first") == 0) {
-			sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST;
+			vg->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST;
 		} else {
 			debug(D_ERROR, "invalid priority mode: %s", value);
 			return -1;
 		}
 
 	} else if (strcmp(name, "output-dir") == 0) {
-		if (sog->output_dir) {
-			free(sog->output_dir);
+		if (vg->output_dir) {
+			free(vg->output_dir);
 		}
 		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
 			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
 			return -1;
 		}
-		sog->output_dir = xxstrdup(value);
+		vg->output_dir = xxstrdup(value);
 
 	} else if (strcmp(name, "prune-depth") == 0) {
-		sog->prune_depth = atoi(value);
+		vg->prune_depth = atoi(value);
 
 	} else if (strcmp(name, "checkpoint-fraction") == 0) {
 		double fraction = atof(value);
@@ -625,39 +609,39 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 			debug(D_ERROR, "invalid checkpoint fraction: %s (must be between 0.0 and 1.0)", value);
 			return -1;
 		}
-		sog->checkpoint_fraction = fraction;
+		vg->checkpoint_fraction = fraction;
 
 	} else if (strcmp(name, "checkpoint-dir") == 0) {
-		if (sog->checkpoint_dir) {
-			free(sog->checkpoint_dir);
+		if (vg->checkpoint_dir) {
+			free(vg->checkpoint_dir);
 		}
 		if (mkdir(value, 0777) != 0 && errno != EEXIST) {
 			debug(D_ERROR, "failed to mkdir %s (errno=%d)", value, errno);
 			return -1;
 		}
-		sog->checkpoint_dir = xxstrdup(value);
+		vg->checkpoint_dir = xxstrdup(value);
 
 	} else if (strcmp(name, "progress-bar-update-interval-sec") == 0) {
 		double val = atof(value);
-		sog->progress_bar_update_interval_sec = (val > 0.0) ? val : 0.1;
+		vg->progress_bar_update_interval_sec = (val > 0.0) ? val : 0.1;
 
 	} else if (strcmp(name, "time-metrics-filename") == 0) {
 		if (strcmp(value, "0") == 0) {
 			return 0;
 		}
 
-		if (sog->time_metrics_filename) {
-			free(sog->time_metrics_filename);
+		if (vg->time_metrics_filename) {
+			free(vg->time_metrics_filename);
 		}
 
-		sog->time_metrics_filename = xxstrdup(value);
+		vg->time_metrics_filename = xxstrdup(value);
 
 		/** Extract parent directory inline **/
-		const char *slash = strrchr(sog->time_metrics_filename, '/');
+		const char *slash = strrchr(vg->time_metrics_filename, '/');
 		if (slash) {
-			size_t len = slash - sog->time_metrics_filename;
+			size_t len = slash - vg->time_metrics_filename;
 			char *parent = malloc(len + 1);
-			memcpy(parent, sog->time_metrics_filename, len);
+			memcpy(parent, vg->time_metrics_filename, len);
 			parent[len] = '\0';
 
 			/** Ensure the parent directory exists **/
@@ -670,19 +654,19 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 		}
 
 		/** Truncate or create the file **/
-		FILE *fp = fopen(sog->time_metrics_filename, "w");
+		FILE *fp = fopen(vg->time_metrics_filename, "w");
 		if (!fp) {
-			debug(D_ERROR, "failed to create file %s (errno=%d)", sog->time_metrics_filename, errno);
+			debug(D_ERROR, "failed to create file %s (errno=%d)", vg->time_metrics_filename, errno);
 			return -1;
 		}
 		fclose(fp);
 
 	} else if (strcmp(name, "enable-debug-log") == 0) {
-		if (sog->enable_debug_log == 0) {
+		if (vg->enable_debug_log == 0) {
 			return -1;
 		}
-		sog->enable_debug_log = (atoi(value) == 1) ? 1 : 0;
-		if (sog->enable_debug_log == 0) {
+		vg->enable_debug_log = (atoi(value) == 1) ? 1 : 0;
+		if (vg->enable_debug_log == 0) {
 			debug_flags_clear();
 			debug_close();
 		}
@@ -696,18 +680,18 @@ int sog_tune(struct strategic_orchestration_graph *sog, const char *name, const
 }
 
 /**
- * Get the outfile remote name of a node in the strategic orchestration graph.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node_key Reference to the node key.
+ * Get the outfile remote name of a node in the vine graph.
+ * @param vg Reference to the vine graph.
+ * @param node_id Reference to the node id.
  * @return The outfile remote name.
  */
-const char *sog_get_node_outfile_remote_name(const struct strategic_orchestration_graph *sog, const char *node_key)
+const char *vine_graph_get_node_outfile_remote_name(const struct vine_graph *vg, uint64_t node_id)
 {
-	if (!sog || !node_key) {
+	if (!vg) {
 		return NULL;
 	}
 
-	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
+	struct vine_node *node = itable_lookup(vg->nodes, node_id);
 	if (!node) {
 		return NULL;
 	}
@@ -716,50 +700,50 @@ const char *sog_get_node_outfile_remote_name(const struct strategic_orchestratio
 }
 
 /**
- * Get the proxy library name of the strategic orchestration graph.
- * @param sog Reference to the strategic orchestration graph object.
+ * Get the proxy library name of the vine graph.
+ * @param vg Reference to the vine graph.
  * @return The proxy library name.
  */
-const char *sog_get_proxy_library_name(const struct strategic_orchestration_graph *sog)
+const char *vine_graph_get_proxy_library_name(const struct vine_graph *vg)
 {
-	if (!sog) {
+	if (!vg) {
 		return NULL;
 	}
 
-	return sog->proxy_library_name;
+	return vg->proxy_library_name;
 }
 
 /**
- * Set the proxy function name of the strategic orchestration graph.
- * @param sog Reference to the strategic orchestration graph object.
+ * Set the proxy function name of the vine graph.
+ * @param vg Reference to the vine graph.
  * @param proxy_function_name Reference to the proxy function name.
  */
-void sog_set_proxy_function_name(struct strategic_orchestration_graph *sog, const char *proxy_function_name)
+void vine_graph_set_proxy_function_name(struct vine_graph *vg, const char *proxy_function_name)
 {
-	if (!sog || !proxy_function_name) {
+	if (!vg || !proxy_function_name) {
 		return;
 	}
 
-	if (sog->proxy_function_name) {
-		free(sog->proxy_function_name);
+	if (vg->proxy_function_name) {
+		free(vg->proxy_function_name);
 	}
 
-	sog->proxy_function_name = xxstrdup(proxy_function_name);
+	vg->proxy_function_name = xxstrdup(proxy_function_name);
 }
 
 /**
- * Get the heavy score of a node in the strategic orchestration graph.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node_key Reference to the node key.
+ * Get the heavy score of a node in the vine graph.
+ * @param vg Reference to the vine graph.
+ * @param node_id Reference to the node id.
  * @return The heavy score.
  */
-double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog, const char *node_key)
+double vine_graph_get_node_heavy_score(const struct vine_graph *vg, uint64_t node_id)
 {
-	if (!sog) {
+	if (!vg) {
 		return -1;
 	}
 
-	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
+	struct vine_node *node = itable_lookup(vg->nodes, node_id);
 	if (!node) {
 		return -1;
 	}
@@ -768,26 +752,26 @@ double sog_get_node_heavy_score(const struct strategic_orchestration_graph *sog,
 }
 
 /**
- * Get the local outfile source of a node in the strategic orchestration graph, only valid for local output files.
+ * Get the local outfile source of a node in the vine graph, only valid for local output files.
  * The source of a local output file is the path on the local filesystem.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node_key Reference to the node key.
+ * @param vg Reference to the vine graph.
+ * @param node_id Reference to the node id.
  * @return The local outfile source.
  */
-const char *sog_get_node_local_outfile_source(const struct strategic_orchestration_graph *sog, const char *node_key)
+const char *vine_graph_get_node_local_outfile_source(const struct vine_graph *vg, uint64_t node_id)
 {
-	if (!sog || !node_key) {
+	if (!vg) {
 		return NULL;
 	}
 
-	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
+	struct vine_node *node = itable_lookup(vg->nodes, node_id);
 	if (!node) {
-		debug(D_ERROR, "node %s not found", node_key);
+		debug(D_ERROR, "node %" PRIu64 " not found", node_id);
 		exit(1);
 	}
 
 	if (node->outfile_type != NODE_OUTFILE_TYPE_LOCAL) {
-		debug(D_ERROR, "node %s is not a local output file", node_key);
+		debug(D_ERROR, "node %" PRIu64 " is not a local output file", node_id);
 		exit(1);
 	}
 
@@ -795,26 +779,25 @@ const char *sog_get_node_local_outfile_source(const struct strategic_orchestrati
 }
 
 /**
- * Compute the topology metrics of the strategic orchestration graph, including depth, height, upstream and downstream counts,
+ * Compute the topology metrics of the vine graph, including depth, height, upstream and downstream counts,
  * heavy scores, and weakly connected components. Must be called after all nodes and dependencies are added.
- * @param sog Reference to the strategic orchestration graph object.
+ * @param vg Reference to the vine graph.
  */
-void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
+void vine_graph_compute_topology_metrics(struct vine_graph *vg)
 {
-	if (!sog) {
+	if (!vg) {
 		return;
 	}
 
 	/* get nodes in topological order */
-	struct list *topo_order = get_topological_order(sog);
+	struct list *topo_order = get_topological_order(vg);
 	if (!topo_order) {
 		return;
 	}
 
-	char *node_key;
-	struct strategic_orchestration_node *node;
-	struct strategic_orchestration_node *parent_node;
-	struct strategic_orchestration_node *child_node;
+	struct vine_node *node;
+	struct vine_node *parent_node;
+	struct vine_node *child_node;
 
 	/* compute the depth of the node */
 	LIST_ITERATE(topo_order, node)
@@ -841,46 +824,47 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 	}
 
 	/* compute the upstream and downstream counts for each node */
-	struct hash_table *upstream_map = hash_table_create(0, 0);
-	struct hash_table *downstream_map = hash_table_create(0, 0);
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	struct itable *upstream_map = itable_create(0);
+	struct itable *downstream_map = itable_create(0);
+	uint64_t nid_tmp;
+	ITABLE_ITERATE(vg->nodes, nid_tmp, node)
 	{
 		struct set *upstream = set_create(0);
 		struct set *downstream = set_create(0);
-		hash_table_insert(upstream_map, node_key, upstream);
-		hash_table_insert(downstream_map, node_key, downstream);
+		itable_insert(upstream_map, node->node_id, upstream);
+		itable_insert(downstream_map, node->node_id, downstream);
 	}
 	LIST_ITERATE(topo_order, node)
 	{
-		struct set *upstream = hash_table_lookup(upstream_map, node->node_key);
+		struct set *upstream = itable_lookup(upstream_map, node->node_id);
 		LIST_ITERATE(node->parents, parent_node)
 		{
-			struct set *parent_upstream = hash_table_lookup(upstream_map, parent_node->node_key);
+			struct set *parent_upstream = itable_lookup(upstream_map, parent_node->node_id);
 			set_union(upstream, parent_upstream);
 			set_insert(upstream, parent_node);
 		}
 	}
 	LIST_ITERATE_REVERSE(topo_order, node)
 	{
-		struct set *downstream = hash_table_lookup(downstream_map, node->node_key);
+		struct set *downstream = itable_lookup(downstream_map, node->node_id);
 		LIST_ITERATE(node->children, child_node)
 		{
-			struct set *child_downstream = hash_table_lookup(downstream_map, child_node->node_key);
+			struct set *child_downstream = itable_lookup(downstream_map, child_node->node_id);
 			set_union(downstream, child_downstream);
 			set_insert(downstream, child_node);
 		}
 	}
 	LIST_ITERATE(topo_order, node)
 	{
-		node->upstream_subgraph_size = set_size(hash_table_lookup(upstream_map, node->node_key));
-		node->downstream_subgraph_size = set_size(hash_table_lookup(downstream_map, node->node_key));
+		node->upstream_subgraph_size = set_size(itable_lookup(upstream_map, node->node_id));
+		node->downstream_subgraph_size = set_size(itable_lookup(downstream_map, node->node_id));
 		node->fan_in = list_size(node->parents);
 		node->fan_out = list_size(node->children);
-		set_delete(hash_table_lookup(upstream_map, node->node_key));
-		set_delete(hash_table_lookup(downstream_map, node->node_key));
+		set_delete(itable_lookup(upstream_map, node->node_id));
+		set_delete(itable_lookup(downstream_map, node->node_id));
 	}
-	hash_table_delete(upstream_map);
-	hash_table_delete(downstream_map);
+	itable_delete(upstream_map);
+	itable_delete(downstream_map);
 
 	/* compute the heavy score for each node */
 	LIST_ITERATE(topo_order, node)
@@ -894,13 +878,13 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 	struct priority_queue *sorted_nodes = priority_queue_create(total_nodes);
 	LIST_ITERATE(topo_order, node)
 	{
-		if (node->is_target_key) {
+		if (node->is_target) {
 			total_target_nodes++;
 		}
 		priority_queue_push(sorted_nodes, node, node->heavy_score);
 	}
 	/* calculate the number of nodes to be checkpointed */
-	int checkpoint_count = (int)((total_nodes - total_target_nodes) * sog->checkpoint_fraction);
+	int checkpoint_count = (int)((total_nodes - total_target_nodes) * vg->checkpoint_fraction);
 	if (checkpoint_count < 0) {
 		checkpoint_count = 0;
 	}
@@ -908,18 +892,18 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 	/* assign outfile types to each node */
 	int assigned_checkpoint_count = 0;
 	while ((node = priority_queue_pop(sorted_nodes))) {
-		if (node->is_target_key) {
+		if (node->is_target) {
 			/* declare the output file as a vine_file so that it can be retrieved by the manager as usual */
 			node->outfile_type = NODE_OUTFILE_TYPE_LOCAL;
-			char *local_outfile_path = string_format("%s/%s", sog->output_dir, node->outfile_remote_name);
-			node->outfile = vine_declare_file(sog->manager, local_outfile_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
+			char *local_outfile_path = string_format("%s/%s", vg->output_dir, node->outfile_remote_name);
+			node->outfile = vine_declare_file(vg->manager, local_outfile_path, VINE_CACHE_LEVEL_WORKFLOW, 0);
 			free(local_outfile_path);
 			continue;
 		}
 		if (assigned_checkpoint_count < checkpoint_count) {
 			/* checkpointed files will be written directly to the shared file system, no need to manage them in the manager */
 			node->outfile_type = NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM;
-			char *shared_file_system_outfile_path = string_format("%s/%s", sog->checkpoint_dir, node->outfile_remote_name);
+			char *shared_file_system_outfile_path = string_format("%s/%s", vg->checkpoint_dir, node->outfile_remote_name);
 			free(node->outfile_remote_name);
 			node->outfile_remote_name = shared_file_system_outfile_path;
 			node->outfile = NULL;
@@ -927,7 +911,7 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 		} else {
 			/* other nodes will be declared as temp files to leverage node-local storage */
 			node->outfile_type = NODE_OUTFILE_TYPE_TEMP;
-			node->outfile = vine_declare_temp(sog->manager);
+			node->outfile = vine_declare_temp(vg->manager);
 		}
 	}
 	/* track the output dependencies of regular and vine_temp nodes */
@@ -940,7 +924,7 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 	priority_queue_delete(sorted_nodes);
 
 	/* extract weakly connected components */
-	struct list *weakly_connected_components = extract_weakly_connected_components(sog);
+	struct list *weakly_connected_components = extract_weakly_connected_components(vg);
 	struct list *component;
 	int component_index = 0;
 	debug(D_VINE, "graph has %d weakly connected components\n", list_size(weakly_connected_components));
@@ -958,135 +942,156 @@ void sog_compute_topology_metrics(struct strategic_orchestration_graph *sog)
 }
 
 /**
- * Create a new node and track it in the strategic orchestration graph.
- * @param sog Reference to the strategic orchestration graph object.
- * @param node_key Reference to the node key.
- * @param is_target_key Reference to whether the node is a target key.
- * @return A new node object.
+ * Create a new node and track it in the vine graph.
+ * @param vg Reference to the vine graph.
+ * @return The auto-assigned node id.
  */
-void sog_add_node(struct strategic_orchestration_graph *sog, const char *node_key, int is_target_key)
+uint64_t vine_graph_add_node(struct vine_graph *vg)
 {
-	if (!sog || !node_key) {
-		return;
+	if (!vg) {
+		return 0;
 	}
 
-	/* if the node already exists, skip creating a new one */
-	struct strategic_orchestration_node *node = hash_table_lookup(sog->nodes, node_key);
+	/* assign a new id based on current node count, ensure uniqueness */
+	uint64_t candidate_id = itable_size(vg->nodes);
+	candidate_id += 1;
+	while (itable_lookup(vg->nodes, candidate_id)) {
+		candidate_id++;
+	}
+	uint64_t node_id = candidate_id;
+
+	/* create the backing node (defaults to non-target) */
+	struct vine_node *node = vine_node_create(node_id);
+
 	if (!node) {
-		node = son_create(node_key, is_target_key);
+		debug(D_ERROR, "failed to create node %" PRIu64, node_id);
+		vine_graph_delete(vg);
+		exit(1);
+	}
 
-		if (!node) {
-			debug(D_ERROR, "failed to create node %s", node_key);
-			sog_delete(sog);
-			exit(1);
-		}
+	if (!vg->proxy_function_name) {
+		debug(D_ERROR, "proxy function name is not set");
+		vine_graph_delete(vg);
+		exit(1);
+	}
 
-		if (!sog->proxy_function_name) {
-			debug(D_ERROR, "proxy function name is not set");
-			sog_delete(sog);
-			exit(1);
-		}
+	if (!vg->proxy_library_name) {
+		debug(D_ERROR, "proxy library name is not set");
+		vine_graph_delete(vg);
+		exit(1);
+	}
 
-		if (!sog->proxy_library_name) {
-			debug(D_ERROR, "proxy library name is not set");
-			sog_delete(sog);
-			exit(1);
-		}
+	/* create node task */
+	node->task = vine_task_create(vg->proxy_function_name);
+	vine_task_set_library_required(node->task, vg->proxy_library_name);
+	vine_task_addref(node->task);
 
-		/* create node task */
-		node->task = vine_task_create(sog->proxy_function_name);
-		vine_task_set_library_required(node->task, sog->proxy_library_name);
-		vine_task_addref(node->task);
+	/* construct the task arguments and declare the infile */
+	char *task_arguments = vine_node_construct_task_arguments(node);
+	node->infile = vine_declare_buffer(vg->manager, task_arguments, strlen(task_arguments), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
+	free(task_arguments);
+	vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
 
-		/* construct the task arguments and declare the infile */
-		char *task_arguments = son_construct_task_arguments(node);
-		node->infile = vine_declare_buffer(sog->manager, task_arguments, strlen(task_arguments), VINE_CACHE_LEVEL_TASK, VINE_UNLINK_WHEN_DONE);
-		free(task_arguments);
-		vine_task_add_input(node->task, node->infile, "infile", VINE_TRANSFER_ALWAYS);
+	/* initialize the pruning depth of each node, currently statically set to the global prune depth */
+	node->prune_depth = vg->prune_depth;
 
-		/* initialize the pruning depth of each node, currently statically set to the global prune depth */
-		node->prune_depth = sog->prune_depth;
+	itable_insert(vg->nodes, node_id, node);
 
-		hash_table_insert(sog->nodes, node_key, node);
+	return node_id;
+}
+
+/**
+ * Mark a node as a retrieval target.
+ */
+void vine_graph_set_target(struct vine_graph *vg, uint64_t node_id)
+{
+	if (!vg) {
+		return;
+	}
+	struct vine_node *node = itable_lookup(vg->nodes, node_id);
+	if (!node) {
+		debug(D_ERROR, "node %" PRIu64 " not found", node_id);
+		exit(1);
 	}
+	node->is_target = 1;
 }
 
 /**
- * Create a new strategic orchestration graph object and bind a manager to it.
+ * Create a new vine graph and bind a manager to it.
  * @param q Reference to the manager object.
- * @return A new strategic orchestration graph object.
+ * @return A new vine graph instance.
  */
-struct strategic_orchestration_graph *sog_create(struct vine_manager *q)
+struct vine_graph *vine_graph_create(struct vine_manager *q)
 {
 	if (!q) {
 		return NULL;
 	}
 
-	struct strategic_orchestration_graph *sog = xxmalloc(sizeof(struct strategic_orchestration_graph));
+	struct vine_graph *vg = xxmalloc(sizeof(struct vine_graph));
 
-	sog->manager = q;
+	vg->manager = q;
 
-	sog->checkpoint_dir = xxstrdup(sog->manager->runtime_directory); // default to current working directory
-	sog->output_dir = xxstrdup(sog->manager->runtime_directory);	 // default to current working directory
+	vg->checkpoint_dir = xxstrdup(vg->manager->runtime_directory); // default to current working directory
+	vg->output_dir = xxstrdup(vg->manager->runtime_directory);     // default to current working directory
 
-	sog->nodes = hash_table_create(0, 0);
-	sog->task_id_to_node = itable_create(0);
-	sog->outfile_cachename_to_node = hash_table_create(0, 0);
+	vg->nodes = itable_create(0);
+	vg->task_id_to_node = itable_create(0);
+	vg->outfile_cachename_to_node = hash_table_create(0, 0);
 
 	cctools_uuid_t proxy_library_name_id;
 	cctools_uuid_create(&proxy_library_name_id);
-	sog->proxy_library_name = xxstrdup(proxy_library_name_id.str);
+	vg->proxy_library_name = xxstrdup(proxy_library_name_id.str);
 
-	sog->proxy_function_name = NULL;
+	vg->proxy_function_name = NULL;
 
-	sog->prune_depth = 1;
+	vg->prune_depth = 1;
 
-	sog->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
-	sog->failure_injection_step_percent = -1.0;
+	vg->task_priority_mode = TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST;
+	vg->failure_injection_step_percent = -1.0;
 
-	sog->progress_bar_update_interval_sec = 0.1;
+	vg->progress_bar_update_interval_sec = 0.1;
 
 	/* enable debug system for C code since it uses a separate debug system instance
 	 * from the Python bindings. Use the same function that the manager uses. */
-	char *debug_tmp = string_format("%s/vine-logs/debug", sog->manager->runtime_directory);
+	char *debug_tmp = string_format("%s/vine-logs/debug", vg->manager->runtime_directory);
 	vine_enable_debug_log(debug_tmp);
 	free(debug_tmp);
 
-	sog->time_metrics_filename = NULL;
+	vg->time_metrics_filename = NULL;
 
-	sog->enable_debug_log = 1;
+	vg->enable_debug_log = 1;
 
-	return sog;
+	return vg;
 }
 
 /**
- * Add a dependency between two nodes in the strategic orchestration graph. Note that the input-output file relationship
- * is not handled here, because their file names may have not been determined yet.
- * @param sog Reference to the strategic orchestration graph object.
- * @param parent_key Reference to the parent node key.
- * @param child_key Reference to the child node key.
+ * Add a dependency between two nodes in the vine graph. Note that the input-output file relationship
+ * is not handled here, because their file names might not have been determined yet.
+ * @param vg Reference to the vine graph.
+ * @param parent_id Reference to the parent node id.
+ * @param child_id Reference to the child node id.
  */
-void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *parent_key, const char *child_key)
+void vine_graph_add_dependency(struct vine_graph *vg, uint64_t parent_id, uint64_t child_id)
 {
-	if (!sog || !parent_key || !child_key) {
+	if (!vg) {
 		return;
 	}
 
-	struct strategic_orchestration_node *parent_node = hash_table_lookup(sog->nodes, parent_key);
-	struct strategic_orchestration_node *child_node = hash_table_lookup(sog->nodes, child_key);
+	struct vine_node *parent_node = itable_lookup(vg->nodes, parent_id);
+	struct vine_node *child_node = itable_lookup(vg->nodes, child_id);
 	if (!parent_node) {
-		debug(D_ERROR, "parent node %s not found", parent_key);
-		char *node_key = NULL;
-		struct strategic_orchestration_node *node;
-		printf("parent_keys:\n");
-		HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+		debug(D_ERROR, "parent node %" PRIu64 " not found", parent_id);
+		uint64_t nid;
+		struct vine_node *node;
+		printf("parent_ids:\n");
+		ITABLE_ITERATE(vg->nodes, nid, node)
 		{
-			printf("  %s\n", node->node_key);
+			printf("  %" PRIu64 "\n", node->node_id);
 		}
 		exit(1);
 	}
 	if (!child_node) {
-		debug(D_ERROR, "child node %s not found", child_key);
+		debug(D_ERROR, "child node %" PRIu64 " not found", child_id);
 		exit(1);
 	}
 
@@ -1097,43 +1102,43 @@ void sog_add_dependency(struct strategic_orchestration_graph *sog, const char *p
 }
 
 /**
- * Execute the strategic orchestration graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
- * @param sog Reference to the strategic orchestration graph object.
+ * Execute the vine graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
+ * @param vg Reference to the vine graph.
  */
-void sog_execute(struct strategic_orchestration_graph *sog)
+void vine_graph_execute(struct vine_graph *vg)
 {
-	if (!sog) {
+	if (!vg) {
 		return;
 	}
 
 	signal(SIGINT, handle_sigint);
 
-	debug(D_VINE, "start executing strategic orchestration graph");
+	debug(D_VINE, "start executing vine graph");
 
 	/* print the info of all nodes */
-	char *node_key;
-	struct strategic_orchestration_node *node;
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	uint64_t nid_iter;
+	struct vine_node *node;
+	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
-		son_debug_print(node);
+		vine_node_debug_print(node);
 	}
 
 	/* enable return recovery tasks */
-	vine_enable_return_recovery_tasks(sog->manager);
+	vine_enable_return_recovery_tasks(vg->manager);
 
-	/* create mapping from task_id and outfile cached_name to node */
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	/* create mappings from task IDs and outfile cache names to nodes */
+	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
 		if (node->outfile) {
-			hash_table_insert(sog->outfile_cachename_to_node, node->outfile->cached_name, node);
+			hash_table_insert(vg->outfile_cachename_to_node, node->outfile->cached_name, node);
 		}
 	}
 
 	/* add the parents' outfiles as inputs to the task */
-	struct list *topo_order = get_topological_order(sog);
+	struct list *topo_order = get_topological_order(vg);
 	LIST_ITERATE(topo_order, node)
 	{
-		struct strategic_orchestration_node *parent_node;
+		struct vine_node *parent_node;
 		LIST_ITERATE(node->parents, parent_node)
 		{
 			if (parent_node->outfile) {
@@ -1143,36 +1148,36 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	}
 
 	/* initialize pending_parents for all nodes */
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
-		struct strategic_orchestration_node *parent_node;
+		struct vine_node *parent_node;
 		LIST_ITERATE(node->parents, parent_node)
 		{
 			if (node->pending_parents) {
-				/* Use parent_node->node_key to ensure pointer consistency */
+				/* Use parent pointer to ensure pointer consistency */
 				set_insert(node->pending_parents, parent_node);
 			}
 		}
 	}
 
 	/* enqueue those without dependencies */
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
 		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
-			submit_node_task(sog, node);
+			submit_node_task(vg, node);
 		}
 	}
 
 	/* calculate steps to inject failure */
 	double next_failure_threshold = -1.0;
-	if (sog->failure_injection_step_percent > 0) {
-		next_failure_threshold = sog->failure_injection_step_percent / 100.0;
+	if (vg->failure_injection_step_percent > 0) {
+		next_failure_threshold = vg->failure_injection_step_percent / 100.0;
 	}
 
 	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
-	progress_bar_set_update_interval(pbar, sog->progress_bar_update_interval_sec);
+	progress_bar_set_update_interval(pbar, vg->progress_bar_update_interval_sec);
 
-	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", hash_table_size(sog->nodes));
+	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", itable_size(vg->nodes));
 	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
 	progress_bar_bind_part(pbar, regular_tasks_part);
 	progress_bar_bind_part(pbar, recovery_tasks_part);
@@ -1184,8 +1189,8 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			break;
 		}
 
-		struct vine_task *task = vine_wait(sog->manager, wait_timeout);
-		progress_bar_set_part_total(pbar, recovery_tasks_part, sog->manager->num_submitted_recovery_tasks);
+		struct vine_task *task = vine_wait(vg->manager, wait_timeout);
+		progress_bar_set_part_total(pbar, recovery_tasks_part, vg->manager->num_submitted_recovery_tasks);
 		if (task) {
 			/* retrieve all possible tasks */
 			wait_timeout = 0;
@@ -1193,7 +1198,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			timestamp_t time_when_postprocessing_start = timestamp_get();
 
 			/* get the original node by task id */
-			struct strategic_orchestration_node *node = get_node_by_task(sog, task);
+			struct vine_node *node = get_node_by_task(vg, task);
 			if (!node) {
 				debug(D_ERROR, "fatal: task %d could not be mapped to a task node, this indicates a serious bug.", task->task_id);
 				exit(1);
@@ -1202,14 +1207,14 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			/* in case of failure, resubmit this task */
 			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
 				if (node->retry_attempts_left <= 0) {
-					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %s has no retries left. Aborting.", task->task_id, node->task->result, node->task->exit_code, node->node_key);
-					sog_delete(sog);
+					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %" PRIu64 " has no retries left. Aborting.", task->task_id, node->task->result, node->task->exit_code, node->node_id);
+					vine_graph_delete(vg);
 					exit(1);
 				}
 				node->retry_attempts_left--;
-				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %s (remaining=%d)...", task->task_id, node->task->result, node->task->exit_code, node->node_key, node->retry_attempts_left);
+				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %" PRIu64 " (remaining=%d)...", task->task_id, node->task->result, node->task->exit_code, node->node_id, node->retry_attempts_left);
 				vine_task_reset(node->task);
-				submit_node_task(sog, node);
+				submit_node_task(vg, node);
 				continue;
 			}
 
@@ -1220,14 +1225,14 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 				int result = stat(node->outfile_remote_name, &info);
 				if (result < 0) {
 					if (node->retry_attempts_left <= 0) {
-						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %s. Aborting.", task->task_id, node->outfile_remote_name, node->node_key);
-						sog_delete(sog);
+						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %" PRIu64 ". Aborting.", task->task_id, node->outfile_remote_name, node->node_id);
+						vine_graph_delete(vg);
 						exit(1);
 					}
 					node->retry_attempts_left--;
-					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %s (remaining=%d)...", task->task_id, node->outfile_remote_name, node->node_key, node->retry_attempts_left);
+					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %" PRIu64 " (remaining=%d)...", task->task_id, node->outfile_remote_name, node->node_id, node->retry_attempts_left);
 					vine_task_reset(node->task);
-					submit_node_task(sog, node);
+					submit_node_task(vg, node);
 					continue;
 				}
 				node->outfile_size_bytes = info.st_size;
@@ -1238,7 +1243,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 				node->outfile_size_bytes = node->outfile->size;
 				break;
 			}
-			debug(D_VINE, "Node %s completed with outfile %s size: %zu bytes", node->node_key, node->outfile_remote_name, node->outfile_size_bytes);
+			debug(D_VINE, "Node %" PRIu64 " completed with outfile %s size: %zu bytes", node->node_id, node->outfile_remote_name, node->outfile_size_bytes);
 
 			/* mark the node as completed */
 			node->completed = 1;
@@ -1248,7 +1253,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			node->retrieval_time = task->time_when_get_result_end - task->time_when_get_result_start;
 
 			/* prune nodes on task completion */
-			prune_ancestors_of_node(sog, node);
+			prune_ancestors_of_node(vg, node);
 
 			/* skip recovery tasks */
 			if (task->type == VINE_TASK_TYPE_RECOVERY) {
@@ -1262,17 +1267,17 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			}
 
 			/* update critical time */
-			son_update_critical_path_time(node, node->execution_time);
+			vine_node_update_critical_path_time(node, node->execution_time);
 
 			/* mark this regular task as completed */
 			progress_bar_update_part(pbar, regular_tasks_part, 1);
 
 			/* inject failure */
-			if (sog->failure_injection_step_percent > 0) {
+			if (vg->failure_injection_step_percent > 0) {
 				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
-				if (progress >= next_failure_threshold && evict_random_worker(sog->manager)) {
+				if (progress >= next_failure_threshold && evict_random_worker(vg->manager)) {
 					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
-					next_failure_threshold += sog->failure_injection_step_percent / 100.0;
+					next_failure_threshold += vg->failure_injection_step_percent / 100.0;
 				}
 			}
 
@@ -1280,7 +1285,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			switch (node->outfile_type) {
 			case NODE_OUTFILE_TYPE_TEMP:
 				/* replicate the outfile of the temp node */
-				vine_temp_replicate_file_later(sog->manager, node->outfile);
+				vine_temp_replicate_file_later(vg->manager, node->outfile);
 				break;
 			case NODE_OUTFILE_TYPE_LOCAL:
 			case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
@@ -1288,7 +1293,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 			}
 
 			/* submit children nodes with dependencies all resolved */
-			submit_unblocked_children(sog, node);
+			submit_unblocked_children(vg, node);
 
 			timestamp_t time_when_postprocessing_end = timestamp_get();
 			node->postprocessing_time = time_when_postprocessing_end - time_when_postprocessing_start;
@@ -1304,7 +1309,7 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	double total_time_spent_on_unlink_local_files = 0;
 	double total_time_spent_on_prune_ancestors_of_temp_node = 0;
 	double total_time_spent_on_prune_ancestors_of_persisted_node = 0;
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
 		total_time_spent_on_unlink_local_files += node->time_spent_on_unlink_local_files;
 		total_time_spent_on_prune_ancestors_of_temp_node += node->time_spent_on_prune_ancestors_of_temp_node;
@@ -1318,47 +1323,47 @@ void sog_execute(struct strategic_orchestration_graph *sog)
 	debug(D_VINE, "total time spent on prune ancestors of persisted node: %.6f seconds\n", total_time_spent_on_prune_ancestors_of_persisted_node);
 	debug(D_VINE, "total time spent on unlink local files: %.6f seconds\n", total_time_spent_on_unlink_local_files);
 
-	if (sog->time_metrics_filename) {
-		print_time_metrics(sog, sog->time_metrics_filename);
+	if (vg->time_metrics_filename) {
+		print_time_metrics(vg, vg->time_metrics_filename);
 	}
 
 	return;
 }
 
 /**
- * Delete a strategic orchestration graph object.
- * @param sog Reference to the strategic orchestration graph object.
+ * Delete a vine graph instance.
+ * @param vg Reference to the vine graph.
  */
-void sog_delete(struct strategic_orchestration_graph *sog)
+void vine_graph_delete(struct vine_graph *vg)
 {
-	if (!sog) {
+	if (!vg) {
 		return;
 	}
 
-	char *node_key;
-	struct strategic_orchestration_node *node;
-	HASH_TABLE_ITERATE(sog->nodes, node_key, node)
+	uint64_t nid;
+	struct vine_node *node;
+	ITABLE_ITERATE(vg->nodes, nid, node)
 	{
 		if (node->infile) {
-			vine_prune_file(sog->manager, node->infile);
-			hash_table_remove(sog->manager->file_table, node->infile->cached_name);
+			vine_prune_file(vg->manager, node->infile);
+			hash_table_remove(vg->manager->file_table, node->infile->cached_name);
 		}
 		if (node->outfile) {
-			vine_prune_file(sog->manager, node->outfile);
-			hash_table_remove(sog->outfile_cachename_to_node, node->outfile->cached_name);
-			hash_table_remove(sog->manager->file_table, node->outfile->cached_name);
+			vine_prune_file(vg->manager, node->outfile);
+			hash_table_remove(vg->outfile_cachename_to_node, node->outfile->cached_name);
+			hash_table_remove(vg->manager->file_table, node->outfile->cached_name);
 		}
 		if (node->outfile_type == NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM) {
 			unlink(node->outfile_remote_name);
 		}
-		son_delete(node);
+		vine_node_delete(node);
 	}
 
-	free(sog->proxy_library_name);
-	free(sog->proxy_function_name);
+	free(vg->proxy_library_name);
+	free(vg->proxy_function_name);
 
-	hash_table_delete(sog->nodes);
-	itable_delete(sog->task_id_to_node);
-	hash_table_delete(sog->outfile_cachename_to_node);
-	free(sog);
+	itable_delete(vg->nodes);
+	itable_delete(vg->task_id_to_node);
+	hash_table_delete(vg->outfile_cachename_to_node);
+	free(vg);
 }
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph.h b/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
new file mode 100644
index 0000000000..f749f442ab
--- /dev/null
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
@@ -0,0 +1,150 @@
+#ifndef VINE_GRAPH_H
+#define VINE_GRAPH_H
+
+#include <stdint.h>
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "itable.h"
+#include "list.h"
+#include "vine_manager.h"
+#include "set.h"
+#include "vine_node.h"
+#include "taskvine.h"
+
+/** The task priority algorithm used for vine graph scheduling. */
+typedef enum {
+	TASK_PRIORITY_MODE_RANDOM = 0,			   /**< Assign random priority to tasks */
+	TASK_PRIORITY_MODE_DEPTH_FIRST,			   /**< Prioritize deeper tasks first */
+	TASK_PRIORITY_MODE_BREADTH_FIRST,		   /**< Prioritize shallower tasks first */
+	TASK_PRIORITY_MODE_FIFO,			   /**< First in, first out priority */
+	TASK_PRIORITY_MODE_LIFO,			   /**< Last in, first out priority */
+	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		   /**< Prioritize tasks with larger inputs first */
+	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+} task_priority_mode_t;
+
+/** The vine graph (logical scheduling layer). */
+struct vine_graph {
+	struct vine_manager *manager;
+	struct itable *nodes;
+	struct itable *task_id_to_node;
+	struct hash_table *outfile_cachename_to_node;
+
+	/* The directory to store the checkpointed results.
+	 * Only intermediate results can be checkpointed, the fraction of intermediate results to checkpoint is controlled by the checkpoint-fraction parameter. */
+	char *checkpoint_dir;
+
+	/* Results of target nodes will be stored in this directory.
+	 * This dir path can not necessarily be a shared file system directory,
+	 * output files will be retrieved through the network instead,
+	 * as long as the manager can access it. */
+	char *output_dir;
+
+	/* Python-side proxy library name. ContextGraph owns this library and sends calls into the vine graph
+	 * so the manager can execute them through the proxy function. */
+	char *proxy_library_name;
+
+	/* The proxy function lives inside that library. It receives vine node IDs, looks up the
+	 * Python callable and arguments inside ContextGraph, and executes the work. ContextGraph generates the name
+	 * and shares it with the vine graph. */
+	char *proxy_function_name;
+
+	/* The depth of the pruning strategy. 0 means no pruning, 1 means the most aggressive pruning. */
+	int prune_depth;
+	double checkpoint_fraction; /* 0 - 1, the fraction of intermediate results to checkpoint */
+
+	task_priority_mode_t task_priority_mode; /* priority mode for task graph task scheduling */
+	double failure_injection_step_percent;	 /* 0 - 100, the percentage of steps to inject failure */
+
+	double progress_bar_update_interval_sec; /* update interval for the progress bar in seconds */
+
+	/* The filename of the csv file to store the time metrics of the vine graph. */
+	char *time_metrics_filename;
+
+	int enable_debug_log; /* whether to enable debug log */
+};
+
+/* Public APIs for operating the vine graph */
+
+/** Create a vine graph and return it.
+@param q Reference to the current manager object.
+@return A new vine graph.
+*/
+struct vine_graph *vine_graph_create(struct vine_manager *q);
+
+/** Create a new node in the vine graph.
+@param vg Reference to the vine graph.
+@return The auto-assigned node id.
+*/
+uint64_t vine_graph_add_node(struct vine_graph *vg);
+
+/** Mark a node as a retrieval target.
+@param vg Reference to the vine graph.
+@param node_id Identifier of the node to mark as target.
+*/
+void vine_graph_set_target(struct vine_graph *vg, uint64_t node_id);
+
+/** Add a dependency between two nodes in the vine graph.
+@param vg Reference to the vine graph.
+@param parent_id Identifier of the parent node.
+@param child_id Identifier of the child node.
+*/
+void vine_graph_add_dependency(struct vine_graph *vg, uint64_t parent_id, uint64_t child_id);
+
+/** Finalize the metrics of the vine graph.
+@param vg Reference to the vine graph.
+*/
+void vine_graph_compute_topology_metrics(struct vine_graph *vg);
+
+/** Get the heavy score of a node in the vine graph.
+@param vg Reference to the vine graph.
+@param node_id Identifier of the node.
+@return The heavy score.
+*/
+double vine_graph_get_node_heavy_score(const struct vine_graph *vg, uint64_t node_id);
+
+/** Execute the task graph.
+@param vg Reference to the vine graph.
+*/
+void vine_graph_execute(struct vine_graph *vg);
+
+/** Get the outfile remote name of a node in the vine graph.
+@param vg Reference to the vine graph.
+@param node_id Identifier of the node.
+@return The outfile remote name.
+*/
+const char *vine_graph_get_node_outfile_remote_name(const struct vine_graph *vg, uint64_t node_id);
+
+/** Get the local outfile source of a node in the vine graph.
+@param vg Reference to the vine graph.
+@param node_id Identifier of the node.
+@return The local outfile source, or NULL if the node does not produce a local file.
+*/
+const char *vine_graph_get_node_local_outfile_source(const struct vine_graph *vg, uint64_t node_id);
+
+/** Delete a vine graph.
+@param vg Reference to the vine graph.
+*/
+void vine_graph_delete(struct vine_graph *vg);
+
+/** Get the proxy library name of the vine graph.
+@param vg Reference to the vine graph.
+@return The proxy library name.
+*/
+const char *vine_graph_get_proxy_library_name(const struct vine_graph *vg);
+
+/** Set the proxy function name of the vine graph.
+@param vg Reference to the vine graph.
+@param proxy_function_name Reference to the proxy function name.
+*/
+void vine_graph_set_proxy_function_name(struct vine_graph *vg, const char *proxy_function_name);
+
+/** Tune the vine graph.
+@param vg Reference to the vine graph.
+@param name Reference to the name of the parameter to tune.
+@param value Reference to the value of the parameter to tune.
+@return 0 on success, -1 on failure.
+*/
+int vine_graph_tune(struct vine_graph *vg, const char *name, const char *value);
+
+#endif // VINE_GRAPH_H
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_graph.i b/taskvine/src/graph/vinedag/vine_graph/vine_graph.i
similarity index 72%
rename from taskvine/src/graph/vinedag/strategic_orchestration_graph.i
rename to taskvine/src/graph/vinedag/vine_graph/vine_graph.i
index 1f7f7be8eb..b87d428c01 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_graph.i
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_graph.i
@@ -1,9 +1,9 @@
 /* SWIG interface for local vinedag graph API bindings */
-%module capi
+%module vine_graph_capi
 
 %{
 #include "int_sizes.h"
-#include "strategic_orchestration_graph.h"
+#include "vine_graph.h"
 %}
 
 %include "stdint.i"
@@ -12,4 +12,4 @@
 /* Import existing SWIG interface for type information (do not wrap again) */
 %import "../../bindings/python3/taskvine.i"
 
-%include "strategic_orchestration_graph.h"
+%include "vine_graph.h"
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph_client.py b/taskvine/src/graph/vinedag/vine_graph/vine_graph_client.py
new file mode 100644
index 0000000000..6019e6e74c
--- /dev/null
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_graph_client.py
@@ -0,0 +1,75 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+"""High-level client that exposes the C vine graph to Python callers."""
+
+from . import vine_graph_capi
+
+
+class VineGraphClient:
+    """Python-friendly wrapper that hides the raw SWIG API surface."""
+
+    def __init__(self, c_taskvine):
+        """Create and own the lifecycle of the backing C vine graph instance."""
+        self._c_graph = vine_graph_capi.vine_graph_create(c_taskvine)
+        self._key_to_id = {}
+        self._id_to_key = {}
+
+    def tune(self, name, value):
+        """Forward tuning parameters directly to the C vine graph."""
+        vine_graph_capi.vine_graph_tune(self._c_graph, name, value)
+
+    def add_node(self, key, is_target=None):
+        """Create a node in the C graph and remember the key↔id mapping."""
+        node_id = vine_graph_capi.vine_graph_add_node(self._c_graph)
+        self._key_to_id[key] = node_id
+        self._id_to_key[node_id] = key
+        if is_target is not None and bool(is_target):
+            vine_graph_capi.vine_graph_set_target(self._c_graph, node_id)
+        return node_id
+
+    def set_target(self, key):
+        """Mark an existing node as a target output."""
+        node_id = self._key_to_id.get(key)
+        if node_id is None:
+            raise KeyError(f"Key not found: {key}")
+        vine_graph_capi.vine_graph_set_target(self._c_graph, node_id)
+
+    def add_dependency(self, parent_key, child_key):
+        """Add an edge in the C graph using the remembered id mapping."""
+        if parent_key not in self._key_to_id or child_key not in self._key_to_id:
+            raise KeyError("parent_key or child_key missing in mapping; call add_node() first")
+        vine_graph_capi.vine_graph_add_dependency(
+            self._c_graph, self._key_to_id[parent_key], self._key_to_id[child_key]
+        )
+
+    def compute_topology_metrics(self):
+        """Trigger the C graph to compute depth/height, heavy-score, etc."""
+        vine_graph_capi.vine_graph_compute_topology_metrics(self._c_graph)
+
+    def get_node_outfile_remote_name(self, key):
+        """Ask the C layer where a node's output will be stored."""
+        if key not in self._key_to_id:
+            raise KeyError(f"Key not found: {key}")
+        return vine_graph_capi.vine_graph_get_node_outfile_remote_name(
+            self._c_graph, self._key_to_id[key]
+        )
+
+    def get_proxy_library_name(self):
+        """Expose the randomly generated proxy library name from the C side."""
+        return vine_graph_capi.vine_graph_get_proxy_library_name(self._c_graph)
+
+    def set_proxy_function(self, proxy_function):
+        """Tell the C graph which Python function should run on the workers."""
+        vine_graph_capi.vine_graph_set_proxy_function_name(
+            self._c_graph, proxy_function.__name__
+        )
+
+    def execute(self):
+        """Kick off execution; runs through SWIG down into the C orchestration loop."""
+        vine_graph_capi.vine_graph_execute(self._c_graph)
+
+    def delete(self):
+        """Release the C resources and clear the client."""
+        vine_graph_capi.vine_graph_delete(self._c_graph)
diff --git a/taskvine/src/graph/vinedag/strategic_orchestration_node.c b/taskvine/src/graph/vinedag/vine_graph/vine_node.c
similarity index 74%
rename from taskvine/src/graph/vinedag/strategic_orchestration_node.c
rename to taskvine/src/graph/vinedag/vine_graph/vine_node.c
index 517e3333c4..86e0dfffb4 100644
--- a/taskvine/src/graph/vinedag/strategic_orchestration_node.c
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_node.c
@@ -21,7 +21,7 @@
 #include "vine_task.h"
 #include "vine_worker_info.h"
 #include "vine_temp.h"
-#include "strategic_orchestration_node.h"
+#include "vine_node.h"
 #include "taskvine.h"
 
 /*************************************************************/
@@ -35,7 +35,7 @@
  * @param node Reference to the node object.
  * @return 1 if the outfile is persisted, 0 otherwise.
  */
-static int node_outfile_has_been_persisted(struct strategic_orchestration_node *node)
+static int node_outfile_has_been_persisted(struct vine_node *node)
 {
 	if (!node) {
 		return 0;
@@ -63,10 +63,10 @@ static int node_outfile_has_been_persisted(struct strategic_orchestration_node *
  * @param node Reference to the node object.
  * @param execution_time Reference to the execution time of the node.
  */
-void son_update_critical_path_time(struct strategic_orchestration_node *node, timestamp_t execution_time)
+void vine_node_update_critical_path_time(struct vine_node *node, timestamp_t execution_time)
 {
 	timestamp_t max_parent_critical_path_time = 0;
-	struct strategic_orchestration_node *parent_node;
+	struct vine_node *parent_node;
 	LIST_ITERATE(node->parents, parent_node)
 	{
 		if (parent_node->critical_path_time > max_parent_critical_path_time) {
@@ -83,7 +83,7 @@ void son_update_critical_path_time(struct strategic_orchestration_node *node, ti
  * @param result Reference to the result list.
  * @param visited Reference to the visited set.
  */
-static void find_parents_dfs(struct strategic_orchestration_node *node, int remaining_depth, struct list *result, struct set *visited)
+static void find_parents_dfs(struct vine_node *node, int remaining_depth, struct list *result, struct set *visited)
 {
 	if (!node || set_lookup(visited, node)) {
 		return;
@@ -94,7 +94,7 @@ static void find_parents_dfs(struct strategic_orchestration_node *node, int rema
 		list_push_tail(result, node);
 		return;
 	}
-	struct strategic_orchestration_node *parent_node;
+	struct vine_node *parent_node;
 	LIST_ITERATE(node->parents, parent_node)
 	{
 		find_parents_dfs(parent_node, remaining_depth - 1, result, visited);
@@ -106,31 +106,21 @@ static void find_parents_dfs(struct strategic_orchestration_node *node, int rema
 /*************************************************************/
 
 /**
- * Create a new node object.
- * @param node_key Reference to the node key.
- * @param is_target_key Reference to whether the node is a target key.
- * @return A new node object.
+ * Create a new vine node owned by the C-side graph.
+ * @param node_id Graph-assigned identifier that keeps C and Python in sync.
+ * @return Newly allocated vine node.
  */
-struct strategic_orchestration_node *son_create(const char *node_key, int is_target_key)
+struct vine_node *vine_node_create(uint64_t node_id)
 {
-	if (!node_key) {
-		debug(D_ERROR, "Cannot create node because node_key is NULL");
-		return NULL;
-	}
-	if (is_target_key != 0 && is_target_key != 1) {
-		debug(D_ERROR, "Cannot create node because is_target_key is not 0 or 1");
-		return NULL;
-	}
-
-	struct strategic_orchestration_node *node = xxmalloc(sizeof(struct strategic_orchestration_node));
+	struct vine_node *node = xxmalloc(sizeof(struct vine_node));
 
-	node->is_target_key = is_target_key;
-	node->node_key = xxstrdup(node_key);
+	node->is_target = 0;
+	node->node_id = node_id;
 
-	/* create a unique outfile remote name for the node */
-	cctools_uuid_t id;
-	cctools_uuid_create(&id);
-	node->outfile_remote_name = xxstrdup(id.str);
+	/* create a unique UUID-based remote outfile name for this node */
+	cctools_uuid_t uuid;
+	cctools_uuid_create(&uuid);
+	node->outfile_remote_name = xxstrdup(uuid.str);
 
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
 	node->parents = list_create();
@@ -168,9 +158,9 @@ struct strategic_orchestration_node *son_create(const char *node_key, int is_tar
 /**
  * Construct the task arguments for the node.
  * @param node Reference to the node object.
- * @return The task arguments in JSON format: {"fn_args": [key], "fn_kwargs": {}}.
+ * @return The task arguments in JSON format: {"fn_args": [node_id], "fn_kwargs": {}}.
  */
-char *son_construct_task_arguments(struct strategic_orchestration_node *node)
+char *vine_node_construct_task_arguments(struct vine_node *node)
 {
 	if (!node) {
 		return NULL;
@@ -178,7 +168,7 @@ char *son_construct_task_arguments(struct strategic_orchestration_node *node)
 
 	struct jx *event = jx_object(NULL);
 	struct jx *args = jx_array(NULL);
-	jx_array_append(args, jx_string(node->node_key));
+	jx_array_append(args, jx_integer(node->node_id));
 	jx_insert(event, jx_string("fn_args"), args);
 	jx_insert(event, jx_string("fn_kwargs"), jx_object(NULL));
 
@@ -194,7 +184,7 @@ char *son_construct_task_arguments(struct strategic_orchestration_node *node)
  * @param depth Reference to the depth.
  * @return The list of parents.
  */
-struct list *son_find_parents_by_depth(struct strategic_orchestration_node *node, int depth)
+struct list *vine_node_find_parents_by_depth(struct vine_node *node, int depth)
 {
 	if (!node || depth < 0) {
 		return NULL;
@@ -229,7 +219,7 @@ struct list *son_find_parents_by_depth(struct strategic_orchestration_node *node
  * @param start_node  The node from which to begin the reverse search.
  * @return A set of ancestor nodes that are safe to prune (excluding start_node).
  */
-struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_node)
+struct set *vine_node_find_safe_ancestors(struct vine_node *start_node)
 {
 	if (!start_node) {
 		return NULL;
@@ -244,8 +234,8 @@ struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_n
 	set_insert(visited_nodes, start_node);
 
 	while (list_size(queue) > 0) {
-		struct strategic_orchestration_node *current_node = list_pop_head(queue);
-		struct strategic_orchestration_node *parent_node;
+		struct vine_node *current_node = list_pop_head(queue);
+		struct vine_node *parent_node;
 
 		LIST_ITERATE(current_node->parents, parent_node)
 		{
@@ -262,7 +252,7 @@ struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_n
 
 			/* check if all children of this parent are safe */
 			int all_children_safe = 1;
-			struct strategic_orchestration_node *child_node;
+			struct vine_node *child_node;
 			LIST_ITERATE(parent_node->children, child_node)
 			{
 				/* shortcut if this child is part of the recovery subgraph */
@@ -298,19 +288,19 @@ struct set *son_find_safe_ancestors(struct strategic_orchestration_node *start_n
  * Print the info of the node.
  * @param node Reference to the node object.
  */
-void son_debug_print(struct strategic_orchestration_node *node)
+void vine_node_debug_print(struct vine_node *node)
 {
 	if (!node) {
 		return;
 	}
 
 	if (!node->task) {
-		debug(D_ERROR, "node %s has no task", node->node_key);
+		debug(D_ERROR, "node %" PRIu64 " has no task", node->node_id);
 		return;
 	}
 
 	debug(D_VINE, "---------------- Node Info ----------------");
-	debug(D_VINE, "key: %s", node->node_key);
+	debug(D_VINE, "node_id: %" PRIu64, node->node_id);
 	debug(D_VINE, "task_id: %d", node->task->task_id);
 	debug(D_VINE, "depth: %d", node->depth);
 	debug(D_VINE, "height: %d", node->height);
@@ -345,38 +335,38 @@ void son_debug_print(struct strategic_orchestration_node *node)
 		debug(D_VINE, "outfile_type: SHARED_FILE_SYSTEM or none");
 	}
 
-	/* print parent and child node keys */
-	char *parent_keys = NULL;
-	struct strategic_orchestration_node *p;
+	/* print parent and child node ids */
+	char *parent_ids = NULL;
+	struct vine_node *p;
 	LIST_ITERATE(node->parents, p)
 	{
-		if (!parent_keys) {
-			parent_keys = string_format("%s", p->node_key);
+		if (!parent_ids) {
+			parent_ids = string_format("%" PRIu64, p->node_id);
 		} else {
-			char *tmp = string_format("%s, %s", parent_keys, p->node_key);
-			free(parent_keys);
-			parent_keys = tmp;
+			char *tmp = string_format("%s, %" PRIu64, parent_ids, p->node_id);
+			free(parent_ids);
+			parent_ids = tmp;
 		}
 	}
 
-	char *child_keys = NULL;
-	struct strategic_orchestration_node *c;
+	char *child_ids = NULL;
+	struct vine_node *c;
 	LIST_ITERATE(node->children, c)
 	{
-		if (!child_keys) {
-			child_keys = string_format("%s", c->node_key);
+		if (!child_ids) {
+			child_ids = string_format("%" PRIu64, c->node_id);
 		} else {
-			char *tmp = string_format("%s, %s", child_keys, c->node_key);
-			free(child_keys);
-			child_keys = tmp;
+			char *tmp = string_format("%s, %" PRIu64, child_ids, c->node_id);
+			free(child_ids);
+			child_ids = tmp;
 		}
 	}
 
-	debug(D_VINE, "parents: %s", parent_keys ? parent_keys : "(none)");
-	debug(D_VINE, "children: %s", child_keys ? child_keys : "(none)");
+	debug(D_VINE, "parents: %s", parent_ids ? parent_ids : "(none)");
+	debug(D_VINE, "children: %s", child_ids ? child_ids : "(none)");
 
-	free(parent_keys);
-	free(child_keys);
+	free(parent_ids);
+	free(child_ids);
 
 	debug(D_VINE, "-------------------------------------------");
 }
@@ -385,15 +375,12 @@ void son_debug_print(struct strategic_orchestration_node *node)
  * Delete the node and all of its associated resources.
  * @param node Reference to the node object.
  */
-void son_delete(struct strategic_orchestration_node *node)
+void vine_node_delete(struct vine_node *node)
 {
 	if (!node) {
 		return;
 	}
 
-	if (node->node_key) {
-		free(node->node_key);
-	}
 	if (node->outfile_remote_name) {
 		free(node->outfile_remote_name);
 	}
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_node.h b/taskvine/src/graph/vinedag/vine_graph/vine_node.h
new file mode 100644
index 0000000000..a838fb6e88
--- /dev/null
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_node.h
@@ -0,0 +1,115 @@
+#ifndef VINE_NODE_H
+#define VINE_NODE_H
+
+#include <stdint.h>
+
+#include "vine_task.h"
+#include "hash_table.h"
+#include "list.h"
+#include "set.h"
+#include "taskvine.h"
+
+/** The storage type of the node's output file. */
+typedef enum {
+	NODE_OUTFILE_TYPE_LOCAL = 0,	      /* Node-output file will be stored locally on the local staging directory */
+	NODE_OUTFILE_TYPE_TEMP,		      /* Node-output file will be stored in the temporary node-local storage */
+	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
+} node_outfile_type_t;
+
+/** The status of an output file of a node. */
+typedef enum {
+	PRUNE_STATUS_NOT_PRUNED = 0,
+	PRUNE_STATUS_SAFE,
+	PRUNE_STATUS_UNSAFE
+} prune_status_t;
+
+/** The vine node object. */
+struct vine_node {
+	/* Identity */
+	uint64_t node_id; /* Unique identifier assigned by the graph when the node is created. */
+	int is_target;	  /* If true, the output of the node is retrieved when the task finishes. */
+
+	/* Task and files */
+	struct vine_task *task;
+	struct vine_file *infile;
+	struct vine_file *outfile;
+	char *outfile_remote_name;
+	size_t outfile_size_bytes;
+	node_outfile_type_t outfile_type;
+
+	/* Graph relationships */
+	struct list *parents;
+	struct list *children;
+
+	/* Execution and scheduling state */
+	struct set *pending_parents;
+	int retry_attempts_left;
+	int completed;
+	prune_status_t prune_status;
+
+	/* Structural metrics */
+	int prune_depth;
+	int depth;
+	int height;
+	int upstream_subgraph_size;
+	int downstream_subgraph_size;
+	int fan_in;
+	int fan_out;
+	double heavy_score;
+
+	/* Time metrics */
+	timestamp_t critical_path_time;
+	timestamp_t time_spent_on_unlink_local_files;
+	timestamp_t time_spent_on_prune_ancestors_of_temp_node;
+	timestamp_t time_spent_on_prune_ancestors_of_persisted_node;
+
+	timestamp_t submission_time;
+	timestamp_t scheduling_time;
+	timestamp_t commit_time;
+	timestamp_t execution_time;
+	timestamp_t retrieval_time;
+	timestamp_t postprocessing_time;
+};
+
+/** Create a new vine node.
+@param node_id Unique node identifier supplied by the owning graph.
+@return Newly allocated vine node instance.
+*/
+struct vine_node *vine_node_create(uint64_t node_id);
+
+/** Create the task arguments for a vine node.
+@param node Reference to the vine node.
+@return The task arguments in JSON format: {"fn_args": [node_id], "fn_kwargs": {}}.
+*/
+char *vine_node_construct_task_arguments(struct vine_node *node);
+
+/** Delete a vine node and release owned resources.
+@param node Reference to the vine node.
+*/
+void vine_node_delete(struct vine_node *node);
+
+/** Print information about a vine node.
+@param node Reference to the vine node.
+*/
+void vine_node_debug_print(struct vine_node *node);
+
+/** Find all safe ancestors of a vine node.
+@param start_node Reference to the start node.
+@return The set of safe ancestors.
+*/
+struct set *vine_node_find_safe_ancestors(struct vine_node *start_node);
+
+/** Find all parents of a vine node at a specific depth.
+@param node Reference to the node.
+@param depth Reference to the depth.
+@return The list of parents.
+*/
+struct list *vine_node_find_parents_by_depth(struct vine_node *node, int depth);
+
+/** Update the critical path time of a vine node.
+@param node Reference to the vine node.
+@param execution_time Reference to the execution time of the node.
+*/
+void vine_node_update_critical_path_time(struct vine_node *node, timestamp_t execution_time);
+
+#endif // VINE_NODE_H
\ No newline at end of file
diff --git a/taskvine/src/graph/vinedag/vinedag.py b/taskvine/src/graph/vinedag/vinedag.py
index 9ec10aefc3..165badaf42 100644
--- a/taskvine/src/graph/vinedag/vinedag.py
+++ b/taskvine/src/graph/vinedag/vinedag.py
@@ -1,11 +1,14 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
 
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.manager import Manager
 
-from ndcctools.taskvine.vinedag.proxy_library import ProxyLibrary
-from ndcctools.taskvine.vinedag.proxy_functions import compute_single_key
-from ndcctools.taskvine.vinedag.runtime_execution_graph import RuntimeExecutionGraph, GraphKeyResult
-from ndcctools.taskvine.vinedag.strategic_orchestration_graph import StrategicOrchestrationGraph
+from ndcctools.taskvine.vinedag.context_graph.proxy_library import ProxyLibrary
+from ndcctools.taskvine.vinedag.context_graph.proxy_functions import compute_single_key
+from ndcctools.taskvine.vinedag.context_graph.core import ContextGraph, GraphKeyResult
+from ndcctools.taskvine.vinedag.vine_graph.vine_graph_client import VineGraphClient
 
 import cloudpickle
 import os
@@ -29,6 +32,7 @@
 
 
 def delete_all_files(root_dir):
+    """Clean the run-info template directory between runs so stale files never leak into a new DAG."""
     if not os.path.exists(root_dir):
         return
     for dirpath, dirnames, filenames in os.walk(root_dir):
@@ -40,34 +44,45 @@ def delete_all_files(root_dir):
                 print(f"Failed to delete file {file_path}")
 
 
-# color the text with the given color code
+# Nicely format terminal output when printing manager metadata.
 def color_text(text, color_code):
+    """Render a colored string for the friendly status banners Vineyard prints at start-up."""
     return f"\033[{color_code}m{text}\033[0m"
 
 
-# convert Dask collection to task dictionary
+# Flatten Dask collections into the dict-of-tasks structure the rest of the
+# pipeline expects. VineDAG clients often hand us a dict like
+# {"result": dask.delayed(...)}; we merge the underlying HighLevelGraphs so
+# `ContextGraph` sees the same dict representation C does.
 def dask_collections_to_task_dict(collection_dict):
+    """Merge user-facing Dask collections into the flattened task dict the ContextGraph expects."""
     assert is_dask_collection is not None
     from dask.highlevelgraph import HighLevelGraph, ensure_dict
 
     if not isinstance(collection_dict, dict):
-        raise TypeError("Input must be a dict or a HighLevelGraph")
+        raise TypeError("Input must be a dict")
 
     for k, v in collection_dict.items():
         if not is_dask_collection(v):
             raise TypeError(f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}")
 
     if dts:
+        # the new Dask API
         sub_hlgs = [v.dask for v in collection_dict.values()]
         hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
     else:
+        # the old Dask API
         hlg = dask.base.collections_to_dsk(collection_dict.values())
 
     return ensure_dict(hlg)
 
 
-# compatibility for Dask-created collections
+# Accept both plain dicts and Dask collections from callers. Most library users
+# hand us `{key: delayed / value}` directly, while some experiments pass a
+# fully-expanded legacy Dask dict. This helper normalises both cases so the rest
+# of the pipeline only deals with `{task_key: task_expression}`.
 def ensure_task_dict(collection_dict):
+    """Normalize user input (raw dict or Dask collection) into a plain `{task_key: expr}` mapping."""
     if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
         task_dict = dask_collections_to_task_dict(collection_dict)
     else:
@@ -81,6 +96,8 @@ def ensure_task_dict(collection_dict):
 
 class GraphParams:
     def __init__(self):
+        """Hold all tweakable knobs (manager-side, vine_graph-side, and misc)."""
+        # Manager-level knobs: fed into `Manager.tune(...)` before execution.
         self.vine_manager_tuning_params = {
             "worker-source-max-transfers": 100,
             "max-retrievals": -1,
@@ -91,7 +108,8 @@ def __init__(self):
             "enforce-worker-eviction-interval": -1,
             "balance-worker-disk-load": 0,
         }
-        self.sog_tuning_params = {
+        # VineGraph-level knobs: forwarded to the underlying vine graph via VineGraphClient.
+        self.vine_graph_tuning_params = {
             "failure-injection-step-percent": -1,
             "task-priority-mode": "largest-input-first",
             "prune-depth": 1,
@@ -102,33 +120,37 @@ def __init__(self):
             "time-metrics-filename": "time_metrics.csv",
             "enable-debug-log": 1,
         }
+        # Misc knobs used purely on the Python side (e.g., generate fake outputs).
         self.other_params = {
             "schedule": "worst",
             "libcores": 16,
             "failure-injection-step-percent": -1,
-            "extra-task-output-size-mb": ["uniform", 0, 0],
-            "extra-task-sleep-time": ["uniform", 0, 0],
+            "extra-task-output-size-mb": [0, 0],
+            "extra-task-sleep-time": [0, 0],
         }
 
     def print_params(self):
-        all_params = {**self.vine_manager_tuning_params, **self.sog_tuning_params, **self.other_params}
+        """Dump current knob values to stdout for debugging."""
+        all_params = {**self.vine_manager_tuning_params, **self.vine_graph_tuning_params, **self.other_params}
         print(json.dumps(all_params, indent=4))
 
     def update_param(self, param_name, new_value):
+        """Update a single knob, falling back to manager-level if unknown."""
         if param_name in self.vine_manager_tuning_params:
             self.vine_manager_tuning_params[param_name] = new_value
-        elif param_name in self.sog_tuning_params:
-            self.sog_tuning_params[param_name] = new_value
+        elif param_name in self.vine_graph_tuning_params:
+            self.vine_graph_tuning_params[param_name] = new_value
         elif param_name in self.other_params:
             self.other_params[param_name] = new_value
         else:
             self.vine_manager_tuning_params[param_name] = new_value
 
     def get_value_of(self, param_name):
+        """Helper so VineDAG can pull a knob value without caring where it lives."""
         if param_name in self.vine_manager_tuning_params:
             return self.vine_manager_tuning_params[param_name]
-        elif param_name in self.sog_tuning_params:
-            return self.sog_tuning_params[param_name]
+        elif param_name in self.vine_graph_tuning_params:
+            return self.vine_graph_tuning_params[param_name]
         elif param_name in self.other_params:
             return self.other_params[param_name]
         else:
@@ -139,20 +161,21 @@ class VineDAG(Manager):
     def __init__(self,
                  *args,
                  **kwargs):
+        """Spin up a TaskVine manager that knows how to mirror a Python DAG into the C orchestration layer."""
 
-        # handle SIGINT
+        # React to Ctrl+C so we can tear down the graphs cleanly.
         signal.signal(signal.SIGINT, self._on_sigint)
 
         self.params = GraphParams()
 
-        # delete all files in the run info directory, do this before super().__init__()
+        # Ensure run-info templates don't accumulate garbage between runs.
         run_info_path = kwargs.get("run_info_path", None)
         run_info_template = kwargs.get("run_info_template", None)
         self.run_info_template_path = os.path.join(run_info_path, run_info_template)
         if self.run_info_template_path:
             delete_all_files(self.run_info_template_path)
 
-        # initialize the manager
+        # Boot the underlying TaskVine manager. The TaskVine manager keeps alive until the vinedag object is destroyed
         super().__init__(*args, **kwargs)
         self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
 
@@ -161,114 +184,130 @@ def __init__(self,
         print(f"=== Runtime directory: {color_text(self.runtime_directory, 92)}")
 
     def param(self, param_name):
+        """Convenience accessor so callers can read tuned parameters at runtime."""
         return self.params.get_value_of(param_name)
 
     def update_params(self, new_params):
+        """Apply a batch of overrides before constructing graphs.
+
+        All parameter dictionaries—whether set via `update_params()` or passed
+        to `run(..., params={...})`—flow through here. We funnel each key into
+        the appropriate bucket (manager/vine_graph/misc). Subsequent runs can override
+        them by calling this again.
+        """
         assert isinstance(new_params, dict), "new_params must be a dict"
         for k, new_v in new_params.items():
             self.params.update_param(k, new_v)
 
-    def get_run_info_path(self):
-        return os.path.join(self.param("run-info-path"), self.param("run-info-template"))
-
     def tune_manager(self):
+        """Push our manager-side tuning knobs into the C layer."""
         for k, v in self.params.vine_manager_tuning_params.items():
             try:
                 self.tune(k, v)
             except Exception:
                 raise ValueError(f"Unrecognized parameter: {k}")
 
-    def tune_sog(self, sog):
-        for k, v in self.params.sog_tuning_params.items():
-            sog.tune(k, str(v))
+    def tune_vine_graph(self, vine_graph):
+        """Push VineGraph-specific tuning knobs before we build the graph."""
+        for k, v in self.params.vine_graph_tuning_params.items():
+            vine_graph.tune(k, str(v))
 
-    def build_reg(self, task_dict):
-        reg = RuntimeExecutionGraph(
+    def build_context_graph(self, task_dict):
+        """Construct the Python-side DAG wrapper (ContextGraph)."""
+        context_graph = ContextGraph(
             task_dict,
             extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
             extra_task_sleep_time=self.param("extra-task-sleep-time")
         )
 
-        return reg
+        return context_graph
 
-    def build_sog(self, reg, target_keys):
-        assert reg is not None, "Python graph must be built before building the C graph"
+    def build_vine_graph(self, context_graph, target_keys):
+        """Mirror the ContextGraph into VineGraph, preserving ordering and targets."""
+        assert context_graph is not None, "ContextGraph must be built before building the VineGraph"
 
-        sog = StrategicOrchestrationGraph(self._taskvine)
+        vine_graph = VineGraphClient(self._taskvine)
 
-        sog.set_proxy_function(compute_single_key)
+        vine_graph.set_proxy_function(compute_single_key)
 
-        # C side vine task graph must be tuned before adding nodes and dependencies
+        # Tune both manager and vine_graph before we start adding nodes/edges.
         self.tune_manager()
-        self.tune_sog(sog)
+        self.tune_vine_graph(vine_graph)
 
-        topo_order = reg.get_topological_order()
+        topo_order = context_graph.get_topological_order()
+        # Build the cross-language mapping as we walk the topo order.
         for k in topo_order:
-            sog.add_node(reg.reg_key_to_sog_key[k], int(k in target_keys))
-            for pk in reg.parents_of[k]:
-                sog.add_dependency(reg.reg_key_to_sog_key[pk], reg.reg_key_to_sog_key[k])
+            node_id = vine_graph.add_node(k)
+            context_graph.ckey2vid[k] = node_id
+            context_graph.vid2ckey[node_id] = k
+            for pk in context_graph.parents_of[k]:
+                vine_graph.add_dependency(pk, k)
 
-        sog.compute_topology_metrics()
+        # Now that every node is present, mark which ones are final outputs.
+        for k in target_keys:
+            vine_graph.set_target(k)
 
-        return sog
+        vine_graph.compute_topology_metrics()
+
+        return vine_graph
 
     def build_graphs(self, task_dict, target_keys):
-        # build Python DAG (logical topology)
-        reg = self.build_reg(task_dict)
-        # build C DAG (physical topology)
-        sog = self.build_sog(reg, target_keys)
+        """Create both the ContextGraph and its C counterpart, wiring outputs for later use."""
+        # Build the logical (Python) DAG.
+        context_graph = self.build_context_graph(task_dict)
+        # Build the physical (C) DAG.
+        vine_graph = self.build_vine_graph(context_graph, target_keys)
 
-        # set outfile remote names in reg from sog, note that these names are automatically generated
-        # with regard to the checkpointing strategy and the shared file system directory
-        for sog_key in reg.reg_key_to_sog_key.values():
-            outfile_remote_name = sog.get_node_outfile_remote_name(sog_key)
-            reg.set_outfile_remote_name_of(reg.sog_key_to_reg_key[sog_key], outfile_remote_name)
+        # Cross-fill the outfile locations so the runtime graph knows where to read/write.
+        for k in context_graph.ckey2vid:
+            outfile_remote_name = vine_graph.get_node_outfile_remote_name(k)
+            context_graph.outfile_remote_name[k] = outfile_remote_name
 
-        return reg, sog
+        return context_graph, vine_graph
 
-    def create_proxy_library(self, reg, sog, hoisting_modules, env_files):
+    def create_proxy_library(self, context_graph, vine_graph, hoisting_modules, env_files):
+        """Package up the context_graph as a TaskVine library."""
         proxy_library = ProxyLibrary(self)
         proxy_library.add_hoisting_modules(hoisting_modules)
         proxy_library.add_env_files(env_files)
-        proxy_library.set_context_loader(RuntimeExecutionGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(reg)])
+        proxy_library.set_context_loader(ContextGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(context_graph)])
         proxy_library.set_libcores(self.param("libcores"))
-        proxy_library.set_name(sog.get_proxy_library_name())
+        proxy_library.set_name(vine_graph.get_proxy_library_name())
 
         return proxy_library
 
     def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}):
+        """High-level entry point: normalise input, build graphs, ship the library, execute, and return results."""
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
         task_dict = ensure_task_dict(collection_dict)
 
-        with open("test_dv5.pkl", "wb") as f:
-            cloudpickle.dump(task_dict, f)
-
-        # build graphs from both sides
-        reg, sog = self.build_graphs(task_dict, target_keys)
+        # Build both the Python DAG and its C mirror.
+        context_graph, vine_graph = self.build_graphs(task_dict, target_keys)
 
-        # create and install the proxy library on the manager
-        proxy_library = self.create_proxy_library(reg, sog, hoisting_modules, env_files)
+        # Ship the execution context to workers via a proxy library.
+        proxy_library = self.create_proxy_library(context_graph, vine_graph, hoisting_modules, env_files)
         proxy_library.install()
 
         print(f"=== Library serialized size: {color_text(proxy_library.get_context_size(), 92)} MB")
 
-        # execute the graph on the C side
-        sog.execute()
+        # Kick off execution on the C side.
+        vine_graph.execute()
 
-        # clean up the library instances and template on the manager
+        # Tear down once we're done so successive runs start clean.
         proxy_library.uninstall()
 
-        # delete the C graph immediately after execution, so that the lifetime of this object is limited to the execution
-        sog.delete()
+        # Delete the C graph immediately so its lifetime matches the run.
+        vine_graph.delete()
 
-        # load results of target keys
+        # Load any requested target outputs back into Python land.
         results = {}
         for k in target_keys:
-            outfile_path = os.path.join(self.param("output-dir"), reg.outfile_remote_name[k])
+            outfile_path = os.path.join(self.param("output-dir"), context_graph.outfile_remote_name[k])
             results[k] = GraphKeyResult.load_from_path(outfile_path)
         return results
 
     def _on_sigint(self, signum, frame):
+        """SIGINT handler that delegates to Manager cleanup so workers are released promptly."""
         self.__del__()
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 7dc74facaa..4e096260e5 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -6121,6 +6121,12 @@ int vine_tune(struct vine_manager *q, const char *name, double value)
 	} else if (!strcmp(name, "balance-worker-disk-load")) {
 		q->balance_worker_disk_load = !!((int)value);
 
+	} else if (!strcmp(name, "enable-debug-log")) {
+		if (value == 0) {
+			debug_flags_clear();
+			debug_close();
+		}
+
 	} else {
 		debug(D_NOTICE | D_VINE, "Warning: tuning parameter \"%s\" not recognized\n", name);
 		return -1;
diff --git a/taskvine/src/worker/vine_worker.c b/taskvine/src/worker/vine_worker.c
index d1ab432cef..b830fb2249 100644
--- a/taskvine/src/worker/vine_worker.c
+++ b/taskvine/src/worker/vine_worker.c
@@ -1706,7 +1706,7 @@ static void vine_worker_serve_manager(struct link *manager)
 		hence a maximum wait time of five seconds is enforced.
 		*/
 
-		int wait_msec = 5000;
+		int wait_msec = 0;
 
 		if (sigchld_received_flag) {
 			wait_msec = 0;

From cca31701e4bd45add5f83a9309dc29753142996d Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Sat, 1 Nov 2025 00:00:45 -0400
Subject: [PATCH 067/113] git ignore

---
 taskvine/src/graph/vinedag/vine_graph/.gitignore | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 taskvine/src/graph/vinedag/vine_graph/.gitignore

diff --git a/taskvine/src/graph/vinedag/vine_graph/.gitignore b/taskvine/src/graph/vinedag/vine_graph/.gitignore
new file mode 100644
index 0000000000..15309787ad
--- /dev/null
+++ b/taskvine/src/graph/vinedag/vine_graph/.gitignore
@@ -0,0 +1 @@
+*.o
\ No newline at end of file

From c1b4e67ea7ce2d2068854d78917c51c8fc958a0b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 09:47:39 -0500
Subject: [PATCH 068/113] revert vine_manager_put_task

---
 .../graph/vinedag/context_graph/__init__.py   |   4 +-
 .../src/graph/vinedag/context_graph/core.py   |   8 +-
 .../vinedag/context_graph/proxy_library.py    |   4 +-
 .../src/graph/vinedag/vine_graph/vine_graph.h |   4 +-
 taskvine/src/graph/vinedag/vinedag.py         |   4 +-
 taskvine/src/manager/vine_manager_put.c       | 269 +-----------------
 6 files changed, 13 insertions(+), 280 deletions(-)

diff --git a/taskvine/src/graph/vinedag/context_graph/__init__.py b/taskvine/src/graph/vinedag/context_graph/__init__.py
index cbb2cafd99..7d8b678cc5 100644
--- a/taskvine/src/graph/vinedag/context_graph/__init__.py
+++ b/taskvine/src/graph/vinedag/context_graph/__init__.py
@@ -3,14 +3,14 @@
 # See the file COPYING for details.
 
 
-from .core import ContextGraph, GraphKeyResult
+from .core import ContextGraph, ContextGraphTaskResult
 from .proxy_functions import compute_single_key, compute_dts_key, compute_sexpr_key
 from .proxy_library import ProxyLibrary
 
 
 __all__ = [
     "ContextGraph",
-    "GraphKeyResult",
+    "ContextGraphTaskResult",
     "compute_single_key",
     "compute_dts_key",
     "compute_sexpr_key",
diff --git a/taskvine/src/graph/vinedag/context_graph/core.py b/taskvine/src/graph/vinedag/context_graph/core.py
index c3708c590c..61bbeb0d30 100644
--- a/taskvine/src/graph/vinedag/context_graph/core.py
+++ b/taskvine/src/graph/vinedag/context_graph/core.py
@@ -32,7 +32,7 @@ def hashable(s):
 
 # Lightweight wrapper around task results that optionally pads the payload. The
 # padding lets tests model large outputs without altering the logical result.
-class GraphKeyResult:
+class ContextGraphTaskResult:
     def __init__(self, result, extra_size_mb=None):
         """Store the real user result plus optional padding used during regression tests."""
         self.result = result
@@ -47,7 +47,7 @@ def load_from_path(path):
         try:
             with open(path, "rb") as f:
                 result_obj = cloudpickle.load(f)
-                assert isinstance(result_obj, GraphKeyResult), "Loaded object is not of type GraphKeyResult"
+                assert isinstance(result_obj, ContextGraphTaskResult), "Loaded object is not of type ContextGraphTaskResult"
                 return result_obj.result
         except FileNotFoundError:
             raise FileNotFoundError(f"Output file not found at {path}")
@@ -149,7 +149,7 @@ def _find_sexpr_parents(sexpr):
     def save_result_of_key(self, key, result):
         """Called from the proxy function to persist a result into disk after the worker finishes."""
         with open(self.outfile_remote_name[key], "wb") as f:
-            result_obj = GraphKeyResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
+            result_obj = ContextGraphTaskResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
             cloudpickle.dump(result_obj, f)
 
     def load_result_of_key(self, key):
@@ -158,7 +158,7 @@ def load_result_of_key(self, key):
         # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
         # if a shared file system output, then remote name is the full path to the file
         outfile_path = self.outfile_remote_name[key]
-        return GraphKeyResult.load_from_path(outfile_path)
+        return ContextGraphTaskResult.load_from_path(outfile_path)
 
     def get_topological_order(self):
         """Produce the order VineDAG uses when assigning node IDs to the C graph."""
diff --git a/taskvine/src/graph/vinedag/context_graph/proxy_library.py b/taskvine/src/graph/vinedag/context_graph/proxy_library.py
index 2bc4dd3c7c..a0c4fb4377 100644
--- a/taskvine/src/graph/vinedag/context_graph/proxy_library.py
+++ b/taskvine/src/graph/vinedag/context_graph/proxy_library.py
@@ -11,7 +11,7 @@
 import hashlib
 import collections
 
-from ndcctools.taskvine.vinedag.context_graph.core import GraphKeyResult, ContextGraph
+from ndcctools.taskvine.vinedag.context_graph.core import ContextGraphTaskResult, ContextGraph
 from ndcctools.taskvine.vinedag.context_graph.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
 from ndcctools.taskvine.utils import load_variable_from_library
 
@@ -28,7 +28,7 @@ def __init__(self, py_manager):
         # these modules are always included in the preamble of the library task, so that function calls can execute directly
         # using the loaded context without importing them over and over again
         self.hoisting_modules = [
-            os, cloudpickle, GraphKeyResult, ContextGraph, uuid, hashlib, random, types, collections, time,
+            os, cloudpickle, ContextGraphTaskResult, ContextGraph, uuid, hashlib, random, types, collections, time,
             load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key
         ]
 
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph.h b/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
index f749f442ab..0d9edb2a9b 100644
--- a/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
@@ -40,12 +40,12 @@ struct vine_graph {
 	 * as long as the manager can access it. */
 	char *output_dir;
 
-	/* Python-side proxy library name. ContextGraph owns this library and sends calls into the vine graph
+	/* Python-side proxy library name. The context_graph runtime owns this library and sends calls into the vine graph
 	 * so the manager can execute them through the proxy function. */
 	char *proxy_library_name;
 
 	/* The proxy function lives inside that library. It receives vine node IDs, looks up the
-	 * Python callable and arguments inside ContextGraph, and executes the work. ContextGraph generates the name
+	 * Python callable and arguments inside the context_graph runtime, and executes the work. The runtime generates the name
 	 * and shares it with the vine graph. */
 	char *proxy_function_name;
 
diff --git a/taskvine/src/graph/vinedag/vinedag.py b/taskvine/src/graph/vinedag/vinedag.py
index 165badaf42..f3be364466 100644
--- a/taskvine/src/graph/vinedag/vinedag.py
+++ b/taskvine/src/graph/vinedag/vinedag.py
@@ -7,7 +7,7 @@
 
 from ndcctools.taskvine.vinedag.context_graph.proxy_library import ProxyLibrary
 from ndcctools.taskvine.vinedag.context_graph.proxy_functions import compute_single_key
-from ndcctools.taskvine.vinedag.context_graph.core import ContextGraph, GraphKeyResult
+from ndcctools.taskvine.vinedag.context_graph.core import ContextGraph, ContextGraphTaskResult
 from ndcctools.taskvine.vinedag.vine_graph.vine_graph_client import VineGraphClient
 
 import cloudpickle
@@ -305,7 +305,7 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
         results = {}
         for k in target_keys:
             outfile_path = os.path.join(self.param("output-dir"), context_graph.outfile_remote_name[k])
-            results[k] = GraphKeyResult.load_from_path(outfile_path)
+            results[k] = ContextGraphTaskResult.load_from_path(outfile_path)
         return results
 
     def _on_sigint(self, signum, frame):
diff --git a/taskvine/src/manager/vine_manager_put.c b/taskvine/src/manager/vine_manager_put.c
index 0b95d62c31..9076124698 100644
--- a/taskvine/src/manager/vine_manager_put.c
+++ b/taskvine/src/manager/vine_manager_put.c
@@ -476,7 +476,7 @@ It does not perform any resource management.
 This allows it to be used for both regular tasks and mini tasks.
 */
 
-vine_result_code_t vine_manager_put_task_old(
+vine_result_code_t vine_manager_put_task(
 		struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t, const char *command_line, struct rmsummary *limits, struct vine_file *target)
 {
 	if (target) {
@@ -590,270 +590,3 @@ vine_result_code_t vine_manager_put_task_old(
 		return VINE_WORKER_FAILURE;
 	}
 }
-
-/*
- * Extreme-optimized implementation of vine_manager_put_task()
- *
- * Key ideas:
- *  - Build the entire task definition (header + command payload + tail)
- *    in one contiguous growable buffer.
- *  - Send the full buffer in one (or very few) link_putlstring() calls.
- *  - No nested functions, no temp stack buffers, no redundant syscalls.
- *  - Protocol and API remain fully backward compatible.
- *  - Achieves order-of-magnitude throughput improvement for short tasks.
- */
-
-#include <stdarg.h>
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <time.h>
-#include <inttypes.h>
-
-/* ---------------------------------------------------------------------- */
-/* Small dynamic buffer utility (local to this file)                      */
-/* ---------------------------------------------------------------------- */
-
-struct sbuf {
-	char *buf;
-	size_t len;
-	size_t cap;
-};
-
-#define SB_INIT_CAP 4096
-#define SB_MAX_CHUNK (1024 * 1024) /* 1 MB max per write */
-
-/* Reserve space for additional bytes. Grows buffer exponentially. */
-#define SB_RESERVE(B, NEED) \
-	do { \
-		size_t need = (B).len + (size_t)(NEED) + 1; \
-		if (need > (B).cap) { \
-			size_t cap = (B).cap ? (B).cap : SB_INIT_CAP; \
-			while (cap < need) \
-				cap <<= 1; \
-			char *nb = (char *)realloc((B).buf, cap); \
-			if (!nb) { \
-				free((B).buf); \
-				return VINE_WORKER_FAILURE; \
-			} \
-			(B).buf = nb; \
-			(B).cap = cap; \
-		} \
-	} while (0)
-
-/* Append formatted text directly into buffer. */
-static inline int sb_vprintf(struct sbuf *B, const char *fmt, va_list ap0)
-{
-	va_list ap;
-	va_copy(ap, ap0);
-
-	size_t avail = (B->cap > B->len) ? (B->cap - B->len) : 0;
-	if (avail < 64) {
-		SB_RESERVE((*B), 64);
-		avail = B->cap - B->len;
-	}
-
-	int n = vsnprintf(B->buf + B->len, avail, fmt, ap);
-	va_end(ap);
-	if (n < 0)
-		return -1;
-
-	/* If output was truncated, expand and retry */
-	if ((size_t)n >= avail) {
-		SB_RESERVE((*B), (size_t)n);
-		va_copy(ap, ap0);
-		n = vsnprintf(B->buf + B->len, B->cap - B->len, fmt, ap);
-		va_end(ap);
-		if (n < 0)
-			return -1;
-	}
-
-	B->len += (size_t)n;
-	return n;
-}
-
-/* Append formatted string. */
-static inline int sb_printf(struct sbuf *B, const char *fmt, ...)
-{
-	va_list ap;
-	va_start(ap, fmt);
-	int n = sb_vprintf(B, fmt, ap);
-	va_end(ap);
-	return n;
-}
-
-/* Append raw bytes. */
-static inline int sb_append(struct sbuf *B, const void *p, size_t n)
-{
-	SB_RESERVE((*B), n);
-	memcpy(B->buf + B->len, p, n);
-	B->len += n;
-	B->buf[B->len] = '\0';
-	return 0;
-}
-
-/* ---------------------------------------------------------------------- */
-/* Main function: vine_manager_put_task()                                 */
-/* ---------------------------------------------------------------------- */
-
-vine_result_code_t vine_manager_put_task(
-		struct vine_manager *q, struct vine_worker_info *w,
-		struct vine_task *t, const char *command_line,
-		struct rmsummary *limits, struct vine_file *target)
-{
-	/* If target already on worker */
-	if (target && vine_file_replica_table_lookup(w, target->cached_name)) {
-		debug(D_NOTICE, "mini_task %s already at %s", target->cached_name, w->addrport);
-		return VINE_SUCCESS;
-	}
-
-	/* Send input files first */
-	vine_result_code_t result = vine_manager_put_input_files(q, w, t);
-	if (result != VINE_SUCCESS)
-		return result;
-
-	if (!command_line)
-		command_line = t->command_line;
-	const long long cmd_len = (long long)strlen(command_line);
-
-	struct sbuf sb = {0};
-
-	/* helper: exact same debug prefix format as vine_manager_send() */
-	auto void dbg_tx(struct vine_worker_info * ww, const char *s, size_t n)
-	{
-		if (!s || n == 0)
-			return;
-		debug(D_VINE, "tx to %s (%s): %.*s", ww->hostname, ww->addrport, (int)n, s);
-	}
-
-/* helper: format one logical line, append to sb, and debug it */
-#ifndef VINE_LINE_MAX
-#define VINE_LINE_MAX 65536
-#endif
-	auto void emitf(const char *fmt, ...)
-	{
-		char line[VINE_LINE_MAX];
-		va_list ap;
-		va_start(ap, fmt);
-		int n = vsnprintf(line, sizeof(line), fmt, ap);
-		va_end(ap);
-		if (n < 0)
-			n = 0;
-		size_t len = (size_t)n;
-		if (len >= sizeof(line))
-			len = sizeof(line) - 1; /* truncate for debug parity safety */
-		sb_printf(&sb, "%.*s", (int)len, line);
-		dbg_tx(w, line, len);
-	}
-
-	/* Header */
-	if (target) {
-		int mode = target->mode ? target->mode : 0755;
-		emitf("mini_task %s %s %d %lld 0%o\n",
-				target->source,
-				target->cached_name,
-				target->cache_level,
-				(long long)target->size,
-				mode);
-	} else {
-		emitf("task %lld\n", (long long)t->task_id);
-	}
-
-	/* cmd header + payload */
-	emitf("cmd %lld\n", cmd_len);
-	sb_append(&sb, command_line, (size_t)cmd_len);
-	dbg_tx(w, command_line, (size_t)cmd_len);
-	emitf("\n");
-
-	/* extras */
-	if (t->needs_library) {
-		emitf("needs_library %s\n", t->needs_library);
-	}
-
-	if (t->provides_library) {
-		emitf("provides_library %s\n", t->provides_library);
-		emitf("function_slots %d\n", t->function_slots_total);
-		emitf("func_exec_mode %d\n", t->func_exec_mode);
-	}
-
-	emitf("category %s\n", t->category);
-
-	if (limits) {
-		emitf("cores %s\n", rmsummary_resource_to_str("cores", limits->cores, 0));
-		emitf("gpus %s\n", rmsummary_resource_to_str("gpus", limits->gpus, 0));
-		emitf("memory %s\n", rmsummary_resource_to_str("memory", limits->memory, 0));
-		emitf("disk %s\n", rmsummary_resource_to_str("disk", limits->disk, 0));
-
-		if (q->monitor_mode == VINE_MON_DISABLED) {
-			if (limits->end > 0)
-				emitf("end_time %s\n", rmsummary_resource_to_str("end", limits->end, 0));
-			if (limits->wall_time > 0)
-				emitf("wall_time %s\n", rmsummary_resource_to_str("wall_time", limits->wall_time, 0));
-		}
-	}
-
-	/* env list */
-	char *var;
-	LIST_ITERATE(t->env_list, var)
-	{
-		size_t L = strlen(var);
-		emitf("env %zu\n", L);
-		sb_append(&sb, var, L);
-		dbg_tx(w, var, L);
-		emitf("\n");
-	}
-
-	/* infile mounts */
-	if (t->input_mounts) {
-		struct vine_mount *m;
-		LIST_ITERATE(t->input_mounts, m)
-		{
-			char enc[PATH_MAX];
-			url_encode(m->remote_name, enc, PATH_MAX);
-			emitf("infile %s %s %d\n", m->file->cached_name, enc, m->flags);
-		}
-	}
-
-	/* outfile mounts */
-	if (t->output_mounts) {
-		struct vine_mount *m;
-		LIST_ITERATE(t->output_mounts, m)
-		{
-			char enc[PATH_MAX];
-			url_encode(m->remote_name, enc, PATH_MAX);
-			emitf("outfile %s %s %d\n", m->file->cached_name, enc, m->flags);
-		}
-	}
-
-	if (t->group_id) {
-		emitf("groupid %d\n", t->group_id);
-	}
-
-	emitf("end\n");
-
-	/* Send in chunks (no extra debug here to avoid duplicate logs) */
-	const char *p = sb.buf;
-	size_t left = sb.len;
-	time_t deadline = time(0) + q->short_timeout;
-	int r = 0;
-
-	while (left > 0) {
-		size_t chunk = left > SB_MAX_CHUNK ? SB_MAX_CHUNK : left;
-		r = link_putlstring(w->link, p, chunk, deadline);
-		if (r < 0)
-			break;
-		p += chunk;
-		left -= chunk;
-	}
-
-	if (r >= 0 && left == 0) {
-		if (target) {
-			vine_file_replica_table_get_or_create(q, w, target->cached_name, target->type, target->cache_level, target->size, target->mtime);
-		}
-		free(sb.buf);
-		return VINE_SUCCESS;
-	} else {
-		free(sb.buf);
-		return VINE_WORKER_FAILURE;
-	}
-}

From c0cc11602ec5da35da4e65d0236a6b3fd9e6672f Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 10:38:29 -0500
Subject: [PATCH 069/113] traverse w->current_libraries instead of
 w->current_tasks

---
 taskvine/src/manager/vine_manager.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index ca72d257d9..7ebcdb3ede 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3067,12 +3067,12 @@ static void find_max_worker(struct vine_manager *q)
  * are not counted towards the resources in use and will be killed if needed. */
 static void kill_empty_libraries_on_worker(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t)
 {
-	uint64_t task_id;
-	struct vine_task *task;
-	ITABLE_ITERATE(w->current_tasks, task_id, task)
+	uint64_t libtask_id;
+	struct vine_task *libtask;
+	ITABLE_ITERATE(w->current_libraries, libtask_id, libtask)
 	{
-		if (task->provides_library && task->function_slots_inuse == 0 && (!t->needs_library || strcmp(t->needs_library, task->provides_library))) {
-			vine_cancel_by_task_id(q, task->task_id);
+		if (libtask->function_slots_inuse == 0 && (!t->needs_library || strcmp(t->needs_library, libtask->provides_library))) {
+			vine_cancel_by_task_id(q, libtask_id);
 		}
 	}
 }

From a8dd136e11112bc91d0d2a4f6f4b03a98389eaf8 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 10:41:48 -0500
Subject: [PATCH 070/113] merge

---
 taskvine/src/graph/README.md                       |  2 --
 taskvine/src/graph/vinedag/vine_graph/__init__.py  |  8 ++------
 taskvine/src/graph/vinedag/vine_graph/vine_graph.h | 14 +++++++-------
 taskvine/src/graph/vinedag/vine_graph/vine_node.h  |  6 +++---
 taskvine/src/graph/vinedag/vinedag.py              |  1 +
 taskvine/src/manager/vine_manager.c                |  2 +-
 6 files changed, 14 insertions(+), 19 deletions(-)
 delete mode 100644 taskvine/src/graph/README.md

diff --git a/taskvine/src/graph/README.md b/taskvine/src/graph/README.md
deleted file mode 100644
index 8d7a3f59fc..0000000000
--- a/taskvine/src/graph/README.md
+++ /dev/null
@@ -1,2 +0,0 @@
-# Graph Executors
-
diff --git a/taskvine/src/graph/vinedag/vine_graph/__init__.py b/taskvine/src/graph/vinedag/vine_graph/__init__.py
index 4dd6f218ce..536eed6b88 100644
--- a/taskvine/src/graph/vinedag/vine_graph/__init__.py
+++ b/taskvine/src/graph/vinedag/vine_graph/__init__.py
@@ -2,13 +2,9 @@
 # This software is distributed under the GNU General Public License.
 # See the file COPYING for details.
 
-"""Namespace for the C vine graph bindings and Python client."""
-
-try:  # pragma: no cover - module only exists after building the SWIG bindings
-    from . import vine_graph_capi
-except ImportError:
-    vine_graph_capi = None
 
+from . import vine_graph_capi
 from .vine_graph_client import VineGraphClient
 
+
 __all__ = ["vine_graph_capi", "VineGraphClient"]
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph.h b/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
index 0d9edb2a9b..e3f78f5c83 100644
--- a/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_graph.h
@@ -14,13 +14,13 @@
 
 /** The task priority algorithm used for vine graph scheduling. */
 typedef enum {
-	TASK_PRIORITY_MODE_RANDOM = 0,			   /**< Assign random priority to tasks */
-	TASK_PRIORITY_MODE_DEPTH_FIRST,			   /**< Prioritize deeper tasks first */
-	TASK_PRIORITY_MODE_BREADTH_FIRST,		   /**< Prioritize shallower tasks first */
-	TASK_PRIORITY_MODE_FIFO,			   /**< First in, first out priority */
-	TASK_PRIORITY_MODE_LIFO,			   /**< Last in, first out priority */
-	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		   /**< Prioritize tasks with larger inputs first */
-	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
+	TASK_PRIORITY_MODE_RANDOM = 0,			              /**< Assign random priority to tasks */
+	TASK_PRIORITY_MODE_DEPTH_FIRST,			              /**< Prioritize deeper tasks first */
+	TASK_PRIORITY_MODE_BREADTH_FIRST,		              /**< Prioritize shallower tasks first */
+	TASK_PRIORITY_MODE_FIFO,			                  /**< First in, first out priority */
+	TASK_PRIORITY_MODE_LIFO,			                  /**< Last in, first out priority */
+	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		          /**< Prioritize tasks with larger inputs first */
+	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST    /**< Prioritize tasks with larger storage footprint first */
 } task_priority_mode_t;
 
 /** The vine graph (logical scheduling layer). */
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_node.h b/taskvine/src/graph/vinedag/vine_graph/vine_node.h
index a838fb6e88..9f01e959c0 100644
--- a/taskvine/src/graph/vinedag/vine_graph/vine_node.h
+++ b/taskvine/src/graph/vinedag/vine_graph/vine_node.h
@@ -11,9 +11,9 @@
 
 /** The storage type of the node's output file. */
 typedef enum {
-	NODE_OUTFILE_TYPE_LOCAL = 0,	      /* Node-output file will be stored locally on the local staging directory */
-	NODE_OUTFILE_TYPE_TEMP,		      /* Node-output file will be stored in the temporary node-local storage */
-	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
+	NODE_OUTFILE_TYPE_LOCAL = 0,	       /* Node-output file will be stored locally on the local staging directory */
+	NODE_OUTFILE_TYPE_TEMP,		           /* Node-output file will be stored in the temporary node-local storage */
+	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,  /* Node-output file will be stored in the persistent shared file system */
 } node_outfile_type_t;
 
 /** The status of an output file of a node. */
diff --git a/taskvine/src/graph/vinedag/vinedag.py b/taskvine/src/graph/vinedag/vinedag.py
index f3be364466..77975df3f5 100644
--- a/taskvine/src/graph/vinedag/vinedag.py
+++ b/taskvine/src/graph/vinedag/vinedag.py
@@ -177,6 +177,7 @@ def __init__(self,
 
         # Boot the underlying TaskVine manager. The TaskVine manager keeps alive until the vinedag object is destroyed
         super().__init__(*args, **kwargs)
+        print(f"cvine = {cvine}")
         self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
 
         print(f"=== Manager name: {color_text(self.name, 92)}")
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index b1a405564e..d6aa1942e0 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3149,7 +3149,7 @@ static vine_result_code_t commit_task_to_worker(struct vine_manager *q, struct v
 
 	/* Kill unused libraries on this worker to reclaim resources. */
 	/* Matches assumption in vine_schedule.c:check_worker_have_enough_resources() */
-	// kill_empty_libraries_on_worker(q, w, t);
+	kill_empty_libraries_on_worker(q, w, t);
 
 	/* If this is a function needing a library, dispatch the library. */
 	if (t->needs_library) {

From 0372e722d30eae7e1f693576a45dd2dbb8cc4502 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 10:44:37 -0500
Subject: [PATCH 071/113] revert push_task_to_ready_tasks

---
 taskvine/src/manager/vine_manager.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index d6aa1942e0..e6ff9a3660 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -170,7 +170,7 @@ static void delete_uncacheable_files(struct vine_manager *q, struct vine_worker_
 static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
-static void enqueue_ready_task(struct vine_manager *q, struct vine_task *t);
+static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t);
 
 static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
 
@@ -3712,7 +3712,7 @@ static int rotate_pending_tasks(struct vine_manager *q)
 		}
 
 		if (consider_task(q, t)) {
-			enqueue_ready_task(q, t);
+			push_task_to_ready_tasks(q, t);
 			runnable_tasks++;
 		} else {
 			list_push_tail(q->pending_tasks, t);
@@ -3814,7 +3814,7 @@ static int send_one_task(struct vine_manager *q, int *tasks_ready_left_to_consid
 
 	/* put back all tasks that were skipped */
 	while ((t = list_pop_head(skipped_tasks))) {
-		enqueue_ready_task(q, t);
+		push_task_to_ready_tasks(q, t);
 	}
 	list_delete(skipped_tasks);
 
@@ -4809,7 +4809,7 @@ char *vine_monitor_wrap(struct vine_manager *q, struct vine_worker_info *w, stru
 }
 
 /* Put a given task on the ready queue, taking into account the task priority and the manager schedule. */
-static void enqueue_ready_task(struct vine_manager *q, struct vine_task *t)
+static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t)
 {
 	if (t->result == VINE_RESULT_RESOURCE_EXHAUSTION) {
 		/* when a task is resubmitted given resource exhaustion, we
@@ -4873,7 +4873,7 @@ static vine_task_state_t change_task_state(struct vine_manager *q, struct vine_t
 		break;
 	case VINE_TASK_READY:
 		vine_task_set_result(t, VINE_RESULT_UNKNOWN);
-		enqueue_ready_task(q, t);
+		push_task_to_ready_tasks(q, t);
 		c->vine_stats->tasks_waiting++;
 		break;
 	case VINE_TASK_RUNNING:

From 10593213a2954456f8bfefa721780c48f422de9e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 10:49:00 -0500
Subject: [PATCH 072/113] vine: multiply task priority on resource exhaustion

---
 taskvine/src/manager/vine_manager.c | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index ca72d257d9..b819b2e16c 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -4668,14 +4668,13 @@ static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t
 {
 	if (t->result == VINE_RESULT_RESOURCE_EXHAUSTION) {
 		/* when a task is resubmitted given resource exhaustion, we
-		 * increment its priority by 1, so it gets to run as soon
+		 * increment its priority a bit, so it gets to run as soon
 		 * as possible among those with the same priority. This avoids
 		 * the issue in which all 'big' tasks fail because the first
 		 * allocation is too small. */
-		priority_queue_push(q->ready_tasks, t, t->priority + 1);
-	} else {
-		priority_queue_push(q->ready_tasks, t, t->priority);
+		t->priority *= 1.05;
 	}
+	priority_queue_push(q->ready_tasks, t, t->priority);
 
 	/* If the task has been used before, clear out accumulated state. */
 	vine_task_clean(t);

From 78501414f766481e1e4e15e6ae784e200ffcaaa2 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 15:47:36 -0500
Subject: [PATCH 073/113] vine: clean redundant input replicas upon task
 completion

---
 taskvine/src/manager/vine_manager.c | 80 +++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index ca72d257d9..d67c822179 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -170,6 +170,8 @@ static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
 
+static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
+
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
 
 static int count_workers(struct vine_manager *q, vine_worker_type_t type)
@@ -650,6 +652,15 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 	itable_remove(q->running_table, t->task_id);
 	vine_task_set_result(t, task_status);
 
+	/* Clean redundant replicas for the inputs of the task. */
+	struct vine_mount *input_mount;
+	LIST_ITERATE(t->input_mounts, input_mount)
+	{
+		if (input_mount->file && input_mount->file->type == VINE_TEMP) {
+			clean_redundant_replicas(q, input_mount->file);
+		}
+	}
+
 	return VINE_SUCCESS;
 }
 
@@ -1001,6 +1012,75 @@ static int enforce_worker_eviction_interval(struct vine_manager *q)
 	return 1;
 }
 
+/** Clean redundant replicas of a temporary file. 
+For example, a file may be transferred to another worker because a task that declares it 
+as input is scheduled there, resulting in an extra replica that consumes storage space. 
+This function evaluates whether the file has excessive replicas and removes those on 
+workers that do not execute their dependent tasks. */
+static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f)
+{
+	if (!f || f->type != VINE_TEMP) {
+		return;
+	}
+
+	struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!source_workers) {
+		/* no surprise - a cache-update message may trigger a file deletion. */
+		return;
+	}
+	int excess_replicas = set_size(source_workers) - q->temp_replica_count;
+	if (excess_replicas <= 0) {
+		return;
+	}
+	/* Note that this replica may serve as a source for a peer transfer. If it is unlinked prematurely,
+	 * the corresponding transfer could fail and leave a task without its required data.
+	 * Therefore, we must wait until all replicas are confirmed ready before proceeding. */
+	if (vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY) != set_size(source_workers)) {
+		return;
+	}
+
+	struct priority_queue *clean_replicas_from_workers = priority_queue_create(0);
+
+	struct vine_worker_info *source_worker = NULL;
+	SET_ITERATE(source_workers, source_worker)
+	{
+		/* if the file is actively in use by a task (the input to that task), we don't remove the replica on this worker */
+		int file_inuse = 0;
+
+		uint64_t task_id;
+		struct vine_task *task;
+		ITABLE_ITERATE(source_worker->current_tasks, task_id, task)
+		{
+			struct vine_mount *input_mount;
+			LIST_ITERATE(task->input_mounts, input_mount)
+			{
+				if (f == input_mount->file) {
+					file_inuse = 1;
+					break;
+				}
+			}
+			if (file_inuse) {
+				break;
+			}
+		}
+		
+		if (file_inuse) {
+			continue;
+		}
+
+		priority_queue_push(clean_replicas_from_workers, source_worker, source_worker->inuse_cache);
+	}
+
+	source_worker = NULL;
+	while (excess_replicas > 0 && (source_worker = priority_queue_pop(clean_replicas_from_workers))) {
+		delete_worker_file(q, source_worker, f->cached_name, 0, 0);
+		excess_replicas--;
+	}
+	priority_queue_delete(clean_replicas_from_workers);
+
+	return;
+}
+
 /* Remove all tasks and other associated state from a given worker. */
 static void cleanup_worker(struct vine_manager *q, struct vine_worker_info *w)
 {

From 3bcc9d0832749a16a62d9f76cf6a7b114553443d Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 3 Nov 2025 15:51:51 -0500
Subject: [PATCH 074/113] lint

---
 taskvine/src/manager/vine_manager.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index d67c822179..633b91fd8b 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -1012,10 +1012,10 @@ static int enforce_worker_eviction_interval(struct vine_manager *q)
 	return 1;
 }
 
-/** Clean redundant replicas of a temporary file. 
-For example, a file may be transferred to another worker because a task that declares it 
-as input is scheduled there, resulting in an extra replica that consumes storage space. 
-This function evaluates whether the file has excessive replicas and removes those on 
+/** Clean redundant replicas of a temporary file.
+For example, a file may be transferred to another worker because a task that declares it
+as input is scheduled there, resulting in an extra replica that consumes storage space.
+This function evaluates whether the file has excessive replicas and removes those on
 workers that do not execute their dependent tasks. */
 static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f)
 {
@@ -1063,7 +1063,7 @@ static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f
 				break;
 			}
 		}
-		
+
 		if (file_inuse) {
 			continue;
 		}

From 203736a900e23eddb005855883fc6f972b984aef Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 13:15:27 -0500
Subject: [PATCH 075/113] make it an argument

---
 taskvine/src/manager/vine_manager.c | 20 ++++++++++++++------
 taskvine/src/manager/vine_manager.h |  1 +
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 633b91fd8b..4528039273 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -652,12 +652,16 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 	itable_remove(q->running_table, t->task_id);
 	vine_task_set_result(t, task_status);
 
-	/* Clean redundant replicas for the inputs of the task. */
-	struct vine_mount *input_mount;
-	LIST_ITERATE(t->input_mounts, input_mount)
-	{
-		if (input_mount->file && input_mount->file->type == VINE_TEMP) {
-			clean_redundant_replicas(q, input_mount->file);
+	/* A task scheduling may result in a redundant replica of its input due to peer transfers, which can be safely removed when completed.
+	 * However, the general function of taskvine is to replicate files on demand, and to only clean them up when prune is called.
+	 * So, we only clean up redundant replicas for the task-inputs when the manager is configured to do so. */
+	if (q->clean_redundant_replicas) {
+		struct vine_mount *input_mount;
+		LIST_ITERATE(t->input_mounts, input_mount)
+		{
+			if (input_mount->file && input_mount->file->type == VINE_TEMP) {
+				clean_redundant_replicas(q, input_mount->file);
+			}
 		}
 	}
 
@@ -4299,6 +4303,7 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->perf_log_interval = VINE_PERF_LOG_INTERVAL;
 
 	q->temp_replica_count = 1;
+	q->clean_redundant_replicas = 0;
 	q->transfer_temps_recovery = 0;
 	q->transfer_replica_per_cycle = 10;
 
@@ -6060,6 +6065,9 @@ int vine_tune(struct vine_manager *q, const char *name, double value)
 	} else if (!strcmp(name, "enforce-worker-eviction-interval")) {
 		q->enforce_worker_eviction_interval = (timestamp_t)(MAX(0, (int)value) * ONE_SECOND);
 
+	} else if (!strcmp(name, "clean-redundant-replicas")) {
+		q->clean_redundant_replicas = !!((int)value);
+
 	} else {
 		debug(D_NOTICE | D_VINE, "Warning: tuning parameter \"%s\" not recognized\n", name);
 		return -1;
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index bcf2405616..f0241e3d9f 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -217,6 +217,7 @@ struct vine_manager {
 	int transfer_temps_recovery;  /* If true, attempt to recover temp files from lost worker to reach threshold required */
 	int transfer_replica_per_cycle;  /* Maximum number of replica to request per temp file per iteration */
 	int temp_replica_count;       /* Number of replicas per temp file */
+	int clean_redundant_replicas; /* If true, remove redundant replicas of temp files to save disk space. */
 
 	double resource_submit_multiplier; /* Factor to permit overcommitment of resources at each worker.  */
 	double bandwidth_limit;            /* Artificial limit on bandwidth of manager<->worker transfers. */

From af1eb9dd2fe39bb1e618cf9d89d9e70fd5b1f1e7 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 13:17:41 -0500
Subject: [PATCH 076/113] shift-disk-load

---
 taskvine/src/manager/vine_manager.c | 80 ++++++++++++++++++++++++++---
 taskvine/src/manager/vine_manager.h |  2 +
 2 files changed, 76 insertions(+), 6 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 633b91fd8b..2874745781 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -170,6 +170,7 @@ static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
 
+static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f);
 static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
 
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
@@ -424,6 +425,10 @@ static vine_msg_code_t handle_cache_update(struct vine_manager *q, struct vine_w
 			if (f->type == VINE_TEMP && *id == 'X' && q->temp_replica_count > 1) {
 				hash_table_insert(q->temp_files_to_replicate, f->cached_name, NULL);
 			}
+
+			if (q->shift_disk_load) {
+				shift_disk_load(q, w, f);
+			}
 		}
 	}
 
@@ -652,12 +657,16 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 	itable_remove(q->running_table, t->task_id);
 	vine_task_set_result(t, task_status);
 
-	/* Clean redundant replicas for the inputs of the task. */
-	struct vine_mount *input_mount;
-	LIST_ITERATE(t->input_mounts, input_mount)
-	{
-		if (input_mount->file && input_mount->file->type == VINE_TEMP) {
-			clean_redundant_replicas(q, input_mount->file);
+	/* A task scheduling may result in a redundant replica of its input due to peer transfers, which can be safely removed when completed.
+	 * However, the general function of taskvine is to replicate files on demand, and to only clean them up when prune is called.
+	 * So, we only clean up redundant replicas for the task-inputs when the manager is configured to clean redundant replicas. */
+	if (q->clean_redundant_replicas) {
+		struct vine_mount *input_mount;
+		LIST_ITERATE(t->input_mounts, input_mount)
+		{
+			if (input_mount->file && input_mount->file->type == VINE_TEMP) {
+				clean_redundant_replicas(q, input_mount->file);
+			}
 		}
 	}
 
@@ -1012,6 +1021,57 @@ static int enforce_worker_eviction_interval(struct vine_manager *q)
 	return 1;
 }
 
+static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f)
+{
+	if (!q || !source_worker || !f) {
+		return;
+	}
+
+	if (f->type != VINE_TEMP) {
+		return;
+	}
+
+	/* Determine if this replica is from the heaviest worker, and if so, trigger a replication immediately 
+	* to shift the storage burden to the most free and eligible worker. */
+	struct vine_worker_info *target_worker = NULL;
+
+	char *key;
+	struct vine_worker_info *w = NULL;
+	HASH_TABLE_ITERATE(q->worker_table, key, w)
+	{
+		if (w->type != VINE_WORKER_TYPE_WORKER) {
+			continue;
+		}
+		if (!w->transfer_port_active) {
+			continue;
+		}
+		if (w->draining) {
+			continue;
+		}
+		if (w->resources->tag < 0) {
+			continue;
+		}
+		if (vine_file_replica_table_lookup(w, f->cached_name)) {
+			continue;
+		}
+		if (w->inuse_cache + f->size > (source_worker->inuse_cache - f->size) * 0.8) {
+			continue;
+		}
+		if (!target_worker || w->inuse_cache < target_worker->inuse_cache) {
+			target_worker = w;
+		}
+	}
+	if (target_worker) {
+		char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
+		vine_manager_put_url_now(q, target_worker, source_worker, source_addr, f);
+		free(source_addr);
+	}
+
+	/* Shifting storage burden from heavy to light workers requires to replicate the file first, 
+	* so we can clean up the original one safely when the replica arrives at the destination worker. */
+	clean_redundant_replicas(q, f);
+}
+
 /** Clean redundant replicas of a temporary file.
 For example, a file may be transferred to another worker because a task that declares it
 as input is scheduled there, resulting in an extra replica that consumes storage space.
@@ -4299,6 +4359,8 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->perf_log_interval = VINE_PERF_LOG_INTERVAL;
 
 	q->temp_replica_count = 1;
+	q->clean_redundant_replicas = 0;
+	q->shift_disk_load = 0;
 	q->transfer_temps_recovery = 0;
 	q->transfer_replica_per_cycle = 10;
 
@@ -6060,6 +6122,12 @@ int vine_tune(struct vine_manager *q, const char *name, double value)
 	} else if (!strcmp(name, "enforce-worker-eviction-interval")) {
 		q->enforce_worker_eviction_interval = (timestamp_t)(MAX(0, (int)value) * ONE_SECOND);
 
+	} else if (!strcmp(name, "shift-disk-load")) {
+		q->shift_disk_load = !!((int)value);
+
+	} else if (!strcmp(name, "clean-redundant-replicas")) {
+		q->clean_redundant_replicas = !!((int)value);
+
 	} else {
 		debug(D_NOTICE | D_VINE, "Warning: tuning parameter \"%s\" not recognized\n", name);
 		return -1;
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index bcf2405616..24989ce0e3 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -217,6 +217,8 @@ struct vine_manager {
 	int transfer_temps_recovery;  /* If true, attempt to recover temp files from lost worker to reach threshold required */
 	int transfer_replica_per_cycle;  /* Maximum number of replica to request per temp file per iteration */
 	int temp_replica_count;       /* Number of replicas per temp file */
+	int clean_redundant_replicas; /* If true, remove redundant replicas of temp files to save disk space. */
+	int shift_disk_load;          /* If true, shift storage burden to more available workers to minimize disk usage peaks. */
 
 	double resource_submit_multiplier; /* Factor to permit overcommitment of resources at each worker.  */
 	double bandwidth_limit;            /* Artificial limit on bandwidth of manager<->worker transfers. */

From e3e51b53c13d9cdc8e72393bc4941f3d2b8d7f26 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 13:25:32 -0500
Subject: [PATCH 077/113] lint

---
 taskvine/src/manager/vine_manager.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 8198229812..2a1a650184 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -1031,8 +1031,8 @@ static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *sou
 		return;
 	}
 
-	/* Determine if this replica is from the heaviest worker, and if so, trigger a replication immediately 
-	* to shift the storage burden to the most free and eligible worker. */
+	/* Determine if this replica is from the heaviest worker, and if so, trigger a replication immediately
+	 * to shift the storage burden to the most free and eligible worker. */
 	struct vine_worker_info *target_worker = NULL;
 
 	char *key;
@@ -1067,8 +1067,8 @@ static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *sou
 		free(source_addr);
 	}
 
-	/* Shifting storage burden from heavy to light workers requires to replicate the file first, 
-	* so we can clean up the original one safely when the replica arrives at the destination worker. */
+	/* Shifting storage burden from heavy to light workers requires to replicate the file first,
+	 * so we can clean up the original one safely when the replica arrives at the destination worker. */
 	clean_redundant_replicas(q, f);
 }
 

From f6e2b0ebee657f578c06638179723c92e34059ec Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 13:36:31 -0500
Subject: [PATCH 078/113] comment

---
 taskvine/src/manager/vine_manager.c | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 2a1a650184..5e79d36090 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -1021,6 +1021,11 @@ static int enforce_worker_eviction_interval(struct vine_manager *q)
 	return 1;
 }
 
+/**
+Shift a temp file replica away from the worker using the most cache space.
+This function looks for an alternative worker that can accept the file immediately
+so that the original replica can be cleaned up later by @clean_redundant_replicas().
+*/
 static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f)
 {
 	if (!q || !source_worker || !f) {
@@ -1031,8 +1036,6 @@ static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *sou
 		return;
 	}
 
-	/* Determine if this replica is from the heaviest worker, and if so, trigger a replication immediately
-	 * to shift the storage burden to the most free and eligible worker. */
 	struct vine_worker_info *target_worker = NULL;
 
 	char *key;
@@ -1067,8 +1070,7 @@ static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *sou
 		free(source_addr);
 	}
 
-	/* Shifting storage burden from heavy to light workers requires to replicate the file first,
-	 * so we can clean up the original one safely when the replica arrives at the destination worker. */
+	/* We can clean up the original one safely when the replica arrives at the destination worker. */
 	clean_redundant_replicas(q, f);
 }
 

From caff977042b1dc83cd89715713ad070b5717b085 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 13:45:17 -0500
Subject: [PATCH 079/113] vine_temp

---
 taskvine/src/manager/Makefile       |   3 +-
 taskvine/src/manager/vine_manager.c | 137 +-----------
 taskvine/src/manager/vine_temp.c    | 335 ++++++++++++++++++++++++++++
 taskvine/src/manager/vine_temp.h    |  13 ++
 4 files changed, 359 insertions(+), 129 deletions(-)
 create mode 100644 taskvine/src/manager/vine_temp.c
 create mode 100644 taskvine/src/manager/vine_temp.h

diff --git a/taskvine/src/manager/Makefile b/taskvine/src/manager/Makefile
index a036e9bd64..db09403667 100644
--- a/taskvine/src/manager/Makefile
+++ b/taskvine/src/manager/Makefile
@@ -28,7 +28,8 @@ SOURCES = \
 	vine_file_replica_table.c \
 	vine_fair.c \
 	vine_runtime_dir.c \
-	vine_task_groups.c
+	vine_task_groups.c \
+	vine_temp.c
 
 PUBLIC_HEADERS = taskvine.h
 
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 5e79d36090..5593e7aeda 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -29,6 +29,7 @@ See the file COPYING for details.
 #include "vine_taskgraph_log.h"
 #include "vine_txn_log.h"
 #include "vine_worker_info.h"
+#include "vine_temp.h"
 
 #include "address.h"
 #include "buffer.h"
@@ -170,9 +171,6 @@ static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
 
-static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f);
-static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
-
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
 
 static int count_workers(struct vine_manager *q, vine_worker_type_t type)
@@ -427,7 +425,7 @@ static vine_msg_code_t handle_cache_update(struct vine_manager *q, struct vine_w
 			}
 
 			if (q->shift_disk_load) {
-				shift_disk_load(q, w, f);
+				vine_temp_shift_disk_load(q, w, f);
 			}
 		}
 	}
@@ -665,7 +663,7 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 		LIST_ITERATE(t->input_mounts, input_mount)
 		{
 			if (input_mount->file && input_mount->file->type == VINE_TEMP) {
-				clean_redundant_replicas(q, input_mount->file);
+				vine_temp_clean_redundant_replicas(q, input_mount->file);
 			}
 		}
 	}
@@ -1021,128 +1019,6 @@ static int enforce_worker_eviction_interval(struct vine_manager *q)
 	return 1;
 }
 
-/**
-Shift a temp file replica away from the worker using the most cache space.
-This function looks for an alternative worker that can accept the file immediately
-so that the original replica can be cleaned up later by @clean_redundant_replicas().
-*/
-static void shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f)
-{
-	if (!q || !source_worker || !f) {
-		return;
-	}
-
-	if (f->type != VINE_TEMP) {
-		return;
-	}
-
-	struct vine_worker_info *target_worker = NULL;
-
-	char *key;
-	struct vine_worker_info *w = NULL;
-	HASH_TABLE_ITERATE(q->worker_table, key, w)
-	{
-		if (w->type != VINE_WORKER_TYPE_WORKER) {
-			continue;
-		}
-		if (!w->transfer_port_active) {
-			continue;
-		}
-		if (w->draining) {
-			continue;
-		}
-		if (w->resources->tag < 0) {
-			continue;
-		}
-		if (vine_file_replica_table_lookup(w, f->cached_name)) {
-			continue;
-		}
-		if (w->inuse_cache + f->size > (source_worker->inuse_cache - f->size) * 0.8) {
-			continue;
-		}
-		if (!target_worker || w->inuse_cache < target_worker->inuse_cache) {
-			target_worker = w;
-		}
-	}
-	if (target_worker) {
-		char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
-		vine_manager_put_url_now(q, target_worker, source_worker, source_addr, f);
-		free(source_addr);
-	}
-
-	/* We can clean up the original one safely when the replica arrives at the destination worker. */
-	clean_redundant_replicas(q, f);
-}
-
-/** Clean redundant replicas of a temporary file.
-For example, a file may be transferred to another worker because a task that declares it
-as input is scheduled there, resulting in an extra replica that consumes storage space.
-This function evaluates whether the file has excessive replicas and removes those on
-workers that do not execute their dependent tasks. */
-static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f)
-{
-	if (!f || f->type != VINE_TEMP) {
-		return;
-	}
-
-	struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
-	if (!source_workers) {
-		/* no surprise - a cache-update message may trigger a file deletion. */
-		return;
-	}
-	int excess_replicas = set_size(source_workers) - q->temp_replica_count;
-	if (excess_replicas <= 0) {
-		return;
-	}
-	/* Note that this replica may serve as a source for a peer transfer. If it is unlinked prematurely,
-	 * the corresponding transfer could fail and leave a task without its required data.
-	 * Therefore, we must wait until all replicas are confirmed ready before proceeding. */
-	if (vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY) != set_size(source_workers)) {
-		return;
-	}
-
-	struct priority_queue *clean_replicas_from_workers = priority_queue_create(0);
-
-	struct vine_worker_info *source_worker = NULL;
-	SET_ITERATE(source_workers, source_worker)
-	{
-		/* if the file is actively in use by a task (the input to that task), we don't remove the replica on this worker */
-		int file_inuse = 0;
-
-		uint64_t task_id;
-		struct vine_task *task;
-		ITABLE_ITERATE(source_worker->current_tasks, task_id, task)
-		{
-			struct vine_mount *input_mount;
-			LIST_ITERATE(task->input_mounts, input_mount)
-			{
-				if (f == input_mount->file) {
-					file_inuse = 1;
-					break;
-				}
-			}
-			if (file_inuse) {
-				break;
-			}
-		}
-
-		if (file_inuse) {
-			continue;
-		}
-
-		priority_queue_push(clean_replicas_from_workers, source_worker, source_worker->inuse_cache);
-	}
-
-	source_worker = NULL;
-	while (excess_replicas > 0 && (source_worker = priority_queue_pop(clean_replicas_from_workers))) {
-		delete_worker_file(q, source_worker, f->cached_name, 0, 0);
-		excess_replicas--;
-	}
-	priority_queue_delete(clean_replicas_from_workers);
-
-	return;
-}
-
 /* Remove all tasks and other associated state from a given worker. */
 static void cleanup_worker(struct vine_manager *q, struct vine_worker_info *w)
 {
@@ -5983,7 +5859,6 @@ void vine_set_manager_preferred_connection(struct vine_manager *q, const char *p
 
 int vine_tune(struct vine_manager *q, const char *name, double value)
 {
-
 	if (!strcmp(name, "attempt-schedule-depth")) {
 		q->attempt_schedule_depth = MAX(1, (int)value);
 
@@ -6122,6 +5997,12 @@ int vine_tune(struct vine_manager *q, const char *name, double value)
 	} else if (!strcmp(name, "enforce-worker-eviction-interval")) {
 		q->enforce_worker_eviction_interval = (timestamp_t)(MAX(0, (int)value) * ONE_SECOND);
 
+	} else if (!strcmp(name, "clean-redundant-replicas")) {
+		q->clean_redundant_replicas = !!((int)value);
+
+	} else if (!strcmp(name, "shift-disk-load")) {
+		q->shift_disk_load = !!((int)value);
+
 	} else {
 		debug(D_NOTICE | D_VINE, "Warning: tuning parameter \"%s\" not recognized\n", name);
 		return -1;
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
new file mode 100644
index 0000000000..7b574653ae
--- /dev/null
+++ b/taskvine/src/manager/vine_temp.c
@@ -0,0 +1,335 @@
+#include "vine_temp.h"
+#include "priority_queue.h"
+#include "vine_file.h"
+#include "vine_worker_info.h"
+#include "vine_file_replica_table.h"
+#include "macros.h"
+#include "stringtools.h"
+#include "vine_manager.h"
+#include "debug.h"
+#include "random.h"
+#include "vine_manager_put.h"
+#include "xxmalloc.h"
+
+/*************************************************************/
+/* Private Functions */
+/*************************************************************/
+
+static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return NULL;
+	}
+
+	struct set *sources = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!sources) {
+		return NULL;
+	}
+
+	struct priority_queue *valid_sources_queue = priority_queue_create(0);
+	struct vine_worker_info *w = NULL;
+	SET_ITERATE(sources, w)
+	{
+		/* skip if transfer port is not active or in draining mode */
+		if (!w->transfer_port_active || w->draining) {
+			continue;
+		}
+		/* skip if incoming transfer counter is too high */
+		if (w->outgoing_xfer_counter >= q->worker_source_max_transfers) {
+			continue;
+		}
+		/* skip if the worker does not have this file */
+		struct vine_file_replica *replica = vine_file_replica_table_lookup(w, f->cached_name);
+		if (!replica) {
+			continue;
+		}
+		/* skip if the file is not ready */
+		if (replica->state != VINE_FILE_REPLICA_STATE_READY) {
+			continue;
+		}
+		/* those with less outgoing_xfer_counter are preferred */
+		priority_queue_push(valid_sources_queue, w, -w->outgoing_xfer_counter);
+	}
+
+	struct vine_worker_info *best_source = priority_queue_pop(valid_sources_queue);
+	priority_queue_delete(valid_sources_queue);
+
+	return best_source;
+}
+
+static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return NULL;
+	}
+
+	struct priority_queue *valid_destinations = priority_queue_create(0);
+
+	char *key;
+	struct vine_worker_info *w;
+	HASH_TABLE_ITERATE(q->worker_table, key, w)
+	{
+		/* skip if transfer port is not active or in draining mode */
+		if (!w->transfer_port_active || w->draining) {
+			continue;
+		}
+		/* skip if the incoming transfer counter is too high */
+		if (w->incoming_xfer_counter >= q->worker_source_max_transfers) {
+			continue;
+		}
+		/* skip if the worker already has this file */
+		struct vine_file_replica *replica = vine_file_replica_table_lookup(w, f->cached_name);
+		if (replica) {
+			continue;
+		}
+		/* skip if the worker does not have enough disk space */
+		int64_t available_disk_space = get_worker_available_disk_bytes(w);
+		if ((int64_t)f->size > available_disk_space) {
+			continue;
+		}
+		/* workers with more available disk space are preferred to hold the file */
+		priority_queue_push(valid_destinations, w, available_disk_space);
+	}
+
+	struct vine_worker_info *best_destination = priority_queue_pop(valid_destinations);
+	priority_queue_delete(valid_destinations);
+
+	return best_destination;
+}
+
+static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return 0;
+	}
+
+	struct vine_worker_info *source_worker = get_best_source_worker(q, f);
+	if (!source_worker) {
+		return 0;
+	}
+
+	struct vine_worker_info *dest_worker = get_best_dest_worker(q, f);
+	if (!dest_worker) {
+		return 0;
+	}
+
+	vine_temp_start_peer_transfer(q, f, source_worker, dest_worker);
+
+	return 1;
+}
+
+/*************************************************************/
+/* Public Functions */
+/*************************************************************/
+
+void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker)
+{
+	if (!q || !f || f->type != VINE_TEMP || !source_worker || !dest_worker) {
+		return;
+	}
+
+	char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
+	vine_manager_put_url_now(q, dest_worker, source_worker, source_addr, f);
+	free(source_addr);
+}
+
+int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+		return 0;
+	}
+
+	int current_replica_count = vine_file_replica_count(q, f);
+	if (current_replica_count == 0 || current_replica_count >= q->temp_replica_count) {
+		return 0;
+	}
+
+	priority_queue_push(q->temp_files_to_replicate, f, -current_replica_count);
+
+	return 1;
+}
+
+int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
+{
+	if (!q || !cachename) {
+		return 0;
+	}
+
+	struct vine_file *f = hash_table_lookup(q->file_table, cachename);
+	if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+		return 0;
+	}
+
+	vine_temp_replicate_file_later(q, f);
+
+	return 1;
+}
+
+int vine_temp_start_replication(struct vine_manager *q)
+{
+	if (!q) {
+		return 0;
+	}
+
+	int processed = 0;
+	int iter_count = 0;
+	int iter_depth = MIN(q->attempt_schedule_depth, priority_queue_size(q->temp_files_to_replicate));
+	struct list *skipped = list_create();
+
+	struct vine_file *f;
+	while ((f = priority_queue_pop(q->temp_files_to_replicate)) && (iter_count++ < iter_depth)) {
+		if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+			continue;
+		}
+
+		/* skip if the file has enough replicas or no replicas */
+		int current_replica_count = vine_file_replica_count(q, f);
+		if (current_replica_count >= q->temp_replica_count || current_replica_count == 0) {
+			continue;
+		}
+		/* skip if the file has no ready replicas */
+		int current_ready_replica_count = vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY);
+		if (current_ready_replica_count == 0) {
+			continue;
+		}
+
+		/* if reach here, it means the file needs to be replicated and there is at least one ready replica. */
+		if (!vine_temp_replicate_file_now(q, f)) {
+			list_push_tail(skipped, f);
+			continue;
+		}
+
+		processed++;
+
+		/* push back and keep evaluating the same file with a lower priority, until no more source
+		 * or destination workers are available, or the file has enough replicas. */
+		vine_temp_replicate_file_later(q, f);
+	}
+
+	while ((f = list_pop_head(skipped))) {
+		vine_temp_replicate_file_later(q, f);
+	}
+	list_delete(skipped);
+
+	return processed;
+}
+
+/**
+Clean redundant replicas of a temporary file.
+For example, a file may be transferred to another worker because a task that declares it
+as input is scheduled there, resulting in an extra replica that consumes storage space.
+This function evaluates whether the file has excessive replicas and removes those on
+workers that do not execute their dependent tasks. 
+*/
+void vine_temp_clean_redundant_replicas(struct vine_manager *q, struct vine_file *f)
+{
+	if (!f || f->type != VINE_TEMP) {
+		return;
+	}
+
+	struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!source_workers) {
+		/* no surprise - a cache-update message may trigger a file deletion. */
+		return;
+	}
+	int excess_replicas = set_size(source_workers) - q->temp_replica_count;
+	if (excess_replicas <= 0) {
+		return;
+	}
+	/* Note that this replica may serve as a source for a peer transfer. If it is unlinked prematurely,
+	 * the corresponding transfer could fail and leave a task without its required data.
+	 * Therefore, we must wait until all replicas are confirmed ready before proceeding. */
+	if (vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY) != set_size(source_workers)) {
+		return;
+	}
+
+	struct priority_queue *clean_replicas_from_workers = priority_queue_create(0);
+
+	struct vine_worker_info *source_worker = NULL;
+	SET_ITERATE(source_workers, source_worker)
+	{
+		/* if the file is actively in use by a task (the input to that task), we don't remove the replica on this worker */
+		int file_inuse = 0;
+
+		uint64_t task_id;
+		struct vine_task *task;
+		ITABLE_ITERATE(source_worker->current_tasks, task_id, task)
+		{
+			struct vine_mount *input_mount;
+			LIST_ITERATE(task->input_mounts, input_mount)
+			{
+				if (f == input_mount->file) {
+					file_inuse = 1;
+					break;
+				}
+			}
+			if (file_inuse) {
+				break;
+			}
+		}
+
+		if (file_inuse) {
+			continue;
+		}
+
+		priority_queue_push(clean_replicas_from_workers, source_worker, source_worker->inuse_cache);
+	}
+
+	source_worker = NULL;
+	while (excess_replicas > 0 && (source_worker = priority_queue_pop(clean_replicas_from_workers))) {
+		delete_worker_file(q, source_worker, f->cached_name, 0, 0);
+		excess_replicas--;
+	}
+	priority_queue_delete(clean_replicas_from_workers);
+
+	return;
+}
+
+/**
+Shift a temp file replica away from the worker using the most cache space.
+This function looks for an alternative worker that can accept the file immediately
+so that the original replica can be cleaned up later by @vine_temp_clean_redundant_replicas().
+*/
+void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f)
+{
+	if (!q || !source_worker || !f || f->type != VINE_TEMP) {
+		return;
+	}
+
+	struct vine_worker_info *target_worker = NULL;
+
+	char *key;
+	struct vine_worker_info *w = NULL;
+	HASH_TABLE_ITERATE(q->worker_table, key, w)
+	{
+		if (w->type != VINE_WORKER_TYPE_WORKER) {
+			continue;
+		}
+		if (!w->transfer_port_active) {
+			continue;
+		}
+		if (w->draining) {
+			continue;
+		}
+		if (w->resources->tag < 0) {
+			continue;
+		}
+		if (vine_file_replica_table_lookup(w, f->cached_name)) {
+			continue;
+		}
+		if (w->inuse_cache + f->size > (source_worker->inuse_cache - f->size) * 0.8) {
+			continue;
+		}
+		if (!target_worker || w->inuse_cache < target_worker->inuse_cache) {
+			target_worker = w;
+		}
+	}
+	if (target_worker) {
+		char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
+		vine_manager_put_url_now(q, target_worker, source_worker, source_addr, f);
+		free(source_addr);
+	}
+
+	/* We can clean up the original one safely when the replica arrives at the destination worker. */
+	vine_temp_clean_redundant_replicas(q, f);
+}
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
new file mode 100644
index 0000000000..d6f2d72523
--- /dev/null
+++ b/taskvine/src/manager/vine_temp.h
@@ -0,0 +1,13 @@
+#ifndef vine_temp_H
+#define vine_temp_H
+
+#include "vine_manager.h"
+
+int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
+int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename);
+int vine_temp_start_replication(struct vine_manager *q);
+void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker);
+
+void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f);
+
+#endif
\ No newline at end of file

From cdd96a8dd6f0c3786a9ca2aa5276f6de1faee38c Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 17:31:01 -0500
Subject: [PATCH 080/113] vine: vine_temp.c

---
 taskvine/src/manager/vine_manager.c | 114 +++++-----------------------
 taskvine/src/manager/vine_manager.h |   5 +-
 taskvine/src/manager/vine_temp.c    |  90 +++++++++++++---------
 taskvine/src/manager/vine_temp.h    |   4 +-
 4 files changed, 79 insertions(+), 134 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 5593e7aeda..dec3d533c6 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -166,7 +166,6 @@ static int vine_manager_check_inputs_available(struct vine_manager *q, struct vi
 static void vine_manager_consider_recovery_task(struct vine_manager *q, struct vine_file *lost_file, struct vine_task *rt);
 
 static void delete_uncacheable_files(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
-static int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level);
 static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
@@ -419,12 +418,15 @@ static vine_msg_code_t handle_cache_update(struct vine_manager *q, struct vine_w
 			f->state = VINE_FILE_STATE_CREATED;
 			f->size = size;
 
-			/* And if the file is a newly created temporary, replicate as needed. */
-			if (f->type == VINE_TEMP && *id == 'X' && q->temp_replica_count > 1) {
-				hash_table_insert(q->temp_files_to_replicate, f->cached_name, NULL);
+			/* If the replica's type was a URL, it means the manager expected the destination worker to download it
+			 * from elsewhere. Now that it's physically present, we can resolve its type back to the original */
+			if (replica->type == VINE_URL) {
+				replica->type = f->type;
 			}
 
-			if (q->shift_disk_load) {
+			/* If a TEMP file, replicate or shift disk load as needed. */
+			if (f->type == VINE_TEMP) {
+				vine_temp_replicate_file_later(q, f);
 				vine_temp_shift_disk_load(q, w, f);
 			}
 		}
@@ -481,6 +483,9 @@ static vine_msg_code_t handle_cache_invalid(struct vine_manager *q, struct vine_
 			w->last_failure_time = timestamp_get();
 		}
 
+		/* If the creation failed, we may want to backup the file somewhere else. */
+		vine_temp_rescue_lost_replica(q, cachename);
+
 		/* Successfully processed this message. */
 		return VINE_MSG_PROCESSED;
 	} else {
@@ -1054,85 +1059,6 @@ static void cleanup_worker(struct vine_manager *q, struct vine_worker_info *w)
 	cleanup_worker_files(q, w);
 }
 
-/* Start replicating files that may need replication */
-static int consider_tempfile_replications(struct vine_manager *q)
-{
-	if (hash_table_size(q->temp_files_to_replicate) <= 0) {
-		return 0;
-	}
-
-	char *cached_name = NULL;
-	void *empty_val = NULL;
-	int total_replication_request_sent = 0;
-
-	static char key_start[PATH_MAX] = "random init";
-	int iter_control;
-	int iter_count_var;
-
-	struct list *to_remove = list_create();
-
-	HASH_TABLE_ITERATE_FROM_KEY(q->temp_files_to_replicate, iter_control, iter_count_var, key_start, cached_name, empty_val)
-	{
-		struct vine_file *f = hash_table_lookup(q->file_table, cached_name);
-
-		if (!f) {
-			continue;
-		}
-
-		/* are there any available source workers? */
-		struct set *source_workers = hash_table_lookup(q->file_worker_table, f->cached_name);
-		if (!source_workers) {
-			/* If no source workers found, it indicates that the file doesn't exist, either pruned or lost.
-			Because a pruned file is removed from the recovery queue, so it definitely indicates that the file is lost. */
-			if (q->transfer_temps_recovery && file_needs_recovery(q, f)) {
-				vine_manager_consider_recovery_task(q, f, f->recovery_task);
-			}
-			list_push_tail(to_remove, xxstrdup(f->cached_name));
-			continue;
-		}
-
-		/* at least one source is able to transfer? */
-		int has_valid_source = 0;
-		struct vine_worker_info *s;
-		SET_ITERATE(source_workers, s)
-		{
-			if (s->transfer_port_active && s->outgoing_xfer_counter < q->worker_source_max_transfers && !s->draining) {
-				has_valid_source = 1;
-				break;
-			}
-		}
-		if (!has_valid_source) {
-			continue;
-		}
-
-		/* has this file been fully replicated? */
-		int nsource_workers = set_size(source_workers);
-		int to_find = MIN(q->temp_replica_count - nsource_workers, q->transfer_replica_per_cycle);
-		if (to_find <= 0) {
-			list_push_tail(to_remove, xxstrdup(f->cached_name));
-			continue;
-		}
-
-		// debug(D_VINE, "Found %d workers holding %s, %d replicas needed", nsource_workers, f->cached_name, to_find);
-
-		int round_replication_request_sent = vine_file_replica_table_replicate(q, f, source_workers, to_find);
-		total_replication_request_sent += round_replication_request_sent;
-
-		if (total_replication_request_sent >= q->attempt_schedule_depth) {
-			break;
-		}
-	}
-
-	while ((cached_name = list_pop_head(to_remove))) {
-		hash_table_remove(q->temp_files_to_replicate, cached_name);
-		free(cached_name);
-	}
-
-	list_delete(to_remove);
-
-	return total_replication_request_sent;
-}
-
 /* Insert into hashtable temp files that may need replication. */
 
 static void recall_worker_lost_temp_files(struct vine_manager *q, struct vine_worker_info *w)
@@ -1145,11 +1071,7 @@ static void recall_worker_lost_temp_files(struct vine_manager *q, struct vine_wo
 	// Iterate over files we want might want to recover
 	HASH_TABLE_ITERATE(w->current_files, cached_name, info)
 	{
-		struct vine_file *f = hash_table_lookup(q->file_table, cached_name);
-
-		if (f && f->type == VINE_TEMP) {
-			hash_table_insert(q->temp_files_to_replicate, cached_name, NULL);
-		}
+		vine_temp_rescue_lost_replica(q, cached_name);
 	}
 }
 
@@ -1261,7 +1183,7 @@ static void add_worker(struct vine_manager *q)
 
 /* Delete a single file on a remote worker except those with greater delete_upto_level cache level */
 
-static int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level)
+int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level)
 {
 	if (cache_level <= delete_upto_level) {
 		process_replica_on_event(q, w, filename, VINE_FILE_REPLICA_STATE_TRANSITION_EVENT_UNLINK);
@@ -4153,7 +4075,7 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 
 	q->worker_table = hash_table_create(0, 0);
 	q->file_worker_table = hash_table_create(0, 0);
-	q->temp_files_to_replicate = hash_table_create(0, 0);
+	q->temp_files_to_replicate = priority_queue_create(0);
 	q->worker_blocklist = hash_table_create(0, 0);
 
 	q->file_table = hash_table_create(0, 0);
@@ -4237,6 +4159,8 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->perf_log_interval = VINE_PERF_LOG_INTERVAL;
 
 	q->temp_replica_count = 1;
+	q->clean_redundant_replicas = 0;
+	q->shift_disk_load = 0;
 	q->transfer_temps_recovery = 0;
 	q->transfer_replica_per_cycle = 10;
 
@@ -4505,8 +4429,7 @@ void vine_delete(struct vine_manager *q)
 	hash_table_clear(q->file_worker_table, (void *)set_delete);
 	hash_table_delete(q->file_worker_table);
 
-	hash_table_clear(q->temp_files_to_replicate, 0);
-	hash_table_delete(q->temp_files_to_replicate);
+	priority_queue_delete(q->temp_files_to_replicate);
 
 	hash_table_clear(q->factory_table, (void *)vine_factory_info_delete);
 	hash_table_delete(q->factory_table);
@@ -5466,7 +5389,7 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 
 		// Check if any temp files need replication and start replicating
 		BEGIN_ACCUM_TIME(q, time_internal);
-		result = consider_tempfile_replications(q);
+		result = vine_temp_start_replication(q);
 		END_ACCUM_TIME(q, time_internal);
 		if (result) {
 			// recovered at least one temp file
@@ -6483,9 +6406,6 @@ void vine_prune_file(struct vine_manager *m, struct vine_file *f)
 			set_free_values_array(workers_array);
 		}
 	}
-
-	/* also remove from the replication table. */
-	hash_table_remove(m->temp_files_to_replicate, f->cached_name);
 }
 
 /*
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index 24989ce0e3..5b96dacb98 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -123,7 +123,7 @@ struct vine_manager {
 
 	struct hash_table *file_table;      /* Maps fileid -> struct vine_file.* */
 	struct hash_table *file_worker_table; /* Maps cachename -> struct set of workers with a replica of the file.* */
-	struct hash_table *temp_files_to_replicate; /* Maps cachename -> NULL. Used as a set of temp files to be replicated */
+	struct priority_queue *temp_files_to_replicate; /* Priority queue of temp files to be replicated, those with less replicas are at the top. */
 
 
 	/* Primary scheduling controls. */
@@ -293,6 +293,9 @@ void vine_manager_remove_worker(struct vine_manager *q, struct vine_worker_info
 /* Check if the worker is able to transfer the necessary files for this task. */
 int vine_manager_transfer_capacity_available(struct vine_manager *q, struct vine_worker_info *w, struct vine_task *t);
 
+/* Delete a file from a worker. */
+int delete_worker_file(struct vine_manager *q, struct vine_worker_info *w, const char *filename, vine_cache_level_t cache_level, vine_cache_level_t delete_upto_level);
+
 /* The expected format of files created by the resource monitor.*/
 #define RESOURCE_MONITOR_TASK_LOCAL_NAME "vine-task-%d"
 #define RESOURCE_MONITOR_REMOTE_NAME "cctools-monitor"
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index 7b574653ae..b7f1ef1c90 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -1,20 +1,45 @@
 #include "vine_temp.h"
-#include "priority_queue.h"
 #include "vine_file.h"
 #include "vine_worker_info.h"
 #include "vine_file_replica_table.h"
+#include "vine_manager.h"
+#include "vine_manager_put.h"
+#include "vine_file_replica.h"
+#include "vine_file_replica_table.h"
+#include "vine_task.h"
+#include "vine_mount.h"
+
+#include "priority_queue.h"
 #include "macros.h"
 #include "stringtools.h"
-#include "vine_manager.h"
 #include "debug.h"
 #include "random.h"
-#include "vine_manager_put.h"
 #include "xxmalloc.h"
 
 /*************************************************************/
 /* Private Functions */
 /*************************************************************/
 
+static int is_worker_active(struct vine_worker_info *w)
+{
+	if (!w) {
+		return 0;
+	}
+	if (w->type != VINE_WORKER_TYPE_WORKER) {
+		return 0;
+	}
+	if (!w->transfer_port_active) {
+		return 0;
+	}
+	if (w->draining) {
+		return 0;
+	}
+	if (w->resources->tag < 0) {
+		return 0;
+	}
+	return 1;
+}
+
 static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP) {
@@ -31,7 +56,7 @@ static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, s
 	SET_ITERATE(sources, w)
 	{
 		/* skip if transfer port is not active or in draining mode */
-		if (!w->transfer_port_active || w->draining) {
+		if (!is_worker_active(w)) {
 			continue;
 		}
 		/* skip if incoming transfer counter is too high */
@@ -70,7 +95,7 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 	HASH_TABLE_ITERATE(q->worker_table, key, w)
 	{
 		/* skip if transfer port is not active or in draining mode */
-		if (!w->transfer_port_active || w->draining) {
+		if (!is_worker_active(w)) {
 			continue;
 		}
 		/* skip if the incoming transfer counter is too high */
@@ -83,7 +108,7 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 			continue;
 		}
 		/* skip if the worker does not have enough disk space */
-		int64_t available_disk_space = get_worker_available_disk_bytes(w);
+		int64_t available_disk_space = (int64_t)MEGABYTES_TO_BYTES(w->resources->disk.total) - w->inuse_cache;
 		if ((int64_t)f->size > available_disk_space) {
 			continue;
 		}
@@ -97,6 +122,17 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 	return best_destination;
 }
 
+static void start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *dest_worker, struct vine_worker_info *source_worker)
+{
+	if (!q || !f || f->type != VINE_TEMP || !dest_worker || !source_worker) {
+		return;
+	}
+
+	char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
+	vine_manager_put_url_now(q, dest_worker, source_worker, source_addr, f);
+	free(source_addr);
+}
+
 static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP) {
@@ -113,7 +149,7 @@ static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file
 		return 0;
 	}
 
-	vine_temp_start_peer_transfer(q, f, source_worker, dest_worker);
+	start_peer_transfer(q, f, dest_worker, source_worker);
 
 	return 1;
 }
@@ -122,23 +158,16 @@ static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file
 /* Public Functions */
 /*************************************************************/
 
-void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker)
-{
-	if (!q || !f || f->type != VINE_TEMP || !source_worker || !dest_worker) {
-		return;
-	}
-
-	char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
-	vine_manager_put_url_now(q, dest_worker, source_worker, source_addr, f);
-	free(source_addr);
-}
-
 int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
 		return 0;
 	}
 
+	if (q->temp_replica_count <= 1) {
+		return 0;
+	}
+
 	int current_replica_count = vine_file_replica_count(q, f);
 	if (current_replica_count == 0 || current_replica_count >= q->temp_replica_count) {
 		return 0;
@@ -149,7 +178,7 @@ int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
 	return 1;
 }
 
-int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
+int vine_temp_rescue_lost_replica(struct vine_manager *q, char *cachename)
 {
 	if (!q || !cachename) {
 		return 0;
@@ -219,7 +248,7 @@ Clean redundant replicas of a temporary file.
 For example, a file may be transferred to another worker because a task that declares it
 as input is scheduled there, resulting in an extra replica that consumes storage space.
 This function evaluates whether the file has excessive replicas and removes those on
-workers that do not execute their dependent tasks. 
+workers that do not execute their dependent tasks.
 */
 void vine_temp_clean_redundant_replicas(struct vine_manager *q, struct vine_file *f)
 {
@@ -296,28 +325,23 @@ void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *
 		return;
 	}
 
+	if (!q->shift_disk_load) {
+		return;
+	}
+
 	struct vine_worker_info *target_worker = NULL;
 
 	char *key;
 	struct vine_worker_info *w = NULL;
 	HASH_TABLE_ITERATE(q->worker_table, key, w)
 	{
-		if (w->type != VINE_WORKER_TYPE_WORKER) {
-			continue;
-		}
-		if (!w->transfer_port_active) {
-			continue;
-		}
-		if (w->draining) {
-			continue;
-		}
-		if (w->resources->tag < 0) {
+		if (!is_worker_active(w)) {
 			continue;
 		}
 		if (vine_file_replica_table_lookup(w, f->cached_name)) {
 			continue;
 		}
-		if (w->inuse_cache + f->size > (source_worker->inuse_cache - f->size) * 0.8) {
+		if (w->inuse_cache + f->size > (source_worker->inuse_cache - f->size)) {
 			continue;
 		}
 		if (!target_worker || w->inuse_cache < target_worker->inuse_cache) {
@@ -325,9 +349,7 @@ void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *
 		}
 	}
 	if (target_worker) {
-		char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
-		vine_manager_put_url_now(q, target_worker, source_worker, source_addr, f);
-		free(source_addr);
+		start_peer_transfer(q, f, target_worker, source_worker);
 	}
 
 	/* We can clean up the original one safely when the replica arrives at the destination worker. */
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
index d6f2d72523..1a1ce2a096 100644
--- a/taskvine/src/manager/vine_temp.h
+++ b/taskvine/src/manager/vine_temp.h
@@ -4,10 +4,10 @@
 #include "vine_manager.h"
 
 int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
-int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename);
+int vine_temp_rescue_lost_replica(struct vine_manager *q, char *cachename);
 int vine_temp_start_replication(struct vine_manager *q);
-void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker);
 
+void vine_temp_clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
 void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f);
 
 #endif
\ No newline at end of file

From d10c7ace5907b8c51fe73266da697f302b90a320 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 17:42:22 -0500
Subject: [PATCH 081/113] lint

---
 taskvine/src/manager/vine_manager.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 5481681251..199705c270 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -6409,6 +6409,8 @@ int vine_prune_file(struct vine_manager *m, struct vine_file *f)
 			set_free_values_array(workers_array);
 		}
 	}
+
+	return pruned_replica_count;
 }
 
 /*

From 57673e75fcafae8ba52f8acd826ce6d4cd252f21 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 4 Nov 2025 18:51:54 -0500
Subject: [PATCH 082/113] trigger rebuild


From 1d91659507e0d68c61ff2b8a83ada6577cb1b290 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 5 Nov 2025 00:07:39 -0500
Subject: [PATCH 083/113] comments

---
 taskvine/src/manager/vine_manager.c | 12 +++--
 taskvine/src/manager/vine_temp.c    | 79 +++++++++++++++++++++++------
 taskvine/src/manager/vine_temp.h    |  6 ++-
 3 files changed, 76 insertions(+), 21 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 199705c270..757eda856b 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -426,8 +426,12 @@ static vine_msg_code_t handle_cache_update(struct vine_manager *q, struct vine_w
 
 			/* If a TEMP file, replicate or shift disk load as needed. */
 			if (f->type == VINE_TEMP) {
-				vine_temp_replicate_file_later(q, f);
-				vine_temp_shift_disk_load(q, w, f);
+				if (q->temp_replica_count > 1) {
+					vine_temp_queue_for_replication(q, f);
+				}
+				if (q->shift_disk_load) {
+					vine_temp_shift_disk_load(q, w, f);
+				}
 			}
 		}
 	}
@@ -484,7 +488,7 @@ static vine_msg_code_t handle_cache_invalid(struct vine_manager *q, struct vine_
 		}
 
 		/* If the creation failed, we may want to backup the file somewhere else. */
-		vine_temp_rescue_lost_replica(q, cachename);
+		vine_temp_handle_lost_replica(q, cachename);
 
 		/* Successfully processed this message. */
 		return VINE_MSG_PROCESSED;
@@ -1071,7 +1075,7 @@ static void recall_worker_lost_temp_files(struct vine_manager *q, struct vine_wo
 	// Iterate over files we want might want to recover
 	HASH_TABLE_ITERATE(w->current_files, cached_name, info)
 	{
-		vine_temp_rescue_lost_replica(q, cached_name);
+		vine_temp_handle_lost_replica(q, cached_name);
 	}
 }
 
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index b7f1ef1c90..f7dac15109 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -20,6 +20,9 @@
 /* Private Functions */
 /*************************************************************/
 
+/**
+Check whether a worker is eligible to participate in peer transfers.
+*/
 static int is_worker_active(struct vine_worker_info *w)
 {
 	if (!w) {
@@ -40,6 +43,12 @@ static int is_worker_active(struct vine_worker_info *w)
 	return 1;
 }
 
+/**
+Find the most suitable worker to serve as the source of a replica transfer.
+Eligible workers already host the file, have a ready replica, and are not
+overloaded with outgoing transfers. Preference is given to workers with fewer
+outgoing transfers to balance load.
+*/
 static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP) {
@@ -82,6 +91,12 @@ static struct vine_worker_info *get_best_source_worker(struct vine_manager *q, s
 	return best_source;
 }
 
+/**
+Select a destination worker that can accept a new replica. Workers must be
+active, not currently hosting the file, and have sufficient free cache space.
+Those with more available disk space are prioritized to reduce pressure on
+heavily utilized workers.
+*/
 static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP) {
@@ -122,6 +137,11 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 	return best_destination;
 }
 
+/**
+Initiate a peer-to-peer transfer between two workers for the specified file.
+The source worker provides a direct URL so the destination worker can pull the
+replica immediately via `vine_manager_put_url_now`.
+*/
 static void start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *dest_worker, struct vine_worker_info *source_worker)
 {
 	if (!q || !f || f->type != VINE_TEMP || !dest_worker || !source_worker) {
@@ -133,6 +153,11 @@ static void start_peer_transfer(struct vine_manager *q, struct vine_file *f, str
 	free(source_addr);
 }
 
+/**
+Attempt to replicate a temporary file immediately by selecting compatible
+source and destination workers. Returns 1 when a transfer is launched, or 0 if
+no suitable pair of workers is currently available.
+*/
 static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP) {
@@ -158,7 +183,12 @@ static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file
 /* Public Functions */
 /*************************************************************/
 
-int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
+/**
+Queue a temporary file for replication when it still lacks the target number of
+replicas. Files without any replica and those already satisfying the quota are
+ignored. A lower priority value gives preference to scarcer replicas.
+*/
+int vine_temp_queue_for_replication(struct vine_manager *q, struct vine_file *f)
 {
 	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
 		return 0;
@@ -178,7 +208,15 @@ int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
 	return 1;
 }
 
-int vine_temp_rescue_lost_replica(struct vine_manager *q, char *cachename)
+/**
+Respond to a missing replica notification by re-queuing the corresponding file
+for replication, provided the file is still valid and managed by this
+coordinator. The use cases include when a cache-invalid message is received from a worker,
+or when a worker disconnects unexpectedly, and we need to rescue the lost data.
+If the replica does not have any ready source, it will be silently discarded in the
+replication phase, so don't worry about it.
+*/
+int vine_temp_handle_lost_replica(struct vine_manager *q, char *cachename)
 {
 	if (!q || !cachename) {
 		return 0;
@@ -189,11 +227,19 @@ int vine_temp_rescue_lost_replica(struct vine_manager *q, char *cachename)
 		return 0;
 	}
 
-	vine_temp_replicate_file_later(q, f);
+	vine_temp_queue_for_replication(q, f);
 
 	return 1;
 }
 
+/**
+Iterate through temporary files that still need additional replicas and
+trigger peer-to-peer transfers when both a source and destination worker
+are available. The function honors the manager's scheduling depth so that we
+do not spend too much time evaluating the queue in a single invocation.
+Files that cannot be replicated immediately are deferred by lowering their
+priority and will be reconsidered in future calls.
+*/
 int vine_temp_start_replication(struct vine_manager *q)
 {
 	if (!q) {
@@ -202,27 +248,31 @@ int vine_temp_start_replication(struct vine_manager *q)
 
 	int processed = 0;
 	int iter_count = 0;
+	/* Only examine up to attempt_schedule_depth files to keep the event loop responsive. */
 	int iter_depth = MIN(q->attempt_schedule_depth, priority_queue_size(q->temp_files_to_replicate));
+	/* Files that cannot be replicated now are temporarily stored and re-queued at the end. */
 	struct list *skipped = list_create();
 
 	struct vine_file *f;
 	while ((f = priority_queue_pop(q->temp_files_to_replicate)) && (iter_count++ < iter_depth)) {
+		/* skip and discard the replication request if the file is not valid */
 		if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
 			continue;
 		}
 
-		/* skip if the file has enough replicas or no replicas */
+		/* skip and discard the replication request if the file has enough replicas or no replicas */
 		int current_replica_count = vine_file_replica_count(q, f);
 		if (current_replica_count >= q->temp_replica_count || current_replica_count == 0) {
 			continue;
 		}
-		/* skip if the file has no ready replicas */
+		/* skip and discard the replication request if the file has no ready replicas */
 		int current_ready_replica_count = vine_file_replica_table_count_replicas(q, f->cached_name, VINE_FILE_REPLICA_STATE_READY);
 		if (current_ready_replica_count == 0) {
 			continue;
 		}
 
-		/* if reach here, it means the file needs to be replicated and there is at least one ready replica. */
+		/* If reaches here, the file still lacks replicas and has at least one ready source, so we start finding a valid source and destination worker
+		 * and trigger the replication. If fails to find a valid source or destination worker, we requeue the file and will consider later. */
 		if (!vine_temp_replicate_file_now(q, f)) {
 			list_push_tail(skipped, f);
 			continue;
@@ -230,13 +280,12 @@ int vine_temp_start_replication(struct vine_manager *q)
 
 		processed++;
 
-		/* push back and keep evaluating the same file with a lower priority, until no more source
-		 * or destination workers are available, or the file has enough replicas. */
-		vine_temp_replicate_file_later(q, f);
+		/* Requeue the file with lower priority so it can accumulate replicas gradually. */
+		vine_temp_queue_for_replication(q, f);
 	}
 
 	while ((f = list_pop_head(skipped))) {
-		vine_temp_replicate_file_later(q, f);
+		vine_temp_queue_for_replication(q, f);
 	}
 	list_delete(skipped);
 
@@ -325,25 +374,25 @@ void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *
 		return;
 	}
 
-	if (!q->shift_disk_load) {
-		return;
-	}
-
 	struct vine_worker_info *target_worker = NULL;
 
 	char *key;
 	struct vine_worker_info *w = NULL;
 	HASH_TABLE_ITERATE(q->worker_table, key, w)
 	{
+		/* skip if the worker is not active */
 		if (!is_worker_active(w)) {
 			continue;
 		}
+		/* skip if the worker already has this file */
 		if (vine_file_replica_table_lookup(w, f->cached_name)) {
 			continue;
 		}
-		if (w->inuse_cache + f->size > (source_worker->inuse_cache - f->size)) {
+		/* skip if the worker becomes heavier after the transfer */
+		if (w->inuse_cache + f->size > source_worker->inuse_cache - f->size) {
 			continue;
 		}
+		/* workers with less inuse cache space are preferred */
 		if (!target_worker || w->inuse_cache < target_worker->inuse_cache) {
 			target_worker = w;
 		}
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
index 1a1ce2a096..0943b9b9cc 100644
--- a/taskvine/src/manager/vine_temp.h
+++ b/taskvine/src/manager/vine_temp.h
@@ -3,10 +3,12 @@
 
 #include "vine_manager.h"
 
-int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
-int vine_temp_rescue_lost_replica(struct vine_manager *q, char *cachename);
+/** Replication related functions */
+int vine_temp_queue_for_replication(struct vine_manager *q, struct vine_file *f);
 int vine_temp_start_replication(struct vine_manager *q);
+int vine_temp_handle_lost_replica(struct vine_manager *q, char *cachename);
 
+/** Storage management functions */
 void vine_temp_clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
 void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f);
 

From ed1fc2368cbf0c341cd90570541fbebfa11212c1 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 5 Nov 2025 00:12:13 -0500
Subject: [PATCH 084/113] remove unrelated code

---
 taskvine/src/manager/vine_manager.c | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 757eda856b..d04096cc8f 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -418,12 +418,6 @@ static vine_msg_code_t handle_cache_update(struct vine_manager *q, struct vine_w
 			f->state = VINE_FILE_STATE_CREATED;
 			f->size = size;
 
-			/* If the replica's type was a URL, it means the manager expected the destination worker to download it
-			 * from elsewhere. Now that it's physically present, we can resolve its type back to the original */
-			if (replica->type == VINE_URL) {
-				replica->type = f->type;
-			}
-
 			/* If a TEMP file, replicate or shift disk load as needed. */
 			if (f->type == VINE_TEMP) {
 				if (q->temp_replica_count > 1) {

From 8280ef61982e3d4dc0d595201441deb66f91a01e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 5 Nov 2025 11:55:32 -0500
Subject: [PATCH 085/113] fix flicker

---
 dttools/src/progress_bar.c      | 48 ++++++++++++++++++++++++---------
 dttools/src/progress_bar.h      | 20 ++++++++++----
 dttools/src/progress_bar_test.c |  4 ++-
 3 files changed, 53 insertions(+), 19 deletions(-)

diff --git a/dttools/src/progress_bar.c b/dttools/src/progress_bar.c
index 14e1995b42..614d4f7439 100644
--- a/dttools/src/progress_bar.c
+++ b/dttools/src/progress_bar.c
@@ -11,6 +11,8 @@ Implementation of a terminal progress bar with multiple parts.
 #include "progress_bar.h"
 #include "xxmalloc.h"
 #include "macros.h"
+#include "macros.h"
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -23,8 +25,9 @@ Implementation of a terminal progress bar with multiple parts.
 
 /* Max bar width (in block characters) for single-line rendering. */
 #define MAX_BAR_WIDTH 30
-/* Minimum redraw interval to avoid flicker. */
-#define PROGRESS_BAR_UPDATE_INTERVAL ((USECOND) * 0.1)
+
+/* Minimum redraw interval to avoid flicker (200ms). */
+#define PROGRESS_BAR_UPDATE_INTERVAL_US (USECOND / 5)
 
 #define COLOR_RESET "\033[0m"
 #define COLOR_GREEN "\033[32m"
@@ -75,7 +78,7 @@ static void print_progress_bar(struct ProgressBar *bar)
 		return;
 	}
 
-	bar->last_draw_time = timestamp_get();
+	bar->last_draw_time_us = timestamp_get();
 
 	char part_text[256];
 	char *ptr = part_text;
@@ -114,7 +117,7 @@ static void print_progress_bar(struct ProgressBar *bar)
 		progress = 1.0f;
 	}
 
-	timestamp_t elapsed = timestamp_get() - bar->start_time;
+	timestamp_t elapsed = timestamp_get() - bar->start_time_us;
 	int h = elapsed / (3600LL * USECOND);
 	int m = (elapsed % (3600LL * USECOND)) / (60LL * USECOND);
 	int s = (elapsed % (60LL * USECOND)) / USECOND;
@@ -167,13 +170,34 @@ struct ProgressBar *progress_bar_init(const char *label)
 
 	bar->label = xxstrdup(label);
 	bar->parts = list_create();
-	bar->start_time = timestamp_get();
-	bar->last_draw_time = timestamp_get();
+	bar->start_time_us = timestamp_get();
+	bar->last_draw_time_us = 0;
+	bar->update_interval_us = PROGRESS_BAR_UPDATE_INTERVAL_US;
+	bar->update_interval_sec = (double)bar->update_interval_us / USECOND;
 	bar->has_drawn_once = 0;
 
 	return bar;
 }
 
+/** Set the update interval for the progress bar. */
+void progress_bar_set_update_interval(struct ProgressBar *bar, double update_interval_sec)
+{
+	if (!bar) {
+		return;
+	}
+
+	if (update_interval_sec < 0) {
+		update_interval_sec = 0;
+	}
+	bar->update_interval_sec = update_interval_sec;
+	/* Convert seconds to microseconds with saturation to avoid overflow. */
+	if (update_interval_sec >= (double)UINT64_MAX / (double)USECOND) {
+		bar->update_interval_us = (timestamp_t)UINT64_MAX;
+	} else {
+		bar->update_interval_us = (timestamp_t)(update_interval_sec * (double)USECOND);
+	}
+}
+
 /** Create a new part. */
 struct ProgressBarPart *progress_bar_create_part(const char *label, uint64_t total)
 {
@@ -207,9 +231,8 @@ void progress_bar_set_part_total(struct ProgressBar *bar, struct ProgressBarPart
 	if (!bar || !part) {
 		return;
 	}
-	part->total = new_total;
 
-	print_progress_bar(bar);
+	part->total = new_total;
 }
 
 /** Advance a part's current value, redraw if needed. */
@@ -224,11 +247,10 @@ void progress_bar_update_part(struct ProgressBar *bar, struct ProgressBarPart *p
 		part->current = part->total;
 	}
 
-	if (timestamp_get() - bar->last_draw_time < PROGRESS_BAR_UPDATE_INTERVAL) {
-		return;
+	timestamp_t now_us = timestamp_get();
+	if (!bar->has_drawn_once || (now_us - bar->last_draw_time_us) >= bar->update_interval_us) {
+		print_progress_bar(bar);
 	}
-
-	print_progress_bar(bar);
 }
 
 /** Set the start time for the progress bar. */
@@ -238,7 +260,7 @@ void progress_bar_set_start_time(struct ProgressBar *bar, timestamp_t start_time
 		return;
 	}
 
-	bar->start_time = start_time;
+	bar->start_time_us = start_time;
 }
 
 /** Final render and newline. */
diff --git a/dttools/src/progress_bar.h b/dttools/src/progress_bar.h
index 6a38a95424..7fe3171a3f 100644
--- a/dttools/src/progress_bar.h
+++ b/dttools/src/progress_bar.h
@@ -25,11 +25,15 @@ struct ProgressBarPart {
 
 /** Progress bar object. */
 struct ProgressBar {
-	char *label;
-	struct list *parts;
-	timestamp_t start_time;
-    timestamp_t last_draw_time;
-	int has_drawn_once;
+    /* User-facing interval in seconds; internal comparisons use *_us. */
+    double update_interval_sec;
+    char *label;
+    struct list *parts;
+    /* Timestamps in microseconds. */
+    timestamp_t start_time_us;
+    timestamp_t last_draw_time_us;
+    timestamp_t update_interval_us;
+    int has_drawn_once;
 };
 
 /* Progress Bar Part API */
@@ -40,6 +44,12 @@ struct ProgressBar {
 */
 struct ProgressBar *progress_bar_init(const char *label);
 
+/** Set the update interval for the progress bar.
+@param bar Progress bar.
+@param update_interval_sec Update interval in seconds.
+*/
+void progress_bar_set_update_interval(struct ProgressBar *bar, double update_interval_sec);
+
 /** Create a new part.
 @param label Part label (internally duplicated).
 @param total Total units for the part.
diff --git a/dttools/src/progress_bar_test.c b/dttools/src/progress_bar_test.c
index 4c72d09425..0d3d3fa813 100644
--- a/dttools/src/progress_bar_test.c
+++ b/dttools/src/progress_bar_test.c
@@ -6,12 +6,14 @@
 
 int main()
 {
-	uint64_t total = 100000;
+	uint64_t total = 100000000;
 	struct ProgressBarPart *part1 = progress_bar_create_part("step", total);
 	struct ProgressBarPart *part2 = progress_bar_create_part("fetch", total);
 	struct ProgressBarPart *part3 = progress_bar_create_part("commit", total);
 
 	struct ProgressBar *bar = progress_bar_init("Compute");
+	progress_bar_set_update_interval(bar, 1);
+
 	progress_bar_bind_part(bar, part1);
 	progress_bar_bind_part(bar, part2);
 	progress_bar_bind_part(bar, part3);

From 176201f57ff0dd90e02ecc8ce6b9829f0cb87fd1 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 6 Nov 2025 15:31:58 -0500
Subject: [PATCH 086/113] fix comment

---
 taskvine/src/manager/vine_manager.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 1886c7f34a..1da2d9c082 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -672,7 +672,7 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 
 	/* A task scheduling may result in a redundant replica of its input due to peer transfers, which can be safely removed when completed.
 	 * However, the general function of taskvine is to replicate files on demand, and to only clean them up when prune is called.
-	 * So, we only clean up redundant replicas for the task-inputs when the manager is configured to clean redundant replicas. */
+	 * So, we only clean up redundant replicas for the task-inputs when the manager is configured to do so. */
 	if (q->clean_redundant_replicas) {
 		struct vine_mount *input_mount;
 		LIST_ITERATE(t->input_mounts, input_mount)

From b6880b2b334cb427aefa1c527dcfd5c171440f5b Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 6 Nov 2025 16:31:25 -0500
Subject: [PATCH 087/113] trigger rebuild


From ba0b9853eb039bd289ef18eb6d9e442d5da21145 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 10 Nov 2025 11:09:26 -0500
Subject: [PATCH 088/113] review fix

---
 poncho/src/poncho/library_network_code.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index b696ee5e57..5fab4b0b85 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -179,9 +179,11 @@ def start_function(in_pipe_fd, thread_limit=1):
                     try:
                         # each child process independently redirects its own stdout/stderr.
                         with open(function_stdout_filename, "wb", buffering=0) as f:
-                            os.dup2(f.fileno(), 1)  # redirect stdout
-                            os.dup2(f.fileno(), 2)  # redirect stderr
+                            os.dup2(f.fileno(), sys.stdout.fileno())  # redirect stdout
+                            os.dup2(f.fileno(), sys.stderr.fileno())  # redirect stderr
 
+                            # keep the function invocation inside the context
+                            # so the stdout/stderr file stays open during execution and closes safely afterward.
                             stdout_timed_message(f"TASK {function_id} {function_name} starts in PID {os.getpid()}")
                             result = globals()[function_name](event)
                             stdout_timed_message(f"TASK {function_id} {function_name} finished")

From c89bd8576a9aeff952893201cce4a3f47a0f49ff Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 3 Dec 2025 13:21:18 -0500
Subject: [PATCH 089/113] modify project name

---
 dttools/src/progress_bar.c                    | 20 ++---
 dttools/src/progress_bar_test.c               |  6 +-
 taskvine/src/graph/Makefile                   |  2 +-
 .../src/graph/{vinedag => dagvine}/.gitignore |  0
 .../src/graph/{vinedag => dagvine}/.gitkeep   |  0
 .../src/graph/{vinedag => dagvine}/Makefile   |  4 +-
 .../graph/{vinedag => dagvine}/__init__.py    |  4 +-
 .../context_graph/Makefile                    |  2 +-
 .../context_graph/__init__.py                 |  0
 .../context_graph/core.py                     |  4 +-
 .../context_graph/proxy_functions.py          |  2 +-
 .../context_graph/proxy_library.py            |  4 +-
 .../vinedag.py => dagvine/dagvine.py}         | 24 +++--
 .../vine_graph/.gitignore                     |  0
 .../{vinedag => dagvine}/vine_graph/Makefile  |  2 +-
 .../vine_graph/__init__.py                    |  0
 .../vine_graph/vine_graph.c                   |  0
 .../vine_graph/vine_graph.h                   |  0
 .../vine_graph/vine_graph.i                   |  2 +-
 .../vine_graph/vine_graph_client.py           |  0
 .../vine_graph/vine_node.c                    |  0
 .../vine_graph/vine_node.h                    |  0
 taskvine/src/manager/vine_manager.c           | 57 ++++++------
 taskvine/src/manager/vine_temp.c              | 88 +++++++++----------
 taskvine/src/manager/vine_temp.h              |  1 -
 25 files changed, 111 insertions(+), 111 deletions(-)
 rename taskvine/src/graph/{vinedag => dagvine}/.gitignore (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/.gitkeep (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/Makefile (85%)
 rename taskvine/src/graph/{vinedag => dagvine}/__init__.py (75%)
 rename taskvine/src/graph/{vinedag => dagvine}/context_graph/Makefile (96%)
 rename taskvine/src/graph/{vinedag => dagvine}/context_graph/__init__.py (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/context_graph/core.py (98%)
 rename taskvine/src/graph/{vinedag => dagvine}/context_graph/proxy_functions.py (98%)
 rename taskvine/src/graph/{vinedag => dagvine}/context_graph/proxy_library.py (96%)
 rename taskvine/src/graph/{vinedag/vinedag.py => dagvine/dagvine.py} (93%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/.gitignore (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/Makefile (99%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/__init__.py (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/vine_graph.c (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/vine_graph.h (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/vine_graph.i (82%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/vine_graph_client.py (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/vine_node.c (100%)
 rename taskvine/src/graph/{vinedag => dagvine}/vine_graph/vine_node.h (100%)

diff --git a/dttools/src/progress_bar.c b/dttools/src/progress_bar.c
index 012d80e003..614d4f7439 100644
--- a/dttools/src/progress_bar.c
+++ b/dttools/src/progress_bar.c
@@ -11,6 +11,8 @@ Implementation of a terminal progress bar with multiple parts.
 #include "progress_bar.h"
 #include "xxmalloc.h"
 #include "macros.h"
+#include "macros.h"
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -23,13 +25,9 @@ Implementation of a terminal progress bar with multiple parts.
 
 /* Max bar width (in block characters) for single-line rendering. */
 #define MAX_BAR_WIDTH 30
-/* Typed time constants (microseconds). */
-static const timestamp_t SECOND_US      = 1000000ULL;
-static const timestamp_t MILLISECOND_US = 1000ULL;
-static const timestamp_t MICROSECOND_US = 1ULL;
 
 /* Minimum redraw interval to avoid flicker (200ms). */
-#define PROGRESS_BAR_UPDATE_INTERVAL_US (SECOND_US / 5)
+#define PROGRESS_BAR_UPDATE_INTERVAL_US (USECOND / 5)
 
 #define COLOR_RESET "\033[0m"
 #define COLOR_GREEN "\033[32m"
@@ -120,9 +118,9 @@ static void print_progress_bar(struct ProgressBar *bar)
 	}
 
 	timestamp_t elapsed = timestamp_get() - bar->start_time_us;
-	int h = elapsed / (3600LL * SECOND_US);
-	int m = (elapsed % (3600LL * SECOND_US)) / (60LL * SECOND_US);
-	int s = (elapsed % (60LL * SECOND_US)) / SECOND_US;
+	int h = elapsed / (3600LL * USECOND);
+	int m = (elapsed % (3600LL * USECOND)) / (60LL * USECOND);
+	int s = (elapsed % (60LL * USECOND)) / USECOND;
 
 	if (bar->has_drawn_once) {
 		printf("\r\033[2K");
@@ -175,7 +173,7 @@ struct ProgressBar *progress_bar_init(const char *label)
 	bar->start_time_us = timestamp_get();
 	bar->last_draw_time_us = 0;
 	bar->update_interval_us = PROGRESS_BAR_UPDATE_INTERVAL_US;
-	bar->update_interval_sec = (double)bar->update_interval_us / SECOND_US;
+	bar->update_interval_sec = (double)bar->update_interval_us / USECOND;
 	bar->has_drawn_once = 0;
 
 	return bar;
@@ -193,10 +191,10 @@ void progress_bar_set_update_interval(struct ProgressBar *bar, double update_int
 	}
 	bar->update_interval_sec = update_interval_sec;
 	/* Convert seconds to microseconds with saturation to avoid overflow. */
-	if (update_interval_sec >= (double)UINT64_MAX / (double)SECOND_US) {
+	if (update_interval_sec >= (double)UINT64_MAX / (double)USECOND) {
 		bar->update_interval_us = (timestamp_t)UINT64_MAX;
 	} else {
-		bar->update_interval_us = (timestamp_t)(update_interval_sec * (double)SECOND_US);
+		bar->update_interval_us = (timestamp_t)(update_interval_sec * (double)USECOND);
 	}
 }
 
diff --git a/dttools/src/progress_bar_test.c b/dttools/src/progress_bar_test.c
index 4a7b70ed1c..1262a6071e 100644
--- a/dttools/src/progress_bar_test.c
+++ b/dttools/src/progress_bar_test.c
@@ -6,13 +6,13 @@
 
 int main()
 {
-	uint64_t total = 1000000;
+	uint64_t total = 100000000;
 	struct ProgressBarPart *part1 = progress_bar_create_part("step", total);
 	struct ProgressBarPart *part2 = progress_bar_create_part("fetch", total);
 	struct ProgressBarPart *part3 = progress_bar_create_part("commit", total);
 
 	struct ProgressBar *bar = progress_bar_init("Compute");
-	progress_bar_set_update_interval(bar, 0.5);
+	progress_bar_set_update_interval(bar, 1);
 
 	progress_bar_bind_part(bar, part1);
 	progress_bar_bind_part(bar, part2);
@@ -32,4 +32,4 @@ int main()
 	printf("time taken: %" PRIu64 "\n", end_time - start_time);
 
 	return 0;
-}
+}
\ No newline at end of file
diff --git a/taskvine/src/graph/Makefile b/taskvine/src/graph/Makefile
index f961ec9e86..c56a9f8090 100644
--- a/taskvine/src/graph/Makefile
+++ b/taskvine/src/graph/Makefile
@@ -1,7 +1,7 @@
 include ../../../config.mk
 include ../../../rules.mk
 
-SUBDIRS = vinedag
+SUBDIRS = dagvine
 
 all clean install test lint format: $(SUBDIRS)
 
diff --git a/taskvine/src/graph/vinedag/.gitignore b/taskvine/src/graph/dagvine/.gitignore
similarity index 100%
rename from taskvine/src/graph/vinedag/.gitignore
rename to taskvine/src/graph/dagvine/.gitignore
diff --git a/taskvine/src/graph/vinedag/.gitkeep b/taskvine/src/graph/dagvine/.gitkeep
similarity index 100%
rename from taskvine/src/graph/vinedag/.gitkeep
rename to taskvine/src/graph/dagvine/.gitkeep
diff --git a/taskvine/src/graph/vinedag/Makefile b/taskvine/src/graph/dagvine/Makefile
similarity index 85%
rename from taskvine/src/graph/vinedag/Makefile
rename to taskvine/src/graph/dagvine/Makefile
index 32dff04894..f40356744e 100644
--- a/taskvine/src/graph/vinedag/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -1,7 +1,7 @@
 include ../../../../config.mk
 include ../../../../rules.mk
 
-MODULE_DIR := $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/vinedag
+MODULE_DIR := $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
 SUBDIRS    := context_graph vine_graph
 
 .PHONY: all install clean lint format $(SUBDIRS)
@@ -13,7 +13,7 @@ $(SUBDIRS):
 
 install: all
 	mkdir -p $(MODULE_DIR)
-	cp vinedag.py $(MODULE_DIR)
+	cp dagvine.py $(MODULE_DIR)
 	cp __init__.py $(MODULE_DIR)
 	@for dir in $(SUBDIRS); do \
 		$(MAKE) -C $$dir install; \
diff --git a/taskvine/src/graph/vinedag/__init__.py b/taskvine/src/graph/dagvine/__init__.py
similarity index 75%
rename from taskvine/src/graph/vinedag/__init__.py
rename to taskvine/src/graph/dagvine/__init__.py
index 0a3da3f715..feee0c0384 100644
--- a/taskvine/src/graph/vinedag/__init__.py
+++ b/taskvine/src/graph/dagvine/__init__.py
@@ -2,6 +2,6 @@
 # This software is distributed under the GNU General Public License.
 # See the file COPYING for details.
 
-from .vinedag import VineDAG
+from .dagvine import DAGVine
 
-__all__ = ["VineDAG"]
+__all__ = ["DAGVine"]
diff --git a/taskvine/src/graph/vinedag/context_graph/Makefile b/taskvine/src/graph/dagvine/context_graph/Makefile
similarity index 96%
rename from taskvine/src/graph/vinedag/context_graph/Makefile
rename to taskvine/src/graph/dagvine/context_graph/Makefile
index bdee79013e..a356267995 100644
--- a/taskvine/src/graph/vinedag/context_graph/Makefile
+++ b/taskvine/src/graph/dagvine/context_graph/Makefile
@@ -1,7 +1,7 @@
 include ../../../../../config.mk
 include ../../../../../rules.mk
 
-PROJECT_NAME = vinedag
+PROJECT_NAME = dagvine
 
 SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)/context_graph
 MODULE_ROOT = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
diff --git a/taskvine/src/graph/vinedag/context_graph/__init__.py b/taskvine/src/graph/dagvine/context_graph/__init__.py
similarity index 100%
rename from taskvine/src/graph/vinedag/context_graph/__init__.py
rename to taskvine/src/graph/dagvine/context_graph/__init__.py
diff --git a/taskvine/src/graph/vinedag/context_graph/core.py b/taskvine/src/graph/dagvine/context_graph/core.py
similarity index 98%
rename from taskvine/src/graph/vinedag/context_graph/core.py
rename to taskvine/src/graph/dagvine/context_graph/core.py
index 61bbeb0d30..f01cd35596 100644
--- a/taskvine/src/graph/vinedag/context_graph/core.py
+++ b/taskvine/src/graph/dagvine/context_graph/core.py
@@ -61,7 +61,7 @@ class ContextGraph:
     def __init__(self, task_dict,
                  extra_task_output_size_mb=[0, 0],
                  extra_task_sleep_time=[0, 0]):
-        """Capture the Python DAG that VineDAG hands us before we mirror it in C."""
+        """Capture the Python DAG that DAGVine hands us before we mirror it in C."""
         self.task_dict = task_dict
 
         if dts:
@@ -161,7 +161,7 @@ def load_result_of_key(self, key):
         return ContextGraphTaskResult.load_from_path(outfile_path)
 
     def get_topological_order(self):
-        """Produce the order VineDAG uses when assigning node IDs to the C graph."""
+        """Produce the order DAGVine uses when assigning node IDs to the C graph."""
         in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
         queue = deque([key for key, degree in in_degree.items() if degree == 0])
         topo_order = []
diff --git a/taskvine/src/graph/vinedag/context_graph/proxy_functions.py b/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
similarity index 98%
rename from taskvine/src/graph/vinedag/context_graph/proxy_functions.py
rename to taskvine/src/graph/dagvine/context_graph/proxy_functions.py
index 4218756007..c466e62576 100644
--- a/taskvine/src/graph/vinedag/context_graph/proxy_functions.py
+++ b/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
@@ -43,7 +43,7 @@ def compute_sexpr_key(context_graph, k, v):
     """
     Evaluate a symbolic expression (S-expression) task within the task graph.
 
-    Both VineDAG and legacy Dask represent computations as symbolic
+    Both DAGVine and legacy Dask represent computations as symbolic
     expression trees (S-expressions). Each task value `v` encodes a nested
     structure where:
       - Leaf nodes are constants or task keys referencing parent results.
diff --git a/taskvine/src/graph/vinedag/context_graph/proxy_library.py b/taskvine/src/graph/dagvine/context_graph/proxy_library.py
similarity index 96%
rename from taskvine/src/graph/vinedag/context_graph/proxy_library.py
rename to taskvine/src/graph/dagvine/context_graph/proxy_library.py
index a0c4fb4377..4d0873e667 100644
--- a/taskvine/src/graph/vinedag/context_graph/proxy_library.py
+++ b/taskvine/src/graph/dagvine/context_graph/proxy_library.py
@@ -11,8 +11,8 @@
 import hashlib
 import collections
 
-from ndcctools.taskvine.vinedag.context_graph.core import ContextGraphTaskResult, ContextGraph
-from ndcctools.taskvine.vinedag.context_graph.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
+from ndcctools.taskvine.dagvine.context_graph.core import ContextGraphTaskResult, ContextGraph
+from ndcctools.taskvine.dagvine.context_graph.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
 from ndcctools.taskvine.utils import load_variable_from_library
 
 
diff --git a/taskvine/src/graph/vinedag/vinedag.py b/taskvine/src/graph/dagvine/dagvine.py
similarity index 93%
rename from taskvine/src/graph/vinedag/vinedag.py
rename to taskvine/src/graph/dagvine/dagvine.py
index 77975df3f5..b8a51bc82d 100644
--- a/taskvine/src/graph/vinedag/vinedag.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -5,10 +5,10 @@
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.manager import Manager
 
-from ndcctools.taskvine.vinedag.context_graph.proxy_library import ProxyLibrary
-from ndcctools.taskvine.vinedag.context_graph.proxy_functions import compute_single_key
-from ndcctools.taskvine.vinedag.context_graph.core import ContextGraph, ContextGraphTaskResult
-from ndcctools.taskvine.vinedag.vine_graph.vine_graph_client import VineGraphClient
+from ndcctools.taskvine.dagvine.context_graph.proxy_library import ProxyLibrary
+from ndcctools.taskvine.dagvine.context_graph.proxy_functions import compute_single_key
+from ndcctools.taskvine.dagvine.context_graph.core import ContextGraph, ContextGraphTaskResult
+from ndcctools.taskvine.dagvine.vine_graph.vine_graph_client import VineGraphClient
 
 import cloudpickle
 import os
@@ -51,7 +51,7 @@ def color_text(text, color_code):
 
 
 # Flatten Dask collections into the dict-of-tasks structure the rest of the
-# pipeline expects. VineDAG clients often hand us a dict like
+# pipeline expects. DAGVine clients often hand us a dict like
 # {"result": dask.delayed(...)}; we merge the underlying HighLevelGraphs so
 # `ContextGraph` sees the same dict representation C does.
 def dask_collections_to_task_dict(collection_dict):
@@ -146,7 +146,7 @@ def update_param(self, param_name, new_value):
             self.vine_manager_tuning_params[param_name] = new_value
 
     def get_value_of(self, param_name):
-        """Helper so VineDAG can pull a knob value without caring where it lives."""
+        """Helper so DAGVine can pull a knob value without caring where it lives."""
         if param_name in self.vine_manager_tuning_params:
             return self.vine_manager_tuning_params[param_name]
         elif param_name in self.vine_graph_tuning_params:
@@ -157,7 +157,7 @@ def get_value_of(self, param_name):
             raise ValueError(f"Invalid param name: {param_name}")
 
 
-class VineDAG(Manager):
+class DAGVine(Manager):
     def __init__(self,
                  *args,
                  **kwargs):
@@ -175,7 +175,7 @@ def __init__(self,
         if self.run_info_template_path:
             delete_all_files(self.run_info_template_path)
 
-        # Boot the underlying TaskVine manager. The TaskVine manager keeps alive until the vinedag object is destroyed
+        # Boot the underlying TaskVine manager. The TaskVine manager keeps alive until the dagvine object is destroyed
         super().__init__(*args, **kwargs)
         print(f"cvine = {cvine}")
         self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
@@ -282,6 +282,14 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
+        # filter out target keys that are not in the collection dict
+        missing_keys = [k for k in target_keys if k not in collection_dict]
+        if missing_keys:
+            print(f"=== Warning: the following target keys are not in the collection dict:")
+            for k in missing_keys:
+                print(f"             {k}")
+        target_keys = list(set(target_keys) - set(missing_keys))
+
         task_dict = ensure_task_dict(collection_dict)
 
         # Build both the Python DAG and its C mirror.
diff --git a/taskvine/src/graph/vinedag/vine_graph/.gitignore b/taskvine/src/graph/dagvine/vine_graph/.gitignore
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/.gitignore
rename to taskvine/src/graph/dagvine/vine_graph/.gitignore
diff --git a/taskvine/src/graph/vinedag/vine_graph/Makefile b/taskvine/src/graph/dagvine/vine_graph/Makefile
similarity index 99%
rename from taskvine/src/graph/vinedag/vine_graph/Makefile
rename to taskvine/src/graph/dagvine/vine_graph/Makefile
index 45fc3f7b42..090682269a 100644
--- a/taskvine/src/graph/vinedag/vine_graph/Makefile
+++ b/taskvine/src/graph/dagvine/vine_graph/Makefile
@@ -1,7 +1,7 @@
 include ../../../../../config.mk
 include ../../../../../rules.mk
 
-PROJECT_NAME = vinedag
+PROJECT_NAME = dagvine
 
 LOCAL_LINKAGE+=${CCTOOLS_HOME}/taskvine/src/manager/libtaskvine.a ${CCTOOLS_HOME}/dttools/src/libdttools.a
 LOCAL_CCFLAGS+=-I ${CCTOOLS_HOME}/taskvine/src/manager
diff --git a/taskvine/src/graph/vinedag/vine_graph/__init__.py b/taskvine/src/graph/dagvine/vine_graph/__init__.py
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/__init__.py
rename to taskvine/src/graph/dagvine/vine_graph/__init__.py
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/vine_graph.c
rename to taskvine/src/graph/dagvine/vine_graph/vine_graph.c
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph.h b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/vine_graph.h
rename to taskvine/src/graph/dagvine/vine_graph/vine_graph.h
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph.i b/taskvine/src/graph/dagvine/vine_graph/vine_graph.i
similarity index 82%
rename from taskvine/src/graph/vinedag/vine_graph/vine_graph.i
rename to taskvine/src/graph/dagvine/vine_graph/vine_graph.i
index b87d428c01..65be1a8edb 100644
--- a/taskvine/src/graph/vinedag/vine_graph/vine_graph.i
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.i
@@ -1,4 +1,4 @@
-/* SWIG interface for local vinedag graph API bindings */
+/* SWIG interface for local dagvine graph API bindings */
 %module vine_graph_capi
 
 %{
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_graph_client.py b/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/vine_graph_client.py
rename to taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_node.c b/taskvine/src/graph/dagvine/vine_graph/vine_node.c
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/vine_node.c
rename to taskvine/src/graph/dagvine/vine_graph/vine_node.c
diff --git a/taskvine/src/graph/vinedag/vine_graph/vine_node.h b/taskvine/src/graph/dagvine/vine_graph/vine_node.h
similarity index 100%
rename from taskvine/src/graph/vinedag/vine_graph/vine_node.h
rename to taskvine/src/graph/dagvine/vine_graph/vine_node.h
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index e6ff9a3660..92bcda6101 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -966,29 +966,6 @@ static void cleanup_worker_files(struct vine_manager *q, struct vine_worker_info
 	hash_table_free_keys_array(cachenames);
 }
 
-/** Check if a file is busy by checking if it is an input file of any task. */
-static int is_file_busy(struct vine_manager *q, struct vine_worker_info *w, struct vine_file *f)
-{
-	if (!q || !w || !f) {
-		return 0;
-	}
-
-	uint64_t task_id;
-	struct vine_task *task;
-	ITABLE_ITERATE(w->current_tasks, task_id, task)
-	{
-		struct vine_mount *input_mount;
-		LIST_ITERATE(task->input_mounts, input_mount)
-		{
-			if (f == input_mount->file) {
-				return 1;
-			}
-		}
-	}
-
-	return 0;
-}
-
 /** Evict a random worker to simulate a worker failure. */
 int evict_random_worker(struct vine_manager *q)
 {
@@ -1108,24 +1085,42 @@ static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f
 		return;
 	}
 
-	struct priority_queue *offload_from_workers = priority_queue_create(0);
+	struct priority_queue *clean_replicas_from_workers = priority_queue_create(0);
 
 	struct vine_worker_info *source_worker = NULL;
 	SET_ITERATE(source_workers, source_worker)
 	{
-		// workers with more used disk are prioritized for removing
-		if (is_file_busy(q, source_worker, f)) {
+		// if the file is actively in use by a task (the input to that task), we don't remove the replica on this worker
+		int file_inuse = 0;
+
+		uint64_t task_id;
+		struct vine_task *task;
+		ITABLE_ITERATE(source_worker->current_tasks, task_id, task)
+		{
+			struct vine_mount *input_mount;
+			LIST_ITERATE(task->input_mounts, input_mount)
+			{
+				if (f == input_mount->file) {
+					file_inuse = 1;
+					break;
+				}
+			}
+			if (file_inuse) {
+				break;
+			}
+		}
+		
+		if (file_inuse) {
 			continue;
 		}
 
-		priority_queue_push(offload_from_workers, source_worker, source_worker->inuse_cache);
+		priority_queue_push(clean_replicas_from_workers, source_worker, source_worker->inuse_cache);
 	}
 
-	struct vine_worker_info *offload_from_worker = NULL;
-	while (replicas_to_remove-- > 0 && (offload_from_worker = priority_queue_pop(offload_from_workers))) {
-		delete_worker_file(q, offload_from_worker, f->cached_name, 0, 0);
+	while (replicas_to_remove-- > 0 && (source_worker = priority_queue_pop(clean_replicas_from_workers))) {
+		delete_worker_file(q, source_worker, f->cached_name, 0, 0);
 	}
-	priority_queue_delete(offload_from_workers);
+	priority_queue_delete(clean_replicas_from_workers);
 
 	return;
 }
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index 2f171f5efe..d8a2339208 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -97,6 +97,31 @@ static struct vine_worker_info *get_best_dest_worker(struct vine_manager *q, str
 	return best_destination;
 }
 
+static int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP) {
+		return 0;
+	}
+
+	struct vine_worker_info *source_worker = get_best_source_worker(q, f);
+	if (!source_worker) {
+		return 0;
+	}
+
+	struct vine_worker_info *dest_worker = get_best_dest_worker(q, f);
+	if (!dest_worker) {
+		return 0;
+	}
+
+	vine_temp_start_peer_transfer(q, f, source_worker, dest_worker);
+
+	return 1;
+}
+
+/*************************************************************/
+/* Public Functions */
+/*************************************************************/
+
 void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f, struct vine_worker_info *source_worker, struct vine_worker_info *dest_worker)
 {
 	if (!q || !f || f->type != VINE_TEMP || !source_worker || !dest_worker) {
@@ -108,23 +133,34 @@ void vine_temp_start_peer_transfer(struct vine_manager *q, struct vine_file *f,
 	free(source_addr);
 }
 
-int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f)
+int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
 {
-	if (!q || !f || f->type != VINE_TEMP) {
+	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
 		return 0;
 	}
 
-	struct vine_worker_info *source_worker = get_best_source_worker(q, f);
-	if (!source_worker) {
+	int current_replica_count = vine_file_replica_count(q, f);
+	if (current_replica_count == 0 || current_replica_count >= q->temp_replica_count) {
 		return 0;
 	}
 
-	struct vine_worker_info *dest_worker = get_best_dest_worker(q, f);
-	if (!dest_worker) {
+	priority_queue_push(q->temp_files_to_replicate, f, -current_replica_count);
+
+	return 1;
+}
+
+int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
+{
+	if (!q || !cachename) {
 		return 0;
 	}
 
-	vine_temp_start_peer_transfer(q, f, source_worker, dest_worker);
+	struct vine_file *f = hash_table_lookup(q->file_table, cachename);
+	if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+		return 0;
+	}
+
+	vine_temp_replicate_file_later(q, f);
 
 	return 1;
 }
@@ -176,40 +212,4 @@ int vine_temp_start_replication(struct vine_manager *q)
 	list_delete(skipped);
 
 	return processed;
-}
-
-/*************************************************************/
-/* Public Functions */
-/*************************************************************/
-
-int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f)
-{
-	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
-		return 0;
-	}
-
-	int current_replica_count = vine_file_replica_count(q, f);
-	if (current_replica_count == 0 || current_replica_count >= q->temp_replica_count) {
-		return 0;
-	}
-
-	priority_queue_push(q->temp_files_to_replicate, f, -current_replica_count);
-
-	return 1;
-}
-
-int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename)
-{
-	if (!q || !cachename) {
-		return 0;
-	}
-
-	struct vine_file *f = hash_table_lookup(q->file_table, cachename);
-	if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
-		return 0;
-	}
-
-	vine_temp_replicate_file_later(q, f);
-
-	return 1;
-}
+}
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
index ff2efb5011..da710d4f1e 100644
--- a/taskvine/src/manager/vine_temp.h
+++ b/taskvine/src/manager/vine_temp.h
@@ -3,7 +3,6 @@
 
 #include "vine_manager.h"
 
-int vine_temp_replicate_file_now(struct vine_manager *q, struct vine_file *f);
 int vine_temp_replicate_file_later(struct vine_manager *q, struct vine_file *f);
 int vine_temp_handle_file_lost(struct vine_manager *q, char *cachename);
 int vine_temp_start_replication(struct vine_manager *q);

From 86cbc133cd7d190a71eabb7166734a1e52d53dcd Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 4 Dec 2025 11:12:29 -0500
Subject: [PATCH 090/113] fix

---
 poncho/src/poncho/library_network_code.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index 5fab4b0b85..539c7464a5 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -81,10 +81,8 @@ def remote_wrapper(event):
 # Handler to sigchld when child exits.
 def sigchld_handler(signum, frame):
     # write any byte to signal that there's at least 1 child
-    try:
-        os.write(w, b"a")
-    except OSError:
-        pass
+    # if this fails, the notification mechanism has failed and the error will be raised normally
+    os.write(w, b"a")
 
 
 # Read data from worker, start function, and dump result to `outfile`.
@@ -417,6 +415,7 @@ def main():
                     )
                 else:
                     pid, func_id = start_function(in_pipe_fd, thread_limit)
+                    # pid == -1 indicates a failure during fork/setup of the function execution
                     if pid == -1:
                         send_result(
                             out_pipe_fd,

From 67b29a529371981affe0e6e83c38471b7fc46b02 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 13:06:40 -0500
Subject: [PATCH 091/113] fix comments

---
 poncho/src/poncho/library_network_code.py | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/poncho/src/poncho/library_network_code.py b/poncho/src/poncho/library_network_code.py
index 539c7464a5..44dc47c566 100755
--- a/poncho/src/poncho/library_network_code.py
+++ b/poncho/src/poncho/library_network_code.py
@@ -156,7 +156,7 @@ def start_function(in_pipe_fd, thread_limit=1):
             finally:
                 os.chdir(library_sandbox)
             return -1, function_id
-        else:
+        elif exec_method == "fork":
             try:
                 arg_infile = os.path.join(function_sandbox, "infile")
                 with open(arg_infile, "rb") as f:
@@ -180,11 +180,10 @@ def start_function(in_pipe_fd, thread_limit=1):
                             os.dup2(f.fileno(), sys.stdout.fileno())  # redirect stdout
                             os.dup2(f.fileno(), sys.stderr.fileno())  # redirect stderr
 
-                            # keep the function invocation inside the context
-                            # so the stdout/stderr file stays open during execution and closes safely afterward.
-                            stdout_timed_message(f"TASK {function_id} {function_name} starts in PID {os.getpid()}")
-                            result = globals()[function_name](event)
-                            stdout_timed_message(f"TASK {function_id} {function_name} finished")
+                        # once the file descriptors are redirected, we can start the function execution
+                        stdout_timed_message(f"TASK {function_id} {function_name} starts in PID {os.getpid()}")
+                        result = globals()[function_name](event)
+                        stdout_timed_message(f"TASK {function_id} {function_name} finished")
 
                     except Exception:
                         stdout_timed_message(f"TASK {function_id} error: can't execute {function_name} due to {traceback.format_exc()}")
@@ -223,6 +222,9 @@ def start_function(in_pipe_fd, thread_limit=1):
             # return pid and function id of child process to parent.
             else:
                 return p, function_id
+        else:
+            stdout_timed_message(f"error: invalid execution method {exec_method}")
+            return -1, function_id
 
 
 # Send result of a function execution to worker. Wake worker up to do work with SIGCHLD.

From 40a09295740abb85272b7fce96099dd4c6fc0147 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 14:30:30 -0500
Subject: [PATCH 092/113] merge

---
 .../src/manager/vine_file_replica_table.c     | 114 ------------------
 .../src/manager/vine_file_replica_table.h     |   4 -
 taskvine/src/manager/vine_manager.c           |  14 +--
 taskvine/src/manager/vine_temp.c              |  37 ++++++
 taskvine/src/manager/vine_temp.h              |  11 +-
 5 files changed, 49 insertions(+), 131 deletions(-)

diff --git a/taskvine/src/manager/vine_file_replica_table.c b/taskvine/src/manager/vine_file_replica_table.c
index d6ba403f5b..1dad20dd62 100644
--- a/taskvine/src/manager/vine_file_replica_table.c
+++ b/taskvine/src/manager/vine_file_replica_table.c
@@ -147,94 +147,6 @@ struct vine_worker_info *vine_file_replica_table_find_worker(struct vine_manager
 	return peer_selected;
 }
 
-// trigger replications of file to satisfy temp_replica_count
-int vine_file_replica_table_replicate(struct vine_manager *m, struct vine_file *f, struct set *source_workers, int to_find)
-{
-	if (!f || !source_workers) {
-		return 0;
-	}
-
-	int nsource_workers = set_size(source_workers);
-	int round_replication_request_sent = 0;
-
-	/* get the elements of set so we can insert new replicas to sources */
-	struct vine_worker_info **source_workers_frozen = (struct vine_worker_info **)set_values(source_workers);
-	struct vine_worker_info *source_worker;
-
-	for (int i = 0; i < nsource_workers; i++) {
-
-		source_worker = source_workers_frozen[i];
-		int dest_workers_found = 0;
-
-		// skip if the file on the source is not ready to transfer
-		struct vine_file_replica *replica = hash_table_lookup(source_worker->current_files, f->cached_name);
-		if (!replica || replica->state != VINE_FILE_REPLICA_STATE_READY) {
-			continue;
-		}
-
-		// skip if the source is busy with other transfers
-		if (source_worker->outgoing_xfer_counter >= m->worker_source_max_transfers) {
-			continue;
-		}
-
-		char *source_addr = string_format("%s/%s", source_worker->transfer_url, f->cached_name);
-
-		char *id;
-		struct vine_worker_info *dest_worker;
-		int offset_bookkeep;
-
-		HASH_TABLE_ITERATE_RANDOM_START(m->worker_table, offset_bookkeep, id, dest_worker)
-		{
-			// skip if the source and destination are on the same host
-			if (set_lookup(source_workers, dest_worker) || strcmp(source_worker->hostname, dest_worker->hostname) == 0) {
-				continue;
-			}
-
-			// skip if the destination is not ready to transfer
-			if (!dest_worker->transfer_port_active) {
-				continue;
-			}
-
-			// skip if the destination is draining
-			if (dest_worker->draining) {
-				continue;
-			}
-
-			// skip if the destination is busy with other transfers
-			if (dest_worker->incoming_xfer_counter >= m->worker_source_max_transfers) {
-				continue;
-			}
-
-			debug(D_VINE, "replicating %s from %s to %s", f->cached_name, source_worker->addrport, dest_worker->addrport);
-
-			vine_manager_put_url_now(m, dest_worker, source_worker, source_addr, f);
-
-			round_replication_request_sent++;
-
-			// break if we have found enough destinations for this source
-			if (++dest_workers_found >= MIN(m->file_source_max_transfers, to_find)) {
-				break;
-			}
-
-			// break if the source becomes busy with transfers
-			if (source_worker->outgoing_xfer_counter >= m->worker_source_max_transfers) {
-				break;
-			}
-		}
-
-		free(source_addr);
-
-		// break if we have sent enough replication requests for this file
-		if (round_replication_request_sent >= to_find) {
-			break;
-		}
-	}
-
-	free(source_workers_frozen);
-
-	return round_replication_request_sent;
-}
-
 /*
 Count number of replicas of a file in the system.
 */
@@ -258,32 +170,6 @@ int vine_file_replica_table_count_replicas(struct vine_manager *q, const char *c
 	return count;
 }
 
-/*
-Check if a file replica exists on a worker. We accept both CREATING and READY replicas,
-since a CREATING replica may already exist physically but hasn't yet received the cache-update
-message from the manager. However, we do not accept DELETING replicas, as they indicate
-the source worker has already been sent an unlink request—any subsequent cache-update or
-cache-invalid events will lead to deletion.
-*/
-int vine_file_replica_table_exists_somewhere(struct vine_manager *q, const char *cachename)
-{
-	struct set *workers = hash_table_lookup(q->file_worker_table, cachename);
-	if (!workers || set_size(workers) < 1) {
-		return 0;
-	}
-
-	struct vine_worker_info *w;
-	SET_ITERATE(workers, w)
-	{
-		struct vine_file_replica *r = vine_file_replica_table_lookup(w, cachename);
-		if (r && (r->state == VINE_FILE_REPLICA_STATE_CREATING || r->state == VINE_FILE_REPLICA_STATE_READY)) {
-			return 1;
-		}
-	}
-
-	return 0;
-}
-
 // get or create a replica for a worker and cachename
 struct vine_file_replica *vine_file_replica_table_get_or_create(struct vine_manager *m, struct vine_worker_info *w, const char *cachename, vine_file_type_t type, vine_cache_level_t cache_level, int64_t size, time_t mtime)
 {
diff --git a/taskvine/src/manager/vine_file_replica_table.h b/taskvine/src/manager/vine_file_replica_table.h
index c4d18b4099..cba24c0133 100644
--- a/taskvine/src/manager/vine_file_replica_table.h
+++ b/taskvine/src/manager/vine_file_replica_table.h
@@ -30,10 +30,6 @@ struct vine_file_replica *vine_file_replica_table_get_or_create(struct vine_mana
 
 struct vine_worker_info *vine_file_replica_table_find_worker(struct vine_manager *q, const char *cachename);
 
-int vine_file_replica_table_replicate(struct vine_manager *q, struct vine_file *f, struct set *source_workers, int to_find);
-
-int vine_file_replica_table_exists_somewhere( struct vine_manager *q, const char *cachename );
-
 int vine_file_replica_table_count_replicas( struct vine_manager *q, const char *cachename, vine_file_replica_state_t state );
 
 #endif
\ No newline at end of file
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 040b797e8e..42192f5cb1 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -43,6 +43,7 @@ See the file COPYING for details.
 #include "envtools.h"
 #include "hash_table.h"
 #include "skip_list.h"
+#include "priority_queue.h"
 #include "int_sizes.h"
 #include "interfaces_address.h"
 #include "itable.h"
@@ -923,15 +924,6 @@ void vine_update_catalog(struct vine_manager *m)
 	}
 }
 
-static int file_needs_recovery(struct vine_manager *q, struct vine_file *f)
-{
-	if (!f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
-		return 0;
-	}
-
-	return !vine_file_replica_table_exists_somewhere(q, f->cached_name);
-}
-
 static void cleanup_worker_files(struct vine_manager *q, struct vine_worker_info *w)
 {
 	if (!q || !w || hash_table_size(w->current_files) < 1) {
@@ -960,7 +952,7 @@ static void cleanup_worker_files(struct vine_manager *q, struct vine_worker_info
 			vine_file_replica_delete(removed_replica);
 		}
 		/* consider if this replica needs recovery because of worker removal */
-		if (q->immediate_recovery && file_needs_recovery(q, f)) {
+		if (q->immediate_recovery && f && f->type == VINE_TEMP && !vine_temp_exists_somewhere(q, f)) {
 			vine_manager_consider_recovery_task(q, f, f->recovery_task);
 		}
 	}
@@ -3475,7 +3467,7 @@ static int vine_manager_check_inputs_available(struct vine_manager *q, struct vi
 		struct vine_file *f = m->file;
 		if (f->type == VINE_FILE && f->state == VINE_FILE_STATE_PENDING) {
 			all_available = 0;
-		} else if (file_needs_recovery(q, f)) {
+		} else if (f->type == VINE_TEMP && !vine_temp_exists_somewhere(q, f)) {
 			vine_manager_consider_recovery_task(q, f, f->recovery_task);
 			all_available = 0;
 		}
diff --git a/taskvine/src/manager/vine_temp.c b/taskvine/src/manager/vine_temp.c
index cae4b183ee..269d47c8e0 100644
--- a/taskvine/src/manager/vine_temp.c
+++ b/taskvine/src/manager/vine_temp.c
@@ -42,6 +42,7 @@ static int worker_can_peer_transfer(struct vine_worker_info *w)
 	if (w->resources->tag < 0) {
 		return 0;
 	}
+
 	return 1;
 }
 
@@ -203,6 +204,42 @@ static int attempt_replication(struct vine_manager *q, struct vine_file *f)
 /* Public Functions */
 /*************************************************************/
 
+/**
+Check if a temporary file exists somewhere in all workers.
+Returns 1 if at least one CREATING or READY replica exists, 0 otherwise.
+
+We accept both CREATING and READY replicas as available sources, since a CREATING
+replica may already exist physically but hasn't yet received the cache-update
+message from the manager. However, we do not accept DELETING replicas, as they
+indicate the source worker has already been sent an unlink request—any subsequent
+cache-update or cache-invalid events will lead to deletion.
+
+If the file's state is not CREATED, we need to wait for the producer task to
+complete before checking for replicas.
+*/
+int vine_temp_exists_somewhere(struct vine_manager *q, struct vine_file *f)
+{
+	if (!q || !f || f->type != VINE_TEMP || f->state != VINE_FILE_STATE_CREATED) {
+		return 0;
+	}
+
+	struct set *workers = hash_table_lookup(q->file_worker_table, f->cached_name);
+	if (!workers || set_size(workers) < 1) {
+		return 0;
+	}
+
+	struct vine_worker_info *w;
+	SET_ITERATE(workers, w)
+	{
+		struct vine_file_replica *replica = vine_file_replica_table_lookup(w, f->cached_name);
+		if (replica && (replica->state == VINE_FILE_REPLICA_STATE_CREATING || replica->state == VINE_FILE_REPLICA_STATE_READY)) {
+			return 1;
+		}
+	}
+
+	return 0;
+}
+
 /**
 Queue a temporary file for replication when it still lacks the target number of
 replicas. Files without any replica and those already satisfying the quota are
diff --git a/taskvine/src/manager/vine_temp.h b/taskvine/src/manager/vine_temp.h
index de25f26a0f..d94c05d372 100644
--- a/taskvine/src/manager/vine_temp.h
+++ b/taskvine/src/manager/vine_temp.h
@@ -3,12 +3,19 @@
 
 #include "vine_manager.h"
 
-/** Replication related functions */
+/** Check if a temporary file exists somewhere in all workers. */
+int vine_temp_exists_somewhere(struct vine_manager *q, struct vine_file *f);
+
+/** Queue a temporary file for replication. */
 int vine_temp_queue_for_replication(struct vine_manager *q, struct vine_file *f);
+
+/** Start replication for temporary files. */
 int vine_temp_start_replication(struct vine_manager *q);
 
-/** Storage management functions */
+/** Clean redundant replicas of a temporary file. */
 void vine_temp_clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
+
+/** Shift a temp file replica away from the worker using the most cache space. */
 void vine_temp_shift_disk_load(struct vine_manager *q, struct vine_worker_info *source_worker, struct vine_file *f);
 
 #endif
\ No newline at end of file

From b1e70df4ce1f5d9b1e797bd0a698e0e3324305b1 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 14:36:39 -0500
Subject: [PATCH 093/113] clean

---
 taskvine/src/manager/vine_manager.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 42192f5cb1..26ece01d74 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -952,7 +952,7 @@ static void cleanup_worker_files(struct vine_manager *q, struct vine_worker_info
 			vine_file_replica_delete(removed_replica);
 		}
 		/* consider if this replica needs recovery because of worker removal */
-		if (q->immediate_recovery && f && f->type == VINE_TEMP && !vine_temp_exists_somewhere(q, f)) {
+		if (q->immediate_recovery && f->type == VINE_TEMP && !vine_temp_exists_somewhere(q, f)) {
 			vine_manager_consider_recovery_task(q, f, f->recovery_task);
 		}
 	}

From 058466ea102032ca55d96ee39a9ef8ba535a1efa Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 15:32:46 -0500
Subject: [PATCH 094/113] update

---
 .../src/graph/dagvine/vine_graph/vine_graph.c |  6 +-
 taskvine/src/manager/vine_manager.c           | 80 +++----------------
 taskvine/src/manager/vine_schedule.c          |  5 --
 3 files changed, 12 insertions(+), 79 deletions(-)

diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 3ef646c768..73d1298fee 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -1275,8 +1275,8 @@ void vine_graph_execute(struct vine_graph *vg)
 			/* inject failure */
 			if (vg->failure_injection_step_percent > 0) {
 				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
-				if (progress >= next_failure_threshold && evict_random_worker(vg->manager)) {
-					debug(D_VINE, "evicted a worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
+				if (progress >= next_failure_threshold && release_random_worker(vg->manager)) {
+					debug(D_VINE, "released a random worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
 					next_failure_threshold += vg->failure_injection_step_percent / 100.0;
 				}
 			}
@@ -1285,7 +1285,7 @@ void vine_graph_execute(struct vine_graph *vg)
 			switch (node->outfile_type) {
 			case NODE_OUTFILE_TYPE_TEMP:
 				/* replicate the outfile of the temp node */
-				vine_temp_replicate_file_later(vg->manager, node->outfile);
+				vine_temp_queue_for_replication(vg->manager, node->outfile);
 				break;
 			case NODE_OUTFILE_TYPE_LOCAL:
 			case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM:
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index afbc6d05d5..18e05326a5 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -173,8 +173,6 @@ static int release_worker(struct vine_manager *q, struct vine_worker_info *w);
 struct vine_task *send_library_to_worker(struct vine_manager *q, struct vine_worker_info *w, const char *name);
 static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t);
 
-static void clean_redundant_replicas(struct vine_manager *q, struct vine_file *f);
-
 /* Return the number of workers matching a given type: WORKER, STATUS, etc */
 
 static int count_workers(struct vine_manager *q, vine_worker_type_t type)
@@ -3533,58 +3531,6 @@ int consider_task(struct vine_manager *q, struct vine_task *t)
 	return 1;
 }
 
-/* Rotate pending tasks to the ready queue if they are runnable. */
-static int rotate_pending_tasks(struct vine_manager *q)
-{
-	if (list_size(q->pending_tasks) == 0) {
-		return 0;
-	}
-
-	int runnable_tasks = 0;
-	int tasks_considered = 0;
-	int tasks_to_consider = MIN(list_size(q->pending_tasks), q->attempt_schedule_depth);
-	struct vine_task *t = NULL;
-
-	double current_time = timestamp_get() / ONE_SECOND;
-
-	while (tasks_considered++ < tasks_to_consider) {
-		t = list_pop_head(q->pending_tasks);
-		if (!t) {
-			break;
-		}
-
-		/* first check if the task has exceeded its end time or does not match any submitted library */
-		/* If any of the reasons fired, then expire the task and put in the retrieved queue. */
-		if (t->resources_requested->end > 0 && t->resources_requested->end <= current_time) {
-			debug(D_VINE, "task %d has exceeded its end time", t->task_id);
-			vine_task_set_result(t, VINE_RESULT_MAX_END_TIME);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-		if (t->needs_library && !hash_table_lookup(q->library_templates, t->needs_library)) {
-			debug(D_VINE, "task %d does not match any submitted library named \"%s\"", t->task_id, t->needs_library);
-			vine_task_set_result(t, VINE_RESULT_MISSING_LIBRARY);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-		if (q->fixed_location_in_queue && t->has_fixed_locations && !vine_schedule_check_fixed_location(q, t)) {
-			debug(D_VINE, "Missing fixed_location dependencies for task: %d", t->task_id);
-			vine_task_set_result(t, VINE_RESULT_FIXED_LOCATION_MISSING);
-			change_task_state(q, t, VINE_TASK_RETRIEVED);
-			continue;
-		}
-
-		if (consider_task(q, t)) {
-			push_task_to_ready_tasks(q, t);
-			runnable_tasks++;
-		} else {
-			list_push_tail(q->pending_tasks, t);
-		}
-	}
-
-	return runnable_tasks;
-}
-
 /*
 Advance the state of the system by selecting one task available
 to run, finding the best worker for that task, and then committing
@@ -3616,25 +3562,24 @@ static int send_one_task_with_cr(struct vine_manager *q, struct skip_list_cursor
 			continue;
 		}
 
-		/* this task is not runnable at all, put it back in the pending queue */
 		if (!consider_task(q, t)) {
-			list_push_tail(q->pending_tasks, t);
 			continue;
 		}
 
-		/* select a worker for the task */
+		// Find the best worker for the task
+		q->stats_measure->time_scheduling = timestamp_get();
 		struct vine_worker_info *w = vine_schedule_task_to_worker(q, t);
+		q->stats->time_scheduling += timestamp_get() - q->stats_measure->time_scheduling;
 
 		if (w) {
 			task_unready = 1;
 
-		/* commit the task to the worker */
-		vine_result_code_t result;
-		if (q->task_groups_enabled) {
-			result = commit_task_group_to_worker(q, w, t);
-		} else {
-			result = commit_task_to_worker(q, w, t);
-		}
+			vine_result_code_t result;
+			if (q->task_groups_enabled) {
+				result = commit_task_group_to_worker(q, w, t);
+			} else {
+				result = commit_task_to_worker(q, w, t);
+			}
 
 			switch (result) {
 			case VINE_SUCCESS:     /* return on successful commit. */
@@ -4676,7 +4621,6 @@ static void push_task_to_ready_tasks(struct vine_manager *q, struct vine_task *t
 	} else if (t->result == VINE_RESULT_RESOURCE_EXHAUSTION) {
 		manager_priority = VINE_PRIORITY_EXHAUSTION;
 	}
-	priority_queue_push(q->ready_tasks, t, t->priority);
 
 	if (manager_priority > t->manager_priority) {
 		t->manager_priority = manager_priority;
@@ -5425,12 +5369,6 @@ static struct vine_task *vine_wait_internal(struct vine_manager *q, int timeout,
 			}
 		}
 
-		// Check if any worker is overloaded and rebalance the disk usage
-		if (q->balance_worker_disk_load && (timestamp_get() - q->when_last_offloaded > 5 * 1e6)) {
-			rebalance_worker_disk_usage(q);
-			q->when_last_offloaded = timestamp_get();
-		}
-
 		// Check if any temp files need replication and start replicating
 		BEGIN_ACCUM_TIME(q, time_internal);
 		result = vine_temp_start_replication(q);
diff --git a/taskvine/src/manager/vine_schedule.c b/taskvine/src/manager/vine_schedule.c
index e383033302..284be290c1 100644
--- a/taskvine/src/manager/vine_schedule.c
+++ b/taskvine/src/manager/vine_schedule.c
@@ -607,10 +607,6 @@ void vine_schedule_check_for_large_tasks(struct vine_manager *q)
 
 	struct rmsummary *largest_unfit_task = rmsummary_create(-1);
 
-<<<<<<< HEAD
-	LIST_ITERATE(q->pending_tasks, t)
-	{
-=======
 	struct skip_list_cursor *cur = skip_list_cursor_create(q->ready_tasks);
 	skip_list_seek(cur, 0);
 	while (skip_list_get(cur, (void **)&t)) {
@@ -618,7 +614,6 @@ void vine_schedule_check_for_large_tasks(struct vine_manager *q)
 		// in case there are continues, etc. below.
 		skip_list_next(cur);
 
->>>>>>> origin/master
 		// check each task against the queue of connected workers
 		vine_resource_bitmask_t bit_set = is_task_larger_than_any_worker(q, t);
 		if (bit_set) {

From da8aa185328df419340375cea2c6cbf74b4ee139 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 15:36:15 -0500
Subject: [PATCH 095/113] rename recovery_tasks_submitted

---
 taskvine/src/graph/dagvine/vine_graph/vine_graph.c | 2 +-
 taskvine/src/manager/vine_manager.c                | 1 -
 taskvine/src/manager/vine_manager.h                | 1 -
 3 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 73d1298fee..66b0655a92 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -1190,7 +1190,7 @@ void vine_graph_execute(struct vine_graph *vg)
 		}
 
 		struct vine_task *task = vine_wait(vg->manager, wait_timeout);
-		progress_bar_set_part_total(pbar, recovery_tasks_part, vg->manager->num_submitted_recovery_tasks);
+		progress_bar_set_part_total(pbar, recovery_tasks_part, vg->manager->stats->recovery_tasks_submitted);
 		if (task) {
 			/* retrieve all possible tasks */
 			wait_timeout = 0;
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 18e05326a5..e8a933b5e6 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -4166,7 +4166,6 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->time_start_worker_eviction = 0;
 
 	q->return_recovery_tasks = 0;
-	q->num_submitted_recovery_tasks = 0;
 	q->balance_worker_disk_load = 0;
 	q->when_last_offloaded = 0;
 	q->peak_used_cache = 0;
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index ec8bdaad4c..5019c9a99b 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -237,7 +237,6 @@ struct vine_manager {
 	double disk_proportion_available_to_task;   /* intentionally reduces disk allocation for tasks to reserve some space for cache growth. */
 
 	int return_recovery_tasks; /* If true, recovery tasks are returned by vine_wait to the user. By default they are handled internally. */
-	int num_submitted_recovery_tasks;
 	int balance_worker_disk_load; /* If true, offload replicas from workers that are overloaded with temp files. */
 	timestamp_t when_last_offloaded;
 	int64_t peak_used_cache;

From 39ae787067b6e736f908d92d2ef770300ade52b0 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 15:41:24 -0500
Subject: [PATCH 096/113] timestamp format

---
 taskvine/src/graph/dagvine/vine_graph/vine_graph.c |  3 ++-
 taskvine/src/graph/dagvine/vine_graph/vine_graph.h | 14 +++++++-------
 taskvine/src/graph/dagvine/vine_graph/vine_node.h  |  6 +++---
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 66b0655a92..4f7ada468b 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -544,7 +544,7 @@ static void print_time_metrics(struct vine_graph *vg, const char *filename)
 	struct vine_node *node;
 	ITABLE_ITERATE(vg->nodes, nid, node)
 	{
-		fprintf(fp, "%" PRIu64 ",%lu,%lu,%lu,%lu,%lu,%lu\n", node->node_id, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
+		fprintf(fp, "%" PRIu64 "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "\n", node->node_id, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
 	}
 	fclose(fp);
 
@@ -1013,6 +1013,7 @@ void vine_graph_set_target(struct vine_graph *vg, uint64_t node_id)
 		debug(D_ERROR, "node %" PRIu64 " not found", node_id);
 		exit(1);
 	}
+
 	node->is_target = 1;
 }
 
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
index e3f78f5c83..0d9edb2a9b 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
@@ -14,13 +14,13 @@
 
 /** The task priority algorithm used for vine graph scheduling. */
 typedef enum {
-	TASK_PRIORITY_MODE_RANDOM = 0,			              /**< Assign random priority to tasks */
-	TASK_PRIORITY_MODE_DEPTH_FIRST,			              /**< Prioritize deeper tasks first */
-	TASK_PRIORITY_MODE_BREADTH_FIRST,		              /**< Prioritize shallower tasks first */
-	TASK_PRIORITY_MODE_FIFO,			                  /**< First in, first out priority */
-	TASK_PRIORITY_MODE_LIFO,			                  /**< Last in, first out priority */
-	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		          /**< Prioritize tasks with larger inputs first */
-	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST    /**< Prioritize tasks with larger storage footprint first */
+	TASK_PRIORITY_MODE_RANDOM = 0,			   /**< Assign random priority to tasks */
+	TASK_PRIORITY_MODE_DEPTH_FIRST,			   /**< Prioritize deeper tasks first */
+	TASK_PRIORITY_MODE_BREADTH_FIRST,		   /**< Prioritize shallower tasks first */
+	TASK_PRIORITY_MODE_FIFO,			   /**< First in, first out priority */
+	TASK_PRIORITY_MODE_LIFO,			   /**< Last in, first out priority */
+	TASK_PRIORITY_MODE_LARGEST_INPUT_FIRST,		   /**< Prioritize tasks with larger inputs first */
+	TASK_PRIORITY_MODE_LARGEST_STORAGE_FOOTPRINT_FIRST /**< Prioritize tasks with larger storage footprint first */
 } task_priority_mode_t;
 
 /** The vine graph (logical scheduling layer). */
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_node.h b/taskvine/src/graph/dagvine/vine_graph/vine_node.h
index 9f01e959c0..a838fb6e88 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_node.h
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_node.h
@@ -11,9 +11,9 @@
 
 /** The storage type of the node's output file. */
 typedef enum {
-	NODE_OUTFILE_TYPE_LOCAL = 0,	       /* Node-output file will be stored locally on the local staging directory */
-	NODE_OUTFILE_TYPE_TEMP,		           /* Node-output file will be stored in the temporary node-local storage */
-	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM,  /* Node-output file will be stored in the persistent shared file system */
+	NODE_OUTFILE_TYPE_LOCAL = 0,	      /* Node-output file will be stored locally on the local staging directory */
+	NODE_OUTFILE_TYPE_TEMP,		      /* Node-output file will be stored in the temporary node-local storage */
+	NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM, /* Node-output file will be stored in the persistent shared file system */
 } node_outfile_type_t;
 
 /** The status of an output file of a node. */

From 1b0cdf1aad728dba178e05633ca56a88b03da714 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 23:10:16 -0500
Subject: [PATCH 097/113] vine: check whether hash table key is present before
 inserting

---
 dttools/src/hash_table.c            | 2 +-
 taskvine/src/manager/vine_manager.c | 4 +++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/dttools/src/hash_table.c b/dttools/src/hash_table.c
index 4c298ca3b5..5f69f7d87d 100644
--- a/dttools/src/hash_table.c
+++ b/dttools/src/hash_table.c
@@ -275,7 +275,7 @@ int hash_table_insert(struct hash_table *h, const char *key, const void *value)
 		h->cant_iterate_yet = 1;
 	} else {
 		/* Key already exists, free the unused entry */
-		notice(D_DEBUG, "key % already exists in hash table, ignoring new value.", key);
+		notice(D_DEBUG, "key %s already exists in hash table, ignoring new value.", key);
 		free(e->key);
 		free(e);
 	}
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index f385fbab06..09694974ad 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -704,7 +704,9 @@ static vine_msg_code_t vine_manager_recv_no_retry(struct vine_manager *q, struct
 			string_prefix_is(line, "wable_status") || string_prefix_is(line, "resources_status")) {
 		result = handle_manager_status(q, w, line, stoptime);
 	} else if (string_prefix_is(line, "available_results")) {
-		hash_table_insert(q->workers_with_watched_file_updates, w->hashkey, w);
+		if (!hash_table_lookup(q->workers_with_watched_file_updates, w->hashkey)) {
+			hash_table_insert(q->workers_with_watched_file_updates, w->hashkey, w);
+		}
 		result = VINE_MSG_PROCESSED;
 	} else if (string_prefix_is(line, "resources")) {
 		result = handle_resources(q, w, stoptime);

From ff7eeb229fcbf4c1662d736bd841263647d552f2 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Mon, 5 Jan 2026 23:12:27 -0500
Subject: [PATCH 098/113] fix hash table insertion

---
 dttools/src/hash_table.c            | 2 +-
 taskvine/src/manager/vine_manager.c | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/dttools/src/hash_table.c b/dttools/src/hash_table.c
index 4c298ca3b5..5f69f7d87d 100644
--- a/dttools/src/hash_table.c
+++ b/dttools/src/hash_table.c
@@ -275,7 +275,7 @@ int hash_table_insert(struct hash_table *h, const char *key, const void *value)
 		h->cant_iterate_yet = 1;
 	} else {
 		/* Key already exists, free the unused entry */
-		notice(D_DEBUG, "key % already exists in hash table, ignoring new value.", key);
+		notice(D_DEBUG, "key %s already exists in hash table, ignoring new value.", key);
 		free(e->key);
 		free(e);
 	}
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index e8a933b5e6..768d356daa 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -148,7 +148,6 @@ static vine_msg_code_t handle_manager_status(struct vine_manager *q, struct vine
 static vine_msg_code_t handle_resources(struct vine_manager *q, struct vine_worker_info *w, time_t stoptime);
 static vine_msg_code_t handle_feature(struct vine_manager *q, struct vine_worker_info *w, const char *line);
 static void handle_library_update(struct vine_manager *q, struct vine_worker_info *w, const char *line);
-static int receive_tasks_from_worker(struct vine_manager *q, struct vine_worker_info *w, int count_received_so_far);
 
 static struct jx *manager_to_jx(struct vine_manager *q);
 static struct jx *manager_lean_to_jx(struct vine_manager *q);
@@ -700,7 +699,6 @@ static vine_msg_code_t handle_complete(struct vine_manager *q, struct vine_worke
 {
 	vine_result_code_t result = get_completion_result(q, w, line);
 	if (result == VINE_SUCCESS) {
-		receive_tasks_from_worker(q, w, 0);
 		return VINE_MSG_PROCESSED;
 	}
 	return VINE_MSG_NOT_PROCESSED;
@@ -737,7 +735,9 @@ static vine_msg_code_t vine_manager_recv_no_retry(struct vine_manager *q, struct
 			string_prefix_is(line, "wable_status") || string_prefix_is(line, "resources_status")) {
 		result = handle_manager_status(q, w, line, stoptime);
 	} else if (string_prefix_is(line, "available_results")) {
-		hash_table_insert(q->workers_with_watched_file_updates, w->hashkey, w);
+		if (!hash_table_lookup(q->workers_with_watched_file_updates, w->hashkey)) {
+			hash_table_insert(q->workers_with_watched_file_updates, w->hashkey, w);
+		}
 		result = VINE_MSG_PROCESSED;
 	} else if (string_prefix_is(line, "resources")) {
 		result = handle_resources(q, w, stoptime);

From fe470361630b6492d67381262c5fe7f555fdf833 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 6 Jan 2026 14:57:33 -0500
Subject: [PATCH 099/113] Add example target to Makefile for running
 example_blueprint

---
 taskvine/src/graph/Makefile      |   5 +-
 taskvine/src/graph/__init__.py   |  10 +
 taskvine/src/graph/high_level.py | 332 +++++++++++++++++++++++++++++++
 3 files changed, 346 insertions(+), 1 deletion(-)
 create mode 100644 taskvine/src/graph/__init__.py
 create mode 100644 taskvine/src/graph/high_level.py

diff --git a/taskvine/src/graph/Makefile b/taskvine/src/graph/Makefile
index c56a9f8090..50314300bc 100644
--- a/taskvine/src/graph/Makefile
+++ b/taskvine/src/graph/Makefile
@@ -8,4 +8,7 @@ all clean install test lint format: $(SUBDIRS)
 $(SUBDIRS): %:
 	$(MAKE) -C $@ $(MAKECMDGOALS)
 
-.PHONY: all clean install test lint format $(SUBDIRS)
+.PHONY: all clean install test lint format $(SUBDIRS) example
+
+example:
+	PYTHONPATH=../../../ python -m taskvine.src.graph.example_blueprint
diff --git a/taskvine/src/graph/__init__.py b/taskvine/src/graph/__init__.py
new file mode 100644
index 0000000000..0231025894
--- /dev/null
+++ b/taskvine/src/graph/__init__.py
@@ -0,0 +1,10 @@
+"""High-level blueprint graph interfaces."""
+
+from .high_level import BlueprintFile, BlueprintGraph, ReturnRef
+
+__all__ = [
+    "BlueprintFile",
+    "BlueprintGraph",
+    "ReturnRef",
+]
+
diff --git a/taskvine/src/graph/high_level.py b/taskvine/src/graph/high_level.py
new file mode 100644
index 0000000000..1a36dc8bb2
--- /dev/null
+++ b/taskvine/src/graph/high_level.py
@@ -0,0 +1,332 @@
+"""High-level blueprint graph for TaskVine DAG modelling."""
+
+from collections import defaultdict
+import uuid
+
+
+class ReturnRef:
+    """Reference to the return value (or sub-path) of another task."""
+
+    def __init__(self, node, path=()):
+        if node is None:
+            raise ValueError("node must not be None")
+        self.node = node
+        self.path = tuple(path)
+
+    def derive(self, *path):
+        return ReturnRef(self.node, self.path + tuple(path))
+
+    def __getitem__(self, item):
+        if isinstance(item, tuple):
+            return self.derive(*item)
+        return self.derive(item)
+
+class BlueprintFile:
+    """Describes a file that tasks may produce or consume."""
+
+    def __init__(self, name, **metadata):
+        if not name or not isinstance(name, str):
+            raise ValueError("File name must be a non-empty string")
+        self.name = name
+        self.metadata = dict(metadata)
+
+class BlueprintGraphTask:
+    """Represents a task node within the blueprint graph."""
+
+    def __init__(self, graph, func, args=None, kwargs=None, name=None):
+        self.graph = graph
+        self.func = func
+        self.name = name or graph._generate_task_name()
+        self.args = tuple(args) if args is not None else tuple()
+        self.kwargs = dict(kwargs) if kwargs is not None else {}
+        self.produced_files = []
+        self.consumed_files = []
+        self._return_ref = ReturnRef(self)
+
+    def produces(self, *files):
+        for file_obj in files:
+            file_obj = self.graph._ensure_file(file_obj)
+            self.graph._register_file_producer(self, file_obj)
+            if file_obj not in self.produced_files:
+                self.produced_files.append(file_obj)
+        return self
+
+    def consumes(self, *files):
+        for file_obj in files:
+            file_obj = self.graph._ensure_file(file_obj)
+            self.graph._register_file_consumer(self, file_obj)
+            if file_obj not in self.consumed_files:
+                self.consumed_files.append(file_obj)
+        return self
+
+    def ret(self):
+        return self._return_ref
+
+    def update_kwargs(self, **new_kwargs):
+        if not new_kwargs:
+            return self
+        merged = dict(self.kwargs)
+        merged.update(new_kwargs)
+        self.kwargs = merged
+        self.graph.invalidate()
+        return self
+
+class BlueprintGraph:
+    """Blueprint graph supporting ReturnRef and file dependencies."""
+
+    _SUPPORTED_SCALARS = (str, int, float, bool, type(None), bytes)
+    def __init__(self):
+        self._tasks = []
+        self._tasks_by_name = {}
+        self._return_edges = defaultdict(set)
+        self._files = {}
+        self._file_producer = {}
+        self._file_consumers = defaultdict(set)
+        self._dirty = True
+
+    def define_file(self, name, **metadata):
+        existing = self._files.get(name)
+        if existing:
+            existing.metadata.update(metadata)
+            return existing
+        file_obj = BlueprintFile(name, **metadata)
+        self._files[name] = file_obj
+        return file_obj
+
+    def task(self, func, *args, name=None, **kwargs):
+        task = BlueprintGraphTask(
+            self,
+            func,
+            args=args,
+            kwargs=kwargs,
+            name=name,
+        )
+        return self._register_task(task)
+
+    def nodes(self):
+        return list(self._tasks)
+
+    def file_links(self):
+        links = []
+        for file_name, consumers in self._file_consumers.items():
+            file_obj = self._files.get(file_name)
+            if file_obj is None:
+                continue
+            producer = self._file_producer.get(file_name)
+            for consumer in consumers:
+                links.append((producer, consumer, file_obj))
+        return links
+
+    def return_children(self, task):
+        task = self._ensure_task(task)
+        return set(self._return_edges.get(task, set()))
+
+    def invalidate(self):
+        self._dirty = True
+
+    def validate(self):
+        if self._dirty:
+            for task in self._tasks:
+                self._validate_supported_value(task.args, f"{task.name}.args")
+                self._validate_supported_value(task.kwargs, f"{task.name}.kwargs")
+                self._assert_no_returnref_in_keys(task.args, f"{task.name}.args")
+                self._assert_no_returnref_in_keys(task.kwargs, f"{task.name}.kwargs")
+            self._rebuild_return_edges()
+            self._dirty = False
+
+        missing_producers = [
+            file_name
+            for file_name, consumers in self._file_consumers.items()
+            if consumers and file_name not in self._file_producer
+        ]
+        if missing_producers:
+            raise ValueError(
+                f"Files consumed without producers: {', '.join(sorted(missing_producers))}"
+            )
+
+    def describe(self):
+        self.validate()
+        data = {
+            "tasks": {},
+            "return_links": [],
+            "file_links": [],
+            "files": {
+                name: dict(file_obj.metadata) for name, file_obj in self._files.items()
+            },
+        }
+        for task in self._tasks:
+            data["tasks"][task.name] = {
+                "func": getattr(task.func, "__name__", repr(task.func)),
+                "args": self._serialise(task.args),
+                "kwargs": self._serialise(task.kwargs),
+                "produces": [self._serialise_file(f) for f in task.produced_files],
+                "consumes": [self._serialise_file(f) for f in task.consumed_files],
+            }
+        for parent, children in self._return_edges.items():
+            for child in children:
+                data["return_links"].append(
+                    {
+                        "parent": parent.name,
+                        "child": child.name,
+                    }
+                )
+        for file_name, consumers in self._file_consumers.items():
+            file_obj = self._files.get(file_name)
+            if file_obj is None:
+                continue
+            producer = self._file_producer.get(file_name)
+            for consumer in consumers:
+                data["file_links"].append(
+                    {
+                        "parent": producer.name if producer else None,
+                        "child": consumer.name if consumer else None,
+                        "filename": file_obj.name,
+                        "metadata": dict(file_obj.metadata),
+                    }
+                )
+        return data
+
+    def _register_task(self, task):
+        canonical = self._tasks_by_name.get(task.name)
+        if canonical is not None:
+            raise ValueError(f"Task name '{task.name}' already registered")
+        self._tasks.append(task)
+        self._tasks_by_name[task.name] = task
+        self.invalidate()
+        return task
+
+    def _register_file_producer(self, task, file_obj):
+        task = self._ensure_task(task)
+        existing = self._file_producer.get(file_obj.name)
+        if existing and existing is not task:
+            raise ValueError(
+                f"File '{file_obj.name}' already produced by task '{existing.name}'"
+            )
+        self._file_producer[file_obj.name] = task
+        self.invalidate()
+
+    def _register_file_consumer(self, task, file_obj):
+        task = self._ensure_task(task)
+        self._file_consumers[file_obj.name].add(task)
+        self.invalidate()
+
+    def _ensure_file(self, file_obj):
+        if isinstance(file_obj, BlueprintFile):
+            existing = self._files.get(file_obj.name)
+            if existing:
+                existing.metadata.update(file_obj.metadata)
+                return existing
+            self._files[file_obj.name] = file_obj
+            return file_obj
+        if isinstance(file_obj, str):
+            existing = self._files.get(file_obj)
+            if not existing:
+                existing = BlueprintFile(file_obj)
+                self._files[file_obj] = existing
+            return existing
+        raise TypeError("File reference must be BlueprintFile or string name")
+
+    def _rebuild_return_edges(self):
+        self._return_edges.clear()
+        for task in self._tasks:
+            canonical_task = self._ensure_task(task)
+            parents = self._collect_return_refs(task.args) | self._collect_return_refs(task.kwargs)
+            for parent in parents:
+                canonical_parent = self._ensure_task(parent)
+                self._return_edges[canonical_parent].add(canonical_task)
+
+    def _collect_return_refs(self, value):
+        refs = set()
+        if isinstance(value, ReturnRef):
+            refs.add(value.node)
+        elif isinstance(value, (list, tuple, set, frozenset)):
+            for item in value:
+                refs |= self._collect_return_refs(item)
+        elif isinstance(value, dict):
+            for item in value.values():
+                refs |= self._collect_return_refs(item)
+        return refs
+
+    def _serialise(self, value):
+        if isinstance(value, ReturnRef):
+            return {
+                "type": "return_ref",
+                "node": value.node.name,
+                "path": list(value.path),
+            }
+        if isinstance(value, (list, tuple)):
+            return [self._serialise(item) for item in value]
+        if isinstance(value, (set, frozenset)):
+            items = [self._serialise(item) for item in value]
+            try:
+                return sorted(items, key=lambda x: str(x))
+            except TypeError:
+                return items
+        if isinstance(value, dict):
+            return {k: self._serialise(v) for k, v in value.items()}
+        return value
+
+    def _serialise_file(self, file_obj):
+        return {
+            "name": file_obj.name,
+            "metadata": dict(file_obj.metadata),
+        }
+
+    def _ensure_task(self, task):
+        name = task.name if isinstance(task, BlueprintGraphTask) else str(task)
+        canonical = self._tasks_by_name.get(name)
+        if canonical is None:
+            raise ValueError(f"Task '{name}' does not belong to this graph")
+        return canonical
+
+    def _generate_task_name(self):
+        return uuid.uuid4().hex
+
+    def _validate_supported_value(self, value, context, _seen=None):
+        if _seen is None:
+            _seen = set()
+        value_id = id(value)
+        if value_id in _seen:
+            return
+        _seen.add(value_id)
+
+        if isinstance(value, ReturnRef):
+            return
+        if isinstance(value, self._SUPPORTED_SCALARS):
+            return
+        if isinstance(value, (list, tuple, set, frozenset)):
+            for item in value:
+                self._validate_supported_value(item, context, _seen)
+            return
+        if isinstance(value, dict):
+            for item in value.values():
+                self._validate_supported_value(item, context, _seen)
+            return
+
+        raise TypeError(
+            f"Unsupported argument type '{type(value).__name__}' encountered in {context}. "
+            "Wrap custom objects in basic containers (dict/list/tuple/set) or convert them "
+            "to ReturnRef before building the graph."
+        )
+
+    def _assert_no_returnref_in_keys(self, value, context, _seen=None):
+        if _seen is None:
+            _seen = set()
+        value_id = id(value)
+        if value_id in _seen:
+            return
+        _seen.add(value_id)
+
+        if isinstance(value, dict):
+            for key, val in value.items():
+                if isinstance(key, ReturnRef):
+                    raise TypeError(
+                        f"ReturnRef cannot be used as a dict key in {context}"
+                    )
+                self._assert_no_returnref_in_keys(val, context, _seen)
+        elif isinstance(value, (list, tuple, set, frozenset)):
+            for item in value:
+                self._assert_no_returnref_in_keys(item, context, _seen)
+
+
+

From bc442cdb11ec53445ea32ee1711f4975d8ffaea1 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Tue, 6 Jan 2026 14:57:41 -0500
Subject: [PATCH 100/113] Add example target to Makefile for running
 example_blueprint

---
 taskvine/src/graph/example_blueprint.py | 80 +++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 taskvine/src/graph/example_blueprint.py

diff --git a/taskvine/src/graph/example_blueprint.py b/taskvine/src/graph/example_blueprint.py
new file mode 100644
index 0000000000..f5bd62322a
--- /dev/null
+++ b/taskvine/src/graph/example_blueprint.py
@@ -0,0 +1,80 @@
+"""Example blueprint graph using ReturnRef and file edges."""
+
+try:
+    from .high_level import BlueprintGraph
+except ImportError:  # Allow running as a standalone script
+    import os
+    import sys
+
+    CURRENT_DIR = os.path.dirname(os.path.abspath(__file__))
+    if CURRENT_DIR not in sys.path:
+        sys.path.insert(0, CURRENT_DIR)
+    from high_level import BlueprintGraph  # type: ignore
+
+
+def func_1(a, b, c):
+    with open("file1.txt", "w") as f:
+        f.write("Hello, world!")
+
+    with open("file2.txt", "w") as f:
+        f.write("Goodbye, world!")
+
+    return a + b + c
+
+
+def func_2(number):
+    with open("file1.txt", "r") as f:
+        contents1 = f.read()
+
+    with open("file2.txt", "r") as f:
+        contents2 = f.read()
+
+    return f"{contents1} {contents2} {number}"
+
+
+def build_blueprint_graph():
+    g = BlueprintGraph()
+
+    f1 = g.define_file("file1.txt", kind="intermediate")
+    f2 = g.define_file("file2.txt", kind="intermediate")
+
+    t1 = g.task(func_1, 1, 2, 3, name="task_a").produces(f1, f2)
+    t2 = g.task(func_2, t1.ret(), name="task_b").consumes(f1, f2)
+
+    return g
+
+def describe_graph(graph):
+    description = graph.describe()
+    print("Files:", {name: meta for name, meta in description["files"].items()})
+    for name, info in description["tasks"].items():
+        print(f"Node {name}:")
+        args = ", ".join(_format_arg(a) for a in info.get("args", []))
+        kwargs = ", ".join(f"{k}={_format_arg(v)}" for k, v in info.get("kwargs", {}).items())
+        produces = ", ".join(_format_arg(f) for f in info.get("produces", []))
+        consumes = ", ".join(_format_arg(f) for f in info.get("consumes", []))
+        print(f"  args     : {args or '-'}")
+        print(f"  kwargs   : {kwargs or '-'}")
+        print(f"  produces : {produces or '-'}")
+        print(f"  consumes : {consumes or '-'}")
+    print("Return links:", description["return_links"])
+    print("File links  :", description["file_links"])
+
+
+def _format_arg(value):
+    if isinstance(value, dict) and value.get("type") == "return_ref":
+        return f"ReturnRef({value['node']})"
+    if isinstance(value, list):
+        return "[" + ", ".join(_format_arg(v) for v in value) + "]"
+    if isinstance(value, set):
+        return "{" + ", ".join(_format_arg(v) for v in sorted(value, key=str)) + "}"
+    if isinstance(value, dict):
+        inner = ", ".join(f"{k}: {_format_arg(v)}" for k, v in value.items())
+        return "{" + inner + "}"
+    return str(value)
+
+
+if __name__ == "__main__":
+    graph = build_blueprint_graph()
+    describe_graph(graph)
+
+

From 747a64799584420a6fa6a0ed8e679b9b261eea7d Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Wed, 7 Jan 2026 15:20:09 -0500
Subject: [PATCH 101/113] temp

---
 taskvine/src/graph/__init__.py                |  10 -
 taskvine/src/graph/dagvine/Makefile           |   2 +-
 .../src/graph/dagvine/context_graph/core.py   |  16 +-
 .../dagvine/context_graph/proxy_functions.py  |   4 +-
 taskvine/src/graph/dagvine/dagvine.py         |  78 ++--
 taskvine/src/graph/example_blueprint.py       |  80 -----
 taskvine/src/graph/high_level.py              | 332 ------------------
 7 files changed, 59 insertions(+), 463 deletions(-)
 delete mode 100644 taskvine/src/graph/example_blueprint.py
 delete mode 100644 taskvine/src/graph/high_level.py

diff --git a/taskvine/src/graph/__init__.py b/taskvine/src/graph/__init__.py
index 0231025894..e69de29bb2 100644
--- a/taskvine/src/graph/__init__.py
+++ b/taskvine/src/graph/__init__.py
@@ -1,10 +0,0 @@
-"""High-level blueprint graph interfaces."""
-
-from .high_level import BlueprintFile, BlueprintGraph, ReturnRef
-
-__all__ = [
-    "BlueprintFile",
-    "BlueprintGraph",
-    "ReturnRef",
-]
-
diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index f40356744e..1bfc711036 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -2,7 +2,7 @@ include ../../../../config.mk
 include ../../../../rules.mk
 
 MODULE_DIR := $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
-SUBDIRS    := context_graph vine_graph
+SUBDIRS    := context_graph vine_graph blueprint_graph
 
 .PHONY: all install clean lint format $(SUBDIRS)
 
diff --git a/taskvine/src/graph/dagvine/context_graph/core.py b/taskvine/src/graph/dagvine/context_graph/core.py
index f01cd35596..9d0f3ac1c4 100644
--- a/taskvine/src/graph/dagvine/context_graph/core.py
+++ b/taskvine/src/graph/dagvine/context_graph/core.py
@@ -72,8 +72,8 @@ def __init__(self, task_dict,
         self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
 
         # these mappings are set after node ids are assigned in the C vine graph
-        self.ckey2vid = {}
-        self.vid2ckey = {}
+        self.pykey2cid = {}
+        self.cid2pykey = {}
 
         # will be set from vine graph
         self.outfile_remote_name = {key: None for key in self.task_dict.keys()}
@@ -181,15 +181,3 @@ def get_topological_order(self):
             raise ValueError("Failed to create topo order, the dependencies may be cyclic or problematic")
 
         return topo_order
-
-    @staticmethod
-    def context_loader_func(context_graph_pkl):
-        """Entry point the proxy library invokes to restore the serialized ContextGraph."""
-        context_graph = cloudpickle.loads(context_graph_pkl)
-
-        if not isinstance(context_graph, ContextGraph):
-            raise TypeError("context_graph_pkl is not of type ContextGraph")
-
-        return {
-            "context_graph": context_graph,
-        }
diff --git a/taskvine/src/graph/dagvine/context_graph/proxy_functions.py b/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
index c466e62576..db14b1c356 100644
--- a/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
+++ b/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
@@ -90,9 +90,9 @@ def compute_single_key(vine_key):
     After computation, the result is saved, the output file is validated, and
     an optional delay (`extra_sleep_time_of`) is applied before returning.
     """
-    context_graph = load_variable_from_library('context_graph')
+    context_graph = load_variable_from_library('graph')
 
-    k = context_graph.vid2ckey[vine_key]
+    k = context_graph.cid2pykey[vine_key]
     v = context_graph.task_dict[k]
 
     if context_graph.is_dts_key(k):
diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/dagvine/dagvine.py
index b8a51bc82d..e060dcbf3d 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -5,9 +5,9 @@
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.manager import Manager
 
-from ndcctools.taskvine.dagvine.context_graph.proxy_library import ProxyLibrary
-from ndcctools.taskvine.dagvine.context_graph.proxy_functions import compute_single_key
-from ndcctools.taskvine.dagvine.context_graph.core import ContextGraph, ContextGraphTaskResult
+from ndcctools.taskvine.dagvine.blueprint_graph.proxy_library import ProxyLibrary
+from ndcctools.taskvine.dagvine.blueprint_graph.proxy_functions import compute_single_key
+from ndcctools.taskvine.dagvine.blueprint_graph.blueprint_graph import BlueprintGraph, TaskOutputWrapper
 from ndcctools.taskvine.dagvine.vine_graph.vine_graph_client import VineGraphClient
 
 import cloudpickle
@@ -31,6 +31,14 @@
     dts = None
 
 
+def context_loader_func(graph_pkl):
+    graph = cloudpickle.loads(graph_pkl)
+
+    return {
+        "graph": graph,
+    }
+
+
 def delete_all_files(root_dir):
     """Clean the run-info template directory between runs so stale files never leak into a new DAG."""
     if not os.path.exists(root_dir):
@@ -81,7 +89,7 @@ def dask_collections_to_task_dict(collection_dict):
 # hand us `{key: delayed / value}` directly, while some experiments pass a
 # fully-expanded legacy Dask dict. This helper normalises both cases so the rest
 # of the pipeline only deals with `{task_key: task_expression}`.
-def ensure_task_dict(collection_dict):
+def normalize_task_dict(collection_dict):
     """Normalize user input (raw dict or Dask collection) into a plain `{task_key: expr}` mapping."""
     if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
         task_dict = dask_collections_to_task_dict(collection_dict)
@@ -223,9 +231,27 @@ def build_context_graph(self, task_dict):
 
         return context_graph
 
-    def build_vine_graph(self, context_graph, target_keys):
-        """Mirror the ContextGraph into VineGraph, preserving ordering and targets."""
-        assert context_graph is not None, "ContextGraph must be built before building the VineGraph"
+    def build_blueprint_graph(self, task_dict):
+        def _unpack_sexpr(sexpr):
+            func = sexpr[0]
+            tail = sexpr[1:]
+            if tail and isinstance(tail[-1], dict):
+                return func, tail[:-1], tail[-1]
+            else:
+                return func, tail, {}
+
+        bg = BlueprintGraph()
+
+        for k, v in task_dict.items():
+            func, args, kwargs = _unpack_sexpr(v)
+            assert callable(func), f"Task {k} does not have a callable"
+            bg.add_task(k, func, *args, **kwargs)
+
+        return bg
+
+    def build_vine_graph(self, py_graph, target_keys):
+        """Mirror the Python graph into VineGraph, preserving ordering and targets."""
+        assert py_graph is not None, "Python graph must be built before building the VineGraph"
 
         vine_graph = VineGraphClient(self._taskvine)
 
@@ -235,13 +261,14 @@ def build_vine_graph(self, context_graph, target_keys):
         self.tune_manager()
         self.tune_vine_graph(vine_graph)
 
-        topo_order = context_graph.get_topological_order()
+        topo_order = py_graph.get_topological_order()
+
         # Build the cross-language mapping as we walk the topo order.
         for k in topo_order:
             node_id = vine_graph.add_node(k)
-            context_graph.ckey2vid[k] = node_id
-            context_graph.vid2ckey[node_id] = k
-            for pk in context_graph.parents_of[k]:
+            py_graph.pykey2cid[k] = node_id
+            py_graph.cid2pykey[node_id] = k
+            for pk in py_graph.parents_of[k]:
                 vine_graph.add_dependency(pk, k)
 
         # Now that every node is present, mark which ones are final outputs.
@@ -252,26 +279,29 @@ def build_vine_graph(self, context_graph, target_keys):
 
         return vine_graph
 
-    def build_graphs(self, task_dict, target_keys):
+    def build_graphs(self, task_dict, target_keys, blueprint_graph=False):
         """Create both the ContextGraph and its C counterpart, wiring outputs for later use."""
         # Build the logical (Python) DAG.
-        context_graph = self.build_context_graph(task_dict)
+        if blueprint_graph == False:
+            py_graph = self.build_context_graph(task_dict)
+        else:
+            py_graph = self.build_blueprint_graph(task_dict)
         # Build the physical (C) DAG.
-        vine_graph = self.build_vine_graph(context_graph, target_keys)
+        vine_graph = self.build_vine_graph(py_graph, target_keys)
 
         # Cross-fill the outfile locations so the runtime graph knows where to read/write.
-        for k in context_graph.ckey2vid:
+        for k in py_graph.pykey2cid:
             outfile_remote_name = vine_graph.get_node_outfile_remote_name(k)
-            context_graph.outfile_remote_name[k] = outfile_remote_name
+            py_graph.outfile_remote_name[k] = outfile_remote_name
 
-        return context_graph, vine_graph
+        return py_graph, vine_graph
 
-    def create_proxy_library(self, context_graph, vine_graph, hoisting_modules, env_files):
+    def create_proxy_library(self, py_graph, vine_graph, hoisting_modules, env_files):
         """Package up the context_graph as a TaskVine library."""
         proxy_library = ProxyLibrary(self)
         proxy_library.add_hoisting_modules(hoisting_modules)
         proxy_library.add_env_files(env_files)
-        proxy_library.set_context_loader(ContextGraph.context_loader_func, context_loader_args=[cloudpickle.dumps(context_graph)])
+        proxy_library.set_context_loader(context_loader_func, context_loader_args=[cloudpickle.dumps(py_graph)])
         proxy_library.set_libcores(self.param("libcores"))
         proxy_library.set_name(vine_graph.get_proxy_library_name())
 
@@ -290,13 +320,13 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
                 print(f"             {k}")
         target_keys = list(set(target_keys) - set(missing_keys))
 
-        task_dict = ensure_task_dict(collection_dict)
+        task_dict = normalize_task_dict(collection_dict)
 
         # Build both the Python DAG and its C mirror.
-        context_graph, vine_graph = self.build_graphs(task_dict, target_keys)
+        py_graph, vine_graph = self.build_graphs(task_dict, target_keys, blueprint_graph=True)
 
         # Ship the execution context to workers via a proxy library.
-        proxy_library = self.create_proxy_library(context_graph, vine_graph, hoisting_modules, env_files)
+        proxy_library = self.create_proxy_library(py_graph, vine_graph, hoisting_modules, env_files)
         proxy_library.install()
 
         print(f"=== Library serialized size: {color_text(proxy_library.get_context_size(), 92)} MB")
@@ -313,8 +343,8 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
         # Load any requested target outputs back into Python land.
         results = {}
         for k in target_keys:
-            outfile_path = os.path.join(self.param("output-dir"), context_graph.outfile_remote_name[k])
-            results[k] = ContextGraphTaskResult.load_from_path(outfile_path)
+            outfile_path = os.path.join(self.param("output-dir"), py_graph.outfile_remote_name[k])
+            results[k] = TaskOutputWrapper.load_from_path(outfile_path)
         return results
 
     def _on_sigint(self, signum, frame):
diff --git a/taskvine/src/graph/example_blueprint.py b/taskvine/src/graph/example_blueprint.py
deleted file mode 100644
index f5bd62322a..0000000000
--- a/taskvine/src/graph/example_blueprint.py
+++ /dev/null
@@ -1,80 +0,0 @@
-"""Example blueprint graph using ReturnRef and file edges."""
-
-try:
-    from .high_level import BlueprintGraph
-except ImportError:  # Allow running as a standalone script
-    import os
-    import sys
-
-    CURRENT_DIR = os.path.dirname(os.path.abspath(__file__))
-    if CURRENT_DIR not in sys.path:
-        sys.path.insert(0, CURRENT_DIR)
-    from high_level import BlueprintGraph  # type: ignore
-
-
-def func_1(a, b, c):
-    with open("file1.txt", "w") as f:
-        f.write("Hello, world!")
-
-    with open("file2.txt", "w") as f:
-        f.write("Goodbye, world!")
-
-    return a + b + c
-
-
-def func_2(number):
-    with open("file1.txt", "r") as f:
-        contents1 = f.read()
-
-    with open("file2.txt", "r") as f:
-        contents2 = f.read()
-
-    return f"{contents1} {contents2} {number}"
-
-
-def build_blueprint_graph():
-    g = BlueprintGraph()
-
-    f1 = g.define_file("file1.txt", kind="intermediate")
-    f2 = g.define_file("file2.txt", kind="intermediate")
-
-    t1 = g.task(func_1, 1, 2, 3, name="task_a").produces(f1, f2)
-    t2 = g.task(func_2, t1.ret(), name="task_b").consumes(f1, f2)
-
-    return g
-
-def describe_graph(graph):
-    description = graph.describe()
-    print("Files:", {name: meta for name, meta in description["files"].items()})
-    for name, info in description["tasks"].items():
-        print(f"Node {name}:")
-        args = ", ".join(_format_arg(a) for a in info.get("args", []))
-        kwargs = ", ".join(f"{k}={_format_arg(v)}" for k, v in info.get("kwargs", {}).items())
-        produces = ", ".join(_format_arg(f) for f in info.get("produces", []))
-        consumes = ", ".join(_format_arg(f) for f in info.get("consumes", []))
-        print(f"  args     : {args or '-'}")
-        print(f"  kwargs   : {kwargs or '-'}")
-        print(f"  produces : {produces or '-'}")
-        print(f"  consumes : {consumes or '-'}")
-    print("Return links:", description["return_links"])
-    print("File links  :", description["file_links"])
-
-
-def _format_arg(value):
-    if isinstance(value, dict) and value.get("type") == "return_ref":
-        return f"ReturnRef({value['node']})"
-    if isinstance(value, list):
-        return "[" + ", ".join(_format_arg(v) for v in value) + "]"
-    if isinstance(value, set):
-        return "{" + ", ".join(_format_arg(v) for v in sorted(value, key=str)) + "}"
-    if isinstance(value, dict):
-        inner = ", ".join(f"{k}: {_format_arg(v)}" for k, v in value.items())
-        return "{" + inner + "}"
-    return str(value)
-
-
-if __name__ == "__main__":
-    graph = build_blueprint_graph()
-    describe_graph(graph)
-
-
diff --git a/taskvine/src/graph/high_level.py b/taskvine/src/graph/high_level.py
deleted file mode 100644
index 1a36dc8bb2..0000000000
--- a/taskvine/src/graph/high_level.py
+++ /dev/null
@@ -1,332 +0,0 @@
-"""High-level blueprint graph for TaskVine DAG modelling."""
-
-from collections import defaultdict
-import uuid
-
-
-class ReturnRef:
-    """Reference to the return value (or sub-path) of another task."""
-
-    def __init__(self, node, path=()):
-        if node is None:
-            raise ValueError("node must not be None")
-        self.node = node
-        self.path = tuple(path)
-
-    def derive(self, *path):
-        return ReturnRef(self.node, self.path + tuple(path))
-
-    def __getitem__(self, item):
-        if isinstance(item, tuple):
-            return self.derive(*item)
-        return self.derive(item)
-
-class BlueprintFile:
-    """Describes a file that tasks may produce or consume."""
-
-    def __init__(self, name, **metadata):
-        if not name or not isinstance(name, str):
-            raise ValueError("File name must be a non-empty string")
-        self.name = name
-        self.metadata = dict(metadata)
-
-class BlueprintGraphTask:
-    """Represents a task node within the blueprint graph."""
-
-    def __init__(self, graph, func, args=None, kwargs=None, name=None):
-        self.graph = graph
-        self.func = func
-        self.name = name or graph._generate_task_name()
-        self.args = tuple(args) if args is not None else tuple()
-        self.kwargs = dict(kwargs) if kwargs is not None else {}
-        self.produced_files = []
-        self.consumed_files = []
-        self._return_ref = ReturnRef(self)
-
-    def produces(self, *files):
-        for file_obj in files:
-            file_obj = self.graph._ensure_file(file_obj)
-            self.graph._register_file_producer(self, file_obj)
-            if file_obj not in self.produced_files:
-                self.produced_files.append(file_obj)
-        return self
-
-    def consumes(self, *files):
-        for file_obj in files:
-            file_obj = self.graph._ensure_file(file_obj)
-            self.graph._register_file_consumer(self, file_obj)
-            if file_obj not in self.consumed_files:
-                self.consumed_files.append(file_obj)
-        return self
-
-    def ret(self):
-        return self._return_ref
-
-    def update_kwargs(self, **new_kwargs):
-        if not new_kwargs:
-            return self
-        merged = dict(self.kwargs)
-        merged.update(new_kwargs)
-        self.kwargs = merged
-        self.graph.invalidate()
-        return self
-
-class BlueprintGraph:
-    """Blueprint graph supporting ReturnRef and file dependencies."""
-
-    _SUPPORTED_SCALARS = (str, int, float, bool, type(None), bytes)
-    def __init__(self):
-        self._tasks = []
-        self._tasks_by_name = {}
-        self._return_edges = defaultdict(set)
-        self._files = {}
-        self._file_producer = {}
-        self._file_consumers = defaultdict(set)
-        self._dirty = True
-
-    def define_file(self, name, **metadata):
-        existing = self._files.get(name)
-        if existing:
-            existing.metadata.update(metadata)
-            return existing
-        file_obj = BlueprintFile(name, **metadata)
-        self._files[name] = file_obj
-        return file_obj
-
-    def task(self, func, *args, name=None, **kwargs):
-        task = BlueprintGraphTask(
-            self,
-            func,
-            args=args,
-            kwargs=kwargs,
-            name=name,
-        )
-        return self._register_task(task)
-
-    def nodes(self):
-        return list(self._tasks)
-
-    def file_links(self):
-        links = []
-        for file_name, consumers in self._file_consumers.items():
-            file_obj = self._files.get(file_name)
-            if file_obj is None:
-                continue
-            producer = self._file_producer.get(file_name)
-            for consumer in consumers:
-                links.append((producer, consumer, file_obj))
-        return links
-
-    def return_children(self, task):
-        task = self._ensure_task(task)
-        return set(self._return_edges.get(task, set()))
-
-    def invalidate(self):
-        self._dirty = True
-
-    def validate(self):
-        if self._dirty:
-            for task in self._tasks:
-                self._validate_supported_value(task.args, f"{task.name}.args")
-                self._validate_supported_value(task.kwargs, f"{task.name}.kwargs")
-                self._assert_no_returnref_in_keys(task.args, f"{task.name}.args")
-                self._assert_no_returnref_in_keys(task.kwargs, f"{task.name}.kwargs")
-            self._rebuild_return_edges()
-            self._dirty = False
-
-        missing_producers = [
-            file_name
-            for file_name, consumers in self._file_consumers.items()
-            if consumers and file_name not in self._file_producer
-        ]
-        if missing_producers:
-            raise ValueError(
-                f"Files consumed without producers: {', '.join(sorted(missing_producers))}"
-            )
-
-    def describe(self):
-        self.validate()
-        data = {
-            "tasks": {},
-            "return_links": [],
-            "file_links": [],
-            "files": {
-                name: dict(file_obj.metadata) for name, file_obj in self._files.items()
-            },
-        }
-        for task in self._tasks:
-            data["tasks"][task.name] = {
-                "func": getattr(task.func, "__name__", repr(task.func)),
-                "args": self._serialise(task.args),
-                "kwargs": self._serialise(task.kwargs),
-                "produces": [self._serialise_file(f) for f in task.produced_files],
-                "consumes": [self._serialise_file(f) for f in task.consumed_files],
-            }
-        for parent, children in self._return_edges.items():
-            for child in children:
-                data["return_links"].append(
-                    {
-                        "parent": parent.name,
-                        "child": child.name,
-                    }
-                )
-        for file_name, consumers in self._file_consumers.items():
-            file_obj = self._files.get(file_name)
-            if file_obj is None:
-                continue
-            producer = self._file_producer.get(file_name)
-            for consumer in consumers:
-                data["file_links"].append(
-                    {
-                        "parent": producer.name if producer else None,
-                        "child": consumer.name if consumer else None,
-                        "filename": file_obj.name,
-                        "metadata": dict(file_obj.metadata),
-                    }
-                )
-        return data
-
-    def _register_task(self, task):
-        canonical = self._tasks_by_name.get(task.name)
-        if canonical is not None:
-            raise ValueError(f"Task name '{task.name}' already registered")
-        self._tasks.append(task)
-        self._tasks_by_name[task.name] = task
-        self.invalidate()
-        return task
-
-    def _register_file_producer(self, task, file_obj):
-        task = self._ensure_task(task)
-        existing = self._file_producer.get(file_obj.name)
-        if existing and existing is not task:
-            raise ValueError(
-                f"File '{file_obj.name}' already produced by task '{existing.name}'"
-            )
-        self._file_producer[file_obj.name] = task
-        self.invalidate()
-
-    def _register_file_consumer(self, task, file_obj):
-        task = self._ensure_task(task)
-        self._file_consumers[file_obj.name].add(task)
-        self.invalidate()
-
-    def _ensure_file(self, file_obj):
-        if isinstance(file_obj, BlueprintFile):
-            existing = self._files.get(file_obj.name)
-            if existing:
-                existing.metadata.update(file_obj.metadata)
-                return existing
-            self._files[file_obj.name] = file_obj
-            return file_obj
-        if isinstance(file_obj, str):
-            existing = self._files.get(file_obj)
-            if not existing:
-                existing = BlueprintFile(file_obj)
-                self._files[file_obj] = existing
-            return existing
-        raise TypeError("File reference must be BlueprintFile or string name")
-
-    def _rebuild_return_edges(self):
-        self._return_edges.clear()
-        for task in self._tasks:
-            canonical_task = self._ensure_task(task)
-            parents = self._collect_return_refs(task.args) | self._collect_return_refs(task.kwargs)
-            for parent in parents:
-                canonical_parent = self._ensure_task(parent)
-                self._return_edges[canonical_parent].add(canonical_task)
-
-    def _collect_return_refs(self, value):
-        refs = set()
-        if isinstance(value, ReturnRef):
-            refs.add(value.node)
-        elif isinstance(value, (list, tuple, set, frozenset)):
-            for item in value:
-                refs |= self._collect_return_refs(item)
-        elif isinstance(value, dict):
-            for item in value.values():
-                refs |= self._collect_return_refs(item)
-        return refs
-
-    def _serialise(self, value):
-        if isinstance(value, ReturnRef):
-            return {
-                "type": "return_ref",
-                "node": value.node.name,
-                "path": list(value.path),
-            }
-        if isinstance(value, (list, tuple)):
-            return [self._serialise(item) for item in value]
-        if isinstance(value, (set, frozenset)):
-            items = [self._serialise(item) for item in value]
-            try:
-                return sorted(items, key=lambda x: str(x))
-            except TypeError:
-                return items
-        if isinstance(value, dict):
-            return {k: self._serialise(v) for k, v in value.items()}
-        return value
-
-    def _serialise_file(self, file_obj):
-        return {
-            "name": file_obj.name,
-            "metadata": dict(file_obj.metadata),
-        }
-
-    def _ensure_task(self, task):
-        name = task.name if isinstance(task, BlueprintGraphTask) else str(task)
-        canonical = self._tasks_by_name.get(name)
-        if canonical is None:
-            raise ValueError(f"Task '{name}' does not belong to this graph")
-        return canonical
-
-    def _generate_task_name(self):
-        return uuid.uuid4().hex
-
-    def _validate_supported_value(self, value, context, _seen=None):
-        if _seen is None:
-            _seen = set()
-        value_id = id(value)
-        if value_id in _seen:
-            return
-        _seen.add(value_id)
-
-        if isinstance(value, ReturnRef):
-            return
-        if isinstance(value, self._SUPPORTED_SCALARS):
-            return
-        if isinstance(value, (list, tuple, set, frozenset)):
-            for item in value:
-                self._validate_supported_value(item, context, _seen)
-            return
-        if isinstance(value, dict):
-            for item in value.values():
-                self._validate_supported_value(item, context, _seen)
-            return
-
-        raise TypeError(
-            f"Unsupported argument type '{type(value).__name__}' encountered in {context}. "
-            "Wrap custom objects in basic containers (dict/list/tuple/set) or convert them "
-            "to ReturnRef before building the graph."
-        )
-
-    def _assert_no_returnref_in_keys(self, value, context, _seen=None):
-        if _seen is None:
-            _seen = set()
-        value_id = id(value)
-        if value_id in _seen:
-            return
-        _seen.add(value_id)
-
-        if isinstance(value, dict):
-            for key, val in value.items():
-                if isinstance(key, ReturnRef):
-                    raise TypeError(
-                        f"ReturnRef cannot be used as a dict key in {context}"
-                    )
-                self._assert_no_returnref_in_keys(val, context, _seen)
-        elif isinstance(value, (list, tuple, set, frozenset)):
-            for item in value:
-                self._assert_no_returnref_in_keys(item, context, _seen)
-
-
-

From 97993b4c14d86c28618f78cbaa941854fd0d12b6 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 02:40:36 -0500
Subject: [PATCH 102/113] support new dask expr

---
 .../graph/dagvine/blueprint_graph/Makefile    |  31 +
 .../graph/dagvine/blueprint_graph/__init__.py |  16 +
 .../graph/dagvine/blueprint_graph/adaptor.py  | 568 ++++++++++++++++++
 .../dagvine/blueprint_graph/adaptor_test.py   | 528 ++++++++++++++++
 .../blueprint_graph/blueprint_graph.py        | 197 ++++++
 .../blueprint_graph/proxy_functions.py        |  51 ++
 .../dagvine/blueprint_graph/proxy_library.py  |  94 +++
 taskvine/src/graph/dagvine/dagvine.py         |  74 +--
 8 files changed, 1489 insertions(+), 70 deletions(-)
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/Makefile
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/__init__.py
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/proxy_library.py

diff --git a/taskvine/src/graph/dagvine/blueprint_graph/Makefile b/taskvine/src/graph/dagvine/blueprint_graph/Makefile
new file mode 100644
index 0000000000..55bbb1c5e4
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/Makefile
@@ -0,0 +1,31 @@
+include ../../../../../config.mk
+include ../../../../../rules.mk
+
+PROJECT_NAME = dagvine
+
+SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)/blueprint_graph
+MODULE_ROOT = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
+MODULE_DIR = $(MODULE_ROOT)/blueprint_graph
+
+PY_SOURCES = $(wildcard $(SOURCE_DIR)/*.py)
+
+.PHONY: all install clean lint format
+
+all:
+	@true
+
+install:
+	mkdir -p $(MODULE_DIR)
+	cp $(PY_SOURCES) $(MODULE_DIR)
+
+clean:
+	rm -rf __pycache__
+
+lint:
+	flake8 --ignore=$(CCTOOLS_FLAKE8_IGNORE_ERRORS) \
+		--exclude=$(CCTOOLS_FLAKE8_IGNORE_FILES) \
+		$(SOURCE_DIR)/
+
+format:
+	@true
+
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/__init__.py b/taskvine/src/graph/dagvine/blueprint_graph/__init__.py
new file mode 100644
index 0000000000..f8282164a7
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/__init__.py
@@ -0,0 +1,16 @@
+# Copyright (C) 2025 The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+
+from .blueprint_graph import BlueprintGraph, TaskOutputRef, TaskOutputWrapper
+from .proxy_functions import compute_single_key
+from .adaptor import Adaptor
+
+__all__ = [
+    "BlueprintGraph",
+    "TaskOutputRef",
+    "TaskOutputWrapper",
+    "compute_single_key",
+    "Adaptor",
+]
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py b/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
new file mode 100644
index 0000000000..3f5db28243
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
@@ -0,0 +1,568 @@
+from collections.abc import Mapping
+
+try:
+    import dask
+except ImportError:
+    dask = None
+
+try:
+    from dask.base import is_dask_collection
+except ImportError:
+    is_dask_collection = None
+
+try:
+    import importlib
+
+    dts = importlib.import_module("dask._task_spec")
+except Exception:
+    # Treat any import failure as "no TaskSpec support" (including environments
+    # where the private module is unavailable or type-checkers can't resolve it).
+    dts = None
+
+from ndcctools.taskvine.dagvine.blueprint_graph.blueprint_graph import TaskOutputRef
+
+
+def _identity(value):
+    """Tiny helper that just hands back whatever you pass in (e.g. `_identity(3)` -> 3)."""
+    return value
+
+
+class Adaptor:
+    """Normalize user task inputs so `BlueprintGraph` can consume them without extra massaging."""
+
+    _LEAF_TYPES = (str, bytes, bytearray, memoryview, int, float, bool, type(None))
+
+    def __init__(self, collection_dict):
+        self.original_collection_dict = collection_dict
+
+        # TaskSpec-only state used to "lift" inline Tasks that cannot be reduced to
+        # a pure Python value (or would be unsafe/expensive to inline).
+        self._lifted_nodes = {}
+        self._lift_cache = {}
+        self._lift_counter = 0
+        # Global shared key-set for the whole adaptation run (original keys + lifted keys).
+        # IMPORTANT: TaskSpec conversion must always consult the same shared set so that
+        # lifted keys remain visible across subsequent conversions/dedup/reference checks.
+        self._task_keys = set()
+
+        normalized = self._normalize_task_dict(collection_dict)
+        self.task_dict = self._convert_to_blueprint_tasks(normalized)
+
+    def _normalize_task_dict(self, collection_dict):
+        """Collapse every supported input style into a classic `{key: sexpr or TaskSpec}` mapping."""
+        from_dask_collection = bool(
+            is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values())
+        )
+
+        if from_dask_collection:
+            task_dict = self._dask_collections_to_task_dict(collection_dict)
+        else:
+            # IMPORTANT: treat plain user dicts as DAGVine sexprs by default.
+            # If we unconditionally run `dask._task_spec.convert_legacy_graph(...)` when
+            # dts is available, Dask will interpret our "final Mapping is kwargs"
+            # convention as a positional dict argument, breaking sexpr semantics.
+            task_dict = dict(collection_dict)
+
+        # Only ask Dask to rewrite legacy graphs when we *know* the input came
+        # from a Dask collection/HLG. This keeps classic DAGVine sexprs stable
+        # even in environments where dask._task_spec is installed.
+        if from_dask_collection and dts and hasattr(dts, "convert_legacy_graph"):
+            task_dict = dts.convert_legacy_graph(task_dict)
+
+        return task_dict
+
+    def _convert_to_blueprint_tasks(self, task_dict):
+        """Turn each normalized entry into the `(func, args, kwargs)` triple that BlueprintGraph expects."""
+        if not task_dict:
+            return {}
+
+        converted = {}
+        # Shared task key universe for TaskSpec lifting/dedup/reference decisions.
+        # Keep this as a single shared set for the whole conversion.
+        self._task_keys = set(task_dict.keys())
+        task_keys = self._task_keys
+
+        for key, value in task_dict.items():
+            if self._is_dts_node(value):
+                converted[key] = self._convert_dts_graph_node(key, value, task_keys)
+            else:
+                converted[key] = self._convert_sexpr_task(value, task_keys)
+
+        # If any inline TaskSpec Tasks were lifted during conversion, convert them too.
+        # We do this iteratively because lifting a node can expose further inline Tasks.
+        while True:
+            pending = [(k, v) for k, v in self._lifted_nodes.items() if k not in converted]
+            if not pending:
+                break
+            for k, node in pending:
+                converted[k] = self._convert_dts_graph_node(k, node, task_keys)
+
+        return converted
+
+    def _convert_dts_graph_node(self, key, node, task_keys):
+        """Translate modern Dask TaskSpec graph nodes into blueprint expressions."""
+        if not dts:
+            raise RuntimeError("Dask TaskSpec support unavailable: dask._task_spec is not installed")
+
+        task_cls = getattr(dts, "Task", None)
+        alias_cls = getattr(dts, "Alias", None)
+        literal_cls = getattr(dts, "Literal", None)
+        datanode_cls = getattr(dts, "DataNode", None)
+        nested_cls = getattr(dts, "NestedContainer", None)
+        taskref_cls = getattr(dts, "TaskRef", None)
+
+        if task_cls and isinstance(node, task_cls):
+            func = self._extract_callable_from_task(node)
+            if func is None:
+                raise TypeError(f"Task {key} is missing a callable function/op attribute")
+
+            raw_args = getattr(node, "args", ()) or ()
+            raw_kwargs = getattr(node, "kwargs", {}) or {}
+
+            args = []
+            try:
+                for i, arg in enumerate(raw_args):
+                    args.append(self._unwrap_dts_operand(arg, task_keys, parent_key=key))
+            except Exception as e:
+                raise TypeError(
+                    "Failed to adapt TaskSpec node argument while converting to BlueprintGraph.\n"
+                    f"- parent_task_key: {key!r}\n"
+                    f"- func: {self._safe_repr(func)}\n"
+                    f"- arg_index: {i}\n"
+                    f"- arg_value: {self._safe_repr(arg)}\n"
+                    f"- raw_args: {self._safe_repr(raw_args)}\n"
+                    f"- raw_kwargs: {self._safe_repr(raw_kwargs)}"
+                ) from e
+
+            kwargs = {}
+            try:
+                for k, v in raw_kwargs.items():
+                    kwargs[k] = self._unwrap_dts_operand(v, task_keys, parent_key=key)
+            except Exception as e:
+                raise TypeError(
+                    "Failed to adapt TaskSpec node kwarg while converting to BlueprintGraph.\n"
+                    f"- parent_task_key: {key!r}\n"
+                    f"- func: {self._safe_repr(func)}\n"
+                    f"- kwarg_key: {k!r}\n"
+                    f"- kwarg_value: {self._safe_repr(v)}\n"
+                    f"- raw_args: {self._safe_repr(raw_args)}\n"
+                    f"- raw_kwargs: {self._safe_repr(raw_kwargs)}"
+                ) from e
+
+            return self._build_expr(func, args, kwargs)
+
+        if alias_cls and isinstance(node, alias_cls):
+            alias_ref = self._extract_alias_target(node, task_keys)
+            if alias_ref is None:
+                raise ValueError(f"Alias {key} is missing a resolvable upstream task")
+            return self._build_expr(_identity, [alias_ref], {})
+
+        if datanode_cls and isinstance(node, datanode_cls):
+            return self._build_expr(_identity, [node.value], {})
+
+        if literal_cls and isinstance(node, literal_cls):
+            return self._build_expr(_identity, [node.value], {})
+
+        if taskref_cls and isinstance(node, taskref_cls):
+            ref = TaskOutputRef(node.key, getattr(node, "path", ()) or ())
+            return self._build_expr(_identity, [ref], {})
+
+        if nested_cls and isinstance(node, nested_cls):
+            payload = getattr(node, "value", None)
+            if payload is None:
+                payload = getattr(node, "data", None)
+            value = self._unwrap_dts_operand(payload, task_keys, parent_key=key)
+            return self._build_expr(_identity, [value], {})
+
+        return self._build_expr(_identity, [node], {})
+
+    def _convert_sexpr_task(self, sexpr, task_keys):
+        """Handle legacy sexpr-style nodes by replacing embedded task keys with `TaskOutputRef`."""
+        if not isinstance(sexpr, (list, tuple)) or not sexpr:
+            raise TypeError(f"Task definition must be a non-empty tuple/list, got {type(sexpr)}")
+
+        func = sexpr[0]
+        tail = sexpr[1:]
+
+        if tail and isinstance(tail[-1], Mapping):
+            raw_args, raw_kwargs = tail[:-1], tail[-1]
+        else:
+            raw_args, raw_kwargs = tail, {}
+
+        args = tuple(self._wrap_dependency(arg, task_keys) for arg in raw_args)
+        kwargs = {k: self._wrap_dependency(v, task_keys) for k, v in raw_kwargs.items()}
+
+        return func, args, kwargs
+
+    def _wrap_dependency(self, obj, task_keys):
+        """Wrap nested objects inside a sexpr when they point at other tasks."""
+        if isinstance(obj, TaskOutputRef):
+            return obj
+
+        if self._should_wrap(obj, task_keys):
+            return TaskOutputRef(obj)
+
+        if isinstance(obj, list):
+            return [self._wrap_dependency(v, task_keys) for v in obj]
+
+        if isinstance(obj, tuple):
+            if obj and callable(obj[0]):
+                head = obj[0]
+                tail = tuple(self._wrap_dependency(v, task_keys) for v in obj[1:])
+                return (head, *tail)
+            return tuple(self._wrap_dependency(v, task_keys) for v in obj)
+
+        if isinstance(obj, Mapping):
+            return {k: self._wrap_dependency(v, task_keys) for k, v in obj.items()}
+
+        if isinstance(obj, set):
+            return {self._wrap_dependency(v, task_keys) for v in obj}
+
+        if isinstance(obj, frozenset):
+            return frozenset(self._wrap_dependency(v, task_keys) for v in obj)
+
+        return obj
+
+    def _should_wrap(self, obj, task_keys):
+        """Decide whether a value should become a `TaskOutputRef`."""
+        if isinstance(obj, self._LEAF_TYPES):
+            if isinstance(obj, str):
+                return obj in task_keys
+            return False
+        try:
+            return obj in task_keys
+        except TypeError:
+            return False
+
+    # Flatten Dask collections into the dict-of-tasks structure the rest of the
+    # pipeline expects. DAGVine clients often hand us a dict like
+    # {"result": dask.delayed(...)}; we merge the underlying HighLevelGraphs so
+    # `ContextGraph` sees the same dict representation C does.
+    def _dask_collections_to_task_dict(self, collection_dict):
+        """Flatten Dask collections into the classic dict-of-task layout."""
+        assert is_dask_collection is not None
+        from dask.highlevelgraph import HighLevelGraph, ensure_dict
+
+        if not isinstance(collection_dict, dict):
+            raise TypeError("Input must be a dict")
+
+        for k, v in collection_dict.items():
+            if not is_dask_collection(v):
+                raise TypeError(
+                    f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}"
+                )
+
+        if dts:
+            sub_hlgs = [v.dask for v in collection_dict.values()]
+            hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
+        else:
+            hlg = dask.base.collections_to_dsk(collection_dict.values())
+
+        return ensure_dict(hlg)
+
+    def _is_dts_node(self, value):
+        """Return True when the value is part of the TaskSpec family."""
+        if not dts:
+            return False
+        try:
+            return isinstance(value, dts.GraphNode)
+        except AttributeError:
+            return False
+
+    def _unwrap_dts_operand(self, operand, task_keys, *, parent_key=None):
+        """Recursively unwrap TaskSpec operands into pure Python values/containers and `TaskOutputRef`.
+
+        Contract (TaskSpec path only):
+        - TaskRef/Alias become `TaskOutputRef` (references, never lifted).
+        - Literals/DataNode become plain Python values.
+        - NestedContainer unwraps recursively.
+        - Task inside args/kwargs is either:
+          - treated as a reference when it has a top-level key, or
+          - reduced to a pure value only for a small "pure constructor/identity" whitelist, or
+          - lifted into a new top-level node and replaced with `TaskOutputRef(new_key)`.
+        """
+        if not dts:
+            return operand
+
+        taskref_cls = getattr(dts, "TaskRef", None)
+        if taskref_cls and isinstance(operand, taskref_cls):
+            key = getattr(operand, "key", None)
+            path = getattr(operand, "path", ())
+            return TaskOutputRef(key, path or ())
+
+        alias_cls = getattr(dts, "Alias", None)
+        if alias_cls and isinstance(operand, alias_cls):
+            alias_ref = self._extract_alias_target(operand, task_keys)
+            if alias_ref is None:
+                raise ValueError("Alias node is missing a valid upstream source")
+            return alias_ref
+
+        literal_cls = getattr(dts, "Literal", None)
+        if literal_cls and isinstance(operand, literal_cls):
+            return getattr(operand, "value", None)
+
+        datanode_cls = getattr(dts, "DataNode", None)
+        if datanode_cls and isinstance(operand, datanode_cls):
+            return operand.value
+
+        nested_cls = getattr(dts, "NestedContainer", None)
+        if nested_cls and isinstance(operand, nested_cls):
+            payload = getattr(operand, "value", None)
+            if payload is None:
+                payload = getattr(operand, "data", None)
+            return self._unwrap_dts_operand(payload, task_keys, parent_key=parent_key)
+
+        task_cls = getattr(dts, "Task", None)
+        if task_cls and isinstance(operand, task_cls):
+            inline_key = getattr(operand, "key", None)
+            # Rule 3: if it is a real graph node (key is present and in task_keys),
+            # treat it as a dependency reference.
+            if inline_key is not None and inline_key in task_keys:
+                return TaskOutputRef(inline_key, ())
+
+            # Otherwise it is an inline expression. Reduce if safe, else lift.
+            func = self._extract_callable_from_task(operand)
+            if func is None:
+                return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+
+            # Special-case: Dask internal identity-cast wrappers should not be called
+            # during adaptation. Reduce structurally by returning the first argument.
+            if self._is_identity_cast_op(func):
+                raw_args = getattr(operand, "args", ()) or ()
+                if not raw_args:
+                    return None
+                return self._unwrap_dts_operand(raw_args[0], task_keys, parent_key=parent_key)
+
+            if self._is_pure_value_op(func):
+                reduced, used_lift = self._reduce_inline_task(operand, task_keys, parent_key=parent_key)
+                if used_lift:
+                    # Rule 2: if any child required lifting/unknown handling, lift the whole expression.
+                    return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+                if self._is_too_large_inline_value(reduced):
+                    return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+                return reduced
+
+            # Rule 1: unknown/unsafe op -> must lift.
+            return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+
+        if isinstance(operand, list):
+            return [self._unwrap_dts_operand(v, task_keys, parent_key=parent_key) for v in operand]
+
+        if isinstance(operand, tuple):
+            return tuple(self._unwrap_dts_operand(v, task_keys, parent_key=parent_key) for v in operand)
+
+        if isinstance(operand, Mapping):
+            return {k: self._unwrap_dts_operand(v, task_keys, parent_key=parent_key) for k, v in operand.items()}
+
+        if isinstance(operand, set):
+            return {self._unwrap_dts_operand(v, task_keys, parent_key=parent_key) for v in operand}
+
+        if isinstance(operand, frozenset):
+            return frozenset(self._unwrap_dts_operand(v, task_keys, parent_key=parent_key) for v in operand)
+
+        return operand
+
+    def _extract_alias_target(self, alias_node, task_keys):
+        """Discover which upstream key an alias points at and return it as a `TaskOutputRef`."""
+        fields = getattr(alias_node.__class__, "__dataclass_fields__", {}) if dts else {}
+
+        path = getattr(alias_node, "path", ())
+        path = tuple(path) if path else ()
+
+        for candidate in ("alias_of", "target", "source", "ref"):
+            if candidate in fields:
+                raw_value = getattr(alias_node, candidate, None)
+                if self._should_wrap(raw_value, task_keys):
+                    return TaskOutputRef(raw_value, path)
+
+        deps = getattr(alias_node, "dependencies", None)
+        if deps:
+            deps = list(deps)
+            if len(deps) == 1:
+                return TaskOutputRef(deps[0], path)
+
+        return None
+
+    @staticmethod
+    def _build_expr(func, args, kwargs):
+        return func, tuple(args), dict(kwargs)
+
+    @staticmethod
+    def _safe_repr(value, limit=800):
+        """Best-effort repr that won't explode logs on huge graphs."""
+        try:
+            text = repr(value)
+        except Exception as e:
+            text = f"<unreprable {type(value).__name__}: {e}>"
+        if limit and len(text) > limit:
+            return text[:limit] + "...<truncated>"
+        return text
+
+    @staticmethod
+    def _is_pure_value_op(func):
+        """Return True if `func` is safe to execute during adaptation to build a pure value.
+
+        This is intentionally conservative: only pure constructors/identity-like ops.
+        """
+        if func in (dict, list, tuple, set, frozenset):
+            return True
+        return False
+
+    @staticmethod
+    def _is_identity_cast_op(func):
+        """Detect Dask's private identity-cast op without executing it."""
+        name = getattr(func, "__name__", None)
+        module = getattr(func, "__module__", None)
+        return bool(name == "_identity_cast" and module and module.startswith("dask"))
+
+    def _reduce_inline_task(self, task_node, task_keys, *, parent_key=None):
+        """Best-effort reduction of an inline TaskSpec Task into a pure value.
+
+        Returns (value, used_lift) where used_lift indicates a nested operand triggered lifting.
+        """
+        func = self._extract_callable_from_task(task_node)
+        raw_args = getattr(task_node, "args", ()) or ()
+        raw_kwargs = getattr(task_node, "kwargs", {}) or {}
+
+        used_lift = False
+
+        # unwrap args/kwargs; if we see a lifted ref, mark used_lift (Rule 2).
+        args = []
+        for arg in raw_args:
+            before = len(self._lifted_nodes)
+            args.append(self._unwrap_dts_operand(arg, task_keys, parent_key=parent_key))
+            used_lift = used_lift or (len(self._lifted_nodes) != before)
+
+        kwargs = {}
+        for k, v in raw_kwargs.items():
+            before = len(self._lifted_nodes)
+            kwargs[k] = self._unwrap_dts_operand(v, task_keys, parent_key=parent_key)
+            used_lift = used_lift or (len(self._lifted_nodes) != before)
+
+        # Pure constructors are safe to execute even if they contain TaskOutputRefs
+        # (they just build containers of refs). Anything else is lifted.
+        try:
+            value = func(*args, **kwargs)
+        except Exception:
+            # If evaluation fails, prefer lifting over guessing semantics.
+            return self._lift_inline_task(task_node, task_keys, parent_key=parent_key), True
+
+        return value, used_lift
+
+    @staticmethod
+    def _is_too_large_inline_value(value, *, max_container_len=2000):
+        """Heuristic to avoid inlining huge container constructions that would bloat memory."""
+        try:
+            if isinstance(value, (list, tuple, set, frozenset, dict)):
+                return len(value) > max_container_len
+        except Exception:
+            return False
+        return False
+
+    def _lift_inline_task(self, task_node, task_keys, *, parent_key=None):
+        """Lift an inline TaskSpec Task into its own node and return a `TaskOutputRef` to it."""
+        inline_key = getattr(task_node, "key", None)
+        if parent_key is not None and inline_key == parent_key:
+            raise ValueError(f"Refusing to lift Task that would self-reference parent key {parent_key!r}")
+
+        sig = self._dts_structural_signature(task_node, task_keys)
+        cached = self._lift_cache.get(sig)
+        if cached is not None:
+            return TaskOutputRef(cached, ())
+
+        import hashlib
+
+        digest = hashlib.sha1(sig.encode("utf-8")).hexdigest()[:16]
+        base = f"__lift__{digest}"
+        new_key = base
+        # Collision handling + avoid clobbering existing user keys.
+        while new_key in task_keys or new_key in self._lifted_nodes:
+            self._lift_counter += 1
+            new_key = f"{base}_{self._lift_counter}"
+
+        self._lift_cache[sig] = new_key
+        self._lifted_nodes[new_key] = task_node
+        task_keys.add(new_key)
+        return TaskOutputRef(new_key, ())
+
+    def _dts_structural_signature(self, obj, task_keys):
+        """Best-effort stable signature for deduping lifted inline expressions."""
+        # Keep it deterministic and conservative. If we can't make it stable, fall back to repr.
+        try:
+            taskref_cls = getattr(dts, "TaskRef", None)
+            alias_cls = getattr(dts, "Alias", None)
+            literal_cls = getattr(dts, "Literal", None)
+            datanode_cls = getattr(dts, "DataNode", None)
+            nested_cls = getattr(dts, "NestedContainer", None)
+            task_cls = getattr(dts, "Task", None)
+
+            if taskref_cls and isinstance(obj, taskref_cls):
+                return f"TaskRef({getattr(obj, 'key', None)!r},{tuple(getattr(obj, 'path', ()) or ())!r})"
+            if alias_cls and isinstance(obj, alias_cls):
+                ref = self._extract_alias_target(obj, task_keys)
+                return f"Alias({getattr(ref, 'task_key', None)!r},{getattr(ref, 'path', ())!r})"
+            if literal_cls and isinstance(obj, literal_cls):
+                return f"Literal({self._safe_repr(getattr(obj, 'value', None))})"
+            if datanode_cls and isinstance(obj, datanode_cls):
+                return f"DataNode({self._safe_repr(getattr(obj, 'value', None))})"
+            if nested_cls and isinstance(obj, nested_cls):
+                payload = getattr(obj, "value", None)
+                if payload is None:
+                    payload = getattr(obj, "data", None)
+                return f"Nested({self._dts_structural_signature(payload, task_keys)})"
+            if task_cls and isinstance(obj, task_cls):
+                key = getattr(obj, "key", None)
+                if key is not None and key in task_keys:
+                    return f"TaskKey({key!r})"
+                func = self._extract_callable_from_task(obj)
+                func_id = (getattr(func, "__module__", None), getattr(func, "__qualname__", None), getattr(func, "__name__", None))
+                args = getattr(obj, "args", ()) or ()
+                kwargs = getattr(obj, "kwargs", {}) or {}
+                arg_sigs = ",".join(self._dts_structural_signature(a, task_keys) for a in args)
+                kw_sigs = ",".join(f"{k}={self._dts_structural_signature(v, task_keys)}" for k, v in sorted(kwargs.items()))
+                return f"TaskInline(func={func_id!r},args=[{arg_sigs}],kwargs=[{kw_sigs}])"
+
+            if isinstance(obj, list):
+                return "list(" + ",".join(self._dts_structural_signature(v, task_keys) for v in obj) + ")"
+            if isinstance(obj, tuple):
+                return "tuple(" + ",".join(self._dts_structural_signature(v, task_keys) for v in obj) + ")"
+            if isinstance(obj, dict):
+                items = ",".join(
+                    f"{self._safe_repr(k)}:{self._dts_structural_signature(v, task_keys)}"
+                    for k, v in sorted(obj.items(), key=lambda kv: repr(kv[0]))
+                )
+                return "dict(" + items + ")"
+            if isinstance(obj, (set, frozenset)):
+                items = ",".join(sorted(self._dts_structural_signature(v, task_keys) for v in obj))
+                return f"{type(obj).__name__}(" + items + ")"
+
+            return f"py({self._safe_repr(obj)})"
+        except Exception:
+            return f"fallback({self._safe_repr(obj)})"
+
+    @staticmethod
+    def _extract_callable_from_task(node):
+        candidates = (
+            "function",
+            "op",
+            "callable",
+            "func",
+            "operation",
+            "callable_obj",
+        )
+
+        for attr in candidates:
+            if not hasattr(node, attr):
+                continue
+            value = getattr(node, attr)
+            if value is None:
+                continue
+            if callable(value):
+                return value
+            if hasattr(value, "__call__"):
+                return value
+
+        if hasattr(node, "__call__") and callable(node):
+            return node
+
+        return None
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py b/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py
new file mode 100644
index 0000000000..ce1a23fe68
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py
@@ -0,0 +1,528 @@
+import importlib
+import importlib.util
+import pathlib
+import sys
+import unittest
+from dataclasses import dataclass, field
+
+from ndcctools.taskvine.dagvine.blueprint_graph.adaptor import Adaptor as _Adaptor, TaskOutputRef as _TaskOutputRef
+
+_MODULE_NAME = "ndcctools.taskvine.dagvine.blueprint_graph.adaptor"
+_LOCAL_ADAPTOR = pathlib.Path(__file__).resolve().parent / "adaptor.py"
+
+if _LOCAL_ADAPTOR.exists():
+    spec = importlib.util.spec_from_file_location(_MODULE_NAME, _LOCAL_ADAPTOR)
+    module = importlib.util.module_from_spec(spec)
+    assert spec.loader is not None
+    sys.modules[_MODULE_NAME] = module
+    spec.loader.exec_module(module)
+    Adaptor = module.Adaptor
+    TaskOutputRef = module.TaskOutputRef
+    adaptor_impl = module
+else:
+    Adaptor = _Adaptor
+    TaskOutputRef = _TaskOutputRef
+    adaptor_impl = importlib.import_module(Adaptor.__module__)
+
+
+class AdaptorSexprTests(unittest.TestCase):
+    def test_empty_graph_returns_empty_dict(self):
+        self.assertEqual(Adaptor({}).task_dict, {})
+
+    def test_wraps_references_in_args_and_kwargs(self):
+        def seed():
+            return 1
+
+        def consume(value, bonus=0):
+            return value + bonus
+
+        graph = {
+            "seed": (seed,),
+            "consumer": (consume, "seed", {"bonus": "seed"}),
+        }
+
+        adaptor = Adaptor(graph)
+        adapted = adaptor.task_dict
+
+        seed_func, seed_args, seed_kwargs = adapted["seed"]
+        self.assertIs(seed_func, seed)
+        self.assertEqual(seed_args, ())
+        self.assertEqual(seed_kwargs, {})
+
+        func, args, kwargs = adapted["consumer"]
+        self.assertIs(func, consume)
+        self.assertEqual(len(args), 1)
+        self.assertIsInstance(args[0], TaskOutputRef)
+        self.assertEqual(args[0].task_key, "seed")
+        self.assertEqual(args[0].path, ())
+
+        self.assertIsInstance(kwargs["bonus"], TaskOutputRef)
+        self.assertEqual(kwargs["bonus"].task_key, "seed")
+        self.assertEqual(kwargs["bonus"].path, ())
+
+    def test_handles_nested_collections(self):
+        def aggregate(structure, *, options=None):
+            return structure, options
+
+        graph = {
+            "alpha": (lambda: {"value": 1},),
+            "beta": (lambda: 2,),
+            "collector": (
+                aggregate,
+                ["alpha", ("beta", "alpha")],
+                {
+                    "mapping": {
+                        "left": "alpha",
+                        "right": ["beta", {"deep": "alpha"}],
+                    },
+                    "flags": {"alpha", "unchanged"},
+                },
+            ),
+        }
+
+        adaptor = Adaptor(graph)
+        adapted = adaptor.task_dict
+
+        func, args, kwargs = adapted["collector"]
+        self.assertIs(func, aggregate)
+
+        self.assertEqual(len(args), 1)
+        structure = args[0]
+        self.assertIsInstance(structure, list)
+        self.assertIsInstance(structure[0], TaskOutputRef)
+        self.assertEqual(structure[0].task_key, "alpha")
+
+        tuple_fragment = structure[1]
+        self.assertIsInstance(tuple_fragment, tuple)
+        self.assertIsInstance(tuple_fragment[0], TaskOutputRef)
+        self.assertEqual(tuple_fragment[0].task_key, "beta")
+        self.assertIsInstance(tuple_fragment[1], TaskOutputRef)
+        self.assertEqual(tuple_fragment[1].task_key, "alpha")
+
+        mapping = kwargs["mapping"]
+        self.assertIsInstance(mapping["left"], TaskOutputRef)
+        self.assertEqual(mapping["left"].task_key, "alpha")
+
+        right_list = mapping["right"]
+        self.assertIsInstance(right_list[0], TaskOutputRef)
+        self.assertEqual(right_list[0].task_key, "beta")
+        self.assertIsInstance(right_list[1]["deep"], TaskOutputRef)
+        self.assertEqual(right_list[1]["deep"].task_key, "alpha")
+
+        flags = kwargs["flags"]
+        self.assertIsInstance(flags, set)
+        ref_keys = {item.task_key for item in flags if isinstance(item, TaskOutputRef)}
+        self.assertEqual(ref_keys, {"alpha"})
+        self.assertIn("unchanged", flags)
+
+    def test_literal_strings_remain_literals(self):
+        def attach_unit(value, *, unit):
+            return value, unit
+
+        graph = {
+            "value": (lambda: 42,),
+            "with_unit": (
+                attach_unit,
+                "value",
+                {"unit": "kg"},
+            ),
+        }
+
+        adaptor = Adaptor(graph)
+        adapted = adaptor.task_dict
+        func, args, kwargs = adapted["with_unit"]
+        self.assertIs(func, attach_unit)
+        self.assertEqual(len(args), 1)
+        self.assertIsInstance(args[0], TaskOutputRef)
+        self.assertEqual(kwargs["unit"], "kg")
+
+    def test_existing_task_output_ref_is_preserved(self):
+        original_ref = TaskOutputRef("seed")
+
+        graph = {
+            "seed": (lambda: 5,),
+            "forward": (lambda x: x, original_ref),
+        }
+
+        adapted = Adaptor(graph).task_dict
+        func, args, kwargs = adapted["forward"]
+        self.assertIs(func, graph["forward"][0])
+        self.assertEqual(kwargs, {})
+        self.assertIs(args[0], original_ref)
+
+    def test_sets_and_frozensets_are_rewritten(self):
+        graph = {
+            "seed": (lambda: 1,),
+            "consumer": (
+                lambda payload, *, meta=None: (payload, meta),
+                (
+                    {
+                        "set_refs": {"seed", "literal"},
+                        "froze_refs": frozenset({"seed"}),
+                    },
+                ),
+                {
+                    "meta": {
+                        "labels": {"seed", "plain"},
+                        "deep": frozenset({"seed"}),
+                    }
+                },
+            ),
+        }
+
+        adapted = Adaptor(graph).task_dict
+        func, args, kwargs = adapted["consumer"]
+        self.assertEqual(len(args), 1)
+
+        self.assertIsInstance(args[0], tuple)
+        payload = args[0][0]
+        set_refs = payload["set_refs"]
+        self.assertIsInstance(set_refs, set)
+        self.assertIn("literal", set_refs)
+        refs = [item for item in set_refs if isinstance(item, TaskOutputRef)]
+        self.assertEqual(len(refs), 1)
+        self.assertEqual(refs[0].task_key, "seed")
+
+        froze_refs = payload["froze_refs"]
+        self.assertIsInstance(froze_refs, frozenset)
+        sole_ref = next(iter(froze_refs))
+        self.assertIsInstance(sole_ref, TaskOutputRef)
+        self.assertEqual(sole_ref.task_key, "seed")
+
+        labels = kwargs["meta"]["labels"]
+        self.assertIsInstance(labels, set)
+        label_refs = [item for item in labels if isinstance(item, TaskOutputRef)]
+        self.assertEqual(len(label_refs), 1)
+        self.assertEqual(label_refs[0].task_key, "seed")
+        self.assertIn("plain", labels)
+
+        deep_froze = kwargs["meta"]["deep"]
+        self.assertIsInstance(deep_froze, frozenset)
+        deep_ref = next(iter(deep_froze))
+        self.assertIsInstance(deep_ref, TaskOutputRef)
+        self.assertEqual(deep_ref.task_key, "seed")
+
+    def test_callable_tuple_preserves_callable(self):
+        def source():
+            return 2
+
+        def apply(func_tuple):
+            fn, value = func_tuple
+            return fn(value)
+
+        increment = lambda x: x + 1  # noqa: E731
+
+        graph = {
+            "value": (source,),
+            "result": (
+                apply,
+                (increment, "value"),
+            ),
+        }
+
+        adapted = Adaptor(graph).task_dict
+        func, args, kwargs = adapted["result"]
+        self.assertIs(func, apply)
+        nested = args[0]
+        self.assertIsInstance(nested, tuple)
+        self.assertIs(nested[0], increment)
+        self.assertIsInstance(nested[1], TaskOutputRef)
+        self.assertEqual(nested[1].task_key, "value")
+
+    def test_invalid_task_definition_raises(self):
+        graph = {"broken": []}
+        with self.assertRaises(TypeError):
+            Adaptor(graph)
+
+    def test_large_graph_scaling(self):
+        size = 500
+
+        graph = {"root": (lambda: 1,)}
+        for i in range(1, size + 1):
+            key = f"node_{i}"
+            prev_key = "root" if i == 1 else f"node_{i - 1}"
+            graph[key] = (
+                lambda x, inc=1: x + inc,
+                prev_key,
+                {"inc": i},
+            )
+
+        graph["fanout"] = (
+            lambda *vals: sum(vals),
+            tuple(graph.keys()),
+        )
+
+        adapted = Adaptor(graph).task_dict
+
+        self.assertEqual(len(adapted), len(graph))
+
+        fanout_func, fanout_args, fanout_kwargs = adapted["fanout"]
+        self.assertEqual(fanout_kwargs, {})
+        self.assertEqual(len(fanout_args), 1)
+        arg_tuple = fanout_args[0]
+        self.assertEqual(len(arg_tuple), len(graph) - 1)
+        refs = [item for item in arg_tuple if isinstance(item, TaskOutputRef)]
+        self.assertEqual(len(refs), len(graph) - 1)
+        ref_keys = {ref.task_key for ref in refs}
+        expected_keys = set(graph.keys()) - {"fanout"}
+        self.assertEqual(ref_keys, expected_keys)
+
+
+class _FakeGraphNode:
+    __slots__ = ()
+
+
+@dataclass
+class _FakeTaskRef(_FakeGraphNode):
+    key: str
+    path: tuple = field(default_factory=tuple)
+
+
+@dataclass
+class _FakeAlias(_FakeGraphNode):
+    target: str
+    path: tuple = field(default_factory=tuple)
+    dependencies: frozenset = field(default_factory=frozenset)
+
+    def __post_init__(self):
+        if not self.dependencies:
+            self.dependencies = frozenset({self.target})
+
+
+@dataclass
+class _FakeLiteral(_FakeGraphNode):
+    value: object
+
+
+@dataclass
+class _FakeDataNode(_FakeGraphNode):
+    value: object
+
+
+@dataclass
+class _FakeNestedContainer(_FakeGraphNode):
+    value: object
+
+
+@dataclass
+class _FakeTask(_FakeGraphNode):
+    key: str
+    function: object
+    args: tuple = field(default_factory=tuple)
+    kwargs: dict = field(default_factory=dict)
+    dependencies: frozenset = field(default_factory=frozenset)
+
+    def __post_init__(self):
+        if not self.dependencies:
+            deps = set()
+            for arg in self.args:
+                if isinstance(arg, _FakeTaskRef):
+                    deps.add(arg.key)
+            for value in self.kwargs.values():
+                if isinstance(value, _FakeTaskRef):
+                    deps.add(value.key)
+            self.dependencies = frozenset(deps)
+
+
+class _FakeDtsModule:
+    GraphNode = _FakeGraphNode
+    Task = _FakeTask
+    TaskRef = _FakeTaskRef
+    Alias = _FakeAlias
+    Literal = _FakeLiteral
+    DataNode = _FakeDataNode
+    NestedContainer = _FakeNestedContainer
+
+    @staticmethod
+    def convert_legacy_graph(task_dict):
+        return task_dict
+
+
+class AdaptorTaskSpecTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls._original_dts = adaptor_impl.dts
+        adaptor_impl.dts = _FakeDtsModule()
+
+    @classmethod
+    def tearDownClass(cls):
+        adaptor_impl.dts = cls._original_dts
+
+    def test_adapts_taskspec_graph(self):
+        def add_bonus(value, bonus):
+            return value + bonus
+
+        def combine(upstream, payload=None):
+            return upstream, payload
+
+        graph = {
+            "raw": _FakeDataNode(value=7),
+            "literal_wrapper": _FakeTask(
+                key="literal_wrapper",
+                function=add_bonus,
+                args=(_FakeTaskRef("raw"),),
+                kwargs={"bonus": _FakeLiteral(3)},
+            ),
+            "alias": _FakeAlias(target="literal_wrapper", path=("result",)),
+            "aggregate": _FakeTask(
+                key="aggregate",
+                function=combine,
+                args=(_FakeTaskRef("alias", path=("payload",)),),
+                kwargs={
+                    "payload": _FakeNestedContainer(
+                        value=[
+                            _FakeTaskRef("raw"),
+                            {"inner": _FakeTaskRef("alias", path=("extra",))},
+                        ]
+                    )
+                },
+            ),
+        }
+
+        adaptor = Adaptor(graph)
+        adapted = adaptor.task_dict
+
+        raw_func, raw_args, raw_kwargs = adapted["raw"]
+        self.assertEqual(raw_args, (7,))
+        self.assertEqual(raw_kwargs, {})
+        self.assertEqual(raw_func(raw_args[0]), raw_args[0])
+
+        wrapper_func, wrapper_args, wrapper_kwargs = adapted["literal_wrapper"]
+        self.assertIs(wrapper_func, add_bonus)
+        self.assertEqual(len(wrapper_args), 1)
+        self.assertIsInstance(wrapper_args[0], TaskOutputRef)
+        self.assertEqual(wrapper_args[0].task_key, "raw")
+        self.assertEqual(wrapper_kwargs["bonus"], 3)
+
+        self.assertIn("alias", adapted)
+        alias_func, alias_args, alias_kwargs = adapted["alias"]
+        self.assertIs(alias_func, adaptor_impl._identity)
+        self.assertEqual(alias_kwargs, {})
+        self.assertEqual(len(alias_args), 1)
+        alias_input = alias_args[0]
+        self.assertIsInstance(alias_input, TaskOutputRef)
+        self.assertEqual(alias_input.task_key, "literal_wrapper")
+        self.assertEqual(alias_input.path, ("result",))
+
+        agg_func, agg_args, agg_kwargs = adapted["aggregate"]
+        self.assertIs(agg_func, combine)
+        self.assertEqual(len(agg_args), 1)
+        primary_input = agg_args[0]
+        self.assertIsInstance(primary_input, TaskOutputRef)
+        self.assertEqual(primary_input.task_key, "alias")
+        self.assertEqual(primary_input.path, ("payload",))
+
+        payload = agg_kwargs["payload"]
+        self.assertIsInstance(payload, list)
+        self.assertIsInstance(payload[0], TaskOutputRef)
+        self.assertEqual(payload[0].task_key, "raw")
+        nested_inner = payload[1]["inner"]
+        self.assertIsInstance(nested_inner, TaskOutputRef)
+        self.assertEqual(nested_inner.task_key, "alias")
+        self.assertEqual(nested_inner.path, ("extra",))
+
+    def test_taskspec_data_node_literal_passthrough(self):
+        graph = {"literal": _FakeDataNode(value=11)}
+        adapted = Adaptor(graph).task_dict
+        func, args, kwargs = adapted["literal"]
+        self.assertEqual(args, (11,))
+        self.assertEqual(kwargs, {})
+        self.assertEqual(func(args[0]), 11)
+
+    def test_taskspec_alias_with_missing_target_raises(self):
+        alias = _FakeAlias(target="ghost", dependencies=frozenset())
+        alias.dependencies = frozenset()
+        graph = {"alias": alias}
+        with self.assertRaises(ValueError):
+            Adaptor(graph)
+
+    def test_taskspec_nested_container_fallback_to_data(self):
+        container = _FakeNestedContainer(value=None)
+        container.data = [_FakeTaskRef("raw")]
+        graph = {
+            "raw": _FakeDataNode(value=5),
+            "use_container": _FakeTask(
+                key="use_container",
+                function=lambda payload: payload,
+                args=(container,),
+            ),
+        }
+
+        adapted = Adaptor(graph).task_dict
+        func, args, kwargs = adapted["use_container"]
+        self.assertEqual(kwargs, {})
+        (payload,) = args
+        self.assertIsInstance(payload, list)
+        self.assertIsInstance(payload[0], TaskOutputRef)
+        self.assertEqual(payload[0].task_key, "raw")
+
+    def test_taskspec_task_missing_function_raises(self):
+        graph = {
+            "broken": _FakeTask(
+                key="broken",
+                function=None,
+                args=(),
+            )
+        }
+        with self.assertRaises(TypeError):
+            Adaptor(graph)
+
+    def test_taskspec_task_nested_inside_args_is_lifted(self):
+        # Inline Tasks inside args/kwargs should be lifted unless they are a top-level key
+        # reference or a pure value constructor. Here `inner` is an inline task with
+        # an unknown (lambda) op, so it must be lifted to a new node.
+        inner = _FakeTask(
+            key=None,
+            function=lambda: 1,
+            args=(),
+        )
+        graph = {
+            "outer": _FakeTask(
+                key="outer",
+                function=lambda x: x,
+                args=(inner,),
+            )
+        }
+        adapted = Adaptor(graph).task_dict
+        outer_func, outer_args, outer_kwargs = adapted["outer"]
+        self.assertEqual(outer_kwargs, {})
+        self.assertEqual(len(outer_args), 1)
+        self.assertIsInstance(outer_args[0], TaskOutputRef)
+        lifted_key = outer_args[0].task_key
+        self.assertIn(lifted_key, adapted)
+        self.assertNotEqual(lifted_key, "outer")
+
+    def test_taskspec_identity_cast_is_structurally_reduced(self):
+        # Ensure we never execute dask private identity-cast during adaptation.
+        def fake_identity_cast(x, *_, **__):
+            raise RuntimeError("must not be executed")
+
+        fake_identity_cast.__name__ = "_identity_cast"
+        fake_identity_cast.__module__ = "dask._fake"
+
+        graph = {
+            "raw": _FakeDataNode(value=5),
+            "outer": _FakeTask(
+                key="outer",
+                function=lambda x: x,
+                args=(
+                    _FakeTask(
+                        key=None,
+                        function=fake_identity_cast,
+                        args=(_FakeTaskRef("raw"),),
+                    ),
+                ),
+            ),
+        }
+
+        adapted = Adaptor(graph).task_dict
+        _, outer_args, outer_kwargs = adapted["outer"]
+        self.assertEqual(outer_kwargs, {})
+        self.assertEqual(len(outer_args), 1)
+        self.assertIsInstance(outer_args[0], TaskOutputRef)
+        self.assertEqual(outer_args[0].task_key, "raw")
+        self.assertFalse(any(str(k).startswith("__lift__") for k in adapted.keys()))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py b/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py
new file mode 100644
index 0000000000..4439a76d42
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py
@@ -0,0 +1,197 @@
+# Copyright (C) 2025- The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+from collections import defaultdict, deque
+from collections.abc import Mapping
+from dataclasses import is_dataclass, fields, replace
+import cloudpickle
+
+
+class TaskOutputWrapper:
+    def __init__(self, result, extra_size_mb=None):
+        self.result = result
+        self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
+
+    @staticmethod
+    def load_from_path(path):
+        try:
+            with open(path, "rb") as f:
+                result_obj = cloudpickle.load(f)
+                assert isinstance(result_obj, TaskOutputWrapper), "Loaded object is not of type TaskOutputWrapper"
+                return result_obj.result
+        except FileNotFoundError:
+            raise FileNotFoundError(f"Task result file not found at {path}")
+
+
+class TaskOutputRef:
+    __slots__ = ("task_key", "path")
+
+    def __init__(self, task_key, path=()):
+        self.task_key = task_key
+        self.path = tuple(path)
+
+    def __getitem__(self, key):
+        if isinstance(key, tuple):
+            return TaskOutputRef(self.task_key, self.path + key)
+        return TaskOutputRef(self.task_key, self.path + (key,))
+
+
+class BlueprintGraph:
+
+    _LEAF_TYPES = (str, bytes, bytearray, memoryview, int, float, bool, type(None))
+
+    def __init__(self):
+        self.task_dict = {}                    # task_key -> (func, frozen_args, frozen_kwargs)
+
+        self.parents_of = defaultdict(set)     # task_key -> set of task_keys
+        self.children_of = defaultdict(set)    # task_key -> set of task_keys
+
+        self.producer_of = {}                  # filename -> task_key
+        self.consumers_of = defaultdict(set)   # filename -> set of task_keys
+
+        self.outfile_remote_name = defaultdict(lambda: None)   # task_key -> remote outfile name, will be set by vine graph
+
+        self.pykey2cid = {}                  # py_key -> c_id
+        self.cid2pykey = {}                  # c_id -> py_key
+
+    def _visit_task_output_refs(self, obj, on_ref, *, rewrite: bool):
+        seen = set()
+
+        def rec(x):
+            if isinstance(x, TaskOutputRef):
+                return on_ref(x)
+
+            if x is None or isinstance(x, self._LEAF_TYPES):
+                return x if rewrite else None
+
+            oid = id(x)
+            if oid in seen:
+                return x if rewrite else None
+            seen.add(oid)
+
+            if isinstance(x, Mapping):
+                for k in x.keys():
+                    if isinstance(k, TaskOutputRef):
+                        raise ValueError("TaskOutputRef cannot be used as dict key")
+                if not rewrite:
+                    for v in x.values():
+                        rec(v)
+                    return None
+                return {k: rec(v) for k, v in x.items()}
+
+            if is_dataclass(x) and not isinstance(x, type):
+                if not rewrite:
+                    for f in fields(x):
+                        rec(getattr(x, f.name))
+                    return None
+                updates = {f.name: rec(getattr(x, f.name)) for f in fields(x)}
+                try:
+                    return replace(x, **updates)
+                except Exception:
+                    return x.__class__(**updates)
+
+            if isinstance(x, tuple) and hasattr(x, "_fields"):  # namedtuple
+                if not rewrite:
+                    for v in x:
+                        rec(v)
+                    return None
+                return x.__class__(*(rec(v) for v in x))
+
+            if isinstance(x, (list, tuple, set, frozenset, deque)):
+                if not rewrite:
+                    for v in x:
+                        rec(v)
+                    return None
+                it = (rec(v) for v in x)
+                if isinstance(x, list):
+                    return list(it)
+                if isinstance(x, tuple):
+                    return tuple(it)
+                if isinstance(x, set):
+                    return set(it)
+                if isinstance(x, frozenset):
+                    return frozenset(it)
+                return deque(it)
+
+            return x if rewrite else None
+
+        return rec(obj)
+
+    def _find_parents(self, obj):
+        parents = set()
+
+        def on_ref(r):
+            parents.add(r.task_key)
+            return None
+
+        self._visit_task_output_refs(obj, on_ref, rewrite=False)
+        return parents
+
+    def add_task(self, task_key, func, *args, **kwargs):
+        if task_key in self.task_dict:
+            raise ValueError(f"Task {task_key} already exists")
+
+        self.task_dict[task_key] = (func, args, kwargs)
+
+        parents = self._find_parents(args) | self._find_parents(kwargs)
+
+        for parent in parents:
+            self.parents_of[task_key].add(parent)
+            self.children_of[parent].add(task_key)
+
+    def task_produces(self, task_key, *filenames):
+        for filename in filenames:
+            # a file can only be produced by one task
+            if filename in self.producer_of:
+                raise ValueError(f"File {filename} already produced by task {self.producer_of[filename]}")
+            self.producer_of[filename] = task_key
+
+    def task_consumes(self, task_key, *filenames):
+        for filename in filenames:
+            # a file can be consumed by multiple tasks
+            self.consumers_of[filename].add(task_key)
+
+    def save_task_output(self, task_key, output):
+        with open(self.outfile_remote_name[task_key], "wb") as f:
+            wrapped_output = TaskOutputWrapper(output, extra_size_mb=0)
+            cloudpickle.dump(wrapped_output, f)
+
+    def load_task_output(self, task_key):
+        return TaskOutputWrapper.load_from_path(self.outfile_remote_name[task_key])
+
+    def get_topological_order(self):
+        indegree = {}
+        for task_key in self.task_dict:
+            indegree[task_key] = len(self.parents_of.get(task_key, ()))
+
+        q = deque(t for t, d in indegree.items() if d == 0)
+        order = []
+
+        while q:
+            u = q.popleft()
+            order.append(u)
+
+            for v in self.children_of.get(u, ()):
+                indegree[v] -= 1
+                if indegree[v] == 0:
+                    q.append(v)
+
+        if len(order) != len(self.task_dict):
+            raise ValueError("Graph has a cycle or missing dependencies")
+
+        return order
+
+    def verify_topo(g, topo):
+        pos = {k: i for i, k in enumerate(topo)}
+        for child, parents in g.parents_of.items():
+            for p in parents:
+                if pos[p] > pos[child]:
+                    raise AssertionError(f"bad topo: parent {p} after child {child}")
+        print("topo verified: ok")
+
+    def finalize(self):
+        for file, producer in self.producer_of.items():
+            for consumer in self.consumers_of.get(file, ()):
+                self.parents_of[consumer].add(producer)
+                self.children_of[producer].add(consumer)
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py b/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py
new file mode 100644
index 0000000000..7c3c5ecf4f
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py
@@ -0,0 +1,51 @@
+# Copyright (C) 2025- The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+
+from ndcctools.taskvine.utils import load_variable_from_library
+
+
+def compute_task(bg, task_expr):
+    func, args, kwargs = task_expr
+    cache = {}
+
+    def _follow_path(value, path):
+        current = value
+        for token in path:
+            if isinstance(current, (list, tuple)):
+                current = current[token]
+            elif isinstance(current, dict):
+                current = current[token]
+            else:
+                current = getattr(current, token)
+        return current
+
+    def on_ref(r):
+        x = cache.get(r.task_key)
+        if x is None:
+            x = bg.load_task_output(r.task_key)
+            cache[r.task_key] = x
+        if r.path:
+            return _follow_path(x, r.path)
+        return x
+
+    r_args = bg._visit_task_output_refs(args, on_ref, rewrite=True)
+    r_kwargs = bg._visit_task_output_refs(kwargs, on_ref, rewrite=True)
+
+    print(f"func: {func}")
+    print(f"r_args: {r_args}")
+    print(f"r_kwargs: {r_kwargs}")
+
+    return func(*r_args, **r_kwargs)
+
+
+def compute_single_key(vine_key):
+    bg = load_variable_from_library('graph')
+
+    task_key = bg.cid2pykey[vine_key]
+    task_expr = bg.task_dict[task_key]
+
+    output = compute_task(bg, task_expr)
+
+    bg.save_task_output(task_key, output)
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/proxy_library.py b/taskvine/src/graph/dagvine/blueprint_graph/proxy_library.py
new file mode 100644
index 0000000000..78a7b71ca8
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/proxy_library.py
@@ -0,0 +1,94 @@
+# Copyright (C) 2025- The University of Notre Dame
+# This software is distributed under the GNU General Public License.
+# See the file COPYING for details.
+
+import os
+import uuid
+import cloudpickle
+import types
+import time
+import random
+import hashlib
+import collections
+
+from ndcctools.taskvine.dagvine.blueprint_graph.blueprint_graph import BlueprintGraph, TaskOutputRef, TaskOutputWrapper
+from ndcctools.taskvine.dagvine.blueprint_graph.proxy_functions import compute_single_key
+from ndcctools.taskvine.utils import load_variable_from_library
+
+
+class ProxyLibrary:
+    def __init__(self, py_manager):
+        self.py_manager = py_manager
+
+        self.name = None
+        self.libcores = None
+
+        self.libtask = None
+
+        # these modules are always included in the preamble of the library task, so that function calls can execute directly
+        # using the loaded context without importing them over and over again
+        self.hoisting_modules = [
+            os, cloudpickle, BlueprintGraph, TaskOutputRef, TaskOutputWrapper, uuid, hashlib, random, types, collections, time,
+            load_variable_from_library, compute_single_key
+        ]
+
+        # environment files serve as additional inputs to the library task, where each key is the local path and the value is the remote path
+        # those local files will be sent remotely to the workers so tasks can access them as appropriate
+        self.env_files = {}
+
+        # context loader is a function that will be used to load the library context on remote nodes.
+        self.context_loader_func = None
+        self.context_loader_args = []
+        self.context_loader_kwargs = {}
+
+        self.local_path = None
+        self.remote_path = None
+
+    def set_libcores(self, libcores):
+        self.libcores = libcores
+
+    def set_name(self, name):
+        self.name = name
+
+    def add_hoisting_modules(self, new_modules):
+        assert isinstance(new_modules, list), "new_modules must be a list of modules"
+        self.hoisting_modules.extend(new_modules)
+
+    def add_env_files(self, new_env_files):
+        assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
+        self.env_files.update(new_env_files)
+
+    def set_context_loader(self, context_loader_func, context_loader_args=[], context_loader_kwargs={}):
+        self.context_loader_func = context_loader_func
+        self.context_loader_args = context_loader_args
+        self.context_loader_kwargs = context_loader_kwargs
+
+    def get_context_size(self):
+        dumped_data = self.context_loader_args[0]
+        serialized = round(len(dumped_data) / 1024 / 1024, 2)
+        return serialized
+
+    def install(self):
+        assert self.name is not None, "Library name must be set before installing (use set_name method)"
+        assert self.libcores is not None, "Library cores must be set before installing (use set_libcores method)"
+
+        self.libtask = self.py_manager.create_library_from_functions(
+            self.name,
+            compute_single_key,
+            library_context_info=[self.context_loader_func, self.context_loader_args, self.context_loader_kwargs],
+            add_env=False,
+            function_infile_load_mode="json",
+            hoisting_modules=self.hoisting_modules,
+        )
+        for local, remote in self.env_files.items():
+            # check if the local file exists
+            if not os.path.exists(local):
+                raise FileNotFoundError(f"Local file {local} not found")
+            # attach as the input file to the library task
+            self.libtask.add_input(self.py_manager.declare_file(local, cache=True, peer_transfer=True), remote)
+        self.libtask.set_cores(self.libcores)
+        self.libtask.set_function_slots(self.libcores)
+        self.py_manager.install_library(self.libtask)
+
+    def uninstall(self):
+        self.py_manager.remove_library(self.name)
diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/dagvine/dagvine.py
index e060dcbf3d..663102daec 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -5,6 +5,7 @@
 from ndcctools.taskvine import cvine
 from ndcctools.taskvine.manager import Manager
 
+from ndcctools.taskvine.dagvine.blueprint_graph.adaptor import Adaptor
 from ndcctools.taskvine.dagvine.blueprint_graph.proxy_library import ProxyLibrary
 from ndcctools.taskvine.dagvine.blueprint_graph.proxy_functions import compute_single_key
 from ndcctools.taskvine.dagvine.blueprint_graph.blueprint_graph import BlueprintGraph, TaskOutputWrapper
@@ -15,21 +16,6 @@
 import signal
 import json
 
-try:
-    import dask
-except ImportError:
-    dask = None
-
-try:
-    from dask.base import is_dask_collection
-except ImportError:
-    is_dask_collection = None
-
-try:
-    import dask._task_spec as dts
-except ImportError:
-    dts = None
-
 
 def context_loader_func(graph_pkl):
     graph = cloudpickle.loads(graph_pkl)
@@ -58,50 +44,6 @@ def color_text(text, color_code):
     return f"\033[{color_code}m{text}\033[0m"
 
 
-# Flatten Dask collections into the dict-of-tasks structure the rest of the
-# pipeline expects. DAGVine clients often hand us a dict like
-# {"result": dask.delayed(...)}; we merge the underlying HighLevelGraphs so
-# `ContextGraph` sees the same dict representation C does.
-def dask_collections_to_task_dict(collection_dict):
-    """Merge user-facing Dask collections into the flattened task dict the ContextGraph expects."""
-    assert is_dask_collection is not None
-    from dask.highlevelgraph import HighLevelGraph, ensure_dict
-
-    if not isinstance(collection_dict, dict):
-        raise TypeError("Input must be a dict")
-
-    for k, v in collection_dict.items():
-        if not is_dask_collection(v):
-            raise TypeError(f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}")
-
-    if dts:
-        # the new Dask API
-        sub_hlgs = [v.dask for v in collection_dict.values()]
-        hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
-    else:
-        # the old Dask API
-        hlg = dask.base.collections_to_dsk(collection_dict.values())
-
-    return ensure_dict(hlg)
-
-
-# Accept both plain dicts and Dask collections from callers. Most library users
-# hand us `{key: delayed / value}` directly, while some experiments pass a
-# fully-expanded legacy Dask dict. This helper normalises both cases so the rest
-# of the pipeline only deals with `{task_key: task_expression}`.
-def normalize_task_dict(collection_dict):
-    """Normalize user input (raw dict or Dask collection) into a plain `{task_key: expr}` mapping."""
-    if is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values()):
-        task_dict = dask_collections_to_task_dict(collection_dict)
-    else:
-        task_dict = collection_dict
-
-    if dts:
-        return dts.convert_legacy_graph(task_dict)
-    else:
-        return task_dict
-
-
 class GraphParams:
     def __init__(self):
         """Hold all tweakable knobs (manager-side, vine_graph-side, and misc)."""
@@ -179,13 +121,13 @@ def __init__(self,
         # Ensure run-info templates don't accumulate garbage between runs.
         run_info_path = kwargs.get("run_info_path", None)
         run_info_template = kwargs.get("run_info_template", None)
+
         self.run_info_template_path = os.path.join(run_info_path, run_info_template)
         if self.run_info_template_path:
             delete_all_files(self.run_info_template_path)
 
         # Boot the underlying TaskVine manager. The TaskVine manager keeps alive until the dagvine object is destroyed
         super().__init__(*args, **kwargs)
-        print(f"cvine = {cvine}")
         self.runtime_directory = cvine.vine_get_runtime_directory(self._taskvine)
 
         print(f"=== Manager name: {color_text(self.name, 92)}")
@@ -232,18 +174,10 @@ def build_context_graph(self, task_dict):
         return context_graph
 
     def build_blueprint_graph(self, task_dict):
-        def _unpack_sexpr(sexpr):
-            func = sexpr[0]
-            tail = sexpr[1:]
-            if tail and isinstance(tail[-1], dict):
-                return func, tail[:-1], tail[-1]
-            else:
-                return func, tail, {}
-
         bg = BlueprintGraph()
 
         for k, v in task_dict.items():
-            func, args, kwargs = _unpack_sexpr(v)
+            func, args, kwargs = v
             assert callable(func), f"Task {k} does not have a callable"
             bg.add_task(k, func, *args, **kwargs)
 
@@ -320,7 +254,7 @@ def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], e
                 print(f"             {k}")
         target_keys = list(set(target_keys) - set(missing_keys))
 
-        task_dict = normalize_task_dict(collection_dict)
+        task_dict = Adaptor(collection_dict).task_dict
 
         # Build both the Python DAG and its C mirror.
         py_graph, vine_graph = self.build_graphs(task_dict, target_keys, blueprint_graph=True)

From 2a6d2caf7a37e3b3de573a2a1b2147c53d2d404a Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 10:24:05 -0500
Subject: [PATCH 103/113] revert vine_worker

---
 taskvine/src/worker/vine_worker.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/worker/vine_worker.c b/taskvine/src/worker/vine_worker.c
index 97a62695d3..ee5f404a8e 100644
--- a/taskvine/src/worker/vine_worker.c
+++ b/taskvine/src/worker/vine_worker.c
@@ -1704,7 +1704,7 @@ static void vine_worker_serve_manager(struct link *manager)
 		hence a maximum wait time of five seconds is enforced.
 		*/
 
-		int wait_msec = 0;
+		int wait_msec = 5000;
 
 		if (sigchld_received_flag) {
 			wait_msec = 0;

From 7d729aba4f4ba660bfbbe1ba6be5f40a8d5d5f36 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 15:54:21 -0500
Subject: [PATCH 104/113] support dask expressions

---
 .../graph/dagvine/blueprint_graph/.gitignore  |   2 +
 .../graph/dagvine/blueprint_graph/adaptor.py  |  72 ++++++++----
 .../dagvine/blueprint_graph/adaptor_test.py   |  17 ++-
 .../blueprint_graph/blueprint_graph.py        |  11 +-
 .../blueprint_graph/proxy_functions.py        |   7 +-
 taskvine/src/graph/dagvine/dagvine.py         | 107 +++++++++---------
 .../src/graph/dagvine/vine_graph/vine_graph.c |   7 +-
 7 files changed, 134 insertions(+), 89 deletions(-)
 create mode 100644 taskvine/src/graph/dagvine/blueprint_graph/.gitignore

diff --git a/taskvine/src/graph/dagvine/blueprint_graph/.gitignore b/taskvine/src/graph/dagvine/blueprint_graph/.gitignore
new file mode 100644
index 0000000000..60123e6dfc
--- /dev/null
+++ b/taskvine/src/graph/dagvine/blueprint_graph/.gitignore
@@ -0,0 +1,2 @@
+adaptor_test.py
+__pycache__/
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py b/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
index 3f5db28243..32d6045b8e 100644
--- a/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
+++ b/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
@@ -19,7 +19,7 @@
     # where the private module is unavailable or type-checkers can't resolve it).
     dts = None
 
-from ndcctools.taskvine.dagvine.blueprint_graph.blueprint_graph import TaskOutputRef
+from ndcctools.taskvine.dagvine.blueprint_graph.blueprint_graph import TaskOutputRef, BlueprintGraph
 
 
 def _identity(value):
@@ -32,8 +32,11 @@ class Adaptor:
 
     _LEAF_TYPES = (str, bytes, bytearray, memoryview, int, float, bool, type(None))
 
-    def __init__(self, collection_dict):
-        self.original_collection_dict = collection_dict
+    def __init__(self, task_dict):
+
+        if isinstance(task_dict, BlueprintGraph):
+            self.converted = task_dict
+            return
 
         # TaskSpec-only state used to "lift" inline Tasks that cannot be reduced to
         # a pure Python value (or would be unsafe/expensive to inline).
@@ -45,23 +48,23 @@ def __init__(self, collection_dict):
         # lifted keys remain visible across subsequent conversions/dedup/reference checks.
         self._task_keys = set()
 
-        normalized = self._normalize_task_dict(collection_dict)
-        self.task_dict = self._convert_to_blueprint_tasks(normalized)
+        normalized = self._normalize_task_dict(task_dict)
+        self.converted = self._convert_to_blueprint_tasks(normalized)
 
-    def _normalize_task_dict(self, collection_dict):
+    def _normalize_task_dict(self, task_dict):
         """Collapse every supported input style into a classic `{key: sexpr or TaskSpec}` mapping."""
         from_dask_collection = bool(
-            is_dask_collection and any(is_dask_collection(v) for v in collection_dict.values())
+            is_dask_collection and any(is_dask_collection(v) for v in task_dict.values())
         )
 
         if from_dask_collection:
-            task_dict = self._dask_collections_to_task_dict(collection_dict)
+            task_dict = self._dask_collections_to_task_dict(task_dict)
         else:
             # IMPORTANT: treat plain user dicts as DAGVine sexprs by default.
             # If we unconditionally run `dask._task_spec.convert_legacy_graph(...)` when
             # dts is available, Dask will interpret our "final Mapping is kwargs"
             # convention as a positional dict argument, breaking sexpr semantics.
-            task_dict = dict(collection_dict)
+            task_dict = dict(task_dict)
 
         # Only ask Dask to rewrite legacy graphs when we *know* the input came
         # from a Dask collection/HLG. This keeps classic DAGVine sexprs stable
@@ -227,10 +230,12 @@ def _should_wrap(self, obj, task_keys):
         """Decide whether a value should become a `TaskOutputRef`."""
         if isinstance(obj, self._LEAF_TYPES):
             if isinstance(obj, str):
-                return obj in task_keys
+                hit = obj in task_keys
+                return hit
             return False
         try:
-            return obj in task_keys
+            hit = obj in task_keys
+            return hit
         except TypeError:
             return False
 
@@ -238,25 +243,25 @@ def _should_wrap(self, obj, task_keys):
     # pipeline expects. DAGVine clients often hand us a dict like
     # {"result": dask.delayed(...)}; we merge the underlying HighLevelGraphs so
     # `ContextGraph` sees the same dict representation C does.
-    def _dask_collections_to_task_dict(self, collection_dict):
+    def _dask_collections_to_task_dict(self, task_dict):
         """Flatten Dask collections into the classic dict-of-task layout."""
         assert is_dask_collection is not None
         from dask.highlevelgraph import HighLevelGraph, ensure_dict
 
-        if not isinstance(collection_dict, dict):
+        if not isinstance(task_dict, dict):
             raise TypeError("Input must be a dict")
 
-        for k, v in collection_dict.items():
+        for k, v in task_dict.items():
             if not is_dask_collection(v):
                 raise TypeError(
                     f"Input must be a dict of DaskCollection, but found {k} with type {type(v)}"
                 )
 
         if dts:
-            sub_hlgs = [v.dask for v in collection_dict.values()]
+            sub_hlgs = [v.dask for v in task_dict.values()]
             hlg = HighLevelGraph.merge(*sub_hlgs).to_dict()
         else:
-            hlg = dask.base.collections_to_dsk(collection_dict.values())
+            hlg = dask.base.collections_to_dsk(task_dict.values())
 
         return ensure_dict(hlg)
 
@@ -299,18 +304,21 @@ def _unwrap_dts_operand(self, operand, task_keys, *, parent_key=None):
 
         literal_cls = getattr(dts, "Literal", None)
         if literal_cls and isinstance(operand, literal_cls):
-            return getattr(operand, "value", None)
+            value = getattr(operand, "value", None)
+            return value
 
         datanode_cls = getattr(dts, "DataNode", None)
         if datanode_cls and isinstance(operand, datanode_cls):
-            return operand.value
+            value = operand.value
+            return value
 
         nested_cls = getattr(dts, "NestedContainer", None)
         if nested_cls and isinstance(operand, nested_cls):
             payload = getattr(operand, "value", None)
             if payload is None:
                 payload = getattr(operand, "data", None)
-            return self._unwrap_dts_operand(payload, task_keys, parent_key=parent_key)
+            value = self._unwrap_dts_operand(payload, task_keys, parent_key=parent_key)
+            return value
 
         task_cls = getattr(dts, "Task", None)
         if task_cls and isinstance(operand, task_cls):
@@ -323,15 +331,31 @@ def _unwrap_dts_operand(self, operand, task_keys, *, parent_key=None):
             # Otherwise it is an inline expression. Reduce if safe, else lift.
             func = self._extract_callable_from_task(operand)
             if func is None:
-                return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+                out = self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+                return out
 
             # Special-case: Dask internal identity-cast wrappers should not be called
-            # during adaptation. Reduce structurally by returning the first argument.
+            # during adaptation. Reduce structurally by unwrapping all args and
+            # rebuilding the requested container type. This preserves dependency
+            # edges (critical for WCC) without executing arbitrary code.
             if self._is_identity_cast_op(func):
                 raw_args = getattr(operand, "args", ()) or ()
-                if not raw_args:
-                    return None
-                return self._unwrap_dts_operand(raw_args[0], task_keys, parent_key=parent_key)
+                raw_kwargs = getattr(operand, "kwargs", {}) or {}
+                typ = raw_kwargs.get("typ", None)
+
+                values = [self._unwrap_dts_operand(a, task_keys, parent_key=parent_key) for a in raw_args]
+
+                # Only allow safe container constructors here; otherwise lift.
+                safe_types = (list, tuple, set, frozenset, dict)
+                if typ in safe_types:
+                    try:
+                        casted = typ(values)
+                    except Exception:
+                        return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
+                    return casted
+
+                # Unknown/unsafe typ: lift so the worker executes the real op.
+                return self._lift_inline_task(operand, task_keys, parent_key=parent_key)
 
             if self._is_pure_value_op(func):
                 reduced, used_lift = self._reduce_inline_task(operand, task_keys, parent_key=parent_key)
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py b/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py
index ce1a23fe68..d641ecea64 100644
--- a/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py
+++ b/taskvine/src/graph/dagvine/blueprint_graph/adaptor_test.py
@@ -501,7 +501,8 @@ def fake_identity_cast(x, *_, **__):
         fake_identity_cast.__module__ = "dask._fake"
 
         graph = {
-            "raw": _FakeDataNode(value=5),
+            "raw0": _FakeDataNode(value=5),
+            "raw1": _FakeDataNode(value=6),
             "outer": _FakeTask(
                 key="outer",
                 function=lambda x: x,
@@ -509,7 +510,11 @@ def fake_identity_cast(x, *_, **__):
                     _FakeTask(
                         key=None,
                         function=fake_identity_cast,
-                        args=(_FakeTaskRef("raw"),),
+                        args=(
+                            _FakeTaskRef("raw0"),
+                            _FakeTaskRef("raw1"),
+                        ),
+                        kwargs={"typ": list},
                     ),
                 ),
             ),
@@ -519,8 +524,12 @@ def fake_identity_cast(x, *_, **__):
         _, outer_args, outer_kwargs = adapted["outer"]
         self.assertEqual(outer_kwargs, {})
         self.assertEqual(len(outer_args), 1)
-        self.assertIsInstance(outer_args[0], TaskOutputRef)
-        self.assertEqual(outer_args[0].task_key, "raw")
+        self.assertIsInstance(outer_args[0], list)
+        self.assertEqual(len(outer_args[0]), 2)
+        self.assertIsInstance(outer_args[0][0], TaskOutputRef)
+        self.assertIsInstance(outer_args[0][1], TaskOutputRef)
+        self.assertEqual(outer_args[0][0].task_key, "raw0")
+        self.assertEqual(outer_args[0][1].task_key, "raw1")
         self.assertFalse(any(str(k).startswith("__lift__") for k in adapted.keys()))
 
 
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py b/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py
index 4439a76d42..0ff1c6caa1 100644
--- a/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py
+++ b/taskvine/src/graph/dagvine/blueprint_graph/blueprint_graph.py
@@ -8,6 +8,8 @@
 import cloudpickle
 
 
+# Lightweight wrapper around task results that optionally pads the payload. The
+# padding lets tests model large outputs without altering the logical result.
 class TaskOutputWrapper:
     def __init__(self, result, extra_size_mb=None):
         self.result = result
@@ -24,6 +26,7 @@ def load_from_path(path):
             raise FileNotFoundError(f"Task result file not found at {path}")
 
 
+# A reference to a task output. This is used to represent the output of a task as a dependency of another task.
 class TaskOutputRef:
     __slots__ = ("task_key", "path")
 
@@ -37,6 +40,8 @@ def __getitem__(self, key):
         return TaskOutputRef(self.task_key, self.path + (key,))
 
 
+# The BlueprintGraph is a directed acyclic graph (DAG) that represents the logical dependencies between tasks.
+# It is used to build the C vine graph.
 class BlueprintGraph:
 
     _LEAF_TYPES = (str, bytes, bytearray, memoryview, int, float, bool, type(None))
@@ -55,6 +60,9 @@ def __init__(self):
         self.pykey2cid = {}                  # py_key -> c_id
         self.cid2pykey = {}                  # c_id -> py_key
 
+        self.extra_task_output_size_mb = {}  # task_key -> extra size in MB
+        self.extra_task_sleep_time = {}      # task_key -> extra sleep time in seconds
+
     def _visit_task_output_refs(self, obj, on_ref, *, rewrite: bool):
         seen = set()
 
@@ -154,7 +162,7 @@ def task_consumes(self, task_key, *filenames):
 
     def save_task_output(self, task_key, output):
         with open(self.outfile_remote_name[task_key], "wb") as f:
-            wrapped_output = TaskOutputWrapper(output, extra_size_mb=0)
+            wrapped_output = TaskOutputWrapper(output, extra_size_mb=self.extra_task_output_size_mb[task_key])
             cloudpickle.dump(wrapped_output, f)
 
     def load_task_output(self, task_key):
@@ -191,6 +199,7 @@ def verify_topo(g, topo):
         print("topo verified: ok")
 
     def finalize(self):
+        # build the dependencies determined by files produced and consumed
         for file, producer in self.producer_of.items():
             for consumer in self.consumers_of.get(file, ()):
                 self.parents_of[consumer].add(producer)
diff --git a/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py b/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py
index 7c3c5ecf4f..0c50e6201c 100644
--- a/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py
+++ b/taskvine/src/graph/dagvine/blueprint_graph/proxy_functions.py
@@ -4,6 +4,7 @@
 
 
 from ndcctools.taskvine.utils import load_variable_from_library
+import time
 
 
 def compute_task(bg, task_expr):
@@ -33,10 +34,6 @@ def on_ref(r):
     r_args = bg._visit_task_output_refs(args, on_ref, rewrite=True)
     r_kwargs = bg._visit_task_output_refs(kwargs, on_ref, rewrite=True)
 
-    print(f"func: {func}")
-    print(f"r_args: {r_args}")
-    print(f"r_kwargs: {r_kwargs}")
-
     return func(*r_args, **r_kwargs)
 
 
@@ -48,4 +45,6 @@ def compute_single_key(vine_key):
 
     output = compute_task(bg, task_expr)
 
+    time.sleep(bg.extra_task_sleep_time[task_key])
+
     bg.save_task_output(task_key, output)
diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/dagvine/dagvine.py
index 663102daec..1869e25540 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -15,6 +15,7 @@
 import os
 import signal
 import json
+import random
 
 
 def context_loader_func(graph_pkl):
@@ -133,6 +134,7 @@ def __init__(self,
         print(f"=== Manager name: {color_text(self.name, 92)}")
         print(f"=== Manager port: {color_text(self.port, 92)}")
         print(f"=== Runtime directory: {color_text(self.runtime_directory, 92)}")
+        self._sigint_received = False
 
     def param(self, param_name):
         """Convenience accessor so callers can read tuned parameters at runtime."""
@@ -163,23 +165,18 @@ def tune_vine_graph(self, vine_graph):
         for k, v in self.params.vine_graph_tuning_params.items():
             vine_graph.tune(k, str(v))
 
-    def build_context_graph(self, task_dict):
-        """Construct the Python-side DAG wrapper (ContextGraph)."""
-        context_graph = ContextGraph(
-            task_dict,
-            extra_task_output_size_mb=self.param("extra-task-output-size-mb"),
-            extra_task_sleep_time=self.param("extra-task-sleep-time")
-        )
-
-        return context_graph
-
     def build_blueprint_graph(self, task_dict):
-        bg = BlueprintGraph()
+        if isinstance(task_dict, BlueprintGraph):
+            bg = task_dict
+        else:
+            bg = BlueprintGraph()
 
-        for k, v in task_dict.items():
-            func, args, kwargs = v
-            assert callable(func), f"Task {k} does not have a callable"
-            bg.add_task(k, func, *args, **kwargs)
+            for k, v in task_dict.items():
+                func, args, kwargs = v
+                assert callable(func), f"Task {k} does not have a callable"
+                bg.add_task(k, func, *args, **kwargs)
+
+        bg.finalize()
 
         return bg
 
@@ -213,14 +210,18 @@ def build_vine_graph(self, py_graph, target_keys):
 
         return vine_graph
 
-    def build_graphs(self, task_dict, target_keys, blueprint_graph=False):
-        """Create both the ContextGraph and its C counterpart, wiring outputs for later use."""
-        # Build the logical (Python) DAG.
-        if blueprint_graph == False:
-            py_graph = self.build_context_graph(task_dict)
-        else:
-            py_graph = self.build_blueprint_graph(task_dict)
-        # Build the physical (C) DAG.
+    def build_graphs(self, task_dict, target_keys):
+        """Create both the python side graph and its C counterpart, wiring outputs for later use."""
+        # Build the python side graph.
+        py_graph = self.build_blueprint_graph(task_dict)
+
+        # filter out target keys that are not in the collection dict
+        missing_keys = [k for k in target_keys if k not in py_graph.task_dict]
+        if missing_keys:
+            print(f"=== Warning: the following target keys are not in the graph: {','.join(map(str, missing_keys))}")
+        target_keys = list(set(target_keys) - set(missing_keys))
+
+        # Build the c side graph.
         vine_graph = self.build_vine_graph(py_graph, target_keys)
 
         # Cross-fill the outfile locations so the runtime graph knows where to read/write.
@@ -231,7 +232,7 @@ def build_graphs(self, task_dict, target_keys, blueprint_graph=False):
         return py_graph, vine_graph
 
     def create_proxy_library(self, py_graph, vine_graph, hoisting_modules, env_files):
-        """Package up the context_graph as a TaskVine library."""
+        """Package up the python side graph as a TaskVine library."""
         proxy_library = ProxyLibrary(self)
         proxy_library.add_hoisting_modules(hoisting_modules)
         proxy_library.add_env_files(env_files)
@@ -241,46 +242,42 @@ def create_proxy_library(self, py_graph, vine_graph, hoisting_modules, env_files
 
         return proxy_library
 
-    def run(self, collection_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}):
+    def run(self, task_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}, adapt_dask=False):
         """High-level entry point: normalise input, build graphs, ship the library, execute, and return results."""
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
-        # filter out target keys that are not in the collection dict
-        missing_keys = [k for k in target_keys if k not in collection_dict]
-        if missing_keys:
-            print(f"=== Warning: the following target keys are not in the collection dict:")
-            for k in missing_keys:
-                print(f"             {k}")
-        target_keys = list(set(target_keys) - set(missing_keys))
-
-        task_dict = Adaptor(collection_dict).task_dict
+        if adapt_dask:
+            task_dict = Adaptor(task_dict).converted
 
         # Build both the Python DAG and its C mirror.
-        py_graph, vine_graph = self.build_graphs(task_dict, target_keys, blueprint_graph=True)
+        py_graph, vine_graph = self.build_graphs(task_dict, target_keys)
 
-        # Ship the execution context to workers via a proxy library.
+        # set extra task output size and sleep time for each task
+        for k in py_graph.task_dict:
+            py_graph.extra_task_output_size_mb[k] = random.uniform(*self.param("extra-task-output-size-mb"))
+            py_graph.extra_task_sleep_time[k] = random.uniform(*self.param("extra-task-sleep-time"))
+
+        # Ship the execution context to workers via a proxy library
         proxy_library = self.create_proxy_library(py_graph, vine_graph, hoisting_modules, env_files)
         proxy_library.install()
 
-        print(f"=== Library serialized size: {color_text(proxy_library.get_context_size(), 92)} MB")
-
-        # Kick off execution on the C side.
-        vine_graph.execute()
-
-        # Tear down once we're done so successive runs start clean.
-        proxy_library.uninstall()
-
-        # Delete the C graph immediately so its lifetime matches the run.
-        vine_graph.delete()
-
-        # Load any requested target outputs back into Python land.
-        results = {}
-        for k in target_keys:
-            outfile_path = os.path.join(self.param("output-dir"), py_graph.outfile_remote_name[k])
-            results[k] = TaskOutputWrapper.load_from_path(outfile_path)
-        return results
+        try:
+            print(f"=== Library serialized size: {color_text(proxy_library.get_context_size(), 92)} MB")
+            vine_graph.execute()
+            results = {}
+            for k in target_keys:
+                if k not in py_graph.task_dict:
+                    continue
+                outfile_path = os.path.join(self.param("output-dir"), py_graph.outfile_remote_name[k])
+                results[k] = TaskOutputWrapper.load_from_path(outfile_path)
+            return results
+        finally:
+            try:
+                proxy_library.uninstall()
+            finally:
+                vine_graph.delete()
 
     def _on_sigint(self, signum, frame):
-        """SIGINT handler that delegates to Manager cleanup so workers are released promptly."""
-        self.__del__()
+        self._sigint_received = True
+        raise KeyboardInterrupt
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 4f7ada468b..3a582aa0ed 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -1112,7 +1112,7 @@ void vine_graph_execute(struct vine_graph *vg)
 		return;
 	}
 
-	signal(SIGINT, handle_sigint);
+	void (*previous_sigint_handler)(int) = signal(SIGINT, handle_sigint);
 
 	debug(D_VINE, "start executing vine graph");
 
@@ -1328,6 +1328,11 @@ void vine_graph_execute(struct vine_graph *vg)
 		print_time_metrics(vg, vg->time_metrics_filename);
 	}
 
+	signal(SIGINT, previous_sigint_handler);
+	if (interrupted) {
+		raise(SIGINT);
+	}
+
 	return;
 }
 

From a7d05b19891b85f387692e5cd4864f2af5d10f93 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 16:10:56 -0500
Subject: [PATCH 105/113] gitignore

---
 taskvine/src/graph/dagvine/.gitignore         |   3 +-
 .../src/graph/dagvine/context_graph/Makefile  |  31 ---
 .../graph/dagvine/context_graph/__init__.py   |  18 --
 .../src/graph/dagvine/context_graph/core.py   | 183 ------------------
 .../dagvine/context_graph/proxy_functions.py  | 111 -----------
 .../dagvine/context_graph/proxy_library.py    |  94 ---------
 6 files changed, 2 insertions(+), 438 deletions(-)
 delete mode 100644 taskvine/src/graph/dagvine/context_graph/Makefile
 delete mode 100644 taskvine/src/graph/dagvine/context_graph/__init__.py
 delete mode 100644 taskvine/src/graph/dagvine/context_graph/core.py
 delete mode 100644 taskvine/src/graph/dagvine/context_graph/proxy_functions.py
 delete mode 100644 taskvine/src/graph/dagvine/context_graph/proxy_library.py

diff --git a/taskvine/src/graph/dagvine/.gitignore b/taskvine/src/graph/dagvine/.gitignore
index 38280b8491..25000a1241 100644
--- a/taskvine/src/graph/dagvine/.gitignore
+++ b/taskvine/src/graph/dagvine/.gitignore
@@ -3,4 +3,5 @@
 *.o
 *_wrap.c
 *_wrap.0
-build/
\ No newline at end of file
+build/
+context_graph/
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/context_graph/Makefile b/taskvine/src/graph/dagvine/context_graph/Makefile
deleted file mode 100644
index a356267995..0000000000
--- a/taskvine/src/graph/dagvine/context_graph/Makefile
+++ /dev/null
@@ -1,31 +0,0 @@
-include ../../../../../config.mk
-include ../../../../../rules.mk
-
-PROJECT_NAME = dagvine
-
-SOURCE_DIR = $(CCTOOLS_HOME)/taskvine/src/graph/$(PROJECT_NAME)/context_graph
-MODULE_ROOT = $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/$(PROJECT_NAME)
-MODULE_DIR = $(MODULE_ROOT)/context_graph
-
-PY_SOURCES = $(wildcard $(SOURCE_DIR)/*.py)
-
-.PHONY: all install clean lint format
-
-all:
-	@true
-
-install:
-	mkdir -p $(MODULE_DIR)
-	cp $(PY_SOURCES) $(MODULE_DIR)
-
-clean:
-	rm -rf __pycache__
-
-lint:
-	flake8 --ignore=$(CCTOOLS_FLAKE8_IGNORE_ERRORS) \
-		--exclude=$(CCTOOLS_FLAKE8_IGNORE_FILES) \
-		$(SOURCE_DIR)/
-
-format:
-	@true
-
diff --git a/taskvine/src/graph/dagvine/context_graph/__init__.py b/taskvine/src/graph/dagvine/context_graph/__init__.py
deleted file mode 100644
index 7d8b678cc5..0000000000
--- a/taskvine/src/graph/dagvine/context_graph/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# Copyright (C) 2025 The University of Notre Dame
-# This software is distributed under the GNU General Public License.
-# See the file COPYING for details.
-
-
-from .core import ContextGraph, ContextGraphTaskResult
-from .proxy_functions import compute_single_key, compute_dts_key, compute_sexpr_key
-from .proxy_library import ProxyLibrary
-
-
-__all__ = [
-    "ContextGraph",
-    "ContextGraphTaskResult",
-    "compute_single_key",
-    "compute_dts_key",
-    "compute_sexpr_key",
-    "ProxyLibrary",
-]
diff --git a/taskvine/src/graph/dagvine/context_graph/core.py b/taskvine/src/graph/dagvine/context_graph/core.py
deleted file mode 100644
index 9d0f3ac1c4..0000000000
--- a/taskvine/src/graph/dagvine/context_graph/core.py
+++ /dev/null
@@ -1,183 +0,0 @@
-# Copyright (C) 2025 The University of Notre Dame
-# This software is distributed under the GNU General Public License.
-# See the file COPYING for details.
-
-import cloudpickle
-import collections
-import random
-from collections import deque
-
-# Attempt to import Dask helpers. When they are unavailable we fall back to
-# None so environments without Dask continue to work. If Dask is present—either
-# the legacy graph or the newer TaskSpec API—we normalize it into our internal
-# task representation.
-try:
-    import dask
-except ImportError:
-    dask = None
-try:
-    import dask._task_spec as dts
-except ImportError:
-    dts = None
-
-
-def hashable(s):
-    """Used while wiring dependencies to spot values we can treat as node keys."""
-    try:
-        hash(s)
-        return True
-    except TypeError:
-        return False
-
-
-# Lightweight wrapper around task results that optionally pads the payload. The
-# padding lets tests model large outputs without altering the logical result.
-class ContextGraphTaskResult:
-    def __init__(self, result, extra_size_mb=None):
-        """Store the real user result plus optional padding used during regression tests."""
-        self.result = result
-        self.extra_obj = bytearray(int(extra_size_mb * 1024 * 1024)) if extra_size_mb and extra_size_mb > 0 else None
-
-    @staticmethod
-    def load_from_path(path):
-        """Workers call this while recovering an output produced by save_result_of_key from disk.
-        If a node-local output, then data is stored in the task sandbox and the path is just the filename
-        If a shared file system output, then path is the full path to the file
-        If a target result, the path is the full path to the file in the manager's output directory"""
-        try:
-            with open(path, "rb") as f:
-                result_obj = cloudpickle.load(f)
-                assert isinstance(result_obj, ContextGraphTaskResult), "Loaded object is not of type ContextGraphTaskResult"
-                return result_obj.result
-        except FileNotFoundError:
-            raise FileNotFoundError(f"Output file not found at {path}")
-
-
-# ContextGraph builds the logical DAG and manages dependencies. The
-# object is cloudpickled, shipped with the proxy library, and hoisted on worker
-# nodes. When a task key executes we map from the Vine key back to the original
-# graph key, run the user function, and persist the result.
-class ContextGraph:
-    def __init__(self, task_dict,
-                 extra_task_output_size_mb=[0, 0],
-                 extra_task_sleep_time=[0, 0]):
-        """Capture the Python DAG that DAGVine hands us before we mirror it in C."""
-        self.task_dict = task_dict
-
-        if dts:
-            for k, v in self.task_dict.items():
-                if isinstance(v, dts.GraphNode):
-                    assert isinstance(v, (dts.Alias, dts.Task, dts.DataNode)), f"Unsupported task type for key {k}: {v.__class__}"
-
-        self.parents_of, self.children_of = self._build_dependencies(self.task_dict)
-
-        # these mappings are set after node ids are assigned in the C vine graph
-        self.pykey2cid = {}
-        self.cid2pykey = {}
-
-        # will be set from vine graph
-        self.outfile_remote_name = {key: None for key in self.task_dict.keys()}
-
-        # testing params
-        self.extra_task_output_size_mb = self._calculate_extra_size_mb_of(extra_task_output_size_mb)
-        self.extra_sleep_time_of = self._calculate_extra_sleep_time_of(extra_task_sleep_time)
-
-    def _calculate_extra_size_mb_of(self, extra_task_output_size_mb):
-        """Sample a uniform byte budget between low/high for every node."""
-        assert isinstance(extra_task_output_size_mb, list) and len(extra_task_output_size_mb) == 2
-        low, high = extra_task_output_size_mb
-        low, high = int(low), int(high)
-        assert low <= high
-
-        return {k: random.uniform(low, high) for k in self.task_dict.keys()}
-
-    def _calculate_extra_sleep_time_of(self, extra_task_sleep_time):
-        """Pick a uniform delay between low/high so tests can fake runtime."""
-        assert isinstance(extra_task_sleep_time, list) and len(extra_task_sleep_time) == 2
-        low, high = extra_task_sleep_time
-        low, high = int(low), int(high)
-        assert low <= high
-
-        return {k: random.uniform(low, high) for k in self.task_dict.keys()}
-
-    def is_dts_key(self, k):
-        """Gate the Dask-specific branch when we parse task definitions."""
-        if not hasattr(dask, "_task_spec"):
-            return False
-        import dask._task_spec as dts
-        return isinstance(self.task_dict[k], (dts.Task, dts.TaskRef, dts.Alias, dts.DataNode, dts.NestedContainer))
-
-    def _build_dependencies(self, task_dict):
-        """Normalize mixed Dask/s-expression inputs into our parent/child lookup tables."""
-        def _find_sexpr_parents(sexpr):
-            """Resolve the immediate parents inside one symbolic expression node."""
-            if hashable(sexpr) and sexpr in task_dict.keys():
-                return {sexpr}
-            elif isinstance(sexpr, (list, tuple)):
-                deps = set()
-                for x in sexpr:
-                    deps |= _find_sexpr_parents(x)
-                return deps
-            elif isinstance(sexpr, dict):
-                deps = set()
-                for k, v in sexpr.items():
-                    deps |= _find_sexpr_parents(k)
-                    deps |= _find_sexpr_parents(v)
-                return deps
-            else:
-                return set()
-
-        parents_of = collections.defaultdict(set)
-        children_of = collections.defaultdict(set)
-
-        for k, value in task_dict.items():
-            if self.is_dts_key(k):
-                # in the new Dask expression, each value is an object from dask._task_spec, could be
-                # a Task, Alias, TaskRef, etc., but they all share the same base class the dependencies
-                # field is of type frozenset(), without recursive ancestor dependencies involved
-                parents_of[k] = value.dependencies
-            else:
-                # the value could be a sexpr, e.g., the old Dask representation
-                parents_of[k] = _find_sexpr_parents(value)
-
-        for k, deps in parents_of.items():
-            for dep in deps:
-                children_of[dep].add(k)
-
-        return parents_of, children_of
-
-    def save_result_of_key(self, key, result):
-        """Called from the proxy function to persist a result into disk after the worker finishes."""
-        with open(self.outfile_remote_name[key], "wb") as f:
-            result_obj = ContextGraphTaskResult(result, extra_size_mb=self.extra_task_output_size_mb[key])
-            cloudpickle.dump(result_obj, f)
-
-    def load_result_of_key(self, key):
-        """Used by downstream tasks to pull inputs from disk or the shared store."""
-        # workers user this function to load results from either local or shared file system
-        # if a node-local output, then data is stored in the task sandbox and the remote name is just the filename
-        # if a shared file system output, then remote name is the full path to the file
-        outfile_path = self.outfile_remote_name[key]
-        return ContextGraphTaskResult.load_from_path(outfile_path)
-
-    def get_topological_order(self):
-        """Produce the order DAGVine uses when assigning node IDs to the C graph."""
-        in_degree = {key: len(self.parents_of[key]) for key in self.task_dict.keys()}
-        queue = deque([key for key, degree in in_degree.items() if degree == 0])
-        topo_order = []
-
-        while queue:
-            current = queue.popleft()
-            topo_order.append(current)
-
-            for child in self.children_of[current]:
-                in_degree[child] -= 1
-                if in_degree[child] == 0:
-                    queue.append(child)
-
-        if len(topo_order) != len(self.task_dict):
-            print(f"len(topo_order): {len(topo_order)}")
-            print(f"len(self.task_dict): {len(self.task_dict)}")
-            raise ValueError("Failed to create topo order, the dependencies may be cyclic or problematic")
-
-        return topo_order
diff --git a/taskvine/src/graph/dagvine/context_graph/proxy_functions.py b/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
deleted file mode 100644
index db14b1c356..0000000000
--- a/taskvine/src/graph/dagvine/context_graph/proxy_functions.py
+++ /dev/null
@@ -1,111 +0,0 @@
-# Copyright (C) 2025- The University of Notre Dame
-# This software is distributed under the GNU General Public License.
-# See the file COPYING for details.
-
-import os
-import time
-from ndcctools.taskvine.utils import load_variable_from_library
-
-
-def compute_dts_key(context_graph, k, v):
-    """
-    Compute the result of a Dask task node from dask._task_spec.
-
-    Each value `v` may be an instance of Task, Alias, or DataNode, all of which
-    inherit from the same base class. The `dependencies` field is a frozenset
-    containing direct dependencies only (no recursive ancestry).
-
-    The function resolves each dependency from the context_graph, constructs an
-    input dictionary, and then executes the node according to its type.
-    """
-    try:
-        import dask._task_spec as dts
-    except ImportError:
-        raise ImportError("Dask is not installed")
-
-    input_dict = {dep: context_graph.load_result_of_key(dep) for dep in v.dependencies}
-
-    try:
-        if isinstance(v, dts.Alias):
-            assert len(v.dependencies) == 1, "Expected exactly one dependency"
-            return context_graph.load_result_of_key(next(iter(v.dependencies)))
-        elif isinstance(v, dts.Task):
-            return v(input_dict)
-        elif isinstance(v, dts.DataNode):
-            return v.value
-        else:
-            raise TypeError(f"unexpected node type: {type(v)} for key {k}")
-    except Exception as e:
-        raise Exception(f"Error while executing task {k}: {e}")
-
-
-def compute_sexpr_key(context_graph, k, v):
-    """
-    Evaluate a symbolic expression (S-expression) task within the task graph.
-
-    Both DAGVine and legacy Dask represent computations as symbolic
-    expression trees (S-expressions). Each task value `v` encodes a nested
-    structure where:
-      - Leaf nodes are constants or task keys referencing parent results.
-      - Lists are recursively evaluated.
-      - Tuples of the form (func, arg1, arg2, ...) represent function calls.
-
-    This function builds an input dictionary from all parent keys, then
-    recursively resolves and executes the expression until a final value
-    is produced.
-    """
-    input_dict = {parent: context_graph.load_result_of_key(parent) for parent in context_graph.parents_of[k]}
-
-    def _rec_call(expr):
-        try:
-            if expr in input_dict.keys():
-                return input_dict[expr]
-        except TypeError:
-            pass
-        if isinstance(expr, list):
-            return [_rec_call(e) for e in expr]
-        if isinstance(expr, tuple) and len(expr) > 0 and callable(expr[0]):
-            res = expr[0](*[_rec_call(a) for a in expr[1:]])
-            return res
-        return expr
-
-    try:
-        return _rec_call(v)
-    except Exception as e:
-        raise Exception(f"Failed to invoke _rec_call(): {e}")
-
-
-def compute_single_key(vine_key):
-    """
-    Compute a single task identified by a Vine key within the current ContextGraph.
-
-    The function retrieves the corresponding graph key and task object from the
-    global context_graph, determines the task type, and dispatches to the appropriate
-    execution interface — e.g., `compute_dts_key` for Dask-style task specs or
-    `compute_sexpr_key` for S-expression graphs.
-
-    This design allows extensibility: for new graph representations, additional
-    compute interfaces can be introduced and registered here to handle new key types.
-
-    After computation, the result is saved, the output file is validated, and
-    an optional delay (`extra_sleep_time_of`) is applied before returning.
-    """
-    context_graph = load_variable_from_library('graph')
-
-    k = context_graph.cid2pykey[vine_key]
-    v = context_graph.task_dict[k]
-
-    if context_graph.is_dts_key(k):
-        result = compute_dts_key(context_graph, k, v)
-    else:
-        result = compute_sexpr_key(context_graph, k, v)
-
-    context_graph.save_result_of_key(k, result)
-    if not os.path.exists(context_graph.outfile_remote_name[k]):
-        raise Exception(f"Output file {context_graph.outfile_remote_name[k]} does not exist after writing")
-    if os.stat(context_graph.outfile_remote_name[k]).st_size == 0:
-        raise Exception(f"Output file {context_graph.outfile_remote_name[k]} is empty after writing")
-
-    time.sleep(context_graph.extra_sleep_time_of[k])
-
-    return True
diff --git a/taskvine/src/graph/dagvine/context_graph/proxy_library.py b/taskvine/src/graph/dagvine/context_graph/proxy_library.py
deleted file mode 100644
index 4d0873e667..0000000000
--- a/taskvine/src/graph/dagvine/context_graph/proxy_library.py
+++ /dev/null
@@ -1,94 +0,0 @@
-# Copyright (C) 2025- The University of Notre Dame
-# This software is distributed under the GNU General Public License.
-# See the file COPYING for details.
-
-import os
-import uuid
-import cloudpickle
-import types
-import time
-import random
-import hashlib
-import collections
-
-from ndcctools.taskvine.dagvine.context_graph.core import ContextGraphTaskResult, ContextGraph
-from ndcctools.taskvine.dagvine.context_graph.proxy_functions import compute_dts_key, compute_sexpr_key, compute_single_key
-from ndcctools.taskvine.utils import load_variable_from_library
-
-
-class ProxyLibrary:
-    def __init__(self, py_manager):
-        self.py_manager = py_manager
-
-        self.name = None
-        self.libcores = None
-
-        self.libtask = None
-
-        # these modules are always included in the preamble of the library task, so that function calls can execute directly
-        # using the loaded context without importing them over and over again
-        self.hoisting_modules = [
-            os, cloudpickle, ContextGraphTaskResult, ContextGraph, uuid, hashlib, random, types, collections, time,
-            load_variable_from_library, compute_dts_key, compute_sexpr_key, compute_single_key
-        ]
-
-        # environment files serve as additional inputs to the library task, where each key is the local path and the value is the remote path
-        # those local files will be sent remotely to the workers so tasks can access them as appropriate
-        self.env_files = {}
-
-        # context loader is a function that will be used to load the library context on remote nodes.
-        self.context_loader_func = None
-        self.context_loader_args = []
-        self.context_loader_kwargs = {}
-
-        self.local_path = None
-        self.remote_path = None
-
-    def set_libcores(self, libcores):
-        self.libcores = libcores
-
-    def set_name(self, name):
-        self.name = name
-
-    def add_hoisting_modules(self, new_modules):
-        assert isinstance(new_modules, list), "new_modules must be a list of modules"
-        self.hoisting_modules.extend(new_modules)
-
-    def add_env_files(self, new_env_files):
-        assert isinstance(new_env_files, dict), "new_env_files must be a dictionary"
-        self.env_files.update(new_env_files)
-
-    def set_context_loader(self, context_loader_func, context_loader_args=[], context_loader_kwargs={}):
-        self.context_loader_func = context_loader_func
-        self.context_loader_args = context_loader_args
-        self.context_loader_kwargs = context_loader_kwargs
-
-    def get_context_size(self):
-        dumped_data = self.context_loader_args[0]
-        serialized = round(len(dumped_data) / 1024 / 1024, 2)
-        return serialized
-
-    def install(self):
-        assert self.name is not None, "Library name must be set before installing (use set_name method)"
-        assert self.libcores is not None, "Library cores must be set before installing (use set_libcores method)"
-
-        self.libtask = self.py_manager.create_library_from_functions(
-            self.name,
-            compute_single_key,
-            library_context_info=[self.context_loader_func, self.context_loader_args, self.context_loader_kwargs],
-            add_env=False,
-            function_infile_load_mode="json",
-            hoisting_modules=self.hoisting_modules,
-        )
-        for local, remote in self.env_files.items():
-            # check if the local file exists
-            if not os.path.exists(local):
-                raise FileNotFoundError(f"Local file {local} not found")
-            # attach as the input file to the library task
-            self.libtask.add_input(self.py_manager.declare_file(local, cache=True, peer_transfer=True), remote)
-        self.libtask.set_cores(self.libcores)
-        self.libtask.set_function_slots(self.libcores)
-        self.py_manager.install_library(self.libtask)
-
-    def uninstall(self):
-        self.py_manager.remove_library(self.name)

From 23331bf27d982d4b577fdb1ca6507ed367accbc7 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 16:13:36 -0500
Subject: [PATCH 106/113] remove context graph from makefile

---
 taskvine/src/graph/dagvine/Makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/taskvine/src/graph/dagvine/Makefile b/taskvine/src/graph/dagvine/Makefile
index 1bfc711036..6e08b844bd 100644
--- a/taskvine/src/graph/dagvine/Makefile
+++ b/taskvine/src/graph/dagvine/Makefile
@@ -2,7 +2,7 @@ include ../../../../config.mk
 include ../../../../rules.mk
 
 MODULE_DIR := $(CCTOOLS_PYTHON3_PATH)/ndcctools/taskvine/dagvine
-SUBDIRS    := context_graph vine_graph blueprint_graph
+SUBDIRS    := vine_graph blueprint_graph
 
 .PHONY: all install clean lint format $(SUBDIRS)
 

From 6f6aca5ba3d247c5b6a4245f986ab3acb0561b4f Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 21:54:17 -0500
Subject: [PATCH 107/113] convert bg to dask expr

---
 .../graph/dagvine/blueprint_graph/adaptor.py  | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py b/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
index 32d6045b8e..20cd935012 100644
--- a/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
+++ b/taskvine/src/graph/dagvine/blueprint_graph/adaptor.py
@@ -27,6 +27,47 @@ def _identity(value):
     return value
 
 
+def _apply_with_kwargs_kvlist(func, args_list, kwargs_kvlist):
+    """Execute `func(*args_list, **kwargs)` where kwargs is encoded as a list of [k, v] pairs.
+
+    This encoding is intentional: `dask_executor.execute_graph_vertex.rec_call` only recurses
+    into lists and task tuples, not dicts/tuples. By representing kwargs as lists, upstream
+    task-key references can be resolved before we rebuild the dict here.
+    """
+    kwargs = {k: v for (k, v) in kwargs_kvlist}
+    return func(*args_list, **kwargs)
+
+
+def collections_from_blueprint_graph(bg):
+    assert isinstance(bg, BlueprintGraph), "bg must be a BlueprintGraph"
+
+    def _ref_to_key(ref: TaskOutputRef):
+        # Replace TaskOutputRef occurrences with the referenced task_key only.
+        # NOTE: This intentionally drops any `path` component on the ref, per request.
+        return ref.task_key
+
+    out = {}
+    for task_key, (func, args, kwargs) in bg.task_dict.items():
+        # Only rewrite references inside args/kwargs; keep everything else unchanged.
+        new_args = bg._visit_task_output_refs(args, _ref_to_key, rewrite=True)
+        new_kwargs = bg._visit_task_output_refs(kwargs, _ref_to_key, rewrite=True)
+
+        # IMPORTANT: `dask_executor.execute_graph_vertex` expects classic Dask sexprs:
+        #   (func, arg1, arg2, ...)
+        # It does not understand the BlueprintGraph triple (func, args_tuple, kwargs_dict),
+        # and it also does not recurse into dicts. So:
+        # - No-kwargs tasks become (func, *args)
+        # - Kwargs tasks become (_apply_with_kwargs_kvlist, func, [*args], [[k, v], ...])
+        if new_kwargs:
+            args_list = list(new_args)
+            kwargs_kvlist = [[k, v] for k, v in new_kwargs.items()]
+            out[task_key] = (_apply_with_kwargs_kvlist, func, args_list, kwargs_kvlist)
+        else:
+            out[task_key] = (func, *new_args)
+
+    return out
+
+
 class Adaptor:
     """Normalize user task inputs so `BlueprintGraph` can consume them without extra massaging."""
 

From a4d078df2452aceecf65f7b4c8267085d13ad698 Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 8 Jan 2026 23:19:47 -0500
Subject: [PATCH 108/113] support internal in/out

---
 taskvine/src/graph/dagvine/dagvine.py         | 13 +++-
 .../src/graph/dagvine/vine_graph/vine_graph.c | 65 +++++++++++++++++++
 .../src/graph/dagvine/vine_graph/vine_graph.h | 16 +++++
 .../dagvine/vine_graph/vine_graph_client.py   | 14 ++++
 taskvine/src/manager/vine_manager.c           |  1 +
 5 files changed, 108 insertions(+), 1 deletion(-)

diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/dagvine/dagvine.py
index 1869e25540..ddba9f673b 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -57,7 +57,8 @@ def __init__(self):
             "attempt-schedule-depth": 10000,
             "temp-replica-count": 1,
             "enforce-worker-eviction-interval": -1,
-            "balance-worker-disk-load": 0,
+            "shift-disk-load": 0,
+            "clean-redundant-replicas": 0,
         }
         # VineGraph-level knobs: forwarded to the underlying vine graph via VineGraphClient.
         self.vine_graph_tuning_params = {
@@ -229,6 +230,16 @@ def build_graphs(self, task_dict, target_keys):
             outfile_remote_name = vine_graph.get_node_outfile_remote_name(k)
             py_graph.outfile_remote_name[k] = outfile_remote_name
 
+        # For each task, declare the input and output files in the vine graph
+        for filename in py_graph.producer_of:
+            task_key = py_graph.producer_of[filename]
+            print(f"adding output file {filename} to task {task_key}")
+            vine_graph.add_task_output(task_key, filename)
+        for filename in py_graph.consumers_of:
+            for task_key in py_graph.consumers_of[filename]:
+                print(f"adding input file {filename} to task {task_key}")
+                vine_graph.add_task_input(task_key, filename)
+
         return py_graph, vine_graph
 
     def create_proxy_library(self, py_graph, vine_graph, hoisting_modules, env_files):
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 3a582aa0ed..fb349dcbae 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -713,6 +713,66 @@ const char *vine_graph_get_proxy_library_name(const struct vine_graph *vg)
 	return vg->proxy_library_name;
 }
 
+/**
+ * Add an input file to a task. The input file will be declared as a temp file.
+ * @param vg Reference to the vine graph.
+ * @param task_id Reference to the task id.
+ * @param filename Reference to the filename.
+ */
+void vine_graph_add_task_input(struct vine_graph *vg, uint64_t task_id, const char *filename)
+{
+	if (!vg || !task_id || !filename) {
+		return;
+	}
+
+	struct vine_node *node = itable_lookup(vg->nodes, task_id);
+	if (!node) {
+		return;
+	}
+
+	struct vine_file *f = NULL;
+	const char *cached_name = hash_table_lookup(vg->inout_filename_to_cached_name, filename);
+
+	if (cached_name) {
+		f = vine_manager_lookup_file(vg->manager, cached_name);
+	} else {
+		f = vine_declare_temp(vg->manager);
+		hash_table_insert(vg->inout_filename_to_cached_name, filename, xxstrdup(f->cached_name));
+	}
+
+	vine_task_add_input(node->task, f, filename, VINE_TRANSFER_ALWAYS);
+}
+
+/**
+ * Add an output file to a task. The output file will be declared as a temp file.
+ * @param vg Reference to the vine graph.
+ * @param task_id Reference to the task id.
+ * @param filename Reference to the filename.
+ */
+void vine_graph_add_task_output(struct vine_graph *vg, uint64_t task_id, const char *filename)
+{
+	if (!vg || !task_id || !filename) {
+		return;
+	}
+
+	struct vine_node *node = itable_lookup(vg->nodes, task_id);
+	if (!node) {
+		return;
+	}
+
+	struct vine_file *f = NULL;
+	const char *cached_name = hash_table_lookup(vg->inout_filename_to_cached_name, filename);
+
+	if (cached_name) {
+		f = vine_manager_lookup_file(vg->manager, cached_name);
+	} else {
+		f = vine_declare_temp(vg->manager);
+		hash_table_insert(vg->inout_filename_to_cached_name, filename, xxstrdup(f->cached_name));
+	}
+
+	vine_task_add_output(node->task, f, filename, VINE_TRANSFER_ALWAYS);
+}
+
 /**
  * Set the proxy function name of the vine graph.
  * @param vg Reference to the vine graph.
@@ -1038,6 +1098,7 @@ struct vine_graph *vine_graph_create(struct vine_manager *q)
 	vg->nodes = itable_create(0);
 	vg->task_id_to_node = itable_create(0);
 	vg->outfile_cachename_to_node = hash_table_create(0, 0);
+	vg->inout_filename_to_cached_name = hash_table_create(0, 0);
 
 	cctools_uuid_t proxy_library_name_id;
 	cctools_uuid_create(&proxy_library_name_id);
@@ -1371,5 +1432,9 @@ void vine_graph_delete(struct vine_graph *vg)
 	itable_delete(vg->nodes);
 	itable_delete(vg->task_id_to_node);
 	hash_table_delete(vg->outfile_cachename_to_node);
+
+	hash_table_clear(vg->inout_filename_to_cached_name, (void *)free);
+	hash_table_delete(vg->inout_filename_to_cached_name);
+
 	free(vg);
 }
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
index 0d9edb2a9b..b20132cc0e 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
@@ -29,6 +29,8 @@ struct vine_graph {
 	struct itable *nodes;
 	struct itable *task_id_to_node;
 	struct hash_table *outfile_cachename_to_node;
+	/* Maps a logical in/out filename (remote_name) to a stable cached_name. */
+	struct hash_table *inout_filename_to_cached_name;
 
 	/* The directory to store the checkpointed results.
 	 * Only intermediate results can be checkpointed, the fraction of intermediate results to checkpoint is controlled by the checkpoint-fraction parameter. */
@@ -133,6 +135,20 @@ void vine_graph_delete(struct vine_graph *vg);
 */
 const char *vine_graph_get_proxy_library_name(const struct vine_graph *vg);
 
+/** Add an input file to a task. The input file will be declared as a temp file.
+@param vg Reference to the vine graph.
+@param task_id Identifier of the task.
+@param filename Reference to the filename.
+*/
+void vine_graph_add_task_input(struct vine_graph *vg, uint64_t task_id, const char *filename);
+
+/** Add an output file to a task. The output file will be declared as a temp file.
+@param vg Reference to the vine graph.
+@param task_id Identifier of the task.
+@param filename Reference to the filename.
+*/
+void vine_graph_add_task_output(struct vine_graph *vg, uint64_t task_id, const char *filename);
+
 /** Set the proxy function name of the vine graph.
 @param vg Reference to the vine graph.
 @param proxy_function_name Reference to the proxy function name.
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py b/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
index 6019e6e74c..841fb55287 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
@@ -66,6 +66,20 @@ def set_proxy_function(self, proxy_function):
             self._c_graph, proxy_function.__name__
         )
 
+    def add_task_input(self, task_key, filename):
+        """Add an input file to a task."""
+        task_id = self._key_to_id.get(task_key)
+        if task_id is None:
+            raise KeyError(f"Task key not found: {task_key}")
+        vine_graph_capi.vine_graph_add_task_input(self._c_graph, task_id, filename)
+
+    def add_task_output(self, task_key, filename):
+        """Add an output file to a task."""
+        task_id = self._key_to_id.get(task_key)
+        if task_id is None:
+            raise KeyError(f"Task key not found: {task_key}")
+        vine_graph_capi.vine_graph_add_task_output(self._c_graph, task_id, filename)
+
     def execute(self):
         """Kick off execution; runs through SWIG down into the C orchestration loop."""
         vine_graph_capi.vine_graph_execute(self._c_graph)
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 306589c042..7473e7dde2 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -3480,6 +3480,7 @@ static int vine_manager_check_inputs_available(struct vine_manager *q, struct vi
 		if (f->type == VINE_FILE && f->state == VINE_FILE_STATE_PENDING) {
 			all_available = 0;
 		} else if (f->type == VINE_TEMP && !vine_temp_exists_somewhere(q, f)) {
+			printf("File %s is not available!\n", f->cached_name);
 			vine_manager_consider_recovery_task(q, f, f->recovery_task);
 			all_available = 0;
 		}

From 160c2b9427c463381f8bfa5d19f24ab76502a85e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Fri, 9 Jan 2026 03:25:41 -0500
Subject: [PATCH 109/113] auto recovery

---
 taskvine/src/graph/dagvine/dagvine.py         |   3 +
 .../src/graph/dagvine/vine_graph/vine_graph.c | 241 ++++++++++++++----
 .../src/graph/dagvine/vine_graph/vine_graph.h |   8 +
 .../src/graph/dagvine/vine_graph/vine_node.c  |  11 +-
 .../src/graph/dagvine/vine_graph/vine_node.h  |  12 +-
 taskvine/src/manager/vine_manager.c           |  10 +-
 taskvine/src/manager/vine_manager.h           |   1 +
 7 files changed, 227 insertions(+), 59 deletions(-)

diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/dagvine/dagvine.py
index ddba9f673b..051da7c047 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -71,6 +71,9 @@ def __init__(self):
             "progress-bar-update-interval-sec": 0.1,
             "time-metrics-filename": "time_metrics.csv",
             "enable-debug-log": 1,
+            "auto-recovery": 1,
+            "max-retry-attempts": 15,
+            "retry-interval-sec": 1,
         }
         # Misc knobs used purely on the Python side (e.g., generate fake outputs).
         self.other_params = {
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index fb349dcbae..48df5d9430 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -116,6 +116,18 @@ static void submit_node_task(struct vine_graph *vg, struct vine_node *node)
 		return;
 	}
 
+	if (!node->task) {
+		debug(D_ERROR, "submit_node_task: node %" PRIu64 " has no task", node->node_id);
+		return;
+	}
+
+	/* Avoid double-submitting the same task object. This should never be needed
+	 * for correctness and leads to task_id mapping corruption if it happens. */
+	if (node->task->state != VINE_TASK_INITIAL) {
+		debug(D_VINE, "submit_node_task: skipping node %" PRIu64 " (task already submitted, state=%d, task_id=%d)", node->node_id, node->task->state, node->task->task_id);
+		return;
+	}
+
 	/* calculate the priority of the node */
 	double priority = calculate_task_priority(node, vg->task_priority_mode);
 	vine_task_set_priority(node->task, priority);
@@ -125,6 +137,11 @@ static void submit_node_task(struct vine_graph *vg, struct vine_node *node)
 	int task_id = vine_submit(vg->manager, node->task);
 	node->submission_time = timestamp_get() - time_start;
 
+	if (task_id <= 0) {
+		debug(D_ERROR, "submit_node_task: failed to submit node %" PRIu64 " (returned task_id=%d)", node->node_id, task_id);
+		return;
+	}
+
 	/* insert the task id to the task id to node map */
 	itable_insert(vg->task_id_to_node, (uint64_t)task_id, node);
 
@@ -147,18 +164,26 @@ static void submit_unblocked_children(struct vine_graph *vg, struct vine_node *n
 	struct vine_node *child_node;
 	LIST_ITERATE(node->children, child_node)
 	{
-		/* Remove this parent from the child's pending set if it exists */
-		if (child_node->pending_parents) {
-			/* Assert that this parent is indeed pending for the child */
-			if (child_node->pending_parents && set_lookup(child_node->pending_parents, node)) {
-				set_remove(child_node->pending_parents, node);
-			} else {
-				debug(D_ERROR, "inconsistent pending set: child=%" PRIu64 " missing parent=%" PRIu64, child_node->node_id, node->node_id);
-			}
+		if (!child_node) {
+			continue;
 		}
 
-		/* If no more parents are pending, submit the child */
-		if (!child_node->pending_parents || set_size(child_node->pending_parents) == 0) {
+		/* Edge-fired dependency resolution: each parent->child edge is consumed at most once.
+		 * This is critical for recomputation/resubmission, where a parent may "complete" multiple times. */
+		if (child_node->fired_parents && set_lookup(child_node->fired_parents, node)) {
+			continue;
+		}
+		if (child_node->fired_parents) {
+			set_insert(child_node->fired_parents, node);
+		}
+
+		if (child_node->remaining_parents_count > 0) {
+			child_node->remaining_parents_count--;
+		}
+
+		/* If no more parents are remaining, submit the child (if it is not already done / in-flight). */
+		if (child_node->remaining_parents_count == 0 && !child_node->completed && child_node->task &&
+				child_node->task->state == VINE_TASK_INITIAL) {
 			submit_node_task(vg, child_node);
 		}
 	}
@@ -551,6 +576,85 @@ static void print_time_metrics(struct vine_graph *vg, const char *filename)
 	return;
 }
 
+/**
+ * Enqueue a node to be resubmitted later.
+ * @param vg Reference to the vine graph.
+ * @param node Reference to the node.
+ */
+static void enqueue_resubmit_node(struct vine_graph *vg, struct vine_node *node)
+{
+	if (!vg || !node) {
+		return;
+	}
+
+	if (node->in_resubmit_queue) {
+		return;
+	}
+
+	/* if the task failed due to inputs missing, we must submit the producer tasks for the lost data */
+	if (node->task->result == VINE_RESULT_INPUT_MISSING) {
+		struct vine_mount *m;
+		LIST_ITERATE(node->task->input_mounts, m)
+		{
+			struct vine_file *f = m->file;
+			/* this is a temp file, it has a producer task id and the task pointer is null */
+			if (f->type != VINE_TEMP) {
+				continue;
+			}
+			if (vine_temp_exists_somewhere(vg->manager, f)) {
+				continue;
+			}
+			if (itable_lookup(vg->manager->tasks, f->original_producer_task_id)) {
+				continue;
+			}
+			/* get the original producer node by task id */
+			struct vine_node *original_producer_node = itable_lookup(vg->task_id_to_node, f->original_producer_task_id);
+			if (!original_producer_node) {
+				continue;
+			}
+			enqueue_resubmit_node(vg, original_producer_node);
+		}
+	}
+
+	node->last_failure_time = timestamp_get();
+	list_push_tail(vg->resubmit_queue, node);
+	node->in_resubmit_queue = 1;
+}
+
+/* Try to resubmit a previously failed node.
+ * @return 1 if a node was actually resubmitted (reset + submit invoked), 0 otherwise. */
+static int try_resubmitting_node(struct vine_graph *vg)
+{
+	if (!vg) {
+		return 0;
+	}
+
+	struct vine_node *node = list_pop_head(vg->resubmit_queue);
+	if (!node) {
+		return 0;
+	}
+	node->in_resubmit_queue = 0;
+
+	timestamp_t interval = timestamp_get() - node->last_failure_time;
+
+	if (interval <= vg->retry_interval_sec * 1e6) {
+		enqueue_resubmit_node(vg, node);
+		return 0;
+	}
+
+	if (node->retry_attempts_left-- <= 0) {
+		debug(D_ERROR, "node %" PRIu64 " has no retries left. Aborting.", node->node_id);
+		vine_graph_delete(vg);
+		exit(1);
+	}
+
+	debug(D_VINE, "Resubmitting node %" PRIu64 " (remaining=%d)", node->node_id, node->retry_attempts_left);
+	vine_task_reset(node->task);
+	submit_node_task(vg, node);
+
+	return 1;
+}
+
 /*************************************************************/
 /* Public APIs */
 /*************************************************************/
@@ -671,6 +775,15 @@ int vine_graph_tune(struct vine_graph *vg, const char *name, const char *value)
 			debug_close();
 		}
 
+	} else if (strcmp(name, "auto-recovery") == 0) {
+		vg->auto_recovery = (atoi(value) == 1) ? 1 : 0;
+
+	} else if (strcmp(name, "max-retry-attempts") == 0) {
+		vg->max_retry_attempts = MAX(0, atoi(value));
+
+	} else if (strcmp(name, "retry-interval-sec") == 0) {
+		vg->retry_interval_sec = MAX(0.0, atof(value));
+
 	} else {
 		debug(D_ERROR, "invalid parameter name: %s", name);
 		return -1;
@@ -1055,6 +1168,8 @@ uint64_t vine_graph_add_node(struct vine_graph *vg)
 	/* initialize the pruning depth of each node, currently statically set to the global prune depth */
 	node->prune_depth = vg->prune_depth;
 
+	node->retry_attempts_left = vg->max_retry_attempts;
+
 	itable_insert(vg->nodes, node_id, node);
 
 	return node_id;
@@ -1099,6 +1214,7 @@ struct vine_graph *vine_graph_create(struct vine_manager *q)
 	vg->task_id_to_node = itable_create(0);
 	vg->outfile_cachename_to_node = hash_table_create(0, 0);
 	vg->inout_filename_to_cached_name = hash_table_create(0, 0);
+	vg->resubmit_queue = list_create();
 
 	cctools_uuid_t proxy_library_name_id;
 	cctools_uuid_create(&proxy_library_name_id);
@@ -1123,6 +1239,14 @@ struct vine_graph *vine_graph_create(struct vine_manager *q)
 
 	vg->enable_debug_log = 1;
 
+	vg->max_retry_attempts = 15;
+	vg->retry_interval_sec = 1.0;
+
+	/* disable auto recovery so that the graph executor can handle all tasks with missing inputs
+	 * this ensures that no recovery tasks are created automatically by the taskvine manager and that
+	 * we can be in control of when to recreate what lost data. */
+	vg->auto_recovery = 0;
+
 	return vg;
 }
 
@@ -1188,6 +1312,8 @@ void vine_graph_execute(struct vine_graph *vg)
 	/* enable return recovery tasks */
 	vine_enable_return_recovery_tasks(vg->manager);
 
+	vg->manager->auto_recovery = vg->auto_recovery;
+
 	/* create mappings from task IDs and outfile cache names to nodes */
 	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
@@ -1209,23 +1335,16 @@ void vine_graph_execute(struct vine_graph *vg)
 		}
 	}
 
-	/* initialize pending_parents for all nodes */
+	/* initialize remaining_parents_count for all nodes */
 	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
-		struct vine_node *parent_node;
-		LIST_ITERATE(node->parents, parent_node)
-		{
-			if (node->pending_parents) {
-				/* Use parent pointer to ensure pointer consistency */
-				set_insert(node->pending_parents, parent_node);
-			}
-		}
+		node->remaining_parents_count = list_size(node->parents);
 	}
 
 	/* enqueue those without dependencies */
 	ITABLE_ITERATE(vg->nodes, nid_iter, node)
 	{
-		if (!node->pending_parents || set_size(node->pending_parents) == 0) {
+		if (node->remaining_parents_count == 0) {
 			submit_node_task(vg, node);
 		}
 	}
@@ -1251,14 +1370,39 @@ void vine_graph_execute(struct vine_graph *vg)
 			break;
 		}
 
+		/* Always process graph-level resubmissions (this affects correctness),
+		 * but the Recovery progress bar source depends on auto_recovery:
+		 * - auto_recovery==1: Recovery tracks manager-created recovery tasks only
+		 * - auto_recovery==0: Recovery tracks graph resubmit queue only */
+		int did_resubmit = try_resubmitting_node(vg);
+
+		if (vg->manager->auto_recovery) {
+			/* Recovery progress reflects manager recovery tasks. */
+			(void)did_resubmit;
+			progress_bar_set_part_total(pbar, recovery_tasks_part, (uint64_t)vg->manager->stats->recovery_tasks_submitted);
+			progress_bar_update_part(pbar, recovery_tasks_part, 0);
+		} else {
+			/* Recovery progress reflects graph-level resubmissions:
+			 * total = (already attempted resubmits) + (currently queued resubmits). */
+			if (did_resubmit) {
+				progress_bar_update_part(pbar, recovery_tasks_part, 1);
+			}
+			uint64_t queued_resubmits = (uint64_t)list_size(vg->resubmit_queue);
+			progress_bar_set_part_total(pbar, recovery_tasks_part, recovery_tasks_part->current + queued_resubmits);
+			progress_bar_update_part(pbar, recovery_tasks_part, 0);
+		}
+
 		struct vine_task *task = vine_wait(vg->manager, wait_timeout);
-		progress_bar_set_part_total(pbar, recovery_tasks_part, vg->manager->stats->recovery_tasks_submitted);
 		if (task) {
 			/* retrieve all possible tasks */
 			wait_timeout = 0;
-
 			timestamp_t time_when_postprocessing_start = timestamp_get();
 
+			/* If auto_recovery is enabled, recovery tasks should be reflected in the Recovery progress bar. */
+			if (vg->manager->auto_recovery && task->type == VINE_TASK_TYPE_RECOVERY) {
+				progress_bar_update_part(pbar, recovery_tasks_part, 1);
+			}
+
 			/* get the original node by task id */
 			struct vine_node *node = get_node_by_task(vg, task);
 			if (!node) {
@@ -1268,15 +1412,8 @@ void vine_graph_execute(struct vine_graph *vg)
 
 			/* in case of failure, resubmit this task */
 			if (node->task->result != VINE_RESULT_SUCCESS || node->task->exit_code != 0) {
-				if (node->retry_attempts_left <= 0) {
-					debug(D_ERROR, "Task %d failed (result=%d, exit=%d). Node %" PRIu64 " has no retries left. Aborting.", task->task_id, node->task->result, node->task->exit_code, node->node_id);
-					vine_graph_delete(vg);
-					exit(1);
-				}
-				node->retry_attempts_left--;
-				debug(D_VINE | D_NOTICE, "Task %d failed (result=%d, exit=%d). Retrying node %" PRIu64 " (remaining=%d)...", task->task_id, node->task->result, node->task->exit_code, node->node_id, node->retry_attempts_left);
-				vine_task_reset(node->task);
-				submit_node_task(vg, node);
+				enqueue_resubmit_node(vg, node);
+				debug(D_VINE, "Task %d failed (result=%d, exit=%d)", task->task_id, node->task->result, node->task->exit_code);
 				continue;
 			}
 
@@ -1286,15 +1423,8 @@ void vine_graph_execute(struct vine_graph *vg)
 				struct stat info;
 				int result = stat(node->outfile_remote_name, &info);
 				if (result < 0) {
-					if (node->retry_attempts_left <= 0) {
-						debug(D_ERROR, "Task %d succeeded but missing sharedfs output %s; no retries left for node %" PRIu64 ". Aborting.", task->task_id, node->outfile_remote_name, node->node_id);
-						vine_graph_delete(vg);
-						exit(1);
-					}
-					node->retry_attempts_left--;
-					debug(D_VINE | D_NOTICE, "Task %d succeeded but missing sharedfs output %s; retrying node %" PRIu64 " (remaining=%d)...", task->task_id, node->outfile_remote_name, node->node_id, node->retry_attempts_left);
-					vine_task_reset(node->task);
-					submit_node_task(vg, node);
+					debug(D_VINE, "Task %d succeeded but missing sharedfs output %s", task->task_id, node->outfile_remote_name);
+					enqueue_resubmit_node(vg, node);
 					continue;
 				}
 				node->outfile_size_bytes = info.st_size;
@@ -1307,7 +1437,10 @@ void vine_graph_execute(struct vine_graph *vg)
 			}
 			debug(D_VINE, "Node %" PRIu64 " completed with outfile %s size: %zu bytes", node->node_id, node->outfile_remote_name, node->outfile_size_bytes);
 
-			/* mark the node as completed */
+			/* mark the node as completed
+			 * Note: a node may complete multiple times due to resubmission/recomputation.
+			 * Only the first completion should advance the "Regular" progress. */
+			int first_completion = !node->completed;
 			node->completed = 1;
 			node->scheduling_time = task->time_when_scheduling_end - task->time_when_scheduling_start;
 			node->commit_time = task->time_when_commit_end - task->time_when_commit_start;
@@ -1317,22 +1450,25 @@ void vine_graph_execute(struct vine_graph *vg)
 			/* prune nodes on task completion */
 			prune_ancestors_of_node(vg, node);
 
-			/* skip recovery tasks */
+			/* skip manager-created recovery tasks.
+			 * - If auto_recovery==1, we already accounted for them in the Recovery bar above.
+			 * - If auto_recovery==0, Recovery bar tracks graph resubmits only. */
 			if (task->type == VINE_TASK_TYPE_RECOVERY) {
-				progress_bar_update_part(pbar, recovery_tasks_part, 1);
 				continue;
 			}
 
-			/* set the start time to the submit time of the first regular task */
-			if (regular_tasks_part->current == 0) {
-				progress_bar_set_start_time(pbar, task->time_when_commit_start);
-			}
+			if (first_completion) {
+				/* set the start time to the submit time of the first regular task */
+				if (regular_tasks_part->current == 0) {
+					progress_bar_set_start_time(pbar, task->time_when_commit_start);
+				}
 
-			/* update critical time */
-			vine_node_update_critical_path_time(node, node->execution_time);
+				/* update critical time */
+				vine_node_update_critical_path_time(node, node->execution_time);
 
-			/* mark this regular task as completed */
-			progress_bar_update_part(pbar, regular_tasks_part, 1);
+				/* mark this regular task as completed */
+				progress_bar_update_part(pbar, regular_tasks_part, 1);
+			}
 
 			/* inject failure */
 			if (vg->failure_injection_step_percent > 0) {
@@ -1361,7 +1497,6 @@ void vine_graph_execute(struct vine_graph *vg)
 			node->postprocessing_time = time_when_postprocessing_end - time_when_postprocessing_start;
 		} else {
 			wait_timeout = 1;
-			progress_bar_update_part(pbar, recovery_tasks_part, 0); // refresh the time and total for recovery tasks
 		}
 	}
 
@@ -1426,6 +1561,8 @@ void vine_graph_delete(struct vine_graph *vg)
 		vine_node_delete(node);
 	}
 
+	list_delete(vg->resubmit_queue);
+
 	free(vg->proxy_library_name);
 	free(vg->proxy_function_name);
 
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
index b20132cc0e..6cebe4dd70 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
@@ -32,6 +32,9 @@ struct vine_graph {
 	/* Maps a logical in/out filename (remote_name) to a stable cached_name. */
 	struct hash_table *inout_filename_to_cached_name;
 
+	/* Unsuccessful tasks are appended to this list to be resubmitted later. */
+	struct list *resubmit_queue;
+
 	/* The directory to store the checkpointed results.
 	 * Only intermediate results can be checkpointed, the fraction of intermediate results to checkpoint is controlled by the checkpoint-fraction parameter. */
 	char *checkpoint_dir;
@@ -64,6 +67,11 @@ struct vine_graph {
 	char *time_metrics_filename;
 
 	int enable_debug_log; /* whether to enable debug log */
+
+	int auto_recovery; /* whether to enable auto recovery */
+
+	int max_retry_attempts;	   /* the maximum number of times to retry a task */
+	double retry_interval_sec; /* the interval between retries in seconds, 0 means no retry interval */
 };
 
 /* Public APIs for operating the vine graph */
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_node.c b/taskvine/src/graph/dagvine/vine_graph/vine_node.c
index 86e0dfffb4..48d43ffccb 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_node.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_node.c
@@ -125,11 +125,13 @@ struct vine_node *vine_node_create(uint64_t node_id)
 	node->prune_status = PRUNE_STATUS_NOT_PRUNED;
 	node->parents = list_create();
 	node->children = list_create();
-	node->pending_parents = set_create(0);
+	node->remaining_parents_count = 0;
+	node->fired_parents = set_create(0);
 	node->completed = 0;
 	node->prune_depth = 0;
-	node->retry_attempts_left = 1;
 	node->outfile_size_bytes = 0;
+	node->retry_attempts_left = 0;
+	node->in_resubmit_queue = 0;
 
 	node->depth = -1;
 	node->height = -1;
@@ -151,6 +153,7 @@ struct vine_node *vine_node_create(uint64_t node_id)
 	node->postprocessing_time = 0;
 
 	node->critical_path_time = -1;
+	node->last_failure_time = 0;
 
 	return node;
 }
@@ -400,8 +403,8 @@ void vine_node_delete(struct vine_node *node)
 	list_delete(node->parents);
 	list_delete(node->children);
 
-	if (node->pending_parents) {
-		set_delete(node->pending_parents);
+	if (node->fired_parents) {
+		set_delete(node->fired_parents);
 	}
 	free(node);
 }
\ No newline at end of file
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_node.h b/taskvine/src/graph/dagvine/vine_graph/vine_node.h
index a838fb6e88..1910a11afa 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_node.h
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_node.h
@@ -42,10 +42,16 @@ struct vine_node {
 	struct list *children;
 
 	/* Execution and scheduling state */
-	struct set *pending_parents;
-	int retry_attempts_left;
+	/* Number of unresolved parent dependencies. This is initialized to the in-degree
+	 * (list_size(parents)) before execution starts, and decremented exactly once per
+	 * parent->child edge when the parent first completes. */
+	int remaining_parents_count;
+	/* Edge-fired guard: tracks which parent edges have already been consumed for this child. */
+	struct set *fired_parents;
 	int completed;
 	prune_status_t prune_status;
+	int retry_attempts_left;
+	int in_resubmit_queue;
 
 	/* Structural metrics */
 	int prune_depth;
@@ -69,6 +75,8 @@ struct vine_node {
 	timestamp_t execution_time;
 	timestamp_t retrieval_time;
 	timestamp_t postprocessing_time;
+
+	timestamp_t last_failure_time;
 };
 
 /** Create a new vine node.
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 7473e7dde2..5ba406a29a 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -1487,6 +1487,10 @@ static int retrieve_ready_task(struct vine_manager *q, struct vine_task *t, doub
 			result = VINE_RESULT_FIXED_LOCATION_MISSING;
 		}
 	}
+	if (!q->auto_recovery && !vine_manager_check_inputs_available(q, t)) {
+		debug(D_VINE, "task %d has missing input files", t->task_id);
+		result = VINE_RESULT_INPUT_MISSING;
+	}
 
 	/* If any of the reasons fired, then expire the task and put in the retrieved queue. */
 	if (result != VINE_RESULT_SUCCESS) {
@@ -3423,6 +3427,10 @@ static void vine_manager_consider_recovery_task(struct vine_manager *q, struct v
 		return;
 	}
 
+	if (!q->auto_recovery) {
+		return;
+	}
+
 	/* Prevent race between original task and recovery task after worker crash.
 	 * Example: Task T completes on worker W, creates file F, T moves to WAITING_RETRIEVAL.
 	 * W crashes before stdout retrieval, T gets rescheduled to READY, F is lost and triggers
@@ -3480,7 +3488,6 @@ static int vine_manager_check_inputs_available(struct vine_manager *q, struct vi
 		if (f->type == VINE_FILE && f->state == VINE_FILE_STATE_PENDING) {
 			all_available = 0;
 		} else if (f->type == VINE_TEMP && !vine_temp_exists_somewhere(q, f)) {
-			printf("File %s is not available!\n", f->cached_name);
 			vine_manager_consider_recovery_task(q, f, f->recovery_task);
 			all_available = 0;
 		}
@@ -4174,6 +4181,7 @@ struct vine_manager *vine_ssl_create(int port, const char *key, const char *cert
 	q->time_start_worker_eviction = 0;
 
 	q->return_recovery_tasks = 0;
+	q->auto_recovery = 1;
 	q->balance_worker_disk_load = 0;
 	q->when_last_offloaded = 0;
 	q->peak_used_cache = 0;
diff --git a/taskvine/src/manager/vine_manager.h b/taskvine/src/manager/vine_manager.h
index 166c9c9c36..3588cd443a 100644
--- a/taskvine/src/manager/vine_manager.h
+++ b/taskvine/src/manager/vine_manager.h
@@ -238,6 +238,7 @@ struct vine_manager {
 	double disk_proportion_available_to_task;   /* intentionally reduces disk allocation for tasks to reserve some space for cache growth. */
 
 	int return_recovery_tasks; /* If true, recovery tasks are returned by vine_wait to the user. By default they are handled internally. */
+	int auto_recovery;         /* If true, recovery tasks are created automatically internally. */
 	int balance_worker_disk_load; /* If true, offload replicas from workers that are overloaded with temp files. */
 	timestamp_t when_last_offloaded;
 	int64_t peak_used_cache;

From f43bd83f8382d917a1457bb8e3784154154cf43d Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Fri, 9 Jan 2026 03:32:08 -0500
Subject: [PATCH 110/113] rename to User

---
 .../src/graph/dagvine/vine_graph/vine_graph.c | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 48df5d9430..199798b83c 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -1087,7 +1087,7 @@ void vine_graph_compute_topology_metrics(struct vine_graph *vg)
 			node->outfile = vine_declare_temp(vg->manager);
 		}
 	}
-	/* track the output dependencies of regular and vine_temp nodes */
+	/* track the output dependencies of user and vine_temp nodes */
 	LIST_ITERATE(topo_order, node)
 	{
 		if (node->outfile) {
@@ -1358,14 +1358,14 @@ void vine_graph_execute(struct vine_graph *vg)
 	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
 	progress_bar_set_update_interval(pbar, vg->progress_bar_update_interval_sec);
 
-	struct ProgressBarPart *regular_tasks_part = progress_bar_create_part("Regular", itable_size(vg->nodes));
+	struct ProgressBarPart *user_tasks_part = progress_bar_create_part("User", itable_size(vg->nodes));
 	struct ProgressBarPart *recovery_tasks_part = progress_bar_create_part("Recovery", 0);
-	progress_bar_bind_part(pbar, regular_tasks_part);
+	progress_bar_bind_part(pbar, user_tasks_part);
 	progress_bar_bind_part(pbar, recovery_tasks_part);
 
 	int wait_timeout = 1;
 
-	while (regular_tasks_part->current < regular_tasks_part->total) {
+	while (user_tasks_part->current < user_tasks_part->total) {
 		if (interrupted) {
 			break;
 		}
@@ -1439,7 +1439,7 @@ void vine_graph_execute(struct vine_graph *vg)
 
 			/* mark the node as completed
 			 * Note: a node may complete multiple times due to resubmission/recomputation.
-			 * Only the first completion should advance the "Regular" progress. */
+			 * Only the first completion should advance the "User" progress. */
 			int first_completion = !node->completed;
 			node->completed = 1;
 			node->scheduling_time = task->time_when_scheduling_end - task->time_when_scheduling_start;
@@ -1458,21 +1458,21 @@ void vine_graph_execute(struct vine_graph *vg)
 			}
 
 			if (first_completion) {
-				/* set the start time to the submit time of the first regular task */
-				if (regular_tasks_part->current == 0) {
+				/* set the start time to the submit time of the first user task */
+				if (user_tasks_part->current == 0) {
 					progress_bar_set_start_time(pbar, task->time_when_commit_start);
 				}
 
 				/* update critical time */
 				vine_node_update_critical_path_time(node, node->execution_time);
 
-				/* mark this regular task as completed */
-				progress_bar_update_part(pbar, regular_tasks_part, 1);
+				/* mark this user task as completed */
+				progress_bar_update_part(pbar, user_tasks_part, 1);
 			}
 
 			/* inject failure */
 			if (vg->failure_injection_step_percent > 0) {
-				double progress = (double)regular_tasks_part->current / (double)regular_tasks_part->total;
+				double progress = (double)user_tasks_part->current / (double)user_tasks_part->total;
 				if (progress >= next_failure_threshold && release_random_worker(vg->manager)) {
 					debug(D_VINE, "released a random worker at %.2f%% (threshold %.2f%%)", progress * 100, next_failure_threshold * 100);
 					next_failure_threshold += vg->failure_injection_step_percent / 100.0;

From 845e0a697175bbeb21e01d23cd25f4bb8b5c65bf Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Fri, 9 Jan 2026 03:43:44 -0500
Subject: [PATCH 111/113] block rec tasks w missing inputs

---
 .../src/graph/dagvine/vine_graph/vine_graph.c | 40 +++++++++++--------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 199798b83c..350dfe20cd 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -591,7 +591,27 @@ static void enqueue_resubmit_node(struct vine_graph *vg, struct vine_node *node)
 		return;
 	}
 
+	node->last_failure_time = timestamp_get();
+	list_push_tail(vg->resubmit_queue, node);
+	node->in_resubmit_queue = 1;
+}
+
+/* Try to resubmit a previously failed node.
+ * @return 1 if a node was actually resubmitted (reset + submit invoked), 0 otherwise. */
+static int try_resubmitting_node(struct vine_graph *vg)
+{
+	if (!vg) {
+		return 0;
+	}
+
+	struct vine_node *node = list_pop_head(vg->resubmit_queue);
+	if (!node) {
+		return 0;
+	}
+	node->in_resubmit_queue = 0;
+
 	/* if the task failed due to inputs missing, we must submit the producer tasks for the lost data */
+	int all_inputs_ready = 1;
 	if (node->task->result == VINE_RESULT_INPUT_MISSING) {
 		struct vine_mount *m;
 		LIST_ITERATE(node->task->input_mounts, m)
@@ -613,27 +633,15 @@ static void enqueue_resubmit_node(struct vine_graph *vg, struct vine_node *node)
 				continue;
 			}
 			enqueue_resubmit_node(vg, original_producer_node);
+			all_inputs_ready = 0;
 		}
 	}
 
-	node->last_failure_time = timestamp_get();
-	list_push_tail(vg->resubmit_queue, node);
-	node->in_resubmit_queue = 1;
-}
-
-/* Try to resubmit a previously failed node.
- * @return 1 if a node was actually resubmitted (reset + submit invoked), 0 otherwise. */
-static int try_resubmitting_node(struct vine_graph *vg)
-{
-	if (!vg) {
-		return 0;
-	}
-
-	struct vine_node *node = list_pop_head(vg->resubmit_queue);
-	if (!node) {
+	/* if not all inputs are ready, enqueue the node and consider later */
+	if (!all_inputs_ready) {
+		enqueue_resubmit_node(vg, node);
 		return 0;
 	}
-	node->in_resubmit_queue = 0;
 
 	timestamp_t interval = timestamp_get() - node->last_failure_time;
 

From 3abe87b77dd852c2abc333eae981fbc0aaa13a4f Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 15 Jan 2026 01:26:48 -0500
Subject: [PATCH 112/113] add compute makespan

---
 .../taskvine/compat/dask_executor.py          | 16 +++++++--
 taskvine/src/graph/dagvine/dagvine.py         | 10 +++++-
 .../src/graph/dagvine/vine_graph/vine_graph.c | 36 ++++++++++++++++---
 .../src/graph/dagvine/vine_graph/vine_graph.h | 11 ++++++
 .../dagvine/vine_graph/vine_graph_client.py   |  4 +++
 taskvine/src/manager/vine_manager.c           |  2 --
 taskvine/src/manager/vine_task.c              | 12 -------
 taskvine/src/manager/vine_task.h              |  7 ----
 8 files changed, 68 insertions(+), 30 deletions(-)

diff --git a/taskvine/src/bindings/python3/ndcctools/taskvine/compat/dask_executor.py b/taskvine/src/bindings/python3/ndcctools/taskvine/compat/dask_executor.py
index f6f4834069..2b48b2675a 100644
--- a/taskvine/src/bindings/python3/ndcctools/taskvine/compat/dask_executor.py
+++ b/taskvine/src/bindings/python3/ndcctools/taskvine/compat/dask_executor.py
@@ -138,8 +138,10 @@ def get(self, dsk, keys, *,
             hoisting_modules=None,  # Deprecated, use lib_modules
             import_modules=None,    # Deprecated, use lib_modules
             lazy_transfers=True,    # Deprecated, use worker_tranfers
+            extra_serialize_time_sec=0,
             ):
         try:
+            self.extra_serialize_time_sec = extra_serialize_time_sec
             self.set_property("framework", "dask")
             if retries and retries < 1:
                 raise ValueError("retries should be larger than 0")
@@ -213,10 +215,13 @@ def __call__(self, *args, **kwargs):
         return self.get(*args, **kwargs)
 
     def _dask_execute(self, dsk, keys):
+
         indices = {k: inds for (k, inds) in find_dask_keys(keys)}
         keys_flatten = indices.keys()
 
+        time_start = time.time()
         dag = DaskVineDag(dsk, low_memory_mode=self.low_memory_mode, prune_depth=self.prune_depth)
+        print(f"Time taken to enqueue tasks: {time.time() - time_start:.6f} seconds")
         tag = f"dag-{id(dag)}"
 
         # create Library if using 'function-calls' task mode.
@@ -437,7 +442,8 @@ def _enqueue_dask_calls(self, dag, tag, rs, retries, enqueued_calls):
                                      extra_files=self.extra_files,
                                      retries=retries,
                                      worker_transfers=lazy,
-                                     wrapper=self.wrapper)
+                                     wrapper=self.wrapper,
+                                     extra_serialize_time_sec=self.extra_serialize_time_sec)
 
                 t.set_priority(priority)
                 t.set_tag(tag)  # tag that identifies this dag
@@ -557,7 +563,9 @@ def __init__(self, m,
                  env_vars=None,
                  retries=5,
                  worker_transfers=False,
-                 wrapper=None):
+                 wrapper=None,
+                 extra_serialize_time_sec=0):
+        time.sleep(extra_serialize_time_sec)
         self._key = key
         self._sexpr = sexpr
 
@@ -658,7 +666,9 @@ def __init__(self, m,
                  extra_files=None,
                  retries=5,
                  worker_transfers=False,
-                 wrapper=None):
+                 wrapper=None,
+                 extra_serialize_time_sec=0):
+        time.sleep(extra_serialize_time_sec)
 
         self._key = key
         self.resources = resources
diff --git a/taskvine/src/graph/dagvine/dagvine.py b/taskvine/src/graph/dagvine/dagvine.py
index 051da7c047..b6b668b890 100644
--- a/taskvine/src/graph/dagvine/dagvine.py
+++ b/taskvine/src/graph/dagvine/dagvine.py
@@ -16,6 +16,7 @@
 import signal
 import json
 import random
+import time
 
 
 def context_loader_func(graph_pkl):
@@ -69,7 +70,7 @@ def __init__(self):
             "checkpoint-dir": "./checkpoints",
             "checkpoint-fraction": 0,
             "progress-bar-update-interval-sec": 0.1,
-            "time-metrics-filename": "time_metrics.csv",
+            "time-metrics-filename": 0,
             "enable-debug-log": 1,
             "auto-recovery": 1,
             "max-retry-attempts": 15,
@@ -258,6 +259,8 @@ def create_proxy_library(self, py_graph, vine_graph, hoisting_modules, env_files
 
     def run(self, task_dict, target_keys=[], params={}, hoisting_modules=[], env_files={}, adapt_dask=False):
         """High-level entry point: normalise input, build graphs, ship the library, execute, and return results."""
+        time_start = time.time()
+
         # first update the params so that they can be used for the following construction
         self.update_params(params)
 
@@ -278,6 +281,7 @@ def run(self, task_dict, target_keys=[], params={}, hoisting_modules=[], env_fil
 
         try:
             print(f"=== Library serialized size: {color_text(proxy_library.get_context_size(), 92)} MB")
+            print(f"Time taken to initialize the graph in Python: {time.time() - time_start:.6f} seconds")
             vine_graph.execute()
             results = {}
             for k in target_keys:
@@ -285,6 +289,10 @@ def run(self, task_dict, target_keys=[], params={}, hoisting_modules=[], env_fil
                     continue
                 outfile_path = os.path.join(self.param("output-dir"), py_graph.outfile_remote_name[k])
                 results[k] = TaskOutputWrapper.load_from_path(outfile_path)
+            makespan_s = round(vine_graph.get_makespan_us() / 1e6, 6)
+            throughput_tps = round(len(py_graph.task_dict) / makespan_s, 6)
+            print(f"Makespan: {color_text(makespan_s, 92)} seconds")
+            print(f"Throughput: {color_text(throughput_tps, 92)} tasks/second")
             return results
         finally:
             try:
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
index 350dfe20cd..0935e4552d 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.c
@@ -563,13 +563,13 @@ static void print_time_metrics(struct vine_graph *vg, const char *filename)
 		debug(D_ERROR, "failed to open file %s", filename);
 		return;
 	}
-	fprintf(fp, "node_id,submission_time_us,scheduling_time_us,commit_time_us,execution_time_us,retrieval_time_us,postprocessing_time_us\n");
+	fprintf(fp, "node_id,submission_time_us,commit_time_us,execution_time_us,retrieval_time_us,postprocessing_time_us\n");
 
 	uint64_t nid;
 	struct vine_node *node;
 	ITABLE_ITERATE(vg->nodes, nid, node)
 	{
-		fprintf(fp, "%" PRIu64 "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "\n", node->node_id, node->submission_time, node->scheduling_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
+		fprintf(fp, "%" PRIu64 "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "," TIMESTAMP_FORMAT "\n", node->node_id, node->submission_time, node->commit_time, node->execution_time, node->retrieval_time, node->postprocessing_time);
 	}
 	fclose(fp);
 
@@ -738,7 +738,7 @@ int vine_graph_tune(struct vine_graph *vg, const char *name, const char *value)
 		vg->progress_bar_update_interval_sec = (val > 0.0) ? val : 0.1;
 
 	} else if (strcmp(name, "time-metrics-filename") == 0) {
-		if (strcmp(value, "0") == 0) {
+		if (value == NULL || strcmp(value, "0") == 0) {
 			return 0;
 		}
 
@@ -1255,6 +1255,10 @@ struct vine_graph *vine_graph_create(struct vine_manager *q)
 	 * we can be in control of when to recreate what lost data. */
 	vg->auto_recovery = 0;
 
+	vg->time_first_task_dispatched = UINT64_MAX;
+	vg->time_last_task_retrieved = 0;
+	vg->makespan_us = 0;
+
 	return vg;
 }
 
@@ -1295,6 +1299,15 @@ void vine_graph_add_dependency(struct vine_graph *vg, uint64_t parent_id, uint64
 	return;
 }
 
+uint64_t vine_graph_get_makespan_us(const struct vine_graph *vg)
+{
+	if (!vg) {
+		return 0;
+	}
+
+	return (uint64_t)vg->makespan_us;
+}
+
 /**
  * Execute the vine graph. This must be called after all nodes and dependencies are added and the topology metrics are computed.
  * @param vg Reference to the vine graph.
@@ -1305,6 +1318,8 @@ void vine_graph_execute(struct vine_graph *vg)
 		return;
 	}
 
+	timestamp_t time_start = timestamp_get();
+
 	void (*previous_sigint_handler)(int) = signal(SIGINT, handle_sigint);
 
 	debug(D_VINE, "start executing vine graph");
@@ -1363,6 +1378,9 @@ void vine_graph_execute(struct vine_graph *vg)
 		next_failure_threshold = vg->failure_injection_step_percent / 100.0;
 	}
 
+	timestamp_t time_end = timestamp_get();
+	printf("Time taken to initialize the graph in C: %.6f seconds\n", (double)(time_end - time_start) / 1e6);
+
 	struct ProgressBar *pbar = progress_bar_init("Executing Tasks");
 	progress_bar_set_update_interval(pbar, vg->progress_bar_update_interval_sec);
 
@@ -1425,6 +1443,15 @@ void vine_graph_execute(struct vine_graph *vg)
 				continue;
 			}
 
+			/* update time metrics */
+			vg->time_first_task_dispatched = MIN(vg->time_first_task_dispatched, task->time_when_commit_end);
+			vg->time_last_task_retrieved = MAX(vg->time_last_task_retrieved, task->time_when_retrieval);
+			if (vg->time_last_task_retrieved < vg->time_first_task_dispatched) {
+				debug(D_ERROR, "task %d time_last_task_retrieved < time_first_task_dispatched: %" PRIu64 " < %" PRIu64, task->task_id, vg->time_last_task_retrieved, vg->time_first_task_dispatched);
+				vg->time_last_task_retrieved = vg->time_first_task_dispatched;
+			}
+			vg->makespan_us = vg->time_last_task_retrieved - vg->time_first_task_dispatched;
+
 			/* if the outfile is set to save on the sharedfs, stat to get the size of the file */
 			switch (node->outfile_type) {
 			case NODE_OUTFILE_TYPE_SHARED_FILE_SYSTEM: {
@@ -1450,10 +1477,9 @@ void vine_graph_execute(struct vine_graph *vg)
 			 * Only the first completion should advance the "User" progress. */
 			int first_completion = !node->completed;
 			node->completed = 1;
-			node->scheduling_time = task->time_when_scheduling_end - task->time_when_scheduling_start;
 			node->commit_time = task->time_when_commit_end - task->time_when_commit_start;
 			node->execution_time = task->time_workers_execute_last;
-			node->retrieval_time = task->time_when_get_result_end - task->time_when_get_result_start;
+			node->retrieval_time = task->time_when_done - task->time_when_retrieval;
 
 			/* prune nodes on task completion */
 			prune_ancestors_of_node(vg, node);
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
index 6cebe4dd70..4433563ec9 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph.h
@@ -11,6 +11,7 @@
 #include "set.h"
 #include "vine_node.h"
 #include "taskvine.h"
+#include "timestamp.h"
 
 /** The task priority algorithm used for vine graph scheduling. */
 typedef enum {
@@ -72,6 +73,10 @@ struct vine_graph {
 
 	int max_retry_attempts;	   /* the maximum number of times to retry a task */
 	double retry_interval_sec; /* the interval between retries in seconds, 0 means no retry interval */
+
+	timestamp_t time_first_task_dispatched; /* the time when the first task is dispatched */
+	timestamp_t time_last_task_retrieved;	/* the time when the last task is retrieved */
+	timestamp_t makespan_us;		/* the makespan of the vine graph in microseconds */
 };
 
 /* Public APIs for operating the vine graph */
@@ -171,4 +176,10 @@ void vine_graph_set_proxy_function_name(struct vine_graph *vg, const char *proxy
 */
 int vine_graph_tune(struct vine_graph *vg, const char *name, const char *value);
 
+/** Get the makespan of the vine graph in microseconds.
+@param vg Reference to the vine graph.
+@return The makespan in microseconds.
+*/
+uint64_t vine_graph_get_makespan_us(const struct vine_graph *vg);
+
 #endif // VINE_GRAPH_H
diff --git a/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py b/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
index 841fb55287..43c7b7e210 100644
--- a/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
+++ b/taskvine/src/graph/dagvine/vine_graph/vine_graph_client.py
@@ -84,6 +84,10 @@ def execute(self):
         """Kick off execution; runs through SWIG down into the C orchestration loop."""
         vine_graph_capi.vine_graph_execute(self._c_graph)
 
+    def get_makespan_us(self):
+        """Get the makespan of the vine graph in microseconds."""
+        return vine_graph_capi.vine_graph_get_makespan_us(self._c_graph)
+
     def delete(self):
         """Release the C resources and clear the client."""
         vine_graph_capi.vine_graph_delete(self._c_graph)
diff --git a/taskvine/src/manager/vine_manager.c b/taskvine/src/manager/vine_manager.c
index 5ba406a29a..e4df62c292 100644
--- a/taskvine/src/manager/vine_manager.c
+++ b/taskvine/src/manager/vine_manager.c
@@ -595,8 +595,6 @@ static vine_result_code_t get_completion_result(struct vine_manager *q, struct v
 		return VINE_SUCCESS;
 	}
 
-	t->time_when_get_result_start = timestamp_get();
-
 	if (task_status != VINE_RESULT_SUCCESS) {
 		w->last_failure_time = timestamp_get();
 		t->time_when_last_failure = w->last_failure_time;
diff --git a/taskvine/src/manager/vine_task.c b/taskvine/src/manager/vine_task.c
index 0adf5c7378..8616e4ecda 100644
--- a/taskvine/src/manager/vine_task.c
+++ b/taskvine/src/manager/vine_task.c
@@ -89,15 +89,9 @@ struct vine_task *vine_task_create(const char *command_line)
 
 void vine_task_clean(struct vine_task *t)
 {
-	t->time_when_scheduling_start = 0;
-	t->time_when_scheduling_end = 0;
-
 	t->time_when_commit_start = 0;
 	t->time_when_commit_end = 0;
 
-	t->time_when_get_result_start = 0;
-	t->time_when_get_result_end = 0;
-
 	t->time_when_retrieval = 0;
 	t->time_when_done = 0;
 
@@ -161,15 +155,9 @@ void vine_task_reset(struct vine_task *t)
 	t->time_workers_execute_exhaustion = 0;
 	t->time_workers_execute_failure = 0;
 
-	t->time_when_scheduling_start = 0;
-	t->time_when_scheduling_end = 0;
-
 	t->time_when_commit_start = 0;
 	t->time_when_commit_end = 0;
 
-	t->time_when_get_result_start = 0;
-	t->time_when_get_result_end = 0;
-
 	rmsummary_delete(t->resources_measured);
 	rmsummary_delete(t->resources_allocated);
 	t->resources_measured = rmsummary_create(-1);
diff --git a/taskvine/src/manager/vine_task.h b/taskvine/src/manager/vine_task.h
index fff5ea553f..ad03efd76e 100644
--- a/taskvine/src/manager/vine_task.h
+++ b/taskvine/src/manager/vine_task.h
@@ -117,20 +117,13 @@ struct vine_task {
 	timestamp_t time_when_submitted;    /**< The time at which this task was added to the queue. */
 	timestamp_t time_when_done;         /**< The time at which the task is mark as retrieved, after transfering output files and other final processing. */
 
-	timestamp_t time_when_scheduling_start; /**< The time when the task starts to be considered for scheduling. */
-	timestamp_t time_when_scheduling_end;   /**< The time when the task is mapped to a worker and ready to be committed. */
-
 	timestamp_t time_when_commit_start; /**< The time when the task starts to be transfered to a worker. */
 	timestamp_t time_when_commit_end;   /**< The time when the task is completely transfered to a worker. */
 
-	timestamp_t time_when_get_result_start; /**< The time when the task starts to get the result from the worker. */
-	timestamp_t time_when_get_result_end;   /**< The time when the task gets the result from the worker. */
-
 	timestamp_t time_when_retrieval;    /**< The time when output files start to be transfered back to the manager. time_done - time_when_retrieval is the time taken to transfer output files. */
 
 	timestamp_t time_when_last_failure; /**< If larger than 0, the time at which the last task failure was detected. */
 
-
 	timestamp_t time_workers_execute_last_start;           /**< The time when the last complete execution for this task started at a worker. */
 	timestamp_t time_workers_execute_last_end;             /**< The time when the last complete execution for this task ended at a worker. */
 

From 4222532c8f469e476d95277338c3e2ba20a85b1e Mon Sep 17 00:00:00 2001
From: Jin Zhou <jzhou24@condorfe.crc.nd.edu>
Date: Thu, 15 Jan 2026 17:22:07 -0500
Subject: [PATCH 113/113] use processing_transfers in vine_cache_check_files

---
 taskvine/src/worker/vine_cache.c | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/taskvine/src/worker/vine_cache.c b/taskvine/src/worker/vine_cache.c
index 40b226c11e..fc97b46416 100644
--- a/taskvine/src/worker/vine_cache.c
+++ b/taskvine/src/worker/vine_cache.c
@@ -941,13 +941,22 @@ If any have definitively failed, they are removed from the cache.
 
 int vine_cache_check_files(struct vine_cache *c, struct link *manager)
 {
-	struct vine_cache_file *f;
+	if (hash_table_size(c->processing_transfers) < 1) {
+		return 1;
+	}
+
+	char **cachenames = hash_table_keys_array(c->processing_transfers);
+	int i = 0;
 	char *cachename;
-	HASH_TABLE_ITERATE(c->table, cachename, f)
-	{
-		vine_cache_check_file(c, f, cachename, manager);
+	while ((cachename = cachenames[i])) {
+		i++;
+		struct vine_cache_file *f = hash_table_lookup(c->table, cachename);
+		if (f) {
+			vine_cache_check_file(c, f, cachename, manager);
+		}
 
-		if (f->status == VINE_CACHE_STATUS_FAILED) {
+		f = hash_table_lookup(c->table, cachename);
+		if (f && f->status == VINE_CACHE_STATUS_FAILED) {
 			/* if transfer failed, then we delete all of our records of the file. The manager
 			 * assumes that the file is not at the worker after the manager receives
 			 * the cache invalid message sent from vine_cache_check_outputs. */
@@ -956,5 +965,7 @@ int vine_cache_check_files(struct vine_cache *c, struct link *manager)
 
 		/* Note that f may no longer be valid at this point */
 	}
+
+	hash_table_free_keys_array(cachenames);
 	return 1;
 }