@de-otio/trellis 0.7.0 → 0.9.0

package/dist/lib/graph/postgres/scoring.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Relationship scoring operations on Postgres.
+ *
+ * Phase 1 · B5. PORT from neo4j-graph-service.ts (scoring methods).
+ * Reuse the backend-agnostic pure formulas in scoring-engine.ts; the adapter
+ * only reads/writes edge properties on the `relationships` table.
+ *
+ * `signals` JSON column shape — the per-interaction-type breakdown. This
+ * mirrors the Neo4j edge's `i_{type}` counter properties (i_view, i_react, …)
+ * and is exactly the `InteractionCounts` interface from scoring-engine.ts:
+ *
+ *   { view, react, comment, share, depth_mode, profile_visit, content_creation }
+ *
+ * Each is a non-negative integer count. A missing column / missing key reads
+ * as 0 (see `zeroCounts` / `readCounts`).
+ */
+import type { PrismaClient } from "@prisma/client";
+import type { RecordInteractionInput, ScoreUpdate } from "../types.js";
+import { type InteractionEventConfig } from "./interaction-events.js";
+export declare class ScoringOps {
+    private readonly prisma;
+    private readonly events;
+    constructor(prisma: PrismaClient, eventConfig?: InteractionEventConfig);
+    /**
+     * Record a single interaction on an existing relationship.
+     *
+     * Bumps interactionCount, refreshes lastInteractionAt, and increments the
+     * per-type counter in the `signals` JSON column. No-op when no relationship
+     * exists (mirrors the Neo4j MATCH, which simply matches nothing).
+     *
+     * Read-modify-write of the JSON column rather than an atomic counter: Prisma
+     * has no JSON-path increment, and the Neo4j port has the same race window
+     * (interaction recording is best-effort, scores are recomputed in batch).
+     *
+     * Phase 0 (P2): ALSO append an InteractionEvent (the temporal signal the
+     * `signals` aggregate destroys). Done FIRST and fail-open, so it captures
+     * every interaction regardless of whether a Relationship row exists to bump,
+     * and never affects aggregation behavior or the user-facing path.
+     */
+    recordInteraction(input: RecordInteractionInput): Promise<void>;
+    /**
+     * Recompute computedScore + tier for ALL of a user's relationships.
+     *
+     * Batch-fetches the user's edges (one query per target type), recomputes via
+     * the scoring engine (target-type-aware), and batch-writes the new scores in
+     * a single transaction. Returns ScoreUpdate[] only for edges whose tier
+     * changed. Ports neo4j-graph-service.recomputeScores.
+     */
+    recomputeScores(userId: string): Promise<ScoreUpdate[]>;
+    /**
+     * Apply time-based multiplicative decay to a user's relationship scores.
+     *
+     * - User→User: 60-day half-life
+     * - User→Entity: 120-day half-life
+     * - Owned entities (an active OWNS / EntityOwnership row) are EXEMPT — their
+     *   score is never decayed (they auto-pin at 1.0 elsewhere).
+     * - Edges with no lastInteractionAt are skipped (nothing to decay from).
+     *
+     * Ports neo4j-graph-service.applyDecay.
+     */
+    applyDecay(userId: string): Promise<ScoreUpdate[]>;
+    /** Batch-write computedScore + tier for a set of relationship rows. */
+    private writeScoreUpdates;
+    /** The set of entity ids (from the given candidates) the user actively owns. */
+    private ownedEntityIdSet;
+    /**
+     * Resolve, for the user's entity targets:
+     *  - which the user owns (decay exemption / auto-pin), and
+     *  - the owner-proximity score per entity = the average of the user's
+     *    computedScore with each *other* active owner of that entity.
+     */
+    private resolveEntityOwnership;
+}
+//# sourceMappingURL=scoring.d.ts.map

package/dist/lib/graph/postgres/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAIV,sBAAsB,EACtB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAwCjC,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAG1B,MAAM,EAAE,YAAY,EAIrC,WAAW,CAAC,EAAE,sBAAsB;IAKtC;;;;;;;;;;;;;;;OAeG;IACG,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrE;;;;;;;OAOG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuE7D;;;;;;;;;;OAUG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgExD,uEAAuE;YACzD,iBAAiB;IAc/B,gFAAgF;YAClE,gBAAgB;IAkB9B;;;;;OAKG;YACW,sBAAsB;CAyErC"}

package/dist/lib/graph/postgres/scoring.js

@@ -0,0 +1,297 @@
+import { getCurrentTenantId } from "@de-otio/saas-foundation/tenant";
+import { InteractionEventOps, } from "./interaction-events.js";
+import { computeDecay, computeScore, ENTITY_DECAY_HALF_LIFE_DAYS, scoreToTier, USER_DECAY_HALF_LIFE_DAYS, } from "../scoring-engine.js";
+/** A fresh zeroed counter set (the canonical `signals` shape). */
+function zeroCounts() {
+    return {
+        view: 0,
+        react: 0,
+        comment: 0,
+        share: 0,
+        depth_mode: 0,
+        profile_visit: 0,
+        content_creation: 0,
+    };
+}
+/**
+ * Coerce the `signals` JSON column into a fully-populated `InteractionCounts`.
+ * Tolerates null (never recorded), partial objects, and non-numeric values.
+ */
+function readCounts(signals) {
+    const base = zeroCounts();
+    if (signals && typeof signals === "object") {
+        for (const key of Object.keys(base)) {
+            const raw = signals[key];
+            if (typeof raw === "number" && Number.isFinite(raw)) {
+                base[key] = raw;
+            }
+        }
+    }
+    return base;
+}
+export class ScoringOps {
+    prisma;
+    events;
+    constructor(prisma, 
+    // Surveillance-hardening Phase 0 (P2): InteractionEvent dual-write config.
+    // Optional so existing/test call sites keep working; production threads it
+    // from env via graph-factory. Defaults are conservative (see the helper).
+    eventConfig) {
+        this.prisma = prisma;
+        this.events = new InteractionEventOps(prisma, eventConfig);
+    }
+    /**
+     * Record a single interaction on an existing relationship.
+     *
+     * Bumps interactionCount, refreshes lastInteractionAt, and increments the
+     * per-type counter in the `signals` JSON column. No-op when no relationship
+     * exists (mirrors the Neo4j MATCH, which simply matches nothing).
+     *
+     * Read-modify-write of the JSON column rather than an atomic counter: Prisma
+     * has no JSON-path increment, and the Neo4j port has the same race window
+     * (interaction recording is best-effort, scores are recomputed in batch).
+     *
+     * Phase 0 (P2): ALSO append an InteractionEvent (the temporal signal the
+     * `signals` aggregate destroys). Done FIRST and fail-open, so it captures
+     * every interaction regardless of whether a Relationship row exists to bump,
+     * and never affects aggregation behavior or the user-facing path.
+     */
+    async recordInteraction(input) {
+        // Append-only behavioral event — independent of the aggregation below.
+        await this.events.record(input);
+        const tenantId = getCurrentTenantId();
+        if (!tenantId)
+            return;
+        const existing = await this.prisma.relationship.findUnique({
+            where: {
+                userId_targetType_targetId: {
+                    userId: input.userId,
+                    targetType: input.targetType,
+                    targetId: input.targetId,
+                },
+            },
+            select: { id: true, tenantId: true, signals: true },
+        });
+        // No-op when no relationship exists or it belongs to another tenant.
+        if (!existing || existing.tenantId !== tenantId)
+            return;
+        const counts = readCounts(existing.signals);
+        counts[input.interactionType] += 1;
+        await this.prisma.relationship.update({
+            where: { id: existing.id },
+            data: {
+                interactionCount: { increment: 1 },
+                lastInteractionAt: new Date(),
+                // InteractionCounts is a plain numeric record; widen to Prisma's JSON
+                // input type (its index signature doesn't structurally match ours).
+                signals: { ...counts },
+            },
+        });
+    }
+    /**
+     * Recompute computedScore + tier for ALL of a user's relationships.
+     *
+     * Batch-fetches the user's edges (one query per target type), recomputes via
+     * the scoring engine (target-type-aware), and batch-writes the new scores in
+     * a single transaction. Returns ScoreUpdate[] only for edges whose tier
+     * changed. Ports neo4j-graph-service.recomputeScores.
+     */
+    async recomputeScores(userId) {
+        const tenantId = getCurrentTenantId();
+        if (!tenantId)
+            return [];
+        const now = new Date();
+        const tierChanges = [];
+        const rels = await this.prisma.relationship.findMany({
+            where: { tenantId, userId },
+        });
+        // Entity owner-proximity: average the user's score with each non-self owner
+        // of the entity. Resolved with two batch queries (ownerships + the user's
+        // relationships to those owners) to avoid an N+1 over entity targets.
+        const entityTargetIds = rels
+            .filter((r) => r.targetType === "entity")
+            .map((r) => r.targetId);
+        const { ownedEntityIds, ownerScoreByEntity } = await this.resolveEntityOwnership(tenantId, userId, entityTargetIds);
+        const updates = [];
+        for (const rel of rels) {
+            const targetType = rel.targetType;
+            const isOwned = targetType === "entity" && ownedEntityIds.has(rel.targetId);
+            const computedScore = computeScore({
+                targetType,
+                connectionMethod: rel.connectionMethod ?? "discovery",
+                interactionCount: rel.interactionCount,
+                interactionsByType: readCounts(rel.signals),
+                lastInteractionAt: rel.lastInteractionAt,
+                reciprocated: targetType === "user" ? rel.reciprocated : false,
+                createdAt: rel.createdAt,
+                manualScore: rel.manualScore,
+                isOwned,
+                ownerScore: targetType === "entity"
+                    ? (ownerScoreByEntity.get(rel.targetId) ?? null)
+                    : null,
+                now,
+            });
+            // Effective score for tier resolution: owned entities pin at 1.0,
+            // otherwise a manual override wins, else the computed score.
+            const effective = isOwned ? 1.0 : (rel.manualScore ?? computedScore);
+            const newTier = scoreToTier(effective);
+            const oldTier = rel.tier;
+            updates.push({ id: rel.id, computedScore, tier: newTier });
+            if (newTier !== oldTier) {
+                tierChanges.push({
+                    userId,
+                    targetType,
+                    targetId: rel.targetId,
+                    previousScore: rel.computedScore,
+                    newScore: computedScore,
+                    previousTier: oldTier,
+                    newTier: newTier,
+                });
+            }
+        }
+        await this.writeScoreUpdates(updates);
+        return tierChanges;
+    }
+    /**
+     * Apply time-based multiplicative decay to a user's relationship scores.
+     *
+     * - User→User: 60-day half-life
+     * - User→Entity: 120-day half-life
+     * - Owned entities (an active OWNS / EntityOwnership row) are EXEMPT — their
+     *   score is never decayed (they auto-pin at 1.0 elsewhere).
+     * - Edges with no lastInteractionAt are skipped (nothing to decay from).
+     *
+     * Ports neo4j-graph-service.applyDecay.
+     */
+    async applyDecay(userId) {
+        const tenantId = getCurrentTenantId();
+        if (!tenantId)
+            return [];
+        const now = new Date();
+        const tierChanges = [];
+        const rels = await this.prisma.relationship.findMany({
+            where: {
+                tenantId,
+                userId,
+                lastInteractionAt: { not: null },
+            },
+        });
+        const ownedEntityIds = await this.ownedEntityIdSet(tenantId, userId, rels.filter((r) => r.targetType === "entity").map((r) => r.targetId));
+        const updates = [];
+        for (const rel of rels) {
+            const targetType = rel.targetType;
+            // Owned entities are exempt from decay entirely.
+            if (targetType === "entity" && ownedEntityIds.has(rel.targetId)) {
+                continue;
+            }
+            const halfLife = targetType === "user"
+                ? USER_DECAY_HALF_LIFE_DAYS
+                : ENTITY_DECAY_HALF_LIFE_DAYS;
+            const decayFactor = computeDecay(rel.lastInteractionAt, now, halfLife);
+            const decayedScore = Math.max(0, rel.computedScore * (1 - decayFactor));
+            const effective = rel.manualScore ?? decayedScore;
+            const newTier = scoreToTier(effective);
+            const oldTier = rel.tier;
+            updates.push({ id: rel.id, computedScore: decayedScore, tier: newTier });
+            if (newTier !== oldTier) {
+                tierChanges.push({
+                    userId,
+                    targetType,
+                    targetId: rel.targetId,
+                    previousScore: rel.computedScore,
+                    newScore: decayedScore,
+                    previousTier: oldTier,
+                    newTier: newTier,
+                });
+            }
+        }
+        await this.writeScoreUpdates(updates);
+        return tierChanges;
+    }
+    // ---- internals -----------------------------------------------------------
+    /** Batch-write computedScore + tier for a set of relationship rows. */
+    async writeScoreUpdates(updates) {
+        if (updates.length === 0)
+            return;
+        await this.prisma.$transaction(updates.map((u) => this.prisma.relationship.update({
+            where: { id: u.id },
+            data: { computedScore: u.computedScore, tier: u.tier },
+        })));
+    }
+    /** The set of entity ids (from the given candidates) the user actively owns. */
+    async ownedEntityIdSet(tenantId, userId, entityIds) {
+        if (entityIds.length === 0)
+            return new Set();
+        const owned = await this.prisma.entityOwnership.findMany({
+            where: {
+                tenantId,
+                userId,
+                status: "ACTIVE",
+                entityId: { in: entityIds },
+            },
+            select: { entityId: true },
+        });
+        return new Set(owned.map((o) => o.entityId));
+    }
+    /**
+     * Resolve, for the user's entity targets:
+     *  - which the user owns (decay exemption / auto-pin), and
+     *  - the owner-proximity score per entity = the average of the user's
+     *    computedScore with each *other* active owner of that entity.
+     */
+    async resolveEntityOwnership(tenantId, userId, entityIds) {
+        const ownerScoreByEntity = new Map();
+        if (entityIds.length === 0) {
+            return { ownedEntityIds: new Set(), ownerScoreByEntity };
+        }
+        const ownerships = await this.prisma.entityOwnership.findMany({
+            where: {
+                tenantId,
+                status: "ACTIVE",
+                entityId: { in: entityIds },
+            },
+            select: { entityId: true, userId: true },
+        });
+        const ownedEntityIds = new Set();
+        // entityId -> set of *other* owner user ids
+        const ownersByEntity = new Map();
+        for (const o of ownerships) {
+            if (o.userId === userId) {
+                ownedEntityIds.add(o.entityId);
+                continue;
+            }
+            let set = ownersByEntity.get(o.entityId);
+            if (!set) {
+                set = new Set();
+                ownersByEntity.set(o.entityId, set);
+            }
+            set.add(o.userId);
+        }
+        // The user's relationship score with each owner (one batch query).
+        const allOwnerIds = [
+            ...new Set([...ownersByEntity.values()].flatMap((s) => [...s])),
+        ];
+        if (allOwnerIds.length > 0) {
+            const ownerRels = await this.prisma.relationship.findMany({
+                where: {
+                    tenantId,
+                    userId,
+                    targetType: "user",
+                    targetId: { in: allOwnerIds },
+                },
+                select: { targetId: true, computedScore: true },
+            });
+            const scoreByOwner = new Map(ownerRels.map((r) => [r.targetId, r.computedScore]));
+            for (const [entityId, owners] of ownersByEntity) {
+                const scores = [...owners]
+                    .map((ownerId) => scoreByOwner.get(ownerId))
+                    .filter((s) => s !== undefined);
+                if (scores.length > 0) {
+                    ownerScoreByEntity.set(entityId, scores.reduce((a, b) => a + b, 0) / scores.length);
+                }
+            }
+        }
+        return { ownedEntityIds, ownerScoreByEntity };
+    }
+}
+//# sourceMappingURL=scoring.js.map

package/dist/lib/graph/postgres/scoring.js.map

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

package/dist/lib/graph/postgres/sync.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Sync-group operations on Postgres.
+ *
+ * Phase 1 · B6. In the Neo4j world these `sync*` methods MIRRORED Postgres data
+ * into a separate graph store (dual-write). Now the graph IS Postgres, so the
+ * group splits three ways:
+ *
+ *  - Node syncs (syncUser / syncEntity / syncPost) — the user/entity/post rows
+ *    already live in their own Postgres tables, written by the create/update
+ *    handlers, so the node mirror is a NO-OP. EXCEPTION: `syncEntity` still
+ *    owns the PostGIS location write — `entity_location` has exactly one
+ *    writer in the codebase (this method, ported from Neo4j), so SyncOps IS
+ *    constructed with the geoLookup (see postgres-graph-service.ts) and
+ *    syncEntity/removeEntity keep the geo row in sync.
+ *
+ *  - Node removals (removeUser / removeEntity / removePost) — Neo4j's
+ *    `DETACH DELETE` cascade-deleted every connected edge. In Postgres some
+ *    edge tables FK-cascade off the user/entity/post row and some do NOT, so
+ *    the non-cascading ones (`relationships`, `entity_relationships`) must be
+ *    deleted in app code to reproduce the exact `DETACH DELETE` scope.
+ *
+ *  - Edge syncs (syncPostSubjects / syncOwnership / removeOwnership) — the
+ *    `post_subjects` / `entity_ownerships` rows ARE the graph now. In the
+ *    current call paths (entity-handler, post-handler) NOTHING else writes
+ *    these tables — the handlers call db.entity.create()/db.post.create() then
+ *    delegate the edge write to the graph service. So these methods are the
+ *    real (and only) writers and must persist the rows. `syncOwnership` also
+ *    auto-pins the owner→entity RELATES_TO at score 1.0 per the GraphService
+ *    contract; `removeOwnership` un-pins it.
+ *
+ * PORT/REVIEW from neo4j-graph-service.ts (sync methods) + graph-service.ts
+ * contracts. See the report for the cascade scope and the several "is there
+ * another writer?" uncertainties flagged for human confirmation.
+ */
+import type { PrismaClient } from "@prisma/client";
+import type { EntityGeoLookup } from "../../geo/entity-geo-repository.js";
+import type { SyncEntityInput, SyncOwnershipInput, SyncPostInput, SyncPostSubjectsInput, SyncUserInput } from "../types.js";
+export declare class SyncOps {
+    private readonly prisma;
+    private readonly geoLookup?;
+    constructor(prisma: PrismaClient, geoLookup?: EntityGeoLookup | undefined);
+    /**
+     * NO-OP. The `users` row is written by the user create/update path; there is
+     * no second store to mirror now that the graph lives in Postgres. The Neo4j
+     * method only MERGEd the User node (id + role) — both already persisted in
+     * `users`, so nothing to do here.
+     */
+    syncUser(_input: SyncUserInput): Promise<void>;
+    /**
+     * The `entities` row itself is written by the entity create/update path (no
+     * node mirror needed). BUT the PostGIS location write IS this method's job:
+     * `entity_location` has exactly one writer in the codebase —
+     * neo4j-graph-service.ts `syncEntity` (verified by grep). Dropping it would
+     * silently break `discoverNearby`, so the geo dual-write is ported here
+     * verbatim (full precision; exposure coarsening is a read-time policy).
+     * Tenant comes from the input or ambient context; without it the location
+     * row can't be scoped, so the geo write is skipped (matching Neo4j).
+     */
+    syncEntity(input: SyncEntityInput): Promise<void>;
+    /**
+     * NO-OP. The `posts` row (including author + radius + createdAt) is written by
+     * the post create path. The Neo4j method MERGEd the Post node and the
+     * AUTHORED edge for visibility queries; on Postgres those are columns/joins on
+     * the existing `posts` row, so there is nothing to mirror.
+     */
+    syncPost(_input: SyncPostInput): Promise<void>;
+    /**
+     * Remove a user's graph edges that do NOT FK-cascade off the `users` row.
+     *
+     * Neo4j `DETACH DELETE (u:User)` removed every edge touching the node — both
+     * the user's own RELATES_TO/OWNS and any incoming RELATES_TO. In Postgres:
+     *  - `entity_ownerships.userId` FK-cascades on user delete → handled by FK.
+     *  - `relationships` has NO FK on `userId` or the polymorphic target, so both
+     *    directions must be deleted here: edges FROM the user (`userId = X`) and
+     *    edges pointing AT the user (`targetType='user' AND targetId = X`).
+     *
+     * Tenant-scoped to the ambient tenant when present (mirrors the other ops);
+     * with no tenant context the delete is unscoped so a hard user delete still
+     * fully detaches.
+     */
+    removeUser(userId: string): Promise<void>;
+    /**
+     * Remove an entity's graph edges that do NOT FK-cascade off the `entities` row.
+     *
+     * Neo4j `DETACH DELETE (e:Entity)` removed every connected edge. In Postgres:
+     *  - `entity_ownerships.entityId` (OWNS) and `post_subjects.entityId` (ABOUT)
+     *    both FK-cascade on entity delete → handled by FK.
+     *  - `relationships` pointing at the entity (`targetType='entity' AND
+     *    targetId = X`) has NO FK → deleted here.
+     *  - `entity_relationships` (typed entity↔entity edges) has NO FK on either
+     *    `entityId` or `relatedEntityId` → both sides deleted here.
+     *
+     * (An entity is never a RELATES_TO source — only users are — so there is no
+     * `userId = X` branch, matching the Neo4j model.)
+     */
+    removeEntity(entityId: string): Promise<void>;
+    /**
+     * NO-OP for edge cleanup. Neo4j `DETACH DELETE (p:Post)` removed the post's
+     * ABOUT edges; in Postgres `post_subjects.postId` FK-cascades on post delete,
+     * so deleting the `posts` row already removes them. There are no other
+     * non-cascading post edges to clean up here.
+     *
+     * @see uncertainty (2) in the report — this assumes the post delete path
+     *   deletes the `posts` row (triggering the cascade); this method does not
+     *   delete the post itself.
+     */
+    removePost(_postId: string): Promise<void>;
+    /**
+     * Replace the ABOUT edge set for a post (`post_subjects`).
+     *
+     * Idempotent "set" semantics, matching the Neo4j method (delete all existing
+     * ABOUT edges for the post, then recreate from `entityIds`, marking
+     * `isPrimary` for the primary entity). Implemented as a delete-then-insert
+     * inside a transaction.
+     *
+     * @see uncertainty (3) in the report — in the current post-creation flow this
+     *   appears to be the ONLY writer of `post_subjects`; if a Prisma nested
+     *   write / handler also creates these rows, this becomes a redundant
+     *   re-write and the set-replace should move to the handler.
+     */
+    syncPostSubjects(input: SyncPostSubjectsInput): Promise<void>;
+    /**
+     * Create/update the OWNS edge (`entity_ownerships`) AND auto-pin the owner's
+     * RELATES_TO to the entity at score 1.0 (tier 0).
+     *
+     * The Neo4j method only MERGEd the OWNS edge; the auto-pin is mandated by the
+     * GraphService contract ("Also ensures the user has a RELATES_TO edge to the
+     * entity at score 1.0 (auto-pinned to inner circle)") and was MISSING from
+     * the Neo4j implementation — see uncertainty (5). The pin is stored as a
+     * `manualScore` override of 1.0 so that {@link removeOwnership} can clear it
+     * and let the computed score take over.
+     *
+     * @see uncertainty (4) in the report — `SyncOwnershipInput` carries no
+     *   `addedByUserId`; the schema requires it with no default. Defaulted to
+     *   `userId` (self-added). Confirm the DTO/schema should carry it explicitly.
+     */
+    syncOwnership(input: SyncOwnershipInput): Promise<void>;
+    /**
+     * Remove the OWNS edge and un-pin the RELATES_TO.
+     *
+     * Per the contract: the RELATES_TO edge is NOT removed (the user may still
+     * follow the entity) — only the score-1.0 auto-pin is cleared by setting
+     * `manualScore` back to null, so the computed score takes over and the tier
+     * is recomputed from it. The OWNS row is hard-deleted to match the Neo4j
+     * `DELETE r` (not a status flip).
+     */
+    removeOwnership(entityId: string, userId: string): Promise<void>;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/lib/graph/postgres/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACd,MAAM,aAAa,CAAC;AAKrB,qBAAa,OAAO;IAEhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBADV,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,eAAe,YAAA;IAK9C;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;;;;;;;OASG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C;;;;;;;;;;;;;OAaG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnD;;;;;;;;;OASG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;;;;;;;;;;;OAYG;IACG,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnE;;;;;;;;;;;;;;OAcG;IACG,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwD7D;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BvE"}