@onimaxxing/sussy-seeds-mcp 0.1.6 → 0.2.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 onimaxxing
+Copyright (c) 2026 i must onimaxx. i MuSt oNiMaXx! I MUST ONIMAXX!!! onimaxxing.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -90,7 +90,12 @@ Streams `notifications/progress` when the client sends `_meta.progressToken`. Ca
 - `scanUntil({coord, spec, targetHits, opts?})`: stops at N matches.
 - `scanSeeds({coord, spec, seeds})`: one row per input seed.
 
-`spec.preHook` and `spec.postHook` accept raw JS. Reserved-identifier guard rejects sources that shadow the Builder emit's bindings.
+`spec.preHook` and `spec.postHook` accept raw JS and are async-first (since 0.2.0):
+
+- Top-level `await worldgen()` works in both hooks; an async preHook's `return { pass: false }` gates the seed, and a rejection (e.g. a gen-failure seed) drops the seed instead of crashing anything.
+- Put cheap summary checks (`hasTrait(summary, findHomeIdx(summary), 'GeoActive')`) before the first `await` so rejected seeds never pay the ~350ms worldgen cost.
+- `scratch` is a per-seed `{}` shared by both hooks: compute in the preHook, then set `score = scratch.whatever` in the postHook to rank results through the normal score channel.
+- Reserved-identifier guard rejects sources that shadow the Builder emit's bindings.
 
 ### Inspection
 
@@ -105,6 +110,8 @@ Streams `notifications/progress` when the client sends `_meta.progressToken`. Ca
 ### Diagnostics
 
 - `ping()`
+- `probeSummarize({coord, seed?})`: boots the wasm and returns one
+  seed's full ClusterSummary — end-to-end scanner smoke test.
 - `probeStreaming({steps, delayMs})`
 
 ## Constraint kinds