@gmickel/gno 1.9.0 → 1.10.0

package/src/store/types.ts

@@ -108,6 +108,7 @@ export interface DocumentRow {
   converterVersion: string | null;
   languageHint: string | null;
   contentType?: string | null;
+  contentTypeSource?: string | null;
   categories?: string[] | null;
   author?: string | null;
   frontmatterDate?: string | null;
@@ -180,6 +181,19 @@ export type DocLinkSource = "parsed" | "user" | "suggested";
 /** Link type */
 export type DocLinkType = "wiki" | "markdown";
 
+/** Semantic edge type / relationship name. Lowercase snake_case after validation. */
+export type DocEdgeType = string;
+export type RelationType = DocEdgeType;
+
+/** Semantic edge confidence. Distinct from GraphEdgeConfidence. */
+export type DocEdgeConfidence = "parsed" | "configured" | "manual" | "inferred";
+
+/** Semantic edge source / provenance. */
+export type DocEdgeSource =
+  | "wikilink"
+  | "markdown-link"
+  | "frontmatter-relation";
+
 /** Document link row from DB */
 export interface DocLinkRow {
   /** Raw path or wiki name (no anchor) */
@@ -206,6 +220,22 @@ export interface DocLinkRow {
   source: DocLinkSource;
 }
 
+/** Semantic document edge row from DB. */
+export interface DocEdgeRow {
+  sourceDocId: number;
+  sourceDocid: string;
+  sourceUri: string;
+  sourceTitle: string | null;
+  targetDocId: number;
+  targetDocid: string;
+  targetUri: string;
+  targetTitle: string | null;
+  edgeType: DocEdgeType;
+  relationType: RelationType;
+  confidence: DocEdgeConfidence;
+  edgeSource: DocEdgeSource;
+}
+
 /** Backlink row from DB (document linking TO target) */
 export interface BacklinkRow {
   /** Source document internal ID */
@@ -238,6 +268,13 @@ export interface DocLinkInput {
   endCol: number;
 }
 
+/** Input for setting semantic document edges for one source document. */
+export interface DocEdgeInput {
+  targetDocId: number;
+  edgeType: DocEdgeType;
+  confidence: DocEdgeConfidence;
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Input Types (for upsert operations)
 // ─────────────────────────────────────────────────────────────────────────────
@@ -258,6 +295,7 @@ export interface DocumentInput {
   converterVersion?: string;
   languageHint?: string;
   contentType?: string;
+  contentTypeSource?: string;
   categories?: string[];
   author?: string;
   frontmatterDate?: string;
@@ -462,6 +500,8 @@ export interface GraphNode {
   degree: number;
   /** Optional deterministic community id from graph analysis */
   communityId?: string;
+  /** Typed graph hints from the node's configured content type */
+  graphHints?: string[];
 }
 
 /** Compact graph report node summary */
@@ -619,6 +659,68 @@ export interface GetGraphOptions {
   similarTopK?: number;
 }
 
+/** Direction for bounded typed-edge graph traversal. */
+export type GraphQueryDirection = "out" | "in" | "both";
+
+/** Node returned by graph query traversal. */
+export interface GraphQueryNode {
+  id: string;
+  uri: string;
+  title: string | null;
+  collection: string;
+  relPath: string;
+  depth: number;
+  graphHints: string[];
+}
+
+/** Edge returned by graph query traversal. */
+export interface GraphQueryEdge {
+  source: string;
+  target: string;
+  edgeType: DocEdgeType;
+  relationType: RelationType;
+  confidence: DocEdgeConfidence;
+  edgeSource: DocEdgeSource;
+  depth: number;
+}
+
+/** Options for bounded graph query traversal. */
+export interface GraphQueryOptions {
+  direction?: GraphQueryDirection;
+  edgeType?: DocEdgeType;
+  maxDepth?: number;
+  maxNodes?: number;
+  frontierLimit?: number;
+  visitedLimit?: number;
+}
+
+/** Bounded graph query traversal result. */
+export interface GraphQueryResult {
+  schemaVersion: "1.0";
+  root: GraphQueryNode;
+  nodes: GraphQueryNode[];
+  edges: GraphQueryEdge[];
+  meta: {
+    direction: GraphQueryDirection;
+    edgeType: DocEdgeType | null;
+    maxDepth: number;
+    maxNodes: number;
+    frontierLimit: number;
+    visitedLimit: number;
+    returnedNodes: number;
+    returnedEdges: number;
+    truncated: boolean;
+    warnings: string[];
+  };
+}
+
+export interface GraphQueryTraversalRows {
+  nodes: Array<{ doc: DocumentRow; depth: number }>;
+  edges: Array<{ edge: DocEdgeRow; depth: number }>;
+  truncated: boolean;
+  warnings: string[];
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Migration Types
 // ─────────────────────────────────────────────────────────────────────────────
@@ -971,6 +1073,45 @@ export interface StorePort {
     >
   >;
 
+  /**
+   * Set semantic edges for a document.
+   * Replaces edges from the given source.
+   */
+  setDocEdges(
+    documentId: number,
+    edges: DocEdgeInput[],
+    source: DocEdgeSource
+  ): Promise<StoreResult<void>>;
+
+  /**
+   * Get outgoing semantic edges for a document.
+   */
+  getEdgesForDoc(
+    documentId: number,
+    options?: { edgeType?: DocEdgeType }
+  ): Promise<StoreResult<DocEdgeRow[]>>;
+
+  /**
+   * Get semantic backlinks pointing to a document.
+   */
+  getEdgeBacklinksForDoc(
+    documentId: number,
+    options?: { collection?: string; edgeType?: DocEdgeType }
+  ): Promise<StoreResult<DocEdgeRow[]>>;
+
+  /**
+   * Bounded recursive traversal over typed document edges.
+   */
+  queryGraphTraversal(
+    rootDocumentId: number,
+    options?: GraphQueryOptions
+  ): Promise<StoreResult<GraphQueryTraversalRows>>;
+
+  /**
+   * Rebuild derived semantic edges from currently indexed links.
+   */
+  backfillDocEdges(): Promise<StoreResult<{ inserted: number }>>;
+
   // ─────────────────────────────────────────────────────────────────────────
   // Graph
   // ─────────────────────────────────────────────────────────────────────────