@graview/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+export { z } from "zod";
+export { defineNode, isCurrent, labelOf, describeNode, tellApart } from "./schema/define-node.js";
+export { nameOfAuthor } from "./who.js";
+export { createSchema, SchemaError } from "./schema/schema.js";
+export type { AnySchema, EdgeKindInfo, KindOfSchema, NodeOfKind, NodeOfSchema, Schema, } from "./schema/schema.js";
+export type { LifecycleDeclaration, AnyNodeDefinition, DeclaredEdgeTargets, EdgeCardinality, EdgeDeclaration, EdgeMap, EmptyEdgeMap, FieldRoleMap, NodeDefinition, NodeDefinitionSpec, NodeOf, ValidateEdgeTargets, } from "./schema/types.js";
+export { mutationToolSchema, nodeJsonSchema, schemaJson, toJsonSchema, } from "./schema/json-schema.js";
+export type { JsonSchema, MutationToolSchema } from "./schema/json-schema.js";
+export { Graph, GraphError } from "./graph/graph.js";
+export type { GraphListener, GraphOptions } from "./graph/graph.js";
+export { diffSnapshots, EMPTY_DIFF, isEmptyDiff } from "./graph/diff.js";
+export type { GraphDiff, NodeChange } from "./graph/diff.js";
+export { invert, isUnset, normalise, UNSET, writesOf } from "./graph/primitives.js";
+export type { Primitive } from "./graph/primitives.js";
+export { TrackedReader } from "./graph/tracked.js";
+export { edgeId } from "./graph/types.js";
+export type { AnyGraphNode, GraphEdge, GraphNodeBase, GraphReader, GraphSnapshot, } from "./graph/types.js";
+export { defineInvariant, evaluate, UnregisteredInvariantError, violationsTouching } from "./invariants/engine.js";
+export type { EvaluateOptions, InvariantContext, InvariantDefinition, InvariantEvalArgs, InvariantScope, Repair, Violation, } from "./invariants/types.js";
+export { admitArrangement, arrange, arrangeable, arrangeAllows, asksForThePast, bucketStart, conditionHolds, edgesOf, formatArrangement, matches, NO_ARRANGEMENT, parseArrangement, } from "./arrange.js";
+export type { Arrangeable, ArrangeContext, Arranged, ArrangeGraph, ArrangedGroup, Arrangement, ArrangementWords, ArrangeNode, ArrangeOffer, ArrangeOption, Condition, DateBucket, Grouping, OfferType, Sort, SortDirection, } from "./arrange.js";
+export { actsOn, describeSearched, fold, fragmentOf, matchNode, parseQuery, search, searchableFields, squeeze, strengthOf, touchWeights, } from "./search.js";
+export type { Hit, HitAbout, MatchStrength, ParsedQuery, SearchCondition, SearchOptions, SearchResult, Why, } from "./search.js";
+export { compileMutation, defineMutation, takesAnId } from "./mutations/define-mutation.js";
+export type { CompiledMutation } from "./mutations/define-mutation.js";
+export { deriveEditMutations, deriveMutations, deriveRemoveMutations, derivedVia, editMutationName, editVia, removeMutationName, removeVia, fieldWriters, fieldsWrittenBy, settableFields, subjectKindsOf, unwrittenFields, } from "./mutations/derive-edits.js";
+export { argShape, describeArg, nodeRef, nodeRefArgs, nodeRefKinds, } from "./mutations/node-ref.js";
+export type { ArgShape } from "./mutations/node-ref.js";
+export type { AnyMutationDefinition, MutationCall, MutationContext, MutationDefinition, MutationDefinitionSpec, } from "./mutations/types.js";
+export { OperationLog } from "./ops/log.js";
+export { checkUndo, undoPrimitives } from "./ops/undo.js";
+export type { UndoBlock, UndoCheck } from "./ops/undo.js";
+export type { Author, Batch, Operation } from "./ops/types.js";
+export { permits, permittedMutations, rolesOf, rolesWhoCould, whyNot, } from "./permissions/policy.js";
+export type { PolicyWords } from "./permissions/policy.js";
+export { PermissionDeniedError } from "./permissions/types.js";
+export { brandFromAccent, checkBrandContrast, hueFor, } from "./theme/derive.js";
+export type { AccentBrandOptions, DerivedBrand, RefusedBrand } from "./theme/derive.js";
+export { checkContrast, coloursIn, composite, contrast, luminance, } from "./theme/contrast.js";
+export type { ContrastFinding, Rgba } from "./theme/contrast.js";
+export { DARK, LIGHT, SCHEMES } from "./theme/palettes.js";
+export { googleCalendar, googleCalendarMapping } from "./sync/google-calendar.js";
+export type { Fetcher, GoogleCalendarOptions } from "./sync/google-calendar.js";
+export { syncConflictInvariant, SYNC_CONFLICTS } from "./sync/conflict.js";
+export type { SyncConflictOptions } from "./sync/conflict.js";
+export { SyncEngine } from "./sync/engine.js";
+export type { SyncConflict, SyncOptions, SyncReport } from "./sync/engine.js";
+export { EMPTY_SYNC_STATE, systemAuthor } from "./sync/types.js";
+export type { RemoteAck, RemoteChange, RemoteLink, RemoteSystem, RemoteWrite, ResourceMapping, SyncMapping, SyncState, } from "./sync/types.js";
+export { checkpoint, checkpointOn, checkpointsBetween, effectivity, isEffectiveBetween, isEffectiveOn, isoDate, } from "./temporal/effectivity.js";
+export type { Checkpoint, Effectivity } from "./temporal/effectivity.js";
+export { article, fieldWords, humaniseField, nounOf, readableFields, summarise, withArticle } from "./schema/define-node.js";
+export type { ReadableField } from "./schema/define-node.js";
+export { TEXT_PAIRS } from "./theme/types.js";
+export { checkKitContrast, connectorHueColour, connectorKitFor, DEFAULT_KIT, kitVariables, resolveKit } from "./theme/kit.js";
+export type { ConnectorKit, ConnectorRoute, Kit, KitContrastFinding, KitEndCap, KitOverrides, KitStrokePattern } from "./theme/kit.js";
+export type { Brand, Scheme, TextPair, ThemeTokens } from "./theme/types.js";
+export type { Grant, Policy, Principal, Refusal } from "./permissions/types.js";
+export { Store, violationKey } from "./store.js";
+export type { ApplyOptions, ApplyResult, Preview, StoreOptions, UndoPreview, } from "./store.js";
+export { createViewRegistry, FIDELITIES, placeSlug } from "./views/types.js";
+export { FIGURES, FIGURE_NAMES, figureBrief, figureFaults, figureSvg } from "./schema/figures.js";
+export type { Figure } from "./schema/figures.js";
+export type { Cardinality, Fidelity, ViewCell, ViewRegistration, ViewMeta, Place, ViewRegistry, } from "./views/types.js";
+export { createMemoryAdapter } from "./persistence/memory.js";
+export { createSqliteAdapter, SQLITE_TABLE_SHAPE } from "./persistence/sqlite.js";
+export type { SqliteAdapterOptions, SqliteDatabase, SqliteStatement } from "./persistence/sqlite.js";
+export type { PersistenceAdapter } from "./persistence/types.js";
+export { extendInvariants, extendMutations } from "./extend.js";
+export { bindSchema } from "./bind.js";
+export type { SchemaBinding } from "./bind.js";
+export { formField, formFields, formComplete } from "./mutations/form.js";
+export type { FormField, ScalarField } from "./mutations/form.js";
+export { resolveModules } from "./modules.js";
+export { declareInstallation, INSTALLATION_MODULE } from "./installation.js";
+export type { Installation, InstallationOf, InstallationOptions } from "./installation.js";
+export type { ModuleDeclaration, ModuleMap, ModuleProjection } from "./modules.js";
+export type { IntelligenceCapability, IntelligenceKind, IntelligenceProviderDeclaration, IntelligenceReach, MigrationDeclaration, SettingDeclaration, } from "./app.js";
+export { capabilitiesOf, describeCapability, providerCan } from "./app.js";
+export { undecidableArguments } from "./mutations/decidable.js";
+export type { UndecidableArgument } from "./mutations/decidable.js";
+export { motion, readerSettings, textSize } from "./settings.js";
+export { DECISION_BRIDGE_PATH, LOCAL_BRIDGE_PATH } from "./intelligence-bridge.js";
+export { STUDIO_DOOR_PATH } from "./studio-door.js";
+export type { DeclarationChange, StudioDoorAnswer, StudioDoorAsk, StudioDoorDiagnostic, StudioDoorSource, StudioDoorStatus, } from "./studio-door.js";
+export type { DecisionBridgeAnswer, DecisionBridgeAsk, DecisionBridgeStatus, LocalBridgeAnswer, LocalBridgeAsk, LocalBridgeStatus, } from "./intelligence-bridge.js";
+export { describeApp } from "./cli/describe.js";
+export type { DescribeOptions } from "./cli/describe.js";
+export { beginning } from "./beginning.js";
+export type { Beginning, KindBeginning } from "./beginning.js";
+export { defineApp } from "./app.js";
+export type { EntityBinding, GraviewApp, LensDeclaration } from "./app.js";
+export { checkApp, formatFindings } from "./cli/check.js";
+export type { CheckResult, Finding, Severity } from "./cli/check.js";
+export { generateAgentsMd, generateLlmsTxt } from "./cli/docs.js";
+export { BLOCK, cityExtent, cityMap, MAX_SIDE, plotsOverlap, roadsOf, sharedEdges, sideFor, toIso } from "./city.js";
+export type { CityHints, CityMap, Plot, Road } from "./city.js";
+export { foldPresence, PRESENCE_TTL_MS, samePresence } from "./presence.js";
+export type { Presence, PresenceChannel, PresenceRobot } from "./presence.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,90 @@
+/*
+ * ONE COPY OF ZOD, AND IT IS THIS ONE.
+ *
+ * A kind's fields are a `z.ZodObject`, so a project building one with a
+ * DIFFERENT copy of zod hands `defineNode` a nominally incompatible type —
+ * and comparing a declared field schema across two copies exhausts tsc's
+ * heap rather than saying so. The scaffolder used to answer that with a
+ * `paths` entry pointing at an exact version inside the framework's own
+ * pnpm store, which typechecks until the framework bumps zod and then reads
+ * as a corrupted install.
+ *
+ * Re-exporting is the answer that cannot drift: a project writes
+ * `import { z } from "@graview/core"` and gets the copy the framework was
+ * built with, for types and at runtime, with nothing to pin and nothing to
+ * keep in step.
+ */
+export { z } from "zod";
+// Schema — the single declaration everything else derives from.
+export { defineNode, isCurrent, labelOf, describeNode, tellApart } from "./schema/define-node.js";
+export { nameOfAuthor } from "./who.js";
+export { createSchema, SchemaError } from "./schema/schema.js";
+export { mutationToolSchema, nodeJsonSchema, schemaJson, toJsonSchema, } from "./schema/json-schema.js";
+// Graph — the reactive in-memory model the framework owns.
+export { Graph, GraphError } from "./graph/graph.js";
+export { diffSnapshots, EMPTY_DIFF, isEmptyDiff } from "./graph/diff.js";
+export { invert, isUnset, normalise, UNSET, writesOf } from "./graph/primitives.js";
+export { TrackedReader } from "./graph/tracked.js";
+export { edgeId } from "./graph/types.js";
+// Invariants — pure evaluation, with repairs as the seam to affordances.
+export { defineInvariant, evaluate, UnregisteredInvariantError, violationsTouching } from "./invariants/engine.js";
+// Arrangement — what a kind can be sorted, filtered and grouped by, and the grammar that carries it.
+export { admitArrangement, arrange, arrangeable, arrangeAllows, asksForThePast, bucketStart, conditionHolds, edgesOf, formatArrangement, matches, NO_ARRANGEMENT, parseArrangement, } from "./arrange.js";
+// Search — one matcher finds a record, a kind, a place, an act or a rule; the graph is the result list.
+export { actsOn, describeSearched, fold, fragmentOf, matchNode, parseQuery, search, searchableFields, squeeze, strengthOf, touchWeights, } from "./search.js";
+// Mutations — the only writes.
+export { compileMutation, defineMutation, takesAnId } from "./mutations/define-mutation.js";
+export { deriveEditMutations, deriveMutations, deriveRemoveMutations, derivedVia, editMutationName, editVia, removeMutationName, removeVia, fieldWriters, fieldsWrittenBy, settableFields, subjectKindsOf, unwrittenFields, } from "./mutations/derive-edits.js";
+export { argShape, describeArg, nodeRef, nodeRefArgs, nodeRefKinds, } from "./mutations/node-ref.js";
+// Operation log — attribution, causality, selective undo.
+export { OperationLog } from "./ops/log.js";
+export { checkUndo, undoPrimitives } from "./ops/undo.js";
+export { permits, permittedMutations, rolesOf, rolesWhoCould, whyNot, } from "./permissions/policy.js";
+export { PermissionDeniedError } from "./permissions/types.js";
+export { brandFromAccent, checkBrandContrast, hueFor, } from "./theme/derive.js";
+export { checkContrast, coloursIn, composite, contrast, luminance, } from "./theme/contrast.js";
+export { DARK, LIGHT, SCHEMES } from "./theme/palettes.js";
+export { googleCalendar, googleCalendarMapping } from "./sync/google-calendar.js";
+export { syncConflictInvariant, SYNC_CONFLICTS } from "./sync/conflict.js";
+export { SyncEngine } from "./sync/engine.js";
+export { EMPTY_SYNC_STATE, systemAuthor } from "./sync/types.js";
+export { checkpoint, checkpointOn, checkpointsBetween, effectivity, isEffectiveBetween, isEffectiveOn, isoDate, } from "./temporal/effectivity.js";
+export { article, fieldWords, humaniseField, nounOf, readableFields, summarise, withArticle } from "./schema/define-node.js";
+export { TEXT_PAIRS } from "./theme/types.js";
+export { checkKitContrast, connectorHueColour, connectorKitFor, DEFAULT_KIT, kitVariables, resolveKit } from "./theme/kit.js";
+// Store — graph + log + mutations + invariants, one object.
+export { Store, violationKey } from "./store.js";
+// Views — the cardinality x fidelity matrix.
+export { createViewRegistry, FIDELITIES, placeSlug } from "./views/types.js";
+export { FIGURES, FIGURE_NAMES, figureBrief, figureFaults, figureSvg } from "./schema/figures.js";
+// Persistence — pluggable underneath the framework-owned graph.
+export { createMemoryAdapter } from "./persistence/memory.js";
+/*
+ * The sqlite adapter, exported so `graview serve --sqlite` can reach it.
+ * It takes a database OBJECT rather than opening one, so `better-sqlite3`
+ * is the caller's dependency and never this package's — nothing here is a
+ * native module and nothing here needs building.
+ */
+export { createSqliteAdapter, SQLITE_TABLE_SHAPE } from "./persistence/sqlite.js";
+// Extending a schema without rewriting what was written against the base.
+export { extendInvariants, extendMutations } from "./extend.js";
+// Schema binding — infers mutation and invariant types from one schema.
+export { bindSchema } from "./bind.js";
+// App bundle, checks and generated agent docs.
+export { formField, formFields, formComplete } from "./mutations/form.js";
+export { resolveModules } from "./modules.js";
+export { declareInstallation, INSTALLATION_MODULE } from "./installation.js";
+export { capabilitiesOf, describeCapability, providerCan } from "./app.js";
+export { undecidableArguments } from "./mutations/decidable.js";
+export { motion, readerSettings, textSize } from "./settings.js";
+export { DECISION_BRIDGE_PATH, LOCAL_BRIDGE_PATH } from "./intelligence-bridge.js";
+export { STUDIO_DOOR_PATH } from "./studio-door.js";
+export { describeApp } from "./cli/describe.js";
+export { beginning } from "./beginning.js";
+export { defineApp } from "./app.js";
+export { checkApp, formatFindings } from "./cli/check.js";
+export { generateAgentsMd, generateLlmsTxt } from "./cli/docs.js";
+// The city: a map drawn from the declaration, in lattice cells.
+export { BLOCK, cityExtent, cityMap, MAX_SIDE, plotsOverlap, roadsOf, sharedEdges, sideFor, toIso } from "./city.js";
+export { foldPresence, PRESENCE_TTL_MS, samePresence } from "./presence.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/installation.d.ts

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import type { AnyMutationDefinition } from "./mutations/types.js";
+import type { ModuleMap } from "./modules.js";
+import type { Grant, Policy } from "./permissions/types.js";
+import type { AnyNodeDefinition } from "./schema/types.js";
+export interface InstallationOptions<R extends string = string> {
+    /** Every role the policy knows. A user holds some of them. */
+    readonly roles: readonly R[];
+    /** The role that administers: invites, welcomes, removes, grants, revokes. */
+    readonly admin: R;
+    /** Plural nouns for the two kinds, if "People" and "Invitations" are wrong here. */
+    readonly plurals?: {
+        readonly user?: string;
+        readonly invitation?: string;
+    };
+    /**
+     * People are not optional in this app.
+     *
+     * An installation without people is a household of one — a graph with no
+     * user nodes, not a disabled module — and an app whose domain points at a
+     * person ("who looks after this ground") has no way to say so otherwise:
+     * it either drops the module, drawing the installation for everybody, or
+     * carries a `module-edge-leak` warning per edge forever. Declared
+     * required, the module is never off, and the checker stops asking a
+     * question with only one answer.
+     */
+    readonly required?: boolean;
+}
+export interface InstallationOf<U extends AnyNodeDefinition = AnyNodeDefinition, I extends AnyNodeDefinition = AnyNodeDefinition> {
+    /**
+     * The two kinds, ready for `createSchema([...yours, ...installation.kinds])`.
+     *
+     * WITH THEIR OWN TYPES, as a tuple, because they are statically known —
+     * they are built a few lines down from here. They used to be widened to
+     * `AnyNodeDefinition[]`, and an app that spread them lost every kind name
+     * in its schema type, so every app spread them as an empty tuple instead
+     * and `user` ended up in the graph and not in the type. That is fine until
+     * the domain wants to point at a person — "who looks after this ground",
+     * "whose round is this", "who reported it" — because `ValidateEdgeTargets`
+     * is a TYPE-level check: the runtime resolved the edge perfectly and tsc
+     * refused to compile it. No first-party app had ever pointed at a person,
+     * which is why it survived this long.
+     */
+    readonly kinds: readonly [U, I];
+    /** The acts, ready for `mutations: [...yours, ...installation.mutations]`. */
+    readonly mutations: readonly AnyMutationDefinition<never>[];
+    /** The module, drawn only for those who administer it. */
+    readonly modules: ModuleMap;
+    /** The policy's grants for the acts, and the self grant for a profile. */
+    readonly grants: readonly Grant[];
+    /** Your policy with the installation's grants and roles folded in. */
+    withPolicy(policy?: Policy): Policy;
+}
+export declare const INSTALLATION_MODULE = "installation";
+/**
+ * What `declareInstallation` gives back, with the two kinds' own types.
+ *
+ * Inferred rather than annotated: the shapes are built inside the function
+ * from the roles it was handed, so writing them out by hand would be a
+ * second copy of the declaration that could disagree with the first.
+ */
+export type Installation<R extends string = string> = ReturnType<typeof declareInstallation<R>>;
+/**
+ * Declares the installation's kinds and acts for a set of roles.
+ *
+ * `admin` names the role that runs the acts. Every other role may edit its
+ * own profile and nothing else here; the app's own policy says the rest.
+ */
+export declare function declareInstallation<const R extends string>(options: InstallationOptions<R>): {
+    kinds: readonly [import("./index.js").NodeDefinition<"user", z.ZodObject<{
+        label: z.ZodString;
+        email: z.ZodString;
+        roles: z.ZodArray<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+        status: z.ZodEnum<{
+            active: "active";
+            removed: "removed";
+        }>;
+    }, z.core.$strip>, import("./index.js").EmptyEdgeMap>, import("./index.js").NodeDefinition<"invitation", z.ZodObject<{
+        label: z.ZodString;
+        email: z.ZodString;
+        roles: z.ZodArray<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+        status: z.ZodEnum<{
+            pending: "pending";
+            accepted: "accepted";
+            revoked: "revoked";
+        }>;
+    }, z.core.$strip>, {
+        readonly became: {
+            readonly to: readonly ["user"];
+            readonly description: "who it became";
+            readonly inverse: "the invitation they came by";
+            readonly appendOnly: true;
+        };
+    }>];
+    mutations: readonly AnyMutationDefinition<never>[];
+    modules: {
+        installation: {
+            required?: true | undefined;
+            description: string;
+            kinds: string[];
+            mutations: ("invite" | "welcome" | "revoke-invitation" | "remove-user" | "grant" | "revoke")[];
+            visibility: "admin";
+        };
+    };
+    grants: readonly Grant[];
+    withPolicy(policy?: Policy): Policy;
+};
+//# sourceMappingURL=installation.d.ts.map

package/dist/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../src/installation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAoB3D,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC5D,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc,CAC7B,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAC/C,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAE/C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5D,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,sEAAsE;IACtE,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAGhG;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAsKzD,SAAS,qBAAqB,CAAC,KAAK,CAAC,EAAE;;;;;;;;;;;wBAWjD,MAAM,GAAG,MAAM;EAYtC"}

package/dist/installation.js

@@ -0,0 +1,193 @@
+import { z } from "zod";
+import { defineMutation } from "./mutations/define-mutation.js";
+import { nodeRef } from "./mutations/node-ref.js";
+import { defineNode } from "./schema/define-node.js";
+export const INSTALLATION_MODULE = "installation";
+/**
+ * Declares the installation's kinds and acts for a set of roles.
+ *
+ * `admin` names the role that runs the acts. Every other role may edit its
+ * own profile and nothing else here; the app's own policy says the rest.
+ */
+export function declareInstallation(options) {
+    const roles = options.roles;
+    if (roles.length === 0)
+        throw new Error("declareInstallation needs at least one role.");
+    if (!roles.includes(options.admin)) {
+        throw new Error(`declareInstallation: the admin role "${options.admin}" is not one of the roles.`);
+    }
+    const role = z.enum(roles);
+    const user = defineNode("user", {
+        description: "Somebody who may use this installation, and the roles they hold.",
+        fields: z.object({
+            label: z.string().min(1),
+            email: z.string().min(3),
+            roles: z.array(role),
+            status: z.enum(["active", "removed"]),
+        }),
+        plural: options.plurals?.user ?? "People",
+        label: (node) => node.label,
+        // A removed person leaves the picture and never the record: what they did
+        // is still theirs in the log.
+        lifecycle: { field: "status", retired: ["removed"] },
+    });
+    const invitation = defineNode("invitation", {
+        description: "Somebody asked to join, and the roles they will hold when they do.",
+        fields: z.object({
+            label: z.string().min(1),
+            email: z.string().min(3),
+            roles: z.array(role),
+            status: z.enum(["pending", "accepted", "revoked"]),
+        }),
+        edges: {
+            // One edge, two readings: from the invitation, who it became; from
+            // the person, how they came in.
+            became: {
+                to: ["user"],
+                description: "who it became",
+                inverse: "the invitation they came by",
+                appendOnly: true,
+            },
+        },
+        plural: options.plurals?.invitation ?? "Invitations",
+        label: (node) => node.label,
+        lifecycle: { field: "status", retired: ["accepted", "revoked"] },
+    });
+    const invite = defineMutation("invite", {
+        title: "Invite somebody",
+        description: "Ask somebody to join, with the roles they will hold when they do.",
+        creates: ["invitation"],
+        input: z.object({ email: z.string().min(3), roles: z.array(role).min(1) }),
+        describe: (args) => `Invite ${args.email} as ${args.roles.join(", ")}`,
+        apply(ctx, args) {
+            ctx.addNode({
+                id: ctx.freshId(args.email, "invitation"),
+                kind: "invitation",
+                label: args.email,
+                email: args.email,
+                roles: args.roles,
+                status: "pending",
+            });
+        },
+    });
+    const welcome = defineMutation("welcome", {
+        title: "Welcome them in",
+        description: "An invitation is accepted: the person exists, with the roles they were invited to hold.",
+        subject: { kinds: ["invitation"], arg: "invitationId" },
+        creates: ["user"],
+        connects: ["became"],
+        writes: ["status"],
+        input: z.object({ invitationId: nodeRef(["invitation"]), label: z.string().min(1) }),
+        describe: (args) => `Welcome ${args.label}`,
+        apply(ctx, args) {
+            const asked = ctx.graph.getNode(args.invitationId);
+            if (!asked || asked["status"] !== "pending") {
+                throw new Error("Only a pending invitation can be welcomed.");
+            }
+            const id = ctx.freshId(args.label, "user");
+            ctx.addNode({
+                id,
+                kind: "user",
+                label: args.label,
+                email: asked["email"],
+                roles: asked["roles"],
+                status: "active",
+            });
+            ctx.addEdge({ kind: "became", from: args.invitationId, to: id });
+            ctx.patchNode(args.invitationId, { status: "accepted" });
+        },
+    });
+    const revokeInvitation = defineMutation("revoke-invitation", {
+        title: "Withdraw the invitation",
+        description: "An invitation that will not be accepted.",
+        subject: { kinds: ["invitation"], arg: "invitationId" },
+        writes: ["status"],
+        input: z.object({ invitationId: nodeRef(["invitation"]) }),
+        describe: (args) => `Withdraw ${args.invitationId}`,
+        apply(ctx, args) {
+            ctx.patchNode(args.invitationId, { status: "revoked" });
+        },
+    });
+    const removeUser = defineMutation("remove-user", {
+        title: "Remove them",
+        description: "They may no longer use this installation. What they did stays theirs in the record.",
+        subject: { kinds: ["user"], arg: "userId" },
+        writes: ["status"],
+        destructive: true,
+        input: z.object({ userId: nodeRef(["user"]) }),
+        describe: (args) => `Remove ${args.userId}`,
+        apply(ctx, args) {
+            ctx.patchNode(args.userId, { status: "removed" });
+        },
+    });
+    const grant = defineMutation("grant", {
+        title: "Give a role",
+        description: "Somebody holds one more role, and may do what it may.",
+        subject: { kinds: ["user"], arg: "userId" },
+        writes: ["roles"],
+        input: z.object({ userId: nodeRef(["user"]), role }),
+        describe: (args) => `Give ${args.userId} the ${args.role} role`,
+        apply(ctx, args) {
+            const held = ctx.graph.getNode(args.userId)?.roles ?? [];
+            if (held.includes(args.role))
+                return;
+            ctx.patchNode(args.userId, { roles: [...held, args.role] });
+        },
+    });
+    const revoke = defineMutation("revoke", {
+        title: "Take a role away",
+        description: "Somebody holds one role fewer.",
+        subject: { kinds: ["user"], arg: "userId" },
+        writes: ["roles"],
+        input: z.object({ userId: nodeRef(["user"]), role }),
+        describe: (args) => `Take the ${args.role} role from ${args.userId}`,
+        apply(ctx, args) {
+            const held = ctx.graph.getNode(args.userId)?.roles ?? [];
+            if (!held.includes(args.role))
+                return;
+            ctx.patchNode(args.userId, { roles: held.filter((r) => r !== args.role) });
+        },
+    });
+    const acts = [invite, welcome, revokeInvitation, removeUser, grant, revoke];
+    const grants = [
+        {
+            roles: [options.admin],
+            mutations: acts.map((act) => act.name),
+            describe: `The ${options.admin} keeps the installation: who is here, and what each of them may do.`,
+        },
+        {
+            // A person's profile is theirs: the derived edit of a user, on their own record only.
+            roles: "*",
+            mutations: ["edit-user"],
+            kinds: ["user"],
+            self: true,
+            describe: "Anyone may change their own name and address.",
+        },
+    ];
+    return {
+        kinds: [user, invitation],
+        mutations: acts,
+        modules: {
+            [INSTALLATION_MODULE]: {
+                description: "Who may use this installation, who has been asked to, and what each may do.",
+                kinds: ["user", "invitation"],
+                mutations: acts.map((act) => act.name),
+                visibility: "admin",
+                ...(options.required ? { required: true } : {}),
+            },
+        },
+        grants,
+        withPolicy(policy) {
+            return {
+                roles: [...new Set([...(policy?.roles ?? []), ...roles])],
+                grants: [...(policy?.grants ?? []), ...grants],
+            };
+        },
+        /*
+         * INFERRED, AND STILL HELD TO THE SHAPE. `satisfies` keeps the two
+         * kinds' own types — which is the whole point — while the interface goes
+         * on being a contract the compiler checks rather than a comment.
+         */
+    };
+}
+//# sourceMappingURL=installation.js.map

package/dist/installation.js.map

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

package/dist/intelligence-bridge.d.ts

@@ -0,0 +1,73 @@
+/**
+ * THE LOCAL DOOR'S CONTRACT — what a page and a dev server agree on.
+ *
+ * `reach: ["local"]` says a provider can be reached by a process on this
+ * machine. This is the whole of what the two sides share: one path and three
+ * message shapes. It carries no Node and no DOM, so the browser bundle and
+ * the dev-server plugin can both hold it, and neither has to import the
+ * other — which matters here, because the plugin lives a tier above the
+ * hook that probes it.
+ *
+ * Not to be confused with a model running IN the browser (`localCompletion`
+ * in `@graview/tools`, which downloads weights and runs them on WebGPU).
+ * This door is a process on the machine the dev server is running on:
+ * somebody's own CLI, already installed, already logged in, already paid
+ * for, and reachable for as long as `pnpm dev` is up.
+ */
+/** Where the bridge answers unless an app says otherwise. */
+export declare const LOCAL_BRIDGE_PATH = "/__graview/local";
+/** GET — is the door open on this machine, and what is behind it? */
+export type LocalBridgeStatus = {
+    readonly available: true;
+    readonly version: string;
+} | {
+    readonly available: false;
+    readonly reason: string;
+};
+/** POST — words, and photographs as base64 data URLs. */
+export interface LocalBridgeAsk {
+    readonly prompt: string;
+    readonly photos?: readonly string[];
+}
+/** What comes back: what it said, or why there is nothing. */
+export type LocalBridgeAnswer = {
+    readonly text: string;
+} | {
+    readonly error: string;
+};
+/**
+ * THE DOOR A DECISION PROVIDER IS REACHED BY from a browser: the dev server
+ * holds the key, the page holds the questions. Same three shapes as the
+ * local door — a probe, an ask, an answer — and the same rule about who may
+ * knock: the page this server serves, and nobody else.
+ *
+ * The key is read on the SERVER side from the environment, so it is never
+ * in a bundle, a repo or the browser's storage: the person running
+ * `pnpm dev` set it once, and the page never sees it.
+ */
+export declare const DECISION_BRIDGE_PATH = "/__graview/decide";
+/** GET — is a decision provider reachable through this server, and which? */
+export type DecisionBridgeStatus = {
+    readonly available: true;
+    readonly model: string;
+} | {
+    readonly available: false;
+    readonly reason: string;
+};
+/** POST — one state, a map of typed questions. The provider's own wire shape. */
+export interface DecisionBridgeAsk {
+    readonly state: unknown;
+    readonly questions: Readonly<Record<string, unknown>>;
+}
+/** What comes back: the provider's answers under the same keys, or why not. */
+export type DecisionBridgeAnswer = {
+    readonly answers: Readonly<Record<string, unknown>>;
+    readonly usage?: {
+        readonly input_tokens?: number;
+        readonly output_tokens?: number;
+    };
+} | {
+    readonly error: string;
+    readonly status?: number;
+};
+//# sourceMappingURL=intelligence-bridge.d.ts.map

package/dist/intelligence-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence-bridge.d.ts","sourceRoot":"","sources":["../src/intelligence-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF,GACD;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}