studiograph 1.3.48-next.21 → 1.3.48-next.210

package/dist/services/markdown.js

@@ -4,7 +4,7 @@
  * Handles parsing and writing markdown files with YAML frontmatter,
  * extracting wikilinks, and validating relationships.
  */
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { readFileSync, mkdirSync, existsSync, openSync, writeSync, fsyncSync, closeSync, renameSync, unlinkSync, } from 'fs';
 import { dirname } from 'path';
 import matter from 'gray-matter';
 import { glob } from 'glob';
@@ -58,7 +58,10 @@ export class MarkdownService {
         const wikilinkRegex = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
         let match;
         while ((match = wikilinkRegex.exec(content)) !== null) {
-            wikilinks.push(match[1]);
+            // `[[user:<id>]]` account refs are not graph entities — skip them so they
+            // don't form edges or register as broken links.
+            if (!match[1].startsWith('user:'))
+                wikilinks.push(match[1]);
         }
         // Extract from frontmatter (check string values and arrays)
         this.extractWikilinksFromObject(frontmatter, wikilinks);
@@ -75,7 +78,7 @@ export class MarkdownService {
             obj.forEach(item => {
                 if (typeof item === 'string') {
                     const match = item.match(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/);
-                    if (match) {
+                    if (match && !match[1].startsWith('user:')) {
                         wikilinks.push(match[1]);
                     }
                 }
@@ -88,7 +91,7 @@ export class MarkdownService {
             Object.values(obj).forEach(value => {
                 if (typeof value === 'string') {
                     const match = value.match(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/);
-                    if (match) {
+                    if (match && !match[1].startsWith('user:')) {
                         wikilinks.push(match[1]);
                     }
                 }
@@ -99,21 +102,35 @@ export class MarkdownService {
         }
     }
     /**
-     * Write markdown file with frontmatter
+     * Write markdown file with frontmatter.
+     *
+     * Atomic on POSIX: write to a tmp sibling, fsync, rename. ENOSPC or EIO
+     * mid-write leaves the tmp file truncated and the target untouched — the
+     * caller observes either the new content or the old, never a partial-write
+     * with broken YAML. The Phase-2 disk-first ordering relies on this: if
+     * step 2 (writeFile) fails, the disk MUST be unchanged so the Y.Doc isn't
+     * applied to a corrupt baseline.
+     *
+     * Parent-dir fsync is best-effort — many filesystems reject fsync on a
+     * directory handle. The rename is still durable enough on every platform
+     * we ship to; the parent fsync just bounds the power-loss window.
      */
     writeFile(filePath, doc) {
         const { content } = doc;
         // Strip undefined values — js-yaml (used by gray-matter) can't serialize them
         const frontmatter = Object.fromEntries(Object.entries(doc.frontmatter).filter(([_, v]) => v !== undefined));
-        // Generate markdown with frontmatter
-        const output = matter.stringify(content, frontmatter);
+        // Generate markdown with frontmatter. Collapse trailing newlines to a
+        // single `\n` — gray-matter appends `\n` even for empty content (so
+        // body-less entries get `---\n\n` at the end), and built-in body
+        // templates often end with `\n\n`. Either way, files end up with an
+        // extra blank line below the body that surfaces in the editor.
+        const output = matter.stringify(content, frontmatter).replace(/\n+$/, '\n');
         // Ensure directory exists
         const dir = dirname(filePath);
         if (!existsSync(dir)) {
             mkdirSync(dir, { recursive: true });
         }
-        // Write file
-        writeFileSync(filePath, output, 'utf-8');
+        atomicWriteFileSync(filePath, output);
     }
     /**
      * Write markdown content from separate frontmatter and content
@@ -353,4 +370,55 @@ export class MarkdownService {
 function escapeRegex(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
+/**
+ * Atomic file write: tmp + fsync(tmp) + rename + best-effort fsync(parent dir).
+ *
+ * Synchronous so the caller (graph.update body-write step) can rely on
+ * post-call ordering without await yields. Mirrors the pattern in
+ * src/server/yjs-persistence.ts:267-289.
+ *
+ * On failure mid-write: deletes the tmp file (best-effort), rethrows the
+ * underlying error. The target path is either fully replaced or untouched.
+ */
+function atomicWriteFileSync(filePath, data) {
+    const dir = dirname(filePath);
+    const tmpPath = `${filePath}.tmp.${process.pid}.${Math.random().toString(36).slice(2, 10)}`;
+    let fd = null;
+    let renamed = false;
+    try {
+        fd = openSync(tmpPath, 'w');
+        writeSync(fd, data, 0, 'utf-8');
+        fsyncSync(fd);
+        closeSync(fd);
+        fd = null;
+        renameSync(tmpPath, filePath);
+        renamed = true;
+        // Best-effort parent-dir fsync. macOS APFS and many Linux filesystems
+        // accept this; some (FAT, network mounts) reject — non-fatal.
+        try {
+            const dirFd = openSync(dir, 'r');
+            try {
+                fsyncSync(dirFd);
+            }
+            finally {
+                closeSync(dirFd);
+            }
+        }
+        catch { /* parent fsync unsupported on this fs */ }
+    }
+    finally {
+        if (fd !== null) {
+            try {
+                closeSync(fd);
+            }
+            catch { /* already broken */ }
+        }
+        if (!renamed) {
+            try {
+                unlinkSync(tmpPath);
+            }
+            catch { /* tmp may not exist if open failed */ }
+        }
+    }
+}
 //# sourceMappingURL=markdown.js.map

package/dist/services/markdown.js.map

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

package/dist/services/mention-detector.d.ts

@@ -0,0 +1,23 @@
+import type { AuthService, AuthUser } from './auth-service.js';
+/**
+ * Matches `@handle` in body text. Handle is lowercase kebab-case, must follow
+ * a word boundary (not part of an email or other identifier). Mirrors the
+ * pattern used by the pre-Phase-0 messaging surface so handles already in
+ * use stay valid.
+ */
+export declare const USER_MENTION_RE: RegExp;
+/** Separate @agent detection so it doesn't get rolled into user notifications. */
+export declare const AGENT_MENTION_RE: RegExp;
+/** Bounded mention fan-out per comment. Above this, extra @-handles in the
+ *  body are ignored — prevents one comment from spamming every workspace
+ *  member with notifications and broadcasts. */
+export declare const MAX_MENTIONS_PER_COMMENT = 20;
+/**
+ * Extract user mentions from a body. Returns AuthUser records, excluding the
+ * sender so authors don't notify themselves. Order matches first-occurrence
+ * in the body; duplicates removed. Capped at MAX_MENTIONS_PER_COMMENT so a
+ * single comment can't fan out unbounded notifications.
+ */
+export declare function detectUserMentions(body: string, senderUserId: number, authService: AuthService): AuthUser[];
+/** True iff the body contains an `@agent` mention. */
+export declare function hasAgentMention(body: string): boolean;

package/dist/services/mention-detector.js

@@ -0,0 +1,47 @@
+/**
+ * Matches `@handle` in body text. Handle is lowercase kebab-case, must follow
+ * a word boundary (not part of an email or other identifier). Mirrors the
+ * pattern used by the pre-Phase-0 messaging surface so handles already in
+ * use stay valid.
+ */
+export const USER_MENTION_RE = /(?<![A-Za-z0-9._-])@([a-z0-9][a-z0-9-]*)/gi;
+/** Separate @agent detection so it doesn't get rolled into user notifications. */
+export const AGENT_MENTION_RE = /@agent\b/i;
+/** Bounded mention fan-out per comment. Above this, extra @-handles in the
+ *  body are ignored — prevents one comment from spamming every workspace
+ *  member with notifications and broadcasts. */
+export const MAX_MENTIONS_PER_COMMENT = 20;
+/**
+ * Extract user mentions from a body. Returns AuthUser records, excluding the
+ * sender so authors don't notify themselves. Order matches first-occurrence
+ * in the body; duplicates removed. Capped at MAX_MENTIONS_PER_COMMENT so a
+ * single comment can't fan out unbounded notifications.
+ */
+export function detectUserMentions(body, senderUserId, authService) {
+    if (!body)
+        return [];
+    const handles = new Set();
+    for (const match of body.matchAll(USER_MENTION_RE)) {
+        const handle = match[1]?.toLowerCase();
+        if (!handle || handle === 'agent')
+            continue;
+        handles.add(handle);
+        if (handles.size >= MAX_MENTIONS_PER_COMMENT)
+            break;
+    }
+    if (handles.size === 0)
+        return [];
+    const byHandle = new Map(authService.listUsers().map(u => [u.handle, u]));
+    const out = [];
+    for (const handle of handles) {
+        const user = byHandle.get(handle);
+        if (user && user.id !== senderUserId)
+            out.push(user);
+    }
+    return out;
+}
+/** True iff the body contains an `@agent` mention. */
+export function hasAgentMention(body) {
+    return AGENT_MENTION_RE.test(body);
+}
+//# sourceMappingURL=mention-detector.js.map

package/dist/services/mention-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-detector.js","sourceRoot":"","sources":["../../src/services/mention-detector.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,4CAA4C,CAAC;AAE5E,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAE5C;;gDAEgD;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,YAAoB,EACpB,WAAwB;IAExB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,OAAO;YAAE,SAAS;QAC5C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,IAAI,IAAI,wBAAwB;YAAE,MAAM;IACtD,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,YAAY;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/services/model-capabilities.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Model capability resolution (P3b — A6).
+ *
+ * The only capability we care about today is **vision**: can the configured
+ * inference model accept image input? Image captioning / OCR (the P3b indexing
+ * pass) and the composer's vision attachments (P6) both gate on this.
+ *
+ * Source of truth, in order:
+ *   1. pi-ai model metadata — `Model.input` is a `("text" | "image")[]`, so
+ *      `input.includes('image')` is authoritative WHEN pi-ai knows the model.
+ *   2. A **maintained fallback map** — pi-ai's generated metadata is missing or
+ *      wrong for custom / gateway / newly-released models. The Studiograph
+ *      Credits gateway in particular routes through its own client and is
+ *      asserted vision-capable here (decision A6).
+ *
+ * Why a map and not "trust pi-ai or default false": defaulting unknown models
+ * to false would silently disable captioning the moment a tenant points at a
+ * model pi-ai hasn't catalogued yet — a quiet regression. The map lets us
+ * assert capability for the providers we actually ship against.
+ *
+ * Note: vision *capability* is necessary but not sufficient for captioning.
+ * The Credits gateway is vision-capable yet `completeSimple()` cannot reach it
+ * (see asset-caption-service.ts) — that reachability gate is separate.
+ */
+/** Shape we read off a pi-ai model. Kept structural so tests can pass a stub. */
+export interface VisionModelLike {
+    input?: readonly string[];
+}
+/**
+ * Does the model that pi-ai resolves for `(provider, modelId)` accept image
+ * input? pi-ai metadata wins when present; otherwise the maintained fallback
+ * map; otherwise `false` (conservative — captioning degrades to filename-only
+ * rather than firing a vision call the model would reject).
+ */
+export declare function supportsVision(provider: string, modelId: string): boolean;
+/**
+ * Capability check against an already-resolved model object (e.g. one from
+ * `getModel`/`studiographCreditsModel`). Falls back to the (provider, modelId)
+ * map when the object carries no usable `input` array.
+ */
+export declare function modelSupportsVision(model: VisionModelLike | null | undefined, provider: string, modelId: string): boolean;

package/dist/services/model-capabilities.js

@@ -0,0 +1,107 @@
+/**
+ * Model capability resolution (P3b — A6).
+ *
+ * The only capability we care about today is **vision**: can the configured
+ * inference model accept image input? Image captioning / OCR (the P3b indexing
+ * pass) and the composer's vision attachments (P6) both gate on this.
+ *
+ * Source of truth, in order:
+ *   1. pi-ai model metadata — `Model.input` is a `("text" | "image")[]`, so
+ *      `input.includes('image')` is authoritative WHEN pi-ai knows the model.
+ *   2. A **maintained fallback map** — pi-ai's generated metadata is missing or
+ *      wrong for custom / gateway / newly-released models. The Studiograph
+ *      Credits gateway in particular routes through its own client and is
+ *      asserted vision-capable here (decision A6).
+ *
+ * Why a map and not "trust pi-ai or default false": defaulting unknown models
+ * to false would silently disable captioning the moment a tenant points at a
+ * model pi-ai hasn't catalogued yet — a quiet regression. The map lets us
+ * assert capability for the providers we actually ship against.
+ *
+ * Note: vision *capability* is necessary but not sufficient for captioning.
+ * The Credits gateway is vision-capable yet `completeSimple()` cannot reach it
+ * (see asset-caption-service.ts) — that reachability gate is separate.
+ */
+import { getModel } from '@mariozechner/pi-ai';
+const VISION_FALLBACK = [
+    // Studiograph Credits gateway — asserted vision-capable (A6). pi-ai has no
+    // metadata for the synthetic gateway model id.
+    { provider: 'studiograph-cloud', vision: true },
+    { provider: 'studiograph-cloud-inference', vision: true },
+    // Anthropic — every shipping Claude 3+/4 model takes images.
+    { provider: 'anthropic', modelSubstrings: ['claude-'], vision: true },
+    // OpenAI — 4o / 4.1 / 5 families (unambiguous substrings) plus the o-series,
+    // which is anchored to the id prefix so a stray "o1" inside an unrelated id
+    // can't falsely report vision. The text-only 3.5 line matches nothing here.
+    {
+        provider: 'openai',
+        modelSubstrings: ['gpt-4o', 'gpt-4.1', 'gpt-5', 'gpt-4-vision'],
+        modelPatterns: [/^o[134](-|$)/],
+        vision: true,
+    },
+    // Google Gemini — 1.5/2.x are multimodal.
+    { provider: 'google', modelSubstrings: ['gemini-'], vision: true },
+];
+/** Lowercase + trim for stable matching. */
+const norm = (s) => s.trim().toLowerCase();
+/**
+ * Resolve vision capability from the maintained fallback map. Returns
+ * `undefined` when no rule matches (caller decides the conservative default).
+ */
+function visionFromFallback(provider, modelId) {
+    const p = norm(provider);
+    const m = norm(modelId);
+    let result;
+    for (const rule of VISION_FALLBACK) {
+        if (rule.provider !== p)
+            continue;
+        if (!rule.modelSubstrings || rule.modelSubstrings.length === 0) {
+            // Whole-provider rule.
+            result = rule.vision;
+            continue;
+        }
+        const matched = rule.modelSubstrings.some(sub => m.includes(sub))
+            || (rule.modelPatterns?.some(re => re.test(m)) ?? false);
+        if (matched) {
+            return rule.vision;
+        }
+        // Provider matched but no model substring did — record a provider-level
+        // "false" only if no positive rule fires later. We don't early-return
+        // here so a more specific positive substring rule can still win.
+        if (result === undefined)
+            result = false;
+    }
+    return result;
+}
+/**
+ * Does the model that pi-ai resolves for `(provider, modelId)` accept image
+ * input? pi-ai metadata wins when present; otherwise the maintained fallback
+ * map; otherwise `false` (conservative — captioning degrades to filename-only
+ * rather than firing a vision call the model would reject).
+ */
+export function supportsVision(provider, modelId) {
+    // 1. pi-ai metadata, when it knows the model.
+    try {
+        const model = getModel(provider, modelId);
+        if (model?.input && Array.isArray(model.input)) {
+            return model.input.includes('image');
+        }
+    }
+    catch {
+        // Unknown to pi-ai (custom/gateway/new model) — fall through to the map.
+    }
+    // 2. Maintained fallback map. 3. Conservative default.
+    return visionFromFallback(provider, modelId) ?? false;
+}
+/**
+ * Capability check against an already-resolved model object (e.g. one from
+ * `getModel`/`studiographCreditsModel`). Falls back to the (provider, modelId)
+ * map when the object carries no usable `input` array.
+ */
+export function modelSupportsVision(model, provider, modelId) {
+    if (model?.input && Array.isArray(model.input)) {
+        return model.input.includes('image');
+    }
+    return visionFromFallback(provider, modelId) ?? false;
+}
+//# sourceMappingURL=model-capabilities.js.map

package/dist/services/model-capabilities.js.map

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

package/dist/services/notification-broadcast.d.ts

@@ -0,0 +1,32 @@
+import type { WsHub } from '../server/ws-hub.js';
+import type { NotificationService } from './notification-service.js';
+import type { AuthUser } from './auth-service.js';
+export interface BroadcastMentionInput {
+    /** User who was @mentioned. */
+    recipient: AuthUser;
+    /** What kind of artifact the mention lives on. Phase 1: 'comment'. */
+    sourceType: string;
+    /** Stable public id of the source (e.g. comment_id). */
+    sourceId: string;
+    /** Body excerpt to render in the notifications dropdown row. Truncated to 200 chars on insert. */
+    preview: string;
+    /** Who did the mentioning. */
+    mentioner: AuthUser;
+    /** Entry coords for deep-linking from the notifications dropdown directly
+     *  to the commented entry. Null for sources that don't live on an entry. */
+    entry: {
+        repo: string;
+        entryType: string;
+        entryId: string;
+        threadId: string;
+    } | null;
+}
+/**
+ * Persist + broadcast a mention. The persisted row is what the notifications
+ * dropdown reads on next load; the WS event is the live nudge that surfaces
+ * the toast and bumps the unread badge without waiting for a poll.
+ *
+ * One-stop call site so messaging-era split between "write row" and "fire
+ * event" can never drift — every mention goes through this.
+ */
+export declare function broadcastMention(notifications: NotificationService, wsHub: WsHub, input: BroadcastMentionInput): number;

package/dist/services/notification-broadcast.js

@@ -0,0 +1,38 @@
+/**
+ * Persist + broadcast a mention. The persisted row is what the notifications
+ * dropdown reads on next load; the WS event is the live nudge that surfaces
+ * the toast and bumps the unread badge without waiting for a poll.
+ *
+ * One-stop call site so messaging-era split between "write row" and "fire
+ * event" can never drift — every mention goes through this.
+ */
+export function broadcastMention(notifications, wsHub, input) {
+    const id = notifications.insert({
+        userId: input.recipient.id,
+        sourceType: input.sourceType,
+        sourceId: input.sourceId,
+        mentionerUserId: input.mentioner.id,
+        mentionerDisplayName: input.mentioner.displayName,
+        preview: input.preview,
+    });
+    // Target the recipient explicitly. `wsHub.broadcast` only filters by
+    // `event.repo`, and user_mention has no repo, so a plain broadcast would
+    // fan the toast + preview out to every connected client — leaking the
+    // comment body and bumping unread badges for users who weren't mentioned.
+    wsHub.broadcastToUser(String(input.recipient.id), {
+        type: 'user_mention',
+        userId: input.recipient.id,
+        notificationId: id,
+        sourceType: input.sourceType,
+        sourceId: input.sourceId,
+        mentionerName: input.mentioner.displayName,
+        preview: input.preview.length > 200 ? input.preview.slice(0, 200) : input.preview,
+        timestamp: new Date().toISOString(),
+        entryRepo: input.entry?.repo ?? null,
+        entryType: input.entry?.entryType ?? null,
+        entryId: input.entry?.entryId ?? null,
+        threadId: input.entry?.threadId ?? null,
+    });
+    return id;
+}
+//# sourceMappingURL=notification-broadcast.js.map

package/dist/services/notification-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-broadcast.js","sourceRoot":"","sources":["../../src/services/notification-broadcast.ts"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,aAAkC,EAClC,KAAY,EACZ,KAA4B;IAE5B,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;QAC9B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE;QACnC,oBAAoB,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;QACjD,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,qEAAqE;IACrE,yEAAyE;IACzE,sEAAsE;IACtE,0EAA0E;IAC1E,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE;QAChD,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE;QAC1B,cAAc,EAAE,EAAE;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;QAC1C,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;QACjF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI;QACpC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,IAAI,IAAI;QACzC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI;QACrC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,IAAI,IAAI;KACxC,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/services/notification-service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Polymorphic notification feed. Phase 1 only ever writes `source_type='comment'`
+ * (the messaging-era 'message' source died with the messaging surface in Phase
+ * 0). The polymorphic shape stays so future surfaces can ride the same wire.
+ */
+export interface Notification {
+    id: number;
+    userId: number;
+    sourceType: string;
+    sourceId: string;
+    mentionerUserId: number;
+    mentionerDisplayName: string;
+    preview: string;
+    read: 0 | 1;
+    createdAt: string;
+}
+export interface InsertNotificationInput {
+    userId: number;
+    sourceType: string;
+    sourceId: string;
+    mentionerUserId: number;
+    mentionerDisplayName: string;
+    preview: string;
+}
+export declare class NotificationService {
+    private db;
+    constructor(workspacePath: string);
+    /** Insert a notification and return the new id. */
+    insert(input: InsertNotificationInput): number;
+    list(userId: number, opts?: {
+        limit?: number;
+        unreadOnly?: boolean;
+    }): Notification[];
+    unreadCount(userId: number): number;
+    markRead(notificationId: number, userId: number): boolean;
+    markAllRead(userId: number): number;
+    /** Remove all notifications referencing a given source (used when a comment is hard-deleted). */
+    deleteBySource(sourceType: string, sourceId: string): number;
+    close(): void;
+    private toNotification;
+}

package/dist/services/notification-service.js

@@ -0,0 +1,100 @@
+import Database from 'better-sqlite3';
+import { join } from 'node:path';
+import { existsSync, mkdirSync, chmodSync } from 'node:fs';
+export class NotificationService {
+    db;
+    constructor(workspacePath) {
+        const sgDir = join(workspacePath, '.studiograph');
+        if (!existsSync(sgDir))
+            mkdirSync(sgDir, { recursive: true });
+        const dbPath = join(sgDir, 'notifications.db');
+        this.db = new Database(dbPath);
+        if (process.platform !== 'win32') {
+            try {
+                chmodSync(dbPath, 0o600);
+            }
+            catch { /* non-fatal */ }
+        }
+        this.db.pragma('journal_mode = WAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS notifications (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        user_id INTEGER NOT NULL,
+        source_type TEXT NOT NULL,
+        source_id TEXT NOT NULL,
+        mentioner_user_id INTEGER NOT NULL,
+        mentioner_display_name TEXT NOT NULL,
+        preview TEXT NOT NULL,
+        read INTEGER NOT NULL DEFAULT 0 CHECK(read IN (0, 1)),
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_notifications_user
+        ON notifications(user_id, read, id DESC)
+    `);
+    }
+    /** Insert a notification and return the new id. */
+    insert(input) {
+        const stmt = this.db.prepare(`
+      INSERT INTO notifications
+        (user_id, source_type, source_id, mentioner_user_id, mentioner_display_name, preview)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        const result = stmt.run(input.userId, input.sourceType, input.sourceId, input.mentionerUserId, input.mentionerDisplayName, input.preview.length > 200 ? input.preview.slice(0, 200) : input.preview);
+        return result.lastInsertRowid;
+    }
+    list(userId, opts = {}) {
+        const limit = Math.min(opts.limit ?? 50, 200);
+        const filter = opts.unreadOnly ? 'AND read = 0' : '';
+        const rows = this.db.prepare(`
+      SELECT id, user_id, source_type, source_id, mentioner_user_id,
+             mentioner_display_name, preview, read, created_at
+      FROM notifications
+      WHERE user_id = ? ${filter}
+      ORDER BY id DESC
+      LIMIT ?
+    `).all(userId, limit);
+        return rows.map(this.toNotification);
+    }
+    unreadCount(userId) {
+        const row = this.db.prepare(`
+      SELECT COUNT(*) AS c FROM notifications WHERE user_id = ? AND read = 0
+    `).get(userId);
+        return row.c;
+    }
+    markRead(notificationId, userId) {
+        const result = this.db.prepare(`
+      UPDATE notifications SET read = 1 WHERE id = ? AND user_id = ?
+    `).run(notificationId, userId);
+        return result.changes > 0;
+    }
+    markAllRead(userId) {
+        const result = this.db.prepare(`
+      UPDATE notifications SET read = 1 WHERE user_id = ? AND read = 0
+    `).run(userId);
+        return result.changes;
+    }
+    /** Remove all notifications referencing a given source (used when a comment is hard-deleted). */
+    deleteBySource(sourceType, sourceId) {
+        const result = this.db.prepare(`
+      DELETE FROM notifications WHERE source_type = ? AND source_id = ?
+    `).run(sourceType, sourceId);
+        return result.changes;
+    }
+    close() {
+        this.db.close();
+    }
+    toNotification = (row) => ({
+        id: row.id,
+        userId: row.user_id,
+        sourceType: row.source_type,
+        sourceId: row.source_id,
+        mentionerUserId: row.mentioner_user_id,
+        mentionerDisplayName: row.mentioner_display_name,
+        preview: row.preview,
+        read: row.read === 1 ? 1 : 0,
+        createdAt: row.created_at,
+    });
+}
+//# sourceMappingURL=notification-service.js.map

package/dist/services/notification-service.js.map

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