Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* Sharp-free border and alpha primitives shared by image-processing lanes.
*
* Border sampling deliberately uses a narrow band and a subsampled perimeter:
* one dirty edge row should not overturn an otherwise flat background, while a
* large source should not allocate one sample for every border pixel.
*/
/** statistics.median: middle value, or mean of the two middles. */
export function median(values) {
const sorted = [...values].sort((a, b) => a - b);
const mid = sorted.length >> 1;
return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
}
/**
* Return raw RGBA offsets for the shared border band.
*
* Callers that need a different sampling geometry can override `band` and
* `step`; the sprite lane uses the defaults, while a domain preserving a
* historical one-pixel ring can request `{ band: 1, step: 1 }` explicitly.
*/
export function getBorderBandOffsets(
{ width, height },
{ band, step } = {},
) {
const minDim = Math.min(width, height);
const sampleBand = Math.max(1, band ?? Math.max(4, Math.floor(minDim / 120)));
const sampleStep = Math.max(1, step ?? Math.max(1, Math.floor(minDim / 320)));
const offsets = [];
const push = (x, y) => offsets.push((y * width + x) * 4);
for (let x = 0; x < width; x += sampleStep) {
for (let o = 0; o < sampleBand && o < height; o += 1) {
push(x, o);
push(x, height - 1 - o);
}
}
for (let y = 0; y < height; y += sampleStep) {
for (let o = 0; o < sampleBand && o < width; o += 1) {
push(o, y);
push(width - 1 - o, y);
}
}
return offsets;
}
const borderColor = (data, offsets) => (
[0, 1, 2].map((channel) => median(offsets.map((offset) => data[offset + channel])))
);
const rgbDistanceSq = (data, offset, [r, g, b]) => (
(data[offset] - r) ** 2
+ (data[offset + 1] - g) ** 2
+ (data[offset + 2] - b) ** 2
);
/**
* Sample the median RGB value across the subsampled border band.
*
* The returned medians intentionally retain the statistics semantics for an
* even sample count. Callers that need a codec/pipeline-specific integer
* rounding policy should apply it at their domain boundary.
*
* @param {{data: Buffer|Uint8Array, width: number, height: number}} frame
* @returns {[number, number, number]}
*/
export function sampleBorderKey({ data, width, height }, options = {}) {
const offsets = getBorderBandOffsets({ width, height }, options);
return borderColor(data, offsets);
}
/**
* Detect a flat border background using the shared band sampler.
*
* @param {{data: Buffer|Uint8Array, width: number, height: number}} frame
* @param {{tolerance?: number, minCoverage?: number}} options
* @returns {[number, number, number]|null}
*/
export function detectSolidBorderColor(
{ data, width, height },
{
tolerance = 30,
minCoverage = 0.9,
band,
step,
} = {},
) {
const offsets = getBorderBandOffsets({ width, height }, { band, step });
if (!offsets.length) return null;
const color = borderColor(data, offsets);
const toleranceSq = tolerance ** 2;
const matching = offsets.reduce(
(count, offset) => count + (rgbDistanceSq(data, offset, color) <= toleranceSq ? 1 : 0),
0,
);
return matching / offsets.length >= minCoverage ? color : null;
}
/**
* Whether an RGBA buffer contains alpha below image-to-3D's historical 250
* meaningfulness cutoff.
*/
export function hasMeaningfulAlpha(data) {
for (let i = 3; i < data.length; i += 4) {
if (data[i] < 250) return true;
}
return false;
}
/** Whether an RGBA buffer's alpha channel varies between pixels. */
export function hasAlphaVariation(data) {
if (data.length < 4) return false;
const first = data[3];
for (let i = 7; i < data.length; i += 4) {
if (data[i] !== first) return true;
}
return false;
}