@graview/core 0.1.62 → 0.1.64

package/dist/workflows/triggered.js

@@ -0,0 +1,69 @@
+import { shapesFor } from "../document/computed-values.js";
+import { evaluateExpr, ExprEvalError } from "../document/expr/evaluate.js";
+import { parseExpr } from "../document/expr/parse.js";
+import { matchSubscriptions } from "../subscriptions.js";
+import { workflowAuthor } from "./resolve.js";
+/**
+ * Which workflow's run made an op: its `lineage.run` (`workflow:<name>:<started>`),
+ * else its author (`workflow:<name>`). Undefined for an op a person, a seat
+ * or anything else made.
+ */
+export function workflowOrigin(op) {
+    const run = op.lineage?.run;
+    const fromRun = typeof run === "string" ? /^workflow:([^:]+):/.exec(run) : null;
+    if (fromRun)
+        return { workflow: fromRun[1], run: run };
+    const fromAuthor = typeof op.author?.id === "string" ? /^workflow:([^:]+)$/.exec(op.author.id) : null;
+    return fromAuthor ? { workflow: fromAuthor[1] } : undefined;
+}
+/** The ids an op made or changed. */
+const touched = (op) => op.primitives.flatMap((primitive) => (primitive.op === "add-node" ? [primitive.node.id] : "id" in primitive && typeof primitive.id === "string" ? [primitive.id] : []));
+const holds = (where, node, store) => {
+    if (where === undefined)
+        return true;
+    if (!node)
+        return false;
+    try {
+        const value = evaluateExpr(parseExpr(where), { graph: store.graph, subject: node, kinds: shapesFor(store.schema) });
+        return value === true;
+    }
+    catch (error) {
+        if (error instanceof ExprEvalError)
+            return false;
+        return false;
+    }
+};
+/** The triggers of a workflow a commit fires, in the order declared. */
+export function triggeredBy(workflow, commit, given) {
+    const store = given;
+    if ("synced" in commit)
+        return workflow.when.filter((trigger) => "synced" in trigger && trigger.synced === commit.synced).map((trigger) => ({ trigger, records: [] }));
+    const who = { ...workflowAuthor(workflow) };
+    const fired = [];
+    workflow.when.forEach((trigger, at) => {
+        if (!("made" in trigger) && !("changed" in trigger))
+            return;
+        const kind = "made" in trigger ? trigger.made : trigger.changed;
+        const subscription = { id: `workflow:${workflow.name}:${at}`, who, app: "", when: "made" in trigger ? { on: "created", kind } : { on: "changed", kind }, at: "" };
+        const records = new Set();
+        for (const match of matchSubscriptions(given, commit.ops, [subscription])) {
+            for (const record of match.records) {
+                if (record.kind !== kind)
+                    continue;
+                if ("made" in trigger ? record.change !== "created" : record.change !== "changed")
+                    continue;
+                if ("changed" in trigger && trigger.fields?.length && !(record.fields ?? []).some((field) => trigger.fields.includes(field.field)))
+                    continue;
+                if (!holds(trigger.where, store.graph.getNode(record.id), store))
+                    continue;
+                records.add(record.id);
+            }
+        }
+        if (records.size === 0)
+            return;
+        const by = commit.ops.filter((op) => touched(op).some((id) => records.has(id))).map(workflowOrigin).find((origin) => origin !== undefined && origin.workflow !== workflow.name);
+        fired.push({ trigger, records: [...records], ...(by ? { by } : {}) });
+    });
+    return fired;
+}
+//# sourceMappingURL=triggered.js.map

package/dist/workflows/triggered.js.map

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

package/dist/workflows/values.d.ts

@@ -0,0 +1,28 @@
+import type { AnyGraphNode } from "../graph/types.js";
+import type { Principal } from "../permissions/types.js";
+import type { AnySchema } from "../schema/schema.js";
+import type { Store } from "../store.js";
+import type { WorkflowDeclaration, WorkflowOver, WorkflowValue } from "../workflow-shape.js";
+/** The ids of the records a step runs over, as `principal` sees them: those of the kind `where` holds of, at most `limit`, in the order they stand. */
+export declare function recordsOver<S extends AnySchema>(store: Store<S>, over: WorkflowOver, principal: Principal): string[];
+/**
+ * A STEP'S VALUE, as the act is handed it: `{ expr }` read with the record
+ * as its subject; `$subject` the record's id; `$now` and `$today` the
+ * run's moment and day; `$$…` a literal "$…"; anything else as written.
+ */
+export declare function workflowValue<S extends AnySchema>(value: WorkflowValue, record: AnyGraphNode | undefined, store: Store<S>, now: {
+    readonly at: string;
+    readonly today: string;
+}): unknown;
+/** A key template read on what a step has: "{id}:{date}" → "task:7f3:2026-11-02". A name it has no value for reads as nothing. */
+export declare function workflowKey(template: string, values: Readonly<Record<string, unknown>>): string;
+/** A workflow as declared, hashed — all but whether it is paused, which changes when it runs, not what it does. */
+export declare function workflowSpecHash(declared: WorkflowDeclaration): string;
+/**
+ * THE ID A KEYED RECORD IS MADE UNDER (Roadmap f-job-idempotency):
+ * `<prefix>:wf.<workflow>.<key>` — the prefix the kind's ids carry, the
+ * workflow's name and the key slugged — asked for as a client asks for an
+ * id, so the store itself refuses a second record of the same key.
+ */
+export declare const keyedId: (prefix: string, workflow: string, key: string) => string;
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/workflows/values.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU7F,uJAAuJ;AACvJ,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAGpH;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAYzL;AAED,kIAAkI;AAClI,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAK/F;AAED,mHAAmH;AACnH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAGtE;AAQD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,KAAK,MAAM,KAAG,MAAoD,CAAC"}

package/dist/workflows/values.js

@@ -0,0 +1,75 @@
+import { canonicalize } from "../document/canonical.js";
+import { shapesFor } from "../document/computed-values.js";
+import { evaluateExpr, NodeSet } from "../document/expr/evaluate.js";
+import { parseExpr } from "../document/expr/parse.js";
+import { sha256Hex } from "../integrity.js";
+import { answerJob } from "../jobs.js";
+/*
+ * WHAT A STEP READS, worked out as a runner needs it: the records `over`
+ * picks, as the run's author sees them; the value a step hands an act,
+ * read on the record it is over, as an act's own `{ expr }` values are;
+ * the key of what it makes; and the hash of a workflow as declared, which
+ * says whether the next run is the first after a change.
+ */
+/** The ids of the records a step runs over, as `principal` sees them: those of the kind `where` holds of, at most `limit`, in the order they stand. */
+export function recordsOver(store, over, principal) {
+    const ids = answerJob(store, { kind: over.kind, ...(over.where !== undefined ? { where: over.where } : {}) }, principal).ids;
+    return over.limit === undefined ? [...ids] : ids.slice(0, over.limit);
+}
+/** A value the language gives, as an act's argument takes it: a record as its id, a set as its ids. */
+const asArgument = (value) => {
+    if (value instanceof NodeSet)
+        return value.nodes.map((node) => node.id);
+    if (Array.isArray(value))
+        return value.map((one) => asArgument(one));
+    if (value !== null && typeof value === "object")
+        return value.id;
+    return value;
+};
+/**
+ * A STEP'S VALUE, as the act is handed it: `{ expr }` read with the record
+ * as its subject; `$subject` the record's id; `$now` and `$today` the
+ * run's moment and day; `$$…` a literal "$…"; anything else as written.
+ */
+export function workflowValue(value, record, store, now) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value) && "expr" in value) {
+        const any = store;
+        return asArgument(evaluateExpr(parseExpr(value.expr), { graph: any.graph, subject: record ?? null, kinds: shapesFor(any.schema), today: now.today, ...(record ? { bindings: { subject: record } } : {}) }));
+    }
+    if (typeof value === "string") {
+        if (value.startsWith("$$"))
+            return value.slice(1);
+        if (value === "$subject")
+            return record?.id;
+        if (value === "$now")
+            return now.at;
+        if (value === "$today")
+            return now.today;
+    }
+    return value;
+}
+/** A key template read on what a step has: "{id}:{date}" → "task:7f3:2026-11-02". A name it has no value for reads as nothing. */
+export function workflowKey(template, values) {
+    return template.replace(/\{([^{}|\s]+)(?:\s*\|[^{}]*)?\}/g, (_, name) => {
+        const value = values[name];
+        return value === undefined || value === null ? "" : typeof value === "object" ? JSON.stringify(value) : String(value);
+    });
+}
+/** A workflow as declared, hashed — all but whether it is paused, which changes when it runs, not what it does. */
+export function workflowSpecHash(declared) {
+    const { status: _status, ...rest } = declared;
+    return sha256Hex(canonicalize(rest));
+}
+/** A key as an id may carry it: letters, digits and a few marks; a long one, or one with none of those, by its hash. */
+const keySlug = (text) => {
+    const slug = text.toLowerCase().replace(/[^a-z0-9._:-]+/g, "-").replace(/^-+|-+$/g, "");
+    return slug.length > 0 && slug.length <= 120 ? slug : sha256Hex(text).slice(0, 24);
+};
+/**
+ * THE ID A KEYED RECORD IS MADE UNDER (Roadmap f-job-idempotency):
+ * `<prefix>:wf.<workflow>.<key>` — the prefix the kind's ids carry, the
+ * workflow's name and the key slugged — asked for as a client asks for an
+ * id, so the store itself refuses a second record of the same key.
+ */
+export const keyedId = (prefix, workflow, key) => `${prefix}:wf.${workflow}.${keySlug(key)}`;
+//# sourceMappingURL=values.js.map

package/dist/workflows/values.js.map

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

package/dist/workflows/words.d.ts

@@ -0,0 +1,10 @@
+import type { WorkflowTrigger } from "../workflow-shape.js";
+import { type KindNoun } from "./steps.js";
+/** One trigger in words: "every Sunday at 6 PM", "when a grocery list is made". */
+export declare function triggerWords(trigger: WorkflowTrigger, noun?: KindNoun): string;
+/** A workflow in a sentence. */
+export declare function workflowWords(workflow: {
+    readonly title: string;
+    readonly when: readonly WorkflowTrigger[];
+}, noun?: KindNoun): string;
+//# sourceMappingURL=words.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../../src/workflows/words.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAWrD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,GAAE,QAAmB,GAAG,MAAM,CAMxF;AAED,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,EAAE,IAAI,GAAE,QAAmB,GAAG,MAAM,CAKhJ"}

package/dist/workflows/words.js

@@ -0,0 +1,30 @@
+import { scheduleWords } from "./schedule.js";
+import { withArticle } from "../schema/define-node.js";
+import { kindNoun } from "./steps.js";
+/*
+ * A WORKFLOW IN A SENTENCE: what starts it, then what it does — "Every
+ * Sunday at 6 PM, and when a grocery list is made: fill out next week's
+ * events". Each kind by its noun: the declaration's, where the caller
+ * hands it (`noun`), else its name read as words.
+ */
+const listed = (said) => (said.length <= 2 ? said.join(" and ") : `${said.slice(0, -1).join(", ")} and ${said.at(-1)}`);
+/** One trigger in words: "every Sunday at 6 PM", "when a grocery list is made". */
+export function triggerWords(trigger, noun = kindNoun) {
+    if ("every" in trigger || "cron" in trigger)
+        return scheduleWords(trigger);
+    if ("made" in trigger)
+        return `when ${withArticle(noun(trigger.made))} is made${trigger.where ? ` where ${trigger.where}` : ""}`;
+    if ("changed" in trigger)
+        return `when ${withArticle(noun(trigger.changed))}${trigger.fields?.length ? `'s ${listed(trigger.fields)}` : ""} changes${trigger.where ? ` where ${trigger.where}` : ""}`;
+    if ("synced" in trigger)
+        return `when the connection “${trigger.synced}” finishes a pass`;
+    return "when somebody runs it";
+}
+/** A workflow in a sentence. */
+export function workflowWords(workflow, noun = kindNoun) {
+    const when = workflow.when.map((trigger) => triggerWords(trigger, noun));
+    const said = when.length <= 2 ? when.join(", and ") : `${when.slice(0, -1).join(", ")}, and ${when.at(-1)}`;
+    const start = said.charAt(0).toUpperCase() + said.slice(1);
+    return `${start}: ${workflow.title.charAt(0).toLowerCase()}${workflow.title.slice(1)}`;
+}
+//# sourceMappingURL=words.js.map

package/dist/workflows/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../src/workflows/words.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAErD;;;;;GAKG;AAEH,MAAM,MAAM,GAAG,CAAC,IAAuB,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEnJ,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,OAAwB,EAAE,OAAiB,QAAQ;IAC9E,IAAI,OAAO,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3E,IAAI,MAAM,IAAI,OAAO;QAAE,OAAO,QAAQ,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACjI,IAAI,SAAS,IAAI,OAAO;QAAE,OAAO,QAAQ,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACtM,IAAI,QAAQ,IAAI,OAAO;QAAE,OAAO,wBAAwB,OAAO,CAAC,MAAM,mBAAmB,CAAC;IAC1F,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,aAAa,CAAC,QAA+E,EAAE,OAAiB,QAAQ;IACtI,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5G,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,GAAG,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC"}

package/dist/workflows/world.d.ts

@@ -0,0 +1,23 @@
+import type { GraviewApp } from "../app.js";
+import type { GraviewDocument } from "../document/schema.js";
+import { type JobWorld } from "../job-findings.js";
+import type { AnySchema } from "../schema/schema.js";
+/** A connection as a workflow reads it: the kinds it keeps in step, and whether this app's changes go out through it. */
+export interface WorkflowConnection {
+    readonly kinds: readonly string[];
+    readonly writes: boolean;
+}
+export interface WorkflowWorld extends JobWorld {
+    /** Every act the app gives, declared and derived, by name. */
+    readonly acts: readonly string[];
+    /** The kinds an act makes records of; undefined where the app has no act of that name. */
+    actMakes(name: string): readonly string[] | undefined;
+    readonly connections: ReadonlyMap<string, WorkflowConnection>;
+    /** A kind as a person reads it: the noun its declaration says. */
+    noun(kind: string): string;
+}
+/** What a document's workflows may name, read off the document alone. */
+export declare function workflowWorldOfDocument(document: GraviewDocument): WorkflowWorld;
+/** What a compiled or TypeScript app's workflows may name. */
+export declare function workflowWorldOfApp<S extends AnySchema>(app: GraviewApp<S>): WorkflowWorld;
+//# sourceMappingURL=world.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/workflows/world.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAItF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAUrD,yHAAyH;AACzH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9D,kEAAkE;IAClE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAaD,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,CAiBhF;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAczF"}

package/dist/workflows/world.js

@@ -0,0 +1,50 @@
+import { actsOfDocument } from "../document/act-spellings.js";
+import { jobWorldOfApp, jobWorldOfDocument } from "../job-findings.js";
+import { deriveMutations } from "../mutations/derive-edits.js";
+import { derivedActOf, givenWhenNeverArchived } from "../mutations/derived-names.js";
+import { nounOf } from "../schema/define-node.js";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** A connection's kinds and direction, read loosely: one kind, or a kind per source. */
+function connectionOf(spec) {
+    const given = isRecord(spec) ? spec : {};
+    const kinds = [given["kind"], ...(Array.isArray(given["sources"]) ? given["sources"].map((source) => (isRecord(source) ? source["kind"] : undefined)) : [])].filter((kind) => typeof kind === "string");
+    return { kinds, writes: given["direction"] !== "read" };
+}
+const connectionsOf = (connections) => new Map(Object.entries(connections ?? {}).map(([name, spec]) => [name, connectionOf(spec)]));
+/** What a document's workflows may name, read off the document alone. */
+export function workflowWorldOfDocument(document) {
+    const acts = document.acts ?? {};
+    return {
+        ...jobWorldOfDocument(document),
+        // A kind that is never set aside (`archives: false`) is given no archive, unarchive or merge: as the app's derived acts leave them out.
+        acts: actsOfDocument(document).filter((act) => {
+            const derived = derivedActOf(act);
+            return !derived || document.kinds[derived.kind]?.archives !== false || givenWhenNeverArchived(derived.act);
+        }),
+        actMakes(name) {
+            const act = acts[name];
+            if (act)
+                return [...new Set([...(act.creates ? [act.creates] : []), ...(act.effects ?? []).flatMap((effect) => (isRecord(effect) && typeof effect["create"] === "string" ? [effect["create"]] : []))])];
+            return derivedActOf(name) || this.actOn(name) !== undefined ? [] : undefined;
+        },
+        connections: connectionsOf(document.connections),
+        noun: (kind) => nounOf(document.kinds[kind], kind),
+    };
+}
+/** What a compiled or TypeScript app's workflows may name. */
+export function workflowWorldOfApp(app) {
+    const declared = app.mutations ?? [];
+    const every = [...declared, ...deriveMutations(app.schema, declared)];
+    const byName = new Map(every.map((mutation) => [mutation.name, mutation]));
+    return {
+        ...jobWorldOfApp(app),
+        acts: [...byName.keys()],
+        actMakes: (name) => {
+            const mutation = byName.get(name);
+            return mutation ? [...(mutation.creates ?? [])] : undefined;
+        },
+        connections: connectionsOf(app.connections),
+        noun: (kind) => nounOf(app.schema.tryDefinition(kind), kind),
+    };
+}
+//# sourceMappingURL=world.js.map

package/dist/workflows/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../../src/workflows/world.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAiB,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AA2BlD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE5I,wFAAwF;AACxF,SAAS,YAAY,CAAC,IAAa;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;IACxN,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,WAA0D,EAA2C,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5N,yEAAyE;AACzE,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,OAAO;QACL,GAAG,kBAAkB,CAAC,QAAQ,CAAC;QAC/B,wIAAwI;QACxI,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,KAAK,IAAI,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7G,CAAC,CAAC;QACF,QAAQ,CAAC,IAAI;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAmE,CAAC;YACzF,IAAI,GAAG;gBAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxM,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,CAAC;QACD,WAAW,EAAE,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAkC,EAAE,IAAI,CAAC;KACpF,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAAsB,GAAkB;IACxE,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO;QACL,GAAG,aAAa,CAAC,GAAG,CAAC;QACrB,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YACjB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAE,QAA4C,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnG,CAAC;QACD,WAAW,EAAE,aAAa,CAAC,GAAG,CAAC,WAA4D,CAAC;QAC5F,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAkC,EAAE,IAAI,CAAC;KAC9F,CAAC;AACJ,CAAC"}

package/dist/workflows.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `@graview/core/workflows` — WHAT THE APP DOES ON ITS OWN, AND WHEN
+ * (Roadmap f-jobs-declared).
+ *
+ * The declaration's `workflows`, read: their shape (`WorkflowSpec`), the
+ * closed set of step kinds (`STEP_KINDS`) and what each may name
+ * (`workflowWorldOfDocument`, `workflowWorldOfApp`), each resolved with its
+ * defaults (`workflowsOf`, dreaming among them), said in a sentence
+ * (`workflowWords`), when it next runs on its clock (`nextRunAt`), what a
+ * commit starts (`triggeredBy`) and what the checker says of them
+ * (`workflowFindings`). Running one is
+ * `@graview/tools/workflows`' (`runWorkflow`). An entry of its own, on no
+ * page: nothing a page draws runs a workflow.
+ */
+export type { ActStep, AgentStep, ArchiveStep, ClassifyFloorRule, ClassifyStep, GenerateFrom, GenerateStep, GenerateWindow, AppWorkflows, WorkflowApproval, WorkflowDeclaration, WorkflowOver, WorkflowStep, WorkflowTrigger, WorkflowValue } from "./workflow-shape.js";
+export { MOST_STEPS, MOST_WORKFLOWS } from "./workflow-shape.js";
+export { kindNoun, STEP_KINDS, stepKindOf, stepShapes, type KindNoun, type StepCheck, type StepKind, type StepKindKey, type StepShapes, type WorkflowFinding } from "./workflows/steps.js";
+export { actStep, keyFields } from "./workflows/step-act.js";
+export { agentStep } from "./workflows/step-agent.js";
+export { classifyApplies, classifyAsks, classifyStep, classifyWords, floorLabel, linksIn, type FloorReading } from "./workflows/step-classify.js";
+export { actsMaking, generateStep } from "./workflows/step-generate.js";
+export { datesIn, generateWants, windowDays, type GenerateReading, type GenerateWants, type WantedRecord } from "./workflows/generate.js";
+export { DEFAULT_GENERATE_KEY, MOST_GENERATED, MOST_WINDOW_DAYS } from "./workflows/generate-words.js";
+export { afterMs, afterWords, archiveStep } from "./workflows/step-archive.js";
+export { followsFindings, keeps, policiesOf, policyApplies, policyInstruction, type WorkflowPolicy } from "./workflows/policies.js";
+export { workflowWorldOfApp, workflowWorldOfDocument, type WorkflowConnection, type WorkflowWorld } from "./workflows/world.js";
+export { WorkflowSpec, WorkflowStepSpec, WorkflowTriggerSpec, WorkflowsSpec } from "./document/workflow-spec.js";
+export { declaredWorkflows, DREAMING, dreamingWorkflow, resolveWorkflow, workflowAuthor, workflowReach, workflowsOf, type ResolvedWorkflow } from "./workflows/resolve.js";
+export { scheduleOf, scheduleOfCron, scheduleOfWords, scheduleWords, SCHEDULE_WORDS, type Schedule } from "./workflows/schedule.js";
+export { nextOf, nextRunAt } from "./workflows/next.js";
+export { triggerWords, workflowWords } from "./workflows/words.js";
+export { triggeredBy, workflowOrigin, type FiredTrigger, type WorkflowCommit, type WorkflowOrigin } from "./workflows/triggered.js";
+export { documentWorkflowFindings, workflowFindings, workflowFindingsOf } from "./workflows/findings.js";
+export { keyedId, recordsOver, workflowKey, workflowSpecHash, workflowValue } from "./workflows/values.js";
+//# sourceMappingURL=workflows.d.ts.map

package/dist/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzQ,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3L,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAClJ,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1I,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChI,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC3K,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACpI,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/workflows.js

@@ -0,0 +1,20 @@
+export { MOST_STEPS, MOST_WORKFLOWS } from "./workflow-shape.js";
+export { kindNoun, STEP_KINDS, stepKindOf, stepShapes } from "./workflows/steps.js";
+export { actStep, keyFields } from "./workflows/step-act.js";
+export { agentStep } from "./workflows/step-agent.js";
+export { classifyApplies, classifyAsks, classifyStep, classifyWords, floorLabel, linksIn } from "./workflows/step-classify.js";
+export { actsMaking, generateStep } from "./workflows/step-generate.js";
+export { datesIn, generateWants, windowDays } from "./workflows/generate.js";
+export { DEFAULT_GENERATE_KEY, MOST_GENERATED, MOST_WINDOW_DAYS } from "./workflows/generate-words.js";
+export { afterMs, afterWords, archiveStep } from "./workflows/step-archive.js";
+export { followsFindings, keeps, policiesOf, policyApplies, policyInstruction } from "./workflows/policies.js";
+export { workflowWorldOfApp, workflowWorldOfDocument } from "./workflows/world.js";
+export { WorkflowSpec, WorkflowStepSpec, WorkflowTriggerSpec, WorkflowsSpec } from "./document/workflow-spec.js";
+export { declaredWorkflows, DREAMING, dreamingWorkflow, resolveWorkflow, workflowAuthor, workflowReach, workflowsOf } from "./workflows/resolve.js";
+export { scheduleOf, scheduleOfCron, scheduleOfWords, scheduleWords, SCHEDULE_WORDS } from "./workflows/schedule.js";
+export { nextOf, nextRunAt } from "./workflows/next.js";
+export { triggerWords, workflowWords } from "./workflows/words.js";
+export { triggeredBy, workflowOrigin } from "./workflows/triggered.js";
+export { documentWorkflowFindings, workflowFindings, workflowFindingsOf } from "./workflows/findings.js";
+export { keyedId, recordsOver, workflowKey, workflowSpecHash, workflowValue } from "./workflows/values.js";
+//# sourceMappingURL=workflows.js.map

package/dist/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAyG,MAAM,sBAAsB,CAAC;AAC3L,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAqB,MAAM,8BAA8B,CAAC;AAClJ,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAA+D,MAAM,yBAAyB,CAAC;AAC1I,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAuB,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAA+C,MAAM,sBAAsB,CAAC;AAChI,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAyB,MAAM,wBAAwB,CAAC;AAC3K,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAiB,MAAM,yBAAyB,CAAC;AACpI,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,cAAc,EAA+D,MAAM,0BAA0B,CAAC;AACpI,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graview/core",
-  "version": "0.1.62",
+  "version": "0.1.64",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -53,6 +53,10 @@
       "types": "./dist/shown.d.ts",
       "default": "./dist/shown.js"
     },
+    "./head": {
+      "types": "./dist/head.d.ts",
+      "default": "./dist/head.js"
+    },
     "./csv": {
       "types": "./dist/csv.d.ts",
       "default": "./dist/csv.js"
@@ -89,6 +93,10 @@
       "types": "./dist/jobs.d.ts",
       "default": "./dist/jobs.js"
     },
+    "./workflows": {
+      "types": "./dist/workflows.d.ts",
+      "default": "./dist/workflows.js"
+    },
     "./friction": {
       "types": "./dist/friction.d.ts",
       "default": "./dist/friction.js"
@@ -227,7 +235,9 @@
     "./dist/tidying.js",
     "./src/tidying.ts",
     "./dist/typing.js",
-    "./src/typing.ts"
+    "./src/typing.ts",
+    "./dist/workflows/findings.js",
+    "./src/workflows/findings.ts"
   ],
   "repository": {
     "type": "git",