@graview/core 0.1.62 → 0.1.64

package/dist/workflows/schedule.js

@@ -0,0 +1,160 @@
+/*
+ * WHEN A WORKFLOW RUNS ON A CLOCK (Roadmap f-jobs-declared): words a person
+ * writes — "day 03:00", "weekday 09:00", "sunday 18:00", "month 1 09:00",
+ * "hour" — or five-field cron, both read as the same table of minutes,
+ * hours, days of the month, months and weekdays, and both on the wall clock
+ * of the app's time zone (the brand's `timeZone`). DST is the wall clock's:
+ * "sunday 18:00" is 6 PM on the Sunday the clocks spring forward too. A time
+ * the clock skips that day (02:30, the night it springs forward) runs the
+ * moment the clock jumps past it (03:00); a time it says twice (01:30, the
+ * night it falls back) runs once.
+ */
+const WEEKDAYS = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+const MONTHS = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
+const range = (from, to) => new Set(Array.from({ length: to - from + 1 }, (_, i) => from + i));
+/** What the words a schedule takes are, said when one cannot be read. */
+export const SCHEDULE_WORDS = '"hour", "day", "day 03:00", "weekday 09:00", "sunday 18:00" (any weekday), "month 1 09:00", or five-field cron like "0 18 * * 0"';
+/** A time of day: "18:00", "6:30", "6pm", "6:30 pm"; minutes after midnight, or undefined. */
+function timeOf(said) {
+    const found = /^(\d{1,2})(?::(\d{2}))?\s*(am|pm)?$/.exec(said.trim().toLowerCase());
+    if (!found)
+        return undefined;
+    let hour = Number(found[1]);
+    const minute = found[2] === undefined ? 0 : Number(found[2]);
+    if (found[3]) {
+        if (hour < 1 || hour > 12)
+            return undefined;
+        hour = (hour % 12) + (found[3] === "pm" ? 12 : 0);
+    }
+    else if (found[2] === undefined)
+        return undefined;
+    return hour > 23 || minute > 59 ? undefined : hour * 60 + minute;
+}
+/** A schedule in words, or a sentence saying what could not be read. */
+export function scheduleOfWords(words) {
+    const said = words.trim().toLowerCase().replace(/^every\s+/, "").replace(/\s+at\s+/, " ");
+    const all = { minutes: new Set([0]), hours: range(0, 23), days: range(1, 31), months: range(1, 12), weekdays: range(0, 6), daysSaid: false, weekdaysSaid: false };
+    if (said === "hour")
+        return all;
+    const [first = "", ...rest] = said.split(/\s+/);
+    const at = (tail) => {
+        if (tail.length === 0)
+            return 0;
+        const time = timeOf(tail.join(" "));
+        return time === undefined ? `"${tail.join(" ")}" is not a time of day; write it as "18:00" or "6 pm"` : time;
+    };
+    const daily = (time) => ({ ...all, minutes: new Set([time % 60]), hours: new Set([Math.floor(time / 60)]) });
+    if (first === "day") {
+        const time = at(rest);
+        return typeof time === "string" ? time : daily(time);
+    }
+    if (first === "weekday") {
+        const time = at(rest);
+        return typeof time === "string" ? time : { ...daily(time), weekdays: range(1, 5), weekdaysSaid: true };
+    }
+    const weekday = WEEKDAYS.findIndex((day) => first === day || first === `${day}s` || (first.length >= 3 && day.startsWith(first)));
+    if (weekday >= 0) {
+        const time = at(rest);
+        return typeof time === "string" ? time : { ...daily(time), weekdays: new Set([weekday]), weekdaysSaid: true };
+    }
+    if (first === "month") {
+        const day = Number(/^(\d{1,2})(?:st|nd|rd|th)?$/.exec(rest[0] ?? "")?.[1]);
+        if (!(day >= 1 && day <= 31))
+            return `"month" takes the day of the month it runs on, 1 to 31, like "month 1 09:00"`;
+        const time = at(rest.slice(1));
+        return typeof time === "string" ? time : { ...daily(time), days: new Set([day]), daysSaid: true };
+    }
+    return `"${words}" is not a schedule Graview reads; it reads ${SCHEDULE_WORDS}`;
+}
+/** One cron field, or a sentence. */
+function cronField(field, min, max, names = [], what = "field") {
+    const out = new Set();
+    const valueOf = (said) => {
+        const named = names.findIndex((name) => said.toLowerCase().startsWith(name.slice(0, 3)) && said.length >= 3);
+        if (named >= 0)
+            return named + (min === 1 ? 1 : 0);
+        return /^\d+$/.test(said) ? Number(said) : undefined;
+    };
+    for (const part of field.split(",")) {
+        const [span = "", stepSaid] = part.split("/");
+        const step = stepSaid === undefined ? 1 : Number(stepSaid);
+        if (!Number.isInteger(step) || step < 1)
+            return `the ${what} "${field}" has a step that is not a whole number`;
+        let from;
+        let to;
+        if (span === "*")
+            (from = min), (to = max);
+        else if (span.includes("-")) {
+            const [a = "", b = ""] = span.split("-");
+            (from = valueOf(a)), (to = valueOf(b));
+        }
+        else {
+            from = valueOf(span);
+            to = stepSaid === undefined ? from : max;
+        }
+        // Sunday as 7, as cron lets it be said.
+        const top = what === "weekday" ? 7 : max;
+        if (from === undefined || to === undefined || from < min || to > top || from > to)
+            return `the ${what} "${field}" is not ${min}–${max}`;
+        for (let value = from; value <= to; value += step)
+            out.add(what === "weekday" ? value % 7 : value);
+    }
+    return out;
+}
+/** A schedule in five-field cron, or a sentence saying what could not be read. */
+export function scheduleOfCron(cron) {
+    const fields = cron.trim().split(/\s+/);
+    if (fields.length !== 5)
+        return `"${cron}" has ${fields.length} field${fields.length === 1 ? "" : "s"}; cron here is five: minute, hour, day of the month, month, weekday ("0 18 * * 0")`;
+    const minutes = cronField(fields[0], 0, 59, [], "minute");
+    const hours = cronField(fields[1], 0, 23, [], "hour");
+    const days = cronField(fields[2], 1, 31, [], "day of the month");
+    const months = cronField(fields[3], 1, 12, MONTHS, "month");
+    const weekdays = cronField(fields[4], 0, 6, WEEKDAYS, "weekday");
+    for (const one of [minutes, hours, days, months, weekdays])
+        if (typeof one === "string")
+            return `"${cron}" does not read: ${one}`;
+    return { minutes: minutes, hours: hours, days: days, months: months, weekdays: weekdays, daysSaid: fields[2] !== "*", weekdaysSaid: fields[4] !== "*" };
+}
+/** A clock trigger's schedule, or a sentence; undefined for a trigger that is no clock. */
+export function scheduleOf(trigger) {
+    if (typeof trigger.every === "string")
+        return scheduleOfWords(trigger.every);
+    if (typeof trigger.cron === "string")
+        return scheduleOfCron(trigger.cron);
+    return undefined;
+}
+const twelve = (minutes) => {
+    const hour = Math.floor(minutes / 60);
+    const minute = minutes % 60;
+    return `${hour % 12 === 0 ? 12 : hour % 12}${minute === 0 ? "" : `:${String(minute).padStart(2, "0")}`} ${hour < 12 ? "AM" : "PM"}`;
+};
+const ordinal = (n) => `${n}${n % 100 >= 11 && n % 100 <= 13 ? "th" : ["th", "st", "nd", "rd"][n % 10] ?? "th"}`;
+const capital = (said) => said.charAt(0).toUpperCase() + said.slice(1);
+/** A clock trigger as a person reads it: "Every Sunday at 6 PM", "Every hour", "On the 1st of each month at 9 AM". */
+export function scheduleWords(trigger) {
+    const schedule = scheduleOf(trigger);
+    const raw = trigger.every ?? trigger.cron ?? "";
+    if (schedule === undefined || typeof schedule === "string")
+        return `On the schedule “${raw}”`;
+    const one = (set) => (set.size === 1 ? [...set][0] : undefined);
+    const hour = one(schedule.hours);
+    const minute = one(schedule.minutes);
+    const allMonths = schedule.months.size === 12;
+    if (hour === undefined || minute === undefined || !allMonths) {
+        if (schedule.hours.size === 24 && minute !== undefined && !schedule.daysSaid && !schedule.weekdaysSaid && allMonths)
+            return minute === 0 ? "Every hour" : `Every hour at ${minute} past`;
+        return `On the schedule “${raw}”`;
+    }
+    const time = `at ${twelve(hour * 60 + minute)}`;
+    if (!schedule.daysSaid && !schedule.weekdaysSaid)
+        return `Every day ${time}`;
+    if (!schedule.daysSaid && schedule.weekdays.size === 5 && [1, 2, 3, 4, 5].every((d) => schedule.weekdays.has(d)))
+        return `Every weekday ${time}`;
+    if (!schedule.daysSaid)
+        return `Every ${[...schedule.weekdays].sort().map((d) => capital(WEEKDAYS[d])).join(" and ")} ${time}`;
+    if (!schedule.weekdaysSaid && schedule.days.size === 1)
+        return `On the ${ordinal([...schedule.days][0])} of each month ${time}`;
+    return `On the schedule “${raw}”`;
+}
+//# sourceMappingURL=schedule.js.map

package/dist/workflows/schedule.js.map

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

package/dist/workflows/step-act.d.ts

@@ -0,0 +1,6 @@
+import type { ActStep } from "../workflow-shape.js";
+import type { StepKind } from "./steps.js";
+/** The names a key's `{field}` template reads. */
+export declare const keyFields: (key: string) => string[];
+export declare const actStep: StepKind<ActStep>;
+//# sourceMappingURL=step-act.d.ts.map

package/dist/workflows/step-act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-act.d.ts","sourceRoot":"","sources":["../../src/workflows/step-act.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAa,QAAQ,EAA+B,MAAM,YAAY,CAAC;AAcnF,kDAAkD;AAClD,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,MAAM,EAAqF,CAAC;AAGpI,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,CA6DrC,CAAC"}

package/dist/workflows/step-act.js

@@ -0,0 +1,79 @@
+import * as z from "../schema/zod.js";
+import { conditionProblems } from "../job-findings.js";
+import { nearestAct } from "../mutations/act-spelling.js";
+/*
+ * RUN AN ACT (Roadmap f-job-step-types): once, or once per record `over`
+ * picks. The act is one the app gives — declared or derived — and what
+ * `{ expr }` values read is the record the step is over. `key` is the
+ * stable key of what it makes, a `{field}` template read on that record
+ * and the step's arguments: a rerun with the same key changes the record
+ * it made last time (`@graview/tools/workflows`).
+ */
+const quoted = (names) => [...names].map((name) => `"${name}"`).join(", ") || "none";
+/** The names a key's `{field}` template reads. */
+export const keyFields = (key) => [...key.matchAll(/\{([^{}|\s]+)(?:\s*\|[^{}]*)?\}/g)].map((found) => found[1]);
+export const actStep = {
+    key: "act",
+    title: "Run an act",
+    shape: (s) => z.strictObject({
+        act: s.name("act"),
+        over: z.optional(z.strictObject({ kind: s.name("kind"), where: z.optional(s.expression), limit: z.optional(z.number().check(z.int(), z.minimum(1), z.maximum(10_000))) })),
+        args: z.optional(z.record(z.string(), s.value)),
+        key: z.optional(s.str(1, 300)),
+        approve: z.optional(s.approve),
+    }),
+    findings(step, check) {
+        const { world, said, index } = check;
+        const out = [];
+        const at = `steps.${index}`;
+        if (!world.acts.includes(step.act)) {
+            const near = nearestAct(step.act, world.acts);
+            const steps = check.declared["steps"] ?? [];
+            out.push({
+                code: "workflow-act-unknown",
+                severity: "error",
+                path: `${at}.act`,
+                message: `${said} runs "${step.act}", which is not an act of this app.`,
+                fix: near ? `Did you mean "${near}"?` : "Name one of the app's acts, declared or derived (add-…, edit-<kind>, archive-<kind>).",
+                ...(near ? { edits: [{ op: "set-workflow", name: check.workflow, workflow: { ...check.declared, steps: steps.map((one, i) => (i === index ? { ...one, act: near } : one)) } }] } : {}),
+            });
+        }
+        if (step.over) {
+            const kind = world.kinds.get(step.over.kind);
+            if (!kind)
+                out.push({ code: "workflow-kind-unknown", severity: "error", path: `${at}.over.kind`, message: `${said} runs over "${step.over.kind}" records, and "${step.over.kind}" is not a kind of this app.`, fix: `Name one of its kinds: ${quoted(world.kinds.keys())}.` });
+            else if (step.over.where !== undefined) {
+                for (const problem of conditionProblems(step.over.where, step.over.kind, kind, world)) {
+                    out.push({ code: "workflow-where-invalid", severity: "error", path: `${at}.over.where`, message: `${said} cannot pick its records: ${problem}.`, fix: `Write it in the rule language over the fields of "${step.over.kind}" (${quoted(Object.keys(kind.fields))}) and its relations.` });
+                }
+            }
+        }
+        if (step.key !== undefined) {
+            const kind = step.over ? world.kinds.get(step.over.kind) : undefined;
+            const readable = new Set(["id", "label", ...Object.keys(step.args ?? {}), ...(kind ? [...Object.keys(kind.fields), ...kind.computed] : [])]);
+            const fields = keyFields(step.key);
+            if (fields.length === 0)
+                out.push({ code: "workflow-key-field-unknown", severity: "error", path: `${at}.key`, message: `${said}'s key "${step.key}" reads no field, so every run would make the same one record.`, fix: `Say what tells two apart in braces, like "{id}" or "{id}:{date}".` });
+            for (const field of fields) {
+                if (readable.has(field) || (step.over && !kind))
+                    continue;
+                out.push({
+                    code: "workflow-key-field-unknown",
+                    severity: "error",
+                    path: `${at}.key`,
+                    message: `${said}'s key reads "{${field}}", and ${step.over ? `"${step.over.kind}" has no field called that and the step hands the act no argument called that` : "the step hands the act no argument called that"}.`,
+                    fix: `Read one of ${quoted(readable)}.`,
+                });
+            }
+        }
+        return out;
+    },
+    words(step, noun) {
+        const over = step.over ? ` for each ${noun(step.over.kind)}${step.over.where ? ` where ${step.over.where}` : ""}${step.over.limit ? ` (at most ${step.over.limit})` : ""}` : "";
+        return `Run “${step.act}”${over}`;
+    },
+    touches(step, world) {
+        return { reads: step.over ? [step.over.kind] : [], writes: [...new Set([...(world.actOn(step.act) ?? []), ...(world.actMakes(step.act) ?? [])])] };
+    },
+};
+//# sourceMappingURL=step-act.js.map

package/dist/workflows/step-act.js.map

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

package/dist/workflows/step-agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentStep } from "../workflow-shape.js";
+import type { StepKind } from "./steps.js";
+export declare const agentStep: StepKind<AgentStep>;
+//# sourceMappingURL=step-agent.d.ts.map

package/dist/workflows/step-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-agent.d.ts","sourceRoot":"","sources":["../../src/workflows/step-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAa,QAAQ,EAA+B,MAAM,YAAY,CAAC;AAanF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,SAAS,CA2CzC,CAAC"}

package/dist/workflows/step-agent.js

@@ -0,0 +1,55 @@
+import * as z from "../schema/zod.js";
+/*
+ * LET A MODEL PROPOSE (Roadmap f-job-step-types): an instruction in words,
+ * the kinds whose records it is shown and the acts it may propose — never
+ * any other. Built on dreaming's runner in `@graview/tools/workflows`: what
+ * it proposes is applied, suggested or let go by `approve` and how sure it
+ * is. With no model lent, the step is skipped and the run says so.
+ */
+const quoted = (names) => [...names].map((name) => `"${name}"`).join(", ") || "none";
+export const agentStep = {
+    key: "agent",
+    title: "Let a model propose",
+    shape: (s) => z.strictObject({
+        agent: s.str(1, 2000),
+        reads: z.array(s.name("kind")).check(z.maxLength(40)),
+        acts: z.array(s.str(1, 120)).check(z.maxLength(60)),
+        model: z.optional(s.str(1, 120)),
+        budget: z.optional(z.strictObject({ calls: z.optional(z.number().check(z.int(), z.minimum(1), z.maximum(1000))), tokens: z.optional(z.number().check(z.int(), z.minimum(1), z.maximum(10_000_000))) })),
+        approve: z.optional(s.approve),
+    }),
+    findings(step, check) {
+        const { world, said, index } = check;
+        const at = `steps.${index}`;
+        const out = [];
+        step.reads.forEach((kind, i) => {
+            if (!world.kinds.has(kind))
+                out.push({ code: "workflow-kind-unknown", severity: "error", path: `${at}.reads.${i}`, message: `${said} reads "${kind}" records, and "${kind}" is not a kind of this app.`, fix: `Name one of its kinds: ${quoted(world.kinds.keys())}.` });
+        });
+        if (step.acts.length === 0) {
+            const over = world.acts.filter((act) => (world.actOn(act) ?? []).some((kind) => step.reads.includes(kind)));
+            const steps = check.declared["steps"] ?? [];
+            out.push({
+                code: "workflow-agent-acts-empty",
+                severity: "error",
+                path: `${at}.acts`,
+                message: `${said} lets a model propose, and names no act it may propose — so it could do nothing.`,
+                fix: over.length > 0 ? `Name the acts it may propose, like ${quoted(over.slice(0, 4))}.` : "Name the acts it may propose.",
+                ...(over.length > 0 ? { edits: [{ op: "set-workflow", name: check.workflow, workflow: { ...check.declared, steps: steps.map((one, i) => (i === index ? { ...one, acts: over.slice(0, 4) } : one)) } }] } : {}),
+            });
+        }
+        step.acts.forEach((act, i) => {
+            if (!world.acts.includes(act))
+                out.push({ code: "workflow-act-unknown", severity: "error", path: `${at}.acts.${i}`, message: `${said} lets a model propose "${act}", which is not an act of this app.`, fix: "Name one of the app's acts, declared or derived." });
+        });
+        return out;
+    },
+    words(step, noun) {
+        const reads = step.reads.length > 0 ? ` reading ${step.reads.map(noun).join(", ")}` : "";
+        return `Ask a model to ${step.agent.replace(/^./, (first) => first.toLowerCase()).replace(/[.!]$/, "")}${reads}, proposing ${step.acts.map((act) => `“${act}”`).join(", ") || "nothing"}`;
+    },
+    touches(step, world) {
+        return { reads: [...step.reads], writes: [...new Set(step.acts.flatMap((act) => [...(world.actOn(act) ?? []), ...(world.actMakes(act) ?? [])]))] };
+    },
+};
+//# sourceMappingURL=step-agent.js.map

package/dist/workflows/step-agent.js.map

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

package/dist/workflows/step-archive.d.ts

@@ -0,0 +1,8 @@
+import type { ArchiveStep } from "../workflow-shape.js";
+import type { StepKind } from "./steps.js";
+/** How long `after` asks a record to have stood, in milliseconds, or undefined when its words do not read. */
+export declare function afterMs(after: string): number | undefined;
+/** `after` said: "3 days after it last changed", "7 days after its date". */
+export declare function afterWords(after: ArchiveStep["after"]): string;
+export declare const archiveStep: StepKind<ArchiveStep>;
+//# sourceMappingURL=step-archive.d.ts.map

package/dist/workflows/step-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-archive.d.ts","sourceRoot":"","sources":["../../src/workflows/step-archive.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAuB,QAAQ,EAA+B,MAAM,YAAY,CAAC;AAoB7F,8GAA8G;AAC9G,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKzD;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM,CAI9D;AAED,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,WAAW,CAwC7C,CAAC"}

package/dist/workflows/step-archive.js

@@ -0,0 +1,74 @@
+import * as z from "../schema/zod.js";
+import { conditionProblems } from "../job-findings.js";
+/*
+ * SET ASIDE WHAT IS DONE WITH (Roadmap f-retention-rules): the records of
+ * one kind a rule holds of, once they have stood so long — "archive
+ * grocery lists where status == 'done' after 3 days". Archived, never
+ * removed (FR-173): each keeps its fields, its links and its history, and
+ * "Bring it back" undoes it. Deterministic, so it spends no model. The
+ * run holds it to what people said — a record left alone, a kind the app
+ * says is never tidied — and never sets aside again a record a person
+ * brought back from one of this workflow's archives
+ * (`@graview/tools/workflows`).
+ */
+const quoted = (names) => [...names].map((name) => `"${name}"`).join(", ") || "none";
+/** How long, in words: "3 days", "1 day", "2 weeks", "12 hours". */
+const AFTER = /^\s*(\d{1,4})\s*(hour|hours|day|days|week|weeks)\s*$/i;
+/** How long `after` asks a record to have stood, in milliseconds, or undefined when its words do not read. */
+export function afterMs(after) {
+    const found = AFTER.exec(after);
+    if (!found)
+        return undefined;
+    const unit = found[2].toLowerCase().replace(/s$/, "");
+    return Number(found[1]) * (unit === "hour" ? 3_600_000 : unit === "day" ? 86_400_000 : 7 * 86_400_000);
+}
+/** `after` said: "3 days after it last changed", "7 days after its date". */
+export function afterWords(after) {
+    if (after === undefined)
+        return "";
+    if (typeof after === "string")
+        return ` ${after.trim()} after it last changed`;
+    return ` ${after.days} ${after.days === 1 ? "day" : "days"} after its ${after.field.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase()}`;
+}
+export const archiveStep = {
+    key: "archive",
+    title: "Archive what is done with",
+    shape: (s) => z.strictObject({
+        archive: s.name("kind"),
+        where: z.optional(s.expression),
+        after: z.optional(z.union([s.str(1, 40), z.strictObject({ field: s.str(1, 120), days: z.number().check(z.int(), z.minimum(0), z.maximum(36_500)) })])),
+        approve: z.optional(s.approve),
+    }),
+    findings(step, check) {
+        const { world, said, index } = check;
+        const at = `steps.${index}`;
+        const out = [];
+        const kind = world.kinds.get(step.archive);
+        if (!kind) {
+            out.push({ code: "workflow-kind-unknown", severity: "error", path: `${at}.archive`, message: `${said} archives "${step.archive}" records, and "${step.archive}" is not a kind of this app.`, fix: `Name one of its kinds: ${quoted(world.kinds.keys())}.` });
+            return out;
+        }
+        if (!world.acts.includes(`archive-${step.archive}`)) {
+            out.push({ code: "workflow-archive-never", severity: "error", path: `${at}.archive`, message: `${said} archives ${world.noun(step.archive)} records, and the app says they are never archived.`, fix: `Take "archives: false" off "${step.archive}", or let this step go.` });
+        }
+        if (step.where !== undefined) {
+            for (const problem of conditionProblems(step.where, step.archive, kind, world)) {
+                out.push({ code: "workflow-where-invalid", severity: "error", path: `${at}.where`, message: `${said} cannot pick its records: ${problem}.`, fix: `Write it in the rule language over the fields of "${step.archive}" (${quoted(Object.keys(kind.fields))}) and its relations.` });
+            }
+        }
+        if (typeof step.after === "string" && afterMs(step.after) === undefined) {
+            out.push({ code: "workflow-archive-after-invalid", severity: "error", path: `${at}.after`, message: `${said} waits "${step.after}", which does not read as how long.`, fix: `Say it as a number and hours, days or weeks — "3 days" — or as { "field": "<a date field>", "days": 3 }.` });
+        }
+        else if (typeof step.after === "object" && !kind.fields[step.after.field]) {
+            out.push({ code: "workflow-archive-after-invalid", severity: "error", path: `${at}.after.field`, message: `${said} counts from "${step.after.field}", and "${step.archive}" has no field called that.`, fix: `Count from one of its fields: ${quoted(Object.keys(kind.fields))}.` });
+        }
+        return out;
+    },
+    words(step, noun) {
+        return `Archive ${noun(step.archive)} records${step.where ? ` where ${step.where}` : ""}${afterWords(step.after)}`;
+    },
+    touches(step, _world) {
+        return { reads: [step.archive], writes: [step.archive] };
+    },
+};
+//# sourceMappingURL=step-archive.js.map

package/dist/workflows/step-archive.js.map

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

package/dist/workflows/step-classify.d.ts

@@ -0,0 +1,25 @@
+import type { ClassifyFloorRule, ClassifyStep } from "../workflow-shape.js";
+import type { KindNoun, StepKind } from "./steps.js";
+/** Whether a step's changes wait for a person: always, unless the step says its own `approve` — and an option in `confirm` always. */
+export declare const classifyAsks: (step: ClassifyStep, option: string) => boolean;
+/** Whether a judgment is sure enough to be set without asking: it reaches its option's `applyAt`, and the option is not one `confirm` names. */
+export declare const classifyApplies: (step: ClassifyStep, option: string, confidence: number) => boolean;
+/** How many links a text holds: http, https and www addresses. */
+export declare const linksIn: (text: string) => number;
+/** A floor rule's verdict on a record: the option, and why, in words a person reads. */
+export interface FloorReading {
+    readonly option: string;
+    readonly basis: string;
+}
+/**
+ * THE FLOOR: the first option, in the order the step says them, whose rule
+ * holds of a record — its text (every string field, joined) holds at least
+ * `links` links, or one of `words` as a whole word in any case, or its
+ * `expr` holds (`holds(option)`, the rule language read by the caller).
+ * Undefined when none holds: the record is left for a person.
+ */
+export declare function floorLabel(floor: Readonly<Record<string, ClassifyFloorRule>> | undefined, text: string, holds?: (option: string) => boolean): FloorReading | undefined;
+/** One line: "Label each feedback's category as spam, rude or good-to-show; archive spam at 90% sure (asks before good-to-show)". */
+export declare function classifyWords(step: ClassifyStep, noun: KindNoun, options?: readonly string[]): string;
+export declare const classifyStep: StepKind<ClassifyStep>;
+//# sourceMappingURL=step-classify.d.ts.map

package/dist/workflows/step-classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-classify.d.ts","sourceRoot":"","sources":["../../src/workflows/step-classify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAa,QAAQ,EAA+B,MAAM,YAAY,CAAC;AA2B7F,sIAAsI;AACtI,eAAO,MAAM,YAAY,GAAI,MAAM,YAAY,EAAE,QAAQ,MAAM,KAAG,OAAwG,CAAC;AAE3K,gJAAgJ;AAChJ,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,EAAE,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,OAGxF,CAAC;AAIF,kEAAkE;AAClE,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAAuC,CAAC;AAI/E,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAqB,GAAG,YAAY,GAAG,SAAS,CAWnL;AAKD,qIAAqI;AACrI,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAOrG;AAED,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,YAAY,CAuF/C,CAAC"}