@braidhq/server 0.1.0 → 0.2.1

package/dist/infrastructure/history/GitWorkspaceHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitWorkspaceHistory.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/history/GitWorkspaceHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,QAAQ,EACR,aAAa,EACb,OAAO,EAER,MAAM,iBAAiB,CAAA;AAIxB,OAAO,EAAE,SAAS,EAA0B,MAAM,iBAAiB,CAAA;AAsDnE,qBAAa,mBAAoB,YAAW,gBAAgB;IACpD,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAYxE,WAAW,CACf,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;IAiB3B,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAe3E,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB/E,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAWjF,OAAO,CACX,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,SAAS,CAAC;IAoBf,GAAG,CACP,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IAwBb,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IAY3D,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAKpD,iBAAiB;YAUjB,cAAc;CAiB7B"}

package/dist/infrastructure/{git → history}/GitWorkspaceHistory.js

@@ -3,7 +3,7 @@ import { writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { CommitSha, Timestamp, WorkspaceId } from '@braidhq/schema';
 import { simpleGit } from 'simple-git';
-import { GRAPH_JSON_VERSION, GraphJsonFile } from '../fs/FsGraphSerializer.js';
+import { MODEL_JSON_VERSION, ModelJsonFile } from '../model/FsModelSerializer.js';
 import { parseCommitMessage, serializeCommitMessage } from './commitMessage.js';
 // ASCII control chars never appear in commit subjects / refnames.
 const LOG_FIELD_SEPARATOR = '';
@@ -21,7 +21,8 @@ const TAG_FORMAT = [
     '%(taggeremail)',
     '%(contents:subject)',
 ].join(TAG_FIELD_SEPARATOR) + TAG_RECORD_SEPARATOR;
-// Intent docs + codebases are re-fetchable; tracking them would nest foreign `.git/` dirs and bloat history.
+// Intent docs and codebases are re-fetchable.
+// Tracking them would nest foreign `.git/` dirs and bloat history.
 const DEFAULT_GITIGNORE = `# Braid auto-generated.
 
 .braid/
@@ -39,7 +40,8 @@ const INITIAL_COMMIT = {
     subject: 'workspace registered',
     userId: BOOTSTRAP_USER_ID,
 };
-// `core.quotePath=false` keeps non-ASCII paths intact in log / name-status output.
+// `core.quotePath=false` keeps non-ASCII paths intact,
+// in log and name-status output.
 function openGit(baseDir) {
     return simpleGit({
         baseDir,
@@ -57,14 +59,16 @@ export class GitWorkspaceHistory {
         if (!existsSync(gitignorePath))
             await writeFile(gitignorePath, DEFAULT_GITIGNORE, 'utf-8');
         await git.add(['-A']);
-        // Allow empty when the workspace dir has nothing tracked yet so HEAD still exists for later commits to parent on.
+        // Allow empty when the workspace dir has nothing tracked yet,
+        // so HEAD exists for later commits to parent on.
         const allowEmpty = !(await this.hasPendingChanges(git));
         await this.commitWithMeta(git, INITIAL_COMMIT, { allowEmpty });
     }
     async commit(workspace, message) {
         const git = openGit(workspace.rootPath);
         await git.add(['-A']);
-        // Redundant commit attempts (e.g. reject after the artifact was already persisted) resolve to a no-op.
+        // Redundant commit attempts resolve to a no-op,
+        // for example a reject after the artifact was already persisted.
         if (!(await this.hasPendingChanges(git))) {
             const head = await git.revparse(['HEAD']);
             return CommitSha.parse(head.trim());
@@ -78,7 +82,7 @@ export class GitWorkspaceHistory {
         if (options?.since)
             args.splice(1, 0, `${options.since}^`);
         const raw = await git.raw(args).catch((err) => {
-            // Fresh repo with no commits → `git log` exits non-zero; treat as empty.
+            // Fresh repo with no commits, `git log` exits non-zero. Treat as empty.
             if (looksLikeNoCommits(err))
                 return '';
             throw err;
@@ -103,23 +107,24 @@ export class GitWorkspaceHistory {
     }
     async readGraphAtCommit(workspace, sha) {
         const git = openGit(workspace.rootPath);
-        // Pre-bootstrap commits don't carry `graph.json`; empty snapshot lets diffs classify everything as `added`.
-        const raw = await git.raw(['show', `${sha}:artifacts/graph.json`]).catch((err) => {
+        // Pre-bootstrap commits don't carry `model.json`.
+        // An empty snapshot lets diffs classify everything as `added`.
+        const raw = await git.raw(['show', `${sha}:artifacts/model.json`]).catch((err) => {
             if (looksLikePathNotInCommit(err) || looksLikeUnknownRevision(err))
                 return '';
             throw err;
         });
         if (!raw.trim())
             return { nodes: [], edges: [] };
-        const parsed = GraphJsonFile.parse(JSON.parse(raw));
-        if (parsed.version !== GRAPH_JSON_VERSION) {
-            throw new Error(`graph.json version mismatch at ${sha}: expected ${GRAPH_JSON_VERSION}, got ${parsed.version}`);
+        const parsed = ModelJsonFile.parse(JSON.parse(raw));
+        if (parsed.version !== MODEL_JSON_VERSION) {
+            throw new Error(`model.json version mismatch at ${sha}: expected ${MODEL_JSON_VERSION}, got ${parsed.version}`);
         }
         return { nodes: parsed.nodes, edges: parsed.edges };
     }
     async getCommitDiff(workspace, sha) {
         const git = openGit(workspace.rootPath);
-        // `--root` keeps the root commit diffable against the empty tree instead of erroring.
+        // `--root` keeps the root commit diffable against the empty tree, instead of erroring.
         const raw = await git.raw(['show', '--name-status', '--root', '--format=', sha]).catch((err) => {
             if (looksLikeUnknownRevision(err))
                 return '';
@@ -133,7 +138,8 @@ export class GitWorkspaceHistory {
         const head = CommitSha.parse(headRaw.trim());
         if (head === targetSha)
             return head;
-        // `checkout <sha> -- .` only restores files present in <sha>; we need an EXACT match so newer files must also go.
+        // `checkout <sha> -- .` only restores files present in <sha>.
+        // We need an EXACT match, so newer files must also go.
         await git.raw(['read-tree', targetSha]);
         await git.raw(['checkout-index', '--force', '--all']);
         await git.raw(['clean', '-fd']);
@@ -148,7 +154,8 @@ export class GitWorkspaceHistory {
     async tag(workspace, sha, name, note) {
         const git = openGit(workspace.rootPath);
         if (note) {
-            // Annotated tags need a committer identity; pin inline so CI runners without global git config don't fail.
+            // Annotated tags need a committer identity. Pin it inline,
+            // so CI runners without global git config don't fail.
             await git.raw([
                 '-c',
                 `user.name=${BOOTSTRAP_USER_ID}`,
@@ -192,11 +199,9 @@ export class GitWorkspaceHistory {
             || status.not_added.length > 0;
     }
     async commitWithMeta(git, message, options) {
-        // `authorName` / `authorEmail` are snapshotted at commit time so
-        // a future rename of the user record doesn't rewrite git history.
-        // When absent (bootstrap, source-sync, pre-Phase-A artifacts) we
-        // fall back to the opaque `userId` for both — same behaviour as
-        // before Theme 13 landed.
+        // `authorName` / `authorEmail` are snapshotted at commit time,
+        // so a later rename of the user record can't rewrite git history.
+        // When absent, we fall back to the opaque `userId` for both.
         const name = message.authorName ?? message.userId;
         const email = message.authorEmail ?? `${message.userId}@braid.local`;
         const args = ['commit', '-m', serializeCommitMessage(message), `--author=${name} <${email}>`];
@@ -222,7 +227,8 @@ function parseLogRecord(record, workspaceId) {
         parents: parents.trim()
             ? parents.trim().split(' ').map(s => CommitSha.parse(s.trim()))
             : [],
-        // Stats are derived lazily via `getCommitDiff` to avoid N extra diff calls per list page.
+        // Stats are derived lazily via `getCommitDiff`,
+        // to avoid N extra diff calls per list page.
         stats: null,
     };
 }
@@ -273,7 +279,7 @@ function parseNameStatus(raw) {
 function splitLogRecords(raw) {
     return raw.split(LOG_RECORD_SEPARATOR).map(s => s.trim()).filter(s => s.length > 0);
 }
-// Unknown letters fall back to `modified` so the row still surfaces.
+// Unknown letters fall back to `updated` so the row still surfaces.
 function statusFromCode(code) {
     switch (code) {
         case 'A':
@@ -282,9 +288,9 @@ function statusFromCode(code) {
         case 'D':
             return 'removed';
         case 'M':
-            return 'modified';
+            return 'updated';
         default:
-            return 'modified';
+            return 'updated';
     }
 }
 function looksLikeNoCommits(err) {
@@ -295,7 +301,8 @@ function looksLikeUnknownRevision(err) {
     const msg = err instanceof Error ? err.message : String(err);
     return /unknown revision|bad revision|ambiguous argument/i.test(msg);
 }
-// `git show <sha>:<path>` for an untracked path reports "exists on disk, but not in" or "does not exist in".
+// `git show <sha>:<path>` for an untracked path reports a specific message,
+// either "exists on disk, but not in" or "does not exist in".
 function looksLikePathNotInCommit(err) {
     const msg = err instanceof Error ? err.message : String(err);
     return /exists on disk, but not in|does not exist in|path .* does not exist/i.test(msg);

package/dist/infrastructure/history/GitWorkspaceHistory.js.map

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

package/dist/infrastructure/history/commitMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitMessage.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/history/commitMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAcpD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAwBrE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAgC7D"}

package/dist/infrastructure/history/commitMessage.js

@@ -0,0 +1,90 @@
+import { ClarificationId, CommitKind, CommitSha, ProposalId, SourceId, UserId, } from '@braidhq/schema';
+// Trailer keys recognised by `git interpret-trailers`,
+// so future tooling can lean on the same parser.
+const TRAILER_KEY_PATTERN = /^[a-z][a-z-]*$/i;
+export function serializeCommitMessage(message) {
+    const trailers = [
+        `Kind: ${message.kind}`,
+        `Author: ${message.userId}`,
+    ];
+    if (message.proposalId)
+        trailers.push(`Proposal-Id: ${message.proposalId}`);
+    if (message.clarificationId)
+        trailers.push(`Clarification-Id: ${message.clarificationId}`);
+    if (message.sourceId)
+        trailers.push(`Source-Id: ${message.sourceId}`);
+    if (message.revertedFrom)
+        trailers.push(`Reverted-From: ${message.revertedFrom}`);
+    if (message.revertedTo)
+        trailers.push(`Reverted-To: ${message.revertedTo}`);
+    // Subjects can span lines, reject/skip reasons and answer notes are free text.
+    // First line stays the git subject, the rest becomes the commit body,
+    // so `parseCommitMessage` can rebuild the whole subject with nothing dropped.
+    const [firstLine = '', ...bodyLines] = message.subject.split('\n');
+    const body = bodyLines.join('\n').trim();
+    const header = body
+        ? `${message.kind}: ${firstLine}\n\n${body}`
+        : `${message.kind}: ${firstLine}`;
+    return `${header}\n\n${trailers.join('\n')}\n`;
+}
+export function parseCommitMessage(raw) {
+    const lines = raw.split('\n');
+    const subjectLine = lines[0] ?? '';
+    const colonIdx = subjectLine.indexOf(':');
+    const firstLine = colonIdx >= 0 ? subjectLine.slice(colonIdx + 1).trim() : subjectLine.trim();
+    // Split off the free-text body the serializer stored below the subject,
+    // so a multi-line reason or note survives the round-trip intact.
+    const { body, trailers } = splitBodyAndTrailers(lines);
+    const subject = body ? `${firstLine}\n${body}` : firstLine;
+    const kindRaw = trailers.Kind ?? subjectLine.slice(0, colonIdx).trim();
+    // Fall back to `snapshot` on unknown kinds,
+    // so a manual `git commit` from the CLI still renders in the timeline.
+    const kind = CommitKind.safeParse(kindRaw).data ?? 'snapshot';
+    const userId = UserId.parse(trailers.Author ?? 'unknown');
+    const out = {
+        kind,
+        subject: subject || `(unsubject ${kind})`,
+        userId,
+    };
+    if (trailers['Proposal-Id'])
+        Object.assign(out, { proposalId: ProposalId.parse(trailers['Proposal-Id']) });
+    if (trailers['Clarification-Id'])
+        Object.assign(out, { clarificationId: ClarificationId.parse(trailers['Clarification-Id']) });
+    if (trailers['Source-Id'])
+        Object.assign(out, { sourceId: SourceId.parse(trailers['Source-Id']) });
+    if (trailers['Reverted-From'])
+        Object.assign(out, { revertedFrom: CommitSha.parse(trailers['Reverted-From']) });
+    if (trailers['Reverted-To'])
+        Object.assign(out, { revertedTo: CommitSha.parse(trailers['Reverted-To']) });
+    return out;
+}
+// indexOf-based scan instead of a single regex,
+// to avoid polynomial backtracking against adversarial commit bodies.
+function splitBodyAndTrailers(lines) {
+    const trailers = {};
+    let bodyEnd = 1;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (line.trim().length === 0) {
+            // Blank line fencing the trailer block, the body ends here.
+            if (Object.keys(trailers).length > 0) {
+                bodyEnd = i;
+                break;
+            }
+            continue;
+        }
+        const colon = line.indexOf(':');
+        if (colon < 1) {
+            bodyEnd = i + 1;
+            break;
+        }
+        const key = line.slice(0, colon);
+        if (!TRAILER_KEY_PATTERN.test(key)) {
+            bodyEnd = i + 1;
+            break;
+        }
+        trailers[key] = line.slice(colon + 1).trim();
+    }
+    return { body: lines.slice(1, bodyEnd).join('\n').trim(), trailers };
+}
+//# sourceMappingURL=commitMessage.js.map

package/dist/infrastructure/history/commitMessage.js.map

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

package/dist/infrastructure/hitl/FsClarificationRepository.d.ts

@@ -0,0 +1,13 @@
+import type { AbsolutePath, ClarificationFilter, ClarificationId, WorkspaceId } from '@braidhq/schema';
+import { Clarification, type ClarificationRepository } from '@braidhq/core';
+export interface FsClarificationRepositoryOptions {
+    readonly workspaceRoots: () => Promise<ReadonlyMap<WorkspaceId, AbsolutePath>>;
+}
+export declare class FsClarificationRepository implements ClarificationRepository {
+    private readonly base;
+    constructor(options: FsClarificationRepositoryOptions);
+    list(filter?: ClarificationFilter): Promise<Clarification[]>;
+    load(clarificationId: ClarificationId): Promise<Clarification>;
+    save(clarification: Clarification): Promise<void>;
+}
+//# sourceMappingURL=FsClarificationRepository.d.ts.map

package/dist/infrastructure/hitl/FsClarificationRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsClarificationRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/hitl/FsClarificationRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAAY,MAAM,eAAe,CAAA;AAKrF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;CAC/E;AAED,qBAAa,yBAA0B,YAAW,uBAAuB;IACvE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoF;gBAE7F,OAAO,EAAE,gCAAgC;IAgB/C,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiBlE,IAAI,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9D,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD"}

package/dist/infrastructure/hitl/FsClarificationRepository.js

@@ -0,0 +1,40 @@
+import { Clarification, paginate } from '@braidhq/core';
+import { Clarification as ClarificationSchema } from '@braidhq/schema';
+import { clarificationDir, CLARIFY_STATUSES } from '../_shared/paths.js';
+import { StatusedJsonStore } from './StatusedJsonStore.js';
+export class FsClarificationRepository {
+    base;
+    constructor(options) {
+        this.base = new StatusedJsonStore({
+            entityName: 'Clarification',
+            statuses: CLARIFY_STATUSES,
+            dirFor: clarificationDir,
+            parse: raw => new Clarification(ClarificationSchema.parse(raw)),
+            serialize: entity => entity.toData(),
+            idOf: entity => entity.id,
+            statusOf: entity => entity.status,
+            workspaceIdOf: entity => entity.workspaceId,
+        }, options.workspaceRoots);
+    }
+    async list(filter) {
+        let clarifications = await this.base.list({
+            ...(filter?.workspaceId !== undefined ? { workspaceId: filter.workspaceId } : {}),
+            ...(filter?.statuses !== undefined ? { statuses: filter.statuses } : {}),
+        });
+        // Pending clarifications are personal, only the owner sees them.
+        // Answered, applied, and skipped clarifications stay workspace-shared.
+        if (filter?.viewerId !== undefined) {
+            const viewerId = filter.viewerId;
+            const includeServiceOwned = filter.includeServiceOwned ?? false;
+            clarifications = clarifications.filter(clarification => clarification.status !== 'pending' || clarification.owner === viewerId || (includeServiceOwned && clarification.ownerKind === 'service'));
+        }
+        return paginate(clarifications, filter?.limit, filter?.offset);
+    }
+    load(clarificationId) {
+        return this.base.load(clarificationId);
+    }
+    save(clarification) {
+        return this.base.save(clarification);
+    }
+}
+//# sourceMappingURL=FsClarificationRepository.js.map

package/dist/infrastructure/hitl/FsClarificationRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsClarificationRepository.js","sourceRoot":"","sources":["../../../src/infrastructure/hitl/FsClarificationRepository.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAgC,QAAQ,EAAE,MAAM,eAAe,CAAA;AACrF,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAM1D,MAAM,OAAO,yBAAyB;IACnB,IAAI,CAAoF;IAEzG,YAAY,OAAyC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAC/B;YACE,UAAU,EAAE,eAAe;YAC3B,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/D,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE;YACpC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACzB,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM;YACjC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW;SAC5C,EACD,OAAO,CAAC,cAAc,CACvB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA4B;QACrC,IAAI,cAAc,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACxC,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC,CAAA;QACF,iEAAiE;QACjE,uEAAuE;QACvE,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;YAChC,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,IAAI,KAAK,CAAA;YAC/D,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CACrD,aAAa,CAAC,MAAM,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,mBAAmB,IAAI,aAAa,CAAC,SAAS,KAAK,SAAS,CAAC,CACzI,CAAA;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChE,CAAC;IAED,IAAI,CAAC,eAAgC;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,CAAC,aAA4B;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACtC,CAAC;CACF"}

package/dist/infrastructure/hitl/FsProposalRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsProposalRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/hitl/FsProposalRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC5F,OAAO,EAAY,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAK3E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;CAC/E;AAED,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2E;gBAEpF,OAAO,EAAE,2BAA2B;IAgB1C,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAsBxD,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/C,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/infrastructure/{fs → hitl}/FsProposalRepository.js

@@ -1,11 +1,11 @@
 import { paginate, Proposal } from '@braidhq/core';
 import { Proposal as ProposalSchema } from '@braidhq/schema';
-import { FsStatusedJsonRepository } from './FsStatusedJsonRepository.js';
-import { PROPOSAL_STATUSES, proposalsDir } from './paths.js';
+import { PROPOSAL_STATUSES, proposalsDir } from '../_shared/paths.js';
+import { StatusedJsonStore } from './StatusedJsonStore.js';
 export class FsProposalRepository {
     base;
     constructor(options) {
-        this.base = new FsStatusedJsonRepository({
+        this.base = new StatusedJsonStore({
             entityName: 'Proposal',
             statuses: PROPOSAL_STATUSES,
             dirFor: proposalsDir,
@@ -25,13 +25,13 @@ export class FsProposalRepository {
             const skills = filter.generatedBy;
             proposals = proposals.filter(proposal => skills.includes(proposal.generatedBy));
         }
-        // Phase E personal/shared filter: pending proposals only the
-        // owner sees; applied / rejected stay workspace-shared audit
-        // history. Absent viewerId means "no filter" (Owner Show All,
-        // legacy callers, bootstrap).
+        // Pending proposals are personal, only the owner sees them.
+        // Applied and rejected stay as workspace-shared audit history.
+        // Absent viewerId means no filter, for Owner Show All and legacy callers.
         if (filter?.viewerId !== undefined) {
             const viewerId = filter.viewerId;
-            proposals = proposals.filter(proposal => proposal.status !== 'pending' || proposal.ownerId === undefined || proposal.ownerId === viewerId);
+            const includeServiceOwned = filter.includeServiceOwned ?? false;
+            proposals = proposals.filter(proposal => proposal.status !== 'pending' || proposal.owner === viewerId || (includeServiceOwned && proposal.ownerKind === 'service'));
         }
         return paginate(proposals, filter?.limit, filter?.offset);
     }

package/dist/infrastructure/hitl/FsProposalRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsProposalRepository.js","sourceRoot":"","sources":["../../../src/infrastructure/hitl/FsProposalRepository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAA2B,MAAM,eAAe,CAAA;AAC3E,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAM1D,MAAM,OAAO,oBAAoB;IACd,IAAI,CAA2E;IAEhG,YAAY,OAAoC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAC/B;YACE,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,iBAAiB;YAC3B,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrD,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE;YACpC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACzB,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM;YACjC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW;SAC5C,EACD,OAAO,CAAC,cAAc,CACvB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAuB;QAChC,IAAI,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACnC,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC,CAAA;QACF,IAAI,MAAM,EAAE,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAA;YACjC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;QACjF,CAAC;QACD,4DAA4D;QAC5D,+DAA+D;QAC/D,0EAA0E;QAC1E,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;YAChC,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,IAAI,KAAK,CAAA;YAC/D,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CACtC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,mBAAmB,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAC1H,CAAA;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3D,CAAC;IAED,IAAI,CAAC,UAAsB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,CAAC,QAAkB;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC;IAED,MAAM,CAAC,UAAsB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACrC,CAAC;CACF"}

package/dist/infrastructure/hitl/StatusedJsonStore.d.ts

@@ -0,0 +1,30 @@
+import type { AbsolutePath, WorkspaceId } from '@braidhq/schema';
+export interface StatusedJsonStoreConfig<TEntity, TStatus extends string, TId extends string> {
+    readonly entityName: string;
+    readonly statuses: readonly TStatus[];
+    readonly idOf: (entity: TEntity) => TId;
+    readonly statusOf: (entity: TEntity) => TStatus;
+    readonly workspaceIdOf: (entity: TEntity) => WorkspaceId;
+    readonly dirFor: (workspaceRoot: AbsolutePath, status: TStatus) => string;
+    readonly parse: (raw: unknown) => TEntity;
+    readonly serialize: (entity: TEntity) => unknown;
+}
+export interface StatusedJsonListFilter<TStatus extends string> {
+    readonly workspaceId?: WorkspaceId;
+    readonly statuses?: readonly TStatus[];
+}
+export declare class StatusedJsonStore<TEntity, TStatus extends string, TId extends string> {
+    private readonly config;
+    private readonly workspaceRoots;
+    constructor(config: StatusedJsonStoreConfig<TEntity, TStatus, TId>, workspaceRoots: () => Promise<ReadonlyMap<WorkspaceId, AbsolutePath>>);
+    list(filter?: StatusedJsonListFilter<TStatus>): Promise<TEntity[]>;
+    load(id: TId): Promise<TEntity>;
+    save(entity: TEntity): Promise<void>;
+    remove(id: TId): Promise<void>;
+    locate(id: TId): Promise<{
+        readonly path: string;
+        readonly status: TStatus;
+    } | undefined>;
+    private candidateRoots;
+}
+//# sourceMappingURL=StatusedJsonStore.d.ts.map

package/dist/infrastructure/hitl/StatusedJsonStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusedJsonStore.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/hitl/StatusedJsonStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAMhE,MAAM,WAAW,uBAAuB,CAAC,OAAO,EAAE,OAAO,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM;IAI1F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAGrC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;IAC/C,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,WAAW,CAAA;IAExD,QAAQ,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;IAIzE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CACjD;AAED,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,MAAM;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CACvC;AAED,qBAAa,iBAAiB,CAAC,OAAO,EAAE,OAAO,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM;IAE9E,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,MAAM,EAAE,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EACtD,cAAc,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAGlF,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiBlE,IAAI,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ/B,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAepC,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9B,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;YAkBjF,cAAc;CAS7B"}

package/dist/infrastructure/{fs/FsStatusedJsonRepository.js → hitl/StatusedJsonStore.js}

@@ -1,8 +1,8 @@
 import { rm } from 'node:fs/promises';
 import { join } from 'node:path';
 import { NotFoundError } from '@braidhq/core';
-import { listJsonFiles, moveFile, readJsonFile, writeJsonFile } from './jsonFileStore.js';
-export class FsStatusedJsonRepository {
+import { listJsonFiles, moveFile, readJsonFile, writeJsonFile } from '../_shared/jsonFileStore.js';
+export class StatusedJsonStore {
     config;
     workspaceRoots;
     constructor(config, workspaceRoots) {
@@ -76,4 +76,4 @@ export class FsStatusedJsonRepository {
         return root ? new Map([[workspaceId, root]]) : new Map();
     }
 }
-//# sourceMappingURL=FsStatusedJsonRepository.js.map
+//# sourceMappingURL=StatusedJsonStore.js.map

package/dist/infrastructure/hitl/StatusedJsonStore.js.map

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

package/dist/infrastructure/model/FsModelSerializer.d.ts

@@ -0,0 +1,94 @@
+import type { ModelSerializer, Workspace } from '@braidhq/core';
+import type { ModelSnapshot } from '@braidhq/schema';
+import { z } from 'zod';
+export declare const MODEL_JSON_VERSION = 1;
+export declare const ModelJsonFile: z.ZodObject<{
+    version: z.ZodNumber;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        type: z.core.$ZodBranded<z.ZodString, "NodeTypeId", "out">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            deprecated: "deprecated";
+            draft: "draft";
+            unclear: "unclear";
+        }>;
+        metadata: z.ZodObject<{
+            missingRoles: z.ZodOptional<z.ZodArray<z.core.$ZodBranded<z.ZodString, "SourceRole", "out">>>;
+            sourceReferences: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                sourceId: z.core.$ZodBranded<z.ZodString, "SourceId", "out">;
+                location: z.ZodObject<{
+                    uri: z.ZodString;
+                    startLine: z.ZodOptional<z.ZodNumber>;
+                    endLine: z.ZodOptional<z.ZodNumber>;
+                    anchor: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                snippet: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            lastTouchedBy: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "SkillId", "out">>;
+            externalReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.core.$ZodBranded<z.ZodString, "ExternalReferenceKind", "out">;
+                url: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            driftIssues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.core.$ZodBranded<z.ZodString, "DriftIssueId", "out">;
+                description: z.ZodString;
+                severity: z.ZodEnum<{
+                    error: "error";
+                    warning: "warning";
+                    info: "info";
+                }>;
+                sourceReferences: z.ZodArray<z.ZodObject<{
+                    sourceId: z.core.$ZodBranded<z.ZodString, "SourceId", "out">;
+                    location: z.ZodObject<{
+                        uri: z.ZodString;
+                        startLine: z.ZodOptional<z.ZodNumber>;
+                        endLine: z.ZodOptional<z.ZodNumber>;
+                        anchor: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>;
+                    snippet: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                raisedAt: z.ZodString;
+            }, z.core.$strip>>>;
+            acknowledgedDrifts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        embedding: z.ZodOptional<z.ZodObject<{
+            vector: z.ZodArray<z.ZodNumber>;
+            modelId: z.ZodString;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "EdgeId", "out">;
+        type: z.core.$ZodBranded<z.ZodString, "EdgeTypeId", "out">;
+        fromNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        toNodeId: z.core.$ZodBranded<z.ZodString, "NodeId", "out">;
+        metadata: z.ZodObject<{
+            sourceReferences: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                sourceId: z.core.$ZodBranded<z.ZodString, "SourceId", "out">;
+                location: z.ZodObject<{
+                    uri: z.ZodString;
+                    startLine: z.ZodOptional<z.ZodNumber>;
+                    endLine: z.ZodOptional<z.ZodNumber>;
+                    anchor: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>;
+                snippet: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            lastTouchedBy: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "SkillId", "out">>;
+            externalReferences: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.core.$ZodBranded<z.ZodString, "ExternalReferenceKind", "out">;
+                url: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare class FsModelSerializer implements ModelSerializer {
+    write(workspace: Workspace, snapshot: ModelSnapshot): Promise<void>;
+    read(workspace: Workspace): Promise<ModelSnapshot | null>;
+    exists(workspace: Workspace): Promise<boolean>;
+}
+//# sourceMappingURL=FsModelSerializer.d.ts.map

package/dist/infrastructure/model/FsModelSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsModelSerializer.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/model/FsModelSerializer.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIxB,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 → model/FsModelSerializer.js}

@@ -2,24 +2,24 @@ 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({
+import { graphJsonPath, workspaceArtifactsDir } from '../_shared/paths.js';
+export const MODEL_JSON_VERSION = 1;
+export const ModelJsonFile = z.object({
     version: z.number().int(),
     nodes: z.array(GraphNode),
     edges: z.array(GraphEdge),
 });
-export class FsGraphSerializer {
+export class FsModelSerializer {
     async write(workspace, snapshot) {
         const path = graphJsonPath(workspace.rootPath);
         await mkdir(workspaceArtifactsDir(workspace.rootPath), { recursive: true });
         const payload = {
-            version: GRAPH_JSON_VERSION,
+            version: MODEL_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.
+        // Atomic write. A crashed server must not leave a half-file behind,
+        // one that would mis-hydrate Kùzu on the next restart.
         const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
         await writeFile(tmp, `${JSON.stringify(payload, null, 2)}\n`, 'utf-8');
         await rename(tmp, path);
@@ -34,9 +34,9 @@ export class FsGraphSerializer {
                 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}`);
+        const parsed = ModelJsonFile.parse(JSON.parse(raw));
+        if (parsed.version !== MODEL_JSON_VERSION) {
+            throw new Error(`model.json version mismatch in ${workspace.rootPath}: expected ${MODEL_JSON_VERSION}, got ${parsed.version}`);
         }
         return { nodes: parsed.nodes, edges: parsed.edges };
     }
@@ -57,4 +57,4 @@ function byId(a, b) {
         return 1;
     return 0;
 }
-//# sourceMappingURL=FsGraphSerializer.js.map
+//# sourceMappingURL=FsModelSerializer.js.map