npm - termi-kids - Versions diffs - 0.1.0 - Mend

termi-kids 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (64) hide show

package/LICENSE +34 -0
package/README.md +148 -0
package/SAFETY.md +187 -0
package/bin/termi.js +22 -0
package/dist/agent/context.js +126 -0
package/dist/agent/loop.js +172 -0
package/dist/agent/prompts/system.js +45 -0
package/dist/agent/tools.js +335 -0
package/dist/auth/keychain.js +146 -0
package/dist/auth/oauth.js +375 -0
package/dist/auth/tokens.js +219 -0
package/dist/cli.js +258 -0
package/dist/config/paths.js +92 -0
package/dist/config/pin.js +150 -0
package/dist/config/settings.js +131 -0
package/dist/grownups/panel.js +483 -0
package/dist/learn/lessons.js +490 -0
package/dist/learn/runner.js +193 -0
package/dist/preview/server.js +407 -0
package/dist/projects/create.js +103 -0
package/dist/projects/ideas.js +182 -0
package/dist/projects/quests.js +277 -0
package/dist/projects/scaffolds/art.js +484 -0
package/dist/projects/scaffolds/biggames.js +554 -0
package/dist/projects/scaffolds/characters.js +580 -0
package/dist/projects/scaffolds/games.js +516 -0
package/dist/projects/scaffolds/index.js +24 -0
package/dist/projects/scaffolds/music.js +528 -0
package/dist/projects/scaffolds/pets.js +567 -0
package/dist/projects/scaffolds/quizzes.js +757 -0
package/dist/projects/scaffolds/stories.js +620 -0
package/dist/projects/scaffolds/vendor/KAPLAY-LICENSE.txt +35 -0
package/dist/projects/scaffolds/vendor/kaplay.mjs +57 -0
package/dist/projects/scaffolds/websites.js +474 -0
package/dist/projects/snapshots.js +203 -0
package/dist/projects/store.js +325 -0
package/dist/providers/errors.js +207 -0
package/dist/providers/index.js +316 -0
package/dist/providers/models.js +38 -0
package/dist/safety/audit.js +195 -0
package/dist/safety/blocks.js +29 -0
package/dist/safety/classifier.js +337 -0
package/dist/safety/codescan.js +168 -0
package/dist/safety/guarddownload.js +79 -0
package/dist/safety/guardrunner.js +125 -0
package/dist/safety/localguard.js +227 -0
package/dist/safety/modelstore.js +127 -0
package/dist/safety/prefilter.js +214 -0
package/dist/safety/session.js +118 -0
package/dist/safety/taxonomy.js +246 -0
package/dist/safety/textextract.js +193 -0
package/dist/setup/launcher.js +65 -0
package/dist/setup/wizard.js +469 -0
package/dist/surfaces/chat.js +439 -0
package/dist/surfaces/commands.js +206 -0
package/dist/surfaces/home.js +438 -0
package/dist/types.js +5 -0
package/dist/ui/banner.js +35 -0
package/dist/ui/celebrate.js +141 -0
package/dist/ui/errors.js +97 -0
package/dist/ui/mascot.js +223 -0
package/dist/ui/text.js +156 -0
package/dist/ui/theme.js +92 -0
package/package.json +67 -0

package/dist/projects/scaffolds/websites.js ADDED Viewed

@@ -0,0 +1,474 @@
+/**
+ * My Page: a personal homepage scaffold.
+ * SAFETY DESIGN: the kid fills name, about, and favorites with editable
+ * fields IN THE PAGE ITSELF (contenteditable saved to localStorage),
+ * never through the chat. So personal details never reach the model.
+ * The page shows a friendly tip: use a nickname, keep real details secret.
+ * Photos are an emoji avatar picker. No uploads, no network.
+ */
+function jsData(value) {
+    return JSON.stringify(value, null, 2);
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+const aboutMeTheme = {
+    id: 'about-me',
+    label: 'About Me',
+    emoji: '\u{1F31E}',
+    palette: { bg: '#fff8ef', fg: '#2b2540', accent: '#ff8a5c' },
+    glyphs: { shield: '\u{1F6E1}\u{FE0F}', spark: '\u{2728}', pin: '\u{1F4CC}' },
+    strings: {
+        heroPlaceholder: 'Your nickname here',
+        taglinePlaceholder: 'Add a fun motto here.',
+        aboutHeading: 'About me',
+        aboutPlaceholder: 'Write three fun facts about you.',
+        favoritesHeading: 'My favorites',
+        avatarHeading: 'Pick your avatar',
+        freshLabel: 'Start fresh',
+        freshConfirm: 'Click again to erase everything',
+    },
+    narrativeIntro: 'Your own corner of the screen. Fill it with the stuff you love.',
+    nonViolent: true,
+    nonCompetitive: true,
+};
+const myTeamTheme = {
+    id: 'my-team',
+    label: 'My Team',
+    emoji: '\u{1F3C5}',
+    palette: { bg: '#0f2557', fg: '#f4f8ff', accent: '#ffd23f' },
+    glyphs: { shield: '\u{1F6E1}\u{FE0F}', spark: '\u{26A1}', pin: '\u{1F4CC}' },
+    strings: {
+        heroPlaceholder: 'Your team name here',
+        taglinePlaceholder: 'Add your team motto here.',
+        aboutHeading: 'About our team',
+        aboutPlaceholder: 'What makes your team great? Write it here.',
+        favoritesHeading: 'Team favorites',
+        avatarHeading: 'Pick your mascot',
+        freshLabel: 'Start fresh',
+        freshConfirm: 'Click again to erase everything',
+    },
+    narrativeIntro: 'Every great team needs a home page. This one is yours.',
+    nonViolent: true,
+    nonCompetitive: true,
+};
+const aboutMeData = {
+    avatars: [
+        '\u{1F98A}',
+        '\u{1F43C}',
+        '\u{1F438}',
+        '\u{1F984}',
+        '\u{1F419}',
+        '\u{1F996}',
+        '\u{1F431}',
+        '\u{1F436}',
+        '\u{1F989}',
+        '\u{1F422}',
+        '\u{1F427}',
+        '\u{1F41D}',
+    ],
+    favorites: [
+        'Favorite game',
+        'Favorite food',
+        'Favorite animal',
+        'Favorite color',
+        'Favorite song',
+        'Favorite place',
+    ],
+};
+const myTeamData = {
+    avatars: [
+        '\u{1F985}',
+        '\u{1F43A}',
+        '\u{1F981}',
+        '\u{1F42F}',
+        '\u{1F988}',
+        '\u{1F409}',
+        '\u{1F43B}',
+        '\u{1F40E}',
+        '\u{1F994}',
+        '\u{1F40D}',
+        '\u{1F99C}',
+        '\u{1F42C}',
+    ],
+    favorites: [
+        'Our sport or game',
+        'Team colors',
+        'Best win ever',
+        'Team snack',
+        'Home field',
+        'Our team cheer',
+    ],
+};
+const SAFETY_TIP = 'Use your nickname. Keep your real name, school, and address secret.';
+function buildHtml(theme, prettyName) {
+    const s = theme.strings;
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtml(prettyName)}</title>
+  <link rel="icon" href="data:,">
+  <link rel="stylesheet" href="style.css">
+  <script src="game.js" defer></script>
+</head>
+<body>
+  <main class="frame">
+    <p class="safety-tip">${theme.glyphs['shield'] ?? ''} Tip: ${SAFETY_TIP}</p>
+    <header class="card hero">
+      <div id="avatar">${theme.emoji}</div>
+      <h1 id="nickname" contenteditable="true" data-save="nickname" data-placeholder="${s['heroPlaceholder'] ?? ''}"></h1>
+      <p id="motto" contenteditable="true" data-save="motto" data-placeholder="${s['taglinePlaceholder'] ?? ''}"></p>
+    </header>
+    <section class="card">
+      <h2>${s['avatarHeading'] ?? 'Pick your avatar'}</h2>
+      <div id="avatar-picker"></div>
+    </section>
+    <section class="card">
+      <h2>${s['aboutHeading'] ?? 'About me'}</h2>
+      <div id="about" class="about" contenteditable="true" data-save="about" data-placeholder="${s['aboutPlaceholder'] ?? ''}"></div>
+    </section>
+    <section class="card">
+      <h2>${s['favoritesHeading'] ?? 'My favorites'}</h2>
+      <div id="favorites"></div>
+    </section>
+    <footer>
+      <span id="save-note"></span>
+      <button id="fresh" class="ghost" type="button">${s['freshLabel'] ?? 'Start fresh'}</button>
+    </footer>
+    <p class="tip">Everything you type saves on this computer only. Nothing goes online.</p>
+  </main>
+</body>
+</html>
+`;
+}
+function buildCss(theme) {
+    const p = theme.palette;
+    return `/* My Page styles. Colors come from your THEME in game.js. */
+* { box-sizing: border-box; }
+:root {
+  --bg: ${p.bg};
+  --fg: ${p.fg};
+  --accent: ${p.accent};
+}
+body {
+  margin: 0;
+  min-height: 100vh;
+  background: var(--bg);
+  background-image: radial-gradient(circle at 50% 0%, color-mix(in srgb, var(--accent) 16%, var(--bg)), var(--bg) 65%);
+  color: var(--fg);
+  font-family: system-ui, "Segoe UI", Roboto, Arial, sans-serif;
+  display: flex;
+  justify-content: center;
+  padding: 28px 16px;
+}
+.frame { width: min(680px, 100%); }
+.safety-tip {
+  background: color-mix(in srgb, var(--accent) 22%, var(--bg));
+  border: 1px solid color-mix(in srgb, var(--accent) 55%, var(--bg));
+  border-radius: 12px;
+  padding: 10px 14px;
+  font-size: 0.92rem;
+  font-weight: 600;
+  margin: 0 0 16px;
+}
+.card {
+  background: color-mix(in srgb, var(--fg) 6%, var(--bg));
+  border: 1px solid color-mix(in srgb, var(--fg) 14%, var(--bg));
+  border-radius: 16px;
+  padding: 20px;
+  margin-bottom: 16px;
+}
+.hero { text-align: center; }
+#avatar { font-size: 4.5rem; line-height: 1.1; }
+#nickname { font-size: 2rem; margin: 8px 0 4px; min-height: 1.2em; }
+#motto { margin: 0; opacity: 0.85; min-height: 1.2em; }
+h2 { margin: 0 0 12px; font-size: 1.1rem; }
+[contenteditable] {
+  border-radius: 8px;
+  padding: 4px 8px;
+  white-space: pre-wrap;
+  outline: 2px dashed transparent;
+  transition: outline-color 0.15s ease;
+}
+[contenteditable]:hover { outline-color: color-mix(in srgb, var(--accent) 50%, var(--bg)); }
+[contenteditable]:focus { outline-color: var(--accent); }
+[contenteditable]:empty::before {
+  content: attr(data-placeholder);
+  opacity: 0.45;
+}
+.about { min-height: 4em; line-height: 1.55; }
+#avatar-picker {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(52px, 1fr));
+  gap: 8px;
+}
+.avatar-btn {
+  font-size: 1.7rem;
+  background: color-mix(in srgb, var(--fg) 8%, var(--bg));
+  border: 2px solid transparent;
+  border-radius: 12px;
+  padding: 6px 0;
+  cursor: pointer;
+  transition: transform 0.12s ease;
+}
+.avatar-btn:hover { transform: translateY(-2px); }
+.avatar-btn.selected { border-color: var(--accent); }
+.avatar-btn:focus-visible { outline: 3px solid var(--accent); }
+#favorites {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
+  gap: 12px;
+}
+.fav-tile {
+  background: color-mix(in srgb, var(--fg) 8%, var(--bg));
+  border-radius: 12px;
+  padding: 12px;
+}
+.fav-label {
+  font-size: 0.78rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  opacity: 0.7;
+  margin: 0 0 6px;
+}
+.fav-value { min-height: 1.4em; font-size: 1.02rem; }
+footer {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+#save-note { color: var(--accent); font-weight: 700; font-size: 0.9rem; }
+.ghost {
+  background: transparent;
+  color: var(--fg);
+  border: 1px solid color-mix(in srgb, var(--fg) 35%, var(--bg));
+  border-radius: 10px;
+  padding: 8px 14px;
+  cursor: pointer;
+}
+.ghost:hover { border-color: var(--accent); color: var(--accent); }
+.tip { opacity: 0.65; font-size: 0.85rem; margin-top: 14px; }
+`;
+}
+function buildGameJs(theme, data) {
+    return `// My Page: ${theme.label}. Made with Termi.
+//
+// HOW YOUR PAGE WORKS:
+// 1. Click any dotted box on the page and type. It saves on this computer.
+// 2. AVATARS below holds your avatar choices. Add more emoji!
+// 3. FAVORITES holds the labels for your favorites grid. Rename them!
+// Remember the tip on the page: nickname only, real details stay secret.
+const THEME = ${jsData({
+        id: theme.id,
+        label: theme.label,
+        emoji: theme.emoji,
+        palette: theme.palette,
+        glyphs: theme.glyphs,
+        strings: theme.strings,
+    })};
+// === YOUR PAGE SETUP (edit this part!) ===
+const AVATARS = ${jsData(data.avatars)};
+const FAVORITES = ${jsData(data.favorites)};
+// === END OF YOUR PAGE SETUP ===
+// ----- The page engine starts here. Curious? Read on! -----
+const avatarEl = document.getElementById("avatar");
+const pickerEl = document.getElementById("avatar-picker");
+const favoritesEl = document.getElementById("favorites");
+const saveNoteEl = document.getElementById("save-note");
+const freshBtn = document.getElementById("fresh");
+const PREFIX = "termi-mypage-" + THEME.id + ":";
+let saveNoteTimer = null;
+let freshArmed = false;
+let freshTimer = null;
+function load(field) {
+  try {
+    return localStorage.getItem(PREFIX + field) || "";
+  } catch (err) {
+    return "";
+  }
+}
+function save(field, value) {
+  try {
+    localStorage.setItem(PREFIX + field, value);
+  } catch (err) {
+    return;
+  }
+  flashSaved();
+}
+function flashSaved() {
+  saveNoteEl.textContent = "Saved " + THEME.glyphs.spark;
+  clearTimeout(saveNoteTimer);
+  saveNoteTimer = setTimeout(function () {
+    saveNoteEl.textContent = "";
+  }, 1400);
+}
+function wireEditable(el) {
+  const field = el.getAttribute("data-save");
+  const saved = load(field);
+  if (saved) {
+    el.textContent = saved;
+  }
+  el.addEventListener("input", function () {
+    if (el.textContent.trim() === "") {
+      el.textContent = "";
+    }
+    save(field, el.innerText);
+  });
+}
+function buildFavorites() {
+  FAVORITES.forEach(function (label, i) {
+    const tile = document.createElement("div");
+    tile.className = "fav-tile";
+    const labelEl = document.createElement("p");
+    labelEl.className = "fav-label";
+    labelEl.textContent = THEME.glyphs.pin + " " + label;
+    const valueEl = document.createElement("div");
+    valueEl.className = "fav-value";
+    valueEl.contentEditable = "true";
+    valueEl.setAttribute("data-save", "fav-" + i);
+    valueEl.setAttribute("data-placeholder", "Type it here");
+    tile.appendChild(labelEl);
+    tile.appendChild(valueEl);
+    favoritesEl.appendChild(tile);
+  });
+}
+function markSelected(emoji) {
+  const buttons = pickerEl.querySelectorAll("button");
+  buttons.forEach(function (b) {
+    b.classList.toggle("selected", b.textContent === emoji);
+  });
+}
+function buildPicker() {
+  AVATARS.forEach(function (emoji) {
+    const btn = document.createElement("button");
+    btn.className = "avatar-btn";
+    btn.type = "button";
+    btn.textContent = emoji;
+    btn.addEventListener("click", function () {
+      avatarEl.textContent = emoji;
+      save("avatar", emoji);
+      markSelected(emoji);
+    });
+    pickerEl.appendChild(btn);
+  });
+}
+function initAvatar() {
+  const saved = load("avatar");
+  if (saved) {
+    avatarEl.textContent = saved;
+    markSelected(saved);
+  }
+}
+function startFresh() {
+  if (!freshArmed) {
+    freshArmed = true;
+    freshBtn.textContent = THEME.strings.freshConfirm;
+    clearTimeout(freshTimer);
+    freshTimer = setTimeout(function () {
+      freshArmed = false;
+      freshBtn.textContent = THEME.strings.freshLabel;
+    }, 3000);
+    return;
+  }
+  try {
+    const doomed = [];
+    for (let i = 0; i < localStorage.length; i += 1) {
+      const key = localStorage.key(i);
+      if (key && key.indexOf(PREFIX) === 0) {
+        doomed.push(key);
+      }
+    }
+    doomed.forEach(function (key) {
+      localStorage.removeItem(key);
+    });
+  } catch (err) {
+    // Storage is off. Nothing to erase.
+  }
+  window.location.reload();
+}
+buildFavorites();
+buildPicker();
+document.querySelectorAll("[data-save]").forEach(wireEditable);
+initAvatar();
+freshBtn.addEventListener("click", startFresh);
+`;
+}
+function buildTermiMd(theme, prettyName, data) {
+    return [
+        `# ${prettyName}`,
+        '',
+        '## What this is',
+        `A personal ${theme.label} homepage. The kid types right on the page, and it saves on this computer only.`,
+        '',
+        '## Files',
+        '- index.html: the page and its editable boxes.',
+        '- style.css: the colors and look.',
+        '- game.js: the avatar and favorites lists, then the page engine.',
+        '',
+        '## Built so far',
+        `- Starter ${theme.label} page with ${data.favorites.length} favorites tiles and ${data.avatars.length} avatars.`,
+        '',
+        '## Recap line',
+        `We built a ${theme.label} page you can fill in right in the browser.`,
+        '',
+    ].join('\n');
+}
+function dataFor(theme) {
+    return theme.id === 'my-team' ? myTeamData : aboutMeData;
+}
+export const websitesScaffold = {
+    id: 'websites',
+    label: 'My Page',
+    emoji: '\u{1F310}',
+    ageNote: 'Great for ages 9 and up. A page about you, saved only on this computer.',
+    themes: [aboutMeTheme, myTeamTheme],
+    files(theme, prettyName) {
+        const data = dataFor(theme);
+        return {
+            'index.html': buildHtml(theme, prettyName),
+            'style.css': buildCss(theme),
+            'game.js': buildGameJs(theme, data),
+            'TERMI.md': buildTermiMd(theme, prettyName, data),
+        };
+    },
+    starterPrompts(theme) {
+        if (theme.id === 'my-team') {
+            return [
+                'Add a player list with five spots I can fill in',
+                'Add a win counter that goes up when I click it',
+                'Make the team name bounce when the page loads',
+                'Add a section for our game schedule',
+                'Let me pick from more mascot emojis',
+            ];
+        }
+        return [
+            'Add a section for my pets',
+            'Make the colors change when I click the title',
+            'Add more emoji choices for my avatar',
+            'Give the favorites cards a rainbow border',
+            'Add a jokes corner with spots for three jokes',
+        ];
+    },
+};
+export default websitesScaffold;

package/dist/projects/snapshots.js ADDED Viewed

@@ -0,0 +1,203 @@
+/**
+ * Content-addressed snapshots for undo and redo.
+ *
+ * Layout under snapshotsDir()/<slug>/:
+ * - blobs/<sha256>       file contents, one blob per unique content
+ * - manifests/<n>.json   { n, ts, files: { relPath: sha } } per saved state
+ * - state.json           { pointer } = the manifest that matches disk now
+ *
+ * Only kid files are snapshotted. TERMI.md, .termi.json, dotfiles, and
+ * vendored engine files are never captured, restored, or deleted.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { atomicWriteFileSync, snapshotsDir } from '../config/paths.js';
+/** How many manifests survive a prune. */
+export const keepManifestCount = 50;
+function sha256(buf) {
+    return crypto.createHash('sha256').update(buf).digest('hex');
+}
+function sameFiles(a, b) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    return aKeys.every((k) => a[k] === b[k]);
+}
+export function createSnapshotStore(project) {
+    const root = path.join(snapshotsDir(), project.meta.slug);
+    const blobsDir = path.join(root, 'blobs');
+    const manifestsDir = path.join(root, 'manifests');
+    const statePath = path.join(root, 'state.json');
+    const manifestPath = (n) => path.join(manifestsDir, `${n}.json`);
+    const readPointer = () => {
+        try {
+            const data = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+            if (typeof data.pointer === 'number' && Number.isInteger(data.pointer) && data.pointer >= 0) {
+                return data.pointer;
+            }
+        }
+        catch {
+            // No state yet: pointer starts at zero.
+        }
+        return 0;
+    };
+    const writePointer = (n) => {
+        atomicWriteFileSync(statePath, JSON.stringify({ pointer: n }) + '\n');
+    };
+    const listManifestNumbers = () => {
+        let names;
+        try {
+            names = fs.readdirSync(manifestsDir);
+        }
+        catch {
+            return [];
+        }
+        const nums = [];
+        for (const name of names) {
+            const match = /^(\d+)\.json$/.exec(name);
+            if (match && match[1] !== undefined)
+                nums.push(Number(match[1]));
+        }
+        nums.sort((a, b) => a - b);
+        return nums;
+    };
+    const readManifest = (n) => {
+        if (n < 1)
+            return null;
+        try {
+            const data = JSON.parse(fs.readFileSync(manifestPath(n), 'utf8'));
+            if (typeof data.n !== 'number' || typeof data.files !== 'object' || data.files === null) {
+                return null;
+            }
+            return data;
+        }
+        catch {
+            return null;
+        }
+    };
+    const projectFilePath = (relPath) => path.join(project.dir, ...relPath.split('/'));
+    /** Hashes the kid files on disk right now. */
+    const captureCurrent = () => {
+        const files = {};
+        const bySha = new Map();
+        for (const f of project.listKidFiles()) {
+            let buf;
+            try {
+                buf = fs.readFileSync(projectFilePath(f.relPath));
+            }
+            catch {
+                continue;
+            }
+            const sha = sha256(buf);
+            files[f.relPath] = sha;
+            bySha.set(sha, buf);
+        }
+        return { files, bySha };
+    };
+    /**
+     * Saves the current state as manifest pointer+1.
+     * Any redo manifests above the pointer are dropped first.
+     */
+    const persistCurrent = (current, pointer) => {
+        for (const n of listManifestNumbers()) {
+            if (n > pointer)
+                fs.rmSync(manifestPath(n), { force: true });
+        }
+        fs.mkdirSync(blobsDir, { recursive: true });
+        fs.mkdirSync(manifestsDir, { recursive: true });
+        for (const [sha, buf] of current.bySha) {
+            const blobPath = path.join(blobsDir, sha);
+            if (!fs.existsSync(blobPath))
+                fs.writeFileSync(blobPath, buf);
+        }
+        const next = pointer + 1;
+        const manifest = { n: next, ts: new Date().toISOString(), files: current.files };
+        atomicWriteFileSync(manifestPath(next), JSON.stringify(manifest) + '\n');
+        writePointer(next);
+        return next;
+    };
+    /** Makes sure the disk state is captured. Returns the pointer after. */
+    const ensureSnapshotted = () => {
+        const pointer = readPointer();
+        const current = captureCurrent();
+        const last = readManifest(pointer);
+        if (last !== null && sameFiles(last.files, current.files))
+            return pointer;
+        return persistCurrent(current, pointer);
+    };
+    /** Writes a manifest's files back to disk and removes kid files not in it. */
+    const restore = (manifest) => {
+        for (const sha of Object.values(manifest.files)) {
+            if (!fs.existsSync(path.join(blobsDir, sha)))
+                return false;
+        }
+        for (const f of project.listKidFiles()) {
+            if (!(f.relPath in manifest.files)) {
+                fs.rmSync(projectFilePath(f.relPath), { force: true });
+            }
+        }
+        for (const [relPath, sha] of Object.entries(manifest.files)) {
+            const blob = fs.readFileSync(path.join(blobsDir, sha));
+            const dest = projectFilePath(relPath);
+            fs.mkdirSync(path.dirname(dest), { recursive: true });
+            fs.writeFileSync(dest, blob);
+        }
+        return true;
+    };
+    /** Keeps the newest manifests and drops blobs nothing points at. */
+    const prune = () => {
+        const nums = listManifestNumbers();
+        if (nums.length > keepManifestCount) {
+            for (const n of nums.slice(0, nums.length - keepManifestCount)) {
+                fs.rmSync(manifestPath(n), { force: true });
+            }
+        }
+        const referenced = new Set();
+        for (const n of listManifestNumbers()) {
+            const manifest = readManifest(n);
+            if (manifest === null)
+                continue;
+            for (const sha of Object.values(manifest.files))
+                referenced.add(sha);
+        }
+        let blobNames;
+        try {
+            blobNames = fs.readdirSync(blobsDir);
+        }
+        catch {
+            return;
+        }
+        for (const name of blobNames) {
+            if (!referenced.has(name))
+                fs.rmSync(path.join(blobsDir, name), { force: true });
+        }
+    };
+    return {
+        beginTurn() {
+            ensureSnapshotted();
+            prune();
+        },
+        undo() {
+            const pointer = ensureSnapshotted();
+            const target = readManifest(pointer - 1);
+            if (target === null)
+                return false;
+            if (!restore(target))
+                return false;
+            writePointer(pointer - 1);
+            return true;
+        },
+        redo() {
+            const pointer = readPointer();
+            const target = readManifest(pointer + 1);
+            if (target === null)
+                return false;
+            if (!restore(target))
+                return false;
+            writePointer(pointer + 1);
+            return true;
+        },
+    };
+}