@braidhq/server 0.0.1 → 0.1.0

package/dist/infrastructure/fs/FsGraphSerializer.d.ts

@@ -0,0 +1,629 @@
+import type { GraphSerializer, Workspace } from '@braidhq/core';
+import type { ModelSnapshot } from '@braidhq/schema';
+import { z } from 'zod';
+export declare const GRAPH_JSON_VERSION = 1;
+export declare const GraphJsonFile: z.ZodObject<{
+    version: z.ZodNumber;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodBranded<z.ZodString, "NodeId">;
+        type: z.ZodBranded<z.ZodString, "NodeTypeId">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["draft", "completed", "unclear", "deprecated"]>;
+        metadata: z.ZodObject<{
+            intentMissing: z.ZodOptional<z.ZodBoolean>;
+            intentConflict: z.ZodOptional<z.ZodBoolean>;
+            implementationMissing: z.ZodOptional<z.ZodBoolean>;
+            sourceReferences: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                sourceId: z.ZodBranded<z.ZodString, "SourceId">;
+                location: z.ZodObject<{
+                    uri: z.ZodString;
+                    startLine: z.ZodOptional<z.ZodNumber>;
+                    endLine: z.ZodOptional<z.ZodNumber>;
+                    anchor: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                }, {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                }>;
+                snippet: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }, {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }>, "many">>;
+            lastTouchedBy: z.ZodOptional<z.ZodBranded<z.ZodString, "SkillId">>;
+            externalReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.ZodBranded<z.ZodString, "ExternalReferenceKind">;
+                url: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }, {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }>, "many">>;
+            driftIssues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodBranded<z.ZodString, "DriftIssueId">;
+                description: z.ZodString;
+                severity: z.ZodEnum<["error", "warning", "info"]>;
+                sourceReferences: z.ZodArray<z.ZodObject<{
+                    sourceId: z.ZodBranded<z.ZodString, "SourceId">;
+                    location: z.ZodObject<{
+                        uri: z.ZodString;
+                        startLine: z.ZodOptional<z.ZodNumber>;
+                        endLine: z.ZodOptional<z.ZodNumber>;
+                        anchor: z.ZodOptional<z.ZodString>;
+                    }, "strip", z.ZodTypeAny, {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    }, {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    }>;
+                    snippet: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    sourceId: string & z.BRAND<"SourceId">;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }, {
+                    sourceId: string;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }>, "many">;
+                raisedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                id: string & z.BRAND<"DriftIssueId">;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string & z.BRAND<"SourceId">;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }, {
+                description: string;
+                id: string;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }>, "many">>;
+            acknowledgedDrifts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sourceReferences: {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[];
+            intentMissing?: boolean | undefined;
+            intentConflict?: boolean | undefined;
+            implementationMissing?: boolean | undefined;
+            lastTouchedBy?: (string & z.BRAND<"SkillId">) | undefined;
+            externalReferences?: {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+            driftIssues?: {
+                description: string;
+                id: string & z.BRAND<"DriftIssueId">;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string & z.BRAND<"SourceId">;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }[] | undefined;
+            acknowledgedDrifts?: string[] | undefined;
+        }, {
+            sourceReferences?: {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[] | undefined;
+            intentMissing?: boolean | undefined;
+            intentConflict?: boolean | undefined;
+            implementationMissing?: boolean | undefined;
+            lastTouchedBy?: string | undefined;
+            externalReferences?: {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+            driftIssues?: {
+                description: string;
+                id: string;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }[] | undefined;
+            acknowledgedDrifts?: string[] | undefined;
+        }>;
+        embedding: z.ZodOptional<z.ZodObject<{
+            vector: z.ZodArray<z.ZodNumber, "many">;
+            modelId: z.ZodString;
+            createdAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            createdAt: string;
+            vector: number[];
+            modelId: string;
+        }, {
+            createdAt: string;
+            vector: number[];
+            modelId: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string & z.BRAND<"NodeTypeId">;
+        status: "deprecated" | "completed" | "draft" | "unclear";
+        id: string & z.BRAND<"NodeId">;
+        name: string;
+        metadata: {
+            sourceReferences: {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[];
+            intentMissing?: boolean | undefined;
+            intentConflict?: boolean | undefined;
+            implementationMissing?: boolean | undefined;
+            lastTouchedBy?: (string & z.BRAND<"SkillId">) | undefined;
+            externalReferences?: {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+            driftIssues?: {
+                description: string;
+                id: string & z.BRAND<"DriftIssueId">;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string & z.BRAND<"SourceId">;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }[] | undefined;
+            acknowledgedDrifts?: string[] | undefined;
+        };
+        description?: string | undefined;
+        embedding?: {
+            createdAt: string;
+            vector: number[];
+            modelId: string;
+        } | undefined;
+    }, {
+        type: string;
+        status: "deprecated" | "completed" | "draft" | "unclear";
+        id: string;
+        name: string;
+        metadata: {
+            sourceReferences?: {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[] | undefined;
+            intentMissing?: boolean | undefined;
+            intentConflict?: boolean | undefined;
+            implementationMissing?: boolean | undefined;
+            lastTouchedBy?: string | undefined;
+            externalReferences?: {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+            driftIssues?: {
+                description: string;
+                id: string;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }[] | undefined;
+            acknowledgedDrifts?: string[] | undefined;
+        };
+        description?: string | undefined;
+        embedding?: {
+            createdAt: string;
+            vector: number[];
+            modelId: string;
+        } | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.ZodBranded<z.ZodString, "EdgeId">;
+        type: z.ZodBranded<z.ZodString, "EdgeTypeId">;
+        fromNodeId: z.ZodBranded<z.ZodString, "NodeId">;
+        toNodeId: z.ZodBranded<z.ZodString, "NodeId">;
+        metadata: z.ZodObject<{
+            sourceReferences: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                sourceId: z.ZodBranded<z.ZodString, "SourceId">;
+                location: z.ZodObject<{
+                    uri: z.ZodString;
+                    startLine: z.ZodOptional<z.ZodNumber>;
+                    endLine: z.ZodOptional<z.ZodNumber>;
+                    anchor: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                }, {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                }>;
+                snippet: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }, {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }>, "many">>;
+            lastTouchedBy: z.ZodOptional<z.ZodBranded<z.ZodString, "SkillId">>;
+            externalReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.ZodBranded<z.ZodString, "ExternalReferenceKind">;
+                url: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }, {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            sourceReferences: {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[];
+            lastTouchedBy?: (string & z.BRAND<"SkillId">) | undefined;
+            externalReferences?: {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+        }, {
+            sourceReferences?: {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[] | undefined;
+            lastTouchedBy?: string | undefined;
+            externalReferences?: {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: string & z.BRAND<"EdgeTypeId">;
+        id: string & z.BRAND<"EdgeId">;
+        metadata: {
+            sourceReferences: {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[];
+            lastTouchedBy?: (string & z.BRAND<"SkillId">) | undefined;
+            externalReferences?: {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+        };
+        fromNodeId: string & z.BRAND<"NodeId">;
+        toNodeId: string & z.BRAND<"NodeId">;
+    }, {
+        type: string;
+        id: string;
+        metadata: {
+            sourceReferences?: {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[] | undefined;
+            lastTouchedBy?: string | undefined;
+            externalReferences?: {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+        };
+        fromNodeId: string;
+        toNodeId: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        type: string & z.BRAND<"NodeTypeId">;
+        status: "deprecated" | "completed" | "draft" | "unclear";
+        id: string & z.BRAND<"NodeId">;
+        name: string;
+        metadata: {
+            sourceReferences: {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[];
+            intentMissing?: boolean | undefined;
+            intentConflict?: boolean | undefined;
+            implementationMissing?: boolean | undefined;
+            lastTouchedBy?: (string & z.BRAND<"SkillId">) | undefined;
+            externalReferences?: {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+            driftIssues?: {
+                description: string;
+                id: string & z.BRAND<"DriftIssueId">;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string & z.BRAND<"SourceId">;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }[] | undefined;
+            acknowledgedDrifts?: string[] | undefined;
+        };
+        description?: string | undefined;
+        embedding?: {
+            createdAt: string;
+            vector: number[];
+            modelId: string;
+        } | undefined;
+    }[];
+    edges: {
+        type: string & z.BRAND<"EdgeTypeId">;
+        id: string & z.BRAND<"EdgeId">;
+        metadata: {
+            sourceReferences: {
+                sourceId: string & z.BRAND<"SourceId">;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[];
+            lastTouchedBy?: (string & z.BRAND<"SkillId">) | undefined;
+            externalReferences?: {
+                kind: string & z.BRAND<"ExternalReferenceKind">;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+        };
+        fromNodeId: string & z.BRAND<"NodeId">;
+        toNodeId: string & z.BRAND<"NodeId">;
+    }[];
+    version: number;
+}, {
+    nodes: {
+        type: string;
+        status: "deprecated" | "completed" | "draft" | "unclear";
+        id: string;
+        name: string;
+        metadata: {
+            sourceReferences?: {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[] | undefined;
+            intentMissing?: boolean | undefined;
+            intentConflict?: boolean | undefined;
+            implementationMissing?: boolean | undefined;
+            lastTouchedBy?: string | undefined;
+            externalReferences?: {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+            driftIssues?: {
+                description: string;
+                id: string;
+                severity: "error" | "warning" | "info";
+                sourceReferences: {
+                    sourceId: string;
+                    location: {
+                        uri: string;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                        anchor?: string | undefined;
+                    };
+                    snippet?: string | undefined;
+                }[];
+                raisedAt: string;
+            }[] | undefined;
+            acknowledgedDrifts?: string[] | undefined;
+        };
+        description?: string | undefined;
+        embedding?: {
+            createdAt: string;
+            vector: number[];
+            modelId: string;
+        } | undefined;
+    }[];
+    edges: {
+        type: string;
+        id: string;
+        metadata: {
+            sourceReferences?: {
+                sourceId: string;
+                location: {
+                    uri: string;
+                    startLine?: number | undefined;
+                    endLine?: number | undefined;
+                    anchor?: string | undefined;
+                };
+                snippet?: string | undefined;
+            }[] | undefined;
+            lastTouchedBy?: string | undefined;
+            externalReferences?: {
+                kind: string;
+                url: string;
+                label?: string | undefined;
+            }[] | undefined;
+        };
+        fromNodeId: string;
+        toNodeId: string;
+    }[];
+    version: number;
+}>;
+export declare class FsGraphSerializer implements GraphSerializer {
+    write(workspace: Workspace, snapshot: ModelSnapshot): Promise<void>;
+    read(workspace: Workspace): Promise<ModelSnapshot | null>;
+    exists(workspace: Workspace): Promise<boolean>;
+}
+//# sourceMappingURL=FsGraphSerializer.d.ts.map

package/dist/infrastructure/fs/FsGraphSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsGraphSerializer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/fs/FsGraphSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAIpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIxB,CAAA;AAEF,qBAAa,iBAAkB,YAAW,eAAe;IACjD,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAenE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAmBzD,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CASrD"}

package/dist/infrastructure/fs/FsGraphSerializer.js

@@ -0,0 +1,60 @@
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import process from 'node:process';
+import { GraphEdge, GraphNode } from '@braidhq/schema';
+import { z } from 'zod';
+import { graphJsonPath, workspaceArtifactsDir } from './paths.js';
+export const GRAPH_JSON_VERSION = 1;
+export const GraphJsonFile = z.object({
+    version: z.number().int(),
+    nodes: z.array(GraphNode),
+    edges: z.array(GraphEdge),
+});
+export class FsGraphSerializer {
+    async write(workspace, snapshot) {
+        const path = graphJsonPath(workspace.rootPath);
+        await mkdir(workspaceArtifactsDir(workspace.rootPath), { recursive: true });
+        const payload = {
+            version: GRAPH_JSON_VERSION,
+            nodes: [...snapshot.nodes].sort(byId),
+            edges: [...snapshot.edges].sort(byId),
+        };
+        // Atomic write so a crashed server can't leave a half-file that
+        // mis-hydrates Kùzu on restart.
+        const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+        await writeFile(tmp, `${JSON.stringify(payload, null, 2)}\n`, 'utf-8');
+        await rename(tmp, path);
+    }
+    async read(workspace) {
+        let raw;
+        try {
+            raw = await readFile(graphJsonPath(workspace.rootPath), 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+        const parsed = GraphJsonFile.parse(JSON.parse(raw));
+        if (parsed.version !== GRAPH_JSON_VERSION) {
+            throw new Error(`graph.json version mismatch in ${workspace.rootPath}: expected ${GRAPH_JSON_VERSION}, got ${parsed.version}`);
+        }
+        return { nodes: parsed.nodes, edges: parsed.edges };
+    }
+    async exists(workspace) {
+        try {
+            await readFile(graphJsonPath(workspace.rootPath), 'utf-8');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+function byId(a, b) {
+    if (a.id < b.id)
+        return -1;
+    if (a.id > b.id)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=FsGraphSerializer.js.map