@graview/core 0.1.54 → 0.1.56

package/dist/friction.d.ts

@@ -0,0 +1,209 @@
+/**
+ * `@graview/core/friction` — WHAT PEOPLE LOOKED FOR AND COULD NOT DO
+ * (Roadmap f-friction-log).
+ *
+ * The op log records every change, with its author and lineage; an AI
+ * interaction keeps its outcome (`@graview/core/catalog`); a declined
+ * suggestion is remembered (`@graview/core/tidying`). What none of them
+ * records is what happened BEFORE a change, or instead of one: the words
+ * somebody searched for and found nothing, the question the seat could not
+ * answer, the act that was refused, the tool call an agent got wrong and
+ * the form that worked after it. This is that record, in the graph's own
+ * words — kinds, acts, refusal codes, the words people typed — never
+ * clicks or selectors.
+ *
+ * A visitor (a person answering a form, who never joined the app) is never
+ * recorded. Free text is bounded and kept as data. What anybody but the
+ * person reads is counted across DISTINCT people (`frictionOf`), never who,
+ * and words fewer than `minPeople` people used are not said at all; a
+ * person reads their own (`ownFriction`); a model is told a short digest
+ * (`frictionDigest`, `aiContextOf`'s `friction`) with no refusal's sentence
+ * in it. `withinRetention` lets the old go.
+ *
+ * Core keeps no storage of it: `memoryFriction` here, a file beside the
+ * store and a browser's storage in `@graview/ship`, a host's own anywhere.
+ * Its own entry, because a page draws nothing with it; what a page records
+ * through is `recordFriction` on the main entry, a weak map and a check.
+ */
+import { type FrictionDraft, type FrictionSink } from "./friction-record.js";
+import type { Author } from "./ops/types.js";
+import type { Principal } from "./permissions/types.js";
+import { type RefusalReason } from "./refused.js";
+import type { AnySchema } from "./schema/schema.js";
+export type { FrictionDraft, FrictionSink };
+export declare const FRICTION_TYPES: readonly ["search-miss", "unanswered", "refused", "tool-invalid"];
+export type FrictionType = (typeof FRICTION_TYPES)[number];
+/** Every event: an id, when, who (the seat's kind and id, and whom an agent acted for), and the kind it was about. */
+export interface FrictionBase {
+    readonly id: string;
+    readonly at: string;
+    readonly by: Author;
+    readonly kind?: string;
+}
+export interface SearchMiss extends FrictionBase {
+    readonly type: "search-miss";
+    readonly words: string;
+}
+export interface Unanswered extends FrictionBase {
+    readonly type: "unanswered";
+    readonly question: string;
+    readonly place?: string;
+}
+export interface RefusedAct extends FrictionBase {
+    readonly type: "refused";
+    readonly act: string;
+    readonly code: RefusalReason;
+}
+export interface ToolInvalid extends FrictionBase {
+    readonly type: "tool-invalid";
+    readonly tool: string;
+    readonly act?: string;
+    readonly message: string;
+    /** The form of the next call of the same tool that worked (`callShape`): argument names and types, never values. */
+    readonly then?: string;
+}
+export type FrictionEvent = SearchMiss | Unanswered | RefusedAct | ToolInvalid;
+/** The caps on what an event keeps: text is cut to these, and a name longer than `name` is no name. */
+export declare const FRICTION_LIMITS: {
+    readonly words: 120;
+    readonly question: 300;
+    readonly message: 300;
+    readonly then: 300;
+    readonly name: 80;
+};
+/** How long a host keeps friction when it says nothing: ninety days. */
+export declare const FRICTION_RETENTION_DAYS = 90;
+/**
+ * A DRAFT, KEPT AS AN EVENT: its text bounded, its names checked, stamped
+ * with an id, a time and its author. Undefined for a visitor (or an agent
+ * acting for one) and for a draft that is not one of the four.
+ */
+export declare function frictionEvent(draft: FrictionDraft, by: Author, options?: {
+    readonly at?: string;
+    readonly id?: string;
+}): FrictionEvent | undefined;
+/**
+ * WHERE A HOST KEEPS FRICTION: append and read back. `memoryFriction` here;
+ * `fileFriction` (a file beside the store) and `browserFriction` (a
+ * browser's storage) in `@graview/ship`; a host's own anywhere.
+ */
+export interface FrictionStore {
+    add(event: FrictionEvent): void | Promise<void>;
+    list(): readonly FrictionEvent[] | Promise<readonly FrictionEvent[]>;
+}
+/** A store that answers at once: memory, a file, a browser's storage. */
+export interface HeldFriction extends FrictionStore {
+    add(event: FrictionEvent): void;
+    list(): readonly FrictionEvent[];
+}
+/** What a kept log holds at most, oldest let go first. */
+export declare const FRICTION_KEPT_MOST = 5000;
+/** What a store keeps after an event: within the retention, at most `most`, oldest let go first. */
+export declare function keptFriction(events: readonly FrictionEvent[], options?: {
+    readonly retentionDays?: number;
+    readonly most?: number;
+    readonly now?: number;
+}): readonly FrictionEvent[];
+/** Friction kept in memory for as long as the process runs. */
+export declare function memoryFriction(options?: {
+    readonly retentionDays?: number;
+    readonly most?: number;
+}): HeldFriction;
+/** A sink that keeps each draft in a `FrictionStore`, as `by` — or, unsaid, as `otherwise`. A visitor's never is. */
+export declare function frictionSinkTo(store: FrictionStore, otherwise?: Author): FrictionSink;
+/** The events within the last `days` days of `now`. */
+export declare function withinRetention(events: readonly FrictionEvent[], days?: number, now?: number): readonly FrictionEvent[];
+/** A person's own events — and an agent's acting for them. A seat with no id has none. */
+export declare function ownFriction(events: readonly FrictionEvent[], principal: Principal): readonly FrictionEvent[];
+/** One thing counted: by how many distinct people, and how many times. */
+export interface FrictionCount {
+    readonly people: number;
+    readonly times: number;
+}
+/**
+ * WHAT PEOPLE COULD NOT DO, COUNTED — and never who. Each group is counted
+ * across distinct people (an agent acting for somebody counts as them),
+ * most people first; a group fewer than `minPeople` people share is left
+ * out, so a word one person typed is never said to anybody else. Tool
+ * mistakes say the tool, the act and the form that worked, never the
+ * refusal's sentence.
+ */
+export interface FrictionSummary {
+    readonly events: number;
+    readonly people: number;
+    readonly byType: Readonly<Record<FrictionType, {
+        readonly events: number;
+        readonly people: number;
+    }>>;
+    readonly searches: readonly (FrictionCount & {
+        readonly words: string;
+    })[];
+    readonly questions: readonly (FrictionCount & {
+        readonly question: string;
+    })[];
+    readonly words: readonly (FrictionCount & {
+        readonly word: string;
+    })[];
+    readonly refusals: readonly (FrictionCount & {
+        readonly act: string;
+        readonly code: RefusalReason;
+    })[];
+    readonly tools: readonly (FrictionCount & {
+        readonly tool: string;
+        readonly act?: string;
+        readonly then?: string;
+    })[];
+}
+export interface FrictionOptions {
+    /** The fewest distinct people a group is said for. 2 unsaid. */
+    readonly minPeople?: number;
+    /** The most groups of each list. 12 unsaid. */
+    readonly most?: number;
+}
+export declare function frictionOf(events: readonly FrictionEvent[], options?: FrictionOptions): FrictionSummary;
+/**
+ * WHAT A MODEL IS TOLD OF IT: the words people searched for that no kind,
+ * noun, plural or field of the app is called, the questions left
+ * unanswered, grouped, and the tool calls refused as invalid with the form
+ * that worked after them — and `said`, the same in a few lines.
+ */
+export interface FrictionDigest {
+    readonly said: string;
+    readonly unknownWords: readonly {
+        readonly words: string;
+        readonly people: number;
+    }[];
+    readonly questions: readonly {
+        readonly question: string;
+        readonly people: number;
+    }[];
+    readonly toolMistakes: readonly {
+        readonly tool: string;
+        readonly act?: string;
+        readonly then?: string;
+        readonly times: number;
+    }[];
+}
+export declare function frictionDigest(events: readonly FrictionEvent[], schema: AnySchema, options?: FrictionOptions): FrictionDigest;
+/** A call's form: each argument's name and type, an object's one level in — never a value. "{ label: string, due: string }". */
+export declare function callShape(args: Readonly<Record<string, unknown>>, depth?: number): string;
+/** What became of one tool call, as `toolMistakes` hears it. */
+export type ToolOutcome = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason?: string;
+    readonly message: string;
+};
+/**
+ * AN AGENT'S TOOL CALLS, WATCHED FOR MISTAKES IN THEIR FORM: a call refused
+ * as `invalid` is held until the next call of the same tool — recorded with
+ * that call's form as `then` when it worked, as it was when it too was
+ * refused — and `flush` records what is still held. A refusal for any
+ * other reason is not a mistake in the call's form, and is not recorded.
+ */
+export declare function toolMistakes(record: (draft: FrictionDraft) => void): {
+    heard(tool: string, act: string | undefined, args: Readonly<Record<string, unknown>>, outcome: ToolOutcome): void;
+    flush(): void;
+};
+//# sourceMappingURL=friction.d.ts.map

package/dist/friction.d.ts.map

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

package/dist/friction.js

@@ -0,0 +1,302 @@
+/**
+ * `@graview/core/friction` — WHAT PEOPLE LOOKED FOR AND COULD NOT DO
+ * (Roadmap f-friction-log).
+ *
+ * The op log records every change, with its author and lineage; an AI
+ * interaction keeps its outcome (`@graview/core/catalog`); a declined
+ * suggestion is remembered (`@graview/core/tidying`). What none of them
+ * records is what happened BEFORE a change, or instead of one: the words
+ * somebody searched for and found nothing, the question the seat could not
+ * answer, the act that was refused, the tool call an agent got wrong and
+ * the form that worked after it. This is that record, in the graph's own
+ * words — kinds, acts, refusal codes, the words people typed — never
+ * clicks or selectors.
+ *
+ * A visitor (a person answering a form, who never joined the app) is never
+ * recorded. Free text is bounded and kept as data. What anybody but the
+ * person reads is counted across DISTINCT people (`frictionOf`), never who,
+ * and words fewer than `minPeople` people used are not said at all; a
+ * person reads their own (`ownFriction`); a model is told a short digest
+ * (`frictionDigest`, `aiContextOf`'s `friction`) with no refusal's sentence
+ * in it. `withinRetention` lets the old go.
+ *
+ * Core keeps no storage of it: `memoryFriction` here, a file beside the
+ * store and a browser's storage in `@graview/ship`, a host's own anywhere.
+ * Its own entry, because a page draws nothing with it; what a page records
+ * through is `recordFriction` on the main entry, a weak map and a check.
+ */
+import { isVisitorAuthor } from "./friction-record.js";
+import { REFUSAL_REASONS } from "./refused.js";
+import { humanizeField, nounOf, pluralOf } from "./schema/define-node.js";
+// ── the events ──────────────────────────────────────────────────────────────
+export const FRICTION_TYPES = ["search-miss", "unanswered", "refused", "tool-invalid"];
+/** The caps on what an event keeps: text is cut to these, and a name longer than `name` is no name. */
+export const FRICTION_LIMITS = { words: 120, question: 300, message: 300, then: 300, name: 80 };
+/** How long a host keeps friction when it says nothing: ninety days. */
+export const FRICTION_RETENTION_DAYS = 90;
+/** Control characters, zero-width marks and direction overrides: nothing a person reads, something a reader could be fooled by. */
+// eslint-disable-next-line no-control-regex
+const UNSEEN = new RegExp("[\\u0000-\\u001f\\u007f-\\u009f\\u200b-\\u200f\\u2028-\\u202e\\u2066-\\u2069]", "g");
+/** Text as data: control characters gone, whitespace folded, cut to `max`. Empty is nothing. */
+function textOf(value, max) {
+    if (typeof value !== "string")
+        return undefined;
+    const clean = value.replace(UNSEEN, " ").replace(/\s+/g, " ").trim();
+    return clean.length === 0 ? undefined : clean.slice(0, max).trimEnd();
+}
+/** A declared name (a kind, an act, a tool, a place): letters, digits, `-`, `_`, `.`, `:` and `/`, or nothing. */
+function nameOf(value) {
+    return typeof value === "string" && value.length > 0 && value.length <= FRICTION_LIMITS.name && /^[\p{L}\p{N}_][\p{L}\p{N}_.:/-]*$/u.test(value) ? value : undefined;
+}
+/** Who, as an event keeps them: the kind and id, and whom an agent acted for — no session, no name. */
+function whoOf(author) {
+    const id = typeof author.id === "string" ? author.id.slice(0, FRICTION_LIMITS.name) : undefined;
+    return {
+        kind: author.kind,
+        ...(id !== undefined ? { id } : {}),
+        ...(author.onBehalfOf ? { onBehalfOf: whoOf(author.onBehalfOf) } : {}),
+    };
+}
+const freshId = () => `fr-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+/**
+ * A DRAFT, KEPT AS AN EVENT: its text bounded, its names checked, stamped
+ * with an id, a time and its author. Undefined for a visitor (or an agent
+ * acting for one) and for a draft that is not one of the four.
+ */
+export function frictionEvent(draft, by, options = {}) {
+    if (!draft || typeof draft !== "object" || !by || isVisitorAuthor(by))
+        return undefined;
+    const asked = draft;
+    const kind = asked["kind"] === undefined ? undefined : nameOf(asked["kind"]);
+    if (asked["kind"] !== undefined && kind === undefined)
+        return undefined;
+    const base = { id: options.id ?? freshId(), at: options.at ?? new Date().toISOString(), by: whoOf(by), ...(kind ? { kind } : {}) };
+    switch (asked["type"]) {
+        case "search-miss": {
+            const words = textOf(asked["words"], FRICTION_LIMITS.words);
+            return words ? { ...base, type: "search-miss", words } : undefined;
+        }
+        case "unanswered": {
+            const question = textOf(asked["question"], FRICTION_LIMITS.question);
+            const place = asked["place"] === undefined ? undefined : nameOf(asked["place"]);
+            return question ? { ...base, type: "unanswered", question, ...(place ? { place } : {}) } : undefined;
+        }
+        case "refused": {
+            const act = nameOf(asked["act"]);
+            const code = asked["code"];
+            return act && REFUSAL_REASONS.includes(code) ? { ...base, type: "refused", act, code: code } : undefined;
+        }
+        case "tool-invalid": {
+            const tool = nameOf(asked["tool"]);
+            const message = textOf(asked["message"], FRICTION_LIMITS.message);
+            const act = asked["act"] === undefined ? undefined : nameOf(asked["act"]);
+            const then = textOf(asked["then"], FRICTION_LIMITS.then);
+            return tool && message ? { ...base, type: "tool-invalid", tool, message, ...(act ? { act } : {}), ...(then ? { then } : {}) } : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+/** What a kept log holds at most, oldest let go first. */
+export const FRICTION_KEPT_MOST = 5000;
+/** What a store keeps after an event: within the retention, at most `most`, oldest let go first. */
+export function keptFriction(events, options = {}) {
+    const kept = withinRetention(events, options.retentionDays ?? FRICTION_RETENTION_DAYS, options.now);
+    const most = options.most ?? FRICTION_KEPT_MOST;
+    return kept.length > most ? kept.slice(kept.length - most) : kept;
+}
+/** Friction kept in memory for as long as the process runs. */
+export function memoryFriction(options = {}) {
+    let held = [];
+    return {
+        add(event) {
+            if (isVisitorAuthor(event.by))
+                return;
+            held = keptFriction([...held, event], options);
+        },
+        list: () => keptFriction(held, options),
+    };
+}
+/** A sink that keeps each draft in a `FrictionStore`, as `by` — or, unsaid, as `otherwise`. A visitor's never is. */
+export function frictionSinkTo(store, otherwise) {
+    return (draft, by) => {
+        const author = by ?? otherwise;
+        const event = author ? frictionEvent(draft, author) : undefined;
+        if (event)
+            void store.add(event);
+    };
+}
+/** The events within the last `days` days of `now`. */
+export function withinRetention(events, days = FRICTION_RETENTION_DAYS, now = Date.now()) {
+    const since = now - days * 86_400_000;
+    return events.filter((event) => {
+        const time = Date.parse(event.at);
+        return Number.isFinite(time) && time >= since;
+    });
+}
+// ── reading it ──────────────────────────────────────────────────────────────
+/** The person an event is of: whom an agent acted for, else the author; a seat with no id is one anonymous person per kind. */
+const personOf = (author) => (author.onBehalfOf ? personOf(author.onBehalfOf) : author.id !== undefined ? `${author.kind}:${author.id}` : `${author.kind}:?`);
+/** Words as they are counted: lower case, whitespace folded, the punctuation at the ends gone. */
+const foldWords = (words) => words
+    .toLowerCase()
+    .replace(/\s+/g, " ")
+    .replace(/^[\s\p{P}]+|[\s\p{P}]+$/gu, "");
+/** A person's own events — and an agent's acting for them. A seat with no id has none. */
+export function ownFriction(events, principal) {
+    if (principal.id === undefined && principal.onBehalfOf?.id === undefined)
+        return [];
+    const me = personOf(principal);
+    return events.filter((event) => personOf(event.by) === me);
+}
+/** Words too common to say anything on their own. */
+const STOP = new Set("a an and are at be by can do does for from has have how i in is it me my of on or our the their there this to was we what when where which who why will with you your".split(" "));
+function grouped(events, keyOf, make, minPeople, most) {
+    const groups = new Map();
+    for (const event of events) {
+        const key = keyOf(event);
+        if (key === undefined)
+            continue;
+        const group = groups.get(key) ?? { first: event, people: new Set(), times: 0, last: event };
+        group.people.add(personOf(event.by));
+        group.times += 1;
+        group.last = event;
+        groups.set(key, group);
+    }
+    return [...groups.entries()]
+        .filter(([, group]) => group.people.size >= minPeople)
+        .sort(([a, one], [b, other]) => other.people.size - one.people.size || other.times - one.times || a.localeCompare(b))
+        .slice(0, most)
+        .map(([key, group]) => ({ ...make(group.last, key), people: group.people.size, times: group.times }));
+}
+export function frictionOf(events, options = {}) {
+    const minPeople = Math.max(1, options.minPeople ?? 2);
+    const most = options.most ?? 12;
+    const kept = events.filter((event) => !isVisitorAuthor(event.by));
+    const byType = Object.fromEntries(FRICTION_TYPES.map((type) => {
+        const of = kept.filter((event) => event.type === type);
+        return [type, { events: of.length, people: new Set(of.map((event) => personOf(event.by))).size }];
+    }));
+    // The words one at a time, from what was searched and asked, each said once per event.
+    const tokens = [];
+    const tokenOf = new Map();
+    for (const event of kept) {
+        const text = event.type === "search-miss" ? event.words : event.type === "unanswered" ? event.question : undefined;
+        if (text === undefined)
+            continue;
+        for (const word of new Set(foldWords(text).split(/[^\p{L}\p{N}]+/u))) {
+            if (word.length < 3 || STOP.has(word))
+                continue;
+            const one = { ...event, id: `${event.id}:${word}` };
+            tokens.push(one);
+            tokenOf.set(one, word);
+        }
+    }
+    return {
+        events: kept.length,
+        people: new Set(kept.map((event) => personOf(event.by))).size,
+        byType,
+        searches: grouped(kept, (event) => (event.type === "search-miss" ? foldWords(event.words) || undefined : undefined), (_event, words) => ({ words }), minPeople, most),
+        questions: grouped(kept, (event) => (event.type === "unanswered" ? foldWords(event.question) || undefined : undefined), (_event, question) => ({ question }), minPeople, most),
+        words: grouped(tokens, (event) => tokenOf.get(event), (_event, word) => ({ word }), minPeople, most),
+        refusals: grouped(kept, (event) => (event.type === "refused" ? `${event.act}|${event.code}` : undefined), (event) => ({ act: event.act, code: event.code }), minPeople, most),
+        tools: grouped(kept, (event) => (event.type === "tool-invalid" ? `${event.tool}|${event.act ?? ""}` : undefined), (event) => {
+            const tool = event;
+            return { tool: tool.tool, ...(tool.act ? { act: tool.act } : {}), ...(tool.then ? { then: tool.then } : {}) };
+        }, 1, most),
+    };
+}
+/** A word as it is compared with the app's names: lower case, a plural's `s` gone. */
+const stem = (word) => (word.length > 3 && word.endsWith("s") && !word.endsWith("ss") ? word.slice(0, -1) : word);
+/** Every word the app's kinds and fields are called by, their aliases among them. */
+function namesOf(schema) {
+    const names = new Set();
+    const add = (text) => {
+        for (const word of text.toLowerCase().split(/[^\p{L}\p{N}]+/u))
+            if (word.length > 0)
+                names.add(stem(word));
+    };
+    for (const kind of schema.kinds) {
+        const definition = schema.tryDefinition(kind);
+        add(kind);
+        add(nounOf(definition, kind));
+        add(pluralOf(schema, kind));
+        // And the other words the app answers to (Roadmap f-learned-suggestions): a word it took as an alias is no longer unknown.
+        for (const alias of [...(definition?.aliases ?? []), ...Object.values(definition?.fieldAliases ?? {}).flat()])
+            add(alias);
+        for (const field of Object.keys(definition?.fields?.shape ?? {})) {
+            add(field);
+            add(humanizeField(field));
+        }
+    }
+    return names;
+}
+export function frictionDigest(events, schema, options = {}) {
+    const summary = frictionOf(events, { most: 8, ...options });
+    const names = namesOf(schema);
+    const unknownWords = summary.searches
+        .filter((search) => !search.words.split(/[^\p{L}\p{N}]+/u).some((word) => word.length > 0 && names.has(stem(word))))
+        .map((search) => ({ words: search.words, people: search.people }));
+    const questions = summary.questions.map((question) => ({ question: question.question, people: question.people }));
+    const toolMistakes = summary.tools.map((tool) => ({ tool: tool.tool, ...(tool.act ? { act: tool.act } : {}), ...(tool.then ? { then: tool.then } : {}), times: tool.times }));
+    const people = (count) => `${count} ${count === 1 ? "person" : "people"}`;
+    const lines = [
+        ...(unknownWords.length > 0 ? [`Searched for, found nothing, and nothing here is called it: ${unknownWords.map((one) => `“${one.words}” (${people(one.people)})`).join(", ")}.`] : []),
+        ...(questions.length > 0 ? [`Asked and not answered: ${questions.map((one) => `“${one.question}” (${people(one.people)})`).join(", ")}.`] : []),
+        ...(toolMistakes.length > 0
+            ? [`Tool calls refused as invalid: ${toolMistakes.map((one) => `${one.tool}${one.act ? ` (${one.act})` : ""} ${one.times === 1 ? "once" : `${one.times} times`}${one.then ? `, then worked as ${one.then}` : ""}`).join("; ")}.`]
+            : []),
+    ];
+    return { said: lines.join("\n"), unknownWords, questions, toolMistakes };
+}
+// ── an agent's tool calls ───────────────────────────────────────────────────
+/** A call's form: each argument's name and type, an object's one level in — never a value. "{ label: string, due: string }". */
+export function callShape(args, depth = 0) {
+    const typeOf = (value) => value === null ? "null" : Array.isArray(value) ? "array" : typeof value === "object" ? (depth < 1 ? callShape(value, depth + 1) : "object") : typeof value;
+    const parts = Object.keys(args)
+        .filter((name) => args[name] !== undefined)
+        .slice(0, 16)
+        .map((name) => `${name.slice(0, 40)}: ${typeOf(args[name])}`);
+    return (parts.length === 0 ? "{}" : `{ ${parts.join(", ")} }`).slice(0, FRICTION_LIMITS.then);
+}
+/**
+ * AN AGENT'S TOOL CALLS, WATCHED FOR MISTAKES IN THEIR FORM: a call refused
+ * as `invalid` is held until the next call of the same tool — recorded with
+ * that call's form as `then` when it worked, as it was when it too was
+ * refused — and `flush` records what is still held. A refusal for any
+ * other reason is not a mistake in the call's form, and is not recorded.
+ */
+export function toolMistakes(record) {
+    const held = new Map();
+    const keep = (draft) => {
+        try {
+            record(draft);
+        }
+        catch {
+            // Recording is never why a call fails.
+        }
+    };
+    return {
+        heard(tool, act, args, outcome) {
+            const before = held.get(tool);
+            if (outcome.ok) {
+                if (before) {
+                    held.delete(tool);
+                    keep({ ...before, then: callShape(args) });
+                }
+                return;
+            }
+            if (outcome.reason !== "invalid")
+                return;
+            if (before)
+                keep(before);
+            held.set(tool, { type: "tool-invalid", tool, ...(act ? { act } : {}), message: outcome.message });
+        },
+        flush() {
+            for (const draft of held.values())
+                keep(draft);
+            held.clear();
+        },
+    };
+}
+//# sourceMappingURL=friction.js.map

package/dist/friction.js.map

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

package/dist/import/coerce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../src/import/coerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAoBD,kIAAkI;AAClI,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,SAAS,CAgCvF;AASD,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,SAAS,CA6B5F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAoB7D;AAKD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAM/D;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7H;AAED,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAyE9G;AAED,mBAAmB;AACnB,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGvD;AAED,oBAAoB;AACpB,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../src/import/coerce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQvD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAoBD,kIAAkI;AAClI,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,SAAS,CAgCvF;AASD,gHAAgH;AAChH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,SAAS,CA6B5F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAoB7D;AAKD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAM/D;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7H;AAED,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CA0E9G;AAED,mBAAmB;AACnB,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGvD;AAED,oBAAoB;AACpB,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGxD"}

package/dist/import/coerce.js

@@ -3,6 +3,7 @@ import { slug } from "../mutations/define-mutation.js";
 import { isAppAddress } from "../schema/app-link.js";
 import { PHONE } from "../schema/typed-fields.js";
 import { parseDuration } from "../schema/field-words.js";
+import { readPartialDay } from "../when-typed.js";
 const MONTHS = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
 const pad = (n) => String(n).padStart(2, "0");
 /** Whether a day is on the calendar: February has no 30th. */
@@ -187,7 +188,8 @@ export function coerceCell(spec, input, said, options = {}) {
             return value === undefined ? { ok: false, why: `${quoted} under ${said} is not a yes or a no` } : { ok: true, value };
         }
         case "date": {
-            const value = readDay(input, options);
+            // A day; else a year or a month alone, which the field keeps or refuses (Roadmap f-partial-dates).
+            const value = readDay(input, options) ?? readPartialDay(input);
             return value === undefined ? { ok: false, why: `${quoted} under ${said} is not a date` } : { ok: true, value };
         }
         case "datetime": {