studiograph 1.3.48-next.26 → 1.3.48-next.261

package/dist/services/fonts/font-metadata.js

@@ -0,0 +1,126 @@
+/**
+ * Server-side font metadata parser (fontkit). Reads a font file's OpenType
+ * `name` + OS/2 tables to extract the typographic family (name ID 16), legacy
+ * family (name ID 1), subfamily (ID 17), true weight (OS/2 usWeightClass),
+ * italic bit, and PostScript name — what macOS/Font Book read, and what the
+ * Font Family feature uses instead of filename guessing (which splits and
+ * mis-weights families).
+ *
+ * fontkit is server-only and ESM (`type: module`); it is NOT importable from
+ * `@core` (shared with the web bundle). The pure CSS derivation that consumes
+ * the parsed shape lives in `@core/font-family`.
+ */
+import * as fontkit from 'fontkit';
+/** fontkit normalizes the OpenType name table to language-keyed records; pull
+ *  the English entry, else any present language. */
+function pickName(record) {
+    if (typeof record === 'string')
+        return record || undefined;
+    if (record && typeof record === 'object') {
+        const r = record;
+        const v = r.en ?? Object.values(r)[0];
+        return v || undefined;
+    }
+    return undefined;
+}
+/** CSS `format(...)` token from the stored filename extension. Defaults to
+ *  opentype (the OTF the workspace ships); the parser still reads metadata
+ *  from the actual bytes regardless. */
+export function fontFormatFromFilename(filename) {
+    const ext = filename.toLowerCase().split('.').pop() ?? '';
+    switch (ext) {
+        case 'woff2': return 'woff2';
+        case 'woff': return 'woff';
+        case 'ttf': return 'truetype';
+        default: return 'opentype';
+    }
+}
+/**
+ * Parse one font file into a face descriptor, or `null` if fontkit can't read
+ * it (corrupt / unsupported container). Never throws — a bad upload degrades to
+ * filename-based handling at the call site rather than failing the whole flow.
+ */
+export function parseFontFace(input) {
+    let font;
+    try {
+        const parsed = fontkit.create(input.bytes);
+        // A collection (.ttc/.otc) exposes `.fonts`; take the first member.
+        font = Array.isArray(parsed?.fonts) ? parsed.fonts[0] : parsed;
+    }
+    catch {
+        return null;
+    }
+    if (!font)
+        return null;
+    const rec = (font.name?.records ?? {});
+    const os2 = font['OS/2'];
+    const macStyle = font.head?.macStyle;
+    const typographic = pickName(rec.preferredFamily) ?? pickName(rec.fontFamily) ?? font.familyName;
+    const legacy = pickName(rec.fontFamily) ?? font.familyName;
+    const subfamily = pickName(rec.preferredSubfamily) ?? pickName(rec.fontSubfamily) ?? font.subfamilyName;
+    const postscript = pickName(rec.postscriptName) ?? (typeof font.postscriptName === 'string' ? font.postscriptName : undefined);
+    if (!typographic)
+        return null; // a font with no usable family name is unusable here
+    const weight = clampWeight(os2?.usWeightClass);
+    const italic = !!(os2?.fsSelection?.italic || macStyle?.italic || (typeof font.italicAngle === 'number' && font.italicAngle !== 0));
+    // Variable when the font carries named variation axes.
+    const variable = !!(font.variationAxes && Object.keys(font.variationAxes).length > 0);
+    // Only include optional keys when they have a value — a literal `undefined`
+    // in the resulting `font` frontmatter makes the YAML serializer throw
+    // ("unacceptable kind of an object to dump [object Undefined]"). null/omitted
+    // are fine; undefined is not.
+    return {
+        typographicFamily: typographic,
+        weight,
+        style: italic ? 'italic' : 'normal',
+        asset_id: input.assetId,
+        filename: input.filename,
+        format: fontFormatFromFilename(input.filename),
+        ...(subfamily ? { subfamily } : {}),
+        ...(legacy ? { legacy_family: legacy } : {}),
+        ...(postscript ? { postscript_name: postscript } : {}),
+        ...(variable ? { variable: true } : {}),
+    };
+}
+function clampWeight(w) {
+    const n = typeof w === 'number' && Number.isFinite(w) ? Math.round(w) : 400;
+    return Math.min(1000, Math.max(1, n));
+}
+/**
+ * Group parsed faces into Font Families by their typographic family (name ID
+ * 16). Each family's `aliases` are the distinct legacy family names that differ
+ * from the typographic name (so weight-baked legacy references still resolve).
+ * Faces are sorted by (weight, style) for stable, readable output. Families are
+ * returned in first-seen order of their typographic name.
+ */
+export function buildFontFamilies(faces) {
+    const byFamily = new Map();
+    for (const face of faces) {
+        const list = byFamily.get(face.typographicFamily);
+        if (list)
+            list.push(face);
+        else
+            byFamily.set(face.typographicFamily, [face]);
+    }
+    const families = [];
+    for (const [family, group] of byFamily) {
+        const aliases = new Set();
+        for (const f of group) {
+            if (f.legacy_family && f.legacy_family !== family)
+                aliases.add(f.legacy_family);
+        }
+        const sorted = [...group].sort((a, b) => a.weight - b.weight || a.style.localeCompare(b.style));
+        families.push({
+            family,
+            ...(aliases.size ? { aliases: [...aliases] } : {}),
+            faces: sorted.map(stripGroupingKeys),
+        });
+    }
+    return families;
+}
+/** Drop the parser-only `typographicFamily` grouping key, leaving a schema FontFace. */
+function stripGroupingKeys(face) {
+    const { typographicFamily: _omit, ...rest } = face;
+    return rest;
+}
+//# sourceMappingURL=font-metadata.js.map

package/dist/services/fonts/font-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-metadata.js","sourceRoot":"","sources":["../../../src/services/fonts/font-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAgBnC;oDACoD;AACpD,SAAS,QAAQ,CAAC,MAAe;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,IAAI,SAAS,CAAC;IAC3D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,MAAgC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,SAAS,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;wCAEwC;AACxC,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC1D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC;QAC7B,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC;QAC3B,KAAK,KAAK,CAAC,CAAC,OAAO,UAAU,CAAC;QAC9B,OAAO,CAAC,CAAC,OAAO,UAAU,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,IAAI,IAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAQ,CAAC;QAClD,oEAAoE;QACpE,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAA4B,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;IAErC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC;IACjG,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC;IAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC;IACxG,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE/H,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC,CAAC,qDAAqD;IAEpF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC;IACpI,uDAAuD;IACvD,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtF,4EAA4E;IAC5E,sEAAsE;IACtE,8EAA8E;IAC9E,8BAA8B;IAC9B,OAAO;QACL,iBAAiB,EAAE,WAAW;QAC9B,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACnC,QAAQ,EAAE,KAAK,CAAC,OAAO;QACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9C,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,CAAU;IAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAClD,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACrB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,aAAa,KAAK,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAChG,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,wFAAwF;AACxF,SAAS,iBAAiB,CAAC,IAAoB;IAC7C,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/services/fonts/font-skill-service.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Font skill orchestration: package a set of selected font assets into a `skill`
+ * entity. The server reads each file's real metadata (family / weight / style),
+ * groups faces into families, and writes a skill whose markdown body carries an
+ * orienting note, the font files as chips, and the derived `@font-face` block.
+ * The agent then uses that skill to make on-brand artifacts. Injectable
+ * (download + access predicates) so it unit-tests without a live workspace.
+ */
+import { type FontFamily } from '../../core/font-family.js';
+export interface FontFamilyAssetInput {
+    assetId: string;
+    filename: string;
+    /** Owning repo of the asset (where its bytes are downloaded from). */
+    repo: string;
+}
+export interface SkippedFontAsset {
+    assetId: string;
+    filename: string;
+    reason: 'unknown' | 'not-a-font' | 'no-access' | 'download-failed' | 'unparseable';
+}
+/** A selected asset is a font when the index marks it `font` media, or its name
+ *  carries a font extension (legacy rows whose octet-stream type indexes as
+ *  `other`). Used to skip non-font selections BEFORE downloading the blob. */
+export declare function isFontAssetRow(row: {
+    mediaType?: string;
+    filename: string;
+}): boolean;
+export interface ResolveFontFamiliesParams {
+    assets: FontFamilyAssetInput[];
+    download: (repo: string, assetId: string, filename: string) => Promise<Buffer>;
+    canRead: (repo: string) => boolean;
+}
+/** Download → parse (real metadata) → group the selected font assets into
+ *  families. Per-asset failures are reported, never fatal. */
+export declare function resolveFontFamilies(params: ResolveFontFamiliesParams): Promise<{
+    families: FontFamily[];
+    skipped: SkippedFontAsset[];
+}>;
+export interface FontSkillDraft {
+    /** Display name / title of the skill entry. */
+    name: string;
+    entityId: string;
+    /** Frontmatter description — the agent reads this to know when to load it. */
+    description: string;
+    /** Markdown body (no frontmatter; the route stamps that). */
+    content: string;
+    familyNames: string[];
+    faceCount: number;
+}
+/** kebab-case skill id from a name. */
+export declare function slugifyFontSkillId(name: string): string;
+/**
+ * Build ONE font skill from all selected font assets (a selection can carry
+ * several typefaces). Returns `null` when nothing parsed.
+ */
+export declare function buildFontSkill(params: ResolveFontFamiliesParams & {
+    nameOverride?: string;
+}): Promise<{
+    draft: FontSkillDraft | null;
+    skipped: SkippedFontAsset[];
+}>;
+/**
+ * The font-skill markdown body: an orienting paragraph, then per family a short
+ * summary, the font files as chips, and the `@font-face` block.
+ */
+export declare function buildFontSkillContent(families: FontFamily[]): string;

package/dist/services/fonts/font-skill-service.js

@@ -0,0 +1,137 @@
+/**
+ * Font skill orchestration: package a set of selected font assets into a `skill`
+ * entity. The server reads each file's real metadata (family / weight / style),
+ * groups faces into families, and writes a skill whose markdown body carries an
+ * orienting note, the font files as chips, and the derived `@font-face` block.
+ * The agent then uses that skill to make on-brand artifacts. Injectable
+ * (download + access predicates) so it unit-tests without a live workspace.
+ */
+import { fontFaceCssForFamily, fontFaceAssetUrl } from '../../core/font-family.js';
+import { parseFontFace, buildFontFamilies } from './font-metadata.js';
+/** A selected asset is a font when the index marks it `font` media, or its name
+ *  carries a font extension (legacy rows whose octet-stream type indexes as
+ *  `other`). Used to skip non-font selections BEFORE downloading the blob. */
+export function isFontAssetRow(row) {
+    return row.mediaType === 'font' || /\.(?:otf|ttf|woff2?)$/i.test(row.filename);
+}
+/** Download → parse (real metadata) → group the selected font assets into
+ *  families. Per-asset failures are reported, never fatal. */
+export async function resolveFontFamilies(params) {
+    const { assets, download, canRead } = params;
+    const faces = [];
+    const skipped = [];
+    for (const a of assets) {
+        if (!canRead(a.repo)) {
+            skipped.push({ assetId: a.assetId, filename: a.filename, reason: 'no-access' });
+            continue;
+        }
+        let bytes;
+        try {
+            bytes = await download(a.repo, a.assetId, a.filename);
+        }
+        catch {
+            skipped.push({ assetId: a.assetId, filename: a.filename, reason: 'download-failed' });
+            continue;
+        }
+        const face = parseFontFace({ assetId: a.assetId, filename: a.filename, bytes });
+        if (!face) {
+            skipped.push({ assetId: a.assetId, filename: a.filename, reason: 'unparseable' });
+            continue;
+        }
+        faces.push(face);
+    }
+    return { families: buildFontFamilies(faces), skipped };
+}
+/** kebab-case skill id from a name. */
+export function slugifyFontSkillId(name) {
+    return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') || 'fonts';
+}
+/**
+ * Build ONE font skill from all selected font assets (a selection can carry
+ * several typefaces). Returns `null` when nothing parsed.
+ */
+export async function buildFontSkill(params) {
+    const { families, skipped } = await resolveFontFamilies(params);
+    if (families.length === 0)
+        return { draft: null, skipped };
+    const override = params.nameOverride?.trim();
+    const name = override || (families.length === 1 ? `${families[0].family} Fonts` : 'Fonts');
+    const familyNames = families.map((f) => f.family);
+    const faceCount = families.reduce((n, f) => n + f.faces.length, 0);
+    const description = `Use ${joinFamilies(familyNames)} when creating an artifact, deck, or document — ` +
+        `include the @font-face block from this skill so the font renders everywhere (canvas, PDF, HTML, share).`;
+    return {
+        draft: { name, entityId: slugifyFontSkillId(name), description, content: buildFontSkillContent(families), familyNames, faceCount },
+        skipped,
+    };
+}
+const WEIGHT_LABELS = {
+    100: 'Thin', 200: 'Extralight', 300: 'Light', 400: 'Regular',
+    500: 'Medium', 600: 'Semibold', 700: 'Bold', 800: 'Extrabold', 900: 'Black', 1000: 'Super',
+};
+/** "the Graphik Schema font" / "the Graphik Schema and Söhne fonts". Escapes the
+ *  (metadata-derived) family names — joinFamilies feeds the body prose AND the
+ *  frontmatter description (agent-loaded instructions), so a crafted name must
+ *  not inject markdown/newlines there either. */
+function joinFamilies(rawNames) {
+    const names = rawNames.map(escapeMdInline);
+    if (names.length === 1)
+        return `the ${names[0]} font`;
+    const head = names.slice(0, -1).join(', ');
+    return `the ${head} and ${names[names.length - 1]} fonts`;
+}
+/** Distinct weights present in a family, smallest first, as readable labels. */
+function weightSummary(font) {
+    const seen = new Map();
+    for (const f of font.faces) {
+        if (!seen.has(f.weight))
+            seen.set(f.weight, WEIGHT_LABELS[f.weight] || String(f.weight));
+    }
+    const hasItalic = font.faces.some((f) => f.style === 'italic');
+    const labels = [...seen.entries()].sort((a, b) => a[0] - b[0]).map(([w, label]) => `${label} (${w})`);
+    return labels.join(', ') + (hasItalic ? ' + italics' : '');
+}
+/** Strip the `<timestamp>-` upload prefix for a clean chip label (native form).
+ *  Mirrors `displayFilename` in web/manager-logic.ts (same stable prefix rule). */
+function displayFilename(filename) {
+    return filename.replace(/^\d+-/, '');
+}
+/** Escape markdown link-label metacharacters. Filenames + font-metadata names
+ *  flow into `[label](url)` / inline code, and a `]` or backtick in them (a
+ *  legit `Trial [2024].otf`, or a crafted font) would break out of the link /
+ *  code span. Escapes `\\ [ ] \` ` and drops control chars. */
+function escapeMdInline(s) {
+    return [...s]
+        .filter((c) => { const n = c.charCodeAt(0); return n >= 32 && n !== 127; })
+        .join('')
+        .replace(/[\\[\]`]/g, '\\$&');
+}
+/**
+ * The font-skill markdown body: an orienting paragraph, then per family a short
+ * summary, the font files as chips, and the `@font-face` block.
+ */
+export function buildFontSkillContent(families) {
+    const names = families.map((f) => f.family);
+    const lines = [];
+    // Single-line paragraph — no mid-sentence breaks (those render as stray line
+    // breaks in markdown).
+    lines.push(`This skill tells Studiograph to use ${joinFamilies(names)} when it creates artifacts, so the type renders correctly everywhere, including PDF and HTML exports and shared links.`, '');
+    for (const font of families) {
+        lines.push(`## ${escapeMdInline(font.family)}`, '');
+        lines.push(`${font.faces.length} ${font.faces.length === 1 ? 'style' : 'styles'}: ${weightSummary(font)}.`);
+        if (font.aliases?.length) {
+            lines.push(`Also answers to: ${font.aliases.map((a) => `\`${escapeMdInline(a)}\``).join(', ')}.`);
+        }
+        lines.push('');
+        // Font files as chips — a plain `[filename](/api/assets/…)` link is what the
+        // editor renders as a file chip (the `![]` image form would break for a
+        // font). Each on its OWN paragraph (blank line between) so they render as a
+        // standalone-chip stack across the editor AND the reading/share renderer
+        // (consecutive lines would soft-wrap into one run in plain markdown).
+        for (const f of font.faces)
+            lines.push(`[${escapeMdInline(displayFilename(f.filename))}](${fontFaceAssetUrl(f)})`, '');
+    }
+    lines.push('## Font CSS', '', '```css', families.map(fontFaceCssForFamily).join('\n\n'), '```', '');
+    return lines.join('\n');
+}
+//# sourceMappingURL=font-skill-service.js.map

package/dist/services/fonts/font-skill-service.js.map

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

package/dist/services/git.d.ts

@@ -39,6 +39,12 @@ export declare class GitService {
      * Check if repository has any commits
      */
     hasCommits(): boolean;
+    /**
+     * Return the current HEAD commit hash, or null if the repo has no commits.
+     * Used by callers (MCP update_entity) that want to surface the post-write
+     * commit hash so external agents can verify a write landed in git.
+     */
+    getHeadCommit(): string | null;
     /**
      * Get current branch name
      */
@@ -59,6 +65,45 @@ export declare class GitService {
      * Get file content at a specific commit
      */
     getFileAtCommit(filePath: string, commitHash: string): string | null;
+    /**
+     * List every file path tracked in `commitHash`, repo-relative POSIX.
+     * Returns an empty array on error (unknown hash, malformed history).
+     * Used by restore flows that need to find a deleted entity's file
+     * inside its last-known commit without knowing the path up-front.
+     */
+    listFilesAtCommit(commitHash: string): string[];
+    /**
+     * Unified diff between two commits for a single file. `toCommitHash` may
+     * be 'HEAD' or any rev-spec git accepts. All three params flow through
+     * passed as argv entries so shell metacharacters in paths or revs are never
+     * interpreted by a shell. Returns the raw diff (or empty string on failure).
+     */
+    getDiff(fromCommitHash: string, toCommitHash: string, filePath: string): string;
+    /**
+     * Recent file deletions from the commit log, scoped to a time window.
+     *
+     * Uses `git log --diff-filter=D --name-only` to find every commit that
+     * deleted at least one file, then walks the output and pairs each
+     * deleted path with the commit that removed it. The returned list is
+     * deduped on `filePath` so a file deleted-and-recreated-and-deleted
+     * surfaces only its most recent removal — that's the one a "restore"
+     * action is going to target.
+     *
+     * `withinDays` clamps to a 1-90 day window. The default of 7 covers
+     * the most common "I deleted that yesterday" workflows without
+     * dragging in months of forgotten removals.
+     */
+    listRecentDeletions(withinDays?: number): Array<{
+        filePath: string;
+        deletedAtCommit: string;
+        deletedAt: number;
+        deletedBy: {
+            name: string;
+            email: string;
+        };
+        lastVersionCommit: string;
+        commitMessage: string;
+    }>;
     /**
      * Get current status (modified, added, deleted files)
      */
@@ -96,6 +141,11 @@ export declare class GitService {
      * Stage specific files and commit with user attribution.
      * Unlike commitAll, this only stages the given files — unrelated
      * untracked files (e.g. sync-created entities) are left untouched.
+     *
+     * Uses `git add -A <pathspec>` so deletions, modifications, and
+     * additions under the listed paths are all staged. The path scoping
+     * still prevents pulling in unrelated untracked files outside the
+     * listed paths. Throws on git failure with stderr in the error.
      */
     commitFiles(filePaths: string[], message: string, user: GitUser): void;
     /**
@@ -106,6 +156,14 @@ export declare class GitService {
      * Pull from remote
      */
     pull(): void;
+    /**
+     * Repo-relative POSIX paths of files that differ between two commits
+     * (`git diff --name-only <from> <to>`). Both revs flow through argv so
+     * shell metacharacters are never interpreted. Returns `[]` on failure or
+     * when nothing changed. Used by `graph.pullAndReconcile` to find the .md
+     * files a pull rewrote so any live editor Y.Doc can be reconciled.
+     */
+    diffNameOnly(fromCommitHash: string, toCommitHash: string): string[];
     /**
      * Get status as array of { path, status } entries
      */