modelroom 0.0.0-stage → 0.0.2

package/dist/lib/artifact.js

@@ -0,0 +1,62 @@
+// modelroom — optional artifact rendering (HTML → PNG)
+//
+// Rendering is optional: it needs Playwright with a browser installed. If it is not
+// there, modelroom still works — the room just has no thumbnail.
+import { join } from 'node:path';
+import { stat } from 'node:fs/promises';
+export async function playwrightAvailable() {
+    try {
+        await import('playwright');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const INSTALL_HINT = 'PNG rendering needs Playwright:\n' +
+    '  npm install --include=dev playwright && npx playwright install chromium\n' +
+    '(modelroom works without it — the room just has no thumbnail.)';
+const WIDTHS = { sp: 390, tablet: 1024, pc: 1280 };
+/**
+ * Render `rooms/<room>/<artifact>` to `<artifact>.png` next to it.
+ */
+export async function renderArtifact({ cfg, room, device = 'tablet', scale = 2, }) {
+    let chromium;
+    try {
+        ({ chromium } = await import('playwright'));
+    }
+    catch {
+        return { ok: false, error: INSTALL_HINT };
+    }
+    const width = WIDTHS[device] ?? 1024;
+    const src = join(cfg.roomsDir, room, cfg.artifact);
+    const out = src.replace(/\.html?$/i, '.png');
+    try {
+        await stat(src);
+    }
+    catch {
+        return { ok: false, error: `artifact not found: ${cfg.rooms}/${room}/${cfg.artifact}` };
+    }
+    const browser = await chromium.launch();
+    try {
+        const page = await browser.newPage({
+            viewport: { width, height: 800 },
+            deviceScaleFactor: scale,
+        });
+        await page.goto('file://' + src, { waitUntil: 'networkidle' });
+        await page.evaluate(() => document.fonts?.ready).catch(() => { });
+        await page.waitForTimeout(250);
+        const height = await page.evaluate(() => Math.ceil(document.body.getBoundingClientRect().height));
+        await page.setViewportSize({ width, height });
+        await page.waitForTimeout(150);
+        await page.screenshot({ path: out, fullPage: true, type: 'png' });
+        return { ok: true, png: out, width, height };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    finally {
+        await browser.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=artifact.js.map

package/dist/lib/artifact.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,53 @@
+export type AdapterName = 'opencode' | 'command';
+export interface AgentConfig {
+    adapter: AdapterName;
+    command: string;
+    /** e.g. "openrouter/deepseek/deepseek-v4.1-flash" (null = let the agent decide) */
+    model: string | null;
+    agent: string;
+    /** opencode: run with a private server (uses this process's env) */
+    standalone: boolean;
+    /** command adapter: e.g. ["-p", "{prompt}"] */
+    args: string[];
+}
+export interface Config {
+    root: string;
+    rooms: string;
+    artifact: string;
+    docs: string[];
+    port: number;
+    host: string;
+    agent: AgentConfig;
+    /** Resolved at load time. */
+    rootDir: string;
+    roomsDir: string;
+    configPath: string;
+    stateDir: string;
+    statePath: string;
+}
+export interface State {
+    sessions: Record<string, string>;
+    settings: Record<string, unknown>;
+}
+export declare const DEFAULTS: {
+    readonly root: '.';
+    readonly rooms: 'rooms';
+    readonly artifact: 'index.html';
+    readonly docs: readonly ['BRIEF.md', 'SPEC.md', 'BEHAVIOUR.md'];
+    readonly port: 4321;
+    readonly host: '127.0.0.1';
+    readonly agent: {
+        readonly adapter: 'opencode';
+        readonly command: 'opencode';
+        readonly model: null;
+        readonly agent: 'build';
+        readonly standalone: true;
+        readonly args: readonly [];
+    };
+};
+export declare function loadConfig(cwd?: string): Promise<Config>;
+export declare function loadState(cfg: Config): Promise<State>;
+export declare function saveState(cfg: Config, state: State): Promise<void>;
+/** Settings the UI may change (whitelist). */
+export declare function applySettings(cfg: Config, patch: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,eAAO,MAAM,QAAQ;aACnB,IAAI,EAAE,GAAG;aACT,KAAK,EAAE,OAAO;aACd,QAAQ,EAAE,YAAY;aACtB,IAAI,YAAG,UAAU,EAAE,SAAS,EAAE,cAAc;aAC5C,IAAI,EAAE,IAAI;aACV,IAAI,EAAE,WAAW;aACjB,KAAK;iBACH,OAAO,EAAE,UAAU;iBACnB,OAAO,EAAE,UAAU;iBACnB,KAAK;iBACL,KAAK,EAAE,OAAO;iBACd,UAAU;iBACV,IAAI;;CAEE,CAAC;AAIX,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7E;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAO3D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB"}

package/dist/lib/config.js

@@ -0,0 +1,92 @@
+// modelroom — config and state
+//
+// Config (`modelroom.json`) is committed. State (`.modelroom/state.json`) is local:
+// chat sessions per room, and any settings changed from the UI.
+import { readFile, writeFile, mkdir, rename } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+export const DEFAULTS = {
+    root: '.',
+    rooms: 'rooms',
+    artifact: 'index.html',
+    docs: ['BRIEF.md', 'SPEC.md', 'BEHAVIOUR.md'],
+    port: 4321,
+    host: '127.0.0.1',
+    agent: {
+        adapter: 'opencode',
+        command: 'opencode',
+        model: null,
+        agent: 'build',
+        standalone: true,
+        args: [],
+    },
+};
+export async function loadConfig(cwd = process.cwd()) {
+    const path = resolve(cwd, 'modelroom.json');
+    let file = {};
+    try {
+        file = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        /* no config: defaults */
+    }
+    const cfg = {
+        root: file.root ?? DEFAULTS.root,
+        rooms: file.rooms ?? DEFAULTS.rooms,
+        artifact: file.artifact ?? DEFAULTS.artifact,
+        docs: Array.isArray(file.docs) && file.docs.length ? file.docs : [...DEFAULTS.docs],
+        port: file.port ?? DEFAULTS.port,
+        host: file.host ?? DEFAULTS.host,
+        agent: { ...DEFAULTS.agent, ...file.agent },
+        rootDir: '',
+        roomsDir: '',
+        configPath: path,
+        stateDir: '',
+        statePath: '',
+    };
+    cfg.rootDir = resolve(cwd, cfg.root);
+    cfg.roomsDir = resolve(cfg.rootDir, cfg.rooms);
+    cfg.stateDir = join(cfg.rootDir, '.modelroom');
+    cfg.statePath = join(cfg.stateDir, 'state.json');
+    return cfg;
+}
+export async function loadState(cfg) {
+    try {
+        const raw = JSON.parse(await readFile(cfg.statePath, 'utf8'));
+        return { sessions: raw.sessions ?? {}, settings: raw.settings ?? {} };
+    }
+    catch {
+        return { sessions: {}, settings: {} };
+    }
+}
+export async function saveState(cfg, state) {
+    await mkdir(dirname(cfg.statePath), { recursive: true });
+    const tmp = cfg.statePath + '.tmp';
+    await writeFile(tmp, JSON.stringify(state, null, 2) + '\n');
+    await rename(tmp, cfg.statePath);
+}
+/** Settings the UI may change (whitelist). */
+export function applySettings(cfg, patch) {
+    const applied = {};
+    if (typeof patch.model === 'string') {
+        cfg.agent.model = patch.model || null;
+        applied.model = cfg.agent.model;
+    }
+    if (typeof patch.agent === 'string' && patch.agent) {
+        cfg.agent.agent = patch.agent;
+        applied.agent = cfg.agent.agent;
+    }
+    if (patch.adapter === 'opencode' || patch.adapter === 'command') {
+        cfg.agent.adapter = patch.adapter;
+        applied.adapter = cfg.agent.adapter;
+    }
+    if (typeof patch.command === 'string' && patch.command) {
+        cfg.agent.command = patch.command;
+        applied.command = cfg.agent.command;
+    }
+    if (typeof patch.standalone === 'boolean') {
+        cfg.agent.standalone = patch.standalone;
+        applied.standalone = cfg.agent.standalone;
+    }
+    return applied;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/facets.d.ts

@@ -0,0 +1,62 @@
+import type { Frontmatter } from './frontmatter.ts';
+/** Keys that are shown on the card, not used as filters. */
+export declare const NOT_FACETS: Set<string>;
+/** How many values before a control stops being useful. */
+export declare const LIMITS: {
+    readonly radio: 8;
+    readonly select: 300;
+    readonly checkboxes: 50;
+};
+export type Control = 'radio' | 'select' | 'checkboxes' | null;
+export interface FacetValue {
+    value: string;
+    count: number;
+}
+export interface Facet {
+    key: string;
+    kind: 'string' | 'array';
+    control: Exclude<Control, null>;
+    values: FacetValue[];
+}
+export declare function controlFor(isArray: boolean, cardinality: number): Control;
+export interface FacetRoom {
+    fields?: Frontmatter;
+    deprecated?: boolean;
+}
+/** Build filter facets from the rooms' merged frontmatter. */
+export declare function buildFacets(rooms: Array<FacetRoom | null | undefined>): Facet[];
+export declare function normalize(value: unknown): string;
+export type Filters = Record<string, string[] | undefined>;
+/** Keep a room when every chosen facet matches (OR within a facet). */
+export declare function matchesFilters(room: {
+    fields?: Frontmatter;
+} | null | undefined, filters?: Filters): boolean;
+/** Markdown markers read as noise in a one-line excerpt. */
+export declare function plainMarkdown(text: unknown): string;
+export interface Snippet {
+    line: number;
+    text: string;
+}
+/** A short excerpt around the first match, with its line number in the body. */
+export declare function snippet(text: string | null | undefined, tokens: string[] | null | undefined, radius?: number): Snippet | null;
+export interface SearchRoom {
+    name: string;
+    title: string;
+    summary: string | null;
+    tags: string[];
+    keyPoints: string[];
+    bodyText: string;
+}
+export interface SearchHit {
+    name: string;
+    score: number;
+    snippets: Snippet[];
+}
+/**
+ * Full-text search over title, summary, tags, key points and the docs' bodies.
+ * Every token must appear somewhere (AND); scoring only decides the order.
+ */
+export declare function searchRooms(rooms: SearchRoom[] | null | undefined, query: string | null | undefined, { limit }?: {
+    limit?: number;
+}): SearchHit[];
+//# sourceMappingURL=facets.d.ts.map

package/dist/lib/facets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.d.ts","sourceRoot":"","sources":["../../lib/facets.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,kBAAkB,CAAC;AAEtE,4DAA4D;AAC5D,eAAO,MAAM,UAAU,aAQrB,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,MAAM;aAAK,KAAK,EAAE,CAAC;aAAE,MAAM,EAAE,GAAG;aAAE,UAAU,EAAE,EAAE;CAAW,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,IAAI,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAKzE;AAKD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,KAAK,EAAE,CAqC/E;AASD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAE3D,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,EACjD,OAAO,GAAE,OAAY,GACpB,OAAO,CAUT;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAWnD;AAID,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EACnC,MAAM,SAAS,GACd,OAAO,GAAG,IAAI,CAsBhB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAUD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,GAAG,SAAS,EACtC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,EAAE,KAAW,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,SAAS,EAAE,CA6Bb"}

package/dist/lib/facets.js

@@ -0,0 +1,181 @@
+// modelroom — facets and search
+//
+// The dashboard's controls are not configured: they are derived from the records.
+// A string becomes a radio group or a select (unique values, with counts); a list
+// becomes checkboxes. Values are free — a facet shows what exists, it does not
+// decide what is allowed.
+/** Keys that are shown on the card, not used as filters. */
+export const NOT_FACETS = new Set([
+    'id',
+    'title',
+    'summary',
+    'key_points',
+    'updated_at',
+    'superseded_by',
+    'deprecated',
+]);
+/** How many values before a control stops being useful. */
+export const LIMITS = { radio: 8, select: 300, checkboxes: 50 };
+export function controlFor(isArray, cardinality) {
+    if (isArray)
+        return cardinality <= LIMITS.checkboxes ? 'checkboxes' : null;
+    if (cardinality <= LIMITS.radio)
+        return 'radio';
+    if (cardinality <= LIMITS.select)
+        return 'select';
+    return null;
+}
+const cmp = (a, b) => b.count - a.count || String(a.value).localeCompare(String(b.value), 'ja');
+/** Build filter facets from the rooms' merged frontmatter. */
+export function buildFacets(rooms) {
+    const values = new Map();
+    const arrays = new Map();
+    for (const room of rooms) {
+        if (!room || room.deprecated)
+            continue;
+        for (const [key, value] of Object.entries(room.fields ?? {})) {
+            if (NOT_FACETS.has(key) || value === null || value === undefined)
+                continue;
+            const list = Array.isArray(value) ? value : [value];
+            if (!list.length)
+                continue;
+            if (!values.has(key))
+                values.set(key, new Map());
+            const counts = values.get(key);
+            for (const v of list) {
+                if (v === null || v === undefined || typeof v === 'object')
+                    continue;
+                const s = String(v);
+                counts.set(s, (counts.get(s) ?? 0) + 1);
+            }
+            if (Array.isArray(value))
+                arrays.set(key, true);
+        }
+    }
+    const facets = [];
+    for (const [key, counts] of values) {
+        const entries = [...counts].map(([value, count]) => ({ value, count })).sort(cmp);
+        const isArray = Boolean(arrays.get(key));
+        const control = controlFor(isArray, entries.length);
+        if (!control || entries.length < 2)
+            continue;
+        facets.push({ key, kind: isArray ? 'array' : 'string', control, values: entries });
+    }
+    // status first, then tags, then the narrowest facets.
+    const rank = (key) => (key === 'status' ? 0 : key === 'tags' ? 1 : 2);
+    facets.sort((a, b) => rank(a.key) - rank(b.key) || a.values.length - b.values.length || a.key.localeCompare(b.key));
+    return facets;
+}
+/** Stringify only primitives; objects and arrays have no text form. */
+function primitive(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return '';
+}
+export function normalize(value) {
+    return primitive(value).normalize('NFKC').toLowerCase();
+}
+/** Keep a room when every chosen facet matches (OR within a facet). */
+export function matchesFilters(room, filters = {}) {
+    for (const [key, wanted] of Object.entries(filters)) {
+        if (!wanted || !wanted.length)
+            continue;
+        const raw = room?.fields?.[key];
+        const have = (Array.isArray(raw) ? raw : [raw])
+            .filter((v) => v !== null && v !== undefined)
+            .map((v) => String(v));
+        if (!have.some((v) => wanted.includes(v)))
+            return false;
+    }
+    return true;
+}
+/** Markdown markers read as noise in a one-line excerpt. */
+export function plainMarkdown(text) {
+    return primitive(text)
+        .replace(/```[\s\S]*?```/g, ' ')
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, '')
+        .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1')
+        .replace(/^#{1,6}\s+/gm, '')
+        .replace(/^\s*[-*+]\s+/gm, '')
+        .replace(/^\s*>\s?/gm, '')
+        .replace(/\*\*([^*]+)\*\*/g, '$1')
+        .replace(/__([^_]+)__/g, '$1')
+        .replace(/`([^`]+)`/g, '$1');
+}
+const RADIUS = 60;
+/** A short excerpt around the first match, with its line number in the body. */
+export function snippet(text, tokens, radius = RADIUS) {
+    const src = String(text ?? '');
+    if (!src.trim() || !tokens?.length)
+        return null;
+    const hay = src.toLowerCase();
+    let at = -1;
+    let len = 0;
+    for (const token of tokens) {
+        const i = hay.indexOf(String(token).toLowerCase());
+        if (i !== -1 && (at === -1 || i < at)) {
+            at = i;
+            len = String(token).length;
+        }
+    }
+    if (at === -1)
+        return null;
+    const start = Math.max(0, at - radius);
+    const end = Math.min(src.length, at + len + radius);
+    const line = src.slice(0, at).split('\n').length;
+    const clean = plainMarkdown(src.slice(start, end)).replace(/\s+/g, ' ').trim();
+    return {
+        line,
+        text: `${start > 0 ? '…' : ''}${clean}${end < src.length ? '…' : ''}`,
+    };
+}
+function snippetsFor(room, tokens) {
+    for (const source of [room.bodyText, room.summary, room.title]) {
+        const hit = snippet(source, tokens);
+        if (hit)
+            return [hit];
+    }
+    return [];
+}
+/**
+ * Full-text search over title, summary, tags, key points and the docs' bodies.
+ * Every token must appear somewhere (AND); scoring only decides the order.
+ */
+export function searchRooms(rooms, query, { limit = 200 } = {}) {
+    const q = String(query ?? '').trim();
+    if (!q)
+        return [];
+    const tokens = normalize(q).split(/\s+/).filter(Boolean);
+    if (!tokens.length)
+        return [];
+    const hits = [];
+    for (const room of rooms ?? []) {
+        const title = normalize(room.title);
+        const summary = normalize(room.summary);
+        const tags = normalize((room.tags ?? []).join(' '));
+        const points = normalize((room.keyPoints ?? []).join(' '));
+        const body = normalize(room.bodyText);
+        const all = [title, summary, tags, points, body].join('\n');
+        if (!tokens.every((t) => all.includes(t)))
+            continue;
+        let score = 0;
+        for (const t of tokens) {
+            if (title.includes(t))
+                score += 5;
+            if (summary.includes(t))
+                score += 3;
+            if (tags.includes(t))
+                score += 3;
+            if (points.includes(t))
+                score += 2;
+            if (body.includes(t))
+                score += 1;
+        }
+        hits.push({ name: room.name, score, snippets: snippetsFor(room, tokens) });
+    }
+    hits.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+    return hits.slice(0, limit);
+}
+//# sourceMappingURL=facets.js.map

package/dist/lib/facets.js.map

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

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,41 @@
+export declare const HEAD_BYTES = 8192;
+export type FrontmatterValue = string | number | boolean | null | FrontmatterValue[];
+export type Frontmatter = Record<string, FrontmatterValue>;
+export interface FrontmatterIssue {
+    code: string;
+    key?: string | null;
+    message: string;
+}
+export interface ParsedDocument {
+    hasFrontmatter: boolean;
+    data: Frontmatter;
+    body: string;
+    issues: FrontmatterIssue[];
+}
+export interface SplitResult {
+    raw: string | null;
+    body: string;
+    error: string | null;
+}
+/** Split `text` into raw frontmatter and body. */
+export declare function splitFrontmatter(text: string | null | undefined): SplitResult;
+/** One scalar: quoted string, inline list, boolean, null, number, or string. */
+export declare function parseScalar(raw: string | null | undefined): FrontmatterValue;
+/** Parse the flat YAML subset. Returns `{ data, issues }`. */
+export declare function parseYamlLite(raw: string | null | undefined): {
+    data: Frontmatter;
+    issues: FrontmatterIssue[];
+};
+/** Parse a whole document: frontmatter + body. */
+export declare function parseFrontmatter(text: string | null | undefined): ParsedDocument;
+export interface FrontmatterRead extends ParsedDocument {
+    source: 'head' | 'full';
+}
+/**
+ * Read a doc's frontmatter without reading the whole file.
+ * `source` is 'head' when the frontmatter fit in the first `head` bytes.
+ */
+export declare function readFrontmatterFile(path: string, { head }?: {
+    head?: number;
+}): Promise<FrontmatterRead>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/lib/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../lib/frontmatter.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,UAAU,OAAO,CAAC;AAI/B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,gBAAgB,EAAE,CAAC;AACrF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAY7E;AA4DD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,CAe5E;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IAC7D,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B,CAgEA;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAchF;AAMD,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,EAAE,IAAiB,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,OAAO,CAAC,eAAe,CAAC,CAc1B"}