@powerhousedao/knowledge-note 1.0.0 → 1.0.1

package/dist/editors/knowledge-vault/hooks/use-drive-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-drive-init.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-drive-init.ts"],"names":[],"mappings":"AAoEA,wBAAgB,YAAY,SAsB3B;AAgHD;;;GAGG;AACH,wBAAgB,YAAY,wBAI3B"}
+{"version":3,"file":"use-drive-init.d.ts","sourceRoot":"","sources":["../../../../editors/knowledge-vault/hooks/use-drive-init.ts"],"names":[],"mappings":"AA2DA,wBAAgB,YAAY,SAqB3B;AAsFD;;;GAGG;AACH,wBAAgB,YAAY,wBAI3B"}

package/dist/editors/knowledge-vault/hooks/use-drive-init.js

@@ -1,65 +1,95 @@
-import { useEffect, useRef } from "react";
+import { useEffect } from "react";
 import { useSelectedDrive, useNodesInSelectedDrive, addDocument, addFolder, } from "@powerhousedao/reactor-browser";
-const FOLDER_TREE = [
-    {
-        name: "knowledge",
-        children: [{ name: "notes" }, { name: "inbox" }, { name: "insights" }],
-    },
+/**
+ * Drive folder structure matching Ars Contexta layout:
+ *
+ * /knowledge/              <- notes, MOCs, knowledge graph
+ *   /knowledge/notes/      <- knowledge notes
+ *   /knowledge/inbox/      <- unprocessed captures
+ *   /knowledge/insights/   <- synthesized insights
+ * /sources/                <- archived source material
+ * /ops/                    <- operational coordination
+ *   /ops/sessions/         <- session transcripts
+ *   /ops/health/           <- health reports
+ *   /ops/queue/            <- pipeline queue singleton
+ * /self/                   <- system identity & config
+ *   /self/methodology/     <- methodology notes
+ * /research/               <- bundled research claims
+ *
+ * Pattern: follows contributor-billing's proven approach —
+ * module-level tracking Set per drive prevents duplicates,
+ * sequential creation with delays for sync compatibility.
+ */
+// ─── Module-level state (survives re-renders, prevents duplicates) ───
+const initStartedForDrives = new Set();
+// Flat list of folders to create (order matters — parents first)
+const FOLDERS = [
+    { name: "knowledge" },
+    { name: "notes", parentPath: "knowledge" },
+    { name: "inbox", parentPath: "knowledge" },
+    { name: "insights", parentPath: "knowledge" },
     { name: "sources" },
-    {
-        name: "ops",
-        children: [{ name: "sessions" }, { name: "health" }, { name: "queue" }],
-    },
-    {
-        name: "self",
-        children: [{ name: "methodology" }],
-    },
+    { name: "ops" },
+    { name: "sessions", parentPath: "ops" },
+    { name: "health", parentPath: "ops" },
+    { name: "queue", parentPath: "ops" },
+    { name: "self" },
+    { name: "methodology", parentPath: "self" },
     { name: "research" },
 ];
 const SINGLETONS = [
-    {
-        name: "PipelineQueue",
-        type: "bai/pipeline-queue",
-        folderPath: "ops/queue",
-    },
-    {
-        name: "HealthReport",
-        type: "bai/health-report",
-        folderPath: "ops/health",
-    },
+    { name: "PipelineQueue", type: "bai/pipeline-queue", folderPath: "ops/queue" },
+    { name: "HealthReport", type: "bai/health-report", folderPath: "ops/health" },
     { name: "KnowledgeGraph", type: "bai/knowledge-graph", folderPath: "self" },
     { name: "VaultConfig", type: "bai/vault-config", folderPath: "self" },
 ];
 export function useDriveInit() {
-    // Use the drive ID (UUID), never the slug
     const [selectedDrive] = useSelectedDrive();
     const driveId = selectedDrive?.header.id;
     const nodes = useNodesInSelectedDrive();
-    const initAttempted = useRef(false);
     useEffect(() => {
-        if (!driveId || initAttempted.current)
+        if (!driveId || nodes === undefined)
             return;
-        if (nodes === undefined)
-            return; // still loading
-        // Check if the root "knowledge" folder exists (our init marker)
+        if (initStartedForDrives.has(driveId))
+            return;
+        // Check if already initialized (knowledge folder exists)
         const hasKnowledgeFolder = (nodes ?? []).some((n) => n.kind === "folder" && n.name === "knowledge" && n.parentFolder == null);
-        if (hasKnowledgeFolder)
-            return; // already initialized
-        initAttempted.current = true;
-        initDrive(driveId, nodes ?? []);
+        if (hasKnowledgeFolder) {
+            initStartedForDrives.add(driveId);
+            return;
+        }
+        initStartedForDrives.add(driveId);
+        void initDrive(driveId, nodes ?? []);
     }, [driveId, nodes]);
 }
+// ─── Single sequential init: folders then singletons ───
 async function initDrive(driveId, existingNodes) {
     try {
-        console.log(`[VaultInit] Initializing drive ${driveId}...`);
-        // Build map of existing folders: path -> id
-        const existingFolderIds = buildExistingFolderMap(existingNodes);
-        const folderIds = new Map(existingFolderIds);
-        // Create folder tree recursively
-        await createFolderTree(driveId, FOLDER_TREE, undefined, "", folderIds);
-        // Wait a beat for the reactor to process folder creation
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        // Create singleton documents in their folders
+        // Phase 1: Create folders
+        console.log(`[VaultInit] Creating folders for drive ${driveId}...`);
+        const existingFolderMap = buildExistingFolderMap(existingNodes);
+        const folderIds = new Map(existingFolderMap);
+        for (const folder of FOLDERS) {
+            const path = folder.parentPath ? `${folder.parentPath}/${folder.name}` : folder.name;
+            if (folderIds.has(path)) {
+                continue;
+            }
+            const parentId = folder.parentPath ? folderIds.get(folder.parentPath) : undefined;
+            try {
+                const result = await addFolder(driveId, folder.name, parentId);
+                folderIds.set(path, result.id);
+                console.log(`[VaultInit] Created folder: /${path}/`);
+                await new Promise((r) => setTimeout(r, 500));
+            }
+            catch (err) {
+                console.error(`[VaultInit] Failed to create folder /${path}/:`, err);
+            }
+        }
+        console.log("[VaultInit] Folders complete");
+        // Wait for reactor to process all folder operations
+        await new Promise((r) => setTimeout(r, 1500));
+        // Phase 2: Create singletons
+        console.log(`[VaultInit] Creating singletons...`);
         const existingTypes = new Set(existingNodes
             .filter((n) => n.kind === "file")
             .map((n) => n.documentType));
@@ -70,11 +100,9 @@ async function initDrive(driveId, existingNodes) {
             }
             const parentFolderId = folderIds.get(singleton.folderPath);
             try {
-                // addDocument uses the drive UUID internally
                 await addDocument(driveId, singleton.name, singleton.type, parentFolderId);
                 console.log(`[VaultInit] Created ${singleton.name} in /${singleton.folderPath}/`);
-                // Small delay between document creations to avoid revision conflicts
-                await new Promise((resolve) => setTimeout(resolve, 500));
+                await new Promise((r) => setTimeout(r, 1000));
             }
             catch (err) {
                 console.error(`[VaultInit] Failed to create ${singleton.name}:`, err);
@@ -86,27 +114,7 @@ async function initDrive(driveId, existingNodes) {
         console.error("[VaultInit] Drive initialization failed:", err);
     }
 }
-async function createFolderTree(driveId, defs, parentFolderId, pathPrefix, folderIds) {
-    for (const def of defs) {
-        const path = pathPrefix ? `${pathPrefix}/${def.name}` : def.name;
-        if (!folderIds.has(path)) {
-            try {
-                const result = await addFolder(driveId, def.name, parentFolderId);
-                folderIds.set(path, result.id);
-                console.log(`[VaultInit] Created folder: /${path}/`);
-                // Small delay to avoid revision conflicts
-                await new Promise((resolve) => setTimeout(resolve, 200));
-            }
-            catch (err) {
-                console.error(`[VaultInit] Failed to create folder /${path}/:`, err);
-                continue;
-            }
-        }
-        if (def.children) {
-            await createFolderTree(driveId, def.children, folderIds.get(path), path, folderIds);
-        }
-    }
-}
+// ─── Helpers ───
 function buildExistingFolderMap(nodes) {
     const map = new Map();
     const folders = nodes.filter((n) => n.kind === "folder");
@@ -116,9 +124,7 @@ function buildExistingFolderMap(nodes) {
         let current = folder;
         while (current) {
             pathParts.unshift(current.name);
-            current = current.parentFolder
-                ? folderById.get(current.parentFolder)
-                : undefined;
+            current = current.parentFolder ? folderById.get(current.parentFolder) : undefined;
         }
         map.set(pathParts.join("/"), folder.id);
     }

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@powerhousedao/knowledge-note",
     "description": "Knowledge Note document model package for Powerhouse",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "license": "AGPL-3.0-only",
     "type": "module",
     "files": [
@@ -23,6 +23,50 @@
             "types": "./dist/editors/index.d.ts",
             "import": "./dist/editors/index.js"
         },
+        "./document-models/derivation": {
+            "types": "./dist/document-models/derivation/index.d.ts",
+            "import": "./dist/document-models/derivation/index.js"
+        },
+        "./document-models/health-report": {
+            "types": "./dist/document-models/health-report/index.d.ts",
+            "import": "./dist/document-models/health-report/index.js"
+        },
+        "./document-models/knowledge-graph": {
+            "types": "./dist/document-models/knowledge-graph/index.d.ts",
+            "import": "./dist/document-models/knowledge-graph/index.js"
+        },
+        "./document-models/knowledge-note": {
+            "types": "./dist/document-models/knowledge-note/index.d.ts",
+            "import": "./dist/document-models/knowledge-note/index.js"
+        },
+        "./document-models/moc": {
+            "types": "./dist/document-models/moc/index.d.ts",
+            "import": "./dist/document-models/moc/index.js"
+        },
+        "./document-models/observation": {
+            "types": "./dist/document-models/observation/index.d.ts",
+            "import": "./dist/document-models/observation/index.js"
+        },
+        "./document-models/pipeline-queue": {
+            "types": "./dist/document-models/pipeline-queue/index.d.ts",
+            "import": "./dist/document-models/pipeline-queue/index.js"
+        },
+        "./document-models/research-claim": {
+            "types": "./dist/document-models/research-claim/index.d.ts",
+            "import": "./dist/document-models/research-claim/index.js"
+        },
+        "./document-models/source": {
+            "types": "./dist/document-models/source/index.d.ts",
+            "import": "./dist/document-models/source/index.js"
+        },
+        "./document-models/tension": {
+            "types": "./dist/document-models/tension/index.d.ts",
+            "import": "./dist/document-models/tension/index.js"
+        },
+        "./document-models/vault-config": {
+            "types": "./dist/document-models/vault-config/index.d.ts",
+            "import": "./dist/document-models/vault-config/index.js"
+        },
         "./document-models/*": {
             "types": "./dist/document-models/*/index.d.ts",
             "import": "./dist/document-models/*/index.js"

package/dist/processors/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../processors/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAErB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,oBAAoB,MAa7C,aAAa,gBAAgB,KAAG,OAAO,CAAC,eAAe,EAAE,CAUxE,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../processors/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAErB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,oBAAoB,MAgB7C,aAAa,gBAAgB,KAAG,OAAO,CAAC,eAAe,EAAE,CAUxE,CAAC"}

package/dist/processors/factory.js

@@ -2,11 +2,14 @@
  * This file aggregates all processor factories
  */
 import { graphIndexerProcessorFactory } from "./graph-indexer/factory.js";
+import { methodologyIndexerProcessorFactory } from "./methodology-indexer/factory.js";
 export const processorFactory = (module) => {
     console.log(`[processorFactory] Initializing with processorApp: ${module.processorApp}`);
     const factories = [];
-    // Register graph indexer for both connect and switchboard
+    // Register graph indexer (watches bai/knowledge-note)
     factories.push(graphIndexerProcessorFactory(module));
+    // Register methodology indexer (watches bai/research-claim)
+    factories.push(methodologyIndexerProcessorFactory(module));
     console.log(`[processorFactory] Loaded ${factories.length} factories`);
     // Return the inner function that will be called for each drive
     return async (driveHeader) => {

package/dist/processors/methodology-indexer/factory.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessorRecord, IProcessorHostModule } from "@powerhousedao/reactor-browser";
+import type { PHDocumentHeader } from "document-model";
+export declare const methodologyIndexerProcessorFactory: (module: IProcessorHostModule) => (driveHeader: PHDocumentHeader) => Promise<ProcessorRecord[]>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/processors/methodology-indexer/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../processors/methodology-indexer/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,eAAO,MAAM,kCAAkC,GAC5C,QAAQ,oBAAoB,MACtB,aAAa,gBAAgB,KAAG,OAAO,CAAC,eAAe,EAAE,CAoC/D,CAAC"}

package/dist/processors/methodology-indexer/factory.js

@@ -0,0 +1,23 @@
+import {} from "@powerhousedao/shared/processors";
+import { MethodologyIndexerProcessor } from "./index.js";
+export const methodologyIndexerProcessorFactory = (module) => async (driveHeader) => {
+    const namespace = MethodologyIndexerProcessor.getNamespace(driveHeader.id);
+    console.log(`[MethodologyIndexer] Factory called for drive: ${driveHeader.id}, namespace: ${namespace}`);
+    const store = await module.relationalDb.createNamespace(namespace);
+    const filter = {
+        branch: ["main"],
+        documentId: ["*"],
+        documentType: ["bai/research-claim", "powerhouse/document-drive"],
+        scope: ["global"],
+    };
+    const processor = new MethodologyIndexerProcessor(namespace, filter, store);
+    await processor.initAndUpgrade();
+    console.log(`[MethodologyIndexer] Processor created for drive: ${driveHeader.id}`);
+    return [
+        {
+            processor,
+            filter,
+            startFrom: "beginning",
+        },
+    ];
+};

package/dist/processors/methodology-indexer/index.d.ts

@@ -0,0 +1,11 @@
+import { RelationalDbProcessor } from "@powerhousedao/shared/processors";
+import type { OperationWithContext } from "@powerhousedao/shared/document-model";
+import type { MethodologyDB } from "./schema.js";
+export declare class MethodologyIndexerProcessor extends RelationalDbProcessor<MethodologyDB> {
+    static getNamespace(driveId: string): string;
+    initAndUpgrade(): Promise<void>;
+    onOperations(operations: OperationWithContext[]): Promise<void>;
+    onDisconnect(): Promise<void>;
+    private deleteClaim;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/processors/methodology-indexer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../processors/methodology-indexer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,2BAA4B,SAAQ,qBAAqB,CAAC,aAAa,CAAC;WACnE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAItC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,YAAY,CACzB,UAAU,EAAE,oBAAoB,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC;IAsGV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAcrB,WAAW;CAkB1B"}

package/dist/processors/methodology-indexer/index.js

@@ -0,0 +1,118 @@
+import { RelationalDbProcessor } from "@powerhousedao/shared/processors";
+import { up } from "./migrations.js";
+export class MethodologyIndexerProcessor extends RelationalDbProcessor {
+    static getNamespace(driveId) {
+        return super.getNamespace(driveId);
+    }
+    async initAndUpgrade() {
+        await up(this.relationalDb);
+    }
+    async onOperations(operations) {
+        if (operations.length === 0)
+            return;
+        const lastByDocument = new Map();
+        for (const entry of operations) {
+            const { operation, context } = entry;
+            const documentId = context.documentId;
+            // Handle deletion from drive
+            if (context.documentType === "powerhouse/document-drive" &&
+                operation.action.type === "DELETE_NODE") {
+                const deleteInput = operation.action.input;
+                await this.deleteClaim(deleteInput.id);
+                lastByDocument.delete(deleteInput.id);
+                continue;
+            }
+            // Only process research-claim documents
+            if (context.documentType !== "bai/research-claim")
+                continue;
+            if (context.resultingState) {
+                lastByDocument.set(documentId, entry);
+            }
+        }
+        for (const [documentId, entry] of lastByDocument) {
+            try {
+                const stateJson = entry.context.resultingState;
+                if (!stateJson)
+                    continue;
+                const parsed = JSON.parse(stateJson);
+                const global = (parsed.global ?? parsed);
+                const now = new Date().toISOString();
+                // Upsert claim
+                const topics = global.topics ?? [];
+                const methodology = global.methodology ?? [];
+                await this.relationalDb
+                    .insertInto("methodology_claims")
+                    .values({
+                    id: documentId,
+                    document_id: documentId,
+                    title: global.title ?? null,
+                    description: global.description ?? null,
+                    kind: global.kind ?? null,
+                    topics: JSON.stringify(topics),
+                    methodology: JSON.stringify(methodology),
+                    updated_at: now,
+                })
+                    .onConflict((oc) => oc.column("document_id").doUpdateSet({
+                    title: global.title ?? null,
+                    description: global.description ?? null,
+                    kind: global.kind ?? null,
+                    topics: JSON.stringify(topics),
+                    methodology: JSON.stringify(methodology),
+                    updated_at: now,
+                }))
+                    .execute();
+                // Reconcile connections
+                await this.relationalDb
+                    .deleteFrom("methodology_connections")
+                    .where("source_document_id", "=", documentId)
+                    .execute();
+                const connections = global.connections ?? [];
+                if (connections.length > 0) {
+                    await this.relationalDb
+                        .insertInto("methodology_connections")
+                        .values(connections.map((conn) => ({
+                        id: conn.id ??
+                            `${documentId}-${conn.targetRef}`,
+                        source_document_id: documentId,
+                        target_ref: conn.targetRef ?? "",
+                        context_phrase: conn.contextPhrase ?? null,
+                        updated_at: now,
+                    })))
+                        .execute();
+                }
+                console.log(`[MethodologyIndexer] Reconciled ${documentId}: ${connections.length} connections`);
+            }
+            catch (err) {
+                console.error(`[MethodologyIndexer] Error reconciling ${documentId}:`, err);
+            }
+        }
+    }
+    async onDisconnect() {
+        try {
+            await this.relationalDb
+                .deleteFrom("methodology_connections")
+                .execute();
+            await this.relationalDb.deleteFrom("methodology_claims").execute();
+            console.log(`[MethodologyIndexer] Cleaned up namespace: ${this.namespace}`);
+        }
+        catch (err) {
+            console.error(`[MethodologyIndexer] Error cleaning up:`, err);
+        }
+    }
+    async deleteClaim(documentId) {
+        try {
+            await this.relationalDb
+                .deleteFrom("methodology_connections")
+                .where("source_document_id", "=", documentId)
+                .execute();
+            await this.relationalDb
+                .deleteFrom("methodology_claims")
+                .where("document_id", "=", documentId)
+                .execute();
+            console.log(`[MethodologyIndexer] Deleted claim ${documentId}`);
+        }
+        catch (err) {
+            console.error(`[MethodologyIndexer] Error deleting claim ${documentId}:`, err);
+        }
+    }
+}

package/dist/processors/methodology-indexer/migrations.d.ts

@@ -0,0 +1,4 @@
+import type { IRelationalDb } from "@powerhousedao/shared/processors";
+export declare function up(db: IRelationalDb<any>): Promise<void>;
+export declare function down(db: IRelationalDb<any>): Promise<void>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/processors/methodology-indexer/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../processors/methodology-indexer/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,wBAAsB,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC9D;AAED,wBAAsB,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE"}

package/dist/processors/methodology-indexer/migrations.js

@@ -0,0 +1,39 @@
+export async function up(db) {
+    await db.schema
+        .createTable("methodology_claims")
+        .addColumn("id", "varchar(255)", (col) => col.primaryKey())
+        .addColumn("document_id", "varchar(255)", (col) => col.notNull().unique())
+        .addColumn("title", "varchar(1024)")
+        .addColumn("description", "text")
+        .addColumn("kind", "varchar(100)")
+        .addColumn("topics", "text") // JSON array as string
+        .addColumn("methodology", "text") // JSON array as string
+        .addColumn("updated_at", "varchar(50)", (col) => col.notNull())
+        .ifNotExists()
+        .execute();
+    await db.schema
+        .createTable("methodology_connections")
+        .addColumn("id", "varchar(255)", (col) => col.primaryKey())
+        .addColumn("source_document_id", "varchar(255)", (col) => col.notNull())
+        .addColumn("target_ref", "varchar(255)", (col) => col.notNull())
+        .addColumn("context_phrase", "text")
+        .addColumn("updated_at", "varchar(50)", (col) => col.notNull())
+        .ifNotExists()
+        .execute();
+    await db.schema
+        .createIndex("idx_methodology_claims_kind")
+        .on("methodology_claims")
+        .column("kind")
+        .ifNotExists()
+        .execute();
+    await db.schema
+        .createIndex("idx_methodology_connections_source")
+        .on("methodology_connections")
+        .column("source_document_id")
+        .ifNotExists()
+        .execute();
+}
+export async function down(db) {
+    await db.schema.dropTable("methodology_connections").ifExists().execute();
+    await db.schema.dropTable("methodology_claims").ifExists().execute();
+}

package/dist/processors/methodology-indexer/query.d.ts

@@ -0,0 +1,35 @@
+import type { Kysely } from "kysely";
+import type { MethodologyDB } from "./schema.js";
+export interface ClaimResult {
+    id: string;
+    documentId: string;
+    title: string | null;
+    description: string | null;
+    kind: string | null;
+    topics: string[];
+    methodology: string[];
+    updatedAt: string;
+}
+export interface ConnectionResult {
+    id: string;
+    sourceDocumentId: string;
+    targetRef: string;
+    contextPhrase: string | null;
+    updatedAt: string;
+}
+export declare function createMethodologyQuery(db: Kysely<MethodologyDB>): {
+    allClaims(): Promise<ClaimResult[]>;
+    claimCount(): Promise<number>;
+    claimByDocumentId(documentId: string): Promise<ClaimResult | undefined>;
+    claimsByKind(kind: string): Promise<ClaimResult[]>;
+    searchClaims(query: string, limit?: number): Promise<ClaimResult[]>;
+    claimsByTopic(topic: string): Promise<ClaimResult[]>;
+    connectionsFrom(documentId: string): Promise<ConnectionResult[]>;
+    connectionsTo(targetRef: string): Promise<ConnectionResult[]>;
+    stats(): Promise<{
+        claimCount: number;
+        connectionCount: number;
+        kindDistribution: Record<string, number>;
+    }>;
+};
+//# sourceMappingURL=query.d.ts.map

package/dist/processors/methodology-indexer/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../processors/methodology-indexer/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAA2C,MAAM,aAAa,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAyBD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,CAAC;iBAEzC,OAAO,CAAC,WAAW,EAAE,CAAC;kBAKrB,OAAO,CAAC,MAAM,CAAC;kCAKC,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;uBASpD,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;wBAS9B,MAAM,mBAAe,OAAO,CAAC,WAAW,EAAE,CAAC;yBAiB1C,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;gCAUxB,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;6BASvC,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;aASpD,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;EAiBpH"}

package/dist/processors/methodology-indexer/query.js

@@ -0,0 +1,102 @@
+function rowToClaim(row) {
+    return {
+        id: row.id,
+        documentId: row.document_id,
+        title: row.title,
+        description: row.description,
+        kind: row.kind,
+        topics: row.topics ? JSON.parse(row.topics) : [],
+        methodology: row.methodology ? JSON.parse(row.methodology) : [],
+        updatedAt: row.updated_at,
+    };
+}
+function rowToConnection(row) {
+    return {
+        id: row.id,
+        sourceDocumentId: row.source_document_id,
+        targetRef: row.target_ref,
+        contextPhrase: row.context_phrase,
+        updatedAt: row.updated_at,
+    };
+}
+export function createMethodologyQuery(db) {
+    return {
+        async allClaims() {
+            const rows = await db.selectFrom("methodology_claims").selectAll().execute();
+            return rows.map(rowToClaim);
+        },
+        async claimCount() {
+            const rows = await db.selectFrom("methodology_claims").selectAll().execute();
+            return rows.length;
+        },
+        async claimByDocumentId(documentId) {
+            const row = await db
+                .selectFrom("methodology_claims")
+                .where("document_id", "=", documentId)
+                .selectAll()
+                .executeTakeFirst();
+            return row ? rowToClaim(row) : undefined;
+        },
+        async claimsByKind(kind) {
+            const rows = await db
+                .selectFrom("methodology_claims")
+                .where("kind", "=", kind)
+                .selectAll()
+                .execute();
+            return rows.map(rowToClaim);
+        },
+        async searchClaims(query, limit = 50) {
+            const q = `%${query.toLowerCase()}%`;
+            const rows = await db
+                .selectFrom("methodology_claims")
+                .where((eb) => eb.or([
+                eb(eb.fn("lower", ["title"]), "like", q),
+                eb(eb.fn("lower", ["description"]), "like", q),
+                eb(eb.fn("lower", ["topics"]), "like", q),
+            ]))
+                .selectAll()
+                .limit(limit)
+                .execute();
+            return rows.map(rowToClaim);
+        },
+        async claimsByTopic(topic) {
+            const q = `%"${topic.toLowerCase()}"%`;
+            const rows = await db
+                .selectFrom("methodology_claims")
+                .where(eb => eb(eb.fn("lower", ["topics"]), "like", q))
+                .selectAll()
+                .execute();
+            return rows.map(rowToClaim);
+        },
+        async connectionsFrom(documentId) {
+            const rows = await db
+                .selectFrom("methodology_connections")
+                .where("source_document_id", "=", documentId)
+                .selectAll()
+                .execute();
+            return rows.map(rowToConnection);
+        },
+        async connectionsTo(targetRef) {
+            const rows = await db
+                .selectFrom("methodology_connections")
+                .where("target_ref", "=", targetRef)
+                .selectAll()
+                .execute();
+            return rows.map(rowToConnection);
+        },
+        async stats() {
+            const claims = await db.selectFrom("methodology_claims").selectAll().execute();
+            const connections = await db.selectFrom("methodology_connections").selectAll().execute();
+            const kindDist = {};
+            for (const c of claims) {
+                const k = c.kind ?? "unknown";
+                kindDist[k] = (kindDist[k] ?? 0) + 1;
+            }
+            return {
+                claimCount: claims.length,
+                connectionCount: connections.length,
+                kindDistribution: kindDist,
+            };
+        },
+    };
+}

package/dist/processors/methodology-indexer/schema.d.ts

@@ -0,0 +1,22 @@
+export interface MethodologyClaim {
+    id: string;
+    document_id: string;
+    title: string | null;
+    description: string | null;
+    kind: string | null;
+    topics: string | null;
+    methodology: string | null;
+    updated_at: string;
+}
+export interface MethodologyConnection {
+    id: string;
+    source_document_id: string;
+    target_ref: string;
+    context_phrase: string | null;
+    updated_at: string;
+}
+export interface MethodologyDB {
+    methodology_claims: MethodologyClaim;
+    methodology_connections: MethodologyConnection;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/processors/methodology-indexer/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../processors/methodology-indexer/schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,uBAAuB,EAAE,qBAAqB,CAAC;CAChD"}

package/dist/processors/methodology-indexer/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/subgraphs/index.d.ts

@@ -1,2 +1,3 @@
 export * as KnowledgeGraphSubgraph from "./knowledge-graph/index.js";
+export * as MethodologySubgraph from "./methodology/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/subgraphs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../subgraphs/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,sBAAsB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../subgraphs/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,sBAAsB,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,mBAAmB,MAAM,wBAAwB,CAAC"}

package/dist/subgraphs/index.js

@@ -1 +1,2 @@
 export * as KnowledgeGraphSubgraph from "./knowledge-graph/index.js";
+export * as MethodologySubgraph from "./methodology/index.js";

package/dist/subgraphs/methodology/index.d.ts

@@ -0,0 +1,2 @@
+export { MethodologySubgraph } from "./subgraph.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/subgraphs/methodology/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../subgraphs/methodology/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/subgraphs/methodology/index.js

@@ -0,0 +1 @@
+export { MethodologySubgraph } from "./subgraph.js";

package/dist/subgraphs/methodology/subgraph.d.ts

@@ -0,0 +1,47 @@
+import { BaseSubgraph, type SubgraphArgs } from "@powerhousedao/reactor-api";
+export declare class MethodologySubgraph extends BaseSubgraph {
+    name: string;
+    typeDefs: import("graphql").DocumentNode;
+    resolvers: {
+        Query: {
+            methodologySearch: (_: unknown, args: {
+                driveId: string;
+                query: string;
+                limit?: number;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ClaimResult[]>;
+            methodologyClaims: (_: unknown, args: {
+                driveId: string;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ClaimResult[]>;
+            methodologyClaimsByKind: (_: unknown, args: {
+                driveId: string;
+                kind: string;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ClaimResult[]>;
+            methodologyClaimsByTopic: (_: unknown, args: {
+                driveId: string;
+                topic: string;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ClaimResult[]>;
+            methodologyClaimById: (_: unknown, args: {
+                driveId: string;
+                documentId: string;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ClaimResult | undefined>;
+            methodologyStats: (_: unknown, args: {
+                driveId: string;
+            }) => Promise<{
+                claimCount: number;
+                connectionCount: number;
+                kindDistribution: Record<string, number>;
+            }>;
+            methodologyConnectionsFrom: (_: unknown, args: {
+                driveId: string;
+                documentId: string;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ConnectionResult[]>;
+            methodologyConnectionsTo: (_: unknown, args: {
+                driveId: string;
+                targetRef: string;
+            }) => Promise<import("../../processors/methodology-indexer/query.js").ConnectionResult[]>;
+        };
+    };
+    constructor(args: SubgraphArgs);
+    private getQuery;
+}
+//# sourceMappingURL=subgraph.d.ts.map

package/dist/subgraphs/methodology/subgraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph.d.ts","sourceRoot":"","sources":["../../../subgraphs/methodology/subgraph.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAMpC,qBAAa,mBAAoB,SAAQ,YAAY;IAC1C,IAAI,SAAiB;IAErB,QAAQ,iCAoCf;IAEO,SAAS;;mCAGT,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE;mCAOrD,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE;yCAOtB,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE;0CAOpC,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE;sCAOrC,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE;kCAO1C,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE;;;;;4CAOtB,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE;0CAO1C,OAAO,QACJ;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE;;MAMhD;gBAEU,IAAI,EAAE,YAAY;IAI9B,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/subgraphs/methodology/subgraph.js

@@ -0,0 +1,87 @@
+import { gql } from "graphql-tag";
+import { BaseSubgraph, } from "@powerhousedao/reactor-api";
+import { MethodologyIndexerProcessor } from "../../processors/methodology-indexer/index.js";
+import { createMethodologyQuery } from "../../processors/methodology-indexer/query.js";
+export class MethodologySubgraph extends BaseSubgraph {
+    name = "methodology";
+    typeDefs = gql `
+    type MethodologyClaim {
+      id: String!
+      documentId: String!
+      title: String
+      description: String
+      kind: String
+      topics: [String!]!
+      methodology: [String!]!
+      updatedAt: String!
+    }
+
+    type MethodologyConnection {
+      id: String!
+      sourceDocumentId: String!
+      targetRef: String!
+      contextPhrase: String
+      updatedAt: String!
+    }
+
+    type MethodologyStats {
+      claimCount: Int!
+      connectionCount: Int!
+      kindDistribution: JSONObject
+    }
+
+    extend type Query {
+      methodologySearch(driveId: ID!, query: String!, limit: Int): [MethodologyClaim!]!
+      methodologyClaims(driveId: ID!): [MethodologyClaim!]!
+      methodologyClaimsByKind(driveId: ID!, kind: String!): [MethodologyClaim!]!
+      methodologyClaimsByTopic(driveId: ID!, topic: String!): [MethodologyClaim!]!
+      methodologyClaimById(driveId: ID!, documentId: String!): MethodologyClaim
+      methodologyStats(driveId: ID!): MethodologyStats!
+      methodologyConnectionsFrom(driveId: ID!, documentId: String!): [MethodologyConnection!]!
+      methodologyConnectionsTo(driveId: ID!, targetRef: String!): [MethodologyConnection!]!
+    }
+  `;
+    resolvers = {
+        Query: {
+            methodologySearch: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.searchClaims(args.query, args.limit ?? 50);
+            },
+            methodologyClaims: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.allClaims();
+            },
+            methodologyClaimsByKind: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.claimsByKind(args.kind);
+            },
+            methodologyClaimsByTopic: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.claimsByTopic(args.topic);
+            },
+            methodologyClaimById: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.claimByDocumentId(args.documentId) ?? null;
+            },
+            methodologyStats: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.stats();
+            },
+            methodologyConnectionsFrom: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.connectionsFrom(args.documentId);
+            },
+            methodologyConnectionsTo: async (_, args) => {
+                const query = this.getQuery(args.driveId);
+                return query.connectionsTo(args.targetRef);
+            },
+        },
+    };
+    constructor(args) {
+        super(args);
+    }
+    getQuery(driveId) {
+        const queryBuilder = MethodologyIndexerProcessor.query(driveId, this.relationalDb);
+        return createMethodologyQuery(queryBuilder);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@powerhousedao/knowledge-note",
   "description": "Knowledge Note document model package for Powerhouse",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "license": "AGPL-3.0-only",
   "type": "module",
   "files": [
@@ -23,6 +23,50 @@
       "types": "./dist/editors/index.d.ts",
       "import": "./dist/editors/index.js"
     },
+    "./document-models/derivation": {
+      "types": "./dist/document-models/derivation/index.d.ts",
+      "import": "./dist/document-models/derivation/index.js"
+    },
+    "./document-models/health-report": {
+      "types": "./dist/document-models/health-report/index.d.ts",
+      "import": "./dist/document-models/health-report/index.js"
+    },
+    "./document-models/knowledge-graph": {
+      "types": "./dist/document-models/knowledge-graph/index.d.ts",
+      "import": "./dist/document-models/knowledge-graph/index.js"
+    },
+    "./document-models/knowledge-note": {
+      "types": "./dist/document-models/knowledge-note/index.d.ts",
+      "import": "./dist/document-models/knowledge-note/index.js"
+    },
+    "./document-models/moc": {
+      "types": "./dist/document-models/moc/index.d.ts",
+      "import": "./dist/document-models/moc/index.js"
+    },
+    "./document-models/observation": {
+      "types": "./dist/document-models/observation/index.d.ts",
+      "import": "./dist/document-models/observation/index.js"
+    },
+    "./document-models/pipeline-queue": {
+      "types": "./dist/document-models/pipeline-queue/index.d.ts",
+      "import": "./dist/document-models/pipeline-queue/index.js"
+    },
+    "./document-models/research-claim": {
+      "types": "./dist/document-models/research-claim/index.d.ts",
+      "import": "./dist/document-models/research-claim/index.js"
+    },
+    "./document-models/source": {
+      "types": "./dist/document-models/source/index.d.ts",
+      "import": "./dist/document-models/source/index.js"
+    },
+    "./document-models/tension": {
+      "types": "./dist/document-models/tension/index.d.ts",
+      "import": "./dist/document-models/tension/index.js"
+    },
+    "./document-models/vault-config": {
+      "types": "./dist/document-models/vault-config/index.d.ts",
+      "import": "./dist/document-models/vault-config/index.js"
+    },
     "./document-models/*": {
       "types": "./dist/document-models/*/index.d.ts",
       "import": "./dist/document-models/*/index.js"