retold 1.0.6 → 4.0.2

package/examples/todo-list/web-client/source/views/calendar/View-WeekView.cjs

@@ -0,0 +1,149 @@
+const libPictView = require('pict-view');
+
+const _ViewConfiguration =
+{
+	ViewIdentifier: 'TodoList-WeekView',
+	DefaultRenderable: 'TodoList-WeekView-Content',
+	DefaultDestinationAddress: '#TodoList-Content',
+	AutoRender: false,
+
+	Templates:
+	[
+		{
+			Hash: 'TodoList-WeekView-Template',
+			Template: /*html*/`
+<div class="tl-cal-header">
+	<h2>Week View</h2>
+	<div class="tl-cal-nav">
+		<button class="tl-btn tl-btn-default" onclick="{~P~}.PictApplication.calendarNavigate('week', -1)">&larr; Prev</button>
+		<button class="tl-btn tl-btn-primary" onclick="{~P~}.PictApplication.calendarToday('week')">Today</button>
+		<button class="tl-btn tl-btn-default" onclick="{~P~}.PictApplication.calendarNavigate('week', 1)">Next &rarr;</button>
+	</div>
+</div>
+<p class="tl-cal-label">{~D:AppData.TodoList.CalendarState.WeekLabel~}</p>
+<table class="tl-cal-table">
+	<thead>
+		<tr>
+			<th>Day</th>
+			<th>Date</th>
+			<th>Completed</th>
+			<th>Open</th>
+			<th>Total</th>
+		</tr>
+	</thead>
+	<tbody>
+		{~TemplateSet:TodoList-WeekRow:AppData.TodoList.CalendarState.WeekRows~}
+	</tbody>
+</table>
+`
+		},
+		{
+			Hash: 'TodoList-WeekRow',
+			Template: /*html*/`
+<tr class="{~D:Record.TodayClass~}">
+	<td>{~D:Record.DayName~}</td>
+	<td>{~D:Record.DateLabel~}</td>
+	<td><span class="tl-cal-badge {~D:Record.CompleteBadge~}">{~D:Record.Complete~}</span></td>
+	<td><span class="tl-cal-badge {~D:Record.OpenBadge~}">{~D:Record.Open~}</span></td>
+	<td><span class="tl-cal-badge {~D:Record.TotalBadge~}">{~D:Record.Total~}</span></td>
+</tr>
+`
+		}
+	],
+
+	Renderables:
+	[
+		{
+			RenderableHash: 'TodoList-WeekView-Content',
+			TemplateHash: 'TodoList-WeekView-Template',
+			DestinationAddress: '#TodoList-Content',
+			RenderMethod: 'replace'
+		}
+	]
+};
+
+const _DayNames = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+const _MonthNames = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+
+class TodoListWeekView extends libPictView
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+	}
+
+	onBeforeRender()
+	{
+		let tmpCal = this.pict.AppData.TodoList.CalendarState;
+		let tmpAnchor = new Date(tmpCal.AnchorDate + 'T00:00:00');
+
+		// Find the Monday of the anchor's week
+		let tmpDayOfWeek = tmpAnchor.getDay();
+		let tmpMonday = new Date(tmpAnchor);
+		tmpMonday.setDate(tmpMonday.getDate() - ((tmpDayOfWeek + 6) % 7));
+
+		let tmpToday = new Date().toISOString().substring(0, 10);
+		let tmpAllTasks = this.pict.AppData.TodoList.AllTasks;
+
+		// Build a lookup: dateString -> { complete, open }
+		let tmpTaskMap = {};
+		for (let i = 0; i < tmpAllTasks.length; i++)
+		{
+			let tmpDate = (tmpAllTasks[i].DueDate || '').substring(0, 10);
+			if (!tmpDate)
+			{
+				continue;
+			}
+			if (!tmpTaskMap[tmpDate])
+			{
+				tmpTaskMap[tmpDate] = { complete: 0, open: 0 };
+			}
+			if (tmpAllTasks[i].Status === 'Complete')
+			{
+				tmpTaskMap[tmpDate].complete++;
+			}
+			else
+			{
+				tmpTaskMap[tmpDate].open++;
+			}
+		}
+
+		// Build 7 row objects (Mon–Sun)
+		let tmpRows = [];
+		for (let d = 0; d < 7; d++)
+		{
+			let tmpDay = new Date(tmpMonday);
+			tmpDay.setDate(tmpMonday.getDate() + d);
+			let tmpDateStr = tmpDay.toISOString().substring(0, 10);
+			let tmpCounts = tmpTaskMap[tmpDateStr] || { complete: 0, open: 0 };
+			let tmpTotal = tmpCounts.complete + tmpCounts.open;
+
+			tmpRows.push(
+			{
+				DayName: _DayNames[tmpDay.getDay()],
+				DateLabel: _MonthNames[tmpDay.getMonth()] + ' ' + tmpDay.getDate() + ', ' + tmpDay.getFullYear(),
+				Complete: tmpCounts.complete,
+				Open: tmpCounts.open,
+				Total: tmpTotal,
+				CompleteBadge: tmpCounts.complete > 0 ? 'tl-cal-badge-complete' : 'tl-cal-badge-zero',
+				OpenBadge: tmpCounts.open > 0 ? 'tl-cal-badge-open' : 'tl-cal-badge-zero',
+				TotalBadge: tmpTotal > 0 ? 'tl-cal-badge-complete' : 'tl-cal-badge-zero',
+				TodayClass: tmpDateStr === tmpToday ? 'tl-cal-today' : ''
+			});
+		}
+
+		tmpCal.WeekRows = tmpRows;
+
+		// Build the header label
+		let tmpSunday = new Date(tmpMonday);
+		tmpSunday.setDate(tmpMonday.getDate() + 6);
+		tmpCal.WeekLabel = _MonthNames[tmpMonday.getMonth()] + ' ' + tmpMonday.getDate()
+			+ ' – ' + _MonthNames[tmpSunday.getMonth()] + ' ' + tmpSunday.getDate()
+			+ ', ' + tmpSunday.getFullYear();
+
+		return super.onBeforeRender();
+	}
+}
+
+module.exports = TodoListWeekView;
+module.exports.default_configuration = _ViewConfiguration;

package/examples/todo-list/web-client/source/views/calendar/View-YearView.cjs

@@ -0,0 +1,226 @@
+const libPictView = require('pict-view');
+
+const _ViewConfiguration =
+{
+	ViewIdentifier: 'TodoList-YearView',
+	DefaultRenderable: 'TodoList-YearView-Content',
+	DefaultDestinationAddress: '#TodoList-Content',
+	AutoRender: false,
+
+	CSS: /*css*/`
+		.tl-year-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1em; margin-bottom: 1.25em; }
+		.tl-year-month-card { background: #fff; border-radius: 6px; padding: 1em; box-shadow: 0 1px 3px rgba(0,0,0,0.08); }
+		.tl-year-month-card-current { border: 2px solid #2E7D74; }
+		.tl-year-month-name { font-weight: 700; font-size: 1em; margin-bottom: 0.5em; }
+		.tl-year-month-stats { display: flex; gap: 0.5em; flex-wrap: wrap; }
+		.tl-year-month-stat { font-size: 0.85em; color: #8A7F72; }
+		.tl-year-month-stat strong { font-weight: 700; }
+	`,
+
+	Templates:
+	[
+		{
+			Hash: 'TodoList-YearView-Template',
+			Template: /*html*/`
+<div class="tl-cal-header">
+	<h2>Year View</h2>
+	<div class="tl-cal-nav">
+		<button class="tl-btn tl-btn-default" onclick="{~P~}.PictApplication.calendarNavigate('year', -1)">&larr; Prev</button>
+		<button class="tl-btn tl-btn-primary" onclick="{~P~}.PictApplication.calendarToday('year')">Today</button>
+		<button class="tl-btn tl-btn-default" onclick="{~P~}.PictApplication.calendarNavigate('year', 1)">Next &rarr;</button>
+	</div>
+</div>
+<p class="tl-cal-label">{~D:AppData.TodoList.CalendarState.YearLabel~}</p>
+<div id="TodoList-YearGrid"></div>
+<table class="tl-cal-table">
+	<thead>
+		<tr>
+			<th>Month</th>
+			<th>Completed</th>
+			<th>Open</th>
+			<th>Total</th>
+		</tr>
+	</thead>
+	<tbody>
+		{~TemplateSet:TodoList-YearRow:AppData.TodoList.CalendarState.YearRows~}
+	</tbody>
+</table>
+`
+		},
+		{
+			Hash: 'TodoList-YearRow',
+			Template: /*html*/`
+<tr class="{~D:Record.TotalClass~}">
+	<td>{~D:Record.MonthLabel~}</td>
+	<td><span class="tl-cal-badge {~D:Record.CompleteBadge~}">{~D:Record.Complete~}</span></td>
+	<td><span class="tl-cal-badge {~D:Record.OpenBadge~}">{~D:Record.Open~}</span></td>
+	<td><span class="tl-cal-badge {~D:Record.TotalBadge~}">{~D:Record.Total~}</span></td>
+</tr>
+`
+		}
+	],
+
+	Renderables:
+	[
+		{
+			RenderableHash: 'TodoList-YearView-Content',
+			TemplateHash: 'TodoList-YearView-Template',
+			DestinationAddress: '#TodoList-Content',
+			RenderMethod: 'replace'
+		}
+	]
+};
+
+const _MonthNamesFull = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+
+class TodoListYearView extends libPictView
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+	}
+
+	onBeforeRender()
+	{
+		let tmpCal = this.pict.AppData.TodoList.CalendarState;
+		let tmpAnchor = new Date(tmpCal.AnchorDate + 'T00:00:00');
+		let tmpYear = tmpAnchor.getFullYear();
+		let tmpCurrentMonth = new Date().getMonth();
+		let tmpCurrentYear = new Date().getFullYear();
+
+		tmpCal.YearLabel = String(tmpYear);
+
+		// Build month->counts map
+		let tmpAllTasks = this.pict.AppData.TodoList.AllTasks;
+		let tmpMonthMap = {};
+		for (let i = 0; i < tmpAllTasks.length; i++)
+		{
+			let tmpDate = (tmpAllTasks[i].DueDate || '').substring(0, 10);
+			if (!tmpDate)
+			{
+				continue;
+			}
+			// Only count tasks in this year
+			if (tmpDate.substring(0, 4) !== String(tmpYear))
+			{
+				continue;
+			}
+			let tmpMonthKey = parseInt(tmpDate.substring(5, 7), 10) - 1;
+			if (!tmpMonthMap[tmpMonthKey])
+			{
+				tmpMonthMap[tmpMonthKey] = { complete: 0, open: 0 };
+			}
+			if (tmpAllTasks[i].Status === 'Complete')
+			{
+				tmpMonthMap[tmpMonthKey].complete++;
+			}
+			else
+			{
+				tmpMonthMap[tmpMonthKey].open++;
+			}
+		}
+
+		// Store for the grid
+		this._monthMap = tmpMonthMap;
+		this._gridYear = tmpYear;
+		this._currentMonth = tmpCurrentMonth;
+		this._isCurrentYear = tmpYear === tmpCurrentYear;
+
+		// Build 12 month rows + total
+		let tmpRows = [];
+		let tmpTotalComplete = 0;
+		let tmpTotalOpen = 0;
+
+		for (let m = 0; m < 12; m++)
+		{
+			let tmpCounts = tmpMonthMap[m] || { complete: 0, open: 0 };
+			let tmpTotal = tmpCounts.complete + tmpCounts.open;
+
+			tmpTotalComplete += tmpCounts.complete;
+			tmpTotalOpen += tmpCounts.open;
+
+			tmpRows.push(
+			{
+				MonthLabel: _MonthNamesFull[m],
+				Complete: tmpCounts.complete,
+				Open: tmpCounts.open,
+				Total: tmpTotal,
+				CompleteBadge: tmpCounts.complete > 0 ? 'tl-cal-badge-complete' : 'tl-cal-badge-zero',
+				OpenBadge: tmpCounts.open > 0 ? 'tl-cal-badge-open' : 'tl-cal-badge-zero',
+				TotalBadge: tmpTotal > 0 ? 'tl-cal-badge-complete' : 'tl-cal-badge-zero',
+				TotalClass: (this._isCurrentYear && m === tmpCurrentMonth) ? 'tl-cal-today' : ''
+			});
+		}
+
+		let tmpGrandTotal = tmpTotalComplete + tmpTotalOpen;
+		tmpRows.push(
+		{
+			MonthLabel: 'Total',
+			Complete: tmpTotalComplete,
+			Open: tmpTotalOpen,
+			Total: tmpGrandTotal,
+			CompleteBadge: tmpTotalComplete > 0 ? 'tl-cal-badge-complete' : 'tl-cal-badge-zero',
+			OpenBadge: tmpTotalOpen > 0 ? 'tl-cal-badge-open' : 'tl-cal-badge-zero',
+			TotalBadge: tmpGrandTotal > 0 ? 'tl-cal-badge-complete' : 'tl-cal-badge-zero',
+			TotalClass: 'tl-cal-total'
+		});
+
+		tmpCal.YearRows = tmpRows;
+
+		return super.onBeforeRender();
+	}
+
+	/**
+	 * Render the 4×3 month card grid after the template is in the DOM.
+	 */
+	onAfterRender()
+	{
+		let tmpContainer = document.getElementById('TodoList-YearGrid');
+		if (!tmpContainer)
+		{
+			return super.onAfterRender();
+		}
+
+		let tmpMonthMap = this._monthMap;
+		let tmpHTML = '<div class="tl-year-grid">';
+
+		for (let m = 0; m < 12; m++)
+		{
+			let tmpCounts = tmpMonthMap[m] || { complete: 0, open: 0 };
+			let tmpTotal = tmpCounts.complete + tmpCounts.open;
+			let tmpIsCurrent = this._isCurrentYear && m === this._currentMonth;
+
+			let tmpCardClass = 'tl-year-month-card';
+			if (tmpIsCurrent)
+			{
+				tmpCardClass += ' tl-year-month-card-current';
+			}
+
+			tmpHTML += '<div class="' + tmpCardClass + '">';
+			tmpHTML += '<div class="tl-year-month-name">' + _MonthNamesFull[m] + '</div>';
+			tmpHTML += '<div class="tl-year-month-stats">';
+
+			if (tmpTotal > 0)
+			{
+				tmpHTML += '<span class="tl-year-month-stat"><strong>' + tmpTotal + '</strong> tasks</span>';
+				tmpHTML += '<span class="tl-year-month-stat">(<span class="tl-cal-badge tl-cal-badge-complete">' + tmpCounts.complete + '</span> done';
+				tmpHTML += ', <span class="tl-cal-badge tl-cal-badge-open">' + tmpCounts.open + '</span> open)</span>';
+			}
+			else
+			{
+				tmpHTML += '<span class="tl-year-month-stat" style="color:#B5ADA2;">No tasks</span>';
+			}
+
+			tmpHTML += '</div>';
+			tmpHTML += '</div>';
+		}
+
+		tmpHTML += '</div>';
+		tmpContainer.innerHTML = tmpHTML;
+
+		return super.onAfterRender();
+	}
+}
+
+module.exports = TodoListYearView;
+module.exports.default_configuration = _ViewConfiguration;

package/modules/.claude/settings.local.json

@@ -0,0 +1,52 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(xargs:*)",
+      "Bash(tree:*)",
+      "Bash(npm install:*)",
+      "Bash(npm view:*)",
+      "Bash(npm run build:*)",
+      "Bash(node -e:*)",
+      "Bash(curl:*)",
+      "Bash(find:*)",
+      "Bash(npx quack build:*)",
+      "Bash(npx quack copy:*)",
+      "Bash(npx quackage build)",
+      "Bash(npx quackage deploy:*)",
+      "Bash(ls:*)",
+      "Bash(lsof:*)",
+      "Bash(wc:*)",
+      "Bash(grep:*)",
+      "Bash(done)",
+      "Bash(npm test:*)",
+      "Bash(python3:*)",
+      "Bash(npx mocha:*)",
+      "Bash(git -C /Users/stevenvelozo/Code/retold remote:*)",
+      "Bash(git -C /Users/stevenvelozo/Code/retold config:*)",
+      "Bash(node:*)",
+      "Bash(chmod:*)",
+      "Bash(./scripts/mysql-test-db.sh:*)",
+      "Bash(npm run test-mysql:*)",
+      "Bash(npm run test-mysql-all:*)",
+      "Bash(npm run docker-mysql-status:*)",
+      "Bash(npm run:*)",
+      "Bash(./scripts/mssql-test-db.sh:*)",
+      "Bash(cat:*)",
+      "Bash(bash:*)",
+      "Bash(tr:*)",
+      "Bash(while read f)",
+      "Bash(do if [ ! -f \"/Users/stevenvelozo/Code/retold/docs/$f\" ])",
+      "Bash(then echo \"MISSING: $f\")",
+      "Bash(fi)",
+      "Bash(echo:*)",
+      "Bash(for app in todo-app contacts-app sports-stats-api)",
+      "Bash(do echo \"\")",
+      "Bash(cmp:*)",
+      "Bash(git rm:*)",
+      "Bash(xxd:*)",
+      "Bash(for f in *.cjs)",
+      "Bash(do sed -i '' \"s|require\\(''./Ultravisor-Task-Base.cjs''\\)|require\\(''../Ultravisor-Task-Base.cjs''\\)|g\" \"$f\")",
+      "Bash(npx ultravisor:*)"
+    ]
+  }
+}

package/modules/CLAUDE.md

@@ -0,0 +1,60 @@
+# Retold Modules
+
+This directory contains all Retold module groups. Each subfolder holds individual git repos.
+
+## Module Management
+
+Shell scripts manage all modules collectively:
+
+- `Checkout.sh` — Clone all module repos from GitHub
+- `Status.sh` — Show git status across all modules
+- `Update.sh` — Pull with rebase across all modules
+- `Include-Retold-Module-List.sh` — Central registry defining module arrays per group (sourced by the scripts above)
+- `Retold-Modules.md` — Human-readable module list with hosted doc links
+
+All modules are hosted at `github.com/stevenvelozo/<module-name>`.
+
+## Module Groups
+
+| Group | Folder | Count | Purpose |
+|-------|--------|-------|---------|
+| Fable | `fable/` | 6 | Core ecosystem, DI, config, logging |
+| Meadow | `meadow/` | 13 | Data access, ORM, query DSL, schema |
+| Orator | `orator/` | 6 | API server, Restify, proxy, WebSocket |
+| Pict | `pict/` | 15 | MVC, views, templates, forms, TUI |
+| Utility | `utility/` | 10+ | Build tools, manifests, docs |
+
+## Working in a Module
+
+Each module has its own `package.json`, tests, and README.
+
+**Testing:**
+```bash
+npm test                        # Mocha TDD: npx mocha -u tdd -R spec
+npm run coverage                # nyc coverage report
+```
+
+**Building:**
+```bash
+npx quack build                 # Most modules use Quackage
+```
+
+Some modules (e.g., Pict, Fable) also use Gulp + Browserify for browser bundles.
+
+## Code Style
+
+- Tabs for indentation, never spaces
+- Plain JavaScript only — no TypeScript
+- Opening braces on new lines (Allman style)
+- Variable naming:
+  - `pVariable` — function parameters
+  - `tmpVariable` — scoped/temporary variables
+  - `VARIABLE` — globals and constants
+  - `libSomeLibrary` — imported/required libraries
+- Match existing patterns in whichever module you are editing
+
+## Adding a New Module
+
+1. Add the repo name to the appropriate array in `Include-Retold-Module-List.sh`
+2. Update `Retold-Modules.md`
+3. The module should follow the same structure: `package.json`, `source/`, `test/`, Mocha TDD tests

package/modules/Checkout.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+echo "### Checking out Retold modules into: [$(pwd)/..."
+
+. ${BASH_SOURCE%/*}/Include-Retold-Module-List.sh
+
+#
+# This function attempts to checkout a repository from github relative to the current script folder
+check_out_repository()
+{
+#	echo "###--> attempting to check out the repository for $2 in $1"
+	CWD=$(pwd)
+	if [ -d "$CWD/$1/$2" ] 
+	then
+		echo "     > A $2 source directory already exists in $1.... skipping checkout."
+	elif [ -f "$CWD/$1/$2" ]; then
+		echo "     > A $2 file already exists in $1... skipping checkout."
+	else
+		git clone https://github.com/stevenvelozo/$2 ./$1/$2
+	fi
+}
+
+process_repository_set()
+{
+	# Save first argument in a variable
+	local repositorySetName="$1"
+	# Shift all arguments to the left (original $1 gets lost)
+	shift
+	# Collapse all remaining arguments into an array
+	local repositorySetRepositories=("$@") # Rebuild the array with rest of arguments
+	# Enumerate all repository addresses and check them out
+	for repositoryAddress in ${repositorySetRepositories[@]}; do
+		echo ""
+		echo "#####[ $repositorySetName -> $repositoryAddress ]#####"
+		check_out_repository $repositorySetName $repositoryAddress
+	done
+}
+
+process_repository_set "fable" "${repositoriesFable[@]}"
+process_repository_set "meadow" "${repositoriesMeadow[@]}"
+process_repository_set "orator" "${repositoriesOrator[@]}"
+process_repository_set "pict" "${repositoriesPict[@]}"
+process_repository_set "utility" "${repositoriesUtility[@]}"

package/modules/Include-Retold-Module-List.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+echo "### Building list of modules..."
+
+repositoriesFable=("fable" "fable-log" "fable-settings" "fable-uuid" "fable-serviceproviderbase" "fable-log-logger-bunyan")
+
+repositoriesMeadow=("stricture" "foxhound" "bibliograph" "meadow" "parime" "meadow-endpoints" "meadow-connection-mysql" "meadow-connection-mssql" "meadow-connection-sqlite" "retold-data-service" "retold-harness" "meadow-integration")
+
+repositoriesOrator=("orator" "orator-serviceserver-restify" "orator-static-server" "orator-http-proxy" "tidings" "orator-endpoint" "orator-conversion")
+
+repositoriesPict=("pict" "pict-template" "pict-view" "pict-provider" "pict-application" "pict-panel" "pict-nonlinearconfig" "pict-section-flow" "pict-docuserve" "cryptbrau" "informary" "pict-service-commandlineutility" "pict-section-recordset" "pict-section-content" "pict-section-form" "pict-section-tuigrid" "pict-router" "pict-serviceproviderbase" "pict-terminalui")
+
+repositoriesUtility=("indoctrinate" "manyfest" "quackage" "ultravisor")
+
+echo "### ... Module lists built!"

package/modules/Retold-Modules.md

@@ -0,0 +1,24 @@
+# Retold
+
+Each of these folders contain the basic modules for the retold package sets.
+
+## Module Documentation
+
+The following modules have documentation sites hosted on GitHub Pages:
+
+### Fable
+
+- [fable-uuid](https://stevenvelozo.github.io/fable-uuid/) - A simple, flexible UUID generator for Node.js and browsers
+
+### Pict
+
+- [pict](https://stevenvelozo.github.io/pict/) - A flexible MVC framework for building applications with text-based UI
+- [pict-view](https://stevenvelozo.github.io/pict-view/) - A flexible View base class for the Pict application framework
+
+## Cleaning the DS_Store Folders
+
+If you are using some variant of MacOS, and hate these folders, run this as a salve.
+
+```
+find . -name '.DS_Store' -type f -delete
+```

package/modules/Status.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+echo "Checking status of Retold modules in: [$(pwd)/..."
+
+. ${BASH_SOURCE%/*}/Include-Retold-Module-List.sh
+
+TOTAL_REPOS=0
+CHANGED_REPOS=0
+MISSING_REPOS=0
+
+#
+# This function checks the status of a repository, only showing output if there are changes
+status_repository()
+{
+	CWD=$(pwd)
+	TOTAL_REPOS=$((TOTAL_REPOS + 1))
+	if [ -d "$CWD/$1/$2" ]
+	then
+		cd "$CWD/$1/$2"
+		# Check if there are any changes (staged, unstaged, or untracked)
+		if [ -n "$(git status --porcelain)" ]
+		then
+			CHANGED_REPOS=$((CHANGED_REPOS + 1))
+			echo ""
+			echo "#####[ $1 -> $2 ]#####"
+			git status
+		fi
+		cd "$CWD"
+	else
+		MISSING_REPOS=$((MISSING_REPOS + 1))
+	fi
+}
+
+process_repository_set()
+{
+	# Save first argument in a variable
+	local repositorySetName="$1"
+	# Shift all arguments to the left (original $1 gets lost)
+	shift
+	# Collapse all remaining arguments into an array
+	local repositorySetRepositories=("$@") # Rebuild the array with rest of arguments
+	# Enumerate all repository addresses and check them out
+	for repositoryAddress in ${repositorySetRepositories[@]}; do
+		status_repository $repositorySetName $repositoryAddress
+	done
+}
+
+process_repository_set "fable" "${repositoriesFable[@]}"
+process_repository_set "meadow" "${repositoriesMeadow[@]}"
+process_repository_set "orator" "${repositoriesOrator[@]}"
+process_repository_set "pict" "${repositoriesPict[@]}"
+process_repository_set "utility" "${repositoriesUtility[@]}"
+
+echo ""
+echo "===== Summary ====="
+echo "$TOTAL_REPOS modules checked, $CHANGED_REPOS with changes, $((TOTAL_REPOS - CHANGED_REPOS - MISSING_REPOS)) clean"
+if [ $MISSING_REPOS -gt 0 ]
+then
+	echo "$MISSING_REPOS modules not checked out (run Checkout.sh)"
+fi

package/modules/Update.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+echo "Checking out Retold modules into: [$(pwd)/..."
+
+. ${BASH_SOURCE%/*}/Include-Retold-Module-List.sh
+
+#
+# This function attempts to update a repository from github relative to the current script folder
+update_repository()
+{
+#	echo "    ###--> attempting to update the repository for $2 in $1"
+	CWD=$(pwd)
+	if [ -d "$CWD/$1/$2" ]
+	then
+#		echo "       # A $2 source directory exists in $1 -- updating with rebase...."
+		cd "$CWD/$1/$2"
+		git pull --rebase
+#		echo "       ..."
+		cd "../.."
+	else
+		echo "       # The $2 source directory does not exist in $1 -- maybe you need to run the Checkout script?"
+	fi
+	echo "      <-- update attempt complete for repository $2 in $1"
+}
+
+process_repository_set()
+{
+	# Save first argument in a variable
+	local repositorySetName="$1"
+	# Shift all arguments to the left (original $1 gets lost)
+	shift
+	# Collapse all remaining arguments into an array
+	local repositorySetRepositories=("$@") # Rebuild the array with rest of arguments
+	# Enumerate all repository addresses and check them out
+	for repositoryAddress in ${repositorySetRepositories[@]}; do
+		echo ""
+		echo "[ U ] --> #####[ $repositorySetName -> $repositoryAddress ]#####"
+		update_repository $repositorySetName $repositoryAddress
+	done
+}
+
+process_repository_set "fable" "${repositoriesFable[@]}"
+process_repository_set "meadow" "${repositoriesMeadow[@]}"
+process_repository_set "orator" "${repositoriesOrator[@]}"
+process_repository_set "pict" "${repositoriesPict[@]}"
+process_repository_set "utility" "${repositoriesUtility[@]}"

package/modules/fable/Fable.md

@@ -0,0 +1,2 @@
+# Fable
+

package/modules/meadow/Meadow.md

@@ -0,0 +1 @@
+# Meadow

package/modules/orator/Orator.md

@@ -0,0 +1 @@
+# Orator