@grafema/api 0.2.5-beta

package/dist/pagination.js

@@ -0,0 +1,71 @@
+/**
+ * Cursor-based Pagination Utilities
+ *
+ * Implements Relay Connection spec for cursor-based pagination.
+ */
+/**
+ * Encode a cursor from an ID.
+ * Format: base64("cursor:${id}")
+ */
+export function encodeCursor(id) {
+    return Buffer.from(`cursor:${id}`).toString('base64');
+}
+/**
+ * Decode a cursor to get the ID.
+ * Returns null if cursor is invalid.
+ */
+export function decodeCursor(cursor) {
+    try {
+        const decoded = Buffer.from(cursor, 'base64').toString('utf-8');
+        if (decoded.startsWith('cursor:')) {
+            return decoded.slice(7);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Apply cursor-based pagination to an array.
+ *
+ * @param items - All items (already filtered)
+ * @param first - Number of items to return (default: 50, max: 250)
+ * @param after - Cursor to start after
+ * @param getId - Function to get ID from item for cursor encoding
+ * @returns Connection structure
+ */
+export function paginateArray(items, first, after, getId) {
+    const limit = Math.min(first ?? 50, 250);
+    // Find start index based on cursor
+    let startIndex = 0;
+    if (after) {
+        const afterId = decodeCursor(after);
+        if (afterId) {
+            const afterIndex = items.findIndex((item) => getId(item) === afterId);
+            if (afterIndex !== -1) {
+                startIndex = afterIndex + 1;
+            }
+        }
+    }
+    // Slice items
+    const slicedItems = items.slice(startIndex, startIndex + limit);
+    // Build edges
+    const edges = slicedItems.map((item) => ({
+        node: item,
+        cursor: encodeCursor(getId(item)),
+    }));
+    // Build pageInfo
+    const pageInfo = {
+        hasNextPage: startIndex + limit < items.length,
+        hasPreviousPage: startIndex > 0,
+        startCursor: edges.length > 0 ? edges[0].cursor : null,
+        endCursor: edges.length > 0 ? edges[edges.length - 1].cursor : null,
+    };
+    return {
+        edges,
+        pageInfo,
+        totalCount: items.length,
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AA6BD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAU,EACV,KAAgC,EAChC,KAAgC,EAChC,KAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAEzC,mCAAmC;IACnC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC;YACtE,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtB,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;IAEhE,cAAc;IACd,MAAM,KAAK,GAAc,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KAClC,CAAC,CAAC,CAAC;IAEJ,iBAAiB;IACjB,MAAM,QAAQ,GAAa;QACzB,WAAW,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM;QAC9C,eAAe,EAAE,UAAU,GAAG,CAAC;QAC/B,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QACtD,SAAS,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;KACpE,CAAC;IAEF,OAAO;QACL,KAAK;QACL,QAAQ;QACR,UAAU,EAAE,KAAK,CAAC,MAAM;KACzB,CAAC;AACJ,CAAC"}

package/dist/resolvers/edge.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Edge Type Resolvers
+ *
+ * Resolves fields on Edge type that require lookups.
+ */
+import type { EdgeRecord } from '@grafema/types';
+import type { GraphQLContext } from '../context.js';
+export declare const edgeResolvers: {
+    /**
+     * Resolve source node.
+     */
+    src(parent: EdgeRecord, _args: unknown, context: GraphQLContext): Promise<import("@grafema/types").BaseNodeRecord | null>;
+    /**
+     * Resolve destination node.
+     */
+    dst(parent: EdgeRecord, _args: unknown, context: GraphQLContext): Promise<import("@grafema/types").BaseNodeRecord | null>;
+    /**
+     * Resolve metadata field.
+     */
+    metadata(parent: EdgeRecord): any;
+};
+//# sourceMappingURL=edge.d.ts.map

package/dist/resolvers/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../src/resolvers/edge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,eAAO,MAAM,aAAa;IACxB;;OAEG;gBACe,UAAU,SAAS,OAAO,WAAW,cAAc;IAIrE;;OAEG;gBACe,UAAU,SAAS,OAAO,WAAW,cAAc;IAIrE;;OAEG;qBACc,UAAU;CAW5B,CAAC"}

package/dist/resolvers/edge.js

@@ -0,0 +1,36 @@
+/**
+ * Edge Type Resolvers
+ *
+ * Resolves fields on Edge type that require lookups.
+ */
+export const edgeResolvers = {
+    /**
+     * Resolve source node.
+     */
+    async src(parent, _args, context) {
+        return context.loaders.node.load(parent.src);
+    },
+    /**
+     * Resolve destination node.
+     */
+    async dst(parent, _args, context) {
+        return context.loaders.node.load(parent.dst);
+    },
+    /**
+     * Resolve metadata field.
+     */
+    metadata(parent) {
+        if (!parent.metadata)
+            return null;
+        if (typeof parent.metadata === 'string') {
+            try {
+                return JSON.parse(parent.metadata);
+            }
+            catch {
+                return null;
+            }
+        }
+        return parent.metadata;
+    },
+};
+//# sourceMappingURL=edge.js.map

package/dist/resolvers/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../../src/resolvers/edge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAAkB,EAAE,KAAc,EAAE,OAAuB;QACnE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAAkB,EAAE,KAAc,EAAE,OAAuB;QACnE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAkB;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;CACF,CAAC"}

package/dist/resolvers/index.d.ts

@@ -0,0 +1,159 @@
+/**
+ * GraphQL Resolver Map
+ *
+ * Combines all resolvers and adds custom scalar handlers.
+ */
+export declare const resolvers: {
+    JSON: import("graphql").GraphQLScalarType<any, any>;
+    Node: {
+        outgoingEdges(parent: import("@grafema/types").BaseNodeRecord, args: {
+            types?: string[] | null;
+            first?: number | null;
+            after?: string | null;
+        }, context: import("../context.js").GraphQLContext): Promise<import("../pagination.js").Connection<import("@grafema/types").EdgeRecord>>;
+        incomingEdges(parent: import("@grafema/types").BaseNodeRecord, args: {
+            types?: string[] | null;
+            first?: number | null;
+            after?: string | null;
+        }, context: import("../context.js").GraphQLContext): Promise<import("../pagination.js").Connection<import("@grafema/types").EdgeRecord>>;
+        children(parent: import("@grafema/types").BaseNodeRecord, args: {
+            first?: number | null;
+            after?: string | null;
+        }, context: import("../context.js").GraphQLContext): Promise<import("../pagination.js").Connection<import("@grafema/types").BaseNodeRecord>>;
+        parent(parent: import("@grafema/types").BaseNodeRecord, _args: unknown, context: import("../context.js").GraphQLContext): Promise<import("@grafema/types").BaseNodeRecord | null>;
+        metadata(parent: import("@grafema/types").BaseNodeRecord): any;
+    };
+    Edge: {
+        src(parent: import("@grafema/types").EdgeRecord, _args: unknown, context: import("../context.js").GraphQLContext): Promise<import("@grafema/types").BaseNodeRecord | null>;
+        dst(parent: import("@grafema/types").EdgeRecord, _args: unknown, context: import("../context.js").GraphQLContext): Promise<import("@grafema/types").BaseNodeRecord | null>;
+        metadata(parent: import("@grafema/types").EdgeRecord): any;
+    };
+    Query: {
+        node(_: unknown, args: {
+            id: string;
+        }, context: import("../context.js").GraphQLContext): Promise<import("@grafema/types").BaseNodeRecord | null>;
+        nodes(_: unknown, args: {
+            filter?: import("./query.js").NodeFilter | null;
+            first?: number | null;
+            after?: string | null;
+        }, context: import("../context.js").GraphQLContext): Promise<import("../pagination.js").Connection<import("@grafema/types").BaseNodeRecord>>;
+        bfs(_: unknown, args: {
+            startIds: string[];
+            maxDepth: number;
+            edgeTypes: string[];
+        }, context: import("../context.js").GraphQLContext): Promise<string[]>;
+        dfs(_: unknown, args: {
+            startIds: string[];
+            maxDepth: number;
+            edgeTypes?: string[] | null;
+        }, context: import("../context.js").GraphQLContext): Promise<string[]>;
+        reachability(_: unknown, args: {
+            from: string;
+            to: string;
+            edgeTypes?: string[] | null;
+            maxDepth?: number | null;
+        }, context: import("../context.js").GraphQLContext): Promise<boolean>;
+        datalog(_: unknown, args: {
+            query: string;
+            limit?: number | null;
+            offset?: number | null;
+        }, context: import("../context.js").GraphQLContext): Promise<{
+            success: boolean;
+            count: number;
+            results: {
+                bindings: {
+                    [k: string]: string;
+                };
+                node: import("@grafema/types").BaseNodeRecord | null;
+            }[];
+            error: null;
+        } | {
+            success: boolean;
+            count: number;
+            results: never[];
+            error: string;
+        }>;
+        stats(_: unknown, _args: unknown, context: import("../context.js").GraphQLContext): Promise<import("@grafema/core/storage/backends/RFDBServerBackend").BackendStats>;
+        analysisStatus(_: unknown, _args: unknown, _context: import("../context.js").GraphQLContext): Promise<{
+            running: boolean;
+            phase: null;
+            message: null;
+            servicesDiscovered: number;
+            servicesAnalyzed: number;
+            error: null;
+        }>;
+        guarantees(_: unknown, _args: unknown, _context: import("../context.js").GraphQLContext): Promise<never[]>;
+        guarantee(_: unknown, _args: {
+            id: string;
+        }, _context: import("../context.js").GraphQLContext): Promise<null>;
+        findCalls(_: unknown, _args: {
+            target: string;
+            className?: string | null;
+            limit?: number | null;
+            offset?: number | null;
+        }, _context: import("../context.js").GraphQLContext): Promise<never[]>;
+        getFunctionDetails(_: unknown, _args: {
+            name: string;
+            file?: string | null;
+            transitive?: boolean | null;
+        }, _context: import("../context.js").GraphQLContext): Promise<null>;
+        findGuards(_: unknown, _args: {
+            nodeId: string;
+        }, _context: import("../context.js").GraphQLContext): Promise<never[]>;
+        traceAlias(_: unknown, _args: {
+            variableName: string;
+            file: string;
+            maxDepth?: number | null;
+        }, _context: import("../context.js").GraphQLContext): Promise<never[]>;
+        traceDataFlow(_: unknown, _args: {
+            source: string;
+            file?: string | null;
+            direction?: string | null;
+            maxDepth?: number | null;
+        }, _context: import("../context.js").GraphQLContext): Promise<never[]>;
+    };
+    Mutation: {
+        analyzeProject(_: unknown, _args: {
+            service?: string | null;
+            force?: boolean | null;
+        }, _context: import("../context.js").GraphQLContext): Promise<{
+            success: boolean;
+            status: {
+                running: boolean;
+                phase: null;
+                message: string;
+                servicesDiscovered: number;
+                servicesAnalyzed: number;
+                error: string;
+            };
+        }>;
+        createGuarantee(_: unknown, _args: {
+            input: Record<string, unknown>;
+        }, _context: import("../context.js").GraphQLContext): Promise<never>;
+        deleteGuarantee(_: unknown, _args: {
+            name: string;
+        }, _context: import("../context.js").GraphQLContext): Promise<never>;
+        checkGuarantees(_: unknown, _args: {
+            names?: string[] | null;
+        }, _context: import("../context.js").GraphQLContext): Promise<{
+            total: number;
+            passed: number;
+            failed: number;
+            results: never[];
+        }>;
+        checkInvariant(_: unknown, args: {
+            rule: string;
+            description?: string | null;
+        }, context: import("../context.js").GraphQLContext): Promise<{
+            guaranteeId: string;
+            passed: boolean;
+            violationCount: number;
+            violations: {
+                node: null;
+                file: null;
+                line: null;
+            }[];
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,SAAS;;;;iBASR,CAAC;iBACD,CAAC;iBAEZ,CAAC;;;iBAAqgB,CAAC;iBAAwB,CAAC;iBAAsB,CAAC;;;iBAA+f,CAAC;iBAAsB,CAAC;;;;;;;;;;;;;;;kBAAnuB,CAAC;iBAAgC,CAAC;iBAA4B,CAAC;;;;;;;;;;qBAAkxC,CAAC;;;;;qBAAkY,CAAC;oBAAiC,CAAC;;;;iBAAmb,CAAC;kBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAAu6E,CAAC;iBAA4B,CAAC;kBAA6B,CAAC;;;;gBAAwT,CAAC;sBAAiC,CAAC;;;;;;;;oBAAuf,CAAC;;;;gBAAwN,CAAC;qBAAgC,CAAC;oBAA+B,CAAC;;;;;mBAdvlM,CAAC;iBAE9B,CAAC;;;;;;;;;;;;;;;;;;;iBAYyxB,CAAC;;;;;;;;;uBAA6Q,CAAC;;;;;;;;;;;;CADrjC,CAAC"}

package/dist/resolvers/index.js

@@ -0,0 +1,21 @@
+/**
+ * GraphQL Resolver Map
+ *
+ * Combines all resolvers and adds custom scalar handlers.
+ */
+import { JSONResolver } from 'graphql-scalars';
+import { nodeResolvers } from './node.js';
+import { edgeResolvers } from './edge.js';
+import { queryResolvers } from './query.js';
+import { mutationResolvers } from './mutation.js';
+export const resolvers = {
+    // Custom scalars
+    JSON: JSONResolver,
+    // Type resolvers
+    Node: nodeResolvers,
+    Edge: edgeResolvers,
+    // Root resolvers
+    Query: queryResolvers,
+    Mutation: mutationResolvers,
+};
+//# sourceMappingURL=index.js.map

package/dist/resolvers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iBAAiB;IACjB,IAAI,EAAE,YAAY;IAElB,iBAAiB;IACjB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,aAAa;IAEnB,iBAAiB;IACjB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,iBAAiB;CAC5B,CAAC"}

package/dist/resolvers/mutation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Mutation Resolvers
+ *
+ * Implements all Mutation type fields.
+ */
+import type { GraphQLContext } from '../context.js';
+export declare const mutationResolvers: {
+    /**
+     * Run project analysis.
+     * Placeholder - would integrate with Orchestrator.
+     */
+    analyzeProject(_: unknown, _args: {
+        service?: string | null;
+        force?: boolean | null;
+    }, _context: GraphQLContext): Promise<{
+        success: boolean;
+        status: {
+            running: boolean;
+            phase: null;
+            message: string;
+            servicesDiscovered: number;
+            servicesAnalyzed: number;
+            error: string;
+        };
+    }>;
+    /**
+     * Create a new guarantee.
+     * Placeholder - would integrate with GuaranteeManager.
+     */
+    createGuarantee(_: unknown, _args: {
+        input: Record<string, unknown>;
+    }, _context: GraphQLContext): Promise<never>;
+    /**
+     * Delete a guarantee.
+     * Placeholder.
+     */
+    deleteGuarantee(_: unknown, _args: {
+        name: string;
+    }, _context: GraphQLContext): Promise<never>;
+    /**
+     * Check guarantees.
+     * Placeholder.
+     */
+    checkGuarantees(_: unknown, _args: {
+        names?: string[] | null;
+    }, _context: GraphQLContext): Promise<{
+        total: number;
+        passed: number;
+        failed: number;
+        results: never[];
+    }>;
+    /**
+     * Check ad-hoc invariant.
+     */
+    checkInvariant(_: unknown, args: {
+        rule: string;
+        description?: string | null;
+    }, context: GraphQLContext): Promise<{
+        guaranteeId: string;
+        passed: boolean;
+        violationCount: number;
+        violations: {
+            node: null;
+            file: null;
+            line: null;
+        }[];
+    }>;
+};
+//# sourceMappingURL=mutation.d.ts.map

package/dist/resolvers/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/resolvers/mutation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;sBAEE,OAAO,SACH;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,YAChD,cAAc;;;;;;;;;;;IAgB1B;;;OAGG;uBAEE,OAAO,SACH;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,YAC/B,cAAc;IAK1B;;;OAGG;uBAEE,OAAO,SACH;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,YACb,cAAc;IAK1B;;;OAGG;uBAEE,OAAO,SACH;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,YACxB,cAAc;;;;;;IAU1B;;OAEG;sBAEE,OAAO,QACJ;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,WAC1C,cAAc;;;;;;;;;;CA4B1B,CAAC"}

package/dist/resolvers/mutation.js

@@ -0,0 +1,82 @@
+/**
+ * Mutation Resolvers
+ *
+ * Implements all Mutation type fields.
+ */
+export const mutationResolvers = {
+    /**
+     * Run project analysis.
+     * Placeholder - would integrate with Orchestrator.
+     */
+    async analyzeProject(_, _args, _context) {
+        // Placeholder - would integrate with Orchestrator
+        return {
+            success: false,
+            status: {
+                running: false,
+                phase: null,
+                message: 'Analysis via GraphQL not yet implemented',
+                servicesDiscovered: 0,
+                servicesAnalyzed: 0,
+                error: 'Not implemented',
+            },
+        };
+    },
+    /**
+     * Create a new guarantee.
+     * Placeholder - would integrate with GuaranteeManager.
+     */
+    async createGuarantee(_, _args, _context) {
+        throw new Error('createGuarantee not yet implemented');
+    },
+    /**
+     * Delete a guarantee.
+     * Placeholder.
+     */
+    async deleteGuarantee(_, _args, _context) {
+        throw new Error('deleteGuarantee not yet implemented');
+    },
+    /**
+     * Check guarantees.
+     * Placeholder.
+     */
+    async checkGuarantees(_, _args, _context) {
+        return {
+            total: 0,
+            passed: 0,
+            failed: 0,
+            results: [],
+        };
+    },
+    /**
+     * Check ad-hoc invariant.
+     */
+    async checkInvariant(_, args, context) {
+        try {
+            const results = await context.backend.checkGuarantee(args.rule);
+            const passed = results.length === 0;
+            return {
+                guaranteeId: 'adhoc',
+                passed,
+                violationCount: results.length,
+                violations: results.slice(0, 10).map((_r) => {
+                    // Would need async resolution to populate node data
+                    return {
+                        node: null,
+                        file: null,
+                        line: null,
+                    };
+                }),
+            };
+        }
+        catch {
+            return {
+                guaranteeId: 'adhoc',
+                passed: false,
+                violationCount: 0,
+                violations: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=mutation.js.map

package/dist/resolvers/mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.js","sourceRoot":"","sources":["../../src/resolvers/mutation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,CAAU,EACV,KAA0D,EAC1D,QAAwB;QAExB,kDAAkD;QAClD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,0CAA0C;gBACnD,kBAAkB,EAAE,CAAC;gBACrB,gBAAgB,EAAE,CAAC;gBACnB,KAAK,EAAE,iBAAiB;aACzB;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,CAAU,EACV,KAAyC,EACzC,QAAwB;QAExB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,CAAU,EACV,KAAuB,EACvB,QAAwB;QAExB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,CAAU,EACV,KAAkC,EAClC,QAAwB;QAExB,OAAO;YACL,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,CAAU,EACV,IAAmD,EACnD,OAAuB;QAEvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;YAEpC,OAAO;gBACL,WAAW,EAAE,OAAO;gBACpB,MAAM;gBACN,cAAc,EAAE,OAAO,CAAC,MAAM;gBAC9B,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;oBAC1C,oDAAoD;oBACpD,OAAO;wBACL,IAAI,EAAE,IAAI;wBACV,IAAI,EAAE,IAAI;wBACV,IAAI,EAAE,IAAI;qBACX,CAAC;gBACJ,CAAC,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,WAAW,EAAE,OAAO;gBACpB,MAAM,EAAE,KAAK;gBACb,cAAc,EAAE,CAAC;gBACjB,UAAU,EAAE,EAAE;aACf,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/resolvers/node.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Node Type Resolvers
+ *
+ * Resolves relationship fields on Node type.
+ */
+import type { BaseNodeRecord, EdgeRecord } from '@grafema/types';
+import type { GraphQLContext } from '../context.js';
+export declare const nodeResolvers: {
+    /**
+     * Resolve outgoing edges with cursor-based pagination.
+     *
+     * Complexity: O(k) where k = number of outgoing edges from this node
+     */
+    outgoingEdges(parent: BaseNodeRecord, args: {
+        types?: string[] | null;
+        first?: number | null;
+        after?: string | null;
+    }, context: GraphQLContext): Promise<import("../pagination.js").Connection<EdgeRecord>>;
+    /**
+     * Resolve incoming edges with cursor-based pagination.
+     *
+     * Complexity: O(k) where k = number of incoming edges to this node
+     */
+    incomingEdges(parent: BaseNodeRecord, args: {
+        types?: string[] | null;
+        first?: number | null;
+        after?: string | null;
+    }, context: GraphQLContext): Promise<import("../pagination.js").Connection<EdgeRecord>>;
+    /**
+     * Resolve child nodes (via CONTAINS edges) with cursor-based pagination.
+     *
+     * Complexity: O(c) where c = number of children
+     */
+    children(parent: BaseNodeRecord, args: {
+        first?: number | null;
+        after?: string | null;
+    }, context: GraphQLContext): Promise<import("../pagination.js").Connection<BaseNodeRecord>>;
+    /**
+     * Resolve parent node (via incoming CONTAINS edge).
+     *
+     * Complexity: O(1) - single lookup
+     */
+    parent(parent: BaseNodeRecord, _args: unknown, context: GraphQLContext): Promise<BaseNodeRecord | null>;
+    /**
+     * Resolve metadata field.
+     * Parses JSON string if needed.
+     */
+    metadata(parent: BaseNodeRecord): any;
+};
+//# sourceMappingURL=node.d.ts.map

package/dist/resolvers/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/resolvers/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,eAAO,MAAM,aAAa;IACxB;;;;OAIG;0BAEO,cAAc,QAChB;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,WACtE,cAAc;IAezB;;;;OAIG;0BAEO,cAAc,QAChB;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,WACtE,cAAc;IAezB;;;;OAIG;qBAEO,cAAc,QAChB;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,WAC7C,cAAc;IAqBzB;;;;OAIG;mBAEO,cAAc,SACf,OAAO,WACL,cAAc;IAQzB;;;OAGG;qBACc,cAAc;CAWhC,CAAC"}

package/dist/resolvers/node.js

@@ -0,0 +1,69 @@
+/**
+ * Node Type Resolvers
+ *
+ * Resolves relationship fields on Node type.
+ */
+import { paginateArray } from '../pagination.js';
+export const nodeResolvers = {
+    /**
+     * Resolve outgoing edges with cursor-based pagination.
+     *
+     * Complexity: O(k) where k = number of outgoing edges from this node
+     */
+    async outgoingEdges(parent, args, context) {
+        const edges = await context.backend.getOutgoingEdges(parent.id, args.types || null);
+        return paginateArray(edges, args.first, args.after, (e) => `${e.src}:${e.dst}:${e.type}`);
+    },
+    /**
+     * Resolve incoming edges with cursor-based pagination.
+     *
+     * Complexity: O(k) where k = number of incoming edges to this node
+     */
+    async incomingEdges(parent, args, context) {
+        const edges = await context.backend.getIncomingEdges(parent.id, args.types || null);
+        return paginateArray(edges, args.first, args.after, (e) => `${e.src}:${e.dst}:${e.type}`);
+    },
+    /**
+     * Resolve child nodes (via CONTAINS edges) with cursor-based pagination.
+     *
+     * Complexity: O(c) where c = number of children
+     */
+    async children(parent, args, context) {
+        const edges = await context.backend.getOutgoingEdges(parent.id, ['CONTAINS']);
+        // Use DataLoader to batch child node lookups
+        const childIds = edges.map((e) => e.dst);
+        const children = await context.loaders.node.loadMany(childIds);
+        // Filter out errors and nulls
+        const validChildren = children.filter((c) => c != null && !(c instanceof Error));
+        return paginateArray(validChildren, args.first, args.after, (n) => n.id);
+    },
+    /**
+     * Resolve parent node (via incoming CONTAINS edge).
+     *
+     * Complexity: O(1) - single lookup
+     */
+    async parent(parent, _args, context) {
+        const edges = await context.backend.getIncomingEdges(parent.id, ['CONTAINS']);
+        if (edges.length === 0)
+            return null;
+        return context.loaders.node.load(edges[0].src);
+    },
+    /**
+     * Resolve metadata field.
+     * Parses JSON string if needed.
+     */
+    metadata(parent) {
+        if (!parent.metadata)
+            return null;
+        if (typeof parent.metadata === 'string') {
+            try {
+                return JSON.parse(parent.metadata);
+            }
+            catch {
+                return null;
+            }
+        }
+        return parent.metadata;
+    },
+};
+//# sourceMappingURL=node.js.map

package/dist/resolvers/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/resolvers/node.ts"],"names":[],"mappings":"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"}