@graview/core 0.1.61 → 0.1.63

package/dist/workflows/generate.js

@@ -0,0 +1,165 @@
+import { dayOfMoment, isoToday, ISO_DAY } from "../days.js";
+import { evaluateExpr, NodeSet } from "../document/expr/evaluate.js";
+import { parseExpr } from "../document/expr/parse.js";
+import { shapesOfSchema } from "../document/rules.js";
+import { startOfWeekOf } from "../document/expr/when.js";
+import { isRepeat, occurrences, repeatKey, WEEKDAYS } from "../repeat.js";
+import { weekdaysOf } from "../sync/recurrence.js";
+import { addDays, weekdayOf } from "../wall-time.js";
+import { keyedId } from "./values.js";
+import { DEFAULT_GENERATE_KEY, MOST_GENERATED, MOST_WINDOW_DAYS, WINDOW_WORDS, windowWordsProblem } from "./generate-words.js";
+/*
+ * WHAT A GENERATE STEP WANTS MADE (Roadmap f-job-generate-from-pattern),
+ * worked out and never kept: the days of its window, every day a source
+ * record's date falls on in them — a date, a date that repeats
+ * (`repeat.ts`: skipped days are not among them), a set of weekdays — and
+ * for each, the record it wants: its key, the id that key gives it, and
+ * its fields as `set` reads them on the source. Running it — making what
+ * is not there yet, changing what the source changed and leaving what a
+ * person changed — is `@graview/tools/workflows`'.
+ */
+/** The days a window covers, from and to (both included), on a day and the app's clock. A week starts on Monday. */
+export function windowDays(window, at) {
+    const { today } = at;
+    if (typeof window === "string") {
+        const said = window.trim().toLowerCase();
+        const problem = windowWordsProblem(said);
+        if (problem)
+            throw new Error(problem);
+        const monday = startOfWeekOf({ day: today }, "mon");
+        if (said === "today")
+            return { from: today, to: today };
+        if (said === "tomorrow")
+            return { from: addDays(today, 1), to: addDays(today, 1) };
+        if (said === "this week")
+            return { from: monday, to: addDays(monday, 6) };
+        if (said === "next week")
+            return { from: addDays(monday, 7), to: addDays(monday, 13) };
+        const days = Number(WINDOW_WORDS.exec(said)[1]);
+        return { from: today, to: addDays(today, days - 1) };
+    }
+    const day = (expr, end) => {
+        const value = at.evaluate ? at.evaluate(expr) : null;
+        const read = typeof value === "string" ? dayOfMoment(value, at.zone) : undefined;
+        if (!read)
+            throw new Error(`the window's ${end} (${expr}) is not a day`);
+        return read;
+    };
+    const from = day(window.from, "from");
+    const to = day(window.to, "to");
+    if (to < from)
+        throw new Error(`the window ends (${to}) before it begins (${from})`);
+    if (addDays(from, MOST_WINDOW_DAYS - 1) < to)
+        throw new Error(`the window is longer than ${MOST_WINDOW_DAYS} days`);
+    return { from, to };
+}
+/** The days a record's date falls on between two days: a date, a date that repeats, or a set of weekdays. Each as the record says it (a moment keeps its time of day). */
+export function datesIn(node, field, window, zone) {
+    const value = node[field];
+    const repeat = node[repeatKey(field)];
+    if (typeof value === "string" && isRepeat(repeat))
+        return occurrences(value, repeat, { from: window.from, to: window.to });
+    if (typeof value === "string") {
+        const day = dayOfMoment(value, zone);
+        if (day)
+            return day >= window.from && day <= window.to ? [value] : [];
+    }
+    const weekdays = weekdaysOf(value);
+    if (weekdays.length === 0)
+        return [];
+    const out = [];
+    for (let day = window.from; day <= window.to; day = addDays(day, 1))
+        if (weekdays.includes(WEEKDAYS[weekdayOf(day)]))
+            out.push(day);
+    return out;
+}
+const asValue = (value) => (value instanceof NodeSet ? value.nodes.map((node) => node.id) : value !== null && typeof value === "object" && !Array.isArray(value) && typeof value.id === "string" ? value.id : value);
+/** A key's `{field}` template read: `source`, `date` (the day), `kind`, or the source's own field. */
+function keyOf(template, node, kind, day) {
+    return template.replace(/\{([^{}|\s]+)(?:\s*\|[^{}]*)?\}/g, (_all, name) => {
+        if (name === "source" || name === "id")
+            return node.id;
+        if (name === "date")
+            return day;
+        if (name === "kind")
+            return kind;
+        const value = node[name];
+        return value === undefined || value === null ? "" : typeof value === "string" ? value : JSON.stringify(value);
+    });
+}
+/** WHAT A GENERATE STEP WANTS, on the graph as it stands: every record, in day order. */
+export function generateWants(step, reading) {
+    const zone = reading.timeZone ?? "UTC";
+    const today = reading.today ?? isoToday(zone, reading.now);
+    const now = new Date(reading.now).toISOString();
+    const kinds = shapesOfSchema(reading.schema);
+    const base = { graph: reading.graph, kinds, today, now, timeZone: zone, ...(reading.locale ? { locale: reading.locale } : {}) };
+    const parsed = new Map();
+    const parse = (source) => {
+        let expr = parsed.get(source);
+        if (!expr)
+            parsed.set(source, (expr = parseExpr(source)));
+        return expr;
+    };
+    const problems = [];
+    let window;
+    try {
+        window = windowDays(step.window, { today, zone, evaluate: (expr) => evaluateExpr(parse(expr), { ...base, subject: null }) });
+    }
+    catch (e) {
+        return { from: today, to: today, wanted: [], problems: [{ why: e instanceof Error ? e.message : String(e) }] };
+    }
+    const wanted = [];
+    const seen = new Set();
+    const template = step.key ?? DEFAULT_GENERATE_KEY;
+    for (const from of step.from) {
+        if (!reading.schema.tryDefinition(from.kind)) {
+            problems.push({ why: `"${from.kind}" is not a kind of this app` });
+            continue;
+        }
+        for (const node of reading.graph.nodesOfKind(from.kind)) {
+            try {
+                if (from.where !== undefined && evaluateExpr(parse(from.where), { ...base, subject: node }) !== true)
+                    continue;
+                for (const date of datesIn(node, from.dates, window, zone)) {
+                    const day = ISO_DAY.test(date) ? date : (dayOfMoment(date, zone) ?? date.slice(0, 10));
+                    const key = keyOf(template, node, from.kind, day);
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    const values = {};
+                    for (const [field, spec] of Object.entries(step.set ?? {}))
+                        values[field] = valueOf(spec, { node, date, today, now, read: (expr) => evaluateExpr(parse(expr), { ...base, subject: node, bindings: { date, source: node.id } }) });
+                    wanted.push({ source: node.id, sourceKind: from.kind, date, day, key, id: keyedId(step.generate, reading.workflow, key), values });
+                    if (wanted.length >= MOST_GENERATED) {
+                        problems.push({ why: `it wants more than ${MOST_GENERATED} records in one run; the rest wait for the next` });
+                        return { ...window, wanted: sorted(wanted), problems };
+                    }
+                }
+            }
+            catch (e) {
+                problems.push({ source: node.id, why: e instanceof Error ? e.message : String(e) });
+            }
+        }
+    }
+    return { ...window, wanted: sorted(wanted), problems };
+}
+const sorted = (wanted) => wanted.sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
+/** A value `set` gives, read on the source: `$date`, `$source`, `$today`, `$now`, `{ expr }`, or itself. */
+function valueOf(spec, at) {
+    if (typeof spec === "string") {
+        if (spec === "$date")
+            return at.date;
+        if (spec === "$source" || spec === "$subject")
+            return at.node.id;
+        if (spec === "$today")
+            return at.today;
+        if (spec === "$now")
+            return at.now;
+        return spec;
+    }
+    if (spec !== null && typeof spec === "object" && !Array.isArray(spec))
+        return asValue(at.read(spec.expr));
+    return spec;
+}
+//# sourceMappingURL=generate.js.map

package/dist/workflows/generate.js.map

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

package/dist/workflows/judging.d.ts

@@ -0,0 +1,17 @@
+/** A workflow judged for an edit: what refuses it, what is said of it, and its line. */
+export interface WorkflowJudged {
+    readonly errors: readonly {
+        readonly code: string;
+        readonly path: string;
+        readonly message: string;
+        readonly fix: string;
+    }[];
+    readonly warnings: readonly string[];
+    /** "Every day at 3 AM, one step": how the edit says it. */
+    readonly said: string;
+}
+export interface WorkflowJudging {
+    judge?: (name: string, workflow: unknown, document: unknown) => WorkflowJudged;
+}
+export declare const WORKFLOW_JUDGING: WorkflowJudging;
+//# sourceMappingURL=judging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"judging.d.ts","sourceRoot":"","sources":["../../src/workflows/judging.ts"],"names":[],"mappings":"AAUA,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7H,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,cAAc,CAAC;CAChF;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAoI,CAAC"}

package/dist/workflows/judging.js

@@ -0,0 +1,11 @@
+/*
+ * WHERE AN EDIT FINDS THE WORKFLOW CHECKER. `editDocument` is on a page,
+ * and the checker — the shapes of every step kind, the schedule reader, the
+ * rule reader — is not: it fills this slot as it loads
+ * (`./findings.ts`, which `@graview/core/check` and
+ * `@graview/core/workflows` both bring), and an edit asks it when it is
+ * there. Without it, an edit keeps a workflow that is shaped as one and
+ * leaves the rest to `graview check`. One slot per realm, as `VOTING` is.
+ */
+export const WORKFLOW_JUDGING = (globalThis[Symbol.for("@graview/core:workflow-judging")] ??= {});
+//# sourceMappingURL=judging.js.map

package/dist/workflows/judging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judging.js","sourceRoot":"","sources":["../../src/workflows/judging.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,MAAM,CAAC,MAAM,gBAAgB,GAAoB,CAAE,UAA0D,CAAC,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/workflows/next.d.ts

@@ -0,0 +1,18 @@
+import { type Schedule } from "./schedule.js";
+/**
+ * WHEN A SCHEDULE NEXT RUNS, after a moment: on the wall clock of `zone`
+ * (the runtime's when unsaid), DST-correct. Undefined when it never does
+ * in the next five years ("month 31" in a schedule that only says February).
+ */
+export declare function nextOf(schedule: Schedule, after: Date | number, zone?: string): Date | undefined;
+/**
+ * WHEN A WORKFLOW NEXT RUNS ON ITS CLOCK, after a moment: the earliest of
+ * its `every` and `cron` triggers, on the wall clock of `zone` (the brand's
+ * `timeZone`). Undefined for one that is paused, has no clock, or whose
+ * schedules do not read.
+ */
+export declare function nextRunAt(workflow: {
+    readonly when: readonly object[];
+    readonly status?: string;
+}, after: Date | number, zone?: string): Date | undefined;
+//# sourceMappingURL=next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/workflows/next.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAiC1D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAchG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAUzJ"}

package/dist/workflows/next.js

@@ -0,0 +1,75 @@
+import { instantIn, wallIn } from "../days.js";
+import { scheduleOf } from "./schedule.js";
+/*
+ * WHEN A SCHEDULE NEXT RUNS, as arithmetic on the wall clock: apart from
+ * reading one (`./schedule.ts`), which the checker needs, so `graview
+ * check` and a host's worker carry none of this. On `@graview/core/workflows`.
+ */
+const nextDay = (day) => new Date(Date.UTC(+day.slice(0, 4), +day.slice(5, 7) - 1, +day.slice(8, 10) + 1)).toISOString().slice(0, 10);
+const weekdayOf = (day) => new Date(`${day}T00:00:00Z`).getUTCDay();
+function dayRuns(schedule, day) {
+    if (!schedule.months.has(+day.slice(5, 7)))
+        return false;
+    const onDay = schedule.days.has(+day.slice(8, 10));
+    const onWeekday = schedule.weekdays.has(weekdayOf(day));
+    // Cron's rule: narrowed both ways, either runs it.
+    return schedule.daysSaid && schedule.weekdaysSaid ? onDay || onWeekday : onDay && onWeekday;
+}
+/** The instant a wall time on a day runs: a time the clock skips that day runs the moment the clock jumps past it. */
+function runsAt(day, minutes, zone) {
+    const instant = instantIn(day, minutes, zone);
+    const there = wallIn(instant, zone);
+    if (there.day === day && there.minutes === minutes)
+        return instant;
+    // Skipped: the first instant on the wall at or after it.
+    for (let later = minutes + 1; later < minutes + 180 && later < 24 * 60; later++) {
+        const at = instantIn(day, later, zone);
+        const wall = wallIn(at, zone);
+        if (wall.day === day && wall.minutes === later)
+            return at;
+    }
+    return instant;
+}
+/**
+ * WHEN A SCHEDULE NEXT RUNS, after a moment: on the wall clock of `zone`
+ * (the runtime's when unsaid), DST-correct. Undefined when it never does
+ * in the next five years ("month 31" in a schedule that only says February).
+ */
+export function nextOf(schedule, after, zone) {
+    const from = typeof after === "number" ? after : after.getTime();
+    const hours = [...schedule.hours].sort((a, b) => a - b);
+    const minutes = [...schedule.minutes].sort((a, b) => a - b);
+    let day = wallIn(from, zone).day;
+    for (let i = 0; i < 366 * 5; i++, day = nextDay(day)) {
+        if (!dayRuns(schedule, day))
+            continue;
+        for (const hour of hours)
+            for (const minute of minutes) {
+                const at = runsAt(day, hour * 60 + minute, zone);
+                if (at > from)
+                    return new Date(at);
+            }
+    }
+    return undefined;
+}
+/**
+ * WHEN A WORKFLOW NEXT RUNS ON ITS CLOCK, after a moment: the earliest of
+ * its `every` and `cron` triggers, on the wall clock of `zone` (the brand's
+ * `timeZone`). Undefined for one that is paused, has no clock, or whose
+ * schedules do not read.
+ */
+export function nextRunAt(workflow, after, zone) {
+    if (workflow.status === "paused")
+        return undefined;
+    let soonest;
+    for (const trigger of workflow.when) {
+        const schedule = scheduleOf(trigger);
+        if (schedule === undefined || typeof schedule === "string")
+            continue;
+        const next = nextOf(schedule, after, zone);
+        if (next && (!soonest || next < soonest))
+            soonest = next;
+    }
+    return soonest;
+}
+//# sourceMappingURL=next.js.map

package/dist/workflows/next.js.map

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

package/dist/workflows/on-the-map.d.ts

@@ -0,0 +1,70 @@
+import type { GraviewApp } from "../app.js";
+import type { AppWorkflows } from "../workflow-shape.js";
+import type { AnySchema } from "../schema/schema.js";
+/** A workflow as the Scene draws it: its name, title and status, and the kinds it reads and writes. */
+export interface MapWorkflow {
+    readonly name: string;
+    readonly title: string;
+    readonly status: "active" | "paused";
+    /** Kinds its steps read, and what starts it on a change, in the order they say them. */
+    readonly reads: readonly string[];
+    /** Kinds its steps may write. */
+    readonly writes: readonly string[];
+}
+/** An act as the map reads it: the kinds it acts on and the kinds it makes. */
+export interface MapAct {
+    readonly name: string;
+    readonly subject?: {
+        readonly kinds: readonly string[] | "*";
+    } | undefined;
+    readonly creates?: readonly string[] | undefined;
+}
+/**
+ * Every workflow the app declares (`declaredWorkflows(app)`, or a
+ * compiled app's document's `workflows`), as the Scene draws it, in
+ * declared order, given every act the app has (`store.allMutations()`: the derived
+ * ones too). Dreaming, built in and at work on every district, is not drawn.
+ */
+export declare function workflowsOnTheMap<S extends AnySchema>(app: Pick<GraviewApp<S>, "schema">, workflows: AppWorkflows | undefined, acts: readonly MapAct[]): readonly MapWorkflow[];
+/** A plot as a spot is found beside it: its corner cell and its side, in lattice cells. */
+export interface SpotPlot {
+    readonly col: number;
+    readonly row: number;
+    readonly side: number;
+}
+/** Where a workflow stands on the lattice: the kind it stands beside, and the point, in lattice cells. */
+export interface WorkflowSpot {
+    readonly name: string;
+    /** The district it stands beside: the first kind it writes that is on the map, else the first it reads. */
+    readonly beside: string;
+    readonly col: number;
+    readonly row: number;
+}
+/**
+ * WHERE EACH WORKFLOW STANDS: in the street along the right edge of the
+ * district it writes first — a cell out from the curb, down the edge, a
+ * cell apart for a second and a third beside the same district — so it
+ * reads as at work on that district and never stands on any district's
+ * ground. One that touches no kind on the map is not placed.
+ */
+export declare function workflowSpots(workflows: readonly MapWorkflow[], plots: ReadonlyMap<string, SpotPlot>): readonly WorkflowSpot[];
+/** A run as `lastRunWords` reads it: `WorkflowRun` from `@graview/tools/workflows`, or any record with these. */
+export interface RunSaid {
+    readonly finished: string;
+    readonly outcome: "ok" | "nothing-new" | "partial" | "held" | "failed";
+    readonly dry: boolean;
+    readonly made: readonly string[];
+    readonly changed: readonly string[];
+    readonly archived: readonly string[];
+    readonly suggested: readonly string[];
+}
+/** "just now", "5 minutes ago", "2 hours ago", "yesterday", "3 days ago": how long before `now` a moment was. */
+export declare function agoWords(at: string | number | Date, now?: string | number | Date): string;
+/**
+ * HOW THE LAST RUN WENT, in words a person reads under a workflow on the
+ * map: "Last ran 2 hours ago: made 28, changed 3", "Last ran yesterday:
+ * nothing new", "Last ran 5 minutes ago, as a dry run: would make 4",
+ * "Last ran 3 days ago and failed". With no run, "Has not run yet".
+ */
+export declare function lastRunWords(run: RunSaid | undefined, now?: string | number | Date): string;
+//# sourceMappingURL=on-the-map.d.ts.map

package/dist/workflows/on-the-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-the-map.d.ts","sourceRoot":"","sources":["../../src/workflows/on-the-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAqBrD,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,+EAA+E;AAC/E,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAA;KAAE,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAClD;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,WAAW,EAAE,CAuB/K;AAED,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,0GAA0G;AAC1G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,YAAY,EAAE,CAY9H;AAED,iHAAiH;AACjH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,iHAAiH;AACjH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,MAAM,GAAG,MAAM,GAAG,IAAiB,GAAG,MAAM,CAQrG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,GAAE,MAAM,GAAG,MAAM,GAAG,IAAiB,GAAG,MAAM,CAcvG"}

package/dist/workflows/on-the-map.js

@@ -0,0 +1,94 @@
+import { subjectKindsOf } from "../mutations/derive-edits.js";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const strings = (value) => (typeof value === "string" ? [value] : Array.isArray(value) ? value.filter((one) => typeof one === "string") : []);
+/**
+ * Every workflow the app declares (`declaredWorkflows(app)`, or a
+ * compiled app's document's `workflows`), as the Scene draws it, in
+ * declared order, given every act the app has (`store.allMutations()`: the derived
+ * ones too). Dreaming, built in and at work on every district, is not drawn.
+ */
+export function workflowsOnTheMap(app, workflows, acts) {
+    const declared = Object.entries(workflows ?? {});
+    if (declared.length === 0)
+        return [];
+    const kinds = new Set(app.schema.kinds);
+    const byName = new Map(acts.map((act) => [act.name, act]));
+    const actKinds = (name) => {
+        const act = byName.get(name);
+        return act ? [...subjectKindsOf(app.schema, act), ...(act.creates ?? [])] : [];
+    };
+    return declared.map(([name, workflow]) => {
+        const reads = [];
+        const writes = [];
+        // What starts it on a change reads that kind: a workflow run when a grocery list is made is wired to grocery lists.
+        for (const trigger of (workflow.when ?? []))
+            reads.push(...strings(trigger["made"]), ...strings(trigger["changed"]));
+        for (const step of (workflow.steps ?? [])) {
+            const over = isRecord(step["over"]) ? strings(step["over"]["kind"]) : [];
+            const from = Array.isArray(step["from"]) ? step["from"].flatMap((source) => (isRecord(source) ? strings(source["kind"]) : [])) : [];
+            reads.push(...over, ...strings(step["reads"]), ...from, ...strings(step["archive"]), ...strings(step["classify"]));
+            writes.push(...[...strings(step["act"]), ...strings(step["acts"])].flatMap(actKinds), ...strings(step["generate"]), ...strings(step["archive"]), ...strings(step["classify"]));
+        }
+        const known = (list) => [...new Set(list)].filter((kind) => kinds.has(kind));
+        return { name, title: workflow.title, status: workflow.status === "paused" ? "paused" : "active", reads: known(reads), writes: known(writes) };
+    });
+}
+/**
+ * WHERE EACH WORKFLOW STANDS: in the street along the right edge of the
+ * district it writes first — a cell out from the curb, down the edge, a
+ * cell apart for a second and a third beside the same district — so it
+ * reads as at work on that district and never stands on any district's
+ * ground. One that touches no kind on the map is not placed.
+ */
+export function workflowSpots(workflows, plots) {
+    const taken = new Map();
+    const out = [];
+    for (const workflow of workflows) {
+        const beside = [...workflow.writes, ...workflow.reads].find((kind) => plots.has(kind));
+        if (beside === undefined)
+            continue;
+        const plot = plots.get(beside);
+        const k = taken.get(beside) ?? 0;
+        taken.set(beside, k + 1);
+        out.push({ name: workflow.name, beside, col: plot.col + plot.side + 1, row: plot.row + 0.5 + k });
+    }
+    return out;
+}
+/** "just now", "5 minutes ago", "2 hours ago", "yesterday", "3 days ago": how long before `now` a moment was. */
+export function agoWords(at, now = Date.now()) {
+    const minutes = Math.floor((new Date(now).getTime() - new Date(at).getTime()) / 60_000);
+    if (!Number.isFinite(minutes) || minutes < 1)
+        return "just now";
+    if (minutes < 60)
+        return minutes === 1 ? "a minute ago" : `${minutes} minutes ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return hours === 1 ? "an hour ago" : `${hours} hours ago`;
+    const days = Math.floor(hours / 24);
+    return days === 1 ? "yesterday" : `${days} days ago`;
+}
+/**
+ * HOW THE LAST RUN WENT, in words a person reads under a workflow on the
+ * map: "Last ran 2 hours ago: made 28, changed 3", "Last ran yesterday:
+ * nothing new", "Last ran 5 minutes ago, as a dry run: would make 4",
+ * "Last ran 3 days ago and failed". With no run, "Has not run yet".
+ */
+export function lastRunWords(run, now = Date.now()) {
+    if (!run)
+        return "Has not run yet";
+    const when = `Last ran ${agoWords(run.finished, now)}`;
+    if (run.outcome === "failed")
+        return `${when} and failed`;
+    if (run.outcome === "held")
+        return `${when}: held back`;
+    const counts = [
+        [run.made.length, run.dry ? "would make" : "made"],
+        [run.changed.length, run.dry ? "would change" : "changed"],
+        [run.archived.length, run.dry ? "would set aside" : "set aside"],
+        [run.suggested.length, run.dry ? "would suggest" : "suggested"],
+    ];
+    const said = counts.filter(([count]) => count > 0).map(([count, verb]) => `${verb} ${count}`);
+    const what = said.length > 0 ? said.join(", ") : "nothing new";
+    return `${when}${run.dry ? ", as a dry run" : ""}: ${what}${run.outcome === "partial" ? " (part of it did not run)" : ""}`;
+}
+//# sourceMappingURL=on-the-map.js.map

package/dist/workflows/on-the-map.js.map

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

package/dist/workflows/policies.d.ts

@@ -0,0 +1,39 @@
+import type { AnyGraphNode, GraphReader } from "../graph/types.js";
+import type { AnySchema } from "../schema/schema.js";
+import type { WorkflowFinding } from "./steps.js";
+import type { WorkflowWorld } from "./world.js";
+/** One rule a workflow follows: the record it is, its words, its place, and what it applies to. */
+export interface WorkflowPolicy {
+    readonly id: string;
+    readonly label: string;
+    /** The rule, verbatim. */
+    readonly action: string;
+    readonly order?: number;
+    /** A kind's name or a rule-language condition; absent, every record. */
+    readonly appliesTo?: string;
+}
+/**
+ * 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 declare function policiesOf(graph: Pick<GraphReader, "getNode"> & {
+    nodesOfKind(kind: string): readonly AnyGraphNode[];
+}, schema: AnySchema, follows: string | undefined): WorkflowPolicy[];
+/**
+ * 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 declare function policyApplies(policy: WorkflowPolicy, record: AnyGraphNode, graph: GraphReader, schema: AnySchema, today?: string): boolean;
+/** Whether a rule says to keep what it applies to: its words begin "keep", "never archive" or "do not archive". */
+export declare const keeps: (policy: WorkflowPolicy) => boolean;
+/**
+ * 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 declare function policyInstruction(policies: readonly WorkflowPolicy[]): string;
+/** What the checker says of `follows`: a kind the app has, or a finding with the fix. */
+export declare function followsFindings(follows: string | undefined, world: WorkflowWorld): WorkflowFinding[];
+//# sourceMappingURL=policies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../src/workflows/policies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyBhD,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAYD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAA;CAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,EAAE,CAqBzL;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAe1I;AAED,mHAAmH;AACnH,eAAO,MAAM,KAAK,GAAI,QAAQ,cAAc,KAAG,OAAyF,CAAC;AAEzI;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAI7E;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,eAAe,EAAE,CAYpG"}