@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/esm/campaign/bands.js

@@ -0,0 +1,176 @@
+/**
+ * What a mess is, and what clearing it is worth — the tables alone.
+ *
+ * Split out of `spot.ts` so a phone can carry the prices without the ask.
+ * The mapping ask's terms are a page of criterion prose, and three client
+ * surfaces — the map's pin card, the grown-up assessment picker, and the
+ * youth app's emoji vocabulary — need only these three tables and the
+ * arithmetic over them. `spot.ts` re-exports every name here, so nothing
+ * that already imports from it has to know this file exists.
+ *
+ * A spot needs a number before anybody can watch a thermometer fill, and the
+ * only person who knows that number is standing in front of it. So the estimate
+ * is not a separate step — it is three questions on the mapping form, and this
+ * file turns their answers into money.
+ *
+ * **Bands, not measurements.** A person can see "about a car boot" and cannot
+ * see 0.5 m³; a liar has to jump a whole category rather than shade a figure;
+ * and a model asked to check the estimate against the photograph can tell a
+ * bagful from a truckload while it could never tell 8 m³ from 11.
+ *
+ * **Every figure here is a placeholder** until somebody who has actually run a
+ * municipal cleanup spends an afternoon on them. They are in one table on
+ * purpose: a number nobody can find is a number nobody corrects.
+ */
+/** 1 unit = 1e6 base. Written out so the tables below read as money. */
+const MONEY = 1_000_000;
+/**
+ * How much there is. `base` is what clearing it is worth before the
+ * multipliers — the crew, the hours and the trips it implies.
+ */
+export const VOLUME = {
+    bagful: { base: 3 * MONEY, says: "a bagful" },
+    boot: { base: 12 * MONEY, says: "a car boot" },
+    trailer: { base: 40 * MONEY, says: "a trailer" },
+    truck: { base: 150 * MONEY, says: "a truck" },
+    /**
+     * Priced, and **never offered to a crowd**. A site this size needs a
+     * coordinator, a vehicle and usually the municipality; putting it on a map as
+     * a thing a volunteer can take is how somebody gets hurt or gives up. It
+     * routes to the professionals path, same as anything hazardous.
+     */
+    bigger: { base: 400 * MONEY, says: "bigger than a truck" }
+};
+/** What it is. Disposal is not free, and some of it is not close to free. */
+export const WASTE = {
+    household: { factor: 1, says: "household" },
+    garden: { factor: 0.8, says: "garden" },
+    rubble: { factor: 1.5, says: "rubble" },
+    /** Tyres, mattresses, electronics — the things a tip charges to take. */
+    awkward: { factor: 2, says: "tyres, mattresses or electronics" }
+};
+/** Getting to it, because carrying is most of the work. */
+export const ACCESS = {
+    roadside: { factor: 1, says: "roadside" },
+    carry: { factor: 1.3, says: "a carry" },
+    hard: { factor: 1.8, says: "steep or water's edge" }
+};
+/**
+ * The assessment as a person would say it — "a car boot of household,
+ * roadside" — from the same tables that price it, so the words and the
+ * money can never describe two different messes. This is the phrase the
+ * mapping claim already used of itself; a cleanup posted against the pin
+ * should speak of the mess, not of the coordinates (the position lives in
+ * the terms' own radius gate and on every map). Unknown bands fall through
+ * to null: a title is not the place to guess.
+ */
+export function spotPhrase(assessment) {
+    if (!isAssessment(assessment))
+        return null;
+    /* Every kind the finder picked, not just the dearest — the phrase is what
+       a cleaner reads to know what they are walking towards. */
+    return `${VOLUME[assessment.volume].says} of ${listSays(wastesOf(assessment))}, ${ACCESS[assessment.access].says}`;
+}
+/**
+ * Every kind of waste the finder saw, dearest first in effect.
+ *
+ * A mess is usually mixed (IXO-4928), and the picker took one answer
+ * because the single answer priced the spot. The pool made that
+ * unnecessary — what a cleaner is paid is what people put in — so the
+ * question can be asked honestly now.
+ *
+ * `wastes` is additive and `waste` stays: it becomes the **dominant** pick,
+ * the one with the highest disposal factor. Every reader that has ever
+ * existed goes on working unchanged, an assessment written before this
+ * reads as one kind, and `spotTarget` prices at the dearest thing present —
+ * which is the right direction for a ceiling that is never what gets paid.
+ */
+export function dominantWaste(wastes) {
+    let best = null;
+    for (const key of ORDERED_WASTE) {
+        if (!wastes.includes(key))
+            continue;
+        if (best === null || WASTE[key].factor > WASTE[best].factor)
+            best = key;
+    }
+    return best;
+}
+/** Table order, so ties break the way the cards are laid out rather than by chance. */
+const ORDERED_WASTE = Object.keys(WASTE);
+/**
+ * What an assessment says was in the mess, however it was written.
+ *
+ * One reader for both shapes: the list when there is one, the single band
+ * when there is not, and nothing when neither is a band this table knows.
+ */
+export function wastesOf(assessment) {
+    if (!assessment)
+        return [];
+    const said = Array.isArray(assessment.wastes) && assessment.wastes.length > 0 ? assessment.wastes : [assessment.waste];
+    const kept = [];
+    for (const key of ORDERED_WASTE)
+        if (said.includes(key) && !kept.includes(key))
+            kept.push(key);
+    return kept;
+}
+/** "household", "household and rubble", "household, garden and rubble". */
+function listSays(wastes) {
+    const words = wastes.map((key) => WASTE[key].says);
+    if (words.length <= 1)
+        return words[0] ?? "";
+    return `${words.slice(0, -1).join(", ")} and ${words[words.length - 1]}`;
+}
+/** The one place the three bands become one number. */
+const ORDER = "volume × waste × access";
+/**
+ * A band is a key the table itself declares — never one it inherits.
+ *
+ * `in` answered yes to `"constructor"`, `"toString"` and every other name on
+ * `Object.prototype`, and an assessment is written by whoever submits the
+ * mapping claim. `VOLUME["constructor"]` is a function with no `base`, so the
+ * spot priced at NaN: every comparison in the funding plan said "no", the
+ * target read as met, and the posting carried "NaN" to the chain. Own keys
+ * only, and only when the value is a string at all.
+ */
+const bandOf = (table, value) => typeof value === "string" && Object.hasOwn(table, value);
+export function isAssessment(value) {
+    const doc = value;
+    return Boolean(doc && typeof doc === "object" && bandOf(VOLUME, doc.volume) && bandOf(WASTE, doc.waste) && bandOf(ACCESS, doc.access));
+}
+/**
+ * What this spot is worth clearing, in base units — **a ceiling, not a price.**
+ *
+ * What actually gets paid is settled by what reached the disposal point. That
+ * distinction is the whole defence against an inflated estimate: reporting "a
+ * truck" raises the target and never the reporter's own fee, so the map ends up
+ * saying *"estimated: a trailer · hauled: two bags"* against a name, on a
+ * record nobody can edit. Self-correcting beats policed.
+ *
+ * Throws on an unknown band rather than treating it as free. A typo that costs
+ * nothing is a typo nobody finds.
+ */
+export function spotTarget(assessment) {
+    if (!isAssessment(assessment)) {
+        throw new Error(`not a spot assessment: ${JSON.stringify(assessment)}. ${ORDER}, each from its own table`);
+    }
+    const { base } = VOLUME[assessment.volume];
+    const target = Math.round(base * WASTE[assessment.waste].factor * ACCESS[assessment.access].factor);
+    /* The tables are constants, so this cannot fire today; it is the promise
+       that a corrected table which loses a number fails loudly rather than
+       pricing a spot at NaN. */
+    if (!Number.isSafeInteger(target) || target <= 0)
+        throw new Error(`the price table yields ${target} for ${JSON.stringify(assessment)}`);
+    return target;
+}
+/** The same fact as a sentence, for a pin somebody is deciding whether to back. */
+export function spotSays(assessment) {
+    if (!isAssessment(assessment))
+        throw new Error("not a spot assessment");
+    const size = VOLUME[assessment.volume].says;
+    const what = listSays(wastesOf(assessment));
+    const reach = ACCESS[assessment.access].says;
+    return `${size} of ${what}, ${reach}`;
+}
+/** Work a crowd should not be sent at: too big, whatever it is made of. */
+export const needsProfessionals = (assessment) => assessment.volume === "bigger";
+//# sourceMappingURL=bands.js.map

package/dist/esm/campaign/bands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bands.js","sourceRoot":"","sources":["../../../src/campaign/bands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wEAAwE;AACxE,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE;IAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;IAC9C,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE;IAChD,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7C;;;;;OAKG;IACH,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE;CAClD,CAAC;AAEX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;IAC3C,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvC,yEAAyE;IACzE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE;CACxD,CAAC;AAEX,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;IACzC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE;IACvC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,uBAAuB,EAAE;CAC5C,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,UAA+G;IACxI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C;gEAC4D;IAC5D,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AACrH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,IAAI,IAAI,GAAiB,IAAI,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;YAAE,IAAI,GAAG,GAAG,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAY,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,UAA6E;IACpG,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvH,MAAM,IAAI,GAAY,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,aAAa;QAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,SAAS,QAAQ,CAAC,MAAwB;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAeD,uDAAuD;AACvD,MAAM,KAAK,GAAG,yBAAyB,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,MAAM,GAAG,CAAmB,KAAQ,EAAE,KAAc,EAAoB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE1I,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,GAAG,GAAG,KAAmC,CAAC;IAChD,OAAO,OAAO,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACzI,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,UAAsB;IAC/C,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,KAAK,2BAA2B,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IACpG;;gCAE4B;IAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACxI,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,UAAsB;IAC7C,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IAC7C,OAAO,GAAG,IAAI,OAAO,IAAI,KAAK,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAsB,EAAW,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC"}

package/dist/esm/campaign/campaign.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Every ask in one campaign, and what became of it.
+ *
+ * A sponsor's real question is not "did anyone clean anything" but **"what did
+ * my money buy, and is it still true?"** — and that is a question about a set
+ * of asks rather than about any one receipt. Everything here is already public
+ * on chain and in the public stores; this only gathers it.
+ *
+ * The campaign tag lives in each ask's published terms, frozen at posting, so
+ * membership cannot be edited afterwards — a campaign cannot quietly drop the
+ * spots that went badly.
+ */
+export interface CampaignSpot {
+    collectionId: string;
+    /** The place as the ask named it, frozen into its terms at posting. */
+    place: string | null;
+    lat: number | null;
+    lon: number | null;
+    /** Approved · rejected · flagged · waiting for somebody to answer. */
+    state: "cleaned" | "refused" | "flagged" | "waiting";
+    /** The two photographs, once the ask has stopped taking answers. */
+    before: string | null;
+    after: string | null;
+    /** What actually moved, in base units, and in which denom. */
+    paidBase: number;
+    denom: string | null;
+    submittedAt: string | null;
+    decidedAt: string | null;
+    /** Seconds from submission to verdict, when both are known. */
+    verdictSeconds: number | null;
+    /** What a later look found, when one was bought and answered. */
+    held: "held" | "not held" | "awaiting" | null;
+}
+export interface CampaignTotals {
+    spots: number;
+    cleaned: number;
+    paidBase: number;
+    denom: string | null;
+    /** A real median, over the spots that actually reached a verdict. */
+    medianVerdictSeconds: number | null;
+    heldRate: number | null;
+}
+export declare function loadCampaign(tag: string, options?: {
+    since?: string;
+    limit?: number;
+}): Promise<{
+    spots: CampaignSpot[];
+    totals: CampaignTotals;
+}>;
+//# sourceMappingURL=campaign.d.ts.map

package/dist/esm/campaign/campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../../src/campaign/campaign.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,sEAAsE;IACtE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACrD,oEAAoE;IACpE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA4CD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,CAkG5J"}

package/dist/esm/campaign/campaign.js

@@ -0,0 +1,147 @@
+import { gql } from "../data/gql.js";
+import { mapLimit } from "../data/concurrency.js";
+import { approvalAmount, chainTime } from "../data/format.js";
+import { approvalPaid } from "../data/types.js";
+import { doneMeansProof } from "../data/resources.js";
+const median = (values) => {
+    if (values.length === 0)
+        return null;
+    const sorted = [...values].sort((a, b) => a - b);
+    const middle = Math.floor(sorted.length / 2);
+    return sorted.length % 2 ? sorted[middle] : Math.round((sorted[middle - 1] + sorted[middle]) / 2);
+};
+/** The verdict a claim reached, in the words the wall uses. */
+function stateOf(claims) {
+    if (claims.length === 0)
+        return "waiting";
+    const approved = claims.find((claim) => claim.evaluationByClaimId?.status === 1);
+    if (approved)
+        return "cleaned";
+    if (claims.some((claim) => claim.evaluationByClaimId?.status === 2))
+        return "refused";
+    if (claims.some((claim) => claim.evaluationByClaimId))
+        return "flagged";
+    return "waiting";
+}
+/**
+ * Read one campaign.
+ *
+ * `since` bounds the collection scan — a campaign is a fortnight, not the
+ * whole chain — and the terms of each candidate are fetched to learn its tag,
+ * because the tag lives in the document rather than on chain. Anything
+ * unreadable is simply not in the campaign; a store blip must not invent a
+ * spot or drop one silently, so a fetch that fails is skipped and the count
+ * says how many were read.
+ */
+/**
+ * How many answers per spot the wall reads (scale review 2026-10, B6). A spot
+ * is one cleanup ask and carries a handful; the cap is what stops one ask
+ * flooded with answers from making every campaign read unbounded. Oldest
+ * first, so `claims[0]` is still the first answer. Known limit: an approval
+ * past the 200th answer of one spot would read as not yet cleaned.
+ */
+const CLAIMS_PER_SPOT = 200;
+export async function loadCampaign(tag, options = {}) {
+    const limit = options.limit ?? 400;
+    const since = options.since ?? new Date(Date.now() - 60 * 24 * 3600 * 1000).toISOString();
+    const data = await gql(`query {
+      claimCollections(filter: {startDate: {greaterThan: ${JSON.stringify(since)}}}, first: ${limit}, orderBy: START_DATE_DESC) {
+        nodes {
+          id state startDate endDate entity
+          payments
+          claimsByCollectionId(first: ${CLAIMS_PER_SPOT}, orderBy: SUBMISSION_DATE_ASC) { nodes { claimId agentAddress submissionDate paymentsStatus evaluationByClaimId { status reason evaluationDate amount } } }
+        }
+      }
+    }`, 8);
+    const spots = [];
+    /* The terms say which campaign each belongs to. Read from the ask's own
+       published document — the one its claim ids are hashes against — a few
+       at a time rather than one after another: four hundred sequential
+       round trips is a wall that times out before it renders. */
+    const nodes = data.claimCollections?.nodes ?? [];
+    const cache = new Map();
+    const read = (entity) => {
+        if (!cache.has(entity))
+            cache.set(entity, termsOf(entity).catch(() => null));
+        return cache.get(entity);
+    };
+    const allTerms = await mapLimit(nodes, 8, (node) => read(node.entity));
+    for (const [index, node] of nodes.entries()) {
+        const terms = allTerms[index] ?? null;
+        if (!terms || terms.campaign !== tag)
+            continue;
+        /* A re-visit carries the tag too; it is not a spot of its own, it is what
+           happened to one. Its own `followUp` is absent, which is the tell. */
+        const isRevisit = !terms.followUp && terms.criteria?.some((one) => one.gate?.id === "within-radius") && !terms.criteria?.some((one) => one.gate?.id === "before-after");
+        if (isRevisit)
+            continue;
+        const claims = node.claimsByCollectionId?.nodes ?? [];
+        const approved = claims.find((claim) => claim.evaluationByClaimId?.status === 1) ?? null;
+        const where = terms.criteria?.find((one) => one.gate?.id === "within-radius")?.gate ?? null;
+        const submittedAt = approved?.submissionDate ?? claims[0]?.submissionDate ?? null;
+        const decidedAt = approved?.evaluationByClaimId?.evaluationDate ?? null;
+        /* `chainTime` returns a Date, and the chain writes timestamps without a
+           zone — the same normalisation every other surface uses. */
+        const from = chainTime(submittedAt);
+        const to = chainTime(decidedAt);
+        const seconds = from && to ? Math.max(0, Math.round((to.getTime() - from.getTime()) / 1000)) : null;
+        spots.push({
+            collectionId: String(node.id),
+            place: where?.place ?? null,
+            lat: where?.lat ?? null,
+            lon: where?.lon ?? null,
+            state: stateOf(claims),
+            before: null,
+            after: null,
+            /* What the chain says moved on approval, in base units of its own denom.
+               `approvalAmount` speaks the collection's payment legs, which is where
+               the number lives — a claim carries the verdict, not the price. */
+            paidBase: approved && approvalPaid(approved) ? Math.round((approvalAmount(node.payments)?.value ?? 0) * 1e6) : 0,
+            denom: node.payments?.approval?.amount?.[0]?.denom ?? null,
+            submittedAt,
+            decidedAt,
+            verdictSeconds: seconds,
+            held: terms.followUp ? "awaiting" : null
+        });
+    }
+    const paid = spots.filter((spot) => spot.state === "cleaned");
+    const held = spots.filter((spot) => spot.held === "held").length;
+    const judged = spots.filter((spot) => spot.held === "held" || spot.held === "not held").length;
+    return {
+        spots,
+        totals: {
+            spots: spots.length,
+            cleaned: paid.length,
+            paidBase: paid.reduce((total, spot) => total + spot.paidBase, 0),
+            denom: spots.find((spot) => spot.denom)?.denom ?? null,
+            medianVerdictSeconds: median(spots.map((spot) => spot.verdictSeconds).filter((value) => value !== null)),
+            heldRate: judged > 0 ? held / judged : null
+        }
+    };
+}
+/**
+ * An ask's published terms, by way of its entity's own record.
+ *
+ * The resource is found by `doneMeansProof` — the helper the receipt page has
+ * always used — rather than by a second search written here. This function
+ * originally matched on a `description` string and a `#done-means` suffix,
+ * **neither of which this estate has ever written**, so it found terms for
+ * nothing and a campaign with asks in it rendered as *"nothing posted under
+ * this tag yet"*. An empty wall is the one failure a sponsor cannot tell apart
+ * from a campaign that never happened.
+ *
+ * It also queries `entities`, as the receipt does, rather than `iid`.
+ */
+async function termsOf(entityDid) {
+    const data = await gql(`query { entities(filter: {id: {equalTo: ${JSON.stringify(entityDid)}}}) { nodes { linkedResource } } }`, 6);
+    const cid = doneMeansProof(data.entities?.nodes?.[0]?.linkedResource ?? []);
+    if (!cid)
+        return null;
+    /* Content-addressed, so it never changes: cache it as long as Next allows.
+       Typed loosely because this module is also read where `RequestInit` knows
+       nothing about `next`. */
+    const { fetchDoc } = await import("../data/docs.js");
+    const response = await fetchDoc(cid, { timeoutMs: 12_000, ...{ next: { revalidate: 3600 } } });
+    return response.ok ? (await response.json()) : null;
+}
+//# sourceMappingURL=campaign.js.map

package/dist/esm/campaign/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../../src/campaign/campaign.ts"],"names":[],"mappings":"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"}

package/dist/esm/campaign/campaigns.d.ts

@@ -0,0 +1,2 @@
+export declare function liveCampaigns(now?: Date): Promise<string[]>;
+//# sourceMappingURL=campaigns.d.ts.map

package/dist/esm/campaign/campaigns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../../src/campaign/campaigns.ts"],"names":[],"mappings":"AAwBA,wBAAsB,aAAa,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY7E"}

package/dist/esm/campaign/campaigns.js

@@ -0,0 +1,34 @@
+import { campaignsIn } from "../data/askFilter.js";
+import { loadThreads } from "../data/threads.js";
+/**
+ * The campaigns that exist — which is the only kind a form may offer.
+ *
+ * A campaign is a program, and programs are written as documents through the
+ * MCP, never in a phone form. What the form is allowed to do is put an ask
+ * *into* one that somebody already set up, and for that it needs the list.
+ * Typing a tag by hand still works and always will — a tag is just a string
+ * frozen into the terms — but a menu of the real ones is the difference
+ * between joining a campaign and inventing a misspelling of it.
+ *
+ * Discovered rather than configured, the same way the board's own campaign
+ * filter is: every tag lives in an ask's published terms, so the set of live
+ * campaigns is a fact about the chain and not a list anybody maintains.
+ */
+/** How far back a campaign counts as live. A season, not the archive. */
+const WINDOW_DAYS = 60;
+/** How many collections to look across. The board's own reach, widened once. */
+const REACH = 60;
+export async function liveCampaigns(now = new Date()) {
+    const threads = await loadThreads(REACH);
+    const since = now.getTime() - WINDOW_DAYS * 86_400_000;
+    /* An ask with no readable date is not evidence of a campaign either way, so
+       it is left out rather than counted — the cost of being wrong here is
+       offering a tag nobody is using, on the one control whose whole job is to
+       say which ones are real. */
+    const recent = threads.filter((thread) => {
+        const at = Date.parse(thread.lastEventAt ?? "");
+        return Number.isFinite(at) && at >= since;
+    });
+    return campaignsIn(recent);
+}
+//# sourceMappingURL=campaigns.js.map

package/dist/esm/campaign/campaigns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../../src/campaign/campaigns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AAEH,yEAAyE;AACzE,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,gFAAgF;AAChF,MAAM,KAAK,GAAG,EAAE,CAAC;AAEjB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAY,IAAI,IAAI,EAAE;IACxD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,WAAW,GAAG,UAAU,CAAC;IACvD;;;kCAG8B;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/dist/esm/campaign/cleanable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Can somebody go and clean this pin right now?
+ *
+ * Its own module, importing nothing at run time, because the browser needs it
+ * (the map's banner, the pin card) and `spots.ts` is the server's: index
+ * queries, the campaign fold, store reads. A client component that imported
+ * this one line from there pulled all of that into its bundle — the same trap
+ * `bandEmoji.ts` was moved out of. The words about WHY a pin is cleanable are
+ * beside the type, in `spots.ts`.
+ */
+import type { Pin } from "./spots.ts";
+export declare const cleanable: (pin: Pick<Pin, "state" | "cleanupId">) => boolean;
+//# sourceMappingURL=cleanable.d.ts.map

package/dist/esm/campaign/cleanable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanable.d.ts","sourceRoot":"","sources":["../../../src/campaign/cleanable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,SAAS,GAAI,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAAC,KAAG,OACY,CAAC"}

package/dist/esm/campaign/cleanable.js

@@ -0,0 +1,2 @@
+export const cleanable = (pin) => (pin.state === "open" || pin.state === "cleaning") && Boolean(pin.cleanupId);
+//# sourceMappingURL=cleanable.js.map

package/dist/esm/campaign/cleanable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanable.js","sourceRoot":"","sources":["../../../src/campaign/cleanable.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAqC,EAAW,EAAE,CAC1E,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC"}

package/dist/esm/campaign/cleanup.d.ts

@@ -0,0 +1,78 @@
+import type { AskTerms } from "../rubric/terms.ts";
+/**
+ * What a cleanup ask says, in one place.
+ *
+ * These five criteria were being assembled by hand in two files — the campaign
+ * poster and the live smoke — and a third copy was about to appear in the MCP.
+ * That is the drift this estate has already paid for twice in a week: a field
+ * added to the type and not to `parseTerms`, so `photo-pair` terms read as
+ * unparseable and `followUp` was silently dropped. Two hand-built copies of the
+ * *same* document is the same bet with worse odds.
+ *
+ * **The shape is the argument.** Somewhere you must be, a pair that must be in
+ * order, a place that must be the same in both, litter that must be visibly
+ * less, and a sky that must not contradict the hour. The first two a machine
+ * settles; the middle two an AI judges; the last is free. Nothing in here can
+ * say who held the grabber or where the waste went, and the envelope says so.
+ */
+export declare function cleanupTerms(args: {
+    lat: number;
+    lon: number;
+    /** How close the work must be. 150 m is a street corner, not a village. */
+    metres?: number;
+    /** A label, frozen at posting. Never geocoded — see the `near` refusal. */
+    place?: string;
+    campaign?: string;
+    /** The pin this clears, so the map can fold its state from chain. */
+    clears?: string;
+    /**
+     * How many people clear this together.
+     *
+     * A big site is a cluster of small proofs: each participant clears a patch
+     * and hands over their own pair, judged on its own. More than one spot
+     * therefore brings the spread gate with it, or two people could photograph
+     * the same cleared corner and both be paid.
+     */
+    spots?: number;
+    /** How far apart two people's patches must be, when there are several. */
+    apartMetres?: number;
+    /** Where the waste may be taken. Adds the third photograph. */
+    disposal?: {
+        points: {
+            lat: number;
+            lon: number;
+            label?: string;
+        }[];
+        metres: number;
+    };
+    followUp?: {
+        days: number;
+        pay: string;
+    };
+    /** What the mess IS, in the bands' own words ("a car boot of household,
+     *  roadside"). The title speaks of the contents when it can — coordinates
+     *  in an ask's name read like a machine talking to itself, and the
+     *  position already lives in the radius gate and on every map. Absent,
+     *  the place (or, last, the coordinates) still names the work. */
+    what?: string;
+    /**
+     * A site: cleared by many people, patch by patch, over days.
+     *
+     * A one-person cleanup is one pair of photographs and a payout. A site is
+     * too much for anybody alone, so its ask takes two kinds of claim — a
+     * patch (before, after, and the bags) which is checked at once and then
+     * **held**, and a site shot which shows the whole area clear and releases
+     * every held patch, the pot split between them.
+     *
+     * Both kinds are judged against the criteria below; `kind` in the claim's
+     * own body says which one arrived, and the checker holds or releases on
+     * that. The terms carry the flag so the checker learns it from the chain
+     * rather than from a deployment's configuration.
+     */
+    site?: boolean;
+    judge: {
+        address: string;
+        rewardUixo: number;
+    };
+}): AskTerms;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/esm/campaign/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/campaign/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC;;;;sEAIkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,GAAG,QAAQ,CAiHX"}