@powerhousedao/network-admin 1.0.0-dev.5 → 1.0.0-dev.7

package/dist/subgraphs/workstreams/resolvers.js

@@ -1,16 +1,41 @@
 import {} from "@powerhousedao/reactor-api";
 import { WorkstreamsProcessor } from "../../processors/workstreams/index.js";
-import {} from "../../document-models/request-for-proposals/index.js";
-import {} from "../../document-models/workstream/index.js";
+import {} from "@powerhousedao/network-admin/document-models/request-for-proposals";
+import {} from "@powerhousedao/network-admin/document-models/workstream";
+import { sql } from "kysely";
 export const getResolvers = (subgraph) => {
-    const reactor = subgraph.reactor;
+    const reactorClient = subgraph.reactorClient;
     const db = subgraph.relationalDb;
+    // Shared state for builder profile resolution (used by field resolvers)
+    let getBuilderProfileByPhid = null;
     const deriveSlug = (name) => name.toLowerCase().trim().split(/\s+/).join("-");
+    const extractPhid = (value) => {
+        if (typeof value === "string") {
+            // Return null for empty strings, otherwise return the string
+            return value.trim() || null;
+        }
+        if (value &&
+            typeof value === "object" &&
+            "id" in value &&
+            typeof value.id === "string") {
+            const id = value.id;
+            // Return null for empty strings
+            return id.trim() || null;
+        }
+        return null;
+    };
+    // Normalize drive IDs to match the format used by the processor factory
+    const normalizeDriveId = (driveId) => {
+        return driveId.replace(/\+/g, "-").replace(/=+$/, "");
+    };
     const getCandidateDrives = async () => {
         try {
-            const drives = await reactor.getDrives?.();
-            if (Array.isArray(drives) && drives.length > 0)
-                return drives;
+            const result = await reactorClient.find({ type: "powerhouse/document-drive" });
+            if (result?.results?.length > 0) {
+                return result.results
+                    .filter((doc) => doc.header?.meta?.preferredEditor === "network-admin")
+                    .map((doc) => normalizeDriveId(doc.header.id));
+            }
         }
         catch { }
         return [];
@@ -19,7 +44,7 @@ export const getResolvers = (subgraph) => {
         if (!id)
             return null;
         try {
-            const linked = await reactor.getDocument(id);
+            const linked = await reactorClient.get(id);
             return { id, stateJSON: linked.state.global };
         }
         catch {
@@ -31,7 +56,7 @@ export const getResolvers = (subgraph) => {
             return null;
         }
         try {
-            const rfpDoc = await reactor.getDocument(rfpRef.id);
+            const rfpDoc = await reactorClient.get(rfpRef.id);
             const rfpState = rfpDoc.state.global;
             return {
                 id: rfpRef.id,
@@ -65,9 +90,105 @@ export const getResolvers = (subgraph) => {
             };
         }
     };
+    const loadNetworkProfile = async (networkId) => {
+        if (!networkId) {
+            return null;
+        }
+        try {
+            const networkDoc = await reactorClient.get(networkId);
+            const state = networkDoc.state.global;
+            return {
+                name: state.name ?? null,
+                slug: state.name
+                    ? state.name.toLowerCase().trim().split(/\s+/).join("-")
+                    : null,
+                icon: state.icon ?? null,
+                darkThemeIcon: state.darkThemeIcon ?? null,
+                logo: state.logo ?? null,
+                darkThemeLogo: state.darkThemeLogo ?? null,
+                logoBig: state.logoBig ?? null,
+                website: state.website ?? null,
+                description: state.description ?? null,
+                category: Array.isArray(state.category) ? state.category : null,
+                x: state.x ?? null,
+                github: state.github ?? null,
+                discord: state.discord ?? null,
+                youtube: state.youtube ?? null,
+            };
+        }
+        catch {
+            return null;
+        }
+    };
+    // Helper function to collect SOWs from hydrated workstreams
+    const collectSowsFromWorkstreams = (workstreams) => {
+        const sowDocs = [];
+        for (const workstream of workstreams) {
+            if (workstream.sow) {
+                sowDocs.push(workstream.sow);
+            }
+            if (workstream.initialProposal?.sow) {
+                sowDocs.push(workstream.initialProposal.sow);
+            }
+            for (const altProposal of workstream.alternativeProposals || []) {
+                if (altProposal.sow) {
+                    sowDocs.push(altProposal.sow);
+                }
+            }
+        }
+        return sowDocs;
+    };
+    // Helper function to fetch builder profiles for contributors
+    const fetchBuilderProfilesForContributors = async (contributorPhids) => {
+        const builderProfileMap = new Map();
+        if (contributorPhids.size > 0) {
+            const builderProfileDocs = await Promise.all(Array.from(contributorPhids).map(async (phid) => {
+                try {
+                    return await reactorClient.get(phid);
+                }
+                catch (error) {
+                    console.warn(`Failed to fetch builder profile ${phid}:`, error);
+                    return null;
+                }
+            }));
+            builderProfileDocs.forEach((doc) => {
+                if (doc && doc.header.documentType === "powerhouse/builder-profile") {
+                    builderProfileMap.set(doc.header.id, doc);
+                    // Also collect contributor PHIDs from these builder profiles
+                    const state = doc.state.global;
+                    if (state?.contributors && Array.isArray(state.contributors)) {
+                        state.contributors.forEach((phid) => {
+                            if (phid && !builderProfileMap.has(phid)) {
+                                contributorPhids.add(phid);
+                            }
+                        });
+                    }
+                }
+            });
+            // Fetch nested contributors if any were found
+            const nestedContributorPhids = Array.from(contributorPhids).filter((phid) => !builderProfileMap.has(phid));
+            if (nestedContributorPhids.length > 0) {
+                const nestedContributorDocs = await Promise.all(nestedContributorPhids.map(async (phid) => {
+                    try {
+                        return await reactorClient.get(phid);
+                    }
+                    catch (error) {
+                        console.warn(`Failed to fetch contributor builder profile ${phid}:`, error);
+                        return null;
+                    }
+                }));
+                nestedContributorDocs.forEach((doc) => {
+                    if (doc && doc.header.documentType === "powerhouse/builder-profile") {
+                        builderProfileMap.set(doc.header.id, doc);
+                    }
+                });
+            }
+        }
+        return builderProfileMap;
+    };
     const hydrateWorkstreamRow = async (row) => {
         try {
-            const doc = await reactor.getDocument(row.workstream_phid);
+            const doc = await reactorClient.get(row.workstream_phid);
             const state = doc.state.global;
             const initialProposalBase = state.initialProposal
                 ? {
@@ -81,14 +202,16 @@ export const getResolvers = (subgraph) => {
                 status: p.status,
                 author: p.author,
             }));
-            const [topSowDoc, topPaymentTermsDoc, initialSowDoc, initialPaymentTermsDoc, altSowDocs, altPaymentDocs, rfpDetails,] = await Promise.all([
-                loadLinkedDocument(state.sow || row.sow_phid || null),
+            const [topSowDoc, topPaymentTermsDoc, initialSowDoc, initialPaymentTermsDoc, altSowDocs, altPaymentDocs, rfpDetails, networkInfo,] = await Promise.all([
+                // Use document state as source of truth - don't fallback to DB
+                loadLinkedDocument(state.sow || null),
                 loadLinkedDocument(state.paymentTerms || null),
-                loadLinkedDocument(state.initialProposal?.sow || row.sow_phid || null),
+                loadLinkedDocument(state.initialProposal?.sow || null),
                 loadLinkedDocument(state.initialProposal?.paymentTerms || null),
                 Promise.all((state.alternativeProposals || []).map((p) => loadLinkedDocument(p.sow || null))),
                 Promise.all((state.alternativeProposals || []).map((p) => loadLinkedDocument(p.paymentTerms || null))),
                 loadRfpDetails(state.rfp || null),
+                loadNetworkProfile(state.client?.id || row.network_phid || null),
             ]);
             const client = state.client ??
                 (row.network_phid
@@ -97,8 +220,12 @@ export const getResolvers = (subgraph) => {
             return {
                 code: state.code || null,
                 title: state.title || row.workstream_title || null,
+                slug: state.title
+                    ? state.title.toLowerCase().trim().split(/\s+/).join("-")
+                    : null,
                 status: state.status || row.workstream_status || null,
                 client,
+                network: networkInfo,
                 rfp: rfpDetails,
                 initialProposal: initialProposalBase
                     ? {
@@ -118,13 +245,16 @@ export const getResolvers = (subgraph) => {
             };
         }
         catch {
+            const networkInfo = await loadNetworkProfile(row.network_phid || null);
             return {
                 code: row.workstream_title || null,
                 title: row.workstream_title || null,
+                slug: row.workstream_slug || null,
                 status: row.workstream_status || null,
                 client: row.network_phid
                     ? { id: row.network_phid, name: row.network_slug, icon: null }
                     : null,
+                network: networkInfo,
                 rfp: null,
                 initialProposal: null,
                 alternativeProposals: [],
@@ -135,12 +265,22 @@ export const getResolvers = (subgraph) => {
         }
     };
     const applyWorkstreamFilters = (qb, filters, wantedSlug) => {
-        if (filters.workstreamId) {
+        // Handle workstreamId and workstreamSlug (from WorkstreamFilter)
+        if ("workstreamId" in filters && filters.workstreamId) {
             qb = qb.where("workstream_phid", "=", filters.workstreamId);
         }
-        else if (filters.workstreamSlug) {
+        else if ("workstreamSlug" in filters && filters.workstreamSlug) {
             qb = qb.where("workstream_slug", "=", filters.workstreamSlug);
         }
+        // Handle workstreamTitle filter (from WorkstreamsFilter)
+        if ("workstreamTitle" in filters && filters.workstreamTitle) {
+            // Use case-insensitive partial match for workstream title
+            // Filter out NULL values and do case-insensitive search
+            const searchPattern = `%${filters.workstreamTitle.toLowerCase()}%`;
+            qb = qb
+                .where("workstream_title", "is not", null)
+                .where((eb) => eb(sql `LOWER(workstream_title)`, "like", searchPattern));
+        }
         if (filters.networkId) {
             qb = qb.where("network_phid", "=", filters.networkId);
         }
@@ -150,6 +290,15 @@ export const getResolvers = (subgraph) => {
         else if (filters.networkName && wantedSlug) {
             qb = qb.where("network_slug", "=", wantedSlug);
         }
+        else if ("networkNames" in filters && filters.networkNames) {
+            // Handle networkNames filter (from WorkstreamsFilter)
+            const networkSlugs = filters.networkNames
+                .filter((name) => Boolean(name))
+                .map((name) => deriveSlug(name));
+            if (networkSlugs.length > 0) {
+                qb = qb.where("network_slug", "in", networkSlugs);
+            }
+        }
         const statuses = (filters.workstreamStatuses || []).filter((status) => Boolean(status));
         if (statuses.length > 0) {
             qb = qb.where("workstream_status", "in", statuses);
@@ -182,13 +331,21 @@ export const getResolvers = (subgraph) => {
     };
     return {
         Query: {
-            processorWorkstreams: async (parent, args) => {
+            processorWorkstreams: async () => {
                 const drives = await getCandidateDrives();
                 const allProcessorWorkstreams = await Promise.all(drives.map(async (driveId) => {
-                    return WorkstreamsProcessor.query(driveId, db)
-                        .selectFrom("workstreams")
-                        .selectAll()
-                        .execute();
+                    const namespace = WorkstreamsProcessor.getNamespace(driveId);
+                    console.log(`[WorkstreamsProcessor] Resolver querying drive: ${driveId}, namespace: ${namespace}`);
+                    try {
+                        return await WorkstreamsProcessor.query(driveId, db)
+                            .selectFrom("workstreams")
+                            .selectAll()
+                            .execute();
+                    }
+                    catch (error) {
+                        console.warn(`[WorkstreamsProcessor] Failed to query namespace ${namespace}:`, error);
+                        return []; // Return empty array if table doesn't exist for this drive
+                    }
                 }));
                 // Flatten the array of arrays into a single array
                 const flattenedWorkstreams = allProcessorWorkstreams.flat();
@@ -211,18 +368,107 @@ export const getResolvers = (subgraph) => {
                 const candidateDrives = await getCandidateDrives();
                 const wantedSlug = filters.networkSlug ||
                     (filters.networkName ? deriveSlug(filters.networkName) : undefined);
-                let resolved = null;
+                const resolved = [];
+                const contributorPhids = new Set();
                 for (const driveId of candidateDrives) {
                     let qb = WorkstreamsProcessor.query(driveId, db)
                         .selectFrom("workstreams")
                         .selectAll();
                     qb = applyWorkstreamFilters(qb, filters, wantedSlug);
-                    const row = await qb.executeTakeFirst();
-                    if (!row)
+                    const rows = await qb.execute();
+                    if (rows.length === 0) {
                         continue;
-                    resolved = await hydrateWorkstreamRow(row);
+                    }
+                    for (const row of rows) {
+                        const hydrated = await hydrateWorkstreamRow(row);
+                        resolved.push(hydrated);
+                    }
                     break;
                 }
+                // Collect SOWs and their contributors
+                const sowDocs = collectSowsFromWorkstreams(resolved);
+                for (const sow of sowDocs) {
+                    if (!sow || typeof sow !== "object")
+                        continue;
+                    if (Array.isArray(sow.contributors)) {
+                        sow.contributors.forEach((contributor) => {
+                            const phid = extractPhid(contributor);
+                            if (phid)
+                                contributorPhids.add(phid);
+                        });
+                    }
+                    // Collect deliverable owners too so `SOW_Deliverable.owner` can resolve
+                    if (Array.isArray(sow.deliverables)) {
+                        sow.deliverables.forEach((deliverable) => {
+                            if (!deliverable || typeof deliverable !== "object")
+                                return;
+                            const phid = extractPhid(deliverable.owner);
+                            if (phid)
+                                contributorPhids.add(phid);
+                        });
+                    }
+                    // Collect project owners too so `SOW_Project.projectOwner` can resolve
+                    if (Array.isArray(sow.projects)) {
+                        sow.projects.forEach((project) => {
+                            if (!project || typeof project !== "object")
+                                return;
+                            const phid = extractPhid(project.projectOwner);
+                            if (phid)
+                                contributorPhids.add(phid);
+                        });
+                    }
+                }
+                // Fetch all builder profile documents for contributors
+                const builderProfileMap = await fetchBuilderProfilesForContributors(contributorPhids);
+                // Create helper function to get builder profile data by PHID
+                getBuilderProfileByPhid = (phid) => {
+                    const doc = builderProfileMap.get(phid);
+                    if (!doc)
+                        return null;
+                    const state = doc.state.global;
+                    // Store contributor PHIDs separately - they'll be resolved by the field resolver
+                    const contributorPhids = state?.contributors ?? [];
+                    // Ensure all non-nullable Builder fields are properly handled
+                    // name: String! - non-nullable
+                    const name = String(state?.name ?? doc.header?.name ?? "");
+                    // icon: String! - non-nullable
+                    const icon = String(state?.icon ?? "");
+                    // description: String! - non-nullable
+                    const description = String(state?.description ?? state?.slug ?? "");
+                    // isOperator: Boolean! - non-nullable, default to false
+                    const isOperator = state?.isOperator ?? false;
+                    // operationalHubMember: OpHubMember! - non-nullable
+                    const operationalHubMember = state?.operationalHubMember ?? {
+                        name: null,
+                        phid: null,
+                    };
+                    // skills: [BuilderSkill!]! - non-nullable array (document model uses 'skils' typo)
+                    const skills = Array.isArray(state?.skils)
+                        ? state.skils
+                        : Array.isArray(state?.skills)
+                            ? state.skills
+                            : [];
+                    // scopes: [BuilderScope!]! - non-nullable array
+                    const scopes = Array.isArray(state?.scopes) ? state.scopes : [];
+                    // links: [BuilderLink!]! - non-nullable array
+                    const links = Array.isArray(state?.links) ? state.links : [];
+                    return {
+                        id: doc.header.id,
+                        code: state?.code ?? null,
+                        slug: state?.slug ?? null,
+                        name,
+                        icon,
+                        description,
+                        lastModified: state?.lastModified ?? null,
+                        isOperator,
+                        operationalHubMember,
+                        _contributorPhids: contributorPhids, // Internal field for resolver
+                        status: state?.status ?? null,
+                        skills,
+                        scopes,
+                        links,
+                    };
+                };
                 return resolved;
             },
             workstreams: async (parent, args) => {
@@ -232,26 +478,21 @@ export const getResolvers = (subgraph) => {
                 const hasFilters = filters.networkId ||
                     filters.networkSlug ||
                     filters.networkName ||
+                    (filters.networkNames && filters.networkNames.length > 0) ||
+                    filters.workstreamTitle ||
                     filters.workstreamStatus ||
-                    (filters.workstreamStatuses &&
-                        filters.workstreamStatuses.length > 0);
+                    (filters.workstreamStatuses && filters.workstreamStatuses.length > 0);
                 const wantedSlug = filters.networkSlug ||
                     (filters.networkName ? deriveSlug(filters.networkName) : undefined);
                 const results = [];
+                const contributorPhids = new Set();
                 for (const driveId of candidateDrives) {
                     let qb = WorkstreamsProcessor.query(driveId, db)
                         .selectFrom("workstreams")
                         .selectAll();
                     // Only apply filters if any are provided
                     if (hasFilters) {
-                        const filterArgs = {
-                            networkId: filters.networkId,
-                            networkSlug: filters.networkSlug,
-                            networkName: filters.networkName,
-                            workstreamStatus: filters.workstreamStatus,
-                            workstreamStatuses: filters.workstreamStatuses,
-                        };
-                        qb = applyWorkstreamFilters(qb, filterArgs, wantedSlug);
+                        qb = applyWorkstreamFilters(qb, filters, wantedSlug);
                     }
                     const rows = await qb.execute();
                     if (rows.length === 0) {
@@ -262,6 +503,90 @@ export const getResolvers = (subgraph) => {
                         results.push(hydrated);
                     }
                 }
+                // Collect SOWs and their contributors
+                const sowDocs = collectSowsFromWorkstreams(results);
+                for (const sow of sowDocs) {
+                    if (!sow || typeof sow !== "object")
+                        continue;
+                    if (Array.isArray(sow.contributors)) {
+                        sow.contributors.forEach((contributor) => {
+                            const phid = extractPhid(contributor);
+                            if (phid)
+                                contributorPhids.add(phid);
+                        });
+                    }
+                    // Collect deliverable owners too so `SOW_Deliverable.owner` can resolve
+                    if (Array.isArray(sow.deliverables)) {
+                        sow.deliverables.forEach((deliverable) => {
+                            if (!deliverable || typeof deliverable !== "object")
+                                return;
+                            const phid = extractPhid(deliverable.owner);
+                            if (phid)
+                                contributorPhids.add(phid);
+                        });
+                    }
+                    // Collect project owners too so `SOW_Project.projectOwner` can resolve
+                    if (Array.isArray(sow.projects)) {
+                        sow.projects.forEach((project) => {
+                            if (!project || typeof project !== "object")
+                                return;
+                            const phid = extractPhid(project.projectOwner);
+                            if (phid)
+                                contributorPhids.add(phid);
+                        });
+                    }
+                }
+                // Fetch all builder profile documents for contributors
+                const builderProfileMap = await fetchBuilderProfilesForContributors(contributorPhids);
+                // Create helper function to get builder profile data by PHID
+                getBuilderProfileByPhid = (phid) => {
+                    const doc = builderProfileMap.get(phid);
+                    if (!doc)
+                        return null;
+                    const state = doc.state.global;
+                    // Store contributor PHIDs separately - they'll be resolved by the field resolver
+                    const contributorPhids = state?.contributors ?? [];
+                    // Ensure all non-nullable Builder fields are properly handled
+                    // name: String! - non-nullable
+                    const name = String(state?.name ?? doc.header?.name ?? "");
+                    // icon: String! - non-nullable
+                    const icon = String(state?.icon ?? "");
+                    // description: String! - non-nullable
+                    const description = String(state?.description ?? state?.slug ?? "");
+                    // isOperator: Boolean! - non-nullable, default to false
+                    const isOperator = state?.isOperator ?? false;
+                    // operationalHubMember: OpHubMember! - non-nullable
+                    const operationalHubMember = state?.operationalHubMember ?? {
+                        name: null,
+                        phid: null,
+                    };
+                    // skills: [BuilderSkill!]! - non-nullable array (document model uses 'skils' typo)
+                    const skills = Array.isArray(state?.skils)
+                        ? state.skils
+                        : Array.isArray(state?.skills)
+                            ? state.skills
+                            : [];
+                    // scopes: [BuilderScope!]! - non-nullable array
+                    const scopes = Array.isArray(state?.scopes) ? state.scopes : [];
+                    // links: [BuilderLink!]! - non-nullable array
+                    const links = Array.isArray(state?.links) ? state.links : [];
+                    return {
+                        id: doc.header.id,
+                        code: state?.code ?? null,
+                        slug: state?.slug ?? null,
+                        name,
+                        icon,
+                        description,
+                        lastModified: state?.lastModified ?? null,
+                        isOperator,
+                        operationalHubMember,
+                        _contributorPhids: contributorPhids, // Internal field for resolver
+                        status: state?.status ?? null,
+                        skills,
+                        scopes,
+                        links,
+                    };
+                };
                 return results;
             },
             rfpByWorkstream: async (parent, args) => {
@@ -300,6 +625,7 @@ export const getResolvers = (subgraph) => {
                 const wantedSlug = filters.networkSlug ||
                     (filters.networkName ? deriveSlug(filters.networkName) : undefined);
                 const results = [];
+                const contributorPhids = new Set();
                 for (const driveId of candidateDrives) {
                     let qb = WorkstreamsProcessor.query(driveId, db)
                         .selectFrom("workstreams")
@@ -342,10 +668,43 @@ export const getResolvers = (subgraph) => {
                         else if (filters.proposalRole === "AWARDED") {
                             // For AWARDED, we check if the workstream status is AWARDED
                             // and return the initial proposal's SOW (as it's typically the awarded one)
-                            if (hydrated.status === "AWARDED" && hydrated.initialProposal?.sow) {
+                            if (hydrated.status === "AWARDED" &&
+                                hydrated.initialProposal?.sow) {
                                 sowDocs.push(hydrated.initialProposal.sow);
                             }
                         }
+                        // Collect contributor PHIDs from all SOWs
+                        for (const sow of sowDocs) {
+                            if (!sow || typeof sow !== "object")
+                                continue;
+                            if (Array.isArray(sow.contributors)) {
+                                sow.contributors.forEach((contributor) => {
+                                    const phid = extractPhid(contributor);
+                                    if (phid)
+                                        contributorPhids.add(phid);
+                                });
+                            }
+                            // Collect deliverable owners too so `SOW_Deliverable.owner` can resolve
+                            if (Array.isArray(sow.deliverables)) {
+                                sow.deliverables.forEach((deliverable) => {
+                                    if (!deliverable || typeof deliverable !== "object")
+                                        return;
+                                    const phid = extractPhid(deliverable.owner);
+                                    if (phid)
+                                        contributorPhids.add(phid);
+                                });
+                            }
+                            // Collect project owners too so `SOW_Project.projectOwner` can resolve
+                            if (Array.isArray(sow.projects)) {
+                                sow.projects.forEach((project) => {
+                                    if (!project || typeof project !== "object")
+                                        return;
+                                    const phid = extractPhid(project.projectOwner);
+                                    if (phid)
+                                        contributorPhids.add(phid);
+                                });
+                            }
+                        }
                         // Filter out null/undefined SOWs and add to results
                         for (const sow of sowDocs) {
                             if (sow) {
@@ -357,13 +716,65 @@ export const getResolvers = (subgraph) => {
                         break;
                     }
                 }
+                // Fetch all builder profile documents for contributors
+                const builderProfileMap = await fetchBuilderProfilesForContributors(contributorPhids);
+                // Create helper function to get builder profile data by PHID
+                getBuilderProfileByPhid = (phid) => {
+                    const doc = builderProfileMap.get(phid);
+                    if (!doc)
+                        return null;
+                    const state = doc.state.global;
+                    // Store contributor PHIDs separately - they'll be resolved by the field resolver
+                    const contributorPhids = state?.contributors ?? [];
+                    // Ensure all non-nullable Builder fields are properly handled
+                    // name: String! - non-nullable
+                    const name = String(state?.name ?? doc.header?.name ?? "");
+                    // icon: String! - non-nullable
+                    const icon = String(state?.icon ?? "");
+                    // description: String! - non-nullable
+                    const description = String(state?.description ?? state?.slug ?? "");
+                    // isOperator: Boolean! - non-nullable, default to false
+                    const isOperator = state?.isOperator ?? false;
+                    // operationalHubMember: OpHubMember! - non-nullable
+                    const operationalHubMember = state?.operationalHubMember ?? {
+                        name: null,
+                        phid: null,
+                    };
+                    // skills: [BuilderSkill!]! - non-nullable array (document model uses 'skils' typo)
+                    const skills = Array.isArray(state?.skils)
+                        ? state.skils
+                        : Array.isArray(state?.skills)
+                            ? state.skills
+                            : [];
+                    // scopes: [BuilderScope!]! - non-nullable array
+                    const scopes = Array.isArray(state?.scopes) ? state.scopes : [];
+                    // links: [BuilderLink!]! - non-nullable array
+                    const links = Array.isArray(state?.links) ? state.links : [];
+                    return {
+                        id: doc.header.id,
+                        code: state?.code ?? null,
+                        slug: state?.slug ?? null,
+                        name,
+                        icon,
+                        description,
+                        lastModified: state?.lastModified ?? null,
+                        isOperator,
+                        operationalHubMember,
+                        _contributorPhids: contributorPhids, // Internal field for resolver
+                        status: state?.status ?? null,
+                        skills,
+                        scopes,
+                        links,
+                    };
+                };
                 return results;
             },
         },
         SOW_Progress: {
             __resolveType(obj) {
                 if (obj && typeof obj === "object") {
-                    if (Object.prototype.hasOwnProperty.call(obj, "total") && Object.prototype.hasOwnProperty.call(obj, "completed")) {
+                    if (Object.prototype.hasOwnProperty.call(obj, "total") &&
+                        Object.prototype.hasOwnProperty.call(obj, "completed")) {
                         return "SOW_StoryPoint";
                     }
                     if (Object.prototype.hasOwnProperty.call(obj, "value")) {
@@ -374,7 +785,81 @@ export const getResolvers = (subgraph) => {
                     }
                 }
                 return null;
-            }
-        }
+            },
+        },
+        SOW_ScopeOfWorkState: {
+            contributors: (parent) => {
+                // Resolve contributor PHIDs to Builder objects
+                if (!parent.contributors || parent.contributors.length === 0) {
+                    return [];
+                }
+                if (!getBuilderProfileByPhid) {
+                    return [];
+                }
+                return parent.contributors
+                    .map((contributor) => {
+                    // Handle both string PHIDs and objects with id property
+                    const phid = typeof contributor === "string" ? contributor : contributor?.id;
+                    if (!phid || typeof phid !== "string") {
+                        return null;
+                    }
+                    return getBuilderProfileByPhid(phid);
+                })
+                    .filter((builder) => builder !== null);
+            },
+        },
+        SOW_Deliverable: {
+            owner: (parent) => {
+                // Handle null, undefined, or empty string cases
+                if (parent?.owner === null || parent?.owner === undefined) {
+                    return null;
+                }
+                // Check if it's an empty string
+                if (typeof parent.owner === "string" && parent.owner.trim() === "") {
+                    return null;
+                }
+                if (!getBuilderProfileByPhid)
+                    return null;
+                const phid = extractPhid(parent.owner);
+                if (!phid)
+                    return null;
+                return getBuilderProfileByPhid(phid);
+            },
+        },
+        SOW_Project: {
+            projectOwner: (parent) => {
+                // Handle null, undefined, or empty string cases
+                if (parent?.projectOwner === null ||
+                    parent?.projectOwner === undefined) {
+                    return null;
+                }
+                // Check if it's an empty string
+                if (typeof parent.projectOwner === "string" &&
+                    parent.projectOwner.trim() === "") {
+                    return null;
+                }
+                if (!getBuilderProfileByPhid)
+                    return null;
+                const phid = extractPhid(parent.projectOwner);
+                if (!phid)
+                    return null;
+                return getBuilderProfileByPhid(phid);
+            },
+        },
+        Builder: {
+            contributors: (parent) => {
+                // Resolve contributor PHIDs to Builder objects
+                if (!parent._contributorPhids ||
+                    parent._contributorPhids.length === 0) {
+                    return [];
+                }
+                if (!getBuilderProfileByPhid) {
+                    return [];
+                }
+                return parent._contributorPhids
+                    .map((phid) => getBuilderProfileByPhid(phid))
+                    .filter((builder) => builder !== null);
+            },
+        },
     };
 };