@ixo/openhands-sdk 0.0.0-stage → 0.1.0

package/dist/esm/rubric/claimForm.js

@@ -0,0 +1,109 @@
+/**
+ * What an Openhands claim looks like, declared once for the whole network.
+ *
+ * The evals-engine binds every rule to a form and refuses rules that mention a
+ * field the form never declared — not leniently, the whole rubric goes
+ * unusable. So this is the contract that makes our terms machine-checkable by
+ * anyone, and it has to describe what our claims *actually* contain.
+ *
+ * It is a **path manifest**, which is the engine's own name for this: a
+ * SurveyJS-shaped document whose question names are paths into a stored JSON
+ * body rather than answers to a questionnaire (their `catalog.ts`). Nobody
+ * fills this in. Two things write our claim bodies —
+ * `app/submit/[id]/page.tsx` (a person handing over work) and
+ * `services/worker-agent/src/proof.ts` (an agent sealing its own) — and the
+ * fields below are the union of both, so one form covers both species.
+ *
+ * **The kinds are load-bearing.** The engine's binder checks operator legality
+ * against them (`bind.ts` `OPERATOR_KINDS`): `lengthBetween` only applies to
+ * `text`, `containsAll` only to `multichoice`, and so on. Getting a kind wrong
+ * here does not fail here — it fails later, as an unusable rubric, on somebody
+ * else's server. `file` is declared `text` on purpose: our claims carry a CID
+ * *string* pointing at a stored object, not a SurveyJS upload, and the
+ * engine's resolver lane resolves no attachments at all. The `file`-kind
+ * questions (`photo` and its siblings, v3) are the same objects again as
+ * SurveyJS file answers, which is the shape an oracle's attachment tools do
+ * read.
+ *
+ * **Changing this document changes its CID**, which is the proof every rubric
+ * pins in `claimSchema.proof` — so an edit here silently unbinds every rubric
+ * published before it (the engine calls that form drift and fails closed).
+ * Add fields; do not rename or remove them.
+ */
+/**
+ * The `alsoKnownAs` the publishing script finds the entity by.
+ *
+ * **The version lives in the name, and that is the whole migration story.**
+ * A rubric pins this form's bytes by their hash, so editing the document
+ * below would not update the form — it would silently unbind every rubric
+ * published against it (their binder calls that form drift and fails closed).
+ * A new field therefore means a new name, a new entity, and new asks binding
+ * to it while old asks keep resolving the old one, untouched, forever.
+ */
+export const FORM_NAME = "Openhands claim form v3";
+export const CLAIM_FORM = {
+    "@context": { ixo: "https://w3id.org/ixo/ns/protocol/" },
+    type: "ixo:entity#surveyTemplate",
+    question: {
+        pages: [
+            {
+                elements: [
+                    /* The work itself, and the only field both writers always carry.
+                       Nearly every rule we publish reads this one. */
+                    { type: "comment", name: "deliverable", title: "The work handed over", isRequired: true },
+                    /* What was asked. The worker agent copies the ask's title in; a
+                       browser submission leaves it out, which is why it is optional. */
+                    { type: "text", name: "task", title: "The ask this answers" },
+                    /* A hosted artifact: a CID string, not an upload — see the note
+                       above about `file` kinds and the resolver lane. */
+                    { type: "text", name: "file", title: "Attached file (content address)" },
+                    { type: "text", name: "mediaType", title: "What kind of file it is" },
+                    /* Who and when. `submitter` is on browser envelopes, `worker` on the
+                       agent's; both are ixo addresses, and the chain is the authority on
+                       which one actually signed. */
+                    { type: "text", name: "submitter", title: "Who handed it over" },
+                    { type: "text", name: "worker", title: "Which agent produced it" },
+                    { type: "text", inputType: "datetime-local", name: "ts", title: "When it was sealed" },
+                    /* Which ask this belongs to, and the envelope version. */
+                    { type: "text", name: "collectionId", title: "The ask's collection id" },
+                    { type: "text", inputType: "number", name: "v", title: "Envelope version" },
+                    /*
+                     * Where the submitter says they were (v2). Dotted names are paths
+                     * into the stored body — the engine's own path-manifest convention,
+                     * and the reason a nested field needs no new machinery.
+                     *
+                     * Client-assisted by nature: a browser's geolocation or a photo's
+                     * EXIF, either of which a determined person can set. Nothing here
+                     * pretends otherwise, and no rule that reads these may approve a
+                     * claim on their strength alone.
+                     */
+                    { type: "text", inputType: "number", name: "location.lat", title: "Reported latitude" },
+                    { type: "text", inputType: "number", name: "location.lon", title: "Reported longitude" },
+                    { type: "text", inputType: "number", name: "location.accuracyMeters", title: "Reported accuracy in metres" },
+                    { type: "text", inputType: "datetime-local", name: "location.at", title: "When the location was taken" },
+                    /*
+                     * The same files, as file answers (v3).
+                     *
+                     * `file`, `before`, `after` and `extra` stay exactly what they were —
+                     * CID strings our own readers parse. An oracle's attachment tools
+                     * see none of them: what they recognise is a SurveyJS file answer,
+                     * `[{ name, type, content }]` with an https `content`. So every
+                     * writer now puts the same object beside its CID in that shape,
+                     * and these four are what the stock media-type, size, image and
+                     * duplicate lanes read. `storeDataAsText: false` is the SurveyJS
+                     * flag for "content is a URL, not the bytes".
+                     */
+                    { type: "file", name: "photo", title: "The photograph", storeDataAsText: false, allowMultiple: false },
+                    { type: "file", name: "beforePhoto", title: "Before the work", storeDataAsText: false, allowMultiple: false },
+                    { type: "file", name: "afterPhoto", title: "After the work", storeDataAsText: false, allowMultiple: false },
+                    { type: "file", name: "extraFile", title: "The second file", storeDataAsText: false, allowMultiple: false },
+                    /* What kind of claim this is — `patch` and `site` on a shared site,
+                       `pair` for a one-person cleanup — where the writer knows it. A
+                       rule reads it to decide whether a payout is held or released. */
+                    { type: "text", name: "kind", title: "What kind of claim this is" }
+                ]
+            }
+        ]
+    }
+};
+//# sourceMappingURL=claimForm.js.map

package/dist/esm/rubric/claimForm.js.map

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

package/dist/esm/rubric/claimFormResource.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The claim form a rubric is bound to, anchored on the ask itself at `#vct`.
+ *
+ * The engine resolves the form from the SAME entity as the rubric: it walks
+ * the ask's own linked resources for an id ending `#vct` (`resolveClaimForm`
+ * in their `lib/rubric/form.ts`), fetches `serviceEndpoint`, and compares the
+ * resource's `proof` — as a string, never recomputed — with the rubric's
+ * pinned `claimSchema.proof`. So every ask has to carry the form's address
+ * and proof itself, or the rubric it just published is unusable. Both values
+ * are the ones `scripts/publish-vct.ts` printed (`NEXT_PUBLIC_VCT_URL`,
+ * `NEXT_PUBLIC_VCT_PROOF`).
+ *
+ * Shape only, no SDK — the worker wraps it in `LinkedResource.fromPartial`;
+ * the browser package builds the same resource itself in
+ * `packages/openhands-sdk/src/chain/ask.ts`, the way `#rub` is built twice too.
+ */
+export interface ClaimFormRef {
+    url: string;
+    proof: string;
+}
+/** The ref when both halves are set, else null — an ask never posts a half address. */
+export declare const claimFormRef: (url?: string | null, proof?: string | null) => ClaimFormRef | null;
+/** The `#vct` resource, ready for a `MsgCreateEntity`. */
+export declare const claimFormResource: (form: ClaimFormRef) => {
+    type: string;
+    id: string;
+    description: string;
+    mediaType: string;
+    serviceEndpoint: string;
+    proof: string;
+    encrypted: string;
+    right: string;
+};
+//# sourceMappingURL=claimFormResource.d.ts.map

package/dist/esm/rubric/claimFormResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimFormResource.d.ts","sourceRoot":"","sources":["../../../src/rubric/claimFormResource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uFAAuF;AACvF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,GAAG,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,KAAG,YAAY,GAAG,IAAwF,CAAC;AAElL,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY;;;;;;;;;CAYlD,CAAC"}

package/dist/esm/rubric/claimFormResource.js

@@ -0,0 +1,33 @@
+/**
+ * The claim form a rubric is bound to, anchored on the ask itself at `#vct`.
+ *
+ * The engine resolves the form from the SAME entity as the rubric: it walks
+ * the ask's own linked resources for an id ending `#vct` (`resolveClaimForm`
+ * in their `lib/rubric/form.ts`), fetches `serviceEndpoint`, and compares the
+ * resource's `proof` — as a string, never recomputed — with the rubric's
+ * pinned `claimSchema.proof`. So every ask has to carry the form's address
+ * and proof itself, or the rubric it just published is unusable. Both values
+ * are the ones `scripts/publish-vct.ts` printed (`NEXT_PUBLIC_VCT_URL`,
+ * `NEXT_PUBLIC_VCT_PROOF`).
+ *
+ * Shape only, no SDK — the worker wraps it in `LinkedResource.fromPartial`;
+ * the browser package builds the same resource itself in
+ * `packages/openhands-sdk/src/chain/ask.ts`, the way `#rub` is built twice too.
+ */
+/** The ref when both halves are set, else null — an ask never posts a half address. */
+export const claimFormRef = (url, proof) => (url?.trim() && proof?.trim() ? { url: url.trim(), proof: proof.trim() } : null);
+/** The `#vct` resource, ready for a `MsgCreateEntity`. */
+export const claimFormResource = (form) => ({
+    /* The same type the form's own entity carries (`scripts/publish-vct.ts`).
+       The engine finds this by id suffix alone; the type is for people. */
+    type: "surveyTemplate",
+    id: "{id}#vct",
+    description: "The claim form this ask's rubric is bound to",
+    mediaType: "application/ld+json",
+    serviceEndpoint: form.url,
+    /* The form's CID, verbatim — compared as a string, never recomputed. */
+    proof: form.proof,
+    encrypted: "false",
+    right: ""
+});
+//# sourceMappingURL=claimFormResource.js.map

package/dist/esm/rubric/claimFormResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimFormResource.js","sourceRoot":"","sources":["../../../src/rubric/claimFormResource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAmB,EAAE,KAAqB,EAAuB,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAElL,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAkB,EAAE,EAAE,CAAC,CAAC;IACxD;2EACuE;IACvE,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,UAAU;IACd,WAAW,EAAE,8CAA8C;IAC3D,SAAS,EAAE,qBAAqB;IAChC,eAAe,EAAE,IAAI,CAAC,GAAG;IACzB,wEAAwE;IACxE,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,SAAS,EAAE,OAAO;IAClB,KAAK,EAAE,EAAE;CACV,CAAC,CAAC"}

package/dist/esm/rubric/compose.d.ts

@@ -0,0 +1,99 @@
+import { type AskTerms } from "./terms.ts";
+/**
+ * The ask form's one mapping: fields in, terms and a title out.
+ *
+ * The composer stopped being a sentence with blanks and became a form — but
+ * everything downstream (the minted title, the published terms, the checker's
+ * leg) still speaks the sentence's language. This file is where the form
+ * becomes that language, kept pure so the equivalence is a test rather than a
+ * hope: a form with nothing optional produces exactly what `deriveTerms`
+ * produces for the bare task, and a before-and-after form with a place is
+ * measured by exactly the gates `cleanupTerms` builds — id for id — while
+ * keeping the poster's own words (the cleanup builder is the campaign's, and
+ * titles everything "Clean up …").
+ *
+ * The judge is always returned as `{ kind: "poster" }` — who actually rules
+ * is decided at publish time, the same override the composer has always done.
+ * Titles carry the place's *name*; the gate carries the coordinates. Nothing
+ * here geocodes, for the reason `deriveTerms` refuses to: a name is a
+ * courtesy, coordinates are the contract.
+ */
+export interface AskForm {
+    task: string;
+    /** Where the work must happen; label is frozen into title and gate alike. */
+    place?: {
+        lat: number;
+        lon: number;
+        metres?: number;
+        label?: string;
+    };
+    /**
+     * **They say where it is.** The other location block, and the opposite one:
+     * `place` is the poster choosing a spot and a radius before anyone goes;
+     * this is the poster choosing nothing and the worker reporting the exact
+     * coordinates as part of the answer. A mapping ask, a found mess, a
+     * delivery that lands where it lands — all of them need the position and
+     * none of them can name it in advance.
+     *
+     * The two compose: an ask can want somebody inside 400 m of a square AND
+     * the precise spot they stood.
+     */
+    pin?: boolean;
+    /** What the proof looks like. Absent means whatever the task implies. */
+    proof?: "text" | "photo" | "pair" | "file";
+    /**
+     * **A place the ask names, which therefore needs a geofence.** The caller
+     * found it in the sentence — a draft's `placeName`, or `GET /api/place?from=`
+     * — and passing it here makes `place` required: an ask that says "the
+     * noticeboard in Smokuč" and gates nothing on Smokuč is a promise the
+     * checker cannot keep (Peter's rule, 2026-10-06). The caller decides when a
+     * named place binds: the composer and the MCP pass it for camera work.
+     */
+    namedPlace?: string;
+    /**
+     * A written answer is required. Alone, it IS the answer — and outranks a
+     * camera the sentence implied, the way *A file* does. Beside an attachment
+     * it is the note that must come with it: the claim's `deliverable` text,
+     * held to the same `min-length` the sentence path uses.
+     */
+    words?: boolean;
+    /**
+     * A file with the photograph or the pair. The claim's primary file is the
+     * camera's; this is the second one, riding beside it in the envelope. Only
+     * meaningful with a camera deliverable — a file alone is `proof: "file"`.
+     */
+    withFile?: boolean;
+    /**
+     * Words the answer has to contain, as the poster wrote them.
+     *
+     * `deriveTerms` already lifts quoted phrases out of a sentence; this is the
+     * same gate said deliberately rather than inferred, for the poster who
+     * wants a reference number or a product name in the answer and would
+     * otherwise have to phrase their whole ask around getting one.
+     */
+    mentions?: string[];
+    /** The campaign tag the receipt wall gathers by. */
+    campaign?: string;
+    /** The poster's name for a batch of the same job, so the board shows it as one card. */
+    series?: string;
+    /** Buy a look back later — before-and-after asks only. */
+    followUp?: {
+        days: number;
+        pay: string;
+    };
+    /** What each approved answer opens — the `+ Then` chip, terms.chain's form. */
+    then?: {
+        task: string;
+        deliverable: "photo-pair" | "photo" | "text";
+        /** The follow-on's full bill, base units. */
+        targetBase: number;
+        funding: "poster" | "crowd";
+        atAnswersPlace?: boolean;
+    };
+}
+export declare const CAMPAIGN_TAG: RegExp;
+export declare function formTerms(form: AskForm): {
+    terms: AskTerms;
+    title: string;
+};
+//# sourceMappingURL=compose.d.ts.map

package/dist/esm/rubric/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/rubric/compose.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,QAAQ,EAA8D,MAAM,YAAY,CAAC;AAEjJ;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAC3C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,+EAA+E;IAC/E,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;QAC7C,6CAA6C;QAC7C,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;QAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,eAAO,MAAM,YAAY,QAAsB,CAAC;AAmFhD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiJ3E"}

package/dist/esm/rubric/compose.js

@@ -0,0 +1,225 @@
+import { addCriterion, deriveTerms, distanceWords } from "./terms.js";
+export const CAMPAIGN_TAG = /^[a-z0-9-]{1,64}$/;
+const DEFAULT_METRES = 150;
+/** Words that already promise a photograph, so the title is not told twice. */
+const SAYS_PHOTO = /photo|picture|snap|film|image|shot/i;
+/** The same courtesy for a file — the title says it once or not at all. */
+const SAYS_FILE = /\b(video|film|footage|recording|scan|pdf|document|file|upload)\b/i;
+/** 25 MB, the ceiling `deriveTerms` puts on a file it inferred for itself. */
+const FILE_MAX_BYTES = 26_214_400;
+/** A sentence that already says before-and-after keeps its own words. */
+const SAYS_PAIR = /before[\s-]*(?:and|&)[\s-]*after/i;
+/** What "a written answer" is held to — `deriveRubric`'s own floor for written work. */
+const WORDS_MIN = 20;
+/**
+ * The two blocks that attach to any shape of ask, applied in the order a
+ * reader would say them: tell me exactly where you stood, and use these words.
+ *
+ * Shared by both branches below because they are shared by both kinds of ask.
+ * A before-and-after cleanup can want the exact spot as much as a photograph
+ * can, and the cleanup builder has no business knowing about either.
+ */
+function withLooseBlocks(terms, form) {
+    let built = terms;
+    /*
+     * Words. Alone, the block outranks the sentence exactly as *A file* does:
+     * "photograph the notice board" with only Words added is asking for a
+     * description, not a camera, so the deliverable is text and the photo's
+     * own gates go with it. Beside an attachment it is the note that must come
+     * with it — the claim's `deliverable` text, which is what `min-length`
+     * measures. A sentence that already demands a length keeps its own number:
+     * one rule, never two saying the same thing.
+     */
+    if (form.words) {
+        const attached = Boolean(form.proof && form.proof !== "text");
+        if (!attached && (built.deliverable.type === "photo" || built.deliverable.type === "file")) {
+            built = {
+                ...built,
+                deliverable: { type: "text", prompt: built.task },
+                criteria: built.criteria.filter((criterion) => !(criterion.kind === "measure" && (criterion.gate.id === "file-type" || criterion.gate.id === "max-bytes")))
+            };
+        }
+        if (!built.criteria.some((criterion) => criterion.kind === "measure" && criterion.gate.id === "min-length")) {
+            built = addCriterion(built, { kind: "measure", gate: { id: "min-length", chars: WORDS_MIN } });
+        }
+    }
+    /*
+     * A file with the photograph. The claim carries it beside its primary
+     * file; the gate holds it to the ceiling a file deliverable has, the
+     * capture asks for it (`wantsExtra`) and the checker measures it.
+     */
+    if (form.withFile && (form.proof === "photo" || form.proof === "pair")) {
+        built = addCriterion(built, { kind: "measure", gate: { id: "with-file", bytes: FILE_MAX_BYTES } });
+    }
+    /*
+     * `located` establishes only that a position was reported at all — which is
+     * the whole point when finding the coordinates IS the work. It composes with
+     * a radius rather than replacing it: be somewhere near this, and say where.
+     */
+    if (form.pin)
+        built = addCriterion(built, { kind: "measure", gate: { id: "located" } });
+    /*
+     * The phrases the poster asked for, minus anything the sentence already
+     * demanded. Two `mentions-terms` gates saying overlapping things would read
+     * to a worker as two rules and be one, and the second would be the poster's
+     * own words repeated back at them.
+     */
+    if (form.mentions?.length) {
+        const already = new Set(built.criteria.flatMap((criterion) => (criterion.kind === "measure" && criterion.gate.id === "mentions-terms" ? criterion.gate.terms.map((term) => term.toLowerCase()) : [])));
+        const wanted = [...new Set(form.mentions.map((term) => term.trim()).filter(Boolean))].filter((term) => !already.has(term.toLowerCase()));
+        if (wanted.length)
+            built = addCriterion(built, { kind: "measure", gate: { id: "mentions-terms", terms: wanted } });
+    }
+    return built;
+}
+export function formTerms(form) {
+    const task = form.task.trim();
+    if (!task)
+        throw new Error("say what needs doing");
+    if (form.namedPlace?.trim() && !form.place)
+        throw new Error(`this ask names ${form.namedPlace.trim()}. Set where it must be done`);
+    if (form.campaign && !CAMPAIGN_TAG.test(form.campaign))
+        throw new Error("a campaign tag is lowercase letters, digits and dashes");
+    /* All-digit tags are the chain namespace — a spawned child wears its parent
+       ask's collection id as its tag. Reserving them here is what makes a
+       numeric tag mean "this ask has a parent" everywhere, unforgeably. */
+    if (form.campaign && /^\d+$/.test(form.campaign))
+        throw new Error("an all-digit campaign tag names a chained ask's parent. Pick a tag with a letter in it");
+    if (form.series && !CAMPAIGN_TAG.test(form.series))
+        throw new Error("a series name is lowercase letters, digits and dashes");
+    if (form.followUp && form.proof !== "pair")
+        throw new Error("a follow-up only makes sense on a before-and-after ask");
+    if (form.then) {
+        if (!form.then.task.trim())
+            throw new Error("the next ask needs a task");
+        if (!(form.then.targetBase > 0))
+            throw new Error("the next ask needs a funding target above zero");
+    }
+    /*
+     * Before-and-after, as the form means it: two photographs of one place,
+     * framed alike, and the poster's own words for what changed between them.
+     *
+     * This is deliberately not `cleanupTerms`. That builder is the campaign's —
+     * it titles the ask "Clean up …", rules on litter, and needs a place because
+     * a cleanup follows a mapped pin. A desk, a wall, a shelf are before-and-
+     * afters too, and the form used to refuse all of them until a place was
+     * set, then throw the poster's sentence away for the cleanup's. Here the
+     * place is a block like any other: a radius when they set one, nothing
+     * when they do not — the pair gate then rules on order alone and "same
+     * place" is the judge's line. The measure gates are the cleanup's, id for
+     * id, so with a place the machine floor is identical; only the title and
+     * the judged sentences are the poster's instead of the campaign's.
+     */
+    if (form.proof === "pair") {
+        const where = form.place ? form.place.label || `${form.place.lat.toFixed(4)}, ${form.place.lon.toFixed(4)}` : null;
+        const metres = form.place?.metres ?? DEFAULT_METRES;
+        let title = SAYS_PAIR.test(task) ? task : `${task}. Photographed before and after`;
+        if (form.place && where)
+            title = `${title}, within ${distanceWords(metres)} of ${where}`;
+        const criteria = [];
+        const rule = (criterion) => criteria.push({ id: `c${criteria.length + 1}`, ...criterion });
+        if (form.place) {
+            rule({ kind: "measure", gate: { id: "within-radius", lat: form.place.lat, lon: form.place.lon, meters: metres, ...(form.place.label ? { place: form.place.label } : {}) } });
+        }
+        rule({ kind: "measure", gate: { id: "before-after" } });
+        /*
+         * **No place name in a judged sentence, and both lines say what fails
+         * them.** This one ended ", somewhere in the verge" when the poster set a
+         * place, which asks a model to confirm a street from a photograph of a
+         * kerb — it cannot, and it says so, and an honest pair is refused. The
+         * campaign's cleanup had the identical clause removed for the identical
+         * reason; where the work happened is the `within-radius` gate's job, from
+         * the reported point and the photograph's own EXIF, and that gate is
+         * already above when there is a place at all. The rest states its own
+         * refusal, because the oracle's wrapper fails any rule it cannot find
+         * proof for — see `JUDGE_GUIDANCE` in `bridge.ts`.
+         */
+        rule({ kind: "judge", text: "The two photographs are of the same place. Things will have moved between them, so look at what stands still: the ground, the walls, the furniture. Fail this only if they are plainly two different places.", confidence: 0.6 });
+        rule({ kind: "judge", text: "The after photograph shows the work the ask describes done: something visibly changed from the before photograph. Fail this if the two photographs show the same state, or if the change is not the work the ask asked for.", confidence: 0.6 });
+        /* Free, and therefore included rather than sold: see the checker's card. */
+        rule({ kind: "measure", gate: { id: "daylight-consistent" } });
+        /* In the parser's own key order, so a publish → parse round trip is
+           byte-identical — the property the engine bridge leans on. */
+        const terms = {
+            v: 2,
+            task: title,
+            deliverable: { type: "photo-pair", prompt: "Two photographs, framed alike: how you found it, and how you left it." },
+            ...(form.campaign ? { campaign: form.campaign } : {}),
+            ...(form.series ? { series: form.series } : {}),
+            ...(form.followUp ? { followUp: form.followUp } : {}),
+            criteria,
+            judge: { kind: "poster" }
+        };
+        return { terms: withLooseBlocks(terms, form), title };
+    }
+    /* The title is built first and the terms derive from it, so the minted
+       sentence and the published terms can never disagree about the task. */
+    let title = task;
+    if (form.proof === "photo" && !SAYS_PHOTO.test(task))
+        title = `${task}. A photograph`;
+    if (form.proof === "file" && !SAYS_FILE.test(task))
+        title = `${task}. A file`;
+    if (form.place) {
+        const metres = form.place.metres ?? DEFAULT_METRES;
+        const where = form.place.label || `${form.place.lat.toFixed(4)}, ${form.place.lon.toFixed(4)}`;
+        title = `${title}, within ${distanceWords(metres)} of ${where}`;
+    }
+    let terms = deriveTerms(title);
+    /*
+     * The block outranks the sentence. `inferDeliverable` reads a title and
+     * guesses, and it checks photo words before file words — so "send me the
+     * event photos as one archive" guesses a camera. A poster who added the
+     * *A file* block has already said which one it is, and a camera-only
+     * picker would refuse the archive they asked for.
+     */
+    if (form.proof === "file" && terms.deliverable.type !== "file") {
+        terms = {
+            ...terms,
+            deliverable: { type: "file", prompt: title },
+            /* The photo's own gates go with it: an image-only filter on a file ask
+               is the same refusal wearing a different name. */
+            criteria: terms.criteria.filter((criterion) => !(criterion.kind === "measure" && (criterion.gate.id === "file-type" || criterion.gate.id === "max-bytes")))
+        };
+        terms = addCriterion(terms, { kind: "measure", gate: { id: "max-bytes", bytes: FILE_MAX_BYTES } });
+    }
+    if (form.place) {
+        const metres = form.place.metres ?? DEFAULT_METRES;
+        terms = addCriterion(terms, {
+            kind: "measure",
+            gate: {
+                id: "within-radius",
+                lat: form.place.lat,
+                lon: form.place.lon,
+                meters: metres,
+                ...(form.place.label ? { place: form.place.label } : {})
+            }
+        });
+    }
+    terms = withLooseBlocks(terms, form);
+    /* Rebuilt in the parser's own key order, so a publish → parse round trip
+       is byte-identical — the same property the engine bridge leans on. */
+    if (form.campaign || form.series || form.then) {
+        terms = {
+            v: terms.v,
+            task: terms.task,
+            deliverable: terms.deliverable,
+            ...(form.campaign ? { campaign: form.campaign } : {}),
+            ...(form.series ? { series: form.series } : {}),
+            ...(form.then
+                ? {
+                    chain: {
+                        task: form.then.task.trim(),
+                        deliverable: { type: form.then.deliverable, prompt: form.then.task.trim() },
+                        target: { mode: "fixed", base: String(Math.floor(form.then.targetBase)) },
+                        funding: form.then.funding,
+                        ...(form.then.atAnswersPlace ? { atAnswersPlace: true } : {})
+                    }
+                }
+                : {}),
+            criteria: terms.criteria,
+            judge: terms.judge
+        };
+    }
+    return { terms, title };
+}
+//# sourceMappingURL=compose.js.map

package/dist/esm/rubric/compose.js.map

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

package/dist/esm/rubric/confidence.d.ts

@@ -0,0 +1,81 @@
+/**
+ * How sure we are, and why — instead of the word "verified".
+ *
+ * A boolean cannot be weighed. A model asking the world a question needs to
+ * know whether it is holding "three independent people agreed and physics
+ * backs them" or "one person's phone said it was nearby", and `verified: true`
+ * says neither. Worse, it says the same thing for both, which makes it the
+ * least honest true statement the product could make.
+ *
+ * So an answer comes back **evidenced**: a number, the reasons that produced
+ * it, and — the part that matters most — a list of what nobody checked. That
+ * last list is the one this round exists for. An answer about a square being
+ * empty carries a location that was measured and an emptiness that was not,
+ * and only saying both is honest.
+ *
+ * **This module is pure and has no network.** It takes outcomes that have
+ * already been gathered and returns a score, so the score is replayable by
+ * anyone holding the same published documents — the same property `decide()`
+ * has, and for the same reason: a confidence nobody can recompute is a number
+ * you are asked to take on faith, which is what it was meant to replace.
+ */
+/** One thing that was, or was not, established. */
+export interface Signal {
+    /** What was checked, in the reader's language. */
+    says: string;
+    /**
+     * `pass` — established. `flat` — could not be checked, and that is not the
+     * answerer's fault (`unverifiable`: an archive was down, a gate deferred).
+     * `absent` — never part of the terms at all, so it is named as uncovered.
+     */
+    weight: "pass" | "flat" | "absent";
+    /** How much a pass is worth. Grounding outweighs relevance; taste is 0. */
+    worth?: number;
+    /**
+     * What to say when this is `flat`, if "could not be checked" would be wrong.
+     *
+     * Two different things land on `flat` and only one of them is an outage: an
+     * archive being unreachable, and a first-time answerer simply having no
+     * record yet. Printing "first answer from this address here — could not be
+     * checked" made the second read like a failure of ours, which is both untrue
+     * and unwelcoming to exactly the person the product wants.
+     */
+    whenFlat?: string;
+}
+export interface Evidence {
+    /** 0–1, never presented bare. */
+    confidence: number;
+    /** Why it is that number, in the order a reader would want it. */
+    because: string[];
+    /** What this answer does NOT establish. Never empty in practice. */
+    unverified: string[];
+}
+/**
+ * The weights, written down rather than scattered.
+ *
+ * They encode a claim about evidence, so they belong in one readable place
+ * where the claim can be argued with: **being there outweighs being
+ * relevant, and a track record is worth less than either.** A judged
+ * criterion says an answer is about the right question; it says nothing about
+ * whether the answer is true.
+ */
+export declare const WORTH: {
+    /** A device reported a location inside the radius, or EXIF did. */
+    readonly grounding: 0.45;
+    /** Something independent of the answerer agrees — weather, daylight, OSM. */
+    readonly corroboration: 0.25;
+    /** An AI ruled the answer addresses the question. */
+    readonly relevance: 0.15;
+    /** The answerer has been right here before. */
+    readonly record: 0.1;
+};
+export declare function evidenceFrom(signals: Signal[], unverified: string[]): Evidence;
+/**
+ * The envelope's own words.
+ *
+ * Kept beside the arithmetic so the number and its presentation cannot drift:
+ * every surface that shows a confidence shows it this way, and a bare score
+ * never escapes on its own.
+ */
+export declare function evidenceLines(evidence: Evidence): string[];
+//# sourceMappingURL=confidence.d.ts.map

package/dist/esm/rubric/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../../src/rubric/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK;IAChB,mEAAmE;;IAEnE,6EAA6E;;IAE7E,qDAAqD;;IAErD,+CAA+C;;CAEvC,CAAC;AAcX,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,CAoB9E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAM1D"}