@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/cjs/campaign/bands.d.ts

@@ -0,0 +1,161 @@
+/**
+ * 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.
+ */
+/**
+ * How much there is. `base` is what clearing it is worth before the
+ * multipliers — the crew, the hours and the trips it implies.
+ */
+export declare const VOLUME: {
+    readonly bagful: {
+        readonly base: number;
+        readonly says: "a bagful";
+    };
+    readonly boot: {
+        readonly base: number;
+        readonly says: "a car boot";
+    };
+    readonly trailer: {
+        readonly base: number;
+        readonly says: "a trailer";
+    };
+    readonly truck: {
+        readonly base: number;
+        readonly 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.
+     */
+    readonly bigger: {
+        readonly base: number;
+        readonly says: "bigger than a truck";
+    };
+};
+/** What it is. Disposal is not free, and some of it is not close to free. */
+export declare const WASTE: {
+    readonly household: {
+        readonly factor: 1;
+        readonly says: "household";
+    };
+    readonly garden: {
+        readonly factor: 0.8;
+        readonly says: "garden";
+    };
+    readonly rubble: {
+        readonly factor: 1.5;
+        readonly says: "rubble";
+    };
+    /** Tyres, mattresses, electronics — the things a tip charges to take. */
+    readonly awkward: {
+        readonly factor: 2;
+        readonly says: "tyres, mattresses or electronics";
+    };
+};
+/** Getting to it, because carrying is most of the work. */
+export declare const ACCESS: {
+    readonly roadside: {
+        readonly factor: 1;
+        readonly says: "roadside";
+    };
+    readonly carry: {
+        readonly factor: 1.3;
+        readonly says: "a carry";
+    };
+    readonly hard: {
+        readonly factor: 1.8;
+        readonly 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 declare function spotPhrase(assessment: {
+    volume?: string;
+    waste?: string;
+    wastes?: readonly string[];
+    access?: string;
+} | null | undefined): string | null;
+/**
+ * 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 declare function dominantWaste(wastes: readonly string[]): Waste | null;
+/**
+ * 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 declare function wastesOf(assessment: {
+    waste?: string;
+    wastes?: readonly string[];
+} | null | undefined): Waste[];
+export type Volume = keyof typeof VOLUME;
+export type Waste = keyof typeof WASTE;
+export type Access = keyof typeof ACCESS;
+export interface Assessment {
+    volume: Volume;
+    /** The dominant kind — the dearest of `wastes` when there are several. */
+    waste: Waste;
+    /** Every kind the finder saw, when they said. Absent means "just `waste`". */
+    wastes?: Waste[];
+    access: Access;
+}
+export declare function isAssessment(value: unknown): value is Assessment;
+/**
+ * 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 declare function spotTarget(assessment: Assessment): number;
+/** The same fact as a sentence, for a pin somebody is deciding whether to back. */
+export declare function spotSays(assessment: Assessment): string;
+/** Work a crowd should not be sent at: too big, whatever it is made of. */
+export declare const needsProfessionals: (assessment: Assessment) => boolean;
+//# sourceMappingURL=bands.d.ts.map

package/dist/cjs/campaign/bands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bands.d.ts","sourceRoot":"","sources":["../../../src/campaign/bands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;IAKjB;;;;;OAKG;;;;;CAEK,CAAC;AAEX,6EAA6E;AAC7E,eAAO,MAAM,KAAK;;;;;;;;;;;;;IAIhB,yEAAyE;;;;;CAEjE,CAAC;AAEX,2DAA2D;AAC3D,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAIT,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKzJ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,IAAI,CAOrE;AAKD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,EAAE,CAM/G;AASD,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,MAAM,CAAC;AACzC,MAAM,MAAM,KAAK,GAAG,MAAM,OAAO,KAAK,CAAC;AACvC,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,MAAM,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,EAAE,KAAK,CAAC;IACb,8EAA8E;IAC9E,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAGhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAWzD;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAMvD;AAED,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,GAAI,YAAY,UAAU,KAAG,OAAyC,CAAC"}

package/dist/cjs/campaign/bands.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsProfessionals = exports.ACCESS = exports.WASTE = exports.VOLUME = void 0;
+exports.spotPhrase = spotPhrase;
+exports.dominantWaste = dominantWaste;
+exports.wastesOf = wastesOf;
+exports.isAssessment = isAssessment;
+exports.spotTarget = spotTarget;
+exports.spotSays = spotSays;
+/** 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.
+ */
+exports.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. */
+exports.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. */
+exports.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.
+ */
+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 `${exports.VOLUME[assessment.volume].says} of ${listSays(wastesOf(assessment))}, ${exports.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.
+ */
+function dominantWaste(wastes) {
+    let best = null;
+    for (const key of ORDERED_WASTE) {
+        if (!wastes.includes(key))
+            continue;
+        if (best === null || exports.WASTE[key].factor > exports.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(exports.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.
+ */
+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) => exports.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);
+function isAssessment(value) {
+    const doc = value;
+    return Boolean(doc && typeof doc === "object" && bandOf(exports.VOLUME, doc.volume) && bandOf(exports.WASTE, doc.waste) && bandOf(exports.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.
+ */
+function spotTarget(assessment) {
+    if (!isAssessment(assessment)) {
+        throw new Error(`not a spot assessment: ${JSON.stringify(assessment)}. ${ORDER}, each from its own table`);
+    }
+    const { base } = exports.VOLUME[assessment.volume];
+    const target = Math.round(base * exports.WASTE[assessment.waste].factor * exports.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. */
+function spotSays(assessment) {
+    if (!isAssessment(assessment))
+        throw new Error("not a spot assessment");
+    const size = exports.VOLUME[assessment.volume].says;
+    const what = listSays(wastesOf(assessment));
+    const reach = exports.ACCESS[assessment.access].says;
+    return `${size} of ${what}, ${reach}`;
+}
+/** Work a crowd should not be sent at: too big, whatever it is made of. */
+const needsProfessionals = (assessment) => assessment.volume === "bigger";
+exports.needsProfessionals = needsProfessionals;
+//# sourceMappingURL=bands.js.map

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

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

package/dist/cjs/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/cjs/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/cjs/campaign/campaign.js

@@ -0,0 +1,183 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCampaign = loadCampaign;
+const gql_ts_1 = require("../data/gql.js");
+const concurrency_ts_1 = require("../data/concurrency.js");
+const format_ts_1 = require("../data/format.js");
+const types_ts_1 = require("../data/types.js");
+const resources_ts_1 = require("../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;
+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 (0, gql_ts_1.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 (0, concurrency_ts_1.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 = (0, format_ts_1.chainTime)(submittedAt);
+        const to = (0, format_ts_1.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 && (0, types_ts_1.approvalPaid)(approved) ? Math.round(((0, format_ts_1.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 (0, gql_ts_1.gql)(`query { entities(filter: {id: {equalTo: ${JSON.stringify(entityDid)}}}) { nodes { linkedResource } } }`, 6);
+    const cid = (0, resources_ts_1.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 Promise.resolve().then(() => __importStar(require("../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/cjs/campaign/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../../src/campaign/campaign.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6FA,oCAkGC;AA/LD,2CAAqC;AACrC,2DAAkD;AAClD,iDAA8D;AAC9D,+CAA4D;AAC5D,uDAAyE;AAqDzE,MAAM,MAAM,GAAG,CAAC,MAAgB,EAAiB,EAAE;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACvG,CAAC,CAAC;AAEF,+DAA+D;AAC/D,SAAS,OAAO,CAAC,MAAe;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC;IACjF,IAAI,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC;QAAE,OAAO,SAAS,CAAC;IACxE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,GAAG,CAAC;AAErB,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,UAA8C,EAAE;IAC9F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAE1F,MAAM,IAAI,GAAG,MAAM,IAAA,YAAG,EAapB;2DACuD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,KAAK;;;;wCAI3D,eAAe;;;MAGjD,EACF,CAAC,CACF,CAAC;IAEF,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC;;;iEAG6D;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC1D,MAAM,IAAI,GAAG,CAAC,MAAc,EAA4B,EAAE;QACxD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;IAC5B,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAQ,EAAC,KAAK,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvE,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG;YAAE,SAAS;QAC/C;+EACuE;QACvE,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,cAAc,CAAC,CAAC;QACxK,IAAI,SAAS;YAAE,SAAS;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,MAAM,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC;QACzF,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,eAAe,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;QAE5F,MAAM,WAAW,GAAG,QAAQ,EAAE,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,IAAI,CAAC;QAClF,MAAM,SAAS,GAAG,QAAQ,EAAE,mBAAmB,EAAE,cAAc,IAAI,IAAI,CAAC;QACxE;qEAC6D;QAC7D,MAAM,IAAI,GAAG,IAAA,qBAAS,EAAC,WAAW,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,IAAA,qBAAS,EAAC,SAAS,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpG,KAAK,CAAC,IAAI,CAAC;YACT,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI;YAC3B,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI;YACvB,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;YACtB,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;YACX;;gFAEoE;YACpE,QAAQ,EAAE,QAAQ,IAAI,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAA,0BAAc,EAAC,IAAI,CAAC,QAAiB,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACzH,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI;YAC1D,WAAW;YACX,SAAS;YACT,cAAc,EAAE,OAAO;YACvB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;SACzC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IAE/F,OAAO;QACL,KAAK;QACL,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAChE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI;YACtD,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;YACzH,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI;SAC5C;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,OAAO,CAAC,SAAiB;IACtC,MAAM,IAAI,GAAG,MAAM,IAAA,YAAG,EACpB,2CAA2C,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,oCAAoC,EACxG,CAAC,CACF,CAAC;IACF,MAAM,GAAG,GAAG,IAAA,6BAAc,EAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB;;+BAE2B;IAC3B,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,iBAAiB,GAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAI,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAA6B,EAAE,CAAC,CAAC;IAC3H,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,CAAC,CAAC,CAAC,IAAI,CAAC;AACpE,CAAC"}

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

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

package/dist/cjs/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/cjs/campaign/campaigns.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveCampaigns = liveCampaigns;
+const askFilter_ts_1 = require("../data/askFilter.js");
+const threads_ts_1 = require("../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;
+async function liveCampaigns(now = new Date()) {
+    const threads = await (0, threads_ts_1.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 (0, askFilter_ts_1.campaignsIn)(recent);
+}
+//# sourceMappingURL=campaigns.js.map