Todo Sweeper - Recent Pages

`, `

`, ``, 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}` or `PROJECTS_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_PROJECTS | (disabled) | projects |\n| TODOS_PROP_STATUS | (disabled) | status |\n| TODOS_FUZZY_MATCH_RELATIONS | (disabled) | fuzzyMatch (comma-separated) |\n\n**Projects Database Properties** (`PROJECTS_PROP_*`):\n| Env Var | Default | Key |\n|---------|---------|-----|\n| PROJECTS_PROP_GROUP_BY | Clients | groupBy |\n| PROJECTS_PROP_DATE_START | Dates | dateStart |\n| PROJECTS_PROP_DATE_END | Dates | dateEnd |\n\n**Examples**:\n```bash\n# Override property names\nTODOS_PROP_DUE_DATE=Deadline\n\n# Enable optional features (disabled by default)\nTODOS_PROP_projects=Projects db\nTODOS_FUZZY_MATCH_RELATIONS=Contacts,Companies\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",[179],"1cb98422-b360-11f0-bc6f-0224a6c84d84","AGENTS.md","019a26dc-99bf-7269-a8f6-692ef14e0fe6",["D",1761588582800],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({ \n subject: \"Hi\", \n text: \"Hi\", \n html: \"<h1>Hi</h1>\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\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#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's *extremely importing* to note that `parseProject` and other Standard Library utilities ONLY RUN ON THE SERVER.\nIf you need access to this data on the client, run it in the server and pass it to the client by splicing it into the HTML page\nor by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `<img src=\"https://maxm-imggenurl.web.val.run/the-description-of-your-image\" />`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link by importing & using `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `<script src=\"https://esm.town/v/std/catch\"></script>` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `<script src=\"https://cdn.twind.style\" crossorigin></script>` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = `<script>\n window.__INITIAL_DATA__ = ${JSON.stringify(initialData)};\n </script>`;\n \n html = html.replace(\"</head>\", `${dataScript}</head>`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[187],"1cb9830a-b360-11f0-bc6f-0224a6c84d84",".vtignore","019a26dc-99bf-7269-a8f6-6555ae856e94",["D",1761588582800],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\nvars.env",[193],"1cb981de-b360-11f0-bc6f-0224a6c84d84","shared","019a26dc-99bf-7269-a8f6-63c6fd1d84b1",["D",1761588582800],"directory",[199],"1cb9746e-b360-11f0-bc6f-0224a6c84d84","frontend","019a26dc-99bf-7269-a8f6-51875d2ac446",["D",1761588582800],[205],"1cb966d6-b360-11f0-bc6f-0224a6c84d84","backend","019a26dc-99bf-7269-a8f6-32bd7c2a6dc6",["D",1761588582800],[210],"1cb9476e-b360-11f0-bc6f-0224a6c84d84",".claude","019a26dc-99bf-7269-a8f5-f075c4855e23",["D",1761588582800],[215],"pulls","branches",2,"forks","envVars",{"_227":229,"_230":62},"connections",{"_227":62,"_228":62},"count","unfilledCount",15,"emptyCount",{"_43":214,"_32":215,"_30":216,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":754,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":755,"_27":756},{"_43":746,"_32":747,"_30":748,"_153":216,"_41":42,"_40":749,"_155":25,"_38":750,"_13":514,"_34":20,"_35":751,"_24":25,"_160":-5,"_301":752,"_27":753},{"_43":209,"_32":210,"_30":211,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":743,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":744,"_27":745},{"_43":739,"_32":701,"_30":695,"_153":211,"_41":42,"_40":166,"_155":58,"_38":740,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":741,"_27":742},{"_43":731,"_32":732,"_30":733,"_153":695,"_41":42,"_40":734,"_155":58,"_38":735,"_13":183,"_34":324,"_35":736,"_24":25,"_160":-5,"_301":737,"_27":738},{"_43":724,"_32":725,"_30":726,"_153":695,"_41":42,"_40":181,"_155":25,"_38":727,"_13":522,"_34":324,"_35":728,"_24":25,"_160":-5,"_301":729,"_27":730},{"_43":717,"_32":718,"_30":719,"_153":695,"_41":42,"_40":322,"_155":58,"_38":720,"_13":221,"_34":324,"_35":721,"_24":25,"_160":-5,"_301":722,"_27":723},{"_43":709,"_32":710,"_30":711,"_153":695,"_41":42,"_40":431,"_155":25,"_38":712,"_13":713,"_34":324,"_35":714,"_24":25,"_160":-5,"_301":715,"_27":716},{"_43":702,"_32":703,"_30":704,"_153":695,"_41":42,"_40":625,"_155":58,"_38":705,"_13":433,"_34":324,"_35":706,"_24":25,"_160":-5,"_301":707,"_27":708},{"_43":692,"_32":693,"_30":694,"_153":695,"_41":42,"_40":181,"_155":25,"_38":696,"_13":697,"_34":324,"_35":698,"_24":25,"_160":-5,"_301":699,"_27":700},{"_43":688,"_32":680,"_30":673,"_153":211,"_41":42,"_40":522,"_155":58,"_38":689,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":690,"_27":691},{"_43":681,"_32":682,"_30":683,"_153":673,"_41":42,"_40":674,"_155":58,"_38":684,"_13":157,"_34":676,"_35":685,"_24":25,"_160":-5,"_301":686,"_27":687},{"_43":670,"_32":671,"_30":672,"_153":673,"_41":42,"_40":674,"_155":58,"_38":675,"_13":221,"_34":676,"_35":677,"_24":25,"_160":-5,"_301":678,"_27":679},{"_43":666,"_32":598,"_30":592,"_153":211,"_41":42,"_40":166,"_155":58,"_38":667,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":668,"_27":669},{"_43":662,"_32":648,"_30":643,"_153":592,"_41":42,"_40":166,"_155":58,"_38":663,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":664,"_27":665},{"_43":655,"_32":656,"_30":657,"_153":643,"_41":42,"_40":181,"_155":25,"_38":658,"_13":166,"_34":324,"_35":659,"_24":25,"_160":-5,"_301":660,"_27":661},{"_43":649,"_32":558,"_30":650,"_153":643,"_41":42,"_40":322,"_155":58,"_38":651,"_13":166,"_34":324,"_35":652,"_24":25,"_160":-5,"_301":653,"_27":654},{"_43":641,"_32":550,"_30":642,"_153":643,"_41":42,"_40":522,"_155":58,"_38":644,"_13":166,"_34":324,"_35":645,"_24":25,"_160":-5,"_301":646,"_27":647},{"_43":637,"_32":614,"_30":608,"_153":592,"_41":42,"_40":166,"_155":58,"_38":638,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":639,"_27":640},{"_43":630,"_32":631,"_30":632,"_153":608,"_41":42,"_40":229,"_155":58,"_38":633,"_13":221,"_34":324,"_35":634,"_24":25,"_160":-5,"_301":635,"_27":636},{"_43":622,"_32":623,"_30":624,"_153":608,"_41":42,"_40":625,"_155":25,"_38":626,"_13":166,"_34":324,"_35":627,"_24":25,"_160":-5,"_301":628,"_27":629},{"_43":615,"_32":616,"_30":617,"_153":608,"_41":42,"_40":454,"_155":58,"_38":618,"_13":62,"_34":324,"_35":619,"_24":25,"_160":-5,"_301":620,"_27":621},{"_43":605,"_32":606,"_30":607,"_153":608,"_41":42,"_40":609,"_155":58,"_38":610,"_13":183,"_34":324,"_35":611,"_24":25,"_160":-5,"_301":612,"_27":613},{"_43":599,"_32":600,"_30":601,"_153":592,"_41":42,"_40":166,"_155":58,"_38":602,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":603,"_27":604},{"_43":589,"_32":590,"_30":591,"_153":592,"_41":42,"_40":593,"_155":58,"_38":594,"_13":183,"_34":324,"_35":595,"_24":25,"_160":-5,"_301":596,"_27":597},{"_43":585,"_32":509,"_30":503,"_153":211,"_41":42,"_40":166,"_155":58,"_38":586,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":587,"_27":588},{"_43":581,"_32":534,"_30":529,"_153":503,"_41":42,"_40":166,"_155":58,"_38":582,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":583,"_27":584},{"_43":573,"_32":574,"_30":575,"_153":529,"_41":42,"_40":576,"_155":58,"_38":577,"_13":166,"_34":324,"_35":578,"_24":25,"_160":-5,"_301":579,"_27":580},{"_43":566,"_32":567,"_30":568,"_153":529,"_41":42,"_40":181,"_155":25,"_38":569,"_13":522,"_34":324,"_35":570,"_24":25,"_160":-5,"_301":571,"_27":572},{"_43":557,"_32":558,"_30":559,"_153":529,"_41":42,"_40":560,"_155":25,"_38":561,"_13":562,"_34":324,"_35":563,"_24":25,"_160":-5,"_301":564,"_27":565},{"_43":549,"_32":550,"_30":551,"_153":529,"_41":42,"_40":552,"_155":58,"_38":553,"_13":504,"_34":324,"_35":554,"_24":25,"_160":-5,"_301":555,"_27":556},{"_43":542,"_32":543,"_30":544,"_153":529,"_41":42,"_40":181,"_155":25,"_38":545,"_13":514,"_34":324,"_35":546,"_24":25,"_160":-5,"_301":547,"_27":548},{"_43":535,"_32":536,"_30":537,"_153":529,"_41":42,"_40":522,"_155":58,"_38":538,"_13":62,"_34":324,"_35":539,"_24":25,"_160":-5,"_301":540,"_27":541},{"_43":526,"_32":527,"_30":528,"_153":529,"_41":42,"_40":469,"_155":58,"_38":530,"_13":166,"_34":324,"_35":531,"_24":25,"_160":-5,"_301":532,"_27":533},{"_43":518,"_32":519,"_30":520,"_153":503,"_41":42,"_40":469,"_155":25,"_38":521,"_13":522,"_34":324,"_35":523,"_24":25,"_160":-5,"_301":524,"_27":525},{"_43":510,"_32":511,"_30":512,"_153":503,"_41":42,"_40":405,"_155":25,"_38":513,"_13":514,"_34":324,"_35":515,"_24":25,"_160":-5,"_301":516,"_27":517},{"_43":500,"_32":501,"_30":502,"_153":503,"_41":42,"_40":504,"_155":58,"_38":505,"_13":166,"_34":324,"_35":506,"_24":25,"_160":-5,"_301":507,"_27":508},{"_43":496,"_32":410,"_30":404,"_153":211,"_41":42,"_40":454,"_155":58,"_38":497,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":498,"_27":499},{"_43":489,"_32":490,"_30":491,"_153":404,"_41":42,"_40":454,"_155":58,"_38":492,"_13":62,"_34":324,"_35":493,"_24":25,"_160":-5,"_301":494,"_27":495},{"_43":481,"_32":482,"_30":483,"_153":404,"_41":42,"_40":484,"_155":58,"_38":485,"_13":221,"_34":324,"_35":486,"_24":25,"_160":-5,"_301":487,"_27":488},{"_43":474,"_32":475,"_30":476,"_153":404,"_41":42,"_40":322,"_155":25,"_38":477,"_13":62,"_34":324,"_35":478,"_24":25,"_160":-5,"_301":479,"_27":480},{"_43":466,"_32":467,"_30":468,"_153":404,"_41":42,"_40":469,"_155":25,"_38":470,"_13":62,"_34":324,"_35":471,"_24":25,"_160":-5,"_301":472,"_27":473},{"_43":459,"_32":460,"_30":461,"_153":404,"_41":42,"_40":431,"_155":58,"_38":462,"_13":166,"_34":324,"_35":463,"_24":25,"_160":-5,"_301":464,"_27":465},{"_43":451,"_32":452,"_30":453,"_153":404,"_41":42,"_40":454,"_155":58,"_38":455,"_13":62,"_34":324,"_35":456,"_24":25,"_160":-5,"_301":457,"_27":458},{"_43":444,"_32":445,"_30":446,"_153":404,"_41":42,"_40":181,"_155":58,"_38":447,"_13":62,"_34":324,"_35":448,"_24":25,"_160":-5,"_301":449,"_27":450},{"_43":437,"_32":438,"_30":439,"_153":404,"_41":42,"_40":181,"_155":25,"_38":440,"_13":157,"_34":324,"_35":441,"_24":25,"_160":-5,"_301":442,"_27":443},{"_43":428,"_32":429,"_30":430,"_153":404,"_41":42,"_40":431,"_155":25,"_38":432,"_13":433,"_34":324,"_35":434,"_24":25,"_160":-5,"_301":435,"_27":436},{"_43":419,"_32":420,"_30":421,"_153":404,"_41":42,"_40":422,"_155":25,"_38":423,"_13":424,"_34":324,"_35":425,"_24":25,"_160":-5,"_301":426,"_27":427},{"_43":411,"_32":412,"_30":413,"_153":404,"_41":42,"_40":414,"_155":58,"_38":415,"_13":62,"_34":324,"_35":416,"_24":25,"_160":-5,"_301":417,"_27":418},{"_43":401,"_32":402,"_30":403,"_153":404,"_41":42,"_40":405,"_155":58,"_38":406,"_13":62,"_34":324,"_35":407,"_24":25,"_160":-5,"_301":408,"_27":409},{"_43":395,"_32":171,"_30":396,"_153":211,"_41":42,"_40":166,"_155":58,"_38":397,"_13":62,"_34":20,"_35":398,"_24":25,"_160":-5,"_301":399,"_27":400},{"_43":204,"_32":205,"_30":206,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":392,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":393,"_27":394},{"_43":388,"_32":371,"_30":366,"_153":206,"_41":42,"_40":166,"_155":58,"_38":389,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":390,"_27":391},{"_43":379,"_32":380,"_30":381,"_153":366,"_41":42,"_40":382,"_155":25,"_38":383,"_13":384,"_34":324,"_35":385,"_24":25,"_160":-5,"_301":386,"_27":387},{"_43":372,"_32":373,"_30":374,"_153":366,"_41":42,"_40":166,"_155":58,"_38":375,"_13":62,"_34":324,"_35":376,"_24":25,"_160":-5,"_301":377,"_27":378},{"_43":363,"_32":364,"_30":365,"_153":366,"_41":42,"_40":166,"_155":58,"_38":367,"_13":62,"_34":324,"_35":368,"_24":25,"_160":-5,"_301":369,"_27":370},{"_43":357,"_32":171,"_30":358,"_153":206,"_41":42,"_40":166,"_155":58,"_38":359,"_13":62,"_34":20,"_35":360,"_24":25,"_160":-5,"_301":361,"_27":362},{"_43":352,"_32":33,"_30":31,"_153":206,"_41":42,"_40":14,"_155":58,"_38":353,"_13":354,"_34":20,"_35":37,"_24":25,"_160":-5,"_301":355,"_27":356},{"_43":345,"_32":346,"_30":347,"_153":206,"_41":42,"_40":166,"_155":58,"_38":348,"_13":62,"_34":324,"_35":349,"_24":25,"_160":-5,"_301":350,"_27":351},{"_43":198,"_32":199,"_30":200,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":342,"_13":62,"_34":202,"_35":-5,"_24":25,"_160":-5,"_301":343,"_27":344},{"_43":336,"_32":171,"_30":337,"_153":200,"_41":42,"_40":166,"_155":58,"_38":338,"_13":62,"_34":20,"_35":339,"_24":25,"_160":-5,"_301":340,"_27":341},{"_43":328,"_32":329,"_30":330,"_153":200,"_41":42,"_40":181,"_155":25,"_38":331,"_13":332,"_34":324,"_35":333,"_24":25,"_160":-5,"_301":334,"_27":335},{"_43":319,"_32":320,"_30":321,"_153":200,"_41":42,"_40":322,"_155":25,"_38":323,"_13":166,"_34":324,"_35":325,"_24":25,"_160":-5,"_301":326,"_27":327},{"_43":192,"_32":193,"_30":194,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":316,"_13":62,"_34":20,"_35":196,"_24":25,"_160":-5,"_301":317,"_27":318},{"_43":186,"_32":187,"_30":188,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":313,"_13":62,"_34":20,"_35":190,"_24":25,"_160":-5,"_301":314,"_27":315},{"_43":178,"_32":179,"_30":180,"_153":-5,"_41":42,"_40":181,"_155":25,"_38":310,"_13":183,"_34":20,"_35":184,"_24":25,"_160":-5,"_301":311,"_27":312},{"_43":170,"_32":171,"_30":172,"_153":-5,"_41":42,"_40":173,"_155":25,"_38":307,"_13":175,"_34":20,"_35":176,"_24":25,"_160":-5,"_301":308,"_27":309},{"_43":163,"_32":164,"_30":165,"_153":-5,"_41":42,"_40":166,"_155":58,"_38":304,"_13":62,"_34":20,"_35":168,"_24":25,"_160":-5,"_301":305,"_27":306},{"_43":151,"_32":152,"_30":56,"_153":-5,"_41":42,"_40":154,"_155":58,"_38":300,"_13":157,"_34":158,"_35":159,"_24":25,"_160":161,"_301":302,"_27":303},["D",1765373228006],"children",[],[152],["D",1761588582800],[],[164],["D",1768933301096],[],[171],["D",1768922475258],[],[179],["D",1761588582800],[],[187],["D",1761588582800],[],[193],"43d13cc8-b962-11f0-8efb-0224a6c84d84","utils.ts","019a26dc-99bf-7269-a8f6-5e2af0c9fdd2",27,["D",1762249214392],"script","/**\n * Shared utility functions\n * IMPORTANT: These must work in both browser AND Deno (no Deno APIs allowed)\n */\n\n/**\n * Check if a string is a valid Notion page ID format\n */\nexport function isValidPageId(pageId: string): boolean {\n if (!pageId || typeof pageId !== 'string') {\n return false;\n }\n\n // Notion IDs are 32 characters (with or without hyphens)\n const cleanId = pageId.replace(/-/g, '');\n return cleanId.length === 32 && /^[a-f0-9]+$/i.test(cleanId);\n}\n\n/**\n * Normalize a Notion page ID (remove hyphens)\n */\nexport function normalizePageId(pageId: string): string {\n return pageId.replace(/-/g, '');\n}\n\n/**\n * Format a Notion page ID with hyphens in standard format\n * 8-4-4-4-12\n */\nexport function formatPageId(pageId: string): string {\n const clean = normalizePageId(pageId);\n return `${clean.slice(0, 8)}-${clean.slice(8, 12)}-${clean.slice(12, 16)}-${clean.slice(16, 20)}-${clean.slice(20)}`;\n}\n\n/**\n * Extract plain text from Notion rich text array\n */\nexport function getPlainText(richText: any[]): string {\n if (!Array.isArray(richText)) {\n return '';\n }\n return richText.map(text => text.plain_text || '').join('');\n}\n\n/**\n * Safely get a property value from Notion page properties\n */\nexport function getPropertyValue(properties: any, propertyName: string): any {\n const property = properties[propertyName];\n if (!property) {\n return null;\n }\n\n // Extract value based on property type\n switch (property.type) {\n case 'title':\n return getPlainText(property.title);\n case 'rich_text':\n return getPlainText(property.rich_text);\n case 'number':\n return property.number;\n case 'select':\n return property.select?.name || null;\n case 'multi_select':\n return property.multi_select?.map((s: any) => s.name) || [];\n case 'date':\n return property.date?.start || null;\n case 'checkbox':\n return property.checkbox;\n case 'url':\n return property.url;\n case 'email':\n return property.email;\n case 'phone_number':\n return property.phone_number;\n case 'status':\n return property.status?.name || null;\n default:\n return property;\n }\n}\n\n/**\n * Format an ISO timestamp to relative time\n * Examples: \"2 hours ago\", \"Yesterday\", \"3 days ago\"\n *\n * @param isoString - ISO 8601 timestamp string\n * @returns Human-readable relative time string\n */\nexport function formatRelativeTime(isoString: string): string {\n try {\n const date = new Date(isoString);\n const now = new Date();\n const diffMs = now.getTime() - date.getTime();\n const diffMinutes = Math.floor(diffMs / (1000 * 60));\n const diffHours = Math.floor(diffMs / (1000 * 60 * 60));\n const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));\n\n // Less than 1 minute\n if (diffMinutes < 1) {\n return \"Just now\";\n }\n\n // Less than 1 hour\n if (diffMinutes < 60) {\n return `${diffMinutes} minute${diffMinutes === 1 ? '' : 's'} ago`;\n }\n\n // Less than 24 hours\n if (diffHours < 24) {\n return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;\n }\n\n // Less than 2 days (show \"Yesterday\")\n if (diffDays === 1) {\n return \"Yesterday\";\n }\n\n // Less than 7 days\n if (diffDays < 7) {\n return `${diffDays} days ago`;\n }\n\n // More than 7 days - show date\n return date.toLocaleDateString('en-US', {\n month: 'short',\n day: 'numeric',\n year: date.getFullYear() !== now.getFullYear() ? 'numeric' : undefined\n });\n\n } catch (err) {\n return isoString; // Fallback to original string\n }\n}\n",[],[199,320],"a9449f4e-f613-11f0-b05a-42dde27851f2","types.ts","019a26dc-99bf-7269-a8f6-5917ad49537e",["D",1768922475258],19,"/**\n * Shared TypeScript types and interfaces\n * These work in both frontend (browser) and backend (Deno)\n */\n\n/**\n * Standard response format for all controller functions\n */\nexport interface ControllerResponse<T = any> {\n success: boolean;\n data: T | null;\n error: string | null;\n details?: string;\n}\n\n/**\n * Notion page response (simplified)\n * For full types, use @notionhq/client types in backend\n */\nexport interface NotionPage {\n id: string;\n object: 'page';\n created_time: string;\n last_edited_time: string;\n properties: Record<string, any>;\n parent: {\n type: string;\n database_id?: string;\n page_id?: string;\n };\n url: string;\n}\n\n/**\n * Notion database response (simplified)\n */\nexport interface NotionDatabase {\n id: string;\n object: 'database';\n created_time: string;\n last_edited_time: string;\n title: Array<{\n type: string;\n plain_text: string;\n }>;\n properties: Record<string, any>;\n}\n\n/**\n * Notion webhook payload\n */\nexport interface NotionWebhookPayload {\n type: 'page' | 'database';\n page?: NotionPage;\n database?: NotionDatabase;\n}\n\n/**\n * Common page properties (extend as needed)\n */\nexport interface PageProperties {\n [key: string]: any;\n}\n\n/**\n * API request/response types\n */\nexport interface UpdatePageRequest {\n properties: PageProperties;\n}\n\nexport interface CreatePageRequest {\n databaseId: string;\n properties: PageProperties;\n}\n\nexport interface PageResponse {\n page: NotionPage;\n}\n\nexport interface PagesListResponse {\n pages: NotionPage[];\n}\n\n/**\n * Faviconizer API response\n */\nexport interface FaviconizerResponse {\n domain: string;\n faviconUrl: string;\n success: boolean;\n source: string;\n contentType: string;\n}\n\n/**\n * Favicon update result\n */\nexport interface FaviconUpdateResult {\n success: boolean;\n iconUpdated?: boolean;\n errorNoteAdded?: boolean;\n successNoteAdded?: boolean;\n error?: string;\n details?: string;\n}\n\n/**\n * Todo search result\n */\nexport interface TodoSearchResult {\n success: boolean;\n blocksFound: number;\n blocksNew?: number;\n blocksUpdated?: number;\n blocksSkipped?: number;\n blockIds: string[];\n error?: string;\n details?: string;\n}\n\n/**\n * Sync metadata for blob storage optimization\n */\nexport interface SyncMetadata {\n synced: boolean; // true = already synced, false = needs sync\n target_page_id?: string; // Cached ID of page in todos database (avoids query on update)\n archived?: boolean; // true = Notion page was archived by user\n}\n\n/**\n * Link mention with optional parent database context\n * Used for dynamic relation mapping\n */\nexport interface LinkMention {\n text: string;\n url: string;\n pageId?: string | null; // Extracted Notion page ID (normalized, no hyphens)\n parentDatabaseId?: string | null; // Parent database ID if page is in a database\n}\n\n/**\n * Reduced/transformed Notion block structure\n */\nexport interface ReducedNotionBlock {\n todo_string: string;\n block_id: string;\n block_url: string;\n page_url?: string; // Source page URL where the todo block was found\n parent_id?: string | null; // Parent block ID for traversal (null if parent is page)\n has_children?: boolean; // true = block has nested children\n preceding_heading?: string | null; // Closest heading before this block (for context matching)\n last_edited_time: string;\n author?: { // Block creator (from created_by)\n id: string;\n name: string | null;\n email: string | null;\n } | null;\n people_mentions: Array<{ // @mentions in block text (all go to Other people)\n id: string;\n name: string;\n email: string | null;\n }>;\n date_mentions: string[];\n link_mentions: LinkMention[];\n source_page_database_id?: string | null; // Parent database of the source page (for contextual mapping)\n sync_metadata?: SyncMetadata; // Optional sync tracking metadata\n checked?: boolean; // to_do block checkbox state (true = checked, undefined = unchecked or not a to_do)\n}\n\n/**\n * Blob storage save result\n */\nexport interface BlobSaveResult {\n success: boolean;\n key: string | null;\n error: string | null;\n}\n\n/**\n * Todo save to Notion result\n */\nexport interface TodoSaveResult {\n success: boolean;\n totalBlobs: number;\n pagesCreated: number;\n pagesUpdated: number;\n pagesSkipped: number;\n pagesFailed: number;\n failures: Array<{\n blockId: string;\n error: string;\n }>;\n error?: string;\n details?: string;\n}\n\n/**\n * Property category for organizational grouping\n * - system: Infrastructure properties (blockId, urls, timestamps)\n * - core: Essential todo properties (name, dueDate, status, owner)\n * - enrichment: Additional context (author, links, summary, projects)\n */\nexport type PropertyCategory = 'system' | 'core' | 'enrichment';\n\n/**\n * Property metadata for declarative configuration\n * Defines what each property does and how it can be discovered\n */\nexport interface PropertyMetadata {\n displayName: string; // Human-readable name for UI (e.g., \"Due date\", \"Block ID\")\n purpose: string; // Human-readable description\n category: PropertyCategory; // Organizational grouping (system/core/enrichment)\n required: boolean; // Is this property required for basic functionality?\n autodiscoverable: boolean; // Can this be found automatically by type or name pattern?\n expectedTypes: string[]; // Notion property types this can be (e.g., [\"title\"], [\"status\", \"select\", \"checkbox\"])\n namePatterns?: string[]; // Optional name patterns for autodiscovery (e.g., [\"due\", \"deadline\"])\n}\n\n/**\n * Property status in health check response (property-centric)\n */\nexport interface PropertyStatus {\n key: string; // Internal property key (e.g., \"name\", \"status\")\n displayName: string; // Human-readable name for UI (e.g., \"Due date\")\n purpose: string; // Human-readable description\n category: PropertyCategory; // Organizational grouping (system/core/enrichment)\n required: boolean; // Is this property required?\n envVar: string; // Env var name (e.g., \"TODOS_PROP_DUE_DATE\")\n envValue: string | null; // Current env var value (if set)\n defaultName: string | null; // System default property name\n foundName: string | null; // Property name found in database (if any)\n foundType: string | null; // Notion property type (if found)\n candidates?: string[]; // Suggested property names (if missing/disabled)\n}\n\n/**\n * Database schema property (from Notion API)\n */\nexport interface DatabaseSchemaProperty {\n name: string;\n type: string;\n id: string;\n}\n\n/**\n * Project info from Val Town\n */\nexport interface ProjectInfo {\n name: string;\n username: string;\n version: number;\n branch: string;\n url: string | null;\n}\n\n/**\n * Connection status type\n */\nexport type ConnectionStatus = 'connected' | 'error' | 'not_configured';\n\n/**\n * Notion API connection status\n */\nexport interface NotionConnection {\n envVar: string;\n status: ConnectionStatus;\n integrationName?: string;\n error?: string;\n}\n\n/**\n * Database connection status\n */\nexport interface DatabaseConnection {\n envVar: string;\n status: ConnectionStatus;\n id: string | null;\n name: string | null;\n url: string | null;\n error?: string;\n}\n\n/**\n * OpenAI connection status\n */\nexport interface OpenAIConnection {\n envVar: string;\n status: ConnectionStatus;\n}\n\n/**\n * All service connections\n */\nexport interface Connections {\n notion: NotionConnection;\n database: DatabaseConnection;\n openai: OpenAIConnection;\n}\n\n/**\n * Category display info\n */\nexport interface CategoryInfo {\n title: string;\n description: string;\n}\n\n/**\n * Health check response (property-centric)\n */\nexport interface HealthCheckResponse {\n project: ProjectInfo;\n timestamp: string;\n connections: Connections;\n properties: PropertyStatus[];\n categories: Record<PropertyCategory, CategoryInfo>;\n relations: Array<{\n propertyName: string;\n targetDatabaseId: string;\n pageCount: number;\n isFuzzyMatchEnabled: boolean;\n }>;\n settings: Array<{\n key: string;\n envVar: string;\n value: string | null;\n defaultValue: string | null;\n description: string;\n }>;\n}\n\n/**\n * Legacy: Property mappings status for a database\n * @deprecated Use HealthCheckResponse instead\n */\nexport interface DatabasePropertyMappings {\n status: 'ok' | 'error' | 'not_connected';\n properties: Array<{\n key: string;\n configured: string;\n found: boolean;\n status: 'ok' | 'missing';\n }>;\n actualProperties: string[];\n}\n\n/**\n * Relation property discovered from todos database schema\n * Used for dynamic relation mapping\n */\nexport interface RelationPropertyMapping {\n propertyName: string; // Name of relation property in todos DB (e.g., \"Projects db\")\n targetDatabaseId: string; // The database this relation points to (normalized, no hyphens)\n isProjectRelation: boolean; // true if matches TODOS_PROPERTIES.projects (gets AI treatment)\n}\n\n/**\n * Result of relation matching for a single block\n */\nexport interface RelationMatchResult {\n propertyName: string; // Relation property name to populate\n pageIds: string[]; // Page IDs to link\n matchType: 'mention' | 'contextual' | 'ai'; // How the match was made\n}\n\n/**\n * Structured result from AI summary generation\n * Contains both the summary text and extracted owner information\n */\nexport interface SummaryResult {\n summary: string;\n ownerName: string | null;\n ownerSource: 'heading' | 'contact' | 'mention' | null;\n}\n\n/**\n * Resolved owner value for property mapping\n * Type determines whether to use people or relation format\n */\nexport interface ResolvedOwner {\n type: 'people' | 'relation';\n value: Array<{ id: string }>;\n}\n",[],[199,329],"1cb975e0-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f6-57913e4eabdf",["D",1761588582800],"# Shared\n\nThis directory contains code shared between frontend (browser) and backend (Deno).\n\n## Files\n\n- **types.ts** - TypeScript interfaces and types\n - Controller response format\n - Notion data structures\n - API request/response types\n\n- **utils.ts** - Utility functions\n - Must work in both browser AND Deno\n - ❌ **NEVER use Deno APIs** (won't work in browser)\n - ✅ Only use standard JavaScript/TypeScript\n\n## Guidelines\n\n### Adding Types\n- Define interfaces for data shared between layers\n- Use clear, descriptive names (PascalCase)\n- Document complex types with comments\n\n### Adding Utils\n- Test that functions work in both environments\n- Avoid platform-specific APIs (Deno, Node, browser-only)\n- Use pure functions when possible\n\n## Example\n\n```typescript\n// ✅ Good - works everywhere\nexport function formatDate(date: string): string {\n return new Date(date).toLocaleDateString();\n}\n\n// ❌ Bad - Deno-specific\nexport function readConfig() {\n return Deno.env.get('CONFIG'); // Won't work in browser!\n}\n```\n",[],[199,171],["D",1761588582800],[291,292,293],[199],"1cb97342-b360-11f0-bc6f-0224a6c84d84","index.tsx","019a26dc-99bf-7269-a8f6-4e21b80e62ce",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0\";\nimport ReactDOM from \"https://esm.sh/react-dom@18.2.0/client\";\nimport { App } from \"./components/App.tsx\";\n\nconst root = ReactDOM.createRoot(document.getElementById(\"root\")!);\nroot.render(\n <React.StrictMode>\n <App />\n </React.StrictMode>\n);\n",[],[205,346],"ba939fe6-f65b-11f0-9735-42dde27851f2",["D",1768953428102],11,[],[205,33],"1cb97072-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f6-463e83dc952c",["D",1761588582800],"# Frontend\n\nThis directory contains the React frontend for the Notion webhook integration application.\n\n## Structure\n\n- **index.html** - HTML shell that loads the React app\n- **index.tsx** - React app entry point\n- **components/** - React components\n - **App.tsx** - Main application component\n - **NotionBlock.tsx** - Renders Notion block content\n - **NotionProperty.tsx** - Displays Notion page properties\n\n## React Configuration\n\n**IMPORTANT**: All React files must:\n1. Include `/** @jsxImportSource https://esm.sh/react@18.2.0 */` at the top\n2. Pin React dependencies to version 18.2.0: `?deps=react@18.2.0`\n3. Use consistent React version across all imports\n\n## Styling\n\nUses Pico CSS (classless CSS framework loaded from CDN in index.html). Pico automatically styles semantic HTML elements without requiring CSS classes, keeping markup clean and maintainable.\n\n## API Communication\n\n- Fetch data from `/api/*` endpoints\n- Use shared types from `../shared/types.ts`\n- Handle loading and error states in components\n\n## Error Handling\n\nThe error catching script is included in index.html to capture client-side errors for better debugging.\n\n## Development\n\nSince this is a Val Town project, the frontend is served through Hono routes defined in `main.http.tsx`.\n",[],[205,171],"1cb96d48-b360-11f0-bc6f-0224a6c84d84","NotionProperty.tsx","019a26dc-99bf-7269-a8f6-3d6be1b615e8","019a26dc-99bf-7269-a8f6-40d88c93ec73",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { getPropertyValue } from \"../../shared/utils.ts\";\n\ninterface NotionPropertyProps {\n name: string;\n property: any;\n}\n\n/**\n * Component for rendering Notion page properties\n * Uses semantic HTML - Pico CSS provides automatic styling\n * Handles different property types\n */\nexport function NotionProperty({ name, property }: NotionPropertyProps) {\n if (!property) {\n return null;\n }\n\n const value = getPropertyValue({ [name]: property }, name);\n\n const renderValue = () => {\n switch (property.type) {\n case 'title':\n case 'rich_text':\n return <span>{value}</span>;\n\n case 'number':\n return <code>{value}</code>;\n\n case 'select':\n return <kbd>{value}</kbd>;\n\n case 'multi_select':\n return (\n <span>\n {Array.isArray(value) && value.map((item: string, i: number) => (\n <kbd key={i} style={{ marginRight: '0.5rem' }}>\n {item}\n </kbd>\n ))}\n </span>\n );\n\n case 'date':\n return (\n <time>\n {value ? new Date(value).toLocaleDateString() : '-'}\n </time>\n );\n\n case 'checkbox':\n return (\n <input\n type=\"checkbox\"\n checked={value}\n readOnly\n />\n );\n\n case 'url':\n return (\n <a\n href={value}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n >\n {value}\n </a>\n );\n\n case 'email':\n return (\n <a href={`mailto:${value}`}>\n {value}\n </a>\n );\n\n case 'phone_number':\n return (\n <a href={`tel:${value}`}>\n {value}\n </a>\n );\n\n case 'status':\n return <mark>{value}</mark>;\n\n default:\n return (\n <small>\n <em>Unsupported: {property.type}</em>\n </small>\n );\n }\n };\n\n return (\n <p>\n <strong>{name}:</strong> {renderValue()}\n </p>\n );\n}\n",[],[205,371,364],"components","1cb96a96-b360-11f0-bc6f-0224a6c84d84","NotionBlock.tsx","019a26dc-99bf-7269-a8f6-3ab802992fe4",["D",1761588582800],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\ninterface NotionBlockProps {\n block: any;\n}\n\n/**\n * Component for rendering Notion blocks\n * Uses semantic HTML - Pico CSS provides automatic styling\n * Extend this to support different block types as needed\n */\nexport function NotionBlock({ block }: NotionBlockProps) {\n if (!block || !block.type) {\n return null;\n }\n\n const renderBlockContent = () => {\n switch (block.type) {\n case 'paragraph':\n return (\n <p>\n {block.paragraph?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </p>\n );\n\n case 'heading_1':\n return (\n <h1>\n {block.heading_1?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </h1>\n );\n\n case 'heading_2':\n return (\n <h2>\n {block.heading_2?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </h2>\n );\n\n case 'heading_3':\n return (\n <h3>\n {block.heading_3?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </h3>\n );\n\n case 'bulleted_list_item':\n return (\n <li>\n {block.bulleted_list_item?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </li>\n );\n\n case 'numbered_list_item':\n return (\n <li>\n {block.numbered_list_item?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </li>\n );\n\n case 'to_do':\n return (\n <label>\n <input\n type=\"checkbox\"\n checked={block.to_do?.checked}\n readOnly\n />\n <span style={block.to_do?.checked ? { textDecoration: 'line-through', opacity: 0.6 } : undefined}>\n {block.to_do?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </span>\n </label>\n );\n\n case 'code':\n return (\n <pre>\n <code>\n {block.code?.rich_text?.map((text: any, i: number) => (\n <span key={i}>{text.plain_text}</span>\n ))}\n </code>\n </pre>\n );\n\n default:\n return (\n <small>\n <em>Unsupported block type: {block.type}</em>\n </small>\n );\n }\n };\n\n return <div>{renderBlockContent()}</div>;\n}\n",[],[205,371,373],"fdeaed5c-f64d-11f0-b79f-42dde27851f2","App.tsx","019a26dc-99bf-7269-a8f6-34ccac805b70",317,["D",1768947528126],60,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n useState,\n useEffect,\n} from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport type {\n PropertyStatus,\n HealthCheckResponse,\n} from \"../../shared/types.ts\";\n\n/**\n * Derived state for display purposes (UI-only)\n */\ntype DerivedState = \"found\" | \"missing\" | \"disabled\" | \"autodiscovered\";\n\n/**\n * Derive display state from property fields\n */\nfunction deriveState(prop: PropertyStatus): DerivedState {\n const effectiveName = prop.envValue ?? prop.defaultName;\n\n if (prop.foundName) {\n // Something was found\n if (prop.foundName === effectiveName) {\n return \"found\";\n }\n return \"autodiscovered\";\n }\n\n // Nothing found\n if (effectiveName) {\n return \"missing\";\n }\n return \"disabled\";\n}\n\n/**\n * Generic config row component - reusable template for all config sections\n * Summary: {label} → {value} {badge?}\n */\ntype ConfigRowProps = {\n label: string;\n purpose?: string;\n value: React.ReactNode;\n badge?: React.ReactNode;\n children: React.ReactNode;\n};\n\nfunction ConfigRow({ label, purpose, value, badge, children }: ConfigRowProps) {\n return (\n <details>\n <summary>\n {purpose ? <span data-tooltip={purpose}>{label}</span> : label} →{\" \"}\n {value} {badge}\n </summary>\n <article>{children}</article>\n </details>\n );\n}\n\n/**\n * Render a single property as stacked details\n * Summary: Name → column (or Name → ? for errors)\n */\nfunction PropertyRow({ prop }: { prop: PropertyStatus }) {\n const state = deriveState(prop);\n const needsFix = state === \"autodiscovered\" || state === \"missing\";\n const isDisabled = state === \"disabled\";\n const configuredName = prop.envValue ?? prop.defaultName;\n\n // Status badge: only show \"disabled\" for disabled state\n const status = isDisabled ? (\n <code data-tooltip=\"optional - expand for details\">disabled</code>\n ) : null;\n\n // Column name: show ? with status for non-working states\n const columnName =\n state === \"found\" && prop.foundName ? (\n <code>{prop.foundName}</code>\n ) : (\n <code\n className={\n needsFix && prop.required\n ? \"pico-background-red-500\"\n : needsFix\n ? \"pico-background-yellow-100\"\n : undefined\n }\n data-tooltip={needsFix ? \"Click for suggestions\" : undefined}\n >\n ?{needsFix && \" - not found\"}\n </code>\n );\n\n return (\n <ConfigRow label={prop.displayName} value={columnName} badge={status}>\n <dl>\n {/* Property description - always shown */}\n <dt>Property description</dt>\n <dd>{prop.purpose}</dd>\n\n {/* Success confirmation */}\n {state === \"found\" && (\n <>\n <dt>Status</dt>\n <dd>\n Mapped correctly to <code>{prop.foundName}</code>\n </dd>\n </>\n )}\n\n {/* Mapping problem - only if there's an issue */}\n {(state === \"autodiscovered\" || state === \"missing\") && (\n <>\n <dt>Mapping problem</dt>\n <dd>\n Your database doesn't have a property called{\" \"}\n <code>{configuredName}</code>\n </dd>\n </>\n )}\n\n {/* Similar properties - autodiscovered has foundName, missing may have candidates */}\n {state === \"autodiscovered\" && prop.foundName && (\n <>\n <dt>Properties with similar names</dt>\n <dd>\n <code>{prop.foundName}</code>\n </dd>\n </>\n )}\n\n {state === \"missing\" &&\n prop.candidates &&\n prop.candidates.length > 0 && (\n <>\n <dt>Properties with similar names</dt>\n <dd>\n {prop.candidates.map((candidate, i) => (\n <span key={candidate}>\n <code>{candidate}</code>\n {i < prop.candidates!.length - 1 && \", \"}\n </span>\n ))}\n </dd>\n </>\n )}\n\n {/* Fix options - only if there's a problem to fix */}\n {state === \"autodiscovered\" && prop.foundName && (\n <>\n <dt>To fix this mapping problem</dt>\n <dd>\n Try one of these options:\n <ul>\n <li>\n Set env var:{\" \"}\n <code>\n {prop.envVar}={prop.foundName}\n </code>\n </li>\n <li>\n Rename <code>{prop.foundName}</code> to{\" \"}\n <code>{configuredName}</code> in the database\n </li>\n </ul>\n </dd>\n </>\n )}\n\n {state === \"missing\" &&\n prop.candidates &&\n prop.candidates.length > 0 && (\n <>\n <dt>To fix this mapping problem</dt>\n <dd>\n Try one of these options:\n <ul>\n {prop.candidates.map((candidate) => (\n <li key={candidate}>\n Set env var:{\" \"}\n <code>\n {prop.envVar}={candidate}\n </code>\n </li>\n ))}\n {prop.candidates.map((candidate) => (\n <li key={`rename-${candidate}`}>\n Rename <code>{candidate}</code> to{\" \"}\n <code>{configuredName}</code> in the database\n </li>\n ))}\n <li>\n Create a <code>{configuredName}</code> property in the\n database\n </li>\n </ul>\n </dd>\n </>\n )}\n\n {state === \"missing\" &&\n (!prop.candidates || prop.candidates.length === 0) && (\n <>\n <dt>To fix this mapping problem</dt>\n <dd>\n Try one of these options:\n <ul>\n <li>\n Create a <code>{configuredName}</code> property in the\n database\n </li>\n <li>\n Set env var: <code>{prop.envVar}=your property name</code>\n </li>\n </ul>\n </dd>\n </>\n )}\n\n {/* Disabled state - optional property not configured */}\n {state === \"disabled\" &&\n prop.candidates &&\n prop.candidates.length > 0 && (\n <>\n <dt>To enable this property</dt>\n <dd>\n <ul>\n {prop.candidates.map((candidate) => (\n <li key={candidate}>\n Set env var:{\" \"}\n <code>\n {prop.envVar}={candidate}\n </code>\n </li>\n ))}\n </ul>\n </dd>\n </>\n )}\n\n {state === \"disabled\" &&\n (!prop.candidates || prop.candidates.length === 0) && (\n <>\n <dt>To enable this property</dt>\n <dd>\n Set env var: <code>{prop.envVar}=your property name</code>\n </dd>\n </>\n )}\n </dl>\n\n <footer>\n <details>\n <summary>JSON</summary>\n <pre>{JSON.stringify(prop, null, 2)}</pre>\n </details>\n </footer>\n </ConfigRow>\n );\n}\n\nexport function App() {\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState<string | null>(null);\n const [healthData, setHealthCheckResponse] =\n useState<HealthCheckResponse | null>(null);\n\n const fetchHealthCheckResponse = async () => {\n setLoading(true);\n setError(null);\n\n try {\n const response = await fetch(\"/api/health\");\n const data: HealthCheckResponse = await response.json();\n\n if (!response.ok) {\n throw new Error(\"Failed to fetch health data\");\n }\n\n setHealthCheckResponse(data);\n } catch (err: any) {\n setError(err.message || \"An error occurred\");\n } finally {\n setLoading(false);\n }\n };\n\n // Fetch health data on mount\n useEffect(() => {\n fetchHealthCheckResponse();\n }, []);\n\n // Update page title with project info\n useEffect(() => {\n if (healthData?.project) {\n document.title = `${healthData.project.username}/${healthData.project.name}`;\n } else {\n document.title = \"todoSweeper - Health Check\";\n }\n }, [healthData]);\n\n return (\n <div className=\"container\">\n <header>\n <hgroup>\n {healthData?.project ? (\n <>\n <code>\n {healthData.project.url ? (\n <a href={healthData.project.url} target=\"_blank\">\n {healthData.project.username}/{healthData.project.name}\n </a>\n ) : (\n `${healthData.project.username}/${healthData.project.name}`\n )}\n </code>\n <small style={{ marginLeft: \"0.5rem\" }}>\n v{healthData.project.version}\n {healthData.project.branch !== \"main\" &&\n ` (${healthData.project.branch})`}\n </small>\n </>\n ) : (\n <code>todoSweeper</code>\n )}\n <p>Sweep todos from your Notion workspace into a database</p>\n </hgroup>\n </header>\n <hr />\n <main>\n <h1>Configuration</h1>\n\n {loading && <p aria-busy=\"true\">Checking system health...</p>}\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 hasIssues = connectionIssues > 0 || requiredIssues > 0;\n\n return (\n <section>\n {hasIssues ? (\n <article\n style={{ backgroundColor: \"var(--pico-color-red-100)\" }}\n >\n <header>\n <strong>⚠ Issues found</strong>\n </header>\n <ul>\n {connectionIssues > 0 && (\n <li>\n {connectionIssues} connection issue\n {connectionIssues > 1 ? \"s\" : \"\"}\n </li>\n )}\n {requiredIssues > 0 && (\n <li>\n {requiredIssues} required property issue\n {requiredIssues > 1 ? \"s\" : \"\"}\n </li>\n )}\n </ul>\n </article>\n ) : (\n <div className=\"pico-color-green-500\">\n ✓ Connections and database property mappings are OK\n </div>\n )}\n </section>\n );\n })()}\n\n {/* Services */}\n <section>\n <hgroup>\n <h2>Connections</h2>\n <p></p>\n </hgroup>\n <dl>\n {/* Notion API */}\n <dt>\n <strong>Notion</strong>\n </dt>\n <dd>\n <details>\n <summary>\n {healthData.connections.notion.status === \"connected\"\n ? \"Notion is connected\"\n : healthData.connections.notion.status === \"error\"\n ? \"Notion connection failed\"\n : \"Notion is not configured\"}\n </summary>\n <article>\n <dl>\n {healthData.connections.notion.status ===\n \"connected\" && (\n <>\n <dt>Integration name</dt>\n <dd>\n <code>\n {healthData.connections.notion.integrationName}\n </code>\n </dd>\n </>\n )}\n {healthData.connections.notion.status === \"error\" && (\n <>\n <dt>Error</dt>\n <dd>{healthData.connections.notion.error}</dd>\n </>\n )}\n <dt>Environment variable</dt>\n <dd>\n <code>{healthData.connections.notion.envVar}</code>\n </dd>\n </dl>\n {healthData.connections.notion.status !== \"connected\" && (\n <p>\n To connect, add to your Val Town environment\n variables:\n <br />\n <code>\n {healthData.connections.notion.envVar}\n =your-integration-token\n </code>\n </p>\n )}\n </article>\n </details>\n </dd>\n\n {/* OpenAI */}\n <dt>\n <strong>OpenAI</strong>\n </dt>\n <dd>\n <details>\n <summary>\n {healthData.connections.openai.status === \"connected\"\n ? \"OpenAI is connected\"\n : \"OpenAI is not configured\"}\n </summary>\n <article>\n <dl>\n <dt>Environment variable</dt>\n <dd>\n <code>{healthData.connections.openai.envVar}</code>\n </dd>\n </dl>\n {healthData.connections.openai.status !== \"connected\" && (\n <p>\n To enable AI summaries, add to your Val Town\n environment variables:\n <br />\n <code>\n {healthData.connections.openai.envVar}=your-api-key\n </code>\n </p>\n )}\n </article>\n </details>\n </dd>\n\n {/* Todos Database */}\n <dt>\n <strong>Todos database</strong>\n </dt>\n <dd>\n <details>\n <summary>\n {healthData.connections.database.status === \"connected\"\n ? \"A todos database is connected\"\n : healthData.connections.database.status === \"error\"\n ? \"Todos database connection failed\"\n : \"Todos database is not configured\"}\n </summary>\n <article>\n <dl>\n {healthData.connections.database.status ===\n \"connected\" && (\n <>\n <dt>Database name</dt>\n <dd>\n {healthData.connections.database.url ? (\n <a\n href={healthData.connections.database.url}\n target=\"_blank\"\n >\n {healthData.connections.database.name}\n </a>\n ) : (\n healthData.connections.database.name\n )}\n </dd>\n <dt>Database ID</dt>\n <dd>\n <code>{healthData.connections.database.id}</code>\n </dd>\n </>\n )}\n {healthData.connections.database.status === \"error\" && (\n <>\n <dt>Error</dt>\n <dd>{healthData.connections.database.error}</dd>\n </>\n )}\n <dt>Environment variable</dt>\n <dd>\n <code>{healthData.connections.database.envVar}</code>\n </dd>\n </dl>\n {healthData.connections.database.status !==\n \"connected\" && (\n <p>\n To connect, add to your Val Town environment\n variables:\n <br />\n <code>\n {healthData.connections.database.envVar}\n =your-database-id\n </code>\n </p>\n )}\n </article>\n </details>\n </dd>\n </dl>\n </section>\n\n {/* Property Configuration */}\n <section>\n <hgroup>\n <h2>Todos database property mappings</h2>\n <ul>\n <li>\n <p>\n Default property display name →{\" \"}\n <code>Actual database property name</code>\n </p>\n </li>\n </ul>\n </hgroup>\n {/* Required - sync will fail without these */}\n <section>\n <hgroup>\n <h5>Required property mappings</h5>\n <p>The sweep will fail if these properties have errors.</p>\n </hgroup>\n <ul>\n {healthData.properties\n .filter((p) => p.required)\n .map((prop) => (\n <li key={prop.key}>\n <PropertyRow prop={prop} />\n </li>\n ))}\n </ul>\n </section>\n\n {/* Optional - nice to have */}\n <section>\n <hgroup>\n <h5>Optional property mappings</h5>\n <p>\n These properties are not required for a successful sweep.\n </p>\n </hgroup>\n <ul>\n {healthData.properties\n .filter((p) => !p.required)\n .sort((a, b) => a.displayName.localeCompare(b.displayName))\n .map((prop) => (\n <li key={prop.key}>\n <PropertyRow prop={prop} />\n </li>\n ))}\n </ul>\n </section>\n </section>\n\n {/* Relations */}\n {healthData.relations.length > 0 && (\n <section>\n <hgroup>\n <h5>Relations</h5>\n <p>\n These relation properties will be updated with page\n mentions.\n </p>\n </hgroup>\n\n <ul>\n {healthData.relations.map((rel) => (\n <li key={rel.propertyName}>\n <ConfigRow\n label={rel.propertyName}\n value={<code>{rel.pageCount} pages</code>}\n >\n <dl>\n <dt>How it works</dt>\n <dd>\n If your todo @mentions a page from the target\n database, it will be added as a relation.\n </dd>\n <dt>Fuzzy matching</dt>\n <dd>\n {rel.isFuzzyMatchEnabled ? (\n <>\n Enabled. When your todo contains text that\n matches a page name in this database (even\n without an @mention), that page will be linked\n automatically.\n </>\n ) : (\n <>\n Not enabled. Only explicit @mentions will be\n linked.\n <br />\n <br />\n To enable, set:{\" \"}\n <code>\n TODOS_FUZZY_MATCH_RELATIONS={rel.propertyName}\n </code>\n </>\n )}\n </dd>\n </dl>\n </ConfigRow>\n </li>\n ))}\n </ul>\n </section>\n )}\n\n {/* Environment */}\n <section>\n <h2>Settings</h2>\n\n <table>\n <thead>\n <tr>\n <th>Environment variable</th>\n <th>Value</th>\n </tr>\n </thead>\n <tbody>\n {healthData.settings.map((setting) => (\n <tr key={setting.key}>\n <td>\n <code>{setting.envVar}</code>\n <br />\n {setting.description}\n {setting.defaultValue !== null && (\n <>\n {\" \"}\n Default: <code>{setting.defaultValue}</code>\n </>\n )}\n </td>\n <td>\n {setting.value !== null ? (\n <code>{setting.value}</code>\n ) : (\n \"not set\"\n )}\n </td>\n </tr>\n ))}\n </tbody>\n </table>\n </section>\n\n {/* Raw JSON */}\n <section>\n <details>\n <summary>\n Raw health data (<code>JSON</code>)\n </summary>\n <article>\n <p>\n Also available at{\" \"}\n <code>\n <a href=\"/api/health\" target=\"_blank\">\n /api/health\n </a>\n </code>\n </p>\n <pre>{JSON.stringify(healthData, null, 2)}</pre>\n </article>\n </details>\n </section>\n </>\n )}\n\n {!loading && error && (\n <details open>\n <summary>\n <strong>✗ Connection Error</strong>\n </summary>\n <div>\n <p>{error}</p>\n <h4>Troubleshooting</h4>\n <ul>\n <li>\n Check that <code>NOTION_API_KEY</code> is set correctly\n </li>\n <li>Verify your integration has access to your workspace</li>\n <li>Ensure the API key hasn't expired</li>\n <li>Make sure pages are shared with your integration</li>\n </ul>\n </div>\n </details>\n )}\n </main>\n {healthData?.timestamp && (\n <footer>\n Last checked: {new Date(healthData.timestamp).toLocaleString()}\n </footer>\n )}\n </div>\n );\n}\n",[],[205,371,380],"1cb96f5a-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[284,285,286],[205,371],["D",1761588582800],[283,287,288,289],[205],"1cb96514-b360-11f0-bc6f-0224a6c84d84","019a26dc-99bf-7269-a8f6-2fbd5953f9c6",["D",1761588582800],"# Backend\n\nThis directory contains the backend logic for the Notion webhook integration application.\n\n## Structure\n\n- **controllers/** - Business logic and orchestration\n - Contains functions that validate data, orchestrate service calls, and return standardized responses\n - All controllers return `{success, data, error, details?}` format\n - Controllers are HTTP-agnostic (don't create HTTP responses)\n\n- **routes/** - HTTP request/response handling\n - **api/** - RESTful API endpoints for data operations\n - **tasks/** - Notion webhook handlers\n - **views/** - User-facing HTML/React views\n - **authCheck.ts** - Authentication middleware\n\n- **services/** - External API integrations\n - Handle calls to external APIs (Notion, Firecrawler, blob storage, etc.)\n - Return structured results with `{success, data, error}` format\n - Manage API authentication and error handling\n\n## Architecture Flow\n\n```\nRequest → Route → Controller → Service → External API\n```\n\n**Never skip layers!**\n- Routes call controllers (not services directly)\n- Controllers call services (not external APIs directly)\n- Services handle external API calls\n\n## Adding New Features\n\n1. Create route in appropriate directory (`api/`, `tasks/`, or `views/`)\n2. Create controller function with business logic\n3. Create/use service functions for external API calls\n4. Mount route in `main.http.tsx`\n\nSee `CLAUDE.md` for detailed guidelines.\n",[],[210,171],"cbdb8792-ebfb-11f0-8ce9-42dde27851f2","valUtils.ts","cbdb8846-ebfb-11f0-8ce9-42dde27851f2","019a2d3c-4319-71ac-88e5-a0aa162b3be7",256,["D",1767812713786],"/**\n * Val Town Project Utilities\n *\n * Provides cached access to project metadata from Val Town's std utils.\n * Used for dynamic project name display and blob key prefixes.\n */\nimport { parseProject } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n/**\n * Project information from Val Town\n */\nexport interface ProjectInfo {\n name: string;\n username: string;\n version: number;\n branch: string;\n url: string | null;\n}\n\nlet cachedProjectInfo: ProjectInfo | null = null;\n\n/**\n * Get project information from Val Town\n *\n * Results are cached since project info doesn't change at runtime.\n *\n * @returns Project info object\n */\nexport function getProjectInfo(): ProjectInfo {\n if (!cachedProjectInfo) {\n try {\n const info = parseProject(import.meta.url);\n cachedProjectInfo = {\n name: info.name || 'unknown',\n username: info.username || 'unknown',\n version: info.version || 0,\n branch: info.branch || 'main',\n url: info.links?.self?.project || null\n };\n } catch {\n cachedProjectInfo = {\n name: 'unknown',\n username: 'unknown',\n version: 0,\n branch: 'main',\n url: null\n };\n }\n }\n return cachedProjectInfo;\n}\n\n/**\n * Get just the project name\n *\n * Convenience function for cases where only the name is needed.\n *\n * @returns Project name string\n */\nexport function getProjectName(): string {\n return getProjectInfo().name;\n}\n",[],[210,410,402],"utils","b947264a-b659-11f0-934f-0224a6c84d84","textUtils.ts","b94726c2-b659-11f0-934f-0224a6c84d84",20,["D",1761915692505],"/**\n * Text utility functions for word counting and text validation\n * Pure functions with no external dependencies\n */\n\n/**\n * Get minimum block words setting from environment variable\n *\n * Reads MIN_BLOCK_WORDS env var\n * Falls back to 5 if not set or invalid\n *\n * Default of 5 accounts for:\n * - ~1 word for person mention (e.g., \"@John\")\n * - ~2-3 words for date mention (e.g., \"October 30, 2025\")\n * - ~2-3 words for action (e.g., \"buy groceries\")\n *\n * @returns Minimum word count (integer >= 1)\n */\nexport function getMinBlockWords(): number {\n const envValue = Deno.env.get('MIN_BLOCK_WORDS');\n\n if (!envValue) {\n return 5; // Default fallback\n }\n\n const parsed = parseInt(envValue.trim(), 10);\n\n // Validate: must be a positive integer\n if (isNaN(parsed) || parsed < 1) {\n console.warn(`⚠ Invalid MIN_BLOCK_WORDS value: \"${envValue}\". Using 5 as fallback.`);\n return 5;\n }\n\n return parsed;\n}\n\n/**\n * Count words in a text string\n *\n * Splits by whitespace and counts non-empty tokens\n * - Hyphenated words count as 1 word (e.g., \"buy-now\" = 1)\n * - Emojis count as words (e.g., \"🍋 🎉\" = 2)\n * - Mentions count as words (e.g., \"@John tomorrow\" = 2)\n * - Dates count as words (e.g., \"October 30, 2025\" = 3)\n *\n * @param text - Text string to count words in\n * @returns Number of words\n */\nexport function countWords(text: string): number {\n if (!text || typeof text !== 'string') {\n return 0;\n }\n\n // Split by whitespace, filter empty strings\n const words = text.trim().split(/\\s+/).filter(w => w.length > 0);\n\n return words.length;\n}\n",[],[210,410,412],"c5a9baba-e570-11f0-81fd-42dde27851f2","projectUtils.ts","380f0278-cc84-11f0-9eea-42dde27851f2",219,["D",1767093296360],7,"/**\n * Project utility functions for disambiguation\n */\n\nexport interface ProjectWithDates {\n id: string;\n name?: string;\n groupName: string | null;\n dateStart: string | null;\n dateEnd: string | null;\n lastEditedTime: string;\n}\n\n/**\n * Result from disambiguation - either a project ID or candidates for AI disambiguation\n */\nexport interface DisambiguationResult {\n projectId: string | null;\n needsAiDisambiguation: boolean;\n candidates?: ProjectWithDates[];\n}\n\n/**\n * Pick the best project within a group based on todo due date\n *\n * Disambiguation strategy:\n * 1. If due date falls within exactly one project's date range → use that project\n * 2. If due date falls within multiple projects → return candidates for AI disambiguation\n * 3. If no project contains the due date → pick project with closest start/end date\n * 4. If projects have no dates → use most recently edited project\n *\n * @param groupName - The group name to filter by\n * @param projects - Array of projects with dates\n * @param todoDueDate - The todo's due date (ISO string) or null\n * @returns DisambiguationResult with projectId or candidates for AI\n */\nexport function disambiguateProjectsByGroup(\n groupName: string,\n projects: ProjectWithDates[],\n todoDueDate: string | null\n): DisambiguationResult {\n // Filter to projects in this group\n const groupProjects = projects.filter(p => p.groupName === groupName);\n\n if (groupProjects.length === 0) {\n return { projectId: null, needsAiDisambiguation: false };\n }\n if (groupProjects.length === 1) {\n return { projectId: groupProjects[0].id, needsAiDisambiguation: false };\n }\n\n // No due date - use most recently edited\n if (!todoDueDate) {\n return { projectId: getMostRecentlyEdited(groupProjects), needsAiDisambiguation: false };\n }\n\n const dueDate = new Date(todoDueDate);\n\n // Strategy 1: Find ALL projects where due date is within range\n const matchingProjects = groupProjects.filter(project => {\n if (project.dateStart && project.dateEnd) {\n const start = new Date(project.dateStart);\n const end = new Date(project.dateEnd);\n return dueDate >= start && dueDate <= end;\n }\n return false;\n });\n\n if (matchingProjects.length === 1) {\n // Exactly one match - use it\n return { projectId: matchingProjects[0].id, needsAiDisambiguation: false };\n }\n\n if (matchingProjects.length > 1) {\n // Multiple overlapping date ranges - need AI to decide\n return { projectId: null, needsAiDisambiguation: true, candidates: matchingProjects };\n }\n\n // Strategy 2: No exact matches - find closest date boundary\n let closestProject = groupProjects[0];\n let closestDistance = Infinity;\n\n for (const project of groupProjects) {\n const startDist = project.dateStart\n ? Math.abs(dueDate.getTime() - new Date(project.dateStart).getTime())\n : Infinity;\n const endDist = project.dateEnd\n ? Math.abs(dueDate.getTime() - new Date(project.dateEnd).getTime())\n : Infinity;\n const minDist = Math.min(startDist, endDist);\n\n if (minDist < closestDistance) {\n closestDistance = minDist;\n closestProject = project;\n }\n }\n\n // Strategy 3: Fallback to most recently edited (if all have Infinity distance)\n if (closestDistance === Infinity) {\n return { projectId: getMostRecentlyEdited(groupProjects), needsAiDisambiguation: false };\n }\n\n return { projectId: closestProject.id, needsAiDisambiguation: false };\n}\n\n/**\n * Get the most recently edited project from a list\n */\nfunction getMostRecentlyEdited(projects: ProjectWithDates[]): string {\n return projects.sort((a, b) =>\n new Date(b.lastEditedTime).getTime() - new Date(a.lastEditedTime).getTime()\n )[0].id;\n}\n",[],[210,410,420],"9840b200-f618-11f0-ba7e-42dde27851f2","notionUtils.ts","1582a536-b459-11f0-a09c-0224a6c84d84",264,["D",1768924594216],18,"/**\n * Notion utility functions for block transformations and processing\n */\n\nimport type { RelationMatchResult, ResolvedOwner } from '../../shared/types.ts';\nimport type { StatusPropertyInfo } from '../services/notion/databases.ts';\n\n/**\n * Format an ISO date string to human-readable format\n *\n * @param dateStr - ISO date string (e.g., \"2025-10-27\" or \"2025-10-27T09:00:00.000-04:00\")\n * @returns Formatted date string (e.g., \"October 27, 2025\" or \"October 27, 2025 at 9:00 AM EDT\")\n */\nfunction formatDateString(dateStr: string): string {\n try {\n // Check if it's date-only (no time component in original string)\n const isDateOnly = !dateStr.includes('T');\n\n if (isDateOnly) {\n // Date-only format: \"October 27, 2025\"\n const date = new Date(dateStr);\n return date.toLocaleDateString('en-US', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n timeZone: 'UTC' // Use UTC for date-only to avoid timezone shifts\n });\n } else {\n // Datetime format: \"October 27, 2025 at 9:00 AM EDT\"\n // Parse the ISO string to extract components without timezone conversion\n const isoMatch = dateStr.match(/^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.\\d+)?([-+]\\d{2}:\\d{2})?$/);\n\n if (!isoMatch) {\n // Fallback to original string if format doesn't match\n return dateStr;\n }\n\n const [_, year, month, day, hour24, minute, second, tzOffset] = isoMatch;\n\n // Create date object for formatting the date part only\n const date = new Date(`${year}-${month}-${day}`);\n const datePart = date.toLocaleDateString('en-US', {\n year: 'numeric',\n month: 'long',\n day: 'numeric',\n timeZone: 'UTC'\n });\n\n // Format time part - preserve the original hour/minute\n const hourNum = parseInt(hour24, 10);\n const minuteNum = parseInt(minute, 10);\n const isPM = hourNum >= 12;\n const hour12 = hourNum === 0 ? 12 : (hourNum > 12 ? hourNum - 12 : hourNum);\n const timePart = `${hour12}:${minute} ${isPM ? 'PM' : 'AM'}`;\n\n // Extract timezone abbreviation\n let tzAbbrev = '';\n if (tzOffset) {\n // Common timezone abbreviations based on offset\n const tzMap: Record<string, string> = {\n '-04:00': 'EDT',\n '-05:00': 'EST/CDT',\n '-06:00': 'CST/MDT',\n '-07:00': 'MST/PDT',\n '-08:00': 'PST',\n '+00:00': 'UTC',\n // Add more as needed\n };\n tzAbbrev = ` ${tzMap[tzOffset] || tzOffset}`;\n }\n\n return `${datePart} at ${timePart}${tzAbbrev}`;\n }\n } catch (err) {\n // If parsing fails, return original string\n return dateStr;\n }\n}\n\n/**\n * Remove hyphens from a string (for Notion URLs)\n */\nfunction removeHyphens(str: string): string {\n return str.replace(/-/g, '');\n}\n\nexport function reduceNotionBlock(block: any) {\n const blockId = block?.id;\n const lastEdited = block?.last_edited_time;\n\n // Generate Notion block URL\n const blockUrl = blockId ? `https://www.notion.so/${removeHyphens(blockId)}` : '';\n\n const richText = block?.[block.type]?.rich_text ?? [];\n\n // Collect all date strings for display formatting\n const allDateStrings: string[] = [];\n\n // Date mentions for due dates - only include if prefaced by \"due\" or \"by\"\n // Other date mentions are treated as content, not due dates\n const date_mentions: string[] = [];\n for (let i = 0; i < richText.length; i++) {\n const part = richText[i];\n if (part.type === \"mention\" && part.mention?.type === \"date\") {\n const dateStr = part.mention.date.start ?? part.mention.date.end;\n if (dateStr) {\n // Always collect for display formatting\n allDateStrings.push(dateStr);\n\n // Get text preceding this date mention\n const precedingText = richText\n .slice(0, i)\n .map((p: any) => p.plain_text || '')\n .join('')\n .toLowerCase()\n .trimEnd();\n\n // Only use as due date if preceded by \"due\" or \"by\"\n if (precedingText.endsWith('due') || precedingText.endsWith('by')) {\n date_mentions.push(dateStr);\n }\n }\n }\n }\n\n // Build full sentence and replace ISO dates with formatted versions\n let fullSentence = richText\n .map((part: any) => part.plain_text)\n .join(\"\")\n .replace(/\\s+/g, \" \") // collapse multiple spaces\n .trim();\n\n // Replace ALL date mentions in the full sentence with formatted version\n for (const dateStr of allDateStrings) {\n const formattedDate = formatDateString(dateStr);\n // Replace the ISO date string with formatted version\n fullSentence = fullSentence.replace(dateStr, formattedDate);\n }\n\n // People mentions\n const people_mentions = richText\n .filter((part: any) => part.type === \"mention\" && part.mention?.type === \"user\")\n .map((part: any) => {\n const user = part.mention.user;\n return {\n id: user.id,\n name: user.name,\n email: user.person?.email ?? null,\n };\n });\n\n // Link mentions (Notion pages, external links - but NOT person mentions)\n // Enhanced with pageId for dynamic relation mapping\n const link_mentions = richText\n .filter((part: any) => {\n // Exclude person mentions - they should only go to people_mentions\n // (Person mentions have href pointing to user profile, which would incorrectly\n // send them to the Links property when not matched to a relation)\n if (part.type === \"mention\" && part.mention?.type === \"user\") {\n return false;\n }\n // Check for href property (page mentions and some links)\n // OR check for text.link.url (regular hyperlinks)\n return part.href || part.text?.link?.url;\n })\n .map((part: any) => {\n const url = part.href || part.text?.link?.url;\n const pageId = extractPageIdFromUrl(url); // Extract Notion page ID if present\n return {\n text: part.plain_text,\n url,\n pageId, // Normalized page ID (no hyphens) or null\n parentDatabaseId: null // Will be populated later in todoController\n };\n });\n\n // Extract checkbox state for to_do blocks\n const checked = block.type === 'to_do' ? (block.to_do?.checked === true) : undefined;\n\n return {\n todo_string: fullSentence,\n block_id: blockId,\n block_url: blockUrl,\n created_time: block?.created_time,\n last_edited_time: lastEdited,\n people_mentions,\n date_mentions,\n link_mentions,\n checked,\n };\n}\n\n/**\n * Map ReducedNotionBlock to Notion database properties\n *\n * Property mappings:\n * - todo_string → Name (title)\n * - block_id → Block ID (rich_text)\n * - block_url → Block URL (url)\n * - last_edited_time → Todo last edited time (date)\n * - author → Author (people) - block creator from created_by\n * - ownerValue → Owner (people or relation) - derived from AI Summary\n * - people_mentions → Other people (people) - ALL @mentions in order\n * - date_mentions[0] → Due date (date)\n * - link_mentions → Links (rich_text - only unmapped mentions)\n * - relationMatches → Dynamic relation properties\n * - checked + statusInfo → Status property (when checkbox is checked)\n *\n * @param reducedBlock - The reduced block data\n * @param validatedProperties - Validated property names (key → actual column name or null)\n * @param relationMatches - Dynamic relation matches from matchBlockToRelations\n * @param summary - AI-interpreted polished todo text (used for Name if available)\n * @param ownerValue - Resolved owner (person or relation format)\n * @param statusInfo - Status property info for checkbox sync (optional)\n */\nexport function mapReducedBlockToProperties(\n reducedBlock: any,\n validatedProperties: Record<string, string | null>,\n relationMatches?: RelationMatchResult[],\n summary?: string,\n ownerValue?: ResolvedOwner | null,\n statusInfo?: StatusPropertyInfo | null\n) {\n const properties: any = {};\n\n // Helper to get validated property name (returns null if property doesn't exist)\n const getPropName = (key: string): string | null => validatedProperties[key] || null;\n\n // Name (title) - AI summary if available, otherwise raw text\n const nameProp = getPropName('name');\n if (nameProp) {\n const nameText = summary || reducedBlock.todo_string;\n properties[nameProp] = {\n title: [\n {\n type: \"text\",\n text: { content: nameText }\n }\n ]\n };\n }\n\n // Source - always raw todo text from source block\n const sourceProp = getPropName('sourceText');\n if (sourceProp) {\n properties[sourceProp] = {\n rich_text: [\n {\n type: \"text\",\n text: { content: reducedBlock.todo_string }\n }\n ]\n };\n }\n\n // Block ID (rich_text)\n const blockIdProp = getPropName('sourceBlockId');\n if (blockIdProp) {\n properties[blockIdProp] = {\n rich_text: [\n {\n type: \"text\",\n text: { content: reducedBlock.block_id }\n }\n ]\n };\n }\n\n // Block URL (url)\n const blockUrlProp = getPropName('sourceBlockUrl');\n if (blockUrlProp && reducedBlock.block_url) {\n properties[blockUrlProp] = {\n url: reducedBlock.block_url\n };\n }\n\n // Page URL (url) - source page where the todo block was found\n const pageUrlProp = getPropName('sourcePageUrl');\n if (pageUrlProp && reducedBlock.page_url) {\n properties[pageUrlProp] = {\n url: reducedBlock.page_url\n };\n }\n\n // Todo last edited time (date)\n const lastEditedProp = getPropName('sourceLastEditedTime');\n if (lastEditedProp) {\n properties[lastEditedProp] = {\n date: {\n start: reducedBlock.last_edited_time\n }\n };\n }\n\n // Author (people) - block creator from created_by\n const authorProp = getPropName('sourceAuthor');\n if (authorProp && reducedBlock.author && reducedBlock.author.id) {\n properties[authorProp] = {\n people: [{ id: reducedBlock.author.id }]\n };\n }\n\n // Owner - derived from AI Summary, can be people or relation type\n const ownerProp = getPropName('owner');\n if (ownerProp && ownerValue) {\n if (ownerValue.type === 'people') {\n properties[ownerProp] = {\n people: ownerValue.value\n };\n } else if (ownerValue.type === 'relation') {\n properties[ownerProp] = {\n relation: ownerValue.value\n };\n }\n }\n\n // Other people (people) - ALL @mentions in order they appear\n const otherPeopleProp = getPropName('otherPeople');\n if (otherPeopleProp && reducedBlock.people_mentions && reducedBlock.people_mentions.length > 0) {\n properties[otherPeopleProp] = {\n people: reducedBlock.people_mentions.map((p: any) => ({ id: p.id }))\n };\n }\n\n // Due date (date) - first date\n const dueDateProp = getPropName('dueDate');\n if (dueDateProp && reducedBlock.date_mentions && reducedBlock.date_mentions.length > 0) {\n properties[dueDateProp] = {\n date: {\n start: reducedBlock.date_mentions[0]\n }\n };\n }\n\n // Collect all pageIds that were mapped to relations (for deduplication)\n const mappedPageIds = new Set<string>();\n\n // Apply dynamic relation matches\n if (relationMatches && relationMatches.length > 0) {\n for (const match of relationMatches) {\n // Skip Owner property - it's handled separately above with dedicated resolution logic\n // (prevents fuzzy matching from overwriting heading/AI-determined owner)\n if (ownerProp && match.propertyName === ownerProp) {\n continue;\n }\n\n properties[match.propertyName] = {\n relation: match.pageIds.map(id => ({ id }))\n };\n // Track which pageIds were mapped to relations\n match.pageIds.forEach(id => mappedPageIds.add(id));\n }\n }\n\n // Links (rich_text) - only include mentions NOT mapped to relations\n const linksProp = getPropName('links');\n if (linksProp && reducedBlock.link_mentions && reducedBlock.link_mentions.length > 0) {\n // Filter out mentions that were mapped to relations\n const unmappedMentions = reducedBlock.link_mentions.filter(\n (lm: any) => !lm.pageId || !mappedPageIds.has(lm.pageId)\n );\n\n if (unmappedMentions.length > 0) {\n properties[linksProp] = {\n rich_text: unmappedMentions.flatMap((link: any, index: number) => {\n const parts = [];\n\n // Add bullet before each link\n parts.push({ type: \"text\", text: { content: \"• \" } });\n\n // Add the link\n parts.push({\n type: \"text\",\n text: {\n content: link.text,\n link: { url: link.url }\n }\n });\n\n // Add newline after each link except the last\n if (index < unmappedMentions.length - 1) {\n parts.push({ type: \"text\", text: { content: \"\\n\" } });\n }\n\n return parts;\n })\n };\n }\n }\n\n // Status - sync checkbox state to status property\n // When checked: set to \"Done\" (or equivalent)\n // When unchecked: set to first non-done option (e.g., \"Not started\")\n // This ensures unchecking a todo properly reverts the status\n const statusProp = getPropName('status');\n if (statusProp && statusInfo && reducedBlock.checked !== undefined) {\n if (statusInfo.type === 'checkbox') {\n properties[statusProp] = {\n checkbox: reducedBlock.checked\n };\n } else if (statusInfo.type === 'status' || statusInfo.type === 'select') {\n if (reducedBlock.checked && statusInfo.doneName) {\n // Checked → set to \"Done\"\n properties[statusProp] = {\n [statusInfo.type]: { name: statusInfo.doneName }\n };\n } else if (!reducedBlock.checked && statusInfo.notDoneName) {\n // Unchecked → set to first non-done option (e.g., \"Not started\")\n properties[statusProp] = {\n [statusInfo.type]: { name: statusInfo.notDoneName }\n };\n }\n }\n }\n\n return properties;\n}\n\n/**\n * Extract Notion page ID from a URL\n *\n * Handles various Notion URL formats:\n * - https://www.notion.so/2393adc4305780f9b923d904dfacb88c (32 chars, no hyphens)\n * - https://www.notion.so/2393adc4-3057-80f9-b923-d904dfacb88c (36 chars, with hyphens)\n * - https://www.notion.so/workspace/Page-Name-2393adc4305780f9b923d904dfacb88c\n *\n * @param url - Notion page URL\n * @returns Normalized page ID (32 chars, no hyphens) or null if invalid\n */\nexport function extractPageIdFromUrl(url: string): string | null {\n if (!url || typeof url !== 'string') {\n return null;\n }\n\n try {\n // Parse URL to get pathname\n const urlObj = new URL(url);\n const pathname = urlObj.pathname;\n\n // Extract the last segment (which should contain the page ID)\n const segments = pathname.split('/').filter(s => s.length > 0);\n const lastSegment = segments[segments.length - 1];\n\n if (!lastSegment) {\n return null;\n }\n\n // Page ID can be:\n // 1. At the end: \"Page-Name-2393adc4305780f9b923d904dfacb88c\"\n // 2. The entire segment: \"2393adc4305780f9b923d904dfacb88c\"\n // 3. With hyphens: \"2393adc4-3057-80f9-b923-d904dfacb88c\"\n\n // Try to extract 32 or 36 character UUID-like pattern at the end\n const uuidPattern32 = /([a-f0-9]{32})$/i; // 32 chars without hyphens\n const uuidPattern36 = /([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$/i; // 36 chars with hyphens\n\n // Try 36-char pattern first (with hyphens)\n let match = lastSegment.match(uuidPattern36);\n if (match) {\n // Remove hyphens to normalize\n return match[1].replace(/-/g, '');\n }\n\n // Try 32-char pattern (no hyphens)\n match = lastSegment.match(uuidPattern32);\n if (match) {\n return match[1];\n }\n\n return null;\n\n } catch (err) {\n // Invalid URL format\n return null;\n }\n}\n",[],[210,410,429],"a943d8a2-f613-11f0-b05a-42dde27851f2","notionConfig.ts","67402628-eb09-11f0-9d1c-42dde27851f2",["D",1768922475258],"/**\n * PROPERTY CONFIGURATION - Single Source of Truth\n *\n * To add a new property:\n * 1. Add default name to TODOS_DEFAULTS below\n * 2. Add metadata to PROPERTY_METADATA below\n * 3. Done - types flow through API to frontend automatically\n *\n * To override a property name: Set env var TODOS_PROP_{KEY}=column name\n * To disable a property: Set env var TODOS_PROP_{KEY}= (empty string)\n *\n * Examples: TODOS_PROP_DUE_DATE=Deadline, TODOS_PROP_STATUS=\n */\n\nimport type { PropertyMetadata } from '../../shared/types.ts';\n\n// Get all env vars once at module load (avoids Val Town warning spam)\nconst ENV = Deno.env.toObject();\n\nconst TODOS_DEFAULTS = {\n name: \"Name\",\n sourceBlockId: \"Source block ID\",\n sourceBlockUrl: \"Source block URL\",\n sourcePageUrl: \"Source page URL\",\n sourceLastEditedTime: \"Source last edited time\",\n sourceAuthor: \"Source author\",\n owner: \"Owner\",\n otherPeople: \"Other people\",\n dueDate: \"Due date\",\n links: \"Links\",\n sourceText: \"Source text\",\n projects: null as string | null, // disabled by default - set TODOS_PROP_PROJECTS to enable\n status: null as string | null, // disabled by default - set TODOS_PROP_STATUS to sync checkbox state\n};\n\n/**\n * Property metadata - declarative configuration for health check\n * Adjust category/required/autodiscoverable flags here to change behavior\n *\n * Categories:\n * - core: Essential todo properties (name, dueDate, status, owner)\n * - system: Infrastructure properties (blockId, urls, timestamps)\n * - enrichment: Additional context (author, links, source, projects)\n */\nexport const PROPERTY_METADATA: Record<keyof typeof TODOS_DEFAULTS, PropertyMetadata> = {\n // === CORE: What makes a todo ===\n name: {\n displayName: \"Name\",\n purpose: \"What the todo says. May be cleaned up by AI if OpenAI is configured.\",\n category: \"core\",\n required: true,\n autodiscoverable: true,\n expectedTypes: [\"title\"]\n },\n dueDate: {\n displayName: \"Due date\",\n purpose: \"Due date extracted from @date mentions in the source block that follow 'due' or 'by'.\",\n category: \"core\",\n required: false,\n autodiscoverable: true,\n expectedTypes: [\"date\"],\n namePatterns: [\"due\", \"due date\", \"deadline\", \"when\"]\n },\n status: {\n displayName: \"Status\",\n purpose: \"Tracks completion status. When the source checkbox is checked, this property is updated to reflect it.\",\n category: \"core\",\n required: false,\n autodiscoverable: true,\n expectedTypes: [\"status\", \"select\", \"checkbox\"]\n },\n owner: {\n displayName: \"Owner\",\n purpose: \"The person responsible for this todo, derived from AI analysis or heading context in the source page.\",\n category: \"core\",\n required: false,\n autodiscoverable: true,\n expectedTypes: [\"people\", \"relation\"],\n namePatterns: [\"owner\", \"assigned\", \"assigned to\", \"assignee\", \"dri\"]\n },\n\n // === SYSTEM: Infrastructure ===\n sourceBlockId: {\n displayName: \"Source block ID\",\n purpose: \"Unique identifier of the source block. Used to detect duplicates and link back to the original todo.\",\n category: \"system\",\n required: true,\n autodiscoverable: true,\n expectedTypes: [\"rich_text\"],\n namePatterns: [\"block id\", \"block_id\", \"blockid\", \"source block\"]\n },\n sourceBlockUrl: {\n displayName: \"Source block URL\",\n purpose: \"Direct link to the source block in Notion for quick navigation.\",\n category: \"system\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"url\"]\n },\n sourcePageUrl: {\n displayName: \"Source page URL\",\n purpose: \"Link to the page containing the source block.\",\n category: \"system\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"url\"]\n },\n sourceLastEditedTime: {\n displayName: \"Source last edited time\",\n purpose: \"Timestamp of when the source block was last modified. Used to detect changes during sync.\",\n category: \"system\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"date\"]\n },\n\n // === ENRICHMENT: Additional context ===\n sourceAuthor: {\n displayName: \"Source author\",\n purpose: \"The Notion user who created the source block.\",\n category: \"enrichment\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"people\"]\n },\n otherPeople: {\n displayName: \"Other people\",\n purpose: \"People @mentioned in the source block, in order of appearance.\",\n category: \"enrichment\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"people\"]\n },\n links: {\n displayName: \"Links\",\n purpose: \"URLs and page links found in the source block that weren't mapped to relations.\",\n category: \"enrichment\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"rich_text\"]\n },\n sourceText: {\n displayName: \"Source text\",\n purpose: \"The raw text from the source block, preserved separately from the processed title.\",\n category: \"system\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"rich_text\"]\n },\n projects: {\n displayName: \"Projects\",\n purpose: \"Relation to a project, matched by fuzzy-matching page links in the source block.\",\n category: \"enrichment\",\n required: false,\n autodiscoverable: false,\n expectedTypes: [\"relation\"]\n }\n};\n\n/**\n * Required property keys - derived from metadata (single source of truth)\n * These properties must be mapped correctly for sync to work\n */\nexport const REQUIRED_PROPERTY_KEYS = Object.entries(PROPERTY_METADATA)\n .filter(([_, meta]) => meta.required)\n .map(([key]) => key);\n\n/**\n * Category metadata - display info for each property category\n */\nexport const CATEGORY_METADATA: Record<string, { title: string; description: string }> = {\n core: {\n title: 'Core',\n description: 'Essential todo properties that define what a todo is'\n },\n system: {\n title: 'System',\n description: 'Infrastructure properties for sync and deduplication'\n },\n enrichment: {\n title: 'Enrichment',\n description: 'Additional context and metadata'\n }\n};\n\n// Fuzzy match relations - handled separately (not a property mapping)\n// Set TODOS_FUZZY_MATCH_RELATIONS to a comma-separated list of relation property names\nfunction getFuzzyMatchRelations(): string[] {\n const val = ENV[\"TODOS_FUZZY_MATCH_RELATIONS\"];\n if (val === undefined || val === \"\") return [];\n return val.split(\",\").map((s) => s.trim()).filter(Boolean);\n}\n\nconst PROJECTS_DEFAULTS = {\n groupBy: \"Clients\",\n dateStart: \"Dates\",\n dateEnd: \"Dates\",\n};\n\n// camelCase → SCREAMING_SNAKE_CASE\nconst toScreamingSnake = (s: string) => s.replace(/([a-z])([A-Z])/g, \"$1_$2\").toUpperCase();\n\n// Get env var, checking exact key first, then SCREAMING_SNAKE_CASE\nfunction getEnv(prefix: string, key: string): string | undefined {\n // Try exact key first: TODOS_PROP_name\n const exactKey = `${prefix}_${key}`;\n if (exactKey in ENV) return ENV[exactKey];\n\n // Try screaming snake: TODOS_PROP_NAME\n const screamingKey = `${prefix}_${toScreamingSnake(key)}`;\n if (screamingKey in ENV) return ENV[screamingKey];\n\n return undefined;\n}\n\n// Build config from defaults + env overrides\nfunction buildConfig<T extends Record<string, string | string[] | null>>(\n prefix: string,\n defaults: T,\n): { [K in keyof T]: T[K] extends string[] ? string[] : string | null } {\n return Object.fromEntries(\n Object.entries(defaults).map(([key, defaultVal]) => {\n const val = getEnv(prefix, key);\n\n if (Array.isArray(defaultVal)) {\n if (val === undefined) return [key, defaultVal];\n if (val === \"\") return [key, []];\n return [key, val.split(\",\").map((s) => s.trim()).filter(Boolean)];\n }\n\n if (val === undefined) return [key, defaultVal]; // keeps null if default is null\n if (val === \"\") return [key, null];\n return [key, val];\n }),\n ) as any;\n}\n\nconst _todosBase = buildConfig(\"TODOS_PROP\", TODOS_DEFAULTS);\nexport const TODOS_PROPERTIES = {\n ..._todosBase,\n fuzzyMatch: getFuzzyMatchRelations(), // from TODOS_FUZZY_MATCH_RELATIONS env var\n};\nexport const PROJECTS_PROPERTIES = buildConfig(\"PROJECTS_PROP\", PROJECTS_DEFAULTS);\n\n/**\n * Get the env var name for a property key\n * Returns the screaming snake case version (e.g., \"dueDate\" → \"TODOS_PROP_DUE_DATE\")\n */\nexport function getEnvVarName(key: string): string {\n return `TODOS_PROP_${toScreamingSnake(key)}`;\n}\n\n/**\n * Get the current env var value for a property key (if set)\n */\nexport function getEnvVarValue(key: string): string | null {\n const val = getEnv(\"TODOS_PROP\", key);\n return val === undefined ? null : val;\n}\n\n/**\n * Get the default property name for a key\n */\nexport function getDefaultPropertyName(key: string): string | null {\n return (TODOS_DEFAULTS as Record<string, string | null>)[key] ?? null;\n}\n\n/**\n * Get all property keys (for iteration)\n */\nexport function getPropertyKeys(): string[] {\n return Object.keys(TODOS_DEFAULTS);\n}\n",[],[210,410,438],"a9400ce0-f613-11f0-b05a-42dde27851f2","logger.ts","a9400e02-f613-11f0-b05a-42dde27851f2",["D",1768922475258],"/**\n * Simple logger with configurable log levels\n *\n * Set LOG_LEVEL env var to control verbosity:\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\ntype LogLevel = 'error' | 'warn' | 'info' | 'debug';\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n error: 0,\n warn: 1,\n info: 2,\n debug: 3\n};\n\nfunction getLogLevel(): LogLevel {\n const level = (Deno.env.get('LOG_LEVEL') || 'info').toLowerCase();\n if (level in LOG_LEVELS) {\n return level as LogLevel;\n }\n return 'info';\n}\n\nfunction shouldLog(level: LogLevel): boolean {\n const currentLevel = getLogLevel();\n return LOG_LEVELS[level] <= LOG_LEVELS[currentLevel];\n}\n\nexport const logger = {\n error: (...args: any[]) => {\n if (shouldLog('error')) console.error(...args);\n },\n warn: (...args: any[]) => {\n if (shouldLog('warn')) console.warn(...args);\n },\n info: (...args: any[]) => {\n if (shouldLog('info')) console.log(...args);\n },\n debug: (...args: any[]) => {\n if (shouldLog('debug')) console.log(...args);\n }\n};\n",[],[210,410,445],"1582a266-b459-11f0-a09c-0224a6c84d84","emojiUtils.ts","1582a2fc-b459-11f0-a09c-0224a6c84d84",16,["D",1761695515418],"/**\n * Emoji utility functions for extracting and detecting emojis\n */\n\n/**\n * Extract the first emoji from a text string\n *\n * @param text - Text to search for emoji\n * @returns First emoji character or null if none found\n *\n * @example\n * extractFirstEmoji(\"📝 Write documentation\") // Returns \"📝\"\n * extractFirstEmoji(\"No emoji here\") // Returns null\n */\nexport function extractFirstEmoji(text: string): string | null {\n if (!text) return null;\n\n // Comprehensive emoji regex pattern covering most common emoji ranges\n const emojiRegex = /[\\u{1F300}-\\u{1F9FF}\\u{2600}-\\u{26FF}\\u{2700}-\\u{27BF}\\u{1F000}-\\u{1F02F}\\u{1F0A0}-\\u{1F0FF}\\u{1F100}-\\u{1F64F}\\u{1F680}-\\u{1F6FF}\\u{1F900}-\\u{1F9FF}\\u{1FA00}-\\u{1FA6F}\\u{1FA70}-\\u{1FAFF}]/u;\n\n const match = text.match(emojiRegex);\n return match ? match[0] : null;\n}\n\n/**\n * Check if text contains at least one emoji\n *\n * @param text - Text to check\n * @returns True if emoji found, false otherwise\n */\nexport function hasEmoji(text: string): boolean {\n return extractFirstEmoji(text) !== null;\n}\n",[],[210,410,452],"98409e32-f618-11f0-ba7e-42dde27851f2","dateUtils.ts","b9471dda-b659-11f0-934f-0224a6c84d84",["D",1768924594216],"/**\n * Date utility functions for calculating default due dates\n * Pure functions with no external dependencies\n */\n\n/**\n * Supported default due date settings\n */\nexport type DueDateSetting =\n | 'today'\n | 'tomorrow'\n | 'one_week'\n | 'end_of_week'\n | 'next_business_day';\n\n/**\n * Get default due date setting from environment variable\n *\n * Reads DEFAULT_DUE_DATE env var\n * Falls back to \"today\" if not set or invalid\n *\n * @returns Valid due date setting\n */\nexport function getDefaultDueDateSetting(): DueDateSetting {\n const envSetting = Deno.env.get('DEFAULT_DUE_DATE');\n\n if (!envSetting) {\n return 'today'; // Default fallback\n }\n\n const normalized = envSetting.trim().toLowerCase();\n\n // Validate setting\n const validSettings: DueDateSetting[] = [\n 'today',\n 'tomorrow',\n 'one_week',\n 'end_of_week',\n 'next_business_day'\n ];\n\n if (validSettings.includes(normalized as DueDateSetting)) {\n return normalized as DueDateSetting;\n }\n\n console.warn(`⚠ Invalid DEFAULT_DUE_DATE value: \"${envSetting}\". Using \"today\" as fallback.`);\n return 'today';\n}\n\n/**\n * Calculate due date based on setting\n *\n * Returns ISO date string (YYYY-MM-DD format)\n * All calculations are relative to the reference date (defaults to now)\n *\n * @param setting - Due date setting\n * @param referenceDate - Date to calculate from (defaults to now, use block creation time for deterministic results)\n * @returns ISO date string (e.g., \"2025-10-31\")\n */\nexport function calculateDueDate(setting: DueDateSetting, referenceDate?: Date): string {\n const now = referenceDate || new Date();\n let targetDate = new Date(now);\n\n switch (setting) {\n case 'today':\n // Already set to today\n break;\n\n case 'tomorrow':\n targetDate.setDate(targetDate.getDate() + 1);\n break;\n\n case 'one_week':\n targetDate.setDate(targetDate.getDate() + 7);\n break;\n\n case 'end_of_week':\n // Next Friday\n const currentDay = targetDate.getDay(); // 0 = Sunday, 5 = Friday\n let daysUntilFriday = (5 - currentDay + 7) % 7;\n\n // If today is Friday, go to next Friday\n if (daysUntilFriday === 0) {\n daysUntilFriday = 7;\n }\n\n targetDate.setDate(targetDate.getDate() + daysUntilFriday);\n break;\n\n case 'next_business_day':\n // Skip weekends (Saturday = 6, Sunday = 0)\n targetDate.setDate(targetDate.getDate() + 1); // Start with tomorrow\n\n while (targetDate.getDay() === 0 || targetDate.getDay() === 6) {\n targetDate.setDate(targetDate.getDate() + 1);\n }\n break;\n\n default:\n // Fallback to today for any unexpected values\n console.warn(`⚠ Unexpected due date setting: \"${setting}\". Using today.`);\n }\n\n // Format as ISO date string (YYYY-MM-DD)\n return toISODateString(targetDate);\n}\n\n/**\n * Convert Date object to ISO date string (YYYY-MM-DD)\n *\n * @param date - Date object\n * @returns ISO date string\n */\nfunction toISODateString(date: Date): string {\n const year = date.getFullYear();\n const month = String(date.getMonth() + 1).padStart(2, '0');\n const day = String(date.getDate()).padStart(2, '0');\n\n return `${year}-${month}-${day}`;\n}\n",[],[210,410,460],"f6ec00ce-ebd3-11f0-955f-42dde27851f2","contextUtils.ts","f6ec0178-ebd3-11f0-955f-42dde27851f2",254,["D",1767795606157],"/**\n * Context Gathering Utilities\n *\n * This module centralizes all context-gathering logic for todo assignment.\n * It provides a single place to understand what context is used and how.\n *\n * ## Context Sources (in priority order)\n *\n * ### 1. Block-Level (Inherent Metadata)\n * Extracted directly from the Notion block at search time:\n * - `todo_string` - The block's text content\n * - `people_mentions` - @mentions in the block (have user IDs)\n * - `date_mentions` - Dates prefixed by \"due\" or \"by\"\n * - `link_mentions` - Page links in the block\n * - `author` - Block's created_by user (who wrote it)\n *\n * ### 2. Surrounding Context (Captured at Search Time)\n * Context from the block's environment, captured without extra API calls:\n * - `preceding_heading` - Most recent h1/h2/h3 seen while scanning the page\n * - `parent_id` - Parent block ID (for traversal at sync time)\n * - `source_page_database_id` - Which database the source page belongs to\n * - `page_url` - URL of the page containing the todo\n *\n * ### 3. Parent Traversal (At Sync Time)\n * When block-level context is insufficient, we crawl up the block tree:\n * - Check parent blocks for @mentions, page links, names\n * - Up to 5 levels of parents\n * - Used for: project matching, fuzzy contact matching, owner candidates\n *\n * ### 4. AI Involvement\n * AI is used sparingly and only when deterministic methods fail:\n * - Project matching: Semantic similarity between todo and project names\n * - Disambiguation: When multiple candidates match (contacts, projects)\n * - Summary generation: Polishing todo text (owner extracted but validated)\n *\n * ## Owner Resolution Flow\n *\n * ```\n * 1. Pre-check: Does heading match someone in owner database?\n * → YES: Use heading match (deterministic, most reliable)\n * → NO: Continue...\n *\n * 2. Are there ANY owner candidates?\n * - Heading matched? (from step 1)\n * - Contacts matched via fuzzy matching?\n * - @mentions in block?\n * → NO candidates: Owner = null (prevents AI hallucination)\n * → YES: Continue...\n *\n * 3. AI generates summary and suggests owner\n * → If AI claims \"heading\" source: Validate name appears in heading\n * → If validation fails: Reject, owner = null\n * → If validation passes: Resolve to user/page ID\n * ```\n */\n\nimport type { ReducedNotionBlock, ResolvedOwner } from '../../shared/types.ts';\nimport * as notionService from '../services/notion/index.ts';\nimport { reduceNotionBlock } from './notionUtils.ts';\n\n/**\n * Owner candidate sources - used to track where candidates came from\n */\nexport type OwnerSource = 'heading' | 'contact' | 'mention' | 'parent';\n\n/**\n * Owner candidate with source tracking\n */\nexport interface OwnerCandidate {\n name: string;\n source: OwnerSource;\n id?: string; // User ID if from @mention, page ID if from contact\n}\n\n/**\n * Result of gathering owner candidates\n */\nexport interface OwnerCandidatesResult {\n candidates: OwnerCandidate[];\n headingMatch: { resolved: ResolvedOwner; name: string } | null;\n hasAnyCandidates: boolean;\n}\n\n/**\n * Page name entry for fuzzy matching (re-exported for convenience)\n */\nexport interface PageNameEntry {\n id: string;\n name: string;\n nameLower: string;\n}\n\n/**\n * Check if a heading matches a name in the owner database\n *\n * @param heading - The heading text (e.g., \"### Alex\")\n * @param ownerNames - Array of page names from owner database\n * @returns Matching entry or null\n */\nexport function matchHeadingToOwnerName(\n heading: string | null,\n ownerNames: PageNameEntry[]\n): PageNameEntry | null {\n if (!heading || ownerNames.length === 0) {\n return null;\n }\n\n // Clean heading (remove markdown markers)\n const cleanHeading = heading.replace(/^#+\\s*/, '').trim().toLowerCase();\n if (!cleanHeading) {\n return null;\n }\n\n for (const entry of ownerNames) {\n // Exact match\n if (entry.nameLower === cleanHeading) {\n return entry;\n }\n // First name match (heading \"Alex\" matches \"Alex Johnson\")\n const entryFirstName = entry.nameLower.split(/\\s+/)[0];\n if (entryFirstName === cleanHeading) {\n return entry;\n }\n }\n\n return null;\n}\n\n/**\n * Gather all owner candidates from a block and its context\n *\n * Sources checked (in priority order):\n * 1. Preceding heading - if it contains a name matching owner database\n * 2. Matched contacts - from fuzzy name matching\n * 3. @mentions - people mentioned in the block\n * 4. Parent blocks - @mentions or headings in parent blocks (if no candidates found)\n *\n * @param block - The reduced block data\n * @param matchedContactNames - Contact names from fuzzy matching\n * @param ownerNames - Page names from owner database (for heading matching)\n * @returns Owner candidates with source tracking\n */\nexport function gatherOwnerCandidates(\n block: ReducedNotionBlock,\n matchedContactNames: string[],\n ownerNames: PageNameEntry[]\n): { candidates: OwnerCandidate[]; headingMatch: PageNameEntry | null } {\n const candidates: OwnerCandidate[] = [];\n\n // 1. Check heading against owner database\n const headingMatch = matchHeadingToOwnerName(block.preceding_heading || null, ownerNames);\n if (headingMatch) {\n candidates.push({\n name: headingMatch.name,\n source: 'heading',\n id: headingMatch.id\n });\n }\n\n // 2. Add matched contacts\n for (const contactName of matchedContactNames) {\n candidates.push({\n name: contactName,\n source: 'contact'\n });\n }\n\n // 3. Add @mentions\n if (block.people_mentions && block.people_mentions.length > 0) {\n for (const mention of block.people_mentions) {\n if (mention.name) {\n candidates.push({\n name: mention.name,\n source: 'mention',\n id: mention.id\n });\n }\n }\n }\n\n return { candidates, headingMatch };\n}\n\n/**\n * Traverse parent blocks to find additional owner candidates\n *\n * Called when the block itself has no owner candidates.\n * Checks parent blocks for @mentions or headings.\n *\n * @param startParentId - Starting parent block ID\n * @param ownerNames - Page names from owner database (for heading matching)\n * @returns Additional owner candidates from parents\n */\nexport async function traverseParentsForOwnerCandidates(\n startParentId: string,\n ownerNames: PageNameEntry[]\n): Promise<OwnerCandidate[]> {\n const candidates: OwnerCandidate[] = [];\n let currentParentId: string | null = startParentId;\n const maxDepth = 5;\n\n for (let depth = 0; depth < maxDepth && currentParentId; depth++) {\n const parentResult = await notionService.getBlock(currentParentId);\n if (!parentResult.success || !parentResult.data) {\n break;\n }\n\n const parentBlock = parentResult.data;\n const parentReduced = reduceNotionBlock(parentBlock);\n\n // Check for @mentions in parent\n if (parentReduced.people_mentions && parentReduced.people_mentions.length > 0) {\n for (const mention of parentReduced.people_mentions) {\n if (mention.name) {\n candidates.push({\n name: mention.name,\n source: 'parent',\n id: mention.id\n });\n }\n }\n // Found mentions in parent - return these\n if (candidates.length > 0) {\n return candidates;\n }\n }\n\n // Check if parent block is a heading that matches owner database\n const parentType = (parentBlock as any).type;\n if (parentType === 'heading_1' || parentType === 'heading_2' || parentType === 'heading_3') {\n const headingMatch = matchHeadingToOwnerName(parentReduced.todo_string, ownerNames);\n if (headingMatch) {\n candidates.push({\n name: headingMatch.name,\n source: 'parent',\n id: headingMatch.id\n });\n return candidates;\n }\n }\n\n // Move up to next parent\n const parentParent = (parentBlock as any).parent;\n currentParentId = parentParent?.type === 'block_id' ? parentParent.block_id : null;\n }\n\n return candidates;\n}\n\n/**\n * Validate that an AI-claimed owner source matches reality\n *\n * Prevents AI hallucination by verifying claimed sources:\n * - \"heading\" → name must appear in heading\n * - \"contact\" → name must be in matched contacts\n * - \"mention\" → name must be in @mentions\n *\n * @param ownerName - Name claimed by AI\n * @param ownerSource - Source claimed by AI\n * @param heading - Actual heading text\n * @param matchedContacts - Actual matched contact names\n * @param peopleMentions - Actual @mentions\n * @returns true if claim is valid, false if AI hallucinated\n */\nexport function validateOwnerClaim(\n ownerName: string,\n ownerSource: 'heading' | 'contact' | 'mention' | null,\n heading: string | null,\n matchedContacts: string[],\n peopleMentions: Array<{ name: string }>\n): boolean {\n if (!ownerSource || !ownerName) {\n return false;\n }\n\n const ownerNameLower = ownerName.toLowerCase();\n\n switch (ownerSource) {\n case 'heading': {\n if (!heading) return false;\n const cleanHeading = heading.replace(/^#+\\s*/, '').trim().toLowerCase();\n const headingWords = cleanHeading.split(/\\s+/);\n const ownerWords = ownerNameLower.split(/\\s+/);\n // Any word overlap counts as valid\n return ownerWords.some(ow =>\n headingWords.some(hw => hw === ow || hw.startsWith(ow) || ow.startsWith(hw))\n );\n }\n\n case 'contact': {\n return matchedContacts.some(c =>\n c.toLowerCase().includes(ownerNameLower) ||\n ownerNameLower.includes(c.toLowerCase())\n );\n }\n\n case 'mention': {\n return peopleMentions.some(m =>\n m.name && (\n m.name.toLowerCase().includes(ownerNameLower) ||\n ownerNameLower.includes(m.name.toLowerCase())\n )\n );\n }\n\n default:\n return false;\n }\n}\n",[],[210,410,467],"43d0f5e2-b962-11f0-8efb-0224a6c84d84","configUtils.ts","43d0f650-b962-11f0-8efb-0224a6c84d84",["D",1762249214392],"/**\n * Configuration utility functions\n * Read and validate environment variables with sensible defaults\n */\n\n/**\n * Get recent pages lookback window from environment variable\n *\n * Reads RECENT_PAGES_LOOKBACK_HOURS env var to determine how far back\n * to search for recent Notion pages.\n *\n * Used by:\n * - Frontend dashboard initial load\n * - /api/pages/recent endpoint\n * - /tasks/todos batch processing\n * - Cron jobs (todoSearch.cron.ts)\n *\n * @returns Number of hours to look back (positive integer)\n * - Default: 24 if not set or invalid\n * - Must be positive integer\n */\nexport function getRecentPagesLookbackHours(): number {\n const envValue = Deno.env.get('RECENT_PAGES_LOOKBACK_HOURS');\n\n // If not set, return default of 24 hours\n if (envValue === undefined || envValue === null || envValue === '') {\n return 24;\n }\n\n // Parse as integer\n const parsed = parseInt(envValue, 10);\n\n // If invalid, return default\n if (isNaN(parsed) || parsed <= 0) {\n console.warn(`⚠ Invalid RECENT_PAGES_LOOKBACK_HOURS value \"${envValue}\", using default of 24 hours`);\n return 24;\n }\n\n return parsed;\n}\n",[],[210,410,475],"5c0f8d2e-cdf5-11f0-a2c0-42dde27851f2","blockUtils.ts","35489a72-b8ac-11f0-a94f-0224a6c84d84",142,["D",1764511414357],"/**\n * Block stability utilities\n *\n * Provides functions to check if blocks are \"stable\" (not recently edited)\n * Used to prevent saving blocks that are actively being edited to blob storage\n */\n\n/**\n * Get block stability threshold from environment variable\n *\n * Reads BLOCK_STABILITY_MINUTES env var to determine minimum age\n * before a block is considered stable enough to save to blob storage.\n *\n * @returns Number of minutes (0 or positive integer)\n * - Default: 0 if not set (no delay - immediate sync)\n * - Set env var to add a delay (e.g., \"2\" for 2 minutes)\n */\nexport function getBlockStabilityMinutes(): number {\n const envValue = Deno.env.get('BLOCK_STABILITY_MINUTES');\n\n // If not set, return default of 0 (no delay)\n if (envValue === undefined || envValue === null || envValue === '') {\n return 0;\n }\n\n // Parse as integer\n const parsed = parseInt(envValue, 10);\n\n // If invalid, return default\n if (isNaN(parsed) || parsed < 0) {\n console.warn(`⚠ Invalid BLOCK_STABILITY_MINUTES value \"${envValue}\", using default of 0 (no delay)`);\n return 0;\n }\n\n return parsed;\n}\n\n/**\n * Calculate the age of a block in minutes\n *\n * @param lastEditedTime - ISO 8601 timestamp string from Notion\n * @returns Number of minutes since the block was last edited\n */\nexport function getBlockAgeMinutes(lastEditedTime: string): number {\n const lastEditedDate = new Date(lastEditedTime);\n const now = Date.now();\n const ageMs = now - lastEditedDate.getTime();\n const ageMinutes = ageMs / (1000 * 60);\n\n return ageMinutes;\n}\n\n/**\n * Check if a block is \"stable\" (old enough to save)\n *\n * A block is considered stable if:\n * - stabilityMinutes is 0 (delay disabled), OR\n * - Block age >= stabilityMinutes\n *\n * @param lastEditedTime - ISO 8601 timestamp string from Notion\n * @param stabilityMinutes - Minimum age threshold in minutes\n * @returns true if block is stable, false if too recent\n */\nexport function isBlockStable(lastEditedTime: string, stabilityMinutes: number): boolean {\n // If stability check is disabled (0 minutes), always return true\n if (stabilityMinutes === 0) {\n return true;\n }\n\n // Calculate block age\n const ageMinutes = getBlockAgeMinutes(lastEditedTime);\n\n // Block is stable if age meets or exceeds threshold\n return ageMinutes >= stabilityMinutes;\n}\n\n/**\n * Valid Notion background colors\n */\nconst VALID_BACKGROUND_COLORS = new Set([\n 'gray_background',\n 'brown_background',\n 'orange_background',\n 'yellow_background',\n 'green_background',\n 'blue_background',\n 'purple_background',\n 'pink_background',\n 'red_background'\n]);\n\n/**\n * Get block background color from environment variable\n *\n * When set to a valid Notion background color, matched todo blocks\n * will have their background color changed in Notion as a visual indicator.\n *\n * @returns The background color if valid, null otherwise\n */\nexport function getBlockBackgroundColor(): string | null {\n const color = Deno.env.get('BLOCK_BACKGROUND_COLOR')?.toLowerCase();\n if (color && VALID_BACKGROUND_COLORS.has(color)) {\n return color;\n }\n return null;\n}\n",[],[210,410,482],"1582a054-b459-11f0-a09c-0224a6c84d84","blobUtils.ts","1582a0ea-b459-11f0-a09c-0224a6c84d84",["D",1761695515418],"/**\n * Blob storage utility functions\n */\n\n/**\n * Extract block ID from blob key\n * Key format: projectName--category--blockId\n *\n * @param key - Blob key string (e.g., \"demo--todo--abc-123-def-456\")\n * @returns Block ID (e.g., \"abc-123-def-456\")\n *\n * @example\n * extractBlockIdFromKey(\"demo--todo--abc-123\") // Returns \"abc-123\"\n */\nexport function extractBlockIdFromKey(key: string): string {\n const parts = key.split('--');\n return parts[parts.length - 1]; // Last part is the block ID\n}\n",[],[210,410,490],"1582acde-b459-11f0-a09c-0224a6c84d84",["D",1761695515418],[269,270,271,272,273,274,275,276,277,278,279,280],[210,410],"fa4ed9f6-b363-11f0-87a0-0224a6c84d84","faviconizerService.ts","b7748178-b361-11f0-b7fc-0224a6c84d84","019a26dc-99bf-7269-a8f6-2bcf04eec442",10,["D",1761590243094],"import type { FaviconizerResponse } from \"../../shared/types.ts\";\n\n/**\n * Get favicon URL for a domain using Faviconizer API\n */\nexport async function getFaviconForDomain(domain: string) {\n try {\n const response = await fetch(\"https://faviconizer.val.run/api/domain\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ domain }),\n });\n\n if (!response.ok) {\n return {\n success: false,\n data: null,\n error: `Faviconizer API returned status ${response.status}`,\n };\n }\n\n const data: FaviconizerResponse = await response.json();\n\n // Check if the API's success field is true\n if (!data.success) {\n return {\n success: false,\n data: null,\n error: \"Faviconizer API returned success: false\",\n };\n }\n\n return {\n success: true,\n data: data,\n error: null,\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || \"Failed to fetch favicon\",\n };\n }\n}\n",[],[210,509,501],"services","cbdbed40-ebfb-11f0-8ce9-42dde27851f2","blobService.ts","15829b9a-b459-11f0-a09c-0224a6c84d84",["D",1767812713786],4,"import { blob } from \"https://esm.town/v/std/blob\";\nimport { getProjectName } from '../utils/valUtils.ts';\n\n/**\n * Save a block to Val Town blob storage\n *\n * @param category - Category of block (e.g., \"todo\", \"mention\", \"date\")\n * @param blockId - Notion block ID\n * @param data - Block data to save (typically ReducedNotionBlock)\n * @returns {success, key, error}\n */\nexport async function saveBlockToBlob(\n category: string,\n blockId: string,\n data: any\n) {\n try {\n // Construct blob key: projectName--category--blockId\n const projectName = getProjectName();\n const key = `${projectName}--${category}--${blockId}`;\n\n // Save to blob storage (overwrites if exists)\n await blob.setJSON(key, data);\n\n return {\n success: true,\n key: key,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n key: null,\n error: err.message || 'Failed to save to blob storage'\n };\n }\n}\n\n/**\n * Get a block from Val Town blob storage\n * (Future implementation)\n */\nexport async function getBlockFromBlob(\n category: string,\n blockId: string\n) {\n try {\n const projectName = getProjectName();\n const key = `${projectName}--${category}--${blockId}`;\n\n const data = await blob.getJSON(key);\n\n return {\n success: true,\n data: data,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to get from blob storage'\n };\n }\n}\n\n/**\n * Delete a block from Val Town blob storage\n * (Future implementation)\n */\nexport async function deleteBlockFromBlob(\n category: string,\n blockId: string\n) {\n try {\n const projectName = getProjectName();\n const key = `${projectName}--${category}--${blockId}`;\n\n await blob.delete(key);\n\n return {\n success: true,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n error: err.message || 'Failed to delete from blob storage'\n };\n }\n}\n\n/**\n * List all blocks in a category from Val Town blob storage\n *\n * @param category - Category of blocks to list (e.g., \"todo\")\n * @returns {success, keys, error}\n */\nexport async function listBlocksByCategory(category: string) {\n try {\n const projectName = getProjectName();\n const prefix = `${projectName}--${category}--`;\n\n // List all blobs with the prefix\n const result = await blob.list(prefix);\n\n // blob.list() returns an array of objects with 'key' property\n // Extract just the keys as strings\n const keys = Array.isArray(result)\n ? result.map((item: any) => typeof item === 'string' ? item : item.key)\n : [];\n\n return {\n success: true,\n keys: keys,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n keys: null,\n error: err.message || 'Failed to list blobs'\n };\n }\n}\n\n/**\n * Update sync metadata for a blob\n *\n * @param key - Full blob key (projectName--category--blockId)\n * @param syncMetadata - Sync metadata to update { synced: boolean, target_page_id?: string }\n * @returns {success, error}\n */\nexport async function updateBlobSyncMetadata(\n key: string,\n syncMetadata: { synced: boolean; target_page_id?: string }\n) {\n try {\n // Read existing blob\n const existingData = await blob.getJSON(key);\n\n if (!existingData) {\n return {\n success: false,\n error: 'Blob not found'\n };\n }\n\n // Update only sync_metadata property\n const updatedData = {\n ...existingData,\n sync_metadata: syncMetadata\n };\n\n // Save back to blob\n await blob.setJSON(key, updatedData);\n\n return {\n success: true,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n error: err.message || 'Failed to update blob sync metadata'\n };\n }\n}\n\n/**\n * Count blobs in a category\n *\n * @param category - Category of blocks to count (e.g., \"todo\")\n * @returns {success, count, prefix, error}\n */\nexport async function countBlobsByCategory(category: string) {\n try {\n const result = await listBlocksByCategory(category);\n\n if (!result.success) {\n return {\n success: false,\n count: 0,\n prefix: null,\n error: result.error\n };\n }\n\n const projectName = getProjectName();\n const prefix = `${projectName}--${category}--`;\n\n return {\n success: true,\n count: result.keys?.length || 0,\n prefix: prefix,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n count: 0,\n prefix: null,\n error: err.message || 'Failed to count blobs'\n };\n }\n}\n",[],[210,509,511],"f6ee4b9a-ebd3-11f0-955f-42dde27851f2","aiService.ts","6f6e36ea-cc7e-11f0-a038-42dde27851f2",["D",1767795606157],17,"/**\n * AI service for fuzzy matching using OpenAI\n *\n * Uses OPENAI_API_KEY env var if set (recommended for production).\n * Falls back to Val Town's shared @std/openai (has 10 req/min limit).\n */\nimport { OpenAI as ValTownOpenAI } from \"https://esm.town/v/std/openai\";\nimport OpenAINpm from \"npm:openai@4\";\nimport type { ProjectWithDates } from '../utils/projectUtils.ts';\nimport type { SummaryResult } from '../../shared/types.ts';\n\n// Use own API key if available, otherwise fall back to Val Town's shared client\nfunction getOpenAIClient() {\n const apiKey = Deno.env.get(\"OPENAI_API_KEY\");\n if (apiKey) {\n return new OpenAINpm({ apiKey });\n }\n // Fall back to Val Town's shared OpenAI (has rate limits)\n return new ValTownOpenAI();\n}\n\n/**\n * Use AI to match a todo to a project based on semantic similarity\n *\n * Returns one of:\n * - A project ID (if confident match to specific project)\n * - \"GROUP:GroupName\" (if matches group but not specific project)\n * - null (no match)\n *\n * @param todoText - The todo text to match\n * @param projects - Array of projects with id, name, and optional groupName\n * @returns Project ID, \"GROUP:name\", or null\n */\nexport async function matchTodoToProject(\n todoText: string,\n projects: Array<{ id: string; name: string; groupName: string | null }>\n): Promise<string | null> {\n if (!todoText || projects.length === 0) {\n return null;\n }\n\n const openai = getOpenAIClient();\n\n const projectList = projects\n .map(p => `- ID: ${p.id} | Project: \"${p.name}\"${p.groupName ? ` | Group: \"${p.groupName}\"` : ''}`)\n .join('\\n');\n\n try {\n const completion = await openai.chat.completions.create({\n model: \"gpt-4o-mini\",\n max_tokens: 100,\n messages: [\n {\n role: \"system\",\n content: `You match todos to projects. Given a todo and a list of projects (with optional group names like client, company, or team):\n- If the todo clearly references a specific PROJECT by name, return that project ID\n- If the todo references a GROUP NAME (client/company/team) but not a specific project, return \"GROUP:GroupName\" (exact group name from the list)\n- If no match, return \"NONE\"\nBe conservative - only match if confident.`\n },\n {\n role: \"user\",\n content: `Todo: \"${todoText}\"\\n\\nProjects:\\n${projectList}\\n\\nReturn the project ID, GROUP:name, or NONE:`\n }\n ]\n });\n\n let response = completion.choices[0]?.message?.content?.trim();\n\n if (!response || response === \"NONE\" || response.toUpperCase() === \"NONE\") {\n return null;\n }\n\n // Strip common prefixes the AI might add\n if (response.startsWith('ID: ')) {\n response = response.substring(4);\n }\n\n // Check if it's a group match\n if (response.startsWith('GROUP:')) {\n const groupName = response.substring(6);\n // Validate that this group exists in our projects (case-insensitive)\n const matchingGroup = projects.find(p =>\n p.groupName && p.groupName.toLowerCase() === groupName.toLowerCase()\n );\n if (matchingGroup) {\n // Return with the exact group name from the database\n return `GROUP:${matchingGroup.groupName}`;\n }\n return null;\n }\n\n // Validate response is a known project ID\n const matchedProject = projects.find(p => p.id === response);\n return matchedProject ? response : null;\n\n } catch (err: any) {\n console.error('AI matching error:', err.message);\n return null;\n }\n}\n\n/**\n * Use AI to pick the best project from candidates with overlapping date ranges\n *\n * Called when multiple projects' date ranges contain the todo's due date.\n * AI decides based on semantic similarity between todo text and project names.\n *\n * @param todoText - The todo text to match\n * @param candidates - Array of projects with overlapping date ranges\n * @returns Best matching project ID, or first candidate as fallback\n */\nexport async function disambiguateOverlappingProjects(\n todoText: string,\n candidates: ProjectWithDates[]\n): Promise<string> {\n if (candidates.length === 0) {\n throw new Error('No candidates provided for disambiguation');\n }\n\n if (candidates.length === 1) {\n return candidates[0].id;\n }\n\n const openai = getOpenAIClient();\n\n const projectList = candidates\n .map(p => `- ID: ${p.id} | Project: \"${p.name || 'Untitled'}\"`)\n .join('\\n');\n\n try {\n const completion = await openai.chat.completions.create({\n model: \"gpt-4o-mini\",\n max_tokens: 100,\n messages: [\n {\n role: \"system\",\n content: `Given a todo and candidate projects with overlapping date ranges, pick the best semantic match based on the todo text and project names. Return ONLY the project ID, nothing else.`\n },\n {\n role: \"user\",\n content: `Todo: \"${todoText}\"\\n\\nProjects:\\n${projectList}\\n\\nReturn the best matching project ID:`\n }\n ]\n });\n\n let response = completion.choices[0]?.message?.content?.trim();\n\n // Strip common prefixes\n if (response?.startsWith('ID: ')) {\n response = response.substring(4);\n }\n\n // Validate response is a known candidate ID\n const matchedCandidate = candidates.find(p => p.id === response);\n if (matchedCandidate) {\n return matchedCandidate.id;\n }\n\n // Fallback to first candidate if AI response is invalid\n return candidates[0].id;\n\n } catch (err: any) {\n console.error('AI disambiguation error:', err.message);\n // Fallback to first candidate on error\n return candidates[0].id;\n }\n}\n\n/**\n * Use AI to pick the best match from multiple fuzzy name matches\n *\n * Called when multiple pages' names match text in the todo or parent blocks.\n * AI decides based on semantic similarity between todo text and page names.\n *\n * @param todoText - The todo text for context\n * @param candidates - Array of matching pages with id and name\n * @returns Best matching page ID, or null if no confident match\n */\nexport async function disambiguateFuzzyMatch(\n todoText: string,\n candidates: Array<{ id: string; name: string }>\n): Promise<string | null> {\n if (candidates.length === 0) {\n return null;\n }\n\n if (candidates.length === 1) {\n return candidates[0].id;\n }\n\n const openai = getOpenAIClient();\n\n const candidateList = candidates\n .map(p => `- ID: ${p.id} | Name: \"${p.name}\"`)\n .join('\\n');\n\n try {\n const completion = await openai.chat.completions.create({\n model: \"gpt-4o-mini\",\n max_tokens: 100,\n messages: [\n {\n role: \"system\",\n content: `Given a todo and candidate names that partially matched, pick the best match based on context. Return ONLY the ID of the best match, or \"NONE\" if no candidate is clearly the right match.`\n },\n {\n role: \"user\",\n content: `Todo: \"${todoText}\"\\n\\nCandidates:\\n${candidateList}\\n\\nReturn the best matching ID or NONE:`\n }\n ]\n });\n\n let response = completion.choices[0]?.message?.content?.trim();\n\n if (!response || response === \"NONE\" || response.toUpperCase() === \"NONE\") {\n return null;\n }\n\n // Strip common prefixes\n if (response.startsWith('ID: ')) {\n response = response.substring(4);\n }\n\n // Validate response is a known candidate ID\n const matchedCandidate = candidates.find(p => p.id === response);\n return matchedCandidate ? matchedCandidate.id : null;\n\n } catch (err: any) {\n console.error('AI fuzzy disambiguation error:', err.message);\n return null;\n }\n}\n\n/**\n * Context for generating AI-interpreted todo summary\n */\nexport interface SummaryContext {\n todoString: string;\n precedingHeading: string | null;\n peopleMentions: Array<{ name: string | null }>;\n dateMentions: string[];\n matchedProject: string | null;\n matchedContacts: string[]; // All matched contact names (supports multiple)\n sourcePage: string | null;\n}\n\n/**\n * Generate an AI-interpreted, polished version of a todo\n *\n * Takes all raw data and metadata, then synthesizes a clear, standalone\n * todo statement that resolves ambiguities about owner, due date, and context.\n * Also extracts the owner name and source for downstream processing.\n *\n * @param context - All available context about the todo\n * @returns Structured result with summary, ownerName, and ownerSource\n */\nexport async function generateSummary(context: SummaryContext): Promise<SummaryResult> {\n const openai = getOpenAIClient();\n\n // Build context sections for the prompt\n const sections: string[] = [];\n\n sections.push(`Raw todo: \"${context.todoString}\"`);\n\n if (context.precedingHeading) {\n sections.push(`Preceding heading: \"${context.precedingHeading}\"`);\n }\n\n if (context.peopleMentions.length > 0) {\n const names = context.peopleMentions\n .map(p => p.name)\n .filter(Boolean)\n .join(', ');\n if (names) {\n sections.push(`People @mentioned: ${names}`);\n }\n }\n\n if (context.dateMentions.length > 0) {\n sections.push(`Dates mentioned: ${context.dateMentions.join(', ')}`);\n }\n\n if (context.matchedProject) {\n sections.push(`Related project: \"${context.matchedProject}\"`);\n }\n\n if (context.matchedContacts.length > 0) {\n sections.push(`Related contacts: ${context.matchedContacts.join(', ')}`);\n }\n\n if (context.sourcePage) {\n sections.push(`Source page: \"${context.sourcePage}\"`);\n }\n\n const contextBlock = sections.join('\\n');\n\n try {\n const completion = await openai.chat.completions.create({\n model: \"gpt-4o-mini\",\n max_tokens: 200,\n messages: [\n {\n role: \"system\",\n content: `You rewrite todos into clear, standalone statements and identify the owner.\n\nGiven raw todo text and metadata, return JSON with:\n1. summary: A polished todo in format \"[Person] to [verb] [object] by [date]\"\n2. ownerName: The person who should own this task (full name if available)\n3. ownerSource: Where you determined the owner from (\"heading\", \"contact\", \"mention\", or null)\n\nOwner determination rules (in STRICT priority order):\n1. If preceding heading contains a person's name → that's the owner (source: \"heading\"). This ALWAYS takes priority.\n2. If matched contacts exist → first contact is the owner (source: \"contact\")\n3. If @mentions exist → first @mention is the owner (source: \"mention\")\n4. If none of the above → ownerName is null, ownerSource is null\n\nCRITICAL: Do NOT assign ownership based on who is mentioned as the TARGET of an action.\n- \"Email Alex\", \"Connect with Taylor\", \"Call Jordan\", \"Follow up with Sam\" → these people are TARGETS, not owners\n- The owner is whoever should PERFORM the action, not receive it\n- Look for the owner in the heading, contacts, or @mentions - NOT in the task target\n\nSummary format:\n- Start with WHO owns this task\n- Follow with \"to\" + action verb\n- Include WHAT the task is about\n- End with WHEN it's due\n\nExamples:\n{\"summary\": \"Alex to prepare the quarterly proposal by January 9, 2026\", \"ownerName\": \"Alex Johnson\", \"ownerSource\": \"heading\"}\n{\"summary\": \"Jamie to connect with Taylor about the project status by January 15\", \"ownerName\": \"Jamie Smith\", \"ownerSource\": \"heading\"}\n{\"summary\": \"Morgan to review the Q1 Planning document by January 15\", \"ownerName\": \"Morgan Lee\", \"ownerSource\": \"contact\"}\n\nReturn ONLY valid JSON, no other text.`\n },\n {\n role: \"user\",\n content: contextBlock\n }\n ]\n });\n\n const response = completion.choices[0]?.message?.content?.trim();\n\n if (!response) {\n // Fallback if AI returns nothing\n return {\n summary: context.todoString,\n ownerName: null,\n ownerSource: null\n };\n }\n\n // Try to parse JSON response\n try {\n const parsed = JSON.parse(response);\n return {\n summary: parsed.summary || context.todoString,\n ownerName: parsed.ownerName || null,\n ownerSource: parsed.ownerSource || null\n };\n } catch (parseErr) {\n // If JSON parsing fails, treat entire response as summary (backward compatibility)\n console.warn('AI returned non-JSON response, treating as summary:', response.substring(0, 50));\n return {\n summary: response,\n ownerName: null,\n ownerSource: null\n };\n }\n\n } catch (err: any) {\n console.error('AI summary generation error:', err.message);\n // Fallback to original on error\n return {\n summary: context.todoString,\n ownerName: null,\n ownerSource: null\n };\n }\n}\n",[],[210,509,519],"f6ee89d4-ebd3-11f0-955f-42dde27851f2","users.ts","49d474b8-ea41-11f0-a04d-42dde27851f2","019a26dc-99bf-7269-a8f6-24515668c88f",["D",1767795606157],"import { notion } from \"./index.ts\";\n\n/**\n * Workspace user entry for caching\n */\ninterface WorkspaceUser {\n id: string;\n name: string;\n email: string | null;\n}\n\n/**\n * Cache for workspace users\n * Refreshed every 5 minutes to balance freshness and performance\n */\nlet userCache: WorkspaceUser[] | null = null;\nlet cacheTimestamp: number = 0;\nconst CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes\n\n/**\n * Get all workspace users\n *\n * Fetches all users in the workspace with caching for performance.\n * Requires the integration to have \"Read user information\" capability.\n *\n * @returns Array of workspace users\n */\nexport async function getWorkspaceUsers(): Promise<{\n success: boolean;\n users: WorkspaceUser[];\n error: string | null;\n}> {\n // Check cache freshness\n const now = Date.now();\n if (userCache && (now - cacheTimestamp) < CACHE_TTL_MS) {\n console.log(`getWorkspaceUsers: Returning ${userCache.length} cached users`);\n return {\n success: true,\n users: userCache,\n error: null\n };\n }\n\n console.log('getWorkspaceUsers: Fetching users from Notion API...');\n try {\n const users: WorkspaceUser[] = [];\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n while (hasMore) {\n const response = await notion.users.list({\n start_cursor: startCursor,\n page_size: 100\n });\n\n for (const user of response.results) {\n // Only include people (not bots)\n if (user.type === 'person') {\n users.push({\n id: user.id,\n name: user.name || '',\n email: (user as any).person?.email || null\n });\n }\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor || undefined;\n }\n\n // Update cache\n userCache = users;\n cacheTimestamp = now;\n\n console.log(`getWorkspaceUsers: Fetched ${users.length} users: ${users.map(u => u.name).join(', ')}`);\n return {\n success: true,\n users,\n error: null\n };\n\n } catch (err: any) {\n // Common error: integration lacks \"Read user information\" capability\n if (err.status === 403) {\n console.warn('getWorkspaceUsers: API access denied (403) - integration may lack \"Read user information\" capability');\n } else {\n console.error(`getWorkspaceUsers: Error fetching users: ${err.message}`);\n }\n\n return {\n success: false,\n users: [],\n error: err.message || 'Failed to get workspace users'\n };\n }\n}\n\n/**\n * Find a workspace user by name\n *\n * Searches workspace users for a matching name.\n * Uses case-insensitive partial matching (e.g., \"Alex\" matches \"Alex Johnson\").\n *\n * @param name - Name to search for\n * @returns Matching user or null\n */\nexport async function findUserByName(name: string): Promise<{\n success: boolean;\n user: WorkspaceUser | null;\n error: string | null;\n}> {\n if (!name) {\n return {\n success: true,\n user: null,\n error: null\n };\n }\n\n const usersResult = await getWorkspaceUsers();\n\n if (!usersResult.success) {\n console.log(`findUserByName(\"${name}\"): getWorkspaceUsers failed - ${usersResult.error}`);\n return {\n success: false,\n user: null,\n error: usersResult.error\n };\n }\n\n const nameLower = name.toLowerCase().trim();\n const searchFirstName = nameLower.split(' ')[0]; // Extract first name from search term\n console.log(`findUserByName: Searching for \"${name}\" (first name: \"${searchFirstName}\") among ${usersResult.users.length} users`);\n\n // Try exact match first\n let match = usersResult.users.find(u =>\n u.name.toLowerCase() === nameLower\n );\n\n if (match) {\n console.log(`findUserByName: Exact match found: \"${match.name}\"`);\n return {\n success: true,\n user: match,\n error: null\n };\n }\n\n // Try partial match (name starts with search term, or search term is first name)\n match = usersResult.users.find(u => {\n const userNameLower = u.name.toLowerCase();\n const userFirstName = userNameLower.split(' ')[0];\n // \"Alex\" matches \"Alex Johnson\"\n // \"Alex Johnson\" matches \"Alex Johnson\"\n // NEW: \"Alex Johnson\" matches \"Alex @ Acme Corp\" (first names match)\n return userNameLower.startsWith(nameLower) ||\n userFirstName === nameLower ||\n userFirstName === searchFirstName; // Match first names\n });\n\n if (match) {\n console.log(`findUserByName: Partial match found: \"${match.name}\"`);\n } else {\n console.log(`findUserByName: No match found for \"${name}\"`);\n }\n\n return {\n success: true,\n user: match || null,\n error: null\n };\n}\n\n/**\n * Find a workspace user by ID\n *\n * Searches cached workspace users for a matching ID.\n * Uses the same cache as getWorkspaceUsers() - no extra API call.\n *\n * @param userId - User ID to search for\n * @returns Matching user or null\n */\nexport async function findUserById(userId: string): Promise<{\n success: boolean;\n user: WorkspaceUser | null;\n error: string | null;\n}> {\n if (!userId) {\n return {\n success: true,\n user: null,\n error: null\n };\n }\n\n const usersResult = await getWorkspaceUsers();\n\n if (!usersResult.success) {\n return {\n success: false,\n user: null,\n error: usersResult.error\n };\n }\n\n const match = usersResult.users.find(u => u.id === userId);\n\n return {\n success: true,\n user: match || null,\n error: null\n };\n}\n\n/**\n * Clear the user cache\n * Useful for testing or forcing a refresh\n */\nexport function clearUserCache(): void {\n userCache = null;\n cacheTimestamp = 0;\n}\n",[],[210,509,534,527],"notion","fd178ad2-b4f0-11f0-8e48-0224a6c84d84","search.ts","fd178b4a-b4f0-11f0-8e48-0224a6c84d84",["D",1761760757953],"/**\n * Notion search operations\n */\n\nimport { notion } from \"./index.ts\";\n\n/**\n * Normalize Notion ID by removing hyphens for comparison\n */\nfunction normalizeNotionId(id: string): string {\n return id.replace(/-/g, '');\n}\n\n/**\n * Search for pages edited within the last X hours\n * Filters out:\n * - Archived items\n * - Database objects\n * - Pages inside TODOS_DB_ID database\n *\n * @param hoursAgo - Number of hours to look back (default: 24)\n * @returns {success, data, error} with array of simplified page objects\n */\nexport async function searchRecentPages(hoursAgo: number = 24) {\n try {\n // Get TODOS_DB_ID to filter out those pages\n const todosDbId = Deno.env.get('TODOS_DB_ID');\n\n // Calculate cutoff timestamp\n const cutoffTime = new Date();\n cutoffTime.setHours(cutoffTime.getHours() - hoursAgo);\n\n const results: any[] = [];\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n // Paginate through all results\n while (hasMore) {\n const response = await notion.search({\n sort: {\n direction: 'descending',\n timestamp: 'last_edited_time'\n },\n page_size: 100,\n start_cursor: startCursor\n });\n\n // Add results to array\n results.push(...response.results);\n\n // Check if we've reached the cutoff time\n // Since results are sorted by last_edited_time descending,\n // once we hit a page older than cutoff, we can stop\n const lastResult = response.results[response.results.length - 1];\n if (lastResult) {\n const lastEditedTime = new Date(lastResult.last_edited_time);\n if (lastEditedTime < cutoffTime) {\n // We've gone past the cutoff, stop paginating\n hasMore = false;\n break;\n }\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor ?? undefined;\n }\n\n // Filter results:\n // 1. Within time range\n // 2. Not archived\n // 3. Only pages (not databases)\n // 4. Not in TODOS_DB_ID database\n const filteredResults = results.filter((item: any) => {\n const lastEditedTime = new Date(item.last_edited_time);\n const isWithinTimeRange = lastEditedTime >= cutoffTime;\n const isNotArchived = !item.archived;\n const isPage = item.object === 'page';\n\n // Filter out pages in the todos database (normalize IDs for comparison)\n const isInTodosDb = todosDbId\n && item.parent?.type === 'database_id'\n && normalizeNotionId(item.parent?.database_id || '') === normalizeNotionId(todosDbId);\n const isNotInTodosDb = !isInTodosDb;\n\n return isWithinTimeRange && isNotArchived && isPage && isNotInTodosDb;\n });\n\n // Simplify the results - extract only needed fields\n const simplifiedResults = filteredResults.map((item: any) => {\n const simplified: any = {\n id: item.id,\n object: item.object, // 'page' or 'database'\n last_edited_time: item.last_edited_time,\n url: item.url\n };\n\n // Extract title from page properties\n const titleProp = Object.values(item.properties || {}).find(\n (prop: any) => prop.type === 'title'\n ) as any;\n\n if (titleProp?.title?.[0]?.plain_text) {\n simplified.title = titleProp.title[0].plain_text;\n } else {\n simplified.title = 'Untitled';\n }\n\n // Extract parent information\n if (item.parent) {\n simplified.parent = {\n type: item.parent.type\n };\n\n // Add the appropriate ID based on parent type\n if (item.parent.type === 'page_id' && item.parent.page_id) {\n simplified.parent.id = item.parent.page_id;\n } else if (item.parent.type === 'database_id' && item.parent.database_id) {\n simplified.parent.id = item.parent.database_id;\n } else if (item.parent.type === 'workspace' && item.parent.workspace) {\n // Workspace parent doesn't have an ID, it's a boolean\n simplified.parent.id = null;\n }\n }\n\n return simplified;\n });\n\n return {\n success: true,\n data: simplifiedResults,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message\n };\n }\n}\n",[],[210,509,534,536],"a943b3f4-f613-11f0-b05a-42dde27851f2","relations.ts","3d6cb198-e71e-11f0-835d-42dde27851f2",["D",1768922475258],"import { notion } from \"./index.ts\";\nimport { TODOS_PROPERTIES } from \"../../utils/notionConfig.ts\";\nimport type { RelationPropertyMapping } from \"../../../shared/types.ts\";\n\n/**\n * Discover all relation properties from a database schema\n *\n * Queries the database to find all relation-type properties and their target databases.\n * Used for dynamic relation mapping without manual configuration.\n *\n * @param databaseId - The database to inspect (typically the todos database)\n * @returns Array of relation property mappings with target database IDs\n */\nexport async function discoverRelationProperties(databaseId: string): Promise<{\n success: boolean;\n relations: RelationPropertyMapping[];\n error: string | null;\n}> {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n const props = (database as any).properties || {};\n\n const relations: RelationPropertyMapping[] = [];\n\n for (const [name, value] of Object.entries(props)) {\n const propAny = value as any;\n if (propAny.type === 'relation' && propAny.relation?.database_id) {\n // Normalize database ID (remove hyphens)\n const targetDbId = propAny.relation.database_id.replace(/-/g, '');\n\n relations.push({\n propertyName: name,\n targetDatabaseId: targetDbId,\n // Matches TODOS_PROPERTIES.projects = special AI treatment\n isProjectRelation: name === TODOS_PROPERTIES.projects\n });\n }\n }\n\n return {\n success: true,\n relations,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n relations: [],\n error: err.message || 'Failed to discover relation properties'\n };\n }\n}\n\n/**\n * Get the parent database ID for a Notion page\n *\n * Returns the database ID if the page is in a database, or null if\n * the page is a standalone page (parent is workspace or another page).\n *\n * @param pageId - Page ID to lookup\n * @returns Parent database ID (normalized, no hyphens) or null\n */\nexport async function getPageParentDatabaseId(pageId: string): Promise<{\n success: boolean;\n databaseId: string | null;\n error: string | null;\n}> {\n try {\n const page = await notion.pages.retrieve({ page_id: pageId });\n\n const parent = (page as any).parent;\n if (parent?.type === 'database_id') {\n // Normalize database ID (remove hyphens)\n return {\n success: true,\n databaseId: parent.database_id.replace(/-/g, ''),\n error: null\n };\n }\n\n // Parent is not a database (page, workspace, etc.)\n return {\n success: true,\n databaseId: null,\n error: null\n };\n\n } catch (err: any) {\n // Page might be deleted, archived, or inaccessible\n return {\n success: false,\n databaseId: null,\n error: err.message || 'Failed to get page parent database'\n };\n }\n}\n\n/**\n * Batch lookup parent database IDs for multiple pages\n *\n * Efficiently looks up parent database IDs for a list of page IDs.\n * Uses internal caching to avoid duplicate lookups within the same batch.\n *\n * @param pageIds - Array of page IDs to lookup\n * @returns Map of pageId -> parentDatabaseId (null if not in a database)\n */\nexport async function batchGetPageParentDatabaseIds(pageIds: string[]): Promise<{\n success: boolean;\n mapping: Map<string, string | null>;\n error: string | null;\n}> {\n const mapping = new Map<string, string | null>();\n\n // Deduplicate page IDs\n const uniquePageIds = [...new Set(pageIds)];\n\n // Process in parallel with concurrency limit\n const BATCH_SIZE = 5; // Limit concurrent requests to avoid rate limits\n\n for (let i = 0; i < uniquePageIds.length; i += BATCH_SIZE) {\n const batch = uniquePageIds.slice(i, i + BATCH_SIZE);\n\n const results = await Promise.all(\n batch.map(async (pageId) => {\n const result = await getPageParentDatabaseId(pageId);\n return { pageId, databaseId: result.success ? result.databaseId : null };\n })\n );\n\n for (const { pageId, databaseId } of results) {\n mapping.set(pageId, databaseId);\n }\n }\n\n return {\n success: true,\n mapping,\n error: null\n };\n}\n\n/**\n * Get the type of a specific property in a database\n *\n * Used to detect whether a property like \"Owner\" is a people type or relation type.\n * Returns the property type and relation target database ID if applicable.\n *\n * @param databaseId - Database to query\n * @param propertyName - Name of the property to look up\n * @returns Property type and relation target if applicable\n */\nexport async function getPropertyType(databaseId: string, propertyName: string): Promise<{\n success: boolean;\n propertyType: string | null; // 'people', 'relation', 'rich_text', etc.\n relationTargetDbId?: string | null; // Only populated if type is 'relation'\n error: string | null;\n}> {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n const props = (database as any).properties || {};\n\n const property = props[propertyName];\n\n if (!property) {\n return {\n success: true,\n propertyType: null,\n relationTargetDbId: null,\n error: null\n };\n }\n\n const propertyType = property.type;\n\n // If it's a relation, also return the target database ID\n if (propertyType === 'relation' && property.relation?.database_id) {\n return {\n success: true,\n propertyType,\n relationTargetDbId: property.relation.database_id.replace(/-/g, ''),\n error: null\n };\n }\n\n return {\n success: true,\n propertyType,\n relationTargetDbId: null,\n error: null\n };\n\n } catch (err: any) {\n return {\n success: false,\n propertyType: null,\n relationTargetDbId: null,\n error: err.message || 'Failed to get property type'\n };\n }\n}\n\n/**\n * Get all page IDs from a database\n *\n * Fetches all pages from a database and returns their IDs.\n * Used to build a lookup set for matching mentions to relation targets.\n *\n * @param databaseId - Database to query\n * @returns Set of page IDs (normalized, no hyphens)\n */\nexport async function getDatabasePageIds(databaseId: string): Promise<{\n success: boolean;\n pageIds: string[];\n error: string | null;\n}> {\n try {\n const pageIds: string[] = [];\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n while (hasMore) {\n const response = await notion.databases.query({\n database_id: databaseId,\n start_cursor: startCursor,\n page_size: 100\n });\n\n for (const page of response.results) {\n // Normalize page ID (remove hyphens)\n pageIds.push(page.id.replace(/-/g, ''));\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor || undefined;\n }\n\n return {\n success: true,\n pageIds,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n pageIds: [],\n error: err.message || 'Failed to get database page IDs'\n };\n }\n}\n",[],[210,509,534,543],"72f1cbee-d5c8-11f0-b312-42dde27851f2","pages.ts","019a26dc-99bf-7269-a8f6-23db6afe7f06",180,["D",1765371734701],"import { notion } from \"./index.ts\";\n\n/**\n * Block types that can contain nested to_do blocks\n * Used to optimize recursive fetching in block type mode\n */\nexport const TODO_CONTAINER_TYPES = new Set([\n 'to_do', // to_do blocks can nest inside other to_do blocks\n 'toggle', // common pattern for organizing todos\n 'heading_1', // toggle headings can contain nested content\n 'heading_2', // toggle headings can contain nested content\n 'heading_3', // toggle headings can contain nested content\n 'column_list', // layout container\n 'column', // layout container\n 'synced_block', // can contain any block type\n 'callout', // can contain nested content\n 'quote', // can contain nested blocks\n 'bulleted_list_item', // can have nested content\n 'numbered_list_item', // can have nested content\n 'template' // can contain any block type\n]);\n\n/**\n * Get a Notion page by ID\n */\nexport async function getNotionPage(pageId: string) {\n try {\n const page = await notion.pages.retrieve({ page_id: pageId });\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch Notion page'\n };\n }\n}\n\n/**\n * Update a Notion page's properties\n */\nexport async function updateNotionPage(\n pageId: string,\n properties: any,\n icon?: { type: string; emoji?: string; external?: { url: string } }\n) {\n try {\n const updateData: any = {\n page_id: pageId,\n properties: properties\n };\n\n // Add icon if provided\n if (icon) {\n updateData.icon = icon;\n }\n\n const page = await notion.pages.update(updateData);\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to update Notion page'\n };\n }\n}\n\n/**\n * Create a new page in a database\n */\nexport async function createNotionPage(\n databaseId: string,\n properties: any,\n icon?: { type: string; emoji?: string; external?: { url: string } }\n) {\n try {\n const pageData: any = {\n parent: { database_id: databaseId },\n properties: properties\n };\n\n // Add icon if provided\n if (icon) {\n pageData.icon = icon;\n }\n\n const page = await notion.pages.create(pageData);\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to create Notion page'\n };\n }\n}\n\n/**\n * Get page blocks (content)\n */\nexport async function getPageBlocks(pageId: string) {\n try {\n const response = await notion.blocks.children.list({ block_id: pageId });\n\n return {\n success: true,\n data: response.results,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch page blocks'\n };\n }\n}\n\n/**\n * Update a Notion page's icon with an external URL\n */\nexport async function updatePageIcon(pageId: string, iconUrl: string) {\n try {\n const page = await notion.pages.update({\n page_id: pageId,\n icon: {\n type: \"external\",\n external: {\n url: iconUrl\n }\n }\n });\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to update page icon'\n };\n }\n}\n\n/**\n * Append a paragraph block to a page (for error notes)\n */\nexport async function appendBlockToPage(pageId: string, message: string) {\n try {\n const response = await notion.blocks.children.append({\n block_id: pageId,\n children: [\n {\n object: \"block\",\n type: \"paragraph\",\n paragraph: {\n rich_text: [\n {\n type: \"text\",\n text: {\n content: message\n }\n }\n ]\n }\n }\n ]\n });\n\n return {\n success: true,\n data: response,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to append block to page'\n };\n }\n}\n\n/**\n * Append a callout block to a page indicating the source has additional details\n *\n * @param pageId - The page to append to\n * @param blockUrl - URL to the source block\n */\nexport async function appendHasChildrenCallout(pageId: string, blockUrl: string) {\n try {\n const response = await notion.blocks.children.append({\n block_id: pageId,\n children: [\n {\n object: \"block\",\n type: \"callout\",\n callout: {\n rich_text: [\n {\n type: \"text\",\n text: { content: \"This todo has additional details. \" }\n },\n {\n type: \"text\",\n text: {\n content: \"View details →\",\n link: { url: blockUrl }\n }\n }\n ],\n icon: {\n type: \"external\",\n external: { url: \"https://www.notion.so/icons/info-alternate_blue.svg\" }\n },\n color: \"blue_background\"\n }\n } as any\n ]\n });\n\n return {\n success: true,\n data: response,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to append callout to page'\n };\n }\n}\n\n/**\n * Recursively get all blocks from a page, including nested children\n *\n * @param blockId - Starting block/page ID\n * @param containerFilter - Optional set of block types to recurse into. If provided, only\n * recurses into blocks whose type is in this set. If null/undefined,\n * recurses into all blocks with children.\n */\nexport async function getPageBlocksRecursive(\n blockId: string,\n containerFilter?: Set<string>\n): Promise<any[]> {\n const allBlocks: any[] = [];\n\n try {\n const response = await notion.blocks.children.list({ block_id: blockId });\n\n for (const block of response.results) {\n // Add the current block\n allBlocks.push(block);\n\n // If block has children, check if we should recurse\n if ((block as any).has_children) {\n const blockType = (block as any).type;\n\n // Recurse if no filter, or if block type is in the filter set\n if (!containerFilter || containerFilter.has(blockType)) {\n const children = await getPageBlocksRecursive(block.id, containerFilter);\n allBlocks.push(...children);\n }\n }\n }\n\n return allBlocks;\n } catch (err: any) {\n // Silently skip validation errors for unsupported block types (transcription, audio, etc.)\n // These are expected - Notion API doesn't support all block types\n if (err.code !== 'validation_error') {\n console.error(`Notion API Error for block ${blockId}: [${err.code}] ${err.message}`);\n }\n return allBlocks; // Return what we have so far\n }\n}\n\n/**\n * Get page title from a Notion page\n *\n * Extracts the title from page properties (looks for property with type \"title\")\n * Returns plain text version of the title\n *\n * @param pageId - Notion page ID\n * @returns Object with success, title (or null), and error\n */\nexport async function getPageTitle(pageId: string) {\n try {\n const page = await notion.pages.retrieve({ page_id: pageId });\n\n // Find the title property (it's the property with type \"title\")\n const properties = (page as any).properties;\n\n if (!properties) {\n return {\n success: false,\n title: null,\n error: 'Page has no properties'\n };\n }\n\n // Find the title property\n let titleProperty = null;\n for (const [key, value] of Object.entries(properties)) {\n if ((value as any).type === 'title') {\n titleProperty = value;\n break;\n }\n }\n\n if (!titleProperty) {\n return {\n success: false,\n title: null,\n error: 'Page has no title property'\n };\n }\n\n // Extract plain text from title rich_text array\n const titleRichText = (titleProperty as any).title;\n if (!Array.isArray(titleRichText) || titleRichText.length === 0) {\n return {\n success: true,\n title: 'Untitled', // Notion pages can legitimately have empty titles\n error: null\n };\n }\n\n const title = titleRichText\n .map((rt: any) => rt.plain_text || '')\n .join('');\n\n return {\n success: true,\n title: title || 'Untitled',\n error: null\n };\n\n } catch (err: any) {\n return {\n success: false,\n title: null,\n error: err.message || 'Failed to fetch page title'\n };\n }\n}\n",[],[210,509,534,550],"49d6954a-ea41-11f0-a04d-42dde27851f2","index.ts","019a26dc-99bf-7269-a8f6-1efef3029063",223,["D",1767622658078],5,"import { Client } from \"npm:@notionhq/client@2\";\n\n// Initialize Notion client - shared across all Notion service modules\nexport const notion = new Client({ auth: Deno.env.get(\"NOTION_API_KEY\") });\n\n/**\n * Get the bot user (integration) info\n * Returns integration name and workspace name\n */\nexport async function getBotUser(): Promise<{\n success: boolean;\n data: { name: string; workspaceName?: string } | null;\n error: string | null;\n}> {\n try {\n const user = await notion.users.me({});\n return {\n success: true,\n data: {\n name: user.name || \"Unknown\",\n workspaceName: (user as any).bot?.workspace_name\n },\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || \"Failed to get bot user\"\n };\n }\n}\n\n// Export all page operations\nexport * from \"./pages.ts\";\n\n// Export all database operations\nexport * from \"./databases.ts\";\n\n// Export all search operations\nexport * from \"./search.ts\";\n\n// Export all block operations\nexport * from \"./blocks.ts\";\n\n// Export all relation discovery operations\nexport * from \"./relations.ts\";\n\n// Export all user operations\nexport * from \"./users.ts\";\n",[],[210,509,534,558],"a9435f44-f613-11f0-b05a-42dde27851f2","databases.ts","019a26dc-99bf-7269-a8f6-1887e096fe60",["D",1768922475258],"import { notion } from \"./index.ts\";\nimport { TODOS_PROPERTIES, PROJECTS_PROPERTIES } from \"../../utils/notionConfig.ts\";\n\n/**\n * Query a Notion database\n */\nexport async function queryNotionDatabase(databaseId: string, filter?: any, sorts?: any) {\n try {\n const response = await notion.databases.query({\n database_id: databaseId,\n filter: filter,\n sorts: sorts\n });\n\n return {\n success: true,\n data: response.results,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to query Notion database'\n };\n }\n}\n\n/**\n * Get a database by ID\n */\nexport async function getNotionDatabase(databaseId: string) {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n\n return {\n success: true,\n data: database,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch Notion database'\n };\n }\n}\n\n/**\n * Get all page IDs from a database\n * Used to cache project IDs for matching against link_mentions\n *\n * @param databaseId - Notion database ID\n * @returns Object with success, pageIds array (normalized, no hyphens), and error\n */\nexport async function getProjectPageIds(databaseId: string): Promise<{\n success: boolean;\n pageIds: string[];\n error: string | null;\n}> {\n try {\n const pageIds: string[] = [];\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n while (hasMore) {\n const response = await notion.databases.query({\n database_id: databaseId,\n page_size: 100,\n start_cursor: startCursor\n });\n\n // Extract and normalize page IDs (remove hyphens for consistent comparison)\n for (const page of response.results) {\n const normalizedId = page.id.replace(/-/g, '');\n pageIds.push(normalizedId);\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor ?? undefined;\n }\n\n return {\n success: true,\n pageIds,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n pageIds: [],\n error: err.message || 'Failed to fetch project page IDs'\n };\n }\n}\n\n/**\n * Get projects with their names, client names, and date ranges\n * Used for AI fuzzy matching and date-based disambiguation\n *\n * @param databaseId - Projects database ID\n * @returns Object with success, projects array, and error\n */\nexport async function getProjectsWithDetails(databaseId: string): Promise<{\n success: boolean;\n projects: Array<{\n id: string;\n name: string;\n groupName: string | null;\n dateStart: string | null;\n dateEnd: string | null;\n lastEditedTime: string;\n }>;\n error: string | null;\n}> {\n try {\n const projects: Array<{\n id: string;\n name: string;\n groupName: string | null;\n dateStart: string | null;\n dateEnd: string | null;\n lastEditedTime: string;\n }> = [];\n\n // Cache group names to avoid redundant API calls\n const groupCache: Map<string, string | null> = new Map();\n\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n while (hasMore) {\n const response = await notion.databases.query({\n database_id: databaseId,\n page_size: 100,\n start_cursor: startCursor\n });\n\n for (const page of response.results) {\n const pageAny = page as any;\n const properties = pageAny.properties || {};\n\n // Extract project name from title property\n let projectName = 'Untitled';\n for (const [key, value] of Object.entries(properties)) {\n if ((value as any).type === 'title') {\n const titleArray = (value as any).title || [];\n projectName = titleArray.map((t: any) => t.plain_text || '').join('') || 'Untitled';\n break;\n }\n }\n\n // Extract group name from groupBy relation (with caching)\n let groupName: string | null = null;\n const groupByRelation = properties[PROJECTS_PROPERTIES.groupBy];\n\n if (groupByRelation?.type === 'relation' && groupByRelation.relation?.length > 0) {\n const groupPageId = groupByRelation.relation[0].id;\n\n // Check cache first\n if (groupCache.has(groupPageId)) {\n groupName = groupCache.get(groupPageId) || null;\n } else {\n // Fetch the related page to get its title\n try {\n const groupPage = await notion.pages.retrieve({ page_id: groupPageId });\n const groupProps = (groupPage as any).properties || {};\n\n for (const [key, value] of Object.entries(groupProps)) {\n if ((value as any).type === 'title') {\n const titleArray = (value as any).title || [];\n groupName = titleArray.map((t: any) => t.plain_text || '').join('') || null;\n break;\n }\n }\n\n // Cache the result\n groupCache.set(groupPageId, groupName);\n } catch (err) {\n // Cache the failure too to avoid retrying\n groupCache.set(groupPageId, null);\n }\n }\n }\n\n // Extract dates from configured properties\n let dateStart: string | null = null;\n let dateEnd: string | null = null;\n\n if (PROJECTS_PROPERTIES.dateStart === PROJECTS_PROPERTIES.dateEnd) {\n // Same property = date range, read .start and .end\n const dateRangeProp = properties[PROJECTS_PROPERTIES.dateStart];\n if (dateRangeProp?.type === 'date' && dateRangeProp.date) {\n dateStart = dateRangeProp.date.start || null;\n dateEnd = dateRangeProp.date.end || null;\n }\n } else {\n // Different properties = separate dates, read .start from each\n const startProp = properties[PROJECTS_PROPERTIES.dateStart];\n const endProp = properties[PROJECTS_PROPERTIES.dateEnd];\n if (startProp?.type === 'date' && startProp.date) {\n dateStart = startProp.date.start || null;\n }\n if (endProp?.type === 'date' && endProp.date) {\n dateEnd = endProp.date.start || null;\n }\n }\n\n projects.push({\n id: page.id.replace(/-/g, ''), // Normalize ID\n name: projectName,\n groupName,\n dateStart,\n dateEnd,\n lastEditedTime: pageAny.last_edited_time\n });\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor ?? undefined;\n }\n\n return {\n success: true,\n projects,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n projects: [],\n error: err.message || 'Failed to fetch projects with details'\n };\n }\n}\n\n/**\n * Get property names from a database schema\n * Used by health check to validate property mappings\n *\n * @param databaseId - Notion database ID\n * @returns Object with success, property names array, and error\n */\nexport async function getDatabasePropertyNames(databaseId: string): Promise<{\n success: boolean;\n properties: string[];\n error: string | null;\n}> {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n const props = (database as any).properties || {};\n\n // Extract property names, excluding buttons (not data, just action triggers)\n const properties: string[] = [];\n for (const [name, value] of Object.entries(props)) {\n const type = (value as any).type;\n if (type !== 'button') {\n properties.push(name);\n }\n }\n\n return {\n success: true,\n properties,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n properties: [],\n error: err.message || 'Failed to fetch database properties'\n };\n }\n}\n\n/**\n * Get all page IDs and names from a database\n * Used for fuzzy name matching in relation mapping\n *\n * @param databaseId - Notion database ID\n * @returns Object with success, array of {id, name}, and error\n */\nexport async function getDatabasePageNames(databaseId: string): Promise<{\n success: boolean;\n pages: Array<{ id: string; name: string }>;\n error: string | null;\n}> {\n try {\n const pages: Array<{ id: string; name: string }> = [];\n let hasMore = true;\n let startCursor: string | undefined = undefined;\n\n while (hasMore) {\n const response = await notion.databases.query({\n database_id: databaseId,\n start_cursor: startCursor,\n page_size: 100\n });\n\n for (const page of response.results) {\n // Extract page ID (normalized, no hyphens)\n const id = page.id.replace(/-/g, '');\n\n // Extract page title from properties\n const props = (page as any).properties || {};\n let name = 'Untitled';\n\n // Find the title property\n for (const [, value] of Object.entries(props)) {\n const propAny = value as any;\n if (propAny.type === 'title' && propAny.title) {\n name = propAny.title.map((t: any) => t.plain_text || '').join('') || 'Untitled';\n break;\n }\n }\n\n pages.push({ id, name });\n }\n\n hasMore = response.has_more;\n startCursor = response.next_cursor || undefined;\n }\n\n return {\n success: true,\n pages,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n pages: [],\n error: err.message || 'Failed to fetch database page names'\n };\n }\n}\n\n/**\n * Query database for a page with specific Block ID\n */\nexport async function queryDatabaseByBlockId(databaseId: string, blockId: string) {\n try {\n const filter = {\n property: TODOS_PROPERTIES.sourceBlockId,\n rich_text: {\n equals: blockId\n }\n };\n\n const response = await notion.databases.query({\n database_id: databaseId,\n filter: filter\n });\n\n // Return first matching page or null\n const page = response.results.length > 0 ? response.results[0] : null;\n\n return {\n success: true,\n data: page,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to query database by Block ID'\n };\n }\n}\n\n/**\n * Status property info for checkbox sync\n *\n * When a todo checkbox is checked, status is set to `doneName`.\n * When unchecked, status is reset to `notDoneName` (first non-done option).\n * This ensures unchecking a todo properly reverts the status.\n */\nexport interface StatusPropertyInfo {\n type: 'status' | 'select' | 'checkbox';\n doneName?: string; // Option name for \"done\" state (e.g., \"Done\", \"Complete\")\n notDoneName?: string; // Option name for \"not done\" state (e.g., \"Not started\", \"To Do\")\n}\n\n/**\n * Get status property info from database schema\n * Used for syncing checkbox state to a status/select/checkbox property\n *\n * @param databaseId - Notion database ID\n * @param propertyName - Name of the status property\n * @returns Status property info or null if not found/unsupported\n */\nexport async function getStatusPropertyInfo(\n databaseId: string,\n propertyName: string\n): Promise<{\n success: boolean;\n data: StatusPropertyInfo | null;\n error: string | null;\n}> {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n const props = (database as any).properties || {};\n const property = props[propertyName];\n\n if (!property) {\n return {\n success: false,\n data: null,\n error: `Property \"${propertyName}\" not found in database schema`\n };\n }\n\n const propType = property.type;\n\n // Checkbox type - no options needed\n if (propType === 'checkbox') {\n return {\n success: true,\n data: { type: 'checkbox' },\n error: null\n };\n }\n\n // Status or select type - find \"done\" and \"not done\" options\n if (propType === 'status' || propType === 'select') {\n const options = property[propType]?.options || [];\n\n // Patterns for \"done\" state (case-insensitive)\n const donePatterns = ['done', 'complete', 'completed', 'finished'];\n\n let doneName: string | undefined;\n let notDoneName: string | undefined;\n\n for (const option of options) {\n const optionNameLower = (option.name || '').toLowerCase();\n if (donePatterns.includes(optionNameLower)) {\n doneName = option.name;\n } else if (!notDoneName) {\n // First non-done option becomes the default \"not done\" state\n notDoneName = option.name;\n }\n }\n\n if (doneName) {\n return {\n success: true,\n data: {\n type: propType,\n doneName,\n notDoneName // First non-done option (e.g., \"Not started\", \"To Do\")\n },\n error: null\n };\n }\n\n // No \"done\" option found\n const availableOptions = options.map((o: any) => o.name).join(', ');\n return {\n success: false,\n data: null,\n error: `No \"done\" option found in \"${propertyName}\". Available: ${availableOptions}`\n };\n }\n\n // Unsupported property type\n return {\n success: false,\n data: null,\n error: `Property \"${propertyName}\" has unsupported type: ${propType}`\n };\n\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to get status property info'\n };\n }\n}\n\n/**\n * Database schema property (name, type, id)\n */\nexport interface SchemaProperty {\n name: string;\n type: string;\n id: string;\n}\n\n/**\n * Get full database schema with property names and types\n * Used by health check for property validation and autodiscovery\n *\n * @param databaseId - Notion database ID\n * @returns Schema properties array\n */\nexport async function getDatabaseSchema(databaseId: string): Promise<{\n success: boolean;\n properties: SchemaProperty[];\n databaseName: string | null;\n error: string | null;\n}> {\n try {\n const database = await notion.databases.retrieve({ database_id: databaseId });\n const props = (database as any).properties || {};\n\n // Extract database name from title\n const titleArray = (database as any).title || [];\n const databaseName = titleArray.map((t: any) => t.plain_text || '').join('') || null;\n\n // Extract property details, excluding buttons\n const properties: SchemaProperty[] = [];\n for (const [name, value] of Object.entries(props)) {\n const propAny = value as any;\n if (propAny.type !== 'button') {\n properties.push({\n name,\n type: propAny.type,\n id: propAny.id\n });\n }\n }\n\n return {\n success: true,\n properties,\n databaseName,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n properties: [],\n databaseName: null,\n error: err.message || 'Failed to fetch database schema'\n };\n }\n}\n\n/**\n * Find properties by type (for autodiscovery)\n * Returns all properties matching any of the given types\n *\n * @param properties - Schema properties from getDatabaseSchema\n * @param types - Notion property types to match (e.g., [\"status\", \"select\", \"checkbox\"])\n * @returns Matching properties\n */\nexport function findPropertiesByType(\n properties: SchemaProperty[],\n types: string[]\n): SchemaProperty[] {\n return properties.filter(p => types.includes(p.type));\n}\n\n/**\n * Find the title property (every database has exactly one)\n *\n * @param properties - Schema properties from getDatabaseSchema\n * @returns Title property or null if not found\n */\nexport function findTitleProperty(properties: SchemaProperty[]): SchemaProperty | null {\n return properties.find(p => p.type === 'title') || null;\n}\n\n/**\n * Find a property by name (case-insensitive)\n *\n * @param properties - Schema properties from getDatabaseSchema\n * @param name - Property name to find\n * @returns Matching property or null\n */\nexport function findPropertyByName(\n properties: SchemaProperty[],\n name: string\n): SchemaProperty | null {\n const nameLower = name.toLowerCase();\n return properties.find(p => p.name.toLowerCase() === nameLower) || null;\n}\n\n/**\n * Find candidate properties by partial name match\n * Used for suggesting fixes when a configured property is missing\n *\n * @param properties - Schema properties from getDatabaseSchema\n * @param name - Name to match against\n * @returns Matching property names (sorted by relevance)\n */\nexport function findCandidateProperties(\n properties: SchemaProperty[],\n name: string\n): string[] {\n const nameLower = name.toLowerCase();\n const candidates: Array<{ name: string; score: number }> = [];\n\n for (const prop of properties) {\n const propLower = prop.name.toLowerCase();\n\n // Exact match (case-insensitive)\n if (propLower === nameLower) {\n candidates.push({ name: prop.name, score: 100 });\n continue;\n }\n\n // Contains match\n if (propLower.includes(nameLower) || nameLower.includes(propLower)) {\n candidates.push({ name: prop.name, score: 50 });\n continue;\n }\n\n // Word match\n const nameWords = nameLower.split(/\\s+/);\n const propWords = propLower.split(/\\s+/);\n const hasWordMatch = nameWords.some(nw =>\n propWords.some(pw => pw.includes(nw) || nw.includes(pw))\n );\n if (hasWordMatch) {\n candidates.push({ name: prop.name, score: 25 });\n }\n }\n\n // Sort by score (highest first) and return names\n return candidates\n .sort((a, b) => b.score - a.score)\n .map(c => c.name);\n}\n\n/**\n * Split a property name into words\n * Handles spaces, underscores, hyphens, and camelCase\n */\nfunction getWords(name: string): string[] {\n return name\n .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase → camel Case\n .replace(/[_-]/g, ' ') // snake_case → snake case\n .toLowerCase()\n .split(/\\s+/)\n .filter(Boolean);\n}\n\n/**\n * Find a property matching any of the given name patterns\n * Uses word boundary matching: \"Due by\" matches pattern \"due\", but \"Overdue\" doesn't\n *\n * @param properties - Schema properties from getDatabaseSchema\n * @param patterns - Name patterns to match (e.g., [\"due\", \"deadline\"])\n * @param expectedTypes - Property types to filter by (e.g., [\"date\"])\n * @returns Matching property or null\n */\nexport function findPropertyByNamePatterns(\n properties: SchemaProperty[],\n patterns: string[],\n expectedTypes: string[]\n): SchemaProperty | null {\n const normalizedPatterns = patterns.map(p => p.toLowerCase());\n\n // First pass: exact match (case-insensitive)\n for (const prop of properties) {\n if (!expectedTypes.includes(prop.type)) continue;\n if (normalizedPatterns.includes(prop.name.toLowerCase())) {\n return prop;\n }\n }\n\n // Second pass: word boundary match\n // Property name contains a word that matches a pattern\n for (const prop of properties) {\n if (!expectedTypes.includes(prop.type)) continue;\n const propWords = getWords(prop.name);\n for (const pattern of normalizedPatterns) {\n // Check if any word in the property name matches the pattern exactly\n if (propWords.includes(pattern)) {\n return prop;\n }\n // For multi-word patterns like \"due date\", ALL pattern words must be present\n const patternWords = getWords(pattern);\n if (patternWords.length > 1 && patternWords.every(pw => propWords.includes(pw))) {\n return prop;\n }\n }\n }\n\n return null;\n}\n",[],[210,509,534,567],"6072067c-cdf4-11f0-8ccd-42dde27851f2","blocks.ts","fef229ce-cc7f-11f0-a637-42dde27851f2",139,["D",1764510992220],"import { notion } from \"./index.ts\";\n\n/**\n * Get a single block by ID\n *\n * Used for parent block traversal in project matching\n */\nexport async function getBlock(blockId: string) {\n try {\n const block = await notion.blocks.retrieve({ block_id: blockId });\n\n return {\n success: true,\n data: block,\n error: null\n };\n } catch (err: any) {\n return {\n success: false,\n data: null,\n error: err.message || 'Failed to fetch block'\n };\n }\n}\n\n/**\n * Update a block's background color\n *\n * Valid colors: gray_background, brown_background, orange_background,\n * yellow_background, green_background, blue_background, purple_background,\n * pink_background, red_background, default (no background)\n *\n * @param blockId - The block ID to update\n * @param color - The background color to set\n */\nexport async function updateBlockColor(blockId: string, color: string) {\n try {\n // First retrieve the block to get its type\n const block = await notion.blocks.retrieve({ block_id: blockId });\n const blockType = (block as any).type;\n\n // Update the block with the new color\n await notion.blocks.update({\n block_id: blockId,\n [blockType]: {\n color: color\n }\n });\n\n return { success: true, error: null };\n } catch (err: any) {\n return { success: false, error: err.message || 'Failed to update block color' };\n }\n}\n",[],[210,509,534,574],"1cb962ee-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[258,259,260,261,262,263,264],[210,509,534],"1cb96406-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[257,265,266,267],[210,509],"ebd4a5ce-d51c-11f0-8fa4-42dde27851f2","authCheck.ts","019a26dc-99bf-7269-a8f6-1140d0020917","019a26dc-99bf-7269-a8f6-14fb6878e1e4",151,["D",1765298064073],"import { Context, Next } from \"npm:hono@4\";\n\n/**\n * Authentication middleware for Hono routes\n *\n * This middleware checks for authentication credentials in requests.\n * Customize this based on your authentication strategy:\n * - API key in header\n * - Bearer token\n * - Notion webhook signature verification\n * - etc.\n */\nexport async function authCheck(c: Context, next: Next) {\n // Example: Check for API key in header\n const apiKey = c.req.header('x-api-key');\n const expectedKey = Deno.env.get('API_KEY');\n\n // If no API_KEY is configured, skip auth (development mode)\n if (!expectedKey) {\n console.warn('Warning: API_KEY not configured, skipping authentication');\n await next();\n return;\n }\n\n // Validate API key\n if (!apiKey || apiKey !== expectedKey) {\n return c.json({ error: 'Unauthorized', details: 'Invalid or missing API key' }, 401);\n }\n\n // Authentication successful, proceed\n await next();\n}\n\n/**\n * Webhook authentication middleware\n *\n * Protects /tasks/* and /api/* endpoints using X-API-KEY header\n * Header value must match WEBHOOK_SECRET env var\n *\n * Usage in Notion webhooks:\n * Add custom header: X-API-KEY: <your-secret>\n *\n * Usage in API requests:\n * curl -H \"X-API-KEY: <your-secret>\" https://your-val.val.town/api/pages/recent\n */\nexport async function webhookAuth(c: Context, next: Next) {\n const apiKey = c.req.header('x-api-key');\n const webhookSecret = Deno.env.get('WEBHOOK_SECRET');\n\n // If no webhook secret is configured, skip authentication (development mode)\n if (!webhookSecret) {\n console.warn('⚠ WEBHOOK_SECRET not configured, skipping authentication');\n await next();\n return;\n }\n\n // Validate API key\n if (!apiKey || apiKey !== webhookSecret) {\n return c.json({\n error: 'Unauthorized',\n details: 'Invalid or missing X-API-KEY header'\n }, 401);\n }\n\n // Authentication successful\n await next();\n}\n",[],[210,598,590],"routes","1cb956be-b360-11f0-bc6f-0224a6c84d84","views","019a26dc-99bf-7269-a8f6-0e71a3295bf6",["D",1761588582800],[],[210,598,600],"eee93626-d51c-11f0-83d7-42dde27851f2","todos.ts","fd1783e8-b4f0-11f0-8e48-0224a6c84d84","019a26dc-99bf-7269-a8f6-0b691fa0aef1",152,["D",1765298069212],"import { Hono } from \"npm:hono@4\";\nimport * as todoOrchestrationController from '../../controllers/todoOrchestrationController.ts';\n\nconst todos = new Hono();\n\n/**\n * POST /tasks/todos\n * Batch process keyword search across recent pages:\n * 1. Get recent pages (filtered by hours parameter)\n * 2. Search each page for keywords and save to blobs\n * 3. Sync all todo blobs to Notion database\n *\n * Keywords are read from SEARCH_KEYWORDS environment variable (comma-separated)\n * Defaults to \"todo\" if not set\n *\n * Note: This endpoint returns immediately (202 Accepted) and processes in background.\n * This prevents timeout errors when called from Notion webhooks or manual triggers.\n * Check console logs for detailed progress and results.\n *\n * Query parameters:\n * - hours (optional): Number of hours to look back (default: 24)\n *\n * Examples:\n * - POST /tasks/todos (defaults: 24 hours)\n * - POST /tasks/todos?hours=48\n *\n * Response (immediate):\n * {\n * accepted: true,\n * message: \"Processing started in background\",\n * parameters: { hours: 24 }\n * }\n */\ntodos.post('/', async (c) => {\n try {\n // Extract hours parameter from query string\n const hoursParam = c.req.query('hours');\n let hours: number | undefined = undefined;\n\n if (hoursParam) {\n hours = parseInt(hoursParam, 10);\n\n // Validate that it's a valid number\n if (isNaN(hours) || hours <= 0) {\n return c.json({\n success: false,\n error: \"Invalid hours parameter\",\n details: \"hours must be a positive number\"\n }, 400);\n }\n }\n\n // Get request origin for building internal URL\n const origin = new URL(c.req.url).origin;\n\n // Get webhook secret for internal authentication\n const webhookSecret = Deno.env.get('WEBHOOK_SECRET');\n\n // Trigger internal processing endpoint (don't await)\n fetch(`${origin}/tasks/todos/internal`, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'X-API-KEY': webhookSecret || ''\n },\n body: JSON.stringify({ hours })\n }).catch((err) => {\n // Log fetch errors (not processing errors)\n console.error('Error triggering internal processing:', err);\n });\n\n // Return immediately with 202 Accepted\n return c.json({\n accepted: true,\n message: \"Processing started in background. Check console logs for progress and results.\",\n parameters: {\n hours: hours ?? 24\n }\n }, 202);\n\n } catch (err: any) {\n // Return error for validation failures\n console.error('Error starting batch keyword search processing:', err);\n return c.json({\n success: false,\n error: \"Failed to start processing\",\n details: err.message\n }, 500);\n }\n});\n\n/**\n * POST /tasks/todos/internal\n * Internal endpoint for actual batch processing.\n * Called by /tasks/todos to perform work in background.\n *\n * This endpoint is not intended for external use.\n *\n * Keywords are read from SEARCH_KEYWORDS environment variable (comma-separated)\n * Defaults to \"todo\" if not set\n *\n * Body:\n * {\n * hours?: number\n * }\n */\ntodos.post('/internal', async (c) => {\n try {\n // Extract parameters from body\n const body = await c.req.json();\n const hours = body.hours;\n\n console.log('Internal processing endpoint triggered');\n console.log(`Parameters: hours=${hours ?? 24}`);\n console.log('Keywords from SEARCH_KEYWORDS env var (or default \"todo\")');\n\n // Process batch keyword search (await to ensure completion)\n const result = await todoOrchestrationController.processBatchTodos(hours);\n\n console.log('Internal processing completed successfully');\n console.log(`Result summary: ${result.pagesSearched} pages searched, ${result.totalTodosFound} matches found`);\n\n // Return result (for logging purposes, no one is listening)\n return c.json(result, 200);\n\n } catch (err: any) {\n // Log errors comprehensively\n console.error('ERROR in internal processing:', err);\n console.error('Stack trace:', err.stack);\n\n // Return 200 even on errors (no one is listening anyway)\n return c.json({\n success: false,\n error: err.message,\n details: err.stack\n }, 200);\n }\n});\n\nexport default todos;\n",[],[210,598,614,606],"tasks","15829730-b459-11f0-a09c-0224a6c84d84","todoSave.ts","158297c6-b459-11f0-a09c-0224a6c84d84",["D",1761695515418],"import { Hono } from \"npm:hono@4\";\nimport * as todoSaveController from '../../controllers/todoSaveController.ts';\n\nconst todoSave = new Hono();\n\n// POST /tasks/todo-save - Save todos from blob storage to Notion database\ntodoSave.post('/', async (c) => {\n try {\n // Process all todo blobs and save to Notion\n // Note: This processes ALL blobs, not just one page\n const result = await todoSaveController.processTodoSave();\n\n // Always return 200 OK to webhook\n return c.json({\n success: result.success,\n totalBlobs: result.totalBlobs,\n pagesCreated: result.pagesCreated,\n pagesUpdated: result.pagesUpdated,\n pagesSkipped: result.pagesSkipped,\n pagesFailed: result.pagesFailed,\n failures: result.failures,\n message: result.success\n ? `Processed ${result.totalBlobs} blobs: ${result.pagesCreated} created, ${result.pagesUpdated} updated, ${result.pagesSkipped} skipped, ${result.pagesFailed} failed`\n : `Todo save failed: ${result.error}`\n }, 200);\n\n } catch (err: any) {\n // Even on unexpected errors, return 200 to prevent webhook retries\n console.error('Unexpected error in todo-save webhook:', err);\n return c.json({\n success: false,\n error: \"Internal server error\",\n details: err.message\n }, 200);\n }\n});\n\nexport default todoSave;\n",[],[210,598,614,616],"8ce524f8-e999-11f0-9687-42dde27851f2","todoPage.ts","dfc4f0f4-d5cb-11f0-bcbf-42dde27851f2",222,["D",1767550615134],"import { Hono } from \"npm:hono@4\";\nimport * as todoController from '../../controllers/todoController.ts';\nimport * as todoSaveController from '../../controllers/todoSaveController.ts';\n\nconst todoPage = new Hono();\n\n/**\n * POST /tasks/todos/page\n * Handle Notion webhook for single-page todo search and sync.\n *\n * Returns immediately (202 Accepted) and processes in background.\n * This prevents timeout errors when called from Notion buttons.\n *\n * Keywords are read from SEARCH_KEYWORDS environment variable (comma-separated)\n * Defaults to \"todo\" if not set\n *\n * Searches only the page specified in the webhook payload, then syncs to database\n * so users see todos appear immediately when they click the button in Notion.\n */\ntodoPage.post('/', async (c) => {\n try {\n // Extract payload from request body\n const payload = await c.req.json();\n\n // Extract page_id from webhook payload - try multiple possible locations\n const pageId = payload?.page_id || // Direct property\n payload?.data?.id || // Notion webhook event format\n payload?.page?.id; // Alternative format\n\n if (!pageId) {\n console.error('Failed to extract page_id from payload:', JSON.stringify(payload));\n return c.json({\n error: \"Missing page_id in webhook payload\",\n receivedPayload: payload\n }, 400);\n }\n\n // Get request origin for building internal URL\n const origin = new URL(c.req.url).origin;\n\n // Get webhook secret for internal authentication\n const webhookSecret = Deno.env.get('WEBHOOK_SECRET');\n\n // Trigger internal processing endpoint (don't await)\n fetch(`${origin}/tasks/todos/page/internal`, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'X-API-KEY': webhookSecret || ''\n },\n body: JSON.stringify({ pageId })\n }).catch((err) => {\n console.error('Error triggering internal processing:', err);\n });\n\n // Return immediately with 202 Accepted\n return c.json({\n accepted: true,\n message: \"Processing started\",\n pageId\n }, 202);\n\n } catch (err: any) {\n // Return error for validation failures\n console.error('Error in todo page webhook:', err);\n return c.json({\n success: false,\n error: \"Failed to start processing\",\n details: err.message\n }, 500);\n }\n});\n\n/**\n * POST /tasks/todos/page/internal\n * Internal endpoint for actual single-page processing.\n * Called by /tasks/todos/page to perform work in background.\n *\n * This endpoint is not intended for external use.\n *\n * Body:\n * {\n * pageId: string\n * }\n */\ntodoPage.post('/internal', async (c) => {\n try {\n const body = await c.req.json();\n const { pageId } = body;\n\n if (!pageId) {\n return c.json({ error: \"Missing pageId\" }, 400);\n }\n\n // Search page for todos (respects BLOCK_STABILITY_MINUTES env var)\n const searchResult = await todoController.processTodoSearch(pageId, true);\n\n // Sync blobs to database so user sees results immediately\n const saveResult = await todoSaveController.processTodoSave();\n\n // Log concise summary\n console.log(`[Page] ${pageId.slice(0, 8)}... → ${searchResult.blocksFound} found, ${saveResult.pagesCreated} created, ${saveResult.pagesUpdated} updated`);\n\n // Return result (for logging purposes)\n return c.json({\n success: searchResult.success,\n blocksFound: searchResult.blocksFound,\n saveResult: {\n pagesCreated: saveResult.pagesCreated,\n pagesUpdated: saveResult.pagesUpdated,\n pagesSkipped: saveResult.pagesSkipped,\n pagesFailed: saveResult.pagesFailed\n }\n }, 200);\n\n } catch (err: any) {\n console.error('ERROR in page processing:', err.message);\n return c.json({\n success: false,\n error: err.message\n }, 200);\n }\n});\n\nexport default todoPage;\n",[],[210,598,614,623],"7a2cba30-b369-11f0-a1ff-0224a6c84d84","favicon.ts","b76fa216-b361-11f0-8f90-0224a6c84d84",["D",1761592605104],"import { Hono } from \"npm:hono@4\";\nimport * as faviconController from '../../controllers/faviconController.ts';\n\nconst favicon = new Hono();\n\n// POST /tasks/favicon - Handle Notion webhook for favicon updates\nfavicon.post('/', async (c) => {\n try {\n // Extract payload from request body\n const payload = await c.req.json();\n\n // Extract page_id from webhook payload - try multiple possible locations\n const pageId = payload?.page_id || // Direct property\n payload?.data?.id || // Notion webhook event format\n payload?.page?.id; // Alternative format\n\n if (!pageId) {\n console.error('Failed to extract page_id from payload:', JSON.stringify(payload));\n return c.json({\n error: \"Missing page_id in webhook payload\",\n receivedPayload: payload\n }, 400);\n }\n\n // Process favicon update (always return 200 to webhook)\n const result = await faviconController.processFaviconUpdate(pageId);\n\n // Always return 200 OK to Notion webhook (even on errors)\n // Errors are logged as notes in the page itself\n return c.json({\n success: result.success,\n iconUpdated: result.iconUpdated,\n errorNoteAdded: result.errorNoteAdded,\n successNoteAdded: result.successNoteAdded,\n message: result.success\n ? \"Favicon updated successfully\"\n : `Favicon update failed: ${result.error}`\n }, 200);\n\n } catch (err: any) {\n // Even on unexpected errors, return 200 to prevent webhook retries\n console.error('Unexpected error in favicon webhook:', err);\n return c.json({\n success: false,\n error: \"Internal server error\",\n details: err.message\n }, 200);\n }\n});\n\nexport default favicon;\n",[],[210,598,614,631],"1cb955b0-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[250,251,252,253],[210,598,614],"fd17b930-b4f0-11f0-8e48-0224a6c84d84","019a26dc-99bf-7269-a8f6-01b5d543f467","019a26dc-99bf-7269-a8f6-0782b134ef20",["D",1761760757953],"import { Hono } from \"npm:hono@4\";\nimport * as pageController from '../../controllers/pageController.ts';\n\nconst pages = new Hono();\n\n/**\n * GET /api/pages/recent\n * Get pages edited within the last X hours\n * Filters out:\n * - Database objects\n * - Archived pages\n * - Pages inside TODOS_DB_ID database\n *\n * Query parameters:\n * - hours (optional): Number of hours to look back (default: 24)\n *\n * Response:\n * {\n * pages: [{ id, object, title, url, last_edited_time, parent }],\n * count: number,\n * timeRange: string\n * }\n */\npages.get('/recent', async (c) => {\n // Extract hours parameter from query string\n const hoursParam = c.req.query('hours');\n let hours: number | undefined = undefined;\n\n if (hoursParam) {\n hours = parseInt(hoursParam, 10);\n\n // Validate that it's a valid number\n if (isNaN(hours)) {\n return c.json({\n error: \"Invalid hours parameter\",\n details: \"hours must be a valid number\"\n }, 400);\n }\n }\n\n // Call controller\n const result = await pageController.getRecentPages(hours);\n\n if (!result.success) {\n return c.json({\n error: result.error,\n details: result.details\n }, 500);\n }\n\n return c.json(result.data);\n});\n\n// GET /api/pages/:id - Get a Notion page\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 - Update a Notion page\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\n// GET /api/pages/:id/content - Get page blocks\npages.get('/:id/content', async (c) => {\n const pageId = c.req.param('id');\n const result = await pageController.getPageContent(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\nexport default pages;\n",[],[210,598,648,550],"api","43d12b70-b962-11f0-8efb-0224a6c84d84","019a26dc-99bf-7269-a8f5-fdd1422bebc3",["D",1762249214392],"import { Hono } from \"npm:hono@4\";\nimport pages from './pages.ts';\nimport health from './health.ts';\n\nconst api = new Hono();\n\n// Mount health check at /api/health\napi.route('/health', health);\n\n// Mount page routes at /api/pages\napi.route('/pages', pages);\n\n// Add more routes here as needed\n// Example:\n// import databases from './databases.ts';\n// api.route('/databases', databases);\n\nexport default api;\n",[],[210,598,648,558],"a9435710-f613-11f0-b05a-42dde27851f2","health.ts","43d0f498-b962-11f0-8efb-0224a6c84d84",["D",1768922475258],"import { Hono } from \"npm:hono@4\";\nimport * as healthController from '../../controllers/healthController.ts';\n\nconst health = new Hono();\n\n/**\n * GET /api/health\n * System health check endpoint\n *\n * Property-centric response showing:\n * - Connection status (Notion API)\n * - Database status (todos database)\n * - All expected properties with their state\n * - Discovered relations with page counts\n * - Settings configuration\n *\n * Use for:\n * - Monitoring system status\n * - Debugging connection issues\n * - Validating property configuration\n */\nhealth.get('/', async (c) => {\n const result = await healthController.getSystemHealth();\n return c.json(result);\n});\n\nexport default health;\n",[],[210,598,648,656],"1cb95484-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[246,247,248],[210,598,648],"1cb95e2a-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[245,249,254,255],[210,598],"951b54c2-eb0f-11f0-8d70-42dde27851f2","todoSync.cron.ts","fd17812c-b4f0-11f0-8e48-0224a6c84d84","019a311f-c8bf-720b-97f6-3e820327a344",228,["D",1767711260690],"interval","import * as todoSaveController from '../controllers/todoSaveController.ts';\n\n/**\n * Cron: Sync todo blobs to Notion database\n *\n * Recommended schedule: Less frequent than search cron (e.g., every 8-12 hours)\n */\nexport default async function() {\n if (Deno.env.get(\"CRONS_DISABLED\") === \"true\") {\n console.log(\"[Sync] Skipped - CRONS_DISABLED=true\");\n return;\n }\n\n try {\n const result = await todoSaveController.processTodoSave();\n\n if (!result.success) {\n console.error(`[Sync] ERROR: ${result.error}${result.details ? ` - ${result.details}` : ''}`);\n return;\n }\n\n // Single summary line\n console.log(`[Sync] ${result.pagesCreated} created, ${result.pagesUpdated} updated, ${result.pagesSkipped} skipped, ${result.pagesFailed} failed (${result.totalBlobs} blobs)`);\n\n // Log failures if any\n if (result.failures && result.failures.length > 0) {\n result.failures.forEach((failure: any) => {\n console.error(` ✗ ${failure.blockId}: ${failure.error}`);\n });\n }\n } catch (err: any) {\n console.error(`[Sync] ERROR: ${err.message}`);\n }\n}\n",[],[210,680,671],"crons","951b4aa4-eb0f-11f0-8d70-42dde27851f2","todoSearch.cron.ts","fd177934-b4f0-11f0-8e48-0224a6c84d84",["D",1767711260690],"import * as todoOrchestrationController from '../controllers/todoOrchestrationController.ts';\n\n/**\n * Cron: Search for todos in recent pages and save to blob storage\n *\n * Lookback window: 15 minutes (cron runs frequently)\n * Schedule: Set in Val Town UI (runs every minute)\n */\nexport default async function() {\n if (Deno.env.get(\"CRONS_DISABLED\") === \"true\") {\n console.log(\"[Search] Skipped - CRONS_DISABLED=true\");\n return;\n }\n\n try {\n const result = await todoOrchestrationController.processBatchSearch(0.25);\n\n if (!result.success) {\n console.error(`[Search] ERROR: ${result.error}${result.details ? ` - ${result.details}` : ''}`);\n return;\n }\n\n // Single summary line\n const summary = `[Search] ${result.totalNew || 0} new, ${result.totalUpdated || 0} updated, ${result.totalSkipped || 0} skipped (${result.pagesSearched} pages)`;\n\n // Only log page details when there's actual work\n const pagesWithChanges = result.searchResults.filter(r => r.blocksFound > 0);\n if (pagesWithChanges.length > 0) {\n console.log(summary);\n pagesWithChanges.forEach(page => {\n console.log(` ${page.pageTitle}: ${page.blocksNew || 0} new, ${page.blocksUpdated || 0} updated`);\n });\n } else {\n console.log(summary);\n }\n } catch (err: any) {\n console.error(`[Search] ERROR: ${err.message}`);\n }\n}\n",[],[210,680,682],"fd1792f2-b4f0-11f0-8e48-0224a6c84d84",["D",1761760757953],[242,243],[210,680],"a9427534-f613-11f0-b05a-42dde27851f2","todoSaveController.ts","158284c0-b459-11f0-a09c-0224a6c84d84","019a26dc-99bf-7269-a8f5-f9aacbe46421",["D",1768922475258],59,"import * as notionService from '../services/notion/index.ts';\nimport * as blobService from '../services/blobService.ts';\nimport * as aiService from '../services/aiService.ts';\nimport { logger } from '../utils/logger.ts';\nimport { discoverRelationProperties, getDatabasePageIds, getPropertyType } from '../services/notion/relations.ts';\nimport { getStatusPropertyInfo, getDatabaseSchema, findPropertyByName, type StatusPropertyInfo, type SchemaProperty } from '../services/notion/databases.ts';\nimport { findUserByName, findUserById } from '../services/notion/users.ts';\nimport type { TodoSaveResult, ReducedNotionBlock, RelationPropertyMapping, RelationMatchResult, ResolvedOwner, SummaryResult } from '../../shared/types.ts';\nimport { extractFirstEmoji } from '../utils/emojiUtils.ts';\nimport { getBlockBackgroundColor } from '../utils/blockUtils.ts';\nimport { mapReducedBlockToProperties, extractPageIdFromUrl, reduceNotionBlock } from '../utils/notionUtils.ts';\nimport { extractBlockIdFromKey } from '../utils/blobUtils.ts';\nimport { disambiguateProjectsByGroup, type ProjectWithDates } from '../utils/projectUtils.ts';\nimport { TODOS_PROPERTIES, REQUIRED_PROPERTY_KEYS } from '../utils/notionConfig.ts';\nimport { traverseParentsForOwnerCandidates, validateOwnerClaim, type PageNameEntry } from '../utils/contextUtils.ts';\n\n/**\n * Enhance Notion API errors with helpful context about property type mismatches\n */\nfunction enhanceNotionError(error: string): string {\n // Check if this looks like a property type validation error\n if (error.includes('body.properties.') && error.includes('should be')) {\n // Extract property name from error like \"body.properties.Due date.date should be...\"\n const propertyMatch = error.match(/body\\.properties\\.([^.]+)/);\n const propertyName = propertyMatch?.[1] || 'unknown';\n\n return `Property type mismatch for \"${propertyName}\". ` +\n `Check that the column type in your Notion database matches what the code expects. ` +\n `Original error: ${error}`;\n }\n\n // Check for validation errors\n if (error.includes('validation') || error.includes('Invalid')) {\n return `Notion API validation error. This may indicate a property type mismatch ` +\n `between your database schema and the code. Original error: ${error}`;\n }\n\n return error;\n}\n\n// Type for project with all details needed for matching\ntype ProjectWithDetails = {\n id: string;\n name: string;\n groupName: string | null;\n dateStart: string | null;\n dateEnd: string | null;\n lastEditedTime: string;\n};\n\n/**\n * Page name entry for fuzzy matching\n */\ntype PageNameEntry = {\n id: string;\n name: string;\n nameLower: string; // Pre-computed lowercase for matching\n};\n\n/**\n * Relation schema cache - initialized once per save operation\n * Contains discovered relations and their target database page IDs\n */\ntype RelationCache = {\n // Discovered relations from todos database schema\n relations: RelationPropertyMapping[];\n // Map of targetDatabaseId -> Set of page IDs in that database\n targetDbPageIds: Map<string, Set<string>>;\n // Project details for AI matching (only for project relations)\n projectsWithDetails: Map<string, ProjectWithDetails[]>;\n // Page names for fuzzy matching (only for configured fuzzyMatch relations)\n // Map of propertyName -> array of page name entries\n fuzzyMatchNames: Map<string, PageNameEntry[]>;\n // Owner property configuration (detected at runtime)\n ownerPropertyType: 'people' | 'relation' | null;\n ownerTargetDbId?: string; // Only populated if owner is relation type\n // Status property configuration for checkbox sync (detected at runtime)\n statusInfo: StatusPropertyInfo | null;\n // Validated property names - only set properties exist in database\n // key = TODOS_PROPERTIES key, value = actual column name or null if not found\n validatedProperties: Record<string, string | null>;\n};\n\n/**\n * Initialize relation cache by discovering relations from todos database schema\n *\n * @param todosDbId - Todos database ID\n * @returns Relation cache or null if discovery fails\n */\nasync function initializeRelationCache(todosDbId: string): Promise<RelationCache | null> {\n // Get database schema for property validation\n const schemaResult = await getDatabaseSchema(todosDbId);\n if (!schemaResult.success) {\n logger.error(`Failed to get database schema: ${schemaResult.error}`);\n return null;\n }\n\n // Validate all configured properties against database schema\n const validatedProperties: Record<string, string | null> = {};\n\n for (const [key, configuredName] of Object.entries(TODOS_PROPERTIES)) {\n if (configuredName && typeof configuredName === 'string') {\n const found = findPropertyByName(schemaResult.properties, configuredName);\n validatedProperties[key] = found ? found.name : null;\n } else {\n validatedProperties[key] = null; // Property not configured\n }\n }\n\n // Check if required properties exist (REQUIRED_PROPERTY_KEYS from notionConfig.ts)\n const missingRequired = REQUIRED_PROPERTY_KEYS.filter(k => {\n const configuredName = (TODOS_PROPERTIES as Record<string, any>)[k];\n return configuredName && !validatedProperties[k];\n });\n\n if (missingRequired.length > 0) {\n const missing = missingRequired.map(k => `${k}=\"${(TODOS_PROPERTIES as Record<string, any>)[k]}\"`).join(', ');\n logger.error(`Sync cannot proceed - required properties not found: ${missing}. Run health check for fix suggestions.`);\n return null;\n }\n\n // Log property validation summary\n const foundProps = Object.entries(validatedProperties).filter(([k, v]) => v && (TODOS_PROPERTIES as Record<string, any>)[k]);\n const missingProps = Object.entries(validatedProperties).filter(([k, v]) => !v && (TODOS_PROPERTIES as Record<string, any>)[k]);\n logger.info(`Properties: ${foundProps.length} found${missingProps.length > 0 ? `, ${missingProps.length} skipped` : ''}`);\n\n // Debug: show individual property mappings\n for (const [key, validatedName] of Object.entries(validatedProperties)) {\n const configuredName = (TODOS_PROPERTIES as Record<string, any>)[key];\n if (configuredName && typeof configuredName === 'string') {\n if (validatedName) {\n logger.debug(` ✓ ${key}: \"${configuredName}\" → found`);\n } else {\n logger.debug(` ⚠ ${key}: \"${configuredName}\" → not found (will skip)`);\n }\n }\n }\n\n // Discover relation properties from todos database schema\n const relationsResult = await discoverRelationProperties(todosDbId);\n\n if (!relationsResult.success) {\n logger.warn(`Failed to discover relations: ${relationsResult.error}`);\n return null;\n }\n\n const cache: RelationCache = {\n relations: relationsResult.relations,\n targetDbPageIds: new Map(),\n projectsWithDetails: new Map(),\n fuzzyMatchNames: new Map(),\n ownerPropertyType: null,\n ownerTargetDbId: undefined,\n statusInfo: null,\n validatedProperties\n };\n\n // Detect Owner property type for runtime owner resolution\n if (TODOS_PROPERTIES.owner) {\n const ownerTypeResult = await getPropertyType(todosDbId, TODOS_PROPERTIES.owner);\n if (ownerTypeResult.success && ownerTypeResult.propertyType) {\n if (ownerTypeResult.propertyType === 'people') {\n cache.ownerPropertyType = 'people';\n } else if (ownerTypeResult.propertyType === 'relation') {\n cache.ownerPropertyType = 'relation';\n cache.ownerTargetDbId = ownerTypeResult.relationTargetDbId || undefined;\n\n // If Owner is a relation, ensure we have fuzzy match names for its target DB\n if (cache.ownerTargetDbId) {\n const namesResult = await notionService.getDatabasePageNames(cache.ownerTargetDbId);\n if (namesResult.success && !cache.fuzzyMatchNames.has(TODOS_PROPERTIES.owner)) {\n const entries: PageNameEntry[] = namesResult.pages.map(p => ({\n id: p.id,\n name: p.name,\n nameLower: p.name.toLowerCase()\n }));\n cache.fuzzyMatchNames.set(TODOS_PROPERTIES.owner, entries);\n logger.debug(`Owner relation names loaded: ${entries.map(e => e.name).join(', ')}`);\n }\n }\n }\n logger.debug(`Owner property \"${TODOS_PROPERTIES.owner}\" is type: ${cache.ownerPropertyType}`);\n }\n }\n\n // Detect Status property configuration for checkbox sync\n if (TODOS_PROPERTIES.status) {\n const statusResult = await getStatusPropertyInfo(todosDbId, TODOS_PROPERTIES.status);\n if (statusResult.success && statusResult.data) {\n cache.statusInfo = statusResult.data;\n const stateInfo = statusResult.data.doneName\n ? ` (done=\"${statusResult.data.doneName}\"${statusResult.data.notDoneName ? `, notDone=\"${statusResult.data.notDoneName}\"` : ''})`\n : '';\n logger.info(`Status property \"${TODOS_PROPERTIES.status}\" is type: ${statusResult.data.type}${stateInfo}`);\n } else {\n logger.warn(`Status property \"${TODOS_PROPERTIES.status}\": ${statusResult.error}`);\n }\n }\n\n // For each relation, fetch the target database's page IDs\n for (const relation of relationsResult.relations) {\n // Get page IDs from target database\n const pageIdsResult = await getDatabasePageIds(relation.targetDatabaseId);\n if (pageIdsResult.success) {\n cache.targetDbPageIds.set(\n relation.targetDatabaseId,\n new Set(pageIdsResult.pageIds)\n );\n }\n\n // For project relations, also fetch full details for AI matching\n if (relation.isProjectRelation) {\n const detailsResult = await notionService.getProjectsWithDetails(relation.targetDatabaseId);\n if (detailsResult.success) {\n cache.projectsWithDetails.set(relation.targetDatabaseId, detailsResult.projects);\n }\n }\n }\n\n // Load page names for fuzzy match relations\n const fuzzyMatchConfig = TODOS_PROPERTIES.fuzzyMatch || [];\n for (const propertyName of fuzzyMatchConfig) {\n // Find the relation in discovered schema\n const relation = relationsResult.relations.find(r => r.propertyName === propertyName);\n\n if (!relation) {\n logger.warn(`Fuzzy match relation \"${propertyName}\" not found in database schema - skipping`);\n continue;\n }\n\n // Fetch page names from target database\n const namesResult = await notionService.getDatabasePageNames(relation.targetDatabaseId);\n if (namesResult.success) {\n const entries: PageNameEntry[] = namesResult.pages.map(p => ({\n id: p.id,\n name: p.name,\n nameLower: p.name.toLowerCase()\n }));\n cache.fuzzyMatchNames.set(propertyName, entries);\n }\n }\n\n // Log discovered relations\n logger.info(`Discovered ${cache.relations.length} relation(s)`);\n for (const rel of cache.relations) {\n const pageCount = cache.targetDbPageIds.get(rel.targetDatabaseId)?.size || 0;\n const fuzzyCount = cache.fuzzyMatchNames.get(rel.propertyName)?.length;\n const extras = [\n rel.isProjectRelation ? 'project' : null,\n fuzzyCount !== undefined ? `fuzzy: ${fuzzyCount} names` : null\n ].filter(Boolean).join(', ');\n logger.debug(` - ${rel.propertyName} → ${pageCount} pages${extras ? ` (${extras})` : ''}`);\n }\n\n return cache;\n}\n\n/**\n * Match a block to relations dynamically\n *\n * Strategies (in priority order):\n * 1. Explicit mention mapping - @mention a page, check its parent DB against relation targets\n * 2. Contextual mapping - Source page's DB matches a relation target\n * 3. Fuzzy name matching - Check todo text and parent blocks for name matches (configured relations)\n * 4. AI fuzzy matching (project relations only) - Semantic matching with date disambiguation\n * 5. Parent block traversal (project relations only) - Apply 1-4 to parent blocks\n *\n * @param blockData - Reduced block with enriched link_mentions\n * @param cache - Relation cache\n * @returns Array of relation match results\n */\nasync function matchBlockToRelations(\n blockData: ReducedNotionBlock,\n cache: RelationCache | null\n): Promise<RelationMatchResult[]> {\n if (!cache || cache.relations.length === 0) {\n return [];\n }\n\n const results: RelationMatchResult[] = [];\n const matchedMentionPageIds = new Set<string>();\n\n // Strategy 1: Explicit mention mapping\n // Check each link mention's parentDatabaseId against relation targets\n for (const linkMention of blockData.link_mentions || []) {\n if (!linkMention.pageId || !linkMention.parentDatabaseId) continue;\n\n // Find which relation this mention's parent DB matches\n for (const relation of cache.relations) {\n if (linkMention.parentDatabaseId === relation.targetDatabaseId) {\n // Verify the page exists in the target database\n const targetPageIds = cache.targetDbPageIds.get(relation.targetDatabaseId);\n if (targetPageIds?.has(linkMention.pageId)) {\n // This mention matches this relation\n let existingResult = results.find(r => r.propertyName === relation.propertyName);\n if (!existingResult) {\n existingResult = { propertyName: relation.propertyName, pageIds: [], matchType: 'mention' };\n results.push(existingResult);\n }\n if (!existingResult.pageIds.includes(linkMention.pageId)) {\n existingResult.pageIds.push(linkMention.pageId);\n }\n matchedMentionPageIds.add(linkMention.pageId);\n }\n break; // A mention can only match one relation\n }\n }\n }\n\n // Strategy 2: Contextual mapping (source page's DB)\n if (blockData.source_page_database_id) {\n for (const relation of cache.relations) {\n if (blockData.source_page_database_id === relation.targetDatabaseId) {\n // Source page is in this relation's target DB\n const sourcePageId = extractPageIdFromUrl(blockData.page_url || '');\n if (sourcePageId) {\n // Check if we already have matches for this relation\n let existingResult = results.find(r => r.propertyName === relation.propertyName);\n if (!existingResult) {\n existingResult = { propertyName: relation.propertyName, pageIds: [], matchType: 'contextual' };\n results.push(existingResult);\n }\n if (!existingResult.pageIds.includes(sourcePageId)) {\n existingResult.pageIds.push(sourcePageId);\n }\n }\n }\n }\n }\n\n // Strategy 3: Fuzzy name matching (configured relations only)\n // Check todo text and parent blocks for names matching pages in configured relations\n if (cache.fuzzyMatchNames.size > 0) {\n const alreadyMatchedRelations = new Set(results.map(r => r.propertyName));\n const fuzzyResults = await fuzzyMatchRelations(blockData, cache, alreadyMatchedRelations);\n results.push(...fuzzyResults);\n }\n\n // Strategy 4 & 5: AI matching + Parent traversal (project relations only)\n for (const relation of cache.relations) {\n if (!relation.isProjectRelation) continue;\n\n // Skip if we already have matches for this relation from strategies 1-3\n const existingResult = results.find(r => r.propertyName === relation.propertyName);\n if (existingResult && existingResult.pageIds.length > 0) {\n continue;\n }\n\n const projectsWithDetails = cache.projectsWithDetails.get(relation.targetDatabaseId) || [];\n const projectPageIds = cache.targetDbPageIds.get(relation.targetDatabaseId) || new Set();\n\n if (projectsWithDetails.length === 0) continue;\n\n // Try AI matching on the block itself\n let matchedProjectIds = await matchBlockToProjects(\n blockData,\n projectPageIds,\n projectsWithDetails\n );\n\n // Strategy 4: Parent traversal if no match\n if (matchedProjectIds.length === 0 && blockData.parent_id) {\n matchedProjectIds = await traverseParentsForProjectMatch(\n blockData.parent_id,\n blockData.date_mentions,\n projectPageIds,\n projectsWithDetails\n );\n }\n\n if (matchedProjectIds.length > 0) {\n results.push({\n propertyName: relation.propertyName,\n pageIds: matchedProjectIds,\n matchType: 'ai'\n });\n }\n }\n\n return results;\n}\n\n/**\n * Traverse parent blocks to find project matches\n * Used only for project-type relations\n *\n * @param startParentId - Starting parent block ID\n * @param todoDueDates - Todo's due dates (used for date disambiguation)\n * @param projectPageIds - Set of known project page IDs\n * @param projectsWithDetails - Array of projects with details for AI matching\n * @returns Array of matched project IDs\n */\nasync function traverseParentsForProjectMatch(\n startParentId: string,\n todoDueDates: string[] | undefined,\n projectPageIds: Set<string>,\n projectsWithDetails: ProjectWithDetails[]\n): Promise<string[]> {\n let currentParentId: string | null = startParentId;\n const maxDepth = 5; // Prevent infinite loops\n\n for (let depth = 0; depth < maxDepth && currentParentId; depth++) {\n // Fetch parent block from Notion\n const parentResult = await notionService.getBlock(currentParentId);\n if (!parentResult.success || !parentResult.data) {\n break;\n }\n\n const parentBlock = parentResult.data;\n\n // Reduce parent block and apply matching strategies 1-3\n const parentReduced = reduceNotionBlock(parentBlock);\n\n const parentMatches = await matchBlockToProjects(\n {\n ...parentReduced,\n date_mentions: todoDueDates // Use todo's due date\n },\n projectPageIds,\n projectsWithDetails\n );\n\n if (parentMatches.length > 0) {\n return parentMatches;\n }\n\n // Move up to next parent (if it's a block, not a page)\n const parentParent = (parentBlock as any).parent;\n currentParentId = parentParent?.type === 'block_id' ? parentParent.block_id : null;\n }\n\n return [];\n}\n\n/**\n * Find fuzzy name matches in text, grouped by the matching word\n * Returns a map of word → matching page entries\n * This allows disambiguation only when the SAME word matches multiple contacts\n *\n * Uses EXACT word matching (not substring) to avoid false positives like:\n * - \"is\" matching \"chrIS pollara\"\n * - \"also\" matching \"als\" in \"Jillian Als\"\n *\n * @param text - Text to search (todo content or parent block content)\n * @param names - Array of page name entries to match against\n * @returns Map of word → matching page entries\n */\nfunction findFuzzyMatches(text: string, names: PageNameEntry[]): Map<string, PageNameEntry[]> {\n const textLower = text.toLowerCase();\n const textWords = textLower.split(/\\s+/).filter(w => w.length >= 2); // Skip very short words\n\n const matchesByWord = new Map<string, PageNameEntry[]>();\n\n for (const textWord of textWords) {\n for (const entry of names) {\n const nameWords = entry.nameLower.split(/\\s+/);\n\n // Check if any text word EXACTLY matches any name word\n // \"alex\" matches \"alex johnson\" ✓\n // \"is\" does NOT match \"chris pollara\" ✓\n const matched = nameWords.some(nameWord =>\n nameWord.length >= 2 && textWord === nameWord\n );\n\n if (matched) {\n if (!matchesByWord.has(textWord)) {\n matchesByWord.set(textWord, []);\n }\n // Avoid duplicates within same word\n const wordMatches = matchesByWord.get(textWord)!;\n if (!wordMatches.some(e => e.id === entry.id)) {\n wordMatches.push(entry);\n }\n }\n }\n }\n\n return matchesByWord;\n}\n\n/**\n * Find a contact by name using exact word matching\n * Used to map workspace users (Owner, @mentions) to Contact pages\n *\n * @param name - Person name to search for\n * @param contactNames - Array of contact page name entries\n * @returns Matching contact entry or null\n */\nfunction findContactByName(name: string, contactNames: PageNameEntry[]): PageNameEntry | null {\n const nameLower = name.toLowerCase();\n const nameWords = nameLower.split(/\\s+/);\n\n // Exact match first\n const exactMatch = contactNames.find(c => c.nameLower === nameLower);\n if (exactMatch) return exactMatch;\n\n // Word match (first name or last name)\n for (const contact of contactNames) {\n const contactWords = contact.nameLower.split(/\\s+/);\n if (nameWords.some(nw => contactWords.some(cw => cw === nw && nw.length >= 2))) {\n return contact;\n }\n }\n\n return null;\n}\n\n/**\n * Add resolved owner and @mentioned people to Contacts relation\n * This preserves connections even if Owner is later changed in the todos database\n *\n * @param resolvedOwner - Resolved owner (people or relation type)\n * @param peopleMentions - @mentions from block text\n * @param relationMatches - Existing relation matches to merge into\n * @param cache - Relation cache with contact names\n */\nasync function addPeopleToContactsRelation(\n resolvedOwner: ResolvedOwner | null,\n peopleMentions: Array<{id: string; name: string | null}>,\n relationMatches: RelationMatchResult[],\n cache: RelationCache\n): Promise<void> {\n // Find the first fuzzy match relation to use as \"Contacts\"\n const fuzzyMatchProps = TODOS_PROPERTIES.fuzzyMatch || [];\n if (fuzzyMatchProps.length === 0) return;\n\n const contactsPropName = fuzzyMatchProps[0];\n const contactNames = cache.fuzzyMatchNames.get(contactsPropName);\n if (!contactNames || contactNames.length === 0) return;\n\n const contactIdsToAdd: string[] = [];\n\n // 1. Add Owner to Contacts\n if (resolvedOwner) {\n if (resolvedOwner.type === 'relation') {\n // Owner is already a page ID - add directly\n contactIdsToAdd.push(resolvedOwner.value[0].id);\n logger.debug(`Adding owner (relation) to Contacts: ${resolvedOwner.value[0].id}`);\n } else if (resolvedOwner.type === 'people') {\n // Owner is a workspace user - look up name and fuzzy match\n const userId = resolvedOwner.value[0].id;\n const userResult = await findUserById(userId);\n if (userResult.success && userResult.user?.name) {\n const match = findContactByName(userResult.user.name, contactNames);\n if (match) {\n contactIdsToAdd.push(match.id);\n logger.debug(`Adding owner \"${userResult.user.name}\" to Contacts: ${match.name}`);\n }\n }\n }\n }\n\n // 2. Add Other People (@mentions) to Contacts\n for (const mention of peopleMentions) {\n if (mention.name) {\n const match = findContactByName(mention.name, contactNames);\n if (match && !contactIdsToAdd.includes(match.id)) {\n contactIdsToAdd.push(match.id);\n logger.debug(`Adding @mention \"${mention.name}\" to Contacts: ${match.name}`);\n }\n }\n }\n\n // 3. Merge into existing relation match (deduplicated)\n if (contactIdsToAdd.length > 0) {\n let existingMatch = relationMatches.find(r => r.propertyName === contactsPropName);\n if (!existingMatch) {\n existingMatch = { propertyName: contactsPropName, pageIds: [], matchType: 'mention' };\n relationMatches.push(existingMatch);\n }\n for (const id of contactIdsToAdd) {\n if (!existingMatch.pageIds.includes(id)) {\n existingMatch.pageIds.push(id);\n }\n }\n logger.debug(`Contacts relation now has ${existingMatch.pageIds.length} entries`);\n }\n}\n\n/**\n * Apply fuzzy name matching for configured relations\n * Checks todo text and parent blocks for name matches\n * Groups matches by source word - only disambiguates when same word matches multiple contacts\n *\n * @param blockData - Reduced block data\n * @param cache - Relation cache with fuzzyMatchNames\n * @param alreadyMatchedRelations - Set of relation property names already matched by other strategies\n * @returns Array of relation match results\n */\nasync function fuzzyMatchRelations(\n blockData: ReducedNotionBlock,\n cache: RelationCache,\n alreadyMatchedRelations: Set<string>\n): Promise<RelationMatchResult[]> {\n const results: RelationMatchResult[] = [];\n\n // Process each configured fuzzy match relation\n for (const [propertyName, names] of cache.fuzzyMatchNames.entries()) {\n // Skip if already matched by explicit mention or contextual mapping\n if (alreadyMatchedRelations.has(propertyName)) {\n continue;\n }\n\n if (names.length === 0) continue;\n\n // Build search text from todo and preceding heading (for context)\n const searchText = [\n blockData.todo_string,\n blockData.preceding_heading\n ].filter(Boolean).join(' ');\n\n // First, check the combined search text\n let matchesByWord = findFuzzyMatches(searchText, names);\n\n // If no match in todo text, check parent blocks\n if (matchesByWord.size === 0 && blockData.parent_id) {\n matchesByWord = await traverseParentsForFuzzyMatch(blockData.parent_id, names);\n }\n\n if (matchesByWord.size === 0) continue;\n\n // Process each word's matches separately\n // This allows \"Alex to talk to Jordan\" to match BOTH Alex and Jordan\n const allPageIds: string[] = [];\n\n for (const [word, wordMatches] of matchesByWord) {\n if (wordMatches.length === 1) {\n // Single match for this word - use it\n allPageIds.push(wordMatches[0].id);\n } else if (wordMatches.length > 1) {\n // True ambiguity - same word matches multiple contacts (e.g., \"John\" matches John Smith and John Doe)\n const disambiguatedId = await aiService.disambiguateFuzzyMatch(\n searchText,\n wordMatches.map(m => ({ id: m.id, name: m.name }))\n );\n if (disambiguatedId) {\n allPageIds.push(disambiguatedId);\n }\n }\n }\n\n // Deduplicate and add to results\n const uniqueIds = [...new Set(allPageIds)];\n if (uniqueIds.length > 0) {\n results.push({\n propertyName,\n pageIds: uniqueIds,\n matchType: 'mention'\n });\n }\n }\n\n return results;\n}\n\n/**\n * Traverse parent blocks to find fuzzy name matches\n *\n * @param startParentId - Starting parent block ID\n * @param names - Array of page name entries to match against\n * @returns Map of word → matching page entries (empty map if none found)\n */\nasync function traverseParentsForFuzzyMatch(\n startParentId: string,\n names: PageNameEntry[]\n): Promise<Map<string, PageNameEntry[]>> {\n let currentParentId: string | null = startParentId;\n const maxDepth = 5;\n\n for (let depth = 0; depth < maxDepth && currentParentId; depth++) {\n const parentResult = await notionService.getBlock(currentParentId);\n if (!parentResult.success || !parentResult.data) {\n break;\n }\n\n const parentBlock = parentResult.data;\n const parentReduced = reduceNotionBlock(parentBlock);\n\n const matchesByWord = findFuzzyMatches(parentReduced.todo_string, names);\n if (matchesByWord.size > 0) {\n return matchesByWord;\n }\n\n // Move up to next parent\n const parentParent = (parentBlock as any).parent;\n currentParentId = parentParent?.type === 'block_id' ? parentParent.block_id : null;\n }\n\n return new Map();\n}\n\n/**\n * Helper to match a block to projects using strategies 1, 2, and 3\n *\n * @param blockData - Block data with link_mentions, page_url, todo_string, and date_mentions\n * @param projectPageIds - Set of known project page IDs\n * @param projectsWithDetails - Array of projects with names, dates for AI matching\n * @returns Array of matched project IDs\n */\nasync function matchBlockToProjects(\n blockData: { link_mentions?: Array<{ url: string }>; page_url?: string; todo_string: string; date_mentions?: string[] },\n projectPageIds: Set<string>,\n projectsWithDetails: ProjectWithDetails[]\n): Promise<string[]> {\n const matchedProjectIds: string[] = [];\n\n // Strategy 1: Check link_mentions for project references\n if (projectPageIds.size > 0 && blockData.link_mentions?.length) {\n for (const link of blockData.link_mentions) {\n const mentionedPageId = extractPageIdFromUrl(link.url);\n if (mentionedPageId) {\n const normalizedId = mentionedPageId.replace(/-/g, '');\n if (projectPageIds.has(normalizedId)) {\n matchedProjectIds.push(normalizedId);\n }\n }\n }\n }\n\n // Strategy 2: Check if page_url is a project\n if (matchedProjectIds.length === 0 && blockData.page_url && projectPageIds.size > 0) {\n const sourcePageId = extractPageIdFromUrl(blockData.page_url);\n if (sourcePageId) {\n const normalizedId = sourcePageId.replace(/-/g, '');\n if (projectPageIds.has(normalizedId)) {\n matchedProjectIds.push(normalizedId);\n }\n }\n }\n\n // Strategy 3: AI fuzzy matching (with group disambiguation)\n if (matchedProjectIds.length === 0 && projectsWithDetails.length > 0) {\n const aiMatch = await aiService.matchTodoToProject(\n blockData.todo_string,\n projectsWithDetails\n );\n\n if (aiMatch) {\n if (aiMatch.startsWith('GROUP:')) {\n // AI matched a group, not a specific project - disambiguate using due date\n const groupName = aiMatch.substring(6);\n const todoDueDate = blockData.date_mentions?.[0] || null;\n\n const result = disambiguateProjectsByGroup(\n groupName,\n projectsWithDetails,\n todoDueDate\n );\n\n if (result.needsAiDisambiguation && result.candidates) {\n // Multiple overlapping date ranges - use AI to pick\n const bestProjectId = await aiService.disambiguateOverlappingProjects(\n blockData.todo_string,\n result.candidates\n );\n matchedProjectIds.push(bestProjectId);\n } else if (result.projectId) {\n matchedProjectIds.push(result.projectId);\n }\n } else {\n // AI matched a specific project - trust its semantic choice\n matchedProjectIds.push(aiMatch);\n }\n }\n }\n\n return matchedProjectIds;\n}\n\n/**\n * Try to resolve owner directly from heading (pre-AI deterministic check)\n *\n * If the heading matches a name in the owner database, returns the resolved owner\n * without needing AI involvement. This ensures heading-based ownership is deterministic.\n *\n * @param heading - The preceding heading text (e.g., \"### Alex\")\n * @param cache - Relation cache with owner property info\n * @returns Resolved owner or null if no match\n */\nasync function tryResolveOwnerFromHeading(\n heading: string | null,\n cache: RelationCache | null\n): Promise<{ resolved: ResolvedOwner; ownerName: string } | null> {\n if (!heading || !cache || !cache.ownerPropertyType) {\n return null;\n }\n\n // Clean heading (remove markdown heading markers)\n const cleanHeading = heading.replace(/^#+\\s*/, '').trim().toLowerCase();\n if (!cleanHeading) {\n return null;\n }\n\n logger.debug(`tryResolveOwnerFromHeading: checking heading \"${cleanHeading}\" against ${cache.ownerPropertyType} type`);\n\n if (cache.ownerPropertyType === 'people') {\n // Check workspace users\n const userResult = await findUserByName(cleanHeading);\n if (userResult.success && userResult.user) {\n logger.debug(`tryResolveOwnerFromHeading: matched heading to user \"${userResult.user.name}\"`);\n return {\n resolved: { type: 'people', value: [{ id: userResult.user.id }] },\n ownerName: userResult.user.name\n };\n }\n } else if (cache.ownerPropertyType === 'relation') {\n // Check pages in owner relation's target database\n const ownerNames = cache.fuzzyMatchNames.get(TODOS_PROPERTIES.owner);\n if (ownerNames && ownerNames.length > 0) {\n // Look for exact or close match\n for (const entry of ownerNames) {\n // Exact match\n if (entry.nameLower === cleanHeading) {\n logger.debug(`tryResolveOwnerFromHeading: exact match to \"${entry.name}\"`);\n return {\n resolved: { type: 'relation', value: [{ id: entry.id }] },\n ownerName: entry.name\n };\n }\n // Any word match (heading \"Bryce\" matches \"Steel: Bryce Sullivan\")\n const entryWords = entry.nameLower.split(/\\s+/);\n if (entryWords.some(word => word === cleanHeading)) {\n logger.debug(`tryResolveOwnerFromHeading: word match to \"${entry.name}\"`);\n return {\n resolved: { type: 'relation', value: [{ id: entry.id }] },\n ownerName: entry.name\n };\n }\n }\n } else {\n logger.debug(`tryResolveOwnerFromHeading: no owner names loaded for \"${TODOS_PROPERTIES.owner}\"`);\n }\n }\n\n logger.debug(`tryResolveOwnerFromHeading: no match found for heading \"${cleanHeading}\"`);\n return null;\n}\n\n/**\n * Resolve owner from AI summary to appropriate property format\n *\n * Handles both Person and Relation property types:\n * - Person: Match against @mentions (have user IDs) or workspace users\n * - Relation: Match against pages in target database\n *\n * @param summaryResult - Structured result from AI summary generation\n * @param reducedBlock - Block data with people_mentions\n * @param cache - Relation cache with owner property info\n * @returns Resolved owner or null if no match\n */\nasync function resolveOwner(\n summaryResult: SummaryResult,\n reducedBlock: ReducedNotionBlock,\n cache: RelationCache | null\n): Promise<ResolvedOwner | null> {\n // No owner name extracted from summary\n if (!summaryResult.ownerName) {\n logger.debug('resolveOwner: No ownerName in summaryResult');\n return null;\n }\n\n // No cache or owner property not detected\n if (!cache || !cache.ownerPropertyType) {\n logger.debug(`resolveOwner: No cache (${!cache}) or ownerPropertyType (${cache?.ownerPropertyType})`);\n return null;\n }\n\n logger.debug(`resolveOwner: ownerName=\"${summaryResult.ownerName}\", ownerSource=\"${summaryResult.ownerSource}\", propertyType=\"${cache.ownerPropertyType}\"`);\n\n const ownerNameLower = summaryResult.ownerName.toLowerCase().trim();\n\n if (cache.ownerPropertyType === 'people') {\n // Try to match against existing @mentions first (they have user IDs)\n if (reducedBlock.people_mentions && reducedBlock.people_mentions.length > 0) {\n for (const mention of reducedBlock.people_mentions) {\n if (!mention.name) continue;\n\n const mentionNameLower = mention.name.toLowerCase();\n // Check for exact or partial match\n if (mentionNameLower === ownerNameLower ||\n mentionNameLower.startsWith(ownerNameLower) ||\n mentionNameLower.split(' ')[0] === ownerNameLower) {\n return {\n type: 'people',\n value: [{ id: mention.id }]\n };\n }\n }\n }\n\n // Try author if ownerSource is 'heading' and no @mention match\n // (Author is often the owner when they're taking notes about someone else)\n if (summaryResult.ownerSource === 'heading' && reducedBlock.author?.id) {\n logger.debug(`resolveOwner: Checking author (id=${reducedBlock.author.id}) for heading-based owner`);\n // Look up author's name from cached workspace users (author.name is null in blob)\n const authorLookup = await findUserById(reducedBlock.author.id);\n logger.debug(`resolveOwner: Author lookup result: success=${authorLookup.success}, user=${authorLookup.user?.name || 'null'}, error=${authorLookup.error}`);\n if (authorLookup.success && authorLookup.user) {\n const authorNameLower = authorLookup.user.name.toLowerCase();\n const matches = authorNameLower === ownerNameLower ||\n authorNameLower.startsWith(ownerNameLower) ||\n authorNameLower.split(' ')[0] === ownerNameLower;\n logger.debug(`resolveOwner: Author name \"${authorLookup.user.name}\" vs ownerName \"${summaryResult.ownerName}\" - match=${matches}`);\n if (matches) {\n return {\n type: 'people',\n value: [{ id: reducedBlock.author.id }]\n };\n }\n }\n } else {\n logger.debug(`resolveOwner: Skipping author check (ownerSource=${summaryResult.ownerSource}, author.id=${reducedBlock.author?.id})`);\n }\n\n // Try workspace users lookup\n logger.debug(`resolveOwner: Trying findUserByName(\"${summaryResult.ownerName}\")`);\n const userResult = await findUserByName(summaryResult.ownerName);\n logger.debug(`resolveOwner: findUserByName result: success=${userResult.success}, user=${userResult.user?.name || 'null'}, error=${userResult.error}`);\n if (userResult.success && userResult.user) {\n return {\n type: 'people',\n value: [{ id: userResult.user.id }]\n };\n }\n\n // No match found for person type\n logger.warn(`resolveOwner: Could not resolve owner \"${summaryResult.ownerName}\" to a Notion user`);\n return null;\n\n } else if (cache.ownerPropertyType === 'relation') {\n // Match against pages in the owner relation's target database\n const ownerNames = cache.fuzzyMatchNames.get(TODOS_PROPERTIES.owner);\n if (!ownerNames || ownerNames.length === 0) {\n logger.warn('No page names loaded for Owner relation target database');\n return null;\n }\n\n // Find matching page(s)\n const matches: PageNameEntry[] = [];\n for (const entry of ownerNames) {\n // Check if owner name matches any word in page name (or vice versa)\n const entryWords = entry.nameLower.split(/\\s+/);\n const ownerWords = ownerNameLower.split(/\\s+/);\n\n // Exact match\n if (entry.nameLower === ownerNameLower) {\n matches.push(entry);\n continue;\n }\n\n // Partial match: any owner word matches any page name word\n const hasMatch = ownerWords.some(ow =>\n entryWords.some(ew => ew === ow || ew.startsWith(ow) || ow.startsWith(ew))\n );\n if (hasMatch) {\n matches.push(entry);\n }\n }\n\n if (matches.length === 0) {\n logger.warn(`Could not resolve owner \"${summaryResult.ownerName}\" to a page in Owner relation`);\n return null;\n }\n\n if (matches.length === 1) {\n return {\n type: 'relation',\n value: [{ id: matches[0].id }]\n };\n }\n\n // Multiple matches - use AI disambiguation\n const disambiguatedId = await aiService.disambiguateFuzzyMatch(\n reducedBlock.todo_string,\n matches.map(m => ({ id: m.id, name: m.name }))\n );\n\n if (disambiguatedId) {\n return {\n type: 'relation',\n value: [{ id: disambiguatedId }]\n };\n }\n\n // Fallback to first match if disambiguation fails\n return {\n type: 'relation',\n value: [{ id: matches[0].id }]\n };\n }\n\n return null;\n}\n\n/**\n * Process todo save: Read blobs and sync to Notion database\n * Creates new pages or updates existing pages based on timestamp comparison\n *\n * Status handling:\n * - CREATE: Sets Status to \"Not started\" for new pages\n * - UPDATE: Does NOT modify Status (preserves user changes)\n */\nexport async function processTodoSave(): Promise<TodoSaveResult> {\n // Get database ID from environment\n const databaseId = Deno.env.get('TODOS_DB_ID');\n\n if (!databaseId) {\n return {\n success: false,\n totalBlobs: 0,\n pagesCreated: 0,\n pagesUpdated: 0,\n pagesSkipped: 0,\n pagesFailed: 0,\n failures: [],\n error: \"Missing TODOS_DB_ID environment variable\",\n details: \"Set TODOS_DB_ID to the Notion database ID where todos should be saved\"\n };\n }\n\n\n // Initialize relation cache - auto-discovers all relations from todos database schema\n // Also validates that required properties exist in the database\n const relationCache = await initializeRelationCache(databaseId);\n\n // Fail fast if property validation failed (required properties missing)\n if (!relationCache) {\n return {\n success: false,\n totalBlobs: 0,\n pagesCreated: 0,\n pagesUpdated: 0,\n pagesSkipped: 0,\n pagesFailed: 0,\n failures: [],\n error: \"Property validation failed\",\n details: \"Required properties not found in database. Run health check for details.\"\n };\n }\n\n // List all todo blobs\n const blobsResult = await blobService.listBlocksByCategory('todo');\n\n if (!blobsResult.success || !blobsResult.keys) {\n return {\n success: false,\n totalBlobs: 0,\n pagesCreated: 0,\n pagesUpdated: 0,\n pagesSkipped: 0,\n pagesFailed: 0,\n failures: [],\n error: \"Failed to list blobs\",\n details: blobsResult.error || undefined\n };\n }\n\n const blobKeys = blobsResult.keys;\n\n let pagesCreated = 0;\n let pagesUpdated = 0;\n let pagesSkipped = 0;\n let pagesFailed = 0;\n const failures: Array<{ blockId: string; error: string }> = [];\n\n // Process each blob\n for (const key of blobKeys) {\n const blockId = extractBlockIdFromKey(key);\n\n try {\n // Get blob content\n const blobContentResult = await blobService.getBlockFromBlob('todo', blockId);\n\n if (!blobContentResult.success || !blobContentResult.data) {\n throw new Error(`Failed to get blob content: ${blobContentResult.error}`);\n }\n\n const reducedBlock: ReducedNotionBlock = blobContentResult.data;\n\n // OPTIMIZATION: Skip if already synced\n if (reducedBlock.sync_metadata?.synced === true) {\n pagesSkipped++;\n continue;\n }\n\n // NOTE: No validation needed here - all blobs are guaranteed valid\n // Validation happens during search phase (todoController.ts)\n // Only blocks with people_mentions AND date_mentions are saved to blob storage\n\n // Dynamic relation matching - handles all relations including projects\n // Strategies: 1) Explicit mentions, 2) Contextual, 3) AI matching, 4) Parent traversal\n const relationMatches = await matchBlockToRelations(reducedBlock, relationCache);\n\n // Generate AI-interpreted v2 todo\n // Gather context from block data and relation matches\n let matchedProjectName: string | null = null;\n const matchedContactNames: string[] = [];\n\n // Get project name from relation matches\n if (TODOS_PROPERTIES.projects && relationCache) {\n const projectMatch = relationMatches.find(r => r.propertyName === TODOS_PROPERTIES.projects);\n if (projectMatch && projectMatch.pageIds.length > 0) {\n const projectId = projectMatch.pageIds[0];\n // Look up project name in cache\n for (const [, projects] of relationCache.projectsWithDetails) {\n const project = projects.find(p => p.id === projectId);\n if (project) {\n matchedProjectName = project.name;\n break;\n }\n }\n }\n }\n\n // Get ALL contact names from fuzzy match relations (supports multiple contacts)\n const fuzzyMatchRelationNames = TODOS_PROPERTIES.fuzzyMatch || [];\n if (fuzzyMatchRelationNames.length > 0 && relationCache) {\n for (const relationName of fuzzyMatchRelationNames) {\n const contactMatch = relationMatches.find(r => r.propertyName === relationName);\n if (contactMatch && contactMatch.pageIds.length > 0) {\n // Look up ALL contact names in cache\n const names = relationCache.fuzzyMatchNames.get(relationName);\n if (names) {\n for (const contactId of contactMatch.pageIds) {\n const contact = names.find(n => n.id === contactId);\n if (contact && !matchedContactNames.includes(contact.name)) {\n matchedContactNames.push(contact.name);\n }\n }\n }\n }\n }\n }\n\n // =======================================================================\n // OWNER RESOLUTION (see backend/utils/contextUtils.ts for full documentation)\n // =======================================================================\n // Priority: 1. Heading match → 2. Contacts → 3. @mentions → 4. Parent blocks\n // AI only suggests owner; we validate claims against actual context.\n // If NO candidates exist anywhere, owner stays null (prevents hallucination).\n // =======================================================================\n\n // Step 1: PRE-AI CHECK - Try to resolve owner directly from heading (deterministic)\n logger.debug(`Owner resolution for block: heading=\"${reducedBlock.preceding_heading || 'none'}\", contacts=[${matchedContactNames.join(', ')}]`);\n const headingOwnerResult = await tryResolveOwnerFromHeading(\n reducedBlock.preceding_heading || null,\n relationCache\n );\n\n // Step 2: Check if there are any valid owner candidates from the block itself\n let hasOwnerCandidates =\n headingOwnerResult !== null ||\n matchedContactNames.length > 0 ||\n (reducedBlock.people_mentions?.length ?? 0) > 0;\n\n // Step 3: If no candidates in block, check parent blocks\n let parentOwnerCandidates: Array<{ name: string; source: string; id?: string }> = [];\n if (!hasOwnerCandidates && reducedBlock.parent_id && relationCache) {\n // Get owner names for parent traversal\n const ownerNames = relationCache.fuzzyMatchNames.get(TODOS_PROPERTIES.owner) || [];\n parentOwnerCandidates = await traverseParentsForOwnerCandidates(\n reducedBlock.parent_id,\n ownerNames as PageNameEntry[]\n );\n if (parentOwnerCandidates.length > 0) {\n hasOwnerCandidates = true;\n logger.debug(`Found owner candidates in parent blocks: ${parentOwnerCandidates.map(c => c.name).join(', ')}`);\n }\n }\n\n const summaryResult = await aiService.generateSummary({\n todoString: reducedBlock.todo_string,\n precedingHeading: reducedBlock.preceding_heading || null,\n peopleMentions: reducedBlock.people_mentions || [],\n dateMentions: reducedBlock.date_mentions || [],\n matchedProject: matchedProjectName,\n matchedContacts: matchedContactNames,\n sourcePage: null // Could extract from page_url but keeping simple for now\n });\n\n // Step 4: Resolve owner based on candidates found\n let resolvedOwner: ResolvedOwner | null = null;\n\n if (!hasOwnerCandidates) {\n // No owner candidates anywhere - leave owner null to prevent AI hallucination\n logger.debug('No owner candidates (heading/contacts/mentions/parents) - skipping owner resolution');\n } else if (headingOwnerResult) {\n // Heading matched an owner - use it directly (most reliable, deterministic)\n resolvedOwner = headingOwnerResult.resolved;\n logger.debug(`Owner resolved from heading: \"${headingOwnerResult.ownerName}\"`);\n } else if (parentOwnerCandidates.length > 0) {\n // Found candidates in parent blocks - use first one\n const parentCandidate = parentOwnerCandidates[0];\n if (parentCandidate.id && relationCache?.ownerPropertyType === 'relation') {\n resolvedOwner = { type: 'relation', value: [{ id: parentCandidate.id }] };\n logger.debug(`Owner resolved from parent block: \"${parentCandidate.name}\"`);\n } else if (parentCandidate.id && relationCache?.ownerPropertyType === 'people') {\n resolvedOwner = { type: 'people', value: [{ id: parentCandidate.id }] };\n logger.debug(`Owner resolved from parent @mention: \"${parentCandidate.name}\"`);\n }\n } else if (summaryResult.ownerName) {\n // Step 5: POST-AI VALIDATION - Verify AI's claim against actual context\n const isValidClaim = validateOwnerClaim(\n summaryResult.ownerName,\n summaryResult.ownerSource,\n reducedBlock.preceding_heading || null,\n matchedContactNames,\n reducedBlock.people_mentions || []\n );\n\n if (isValidClaim) {\n // AI's determination is valid - resolve it\n resolvedOwner = await resolveOwner(summaryResult, reducedBlock, relationCache);\n } else {\n // AI claimed a source but name doesn't match - reject\n logger.warn(`Rejecting AI owner \"${summaryResult.ownerName}\" (source: ${summaryResult.ownerSource}) - doesn't match actual context`);\n resolvedOwner = null;\n }\n }\n\n // Log final owner result\n if (resolvedOwner) {\n logger.debug(`Final owner: type=${resolvedOwner.type}, id=${resolvedOwner.value[0]?.id}`);\n } else {\n logger.debug(`Final owner: null`);\n }\n\n // Add owner and @mentions to Contacts relation\n // This preserves connections even if Owner is later changed\n await addPeopleToContactsRelation(\n resolvedOwner,\n reducedBlock.people_mentions || [],\n relationMatches,\n relationCache\n );\n\n // Map to Notion properties with dynamic relation matches, resolved owner, and status info\n // Uses validated property names from cache to ensure exact column name match\n const properties = mapReducedBlockToProperties(\n reducedBlock,\n relationCache.validatedProperties,\n relationMatches,\n summaryResult.summary,\n resolvedOwner,\n relationCache.statusInfo\n );\n\n // Extract emoji from todo_string for page icon\n const emoji = extractFirstEmoji(reducedBlock.todo_string);\n const icon = emoji ? { type: \"emoji\", emoji: emoji } : undefined;\n\n // OPTIMIZATION: Use cached page ID if available (fallback to old field name for existing blobs)\n const cachedPageId = reducedBlock.sync_metadata?.target_page_id || reducedBlock.sync_metadata?.notion_page_id;\n let pageId: string | null = null;\n\n if (cachedPageId) {\n // We have a cached page ID - update directly without query\n const updateResult = await notionService.updateNotionPage(cachedPageId, properties, icon);\n\n if (updateResult.success) {\n pagesUpdated++;\n pageId = cachedPageId;\n } else if (updateResult.error?.includes('archived')) {\n // Page was archived - clear cache and skip (user intentionally archived it)\n const projectName = key.split('--')[0];\n const fullKey = `${projectName}--todo--${blockId}`;\n await blobService.updateBlobSyncMetadata(fullKey, {\n synced: true, // Mark synced to prevent retry\n target_page_id: undefined, // Clear cached ID\n archived: true // Flag as archived\n });\n pagesSkipped++;\n continue;\n } else {\n throw new Error(`Failed to update page: ${enhanceNotionError(updateResult.error || 'Unknown error')}`);\n }\n } else {\n // No cached page ID - query database to check if page exists\n const existingPageResult = await notionService.queryDatabaseByBlockId(databaseId, blockId);\n\n if (!existingPageResult.success) {\n throw new Error(`Failed to query database: ${existingPageResult.error}`);\n }\n\n if (existingPageResult.data) {\n // Page exists but we don't have cached ID - update it\n // (blob has synced=false so it needs syncing)\n pageId = existingPageResult.data.id;\n const updateResult = await notionService.updateNotionPage(pageId, properties, icon);\n\n if (updateResult.success) {\n pagesUpdated++;\n } else {\n throw new Error(`Failed to update existing page: ${enhanceNotionError(updateResult.error || 'Unknown error')}`);\n }\n } else {\n // Page doesn't exist - create new\n const createResult = await notionService.createNotionPage(databaseId, properties, icon);\n\n if (createResult.success) {\n pagesCreated++;\n pageId = createResult.data?.id || null;\n\n // Add callout if source block has children\n if (pageId && reducedBlock.has_children && reducedBlock.block_url) {\n const calloutResult = await notionService.appendHasChildrenCallout(pageId, reducedBlock.block_url);\n if (!calloutResult.success) {\n logger.warn(`Failed to add children callout: ${calloutResult.error}`);\n }\n }\n\n // Set block background color on first sync\n // (Only on create, not update, to avoid infinite sync loop)\n const bgColor = getBlockBackgroundColor();\n if (bgColor) {\n const colorResult = await notionService.updateBlockColor(blockId, bgColor);\n if (!colorResult.success) {\n logger.warn(`Failed to set block color: ${colorResult.error}`);\n }\n }\n } else {\n throw new Error(`Failed to create page: ${enhanceNotionError(createResult.error || 'Unknown error')}`);\n }\n }\n }\n\n // Mark blob as synced on success\n if (pageId) {\n const projectName = key.split('--')[0];\n const fullKey = `${projectName}--todo--${blockId}`;\n\n const updateMetadataResult = await blobService.updateBlobSyncMetadata(fullKey, {\n synced: true,\n target_page_id: pageId\n });\n\n if (!updateMetadataResult.success) {\n logger.warn(`Failed to update sync metadata: ${updateMetadataResult.error}`);\n }\n }\n } catch (err: any) {\n pagesFailed++;\n failures.push({\n blockId: blockId,\n error: err.message\n });\n }\n }\n\n return {\n success: true,\n totalBlobs: blobKeys.length,\n pagesCreated,\n pagesUpdated,\n pagesSkipped,\n pagesFailed,\n failures\n };\n}\n",[],[210,701,693],"controllers","8ce47620-e999-11f0-9687-42dde27851f2","todoOrchestrationController.ts","fd176688-b4f0-11f0-8e48-0224a6c84d84",["D",1767550615134],"import * as pageController from './pageController.ts';\nimport * as todoController from './todoController.ts';\nimport * as todoSaveController from './todoSaveController.ts';\nimport { getRecentPagesLookbackHours } from '../utils/configUtils.ts';\n\n/**\n * Batch todo search result for a single page\n */\ninterface PageSearchResult {\n pageId: string;\n pageTitle: string;\n success: boolean;\n blocksFound: number;\n blocksNew?: number;\n blocksUpdated?: number;\n blocksSkipped?: number;\n blockIds: string[];\n error?: string;\n}\n\n/**\n * Batch search result (search and save to blobs only)\n */\nexport interface BatchSearchResult {\n success: boolean;\n pagesSearched: number;\n totalTodosFound: number;\n totalNew?: number;\n totalUpdated?: number;\n totalSkipped?: number;\n searchResults: PageSearchResult[];\n error?: string;\n details?: string;\n}\n\n/**\n * Batch todos processing result (search + sync to database)\n */\nexport interface BatchTodosResult {\n success: boolean;\n pagesSearched: number;\n totalTodosFound: number;\n searchResults: PageSearchResult[];\n saveResult: any;\n error?: string;\n details?: string;\n}\n\n/**\n * Orchestrate batch keyword search:\n * 1. Get recent pages from Notion\n * 2. Search each page for keywords and save to blobs\n *\n * Does NOT sync to Notion database - that's handled separately by processTodoSave()\n *\n * Keywords are read from SEARCH_KEYWORDS environment variable (comma-separated)\n * Defaults to \"todo\" if not set\n *\n * @param hoursAgo - Number of hours to look back for recent pages (default: RECENT_PAGES_LOOKBACK_HOURS env var, fallback 24)\n * @param applyStabilityDelay - Whether to apply stability check before saving blocks (default: true for cron usage)\n */\nexport async function processBatchSearch(hoursAgo?: number, applyStabilityDelay: boolean = true): Promise<BatchSearchResult> {\n const hours = hoursAgo ?? getRecentPagesLookbackHours();\n\n // Step 1: Get recent pages\n const pagesResult = await pageController.getRecentPages(hours);\n\n if (!pagesResult.success || !pagesResult.data?.pages) {\n return {\n success: false,\n pagesSearched: 0,\n totalTodosFound: 0,\n searchResults: [],\n error: \"Failed to fetch recent pages\",\n details: pagesResult.error || undefined\n };\n }\n\n const pages = pagesResult.data.pages;\n\n if (pages.length === 0) {\n return {\n success: true,\n pagesSearched: 0,\n totalTodosFound: 0,\n searchResults: []\n };\n }\n\n // Step 2: Search each page for keywords\n const searchResults: PageSearchResult[] = [];\n let totalTodosFound = 0;\n let totalNew = 0;\n let totalUpdated = 0;\n let totalSkipped = 0;\n\n for (let i = 0; i < pages.length; i++) {\n const page = pages[i];\n\n try {\n const searchResult = await todoController.processTodoSearch(page.id, applyStabilityDelay);\n\n searchResults.push({\n pageId: page.id,\n pageTitle: page.title,\n success: searchResult.success,\n blocksFound: searchResult.blocksFound,\n blocksNew: searchResult.blocksNew,\n blocksUpdated: searchResult.blocksUpdated,\n blocksSkipped: searchResult.blocksSkipped,\n blockIds: searchResult.blockIds,\n error: searchResult.error\n });\n\n if (searchResult.success) {\n totalTodosFound += searchResult.blocksFound;\n totalNew += searchResult.blocksNew || 0;\n totalUpdated += searchResult.blocksUpdated || 0;\n totalSkipped += searchResult.blocksSkipped || 0;\n }\n } catch (err: any) {\n searchResults.push({\n pageId: page.id,\n pageTitle: page.title,\n success: false,\n blocksFound: 0,\n blockIds: [],\n error: err.message\n });\n }\n }\n\n // Return comprehensive summary (no database sync)\n return {\n success: true,\n pagesSearched: pages.length,\n totalTodosFound,\n totalNew,\n totalUpdated,\n totalSkipped,\n searchResults\n };\n}\n\n/**\n * Orchestrate batch keyword search processing:\n * 1. Get recent pages from Notion\n * 2. Search each page for keywords and save to blobs\n * 3. Sync all todo blobs to Notion database\n *\n * Keywords are read from SEARCH_KEYWORDS environment variable (comma-separated)\n * Defaults to \"todo\" if not set\n *\n * @param hoursAgo - Number of hours to look back for recent pages (default: RECENT_PAGES_LOOKBACK_HOURS env var, fallback 24)\n * @param applyStabilityDelay - Whether to apply stability check before saving blocks (default: true, respects BLOCK_STABILITY_MINUTES)\n */\nexport async function processBatchTodos(hoursAgo?: number, applyStabilityDelay: boolean = true): Promise<BatchTodosResult> {\n const hours = hoursAgo ?? getRecentPagesLookbackHours();\n\n // Step 1: Get recent pages\n const pagesResult = await pageController.getRecentPages(hours);\n\n if (!pagesResult.success || !pagesResult.data?.pages) {\n return {\n success: false,\n pagesSearched: 0,\n totalTodosFound: 0,\n searchResults: [],\n saveResult: null,\n error: \"Failed to fetch recent pages\",\n details: pagesResult.error || undefined\n };\n }\n\n const pages = pagesResult.data.pages;\n\n if (pages.length === 0) {\n return {\n success: true,\n pagesSearched: 0,\n totalTodosFound: 0,\n searchResults: [],\n saveResult: { totalBlobs: 0, pagesCreated: 0, pagesUpdated: 0, pagesSkipped: 0, pagesFailed: 0 }\n };\n }\n\n // Step 2: Search each page for keywords\n const searchResults: PageSearchResult[] = [];\n let totalTodosFound = 0;\n let totalNew = 0;\n let totalUpdated = 0;\n let totalSkipped = 0;\n\n for (let i = 0; i < pages.length; i++) {\n const page = pages[i];\n\n try {\n const searchResult = await todoController.processTodoSearch(page.id, applyStabilityDelay);\n\n searchResults.push({\n pageId: page.id,\n pageTitle: page.title,\n success: searchResult.success,\n blocksFound: searchResult.blocksFound,\n blocksNew: searchResult.blocksNew,\n blocksUpdated: searchResult.blocksUpdated,\n blocksSkipped: searchResult.blocksSkipped,\n blockIds: searchResult.blockIds,\n error: searchResult.error\n });\n\n if (searchResult.success) {\n totalTodosFound += searchResult.blocksFound;\n totalNew += searchResult.blocksNew || 0;\n totalUpdated += searchResult.blocksUpdated || 0;\n totalSkipped += searchResult.blocksSkipped || 0;\n }\n } catch (err: any) {\n searchResults.push({\n pageId: page.id,\n pageTitle: page.title,\n success: false,\n blocksFound: 0,\n blockIds: [],\n error: err.message\n });\n }\n }\n\n // Step 3: Save all todos to Notion database\n let saveResult;\n\n try {\n saveResult = await todoSaveController.processTodoSave();\n } catch (err: any) {\n saveResult = {\n success: false,\n totalBlobs: 0,\n pagesCreated: 0,\n pagesUpdated: 0,\n pagesSkipped: 0,\n pagesFailed: 0,\n failures: [],\n error: err.message\n };\n }\n\n // Return comprehensive summary\n return {\n success: true,\n pagesSearched: pages.length,\n totalTodosFound,\n searchResults,\n saveResult\n };\n}\n",[],[210,701,703],"98402f10-f618-11f0-ba7e-42dde27851f2","todoController.ts","15827462-b459-11f0-a09c-0224a6c84d84",["D",1768924594216],40,"import * as notionService from '../services/notion/index.ts';\nimport { TODO_CONTAINER_TYPES } from '../services/notion/pages.ts';\nimport { batchGetPageParentDatabaseIds, getPageParentDatabaseId } from '../services/notion/relations.ts';\nimport type { TodoSearchResult } from '../../shared/types.ts';\nimport { reduceNotionBlock, extractPageIdFromUrl } from '../utils/notionUtils.ts';\nimport * as blobService from '../services/blobService.ts';\nimport { logger } from '../utils/logger.ts';\nimport { getDefaultDueDateSetting, calculateDueDate } from '../utils/dateUtils.ts';\nimport { getMinBlockWords, countWords } from '../utils/textUtils.ts';\nimport { getBlockStabilityMinutes, isBlockStable, getBlockAgeMinutes } from '../utils/blockUtils.ts';\n\n/**\n * Get search keywords from environment variable or default\n *\n * Reads SEARCH_KEYWORDS env var (comma-separated list)\n * Falls back to [\"todo\"] if not set\n *\n * @returns Array of keywords to search for\n */\nfunction getSearchKeywords(): string[] {\n const envKeywords = Deno.env.get('SEARCH_KEYWORDS');\n\n if (envKeywords) {\n return envKeywords\n .split(',')\n .map(k => k.trim())\n .filter(k => k.length > 0);\n }\n\n return ['todo']; // Default fallback\n}\n\n/**\n * Search configuration interface\n */\ninterface SearchConfig {\n mode: 'keyword' | 'blockType';\n keywords?: string[]; // For keyword mode\n blockType?: string; // For block type mode\n}\n\n/**\n * Get search configuration from environment variables\n *\n * Determines search mode based on which env var is set:\n * - SEARCH_BLOCK_TYPE (if set) → block type mode (takes precedence)\n * - SEARCH_KEYWORDS (if set) → keyword mode\n * - Neither set → keyword mode with default \"todo\"\n *\n * @returns Search configuration\n */\nfunction getSearchConfig(): SearchConfig {\n const blockType = Deno.env.get('SEARCH_BLOCK_TYPE');\n\n if (blockType !== undefined) {\n // Block type mode takes precedence\n const type = blockType.trim() || 'to_do'; // Default to to_do if empty\n\n return {\n mode: 'blockType',\n blockType: type\n };\n }\n\n // Keyword mode (existing logic)\n const keywords = getSearchKeywords();\n return {\n mode: 'keyword',\n keywords: keywords\n };\n}\n\n/**\n * Extract creator information from Notion block\n * Returns user object in people_mentions format\n *\n * @param block - Notion block object\n * @returns Creator user object or null\n */\nfunction getBlockCreator(block: any): { id: string; name: string | null; email: string | null } | null {\n if (!block.created_by || !block.created_by.id) {\n return null;\n }\n\n return {\n id: block.created_by.id,\n name: null, // Not available without additional API call\n email: null\n };\n}\n\n/**\n * Search for blocks in a page\n * Logs entire block to console when found\n *\n * Two search modes:\n * 1. Keyword mode: Uses SEARCH_KEYWORDS env var (comma-separated)\n * 2. Block type mode: Uses SEARCH_BLOCK_TYPE env var (e.g., \"to_do\")\n *\n * Block type mode takes precedence if both are set.\n *\n * Validation:\n * - Blocks must have MIN_BLOCK_WORDS words (default: 5) to be saved\n * - Short blocks lack context needed for meaningful todos\n *\n * Auto-assignment:\n * - If no date_mentions: auto-assigns due date based on DEFAULT_DUE_DATE env var (defaults to \"today\")\n * - If no people_mentions: auto-assigns creator as owner\n *\n * Stability check:\n * - If applyStabilityDelay is true: blocks must be older than BLOCK_STABILITY_MINUTES (default: 2)\n * - If applyStabilityDelay is false: blocks are saved immediately (webhook/manual triggers)\n *\n * @param pageId - Notion page ID to search\n * @param applyStabilityDelay - Whether to check block age before saving (default: false for webhook compatibility)\n */\nexport async function processTodoSearch(pageId: string, applyStabilityDelay: boolean = false): Promise<TodoSearchResult> {\n // Validate input\n if (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n blocksFound: 0,\n blockIds: [],\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n }\n\n // Get search configuration\n const searchConfig = getSearchConfig();\n\n try {\n // Fetch page to get URL (single API call for all blocks in this page)\n const pageResult = await notionService.getNotionPage(pageId);\n const pageUrl = pageResult.success ? (pageResult.data as any)?.url : null;\n\n // Get source page's parent database ID for contextual mapping\n let sourcePageDatabaseId: string | null = null;\n if (pageResult.success && pageResult.data) {\n const parent = (pageResult.data as any).parent;\n if (parent?.type === 'database_id') {\n sourcePageDatabaseId = parent.database_id.replace(/-/g, '');\n }\n }\n\n // Get all blocks recursively from the page\n // In block type mode, only recurse into container blocks that can hold to_do items\n const containerFilter = searchConfig.mode === 'blockType' ? TODO_CONTAINER_TYPES : undefined;\n const allBlocks = await notionService.getPageBlocksRecursive(pageId, containerFilter);\n\n if (!allBlocks || allBlocks.length === 0) {\n return {\n success: true,\n blocksFound: 0,\n blockIds: []\n };\n }\n\n const blocksMatched: string[] = [];\n let blocksNew = 0;\n let blocksUpdated = 0;\n let blocksSkipped = 0;\n\n // Track preceding headings for context matching\n let currentHeading: string | null = null;\n\n // Search based on mode\n for (const block of allBlocks) {\n // Update current heading when we see one (for context in fuzzy matching)\n if (block.type === 'heading_1' || block.type === 'heading_2' || block.type === 'heading_3') {\n const headingContent = block[block.type]?.rich_text;\n if (headingContent && Array.isArray(headingContent)) {\n currentHeading = headingContent.map((rt: any) => rt.plain_text || '').join('');\n }\n }\n\n let matched = false;\n let matchInfo = '';\n\n if (searchConfig.mode === 'blockType') {\n // Block type mode: match by Notion block type\n if (block.type === searchConfig.blockType) {\n matched = true;\n matchInfo = `block type \"${searchConfig.blockType}\"`;\n }\n } else {\n // Keyword mode: match by text content\n const matchedKeyword = searchConfig.keywords?.find(kw => searchBlockForKeyword(block, kw));\n if (matchedKeyword) {\n matched = true;\n matchInfo = `keyword \"${matchedKeyword}\"`;\n }\n }\n\n if (matched) {\n const reducedBlock = reduceNotionBlock(block);\n\n // ENRICH PAGE TITLES: Replace \"Untitled\" with actual page titles\n if (reducedBlock.link_mentions && reducedBlock.link_mentions.length > 0) {\n for (const linkMention of reducedBlock.link_mentions) {\n // Only fetch title if it's currently \"Untitled\"\n if (linkMention.text === 'Untitled') {\n // Extract page ID from URL\n const mentionPageId = extractPageIdFromUrl(linkMention.url);\n\n if (mentionPageId) {\n // Fetch page title from Notion API\n const titleResult = await notionService.getPageTitle(mentionPageId);\n\n if (titleResult.success && titleResult.title) {\n // Replace \"Untitled\" with actual title\n linkMention.text = titleResult.title;\n }\n }\n }\n }\n\n // ENRICH PARENT DATABASE IDs: Batch lookup for dynamic relation mapping\n const mentionPageIds = reducedBlock.link_mentions\n .map((lm: any) => lm.pageId)\n .filter((id: string | null): id is string => id !== null);\n\n if (mentionPageIds.length > 0) {\n const parentDbResult = await batchGetPageParentDatabaseIds(mentionPageIds);\n\n if (parentDbResult.success) {\n for (const linkMention of reducedBlock.link_mentions) {\n if (linkMention.pageId) {\n linkMention.parentDatabaseId = parentDbResult.mapping.get(linkMention.pageId) || null;\n }\n }\n }\n }\n }\n\n // STABILITY CHECK: Only apply if requested (cron mode)\n if (applyStabilityDelay) {\n const stabilityMinutes = getBlockStabilityMinutes();\n\n if (stabilityMinutes > 0 && !isBlockStable(reducedBlock.last_edited_time, stabilityMinutes)) {\n continue; // Block too recent, skip\n }\n }\n\n // VALIDATION: Only save blocks that meet sync criteria\n\n // Check minimum word count\n const minWords = getMinBlockWords();\n const wordCount = countWords(reducedBlock.todo_string);\n\n if (wordCount < minWords) {\n continue; // Block too short, skip\n }\n\n // Auto-assign due date if no date mentioned\n // Uses block creation time as reference for deterministic results across re-syncs\n if (!reducedBlock.date_mentions || reducedBlock.date_mentions.length === 0) {\n const setting = getDefaultDueDateSetting();\n const referenceDate = reducedBlock.created_time\n ? new Date(reducedBlock.created_time)\n : new Date();\n const calculatedDate = calculateDueDate(setting, referenceDate);\n reducedBlock.date_mentions = [calculatedDate];\n }\n\n // Capture block creator as author (separate from @mentions)\n // Author = block's created_by; Owner will be derived from AI Summary later\n const creator = getBlockCreator(block);\n (reducedBlock as any).author = creator; // May be null if no creator\n\n // Check if blob already exists\n const existingBlobResult = await blobService.getBlockFromBlob('todo', block.id);\n\n let shouldSave = false;\n let saveReason = '';\n let existingNotionPageId: string | undefined = undefined;\n\n if (!existingBlobResult.success || !existingBlobResult.data) {\n // No existing blob, save as new\n shouldSave = true;\n saveReason = 'new';\n } else {\n // Preserve existing target_page_id if it exists (fallback to old field name for existing blobs)\n existingNotionPageId = existingBlobResult.data.sync_metadata?.target_page_id || existingBlobResult.data.sync_metadata?.notion_page_id;\n\n // Compare timestamps\n const existingTime = new Date(existingBlobResult.data.last_edited_time);\n const currentTime = new Date(reducedBlock.last_edited_time);\n\n if (currentTime > existingTime) {\n shouldSave = true;\n saveReason = 'updated';\n } else {\n shouldSave = false;\n }\n }\n\n // Save to blob storage if needed\n if (shouldSave) {\n // Extract parent block ID (null if parent is a page, not a block)\n const parentId = block.parent?.type === 'block_id' ? block.parent.block_id : null;\n\n // Add sync metadata - mark as needing sync, preserve page ID\n const blobData: any = {\n ...reducedBlock,\n page_url: pageUrl, // Source page URL\n parent_id: parentId, // Parent block ID for traversal\n preceding_heading: currentHeading, // Closest heading for context matching\n source_page_database_id: sourcePageDatabaseId, // For contextual relation mapping\n sync_metadata: {\n synced: false, // Needs sync since block changed\n target_page_id: existingNotionPageId // Preserve if exists\n }\n };\n\n // Flag if block has children (for callout in todo page)\n if (block.has_children) {\n blobData.has_children = true;\n }\n\n const blobResult = await blobService.saveBlockToBlob(\n 'todo',\n block.id,\n blobData\n );\n\n if (!blobResult.success) {\n logger.error(`Failed to save blob: ${blobResult.error}`);\n }\n\n // Track counters based on save reason\n if (saveReason === 'new') {\n blocksNew++;\n } else {\n blocksUpdated++;\n }\n blocksMatched.push(block.id);\n } else {\n // Block unchanged, skip\n blocksSkipped++;\n }\n }\n }\n\n return {\n success: true,\n blocksFound: blocksNew + blocksUpdated,\n blocksNew,\n blocksUpdated,\n blocksSkipped,\n blockIds: blocksMatched\n };\n\n } catch (err: any) {\n return {\n success: false,\n blocksFound: 0,\n blockIds: [],\n error: `Failed to search for keywords`,\n details: err.message\n };\n }\n}\n\n/**\n * Helper function to escape special regex characters\n */\nfunction escapeRegex(str: string): string {\n return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Helper function to search a block for a keyword\n *\n * For text keywords: Uses word boundary regex for exact word match, case-insensitive\n * For non-alphanumeric keywords (like emojis): Uses exact match\n *\n * Searches within:\n * - Standard rich_text blocks (paragraphs, headings, lists, toggles, etc.)\n * - Blocks inside columns (automatically handled by recursive fetching)\n *\n * Skips:\n * - Unsupported blocks\n * - Button blocks\n * - Table blocks\n * - Table row blocks\n *\n * @param block - Notion block object\n * @param keyword - Keyword to search for (default: \"todo\")\n */\nfunction searchBlockForKeyword(block: any, keyword: string = 'todo'): boolean {\n const blockType = block.type;\n\n // Skip if block type is not defined\n if (!blockType || !block[blockType]) {\n return false;\n }\n\n // Explicitly skip unsupported, button, table, and table_row blocks\n if (blockType === 'unsupported' || blockType === 'button' || blockType === 'table' || blockType === 'table_row') {\n return false;\n }\n\n let textContent = '';\n\n // Extract text from standard rich_text array (most block types)\n if (block[blockType]?.rich_text && Array.isArray(block[blockType].rich_text)) {\n textContent = block[blockType].rich_text\n .map((rt: any) => rt.plain_text || '')\n .join(' ');\n }\n\n // If no text content extracted, return false\n if (!textContent.trim()) {\n return false;\n }\n\n // Escape special regex characters in the keyword\n const escapedKeyword = escapeRegex(keyword);\n\n // Check if keyword contains only alphanumeric characters (and common word chars)\n const isAlphanumeric = /^[\\w\\s-]+$/.test(keyword);\n\n if (isAlphanumeric) {\n // Use word boundary for text keywords (case-insensitive)\n const regex = new RegExp(`\\\\b${escapedKeyword}\\\\b`, 'i');\n return regex.test(textContent);\n } else {\n // For emojis and special characters, use exact match (case-sensitive)\n return textContent.includes(keyword);\n }\n}\n",[],[210,701,710],"43d11f54-b962-11f0-8efb-0224a6c84d84","pageController.ts","019a26dc-99bf-7269-a8f5-f4ae4994f9d7",["D",1762249214392],"import * as notionService from '../services/notion/index.ts';\nimport { getRecentPagesLookbackHours } from '../utils/configUtils.ts';\n\n/**\n * Get a Notion page by ID\n * Generic controller that works with any Notion page type\n */\nexport async function getPage(pageId: string) {\n // Validate input\n if (!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 // Call service\n const result = await notionService.getNotionPage(pageId);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to fetch page\",\n details: result.error\n };\n }\n\n // Filter sensitive data if needed\n // Example: Remove button properties\n const filteredData = filterSensitiveProperties(result.data);\n\n return {\n success: true,\n data: filteredData,\n error: null\n };\n}\n\n/**\n * Update a Notion page's properties\n * Generic controller that works with any Notion page type\n */\nexport async function updatePage(pageId: string, properties: any) {\n // Validate input\n if (!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 if (!properties || typeof properties !== 'object') {\n return {\n success: false,\n data: null,\n error: \"Invalid properties\",\n details: \"properties must be a non-empty object\"\n };\n }\n\n // Call service\n const result = await notionService.updateNotionPage(pageId, properties);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to update page\",\n details: result.error\n };\n }\n\n // Filter sensitive data if needed\n const filteredData = filterSensitiveProperties(result.data);\n\n return {\n success: true,\n data: filteredData,\n error: null\n };\n}\n\n/**\n * Create a new page in a database\n */\nexport async function createPage(databaseId: string, properties: any) {\n // Validate input\n if (!databaseId || typeof databaseId !== 'string') {\n return {\n success: false,\n data: null,\n error: \"Invalid databaseId\",\n details: \"databaseId must be a non-empty string\"\n };\n }\n\n if (!properties || typeof properties !== 'object') {\n return {\n success: false,\n data: null,\n error: \"Invalid properties\",\n details: \"properties must be a non-empty object\"\n };\n }\n\n // Call service\n const result = await notionService.createNotionPage(databaseId, properties);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to create page\",\n details: result.error\n };\n }\n\n // Filter sensitive data if needed\n const filteredData = filterSensitiveProperties(result.data);\n\n return {\n success: true,\n data: filteredData,\n error: null\n };\n}\n\n/**\n * Get page content (blocks)\n */\nexport async function getPageContent(pageId: string) {\n // Validate input\n if (!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 // Call service\n const result = await notionService.getPageBlocks(pageId);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to fetch page content\",\n details: result.error\n };\n }\n\n return {\n success: true,\n data: result.data,\n error: null\n };\n}\n\n/**\n * Get recent pages edited within the last X hours\n * Returns simplified page objects with id, title, url, last_edited_time, parent\n * Filters out:\n * - Archived pages\n * - Database objects\n * - Pages inside TODOS_DB_ID database\n *\n * @param hoursAgo - Number of hours to look back (default: RECENT_PAGES_LOOKBACK_HOURS env var, fallback 24)\n */\nexport async function getRecentPages(hoursAgo?: number) {\n // Validate input - use env var default if not provided\n const hours = hoursAgo ?? getRecentPagesLookbackHours();\n\n if (typeof hours !== 'number' || hours <= 0) {\n return {\n success: false,\n data: null,\n error: \"Invalid hours parameter\",\n details: \"hours must be a positive number\"\n };\n }\n\n // Call service\n const result = await notionService.searchRecentPages(hours);\n\n if (!result.success) {\n return {\n success: false,\n data: null,\n error: \"Failed to fetch recent pages\",\n details: result.error\n };\n }\n\n return {\n success: true,\n data: {\n pages: result.data,\n count: result.data?.length || 0,\n timeRange: `${hours} hours`\n },\n error: null\n };\n}\n\n/**\n * Filter sensitive properties from Notion data\n * Example: Remove button properties\n */\nfunction filterSensitiveProperties(data: any) {\n if (!data || !data.properties) {\n return data;\n }\n\n const filtered = {\n ...data,\n properties: Object.entries(data.properties)\n .filter(([_key, value]: [string, any]) => value.type !== 'button')\n .reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {})\n };\n\n return filtered;\n}\n",[],[210,701,718],"a941f58c-f613-11f0-b05a-42dde27851f2","healthController.ts","43d0e1d8-b962-11f0-8efb-0224a6c84d84",["D",1768922475258],"import * as notionService from '../services/notion/index.ts';\nimport {\n getDatabaseSchema,\n findTitleProperty,\n findPropertiesByType,\n findPropertyByName,\n findCandidateProperties,\n findPropertyByNamePatterns,\n type SchemaProperty\n} from '../services/notion/databases.ts';\nimport { discoverRelationProperties } from '../services/notion/relations.ts';\nimport { getRecentPagesLookbackHours } from '../utils/configUtils.ts';\nimport { getBlockStabilityMinutes } from '../utils/blockUtils.ts';\nimport { getMinBlockWords } from '../utils/textUtils.ts';\nimport { getDefaultDueDateSetting } from '../utils/dateUtils.ts';\nimport {\n TODOS_PROPERTIES,\n PROPERTY_METADATA,\n CATEGORY_METADATA,\n getEnvVarName,\n getEnvVarValue,\n getPropertyKeys,\n getDefaultPropertyName\n} from '../utils/notionConfig.ts';\nimport { getProjectInfo, type ProjectInfo } from '../utils/valUtils.ts';\nimport type {\n PropertyStatus,\n PropertyMetadata,\n HealthCheckResponse\n} from '../../shared/types.ts';\n\n/**\n * Try to autodiscover a property using name pattern matching\n *\n * Conservative approach - only autodiscover when confident:\n * 1. Title property (unique per database) - safe, unambiguous\n * 2. Name pattern matching (+ correct type) - reasonable confidence\n *\n * Type-only matching is NOT used for autodiscovery (too risky for false positives).\n * Instead, type-compatible properties are shown as suggestions in `candidates`.\n */\nfunction tryAutodiscover(\n schemaProperties: SchemaProperty[],\n metadata: PropertyMetadata\n): SchemaProperty | null {\n const expectedTypes = metadata.expectedTypes;\n\n // Title property - safe because there's exactly one per database\n if (expectedTypes.includes('title')) {\n const titleProp = findTitleProperty(schemaProperties);\n if (titleProp) return titleProp;\n }\n\n // Name pattern matching - autodiscover if name matches expected patterns\n if (metadata.namePatterns && metadata.namePatterns.length > 0) {\n const matched = findPropertyByNamePatterns(\n schemaProperties,\n metadata.namePatterns,\n expectedTypes\n );\n if (matched) return matched;\n }\n\n // No type-only fallback - let candidates show suggestions instead\n return null;\n}\n\n/**\n * Build property status for a single expected property\n * Property-centric: starts from what we expect, checks against what exists\n *\n * Logic:\n * - Explicit env var → respect it, no autodiscovery fallback\n * - Default name → try exact match first, then autodiscovery if not found\n * - No default (null) → try autodiscovery\n */\nfunction buildPropertyStatus(\n key: string,\n schemaProperties: SchemaProperty[] | null\n): PropertyStatus {\n const metadata = PROPERTY_METADATA[key as keyof typeof PROPERTY_METADATA];\n const configuredName = (TODOS_PROPERTIES as Record<string, string | null>)[key];\n const envValue = getEnvVarValue(key);\n\n // Base status object\n const status: PropertyStatus = {\n key,\n displayName: metadata?.displayName || key,\n purpose: metadata?.purpose || 'Unknown',\n category: metadata?.category || 'enrichment',\n required: metadata?.required || false,\n envVar: getEnvVarName(key),\n envValue,\n defaultName: getDefaultPropertyName(key),\n foundName: null,\n foundType: null\n };\n\n // No database schema available - can't determine beyond config\n if (!schemaProperties) {\n return status;\n }\n\n // Case 1: User EXPLICITLY set an env var (envValue is not null)\n // Respect their choice - no autodiscovery fallback\n if (envValue !== null) {\n if (configuredName) {\n const found = findPropertyByName(schemaProperties, configuredName);\n if (found) {\n status.foundName = found.name;\n status.foundType = found.type;\n } else {\n status.candidates = findCandidateProperties(schemaProperties, configuredName).slice(0, 3);\n }\n }\n return status;\n }\n\n // Case 2: Using DEFAULT name (env var not set)\n if (configuredName) {\n const found = findPropertyByName(schemaProperties, configuredName);\n if (found) {\n status.foundName = found.name;\n status.foundType = found.type;\n return status;\n }\n\n // Default name not found - try autodiscovery if available\n if (metadata?.autodiscoverable) {\n const autodiscovered = tryAutodiscover(schemaProperties, metadata);\n if (autodiscovered) {\n status.foundName = autodiscovered.name;\n status.foundType = autodiscovered.type;\n return status;\n }\n }\n\n // Default not found and autodiscovery failed\n status.candidates = findCandidateProperties(schemaProperties, configuredName).slice(0, 3);\n return status;\n }\n\n // Case 3: No default (null) but autodiscoverable\n if (metadata?.autodiscoverable) {\n const autodiscovered = tryAutodiscover(schemaProperties, metadata);\n if (autodiscovered) {\n status.foundName = autodiscovered.name;\n status.foundType = autodiscovered.type;\n return status;\n }\n }\n\n // Case 4: Not configured and not autodiscoverable\n // Suggest candidates if we have expected types\n if (metadata?.expectedTypes && metadata.expectedTypes.length > 0) {\n const candidates = findPropertiesByType(schemaProperties, metadata.expectedTypes);\n if (candidates.length > 0) {\n status.candidates = candidates.map(c => c.name).slice(0, 3);\n }\n }\n\n return status;\n}\n\n/**\n * Build property statuses for all expected properties\n * Property-centric approach: iterate over expected properties, not configured values\n */\nfunction buildAllPropertyStatuses(\n schemaProperties: SchemaProperty[] | null\n): PropertyStatus[] {\n const keys = getPropertyKeys();\n return keys.map(key => buildPropertyStatus(key, schemaProperties));\n}\n\n/**\n * Setting configuration for health check\n */\ninterface SettingConfig {\n key: string;\n envVar: string;\n description: string;\n defaultValue: string | null;\n getValue: () => string | null;\n}\n\n/**\n * Get all settings configurations\n */\nfunction getSettingsConfigs(): SettingConfig[] {\n return [\n {\n key: 'searchBlockType',\n envVar: 'SEARCH_BLOCK_TYPE',\n description: 'Block type to search for (e.g., to_do for checkboxes)',\n defaultValue: 'to_do',\n getValue: () => {\n const val = Deno.env.get('SEARCH_BLOCK_TYPE');\n return val !== undefined ? (val.trim() || 'to_do') : null;\n }\n },\n {\n key: 'searchKeywords',\n envVar: 'SEARCH_KEYWORDS',\n description: 'Keywords to search for in blocks (comma-separated)',\n defaultValue: 'todo',\n getValue: () => Deno.env.get('SEARCH_KEYWORDS') || null\n },\n {\n key: 'minBlockWords',\n envVar: 'MIN_BLOCK_WORDS',\n description: 'Minimum word count for a block to be saved',\n defaultValue: String(getMinBlockWords()),\n getValue: () => Deno.env.get('MIN_BLOCK_WORDS') || null\n },\n {\n key: 'defaultDueDate',\n envVar: 'DEFAULT_DUE_DATE',\n description: 'Default due date (today, tomorrow, one_week, end_of_week, next_business_day)',\n defaultValue: 'today',\n getValue: () => Deno.env.get('DEFAULT_DUE_DATE') || null\n },\n {\n key: 'blockStabilityMinutes',\n envVar: 'BLOCK_STABILITY_MINUTES',\n description: 'Minutes to wait before syncing (prevents syncing while editing)',\n defaultValue: '0',\n getValue: () => Deno.env.get('BLOCK_STABILITY_MINUTES') || null\n },\n {\n key: 'blockBackgroundColor',\n envVar: 'BLOCK_BACKGROUND_COLOR',\n description: 'Background color for synced blocks (e.g., gray_background)',\n defaultValue: null,\n getValue: () => Deno.env.get('BLOCK_BACKGROUND_COLOR') || null\n },\n {\n key: 'recentPagesLookbackHours',\n envVar: 'RECENT_PAGES_LOOKBACK_HOURS',\n description: 'Hours to look back when searching for recent pages',\n defaultValue: '24',\n getValue: () => Deno.env.get('RECENT_PAGES_LOOKBACK_HOURS') || null\n },\n {\n key: 'cronsDisabled',\n envVar: 'CRONS_DISABLED',\n description: 'Set to \"true\" to disable scheduled cron jobs',\n defaultValue: 'false',\n getValue: () => Deno.env.get('CRONS_DISABLED') || null\n },\n {\n key: 'fuzzyMatchRelations',\n envVar: 'TODOS_FUZZY_MATCH_RELATIONS',\n description: 'Relation properties to fuzzy match (comma-separated)',\n defaultValue: null,\n getValue: () => Deno.env.get('TODOS_FUZZY_MATCH_RELATIONS') || null\n }\n ];\n}\n\n\n/**\n * Get system health status\n *\n * Property-centric approach:\n * - Shows all expected properties and their state\n * - Autodiscovers properties where possible\n * - Suggests fixes for missing properties\n *\n * Returns structured health data for monitoring/debugging\n */\nexport async function getSystemHealth(): Promise<HealthCheckResponse> {\n const timestamp = new Date().toISOString();\n const project = getProjectInfo();\n\n const notionApiKey = Deno.env.get('NOTION_API_KEY');\n const todosDbId = Deno.env.get('TODOS_DB_ID');\n\n // 1. Check Notion connection and get integration name\n let connectionStatus: 'connected' | 'error' | 'not_configured' = 'not_configured';\n let connectionError: string | undefined;\n let integrationName: string | undefined;\n\n if (!notionApiKey) {\n connectionStatus = 'not_configured';\n } else {\n const botResult = await notionService.getBotUser();\n if (botResult.success && botResult.data) {\n connectionStatus = 'connected';\n integrationName = botResult.data.name;\n } else {\n connectionStatus = 'error';\n connectionError = botResult.error || 'Failed to connect to Notion';\n }\n }\n\n // 2. Check database connection and get schema + URL\n let databaseStatus: 'connected' | 'error' | 'not_configured' = 'not_configured';\n let databaseError: string | undefined;\n let databaseName: string | null = null;\n let databaseUrl: string | null = null;\n let schemaProperties: SchemaProperty[] | null = null;\n\n if (!todosDbId) {\n databaseStatus = 'not_configured';\n } else {\n // Get schema for property validation\n const schemaResult = await getDatabaseSchema(todosDbId);\n if (schemaResult.success) {\n databaseStatus = 'connected';\n connectionStatus = 'connected'; // If DB works, connection works\n databaseName = schemaResult.databaseName;\n schemaProperties = schemaResult.properties;\n\n // Get database URL separately\n const dbResult = await notionService.getNotionDatabase(todosDbId);\n if (dbResult.success && dbResult.data) {\n databaseUrl = (dbResult.data as any).url || null;\n }\n } else {\n databaseStatus = 'error';\n databaseError = schemaResult.error || 'Failed to connect to database';\n }\n }\n\n // 3. Build property statuses (property-centric)\n const properties = buildAllPropertyStatuses(schemaProperties);\n\n // 4. Discover relations with page counts\n const relations: HealthCheckResponse['relations'] = [];\n\n if (todosDbId && databaseStatus === 'connected') {\n const relationsResult = await discoverRelationProperties(todosDbId);\n if (relationsResult.success) {\n for (const rel of relationsResult.relations) {\n // Get page count for each relation's target database\n const pageNamesResult = await notionService.getDatabasePageNames(rel.targetDatabaseId);\n relations.push({\n propertyName: rel.propertyName,\n targetDatabaseId: rel.targetDatabaseId,\n pageCount: pageNamesResult.success ? pageNamesResult.pages.length : 0,\n isFuzzyMatchEnabled: TODOS_PROPERTIES.fuzzyMatch.includes(rel.propertyName)\n });\n }\n }\n }\n\n // 5. Build settings array\n const settingsConfigs = getSettingsConfigs();\n const settings: HealthCheckResponse['settings'] = settingsConfigs.map(config => ({\n key: config.key,\n envVar: config.envVar,\n value: config.getValue(),\n defaultValue: config.defaultValue,\n description: config.description\n }));\n\n // 6. Check OpenAI connection (just check if env var is set)\n const openaiApiKey = Deno.env.get('OPENAI_API_KEY');\n const openaiStatus: 'connected' | 'not_configured' = openaiApiKey ? 'connected' : 'not_configured';\n\n return {\n project,\n timestamp,\n connections: {\n notion: {\n envVar: 'NOTION_API_KEY',\n status: connectionStatus,\n ...(integrationName ? { integrationName } : {}),\n ...(connectionError ? { error: connectionError } : {})\n },\n database: {\n envVar: 'TODOS_DB_ID',\n status: databaseStatus,\n id: todosDbId || null,\n name: databaseName,\n url: databaseUrl,\n ...(databaseError ? { error: databaseError } : {})\n },\n openai: {\n envVar: 'OPENAI_API_KEY',\n status: openaiStatus\n }\n },\n properties,\n categories: CATEGORY_METADATA as HealthCheckResponse['categories'],\n relations,\n settings\n };\n}\n",[],[210,701,725],"71e9f9e6-b369-11f0-bc36-0224a6c84d84","faviconController.ts","b7798a9c-b361-11f0-9afd-0224a6c84d84",14,["D",1761592591230],"import * as notionService from '../services/notion/index.ts';\nimport * as faviconizerService from '../services/faviconizerService.ts';\nimport type { FaviconUpdateResult } from '../../shared/types.ts';\n\n/**\n * Process favicon update for a Notion page\n * Orchestrates: Get page → Extract Domain → Fetch favicon → Update icon\n * On error: Append error note to page\n */\nexport async function processFaviconUpdate(pageId: string): Promise<FaviconUpdateResult> {\n // Validate input\n if (!pageId || typeof pageId !== 'string') {\n return {\n success: false,\n error: \"Invalid pageId\",\n details: \"pageId must be a non-empty string\"\n };\n }\n\n // Step 1: Get the Notion page\n const pageResult = await notionService.getNotionPage(pageId);\n\n if (!pageResult.success) {\n return {\n success: false,\n error: \"Failed to fetch Notion page\",\n details: pageResult.error\n };\n }\n\n // Step 2: Extract domain from Name property (title type)\n const domain = pageResult.data?.properties?.Name?.title?.[0]?.plain_text;\n\n if (!domain || typeof domain !== 'string' || domain.trim() === '') {\n const errorMessage = \"⚠️ Favicon update failed: Name property not found or empty\";\n\n // Append error note to page\n await notionService.appendBlockToPage(pageId, errorMessage);\n\n return {\n success: false,\n iconUpdated: false,\n errorNoteAdded: true,\n error: \"Name property not found or empty\"\n };\n }\n\n // Step 3: Fetch favicon from Faviconizer\n const faviconResult = await faviconizerService.getFaviconForDomain(domain);\n\n if (!faviconResult.success || !faviconResult.data?.faviconUrl) {\n const errorMessage = `⚠️ Favicon update failed: Could not fetch favicon for domain '${domain}'. Error: ${faviconResult.error}`;\n\n // Append error note to page\n await notionService.appendBlockToPage(pageId, errorMessage);\n\n return {\n success: false,\n iconUpdated: false,\n errorNoteAdded: true,\n error: \"Failed to fetch favicon\",\n details: faviconResult.error\n };\n }\n\n // Step 4: Update page icon\n const iconUpdateResult = await notionService.updatePageIcon(pageId, faviconResult.data.faviconUrl);\n\n if (!iconUpdateResult.success) {\n const errorMessage = `⚠️ Favicon update failed for domain '${domain}': Could not update page icon. Error: ${iconUpdateResult.error}`;\n\n // Append error note to page\n await notionService.appendBlockToPage(pageId, errorMessage);\n\n return {\n success: false,\n iconUpdated: false,\n errorNoteAdded: true,\n error: \"Failed to update page icon\",\n details: iconUpdateResult.error\n };\n }\n\n // Success! Append success note to page\n const successMessage = `✅ Favicon successfully updated for domain: ${domain}`;\n const appendResult = await notionService.appendBlockToPage(pageId, successMessage);\n\n return {\n success: true,\n iconUpdated: true,\n errorNoteAdded: false,\n successNoteAdded: appendResult.success\n };\n}\n",[],[210,701,732],"1cb94fca-b360-11f0-bc6f-0224a6c84d84",["D",1761588582800],[235,236,237,238,239,240],[210,701],["D",1761588582800],[234,241,244,256,268,281],[210],"df948c04-eca3-11f0-84de-42dde27851f2","settings.local.json","019a26dc-99bf-7269-a8f5-ec22817c2d0b",260,["D",1767884902323],"{\n \"permissions\": {\n \"allow\": [\n \"Bash(cat:*)\",\n \"mcp__ide__getDiagnostics\",\n \"WebFetch(domain:docs.val.town)\",\n \"WebFetch(domain:developers.notion.com)\",\n \"Bash(find:*)\"\n ],\n \"deny\": [],\n \"ask\": []\n }\n}\n",[],[215,747],["D",1761588582800],[232],[215],["D",1761588582800],["D",1789527031073],{"_103":102,"_110":106},{"_103":102,"_104":-5,"_105":106,"_18":54,"_107":108,"_109":25},{"_13":88,"_32":89,"_43":42,"_90":44,"_91":92,"_93":94,"_95":96,"_97":98,"_99":64,"_100":45,"_101":102},"ctx",{"_81":-5,"_131":795,"_796":797,"_798":799,"_800":25,"_801":25,"_802":25,"_803":58,"_804":-5,"_805":-7,"_806":-7,"_807":62,"_808":25,"_809":25,"_810":-5,"_811":25,"_812":25,"_813":25,"_814":-5},"ENV",{"_766":767,"_768":769,"_770":89,"_771":772,"_773":774,"_775":776,"_777":778,"_779":780,"_781":782,"_783":784,"_785":786,"_787":788,"_789":790,"_791":792,"_793":794},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"] </article></body></html>

Diff · v321