\n \n

Configuration

Connections, database property mappings, and settings

\n \n {loading &&

Checking system health...

}\n\n {!loading && !error && healthData && (\n <>\n {/* Health Summary */}\n {(() => {\n // Compute issue counts\n const connectionIssues = [\n healthData.connections.notion,\n healthData.connections.database,\n ].filter((c) => c.status !== \"connected\").length;\n\n const requiredIssues = healthData.properties\n .filter((p) => p.required)\n .filter((p) => {\n const state = deriveState(p);\n return state === \"missing\" || state === \"autodiscovered\";\n }).length;\n\n const totalIssues = connectionIssues + requiredIssues;\n\n return (\n

\n {totalIssues > 0 && (\n

\n ✗{\" \"}\n {totalIssues} issue{totalIssues > 1 ? \"s\" : \"\"}\n

\n )}\n

\n );\n })()}\n\n {/* Services */}\n

\n \n

Connections

\n \n

\n Notion\n

\n {healthData.connections.notion.status === \"connected\" ? (\n

\n                          Connected to{\" \"}\n                          {healthData.connections.notion.integrationName}\n

\n ) : (\n \n Not connected\n \n )}\n

Integration name: \n \n {healthData.connections.notion.integrationName}\n \n
Error: {healthData.connections.notion.error}
Environment variable: \n {healthData.connections.notion.envVar}\n

\n {healthData.connections.notion.status !== \"connected\" && (\n

\n To connect, add to your{\" \"}\n {envUrl ? (\n \n Val Town environment variables\n \n ) : (\n \"Val Town environment variables\"\n )}\n :\n
\n \n {healthData.connections.notion.envVar}\n =your-integration-token\n \n

\n )}\n \n

\n OpenAI\n

\n {healthData.connections.openai.status === \"connected\" ? (\n \n Connected\n \n ) : healthData.connections.openai.status === \"error\" ? (\n \n Not connected\n \n ) : (\n \n Not configured\n \n )}\n

Error: {healthData.connections.openai.error}
Environment variable: \n {healthData.connections.openai.envVar}\n

\n {healthData.connections.openai.status !== \"connected\" && (\n

\n To connect to OpenAI, add to your{\" \"}\n {envUrl ? (\n \n Val Town environment variables\n \n ) : (\n \"Val Town environment variables\"\n )}\n :\n
\n \n {healthData.connections.openai.envVar}=your-api-key\n \n

\n )}\n \n

\n Todos database\n

\n {healthData.connections.database.status ===\n \"connected\" ? (\n

\n                              Connected to{\" \"}\n                              {healthData.connections.database.name}\n

\n ) : (\n \n Not connected\n \n )}\n

Database name: \n {healthData.connections.database.url ? (\n \n {healthData.connections.database.name}\n \n ) : (\n healthData.connections.database.name\n )}\n
Database ID: \n \n {healthData.connections.database.id}\n \n
Error: {healthData.connections.database.error}
Environment variable: \n \n {healthData.connections.database.envVar}\n \n

\n {healthData.connections.database.status !==\n \"connected\" && (\n

\n To connect, add to your{\" \"}\n {envUrl ? (\n \n Val Town environment variables\n \n ) : (\n \"Val Town environment variables\"\n )}\n :\n
\n \n {healthData.connections.database.envVar}\n =your-database-id\n \n

\n )}\n \n

\n\n {/* Property Configuration - only show if Notion is connected */}\n {healthData.connections.notion.status === \"connected\" && (\n

\n \n

Todos database property mappings

\n For required, optional, and relation database properties\n

\n \n {/*

\n Default property display name →{\" \"}\n Actual database property name\n

*/}\n {/* Required - sync will fail without these */}\n

\n \n

Required property mappings

The sweep will fail if these properties have errors.

\n \n

\n \n

\n\n {/* Optional - nice to have */}\n

\n \n

Optional property mappings

\n These properties are not required for a successful sweep.\n

\n \n

\n \n

\n )}\n\n {/* Display Formula Helper */}\n {healthData.displayFormula && (\n

\n \n

Display Formula

\n Copy this formula into a new formula property in your todos\n database to show: Owner + Task + Due date\n

\n \n \n {healthData.displayFormula}\n \n

\n \n Example output: \"Alex to review the quarterly report by\n January 15, 2026\"\n \n

\n )}\n\n {/* Environment */}\n

\n \n

Settings

\n Set by{\" \"}\n {envUrl ? (\n \n environment variables\n \n ) : (\n \"environment variables\"\n )}{\" \"}\n in Val Town\n

\n \n \n \n \n \n \n \n \n \n {healthData.settings.map((setting) => (\n \n \n \n \n ))}\n \n

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

\n\n {/* Raw JSON */}\n

\n Raw health data (JSON)\n

\n Also available at{\" \"}\n \n \n /api/health\n \n \n

{JSON.stringify(healthData, null, 2)}

\n \n )}\n\n {!loading && error && (\n

\n ✗ Connection Error\n

{error}

Troubleshooting

\n Check that NOTION_API_KEY is set correctly\n
Verify your integration has access to your workspace
Ensure the API key hasn't expired
Make sure pages are shared with your integration

\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",[],[706],{"_110":713,"_100":714,"_173":715,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":716,"_106":33,"_181":193,"_183":717,"_184":22,"_185":-5,"_186":718,"_104":719},"7dd4282c-09e4-11f1-a83f-42dde27851f2","DISCLAIMER.md","019c5ddc-37d1-74ea-8081-0547fe4e3952",["D",1771101239266],"# Disclaimer\n\nThis software is provided for informational and productivity purposes only. By using this software, you acknowledge and agree to the following:\n\n## No Warranty\n\nThis software is provided \"as is\" without warranty of any kind, express or implied. The authors make no representations or warranties regarding the accuracy, reliability, completeness, or timeliness of the software or its results.\n\n## Data Handling\n\nThis software interacts with your Notion workspace and may:\n\n- Read pages, databases, and user information\n- Create, update, or modify pages in your databases\n- Store intermediate data in Val Town blob storage\n\n**You are solely responsible for:**\n\n- Maintaining backups of your Notion data\n- Verifying the accuracy of synced information\n- Monitoring the software's behavior in your workspace\n- Configuring the software correctly for your use case\n\n## Third-Party Services\n\nThis software integrates with third-party services including:\n\n- **Notion API** - Subject to Notion's terms of service and API limitations\n- **OpenAI API** (optional) - Subject to OpenAI's terms of service\n- **Val Town** - Subject to Val Town's terms of service\n\nThe authors are not responsible for changes, outages, or issues with these third-party services.\n\n## Limitation of Liability\n\nIn no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.\n\nThis includes, but is not limited to:\n\n- Data loss or corruption\n- Incorrect data synchronization\n- Service interruptions\n- Security breaches\n- Any direct, indirect, incidental, special, exemplary, or consequential damages\n\n## No Service Level Agreement\n\nThis software is not a managed service. There is no guarantee of:\n\n- Uptime or availability\n- Response time for issues\n- Ongoing maintenance or updates\n- Technical support\n\n## User Responsibility\n\nUsers are responsible for:\n\n- Understanding what the software does before enabling it\n- Testing in a safe environment before production use\n- Regularly reviewing synced data for accuracy\n- Disabling the software if issues arise (set `CRONS_DISABLED=true`)\n- Securing their API keys and environment variables\n\n## Acceptance\n\nBy using this software, you accept these terms and assume all associated risks.\n",[],[714],{"_110":721,"_100":722,"_173":723,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":724,"_106":33,"_181":193,"_183":725,"_184":22,"_185":-5,"_186":726,"_104":727},"7dd438e4-09e4-11f1-a83f-42dde27851f2","LICENSE","019c5ddc-37d1-74ea-8081-0acb2cf4312c",["D",1771101239266],"MIT License\n\nCopyright (c) 2026 Lightweight Industries, LLC\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",[],[722],{"_110":729,"_100":582,"_173":730,"_175":-5,"_176":156,"_177":178,"_179":22,"_112":731,"_106":33,"_181":193,"_183":732,"_184":22,"_185":-5,"_186":733,"_104":734},"7dd441b8-09e4-11f1-a83f-42dde27851f2","019c5ddc-37d1-74ea-8081-0f49abec7b7d",["D",1771101239266],"# Notion Todo Sync\n\nAutomatically syncs Notion checkbox todos to a centralized database with intelligent owner resolution, relation mapping, and AI-powered summaries.\n\n## Table of Contents\n\n- [Quick Start](#quick-start)\n- [How It Works](#how-it-works)\n- [Property Mapping](#property-mapping)\n- [Owner Resolution](#owner-resolution)\n- [Other People Resolution](#other-people-resolution)\n- [Due Date Resolution](#due-date-resolution)\n- [Status Resolution](#status-resolution)\n- [Relation Mapping](#relation-mapping)\n- [Configuration Reference](#configuration-reference)\n- [Advanced Topics](#advanced-topics)\n\n---\n\n## Quick Start\n\n### Required Environment Variables\n\n| Variable | Description |\n| ---------------- | ------------------------------------------------------------------------------------- |\n| `NOTION_API_KEY` | Your Notion integration token ([get one here](https://www.notion.so/my-integrations)) |\n| `TODOS_DB_ID` | Database ID where todos are synced (32-char ID without hyphens) |\n\n### Recommended: OpenAI API Key\n\n| Variable | Description |\n| ---------------- | ----------------------------------------------------- |\n| `OPENAI_API_KEY` | OpenAI API key for AI features (strongly recommended) |\n\n**What AI does:**\n\n- Polishes raw todo text into clean, standalone summaries\n- Extracts owner from text patterns (e.g., \"Taylor to call Jordan\" → owner: Taylor)\n- Determines which date in the todo is the deadline\n- Extracts other people mentioned in text\n- Disambiguates when multiple contacts match a name\n\n**Without `OPENAI_API_KEY`:** Falls back to Val Town's shared OpenAI client (10 req/min limit). If AI is unavailable, the system still works but uses raw text, heading/@mention-only owner resolution, and default due dates.\n\n### Required Database Properties\n\nYour Todos database needs these properties at minimum:\n\n| Property Name | Type | Purpose |\n| --------------- | --------- | --------------------------------------- |\n| Name | Title | The todo text (cleaned up by AI) |\n| Source block ID | Rich text | Unique identifier to prevent duplicates |\n\n### Setup Steps\n\n1. Create a Notion integration and get the API key\n2. Make sure the integration has access to your databases\n3. Set the environment variables\n\nBy using this software, you agree to the terms in [DISCLAIMER.md](DISCLAIMER.md).\n\n---\n\n## How It Works\n\n```\nNotion pages → Search for todos → Blob storage → Sync to database\n```\n\n1. **Search**: Scans recent pages for checkbox (`to_do`) blocks\n2. **Extract**: Captures text, @mentions, dates, page links, and surrounding context\n3. **Store**: Saves to blob storage with sync tracking\n4. **Sync**: Creates/updates pages in your Todos database with AI-powered summaries\n\n**What gets captured from a todo:**\n\n- Block text → Name (polished by AI)\n- @mentions → Owner and Other People\n- Dates in text → Due Date (AI interprets which is the deadline)\n- Page links → Relations (auto-mapped to matching databases)\n- Preceding heading → Owner context (if heading matches a contact name)\n- Checked/unchecked → Status (Done or Not started, if configured)\n\n**One-way sync with user override:**\n\nSync flows one direction: source pages → todos database. Updates from the source continue until a user edits the todo directly in the database. At that point, the database becomes authoritative for that todo—todoSweeper won't overwrite your explicit changes.\n\nThis works automatically using Notion's built-in `last_edited_by` system field (not a database property). You don't need to add or display this field—it's tracked by Notion on every page.\n\n---\n\n## Health Dashboard\n\nVisit the root URL of your val (`main.http.tsx`) to see a dashboard showing:\n\n- **Connection status**: Notion API and OpenAI connectivity\n- **Property mappings**: Which properties are configured and whether they exist in your database\n\nUse this to verify your setup is working and debug property mapping issues.\n\n---\n\n## Property Mapping\n\nThe system maps todo data to your database properties. Properties are matched by name.\n\n### Default Property Names\n\n| Key | Default Name | Required | Purpose |\n| ---------------------- | ----------------------- | -------- | -------------------------------- |\n| `name` | Name | **Yes** | Todo text (title property) |\n| `sourceBlockId` | Source block ID | **Yes** | Unique ID for deduplication |\n| `owner` | Owner | No | Person responsible for the todo |\n| `otherPeople` | Other people | No | Other people mentioned |\n| `dueDate` | Due date | No | When it's due |\n| `status` | _(disabled)_ | No | Checkbox sync (Done/Not started) |\n| `projects` | _(disabled)_ | No | Project relation |\n| `sourceBlockUrl` | Source block URL | No | Link to original block |\n| `sourcePageUrl` | Source page URL | No | Link to source page |\n| `sourceLastEditedTime` | Source last edited time | No | When source was edited |\n| `sourceAuthor` | Source author | No | Who created the block |\n| `sourceText` | Source text | No | Raw block text |\n| `links` | Links | No | URLs found in block |\n\n### Overriding Property Names\n\nIf your database uses different property names, override with environment variables:\n\n```\nTODOS_PROP_{key}=Your Property Name\n```\n\nThe `{key}` can be either format:\n\n- camelCase: `TODOS_PROP_otherPeople`\n- SCREAMING_SNAKE: `TODOS_PROP_OTHER_PEOPLE`\n\n| Key (camelCase) | Key (SCREAMING_SNAKE) |\n| ---------------------- | ------------------------- |\n| `name` | `NAME` |\n| `sourceBlockId` | `SOURCE_BLOCK_ID` |\n| `owner` | `OWNER` |\n| `otherPeople` | `OTHER_PEOPLE` |\n| `dueDate` | `DUE_DATE` |\n| `status` | `STATUS` |\n| `projects` | `PROJECTS` |\n| `sourceBlockUrl` | `SOURCE_BLOCK_URL` |\n| `sourcePageUrl` | `SOURCE_PAGE_URL` |\n| `sourceLastEditedTime` | `SOURCE_LAST_EDITED_TIME` |\n| `sourceAuthor` | `SOURCE_AUTHOR` |\n| `sourceText` | `SOURCE_TEXT` |\n| `links` | `LINKS` |\n\n**Examples (both formats work identically):**\n\n```bash\n# These two are equivalent:\nTODOS_PROP_dueDate=Deadline\nTODOS_PROP_DUE_DATE=Deadline\n\n# These two are equivalent:\nTODOS_PROP_otherPeople=Contacts\nTODOS_PROP_OTHER_PEOPLE=Contacts\n\n# These two are equivalent:\nTODOS_PROP_sourceBlockId=Block ID\nTODOS_PROP_SOURCE_BLOCK_ID=Block ID\n\n# Enable optional features (disabled by default):\nTODOS_PROP_status=Status # or TODOS_PROP_STATUS=Status\nTODOS_PROP_projects=Projects # or TODOS_PROP_PROJECTS=Projects\n```\n\n**To disable a property:** Set it to empty string:\n\n```bash\nTODOS_PROP_otherPeople= # or TODOS_PROP_OTHER_PEOPLE=\n```\n\n### Property Type Detection\n\nOwner and Other People can be either:\n\n- **People type**: Links to Notion workspace users\n- **Relation type**: Links to pages in another database (e.g., Contacts)\n\nThe system auto-detects the type from your database schema and adjusts matching behavior accordingly.\n\n---\n\n## Owner Resolution\n\nOwner is determined using a strict priority order. The first match wins.\n\n### Priority Order\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ Priority 1: HEADING MATCH │\n│ Does the preceding heading match someone in owner DB? │\n│ Example: \"### Alex\" matches \"Alex Johnson\" in Contacts │\n├─────────────────────────────────────────────────────────────┤\n│ MATCH → Use heading match (most reliable) │\n│ NO → Continue to Priority 2 │\n└─────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────┐\n│ Priority 2: @MENTION │\n│ Is there an @mention in the todo? │\n│ Example: \"@Jane should review the PR\" │\n├─────────────────────────────────────────────────────────────┤\n│ YES → Use first @mention │\n│ NO → Continue to Priority 3 │\n└─────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────┐\n│ Priority 3: AI EXTRACTION │\n│ AI extracts owner from todo text patterns │\n│ Example: \"Taylor to call Jordan\" → Taylor is owner │\n├─────────────────────────────────────────────────────────────┤\n│ Name extracted → Validate against owner database │\n│ FOUND → Use matched page/user │\n│ NOT FOUND → Owner = null (prevents hallucination) │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### Heading Proximity Rules\n\nHeadings only apply to todos **directly beneath them**. Any intervening block resets the heading context.\n\n**Heading applies:**\n\n```\n### Alex\n- [ ] Todo 1 ← owner context: \"Alex\"\n- [ ] Todo 2 ← owner context: \"Alex\"\n```\n\n**Paragraph resets heading:**\n\n```\n### Alex\nSome intro text here\n- [ ] Todo 1 ← owner context: null (reset by paragraph)\n```\n\n**Empty line resets heading:**\n\n```\n### Alex\n\n- [ ] Todo 1 ← owner context: null (reset by empty line)\n```\n\nThis prevents distant headings from incorrectly matching todos far below them.\n\n### People vs Relation Type\n\n| Owner Type | Matches Against |\n| ---------- | ----------------------------- |\n| People | Notion workspace members only |\n| Relation | Any page in target database |\n\n**Recommendation:** Use Relation type pointing to a Contacts database. It's more flexible and works with both workspace members and external contacts.\n\n---\n\n## Other People Resolution\n\nOther People captures everyone mentioned in a todo except the owner.\n\n### Sources\n\n1. **@Mentions**: All @mentions (except the resolved owner) are added\n2. **AI-Extracted Names**: Names mentioned in text (only when Other People is a relation type)\n\n### AI-Extracted Name Matching\n\nWhen Other People is a relation property, AI extracts names from the todo text:\n\n```\n\"Call Kevin about the project\" → AI extracts \"Kevin\"\n```\n\n**Matching rules:**\n\n- Exact match first (case-insensitive)\n- Prefix match fallback: \"Kevin M\" matches \"Kevin McIntyre\"\n- Skipped if ambiguous (multiple matches)\n- Skipped if already the owner or an @mention\n\n---\n\n## Due Date Resolution\n\nAI determines the due date from your todo content.\n\n### How It Works\n\n1. AI examines all dates mentioned in the todo\n2. AI picks the one that looks like a deadline\n3. If no date in text, uses `DEFAULT_DUE_DATE` setting\n4. AI always returns a date (never leaves it blank)\n\n### Default Date Options\n\nSet `DEFAULT_DUE_DATE` environment variable:\n\n| Value | Meaning |\n| ------------------- | ------------------- |\n| `today` | Due today (default) |\n| `tomorrow` | Due tomorrow |\n| `one_week` | Due 7 days from now |\n| `end_of_week` | Due next Friday |\n| `next_business_day` | Due next weekday |\n\n---\n\n## Status Resolution\n\nWhen `TODOS_PROP_STATUS` is set, checkbox state syncs to your status property.\n\n| Checkbox State | Status Value |\n|----------------|--------------|\n| Checked | \"Done\" (or \"Complete\", \"Completed\", \"Finished\") |\n| Unchecked | First non-done option (e.g., \"Not started\", \"To Do\") |\n\nSupports Status, Select, and Checkbox property types. The system auto-detects your property type and finds matching options.\n\n---\n\n## Relation Mapping\n\nTodos are automatically linked to related pages (projects, tags, etc.) using these strategies.\n\n### Strategy 1: Explicit Matches (All Relations)\n\nWorks for any relation property.\n\n**1a: @Mentions**\nIf the todo @mentions a page that exists in a relation's target database, it's linked.\n\n```\n- [ ] Review [[Project Alpha]] specs\n→ Linked to \"Project Alpha\" in Projects\n```\n\n**1b: Heading Match**\nIf the preceding heading exactly matches a page name in a relation's target database, it's linked.\n\n```\n### Project Alpha\n- [ ] Review the specs\n→ Linked to \"Project Alpha\" in Projects\n```\n\n### Strategy 2: Contextual Matches (Projects Only)\n\nThese strategies only apply to the Projects relation. Other relations require explicit @mentions or heading matches.\n\n**2a: Source Page Relations**\nIf the source page has a relation property with matching values, those are inherited.\n\n```\nMeeting Notes page has Project = \"Acme Redesign\"\n→ All todos on that page inherit \"Acme Redesign\"\n```\n\n**2b: Source Page is Database Entry**\nIf the source page is a direct entry in the Projects database, todos link to that page.\n\n```\nTodo on \"Project Beta\" page (which is in Projects DB)\n→ Linked to \"Project Beta\"\n```\n\n**2c: Parent Page Traversal**\nFor nested pages, walks up the hierarchy (up to 3 levels) looking for 2a/2b matches.\n\n---\n\n## Configuration Reference\n\n### Required Variables\n\n| Variable | Description |\n| ---------------- | ---------------------------- |\n| `NOTION_API_KEY` | Notion integration token |\n| `TODOS_DB_ID` | Database ID for synced todos |\n\n### Property Overrides\n\n| Variable | Default | Description |\n| ------------------------------------ | ----------------------- | ------------------- |\n| `TODOS_PROP_NAME` | Name | Todo title property |\n| `TODOS_PROP_SOURCE_BLOCK_ID` | Source block ID | Deduplication ID |\n| `TODOS_PROP_OWNER` | Owner | Person responsible |\n| `TODOS_PROP_OTHER_PEOPLE` | Other people | Other mentions |\n| `TODOS_PROP_DUE_DATE` | Due date | Deadline |\n| `TODOS_PROP_STATUS` | _(disabled)_ | Checkbox sync |\n| `TODOS_PROP_PROJECTS` | _(disabled)_ | Project relation |\n| `TODOS_PROP_LINKS` | Links | URLs found |\n| `TODOS_PROP_SOURCE_BLOCK_URL` | Source block URL | Link to block |\n| `TODOS_PROP_SOURCE_PAGE_URL` | Source page URL | Link to page |\n| `TODOS_PROP_SOURCE_LAST_EDITED_TIME` | Source last edited time | Edit timestamp |\n| `TODOS_PROP_SOURCE_AUTHOR` | Source author | Block creator |\n| `TODOS_PROP_SOURCE_TEXT` | Source text | Raw text |\n\n### Behavior Settings\n\n| Variable | Default | Description |\n| ----------------------------- | ------- | ------------------------------- |\n| `DEFAULT_DUE_DATE` | today | Fallback when no date in todo |\n| `MIN_BLOCK_WORDS` | 5 | Skip todos with fewer words |\n| `BLOCK_STABILITY_MINUTES` | 0 | Wait before syncing (cron only) |\n| `RECENT_PAGES_LOOKBACK_HOURS` | 24 | How far back to search |\n| `CRONS_DISABLED` | false | Disable automatic sync |\n\n### Search Settings\n\n| Variable | Default | Description |\n| ------------------- | -------- | ------------------------------------- |\n| `SEARCH_BLOCK_TYPE` | to_do | Block type to search for |\n| `SEARCH_KEYWORDS` | _(none)_ | Additional keywords (comma-separated) |\n\n### Security & API Keys\n\n| Variable | Description |\n| ----------------------- | --------------------------------------------- |\n| `NOTION_WEBHOOK_SECRET` | API key for protecting endpoints |\n| `OPENAI_API_KEY` | For AI features (see Quick Start for details) |\n\n---\n\n## Advanced Topics\n\n### Setup vs Production Mode\n\nWhen first setting up, you may want to test on individual pages before letting the system sweep up all todos under your integration.\n\n**Setup mode** (`CRONS_DISABLED=true`):\n\n- Crons don't run - nothing syncs automatically\n- Use the `/tasks/todos/page` webhook to test on specific pages\n- Add a button in Notion that calls this endpoint to sync just that page\n- Validate property mappings, owner resolution, and relations work correctly\n\n**Production mode** (default, or `CRONS_DISABLED=false`):\n\n- Crons run every minute\n- All pages under your integration are scanned for todos\n- Todos automatically sync to your central database\n\nOnce you've validated everything works in setup mode, remove `CRONS_DISABLED` (or set to `false`) to enable automatic syncing.\n\n### Using Notion Buttons for Testing\n\nIn setup mode, you need `NOTION_WEBHOOK_SECRET` to authenticate webhook requests. This is **required for setup mode** but not needed for production mode (crons authenticate differently).\n\n**Step 1: Set the environment variable**\n\nSet `NOTION_WEBHOOK_SECRET` to any secure string:\n\n```\nNOTION_WEBHOOK_SECRET=your-secret-key-here\n```\n\n**Step 2: Get your val's URL**\n\nOpen `main.http.tsx` in Val Town. Copy the HTTP endpoint of that file (something like `https://<your val's subdomain>.web.val.run`) - you'll need it for the button.\n\n**Step 3: Configure your Notion button**\n\nCreate a button in Notion with these settings:\n\n- **Action**: Send webhook\n- **URL**: Your val's base URL + `/tasks/todos/page` (e.g., `https://<your val's subdomain>.web.val.run/tasks/todos/page`)\n- **Headers**: Add `X-API-KEY` with the exact same value as your `NOTION_WEBHOOK_SECRET`\n\nThe header value must match the environment variable exactly (case-sensitive). If they don't match, the request will be rejected with a 401 error.\n\n**What the endpoint does:**\n\n`POST /tasks/todos/page` syncs only the page containing the button, letting you validate property mappings, owner resolution, and relations before enabling crons for your entire workspace.\n\n### Cron Jobs\n\nThree crons run independently (when enabled):\n\n- **todoSearch.cron**: Scans recent pages for todos\n- **todoSync.cron**: Syncs blobs to database\n- **cacheWarm.cron**: Keeps health cache fresh\n\n### Sync Optimization\n\nThe system tracks sync state in blob storage:\n\n- **First sync**: Query + create = 2 API calls\n- **No changes**: Skip immediately = 0 API calls\n- **Block updated**: Direct update = 1 API call\n\nThis reduces API calls by 90%+ for stable todos.\n\n### Blob Storage\n\nBlob storage serves two purposes: **checkpointing** sync state and **caching** for performance.\n\n**Example blob** (one per todo block):\n\n```json\n{\n // Block identity\n \"block_id\": \"abc123-def456-...\",\n \"block_url\": \"https://notion.so/page#abc123\",\n \"page_url\": \"https://notion.so/page\",\n\n // Todo content\n \"todo_string\": \"Call Kevin about the project by Friday\",\n \"checked\": false,\n\n // Context for matching\n \"preceding_heading\": \"Alex\",\n \"people_mentions\": [{\"id\": \"...\", \"name\": \"Kevin\", \"email\": \"...\"}],\n \"date_mentions\": [\"2025-01-24\"],\n \"link_mentions\": [{\"text\": \"Project Alpha\", \"url\": \"...\", \"pageId\": \"...\"}],\n\n // Source page context (for project inheritance)\n \"source_page_database_id\": \"projects-db-id\",\n \"source_page_relations\": {\"Projects\": [\"page-id-1\"]},\n\n // Metadata\n \"last_edited_time\": \"2025-01-22T10:30:00.000Z\",\n \"author\": {\"id\": \"...\", \"name\": \"Jane\", \"email\": \"...\"},\n\n // Sync tracking\n \"sync_metadata\": {\n \"synced\": true,\n \"syncing\": false,\n \"target_page_id\": \"xyz789\",\n \"archived\": false\n }\n}\n```\n\n**Key fields explained:**\n\n| Field | Purpose |\n|-------|---------|\n| `sync_metadata.synced` | `false` = needs sync, `true` = already synced |\n| `sync_metadata.syncing` | Lock to prevent concurrent syncs (5-minute timeout) |\n| `sync_metadata.target_page_id` | Cached ID so updates don't require a database query |\n| `preceding_heading` | Used for owner matching when heading matches a contact name |\n| `source_page_relations` | Inherited project relations from the source page |\n\n**Checkpointing flow:**\n\n1. Search phase finds todo → saves blob with `synced: false`\n2. Save phase acquires lock (`syncing: true`)\n3. On success → marks `synced: true`, stores `target_page_id`\n4. On failure → releases lock (`syncing: false`), retries next cron run\n\n**Caching:**\n\n- Health data and relation mappings are cached separately with 60-second TTL\n- `cacheWarm.cron` keeps caches fresh for instant dashboard loads\n\n### Caching\n\nTwo caches with 1-minute TTL:\n\n- **Health cache**: Instant dashboard loads\n- **Relation cache**: Fast sync initialization\n\nProperty renames in Notion may take up to 1 minute to propagate.\n\n### Validation\n\nTodos are validated during search:\n\n- Must have at least `MIN_BLOCK_WORDS` words (default: 5)\n- Shorter blocks are skipped as not meaningful\n\n### Project Structure\n\n```\nbackend/\n├── controllers/ # Business logic\n├── services/ # External API integrations\n├── routes/ # HTTP handlers\n├── crons/ # Scheduled jobs\n└── utils/ # Helpers\nfrontend/ # React dashboard\nshared/ # Shared types\n```\n\n### Known Limitations\n\n**Notion Timestamp Precision**: Block edit times are rounded to the minute. If you edit a todo twice within 60 seconds, only the first edit syncs until a later edit. Checkbox toggles are explicitly compared to catch same-minute changes.\n\n---\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n## Disclaimer\n\nThis software interacts with your Notion workspace and third-party services. By using this software, you accept the terms in [DISCLAIMER.md](DISCLAIMER.md), including limitations of liability and user responsibilities.\n",[],[582],{"_110":736,"_100":737,"_173":738,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":739,"_106":33,"_181":193,"_183":740,"_184":22,"_185":-5,"_186":741,"_104":742},"7dd4a680-09e4-11f1-a83f-42dde27851f2","deno.json","019c5ddc-37d1-74ea-8081-122ce6e4f55e",["D",1771101239266],"{\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}",[],[737],{"_110":744,"_100":745,"_173":746,"_175":-5,"_176":156,"_177":178,"_179":22,"_112":747,"_106":33,"_181":748,"_183":749,"_184":22,"_185":-5,"_186":750,"_104":751},"7dd4af54-09e4-11f1-a83f-42dde27851f2","main.http.tsx","019c5ddc-37d1-74ea-8081-1478672d5931",["D",1771101239266],"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",[],[745],"files",[170,188,198,204,210,220,228,236,244,252,260,269,275,284,292,300,309,315,321,329,337,346,352,360,368,376,385,392,401,407,413,421,429,436,443,451,459,468,476,484,493,499,507,515,523,531,539,547,555,563,571,580,589,595,601,609,617,626,633,641,650,656,663,671,680,688,696,704,712,720,728,735,743],"counts",{"_756":33,"_757":214,"_758":33,"_759":760,"_764":765},"pulls","branches","forks","envVars",{"_761":762,"_763":33},"count",15,"emptyCount","connections",{"_761":33,"_766":33},"unfilledCount","contents",[],{"_110":460,"_100":461,"_173":462,"_175":410,"_176":156,"_177":178,"_179":124,"_112":770,"_106":33,"_181":216,"_183":464,"_184":22,"_185":-5,"_104":771},["D",1771101239266],[200,403,409,461],"upstreamProject",{"_110":774,"_100":775,"_118":-5,"_119":-5,"_116":776,"_23":777},"a2d6c922-b336-11f0-a549-0224a6c84d84","scaffold","unlisted",{"_98":99,"_146":147},"upstreamBranch",{"_110":159,"_112":780,"_781":782,"_100":46,"_157":111,"_106":161,"_158":783,"_160":784,"_785":786,"_114":-5,"_167":22,"_116":117,"_166":99,"_16":128,"_165":101},["D",1761588582800],"updatedAt",["D",1770914662866],"a2d72f7a-b336-11f0-a549-0224a6c84d84",73,"lockfileKey","1770914669253-esm.town_v_lightweight_todoSweeper@438-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_98":99,"_100":101,"_102":103,"_106":107,"_104":105,"_108":793,"_168":799,"_752":1092,"_193":1093,"_767":1096,"_1097":1098,"_1101":-5,"_1102":1103,"_1104":33,"_1105":1106,"_759":-5},{"_110":111,"_100":101,"_112":794,"_114":-5,"_115":22,"_116":117,"_118":-5,"_119":-5,"_14":120,"_121":122,"_123":124,"_125":124,"_126":-5,"_127":33,"_16":128,"_129":130,"_131":132,"_133":795,"_135":-5,"_136":137,"_138":137,"_139":140,"_141":140,"_142":140,"_143":137,"_144":137,"_23":796,"_148":797,"_153":798,"_167":22},["D",1761588582800],["D",1775604061217],{"_98":99,"_146":147},{"_98":99,"_150":147,"_14":120,"_151":152},{"_106":155,"_100":103,"_110":156,"_157":111,"_158":159,"_160":161,"_162":117,"_163":111,"_164":128,"_165":101,"_166":99},[800,808,1008,1040,1056,1060,1064,1068,1072,1076,1080,1084,1088],{"_110":171,"_100":172,"_173":174,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":801,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":802,"_104":807},["D",1771101239266],[803],{"_110":189,"_100":190,"_173":191,"_175":174,"_176":156,"_177":178,"_179":124,"_112":804,"_106":33,"_181":193,"_183":194,"_184":22,"_185":-5,"_186":805,"_104":806},["D",1771101239266],[],[172,190],[172],{"_110":199,"_100":200,"_173":201,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":809,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":810,"_104":1007},["D",1771101239266],[811,843,863,911,959,1003],{"_110":205,"_100":206,"_173":207,"_175":201,"_176":156,"_177":178,"_179":124,"_112":812,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":813,"_104":842},["D",1771101239266],[814,818,822,826,830,834,838],{"_110":211,"_100":212,"_173":213,"_175":207,"_176":156,"_177":214,"_179":124,"_112":815,"_106":33,"_181":216,"_183":217,"_184":22,"_185":-5,"_186":816,"_104":817},["D",1771157924523],[],[200,206,212],{"_110":221,"_100":222,"_173":223,"_175":207,"_176":156,"_177":178,"_179":124,"_112":819,"_106":33,"_181":216,"_183":225,"_184":22,"_185":-5,"_186":820,"_104":821},["D",1771101239266],[],[200,206,222],{"_110":229,"_100":230,"_173":231,"_175":207,"_176":156,"_177":178,"_179":124,"_112":823,"_106":33,"_181":216,"_183":233,"_184":22,"_185":-5,"_186":824,"_104":825},["D",1771101239266],[],[200,206,230],{"_110":237,"_100":238,"_173":239,"_175":207,"_176":156,"_177":178,"_179":124,"_112":827,"_106":33,"_181":216,"_183":241,"_184":22,"_185":-5,"_186":828,"_104":829},["D",1771101239266],[],[200,206,238],{"_110":245,"_100":246,"_173":247,"_175":207,"_176":156,"_177":178,"_179":124,"_112":831,"_106":33,"_181":216,"_183":249,"_184":22,"_185":-5,"_186":832,"_104":833},["D",1771101239266],[],[200,206,246],{"_110":253,"_100":254,"_173":255,"_175":207,"_176":156,"_177":178,"_179":124,"_112":835,"_106":33,"_181":216,"_183":257,"_184":22,"_185":-5,"_186":836,"_104":837},["D",1771101239266],[],[200,206,254],{"_110":261,"_100":262,"_173":263,"_175":207,"_176":156,"_177":178,"_179":124,"_112":839,"_106":33,"_181":216,"_183":265,"_184":22,"_185":-5,"_186":840,"_104":841},["D",1771101239266],[],[200,206,262],[200,206],{"_110":270,"_100":271,"_173":272,"_175":201,"_176":156,"_177":178,"_179":124,"_112":844,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":845,"_104":862},["D",1771101239266],[846,850,854,858],{"_110":276,"_100":277,"_173":278,"_175":272,"_176":156,"_177":107,"_179":124,"_112":847,"_106":33,"_181":280,"_183":281,"_184":22,"_185":-5,"_186":848,"_104":849},["D",1771157945173],[],[200,271,277],{"_110":285,"_100":286,"_173":287,"_175":272,"_176":156,"_177":178,"_179":124,"_112":851,"_106":33,"_181":280,"_183":289,"_184":22,"_185":-5,"_186":852,"_104":853},["D",1771101239266],[],[200,271,286],{"_110":293,"_100":294,"_173":295,"_175":272,"_176":156,"_177":178,"_179":124,"_112":855,"_106":33,"_181":280,"_183":297,"_184":22,"_185":-5,"_186":856,"_104":857},["D",1771101239266],[],[200,271,294],{"_110":301,"_100":302,"_173":303,"_175":272,"_176":156,"_177":178,"_179":124,"_112":859,"_106":33,"_181":280,"_183":305,"_184":22,"_185":-5,"_186":860,"_104":861},["D",1771101239266],[],[200,271,302],[200,271],{"_110":310,"_100":311,"_173":312,"_175":201,"_176":156,"_177":178,"_179":124,"_112":864,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":865,"_104":910},["D",1771101239266],[866,882,902,906],{"_110":316,"_100":317,"_173":318,"_175":312,"_176":156,"_177":178,"_179":124,"_112":867,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":868,"_104":881},["D",1771101239266],[869,873,877],{"_110":322,"_100":323,"_173":324,"_175":318,"_176":156,"_177":178,"_179":124,"_112":870,"_106":33,"_181":216,"_183":326,"_184":22,"_185":-5,"_186":871,"_104":872},["D",1771101239266],[],[200,311,317,323],{"_110":330,"_100":331,"_173":332,"_175":318,"_176":156,"_177":178,"_179":124,"_112":874,"_106":33,"_181":216,"_183":334,"_184":22,"_185":-5,"_186":875,"_104":876},["D",1771101239266],[],[200,311,317,331],{"_110":338,"_100":339,"_173":340,"_175":318,"_176":156,"_177":178,"_179":124,"_112":878,"_106":33,"_181":216,"_183":342,"_184":22,"_185":-5,"_186":879,"_104":880},["D",1771101239266],[],[200,311,317,339],[200,311,317],{"_110":347,"_100":348,"_173":349,"_175":312,"_176":156,"_177":178,"_179":124,"_112":883,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":884,"_104":901},["D",1771101239266],[885,889,893,897],{"_110":353,"_100":354,"_173":355,"_175":349,"_176":156,"_177":178,"_179":124,"_112":886,"_106":33,"_181":216,"_183":357,"_184":22,"_185":-5,"_186":887,"_104":888},["D",1771101239266],[],[200,311,348,354],{"_110":361,"_100":362,"_173":363,"_175":349,"_176":156,"_177":178,"_179":124,"_112":890,"_106":33,"_181":216,"_183":365,"_184":22,"_185":-5,"_186":891,"_104":892},["D",1771101239266],[],[200,311,348,362],{"_110":369,"_100":370,"_173":371,"_175":349,"_176":156,"_177":178,"_179":124,"_112":894,"_106":33,"_181":216,"_183":373,"_184":22,"_185":-5,"_186":895,"_104":896},["D",1771101239266],[],[200,311,348,370],{"_110":377,"_100":378,"_173":379,"_175":349,"_176":156,"_177":178,"_179":124,"_112":898,"_106":33,"_181":216,"_183":381,"_184":22,"_185":-5,"_186":899,"_104":900},["D",1771101239266],[],[200,311,348,378],[200,311,348],{"_110":386,"_100":387,"_173":388,"_175":312,"_176":156,"_177":178,"_179":124,"_112":903,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":904,"_104":905},["D",1771101239266],[],[200,311,387],{"_110":393,"_100":394,"_173":395,"_175":312,"_176":156,"_177":178,"_179":124,"_112":907,"_106":33,"_181":216,"_183":397,"_184":22,"_185":-5,"_186":908,"_104":909},["D",1771101239266],[],[200,311,394],[200,311],{"_110":402,"_100":403,"_173":404,"_175":201,"_176":156,"_177":178,"_179":124,"_112":912,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":913,"_104":958},["D",1771101239266],[914,946,950,954],{"_110":408,"_100":409,"_173":410,"_175":404,"_176":156,"_177":178,"_179":124,"_112":915,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":916,"_104":945},["D",1771101239266],[917,921,925,929,933,937,941],{"_110":414,"_100":415,"_173":416,"_175":410,"_176":156,"_177":178,"_179":124,"_112":918,"_106":33,"_181":216,"_183":418,"_184":22,"_185":-5,"_186":919,"_104":920},["D",1771101239266],[],[200,403,409,415],{"_110":422,"_100":423,"_173":424,"_175":410,"_176":156,"_177":178,"_179":124,"_112":922,"_106":33,"_181":216,"_183":426,"_184":22,"_185":-5,"_186":923,"_104":924},["D",1771101239266],[],[200,403,409,423],{"_110":430,"_100":331,"_173":431,"_175":410,"_176":156,"_177":178,"_179":124,"_112":926,"_106":33,"_181":216,"_183":433,"_184":22,"_185":-5,"_186":927,"_104":928},["D",1771101239266],[],[200,403,409,331],{"_110":437,"_100":339,"_173":438,"_175":410,"_176":156,"_177":178,"_179":124,"_112":930,"_106":33,"_181":216,"_183":440,"_184":22,"_185":-5,"_186":931,"_104":932},["D",1771101239266],[],[200,403,409,339],{"_110":444,"_100":445,"_173":446,"_175":410,"_176":156,"_177":178,"_179":124,"_112":934,"_106":33,"_181":216,"_183":448,"_184":22,"_185":-5,"_186":935,"_104":936},["D",1771101239266],[],[200,403,409,445],{"_110":452,"_100":453,"_173":454,"_175":410,"_176":156,"_177":178,"_179":124,"_112":938,"_106":33,"_181":216,"_183":456,"_184":22,"_185":-5,"_186":939,"_104":940},["D",1771101239266],[],[200,403,409,453],{"_110":460,"_100":461,"_173":462,"_175":410,"_176":156,"_177":178,"_179":124,"_112":942,"_106":33,"_181":216,"_183":464,"_184":22,"_185":-5,"_186":943,"_104":944},["D",1771101239266],[],[200,403,409,461],[200,403,409],{"_110":469,"_100":470,"_173":471,"_175":404,"_176":156,"_177":178,"_179":124,"_112":947,"_106":33,"_181":216,"_183":473,"_184":22,"_185":-5,"_186":948,"_104":949},["D",1771101239266],[],[200,403,470],{"_110":477,"_100":478,"_173":479,"_175":404,"_176":156,"_177":178,"_179":124,"_112":951,"_106":33,"_181":216,"_183":481,"_184":22,"_185":-5,"_186":952,"_104":953},["D",1771101239266],[],[200,403,478],{"_110":485,"_100":486,"_173":487,"_175":404,"_176":156,"_177":178,"_179":124,"_112":955,"_106":33,"_181":216,"_183":489,"_184":22,"_185":-5,"_186":956,"_104":957},["D",1771101239266],[],[200,403,486],[200,403],{"_110":494,"_100":495,"_173":496,"_175":201,"_176":156,"_177":178,"_179":124,"_112":960,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":961,"_104":1002},["D",1771101239266],[962,966,970,974,978,982,986,990,994,998],{"_110":500,"_100":501,"_173":502,"_175":496,"_176":156,"_177":178,"_179":124,"_112":963,"_106":33,"_181":216,"_183":504,"_184":22,"_185":-5,"_186":964,"_104":965},["D",1771101239266],[],[200,495,501],{"_110":508,"_100":509,"_173":510,"_175":496,"_176":156,"_177":178,"_179":124,"_112":967,"_106":33,"_181":216,"_183":512,"_184":22,"_185":-5,"_186":968,"_104":969},["D",1771101239266],[],[200,495,509],{"_110":516,"_100":517,"_173":518,"_175":496,"_176":156,"_177":178,"_179":124,"_112":971,"_106":33,"_181":216,"_183":520,"_184":22,"_185":-5,"_186":972,"_104":973},["D",1771101239266],[],[200,495,517],{"_110":524,"_100":525,"_173":526,"_175":496,"_176":156,"_177":178,"_179":124,"_112":975,"_106":33,"_181":216,"_183":528,"_184":22,"_185":-5,"_186":976,"_104":977},["D",1771101239266],[],[200,495,525],{"_110":532,"_100":533,"_173":534,"_175":496,"_176":156,"_177":178,"_179":124,"_112":979,"_106":33,"_181":216,"_183":536,"_184":22,"_185":-5,"_186":980,"_104":981},["D",1771101239266],[],[200,495,533],{"_110":540,"_100":541,"_173":542,"_175":496,"_176":156,"_177":178,"_179":124,"_112":983,"_106":33,"_181":216,"_183":544,"_184":22,"_185":-5,"_186":984,"_104":985},["D",1771101239266],[],[200,495,541],{"_110":548,"_100":549,"_173":550,"_175":496,"_176":156,"_177":178,"_179":124,"_112":987,"_106":33,"_181":216,"_183":552,"_184":22,"_185":-5,"_186":988,"_104":989},["D",1771101239266],[],[200,495,549],{"_110":556,"_100":557,"_173":558,"_175":496,"_176":156,"_177":178,"_179":124,"_112":991,"_106":33,"_181":216,"_183":560,"_184":22,"_185":-5,"_186":992,"_104":993},["D",1771101239266],[],[200,495,557],{"_110":564,"_100":565,"_173":566,"_175":496,"_176":156,"_177":178,"_179":124,"_112":995,"_106":33,"_181":216,"_183":568,"_184":22,"_185":-5,"_186":996,"_104":997},["D",1771101239266],[],[200,495,565],{"_110":572,"_100":573,"_173":574,"_175":496,"_176":156,"_177":178,"_179":124,"_112":999,"_106":33,"_181":216,"_183":576,"_184":22,"_185":-5,"_186":1000,"_104":1001},["D",1771101239266],[],[200,495,573],[200,495],{"_110":581,"_100":582,"_173":583,"_175":201,"_176":156,"_177":178,"_179":124,"_112":1004,"_106":33,"_181":193,"_183":585,"_184":22,"_185":-5,"_186":1005,"_104":1006},["D",1771101239266],[],[200,582],[200],{"_110":590,"_100":591,"_173":592,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1009,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":1010,"_104":1039},["D",1771101239266],[1011,1027,1031,1035],{"_110":596,"_100":597,"_173":598,"_175":592,"_176":156,"_177":178,"_179":124,"_112":1012,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":1013,"_104":1026},["D",1771101239266],[1014,1018,1022],{"_110":602,"_100":603,"_173":604,"_175":598,"_176":156,"_177":178,"_179":124,"_112":1015,"_106":33,"_181":216,"_183":606,"_184":22,"_185":-5,"_186":1016,"_104":1017},["D",1771101239266],[],[591,597,603],{"_110":610,"_100":611,"_173":612,"_175":598,"_176":156,"_177":178,"_179":124,"_112":1019,"_106":33,"_181":216,"_183":614,"_184":22,"_185":-5,"_186":1020,"_104":1021},["D",1771101239266],[],[591,597,611],{"_110":618,"_100":619,"_173":620,"_175":598,"_176":156,"_177":178,"_179":124,"_112":1023,"_106":33,"_181":216,"_183":622,"_184":22,"_185":-5,"_186":1024,"_104":1025},["D",1771101239266],[],[591,597,619],[591,597],{"_110":627,"_100":582,"_173":628,"_175":592,"_176":156,"_177":178,"_179":124,"_112":1028,"_106":33,"_181":193,"_183":630,"_184":22,"_185":-5,"_186":1029,"_104":1030},["D",1771101239266],[],[591,582],{"_110":634,"_100":635,"_173":636,"_175":592,"_176":156,"_177":178,"_179":124,"_112":1032,"_106":33,"_181":193,"_183":638,"_184":22,"_185":-5,"_186":1033,"_104":1034},["D",1771101239266],[],[591,635],{"_110":642,"_100":643,"_173":644,"_175":592,"_176":156,"_177":178,"_179":124,"_112":1036,"_106":33,"_181":216,"_183":646,"_184":22,"_185":-5,"_186":1037,"_104":1038},["D",1771101239266],[],[591,643],[591],{"_110":651,"_100":652,"_173":653,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1041,"_106":33,"_181":182,"_183":-5,"_184":22,"_185":-5,"_186":1042,"_104":1055},["D",1771101239266],[1043,1047,1051],{"_110":657,"_100":582,"_173":658,"_175":653,"_176":156,"_177":178,"_179":124,"_112":1044,"_106":33,"_181":193,"_183":660,"_184":22,"_185":-5,"_186":1045,"_104":1046},["D",1771101239266],[],[652,582],{"_110":664,"_100":665,"_173":666,"_175":653,"_176":156,"_177":178,"_179":124,"_112":1048,"_106":33,"_181":216,"_183":668,"_184":22,"_185":-5,"_186":1049,"_104":1050},["D",1771101239266],[],[652,665],{"_110":672,"_100":673,"_173":674,"_175":653,"_176":156,"_177":178,"_179":124,"_112":1052,"_106":33,"_181":216,"_183":676,"_184":22,"_185":-5,"_186":1053,"_104":1054},["D",1771101239266],[],[652,673],[652],{"_110":681,"_100":682,"_173":683,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1057,"_106":33,"_181":193,"_183":685,"_184":22,"_185":-5,"_186":1058,"_104":1059},["D",1771101239266],[],[682],{"_110":689,"_100":690,"_173":691,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1061,"_106":33,"_181":193,"_183":693,"_184":22,"_185":-5,"_186":1062,"_104":1063},["D",1771101239266],[],[690],{"_110":697,"_100":698,"_173":699,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1065,"_106":33,"_181":193,"_183":701,"_184":22,"_185":-5,"_186":1066,"_104":1067},["D",1771101239266],[],[698],{"_110":705,"_100":706,"_173":707,"_175":-5,"_176":156,"_177":178,"_179":22,"_112":1069,"_106":33,"_181":193,"_183":709,"_184":22,"_185":-5,"_186":1070,"_104":1071},["D",1771101239266],[],[706],{"_110":713,"_100":714,"_173":715,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1073,"_106":33,"_181":193,"_183":717,"_184":22,"_185":-5,"_186":1074,"_104":1075},["D",1771101239266],[],[714],{"_110":721,"_100":722,"_173":723,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1077,"_106":33,"_181":193,"_183":725,"_184":22,"_185":-5,"_186":1078,"_104":1079},["D",1771101239266],[],[722],{"_110":729,"_100":582,"_173":730,"_175":-5,"_176":156,"_177":178,"_179":22,"_112":1081,"_106":33,"_181":193,"_183":732,"_184":22,"_185":-5,"_186":1082,"_104":1083},["D",1771101239266],[],[582],{"_110":736,"_100":737,"_173":738,"_175":-5,"_176":156,"_177":178,"_179":124,"_112":1085,"_106":33,"_181":193,"_183":740,"_184":22,"_185":-5,"_186":1086,"_104":1087},["D",1771101239266],[],[737],{"_110":744,"_100":745,"_173":746,"_175":-5,"_176":156,"_177":178,"_179":22,"_112":1089,"_106":33,"_181":748,"_183":749,"_184":22,"_185":-5,"_186":1090,"_104":1091},["D",1771101239266],[],[745],[800,803,808,811,814,818,822,826,830,834,838,843,846,850,854,858,863,866,869,873,877,882,885,889,893,897,902,906,911,914,917,921,925,929,933,937,941,946,950,954,959,962,966,970,974,978,982,986,990,994,998,1003,1008,1011,1014,1018,1022,1027,1031,1035,1040,1043,1047,1051,1056,1060,1064,1068,1072,1076,1080,1084,1088],{"_110":460,"_100":461,"_173":462,"_175":410,"_176":156,"_177":178,"_179":124,"_112":1094,"_106":33,"_181":216,"_183":464,"_184":22,"_185":-5,"_104":1095},["D",1771101239266],[200,403,409,461],[],"upstream",{"_110":159,"_112":1099,"_781":1100,"_100":46,"_157":111,"_106":161,"_158":783,"_160":784,"_785":786,"_114":-5,"_167":22,"_116":117,"_166":99,"_16":128,"_165":101},["D",1761588582800],["D",1770914662866],"pull","ahead",9,"behind","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