Nicholas Kyriakides nicholaswmin

flow

format for flow documenation in [LLM][llm]-assisted refactoring

This spec is given to the LLM which in turn utilizes it to
produce documentation of [system flows][flow], each showing
[state transitions][state], [steps][step], and [side effects][effect].

These flow documents support:

pretty printer for object/arrays

const result = inspect([ { index: 1,   value: 'foo bar baz '.repeat(100) },
                         { index: 2,   value: 'foo bar baz '.repeat(10)  },
                         { index: 125, value:  null                      },
                         { index: 16,  value: 0123456789                 },
{ index: 300, value: function foo() {} },

	#!/usr/bin/env zsh

	autoload -U colors && colors

	# Check for correct shell
	if [ -z "$ZSH_VERSION" ]; then
	echo "Error: This script must be run with zsh, not sh or bash"
	echo "Please run with: zsh ./vouch.zsh install"
	exit 1
	fi

	#!/usr/bin/env zsh
	# ext-sync.zsh
	#
	# Authors: 2025 - nicholaswmin - MIT
	#
	# Declaratively lists all installed zed.dev extensions
	# in `settings.json` under `auto_install_extensions`
	# - Run once before backing up dotfiles.
	# - https://zed.dev/docs/configuring-zed#auto-install-extensions
	#

	#!/usr/bin/env zsh
	# a git-based, no-tools dotfiles manager
	# authors: @nicholaswmin, The MIT License

	set -e

	# TODO:
	# - [ ] think about Spotlight filetype exclusion
	# - [ ] consider ohmyzsh
	# - [ ] automate git clone of work projects

	/* Largest-Triangle-3-Buckets/MinMax in ES6
	+ unit tests, run by node --test foo.js
	- authors: Nicholas Kyriakides, @nicholasmin
	- license: MIT
	from: Downsampling Time Series for Visual Representation
	Sveinn Steinarsson
	University of Iceland,
	https://skemman.is/handle/1946/15343

	Downsampling/Decimation Algorithms

	/**l
	* Opens Chrome tab to a specified URL(or reload if exists)
	* without the usual ballbusting focus loss on every file change.
	*
	* Meant for:
	* `$ node --watch` or `$ nodemon app.js`
	* type of orkflows where you don't
	* want each file-save taking you to the browser.
	*
	* macOS only; no Linux/Windows

	#!/bin/sh

	# test.sh
	# ----------------------
	# scaffold example test:
	# sh --init

	#
	# quickstart:
	#

	/** @function
	* @name validated
	* @summary validate the type of a value
	*
	* @description
	* validates a value against a {spec}. object, specifying:
	* - parameter {name}
	* - expected {type}
	* {type} suppers & differentiates non-standard "array" and "null" types.
	*

	/* examples:
	$$('.button').map(el => el.on('click', console.log))
	$('body').on('mouseenter', console.log) */

	Node.prototype.on = Node.prototype.addEventListener
	window.$ = document.querySelectorAll.bind(document)
	window.$$ = (...a) => Array.from(document.querySelectorAll(...a))