@de-otio/trellis 0.7.0 → 0.9.0

package/dist/lib/graph/graph-factory.js

@@ -1,190 +1,95 @@
-"use strict";
 /**
  * Graph Service Factory
  *
- * Creates and configures the GraphService implementation (Neo4j over Bolt)
- * against either AuraDB (dev/prod) or a local Docker Neo4j (local/integration
- * tests). Both targets speak the same Cypher dialect, so the factory only
- * varies authentication and connection string.
+ * Creates and memoizes the GraphService implementation. The graph serving
+ * path runs on Postgres (PostgresGraphService — joins + recursive CTEs on
+ * the existing RDS); there is no separate graph database. (Graph-db revisit
+ * 2026-06. The Neo4j/Neptune backend was removed; restore it from git
+ * history if a dedicated graph DB is ever re-adopted.)
  *
  * @example
  * ```typescript
- * const graphService = await createGraphService({
- *   uri: "bolt://localhost:7687",
- *   user: "neo4j",
- *   password: "test-password",
- * });
- *
- * const health = await graphService.healthCheck();
+ * const graphService = await createGraphServiceFromEnv(env);
+ * const health = await graphService.healthCheck(); // backend: "postgres"
  * ```
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createGraphService = createGraphService;
-exports.createGraphServiceFromEnv = createGraphServiceFromEnv;
-const neo4j_graph_service_1 = require("./neo4j-graph-service");
 /**
- * Build a GraphConnectionConfig from environment-style config.
+ * Build the PostGIS geo-proximity lookup for discoverNearby. Tolerant of
+ * absence — if Postgres config is missing it returns undefined and
+ * geo-discovery yields empty. NOTE (residency): a single pooled client at
+ * the default region is fine for dev/single-DB; multi-residency prod should
+ * route per request.
  */
-function buildConnectionConfig(env) {
-    const auth = env.user && env.password
-        ? { type: "basic", username: env.user, password: env.password }
-        : { type: "none" };
-    return {
-        endpoint: env.uri,
-        auth,
-        pool: {
-            maxConnectionPoolSize: env.maxConnectionPoolSize,
-            connectionAcquisitionTimeout: env.connectionAcquisitionTimeout,
-            maxConnectionLifetime: env.maxConnectionLifetime,
-            connectionLivenessCheckTimeout: env.connectionLivenessCheckTimeout,
-        },
-        queryTimeoutMs: env.queryTimeoutMs,
-    };
-}
-// ---------------------------------------------------------------------------
-// Environment Variable Helpers
-// ---------------------------------------------------------------------------
-function intEnv(name) {
-    const raw = process.env[name];
-    if (raw === undefined || raw === "")
+async function buildGeoLookup(env) {
+    try {
+        const e = env;
+        if (!e?.DATABASE_URL)
+            return undefined;
+        const { createPrisma } = await import("../../db.js");
+        const { EntityGeoRepository } = await import("../geo/entity-geo-repository.js");
+        return new EntityGeoRepository(createPrisma(e));
+    }
+    catch {
         return undefined;
-    const parsed = Number.parseInt(raw, 10);
-    if (!Number.isFinite(parsed) || parsed <= 0 || String(parsed) !== raw.trim()) {
-        // Throwing at startup fails the ECS health check, triggering a
-        // rollback via ECS circuitBreaker instead of running with bad config.
-        throw new Error(`${name} must be a positive integer, got: ${JSON.stringify(raw)}`);
     }
-    return parsed;
 }
-// ---------------------------------------------------------------------------
-// Factory Function
-// ---------------------------------------------------------------------------
 /**
- * Create a connected GraphService instance.
- *
- * Reads connection config, creates the appropriate implementation,
- * and establishes the connection (including schema initialization).
+ * Process-wide shared graph service.
  *
- * @param envConfig - Connection configuration (typically from process.env)
- * @returns A connected GraphService instance that also implements GraphConnection
- * @throws GraphConnectionError if the database is unreachable
+ * createGraphServiceFromEnv is called from ~10 per-request handlers + the
+ * extension wrapper. Memoize the connected service so all callers share one
+ * instance (and one underlying Prisma client) instead of building a fresh
+ * one per request. Config comes from env, which is stable for the process,
+ * so a single instance is correct.
  */
-async function createGraphService(envConfig) {
-    const config = buildConnectionConfig(envConfig);
-    const service = new neo4j_graph_service_1.Neo4jGraphService();
-    await service.connect(config);
-    return service;
+let sharedGraphService = null;
+export async function createGraphServiceFromEnv(env) {
+    if (!sharedGraphService) {
+        sharedGraphService = buildGraphServiceFromEnv(env).catch((err) => {
+            // Don't cache a failed connection — allow the next call to retry.
+            sharedGraphService = null;
+            throw err;
+        });
+    }
+    return sharedGraphService;
 }
 /**
- * Fetch AuraDB credentials from an SSM SecureString without touching process.env.
- * The returned values live only on the returned object and are passed directly
- * into the neo4j driver; `process.env` is never mutated.
+ * Close the shared graph service and clear the cache. Call on graceful
+ * shutdown / test teardown so the process can exit cleanly.
  */
-async function fetchGraphCredentialsFromSsm(paramName, region) {
-    const { SSMClient, GetParameterCommand } = await Promise.resolve().then(() => __importStar(require("@aws-sdk/client-ssm")));
-    const client = new SSMClient({ region });
-    const response = await client.send(new GetParameterCommand({ Name: paramName, WithDecryption: true }));
-    const raw = response.Parameter?.Value;
-    if (!raw) {
-        throw new Error(`SSM parameter ${paramName} has no value`);
-    }
-    let parsed;
+export async function closeSharedGraphService() {
+    if (!sharedGraphService)
+        return;
+    const pending = sharedGraphService;
+    sharedGraphService = null;
     try {
-        parsed = JSON.parse(raw);
+        const svc = await pending;
+        await svc.close();
     }
     catch {
-        throw new Error(`SSM parameter ${paramName} is not valid JSON`);
-    }
-    const uri = parsed.NEO4J_URI;
-    const user = parsed.NEO4J_USERNAME;
-    const password = parsed.NEO4J_PASSWORD;
-    if (typeof uri !== "string" || typeof user !== "string" || typeof password !== "string") {
-        throw new Error(`SSM parameter ${paramName} missing required fields NEO4J_URI / NEO4J_USERNAME / NEO4J_PASSWORD`);
+        // best-effort
     }
-    return { uri, user, password };
 }
-/**
- * Create a GraphService from standard environment variables or SSM.
- *
- * Resolution order:
- *   1. If GRAPH_DB_URI is set, use direct env vars (local dev, integration tests).
- *   2. Else if GRAPH_DB_CREDENTIALS_SSM_PARAM is set, fetch and decrypt from SSM.
- *
- * Credentials fetched from SSM are kept in function-local scope and passed
- * directly to the neo4j driver. They never enter process.env, so child
- * processes, core dumps, and `env` in a shell exec don't leak them.
- *
- * @returns A connected GraphService instance
- * @throws GraphConnectionError if the database is unreachable
- * @throws Error if neither GRAPH_DB_URI nor GRAPH_DB_CREDENTIALS_SSM_PARAM is set
- */
-async function createGraphServiceFromEnv(_env) {
-    const region = process.env.AWS_REGION ?? "eu-central-1";
-    const isLambda = !!process.env.AWS_LAMBDA_FUNCTION_NAME;
-    const poolMax = isLambda ? 1 : intEnv("GRAPH_DB_POOL_MAX_SIZE");
-    // Direct env-var path — local dev, docker-compose, integration tests.
-    if (process.env.GRAPH_DB_URI) {
-        return createGraphService({
-            uri: process.env.GRAPH_DB_URI,
-            user: process.env.GRAPH_DB_USER,
-            password: process.env.GRAPH_DB_PASSWORD,
-            region,
-            maxConnectionPoolSize: poolMax,
-            connectionAcquisitionTimeout: intEnv("GRAPH_DB_POOL_ACQUIRE_TIMEOUT_MS"),
-            maxConnectionLifetime: intEnv("GRAPH_DB_POOL_MAX_LIFETIME_MS"),
-            connectionLivenessCheckTimeout: intEnv("GRAPH_DB_POOL_LIVENESS_CHECK_MS"),
-            queryTimeoutMs: intEnv("GRAPH_DB_QUERY_TIMEOUT_MS"),
-        });
+async function buildGraphServiceFromEnv(_env) {
+    if (process.env.GRAPH_BACKEND === "neo4j") {
+        throw new Error("GRAPH_BACKEND=neo4j is no longer supported — the Neo4j/Neptune backend " +
+            "was removed (the graph runs in Postgres; graph-db revisit 2026-06). " +
+            "Restore it from git history if a dedicated graph DB is ever re-adopted.");
     }
-    // Runtime SSM fetch — prod / dev AWS. Credentials stay in-memory only.
-    const paramName = process.env.GRAPH_DB_CREDENTIALS_SSM_PARAM;
-    if (!paramName) {
-        throw new Error("Graph DB config missing: set either GRAPH_DB_URI (local) or GRAPH_DB_CREDENTIALS_SSM_PARAM (AWS)");
+    const e = _env;
+    if (!e?.DATABASE_URL) {
+        throw new Error("Postgres graph backend requires a DATABASE_URL");
     }
-    const creds = await fetchGraphCredentialsFromSsm(paramName, region);
-    return createGraphService({
-        uri: creds.uri,
-        user: creds.user,
-        password: creds.password,
-        region,
-        maxConnectionPoolSize: poolMax,
-        connectionAcquisitionTimeout: intEnv("GRAPH_DB_POOL_ACQUIRE_TIMEOUT_MS"),
-        maxConnectionLifetime: intEnv("GRAPH_DB_POOL_MAX_LIFETIME_MS"),
-        connectionLivenessCheckTimeout: intEnv("GRAPH_DB_POOL_LIVENESS_CHECK_MS"),
-        queryTimeoutMs: intEnv("GRAPH_DB_QUERY_TIMEOUT_MS"),
-    });
+    const geoLookup = await buildGeoLookup(_env);
+    const { createPrisma } = await import("../../db.js");
+    const { PostgresGraphService } = await import("./postgres/postgres-graph-service.js");
+    // Surveillance-hardening Phase 0 (P2): thread the InteractionEvent dual-write
+    // config from env (built by env.ts), falling back to the process.env parser.
+    const { resolveInteractionEventConfig } = await import("./postgres/interaction-events.js");
+    const eventConfig = e
+        .interactionEvents ?? resolveInteractionEventConfig();
+    const service = new PostgresGraphService(createPrisma(e), geoLookup, eventConfig);
+    await service.connect({ endpoint: "postgres", auth: { type: "none" } });
+    return service;
 }
 //# sourceMappingURL=graph-factory.js.map

package/dist/lib/graph/graph-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-factory.js","sourceRoot":"","sources":["../../../src/lib/graph/graph-factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph-factory.js","sourceRoot":"","sources":["../../../src/lib/graph/graph-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;;;;;GAMG;AACH,KAAK,UAAU,cAAc,CAAC,GAAa;IACzC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,EAAE,YAAY;YAAE,OAAO,SAAS,CAAC;QACvC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAChF,OAAO,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,IAAI,kBAAkB,GAAmD,IAAI,CAAC;AAE9E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAa;IAEb,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/D,kEAAkE;YAClE,kBAAkB,GAAG,IAAI,CAAC;YAC1B,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,CAAC,kBAAkB;QAAE,OAAO;IAChC,MAAM,OAAO,GAAG,kBAAkB,CAAC;IACnC,kBAAkB,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QAC1B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,IAAc;IAEd,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,sEAAsE;YACtE,yEAAyE,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAA6B,CAAC;IACxC,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,sCAAsC,CACvC,CAAC;IACF,8EAA8E;IAC9E,6EAA6E;IAC7E,MAAM,EAAE,6BAA6B,EAAE,GAAG,MAAM,MAAM,CACpD,kCAAkC,CACnC,CAAC;IACF,MAAM,WAAW,GACd,CAA8E;SAC5E,iBAAiB,IAAI,6BAA6B,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAClF,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/graph/graph-service.d.ts

@@ -16,7 +16,7 @@
  * @see /analysis/redesign/07-graph-database/02-hybrid-architecture.md
  * @see /analysis/redesign/07-graph-database/04-graph-schema.md
  */
-import type { CircleEntityStatus, CircleMember, CircleTier, CircleTierStatus, CreateEntityRelationshipInput, CreateRelationshipInput, DiscoveryFilters, DiscoveryResult, EntityRelationship, EntityRelationshipStatus, GlanceItem, GraphConnectionConfig, GraphData, GraphHealthStatus, GraphNodeType, NearbyFilters, PaginatedResult, PaginationInput, Recommendation, RecordInteractionInput, Relationship, ScoreUpdate, SyncEntityInput, SyncOwnershipInput, SyncPostInput, SyncPostSubjectsInput, SyncUserInput, UpdateRelationshipScoreInput, VisiblePostResult } from "./types";
+import type { CircleEntityStatus, CircleMember, CircleTier, CircleTierStatus, CreateEntityRelationshipInput, CreateRelationshipInput, DiscoveryFilters, DiscoveryResult, EntityRelationship, EntityRelationshipStatus, GlanceItem, GraphConnectionConfig, GraphData, GraphHealthStatus, GraphNodeType, NearbyFilters, PaginatedResult, PaginationInput, Recommendation, RecordInteractionInput, Relationship, ScoreUpdate, SyncEntityInput, SyncOwnershipInput, SyncPostInput, SyncPostSubjectsInput, SyncUserInput, UpdateRelationshipScoreInput, VisiblePostResult } from "./types.js";
 /**
  * Abstract connection to the graph database.
  *

package/dist/lib/graph/graph-service.d.ts.map

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

package/dist/lib/graph/graph-service.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * GraphService Interface
  *
@@ -17,5 +16,5 @@
  * @see /analysis/redesign/07-graph-database/02-hybrid-architecture.md
  * @see /analysis/redesign/07-graph-database/04-graph-schema.md
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=graph-service.js.map

package/dist/lib/graph/graph-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-service.js","sourceRoot":"","sources":["../../../src/lib/graph/graph-service.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG"}
+{"version":3,"file":"graph-service.js","sourceRoot":"","sources":["../../../src/lib/graph/graph-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/lib/graph/index.d.ts

@@ -1,9 +1,10 @@
 /**
  * Graph Service
  *
- * Abstraction layer between API handlers and the graph database
- * (Neo4j AuraDB in dev/prod, Neo4j Community via Docker in local dev
- * and integration tests).
+ * Abstraction layer between API handlers and the graph backend. The graph
+ * runs in Postgres (PostgresGraphService — joins + recursive CTEs on the
+ * existing RDS); there is no separate graph database. (Graph-db revisit
+ * 2026-06.)
  *
  * @example
  * ```typescript
@@ -26,15 +27,10 @@
  * }
  * ```
  */
-export type { GraphService, GraphConnection } from "./graph-service";
-export { Neo4jGraphService } from "./neo4j-graph-service";
-export { createGraphService, createGraphServiceFromEnv, type GraphServiceEnvConfig, } from "./graph-factory";
-export { initGraphSchema, verifyGraphSchema } from "./graph-schema-init";
-export type { DualWriteService, DualWriteConfig, DualWriteFailure, DualWriteOperation, DualWritePayload, DualWriteSyncResult, ReconciliationProgress, ReconciliationResult, ConsistencyCheckResult, } from "./dual-write";
-export { GraphSyncError } from "./dual-write";
-export { DualWriteServiceImpl } from "./dual-write-service";
-export { ReconciliationService } from "./reconciliation-service";
-export type { ConnectionMethod, PostRadius, CircleTier, TierName, GraphNodeType, EntityRelationshipType, OwnershipRole, InteractionType, EntityRelationshipStatus, RecommendationReason, GraphUser, GraphEntity, GraphPost, Relationship, CreateRelationshipInput, UpdateRelationshipScoreInput, CircleMember, CircleTierStatus, CircleEntityStatus, GlanceItem, VisiblePostResult, EntityRelationship, CreateEntityRelationshipInput, DiscoveryFilters, NearbyFilters, DiscoveryResult, Recommendation, RecordInteractionInput, ScoringWeights, ScoreUpdate, GraphData, GraphNode, TierSummary, SyncUserInput, SyncEntityInput, SyncPostInput, SyncPostSubjectsInput, SyncOwnershipInput, GraphConnectionConfig, GraphAuthConfig, GraphPoolConfig, GraphHealthStatus, PaginationInput, PaginatedResult, } from "./types";
-export { computeScore, effectiveScore, scoreToTier, computeDecay, computeEngagementDepth, computeFrequencySignal, connectionBonus, computeContentCreationSignal, computeOwnerProximity, USER_WEIGHTS, ENTITY_WEIGHTS, USER_DECAY_HALF_LIFE_DAYS, ENTITY_DECAY_HALF_LIFE_DAYS, ENGAGEMENT_SCORES, CONNECTION_BONUSES, TIER_THRESHOLDS, type InteractionCounts, type ScoringInput, } from "./scoring-engine";
-export { GraphError, GraphConnectionError, GraphQueryError, GraphNotFoundError, GraphConflictError, GraphAuthorizationError, GraphTimeoutError, } from "./errors";
+export type { GraphService, GraphConnection } from "./graph-service.js";
+export { PostgresGraphService } from "./postgres/postgres-graph-service.js";
+export { createGraphServiceFromEnv, closeSharedGraphService, } from "./graph-factory.js";
+export type { ConnectionMethod, PostRadius, CircleTier, TierName, GraphNodeType, EntityRelationshipType, OwnershipRole, InteractionType, EntityRelationshipStatus, RecommendationReason, GraphUser, GraphEntity, GraphPost, Relationship, CreateRelationshipInput, UpdateRelationshipScoreInput, CircleMember, CircleTierStatus, CircleEntityStatus, GlanceItem, VisiblePostResult, EntityRelationship, CreateEntityRelationshipInput, DiscoveryFilters, NearbyFilters, DiscoveryResult, Recommendation, RecordInteractionInput, ScoringWeights, ScoreUpdate, GraphData, GraphNode, TierSummary, SyncUserInput, SyncEntityInput, SyncPostInput, SyncPostSubjectsInput, SyncOwnershipInput, GraphConnectionConfig, GraphAuthConfig, GraphPoolConfig, GraphHealthStatus, PaginationInput, PaginatedResult, } from "./types.js";
+export { computeScore, effectiveScore, scoreToTier, computeDecay, computeEngagementDepth, computeFrequencySignal, connectionBonus, computeContentCreationSignal, computeOwnerProximity, USER_WEIGHTS, ENTITY_WEIGHTS, USER_DECAY_HALF_LIFE_DAYS, ENTITY_DECAY_HALF_LIFE_DAYS, ENGAGEMENT_SCORES, CONNECTION_BONUSES, TIER_THRESHOLDS, type InteractionCounts, type ScoringInput, } from "./scoring-engine.js";
+export { GraphError, GraphConnectionError, GraphQueryError, GraphNotFoundError, GraphConflictError, GraphAuthorizationError, GraphTimeoutError, } from "./errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,YAAY,EAEV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EAEpB,SAAS,EACT,WAAW,EACX,SAAS,EAET,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAE5B,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EAEjB,kBAAkB,EAClB,6BAA6B,EAE7B,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,EAEd,sBAAsB,EACtB,cAAc,EACd,WAAW,EAEX,SAAS,EACT,SAAS,EACT,WAAW,EAEX,aAAa,EACb,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAElB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EAEjB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAEV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EAEpB,SAAS,EACT,WAAW,EACX,SAAS,EAET,YAAY,EACZ,uBAAuB,EACvB,4BAA4B,EAE5B,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EAEjB,kBAAkB,EAClB,6BAA6B,EAE7B,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,EAEd,sBAAsB,EACtB,cAAc,EACd,WAAW,EAEX,SAAS,EACT,SAAS,EACT,WAAW,EAEX,aAAa,EACb,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAElB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EAEjB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/lib/graph/index.js

@@ -1,10 +1,10 @@
-"use strict";
 /**
  * Graph Service
  *
- * Abstraction layer between API handlers and the graph database
- * (Neo4j AuraDB in dev/prod, Neo4j Community via Docker in local dev
- * and integration tests).
+ * Abstraction layer between API handlers and the graph backend. The graph
+ * runs in Postgres (PostgresGraphService — joins + recursive CTEs on the
+ * existing RDS); there is no separate graph database. (Graph-db revisit
+ * 2026-06.)
  *
  * @example
  * ```typescript
@@ -27,48 +27,14 @@
  * }
  * ```
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphTimeoutError = exports.GraphAuthorizationError = exports.GraphConflictError = exports.GraphNotFoundError = exports.GraphQueryError = exports.GraphConnectionError = exports.GraphError = exports.TIER_THRESHOLDS = exports.CONNECTION_BONUSES = exports.ENGAGEMENT_SCORES = exports.ENTITY_DECAY_HALF_LIFE_DAYS = exports.USER_DECAY_HALF_LIFE_DAYS = exports.ENTITY_WEIGHTS = exports.USER_WEIGHTS = exports.computeOwnerProximity = exports.computeContentCreationSignal = exports.connectionBonus = exports.computeFrequencySignal = exports.computeEngagementDepth = exports.computeDecay = exports.scoreToTier = exports.effectiveScore = exports.computeScore = exports.ReconciliationService = exports.DualWriteServiceImpl = exports.GraphSyncError = exports.verifyGraphSchema = exports.initGraphSchema = exports.createGraphServiceFromEnv = exports.createGraphService = exports.Neo4jGraphService = void 0;
-// Implementations
-var neo4j_graph_service_1 = require("./neo4j-graph-service");
-Object.defineProperty(exports, "Neo4jGraphService", { enumerable: true, get: function () { return neo4j_graph_service_1.Neo4jGraphService; } });
-var graph_factory_1 = require("./graph-factory");
-Object.defineProperty(exports, "createGraphService", { enumerable: true, get: function () { return graph_factory_1.createGraphService; } });
-Object.defineProperty(exports, "createGraphServiceFromEnv", { enumerable: true, get: function () { return graph_factory_1.createGraphServiceFromEnv; } });
-var graph_schema_init_1 = require("./graph-schema-init");
-Object.defineProperty(exports, "initGraphSchema", { enumerable: true, get: function () { return graph_schema_init_1.initGraphSchema; } });
-Object.defineProperty(exports, "verifyGraphSchema", { enumerable: true, get: function () { return graph_schema_init_1.verifyGraphSchema; } });
-var dual_write_1 = require("./dual-write");
-Object.defineProperty(exports, "GraphSyncError", { enumerable: true, get: function () { return dual_write_1.GraphSyncError; } });
-var dual_write_service_1 = require("./dual-write-service");
-Object.defineProperty(exports, "DualWriteServiceImpl", { enumerable: true, get: function () { return dual_write_service_1.DualWriteServiceImpl; } });
-var reconciliation_service_1 = require("./reconciliation-service");
-Object.defineProperty(exports, "ReconciliationService", { enumerable: true, get: function () { return reconciliation_service_1.ReconciliationService; } });
+// Implementation (Postgres — the only backend; the Neo4j/Neptune service and
+// the dual-write/reconciliation machinery were removed with the 2026-06
+// revisit: handlers call the sync* methods directly and there is no second
+// store to mirror or reconcile).
+export { PostgresGraphService } from "./postgres/postgres-graph-service.js";
+export { createGraphServiceFromEnv, closeSharedGraphService, } from "./graph-factory.js";
 // Scoring engine
-var scoring_engine_1 = require("./scoring-engine");
-Object.defineProperty(exports, "computeScore", { enumerable: true, get: function () { return scoring_engine_1.computeScore; } });
-Object.defineProperty(exports, "effectiveScore", { enumerable: true, get: function () { return scoring_engine_1.effectiveScore; } });
-Object.defineProperty(exports, "scoreToTier", { enumerable: true, get: function () { return scoring_engine_1.scoreToTier; } });
-Object.defineProperty(exports, "computeDecay", { enumerable: true, get: function () { return scoring_engine_1.computeDecay; } });
-Object.defineProperty(exports, "computeEngagementDepth", { enumerable: true, get: function () { return scoring_engine_1.computeEngagementDepth; } });
-Object.defineProperty(exports, "computeFrequencySignal", { enumerable: true, get: function () { return scoring_engine_1.computeFrequencySignal; } });
-Object.defineProperty(exports, "connectionBonus", { enumerable: true, get: function () { return scoring_engine_1.connectionBonus; } });
-Object.defineProperty(exports, "computeContentCreationSignal", { enumerable: true, get: function () { return scoring_engine_1.computeContentCreationSignal; } });
-Object.defineProperty(exports, "computeOwnerProximity", { enumerable: true, get: function () { return scoring_engine_1.computeOwnerProximity; } });
-Object.defineProperty(exports, "USER_WEIGHTS", { enumerable: true, get: function () { return scoring_engine_1.USER_WEIGHTS; } });
-Object.defineProperty(exports, "ENTITY_WEIGHTS", { enumerable: true, get: function () { return scoring_engine_1.ENTITY_WEIGHTS; } });
-Object.defineProperty(exports, "USER_DECAY_HALF_LIFE_DAYS", { enumerable: true, get: function () { return scoring_engine_1.USER_DECAY_HALF_LIFE_DAYS; } });
-Object.defineProperty(exports, "ENTITY_DECAY_HALF_LIFE_DAYS", { enumerable: true, get: function () { return scoring_engine_1.ENTITY_DECAY_HALF_LIFE_DAYS; } });
-Object.defineProperty(exports, "ENGAGEMENT_SCORES", { enumerable: true, get: function () { return scoring_engine_1.ENGAGEMENT_SCORES; } });
-Object.defineProperty(exports, "CONNECTION_BONUSES", { enumerable: true, get: function () { return scoring_engine_1.CONNECTION_BONUSES; } });
-Object.defineProperty(exports, "TIER_THRESHOLDS", { enumerable: true, get: function () { return scoring_engine_1.TIER_THRESHOLDS; } });
+export { computeScore, effectiveScore, scoreToTier, computeDecay, computeEngagementDepth, computeFrequencySignal, connectionBonus, computeContentCreationSignal, computeOwnerProximity, USER_WEIGHTS, ENTITY_WEIGHTS, USER_DECAY_HALF_LIFE_DAYS, ENTITY_DECAY_HALF_LIFE_DAYS, ENGAGEMENT_SCORES, CONNECTION_BONUSES, TIER_THRESHOLDS, } from "./scoring-engine.js";
 // Errors
-var errors_1 = require("./errors");
-Object.defineProperty(exports, "GraphError", { enumerable: true, get: function () { return errors_1.GraphError; } });
-Object.defineProperty(exports, "GraphConnectionError", { enumerable: true, get: function () { return errors_1.GraphConnectionError; } });
-Object.defineProperty(exports, "GraphQueryError", { enumerable: true, get: function () { return errors_1.GraphQueryError; } });
-Object.defineProperty(exports, "GraphNotFoundError", { enumerable: true, get: function () { return errors_1.GraphNotFoundError; } });
-Object.defineProperty(exports, "GraphConflictError", { enumerable: true, get: function () { return errors_1.GraphConflictError; } });
-Object.defineProperty(exports, "GraphAuthorizationError", { enumerable: true, get: function () { return errors_1.GraphAuthorizationError; } });
-Object.defineProperty(exports, "GraphTimeoutError", { enumerable: true, get: function () { return errors_1.GraphTimeoutError; } });
+export { GraphError, GraphConnectionError, GraphQueryError, GraphNotFoundError, GraphConflictError, GraphAuthorizationError, GraphTimeoutError, } from "./errors.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/graph/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAKH,kBAAkB;AAClB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,iDAIyB;AAHvB,mHAAA,kBAAkB,OAAA;AAClB,0HAAA,yBAAyB,OAAA;AAG3B,yDAAyE;AAAhE,oHAAA,eAAe,OAAA;AAAE,sHAAA,iBAAiB,OAAA;AAc3C,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,2DAA4D;AAAnD,0HAAA,oBAAoB,OAAA;AAC7B,mEAAiE;AAAxD,+HAAA,qBAAqB,OAAA;AA6D9B,iBAAiB;AACjB,mDAmB0B;AAlBxB,8GAAA,YAAY,OAAA;AACZ,gHAAA,cAAc,OAAA;AACd,6GAAA,WAAW,OAAA;AACX,8GAAA,YAAY,OAAA;AACZ,wHAAA,sBAAsB,OAAA;AACtB,wHAAA,sBAAsB,OAAA;AACtB,iHAAA,eAAe,OAAA;AACf,8HAAA,4BAA4B,OAAA;AAC5B,uHAAA,qBAAqB,OAAA;AACrB,8GAAA,YAAY,OAAA;AACZ,gHAAA,cAAc,OAAA;AACd,2HAAA,yBAAyB,OAAA;AACzB,6HAAA,2BAA2B,OAAA;AAC3B,mHAAA,iBAAiB,OAAA;AACjB,oHAAA,kBAAkB,OAAA;AAClB,iHAAA,eAAe,OAAA;AAKjB,SAAS;AACT,mCAQkB;AAPhB,oGAAA,UAAU,OAAA;AACV,8GAAA,oBAAoB,OAAA;AACpB,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,4GAAA,kBAAkB,OAAA;AAClB,iHAAA,uBAAuB,OAAA;AACvB,2GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,6EAA6E;AAC7E,wEAAwE;AACxE,2EAA2E;AAC3E,iCAAiC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AA6D5B,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAGhB,MAAM,qBAAqB,CAAC;AAE7B,SAAS;AACT,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Shared helpers for the Postgres GraphService adapter.
+ *
+ * Graph-DB revisit (2026-06): the graph serving path runs in Postgres
+ * (joins + recursive CTEs), no separate graph DB. See
+ * plans/redesign/graph-backend-contract.md.
+ *
+ * Phase 0 lands the scaffold (this dir) behind the `GRAPH_BACKEND=postgres`
+ * factory flag; the default backend stays Neo4j, so nothing changes until
+ * Phase 1 fills in each group module and the flag is flipped.
+ */
+/** Thrown by not-yet-ported adapter methods so a premature flip fails loudly. */
+export declare class GraphNotImplementedError extends Error {
+    constructor(group: string, method: string);
+}
+/** Stub marker for unported methods. Returns `never` (always throws). */
+export declare function ni(group: string, method: string): never;
+//# sourceMappingURL=_shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iFAAiF;AACjF,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO1C;AAED,yEAAyE;AACzE,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAEvD"}

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

@@ -0,0 +1,24 @@
+/**
+ * Shared helpers for the Postgres GraphService adapter.
+ *
+ * Graph-DB revisit (2026-06): the graph serving path runs in Postgres
+ * (joins + recursive CTEs), no separate graph DB. See
+ * plans/redesign/graph-backend-contract.md.
+ *
+ * Phase 0 lands the scaffold (this dir) behind the `GRAPH_BACKEND=postgres`
+ * factory flag; the default backend stays Neo4j, so nothing changes until
+ * Phase 1 fills in each group module and the flag is flipped.
+ */
+/** Thrown by not-yet-ported adapter methods so a premature flip fails loudly. */
+export class GraphNotImplementedError extends Error {
+    constructor(group, method) {
+        super(`PostgresGraphService.${method} not yet implemented (Phase 1 — ${group}). ` +
+            `See plans/redesign/graph-db/graph-db-postgres-migration-plan.md`);
+        this.name = "GraphNotImplementedError";
+    }
+}
+/** Stub marker for unported methods. Returns `never` (always throws). */
+export function ni(group, method) {
+    throw new GraphNotImplementedError(group, method);
+}
+//# sourceMappingURL=_shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,iFAAiF;AACjF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CACH,wBAAwB,MAAM,mCAAmC,KAAK,KAAK;YACzE,iEAAiE,CACpE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,UAAU,EAAE,CAAC,KAAa,EAAE,MAAc;IAC9C,MAAM,IAAI,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * Circle (content-view) operations on Postgres.
+ *
+ * Phase 1 · B2. PORT from neo4j-graph-service.ts (circle methods).
+ * Single-hop edge filters + counts; `getVisiblePostIds` is the dual-gated
+ * visibility query (subject-entity path OR author path) — a PRIVACY CONTROL,
+ * so its behavior-comparison test against the Neo4j impl is the gate that
+ * matters most. Reads tier thresholds from CircleConfig and read-state from
+ * CircleReadState (both already in Postgres).
+ *
+ * PORTING NOTES (Neo4j → Postgres)
+ * --------------------------------
+ * - Effective relationship score: Neo4j stored a single `r.score` property
+ *   (manualScore-overrides-computedScore, maintained on write). The Postgres
+ *   `relationships` table stores `computed_score` + nullable `manual_score`
+ *   instead, so everywhere Neo4j used `r.score` we use
+ *   `COALESCE(manual_score, computed_score)` — matching `effectiveScore()` in
+ *   scoring-engine.ts.
+ * - PostRadius → reachable tier: Neo4j stored a precomputed `radiusInt`; here
+ *   we derive it inline from the `radius` enum via the SAME mapping
+ *   (WHISPER=0, NORMAL=1, LOUD=2, SHOUT=3) and keep the `radiusInt >= tier`
+ *   comparison identical.
+ * - Tier thresholds: Neo4j used hard-coded CIRCLE_THRESHOLDS (0.8/0.5/0.2).
+ *   Here they come per-user from CircleConfig (same defaults), loaded once per
+ *   request — as circle-queries.md prescribes.
+ * - getVisiblePostIds keeps the Neo4j two-branch (entity ∪ author) structure:
+ *   each branch ordered + limited to (limit+1) by (createdAt DESC, postId DESC),
+ *   then merged + deduped app-side keeping the MIN (closest) resolved tier. The
+ *   global top-(limit+1) is a subset of the union of per-branch top-(limit+1),
+ *   so merge → re-sort → truncate is exact.
+ * - Tenant scoping: the graph was implicitly single-tenant, so the Neo4j circle
+ *   methods carried no tenant filter. The Postgres `relationships`/`posts` rows
+ *   are tenant-scoped, so we filter by `getCurrentTenantId()` when a tenant
+ *   context is present; when it is absent we match the Neo4j behavior (no
+ *   tenant filter). This mirrors how neo4j-graph-service.ts treats a missing
+ *   tenant (it simply did not constrain on it).
+ * - Soft-deleted posts: the synced graph only contained live posts. Postgres is
+ *   the source of truth and retains soft-deleted rows, so every post query adds
+ *   `deleted_at IS NULL` to avoid surfacing deleted content.
+ */
+import type { PrismaClient } from "@prisma/client";
+import type { CircleEntityStatus, CircleMember, CircleTier, CircleTierStatus, GlanceItem, GraphNodeType, PaginatedResult, PaginationInput, VisiblePostResult } from "../types.js";
+export declare class CircleOps {
+    private readonly prisma;
+    constructor(prisma: PrismaClient);
+    /**
+     * Tenant filter for the `relationships` alias `r`. Present only when an
+     * ambient tenant context exists; absent → no filter (matches Neo4j, which
+     * never constrained on tenant). Returns a SQL fragment that ANDs cleanly.
+     */
+    private tenantFilter;
+    /** Same as {@link tenantFilter} but for the `posts` alias `p`. */
+    private postTenantFilter;
+    /** Load per-user thresholds from CircleConfig, falling back to defaults. */
+    private loadThresholds;
+    /** Load last-read timestamps for all four tiers from CircleReadState. */
+    private loadReadStates;
+    getCircleMembers(userId: string, tier: CircleTier): Promise<CircleMember[]>;
+    getVisiblePostIds(userId: string, tier: CircleTier, since: Date, pagination: PaginationInput): Promise<PaginatedResult<VisiblePostResult>>;
+    getGlanceItems(userId: string, tier: CircleTier, limit: number): Promise<GlanceItem[]>;
+    getDepthPostIds(userId: string, targetType: GraphNodeType, targetId: string, since: Date, limit: number): Promise<string[]>;
+    getCircleStatus(userId: string): Promise<CircleTierStatus[]>;
+    getCircleEntityStatus(userId: string, tier: CircleTier): Promise<CircleEntityStatus[]>;
+    markCircleRead(userId: string, tier: CircleTier, readAt?: Date): Promise<void>;
+}
+//# sourceMappingURL=circles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circles.d.ts","sourceRoot":"","sources":["../../../../src/lib/graph/postgres/circles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,eAAe,EACf,eAAe,EAGf,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAgGrB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAEjD;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAKpB,kEAAkE;IAClE,OAAO,CAAC,gBAAgB;IAKxB,4EAA4E;YAC9D,cAAc;IAiB5B,yEAAyE;YAC3D,cAAc;IAyBtB,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,EAAE,CAAC;IAoCpB,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,IAAI,EACX,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;IA0GxC,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,EAAE,CAAC;IAuHlB,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC;IAkDd,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAwD5D,qBAAqB,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA6D1B,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,IAAI,GACZ,OAAO,CAAC,IAAI,CAAC;CAWjB"}