@graview/core 0.1.61 → 0.1.63

package/dist/workflows/policies.js

@@ -0,0 +1,95 @@
+import { shapesFor } from "../document/computed-values.js";
+import { evaluateExpr, ExprEvalError, NodeSet } from "../document/expr/evaluate.js";
+import { ExprSyntaxError, parseExpr } from "../document/expr/parse.js";
+import { labelOf, nounOf, pluralOf } from "../schema/define-node.js";
+const ACTION = ["action", "rule", "instruction", "text"];
+const ORDER = ["order", "rank", "priority"];
+const APPLIES = ["appliesTo", "applies-to", "applies_to", "scope"];
+const RETIRED = /^(retired|off|inactive|paused|draft|archived|disabled)$/i;
+const first = (node, names) => names.map((name) => node[name]).find((value) => value !== undefined && value !== null && value !== "");
+/** Whether a policy record stands: not retired by its status, nor `active: false`. */
+const stands = (node) => node["active"] !== false && !(typeof node["status"] === "string" && RETIRED.test(node["status"].trim()));
+/**
+ * THE RULES THAT STAND, IN ORDER: the live records of `follows` whose
+ * status does not retire them, by `order` (those with none last), then by
+ * label. Nothing when the workflow follows nothing or the kind is not the app's.
+ */
+export function policiesOf(graph, schema, follows) {
+    if (follows === undefined || !schema.tryDefinition(follows))
+        return [];
+    const definition = schema.tryDefinition(follows);
+    return graph
+        .nodesOfKind(follows)
+        .filter((node) => stands(node))
+        .map((node) => {
+        const fields = node;
+        const label = labelOf(definition, node);
+        const action = first(fields, ACTION);
+        const order = first(fields, ORDER);
+        const applies = first(fields, APPLIES);
+        return {
+            id: node.id,
+            label,
+            action: typeof action === "string" ? action.trim() : label,
+            ...(typeof order === "number" && Number.isFinite(order) ? { order } : {}),
+            ...(typeof applies === "string" && applies.trim() !== "" ? { appliesTo: applies.trim() } : {}),
+        };
+    })
+        .sort((a, b) => (a.order ?? Infinity) - (b.order ?? Infinity) || a.label.localeCompare(b.label));
+}
+/**
+ * WHETHER A RULE APPLIES TO A RECORD: one that says nothing of what it
+ * applies to applies to every record; one that names a kind (its name, or
+ * its plural) to that kind's; anything else is read as a condition in the
+ * rule language with the record as its subject — a mistake applies to nothing.
+ */
+export function policyApplies(policy, record, graph, schema, today) {
+    const said = policy.appliesTo;
+    if (said === undefined)
+        return true;
+    const words = said.toLowerCase();
+    if (schema.tryDefinition(said))
+        return said === record.kind;
+    const names = (kind) => [pluralOf(schema, kind).toLowerCase(), nounOf(schema.tryDefinition(kind), kind).toLowerCase()];
+    if (names(record.kind).includes(words))
+        return true;
+    if (schema.definitions.some((one) => names(one.kind).includes(words)))
+        return false;
+    try {
+        const value = evaluateExpr(parseExpr(said), { graph, subject: record, kinds: shapesFor(schema), ...(today ? { today } : {}) });
+        return value instanceof NodeSet ? value.nodes.length > 0 : Array.isArray(value) ? value.length > 0 : value === true;
+    }
+    catch (error) {
+        if (error instanceof ExprEvalError || error instanceof ExprSyntaxError)
+            return false;
+        throw error;
+    }
+}
+/** Whether a rule says to keep what it applies to: its words begin "keep", "never archive" or "do not archive". */
+export const keeps = (policy) => /^(keep|never archive|do not archive|don['’]t archive)\b/i.test(policy.action);
+/**
+ * THE RULES, AS AN AGENT STEP IS HANDED THEM: verbatim, numbered in order,
+ * under a line that says they are the app's own — or "" when none stand.
+ */
+export function policyInstruction(policies) {
+    if (policies.length === 0)
+        return "";
+    const lines = policies.map((policy, at) => `${at + 1}. ${policy.action === policy.label ? policy.action : `${policy.label}: ${policy.action}`}${policy.appliesTo ? ` (applies to ${policy.appliesTo})` : ""}`);
+    return `\n\nFollow these rules, which the app's own people keep, in order; an earlier one wins:\n${lines.join("\n")}`;
+}
+/** What the checker says of `follows`: a kind the app has, or a finding with the fix. */
+export function followsFindings(follows, world) {
+    if (follows === undefined || world.kinds.has(follows))
+        return [];
+    const kinds = [...world.kinds.keys()];
+    return [
+        {
+            code: "workflow-follows-unknown",
+            severity: "error",
+            path: "follows",
+            message: `The workflow follows the rules kept as "${follows}" records, and "${follows}" is not a kind of this app.`,
+            fix: `Name the kind its rules are kept as: ${kinds.map((kind) => `"${kind}"`).join(", ") || "none"}.`,
+        },
+    ];
+}
+//# sourceMappingURL=policies.js.map

package/dist/workflows/policies.js.map

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

package/dist/workflows/resolve.d.ts

@@ -0,0 +1,55 @@
+import type { GraviewApp } from "../app.js";
+import type { AnySchema } from "../schema/schema.js";
+import type { Author } from "../ops/types.js";
+import type { AppWorkflows, WorkflowApproval, WorkflowDeclaration, WorkflowStep, WorkflowTrigger } from "../workflow-shape.js";
+import { type WorkflowWorld } from "./world.js";
+/** A workflow as `workflowsOf` resolves it. */
+export interface ResolvedWorkflow {
+    readonly name: string;
+    readonly title: string;
+    readonly when: readonly WorkflowTrigger[];
+    readonly status: "active" | "paused";
+    /** What its changes become when a step says nothing of its own. */
+    readonly approve: WorkflowApproval;
+    readonly steps: readonly WorkflowStep[];
+    /** "Every Sunday at 6 PM: fill out next week's events". */
+    readonly words: string;
+    /** The kinds its steps read and may write. */
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+    /** Whether a step writes to another system through a connection: what makes "ask" the default. */
+    readonly sendsOut: boolean;
+    /** Dreaming: the framework's, not the declaration's. */
+    readonly builtIn?: true;
+}
+/** The built-in workflow's name. */
+export declare const DREAMING = "dreaming";
+/** The automated author a workflow runs as: `workflow:<name>`, named by its title. */
+export declare const workflowAuthor: (workflow: {
+    readonly name: string;
+    readonly title: string;
+}) => Author;
+/** What a workflow's steps read and write, and whether one writes through a connection. */
+export declare function workflowReach(steps: readonly WorkflowStep[], world: WorkflowWorld): {
+    reads: string[];
+    writes: string[];
+    sendsOut: boolean;
+};
+/** One declared workflow, resolved against what the app may name. */
+export declare function resolveWorkflow(name: string, declared: WorkflowDeclaration, world: WorkflowWorld): ResolvedWorkflow;
+/**
+ * AN APP'S WORKFLOWS AS DECLARED: `defineApp({ workflows })`'s, or the
+ * document's an app was compiled from (`documentOf`) — read there rather
+ * than copied onto the compiled app, so a page that draws the app carries
+ * none of them.
+ */
+export declare const declaredWorkflows: (app: object) => AppWorkflows | undefined;
+/** Dreaming, as a workflow: every night at three, suggesting what it is not sure of. */
+export declare const dreamingWorkflow: () => ResolvedWorkflow;
+/**
+ * AN APP'S WORKFLOWS, RESOLVED, in the order declared, with dreaming last
+ * (`builtIn: true`) unless the app declares a workflow of that name or the
+ * actor has nothing it may tidy.
+ */
+export declare function workflowsOf<S extends AnySchema>(app: GraviewApp<S>): ResolvedWorkflow[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/workflows/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/workflows/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE/H,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAcpE,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;CACzB;AAED,oCAAoC;AACpC,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC,sFAAsF;AACtF,eAAO,MAAM,cAAc,GAAI,UAAU;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MAAsG,CAAC;AAEpM,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAU5I;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAInH;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,YAAY,GAAG,SAAwH,CAAC;AAKxL,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,QAAO,gBAGnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,gBAAgB,EAAE,CAOvF"}

package/dist/workflows/resolve.js

@@ -0,0 +1,57 @@
+import { documentOf } from "../document/remembered.js";
+import { stepKindOf } from "./steps.js";
+import { workflowWorldOfApp } from "./world.js";
+import { workflowWords } from "./words.js";
+/** The built-in workflow's name. */
+export const DREAMING = "dreaming";
+/** The automated author a workflow runs as: `workflow:<name>`, named by its title. */
+export const workflowAuthor = (workflow) => ({ kind: "system", id: `workflow:${workflow.name}`, name: workflow.title, automated: true });
+/** What a workflow's steps read and write, and whether one writes through a connection. */
+export function workflowReach(steps, world) {
+    const reads = new Set();
+    const writes = new Set();
+    for (const step of steps) {
+        const touched = stepKindOf(step)?.touches(step, world);
+        for (const kind of touched?.reads ?? [])
+            reads.add(kind);
+        for (const kind of touched?.writes ?? [])
+            writes.add(kind);
+    }
+    const sent = [...world.connections.values()].some((connection) => connection.writes && connection.kinds.some((kind) => writes.has(kind)));
+    return { reads: [...reads], writes: [...writes], sendsOut: sent };
+}
+/** One declared workflow, resolved against what the app may name. */
+export function resolveWorkflow(name, declared, world) {
+    const reach = workflowReach(declared.steps ?? [], world);
+    const resolved = { name, title: declared.title, when: declared.when ?? [], status: declared.status ?? "active", approve: declared.approve ?? (reach.sendsOut ? "ask" : "apply"), steps: declared.steps ?? [] };
+    return { ...resolved, words: workflowWords(resolved, world.noun), ...reach };
+}
+/**
+ * AN APP'S WORKFLOWS AS DECLARED: `defineApp({ workflows })`'s, or the
+ * document's an app was compiled from (`documentOf`) — read there rather
+ * than copied onto the compiled app, so a page that draws the app carries
+ * none of them.
+ */
+export const declaredWorkflows = (app) => app.workflows ?? documentOf(app)?.workflows;
+/** Whether the app's own actor has anything it may tidy: some kind that does not say `tidying: "never"`. */
+const actorTidies = (schema) => schema.kinds.some((kind) => schema.tryDefinition(kind)?.tidying !== "never");
+/** Dreaming, as a workflow: every night at three, suggesting what it is not sure of. */
+export const dreamingWorkflow = () => {
+    const workflow = { name: DREAMING, title: "Tidy the app overnight", when: [{ every: "day 03:00" }], status: "active", approve: "suggest", steps: [] };
+    return { ...workflow, words: workflowWords(workflow), reads: [], writes: [], sendsOut: false, builtIn: true };
+};
+/**
+ * AN APP'S WORKFLOWS, RESOLVED, in the order declared, with dreaming last
+ * (`builtIn: true`) unless the app declares a workflow of that name or the
+ * actor has nothing it may tidy.
+ */
+export function workflowsOf(app) {
+    const workflows = declaredWorkflows(app);
+    const declared = Object.entries(workflows ?? {});
+    const world = declared.length > 0 ? workflowWorldOfApp(app) : undefined;
+    const out = declared.map(([name, workflow]) => resolveWorkflow(name, workflow, world));
+    if (!workflows?.[DREAMING] && actorTidies(app.schema))
+        out.push(dreamingWorkflow());
+    return out;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/workflows/resolve.js.map

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

package/dist/workflows/schedule.d.ts

@@ -0,0 +1,28 @@
+/** A schedule as a table: which minutes, hours, days of the month, months (1–12) and weekdays (0 Sunday – 6). */
+export interface Schedule {
+    readonly minutes: ReadonlySet<number>;
+    readonly hours: ReadonlySet<number>;
+    readonly days: ReadonlySet<number>;
+    readonly months: ReadonlySet<number>;
+    readonly weekdays: ReadonlySet<number>;
+    /** Whether days and weekdays were each narrowed: cron runs on either, when both are. */
+    readonly daysSaid: boolean;
+    readonly weekdaysSaid: boolean;
+}
+/** What the words a schedule takes are, said when one cannot be read. */
+export declare 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 schedule in words, or a sentence saying what could not be read. */
+export declare function scheduleOfWords(words: string): Schedule | string;
+/** A schedule in five-field cron, or a sentence saying what could not be read. */
+export declare function scheduleOfCron(cron: string): Schedule | string;
+/** A clock trigger's schedule, or a sentence; undefined for a trigger that is no clock. */
+export declare function scheduleOf(trigger: {
+    readonly every?: string;
+    readonly cron?: string;
+}): Schedule | string | undefined;
+/** 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 declare function scheduleWords(trigger: {
+    readonly every?: string;
+    readonly cron?: string;
+}): string;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/workflows/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/workflows/schedule.ts"],"names":[],"mappings":"AAaA,iHAAiH;AACjH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAMD,yEAAyE;AACzE,eAAO,MAAM,cAAc,mJAAqI,CAAC;AAejK,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CA+BhE;AAgCD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAU9D;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAItH;AAUD,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkBlG"}

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