mirror of
https://github.com/zvx-echo6/meshai.git
synced 2026-09-03 23:03:52 +00:00
malice
2c46c9104d* 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>
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# Pirates [![Coverage][codecov-badge]][codecov-link]
|
|
|
|
### Properly hijack require
|
|
|
|
This library allows to add custom require hooks, which do not interfere with other require hooks.
|
|
|
|
This library only works with commonJS.
|
|
|
|
[codecov-badge]: https://img.shields.io/codecov/c/github/danez/pirates/master.svg?style=flat "codecov"
|
|
[codecov-link]: https://codecov.io/gh/danez/pirates "codecov"
|
|
|
|
## Why?
|
|
|
|
Two reasons:
|
|
1. Babel and istanbul were breaking each other.
|
|
2. Everyone seemed to re-invent the wheel on this, and everyone wanted a solution that was DRY, simple, easy to use,
|
|
and made everything Just Work™, while allowing multiple require hooks, in a fashion similar to calling `super`.
|
|
|
|
For some context, see [the Babel issue thread][] which started this all, then [the nyc issue thread][], where
|
|
discussion was moved (as we began to discuss just using the code nyc had developed), and finally to [#1][issue-1]
|
|
where discussion was finally moved.
|
|
|
|
[the Babel issue thread]: https://github.com/babel/babel/pull/3062 "Babel Issue Thread"
|
|
[the nyc issue thread]: https://github.com/bcoe/nyc/issues/70 "NYC Issue Thread"
|
|
[issue-1]: https://github.com/danez/pirates/issues/1 "Issue #1"
|
|
|
|
## Installation
|
|
|
|
npm install --save pirates
|
|
|
|
## Usage
|
|
|
|
Using pirates is really easy:
|
|
```javascript
|
|
// my-module/register.js
|
|
const addHook = require('pirates').addHook;
|
|
// Or if you use ES modules
|
|
// import { addHook } from 'pirates';
|
|
|
|
function matcher(filename) {
|
|
// Here, you can inspect the filename to determine if it should be hooked or
|
|
// not. Just return a truthy/falsey. Files in node_modules are automatically ignored,
|
|
// unless otherwise specified in options (see below).
|
|
|
|
// TODO: Implement your logic here
|
|
return true;
|
|
}
|
|
|
|
const revert = addHook(
|
|
(code, filename) => code.replace('@@foo', 'console.log(\'foo\');'),
|
|
{ exts: ['.js'], matcher }
|
|
);
|
|
|
|
// And later, if you want to un-hook require, you can just do:
|
|
revert();
|
|
```
|
|
|
|
## API
|
|
|
|
### pirates.addHook(hook, [opts={ [matcher: true], [exts: ['.js']], [ignoreNodeModules: true] }]);
|
|
Add a require hook. `hook` must be a function that takes `(code, filename)`, and returns the modified code. `opts` is
|
|
an optional options object. Available options are: `matcher`, which is a function that accepts a filename, and
|
|
returns a truthy value if the file should be hooked (defaults to a function that always returns true), falsey if
|
|
otherwise; `exts`, which is an array of extensions to hook, they should begin with `.` (defaults to `['.js']`);
|
|
`ignoreNodeModules`, if true, any file in a `node_modules` folder wont be hooked (the matcher also wont be called),
|
|
if false, then the matcher will be called for any files in `node_modules` (defaults to true).
|
|
|
|
|
|
## Projects that use Pirates
|
|
|
|
See the [wiki page](https://github.com/danez/pirates/wiki/Projects-using-Pirates). If you add Pirates to your project,
|
|
(And you should! It works best if everyone uses it. Then we can have a happy world full of happy require hooks!), please
|
|
add yourself to the wiki.
|