@bendyline/gilde 0.1.6 → 0.1.8

package/data/project-types/fi/fitness-coach/versions/1.0.1/manifest.json

@@ -0,0 +1,125 @@
+{
+  "schemaVersion": 1,
+  "version": "1.0.1",
+  "releasedAt": "2026-08-01T00:00:00Z",
+  "meesterManaged": false,
+  "params": {
+    "type": "object",
+    "properties": {
+      "goal": {
+        "type": "string",
+        "title": "What are you training toward?",
+        "description": "e.g. 'feel strong again', 'a 10k in October'.",
+        "default": "feeling strong and consistent"
+      },
+      "weeklyTarget": {
+        "type": "number",
+        "title": "Sessions per week",
+        "description": "How many training sessions a week to aim for.",
+        "default": 3
+      }
+    },
+    "required": [
+      "goal",
+      "weeklyTarget"
+    ]
+  },
+  "nameTemplate": "Fitness: {{goal}}",
+  "aboutTemplate": "about.md",
+  "missionTemplate": "mission.md",
+  "gezels": [
+    {
+      "templateId": "coach",
+      "voorman": true
+    }
+  ],
+  "tools": [
+    {
+      "name": "log_workout",
+      "description": "Log a training session the moment it is reported (activity + minutes).",
+      "script": "training-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "activity": {
+            "type": "string"
+          },
+          "minutes": {
+            "type": "number"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "activity"
+        ]
+      },
+      "bind": {
+        "action": "log_workout"
+      }
+    },
+    {
+      "name": "set_target",
+      "description": "Change the weekly session target.",
+      "script": "training-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "weeklyTarget": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "weeklyTarget"
+        ]
+      },
+      "bind": {
+        "action": "set_target"
+      }
+    },
+    {
+      "name": "training_status",
+      "description": "Streak, this week against the target, all-time count.",
+      "script": "training-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "status"
+      }
+    },
+    {
+      "name": "workout_history",
+      "description": "The recent sessions, most recent last.",
+      "script": "training-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "history"
+      }
+    }
+  ],
+  "craftbooks": [
+    "weekly-review"
+  ],
+  "schedules": [],
+  "pages": {
+    "entry": "dashboard/index.html",
+    "reads": [
+      {
+        "source": "workspace",
+        "path": "training.json"
+      }
+    ]
+  },
+  "workspaceSeed": [
+    "training.json"
+  ],
+  "scripts": {
+    "training-store": "import { type InferredInput, defineScript, gezel } from '@bendyline/gezel-sdk';\nimport { logStore } from '@bendyline/gezel-sdk/stores';\n\nexport const meta = defineScript({\n  name: 'training-store',\n  description:\n    \"Read and update the training log (training.json). Call action:'status' for streak + this week vs the target; 'log_workout' the moment a session is reported (activity + minutes); 'set_target' to change the weekly session target; 'history' for the recent sessions.\",\n  inputs: {\n    action: {\n      type: 'string',\n      description: \"One of 'status', 'log_workout', 'set_target', or 'history'.\",\n      required: true,\n    },\n    activity: { type: 'string', description: \"What they did, e.g. 'run', 'gym', 'long walk'.\" },\n    minutes: { type: 'number', description: 'How long the session ran, in minutes.' },\n    note: { type: 'string', description: 'Anything worth remembering about the session.' },\n    weeklyTarget: { type: 'number', description: 'Sessions per week to aim for (set_target).' },\n  },\n  outputs: {\n    streakDays: { type: 'number', description: 'Consecutive days with a session, ending at the latest.' },\n    thisWeek: { type: 'number', description: 'Sessions logged this week (Monday UTC start).' },\n    weeklyTarget: { type: 'number', description: 'The current weekly session target.' },\n    summary: { type: 'string', description: 'The training picture.' },\n  },\n  requires: ['workspace.read', 'workspace.write'],\n} as const);\n\nconst input = gezel.input as InferredInput<typeof meta>;\n\n// ── fitness-rules-start ──\n// Pure derivations over logStore-shaped workout events: kind 'workout',\n// data {activity, minutes}. Weeks start Monday 00:00 UTC; nowIso is a\n// parameter so the rules stay clock-independent and testable.\n\nfunction weekStartMs(nowIso) {\n  var day = new Date(nowIso.slice(0, 10) + 'T00:00:00Z');\n  var sinceMonday = (day.getUTCDay() + 6) % 7;\n  return day.getTime() - sinceMonday * 86400000;\n}\n\nfunction thisWeekCount(events, nowIso) {\n  var start = weekStartMs(nowIso);\n  return events.filter(function (e) {\n    return Date.parse(e.at) >= start;\n  }).length;\n}\n\nfunction trainingLine(stats, weekCount, weeklyTarget) {\n  var target = weeklyTarget > 0 ? weeklyTarget : 0;\n  var weekPart =\n    'This week: ' +\n    weekCount +\n    (target > 0 ? ' of ' + target + ' session(s)' : ' session(s)') +\n    (target > 0 && weekCount >= target ? ' — target met.' : '.');\n  var streakPart =\n    stats.total === 0\n      ? 'No sessions logged yet.'\n      : 'Streak: ' + stats.streakDays + ' day(s); ' + stats.total + ' session(s) all time.';\n  return weekPart + ' ' + streakPart;\n}\n// ── fitness-rules-end ──\n\nconst training = logStore(gezel.fs, 'training.json');\n\nasync function readWeeklyTarget(): Promise<number> {\n  try {\n    const parsed = JSON.parse(await gezel.fs.read('training.json')) as { weeklyTarget?: unknown };\n    const target = Number(parsed.weeklyTarget);\n    return Number.isFinite(target) && target > 0 ? Math.round(target) : 0;\n  } catch {\n    return 0;\n  }\n}\n\nif (input.action === 'log_workout') {\n  if (!input.activity) throw new Error(\"log_workout needs 'activity' (what they did).\");\n  await training.append({\n    kind: 'workout',\n    ...(input.note ? { note: input.note } : {}),\n    data: {\n      activity: input.activity,\n      ...(typeof input.minutes === 'number' && input.minutes > 0\n        ? { minutes: Math.round(input.minutes) }\n        : {}),\n    },\n  });\n} else if (input.action === 'set_target') {\n  const target = Number(input.weeklyTarget);\n  if (!Number.isFinite(target) || target <= 0) {\n    throw new Error(\"set_target needs a positive 'weeklyTarget' (sessions per week).\");\n  }\n  // logStore has no field API; the passenger key flips via a targeted\n  // read-modify-write that preserves the rest of the file.\n  const raw = JSON.parse(await gezel.fs.read('training.json')) as Record<string, unknown>;\n  raw.weeklyTarget = Math.round(target);\n  await gezel.fs.write('training.json', `${JSON.stringify(raw, null, 2)}\\n`);\n} else if (input.action !== 'status' && input.action !== 'history') {\n  throw new Error(`Unknown action '${input.action}'. Use status, log_workout, set_target, or history.`);\n}\n\nconst events = await training.list();\nconst stats = await training.stats();\nconst weeklyTarget = await readWeeklyTarget();\nconst nowIso = new Date().toISOString();\nconst weekCount = thisWeekCount(events, nowIso);\nconst listing =\n  input.action === 'history'\n    ? events\n        .slice(-12)\n        .map(\n          (e) =>\n            `${e.at.slice(0, 10)} ${String(e.data?.activity ?? 'session')}${typeof e.data?.minutes === 'number' ? ` (${e.data.minutes} min)` : ''}${e.note ? ` — ${e.note}` : ''}`,\n        )\n        .join('\\n') || 'No sessions yet.'\n    : '';\n\ngezel.output({\n  streakDays: stats.streakDays,\n  thisWeek: weekCount,\n  weeklyTarget,\n  summary: listing || trainingLine(stats, weekCount, weeklyTarget),\n});\n"
+  }
+}

package/data/project-types/fi/fitness-coach/versions/1.0.1/mission.md

@@ -0,0 +1,7 @@
+- Build a training rhythm that holds: {{weeklyTarget}} session(s) a week toward
+  {{goal}}.
+- Every session gets logged the day it happens — the streak and the weekly
+  count come from the record, never from memory.
+- Consistency over intensity: a shrunk plan that survives a hard week beats an
+  ambitious one that dies in it.
+- Encouragement always, guilt never.

package/data/project-types/fi/fitness-coach/versions/1.0.1/pages/dashboard/index.html

@@ -0,0 +1,172 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="gezel-demo" content="standalone" />
+    <title>Fitness Coach</title>
+    <style>
+      :root {
+        color-scheme: light dark;
+        --bg: #faf7f2; --card: #fff; --ink: #2b2620; --muted: #7a7166;
+        --accent: #b5651d; --track: #ece5da; --good: #4a7c59;
+      }
+      @media (prefers-color-scheme: dark) {
+        :root {
+          --bg: #1c1a17; --card: #262320; --ink: #efe9e0; --muted: #a59a8c;
+          --accent: #e0894a; --track: #3a352f; --good: #7fae8d;
+        }
+      }
+      * { box-sizing: border-box; }
+      body { margin: 0; font: 15px/1.5 system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif; background: var(--bg); color: var(--ink); padding: 1.5rem 1.25rem; }
+      main { max-width: 620px; margin: 0 auto; }
+      h1 { font-family: Georgia, 'PT Serif', 'Times New Roman', serif; font-size: 1.35rem; font-weight: 600; margin: 0 0 0.15rem; }
+      .sub { color: var(--muted); font-size: 0.9rem; margin: 0 0 0.9rem; }
+      .stats { display: grid; grid-template-columns: 1fr 1fr; gap: 0.6rem; margin-bottom: 0.75rem; }
+      .stat { background: var(--card); border: 1px solid var(--track); border-radius: 10px; padding: 0.85rem 1rem; }
+      .stat .num { font-size: 1.9rem; font-weight: 700; font-variant-numeric: tabular-nums; }
+      .stat .num.good { color: var(--good); }
+      .stat .lbl { color: var(--muted); font-size: 0.78rem; text-transform: uppercase; letter-spacing: 0.05em; }
+      .week { background: var(--card); border: 1px solid var(--track); border-radius: 10px; padding: 0.85rem 1rem; margin-bottom: 0.75rem; }
+      .week h2, .recent h2 { font-size: 0.72rem; text-transform: uppercase; letter-spacing: 0.05em; color: var(--muted); margin: 0 0 0.5rem; }
+      .dots { display: flex; gap: 0.4rem; }
+      .dot { width: 22px; height: 22px; border-radius: 6px; background: var(--track); }
+      .dot.hit { background: var(--good); }
+      .week .note { color: var(--muted); font-size: 0.85rem; margin-top: 0.5rem; }
+      .recent { background: var(--card); border: 1px solid var(--track); border-radius: 10px; padding: 0.85rem 1rem; font-size: 0.9rem; }
+      .recent ul { margin: 0; padding-left: 1.05rem; }
+      .recent li { margin: 0.25rem 0; }
+      .recent .when { color: var(--muted); font-variant-numeric: tabular-nums; }
+      .empty { color: var(--muted); font-style: italic; }
++      .demo-banner {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 0.75rem;
+        margin: 0 0 0.85rem;
+        padding: 0.5rem 0.65rem;
+        border: 1px solid var(--accent, #8a5a2b);
+        border-radius: 6px;
+        background: color-mix(in srgb, var(--card, var(--surface, #fffdf8)) 88%, var(--accent, #8a5a2b));
+        color: var(--ink, #2b2620);
+        font-size: 0.8rem;
+      }
+      .demo-banner[hidden] { display: none; }
+      .demo-banner strong { font-weight: 700; }
+      .demo-reset {
+        flex: none;
+        padding: 0.25rem 0.5rem;
+        border: 1px solid var(--accent, #8a5a2b);
+        border-radius: 6px;
+        background: var(--card, var(--surface, #fffdf8));
+        color: var(--ink, #2b2620);
+        cursor: pointer;
+        font: inherit;
+      }
+      .demo-reset:hover { border-color: var(--ink, #2b2620); }
+    </style>
+  </head>
+  <body>
+    <main>
++      <div class="demo-banner" data-gezel-demo-banner hidden>
+        <span><strong>Demo mode</strong> — sample data stays in this page.</span>
+        <button type="button" class="demo-reset" onclick="location.reload()">Reset demo</button>
+      </div>
+      <h1 id="title">Fitness Coach</h1>
+      <p class="sub" id="sub">Loading the training log…</p>
+      <div class="stats">
+        <div class="stat"><div class="num good" id="streak">—</div><div class="lbl">Day streak</div></div>
+        <div class="stat"><div class="num" id="total">—</div><div class="lbl">Sessions all time</div></div>
+      </div>
+      <div class="week">
+        <h2>This week</h2>
+        <div class="dots" id="dots"></div>
+        <div class="note" id="weekNote"></div>
+      </div>
+      <div class="recent">
+        <h2>Recent sessions</h2>
+        <ul id="recent"><li class="empty">Nothing logged yet — tell your Coach about your first session.</li></ul>
+      </div>
+    </main>
+    <script>
+      (function () {
+        'use strict';
+        var parts = location.pathname.split('/').filter(Boolean);
+        var typeIdx = parts.indexOf('type');
+        var capability = typeIdx > 0 ? parts[typeIdx - 1] : null;
+        var projectId = typeIdx >= 0 ? parts[typeIdx + 1] : null;
+        var failedPolls = 0;
+        var DAY = 86400000;
+        var demoMode = !capability || !projectId;
+        var demoTraining = {
+          goal: 'a comfortable 10K',
+          weeklyTarget: 4,
+          events: [
+            { at: new Date(Date.now() - 6 * DAY).toISOString(), data: { activity: 'Easy run', minutes: 32 } },
+            { at: new Date(Date.now() - 4 * DAY).toISOString(), data: { activity: 'Mobility and strength', minutes: 25 } },
+            { at: new Date(Date.now() - 2 * DAY).toISOString(), data: { activity: 'Tempo intervals', minutes: 38 } },
+            { at: new Date().toISOString(), data: { activity: 'Recovery walk', minutes: 28 } },
+          ],
+        };
+        if (demoMode) document.querySelector('[data-gezel-demo-banner]').hidden = false;
+
+        function esc(s) { return String(s).replace(/[&<>"]/g, function (c) { return { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]; }); }
+        function utcDay(iso) { return iso.slice(0, 10); }
+        function weekStartMs(nowIso) {
+          var d = new Date(nowIso.slice(0, 10) + 'T00:00:00Z');
+          return d.getTime() - ((d.getUTCDay() + 6) % 7) * DAY;
+        }
+        function streakDays(events) {
+          if (!events.length) return 0;
+          var days = {};
+          var last = null;
+          events.forEach(function (e) { days[utcDay(e.at)] = true; if (last === null || e.at > last) last = e.at; });
+          var streak = 0;
+          var cursor = Date.parse(utcDay(last) + 'T00:00:00Z');
+          while (days[new Date(cursor).toISOString().slice(0, 10)]) { streak += 1; cursor -= DAY; }
+          return streak;
+        }
+
+        function render(doc) {
+          var events = Array.isArray(doc.events) ? doc.events : [];
+          var target = Number(doc.weeklyTarget);
+          if (!isFinite(target) || target <= 0) target = 0;
+          if (doc.goal) document.getElementById('title').textContent = 'Training toward: ' + doc.goal;
+          document.getElementById('sub').textContent = events.length ? events.length + ' session(s) on record' : 'The record starts with the first session.';
+          document.getElementById('streak').textContent = String(streakDays(events));
+          document.getElementById('total').textContent = String(events.length);
+
+          var start = weekStartMs(new Date().toISOString());
+          var week = events.filter(function (e) { return Date.parse(e.at) >= start; }).length;
+          var slots = Math.max(target, week, 1);
+          var dots = '';
+          for (var i = 0; i < slots; i++) dots += '<span class="dot' + (i < week ? ' hit' : '') + '"></span>';
+          document.getElementById('dots').innerHTML = dots;
+          document.getElementById('weekNote').textContent = target > 0
+            ? week + ' of ' + target + ' session(s)' + (week >= target ? ' — target met.' : '.')
+            : week + ' session(s) this week.';
+
+          if (events.length) {
+            document.getElementById('recent').innerHTML = events.slice(-8).reverse().map(function (e) {
+              var mins = e.data && isFinite(Number(e.data.minutes)) && Number(e.data.minutes) > 0 ? ' (' + Number(e.data.minutes) + ' min)' : '';
+              return '<li><span class="when">' + esc(utcDay(e.at)) + '</span> ' + esc((e.data && e.data.activity) || 'session') + mins + '</li>';
+            }).join('');
+          }
+        }
+
+        function poll() {
+          if (demoMode) { render(demoTraining); return Promise.resolve(); }
+          if (!capability || !projectId) return Promise.resolve();
+          return fetch('/preview/' + encodeURIComponent(capability) + '/workspace/' + encodeURIComponent(projectId) + '/training.json', { cache: 'no-store' })
+            .then(function (r) { if (!r.ok) throw new Error('poll ' + r.status); return r.json(); })
+            .then(function (next) { failedPolls = 0; render(next); })
+            .catch(function () {
+              failedPolls += 1;
+              if (failedPolls === 3 && window.parent !== window) window.parent.postMessage({ __gezelPageRefresh: true }, '*');
+            });
+        }
+        poll().then(function () { setInterval(function () { void poll(); }, 5000); });
+      })();
+    </script>
+  </body>
+</html>

package/data/project-types/fi/fitness-coach/versions/1.0.1/training.json

@@ -0,0 +1,6 @@
+{
+  "version": 1,
+  "goal": "{{goal}}",
+  "weeklyTarget": {{weeklyTarget}},
+  "events": []
+}

package/data/project-types/fl/flashcards/versions/1.0.1/about.md

@@ -0,0 +1,8 @@
+A spaced-repetition practice bench for **{{subject}}**.
+
+Your Studiemaat writes the cards — ask for them in chat, or let them propose
+cards when a weak spot shows. You review in the **Output** tab: flip the card,
+mark it got-it or missed, and the deck's schedule decides when each card comes
+back (daily, every three days, weekly, as you prove them).
+
+After each session your Studiemaat checks in on how it went.

package/data/project-types/fl/flashcards/versions/1.0.1/deck.json

@@ -0,0 +1,7 @@
+{
+  "version": 1,
+  "subject": "{{subject}}",
+  "cards": [],
+  "dueCardIds": [],
+  "updatedAt": "2026-07-18T00:00:00.000Z"
+}

package/data/project-types/fl/flashcards/versions/1.0.1/manifest.json

@@ -0,0 +1,167 @@
+{
+  "schemaVersion": 1,
+  "version": "1.0.1",
+  "releasedAt": "2026-08-01T00:00:00Z",
+  "meesterManaged": false,
+  "params": {
+    "type": "object",
+    "properties": {
+      "subject": {
+        "type": "string",
+        "title": "What are you learning?",
+        "description": "The deck's subject — e.g. Spanish vocabulary, AWS certification, organic chemistry.",
+        "default": "Spanish vocabulary"
+      }
+    },
+    "required": [
+      "subject"
+    ]
+  },
+  "nameTemplate": "{{subject}} Flashcards",
+  "aboutTemplate": "about.md",
+  "missionTemplate": "mission.md",
+  "gezels": [
+    {
+      "templateId": "study-buddy",
+      "voorman": true
+    }
+  ],
+  "scripts": {
+    "deck-store": "import { type InferredInput, defineScript, gezel } from '@bendyline/gezel-sdk';\n\nexport const meta = defineScript({\n  name: 'deck-store',\n  description:\n    \"Read and update the flashcard deck (deck.json). Call action:'add_cards' with a cards array ([{front, back}, ...]) to add practice cards; action:'state' to see due counts and box distribution; action:'list_deck' to read every card. The review page drives 'record_review' and 'finish_session' itself.\",\n  inputs: {\n    action: {\n      type: 'string',\n      description:\n        \"One of 'state', 'list_deck', 'add_cards', 'record_review', or 'finish_session'.\",\n      required: true,\n    },\n    cards: {\n      type: 'json',\n      description: 'For add_cards: an array of {front, back} objects.',\n    },\n    cardId: { type: 'string', description: \"For record_review: the card id, e.g. 'card-3'.\" },\n    verdict: { type: 'string', description: \"For record_review: 'got-it' or 'missed'.\" },\n    reviewed: { type: 'number', description: 'For finish_session: how many cards were reviewed.' },\n    missedIds: { type: 'json', description: 'For finish_session: array of card ids that were missed.' },\n  },\n  outputs: {\n    total: { type: 'number', description: 'Cards in the deck.' },\n    due: { type: 'number', description: 'Cards due for review now.' },\n    summary: { type: 'string', description: 'Human-readable deck or session summary.' },\n    missedList: { type: 'string', description: 'Fronts of the cards missed this session (finish_session).' },\n  },\n  requires: ['workspace.read', 'workspace.write'],\n} as const);\n\nconst input = gezel.input as InferredInput<typeof meta>;\n\n// ── leitner-rules-start ──\n// Pure Leitner-box scheduling (3 boxes). Box 1 reviews daily, box 2 every\n// 3 days, box 3 weekly. A got-it promotes (capped at 3); a miss goes back\n// to box 1. Never-reviewed cards are always due. Kept self-contained\n// between these sentinels so unit tests execute the shipped bytes.\n\nvar BOX_INTERVAL_DAYS = { 1: 1, 2: 3, 3: 7 };\nvar DAY_MS = 24 * 60 * 60 * 1000;\n\nfunction isDue(card, nowMs) {\n  if (!card.lastReviewedAt) return true;\n  var interval = BOX_INTERVAL_DAYS[card.box] || 1;\n  return nowMs - Date.parse(card.lastReviewedAt) >= interval * DAY_MS;\n}\n\nfunction computeDueIds(cards, nowMs) {\n  return cards\n    .filter(function (c) {\n      return isDue(c, nowMs);\n    })\n    .sort(function (a, b) {\n      if (a.box !== b.box) return a.box - b.box;\n      return a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : 0;\n    })\n    .map(function (c) {\n      return c.id;\n    });\n}\n\nfunction applyReview(card, verdict, nowIso) {\n  if (verdict === 'got-it') card.box = Math.min(3, card.box + 1);\n  else card.box = 1;\n  card.lastReviewedAt = nowIso;\n  card.stats = card.stats || { gotIt: 0, missed: 0 };\n  if (verdict === 'got-it') card.stats.gotIt += 1;\n  else card.stats.missed += 1;\n  return card;\n}\n\nfunction nextCardId(cards) {\n  var max = 0;\n  for (var i = 0; i < cards.length; i += 1) {\n    var m = /^card-(\\d+)$/.exec(cards[i].id);\n    if (m) max = Math.max(max, Number(m[1]));\n  }\n  return 'card-' + (max + 1);\n}\n// ── leitner-rules-end ──\n\nconst DECK_FILE = 'deck.json';\n\ninterface Card {\n  id: string;\n  front: string;\n  back: string;\n  box: number;\n  lastReviewedAt: string | null;\n  createdAt: string;\n  stats: { gotIt: number; missed: number };\n}\n\ninterface Deck {\n  version: number;\n  subject: string;\n  cards: Card[];\n  dueCardIds: string[];\n  updatedAt: string;\n}\n\nasync function load(): Promise<Deck> {\n  let raw: string;\n  try {\n    raw = await gezel.fs.read(DECK_FILE);\n  } catch {\n    return { version: 1, subject: 'your subject', cards: [], dueCardIds: [], updatedAt: new Date().toISOString() };\n  }\n  const parsed = JSON.parse(raw) as Partial<Deck>;\n  return {\n    version: 1,\n    subject: typeof parsed.subject === 'string' ? parsed.subject : 'your subject',\n    cards: Array.isArray(parsed.cards) ? (parsed.cards as Card[]) : [],\n    dueCardIds: [],\n    updatedAt: new Date().toISOString(),\n  };\n}\n\nasync function persist(deck: Deck): Promise<Deck> {\n  deck.dueCardIds = computeDueIds(deck.cards, Date.now());\n  deck.updatedAt = new Date().toISOString();\n  await gezel.fs.write(DECK_FILE, `${JSON.stringify(deck, null, 2)}\\n`);\n  return deck;\n}\n\nconst deck = await load();\ndeck.dueCardIds = computeDueIds(deck.cards, Date.now());\nlet summary = '';\nlet missedList = '';\n\nif (input.action === 'add_cards') {\n  const raw = Array.isArray(input.cards) ? input.cards : [];\n  const added: string[] = [];\n  for (const entry of raw) {\n    const front = typeof (entry as { front?: unknown }).front === 'string' ? (entry as { front: string }).front.trim() : '';\n    const back = typeof (entry as { back?: unknown }).back === 'string' ? (entry as { back: string }).back.trim() : '';\n    if (!front || !back) continue;\n    const card: Card = {\n      id: nextCardId(deck.cards),\n      front: front.slice(0, 300),\n      back: back.slice(0, 500),\n      box: 1,\n      lastReviewedAt: null,\n      createdAt: new Date().toISOString(),\n      stats: { gotIt: 0, missed: 0 },\n    };\n    deck.cards.push(card);\n    added.push(card.id);\n  }\n  if (added.length === 0) {\n    throw new Error(\"add_cards needs a non-empty 'cards' array of {front, back} objects.\");\n  }\n  await persist(deck);\n  summary = `Added ${added.length} card(s). ${deck.cards.length} in the deck, ${deck.dueCardIds.length} due now.`;\n} else if (input.action === 'record_review') {\n  if (!input.cardId || (input.verdict !== 'got-it' && input.verdict !== 'missed')) {\n    throw new Error(\"record_review needs 'cardId' and verdict 'got-it' or 'missed'.\");\n  }\n  const card = deck.cards.find((c) => c.id === input.cardId);\n  if (!card) throw new Error(`No card '${input.cardId}' in the deck.`);\n  applyReview(card, input.verdict, new Date().toISOString());\n  await persist(deck);\n  summary = `${card.id} marked ${input.verdict} (now box ${card.box}). ${deck.dueCardIds.length} still due.`;\n} else if (input.action === 'finish_session') {\n  const reviewed = typeof input.reviewed === 'number' ? input.reviewed : 0;\n  const missedIds = Array.isArray(input.missedIds) ? input.missedIds.map(String) : [];\n  const missedFronts = missedIds\n    .map((id) => deck.cards.find((c) => c.id === id)?.front)\n    .filter((f): f is string => typeof f === 'string');\n  missedList = missedFronts.length ? missedFronts.join(' | ') : '(none)';\n  summary = `Reviewed ${reviewed} card(s): ${reviewed - missedIds.length} got it, ${missedIds.length} missed. ${deck.dueCardIds.length} due next.`;\n} else if (input.action === 'list_deck') {\n  summary = deck.cards.length\n    ? deck.cards\n        .map((c) => `${c.id} [box ${c.box}] ${c.front} -> ${c.back}`)\n        .join('\\n')\n    : 'The deck is empty — add cards with add_cards.';\n} else if (input.action === 'state') {\n  const boxes = { 1: 0, 2: 0, 3: 0 } as Record<number, number>;\n  for (const c of deck.cards) boxes[c.box] = (boxes[c.box] ?? 0) + 1;\n  summary = deck.cards.length\n    ? `${deck.cards.length} card(s) on \"${deck.subject}\": ${deck.dueCardIds.length} due now. Boxes: ${boxes[1]} daily, ${boxes[2]} every-3-days, ${boxes[3]} weekly.`\n    : `The deck for \"${deck.subject}\" is empty — offer to write the first cards.`;\n} else {\n  throw new Error(\n    `Unknown action '${input.action}'. Use state, list_deck, add_cards, record_review, or finish_session.`,\n  );\n}\n\ngezel.output({\n  total: deck.cards.length,\n  due: deck.dueCardIds.length,\n  summary,\n  missedList,\n});\n"
+  },
+  "tools": [
+    {
+      "name": "add_cards",
+      "description": "Add flashcards to the deck. Pass a cards array of {front, back} objects — one fact per card.",
+      "script": "deck-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "cards": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "front": {
+                  "type": "string"
+                },
+                "back": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "front",
+                "back"
+              ]
+            },
+            "description": "The cards to add."
+          }
+        },
+        "required": [
+          "cards"
+        ]
+      },
+      "bind": {
+        "action": "add_cards"
+      }
+    },
+    {
+      "name": "deck_status",
+      "description": "See the deck: how many cards, how many due, and the box distribution.",
+      "script": "deck-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "state"
+      }
+    },
+    {
+      "name": "list_deck",
+      "description": "Read every card in the deck (id, box, front, back).",
+      "script": "deck-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "list_deck"
+      }
+    },
+    {
+      "name": "record_review",
+      "description": "The review page's per-card verdict.",
+      "script": "deck-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "cardId": {
+            "type": "string"
+          },
+          "verdict": {
+            "type": "string",
+            "enum": [
+              "got-it",
+              "missed"
+            ]
+          }
+        },
+        "required": [
+          "cardId",
+          "verdict"
+        ]
+      },
+      "bind": {
+        "action": "record_review"
+      }
+    },
+    {
+      "name": "finish_session",
+      "description": "The review page's end-of-session summary.",
+      "script": "deck-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "reviewed": {
+            "type": "number"
+          },
+          "missedIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "reviewed"
+        ]
+      },
+      "bind": {
+        "action": "finish_session"
+      },
+      "reaction": {
+        "gezel": "study-buddy",
+        "prompt": "The user finished a flashcard review session. {{output.summary}}\nMissed cards: {{output.missedList}}\nReply with ONE short encouraging line — specific beats generic. If any cards were missed, offer to add fresh practice cards that come at those same ideas from a new angle (add them with your deck capabilities if the user agrees)."
+      }
+    }
+  ],
+  "craftbooks": [],
+  "schedules": [],
+  "pages": {
+    "entry": "review/index.html",
+    "reads": [
+      {
+        "source": "workspace",
+        "path": "deck.json"
+      }
+    ],
+    "tools": [
+      "record_review",
+      "finish_session"
+    ]
+  },
+  "workspaceSeed": [
+    "deck.json"
+  ]
+}

package/data/project-types/fl/flashcards/versions/1.0.1/mission.md

@@ -0,0 +1,6 @@
+- A living deck on {{subject}}: a few sharp new cards whenever they're needed,
+  never bulk filler.
+- Due cards get reviewed most days; the page's schedule is the source of truth.
+- Every missed card gets another road in — fresh cards on the same idea from a
+  new angle, offered after the session.
+- Encouragement always, shame never: a miss is the system working.