@bendyline/gilde 0.1.7 → 0.1.8

package/data/project-types/ho/household-budget/versions/1.0.1/about.md

@@ -0,0 +1,6 @@
+The household ledger, kept honest. Tell your Penningmeester when money moves —
+"14.20 on groceries", "salary landed" — and it goes straight into the ledger on
+this machine. Nothing leaves your disk.
+
+The **Output** tab shows the month at a glance: in, out, net ({{currency}}), the
+biggest categories, and a quick-add box for the receipt in your hand.

package/data/project-types/ho/household-budget/versions/1.0.1/ledger.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "currency": "{{currency}}",
+  "entries": []
+}

package/data/project-types/ho/household-budget/versions/1.0.1/manifest.json

@@ -0,0 +1,163 @@
+{
+  "schemaVersion": 1,
+  "version": "1.0.1",
+  "releasedAt": "2026-08-01T00:00:00Z",
+  "meesterManaged": false,
+  "params": {
+    "type": "object",
+    "properties": {
+      "currency": {
+        "type": "string",
+        "title": "Currency",
+        "description": "Shown on the dashboard; entries are unit-agnostic.",
+        "default": "USD"
+      }
+    },
+    "required": [
+      "currency"
+    ]
+  },
+  "nameTemplate": "Household Budget",
+  "aboutTemplate": "about.md",
+  "missionTemplate": "mission.md",
+  "gezels": [
+    {
+      "templateId": "penningmeester",
+      "voorman": true
+    }
+  ],
+  "tools": [
+    {
+      "name": "add_expense",
+      "description": "Record spending the moment it happens (amount in ordinary units).",
+      "script": "budget-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "category": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "category"
+        ]
+      },
+      "bind": {
+        "action": "add_expense"
+      }
+    },
+    {
+      "name": "add_income",
+      "description": "Record money coming in.",
+      "script": "budget-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "category": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "category"
+        ]
+      },
+      "bind": {
+        "action": "add_income"
+      }
+    },
+    {
+      "name": "budget_status",
+      "description": "This month's shape: in, out, net, and the biggest categories.",
+      "script": "budget-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "status"
+      }
+    },
+    {
+      "name": "month_summary",
+      "description": "Summarize any month ('YYYY-MM').",
+      "script": "budget-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "month": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "month"
+        ]
+      },
+      "bind": {
+        "action": "month_summary"
+      }
+    },
+    {
+      "name": "record_expense",
+      "description": "The dashboard's quick-add expense entry.",
+      "script": "budget-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "category": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "category"
+        ]
+      },
+      "bind": {
+        "action": "add_expense"
+      }
+    }
+  ],
+  "craftbooks": [
+    "subscription-audit",
+    "month-close"
+  ],
+  "schedules": [],
+  "pages": {
+    "entry": "dashboard/index.html",
+    "reads": [
+      {
+        "source": "workspace",
+        "path": "ledger.json"
+      }
+    ],
+    "tools": [
+      "record_expense"
+    ]
+  },
+  "workspaceSeed": [
+    "ledger.json"
+  ],
+  "scripts": {
+    "budget-store": "import { type InferredInput, defineScript, gezel } from '@bendyline/gezel-sdk';\nimport { ledgerStore } from '@bendyline/gezel-sdk/stores';\n\nexport const meta = defineScript({\n  name: 'budget-store',\n  description:\n    \"Read and update the household ledger (ledger.json). Call action:'status' for this month's shape (in/out/net, top categories); 'add_expense' or 'add_income' the moment money moves (amount in ordinary units, e.g. 12.50); 'month_summary' with month 'YYYY-MM' for any past month.\",\n  inputs: {\n    action: {\n      type: 'string',\n      description: \"One of 'status', 'add_expense', 'add_income', or 'month_summary'.\",\n      required: true,\n    },\n    amount: { type: 'number', description: 'Amount in ordinary currency units, e.g. 12.50.' },\n    category: { type: 'string', description: \"Category, e.g. 'groceries', 'rent', 'salary'.\" },\n    note: { type: 'string', description: 'Short note on the entry.' },\n    month: { type: 'string', description: \"Month for month_summary, e.g. '2026-06'.\" },\n  },\n  outputs: {\n    entries: { type: 'number', description: 'Total ledger entries.' },\n    summary: { type: 'string', description: 'Human-readable money summary.' },\n    netCents: { type: 'number', description: 'Net for the summarized month, in cents.' },\n  },\n  requires: ['workspace.read', 'workspace.write'],\n} as const);\n\nconst input = gezel.input as InferredInput<typeof meta>;\n\n// ── budget-rules-start ──\n// Pure derivations shared with tests: cents conversion and the month\n// summary line, kept engine-side so the dashboard, the tools, and the\n// tests agree on one rendering.\n\nfunction toCents(amount) {\n  if (typeof amount !== 'number' || !isFinite(amount) || amount <= 0) return null;\n  return Math.round(amount * 100);\n}\n\nfunction fmtCents(cents) {\n  var sign = cents < 0 ? '-' : '';\n  var abs = Math.abs(cents);\n  return sign + Math.floor(abs / 100) + '.' + String(abs % 100).padStart(2, '0');\n}\n\nfunction topCategories(byCategory, kind, limit) {\n  return Object.entries(byCategory)\n    .map(function (pair) {\n      return { category: pair[0], cents: kind === 'out' ? pair[1].outCents : pair[1].inCents };\n    })\n    .filter(function (row) {\n      return row.cents > 0;\n    })\n    .sort(function (a, b) {\n      return b.cents - a.cents;\n    })\n    .slice(0, limit);\n}\n\nfunction monthLine(month, totals) {\n  var top = topCategories(totals.byCategory, 'out', 3)\n    .map(function (row) {\n      return row.category + ' ' + fmtCents(row.cents);\n    })\n    .join(', ');\n  return (\n    month +\n    ': in ' +\n    fmtCents(totals.inCents) +\n    ', out ' +\n    fmtCents(totals.outCents) +\n    ', net ' +\n    fmtCents(totals.netCents) +\n    (top ? '. Biggest: ' + top + '.' : '. No spending recorded.')\n  );\n}\n// ── budget-rules-end ──\n\nconst ledger = ledgerStore(gezel.fs, 'ledger.json');\nconst currentMonth = new Date().toISOString().slice(0, 7);\n\nif (input.action === 'add_expense' || input.action === 'add_income') {\n  const cents = toCents(input.amount);\n  if (cents === null) throw new Error(\"Pass a positive 'amount' in ordinary units, e.g. 12.50.\");\n  if (!input.category) throw new Error(\"Pass a 'category', e.g. 'groceries' or 'salary'.\");\n  await ledger.add({\n    amountCents: cents,\n    kind: input.action === 'add_expense' ? 'out' : 'in',\n    category: input.category.toLowerCase(),\n    ...(input.note ? { note: input.note } : {}),\n  });\n} else if (input.action !== 'status' && input.action !== 'month_summary') {\n  throw new Error(\n    `Unknown action '${input.action}'. Use status, add_expense, add_income, or month_summary.`,\n  );\n}\n\nconst month =\n  input.action === 'month_summary' && input.month ? input.month : currentMonth;\nconst totals = await ledger.totals({ month });\nconst all = await ledger.list();\n\ngezel.output({\n  entries: all.length,\n  summary: monthLine(month, totals),\n  netCents: totals.netCents,\n});\n"
+  }
+}

package/data/project-types/ho/household-budget/versions/1.0.1/mission.md

@@ -0,0 +1,6 @@
+- Every expense and income lands in the ledger the day it happens.
+- The month gets closed with a twenty-minute review: in, out, net, biggest
+  categories, one observation.
+- Quiet leaks get surfaced — recurring charges and drifting categories, with
+  figures attached, never a lecture.
+- The data never leaves this machine.

package/data/project-types/ho/household-budget/versions/1.0.1/pages/dashboard/index.html

@@ -0,0 +1,233 @@
+<!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>Household budget</title>
+    <style>
+      :root {
+        color-scheme: light dark;
+        --bg: #faf7f2; --card: #fff; --ink: #2b2620; --muted: #7a7166;
+        --accent: #b5651d; --track: #ece5da; --good: #4a7c59; --warn: #a4552e;
+      }
+      @media (prefers-color-scheme: dark) {
+        :root {
+          --bg: #1c1a17; --card: #262320; --ink: #efe9e0; --muted: #a59a8c;
+          --accent: #e0894a; --track: #3a352f; --good: #7fae8d; --warn: #d98a63;
+        }
+      }
+      * { 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: 760px; 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 1rem; }
+      .tiles { display: grid; grid-template-columns: repeat(3, 1fr); gap: 0.6rem; margin-bottom: 1rem; }
+      .tile { background: var(--card); border: 1px solid var(--track); border-radius: 10px; padding: 0.7rem 0.85rem; }
+      .tile .n { font-size: 1.35rem; font-weight: 700; color: var(--accent); line-height: 1.2; }
+      .tile .n.good { color: var(--good); }
+      .tile .n.warn { color: var(--warn); }
+      .tile .l { font-size: 0.72rem; color: var(--muted); text-transform: uppercase; letter-spacing: 0.05em; }
+      .cols { display: grid; grid-template-columns: 1fr 1fr; gap: 0.6rem; }
+      .panel { background: var(--card); border: 1px solid var(--track); border-radius: 10px; padding: 0.85rem 1rem; font-size: 0.85rem; }
+      .panel h2 { font-size: 0.72rem; text-transform: uppercase; letter-spacing: 0.05em; color: var(--muted); margin: 0 0 0.5rem; }
+      .bar-row { display: grid; grid-template-columns: 7.5rem 1fr 4.5rem; gap: 0.5rem; align-items: center; margin: 0.3rem 0; }
+      .bar-row .name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .bar { background: var(--track); border-radius: 4px; height: 10px; overflow: hidden; }
+      .bar > span { display: block; height: 100%; background: var(--accent); border-radius: 4px; }
+      .bar-row .amt { text-align: right; color: var(--muted); font-variant-numeric: tabular-nums; }
+      .entries { margin: 0; padding-left: 1.05rem; }
+      .entries li { margin: 0.25rem 0; color: var(--muted); }
+      .entries li strong { color: var(--ink); font-weight: 600; }
+      form { display: grid; grid-template-columns: 5.5rem 1fr auto; gap: 0.4rem; margin-top: 0.5rem; }
+      input { font: inherit; color: var(--ink); background: var(--bg); border: 1px solid var(--track); border-radius: 6px; padding: 0.35rem 0.5rem; min-width: 0; }
+      button { font: inherit; border: 1px solid var(--track); background: var(--card); color: var(--ink); border-radius: 6px; padding: 0.35rem 0.8rem; cursor: pointer; }
+      button:hover { border-color: var(--accent); }
+      button:disabled { opacity: 0.5; cursor: default; }
+      .banner { border: 1px solid var(--accent); border-radius: 6px; padding: 0.45rem 0.7rem; font-size: 0.85rem; margin-bottom: 0.75rem; display: none; }
+      .banner.show { display: block; }
+      .empty { color: var(--muted); font-style: italic; }
+      @media (max-width: 640px) { .cols { grid-template-columns: 1fr; } .tiles { grid-template-columns: 1fr 1fr; } }
++      .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>
+      <div class="banner" id="banner"></div>
+      <h1>Household budget</h1>
+      <p class="sub" id="sub">Loading the ledger…</p>
+      <div class="tiles">
+        <div class="tile"><div class="n good" id="t-in">—</div><div class="l">In this month</div></div>
+        <div class="tile"><div class="n warn" id="t-out">—</div><div class="l">Out this month</div></div>
+        <div class="tile"><div class="n" id="t-net">—</div><div class="l">Net</div></div>
+      </div>
+      <div class="cols">
+        <div class="panel">
+          <h2>Where it goes</h2>
+          <div id="cats"><p class="empty">No spending recorded this month.</p></div>
+        </div>
+        <div class="panel">
+          <h2>Recent entries</h2>
+          <ul class="entries" id="entries"><li class="empty">Nothing yet — tell your Penningmeester, or use quick add.</li></ul>
+          <h2 style="margin-top: 0.9rem">Quick add expense</h2>
+          <form id="quick">
+            <input id="q-amount" type="number" step="0.01" min="0.01" placeholder="12.50" required />
+            <input id="q-category" type="text" placeholder="groceries" required />
+            <button type="submit" id="q-go">Add</button>
+          </form>
+        </div>
+      </div>
+    </main>
+    <script>
+      (function () {
+        'use strict';
+        var gezelPage = (function () {
+          var seq = 0; var pending = {};
+          window.addEventListener('message', function (event) {
+            var d = event.data;
+            if (!d || d.__gezelPageResult !== true || typeof d.id !== 'string') return;
+            var entry = pending[d.id]; if (!entry) return;
+            delete pending[d.id]; clearTimeout(entry.timer);
+            if (d.ok) entry.resolve(d); else entry.reject(new Error(d.error || 'invoke failed'));
+          });
+          return {
+            embedded: function () { return demoMode || Boolean(capability && projectId); },
+            invoke: function (tool, input) {
+              return new Promise(function (resolve, reject) {
+                if (demoMode) { resolve(demoInvoke(tool, input)); return; }
+                if (window.parent === window) { reject(new Error('not embedded in Gezel')); return; }
+                seq += 1; var id = 'pi-' + Date.now() + '-' + seq;
+                pending[id] = { resolve: resolve, reject: reject, timer: setTimeout(function () { delete pending[id]; reject(new Error('invoke timed out')); }, 45000) };
+                window.parent.postMessage({ __gezelPageInvoke: true, id: id, tool: tool, input: input || {} }, '*');
+              });
+            },
+            refresh: function () { if (!demoMode && window.parent !== window) window.parent.postMessage({ __gezelPageRefresh: true }, '*'); },
+          };
+        })();
+
+        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 demoMode = !capability || !projectId;
+        var demoLedger = { currency: 'USD', entries: [
+          { kind: 'in', amountCents: 520000, category: 'Income', note: 'Monthly pay', at: new Date().toISOString() },
+          { kind: 'out', amountCents: 146000, category: 'Housing', note: 'Rent', at: new Date().toISOString() },
+          { kind: 'out', amountCents: 58200, category: 'Groceries', note: 'Weekly shops', at: new Date().toISOString() },
+          { kind: 'out', amountCents: 22400, category: 'Transport', note: 'Train and fuel', at: new Date().toISOString() },
+          { kind: 'out', amountCents: 18900, category: 'Eating out', note: 'Dinner with friends', at: new Date().toISOString() },
+        ] };
+        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 fmt(cents) {
+          var sign = cents < 0 ? '-' : '';
+          var abs = Math.abs(cents);
+          return sign + Math.floor(abs / 100) + '.' + String(abs % 100).padStart(2, '0');
+        }
+        function setBanner(text) { var el = document.getElementById('banner'); el.textContent = text || ''; el.className = text ? 'banner show' : 'banner'; }
+        function demoInvoke(tool, input) {
+          if (tool !== 'record_expense') throw new Error('Unknown demo action: ' + tool);
+          demoLedger.entries.push({
+            kind: 'out',
+            amountCents: Math.round(Number(input.amount) * 100),
+            category: input.category,
+            at: new Date().toISOString(),
+          });
+          return { ok: true };
+        }
+
+        function render(ledger) {
+          var month = new Date().toISOString().slice(0, 7);
+          var entries = (ledger.entries || []).filter(function (e) { return typeof e.at === 'string'; });
+          var monthEntries = entries.filter(function (e) { return e.at.slice(0, 7) === month; });
+          var inC = 0, outC = 0; var byCat = {};
+          monthEntries.forEach(function (e) {
+            if (e.kind === 'in') inC += e.amountCents;
+            else { outC += e.amountCents; byCat[e.category] = (byCat[e.category] || 0) + e.amountCents; }
+          });
+          document.getElementById('sub').textContent = month + ' · ' + (ledger.currency || '') + ' · ' + entries.length + ' entr' + (entries.length === 1 ? 'y' : 'ies') + ' all time';
+          document.getElementById('t-in').textContent = fmt(inC);
+          document.getElementById('t-out').textContent = fmt(outC);
+          var net = document.getElementById('t-net');
+          net.textContent = fmt(inC - outC);
+          net.className = 'n ' + (inC - outC >= 0 ? 'good' : 'warn');
+
+          var cats = Object.entries(byCat).sort(function (a, b) { return b[1] - a[1]; }).slice(0, 7);
+          var max = cats.length ? cats[0][1] : 1;
+          document.getElementById('cats').innerHTML = cats.length
+            ? cats.map(function (pair) {
+                return '<div class="bar-row"><span class="name">' + esc(pair[0]) + '</span><span class="bar"><span style="width:' + Math.max(4, Math.round((pair[1] / max) * 100)) + '%"></span></span><span class="amt">' + fmt(pair[1]) + '</span></div>';
+              }).join('')
+            : '<p class="empty">No spending recorded this month.</p>';
+
+          var recent = entries.slice(-7).reverse();
+          if (recent.length) {
+            document.getElementById('entries').innerHTML = recent.map(function (e) {
+              return '<li><strong>' + (e.kind === 'in' ? '+' : '-') + fmt(e.amountCents) + '</strong> ' + esc(e.category) + (e.note ? ' — ' + esc(e.note) : '') + '</li>';
+            }).join('');
+          }
+        }
+
+        function poll() {
+          if (demoMode) { render(demoLedger); return Promise.resolve(); }
+          if (!capability || !projectId) return Promise.resolve();
+          return fetch('/preview/' + encodeURIComponent(capability) + '/workspace/' + encodeURIComponent(projectId) + '/ledger.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) gezelPage.refresh(); });
+        }
+
+        document.getElementById('quick').addEventListener('submit', function (ev) {
+          ev.preventDefault();
+          var amount = parseFloat(document.getElementById('q-amount').value);
+          var category = document.getElementById('q-category').value.trim();
+          if (!(amount > 0) || !category) return;
+          var btn = document.getElementById('q-go');
+          btn.disabled = true;
+          gezelPage.invoke('record_expense', { amount: amount, category: category })
+            .then(function () {
+              setBanner('');
+              document.getElementById('q-amount').value = '';
+              document.getElementById('q-category').value = '';
+              return poll();
+            })
+            .catch(function (err) { setBanner(String(err && err.message ? err.message : err)); })
+            .then(function () { btn.disabled = false; });
+        });
+
+        poll().then(function () { setInterval(function () { void poll(); }, 5000); });
+      })();
+    </script>
+  </body>
+</html>

package/data/project-types/ho/household-manual/versions/1.0.1/about.md

@@ -0,0 +1,7 @@
+The operations book for {{home}}. Tell your Huismeester about the systems that
+need regular care — the furnace, the gutters, the smoke alarms — and each gets a
+card: what it is, where it lives, what care it needs, how often. Maintenance
+gets logged; the schedule takes care of itself.
+
+The **Output** tab shows what the house needs right now: care due and anything
+flagged for attention.

package/data/project-types/ho/household-manual/versions/1.0.1/manifest.json

@@ -0,0 +1,152 @@
+{
+  "schemaVersion": 1,
+  "version": "1.0.1",
+  "releasedAt": "2026-08-01T00:00:00Z",
+  "meesterManaged": false,
+  "params": {
+    "type": "object",
+    "properties": {
+      "home": {
+        "type": "string",
+        "title": "What kind of home?",
+        "description": "e.g. 'a 1960s house', 'a third-floor apartment'.",
+        "default": "our home"
+      }
+    },
+    "required": [
+      "home"
+    ]
+  },
+  "nameTemplate": "Household Manual",
+  "aboutTemplate": "about.md",
+  "missionTemplate": "mission.md",
+  "gezels": [
+    {
+      "templateId": "huismeester",
+      "voorman": true
+    }
+  ],
+  "tools": [
+    {
+      "name": "record_system",
+      "description": "Add a system or appliance card (with a care interval in days when known).",
+      "script": "house-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "location": {
+            "type": "string"
+          },
+          "care": {
+            "type": "string"
+          },
+          "intervalDays": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      },
+      "bind": {
+        "action": "record_system"
+      }
+    },
+    {
+      "name": "log_maintenance",
+      "description": "Log that care happened (resets the due clock).",
+      "script": "house-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          }
+        }
+      },
+      "bind": {
+        "action": "log_maintenance"
+      }
+    },
+    {
+      "name": "flag_attention",
+      "description": "Flag a problem on a system (a noise, a drip, a trip).",
+      "script": "house-store",
+      "inputs": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "note"
+        ]
+      },
+      "bind": {
+        "action": "flag_attention"
+      }
+    },
+    {
+      "name": "house_status",
+      "description": "What the house needs: care due and flagged problems.",
+      "script": "house-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "status"
+      }
+    },
+    {
+      "name": "house_list",
+      "description": "Read every system card.",
+      "script": "house-store",
+      "inputs": {
+        "type": "object",
+        "properties": {}
+      },
+      "bind": {
+        "action": "house_list"
+      }
+    }
+  ],
+  "craftbooks": [
+    "seasonal-maintenance-sweep"
+  ],
+  "schedules": [],
+  "pages": {
+    "entry": "dashboard/index.html",
+    "reads": [
+      {
+        "source": "workspace",
+        "path": "systems.json"
+      }
+    ]
+  },
+  "workspaceSeed": [
+    "systems.json"
+  ],
+  "scripts": {
+    "house-store": "import { type InferredInput, defineScript, gezel } from '@bendyline/gezel-sdk';\nimport { rosterStore } from '@bendyline/gezel-sdk/stores';\n\nexport const meta = defineScript({\n  name: 'house-store',\n  description:\n    \"Read and update the home's system cards (systems.json). Call action:'status' for what's due or flagged; 'record_system' when an appliance/system comes up (with care interval in days when known); 'log_maintenance' when care happens; 'flag_attention' for problems; 'house_list' to read every card.\",\n  inputs: {\n    action: {\n      type: 'string',\n      description:\n        \"One of 'status', 'record_system', 'log_maintenance', 'flag_attention', or 'house_list'.\",\n      required: true,\n    },\n    name: { type: 'string', description: \"System name, e.g. 'Furnace', 'Smoke alarms'.\" },\n    kind: { type: 'string', description: 'What it is (appliance, safety, structure, utility).' },\n    location: { type: 'string', description: 'Where it lives in the house.' },\n    care: { type: 'string', description: \"The care it needs, e.g. 'replace filter'.\" },\n    intervalDays: { type: 'number', description: 'Care interval in days, when known.' },\n    note: { type: 'string', description: 'Maintenance or attention note.' },\n    id: { type: 'string', description: \"System id, e.g. 'sys-2'.\" },\n  },\n  outputs: {\n    systems: { type: 'number', description: 'System cards in the manual.' },\n    due: { type: 'number', description: 'Systems with care due.' },\n    flagged: { type: 'number', description: 'Systems flagged for attention.' },\n    summary: { type: 'string', description: 'What the house needs.' },\n  },\n  requires: ['workspace.read', 'workspace.write'],\n} as const);\n\nconst input = gezel.input as InferredInput<typeof meta>;\n\n// ── house-rules-start ──\n// Pure derivations over rosterStore-shaped system cards: statuses are\n// ok -> attention; \"due\" derives from lastDoneAt + intervalDays.\n\nvar DAY_MS = 24 * 60 * 60 * 1000;\n\nfunction isDue(record, nowMs) {\n  var f = record.fields || {};\n  if (typeof f.intervalDays !== 'number' || f.intervalDays <= 0) return false;\n  var last = typeof f.lastDoneAt === 'string' ? Date.parse(f.lastDoneAt) : Date.parse(record.createdAt);\n  return isFinite(last) && nowMs - last >= f.intervalDays * DAY_MS;\n}\n\nfunction houseShape(records, nowMs) {\n  var due = [];\n  var flagged = [];\n  records.forEach(function (r) {\n    if (isDue(r, nowMs)) due.push(r);\n    if (r.status === 'attention') flagged.push(r);\n  });\n  return { due: due, flagged: flagged };\n}\n\nfunction houseLine(records, nowMs) {\n  var shape = houseShape(records, nowMs);\n  var names = function (rows) {\n    return rows\n      .map(function (r) {\n        return (r.fields && r.fields.name) || r.id;\n      })\n      .join(', ');\n  };\n  if (records.length === 0) return 'No systems recorded yet — start with the ones that need regular care.';\n  var bits = [];\n  if (shape.due.length) bits.push('care due: ' + names(shape.due));\n  if (shape.flagged.length) bits.push('flagged: ' + names(shape.flagged));\n  return records.length + ' system(s) on record. ' + (bits.length ? bits.join('; ') + '.' : 'Nothing due — the house is quiet.');\n}\n// ── house-rules-end ──\n\nconst house = rosterStore(gezel.fs, 'systems.json', {\n  stages: ['ok', 'attention'],\n  idPrefix: 'sys',\n});\n\nasync function resolveSystem(): Promise<string> {\n  if (input.id) return input.id;\n  if (input.name) {\n    const wanted = input.name.toLowerCase();\n    const matches = (await house.list()).filter(\n      (r) => String(r.fields.name ?? '').toLowerCase() === wanted,\n    );\n    if (matches.length === 1) return matches[0]!.id;\n  }\n  throw new Error(\"Pass 'id' (e.g. 'sys-2') or an exact system 'name'.\");\n}\n\nif (input.action === 'record_system') {\n  if (!input.name) throw new Error(\"record_system needs 'name'.\");\n  await house.add({\n    status: 'ok',\n    fields: {\n      name: input.name,\n      ...(input.kind ? { kind: input.kind } : {}),\n      ...(input.location ? { location: input.location } : {}),\n      ...(input.care ? { care: input.care } : {}),\n      ...(typeof input.intervalDays === 'number' ? { intervalDays: input.intervalDays } : {}),\n      lastDoneAt: new Date().toISOString(),\n    },\n  });\n} else if (input.action === 'log_maintenance') {\n  const id = await resolveSystem();\n  await house.update(id, {\n    fields: { lastDoneAt: new Date().toISOString() },\n    ...(input.note ? { note: input.note } : {}),\n  });\n  await house.transition(id, 'ok');\n} else if (input.action === 'flag_attention') {\n  const id = await resolveSystem();\n  await house.transition(id, 'attention', input.note ? { note: input.note } : {});\n} else if (input.action !== 'status' && input.action !== 'house_list') {\n  throw new Error(\n    `Unknown action '${input.action}'. Use status, record_system, log_maintenance, flag_attention, or house_list.`,\n  );\n}\n\nconst records = await house.list();\nconst shape = houseShape(records, Date.now());\nconst listing =\n  input.action === 'house_list'\n    ? records\n        .map(\n          (r) =>\n            `${r.id} [${r.status}${isDue(r, Date.now()) ? ', due' : ''}] ${String(r.fields.name ?? '?')}${r.fields.location ? ` — ${String(r.fields.location)}` : ''}${r.fields.care ? ` (${String(r.fields.care)}${r.fields.intervalDays ? ` every ${String(r.fields.intervalDays)}d` : ''})` : ''}`,\n        )\n        .join('\\n') || 'No systems recorded yet.'\n    : '';\n\ngezel.output({\n  systems: records.length,\n  due: shape.due.length,\n  flagged: shape.flagged.length,\n  summary: listing || houseLine(records, Date.now()),\n});\n"
+  }
+}

package/data/project-types/ho/household-manual/versions/1.0.1/mission.md

@@ -0,0 +1,8 @@
+- Every system that needs regular care has a card with its interval; nothing
+  relies on memory.
+- Care gets logged the day it happens; "what does the house need?" is answered
+  from the record, not a generic checklist.
+- Problems get flagged on the system's card the day they're noticed, so repairs
+  start from history.
+- Safety honesty: gas, mains electricity, and structure always get the "call a
+  professional" line when it belongs.