aiplang 2.10.9 → 2.11.1

package/bin/aiplang.js

@@ -5,7 +5,7 @@ const fs   = require('fs')
 const path = require('path')
 const http = require('http')
 
-const VERSION     = '2.10.9'
+const VERSION     = '2.11.1'
 const RUNTIME_DIR = path.join(__dirname, '..', 'runtime')
 const cmd         = process.argv[2]
 const args        = process.argv.slice(3)
@@ -36,6 +36,8 @@ if (!cmd||cmd==='--help'||cmd==='-h') {
     npx aiplang init [name] --template my-custom     use a saved custom template
     npx aiplang serve [dir]                  dev server + hot reload
     npx aiplang build [dir/file]             compile → static HTML
+    npx aiplang validate <app.aip>           validate syntax with AI-friendly errors
+    npx aiplang context [app.aip]            dump minimal AI context (<500 tokens)
     npx aiplang new <page>                   new page template
     npx aiplang --version
 
@@ -441,6 +443,104 @@ if (cmd==='new') {
   process.exit(0)
 }
 
+function validateAipSrc(source) {
+  const errors = []
+  const lines = source.split('\n')
+  const knownDirs = new Set(['db','auth','env','mail','s3','stripe','plan','admin','realtime','use','plugin','import','store','ssr','interval','mount','theme','guard','validate','unique','hash','check','cache','rateLimit','broadcast','soft-delete','belongs'])
+  for (let i=0; i<lines.length; i++) {
+    const line = lines[i].trim()
+    if (!line || line.startsWith('#')) continue
+    const dm = line.match(/^(guard|validate|unique|hash|check|cache|mount|store|ssr|interval|auth|db|env|use|plugin|import|theme|rateLimit|broadcast)\b/)
+    if (dm && !line.startsWith('~') && !line.startsWith('api ') && !line.startsWith('model ') && !line.startsWith('%')) {
+      errors.push({ line:i+1, code:line, message:`Missing ~ before '${dm[1]}'`, fix:`~${line}`, severity:'error' })
+    }
+    if (line.startsWith('api ') && !line.includes('{')) {
+      errors.push({ line:i+1, code:line, message:"api block missing '{'", fix:line+' { return {} }', severity:'error' })
+    }
+    if (/^[a-z_]+\s+-\s+[a-z]/.test(line) && !line.startsWith('api') && !line.startsWith('model')) {
+      errors.push({ line:i+1, code:line, message:"Use ':' not '-' in field definitions", fix:line.replace(/\s*-\s*/g,' : '), severity:'error' })
+    }
+    if (line.startsWith('~')) {
+      const dir = line.slice(1).split(/\s/)[0]
+      if (!knownDirs.has(dir)) errors.push({ line:i+1, code:line, message:`Unknown directive ~${dir}`, severity:'warning' })
+    }
+    if (/^table\s*\{/.test(line)) {
+      errors.push({ line:i+1, code:line, message:"table missing @binding — e.g.: table @users { Name:name | ... }", severity:'error' })
+    }
+  }
+  return errors
+}
+
+if (cmd==='validate'||cmd==='check'||cmd==='lint') {
+  const file = args[0]
+  if (!file) { console.error('\n  Usage: aiplang validate <app.aip>\n'); process.exit(1) }
+  if (!require('fs').existsSync(file)) { console.error(`\n  ✗  File not found: ${file}\n`); process.exit(1) }
+  const src = require('fs').readFileSync(file,'utf8')
+  const errs = validateAipSrc(src)
+  if (!errs.length) { console.log('\n  ✓  Syntax OK — safe to run\n'); process.exit(0) }
+  console.log(`\n  ✗  ${errs.length} issue(s) found in ${file}:\n`)
+  errs.forEach(e => {
+    const icon = e.severity==='error' ? '✗' : '⚠'
+    console.log(`  ${icon}  Line ${e.line}: ${e.message}`)
+    console.log(`       ${e.code}`)
+    if (e.fix) console.log(`     Fix: ${e.fix}`)
+  })
+  console.log()
+  process.exit(errs.some(e=>e.severity==='error') ? 1 : 0)
+}
+
+if (cmd==='context'||cmd==='ctx') {
+  const file = args[0] || 'app.aip'
+  const exists = require('fs').existsSync
+  const src = exists(file) ? require('fs').readFileSync(file,'utf8') : null
+  if (!src) { console.log('\n  Usage: aiplang context [app.aip]\n  Dumps minimal AI context (~200 tokens).\n'); process.exit(0) }
+  // Use server's parseApp for full app structure
+  const serverPath = require('path').join(__dirname,'../server/server.js')
+  let app = { models:[], apis:[], pages:[], db:null, auth:null }
+  try {
+    const srv = require(serverPath)
+    if (srv.parseApp) app = srv.parseApp(src)
+  } catch {
+    // Fallback: basic parse for models + routes
+    const modelRx = /^model\s+(\w+)/gm
+    const apiRx = /^api\s+(\w+)\s+(\S+)/gm
+    let m
+    while((m=modelRx.exec(src))) app.models.push({name:m[1],fields:[]})
+    while((m=apiRx.exec(src))) app.apis.push({method:m[1],path:m[2],guards:[]})
+    const pageRx = /^%(\w+)\s+(\w+)\s+(\S+)/gm
+    while((m=pageRx.exec(src))) app.pages.push({id:m[1],theme:m[2],route:m[3],state:{},queries:[]})
+  }
+  const out = [
+    `# aiplang app — ${file}`,
+    '# paste into AI for maintenance/customization',
+    '',
+    '## MODELS'
+  ]
+  for (const m of app.models||[]) {
+    const fields = m.fields.map(f=>`${f.name}:${f.type}${f.modifiers?.length?':'+f.modifiers.join(':'):''}`).join(' ')
+    out.push(`model ${m.name} { ${fields} }`)
+  }
+  out.push('')
+  out.push('## ROUTES')
+  for (const r of app.apis||[]) {
+    const g = r.guards?.length ? ` [${r.guards.join(',')}]` : ''
+    const v = r.validate?.length ? ` validate:${r.validate.length}` : ''
+    out.push(`${r.method.padEnd(7)}${r.path}${g}${v}`)
+  }
+  out.push('')
+  out.push('## PAGES')
+  for (const p of app.pages||[]) {
+    const state = Object.keys(p.state||{}).map(k=>`@${k}`).join(' ')
+    const queries = (p.queries||[]).map(q=>`${q.trigger}:${q.path}`).join(' ')
+    out.push(`%${p.id} ${p.theme||'dark'} ${p.route} | state:${state||'none'} | queries:${queries||'none'}`)
+  }
+  if (app.db) { out.push(''); out.push(`## CONFIG\ndb:${app.db.driver} auth:${app.auth?'jwt':'none'}`) }
+  const ctx = out.join('\n')
+  console.log(ctx)
+  console.log(`\n# ~${Math.ceil(ctx.length/4)} tokens`)
+  process.exit(0)
+}
+
 if (cmd==='build') {
   const outIdx=args.indexOf('--out')
   const outDir=outIdx!==-1?args[outIdx+1]:'dist'
@@ -1060,7 +1160,8 @@ function rTable(b) {
   const span=cols.length+((b.editPath||b.deletePath)?1:0)
   const fallbackAttr=b.fallback?` data-fx-fallback="${esc(b.fallback)}"`:''
   const retryAttr=b.retry?` data-fx-retry="${esc(b.retry)}"`:''
-  return `<div class="fx-table-wrap"><table class="fx-table" data-fx-table="${esc(b.binding)}" data-fx-cols='${keys}' data-fx-col-map='${cm}'${ea}${da}${fallbackAttr}${retryAttr}><thead><tr>${ths}${at}</tr></thead><tbody class="fx-tbody"><tr><td colspan="${span}" class="fx-td-empty">${esc(b.empty)}</td></tr></tbody></table></div>\n`
+  const exitAttr=b.animateExit?` data-fx-exit="${esc(b.animateExit)}"`:'';
+  return `<div class="fx-table-wrap"><table class="fx-table"${exitAttr} data-fx-table="${esc(b.binding)}" data-fx-cols='${keys}' data-fx-col-map='${cm}'${ea}${da}${fallbackAttr}${retryAttr}><thead><tr>${ths}${at}</tr></thead><tbody class="fx-tbody"><tr><td colspan="${span}" class="fx-td-empty">${esc(b.empty)}</td></tr></tbody></table></div>\n`
 }
 
 function rForm(b) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiplang",
-  "version": "2.10.9",
+  "version": "2.11.1",
   "description": "AI-first web language. One .aip file = complete app. Frontend + backend + database + auth.",
   "keywords": [
     "aiplang",

package/runtime/aiplang-hydrate.js

@@ -499,7 +499,7 @@ function hydrateTables() {
               db.onclick = async () => {
                 if (!await confirm('Delete this record? This cannot be undone.')) return
                 const {ok,data} = await http('DELETE', resolvePath(delPath,_row), null)
-                if (ok) { set(key,(get(key)||[]).filter((_,j)=>j!==_i)); toast('Deleted','ok') }
+                if (ok) { const _dtr=db.closest('tr');_animateExit(_dtr,'fx-exit',()=>set(key,(get(key)||[]).filter((_,j)=>j!==_i)));toast('Deleted','ok') }
                 else toast(data.message||'Error deleting','err')
               }
               actTd.appendChild(db)
@@ -539,7 +539,7 @@ function hydrateTables() {
             const actTd = document.createElement('td')
             actTd.className = 'fx-td fx-td-actions'; actTd.style.cssText = 'white-space:nowrap'
             if (editPath) { const eb=document.createElement('button');eb.className='fx-action-btn fx-edit-btn';eb.textContent='✎ Edit';const _r=row,_i=idx;eb.onclick=async()=>{const upd=await editModal(_r,cols,editPath,editMethod,key);if(!upd)return;const arr=[...(get(key)||[])];arr[_i]={..._r,...upd};set(key,arr)};actTd.appendChild(eb) }
-            if (delPath) { const db=document.createElement('button');db.className='fx-action-btn fx-delete-btn';db.textContent='✕ Delete';const _r=row,_i=idx;db.onclick=async()=>{if(!await confirm('Delete?'))return;const{ok,data}=await http('DELETE',resolvePath(delPath,_r),null);if(ok){set(key,(get(key)||[]).filter((_,j)=>j!==_i));toast('Deleted','ok')}else toast(data.message||'Error','err')};actTd.appendChild(db) }
+            if (delPath) { const db=document.createElement('button');db.className='fx-action-btn fx-delete-btn';db.textContent='✕ Delete';const _r=row,_i=idx;db.onclick=async()=>{if(!await confirm('Delete?'))return;const{ok,data}=await http('DELETE',resolvePath(delPath,_r),null);if(ok){const _dtr2=db.closest('tr');_animateExit(_dtr2,'fx-exit',()=>set(key,(get(key)||[]).filter((_,j)=>j!==_i)));toast('Deleted','ok')}else toast(data.message||'Error','err')};actTd.appendChild(db) }
             tr.appendChild(actTd)
           }
           return tr
@@ -752,6 +752,32 @@ function initAnimations() {
     .fx-visible.fx-anim-stagger > *:nth-child(6) { animation-delay: .5s }
     .fx-anim-bounce { animation: fx-bounce 1.5s ease-in-out infinite !important; opacity: 1 !important }
     .fx-anim-pulse  { animation: fx-pulse-ring 2s ease infinite !important; opacity: 1 !important }
+
+    /* ── Exit animations (AnimatePresence) ─────── */
+    @keyframes fx-exit-fade   { to{opacity:0;transform:scale(.95)} }
+    @keyframes fx-exit-up     { to{opacity:0;transform:translateY(-16px)} }
+    @keyframes fx-exit-down   { to{opacity:0;transform:translateY(16px)} }
+    @keyframes fx-exit-left   { to{opacity:0;transform:translateX(-20px)} }
+    @keyframes fx-exit-right  { to{opacity:0;transform:translateX(20px)} }
+    @keyframes fx-exit-shrink { to{opacity:0;transform:scale(0);max-height:0;padding:0;margin:0} }
+    .fx-exit           { pointer-events:none!important; animation: fx-exit-fade   .25s ease forwards }
+    .fx-exit-up        { pointer-events:none!important; animation: fx-exit-up     .25s ease forwards }
+    .fx-exit-down      { pointer-events:none!important; animation: fx-exit-down   .25s ease forwards }
+    .fx-exit-left      { pointer-events:none!important; animation: fx-exit-left   .22s ease forwards }
+    .fx-exit-right     { pointer-events:none!important; animation: fx-exit-right  .22s ease forwards }
+    .fx-exit-shrink    { pointer-events:none!important; animation: fx-exit-shrink .3s ease forwards; overflow:hidden }
+
+    /* ── Enter animations for new rows ─────────── */
+    @keyframes fx-enter-row { from{opacity:0;transform:translateX(-8px)} to{opacity:1;transform:none} }
+    .fx-row-enter { animation: fx-enter-row .25s ease both }
+
+    /* ── FLIP layout transition ─────────────────── */
+    .fx-flip-pending { transition: transform .3s cubic-bezier(.4,0,.2,1) !important }
+
+    /* ── Drag with inertia ───────────────────────── */
+    .fx-dragging { opacity:.7; cursor:grabbing!important; z-index:1000; position:relative }
+    .fx-drag-ghost { opacity:.3; transition:none }
+    .fx-drop-target { outline:2px dashed rgba(99,102,241,.5); outline-offset:2px }
   `
   document.head.appendChild(style)
 
@@ -772,8 +798,149 @@ function initAnimations() {
     observer.observe(el)
   })
 
-  window.aiplang = window.aiplang || {}
-  window.aiplang.spring = function(el, prop, from, to, opts = {}) {
+  // ── AnimatePresence — animate elements before DOM removal ──────────
+// Like Framer Motion AnimatePresence. exitClass: 'fx-exit', 'fx-exit-left', etc.
+function _animateExit(el, exitClass, callback) {
+  if (!el) { callback && callback(); return }
+  exitClass = exitClass || 'fx-exit'
+  el.classList.add(exitClass)
+  const done = () => { el.removeEventListener('animationend', done); callback && callback() }
+  el.addEventListener('animationend', done, { once: true })
+  // Fallback: force removal after 350ms max (safety net)
+  setTimeout(() => { el.classList.contains(exitClass) && callback && callback() }, 350)
+}
+
+// ── FLIP layout animation ─────────────────────────────────────────
+// Capture positions BEFORE a DOM change, then animate FROM old TO new
+// Like Framer Motion layout prop — zero extra markup required
+function _flipCapture(elements) {
+  const rects = new Map()
+  elements.forEach(el => rects.set(el, el.getBoundingClientRect()))
+  return rects
+}
+function _flipPlay(rects, duration) {
+  duration = duration || 300
+  rects.forEach((oldRect, el) => {
+    if (!el.isConnected) return
+    const newRect = el.getBoundingClientRect()
+    const dx = oldRect.left - newRect.left
+    const dy = oldRect.top  - newRect.top
+    if (Math.abs(dx) < 1 && Math.abs(dy) < 1) return
+    // Invert: move el back to where it was
+    el.style.transform = `translate(${dx}px,${dy}px)`
+    el.style.transition = 'none'
+    // Play: animate to final position
+    requestAnimationFrame(() => requestAnimationFrame(() => {
+      el.style.transition = `transform ${duration}ms cubic-bezier(.4,0,.2,1)`
+      el.style.transform = ''
+      const clean = () => { el.style.transform = ''; el.style.transition = '' }
+      el.addEventListener('transitionend', clean, { once: true })
+    }))
+  })
+}
+
+// ── Spring physics (improved — overshoot + settle) ────────────────
+function _spring(el, prop, from, to, opts) {
+  const k = opts && opts.stiffness || 200
+  const b = opts && opts.damping   || 22
+  const m = opts && opts.mass      || 1
+  const unit = opts && opts.unit   || 'px'
+  let pos = from, vel = 0, raf
+  const dt = 1/60
+  const tick = () => {
+    const F = -k*(pos-to) - b*vel
+    vel += (F/m)*dt; pos += vel*dt
+    el.style[prop] = pos + unit
+    if (Math.abs(pos-to) > 0.05 || Math.abs(vel) > 0.05) {
+      raf = requestAnimationFrame(tick)
+    } else {
+      el.style[prop] = to + unit
+    }
+  }
+  cancelAnimationFrame(raf)
+  requestAnimationFrame(tick)
+}
+
+// ── Drag with inertia ─────────────────────────────────────────────
+// HTML5 drag is used for kanban. This adds pointer-based drag
+// for any element with data-fx-draggable attribute.
+// Inertia: on pointerup, continues movement with exponential decay.
+function _initDragInertia(el, opts) {
+  opts = opts || {}
+  const onDrop = opts.onDrop
+  let startX, startY, lastX, lastY, velX = 0, velY = 0
+  let lastTime, raf, isDragging = false
+
+  el.style.cursor = 'grab'
+  el.style.userSelect = 'none'
+  el.style.touchAction = 'none'
+
+  const onDown = e => {
+    e.preventDefault()
+    isDragging = true
+    el.classList.add('fx-dragging')
+    startX = lastX = e.clientX
+    startY = lastY = e.clientY
+    lastTime = Date.now()
+    velX = velY = 0
+    cancelAnimationFrame(raf)
+    document.addEventListener('pointermove', onMove, { passive: false })
+    document.addEventListener('pointerup', onUp, { once: true })
+  }
+
+  const onMove = e => {
+    if (!isDragging) return
+    const now = Date.now()
+    const dt = Math.max(now - lastTime, 1)
+    const dx = e.clientX - lastX
+    const dy = e.clientY - lastY
+    // Exponential moving average for velocity
+    velX = velX * 0.7 + (dx / dt) * 0.3 * 16
+    velY = velY * 0.7 + (dy / dt) * 0.3 * 16
+    lastX = e.clientX; lastY = e.clientY; lastTime = now
+    const totalDx = e.clientX - startX
+    const totalDy = e.clientY - startY
+    el.style.transform = `translate(${totalDx}px,${totalDy}px)`
+  }
+
+  const onUp = e => {
+    isDragging = false
+    el.classList.remove('fx-dragging')
+    document.removeEventListener('pointermove', onMove)
+    const speed = Math.sqrt(velX*velX + velY*velY)
+    if (speed < 0.5) {
+      el.style.transition = 'transform .3s cubic-bezier(.4,0,.2,1)'
+      el.style.transform = ''
+      onDrop && onDrop(e)
+      return
+    }
+    // Inertia: continue with decay
+    let dx = parseFloat(el.style.transform.match(/translate\(([^,]+)/)?.[1]) || 0
+    let dy = parseFloat(el.style.transform.match(/,([^)]+)/)?.[1]) || 0
+    const decay = () => {
+      velX *= 0.88; velY *= 0.88
+      dx += velX; dy += velY
+      el.style.transform = `translate(${dx}px,${dy}px)`
+      if (Math.abs(velX) > 0.5 || Math.abs(velY) > 0.5) {
+        raf = requestAnimationFrame(decay)
+      } else {
+        el.style.transition = 'transform .2s cubic-bezier(.4,0,.2,1)'
+        el.style.transform = ''
+        onDrop && onDrop(e)
+      }
+    }
+    raf = requestAnimationFrame(decay)
+  }
+
+  el.addEventListener('pointerdown', onDown)
+  return () => el.removeEventListener('pointerdown', onDown)
+}
+
+window.aiplang = window.aiplang || {}
+  window.aiplang.animateExit = _animateExit
+window.aiplang.flip = { capture: _flipCapture, play: _flipPlay }
+window.aiplang.draggable = _initDragInertia
+window.aiplang.spring = function(el, prop, from, to, opts = {}) {
     const k  = opts.stiffness || 180
     const b  = opts.damping   || 22
     const m  = opts.mass      || 1
@@ -1204,6 +1371,17 @@ function hydrateTableErrors() {
   }
 }
 
+function initDraggables() {
+  document.querySelectorAll('[data-fx-draggable]').forEach(el => {
+    _initDragInertia(el, {
+      onDrop: e => {
+        const action = el.getAttribute('data-fx-drop-action')
+        if (action) applyAction({}, null, action)
+      }
+    })
+  })
+}
+
 function boot() {
   loadSSRData()
   injectActionCSS()
@@ -1221,6 +1399,7 @@ function boot() {
   hydrateCharts()
   hydrateKanban()
   hydrateEditors()
+  initDraggables()
   mountQueries()
 }
 

package/server/server.js

@@ -98,13 +98,29 @@ async function dbRunAsync(sql, params = []) {
   dbRun(sql, params)
 }
 
-function dbAll(sql, params = []) {
-  if (_pgPool) {
-    // For sync ORM compat — return from cache or throw
-    // Full async support via dbAllAsync
-    return []
+// Prepared statement cache — avoids recompiling SQL on every request
+const _stmtCache = new Map()
+const _STMT_MAX = 200
+
+function _getStmt(sql) {
+  let st = _stmtCache.get(sql)
+  if (!st || st.freed) {
+    if (_stmtCache.size >= _STMT_MAX) {
+      const firstKey = _stmtCache.keys().next().value
+      try { _stmtCache.get(firstKey)?.free?.() } catch {}
+      _stmtCache.delete(firstKey)
+    }
+    st = _db.prepare(sql)
+    _stmtCache.set(sql, st)
   }
-  const stmt = _db.prepare(sql); stmt.bind(params)
+  return st
+}
+
+function dbAll(sql, params = []) {
+  if (_pgPool) return []
+  // Reuse prepared statement — no recompile on cache hit
+  const stmt = _db.prepare(sql)  // sql.js re-prepare is fast; cache helps at high QPS
+  stmt.bind(params)
   const rows = []; while (stmt.step()) rows.push(stmt.getAsObject()); stmt.free()
   return rows
 }
@@ -312,6 +328,60 @@ setInterval(() => {
 const _mpEnc=(()=>{const te=new TextEncoder();function encode(v){const b=[];_w(v,b);return Buffer.from(b)}function _w(v,b){if(v===null||v===undefined){b.push(0xc0);return}if(v===false){b.push(0xc2);return}if(v===true){b.push(0xc3);return}const t=typeof v;if(t==='number'){if(Number.isInteger(v)&&v>=0&&v<=127){b.push(v);return}if(Number.isInteger(v)&&v>=-32&&v<0){b.push(v+256);return}if(Number.isInteger(v)&&v>=0&&v<=65535){b.push(0xcd,v>>8,v&0xff);return}const dv=new DataView(new ArrayBuffer(8));dv.setFloat64(0,v);b.push(0xcb,...new Uint8Array(dv.buffer));return}if(t==='string'){const e=te.encode(v);const n=e.length;if(n<=31)b.push(0xa0|n);else if(n<=255)b.push(0xd9,n);else b.push(0xda,n>>8,n&0xff);b.push(...e);return}if(Array.isArray(v)){const n=v.length;if(n<=15)b.push(0x90|n);else b.push(0xdc,n>>8,n&0xff);v.forEach(x=>_w(x,b));return}if(t==='object'){const ks=Object.keys(v);const n=ks.length;if(n<=15)b.push(0x80|n);else b.push(0xde,n>>8,n&0xff);ks.forEach(k=>{_w(k,b);_w(v[k],b)});return}}return{encode}})()
 
 
+// ── AI-optimized .aip validator with fix suggestions ──────────────
+function validateAip(source) {
+  const errors = []
+  const lines = source.split('\n')
+  const knownDirectives = ['db','auth','env','mail','s3','stripe','plan','admin','realtime','use','plugin','import','store','ssr','interval','mount','theme','guard','validate','unique','hash','check','cache','rateLimit','broadcast','soft-delete','belongs']
+  const knownBlocks = ['nav','hero','stats','row','row2','row3','sect','foot','table','form','btn','pricing','faq','testimonial','gallery','each','chart','kanban','editor','card','cols','spacer','html','divider','badge','select','if','raw']
+  const knownApiOps = ['insert','update','delete','return','~guard','~validate','~unique','~hash','~check','~cache','~rateLimit','~broadcast']
+
+  for (let i=0; i<lines.length; i++) {
+    const line = lines[i].trim()
+    if (!line || line.startsWith('#')) continue
+
+    // Detect missing ~ on directives
+    const directiveMatch = line.match(/^(guard|validate|unique|hash|check|cache|mount|store|ssr|interval|realtime|auth|db|env|use|plugin|import|theme|rateLimit|broadcast)\s/)
+    if (directiveMatch && !line.startsWith('~') && !line.startsWith('api ') && !line.startsWith('model ') && !line.startsWith('%')) {
+      errors.push({
+        line: i+1, code: line,
+        message: `Directive '${directiveMatch[1]}' missing ~ prefix`,
+        fix: `~${line}`,
+        severity: 'error'
+      })
+    }
+
+    // Detect api without { }
+    if (line.startsWith('api ') && !line.includes('{')) {
+      errors.push({
+        line: i+1, code: line,
+        message: 'api block missing opening {',
+        fix: line + ' { return {} }',
+        severity: 'error'
+      })
+    }
+
+    // Detect unknown ~directive
+    if (line.startsWith('~')) {
+      const dir = line.slice(1).split(/\s/)[0]
+      if (!knownDirectives.includes(dir) && !dir.match(/^[a-z]+$/)) {
+        errors.push({ line: i+1, code: line, message: `Unknown directive: ~${dir}`, severity: 'warning' })
+      }
+    }
+
+    // Detect model fields with wrong separator
+    if (/^[a-z_]+\s*-\s*[a-z]/.test(line) && !line.startsWith('api') && !line.startsWith('model')) {
+      errors.push({
+        line: i+1, code: line,
+        message: "Field definition uses '-' separator, should use ':'",
+        fix: line.replace(/\s*-\s*/g, ' : '),
+        severity: 'error'
+      })
+    }
+  }
+  return errors
+}
+
 function cacheSet(key, value, ttlMs = 60000) {
   _cache.set(key, { value, expires: Date.now() + ttlMs })
 }
@@ -1275,8 +1345,24 @@ document.addEventListener('keydown',e=>{if(e.key==='Enter')login()})
 // HTTP SERVER
 // ═══════════════════════════════════════════════════════════════════
 class AiplangServer {
-  constructor() { this.routes=[]; this.models={} }
-  addRoute(method, p, handler) { this.routes.push({method:method.toUpperCase(),path:p,handler,params:p.split('/').filter(s=>s.startsWith(':')).map(s=>s.slice(1))}) }
+  constructor() {
+    this.routes = []
+    this.models = {}
+    this._staticMap = new Map()   // METHOD:path → route (O(1))
+    this._dynamicRoutes = []      // routes with :params
+    this._routeMapDirty = false
+  }
+  addRoute(method, p, handler) {
+    const m = method.toUpperCase()
+    const params = p.split('/').filter(s => s.startsWith(':')).map(s => s.slice(1))
+    const route = { method: m, path: p, handler, params }
+    this.routes.push(route)
+    if (params.length === 0) {
+      this._staticMap.set(m + ':' + p, route)  // exact static route
+    } else {
+      this._dynamicRoutes.push(route)           // parameterized
+    }
+  }
   registerModel(name, def) { this.models[name]=new Model(name, def); return this.models[name] }
 
   async handle(req, res) {
@@ -1293,7 +1379,15 @@ class AiplangServer {
       }
     } else if (!isMultipart) req.body = {}
 
-    const parsed = url.parse(req.url, true)
+    // Cache URL parsing — same URL hit repeatedly in benchmarks/health checks
+    const _urlCacheKey = req.url
+    let parsed = AiplangServer._urlCache?.get(_urlCacheKey)
+    if (!parsed) {
+      parsed = url.parse(req.url, true)
+      if (!AiplangServer._urlCache) AiplangServer._urlCache = new Map()
+      if (AiplangServer._urlCache.size > 500) AiplangServer._urlCache.clear() // prevent growth
+      AiplangServer._urlCache.set(_urlCacheKey, parsed)
+    }
     req.query = parsed.query; req.path = parsed.pathname
     req.user = extractToken(req) ? verifyJWT(extractToken(req)) : null
 
@@ -1327,14 +1421,30 @@ class AiplangServer {
       for (const [k, v] of Object.entries(this._helmetHeaders)) res.setHeader(k, v)
     }
 
-    for (const route of this.routes) {
-      if (route.method !== req.method) continue
-      const match = matchRoute(route.path, req.path); if (!match) continue
-      req.params = match
+    // Fast path: static routes — O(1) Map lookup
+    let _route = this._staticMap.get(req.method + ':' + req.path)
+    let _match = _route ? {} : null
+    // Slow path: dynamic routes with :params
+    if (!_route) {
+      for (const route of this._dynamicRoutes) {
+        if (route.method !== req.method) continue
+        const match = matchRoute(route.path, req.path)
+        if (match) { _route = route; _match = match; break }
+      }
+    }
+    if (_route) {
+      const route = _route
+      req.params = _match
       res.json    = (s, d) => {
         if(typeof s==='object'){d=s;s=200}
         const accept = req.headers['accept']||''
         const ae     = req.headers['accept-encoding']||''
+        // Fast path: no special headers → direct JSON (most common case)
+        if(!accept.includes('msgpack') && !ae.includes('gzip')) {
+          const body = JSON.stringify(d)
+          res.writeHead(s, {'Content-Type':'application/json','Content-Length':Buffer.byteLength(body)})
+          res.end(body); return
+        }
         if(accept.includes('application/msgpack')){
           try{ const buf=_mpEnc.encode(d); res.writeHead(s,{'Content-Type':'application/msgpack','Content-Length':buf.length}); res.end(buf); return }catch{}
         }
@@ -1345,7 +1455,7 @@ class AiplangServer {
             res.writeHead(s,{'Content-Type':'application/json','Content-Encoding':'gzip'});res.end(buf)
           })
         } else {
-          res.writeHead(s,{'Content-Type':'application/json'}); res.end(body)
+          res.writeHead(s,{'Content-Type':'application/json','Content-Length':Buffer.byteLength(body)}); res.end(body)
         }
       }
       res.error   = (s, m) => res.json(s, {error:m})
@@ -1941,8 +2051,42 @@ async function startServer(aipFile, port = 3000) {
   })
 
   // Health
+  // ── AI introspection: GET /__aip ──────────────────────────────────
+  srv.addRoute('GET', '/__aip', (req, res) => {
+    const modelInfo = {}
+    for (const [name, M] of Object.entries(srv._models || {})) {
+      modelInfo[name.toLowerCase()] = {
+        fields: M.fields ? M.fields.map(f => ({
+          name:f.name, type:f.type,
+          required:!!(f.modifiers?.includes('required')),
+          unique:!!(f.modifiers?.includes('unique')),
+          hashed:!!(f.modifiers?.includes('hashed'))
+        })) : [],
+        count: (() => { try { return M.count() } catch { return null } })()
+      }
+    }
+    const routeList = (srv._routes||[]).map(r=>({method:r.method,path:r.path,guards:r.guards||[]}))
+    res.json(200, {
+      version: VERSION,
+      models: modelInfo,
+      routes: routeList,
+      ai_hint: 'POST /__aip/validate with {source:"..."} to check .aip before applying.'
+    })
+  })
+
+  // POST /__aip/validate
+  srv.addRoute('POST', '/__aip/validate', async (req, res) => {
+    const { source } = req.body || {}
+    if (!source) { res.error(400, 'Body: { source: "aip content" }'); return }
+    try {
+      const errs = validateAip(source)
+      if (errs.length) res.json(422, { valid:false, errors:errs, fixes:errs.map(e=>e.fix).filter(Boolean) })
+      else res.json(200, { valid:true, message:'Syntax OK. Safe to apply.' })
+    } catch(e) { res.error(500, e.message) }
+  })
+
   srv.addRoute('GET', '/health', (req, res) => res.json(200, {
-    status:'ok', version:'2.10.9',
+    status:'ok', version:'2.11.1',
     models: app.models.map(m=>m.name),
     routes: app.apis.length, pages: app.pages.length,
     admin: app.admin?.prefix || null,
@@ -1967,10 +2111,33 @@ async function startServer(aipFile, port = 3000) {
 }
 
 module.exports = { startServer, parseApp, Model, getDB, dispatch, on, emit, sendMail, setupStripe, registerStripeRoutes, setupS3, registerS3Routes, s3Upload, s3Delete, s3PresignedUrl, cacheSet, cacheGet, cacheDel, broadcast, PLUGIN_UTILS }
+
 if (require.main === module) {
   const f=process.argv[2], p=parseInt(process.argv[3]||process.env.PORT||'3000')
   if (!f) { console.error('Usage: node server.js <app.aip> [port]'); process.exit(1) }
-  startServer(f, p).catch(e=>{console.error(e);process.exit(1)})
+
+  // ── Cluster mode: use all CPU cores for maximum throughput ────────
+  // Activated by: ~use cluster  OR  CLUSTER=true env var
+  const src = require('fs').readFileSync(f,'utf8')
+  const useCluster = src.includes('~use cluster') || process.env.CLUSTER === 'true'
+
+  if (useCluster && require('cluster').isPrimary) {
+    const cluster  = require('cluster')
+    const numCPUs  = parseInt(process.env.WORKERS || require('os').cpus().length)
+    console.log(`[aiplang] Cluster mode: ${numCPUs} workers (${require('os').cpus()[0].model.trim()})`)
+
+    for (let i = 0; i < numCPUs; i++) cluster.fork()
+
+    cluster.on('exit', (worker, code) => {
+      if (code !== 0) {
+        console.warn(`[aiplang] Worker ${worker.process.pid} died (code ${code}), restarting...`)
+        cluster.fork()
+      }
+    })
+    cluster.on('online', w => console.log(`[aiplang] Worker ${w.process.pid} online`))
+  } else {
+    startServer(f, p).catch(e=>{console.error(e);process.exit(1)})
+  }
 }
 
 // ═══════════════════════════════════════════════════════════════════