scribe-cms 0.0.4 → 0.0.6

package/dist/cli/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import path4 from 'path';
-import 'url';
+import { fileURLToPath } from 'url';
 import fs2 from 'fs';
 import Database from 'better-sqlite3';
 import { z } from 'zod';
@@ -56,12 +56,19 @@ function addColumnIfMissing(db, table, column, ddlType) {
     db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${ddlType}`);
   }
 }
+function readSchemaVersion(db) {
+  const row = db.prepare(`SELECT value FROM meta WHERE key = 'schema_version'`).get();
+  return row ? Number.parseInt(row.value, 10) || 0 : 0;
+}
 function migrate(db) {
+  const previousVersion = readSchemaVersion(db);
   for (const sql of MIGRATIONS) {
     db.exec(sql);
   }
-  addColumnIfMissing(db, "revisions", "frontmatter_json", "TEXT");
-  addColumnIfMissing(db, "revisions", "body", "TEXT");
+  if (previousVersion < 4) {
+    db.exec(`DROP TABLE IF EXISTS revisions`);
+  }
+  addColumnIfMissing(db, "translations", "snapshot_id", "INTEGER");
   db.prepare(
     `INSERT INTO meta(key, value) VALUES('schema_version', ?)
      ON CONFLICT(key) DO UPDATE SET value = excluded.value`
@@ -74,7 +81,7 @@ var SCHEMA_VERSION, MIGRATIONS;
 var init_sqlite = __esm({
   "src/storage/sqlite.ts"() {
     init_esm_shims();
-    SCHEMA_VERSION = 3;
+    SCHEMA_VERSION = 4;
     MIGRATIONS = [
       `CREATE TABLE IF NOT EXISTS meta (
     key TEXT PRIMARY KEY,
@@ -94,20 +101,6 @@ var init_sqlite = __esm({
   )`,
       `CREATE INDEX IF NOT EXISTS idx_translations_type_locale
     ON translations(content_type, locale)`,
-      `CREATE TABLE IF NOT EXISTS revisions (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    content_type TEXT NOT NULL,
-    en_slug TEXT NOT NULL,
-    locale TEXT,
-    revision_kind TEXT NOT NULL,
-    en_hash TEXT NOT NULL,
-    body_hash TEXT NOT NULL,
-    created_at TEXT NOT NULL,
-    model TEXT,
-    body_preview TEXT
-  )`,
-      `CREATE INDEX IF NOT EXISTS idx_revisions_lookup
-    ON revisions(content_type, en_slug, locale, created_at DESC)`,
       `CREATE TABLE IF NOT EXISTS slug_aliases (
     content_type TEXT NOT NULL,
     canonical_en_slug TEXT NOT NULL,
@@ -124,7 +117,19 @@ var init_sqlite = __esm({
     locale_slug TEXT NOT NULL,
     captured_at TEXT NOT NULL,
     PRIMARY KEY (content_type, alias_en_slug, locale)
-  )`
+  )`,
+      `CREATE TABLE IF NOT EXISTS en_snapshots (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    content_type TEXT NOT NULL,
+    en_slug TEXT NOT NULL,
+    en_hash TEXT NOT NULL,
+    frontmatter_json TEXT NOT NULL,
+    body TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    UNIQUE (content_type, en_slug, en_hash)
+  )`,
+      `CREATE INDEX IF NOT EXISTS idx_en_snapshots_lookup
+    ON en_snapshots(content_type, en_slug, created_at DESC)`
     ];
   }
 });
@@ -218,14 +223,14 @@ var SLUG_PLACEHOLDER = "{slug}";
 function isRoutableType(type) {
   return typeof type.path === "string" && type.path.length > 0;
 }
-function assertValidPathTemplate(path12, typeId) {
-  if (!path12.startsWith("/")) {
-    throw new Error(`Content type "${typeId}": path must start with / (got "${path12}")`);
+function assertValidPathTemplate(path14, typeId) {
+  if (!path14.startsWith("/")) {
+    throw new Error(`Content type "${typeId}": path must start with / (got "${path14}")`);
   }
-  const count = (path12.match(/\{slug\}/g) ?? []).length;
+  const count = (path14.match(/\{slug\}/g) ?? []).length;
   if (count !== 1) {
     throw new Error(
-      `Content type "${typeId}": path must contain exactly one {slug} (got "${path12}")`
+      `Content type "${typeId}": path must contain exactly one {slug} (got "${path14}")`
     );
   }
 }
@@ -277,6 +282,7 @@ function resolveConfig(input, baseDir) {
   const projectRoot = path4.resolve(baseDir ?? process.cwd(), raw.rootDir);
   const contentRoot = path4.resolve(projectRoot, raw.contentDir ?? "content");
   const storePath = path4.resolve(projectRoot, raw.store ?? ".scribe/store.sqlite");
+  const assetsPath = raw.assetsDir ? path4.resolve(projectRoot, raw.assetsDir) : void 0;
   const seenIds = /* @__PURE__ */ new Set();
   const types = raw.types.map((type) => {
     if (seenIds.has(type.id)) {
@@ -297,6 +303,7 @@ function resolveConfig(input, baseDir) {
   const config = {
     rootDir: contentRoot,
     storePath,
+    assetsPath,
     locales: [...raw.locales],
     defaultLocale,
     localePresets: raw.localePresets,
@@ -353,10 +360,10 @@ function introspectSchema(schema, prefix = []) {
 }
 function extractByPaths(data, paths) {
   const out = {};
-  for (const path12 of paths) {
-    const value = getAtPath(data, path12);
+  for (const path14 of paths) {
+    const value = getAtPath(data, path14);
     if (value !== void 0) {
-      setAtPath(out, path12.filter((p) => p !== "*"), value);
+      setAtPath(out, path14.filter((p) => p !== "*"), value);
     }
   }
   return out;
@@ -374,13 +381,13 @@ function mergeStructuralOntoLocale(localeData, enData, schema) {
   const translatable = pickTranslatable(localeData, schema);
   return deepMerge(structural, translatable);
 }
-function getAtPath(obj, path12) {
+function getAtPath(obj, path14) {
   let current = obj;
-  for (const segment of path12) {
+  for (const segment of path14) {
     if (segment === "*") {
       if (!Array.isArray(current)) return void 0;
       return current.map(
-        (item) => typeof item === "object" && item !== null ? getAtPath(item, path12.slice(path12.indexOf("*") + 1)) : void 0
+        (item) => typeof item === "object" && item !== null ? getAtPath(item, path14.slice(path14.indexOf("*") + 1)) : void 0
       );
     }
     if (typeof current !== "object" || current === null || Array.isArray(current)) return void 0;
@@ -388,13 +395,13 @@ function getAtPath(obj, path12) {
   }
   return current;
 }
-function setAtPath(obj, path12, value) {
-  if (path12.length === 0) return;
-  if (path12.length === 1) {
-    obj[path12[0]] = value;
+function setAtPath(obj, path14, value) {
+  if (path14.length === 0) return;
+  if (path14.length === 1) {
+    obj[path14[0]] = value;
     return;
   }
-  const [head, ...rest] = path12;
+  const [head, ...rest] = path14;
   if (!(head in obj) || typeof obj[head] !== "object" || obj[head] === null) {
     obj[head] = {};
   }
@@ -596,18 +603,51 @@ init_sqlite();
 
 // src/storage/translations.ts
 init_esm_shims();
+function getOrCreateEnSnapshot(db, input) {
+  db.prepare(
+    `INSERT OR IGNORE INTO en_snapshots (
+      content_type, en_slug, en_hash, frontmatter_json, body, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?)`
+  ).run(
+    input.contentType,
+    input.enSlug,
+    input.enHash,
+    JSON.stringify(input.frontmatter),
+    input.body,
+    input.createdAt
+  );
+  const row = db.prepare(
+    `SELECT id FROM en_snapshots
+       WHERE content_type = ? AND en_slug = ? AND en_hash = ?`
+  ).get(input.contentType, input.enSlug, input.enHash);
+  return row.id;
+}
+function getEnSnapshot(db, snapshotId) {
+  return db.prepare(`SELECT * FROM en_snapshots WHERE id = ?`).get(snapshotId);
+}
+function listEnSnapshotsForEnSlug(db, contentType, enSlug) {
+  return db.prepare(
+    `SELECT s.*, GROUP_CONCAT(t.locale) AS locales
+       FROM en_snapshots s
+       LEFT JOIN translations t ON t.snapshot_id = s.id
+       WHERE s.content_type = ? AND s.en_slug = ?
+       GROUP BY s.id
+       ORDER BY s.created_at DESC, s.id DESC`
+  ).all(contentType, enSlug);
+}
 function upsertTranslation(db, input) {
   db.prepare(
     `INSERT INTO translations (
-      content_type, en_slug, locale, slug, frontmatter_json, body, en_hash, translated_at, model
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      content_type, en_slug, locale, slug, frontmatter_json, body, en_hash, translated_at, model, snapshot_id
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(content_type, en_slug, locale) DO UPDATE SET
       slug = excluded.slug,
       frontmatter_json = excluded.frontmatter_json,
       body = excluded.body,
       en_hash = excluded.en_hash,
       translated_at = excluded.translated_at,
-      model = excluded.model`
+      model = excluded.model,
+      snapshot_id = excluded.snapshot_id`
   ).run(
     input.contentType,
     input.enSlug,
@@ -617,7 +657,8 @@ function upsertTranslation(db, input) {
     input.body,
     input.enHash,
     input.translatedAt,
-    input.model
+    input.model,
+    input.snapshotId
   );
 }
 function getTranslation(db, contentType, enSlug, locale) {
@@ -639,41 +680,6 @@ function listTranslationsForLocale(db, contentType, locale) {
 function bulkLoadTranslations(db) {
   return db.prepare(`SELECT * FROM translations ORDER BY content_type, en_slug, locale`).all();
 }
-function appendRevision(db, input) {
-  const result = db.prepare(
-    `INSERT INTO revisions (
-        content_type, en_slug, locale, revision_kind, en_hash, body_hash, created_at,
-        model, body_preview, frontmatter_json, body
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    input.contentType,
-    input.enSlug,
-    input.locale,
-    input.revisionKind,
-    input.enHash,
-    input.bodyHash,
-    input.createdAt,
-    input.model ?? null,
-    input.bodyPreview ?? null,
-    input.frontmatterJson ?? null,
-    input.body ?? null
-  );
-  return Number(result.lastInsertRowid);
-}
-function listRevisions(db, contentType, enSlug, locale) {
-  if (locale) {
-    return db.prepare(
-      `SELECT * FROM revisions
-         WHERE content_type = ? AND en_slug = ? AND locale = ?
-         ORDER BY created_at DESC, id DESC`
-    ).all(contentType, enSlug, locale);
-  }
-  return db.prepare(
-    `SELECT * FROM revisions
-       WHERE content_type = ? AND en_slug = ?
-       ORDER BY created_at DESC, id DESC`
-  ).all(contentType, enSlug);
-}
 
 // src/loader/normalize-en.ts
 init_esm_shims();
@@ -1466,43 +1472,6 @@ function loadConfigSync(options = {}) {
 
 // src/validate/validate-project.ts
 init_esm_shims();
-
-// src/hash/page-hash.ts
-init_esm_shims();
-function sha256(input) {
-  return createHash("sha256").update(input, "utf8").digest("hex");
-}
-function computePageEnHash(translatableFrontmatter, body) {
-  const payload = JSON.stringify({ frontmatter: translatableFrontmatter, body });
-  return sha256(payload);
-}
-function computeBodyHash(body) {
-  return sha256(body);
-}
-
-// src/history/record-revision.ts
-init_esm_shims();
-init_sqlite();
-function recordRevision(config, input) {
-  const db = openStore(config, "readwrite");
-  const id = appendRevision(db, {
-    contentType: input.contentType,
-    enSlug: input.enSlug,
-    locale: input.locale,
-    revisionKind: input.revisionKind,
-    enHash: input.enHash,
-    bodyHash: computeBodyHash(input.body),
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    model: input.model,
-    bodyPreview: input.body.slice(0, 200),
-    frontmatterJson: input.frontmatter ? JSON.stringify(input.frontmatter) : null,
-    body: input.body
-  });
-  db.close();
-  return id;
-}
-
-// src/validate/validate-project.ts
 init_sqlite();
 
 // src/validate/validate-relations.ts
@@ -1587,6 +1556,75 @@ function validateRelations(project) {
   return issues;
 }
 
+// src/validate/validate-assets.ts
+init_esm_shims();
+var IMAGE_EXT = String.raw`(?:png|jpe?g|webp|gif|svg)`;
+var IMAGE_WEB_PATH = String.raw`\/[\w\-./]+\.${IMAGE_EXT}`;
+var MARKDOWN_IMAGE_RE = new RegExp(
+  String.raw`!\[[^\]]*\]\((${IMAGE_WEB_PATH})\)`,
+  "gi"
+);
+var HTML_SRC_RE = new RegExp(String.raw`src=["'](${IMAGE_WEB_PATH})["']`, "gi");
+function isImageWebPath(value) {
+  return new RegExp(String.raw`^${IMAGE_WEB_PATH}$`, "i").test(value);
+}
+function isSiteAssetPath(webPath) {
+  const segment = webPath.split("/")[1];
+  return Boolean(segment && !segment.includes("."));
+}
+function addImagePath(webPath, out) {
+  if (isSiteAssetPath(webPath)) out.add(webPath);
+}
+function collectBodyImagePaths(body, out) {
+  for (const re of [MARKDOWN_IMAGE_RE, HTML_SRC_RE]) {
+    for (const match of body.matchAll(re)) {
+      addImagePath(match[1], out);
+    }
+  }
+}
+function collectFrontmatterImagePaths(value, out) {
+  if (typeof value === "string") {
+    if (isImageWebPath(value)) addImagePath(value, out);
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectFrontmatterImagePaths(item, out);
+    return;
+  }
+  if (value && typeof value === "object") {
+    for (const nested of Object.values(value)) {
+      collectFrontmatterImagePaths(nested, out);
+    }
+  }
+}
+function collectImagePaths(frontmatter, body) {
+  const paths = /* @__PURE__ */ new Set();
+  collectFrontmatterImagePaths(frontmatter, paths);
+  collectBodyImagePaths(body, paths);
+  return [...paths].sort();
+}
+function assetFilePath(assetsPath, webPath) {
+  return path4.join(assetsPath, webPath.replace(/^\//, ""));
+}
+function validateDocumentAssets(config, input) {
+  const assetsPath = config.assetsPath;
+  if (!assetsPath) return [];
+  const issues = [];
+  for (const webPath of collectImagePaths(input.frontmatter, input.body)) {
+    const filePath = assetFilePath(assetsPath, webPath);
+    if (fs2.existsSync(filePath)) continue;
+    issues.push({
+      level: "warning",
+      contentType: input.contentType,
+      enSlug: input.enSlug,
+      locale: input.locale,
+      field: "asset",
+      message: `Missing image asset ${webPath} (expected ${filePath})`
+    });
+  }
+  return issues;
+}
+
 // src/validate/validate-slug-suffix.ts
 init_esm_shims();
 function validateTranslationSlugSuffixes(config, db) {
@@ -1649,8 +1687,6 @@ function validateProject(config) {
         });
         continue;
       }
-      const payload = getTranslatablePayload(enDoc, type);
-      const currentEnHash = computePageEnHash(payload.frontmatter, payload.body);
       const crossIssues = type.crossValidate?.(enDoc.frontmatter, {
         locale: config.defaultLocale,
         defaultLocale: config.defaultLocale,
@@ -1668,29 +1704,18 @@ function validateProject(config) {
           message: issue.message
         });
       }
+      for (const issue of validateDocumentAssets(config, {
+        contentType: type.id,
+        enSlug,
+        frontmatter: enDoc.frontmatter,
+        body: enDoc.content
+      })) {
+        issues.push(issue);
+      }
       for (const locale of config.locales) {
         if (locale === config.defaultLocale) continue;
         const row = getTranslation(db, type.id, enSlug, locale);
         if (!row) continue;
-        if (row.en_hash !== currentEnHash) {
-          issues.push({
-            level: "warning",
-            contentType: type.id,
-            enSlug,
-            locale,
-            field: "en_hash",
-            message: "Translation is stale (en_hash mismatch)"
-          });
-          recordRevision(config, {
-            contentType: type.id,
-            enSlug,
-            locale,
-            revisionKind: "en_edit_detected",
-            enHash: currentEnHash,
-            body: row.body,
-            frontmatter: JSON.parse(row.frontmatter_json)
-          });
-        }
         const localeFm = JSON.parse(row.frontmatter_json);
         for (const issue of validateLocaleBuiltinFields(localeFm)) {
           issues.push({
@@ -1702,6 +1727,15 @@ function validateProject(config) {
             message: issue.message
           });
         }
+        for (const issue of validateDocumentAssets(config, {
+          contentType: type.id,
+          enSlug,
+          locale,
+          frontmatter: localeFm,
+          body: row.body
+        })) {
+          issues.push(issue);
+        }
       }
     }
     try {
@@ -1772,6 +1806,18 @@ function validateProject(config) {
 
 // src/translate/worklist.ts
 init_esm_shims();
+
+// src/hash/page-hash.ts
+init_esm_shims();
+function sha256(input) {
+  return createHash("sha256").update(input, "utf8").digest("hex");
+}
+function computePageEnHash(translatableFrontmatter, body) {
+  const payload = JSON.stringify({ frontmatter: translatableFrontmatter, body });
+  return sha256(payload);
+}
+
+// src/translate/worklist.ts
 init_sqlite();
 function listEnSlugs3(rootDir, contentDir) {
   const dir = path4.join(rootDir, contentDir);
@@ -1833,6 +1879,25 @@ function resolveLocalesFromPreset(config, preset, explicitLocales) {
 
 // src/translate/page-translator.ts
 init_esm_shims();
+
+// src/history/record-snapshot.ts
+init_esm_shims();
+init_sqlite();
+function recordEnSnapshot(config, input, db) {
+  const ownDb = db ?? openStore(config, "readwrite");
+  const id = getOrCreateEnSnapshot(ownDb, {
+    contentType: input.contentType,
+    enSlug: input.enSlug,
+    enHash: input.enHash,
+    frontmatter: input.frontmatter,
+    body: input.body,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (!db) ownDb.close();
+  return id;
+}
+
+// src/translate/page-translator.ts
 init_sqlite();
 
 // src/translate/gemini-client.ts
@@ -2230,6 +2295,17 @@ async function translatePage(config, item, options = {}) {
       throw new Error(`Translation validation failed: ${validated.error}`);
     }
     const writeDb = openStore(config, "readwrite");
+    const snapshotId = recordEnSnapshot(
+      config,
+      {
+        contentType: type.id,
+        enSlug: item.enSlug,
+        enHash: currentEnHash,
+        frontmatter: payload.frontmatter,
+        body: payload.body
+      },
+      writeDb
+    );
     upsertTranslation(writeDb, {
       contentType: type.id,
       enSlug: item.enSlug,
@@ -2239,19 +2315,10 @@ async function translatePage(config, item, options = {}) {
       body: result.parsed.body,
       enHash: currentEnHash,
       translatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      model: result.model
+      model: result.model,
+      snapshotId
     });
     writeDb.close();
-    recordRevision(config, {
-      contentType: type.id,
-      enSlug: item.enSlug,
-      locale: item.locale,
-      revisionKind: "translation",
-      enHash: currentEnHash,
-      body: result.parsed.body,
-      frontmatter: validated.frontmatter,
-      model: result.model
-    });
     const estimatedCostUsd = estimateTranslationCostUsd(
       normalizeGeminiDisplayName(result.model),
       result.usage.inputTokens,
@@ -2490,38 +2557,31 @@ function renderFrontmatterTable(frontmatter, schema) {
     <tbody>${rows || `<tr><td colspan="2" class="dim">\u2014</td></tr>`}</tbody>
   </table>`;
 }
-function renderRevisionSnapshot(revision) {
-  if (revision.frontmatter_json && revision.body) {
-    let frontmatter = {};
-    try {
-      frontmatter = JSON.parse(revision.frontmatter_json);
-    } catch {
-      frontmatter = {};
-    }
-    const fmRows = flattenFrontmatter(frontmatter).map(
-      (row) => `<tr><td class="k">${escapeHtml(row.key)}</td><td class="v">${escapeHtml(row.value)}</td></tr>`
-    ).join("");
-    return `<table class="kv"><tbody>${fmRows}</tbody></table>
-      <pre class="code">${escapeHtml(revision.body)}</pre>`;
-  }
-  return `<p class="dim">${escapeHtml(revision.body_preview ?? "(no snapshot)")}</p>`;
-}
-function renderRevisionTimeline(revisions) {
-  if (revisions.length === 0) {
-    return `<p class="dim">No history.</p>`;
-  }
-  const items = revisions.map(
-    (row) => `<tr>
-        <td class="dim">${escapeHtml(row.created_at.slice(0, 19))}</td>
-        <td>${escapeHtml(row.revision_kind)}</td>
-        <td class="dim">${row.model ? escapeHtml(row.model) : "\u2014"}</td>
-        <td class="dim mono">${escapeHtml(row.en_hash.slice(0, 8))}</td>
-        <td><details><summary>view</summary>${renderRevisionSnapshot(row)}</details></td>
-      </tr>`
+function renderEnSnapshotPreview(snapshot) {
+  let frontmatter = {};
+  try {
+    frontmatter = JSON.parse(snapshot.frontmatter_json);
+  } catch {
+    frontmatter = {};
+  }
+  const fmRows = flattenFrontmatter(frontmatter).map(
+    (row) => `<tr><td class="k">${escapeHtml(row.key)}</td><td class="v">${escapeHtml(row.value)}</td></tr>`
   ).join("");
-  return `<table class="data"><thead><tr>
-    <th>When</th><th>Kind</th><th>Model</th><th>Hash</th><th></th>
-  </tr></thead><tbody>${items}</tbody></table>`;
+  return `<table class="kv"><tbody>${fmRows}</tbody></table>
+    <pre class="code">${escapeHtml(snapshot.body)}</pre>`;
+}
+function renderTranslationSnapshotPanel(snapshot, currentEnHash) {
+  if (!snapshot) {
+    return `<p class="dim">No EN snapshot linked to this translation.</p>`;
+  }
+  const staleNote = currentEnHash && currentEnHash !== snapshot.en_hash ? `<p class="dim">Current EN hash differs from snapshot (${escapeHtml(currentEnHash.slice(0, 12))} vs ${escapeHtml(snapshot.en_hash.slice(0, 12))}).</p>` : "";
+  return `<dl class="meta">
+    <dt>snapshot</dt><dd>#${snapshot.id}</dd>
+    <dt>captured</dt><dd>${escapeHtml(snapshot.created_at.slice(0, 19))}</dd>
+    <dt>en_hash</dt><dd class="mono">${escapeHtml(snapshot.en_hash.slice(0, 12))}</dd>
+  </dl>
+  ${staleNote}
+  <details><summary>EN source at translation time</summary>${renderEnSnapshotPreview(snapshot)}</details>`;
 }
 function renderLayout(title, body, project, options = {}) {
   const typeLinks = project.listTypes().map((type) => {
@@ -2832,10 +2892,10 @@ async function startStudio(project, options = {}) {
           <dt>slug</dt><dd>${escapeHtml(translation.slug)}</dd>
           <dt>en_hash</dt><dd>${escapeHtml(currentEnHash?.slice(0, 12) ?? "\u2014")} / ${escapeHtml(storedEnHash?.slice(0, 12) ?? "\u2014")}</dd>
         </dl>`;
-        const revisions = listRevisions(db, typeId, enSlug, locale);
+        const snapshot = translation.snapshot_id != null ? getEnSnapshot(db, translation.snapshot_id) : void 0;
         historyPanel = `<div class="section">
-          <div class="section-head">History</div>
-          <div class="section-body">${renderRevisionTimeline(revisions)}</div>
+          <div class="section-head">EN snapshot</div>
+          <div class="section-body">${renderTranslationSnapshotPanel(snapshot, currentEnHash)}</div>
         </div>`;
       } else {
         contentPanel = `<p class="dim" style="padding:12px">No translation for ${escapeHtml(locale)}.</p>`;
@@ -3164,6 +3224,24 @@ function createTranslateProgressReporter(options = {}) {
   };
 }
 
+// src/version.ts
+init_esm_shims();
+function readScribeVersion() {
+  let dir = path4.dirname(fileURLToPath(import.meta.url));
+  for (; ; ) {
+    const candidate = path4.join(dir, "package.json");
+    if (fs2.existsSync(candidate)) {
+      const pkg = JSON.parse(fs2.readFileSync(candidate, "utf8"));
+      if (pkg.name === "scribe-cms" && pkg.version) return pkg.version;
+    }
+    const parent = path4.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return "unknown";
+}
+var SCRIBE_VERSION = readScribeVersion();
+
 // cli/index.ts
 function parseArgs(argv) {
   const options = { cwd: process.cwd() };
@@ -3266,7 +3344,13 @@ function loadProject(options) {
   return createProject(config);
 }
 async function main() {
-  const { command, options, rest } = parseArgs(process.argv.slice(2));
+  const argv = process.argv.slice(2);
+  const first = argv[0];
+  if (first === "--version" || first === "-V" || first === "version") {
+    console.log(SCRIBE_VERSION);
+    return;
+  }
+  const { command, options, rest } = parseArgs(argv);
   loadEnvFromCwd(options.cwd);
   if (command === "help" || command === "--help") {
     console.log(`Usage: scribe <command>
@@ -3276,8 +3360,9 @@ Commands:
   validate               Validate EN files and sqlite consistency
   export-static          Write raw MDX files for static hosting
   translate              Translate stale/missing locale pages
-  history <type> <slug>  Show revision timeline
+  history <type> <slug>  Show EN snapshot timeline
   studio                 Start read-only local studio
+  version                Print scribe-cms version
 
 Export-static flags:
   --out <dir>            Output directory (default: public)
@@ -3299,6 +3384,10 @@ Translate flags:
 `);
     return;
   }
+  if (command === "version") {
+    console.log(SCRIBE_VERSION);
+    return;
+  }
   const project = loadProject(options);
   const config = project.config;
   switch (command) {
@@ -3377,11 +3466,13 @@ Translate flags:
       }
       const { openStore: openStore2 } = await Promise.resolve().then(() => (init_sqlite(), sqlite_exports));
       const db = openStore2(config, "readonly");
-      const rows = listRevisions(db, typeId, enSlug, locale);
+      const rows = listEnSnapshotsForEnSlug(db, typeId, enSlug);
       db.close();
       for (const row of rows) {
+        const locales = row.locales ?? "";
+        if (locale && !locales.split(",").includes(locale)) continue;
         console.log(
-          `${row.created_at} ${row.revision_kind} locale=${row.locale ?? "en"} en_hash=${row.en_hash.slice(0, 8)} body_hash=${row.body_hash.slice(0, 8)}`
+          `${row.created_at} snapshot=#${row.id} en_hash=${row.en_hash.slice(0, 8)} locales=${locales || "\u2014"}`
         );
       }
       break;