pi-soly 0.2.1

package/docs.ts

@@ -0,0 +1,235 @@
+// =============================================================================
+// docs.ts — Doc search + snippet tools support
+// =============================================================================
+//
+// Lazy context helpers:
+//   - searchDocs(query, cwd) — index of all .md files (one-line descriptions),
+//     matches by simple substring scoring
+//   - readSnippet(path, offset, limit) — bounded file read for soly_snippet
+// =============================================================================
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { estimateTokens, findMarkdownFiles, readIfExists } from "./core.js";
+import { extractTitleAndPreview, stripHtml } from "./html.js";
+
+// Re-export the stripHtml helper so existing imports of `stripHtml from
+// "./docs.js"` (used by tools.ts) continue to work without churn.
+export { stripHtml };
+
+export interface DocIndexEntry {
+	relPath: string;
+	absPath: string;
+	tokens: number;
+	title: string;
+	preview: string;
+	/** Priority bucket: 0=intent, 1=phase-intent, 2=project. Used in search ranking. */
+	sourceKind: "intent" | "phase-intent" | "project";
+}
+
+const DOC_GLOBS_IGNORE = [
+	"node_modules",
+	"dist",
+	"build",
+	"coverage",
+	".git",
+	"out",
+	".next",
+	".nuxt",
+	"target", // rust
+	"__pycache__",
+	".venv",
+	"venv",
+];
+
+// .soly/ IS indexed, but intent docs in .soly/docs/ and .soly/phases/<N>/docs/
+// are tagged with higher priority in search results (see buildDocIndex).
+
+const INTENT_DOC_EXTS = [".md", ".html", ".htm"];
+
+/** Build an index of all .md / .html files under cwd, excluding noisy dirs. */
+export function buildDocIndex(cwd: string, limit = 5000): DocIndexEntry[] {
+	const mdFiles = findMarkdownFiles(cwd);
+	const out: DocIndexEntry[] = [];
+	const seen = new Set<string>();
+
+	const addFile = (relPath: string, absPath: string, sourceKind: DocIndexEntry["sourceKind"]) => {
+		if (seen.has(relPath)) return;
+		seen.add(relPath);
+		const raw = readIfExists(absPath);
+		if (!raw) return;
+		const ext = path.extname(relPath).toLowerCase();
+		if (ext !== ".md" && ext !== ".html" && ext !== ".htm") return;
+		const { title, preview } = extractTitleAndPreview(raw, ext);
+		out.push({
+			relPath,
+			absPath,
+			tokens: estimateTokens(raw),
+			title,
+			preview,
+			sourceKind,
+		});
+	};
+
+	// 1. Intent docs (priority 0)
+	const docsRoot = path.join(cwd, ".soly", "docs");
+	if (fs.existsSync(docsRoot)) {
+		const intentFiles = findIntentFiles(docsRoot);
+		for (const f of intentFiles) {
+			const rel = path.relative(cwd, f);
+			addFile(rel, f, "intent");
+			if (out.length >= limit) break;
+		}
+	}
+
+	// 2. Phase intent docs (priority 1) — only if phases dir exists
+	const phasesRoot = path.join(cwd, ".soly", "phases");
+	if (out.length < limit && fs.existsSync(phasesRoot)) {
+		try {
+			const phaseEntries = fs.readdirSync(phasesRoot, { withFileTypes: true });
+			for (const pe of phaseEntries) {
+				if (!pe.isDirectory()) continue;
+				const phaseDocsDir = path.join(phasesRoot, pe.name, "docs");
+				if (fs.existsSync(phaseDocsDir)) {
+					const phaseFiles = findIntentFiles(phaseDocsDir);
+					for (const f of phaseFiles) {
+						const rel = path.relative(cwd, f);
+						addFile(rel, f, "phase-intent");
+						if (out.length >= limit) break;
+					}
+				}
+				if (out.length >= limit) break;
+			}
+		} catch {
+			// best effort
+		}
+	}
+
+	// 3. Rest of project (priority 2)
+	if (out.length < limit) {
+		for (const relPath of mdFiles) {
+			const segments = relPath.split("/");
+			if (segments.some((s) => DOC_GLOBS_IGNORE.includes(s))) continue;
+			const absPath = path.join(cwd, relPath);
+			addFile(relPath, absPath, "project");
+			if (out.length >= limit) break;
+		}
+	}
+
+	return out;
+}
+
+function findIntentFiles(dir: string): string[] {
+	const out: string[] = [];
+	if (!fs.existsSync(dir)) return out;
+	let entries: fs.Dirent[];
+	try {
+		entries = fs.readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return out;
+	}
+	for (const e of entries) {
+		if (e.name.startsWith(".")) continue;
+		const full = path.join(dir, e.name);
+		if (e.isDirectory()) {
+			out.push(...findIntentFiles(full));
+		} else if (e.isFile()) {
+			const ext = path.extname(e.name).toLowerCase();
+			if (INTENT_DOC_EXTS.includes(ext)) {
+				out.push(full);
+			}
+		}
+	}
+	return out;
+}
+
+export interface DocSearchHit {
+	entry: DocIndexEntry;
+	score: number;
+	/** Substring excerpts where the query matched (up to 3). */
+	excerpts: string[];
+	/** Source-priority bonus applied (intent > phase-intent > project). */
+	priorityBonus: number;
+}
+
+const SOURCE_PRIORITY_BONUS: Record<DocIndexEntry["sourceKind"], number> = {
+	intent: 5,
+	"phase-intent": 3,
+	project: 0,
+};
+
+const SOURCE_TAG: Record<DocIndexEntry["sourceKind"], string> = {
+	intent: "[intent]",
+	"phase-intent": "[phase-intent]",
+	project: "[project]",
+};
+
+/**
+ * Search the doc index by substring scoring.
+ * Title matches outscore body matches 3:1. Case-insensitive.
+ * Intent docs are prioritized over project docs (source-priority bonus).
+ */
+export function searchDocs(index: DocIndexEntry[], query: string, limit = 10): DocSearchHit[] {
+	const q = query.trim().toLowerCase();
+	if (!q) return [];
+	const tokens = q.split(/\s+/).filter(Boolean);
+	const hits: DocSearchHit[] = [];
+
+	for (const entry of index) {
+		const titleLower = entry.title.toLowerCase();
+		const previewLower = entry.preview.toLowerCase();
+		const relPathLower = entry.relPath.toLowerCase();
+
+		let score = 0;
+		const excerpts: string[] = [];
+
+		for (const t of tokens) {
+			if (titleLower.includes(t)) score += 3;
+			if (relPathLower.includes(t)) score += 2;
+			const previewMatches = previewLower.split(t).length - 1;
+			if (previewMatches > 0) {
+				score += previewMatches;
+				const idx = previewLower.indexOf(t);
+				if (idx >= 0 && excerpts.length < 3) {
+					const start = Math.max(0, idx - 40);
+					const end = Math.min(entry.preview.length, idx + t.length + 60);
+					excerpts.push(
+						(start > 0 ? "…" : "") + entry.preview.slice(start, end) + (end < entry.preview.length ? "…" : ""),
+					);
+				}
+			}
+		}
+
+		if (score > 0) {
+			const priorityBonus = SOURCE_PRIORITY_BONUS[entry.sourceKind];
+			hits.push({ entry, score: score + priorityBonus, excerpts, priorityBonus });
+		}
+	}
+
+	hits.sort((a, b) => b.score - a.score);
+	return hits.slice(0, limit);
+}
+
+/** Helper: source tag for a DocIndexEntry (used in search output). */
+export function sourceTag(entry: DocIndexEntry): string {
+	return SOURCE_TAG[entry.sourceKind];
+}
+
+/** Bounded file read with line numbers, for soly_snippet. */
+export function readSnippet(
+	absPath: string,
+	offset = 0,
+	limit = 100,
+): { lines: string[]; totalLines: number; outOfRange: boolean } | null {
+	const raw = readIfExists(absPath);
+	if (raw === null) return null;
+	const allLines = raw.split(/\r?\n/);
+	const start = Math.max(0, offset);
+	const end = Math.min(allLines.length, start + limit);
+	return {
+		lines: allLines.slice(start, end),
+		totalLines: allLines.length,
+		outOfRange: end < allLines.length,
+	};
+}
+

package/env.ts

@@ -0,0 +1,196 @@
+// =============================================================================
+// env.ts — Project environment summary for the soly extension
+// =============================================================================
+//
+// Detects the project's runtime environment: package manager, node/bun
+// version, key dependencies, and common services (postgres, redis, etc.).
+// Used by the `soly_env` tool and injected into the system prompt as a
+// short "## project env" section.
+//
+// All detection is best-effort. Missing files just skip their block.
+// =============================================================================
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+interface PackageJson {
+	name?: string;
+	version?: string;
+	private?: boolean;
+	type?: string;
+	scripts?: Record<string, string>;
+	dependencies?: Record<string, string>;
+	devDependencies?: Record<string, string>;
+	engines?: Record<string, string>;
+	packageManager?: string;
+	workspaces?: string[] | { packages?: string[] };
+}
+
+export interface EnvSummary {
+	projectName: string | null;
+	projectVersion: string | null;
+	runtimes: string[];
+	packageManager: string | null;
+	mainDependencies: string[]; // up to 8 most relevant
+	scripts: string[]; // up to 6 most common
+	services: string[];
+	hasTypeScript: boolean;
+	hasTests: boolean;
+	hasDocker: boolean;
+	hasCI: boolean;
+}
+
+/** Heuristic: which top-level deps look "main" rather than "peripheral". */
+const MAIN_DEP_HINTS = [
+	"react", "vue", "svelte", "next", "nuxt", "remix", "astro",
+	"express", "fastify", "koa", "hapi", "nestjs",
+	"prisma", "drizzle-orm", "typeorm", "sequelize", "mongoose",
+	"@earendil-works/pi-coding-agent", "@earendil-works/pi-ai",
+	"typescript", "zod", "typebox",
+	"tailwindcss", "@radix-ui/react",
+];
+
+const COMMON_SCRIPTS = [
+	"dev", "build", "start", "test", "lint", "typecheck", "format", "check",
+];
+
+function readJsonSafe<T>(p: string): T | null {
+	try {
+		return JSON.parse(fs.readFileSync(p, "utf-8")) as T;
+	} catch {
+		return null;
+	}
+}
+
+function readFirstLine(p: string): string | null {
+	try {
+		const content = fs.readFileSync(p, "utf-8");
+		const first = content.split(/\r?\n/)[0]?.trim() ?? "";
+		return first || null;
+	} catch {
+		return null;
+	}
+}
+
+export function detectEnv(cwd: string): EnvSummary {
+	const out: EnvSummary = {
+		projectName: null,
+		projectVersion: null,
+		runtimes: [],
+		packageManager: null,
+		mainDependencies: [],
+		scripts: [],
+		services: [],
+		hasTypeScript: false,
+		hasTests: false,
+		hasDocker: false,
+		hasCI: false,
+	};
+
+	// package.json
+	const pkg = readJsonSafe<PackageJson>(path.join(cwd, "package.json"));
+	if (pkg) {
+		out.projectName = pkg.name ?? null;
+		out.projectVersion = pkg.version ?? null;
+		if (pkg.packageManager) out.packageManager = pkg.packageManager;
+
+		// Engines
+		if (pkg.engines) {
+			for (const [k, v] of Object.entries(pkg.engines)) {
+				out.runtimes.push(`${k} ${v}`);
+			}
+		}
+
+		// Main dependencies — prefer hints, then top-level deps
+		const allDeps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+		const hinted = MAIN_DEP_HINTS.filter((h) => allDeps[h]).slice(0, 8);
+		out.mainDependencies = hinted;
+
+		// Scripts — only those in COMMON_SCRIPTS
+		if (pkg.scripts) {
+			out.scripts = COMMON_SCRIPTS.filter((s) => pkg.scripts?.[s]).slice(0, 6);
+		}
+
+		// Has TypeScript?
+		out.hasTypeScript = "typescript" in allDeps || fs.existsSync(path.join(cwd, "tsconfig.json"));
+		// Has tests?
+		out.hasTests =
+			"vitest" in allDeps ||
+			"jest" in allDeps ||
+			"mocha" in allDeps ||
+			"@playwright/test" in allDeps ||
+			fs.existsSync(path.join(cwd, "tests")) ||
+			fs.existsSync(path.join(cwd, "__tests__"));
+	}
+
+	// Has Docker?
+	out.hasDocker =
+		fs.existsSync(path.join(cwd, "Dockerfile")) ||
+		fs.existsSync(path.join(cwd, "docker-compose.yml")) ||
+		fs.existsSync(path.join(cwd, "docker-compose.yaml"));
+
+	// Has CI?
+	const ciDirs = [".github/workflows", ".gitlab-ci.yml", ".circleci", ".buildkite"];
+	out.hasCI = ciDirs.some((d) => fs.existsSync(path.join(cwd, d)));
+
+	// Services — scan compose file for known service names
+	const composeFile =
+		fs.existsSync(path.join(cwd, "docker-compose.yml"))
+			? path.join(cwd, "docker-compose.yml")
+			: fs.existsSync(path.join(cwd, "docker-compose.yaml"))
+				? path.join(cwd, "docker-compose.yaml")
+				: null;
+	if (composeFile) {
+		try {
+			const text = fs.readFileSync(composeFile, "utf-8");
+			const serviceHints = ["postgres", "redis", "mysql", "mongo", "rabbitmq", "kafka", "nginx", "traefik"];
+			out.services = serviceHints.filter((s) => new RegExp(`\\b${s}\\b`, "i").test(text));
+		} catch {
+			// ignore
+		}
+	}
+
+	// .nvmrc / .node-version / .tool-versions
+	const nvmrc = readFirstLine(path.join(cwd, ".nvmrc"));
+	if (nvmrc) out.runtimes.push(`node ${nvmrc}`);
+	const toolVersions = readFirstLine(path.join(cwd, ".tool-versions"));
+	if (toolVersions) out.runtimes.push(`asdf ${toolVersions.replace(/\s+/g, " ")}`);
+
+	return out;
+}
+
+/** Short env section to inject into the system prompt. */
+export function buildEnvSection(env: EnvSummary): string {
+	if (!env.projectName && env.runtimes.length === 0 && !env.packageManager) {
+		return "";
+	}
+
+	const lines: string[] = ["", "## project env", ""];
+	if (env.projectName) {
+		lines.push(`- **name**: ${env.projectName}${env.projectVersion ? ` @ ${env.projectVersion}` : ""}`);
+	}
+	if (env.packageManager) {
+		lines.push(`- **package manager**: ${env.packageManager}`);
+	}
+	if (env.runtimes.length > 0) {
+		lines.push(`- **runtimes**: ${env.runtimes.join(", ")}`);
+	}
+	if (env.mainDependencies.length > 0) {
+		lines.push(`- **key deps**: ${env.mainDependencies.join(", ")}`);
+	}
+	if (env.scripts.length > 0) {
+		lines.push(`- **scripts**: \`${env.scripts.join("`, `")}\``);
+	}
+	const flags: string[] = [];
+	if (env.hasTypeScript) flags.push("ts");
+	if (env.hasTests) flags.push("tests");
+	if (env.hasDocker) flags.push("docker");
+	if (env.hasCI) flags.push("ci");
+	if (flags.length > 0) {
+		lines.push(`- **tooling**: ${flags.join(", ")}`);
+	}
+	if (env.services.length > 0) {
+		lines.push(`- **services**: ${env.services.join(", ")}`);
+	}
+	return lines.join("\n");
+}

package/git.ts

@@ -0,0 +1,95 @@
+// =============================================================================
+// git.ts — Git context provider for the soly extension
+// =============================================================================
+//
+// Reads current git state (branch, status, last 5 commits) and renders a
+// short section to inject into the system prompt. The model gets immediate
+// awareness of what's changed recently and what's uncommitted.
+//
+// All git calls go through `git ...` with a 2s timeout. Failures are silent
+// (no git, not a repo, no network) — the section just doesn't render.
+// =============================================================================
+
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+const TIMEOUT_MS = 2000;
+
+interface GitResult {
+	ok: boolean;
+	stdout: string;
+}
+
+async function safeGit(args: string[], cwd: string): Promise<GitResult> {
+	try {
+		const { stdout } = await execFileAsync("git", args, {
+			cwd,
+			timeout: TIMEOUT_MS,
+			maxBuffer: 64 * 1024,
+			encoding: "utf-8",
+		});
+		return { ok: true, stdout: stdout.trim() };
+	} catch {
+		return { ok: false, stdout: "" };
+	}
+}
+
+export interface GitContext {
+	available: boolean;
+	branch: string | null;
+	statusShort: string | null;
+	lastCommits: string[];
+}
+
+/** Read git state. Returns `available: false` if git is missing / not a repo. */
+export async function readGitContext(cwd: string): Promise<GitContext> {
+	const branch = await safeGit(["rev-parse", "--abbrev-ref", "HEAD"], cwd);
+	if (!branch.ok) {
+		return { available: false, branch: null, statusShort: null, lastCommits: [] };
+	}
+	const [status, log] = await Promise.all([
+		safeGit(["status", "--short"], cwd),
+		safeGit(["log", "--oneline", "-5", "--no-decorate"], cwd),
+	]);
+	return {
+		available: true,
+		branch: branch.stdout || null,
+		statusShort: status.ok ? status.stdout : null,
+		lastCommits: log.ok && log.stdout ? log.stdout.split(/\r?\n/).filter(Boolean) : [],
+	};
+}
+
+/** Render a short git section to inject into the system prompt. */
+export function buildGitSection(ctx: GitContext): string {
+	if (!ctx.available) return "";
+
+	const lines: string[] = ["", "## current git state", ""];
+	lines.push(`- **branch**: ${ctx.branch ?? "(detached)"}`);
+
+	if (ctx.statusShort !== null) {
+		if (ctx.statusShort === "") {
+			lines.push("- **working tree**: clean");
+		} else {
+			const changed = ctx.statusShort.split(/\r?\n/).filter(Boolean);
+			lines.push(`- **working tree**: ${changed.length} changed file(s)`);
+			// Inline first 10 for visibility — full list available via `soly diff`
+			for (const c of changed.slice(0, 10)) {
+				lines.push(`  - ${c}`);
+			}
+			if (changed.length > 10) {
+				lines.push(`  - ... and ${changed.length - 10} more (run \`soly diff\` for full)`);
+			}
+		}
+	}
+
+	if (ctx.lastCommits.length > 0) {
+		lines.push("- **recent commits**:");
+		for (const c of ctx.lastCommits.slice(0, 5)) {
+			lines.push(`  - ${c}`);
+		}
+	}
+
+	return lines.join("\n");
+}

package/html.ts

@@ -0,0 +1,157 @@
+// =============================================================================
+// html.ts — Shared HTML utilities (shared between intent and docs loaders)
+// =============================================================================
+//
+// Single source of truth for parsing `.html`/`.htm` intent docs and for
+// stripping HTML tags from arbitrary text. Previously duplicated in
+// intent.ts and docs.ts — extracting here lets the test suite cover
+// one parser instead of two, and prevents drift.
+//
+// Public API:
+//   - stripHtml(html)              — strip tags + decode common entities
+//   - extractHtmlMeta(html)        — pull <title> / <h1> / <meta description>
+//   - extractTitleAndPreview(raw, ext, opts?) — unified .md / .html frontmatter
+//
+// All functions are pure (no I/O) — they accept a string and return
+// a string (or a small object). They never read the filesystem.
+// =============================================================================
+
+const HTML_TAG_RE = /<[^>]+>/g;
+const HTML_STYLE_RE = /<style[\s\S]*?<\/style>/gi;
+const HTML_SCRIPT_RE = /<script[\s\S]*?<\/script>/gi;
+const HTML_COMMENT_RE = /<!--[\s\S]*?-->/g;
+const HTML_TITLE_RE = /<title[^>]*>([\s\S]*?)<\/title>/i;
+const HTML_H1_RE = /<h1[^>]*>([\s\S]*?)<\/h1>/i;
+const HTML_META_DESC_RE = /<meta\s+name=["']description["']\s+content=["']([^"']+)["']/i;
+
+// Markdown frontmatter (YAML-ish). Captures: [1] body after the closing `---`.
+const MD_FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?([\s\S]*)$/;
+
+/** Strip just the tags (used internally for title/description extraction). */
+function stripTags(html: string): string {
+  return html
+    .replace(HTML_STYLE_RE, " ")
+    .replace(HTML_SCRIPT_RE, " ")
+    .replace(HTML_COMMENT_RE, " ")
+    .replace(HTML_TAG_RE, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+/** Strip HTML tags and decode common entities. Whitespace is collapsed. */
+export function stripHtml(html: string): string {
+  return stripTags(html)
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'");
+}
+
+export interface HtmlMeta {
+  title: string;
+  description: string;
+}
+
+/**
+ * Extract `<title>` / `<h1>` (fallback) / `<meta name="description">` from a
+ * raw HTML document. Entities in the extracted text are decoded. Title is
+ * capped at 200 chars, description at 300.
+ */
+export function extractHtmlMeta(html: string): HtmlMeta {
+  const titleMatch = html.match(HTML_TITLE_RE);
+  const h1Match = html.match(HTML_H1_RE);
+  const metaMatch = html.match(HTML_META_DESC_RE);
+  const title =
+    (titleMatch?.[1] ? stripHtml(titleMatch[1]) : "") ||
+    (h1Match?.[1] ? stripHtml(h1Match[1]) : "");
+  const description = metaMatch?.[1] ? stripHtml(metaMatch[1]) : "";
+  return {
+    title: title.slice(0, 200),
+    description: description.slice(0, 300),
+  };
+}
+
+export interface ExtractedDoc {
+  title: string;
+  preview: string;
+}
+
+/**
+ * Unified title + preview extractor for both `.md` and `.html`/`.htm` files.
+ * Markdown path strips YAML frontmatter, picks the first H1 (or first non-blank
+ * non-code-fence line as fallback), and joins non-heading non-code paragraphs.
+ * HTML path delegates to `extractHtmlMeta` + `stripHtml`.
+ *
+ * @param raw   Full file content
+ * @param ext   Lowercase file extension, e.g. ".md", ".html", ".htm"
+ * @param opts  `maxPreview` caps the preview string (default 200)
+ */
+export function extractTitleAndPreview(
+  raw: string,
+  ext: ".md" | ".html" | ".htm",
+  opts: { maxPreview?: number } = {},
+): ExtractedDoc {
+  const maxPreview = opts.maxPreview ?? 200;
+  if (ext === ".html" || ext === ".htm") {
+    const { title, description } = extractHtmlMeta(raw);
+    return {
+      title: title.slice(0, 120),
+      preview: description || stripHtml(raw).slice(0, maxPreview),
+    };
+  }
+
+  // Markdown path
+  const fmMatch = raw.match(MD_FRONTMATTER_RE);
+  const body = fmMatch ? fmMatch[1] : raw;
+  const lines = body.split(/\r?\n/);
+
+  // Strip fenced code blocks (``` ... ```) so we don't pull in code as the
+  // title or as part of the preview body. Track open/close state across
+  // lines: a fence opens, everything until the matching close is skipped.
+  const stripCodeBlocks = (input: string[]): string[] => {
+    const out: string[] = [];
+    let inFence = false;
+    for (const l of input) {
+      const trimmed = l.trim();
+      if (trimmed.startsWith("```")) {
+        inFence = !inFence;
+        continue; // skip the fence line itself
+      }
+      if (inFence) continue;
+      out.push(l);
+    }
+    return out;
+  };
+  const bodyLines = stripCodeBlocks(lines);
+
+  let title = "";
+  for (const l of bodyLines) {
+    const h = l.match(/^#\s+(.+)$/);
+    if (h) {
+      title = h[1].trim();
+      break;
+    }
+  }
+  if (!title) {
+    for (const l of bodyLines) {
+      const t = l.trim();
+      if (t) {
+        title = t;
+        break;
+      }
+    }
+  }
+
+  const meaningful = bodyLines
+    .filter((l) => l.trim() && !l.startsWith("#"))
+    .join(" ")
+    .replace(/\s+/g, " ")
+    .trim();
+
+  return {
+    title: title.slice(0, 120),
+    preview: meaningful.slice(0, maxPreview),
+  };
+}