mirror of
https://github.com/zvx-echo6/meshai.git
synced 2026-08-26 17:31:34 +00:00
* feat(region-routing): P1 tagging + region_routes primitive + read/write API + preview launcher - config.py: add Coverage.region_tagging (bool=False); add RegionRouteMatrix dataclass (enabled, cells) above NotificationsConfig; add region_routes field to NotificationsConfig; add explicit hydration branch for region_routes in _dict_to_dataclass mirroring destinations pattern. - coverage_area.py: add MonitoringArea.name (str|None=None, frozen); update areas_from_config to preserve name; refactor inline geom extraction from classify_event_areas into shared _event_geom_json helper; add matching_area_names(geom_json, areas)->list[str] (additive, all named matches, config-order, deduped; gate unchanged); add event_region_names convenience wrapper. - coverage_filter.py: add region_tagging ctor kwarg; stamp event.region/ regions before the gate when region_tagging=True and areas non-empty and not event.regions (never clobbers satpass preset). - pipeline/__init__.py: wire region_tagging into CoverageFilter construction. - notification_routes.py: add GET /notifications/regions (named coverage area names, config-order, deduped); GET /notifications/region-routing (matrix as JSON); POST /notifications/region-routing (explicit RMW — only region_routes changes, toggles/rules/destinations survive). - scripts/preview_dashboard.py: mesh-free launcher — dashboard API only, no mesh connector, no broadcast loop; vite runs separately. All 87 coverage tests pass; 300 total pass; 6 pre-existing failures unchanged (adapter config count mismatch + MeshCore EventType.NEW_CONTACT). * feat(region-routing): manual region x family matrix editor page Adds RegionRoutingMatrix.tsx — a plain editor over the region_routes config primitive. Rows = families (via useFamilies()), cols = regions (from GET /api/notifications/regions). Each cell exposes MT channel (ChannelPicker single + includeDisabled), MC channel name (text input), min_severity select (routine/priority/critical/immediate), and an enabled checkbox. Only cells where MT or MC is set are included in the sparse POST payload. Master enable toggle maps to top-level enabled. MT budget guard warns when more than 7 distinct MT indices are in use. Sticky family column; horizontal scroll for wide region sets. Registers route /region-routing in App.tsx and adds "Region Routing" nav entry (Map icon) under the Meshtastic section in Layout.tsx, immediately after Routing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(region-routing): regions endpoint reads saved (disk) coverage so routing columns are dynamic without a bot restart; preview reloads config after writes * feat(routing): unify MT/MC routing into per-family cards; region routing as an in-card expand; remove rules/destinations UI + standalone page * refactor(routing): move Meshtastic Routing from /notifications to /meshtastic/routing (mirror /meshcore/routing); redirect legacy path * feat(region-routing): dispatcher honors region_routes matrix (authoritative-on-match, per-region cooldown, per-channel dedup); non-matrix path unchanged Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(region-routing): matrix dedup key must match boot-restore 2-tuple form (prevents restart re-broadcast flood); regression test --------- Co-authored-by: Matt Johnson <mj@k7zvx.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
195 lines
4.4 KiB
JavaScript
195 lines
4.4 KiB
JavaScript
const flagSymbol = Symbol('arg flag');
|
|
|
|
class ArgError extends Error {
|
|
constructor(msg, code) {
|
|
super(msg);
|
|
this.name = 'ArgError';
|
|
this.code = code;
|
|
|
|
Object.setPrototypeOf(this, ArgError.prototype);
|
|
}
|
|
}
|
|
|
|
function arg(
|
|
opts,
|
|
{
|
|
argv = process.argv.slice(2),
|
|
permissive = false,
|
|
stopAtPositional = false
|
|
} = {}
|
|
) {
|
|
if (!opts) {
|
|
throw new ArgError(
|
|
'argument specification object is required',
|
|
'ARG_CONFIG_NO_SPEC'
|
|
);
|
|
}
|
|
|
|
const result = { _: [] };
|
|
|
|
const aliases = {};
|
|
const handlers = {};
|
|
|
|
for (const key of Object.keys(opts)) {
|
|
if (!key) {
|
|
throw new ArgError(
|
|
'argument key cannot be an empty string',
|
|
'ARG_CONFIG_EMPTY_KEY'
|
|
);
|
|
}
|
|
|
|
if (key[0] !== '-') {
|
|
throw new ArgError(
|
|
`argument key must start with '-' but found: '${key}'`,
|
|
'ARG_CONFIG_NONOPT_KEY'
|
|
);
|
|
}
|
|
|
|
if (key.length === 1) {
|
|
throw new ArgError(
|
|
`argument key must have a name; singular '-' keys are not allowed: ${key}`,
|
|
'ARG_CONFIG_NONAME_KEY'
|
|
);
|
|
}
|
|
|
|
if (typeof opts[key] === 'string') {
|
|
aliases[key] = opts[key];
|
|
continue;
|
|
}
|
|
|
|
let type = opts[key];
|
|
let isFlag = false;
|
|
|
|
if (
|
|
Array.isArray(type) &&
|
|
type.length === 1 &&
|
|
typeof type[0] === 'function'
|
|
) {
|
|
const [fn] = type;
|
|
type = (value, name, prev = []) => {
|
|
prev.push(fn(value, name, prev[prev.length - 1]));
|
|
return prev;
|
|
};
|
|
isFlag = fn === Boolean || fn[flagSymbol] === true;
|
|
} else if (typeof type === 'function') {
|
|
isFlag = type === Boolean || type[flagSymbol] === true;
|
|
} else {
|
|
throw new ArgError(
|
|
`type missing or not a function or valid array type: ${key}`,
|
|
'ARG_CONFIG_VAD_TYPE'
|
|
);
|
|
}
|
|
|
|
if (key[1] !== '-' && key.length > 2) {
|
|
throw new ArgError(
|
|
`short argument keys (with a single hyphen) must have only one character: ${key}`,
|
|
'ARG_CONFIG_SHORTOPT_TOOLONG'
|
|
);
|
|
}
|
|
|
|
handlers[key] = [type, isFlag];
|
|
}
|
|
|
|
for (let i = 0, len = argv.length; i < len; i++) {
|
|
const wholeArg = argv[i];
|
|
|
|
if (stopAtPositional && result._.length > 0) {
|
|
result._ = result._.concat(argv.slice(i));
|
|
break;
|
|
}
|
|
|
|
if (wholeArg === '--') {
|
|
result._ = result._.concat(argv.slice(i + 1));
|
|
break;
|
|
}
|
|
|
|
if (wholeArg.length > 1 && wholeArg[0] === '-') {
|
|
/* eslint-disable operator-linebreak */
|
|
const separatedArguments =
|
|
wholeArg[1] === '-' || wholeArg.length === 2
|
|
? [wholeArg]
|
|
: wholeArg
|
|
.slice(1)
|
|
.split('')
|
|
.map((a) => `-${a}`);
|
|
/* eslint-enable operator-linebreak */
|
|
|
|
for (let j = 0; j < separatedArguments.length; j++) {
|
|
const arg = separatedArguments[j];
|
|
const [originalArgName, argStr] =
|
|
arg[1] === '-' ? arg.split(/=(.*)/, 2) : [arg, undefined];
|
|
|
|
let argName = originalArgName;
|
|
while (argName in aliases) {
|
|
argName = aliases[argName];
|
|
}
|
|
|
|
if (!(argName in handlers)) {
|
|
if (permissive) {
|
|
result._.push(arg);
|
|
continue;
|
|
} else {
|
|
throw new ArgError(
|
|
`unknown or unexpected option: ${originalArgName}`,
|
|
'ARG_UNKNOWN_OPTION'
|
|
);
|
|
}
|
|
}
|
|
|
|
const [type, isFlag] = handlers[argName];
|
|
|
|
if (!isFlag && j + 1 < separatedArguments.length) {
|
|
throw new ArgError(
|
|
`option requires argument (but was followed by another short argument): ${originalArgName}`,
|
|
'ARG_MISSING_REQUIRED_SHORTARG'
|
|
);
|
|
}
|
|
|
|
if (isFlag) {
|
|
result[argName] = type(true, argName, result[argName]);
|
|
} else if (argStr === undefined) {
|
|
if (
|
|
argv.length < i + 2 ||
|
|
(argv[i + 1].length > 1 &&
|
|
argv[i + 1][0] === '-' &&
|
|
!(
|
|
argv[i + 1].match(/^-?\d*(\.(?=\d))?\d*$/) &&
|
|
(type === Number ||
|
|
// eslint-disable-next-line no-undef
|
|
(typeof BigInt !== 'undefined' && type === BigInt))
|
|
))
|
|
) {
|
|
const extended =
|
|
originalArgName === argName ? '' : ` (alias for ${argName})`;
|
|
throw new ArgError(
|
|
`option requires argument: ${originalArgName}${extended}`,
|
|
'ARG_MISSING_REQUIRED_LONGARG'
|
|
);
|
|
}
|
|
|
|
result[argName] = type(argv[i + 1], argName, result[argName]);
|
|
++i;
|
|
} else {
|
|
result[argName] = type(argStr, argName, result[argName]);
|
|
}
|
|
}
|
|
} else {
|
|
result._.push(wholeArg);
|
|
}
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
arg.flag = (fn) => {
|
|
fn[flagSymbol] = true;
|
|
return fn;
|
|
};
|
|
|
|
// Utility types
|
|
arg.COUNT = arg.flag((v, name, existingCount) => (existingCount || 0) + 1);
|
|
|
|
// Expose error class
|
|
arg.ArgError = ArgError;
|
|
|
|
module.exports = arg;
|