Todo Sweeper - Recent Pages

Environment variable	Value
\n `{setting.envVar}`\n \n {setting.description}\n {setting.defaultValue !== null && (\n <>\n {\" \"}\n Default: `{setting.defaultValue}`\n \n )}\n	\n {setting.value !== null ? (\n `{setting.value}`\n ) : (\n \"not set\"\n )}\n

`, `

`, ``, etc.)\n- **Automatic styling** - Beautiful design out of the box\n- **CDN delivery** - Single `` tag, no build step\n\n### Rules\n\n❌ **NEVER use CSS class names** (no `className` attributes)\n❌ **NEVER use TailwindCSS, Bootstrap, or other class-based frameworks**\n✅ **ALWAYS use semantic HTML elements**\n✅ **Use inline styles sparingly** - Only for dynamic/conditional styling\n\n### Semantic HTML Elements\n\nUse these semantic elements - Pico styles them automatically:\n\n**Layout:**\n- `` - Main content container\n- `` - Self-contained content (cards, sections)\n- `` - Thematic grouping of content\n- ``, `` - Page/section headers and footers\n- `` - Sidebar content\n\n**Typography:**\n- `` through ` ` - Headings\n- `` - Paragraphs\n- `` - Bold/important text\n- `` - Italic/emphasized text\n- `` - Fine print\n- `` - Highlighted text\n- `` - Inline code\n- ` ` - Code blocks\n- `` - Keyboard input / tags\n\n**Lists:**\n- ``, ``, `` - Lists\n- ``, ``, ` ` - Definition lists\n\n**Forms:**\n- ``, ``, `<select>` - Form inputs\n- `<button>` - Buttons\n- `<label>` - Form labels\n- Use `aria-busy` attribute for loading states on buttons\n\n**Links & Media:**\n- `<a>` - Links\n- `<time>` - Dates and times\n- `<figure>`, `<figcaption>` - Images with captions\n\n### Example Patterns\n\n**Card layout:**\n```tsx\n<article>\n <h2>Card Title</h2>\n <p>Card content goes here.</p>\n <button>Action</button>\n</article>\n```\n\n**Form with loading state:**\n```tsx\n<div style={{ display: 'flex', gap: '1rem' }}>\n <input type=\"text\" placeholder=\"Enter value\" style={{ flex: 1 }} />\n <button disabled={loading} aria-busy={loading}>\n Submit\n </button>\n</div>\n```\n\n**Error message:**\n```tsx\n{error && <mark>{error}</mark>}\n```\n\n**Tags/badges:**\n```tsx\n<kbd>Tag 1</kbd> <kbd>Tag 2</kbd>\n```\n\n**Conditional styling:**\n```tsx\n<span style={checked ? { textDecoration: 'line-through', opacity: 0.6 } : undefined}>\n Task text\n</span>\n```\n\n### Loading Pico CSS\n\nAlready included in `frontend/index.html`:\n\n```html\n<link href=\"https://cdn.jsdelivr.net/npm/@picocss/pico@2.1.1/css/pico.classless.min.css\" rel=\"stylesheet\" />\n```\n\n## Shared Code (`shared/`)\n\n**Types** (`shared/types.ts`):\n- All TypeScript interfaces shared between frontend/backend\n- Notion data structures\n- API request/response types\n- Common data models\n\n**Utils** (`shared/utils.ts`):\n- Pure functions that work in both Deno (backend) and browser (frontend)\n- ❌ NEVER use Deno APIs (won't work in browser)\n- ✅ Only use standard JavaScript/TypeScript\n\n## Environment Variables\n\nRequired environment variables for this val:\n\n- `NOTION_API_KEY` - Notion integration token\n- `FIRECRAWLER_API_KEY` - Firecrawler service (if used)\n- Additional service API keys as needed\n\n**Access via**: `Deno.env.get('VAR_NAME')`\n\n**NEVER hardcode secrets** - always use environment variables\n\n### Logging Configuration\n\nControl log verbosity via `LOG_LEVEL` environment variable:\n\n| Level | Description |\n|-------|-------------|\n| `error` | Only errors |\n| `warn` | Errors and warnings |\n| `info` | Errors, warnings, and summary info (default, recommended for production) |\n| `debug` | All logs including verbose per-item details (useful for development) |\n\n**Example**:\n```bash\n# Production (quiet, only summaries)\nLOG_LEVEL=info\n\n# Development (verbose, all details)\nLOG_LEVEL=debug\n```\n\nThe logger utility is in `backend/utils/logger.ts` and provides: `logger.error()`, `logger.warn()`, `logger.info()`, `logger.debug()`.\n\n### Notion Property Overrides\n\nOverride default property names via env vars. Defaults are in `/backend/utils/notionConfig.ts`.\n\n**Pattern**: `TODOS_PROP_{SCREAMING_SNAKE_KEY}`\n\n**Logic**:\n- Not set → use default\n- Empty string → disable (null)\n- Set to value → use that value\n\n**Todos Database Properties** (`TODOS_PROP_*`):\n| Env Var | Default | Key |\n|---------|---------|-----|\n| TODOS_PROP_NAME | Name | name |\n| TODOS_PROP_SOURCE_BLOCK_ID | Source block ID | sourceBlockId |\n| TODOS_PROP_SOURCE_BLOCK_URL | Source block URL | sourceBlockUrl |\n| TODOS_PROP_SOURCE_PAGE_URL | Source page URL | sourcePageUrl |\n| TODOS_PROP_SOURCE_LAST_EDITED_TIME | Source last edited time | sourceLastEditedTime |\n| TODOS_PROP_SOURCE_AUTHOR | Source author | sourceAuthor |\n| TODOS_PROP_SOURCE_TEXT | Source text | sourceText |\n| TODOS_PROP_OWNER | Owner | owner |\n| TODOS_PROP_OTHER_PEOPLE | Other people | otherPeople |\n| TODOS_PROP_DUE_DATE | Due date | dueDate |\n| TODOS_PROP_LINKS | Links | links |\n| TODOS_PROP_STATUS | (disabled) | status |\n\n**Examples**:\n```bash\n# Override property names\nTODOS_PROP_DUE_DATE=Deadline\n\n# Enable checkbox status sync\n# - Checked todos → \"Done\" (or first matching done option)\n# - Unchecked todos → first non-done option (e.g., \"Not started\")\n# Auto-detects property type (status, select, checkbox) and finds options\nTODOS_PROP_STATUS=Status\n\n# Disable a property\nTODOS_PROP_OWNER=\n```\n\n## Data Validation\n\nValidate request data in **controllers**, not routes:\n\n```typescript\nif (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n}\n```\n\n**Check:**\n- Required fields exist\n- Types are correct\n- Formats are valid\n- Values are within expected ranges\n\n**Return helpful error messages** with `details` field\n\n## Response Filtering\n\n**Filter sensitive data in controllers** before returning:\n\n- Remove button properties from Notion data\n- Don't expose internal IDs or tokens\n- Clean up API responses before sending to frontend\n- Strip unnecessary metadata\n\n**Example:**\n```typescript\n// Remove sensitive properties\nconst filtered = {\n ...notionData,\n properties: Object.entries(notionData.properties)\n .filter(([key, value]) => value.type !== 'button')\n .reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {})\n};\n```\n\n## Questions to Ask User\n\nWhen the user requests a new feature, clarify:\n\n1. **Is this a webhook handler or API endpoint?**\n - Webhook → `routes/tasks/`\n - API → `routes/api/`\n\n2. **What external service needs integration?**\n - New service → create `backend/services/[name].ts`\n\n3. **What data needs to be saved back to Notion?**\n - Update Notion → use/extend `notionService.ts`\n\n4. **Does this need authentication?**\n - Protected → apply `authCheck` middleware\n\n5. **Is this frontend-facing?**\n - Yes → create React component in `frontend/components/`\n\n## Common Patterns Checklist\n\nBefore implementing, verify:\n\n- ✅ Following 3-layer architecture (Route → Controller → Service)\n- ✅ Routes only handle HTTP, no business logic\n- ✅ Controllers return standardized `{success, data, error}` structure\n- ✅ Services handle external API calls\n- ✅ Never skipping layers\n- ✅ TypeScript types defined in `shared/types.ts`\n- ✅ Environment variables used for secrets\n- ✅ Error handling at each layer\n- ✅ Validation in controllers\n- ✅ Sensitive data filtered before returning\n\n## Integration with AGENTS.md\n\n**Use AGENTS.md for:**\n- Val Town platform requirements\n- Deno-specific patterns\n- Standard library usage\n- React configuration\n- Import patterns (esm.sh)\n- Platform limitations\n\n**Use CLAUDE.md (this file) for:**\n- This val's architecture\n- MVC layer separation\n- Notion integration patterns\n- External service integration\n- File organization\n- Response formats\n\n## Entry Point\n\n`main.http.tsx` is the HTTP entry point:\n- Exports `app.fetch` for Val Town\n- Uses Hono for routing\n- Serves static frontend assets\n- Mounts API routes at `/api`\n- Includes error handler\n\n**Always mount new routes in main.http.tsx:**\n```typescript\nimport { taskRoutes } from './backend/routes/tasks/index.ts';\n\napp.route('/tasks', taskRoutes);\n```\n\n## Hono Framework Patterns\n\nThis val uses **Hono** as the web framework. Follow these patterns:\n\n### Importing Hono\n\n```typescript\nimport { Hono } from \"npm:hono@4\";\nimport { Context, Next } from \"npm:hono@4\";\n```\n\n**Note**: Use `npm:` specifier for backend-only packages (better performance, modern Deno way).\n\n### Creating Route Modules\n\nWhen creating route modules (e.g., `backend/routes/api/pages.ts`):\n\n```typescript\nimport { Hono } from \"npm:hono@4\";\nimport * as pageController from '../../controllers/pageController.ts';\n\nconst pages = new Hono();\n\n// GET /api/pages/:id\npages.get('/:id', async (c) => {\n const pageId = c.req.param('id');\n const result = await pageController.getPage(pageId);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\n// POST /api/pages/:id\npages.post('/:id', async (c) => {\n const pageId = c.req.param('id');\n const body = await c.req.json();\n\n const result = await pageController.updatePage(pageId, body.properties);\n\n if (!result.success) {\n return c.json({ error: result.error, details: result.details }, 400);\n }\n\n return c.json(result.data);\n});\n\nexport default pages;\n```\n\n### Mounting Routes\n\nCreate an index file for each route directory (e.g., `backend/routes/api/index.ts`):\n\n```typescript\nimport { Hono } from \"npm:hono@4\";\nimport pages from './pages.ts';\n\nconst api = new Hono();\n\napi.route('/pages', pages);\n// Add more routes as needed\n\nexport default api;\n```\n\nThen mount in `main.http.tsx`:\n\n```typescript\nimport api from './backend/routes/api/index.ts';\napp.route('/api', api);\n```\n\n### Accessing Request Data\n\n```typescript\n// URL params\nconst id = c.req.param('id');\n\n// Query params\nconst query = c.req.query('q');\n\n// Headers\nconst apiKey = c.req.header('x-api-key');\n\n// JSON body\nconst body = await c.req.json();\n\n// Form data\nconst formData = await c.req.formData();\n```\n\n### Returning Responses\n\n```typescript\n// JSON response\nreturn c.json({ data: 'value' });\n\n// JSON with status code\nreturn c.json({ error: 'Not found' }, 404);\n\n// HTML response\nreturn c.html('<h1>Hello</h1>');\n\n// Plain text\nreturn c.text('Hello');\n\n// Redirect (use this pattern, not Response.redirect)\nreturn new Response(null, { status: 302, headers: { Location: '/new-url' }});\n```\n\n### Middleware\n\nApply middleware to routes:\n\n```typescript\nimport { authCheck } from '../authCheck.ts';\n\n// Apply to single route\npages.post('/:id', authCheck, async (c) => {\n // Protected route logic\n});\n\n// Apply to all routes in this module\npages.use('*', authCheck);\n```\n\n### Error Handler\n\nAlready configured in `main.http.tsx`:\n\n```typescript\napp.onError((err, c) => {\n throw err; // Re-throw to see full stack trace\n});\n```\n\n### Static File Serving\n\nAlready configured in `main.http.tsx`:\n\n```typescript\nimport { serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n### Route Organization Example\n\n```\nbackend/routes/\n├── api/\n│ ├── index.ts # Mounts all API routes\n│ ├── pages.ts # /api/pages/* endpoints\n│ └── databases.ts # /api/databases/* endpoints\n├── tasks/\n│ ├── index.ts # Mounts all webhook routes\n│ └── notion.ts # /tasks/notion webhook handler\n├── views/\n│ └── dashboard.ts # /views/dashboard page\n└── authCheck.ts # Auth middleware\n```\n",[],[728],{"_106":735,"_97":599,"_168":736,"_170":-5,"_171":149,"_172":737,"_174":22,"_108":738,"_102":263,"_176":190,"_178":739,"_179":22,"_180":-5,"_181":740,"_100":741},"072eaa92-02c0-11f1-b363-42dde27851f2","019a26dc-99bf-7269-a8f6-707670e63f81",419,["D",1770315920249],"# Notion Todo Sync System\n\nA Val Town application that automatically syncs Notion checkbox todos (`to_do` blocks) to a database. Extracts structured data from your checkboxes, stores it in blob storage, and syncs to a Notion database with intelligent owner resolution and relation mapping.\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Project Structure](#project-structure)\n- [MVC Architecture](#mvc-architecture)\n- [Search Workflow](#search-workflow)\n- [Block Type Handling](#block-type-handling)\n- [Validation & Auto-Assignment Rules](#validation--auto-assignment-rules)\n- [Endpoints](#endpoints)\n- [Cron Jobs](#cron-jobs)\n- [Caching](#caching)\n- [Environment Variables](#environment-variables)\n- [Search Configuration](#search-configuration)\n- [Context Gathering & Assignment Logic](#context-gathering--assignment-logic)\n- [Relation Mapping](#relation-mapping)\n- [Owner Resolution](#owner-resolution)\n- [Project Matching](#project-matching)\n\n## Overview\n\nThis system automatically captures checkbox todos from your Notion pages and syncs them to a centralized database:\n\n1. **Search**: Scans recent Notion pages for `to_do` blocks (checkboxes)\n2. **Extract**: Captures block content including @mentions and dates\n3. **Validate**: Filters out blocks that are too short (< 5 words by default)\n4. **Enrich**: Captures author and dates for AI resolution during sync\n5. **Store**: Saves to Val Town blob storage with timestamp tracking and sync metadata\n6. **Optimize**: Skips already-synced items to reduce API calls by 90%+\n7. **Sync**: Creates/updates Notion database pages\n\n> **Note**: Keyword-based search can be added on top of block type search. See [Search Configuration](#search-configuration).\n\n## Project Structure\n\n```\n├── backend/\n│ ├── controllers/ # Business logic\n│ │ ├── pageController.ts # Page operations\n│ │ ├── todoController.ts # Block/keyword search logic\n│ │ ├── todoSaveController.ts # Blob → Notion sync\n│ │ └── todoOrchestrationController.ts # Batch workflow\n│ ├── crons/ # Time-based triggers\n│ │ ├── todoSearch.cron.ts # Periodic todo search\n│ │ └── todoSync.cron.ts # Periodic database sync\n│ ├── routes/ # HTTP handlers\n│ │ ├── api/ # API endpoints\n│ │ │ └── pages.ts # Recent pages API\n│ │ └── tasks/ # Task automation endpoints\n│ │ ├── todoSearch.ts # Single page search webhook\n│ │ ├── todoSave.ts # Blob sync webhook\n│ │ └── todos.ts # Batch search & sync\n│ ├── services/ # External API integrations\n│ │ ├── notion/ # Notion API wrapper\n│ │ │ ├── index.ts # Client initialization\n│ │ │ ├── pages.ts # Page operations\n│ │ │ ├── databases.ts # Database operations\n│ │ │ ├── blocks.ts # Block operations\n│ │ │ └── search.ts # Search operations\n│ │ ├── aiService.ts # OpenAI for summaries & owner disambiguation\n│ │ └── blobService.ts # Val Town blob storage\n│ └── utils/ # Utility functions\n│ ├── notionUtils.ts # Block transformation\n│ ├── blobUtils.ts # Blob key parsing\n│ └── emojiUtils.ts # Emoji extraction\n├── frontend/ # React frontend\n├── shared/ # Shared types and utilities\n│ ├── types.ts # TypeScript interfaces\n│ └── utils.ts # Shared utility functions\n├── main.http.tsx # Application entry point (Hono)\n├── CLAUDE.md # Development guidelines\n└── AGENTS.md # Val Town platform guidelines\n```\n\n## MVC Architecture\n\nThis application follows a strict **3-layer MVC architecture** with clear separation of concerns:\n\n```\nRequest → Route → Controller → Service → External API\n ↓\nResponse ← Format ← Standard Response ← Result\n```\n\n### Layer 1: Routes (`backend/routes/`)\n\n**Responsibility**: HTTP handling only\n\n- Extract request parameters (query, body, headers)\n- Call controller functions\n- Format responses with appropriate HTTP status codes\n- **Never contain business logic**\n\n```typescript\n// Example: backend/routes/tasks/todos.ts\napp.post(\"/\", async (c) => {\n const keyword = c.req.query(\"keyword\") || undefined;\n const result = await todoOrchestrationController.processBatchTodos(\n hours,\n keyword\n );\n return c.json(result, 200);\n});\n```\n\n### Layer 2: Controllers (`backend/controllers/`)\n\n**Responsibility**: Business logic and orchestration\n\n- Validate input data\n- Orchestrate multiple service calls\n- Transform and filter data\n- Return standardized response format: `{success, data, error, details?}`\n- **Never make direct HTTP calls to external APIs**\n\n```typescript\n// Example: backend/controllers/todoController.ts\nexport async function processTodoSearch(pageId: string, keyword: string = 'todo') {\n // Validation\n if (!pageId) return { success: false, error: \"Invalid pageId\", ... };\n\n // Call service layer\n const blocks = await notionService.getPageBlocksRecursive(pageId);\n\n // Business logic\n const matches = blocks.filter(block => searchBlockForKeyword(block, keyword));\n\n return { success: true, data: matches, error: null };\n}\n```\n\n### Layer 3: Services (`backend/services/`)\n\n**Responsibility**: External API calls only\n\n- Make HTTP requests to external APIs\n- Handle API authentication\n- Parse and normalize API responses\n- Return structured results: `{success, data, error}`\n- **Never contain business logic**\n\n```typescript\n// Example: backend/services/notion/pages.ts\nexport async function getPageBlocksRecursive(blockId: string) {\n const response = await notion.blocks.children.list({ block_id: blockId });\n return response.results;\n}\n```\n\n**Golden Rule**: Never skip layers! Routes call controllers, controllers call services. This ensures testability, maintainability, and clear separation of concerns.\n\n## Search Workflow\n\nThe system follows a three-stage pipeline: **Notion → Blob Storage → Notion Database**\n\nBy default, the system searches for `to_do` blocks (Notion checkboxes). The pipeline remains the same regardless of search mode.\n\n### Stage 1: Search & Extract (Notion → Blobs)\n\n**Flow**:\n\n1. Get recent pages from Notion (configurable time window)\n2. For each page, recursively fetch all blocks\n3. Find `to_do` blocks (checkboxes) - or keyword matches in alternative mode\n4. Extract structured data from matching blocks\n5. **Validate word count**: Skip blocks below `MIN_BLOCK_WORDS` (default: 5)\n6. **Capture context**: Extract dates and block author for AI resolution during sync\n7. Save enriched blocks to blob storage with timestamp\n\n**Validation & Enrichment**:\n\n- ❌ Word count < `MIN_BLOCK_WORDS`? → Skip (too short to be meaningful)\n- ✅ Only skips if: too short (below MIN_BLOCK_WORDS)\n- Note: Both owner AND due date are determined by AI during sync, not during search\n- Result: All blobs in storage are meaningful; AI resolves owner and due date during sync\n\n**Endpoints**:\n\n- `POST /tasks/todo/search` - Single page search (webhook-triggered)\n- `POST /tasks/todos?hours=24` - Batch search across recent pages\n\n**Default Configuration**:\n\n- By default, searches for `to_do` blocks (Notion checkboxes)\n- No configuration needed - works out of the box\n- To add keyword search, see [Search Configuration](#search-configuration)\n\n**Block Extraction**:\n\nWhen a matching block is found, the system extracts and transforms it into a reduced format:\n\n```typescript\n{\n todo_string: \"Buy groceries for @John due October 30, 2025\",\n block_id: \"abc-123-def-456\",\n block_url: \"https://www.notion.so/abc123def456\",\n last_edited_time: \"2025-10-29T12:00:00.000Z\",\n people_mentions: [{ id: \"user-123\", name: \"John\", email: \"john@example.com\" }],\n date_mentions: [\"2025-10-30\"],\n link_mentions: [{ text: \"Project\", url: \"/page-id\" }],\n sync_metadata: {\n synced: false, // Needs sync to Notion database\n target_page_id: undefined // Will be set after first sync (ID of page in todos database)\n }\n}\n```\n\n**Transformation Details**:\n\n- **Dates**: Formatted to human-readable (e.g., \"October 30, 2025 at 3:00 PM EDT\")\n- **Original dates preserved**: ISO format kept in `date_mentions` array for Notion API\n- **Block URL**: Clickable link to original block location\n- **Emojis**: Extracted for use as page icons\n\n### Stage 2: Blob Storage\n\n**Storage Format**:\n\n- **Key pattern**: `{projectName}--{category}--{blockId}`\n- **Example**: `demo--todo--abc-123-def-456`\n- **Content**: JSON of reduced block structure with sync metadata\n\n**Blob Structure**:\n\n```typescript\n{\n todo_string: \"...\",\n block_id: \"...\",\n page_url: \"...\", // Source page URL\n parent_id: \"...\" | null, // Parent block ID (for project matching)\n preceding_heading: \"...\" | null, // Closest h1/h2/h3 before block (for owner matching)\n // ... other properties\n sync_metadata: {\n synced: boolean, // true = synced to Notion, false = needs sync\n target_page_id?: string // Cached ID of page in todos database (optimization)\n }\n}\n```\n\n**Update Logic**:\n\n- Compare `last_edited_time` of existing blob vs new block\n- If unchanged: **Skip save** (preserves `synced: true` status)\n- If changed: Save with `synced: false` (triggers re-sync)\n- **Checkbox state**: For `to_do` blocks, also compare `checked` state (see note below)\n- Preserve cached `target_page_id` across updates\n- Prevents data loss from out-of-order processing\n\n> **Minute-Precision Note**: Notion's `last_edited_time` is rounded to the minute. If you edit a block twice within the same minute, the second edit may not be detected by timestamp comparison alone. For `to_do` blocks, the system also compares the `checked` state to catch same-minute checkbox toggles. Other same-minute edits (text changes) will be captured on the next edit in a different minute.\n\n### Stage 3: Sync to Notion Database (Blobs → Notion)\n\n**Flow**:\n\n1. List all blobs in \"todo\" category\n2. For each blob, read reduced block data\n3. **Optimization: Skip if `synced: true`** (0 API calls)\n4. **Optimization: Use cached `target_page_id` if available** (1 API call - update only)\n5. If no cached ID: Query database for existing page by Block ID\n6. Create new page OR update existing page\n7. Mark blob as `synced: true` and cache page ID\n\n**Note**: No validation happens during sync - all blobs are guaranteed valid because validation occurs during the search phase (Stage 1).\n\n**Endpoints**:\n\n- `POST /tasks/todo/save` - Sync all blobs to database (webhook-triggered)\n- `POST /tasks/todos` - Batch workflow (search + sync in one call)\n\n**Property Mappings** (Blob → Notion Database):\n\n```\ntodo_string → Name (title)\nblock_id → Block ID (rich_text)\nblock_url → Block URL (url)\npage_url → Page URL (url) - source page where todo was found\nlast_edited_time → Todo last edited time (date)\npeople_mentions[0] → Owner (people)\npeople_mentions[1..] → Other people (people)\ndate_mentions[0] → Due date (date)\nlink_mentions → Links (rich_text, bullet list)\nmatched projects → Projects db (relation) - see Project Matching\nemoji (if found) → Page icon\n```\n\n**Status Sync** (optional): Set `TODOS_PROP_STATUS=YourStatusProperty` to sync checkbox state:\n- ✅ **Checked** → Status set to \"Done\" (or first matching: \"Complete\", \"Completed\", \"Finished\")\n- ⬜ **Unchecked** → Status set to first non-done option (e.g., \"Not started\", \"To Do\")\n- Supports Status, Select, and Checkbox property types\n\n**Sync Optimization**:\n\nThe system uses sync metadata to dramatically reduce Notion API calls:\n\n**On first sync**:\n\n- Blob has `synced: false`, no `target_page_id`\n- Query database → create or update → cache page ID\n- Mark `synced: true`\n- **API calls**: 1 query + 1 create/update = **2 calls**\n\n**On subsequent syncs (no changes)**:\n\n- Blob has `synced: true`\n- Skip immediately\n- **API calls**: **0 calls** (100% reduction)\n\n**On subsequent syncs (block changed)**:\n\n- Blob saved with `synced: false` (block edited in Notion)\n- Has cached `target_page_id` from previous sync\n- Update directly without query\n- Mark `synced: true`\n- **API calls**: **1 update** (50% reduction)\n\n**Performance impact**:\n\n- **Before optimization**: 100 blobs = 100 queries + 50 updates = 150 API calls\n- **After optimization**: 90 synced + 10 changed = 0 + 10 updates = **10 API calls** (93% reduction)\n\n## Block Type Handling\n\nThe search uses **recursive block fetching** to traverse the entire page hierarchy, including nested content.\n\n### Recursive Fetching\n\n**How it works**:\n\n```typescript\nfunction getPageBlocksRecursive(blockId, containerFilter?) {\n 1. Fetch immediate children of blockId\n 2. For each child:\n - Add child to results\n - If child.has_children === true:\n - If containerFilter provided: only recurse if block type is in filter\n - Otherwise: recurse into all children\n - Add to results\n 3. Return flattened array of all blocks\n}\n```\n\n**What this means**:\n\n- ✅ Finds blocks nested inside toggles\n- ✅ Finds blocks nested inside columns\n- ✅ Finds blocks nested inside lists\n- ✅ Finds blocks nested N levels deep\n\n### Block Type Optimization\n\nWhen only block type search is active (no `SEARCH_KEYWORDS` set), the system optimizes recursive fetching by only traversing into container blocks that can hold children of the target type:\n\n**Container blocks (recursed into)**:\n\n- `to_do` - to_do blocks can nest inside other to_do blocks\n- `toggle` - common pattern for organizing todos\n- `column_list` / `column` - layout containers\n- `synced_block` - can contain any block type\n- `callout` - can contain nested content\n- `quote` - can contain nested blocks\n- `bulleted_list_item` / `numbered_list_item` - can have nested content\n- `template` - can contain any block type\n\n**Non-container blocks (skipped)**:\n\n- `paragraph`, `heading_1/2/3`, `code`, `equation` - cannot have to_do children\n- `image`, `video`, `file`, `pdf`, `audio`, `embed`, `bookmark` - media blocks\n\n**Performance impact**: Significantly reduces API calls by skipping recursion into blocks that cannot contain to_do items. When `SEARCH_KEYWORDS` is set, all blocks are traversed (no filter applied) to find keyword matches.\n\n### Included Block Types\n\nThese block types are **searchable** (block type search matches only the configured type; keyword search checks text content in all blocks):\n\n| Block Type | Has rich_text? | Notes |\n| ------------------------------------- | -------------- | --------------------------------- |\n| `paragraph` | ✅ | Standard text blocks |\n| `heading_1`, `heading_2`, `heading_3` | ✅ | All heading levels |\n| `bulleted_list_item` | ✅ | Bullet lists |\n| `numbered_list_item` | ✅ | Numbered lists |\n| `to_do` | ✅ | Checkbox items |\n| `toggle` | ✅ | Collapsible toggles |\n| `quote` | ✅ | Quote blocks |\n| `callout` | ✅ | Callout/alert blocks |\n| `code` | ✅ | Code blocks (captions only) |\n| `column` | N/A | Container - children are searched |\n| `column_list` | N/A | Container - children are searched |\n\n**Column Behavior**:\n\n- Column blocks themselves have no searchable text\n- But their children (paragraphs, lists, etc.) ARE searched\n- Example: A todo in a column will be found\n\n### Excluded Block Types\n\nThese block types are **explicitly skipped**:\n\n| Block Type | Reason |\n| ------------------------------- | ------------------------------------------------------ |\n| `unsupported` | Not supported by Notion API |\n| `button` | Action buttons, not content |\n| `table` | Container block, no text content |\n| `table_row` | Cells aren't individual blocks; can't be saved to blob |\n| `child_page` | Page title not in rich_text format |\n| `child_database` | Database title not in rich_text format |\n| `divider` | No text content |\n| `table_of_contents` | No text content |\n| `breadcrumb` | No text content |\n| `image`, `file`, `video`, `pdf` | Media blocks (captions could be added later) |\n| `bookmark`, `embed` | External content (could be added later) |\n\n**Why tables are excluded**:\n\n- Table content lives in `table_row.cells[][]` (array of arrays)\n- Cells contain rich_text but aren't individual blocks\n- Can't be saved to blob storage as standalone blocks\n- Can't create Notion pages from cell content\n\n## Validation & Auto-Assignment Rules\n\nMatched blocks are validated for minimum length before being saved to blob storage. **Validation ensures quality; both owner and due date are determined by AI during sync**.\n\n### Validation & Enrichment for Blob Storage\n\nMatched blocks go through validation before being saved:\n\n**1. Word Count Validation (REQUIRED)**:\n\n- ✅ Block must have at least `MIN_BLOCK_WORDS` words (default: 5)\n- ❌ Blocks with fewer words are skipped - too short to be meaningful todos\n- Counts all words including mentions and dates (simple whitespace split)\n- Example: \"Buy groceries for @John tomorrow\" = 5 words (passes)\n- Example: \"todo\" = 1 word (skipped)\n\n**2. Due Date (AI-DETERMINED during sync)**:\n\n- ALL date mentions are extracted from the block (no prefix required)\n- AI determines which date is the due date based on context\n- Example: \"finish report @October 30\" → AI interprets October 30 as due date\n- Example: \"meeting @October 30 about Q4\" → AI determines if this is a due date or just content\n- **Fallback**: If no date in content, AI uses `DEFAULT_DUE_DATE` setting (default: today)\n- AI always includes a date in both the summary (Name) and the dueDate property for consistency\n\n**3. Owner Assignment (AI-DETERMINED during sync)**:\n\n- Owner is determined by AI during sync, not during search\n- AI uses context with priority: (1) heading, (2) matched contacts, (3) @mentions\n- Block creator is captured as `author` for potential use in owner resolution\n- Owner can be null if AI cannot determine from context\n- @mentions populate \"Other people\" property\n\n**Default Due Date (AI Fallback)**:\n\n- When no date is mentioned in the todo content, AI uses the default due date\n- **Configurable**: Set via `DEFAULT_DUE_DATE` environment variable\n- **Options**: `today` (default), `tomorrow`, `one_week`, `end_of_week`, `next_business_day`\n- **Behavior**: Default date is passed to AI as context; AI includes it in both summary and dueDate\n- **Consistency**: AI summary (Name property) and dueDate property always show the same date\n\n**Owner Resolution (during sync)**:\n\n- Owner is determined by AI during sync using `generateSummary()` + `resolveOwner()`\n- AI analyzes context to identify the responsible person:\n 1. **Heading**: If preceding heading contains a person's name → that person is owner\n 2. **Contact**: If matched contacts exist → first contact is owner\n 3. **Mention**: If @mentions exist → first @mention is owner\n- Block creator is stored as `author` and may be used if owner source is \"heading\"\n- If AI cannot determine owner, the Owner field is left empty\n- This allows intelligent assignment based on context rather than assuming creator = owner\n\n**Result**: All matched blocks are saved - no blocks are skipped due to missing people. Owner is resolved during sync.\n\n### When Validation Happens\n\n**During Search (Stage 1)** - `todoController.ts`:\n\n- After keyword match is found\n- After block is transformed to reduced format\n- Before saving to blob storage\n\n**Not During Sync (Stage 3)** - All blobs are guaranteed valid, no checking needed\n\n### Validation Logic\n\n```typescript\n// From todoController.ts (search phase)\n\n// Step 1: Check minimum word count\nconst minWords = getMinBlockWords();\nconst wordCount = countWords(reducedBlock.todo_string);\n\nif (wordCount < minWords) {\n console.log(\n `○ Skipped: block too short (${wordCount} words, minimum: ${minWords})`\n );\n continue; // Don't save to blob\n}\n\n// Step 2: Capture block creator as author (for AI resolution during sync)\nconst creator = getBlockCreator(block);\n(reducedBlock as any).author = creator; // May be null if no creator\n\n// All validated blocks reach this point and get saved\n// Owner AND due date are determined by AI during sync phase\nawait blobService.saveBlockToBlob(\"todo\", block.id, blobData);\n```\n\n### Examples\n\n**Valid - @mention + date** (8 words):\n\n```\n\"Buy groceries for @John due October 30, 2025\"\n✅ Word count: 8 (passes minimum of 5)\n✅ Has @mention (@John → Other people)\n✅ Has date mention (October 30)\n→ Saved to blob storage\n→ Synced: AI determines owner and due date (Oct 30)\n```\n\n**Valid - Date without prefix** (6 words):\n\n```\n\"Buy groceries October 30, 2025 for dinner\"\n✅ Word count: 6 (passes minimum of 5)\n✅ Has date mention (October 30) - no prefix needed\n→ Saved to blob storage (author captured for AI resolution)\n→ Synced: AI interprets Oct 30 as due date\n```\n\n**Valid - Date in context** (7 words):\n\n```\n\"Meeting with @John October 30 about Q4\"\n✅ Word count: 7 (passes minimum of 5)\n✅ Has @mention (@John → Other people)\n✅ Has date mention (October 30)\n→ Saved to blob storage\n→ Synced: AI determines if date is due date or just context\n```\n\n**Valid - No date** (5 words):\n\n```\n\"Buy groceries at the store\"\n✅ Word count: 5 (passes minimum of 5)\n⚠️ No date in content → AI uses DEFAULT_DUE_DATE\n→ Saved to blob storage (author captured for AI resolution)\n→ Synced: AI uses default date for both summary and dueDate\n```\n\n**Invalid - Too short** (2 words):\n\n```\n\"Buy groceries\"\n❌ Word count: 2 (below minimum of 5)\n→ NOT saved to blob storage (skipped - too short)\n```\n\n**Invalid - Too short** (1 word):\n\n```\n\"todo\"\n❌ Word count: 1 (below minimum of 5)\n→ NOT saved to blob storage (skipped - too short)\n```\n\n**Invalid - Too short with emojis** (2 words):\n\n```\n\"🍋 🎉\"\n❌ Word count: 2 (below minimum of 5)\n→ NOT saved to blob storage (skipped - too short)\n```\n\n**Valid - @Today shorthand** (5 words):\n\n```\n\"Test the feature @Today please\"\n✅ Word count: 5 (passes minimum of 5)\n✅ Has date mention (@Today)\n→ Saved to blob storage (author captured if available)\n→ Synced: AI interprets @Today as due date; summary includes \"by [today's date]\"\n```\n\n**Note**: With word count validation, most meaningful blocks are saved. Blocks are only skipped if too short (below `MIN_BLOCK_WORDS`, default: 5). AI determines due date from any date in the content; if no date, uses DEFAULT_DUE_DATE.\n\n### Sync Summary\n\nAfter syncing, the controller reports:\n\n- **Total blobs**: All blobs in storage (all guaranteed valid)\n- **Pages created**: New pages added to database\n- **Pages updated**: Existing pages updated\n- **Pages skipped**: Blobs already synced (`synced: true`)\n- **Pages failed**: Errors during create/update\n\n**Note**: Both owner and due date are determined by AI during sync. AI ensures consistent dates in both the summary (Name) and dueDate property.\n\n## Endpoints\n\n### API Endpoints\n\n**`GET /api/pages/recent?hours=24`**\n\n- Get pages edited in last N hours\n- Filters out archived pages and pages in TODOS_DB_ID database\n- Returns simplified page objects with parent information\n\n**Response**:\n\n```json\n{\n \"pages\": [\n {\n \"id\": \"page-id\",\n \"object\": \"page\",\n \"title\": \"My Page\",\n \"url\": \"https://notion.so/...\",\n \"last_edited_time\": \"2025-10-29T12:00:00.000Z\",\n \"parent\": { \"type\": \"page_id\", \"id\": \"parent-id\" }\n }\n ],\n \"count\": 1,\n \"timeRange\": \"24 hours\"\n}\n```\n\n### Task Endpoints\n\n**`POST /tasks/todo/search`**\n\n- Search single page for checkboxes or keywords (webhook-triggered)\n- Default: finds `to_do` blocks (checkboxes)\n- Optional: set `SEARCH_KEYWORDS` to also capture keyword matches\n- Extracts and saves matching blocks to blobs\n- Body: `{ \"page_id\": \"abc-123\" }`\n\n**`POST /tasks/todo/save`**\n\n- Sync all blobs to Notion database\n- Validates and creates/updates pages\n- No request body needed\n\n**`POST /tasks/todos?hours=24`**\n\n- **Batch workflow**: Search recent pages + sync to database\n- Default: finds `to_do` blocks (checkboxes)\n- Combines search and save in one call\n- Use for manual triggers or cron jobs\n\n**Response**:\n\n```json\n{\n \"success\": true,\n \"pagesSearched\": 5,\n \"totalTodosFound\": 12,\n \"searchResults\": [\n {\n \"pageId\": \"abc-123\",\n \"pageTitle\": \"My Page\",\n \"success\": true,\n \"blocksFound\": 3,\n \"blockIds\": [\"block-1\", \"block-2\", \"block-3\"]\n }\n ],\n \"saveResult\": {\n \"totalBlobs\": 12,\n \"pagesCreated\": 5,\n \"pagesUpdated\": 3,\n \"pagesSkipped\": 4,\n \"pagesFailed\": 0\n }\n}\n```\n\n## Cron Jobs\n\nThe system includes two separate cron jobs for automated workflow execution. Crons are time-based triggers that run independently of HTTP requests.\n\n### Architecture\n\nCrons live in `backend/crons/` and follow the same MVC pattern as HTTP routes:\n\n```\nCron Trigger → Controller → Service → External API\n```\n\n**Key differences from HTTP routes**:\n\n- Triggered by time intervals (not HTTP requests)\n- No request/response cycle\n- Results logged to console only\n- Use `.cron.tsx` extension for Val Town\n\n### Cron 1: Todo Search (`todoSearch.cron.ts`)\n\n**Purpose**: Search recent pages for checkboxes (or keywords) and save matches to blob storage\n\n**Workflow**:\n\n1. Get recent pages from Notion (last 15 minutes)\n2. Search each page for `to_do` blocks (checkboxes) by default\n3. Save matching blocks to Val Town blob storage\n4. Does NOT sync to Notion database\n\n**Configuration**:\n\n- **Lookback window**: 15 minutes (optimized for frequent runs)\n- **Search mode**: Default is `to_do` blocks; set `SEARCH_KEYWORDS` to also capture keyword matches\n- **Recommended schedule**: Every 1 minute\n - 15 minute lookback provides buffer for missed runs\n - Frequent runs catch changes quickly\n\n**Output**:\n\n```\n=== Cron: Todo Search Started ===\nTimestamp: 2025-10-29T12:00:00.000Z\n\nCron: Search complete - Found 12 todos in 5 pages\nPages with matches:\n - Project Planning: 3 match(es)\n - Meeting Notes: 5 match(es)\n - Weekly Review: 4 match(es)\n\n=== Cron: Todo Search Complete ===\n```\n\n### Cron 2: Todo Sync (`todoSync.cron.ts`)\n\n**Purpose**: Sync validated todo blobs to Notion database\n\n**Workflow**:\n\n1. Read all todo blobs from Val Town blob storage\n2. Validate each blob (requires person mention + date mention)\n3. Query Notion database for existing pages by Block ID\n4. Create new pages or update existing pages (timestamp-based)\n\n**Configuration**:\n\n- **No parameters**: Processes all blobs in storage\n- **Recommended schedule**: Every 8-12 hours\n - Less frequent than search cron\n - Allows time for blob accumulation\n - Reduces Notion API calls\n\n**Output**:\n\n```\n=== Cron: Todo Sync Started ===\nTimestamp: 2025-10-29T14:00:00.000Z\n\nCron: Sync complete\nSummary:\n Total blobs processed: 12\n Pages created: 5\n Pages updated: 3\n Pages skipped: 4\n Pages failed: 0\n\n=== Cron: Todo Sync Complete ===\n```\n\n### Cron 3: Cache Warm (`cacheWarm.cron.ts`)\n\n**Purpose**: Warm caches to ensure fast first-load experience\n\n**What it warms**:\n\n- **Health cache**: Ensures dashboard loads instantly (main benefit)\n- Future: Can add more cache warming (relations, project names, etc.)\n\n**How it works**:\n\n- Calls `getSystemHealth()` from the health controller\n- Controller checks cache TTL internally\n- If cache is fresh → returns immediately (no API calls)\n- If cache is stale → builds fresh data and saves to cache\n\n**Configuration**:\n\n- **No parameters**: Just warms caches\n- **Recommended schedule**: Every 1 minute\n - Keeps health cache warm for dashboard users\n - Minimal overhead when cache is already fresh\n\n**Output**:\n\n```\n[CacheWarm] Health cache refreshed\n```\nor\n```\n[CacheWarm] Health cache hit (age: 45s)\n```\n\n### Why Three Separate Crons?\n\n**Operational flexibility**:\n\n- **Search cron** runs frequently to capture changes quickly\n- **Sync cron** runs less frequently to batch database updates\n- **Cache warm cron** keeps health UI fast for dashboard users\n- Reduces Notion API rate limit concerns\n- Allows manual triggering of each independently\n\n**Fault isolation**:\n\n- Search failures don't block syncing existing blobs\n- Sync failures don't block new searches\n- Cache failures don't affect search/sync\n- Each cron can be debugged independently\n\n**Cost optimization**:\n\n- Blob storage is cheap and fast\n- Notion API calls are rate-limited\n- Separate crons allow different schedules for different costs\n\n### Setting Up Crons in Val Town\n\n1. **Navigate to Val Town UI**\n2. **Create new cron vals**:\n - `todoSearch.cron.tsx` - Copy content from `backend/crons/todoSearch.cron.ts`\n - `todoSync.cron.tsx` - Copy content from `backend/crons/todoSync.cron.ts`\n - `cacheWarm.cron.tsx` - Copy content from `backend/crons/cacheWarm.cron.ts`\n3. **Set schedules**:\n - `todoSearch.cron.tsx`: Every 1 minute (`* * * * *`)\n - `todoSync.cron.tsx`: Every 1 minute (`* * * * *`)\n - `cacheWarm.cron.tsx`: Every 1 minute (`* * * * *`)\n4. **Monitor logs**: Check Val Town console for cron execution results\n\n**Note**: Val Town cron jobs must be separate vals (not files in this project). The files in `backend/crons/` serve as templates to copy into Val Town cron vals.\n\n## Caching\n\nThe system uses blob storage caching to dramatically reduce Notion API calls and improve response times. Caching is automatic and requires no configuration.\n\n### Why Caching?\n\n**Without caching**:\n- Health endpoint: 4-10 Notion API calls per request (1000-2000ms)\n- Sync initialization: ~11 Notion API calls per sync (2-5 seconds startup)\n\n**With caching**:\n- Health endpoint: 0 API calls when cached (~50ms)\n- Sync initialization: 0 API calls when cached (~100ms)\n\n**Trade-off**: Property renames in Notion may take up to 1 minute to propagate. This is acceptable because property renames are rare, while health checks and syncs are constant.\n\n### How It Works\n\nThe system caches two types of data in Val Town blob storage:\n\n| Cache | Key Pattern | TTL | Contents |\n|-------|-------------|-----|----------|\n| Health Response | `{project}--cache--health` | 1 minute | Full health check JSON |\n| Relation Cache | `{project}--cache--relations` | 1 minute | Database schema, relations, page IDs |\n\n**Cache flow** (same for both caches):\n\n```\nRequest arrives\n ↓\nCheck blob cache\n ↓\nAge < 1 minute? ──YES──→ Return cached data (instant, ~50ms)\n ↓ NO\nFetch fresh data from Notion (slow, 1-5 seconds)\n ↓\nSave to blob cache\n ↓\nReturn fresh data\n```\n\n### Health UI Cache\n\nThe `/api/health` endpoint caches its full response:\n\n- **First request after cache expires**: Slow (fetches from Notion)\n- **Subsequent requests within 1 minute**: Instant (returns cached data)\n- **No cron needed**: Cache refreshes lazily when accessed\n- **Response includes cache info**: `cached: true` and `cacheAge: 45000` (milliseconds)\n\n**Example cached response**:\n```json\n{\n \"project\": { \"name\": \"demo\", ... },\n \"connections\": { ... },\n \"properties\": [ ... ],\n \"cached\": true,\n \"cacheAge\": 45000\n}\n```\n\n### Sync Relation Cache\n\nThe sync process caches all relation data needed to map todos:\n\n- **What's cached**: Database schema, relation properties, page IDs\n- **When refreshed**: Automatically when stale and a sync runs\n- **No extra cron needed**: The existing `todoSync.cron` (runs every 1 minute) keeps the cache warm\n\n**Cache contents** (serialized to blob storage):\n```typescript\n{\n relations: [...], // Discovered relation properties\n targetDbPageIds: [...], // Page IDs in each relation's target database\n ownerPropertyType: \"people\" | \"relation\",\n statusInfo: { ... }, // Status property config for checkbox sync\n validatedProperties: { ... } // Property name mappings\n}\n```\n\n### Performance Impact\n\n| Metric | Before | After | Improvement |\n|--------|--------|-------|-------------|\n| Health endpoint response | 1000-2000ms | ~50ms | **20x faster** |\n| Sync initialization | 2-5 seconds | ~100ms | **20-50x faster** |\n| Notion API calls (health) | 4-10 per request | 0 (cached) | **100% reduction** |\n| Notion API calls (sync) | ~11 per sync | 0 (cached) | **100% reduction** |\n\n### Staleness Considerations\n\nBecause caches have a 1-minute TTL, some changes may be delayed:\n\n| Change Type | Propagation Time | Frequency |\n|-------------|------------------|-----------|\n| New todo in Notion | Immediate (not cached) | Common |\n| Todo content changes | Immediate (not cached) | Common |\n| Property value changes | Immediate (not cached) | Common |\n| **Property renamed** | Up to 1 minute | Rare |\n| **Relation added/removed** | Up to 1 minute | Rare |\n| **New page in relation DB** | Up to 1 minute | Uncommon |\n\n**Why this is acceptable**: The things that change frequently (todo content) are not cached. The things that are cached (schema, relations) change rarely.\n\n### Implementation Details\n\n**Files involved**:\n- `backend/services/blobService.ts` - `getCache()` and `setCache()` functions\n- `backend/controllers/healthController.ts` - Wraps `buildHealthResponse()` with cache\n- `backend/controllers/todoSaveController.ts` - Wraps `buildRelationCache()` with cache\n\n**Cache key format**: `{projectName}--cache--{cacheKey}`\n- Example: `demo--cache--health`\n- Example: `demo--cache--relations`\n\n**Serialization**: Maps are converted to arrays for JSON storage and restored on retrieval.\n\n### Debugging Cache Issues\n\n**Force fresh data** (health endpoint):\n- Wait 1 minute for cache to expire, OR\n- (Future enhancement) Add `?refresh=true` query param\n\n**Check cache age**:\n- Health endpoint returns `cacheAge` in response when cached\n- Sync logs \"Using cached relation data (age: Xs)\" when using cache\n\n**Verify cache is working**:\n1. Load `/api/health` - note response time\n2. Load again within 1 minute - should be instant with `cached: true`\n3. Check `cacheAge` increases on subsequent requests\n\n## Environment Variables\n\nRequired environment variables (set in Val Town):\n\n- **`NOTION_API_KEY`** - Notion integration token (required)\n\n - Get from: https://www.notion.so/my-integrations\n - Required for all Notion API calls\n\n- **`TODOS_DB_ID`** - Notion database ID for todo sync (required)\n\n - The database where keyword matches are synced\n - Format: `abc123def456...` (32-character ID without hyphens)\n\n- **`PROJECTS_DB_ID`** - **DEPRECATED** (optional, still works)\n\n - No longer needed - relations are auto-discovered from the todos database schema\n - Configure project matching in `notion.config.ts` instead (see [Project Matching](#project-matching))\n - If set, a deprecation warning will be logged\n\n- **`SEARCH_BLOCK_TYPE`** - Block type to search for (always active)\n\n - Searches by Notion block type (not text content)\n - **Default**: `to_do` (Notion checkbox blocks) - works without setting this variable\n - Common values: `to_do`, `paragraph`, `bulleted_list_item`, `numbered_list_item`\n - Workflow: Create a checkbox, add @person and date = instant todo\n\n- **`SEARCH_KEYWORDS`** - Additional keywords to search for (optional, additive)\n\n - Adds keyword-based search on top of block type search\n - Comma-separated list of keywords/phrases\n - Example: `todo,zinger,bit` or `todo,😀,🎉`\n - Blocks matching the block type OR any keyword will be saved\n - Use this to capture additional blocks beyond the configured block type\n\n- **`MIN_BLOCK_WORDS`** - Minimum word count for blocks to be saved (optional)\n\n - Blocks with fewer words are skipped (too short to be meaningful todos)\n - Defaults to `5` if not set\n - Word counting:\n - Counts all words including mentions and dates (simple whitespace split)\n - Hyphenated words count as 1 (e.g., \"buy-now\" = 1 word)\n - Emojis count as words (e.g., \"🍋 🎉\" = 2 words)\n - Default of 5 accounts for: ~1 word for mention + ~2-3 words for date + ~2-3 words for action\n - Example: \"Buy groceries for @John tomorrow\" = 5 words (minimum)\n\n- **`DEFAULT_DUE_DATE`** - Default due date for blocks without date mentions (optional)\n\n - Passed to AI as fallback context when a block has no date mentions\n - AI uses this date for both the summary (Name) and dueDate property\n - Ensures consistent dates even when no date is in the content\n - Supported values: `today`, `tomorrow`, `one_week`, `end_of_week`, `next_business_day`\n - Defaults to `today` if not set\n - Examples:\n - `today` - Due today (default)\n - `tomorrow` - Due tomorrow\n - `one_week` - Due 7 days from today\n - `end_of_week` - Due next Friday (end of work week)\n - `next_business_day` - Due next weekday (skips weekends)\n\n- **`BLOCK_STABILITY_MINUTES`** - Minimum age (in minutes) before blocks are saved to blob storage (optional)\n\n - Only applies to cron-triggered searches (not webhook-triggered)\n - Prevents syncing blocks that are actively being edited\n - Defaults to `0` if not set (no delay - blocks saved immediately)\n - Set to a positive number to add a stability delay (e.g., `2` for 2 minutes)\n - Examples:\n - Not set or `BLOCK_STABILITY_MINUTES=0` - All blocks saved immediately (default)\n - `BLOCK_STABILITY_MINUTES=2` - Block edited 1 minute ago will be skipped, 3 minutes ago will be saved\n - `BLOCK_STABILITY_MINUTES=5` - Block edited 4 minutes ago will be skipped, 6 minutes ago will be saved\n - Webhook/button triggers always bypass this delay regardless of setting (immediate sync on user action)\n - Use case: Set a delay if you frequently edit todos and want cron to wait for \"final\" versions\n\n- **`RECENT_PAGES_LOOKBACK_HOURS`** - Default lookback window for searching recent pages (optional)\n\n - System-wide setting that applies to all triggers: cron jobs, frontend dashboard, manual API calls\n - Defaults to `24` hours if not set\n - Must be a positive integer\n - Can be overridden per-request with `?hours=X` query parameter\n - Examples:\n - Not set or `RECENT_PAGES_LOOKBACK_HOURS=24` - Search last 24 hours (default)\n - `RECENT_PAGES_LOOKBACK_HOURS=48` - Search last 48 hours (2 days)\n - `RECENT_PAGES_LOOKBACK_HOURS=168` - Search last 168 hours (1 week)\n - Use case: Match to your cron schedule or desired dashboard timeframe\n - Cron every 4 hours → Set to 6-8 hours (buffer for overlap/delays)\n - Cron every 24 hours → Set to 24-48 hours\n - No cron → Set to desired dashboard timeframe\n\n- **`NOTION_WEBHOOK_SECRET`** - API key for protecting webhooks and API endpoints (recommended)\n\n - **Required for production use** - protects all `/tasks/*` and `/api/*` endpoints (except `/api/health`)\n - Prevents unauthorized access to your Notion data and webhook triggers\n - Set to any secure random string (e.g., generated password or UUID)\n - **Notion webhook configuration**: Add custom header `X-API-KEY` with this value\n - **API requests**: Include header `X-API-KEY: your-secret-value`\n - If not set, authentication is disabled (development mode only)\n - Example: `NOTION_WEBHOOK_SECRET=abc123xyz789...`\n\n **Security note**: Without this, anyone can:\n\n - Trigger your webhooks (causing unnecessary processing)\n - Access recent pages via `/api/pages/recent` (potential data leak)\n - View page IDs from `/api/health` and use them to query other endpoints\n\n **Public endpoint exception**: `/api/health` remains public (needed for frontend dashboard)\n\n- **`API_KEY`** - Legacy API key (deprecated, use `NOTION_WEBHOOK_SECRET` instead)\n - Kept for backwards compatibility\n - Use `NOTION_WEBHOOK_SECRET` for new deployments\n\n- **`CRONS_DISABLED`** - Toggle between \"setup mode\" and \"production mode\" (optional)\n - **Setup mode** (`CRONS_DISABLED=true`):\n - No automatic search/sync (test via webhooks instead)\n - No cache warming (config changes reflect immediately in health UI)\n - Recommended while configuring env vars and Notion properties\n - **Production mode** (not set or `false`):\n - Automatic search/sync every minute\n - Cache warming for fast dashboard loads\n - Config changes may take up to 1 minute to reflect\n - Note: Crons still execute in Val Town (uses compute), they just exit immediately when disabled\n\n## Search Configuration\n\nBy default, the system searches for `to_do` blocks (Notion checkboxes). This is the recommended workflow:\n\n### Default Mode: Checkbox Search\n\n**How it works**:\n\n1. Create a checkbox in Notion (this creates a `to_do` block)\n2. Add @person mention (optional)\n3. Add date mention (optional - AI uses DEFAULT_DUE_DATE if none)\n4. Done! Automatically syncs to database\n\n**No configuration needed** - the system defaults to `to_do` block type search.\n\n**What gets captured**:\n\n- ✅ Checkbox text becomes the todo title (polished by AI)\n- ✅ @mentions populate Owner and Other People\n- ✅ AI interprets dates from content for Due Date\n- ✅ Page links are captured for relation mapping\n- ✅ Checkbox state syncs to Status property (if configured)\n\n**Example**:\n\n```\n☐ Email @Jane about proposal Friday\n```\n\nSyncs as: Name = \"Jane to email about proposal by Friday\", Owner = Jane, Due = Friday\n\n### Additive: Keyword Search\n\nYou can add keyword-based search on top of block type search to capture additional blocks.\n\n**Configuration**:\n\n```env\nSEARCH_KEYWORDS=todo,zinger,🍋\n```\n\n**How it works**:\n\n- Block type search always runs (primary)\n- Keyword search is additive - also captures blocks matching keywords\n- A block is saved if it matches the block type OR any keyword\n\n**Keyword Matching Logic**:\n\n- **Text keywords** (e.g., \"todo\", \"bit\"):\n - Case-insensitive\n - Word boundary matching (finds \"todo\" but not \"todoist\")\n - Uses regex: `/\\btodo\\b/i`\n- **Emojis** (e.g., \"😀\", \"🎉\"):\n - Exact match\n- **Multi-keyword**: Block saved if it matches ANY keyword\n\n**Example**:\n\n```\nBuy groceries todo @John due October 30\n```\n\n**When to use keyword search**:\n\n- You have existing content with \"todo\" markers you want to capture\n- You want a specific emoji or word to trigger sync\n- You need to match blocks beyond the configured block type\n\n### Combined Search\n\n**If `SEARCH_KEYWORDS` is set**: Both searches run (OR logic)\n\n- Block type matches are captured\n- Keyword matches are also captured\n- Example: `to_do` blocks AND any block containing \"urgent\"\n\n**If `SEARCH_KEYWORDS` is not set**: Only block type search runs (default behavior)\n\n### Enrichment (applies to all modes)\n\nRegardless of search mode, all matched blocks have context captured:\n\n- `date_mentions` - All dates in the block (AI interprets during sync)\n- `author` - Block creator is captured for potential use in AI owner resolution\n\nAll matched blocks are saved to blob storage. Both owner AND due date are determined by AI during sync. If no date is in the content, AI uses `DEFAULT_DUE_DATE` (see Context Gathering below).\n\n## Context Gathering & Assignment Logic\n\nThis section explains how context is gathered from todos and used to populate database fields. The goal is to make \"magical\" assignments predictable and debuggable.\n\n**Code reference**: `backend/controllers/todoSaveController.ts` contains the core owner resolution and relation matching logic.\n\n### Two-Stage Processing\n\n| Stage | When | What Happens | Files |\n|-------|------|--------------|-------|\n| **Search** | When pages are scanned | Extract block data + surrounding context | `todoController.ts` |\n| **Sync** | When blobs sync to DB | Resolve relations, owner, due date, generate summary | `todoSaveController.ts` |\n\n### Context Sources\n\n#### 1. Block-Level (Inherent Metadata)\n\nExtracted directly from the Notion block:\n\n| Context | Description | Example |\n|---------|-------------|---------|\n| `todo_string` | Block text content | \"Email client about proposal\" |\n| `people_mentions` | @mentions with user IDs | @Jane Smith |\n| `date_mentions` | All dates in block (AI interprets) | \"@Friday\" → AI determines due date |\n| `link_mentions` | Page links | [[Project Alpha]] |\n| `author` | Block's `created_by` | Who wrote the todo |\n\n#### 2. Surrounding Context (Captured at Search Time)\n\nContext from the block's environment (no extra API calls):\n\n| Context | Description | How Captured |\n|---------|-------------|--------------|\n| `preceding_heading` | Last h1/h2/h3 before this block | Tracked while scanning page |\n| `parent_id` | Parent block ID | From block's `parent` field |\n| `source_page_database_id` | Which database the page is in | From page's `parent` field |\n| `page_url` | URL of containing page | From page object |\n\n#### 3. Parent Page Traversal (At Sync Time)\n\nWhen block-level context is insufficient for relation matching, we traverse parent pages:\n\n- **What**: Check parent pages for relation properties that match target databases\n- **Depth**: Up to 5 levels of parent pages\n- **Used for**: Project/relation contextual matching (Strategy 2c)\n- **API calls**: 1 per parent level traversed\n\n#### 4. AI Involvement\n\nAI is used **sparingly** and only when deterministic methods fail:\n\n| Use Case | When AI is Called | Can Be Rejected? |\n|----------|-------------------|------------------|\n| Summary generation | Always (polishes text) | N/A |\n| Owner extraction | When no heading or @mention match | **Yes** - must exist in owner database |\n| Due date extraction | Always (interprets dates in text) | No (falls back to default) |\n| Disambiguation | Multiple name matches | No (picks best match) |\n\n### Owner Resolution Flow\n\nOwner is determined using a strict priority order. Each step is checked in sequence, and resolution stops at the first match:\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ Priority 1: Heading Match (Deterministic) │\n│ Does preceding heading match someone in owner database? │\n│ e.g., \"### Alex\" matches \"Alex Johnson\" in Contacts │\n├─────────────────────────────────────────────────────────────────┤\n│ MATCH → Use heading match, DONE (most reliable) │\n│ NO → Continue to Priority 2 │\n└─────────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────────┐\n│ Priority 2: @mention (Explicit) │\n│ Is there an @mention in the todo block? │\n│ e.g., \"@Jane Smith should review the PR\" │\n├─────────────────────────────────────────────────────────────────┤\n│ YES → Use first @mention's user ID, DONE │\n│ NO → Continue to Priority 3 │\n└─────────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────────┐\n│ Priority 3: AI Extraction (Validated) │\n│ AI extracts potential owner name from todo text │\n│ e.g., \"Brad to contact Kevin\" → AI extracts \"Brad\" │\n├─────────────────────────────────────────────────────────────────┤\n│ Name extracted → Validate against owner database │\n│ FOUND in DB → Use matched page/user, DONE │\n│ NOT in DB → Owner = null (prevents hallucination) │\n│ No name extracted → Owner = null │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n### Why This Design?\n\n1. **Deterministic when possible**: Heading matches are 100% reliable - no AI guessing\n2. **AI as fallback, not authority**: AI extracts names, we validate against owner database\n3. **No hallucination**: AI-extracted names must exist in owner DB to be used\n4. **Debuggable**: Clear priority order makes it easy to trace why a field was assigned\n\n### Example Scenarios\n\n**Scenario 1: Heading determines owner**\n```\n### Alex ← Heading matches \"Alex Johnson\" in owner DB\n[] Connect with Taylor about docs ← \"Taylor\" appears but is task TARGET, not owner\n\nResult: Owner = Alex Johnson (Priority 1: heading match)\n```\n\n**Scenario 2: @mention determines owner**\n```\n[] @Jane should review the PR ← @mention with user ID\n\nResult: Owner = Jane (Priority 2: @mention)\n```\n\n**Scenario 3: AI extracts owner from text**\n```\n[] Brad to contact Kevin about Q1 ← AI extracts \"Brad\" as performer\n\nResult: If \"Brad\" or \"Brad Noble\" exists in owner DB → Owner = Brad Noble\n If not in DB → Owner = null (prevents hallucination)\n```\n\n**Scenario 4: No owner signals**\n```\n[] Update the documentation ← No heading, no @mention, no name prefix\n\nResult: Owner = null\n```\n\n## Relation Mapping\n\nThe system automatically discovers all relation properties in your Todos database and maps @mentions to the appropriate relations.\n\n**How it works:**\n\n1. On each sync, the system reads your Todos database schema from the Notion API\n2. All relation properties are discovered automatically (no configuration needed)\n3. For each relation, the system applies mention mapping and contextual mapping\n\n**Example:** If your Todos database has relations to \"Projects db\", \"Clients\", and \"Tags\":\n\n- All three are auto-discovered\n- @mentions in todos are mapped to the correct relation based on the mentioned page's parent database\n- Contextual mapping links todos based on source page relationships\n\n## Owner Resolution\n\nThe system automatically determines task ownership from context and resolves it to the correct Notion property format.\n\n### Property Type Detection\n\nThe Owner property type is detected at runtime from your Todos database schema:\n\n- **People type**: Stores Notion workspace user references\n- **Relation type**: Links to pages in another database (e.g., Contacts)\n\n### How Owner is Determined\n\nWhen generating the AI summary, the system extracts an owner name from context using this priority:\n\n1. **Heading** - Preceding heading contains a person's name (e.g., \"### Alex\")\n2. **Contact** - Matched contact from name matching\n3. **Mention** - First @mention in the todo text\n\n### Resolution by Property Type\n\n**If Owner is a People property:**\n\nThe owner name is matched to a Notion workspace user:\n\n1. Check @mentions in the todo (already have user IDs)\n2. Check if the block author's name matches (for heading-based ownership)\n3. Search workspace users by name (supports first-name matching)\n\nExample: Owner name \"Alex Johnson\" matches workspace user \"Alex @ Acme Corp\" via first-name matching (\"Alex\" = \"Alex\").\n\n**If Owner is a Relation property:**\n\nThe owner name is matched to a page in the relation's target database using name matching with AI disambiguation if multiple pages match.\n\n### Key Insight\n\nThe AI's owner name is a **search term**, not a final value. The same name resolves differently based on property type:\n\n- \"Jane Smith\" → Workspace user \"Jane\" (if Owner is people type)\n- \"Jane Smith\" → Contacts page \"Jane Smith\" (if Owner is relation type)\n\n### Notion Workspace Members vs Guests\n\nNotion distinguishes between two types of users:\n\n- **Members**: Full workspace users with complete access (paid seats)\n- **Guests**: External collaborators with limited access to specific pages\n\n**API Limitation**: The Notion API's `users.list()` endpoint only returns **members**, not guests. This has important implications:\n\n| Property Type | Can match members? | Can match guests? |\n|---------------|-------------------|-------------------|\n| People | ✅ Yes | ❌ No |\n| Relation | ✅ Yes (via name match) | ✅ Yes (via name match) |\n\nIf you use a **People** type for Owner and the owner is a guest user (e.g., an external client), the system cannot find them by name and the Owner field will remain empty.\n\n### Choosing Between People and Relation Types\n\n**Use People type when:**\n- All task owners are full workspace members\n- You want native Notion user avatars and @mention integration\n- Your team is internal-only\n\n**Use Relation type when:**\n- Task owners include external contacts, clients, or guests\n- You have a Contacts/People database you want to link to\n- You need to track owners who aren't Notion users\n- You want owner matching to work regardless of workspace membership\n\n**Recommendation**: If you're unsure, use **Relation type**. It's more flexible and works with both workspace members and external contacts. Create a Contacts database with names — the system will match owners from heading context and @mentions automatically.\n\n### Example Scenarios\n\n**Scenario A: Internal team todos**\n```\nOwner property: People type\nTeam members: All are workspace members\nResult: ✅ Works perfectly - names matched to workspace users\n```\n\n**Scenario B: Client-facing project todos**\n```\nOwner property: People type\nOwners include: External client (guest user)\nResult: ❌ Guest not found - guests not returned by users.list()\n\nFix: Change Owner to Relation type pointing to Contacts database\nResult: ✅ Client name matched to Contacts page via heading/mention matching\n```\n\n**Scenario C: Mixed internal + external**\n```\nOwner property: Relation type → Contacts database\nContacts database: Contains both team members and clients\nResult: ✅ All names matched via heading/mention matching, regardless of workspace status\n```\n\n## Relation Matching Strategies\n\nWhen syncing todos to the database, the system automatically links them to related pages using matching strategies in priority order. Strategy 1 matches (mentions + headings) can accumulate — both @mentions and heading matches are added to the same relation. Strategy 2 only applies as a fallback when Strategy 1 finds no matches.\n\n### Strategy 1: Explicit Matches\n\n**1a: @Mentions** — If the todo text contains an @mention to a page that exists in a relation's target database, the todo is linked to that page.\n\n**Example**: A todo containing `@Project Alpha` will be linked to \"Project Alpha\" if it exists in the relation's target database.\n\n**1b: Heading Text** — If the preceding heading text exactly matches a page name in a relation's target database, the todo is linked to that page. This allows organizing todos under project headings without needing @mentions.\n\n**Example**:\n```\n### Stainless todoSweeper v1 ← Heading matches page name in Projects db\n- [ ] verify this goes to the right place\n→ Todo is linked to \"Stainless todoSweeper v1\"\n```\n\n**Note**: Both 1a and 1b can match — if a heading matches one project and the todo @mentions another, both are added to the relation.\n\n### Strategy 2: Contextual Mapping (Fallback)\n\nIf strategy 1 doesn't find a match, the system uses the source page's context to infer relations. Three sub-strategies are checked in order:\n\n**2a: Source page relation properties** — If the source page has a relation property whose values exist in a target database, those values are used. This is the strongest contextual signal because someone explicitly assigned the page to a project/contact.\n\n**Example**: A \"Meeting Notes\" page has a \"Project\" relation set to \"Acme Redesign\". Todos on that page inherit the \"Acme Redesign\" link. Zero extra API calls — relations are captured when the source page is fetched during search.\n\n**2b: Source page is a direct database entry** — If the source page is a direct entry in a relation's target database (i.e., `parent.type === 'database_id'`), the todo is linked to that page.\n\n**Example**: A todo on the \"Project Beta\" page (which is a direct entry in the Projects database) is linked to \"Project Beta\".\n\n**2c: Parent page traversal** — If the source page is a child page (where `parent.type === 'page_id'`, not `'database_id'`), the system walks up the page hierarchy (up to 3 levels) checking each ancestor for matches via 2a or 2b.\n\n**Example**: A todo on a sub-page \"Sprint Notes\" nested under project page \"Project Beta\" — the system fetches the parent page, finds it's a direct entry in the Projects database, and links the todo to \"Project Beta\". Costs up to 3 API calls per block, but only fires for child pages where `source_page_database_id` is null.\n\n### Owner Matching\n\nOwner resolution is handled separately from general relation matching. When the Owner property is a relation type (pointing to a Contacts database), the system matches names from headings, @mentions, and AI-extracted owner names against the contacts database using its own dedicated matching logic. This supports partial name matching (e.g., \"bryce\" in a heading matches \"Bryce Roberts\" in the contacts database).\n\n### Configuration\n\nRelations are auto-discovered from your Todos database schema — no configuration needed.\n\n## Getting Started\n\n### Prerequisites\n\n1. Create a Notion integration at https://www.notion.so/my-integrations\n2. Create a Notion database with these properties:\n - **Name** (title)\n - **Block ID** (rich_text)\n - **Block URL** (url)\n - **Page URL** (url) - source page where todo was found\n - **Todo last edited time** (date)\n - **Owner** (people)\n - **Other people** (people)\n - **Due date** (date)\n - **Links** (rich_text)\n - **Projects db** (relation) - optional, auto-discovered for relation mapping\n3. Share the database with your integration\n\n### Setup\n\n1. Fork this val in Val Town\n2. Set environment variables:\n - `NOTION_API_KEY` = your integration token\n - `TODOS_DB_ID` = your database ID\n - *(No search configuration needed - defaults to checkbox/`to_do` search)*\n3. Test with: `POST /tasks/todos?hours=1`\n\nRelations are auto-discovered from your database schema - no configuration needed.\n\n**Additive keyword search** - To also capture keyword matches, set `SEARCH_KEYWORDS=todo` (or your preferred keywords, comma-separated).\n\n### Usage Examples\n\n#### Default Mode (Checkbox Search)\n\n**Find and sync all checkbox todos from last 24 hours**:\n\n```bash\n# Default behavior - no env vars needed\ncurl -X POST https://your-val.express/tasks/todos\n```\n\n**Custom time window**:\n\n```bash\ncurl -X POST \"https://your-val.express/tasks/todos?hours=48\"\n```\n\n**Find all bullet points instead of checkboxes**:\n\n```bash\n# Set: SEARCH_BLOCK_TYPE=bulleted_list_item\ncurl -X POST https://your-val.express/tasks/todos\n```\n\n#### Additive: Keyword Search Examples\n\n**Also capture blocks containing \"todo\" keyword**:\n\n```bash\n# Set: SEARCH_KEYWORDS=todo\n# Finds: to_do blocks AND any block containing \"todo\"\ncurl -X POST https://your-val.express/tasks/todos\n```\n\n**Also capture blocks with multiple keywords**:\n\n```bash\n# Set: SEARCH_KEYWORDS=todo,urgent,🍋\n# Finds: to_do blocks AND blocks containing any of these keywords\ncurl -X POST https://your-val.express/tasks/todos\n```\n\n#### Other Examples\n\n**Get recent pages (API)**:\n\n```bash\ncurl \"https://your-val.express/api/pages/recent?hours=12\"\n```\n\n## Development Guidelines\n\n- **For project-specific architecture**: See `CLAUDE.md`\n- **For Val Town platform guidelines**: See `AGENTS.md`\n\n## Tech Stack\n\n- **Runtime**: Deno on Val Town\n- **Framework**: Hono (lightweight web framework)\n- **Frontend**: React 18.2.0 with Pico CSS (classless CSS framework)\n- **APIs**:\n - Notion API (@notionhq/client v2)\n - Val Town blob storage\n- **Language**: TypeScript\n\n## Architecture Diagrams\n\n### Complete System Flow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ Notion Workspace │\n│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │\n│ │ Page A │ │ Page B │ │ Page C │ │\n│ │ ☐ │ │ ☐ │ │ │ │\n│ └──────────┘ └──────────┘ └──────────┘ │\n└──────────────────────────┬──────────────────────────────────┘\n │\n ▼\n ┌─────────────────────────────────────┐\n │ POST /tasks/todos │\n │ (Batch Search & Sync Endpoint) │\n └─────────────────┬───────────────────┘\n │\n ┌──────────────────┴──────────────────┐\n │ │\n ▼ ▼\n┌───────────────────┐ ┌──────────────────────────┐\n│ Step 1: Search │ │ Step 3: Sync (Optimized)│\n│ │ │ │\n│ • Get recent pages│ │ • Read blobs │\n│ • Fetch all blocks│ │ • Skip if synced: true │\n│ • Find checkboxes │ │ • Use cached page ID │\n│ • Extract data │ │ • Create/update pages │\n│ • Validate │ │ • Mark synced: true │\n└─────────┬─────────┘ └──────────────────────────┘\n │ ▲\n ▼ │\n┌─────────────────────┐ │\n│ Step 2: Store │ │\n│ │ │\n│ • Save to blobs │──────────────────────┘\n│ • Set synced: false │\n│ • Compare timestamps│\n│ • Preserve page ID │\n└─────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────────┐\n│ Val Town Blob Storage │\n│ │\n│ demo--todo--block-1: { data, sync_metadata: {synced, page_id} }│\n│ demo--todo--block-2: { data, sync_metadata: {synced, page_id} }│\n│ demo--todo--block-3: { data, sync_metadata: {synced, page_id} }│\n└─────────────────────────────────────────────────────────────────┘\n```\n\n### MVC Layer Interaction\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│ HTTP Request │\n│ POST /tasks/todos?hours=24 │\n└──────────────────────┬───────────────────────────────────────┘\n │\n ▼\n ┌─────────────────────────────┐\n │ ROUTE (todos.ts) │\n │ • Extract query params │\n │ • Call controller │\n │ • Format HTTP response │\n └─────────────┬───────────────┘\n │\n ▼\n ┌─────────────────────────────────────┐\n │ CONTROLLER (orchestration) │\n │ • Validate inputs │\n │ • Orchestrate workflow: │\n │ 1. Get recent pages │\n │ 2. Search each page │\n │ 3. Sync to database │\n │ • Return standardized result │\n └──────────────┬──────────────────────┘\n │\n ┌───────────┼───────────┐\n │ │ │\n ▼ ▼ ▼\n ┌───────────┐ ┌──────────┐ ┌────────────┐\n │ SERVICE: │ │ SERVICE: │ │ SERVICE: │\n │ pages.ts │ │ blob.ts │ │ database.ts│\n │ │ │ │ │ │\n │ • API call│ │ • Blob │ │ • Query DB │\n │ • Parse │ │ CRUD │ │ • Create │\n │ • Return │ │ • Return │ │ • Update │\n └─────┬─────┘ └────┬─────┘ └─────┬──────┘\n │ │ │\n ▼ ▼ ▼\n Notion API Blob Storage Notion API\n```\n\n## Known Limitations\n\n### Notion Timestamp Precision\n\nNotion's `last_edited_time` on blocks is rounded to the minute. This affects change detection:\n\n| Scenario | Detection | Notes |\n|----------|-----------|-------|\n| Edits in different minutes | ✅ Detected | Timestamp comparison works |\n| Edits within same minute | ⚠️ May miss | Same minute = same timestamp |\n| Checkbox toggle (same minute) | ✅ Detected | Explicit `checked` comparison |\n| Text edit (same minute) | ❌ Missed | Caught on next different-minute edit |\n\n**Practical impact**: If you write a todo and immediately check it off (within 60 seconds), the checkbox change is detected. If you edit text twice within 60 seconds, only the first edit syncs until a later edit.\n\n**Workaround**: Wait ~60 seconds between edits, or make another edit later.\n\n## License\n\nMIT\n",[],[599],{"_106":743,"_97":744,"_168":745,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":746,"_102":33,"_176":190,"_178":747,"_179":22,"_180":-5,"_181":748,"_100":749},"1cb9ac7c-b360-11f0-bc6f-0224a6c84d84","deno.json","019a26dc-99bf-7269-a8f6-768a874ec6fc",["D",1761588582800],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[744],{"_106":751,"_97":101,"_168":118,"_170":-5,"_171":149,"_172":752,"_174":120,"_108":753,"_102":291,"_176":754,"_178":755,"_179":22,"_180":756,"_181":757,"_100":758},"ed065d98-d5cb-11f0-a34c-42dde27851f2",183,["D",1765373228006],"http","import { Hono } from \"npm:hono@4\";\nimport {\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { webhookAuth } from \"./backend/routes/authCheck.ts\";\nimport api from \"./backend/routes/api/index.ts\";\nimport favicon from \"./backend/routes/tasks/favicon.ts\";\nimport todoPage from \"./backend/routes/tasks/todoPage.ts\";\nimport todoSave from \"./backend/routes/tasks/todoSave.ts\";\nimport todos from \"./backend/routes/tasks/todos.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve static frontend files\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n\n// Serve main HTML page\napp.get(\"/\", async (c) => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// Authentication middleware\n// Protects specified prefixes, with exceptions for public endpoints\nconst protectedPrefixes = ['/tasks', '/api'];\nconst publicExceptions = ['/api/health'];\n\napp.use('*', async (c, next) => {\n const path = c.req.path;\n\n // Check if it's a public exception\n if (publicExceptions.includes(path)) {\n await next();\n return;\n }\n\n // Check if path needs auth\n const needsAuth = protectedPrefixes.some(prefix => path.startsWith(prefix));\n\n if (needsAuth) {\n await webhookAuth(c, next);\n } else {\n await next();\n }\n});\n\n// Mount API routes\napp.route(\"/api\", api);\n\n// Mount webhook routes\napp.route(\"/tasks/favicon\", favicon);\napp.route(\"/tasks/todos/page\", todoPage);\napp.route(\"/tasks/todos/save\", todoSave);\napp.route(\"/tasks/todos\", todos);\n\n// Mount view routes (to be added)\n// Example:\n// import { viewRoutes } from './backend/routes/views/index.ts';\n// app.route('/views', viewRoutes);\n\n// This is the entry point for Val Town HTTP vals\nexport default app.fetch;\n","todosweeper",[],[101],"files",[165,183,195,201,207,218,228,238,248,258,268,275,285,295,304,310,316,325,333,342,348,357,366,375,385,392,402,408,414,423,432,440,449,459,467,477,486,496,505,511,519,528,536,545,553,562,571,579,587,597,606,612,618,627,635,644,651,661,670,676,683,692,702,710,718,726,734,742,750],"counts",{"_763":33,"_764":234,"_765":173,"_766":767,"_770":771},"pulls","branches","forks","envVars",{"_768":352,"_769":33},"count","emptyCount","connections",{"_768":33,"_772":33},"unfilledCount","contents",[],{"_106":751,"_97":101,"_168":118,"_170":-5,"_171":149,"_172":752,"_174":120,"_108":776,"_102":291,"_176":754,"_178":755,"_179":22,"_180":756,"_100":777},["D",1765373228006],[101],"upstreamProject","upstreamBranch",{"_106":152,"_108":781,"_782":783,"_97":45,"_150":158,"_102":784,"_151":-5,"_153":-5,"_785":786,"_110":-5,"_162":22,"_112":156,"_161":96,"_16":124,"_160":787},["D",1761570769002],"updatedAt",["D",1762379577029],82,"lockfileKey","1762415664461-esm.town_v_lightweight_scaffold@82-main","scaffold","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_95":96,"_97":98,"_99":45,"_102":103,"_100":101,"_104":794,"_163":799,"_759":1007,"_190":1008,"_773":1011,"_1012":1013,"_1016":-5,"_1017":1018,"_1019":1020,"_1021":1022,"_766":-5},{"_106":107,"_97":98,"_108":795,"_110":-5,"_111":22,"_112":113,"_114":-5,"_115":-5,"_14":116,"_117":118,"_119":120,"_121":120,"_122":-5,"_123":33,"_16":124,"_125":126,"_127":128,"_129":130,"_131":130,"_132":133,"_134":133,"_135":133,"_136":130,"_137":130,"_23":796,"_141":797,"_146":798,"_162":22},["D",1761588582800],{"_95":96,"_139":140},{"_95":96,"_143":140,"_14":116,"_144":145},{"_102":148,"_97":45,"_106":149,"_150":107,"_151":152,"_153":154,"_155":156,"_157":158,"_159":124,"_160":98,"_161":96},[800,806,950,974,986,989,992,995,998,1001,1004],{"_106":166,"_97":167,"_168":169,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":175,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":801,"_100":805},[802],{"_106":184,"_97":185,"_168":186,"_170":169,"_171":149,"_172":187,"_174":120,"_108":188,"_102":189,"_176":190,"_178":191,"_179":22,"_180":-5,"_181":803,"_100":804},[],[167,185],[167],{"_106":196,"_97":197,"_168":198,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":199,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":807,"_100":949},[808,829,841,877,913,946],{"_106":202,"_97":203,"_168":204,"_170":198,"_171":149,"_172":173,"_174":120,"_108":205,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":809,"_100":828},[810,813,816,819,822,825],{"_106":208,"_97":209,"_168":210,"_170":204,"_171":149,"_172":211,"_174":120,"_108":212,"_102":213,"_176":214,"_178":215,"_179":22,"_180":-5,"_181":811,"_100":812},[],[197,203,209],{"_106":219,"_97":220,"_168":221,"_170":204,"_171":149,"_172":222,"_174":120,"_108":223,"_102":224,"_176":214,"_178":225,"_179":22,"_180":-5,"_181":814,"_100":815},[],[197,203,220],{"_106":229,"_97":230,"_168":231,"_170":204,"_171":149,"_172":232,"_174":120,"_108":233,"_102":234,"_176":214,"_178":235,"_179":22,"_180":-5,"_181":817,"_100":818},[],[197,203,230],{"_106":239,"_97":240,"_168":241,"_170":204,"_171":149,"_172":242,"_174":22,"_108":243,"_102":244,"_176":214,"_178":245,"_179":22,"_180":-5,"_181":820,"_100":821},[],[197,203,240],{"_106":249,"_97":250,"_168":251,"_170":204,"_171":149,"_172":252,"_174":120,"_108":253,"_102":254,"_176":214,"_178":255,"_179":22,"_180":-5,"_181":823,"_100":824},[],[197,203,250],{"_106":259,"_97":260,"_168":261,"_170":204,"_171":149,"_172":103,"_174":22,"_108":262,"_102":263,"_176":214,"_178":264,"_179":22,"_180":-5,"_181":826,"_100":827},[],[197,203,260],[197,203],{"_106":269,"_97":270,"_168":271,"_170":198,"_171":149,"_172":272,"_174":120,"_108":273,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":830,"_100":840},[831,834,837],{"_106":276,"_97":277,"_168":278,"_170":271,"_171":149,"_172":279,"_174":120,"_108":280,"_102":33,"_176":281,"_178":282,"_179":22,"_180":-5,"_181":832,"_100":833},[],[197,270,277],{"_106":286,"_97":287,"_168":288,"_170":271,"_171":149,"_172":289,"_174":120,"_108":290,"_102":291,"_176":281,"_178":292,"_179":22,"_180":-5,"_181":835,"_100":836},[],[197,270,287],{"_106":296,"_97":297,"_168":298,"_170":271,"_171":149,"_172":289,"_174":120,"_108":299,"_102":234,"_176":281,"_178":300,"_179":22,"_180":-5,"_181":838,"_100":839},[],[197,270,297],[197,270],{"_106":305,"_97":306,"_168":307,"_170":198,"_171":149,"_172":173,"_174":120,"_108":308,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":842,"_100":876},[843,855,870,873],{"_106":311,"_97":312,"_168":313,"_170":307,"_171":149,"_172":173,"_174":120,"_108":314,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":844,"_100":854},[845,848,851],{"_106":317,"_97":318,"_168":319,"_170":313,"_171":149,"_172":320,"_174":120,"_108":321,"_102":234,"_176":214,"_178":322,"_179":22,"_180":-5,"_181":846,"_100":847},[],[197,306,312,318],{"_106":326,"_97":327,"_168":328,"_170":313,"_171":149,"_172":232,"_174":120,"_108":329,"_102":173,"_176":214,"_178":330,"_179":22,"_180":-5,"_181":849,"_100":850},[],[197,306,312,327],{"_106":334,"_97":335,"_168":336,"_170":313,"_171":149,"_172":272,"_174":120,"_108":337,"_102":173,"_176":214,"_178":338,"_179":22,"_180":-5,"_181":852,"_100":853},[],[197,306,312,335],[197,306,312],{"_106":343,"_97":344,"_168":345,"_170":307,"_171":149,"_172":173,"_174":120,"_108":346,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":856,"_100":869},[857,860,863,866],{"_106":349,"_97":350,"_168":351,"_170":345,"_171":149,"_172":352,"_174":120,"_108":353,"_102":234,"_176":214,"_178":354,"_179":22,"_180":-5,"_181":858,"_100":859},[],[197,306,344,350],{"_106":358,"_97":359,"_168":360,"_170":345,"_171":149,"_172":361,"_174":120,"_108":362,"_102":234,"_176":214,"_178":363,"_179":22,"_180":-5,"_181":861,"_100":862},[],[197,306,344,359],{"_106":367,"_97":368,"_168":369,"_170":345,"_171":149,"_172":370,"_174":120,"_108":371,"_102":33,"_176":214,"_178":372,"_179":22,"_180":-5,"_181":864,"_100":865},[],[197,306,344,368],{"_106":376,"_97":377,"_168":378,"_170":345,"_171":149,"_172":379,"_174":120,"_108":380,"_102":213,"_176":214,"_178":381,"_179":22,"_180":-5,"_181":867,"_100":868},[],[197,306,344,377],[197,306,344],{"_106":386,"_97":387,"_168":388,"_170":307,"_171":149,"_172":173,"_174":120,"_108":389,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":871,"_100":872},[],[197,306,387],{"_106":393,"_97":394,"_168":395,"_170":307,"_171":149,"_172":396,"_174":120,"_108":397,"_102":213,"_176":214,"_178":398,"_179":22,"_180":-5,"_181":874,"_100":875},[],[197,306,394],[197,306],{"_106":403,"_97":404,"_168":405,"_170":198,"_171":149,"_172":173,"_174":120,"_108":406,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":878,"_100":912},[879,903,906,909],{"_106":409,"_97":410,"_168":411,"_170":405,"_171":149,"_172":173,"_174":120,"_108":412,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":880,"_100":902},[881,884,887,890,893,896,899],{"_106":415,"_97":416,"_168":417,"_170":411,"_171":149,"_172":418,"_174":120,"_108":419,"_102":173,"_176":214,"_178":420,"_179":22,"_180":-5,"_181":882,"_100":883},[],[197,404,410,416],{"_106":424,"_97":425,"_168":426,"_170":411,"_171":149,"_172":242,"_174":120,"_108":427,"_102":428,"_176":214,"_178":429,"_179":22,"_180":-5,"_181":885,"_100":886},[],[197,404,410,425],{"_106":433,"_97":327,"_168":434,"_170":411,"_171":149,"_172":435,"_174":120,"_108":436,"_102":291,"_176":214,"_178":437,"_179":22,"_180":-5,"_181":888,"_100":889},[],[197,404,410,327],{"_106":441,"_97":335,"_168":442,"_170":411,"_171":149,"_172":443,"_174":120,"_108":444,"_102":445,"_176":214,"_178":446,"_179":22,"_180":-5,"_181":891,"_100":892},[],[197,404,410,335],{"_106":450,"_97":451,"_168":452,"_170":411,"_171":149,"_172":453,"_174":120,"_108":454,"_102":455,"_176":214,"_178":456,"_179":22,"_180":-5,"_181":894,"_100":895},[],[197,404,410,451],{"_106":460,"_97":461,"_168":462,"_170":411,"_171":149,"_172":272,"_174":120,"_108":463,"_102":33,"_176":214,"_178":464,"_179":22,"_180":-5,"_181":897,"_100":898},[],[197,404,410,461],{"_106":468,"_97":469,"_168":470,"_170":411,"_171":149,"_172":471,"_174":120,"_108":472,"_102":173,"_176":214,"_178":473,"_179":22,"_180":-5,"_181":900,"_100":901},[],[197,404,410,469],[197,404,410],{"_106":478,"_97":479,"_168":480,"_170":405,"_171":149,"_172":103,"_174":22,"_108":481,"_102":482,"_176":214,"_178":483,"_179":22,"_180":-5,"_181":904,"_100":905},[],[197,404,479],{"_106":487,"_97":488,"_168":489,"_170":405,"_171":149,"_172":490,"_174":120,"_108":491,"_102":492,"_176":214,"_178":493,"_179":22,"_180":-5,"_181":907,"_100":908},[],[197,404,488],{"_106":497,"_97":498,"_168":499,"_170":405,"_171":149,"_172":445,"_174":120,"_108":500,"_102":173,"_176":214,"_178":501,"_179":22,"_180":-5,"_181":910,"_100":911},[],[197,404,498],[197,404],{"_106":506,"_97":507,"_168":508,"_170":198,"_171":149,"_172":370,"_174":120,"_108":509,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":914,"_100":945},[915,918,921,924,927,930,933,936,939,942],{"_106":512,"_97":513,"_168":514,"_170":508,"_171":149,"_172":370,"_174":120,"_108":515,"_102":33,"_176":214,"_178":516,"_179":22,"_180":-5,"_181":916,"_100":917},[],[197,507,513],{"_106":520,"_97":521,"_168":522,"_170":508,"_171":149,"_172":523,"_174":120,"_108":524,"_102":234,"_176":214,"_178":525,"_179":22,"_180":-5,"_181":919,"_100":920},[],[197,507,521],{"_106":529,"_97":530,"_168":531,"_170":508,"_171":149,"_172":242,"_174":120,"_108":532,"_102":234,"_176":214,"_178":533,"_179":22,"_180":-5,"_181":922,"_100":923},[],[197,507,530],{"_106":537,"_97":538,"_168":539,"_170":508,"_171":149,"_172":540,"_174":120,"_108":541,"_102":173,"_176":214,"_178":542,"_179":22,"_180":-5,"_181":925,"_100":926},[],[197,507,538],{"_106":546,"_97":547,"_168":548,"_170":508,"_171":149,"_172":370,"_174":120,"_108":549,"_102":33,"_176":214,"_178":550,"_179":22,"_180":-5,"_181":928,"_100":929},[],[197,507,547],{"_106":554,"_97":555,"_168":556,"_170":508,"_171":149,"_172":557,"_174":120,"_108":558,"_102":33,"_176":214,"_178":559,"_179":22,"_180":-5,"_181":931,"_100":932},[],[197,507,555],{"_106":563,"_97":564,"_168":565,"_170":508,"_171":149,"_172":566,"_174":120,"_108":567,"_102":254,"_176":214,"_178":568,"_179":22,"_180":-5,"_181":934,"_100":935},[],[197,507,564],{"_106":572,"_97":573,"_168":574,"_170":508,"_171":149,"_172":242,"_174":120,"_108":575,"_102":428,"_176":214,"_178":576,"_179":22,"_180":-5,"_181":937,"_100":938},[],[197,507,573],{"_106":580,"_97":581,"_168":582,"_170":508,"_171":149,"_172":428,"_174":120,"_108":583,"_102":33,"_176":214,"_178":584,"_179":22,"_180":-5,"_181":940,"_100":941},[],[197,507,581],{"_106":588,"_97":589,"_168":590,"_170":508,"_171":149,"_172":591,"_174":120,"_108":592,"_102":33,"_176":214,"_178":593,"_179":22,"_180":-5,"_181":943,"_100":944},[],[197,507,589],[197,507],{"_106":598,"_97":599,"_168":600,"_170":198,"_171":149,"_172":173,"_174":120,"_108":601,"_102":33,"_176":190,"_178":602,"_179":22,"_180":-5,"_181":947,"_100":948},[],[197,599],[197],{"_106":607,"_97":608,"_168":609,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":610,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":951,"_100":973},[952,964,967,970],{"_106":613,"_97":614,"_168":615,"_170":609,"_171":149,"_172":173,"_174":120,"_108":616,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":953,"_100":963},[954,957,960],{"_106":619,"_97":620,"_168":621,"_170":615,"_171":149,"_172":566,"_174":120,"_108":622,"_102":623,"_176":214,"_178":624,"_179":22,"_180":-5,"_181":955,"_100":956},[],[608,614,620],{"_106":628,"_97":629,"_168":630,"_170":615,"_171":149,"_172":173,"_174":120,"_108":631,"_102":33,"_176":214,"_178":632,"_179":22,"_180":-5,"_181":958,"_100":959},[],[608,614,629],{"_106":636,"_97":637,"_168":638,"_170":615,"_171":149,"_172":173,"_174":120,"_108":639,"_102":33,"_176":214,"_178":640,"_179":22,"_180":-5,"_181":961,"_100":962},[],[608,614,637],[608,614],{"_106":645,"_97":599,"_168":646,"_170":609,"_171":149,"_172":173,"_174":120,"_108":647,"_102":33,"_176":190,"_178":648,"_179":22,"_180":-5,"_181":965,"_100":966},[],[608,599],{"_106":652,"_97":653,"_168":654,"_170":609,"_171":149,"_172":655,"_174":120,"_108":656,"_102":657,"_176":190,"_178":658,"_179":22,"_180":-5,"_181":968,"_100":969},[],[608,653],{"_106":662,"_97":663,"_168":664,"_170":609,"_171":149,"_172":173,"_174":120,"_108":665,"_102":33,"_176":214,"_178":666,"_179":22,"_180":-5,"_181":971,"_100":972},[],[608,663],[608],{"_106":671,"_97":672,"_168":673,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":674,"_102":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":975,"_100":985},[976,979,982],{"_106":677,"_97":599,"_168":678,"_170":673,"_171":149,"_172":173,"_174":120,"_108":679,"_102":33,"_176":190,"_178":680,"_179":22,"_180":-5,"_181":977,"_100":978},[],[672,599],{"_106":684,"_97":685,"_168":686,"_170":673,"_171":149,"_172":687,"_174":120,"_108":688,"_102":224,"_176":214,"_178":689,"_179":22,"_180":-5,"_181":980,"_100":981},[],[672,685],{"_106":693,"_97":694,"_168":695,"_170":673,"_171":149,"_172":696,"_174":120,"_108":697,"_102":234,"_176":214,"_178":698,"_179":22,"_180":-5,"_181":983,"_100":984},[],[672,694],[672],{"_106":703,"_97":704,"_168":705,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":706,"_102":33,"_176":190,"_178":707,"_179":22,"_180":-5,"_181":987,"_100":988},[],[704],{"_106":711,"_97":712,"_168":713,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":714,"_102":33,"_176":190,"_178":715,"_179":22,"_180":-5,"_181":990,"_100":991},[],[712],{"_106":719,"_97":720,"_168":721,"_170":-5,"_171":149,"_172":103,"_174":22,"_108":722,"_102":234,"_176":190,"_178":723,"_179":22,"_180":-5,"_181":993,"_100":994},[],[720],{"_106":727,"_97":728,"_168":729,"_170":-5,"_171":149,"_172":242,"_174":120,"_108":730,"_102":291,"_176":190,"_178":731,"_179":22,"_180":-5,"_181":996,"_100":997},[],[728],{"_106":735,"_97":599,"_168":736,"_170":-5,"_171":149,"_172":737,"_174":22,"_108":738,"_102":263,"_176":190,"_178":739,"_179":22,"_180":-5,"_181":999,"_100":1000},[],[599],{"_106":743,"_97":744,"_168":745,"_170":-5,"_171":149,"_172":173,"_174":120,"_108":746,"_102":33,"_176":190,"_178":747,"_179":22,"_180":-5,"_181":1002,"_100":1003},[],[744],{"_106":751,"_97":101,"_168":118,"_170":-5,"_171":149,"_172":752,"_174":120,"_108":753,"_102":291,"_176":754,"_178":755,"_179":22,"_180":756,"_181":1005,"_100":1006},[],[101],[800,802,806,808,810,813,816,819,822,825,829,831,834,837,841,843,845,848,851,855,857,860,863,866,870,873,877,879,881,884,887,890,893,896,899,903,906,909,913,915,918,921,924,927,930,933,936,939,942,946,950,952,954,957,960,964,967,970,974,976,979,982,986,989,992,995,998,1001,1004],{"_106":751,"_171":149,"_168":118,"_97":101,"_178":755,"_176":754,"_102":291,"_170":-5,"_108":1009,"_172":752,"_180":756,"_100":1010},["D",1765373228006],[101],[],"upstream",{"_106":152,"_108":1014,"_782":1015,"_97":45,"_150":158,"_102":784,"_151":-5,"_153":-5,"_785":786,"_110":-5,"_162":22,"_112":156,"_161":96,"_16":124,"_160":787},["D",1761570769002],["D",1762379577029],"pull","ahead",437,"behind",9,"templates",[],"actionData","errors"] </article></body></html>

Configuration

Connections

Todos database property mappings

Required property mappings

Optional property mappings

Display Formula

Settings

Troubleshooting

\n {block.heading_1?.rich_text?.map((text: any, i: number) => (\n {text.plain_text}\n ))}\n

\n {block.heading_2?.rich_text?.map((text: any, i: number) => (\n {text.plain_text}\n ))}\n

\n {block.heading_3?.rich_text?.map((text: any, i: number) => (\n {text.plain_text}\n ))}\n

Hi