@lucern/graph-primitives 1.0.0 → 1.0.1

package/dist/epistemicEvidenceHelpers.d.ts

@@ -0,0 +1,71 @@
+import { r as resolveTopicProjectScope, T as TopicProjectScope } from './topicScope-By_zp4tt.js';
+import * as convex_values from 'convex/values';
+import { Doc, QueryCtx, MutationCtx } from './convex.js';
+
+type EvidenceKind = "fact" | "observation" | "claim" | "quote" | "statistic" | "signal";
+type AudienceClass = "internal" | "restricted_external" | "public";
+type EvidenceScopeArgs = {
+    projectId?: string | null;
+    topicId?: string | null;
+};
+type EvidenceNodeDoc = Doc<"epistemicNodes">;
+declare const optionalEvidenceScopeArgs: {
+    readonly projectId: convex_values.VString<string | undefined, "optional">;
+    readonly topicId: convex_values.VString<string | undefined, "optional">;
+};
+declare const LEGACY_SPRINT_LINK_KEY: string;
+declare function generateContentHash(text: string): string;
+declare function normalizeKind(kind?: string): EvidenceKind;
+declare function normalizeSourceType(sourceType?: string): "proprietary" | "verified" | "ai_generated";
+declare function markProjectGraphDirty(ctx: QueryCtx | MutationCtx, projectId: string | undefined | null, topicId?: string | undefined | null): Promise<void>;
+declare function clampEvidenceLimit(limit: number | undefined, fallback?: number): number;
+declare function dedupeEvidenceNodes(nodes: EvidenceNodeDoc[]): EvidenceNodeDoc[];
+declare function evidenceMatchesScope(node: Pick<EvidenceNodeDoc, "topicId" | "projectId">, scope: Awaited<ReturnType<typeof resolveTopicProjectScope>>): boolean;
+declare function resolveEvidenceLinkedWorktreeId(metadata: Record<string, unknown> | undefined): string | undefined;
+declare function resolveEvidenceScopeOrNull(ctx: QueryCtx | MutationCtx, args: EvidenceScopeArgs): Promise<TopicProjectScope | null>;
+declare function getEvidenceNodesForScope(ctx: QueryCtx, scope: Awaited<ReturnType<typeof resolveTopicProjectScope>>, args?: {
+    scanLimit?: number;
+}): Promise<EvidenceNodeDoc[]>;
+type AudienceRow = {
+    audienceKey?: string | null;
+    audienceClass: AudienceClass;
+};
+declare function createEvidenceAudienceResolver(registryRows: AudienceRow[]): (audienceKey: string | undefined | null, fallback: AudienceClass) => AudienceClass;
+declare function flattenEvidenceNode(n: EvidenceNodeDoc): any;
+declare function formatEvidenceNode(n: {
+    _id: string;
+    projectId: string;
+    topicId?: string;
+    canonicalText: string;
+    sourceType: string;
+    status: string;
+    metadata?: unknown;
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
+}): {
+    [LEGACY_SPRINT_LINK_KEY]: string | undefined;
+    _id: string;
+    _epistemicNodeId: string;
+    _creationTime: number;
+    projectId: string;
+    topicId: string | undefined;
+    text: string;
+    kind: {};
+    tags: string[];
+    sourceType: string;
+    externalSourceType: unknown;
+    externalSourceUrl: unknown;
+    sourceArtifactId: unknown;
+    sourceQuestionId: unknown;
+    linkedWorktreeId: string | undefined;
+    sourceAnchor: unknown;
+    aiProvider: unknown;
+    verificationStatus: unknown;
+    status: string;
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
+};
+
+export { type AudienceClass, type EvidenceKind, type EvidenceNodeDoc, type EvidenceScopeArgs, clampEvidenceLimit, createEvidenceAudienceResolver, dedupeEvidenceNodes, evidenceMatchesScope, flattenEvidenceNode, formatEvidenceNode, generateContentHash, getEvidenceNodesForScope, markProjectGraphDirty, normalizeKind, normalizeSourceType, optionalEvidenceScopeArgs, resolveEvidenceLinkedWorktreeId, resolveEvidenceScopeOrNull };