@graview/core 0.1.27 → 0.1.29

package/dist/mutations/keep-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-link.d.ts","sourceRoot":"","sources":["../../src/mutations/keep-link.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,oEAAoE;AACpE,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CA2BzF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,SAAS,EAAE,WAAW,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,OAAO,KAAG,SAAS,MAAM,EACoE,CAAC"}

package/dist/mutations/keep-link.js

@@ -0,0 +1,56 @@
+import * as z from "../schema/zod.js";
+import { MissingRecordError } from "../graph/graph.js";
+import { edgeId } from "../graph/types.js";
+import { labelOf } from "../schema/define-node.js";
+/** The name of the act that accepts a provisional link (FR-172). */
+export const KEEP_LINK = "keep-link";
+/**
+ * "KEEP THIS LINK" (FR-172): a person accepting a link something less sure
+ * made. It takes the link away and puts it back in one op — the graph is as
+ * it was — so the log holds a person's op naming it, which is what makes a
+ * provisional link ordinary (`linkProvenances`); undone, the link is
+ * provisional again. Its arguments are the link: `{ kind, from, to }`.
+ *
+ * Every store answers to it and no list offers it: it is not one of the
+ * app's acts, and a face offers it beside the link it would keep (a line's
+ * acts, a record page's mark). It goes over the wire like any call, and is
+ * permitted to whoever may make or break links of its relation
+ * (`keepLinkVia`).
+ */
+export function keepLinkMutation(schema) {
+    const name = (graph, id) => {
+        const node = graph.getNode(id);
+        return node ? labelOf(schema.tryDefinition(node.kind), node) : id;
+    };
+    return {
+        name: KEEP_LINK,
+        title: "Keep this link",
+        input: z.object({ kind: z.string(), from: z.string(), to: z.string() }),
+        describe: (args, graph) => `Keep the link from ${name(graph, args.from)} to ${name(graph, args.to)}`,
+        // A link that is not there is refused by the graph itself, as missing.
+        apply(ctx, args) {
+            const { kind, from, to } = args;
+            /*
+             * AND ONE TO A RECORD THE SEAT MAY NOT SEE IS NOT THERE FOR IT (FR-55):
+             * its ends are plain ids, which a seat can guess, so it is refused in
+             * the graph's own words, alike whether the hidden record holds the
+             * link or nothing does. `ctx.graph` is what the seat is served.
+             */
+            if (!ctx.graph.getNode(from) || !ctx.graph.getNode(to)) {
+                const id = edgeId({ kind, from, to });
+                throw new MissingRecordError(id, `Cannot remove missing edge ${id}`);
+            }
+            ctx.removeEdge({ kind, from, to });
+            ctx.addEdge({ kind, from, to });
+        },
+    };
+}
+/**
+ * Who may keep a link of a relation: whoever may run a declared act that
+ * makes or breaks links of THAT relation — the policy's own grants, read
+ * again. A seat that may link a lease to its property may keep such a link,
+ * and is not thereby the judge of a link between two people; a link of a
+ * relation no act makes or breaks is kept by nobody a policy names.
+ */
+export const keepLinkVia = (mutations, relation) => [...mutations].filter((one) => !one.derived && one.name !== KEEP_LINK && typeof relation === "string" && (one.connects?.includes(relation) || one.severs?.includes(relation))).map((one) => one.name);
+//# sourceMappingURL=keep-link.js.map

package/dist/mutations/keep-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-link.js","sourceRoot":"","sources":["../../src/mutations/keep-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAInD,oEAAoE;AACpE,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAsB,MAAS;IAC7D,MAAM,IAAI,GAAG,CAAC,KAAuC,EAAE,EAAU,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAyE,CAAC;QACvG,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAU;QAChF,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,sBAAsB,IAAI,CAAC,KAAK,EAAG,IAAyB,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAG,IAAuB,CAAC,EAAE,CAAC,EAAE;QAC9I,uEAAuE;QACvE,KAAK,CAAC,GAAG,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,IAAkD,CAAC;YAC9E;;;;;eAKG;YACH,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACtC,MAAM,IAAI,kBAAkB,CAAC,EAAE,EAAE,8BAA8B,EAAE,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACnC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;KAC0B,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAsB,SAA6C,EAAE,QAAiB,EAAqB,EAAE,CACtI,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/dist/mutations/kept-arguments.d.ts

@@ -0,0 +1,26 @@
+import type { Policy, Principal } from "../permissions/types.js";
+import type { AnySchema } from "../schema/schema.js";
+import type { Judged } from "../seen.js";
+import type { AnyMutationDefinition } from "./types.js";
+/**
+ * THE ARGUMENTS OF AN ACT A SEAT IS NOT ASKED FOR (Roadmap f-field-sight):
+ * the ones that write a field its sight keeps from it — on the record it
+ * acts on, or on one it makes (judged as its own, as the store judges it).
+ * The store refuses such a write as an argument the act does not take, so
+ * a form that offered it would offer a refusal.
+ */
+export declare function keptArguments<S extends AnySchema>(store: Judged & {
+    readonly schema: S;
+}, principal: Principal, mutation: AnyMutationDefinition<S>, subject?: string): ReadonlySet<string>;
+/**
+ * THE ARGUMENTS OF AN ACT NO RECORD WOULD LET A SEAT WRITE, read off the
+ * declaration alone (Roadmap f-field-sight): each writes a field that no
+ * sight granting the seat that kind shows — on the kind the act makes, or
+ * every kind its subject takes. An agent's tool for the act lists none of
+ * them, so its schema never names a field the seat may not see; a field
+ * the seat sees on some records (its own child's phone) stays, and the
+ * store refuses the write on the rest, as `keptArguments` says per record.
+ * Judged as the policy says it whether or not field sight is loaded.
+ */
+export declare function argumentsNeverShown<S extends AnySchema>(schema: S, policy: Policy | undefined, principal: Principal, mutation: AnyMutationDefinition<S>): ReadonlySet<string>;
+//# sourceMappingURL=kept-arguments.d.ts.map

package/dist/mutations/kept-arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-arguments.d.ts","sourceRoot":"","sources":["../../src/mutations/kept-arguments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAC/C,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,EACtC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAAC,MAAM,CAAC,CAcrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EACrD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,WAAW,CAAC,MAAM,CAAC,CAwBrB"}

package/dist/mutations/kept-arguments.js

@@ -0,0 +1,77 @@
+import { ARCHIVED } from "../graph/archived.js";
+import { actingAs, grantsTo, isSystem } from "../permissions/policy.js";
+import { FIELD_SIGHT, partialSight } from "../permissions/sight.js";
+import { fieldsWrittenBy, subjectKindsOf } from "./derive-edits.js";
+/**
+ * THE ARGUMENTS OF AN ACT A SEAT IS NOT ASKED FOR (Roadmap f-field-sight):
+ * the ones that write a field its sight keeps from it — on the record it
+ * acts on, or on one it makes (judged as its own, as the store judges it).
+ * The store refuses such a write as an argument the act does not take, so
+ * a form that offered it would offer a refusal.
+ */
+export function keptArguments(store, principal, mutation, subject) {
+    const kept = FIELD_SIGHT.keptFrom?.(store, principal);
+    const out = new Set();
+    if (!kept)
+        return out;
+    const shape = Object.keys(mutation.input.shape ?? {});
+    for (const kind of mutation.creates ?? []) {
+        const fields = kept({ id: "\u0000new", kind });
+        for (const name of shape)
+            if (fields?.(name))
+                out.add(name);
+    }
+    const node = subject === undefined ? undefined : store.graph.getNode(subject);
+    const definition = node && store.schema.tryDefinition(node.kind);
+    const fields = node && kept(node);
+    if (definition && fields)
+        for (const name of fieldsWrittenBy(mutation, definition))
+            if (fields(name) && shape.includes(name))
+                out.add(name);
+    return out;
+}
+/**
+ * THE ARGUMENTS OF AN ACT NO RECORD WOULD LET A SEAT WRITE, read off the
+ * declaration alone (Roadmap f-field-sight): each writes a field that no
+ * sight granting the seat that kind shows — on the kind the act makes, or
+ * every kind its subject takes. An agent's tool for the act lists none of
+ * them, so its schema never names a field the seat may not see; a field
+ * the seat sees on some records (its own child's phone) stays, and the
+ * store refuses the write on the rest, as `keptArguments` says per record.
+ * Judged as the policy says it whether or not field sight is loaded.
+ */
+export function argumentsNeverShown(schema, policy, principal, mutation) {
+    const out = new Set();
+    const sights = policy?.sees ?? [];
+    if (isSystem(principal) || !sights.some(partialSight))
+        return out;
+    const acting = actingAs(principal);
+    /** Whether a seat is shown a kind's field on some record: a sight granting it the kind shows it. */
+    const shown = (kind, field) => {
+        const granted = sights.filter((sight) => sight.kinds.includes(kind) && grantsTo(sight, acting));
+        if (!granted.some(partialSight))
+            return true;
+        return field === ARCHIVED || granted.some((sight) => !partialSight(sight) || ((sight.fields === undefined || sight.fields.includes(field)) && !sight.hide?.includes(field)));
+    };
+    const shape = Object.keys(mutation.input.shape ?? {});
+    const written = new Map();
+    const write = (field, seen) => written.set(field, written.get(field) === true || seen);
+    for (const kind of mutation.creates ?? []) {
+        const declared = Object.keys((schema.tryDefinition(kind)?.fields.shape ?? {}));
+        for (const name of shape)
+            if (declared.includes(name))
+                write(name, shown(kind, name));
+    }
+    for (const kind of subjectKindsOf(schema, mutation)) {
+        const definition = schema.tryDefinition(kind);
+        if (definition)
+            for (const name of fieldsWrittenBy(mutation, definition))
+                if (shape.includes(name))
+                    write(name, shown(kind, name));
+    }
+    for (const [name, seen] of written)
+        if (!seen)
+            out.add(name);
+    return out;
+}
+//# sourceMappingURL=kept-arguments.js.map

package/dist/mutations/kept-arguments.js.map

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

package/dist/mutations/node-ref.d.ts

@@ -28,84 +28,4 @@ export declare function nodeRefArgs(input: unknown): {
     kinds: readonly string[];
     optional: boolean;
 }[];
-/**
- * What sort of answer an argument wants, read off its own declaration.
- *
- * The affordance layer could already say "this needs a `label`" and offer
- * candidate ids for a node reference — but for a plain string or a date it
- * offered a list of nothing, so half the actions in an interface were dead
- * ends that looked live. The mutation's schema knows perfectly well that
- * `label` is a non-empty string and `date` is `YYYY-MM-DD`; nothing had
- * asked it.
- */
-export type ArgShape = 
-/** Words; `long` where the field allows more than 500 characters — prose, asked for in a text area (FR-147). */
-{
-    readonly type: "text";
-    readonly long?: true;
-}
-/**
- * A DATE, AND WITH `time` A TIME OF DAY IN IT. A workshop's start is
- * `YYYY-MM-DDTHH:MM`; read as a plain date it got a date picker, whose
- * `YYYY-MM-DD` the act's own pattern refused — on every face, so the
- * workshop could not be made and the talk could not be given its slot.
- */
- | {
-    readonly type: "date";
-    readonly time?: true;
-}
-/** A number, and its range where it says one: `step` is what its values are whole multiples of (FR-114), 1 for a whole number. */
- | {
-    readonly type: "number";
-    readonly min?: number;
-    readonly max?: number;
-    readonly step?: number;
-} | {
-    readonly type: "choice";
-    readonly options: readonly string[];
-}
-/**
- * YES OR NO — an argument that takes a boolean.
- *
- * Undescribable until now, for the same reason a list was: an interface
- * can only offer what it can ask for, so "Add a field" — whose `required`
- * is a plain boolean — was derived NOWHERE. The studio's central act, in
- * the studio, unreachable, because nothing could ask one question.
- */
- | {
-    readonly type: "boolean";
-}
-/**
- * SEVERAL OF A THING — an argument that takes a list.
- *
- * "Invite somebody as coordinator and gardener" is one act with two roles
- * in one argument, and without this shape it described itself as `unknown`:
- * an interface can only offer what it can ask for, so the act was offered
- * NOWHERE. Not hidden behind a refusal — simply never derived, in every
- * installation the framework ships.
- */
- | {
-    readonly type: "several";
-    readonly of: ArgShape;
-}
-/** A picture or a document the host stores (FR-162), put on the record by its upload (FR-163); `image` where only a picture will do. */
- | {
-    readonly type: "file";
-    readonly image?: true;
-} | {
-    readonly type: "unknown";
-};
-/** Unwraps optional/default/nullable so a wrapped field still describes itself. */
-export declare function unwrap(schema: unknown): unknown;
-/**
- * Zod 4 keeps the primitive type on `_def.type` and the refinements a UI
- * actually needs — bounds, patterns — as the checks on its definition. Read
- * from the checks themselves, not from `_zod.bag`, which zod 4.6 stopped
- * filling as it builds a schema: the bounds and the date pattern read there
- * vanished with a minor version. Reading them here, in one place, keeps
- * every other layer free of zod internals.
- */
-export declare function describeArg(schema: unknown): ArgShape;
-/** The declared shape of one named argument of a mutation input object. */
-export declare function argShape(input: unknown, name: string): ArgShape;
 //# sourceMappingURL=node-ref.d.ts.map

package/dist/mutations/node-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-ref.d.ts","sourceRoot":"","sources":["../../src/mutations/node-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,IAAI,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,CAAC,MAAM,kBAAkB,CAAC;AAsBtC;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAC5C,KAAK,GAAE,SAAS,CAAC,EAAE,GAAG,GAAS,GAC9B,OAAO,CAAC,SAAS,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,GAAE,SAAS,MAAM,EAAE,GAAG,GAAS,GAAG,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAEnF;AAmBD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAW3E;AAED,kHAAkH;AAClH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EAAE,CAUjE;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ;AAClB,gHAAgH;AAC9G;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE;AACjD;;;;;GAKG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE;AACjD,kIAAkI;GAChI;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AAClE;;;;;;;GAOG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE;AAC9B;;;;;;;;GAQG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;CAAE;AACrD,wIAAwI;GACtI;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAG/C;AAeD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CA8DrD;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAI/D"}
+{"version":3,"file":"node-ref.d.ts","sourceRoot":"","sources":["../../src/mutations/node-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,IAAI,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,CAAC,MAAM,kBAAkB,CAAC;AAqBtC;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAC5C,KAAK,GAAE,SAAS,CAAC,EAAE,GAAG,GAAS,GAC9B,OAAO,CAAC,SAAS,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,GAAE,SAAS,MAAM,EAAE,GAAG,GAAS,GAAG,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAEnF;AAmBD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAW3E;AAED,kHAAkH;AAClH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EAAE,CAUjE"}

package/dist/mutations/node-ref.js

@@ -1,7 +1,6 @@
 import { z as classic } from "zod";
 import * as z from "../schema/zod.js";
 import { defOf } from "../schema/zod.js";
-import { fileKindOf } from "../schema/files.js";
 /**
  * WHERE A NODE REFERENCE KEEPS ITS KINDS: on the schema itself, under a
  * registry symbol.
@@ -80,96 +79,4 @@ export function nodeRefArgs(input) {
     }
     return args;
 }
-/** Unwraps optional/default/nullable so a wrapped field still describes itself. */
-export function unwrap(schema) {
-    const inner = defOf(schema)?.innerType;
-    return inner === undefined ? schema : unwrap(inner);
-}
-/** What a number's declared format bounds it to, as zod's own `int()`, `int32()` … say. */
-const NUMBER_FORMAT_RANGES = {
-    safeint: [Number.MIN_SAFE_INTEGER, Number.MAX_SAFE_INTEGER],
-    int32: [-2147483648, 2147483647],
-    uint32: [0, 4294967295],
-    float32: [-3.4028234663852886e38, 3.4028234663852886e38],
-    float64: [-Number.MAX_VALUE, Number.MAX_VALUE],
-};
-const checksOf = (field) => ((field?._zod?.def?.checks ?? []).map((check) => check._zod?.def).filter((def) => def !== undefined));
-/**
- * Zod 4 keeps the primitive type on `_def.type` and the refinements a UI
- * actually needs — bounds, patterns — as the checks on its definition. Read
- * from the checks themselves, not from `_zod.bag`, which zod 4.6 stopped
- * filling as it builds a schema: the bounds and the date pattern read there
- * vanished with a minor version. Reading them here, in one place, keeps
- * every other layer free of zod internals.
- */
-export function describeArg(schema) {
-    const field = unwrap(schema);
-    const def = defOf(field);
-    const type = def?.type;
-    const checks = checksOf(field);
-    if (type === "enum")
-        return { type: "choice", options: Object.keys(def?.entries ?? {}) };
-    const file = fileKindOf(field);
-    if (file)
-        return file === "image" ? { type: "file", image: true } : { type: "file" };
-    if (type === "boolean")
-        return { type: "boolean" };
-    /*
-     * A list describes itself through what it holds. An array of something
-     * nothing can describe is still unknown — saying "several unknowns" would
-     * make an unaskable argument look askable, which is the failure this whole
-     * shape exists to prevent.
-     */
-    if (type === "array") {
-        const of = describeArg(def?.element);
-        return of.type === "unknown" ? { type: "unknown" } : { type: "several", of };
-    }
-    if (type === "number") {
-        let min;
-        let max;
-        let step;
-        for (const check of checks) {
-            if (check.check === "multiple_of" && typeof check.value === "number")
-                step = check.value;
-            else if (check.check === "number_format" && (check.format === "safeint" || check.format === "int32" || check.format === "uint32"))
-                step ??= 1;
-            const range = check.check === "number_format" && check.format ? NUMBER_FORMAT_RANGES[check.format] : undefined;
-            const low = range ? range[0] : check.check === "greater_than" && check.inclusive && typeof check.value === "number" ? check.value : undefined;
-            const high = range ? range[1] : check.check === "less_than" && check.inclusive && typeof check.value === "number" ? check.value : undefined;
-            if (low !== undefined)
-                min = min === undefined ? low : Math.max(min, low);
-            if (high !== undefined)
-                max = max === undefined ? high : Math.min(max, high);
-        }
-        return {
-            type: "number",
-            ...(min === undefined ? {} : { min }),
-            ...(max === undefined ? {} : { max }),
-            ...(step === undefined ? {} : { step }),
-        };
-    }
-    if (type === "string") {
-        // A date is a string with a date-shaped pattern. Recognizing it means
-        // the interface offers a date picker instead of a free text box, which
-        // is the difference between an action anyone can run and one only its
-        // author knows the format for.
-        const own = def?.pattern;
-        const sources = [own, ...checks.map((check) => check.pattern)].filter((pattern) => pattern instanceof RegExp).map((pattern) => pattern.source);
-        if (sources.some((source) => source.includes("\\d{4}"))) {
-            // A time of day in the pattern as well: `T\d{2}:\d{2}`, or a space before it.
-            return sources.some((source) => source.includes("\\d{2}:\\d{2}")) ? { type: "date", time: true } : { type: "date" };
-        }
-        // Prose: more than 500 characters allowed — a document's `text` (FR-147), asked for in a text area.
-        const long = checks.some((check) => check.check === "max_length" && typeof check.maximum === "number" && check.maximum > 500);
-        return long ? { type: "text", long: true } : { type: "text" };
-    }
-    return { type: "unknown" };
-}
-/** The declared shape of one named argument of a mutation input object. */
-export function argShape(input, name) {
-    const shape = input?.shape;
-    if (!shape || !(name in shape))
-        return { type: "unknown" };
-    return describeArg(shape[name]);
-}
 //# sourceMappingURL=node-ref.js.map

package/dist/mutations/node-ref.js.map

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

package/dist/mutations/types.d.ts

@@ -19,6 +19,20 @@ export interface MutationContext<S extends AnySchema> {
     /** Removes a node together with every edge touching it. */
     removeNode(id: string): void;
     patchNode(id: string, fields: Record<string, unknown>): void;
+    /**
+     * Sets a record aside (FR-173): its fields, links and history kept, and
+     * it out of lists, the Scene, counts, computed fields and rules. Nothing
+     * when it is archived already.
+     */
+    archiveNode(id: string): void;
+    /** Brings an archived record back. Nothing when it is not archived. */
+    unarchiveNode(id: string): void;
+    /**
+     * Merges two records that are one thing (FR-173): the kept one (`into`)
+     * takes the duplicate's links, and the duplicate is archived, its op
+     * saying `mergedInto`. Undone as one, like any act.
+     */
+    mergeNode(duplicate: string, into: string): void;
     addEdge(edge: GraphEdge): void;
     removeEdge(edge: GraphEdge): void;
     /** Replaces every `kind` edge arriving at `to` with one from `from`. */
@@ -166,9 +180,11 @@ export interface MutationDefinition<S extends AnySchema = AnySchema, Name extend
      */
     readonly derived?: {
         readonly kind: string;
-        readonly act: "edit" | "remove";
+        readonly act: DerivedAct;
     };
 }
+/** The acts the framework gives every kind: edit and remove, and archive, unarchive and merge (FR-173). */
+export type DerivedAct = "edit" | "remove" | "archive" | "unarchive" | "merge" | "skip" | "detach" | "split";
 export type AnyMutationDefinition<S extends AnySchema = AnySchema> = MutationDefinition<S, string, z.ZodType>;
 /** A concrete, ready-to-apply mutation: a name plus validated arguments. */
 export interface MutationCall<Name extends string = string> {

package/dist/mutations/types.d.ts.map

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

package/dist/mutations/words.d.ts

@@ -1,4 +1,3 @@
-import { GraphError } from "../graph/graph.js";
 import type { AnySchema } from "../schema/schema.js";
 /** The parts of a mutation that say which kinds its arguments fill. */
 interface Filling {
@@ -23,18 +22,6 @@ export declare function argumentWords(schema: AnySchema, mutation: Filling | und
     readonly label: string;
     readonly option: (value: string) => string;
 };
-/** Arguments a mutation refused, each with where it was and what was wrong. */
-export declare class InvalidArguments extends GraphError {
-    readonly mutation: string;
-    readonly issues: readonly {
-        readonly path: readonly PropertyKey[];
-        readonly message: string;
-    }[];
-    constructor(mutation: string, issues: readonly {
-        readonly path: readonly PropertyKey[];
-        readonly message: string;
-    }[]);
-}
 /**
  * WHY A PRESS DID NOT TAKE, in a person's words.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../../src/mutations/words.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,uEAAuE;AACvE,UAAU,OAAO;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAexE;AAED,+EAA+E;AAC/E,qBAAa,gBAAiB,SAAQ,UAAU;IAE5C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;gBADtF,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE;CAQlG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,KAAK,EAAE,OAAO,GACb,MAAM,CAUR"}
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../../src/mutations/words.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,uEAAuE;AACvE,UAAU,OAAO;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAexE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,SAAS,OAAO,EAAE,EAC7B,KAAK,EAAE,OAAO,GACb,MAAM,CAUR"}

package/dist/mutations/words.js

@@ -1,4 +1,4 @@
-import { GraphError } from "../graph/graph.js";
+import { InvalidArguments } from "./invalid-arguments.js";
 import { fieldWords, humanizeField } from "../schema/define-node.js";
 /**
  * AN ARGUMENT ASKED FOR IN THE RECORD'S OWN WORDS.
@@ -27,17 +27,6 @@ export function argumentWords(schema, mutation, name) {
     }
     return { label: fieldWords(undefined, name), option: (value) => humanizeField(value) };
 }
-/** Arguments a mutation refused, each with where it was and what was wrong. */
-export class InvalidArguments extends GraphError {
-    mutation;
-    issues;
-    constructor(mutation, issues) {
-        super(`Invalid arguments for mutation "${mutation}"`, issues.map((issue) => `${issue.path.map(String).join(".") || "(root)"}: ${issue.message}`).join("; "));
-        this.mutation = mutation;
-        this.issues = issues;
-        this.name = "InvalidArguments";
-    }
-}
 /**
  * WHY A PRESS DID NOT TAKE, in a person's words.
  *

package/dist/mutations/words.js.map

@@ -1 +1 @@
-{"version":3,"file":"words.js","sourceRoot":"","sources":["../../src/mutations/words.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../src/mutations/words.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AASrE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAiB,EACjB,QAA6B,EAC7B,IAAY;IAEZ,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAE,UAAU,EAAE,MAA0D,EAAE,KAAK,IAAI,EAAE,CAA4B,CAAC;QAChI,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC;YAAE,SAAS;QAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO;YACL,iFAAiF;YACjF,KAAK,EAAE,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC;YAC/C,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACnE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;AACzF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,SAA6B,EAC7B,KAAc;IAEd,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/G,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7G,CAAC,CAAC,CAAC;QACH,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/ops/kept-fields.d.ts

@@ -0,0 +1,7 @@
+import type { Primitive } from "../graph/primitives.js";
+import type { SeatLens } from "./withheld.js";
+/** The fields of a record a lens keeps, when it keeps any. */
+export declare const keptOf: (lens: SeatLens, id: string) => ((field: string) => boolean) | undefined;
+/** Primitives as the seat receives them: what a patch wrote of a field kept from it is no part of them. */
+export declare function withoutKeptFields(primitives: readonly Primitive[], lens: SeatLens): Primitive[];
+//# sourceMappingURL=kept-fields.d.ts.map

package/dist/ops/kept-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-fields.d.ts","sourceRoot":"","sources":["../../src/ops/kept-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQ9C,8DAA8D;AAC9D,eAAO,MAAM,MAAM,GAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,KAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAGlF,CAAC;AAEF,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,CAS/F"}

package/dist/ops/kept-fields.js

@@ -0,0 +1,24 @@
+/*
+ * What a seat's lens keeps of a record's fields (Roadmap f-field-sight),
+ * read where an answer is served: apart from `@graview/core/field-sight`,
+ * so a page that answers its seat carries none of the judging.
+ */
+/** The fields of a record a lens keeps, when it keeps any. */
+export const keptOf = (lens, id) => {
+    const kind = lens.kindOf(id);
+    return kind === undefined ? undefined : lens.kept?.({ id, kind });
+};
+/** Primitives as the seat receives them: what a patch wrote of a field kept from it is no part of them. */
+export function withoutKeptFields(primitives, lens) {
+    return primitives.flatMap((primitive) => {
+        if (primitive.op !== "patch-node")
+            return [primitive];
+        const kept = keptOf(lens, primitive.id);
+        if (!kept || !Object.keys(primitive.after).some(kept))
+            return [primitive];
+        const keep = (side) => Object.fromEntries(Object.entries(side).filter(([field]) => !kept(field)));
+        const after = keep(primitive.after);
+        return Object.keys(after).length === 0 ? [] : [{ op: "patch-node", id: primitive.id, before: keep(primitive.before), after }];
+    });
+}
+//# sourceMappingURL=kept-fields.js.map

package/dist/ops/kept-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-fields.js","sourceRoot":"","sources":["../../src/ops/kept-fields.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAc,EAAE,EAAU,EAA4C,EAAE;IAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,2GAA2G;AAC3G,MAAM,UAAU,iBAAiB,CAAC,UAAgC,EAAE,IAAc;IAChF,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAe,EAAE;QACnD,IAAI,SAAS,CAAC,EAAE,KAAK,YAAY;YAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,CAAC,IAAuC,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrI,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChI,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ops/lineage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * WHAT A CHANGE WAS BASED ON, AND HOW SURE ITS MAKER WAS (FR-172).
+ *
+ * An author says who moved; it is the same for every change a seat makes,
+ * so it cannot say why THIS one was made. A background actor that links
+ * and prunes on its own ("Graview, tidying") owes the reader a reason per
+ * change — "both name the Harbor Street lease" — and a measure of how far
+ * to trust it. Lineage is that, kept on the op beside its author: in the
+ * log, on the wire, on the history line and the record's page.
+ *
+ * `confidence` is 0 to 1; one below 1 makes what the op links PROVISIONAL
+ * until a person touches it (`linkProvenance`). Absent, the maker did not
+ * say, and nothing is drawn quieter for it. `model` names what judged it,
+ * when a model did. The framework records, draws and explains; it never
+ * decides what to link.
+ *
+ * What draws a link or a history line reads `provenance.ts`; only the check
+ * every change is held to lives here, so a page carries the rest when it
+ * draws.
+ */
+export interface Lineage {
+    readonly basis: string;
+    readonly confidence?: number;
+    readonly model?: string;
+}
+/** The longest basis an op keeps: a reason, not a transcript. */
+export declare const LINEAGE_BASIS_LIMIT = 500;
+/** The longest model name an op keeps. */
+export declare const LINEAGE_MODEL_LIMIT = 120;
+/**
+ * A lineage as an op keeps it — the basis trimmed, keys it does not know
+ * dropped — or a GraphError: a basis of 1–500 characters, a confidence
+ * from 0 to 1, a model name of 1–120. Asked before anything is kept;
+ * nothing said is no lineage.
+ */
+export declare function lineageOf(value: unknown): Lineage | undefined;
+//# sourceMappingURL=lineage.d.ts.map

package/dist/ops/lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../src/ops/lineage.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAc7D"}