@rip-lang/server 1.3.125 → 1.4.1

package/tests/watchers.rip

@@ -1,4 +1,4 @@
-import { test, eq } from '../test.rip'
+import { test, eq } from './runner.rip'
 import { shouldTriggerCodeReload } from '../control/watchers.rip'
 
 test "shouldTriggerCodeReload matches extension watch specs", ->
@@ -6,9 +6,9 @@ test "shouldTriggerCodeReload matches extension watch specs", ->
   eq shouldTriggerCodeReload('foo.txt', '*.rip'), false
 
 test "shouldTriggerCodeReload matches exact filenames", ->
-  eq shouldTriggerCodeReload('config.rip', 'config.rip'), true
-  eq shouldTriggerCodeReload('nested/config.rip', 'config.rip'), true
-  eq shouldTriggerCodeReload('other.rip', 'config.rip'), false
+  eq shouldTriggerCodeReload('serve.rip', 'serve.rip'), true
+  eq shouldTriggerCodeReload('nested/serve.rip', 'serve.rip'), true
+  eq shouldTriggerCodeReload('other.rip', 'serve.rip'), false
 
 test "shouldTriggerCodeReload ignores the entry file itself", ->
   eq shouldTriggerCodeReload('index.rip', '*.rip', 'index.rip'), false

package/default.rip

@@ -1,435 +0,0 @@
-# ==============================================================================
-# @rip-lang/server — Default Static File Server
-# ==============================================================================
-#
-# Built-in fallback when no index.rip or index.ts exists in the target directory.
-# Activated automatically by `rip server` when no app entry is found.
-#
-# Behavior:
-#   - Serves static files with auto-detected MIME types
-#   - Directories with index.html serve the index.html
-#   - Directories without index.html show a browsable file listing
-#   - Hover preview for images and PDFs
-#   - Rip browser bundle available at /rip/rip.min.js
-#   - Hot-reload via SSE for .rip, .html, and .css changes
-#
-# ==============================================================================
-
-import { use, start, notFound } from '@rip-lang/server'
-import { serve } from '@rip-lang/server/middleware'
-import { statSync, readdirSync, readFileSync } from 'node:fs'
-import { join, resolve, basename } from 'node:path'
-
-root = resolve(process.env.APP_BASE_DIR or process.cwd())
-rootSlash = root + '/'
-rootName = basename(root) or root
-
-use serve dir: root, bundle: [], watch: true
-
-# --- Helpers ---
-
-esc = (s) ->
-  s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
-
-fmtSize = (n) ->
-  for u in ['B', 'KB', 'MB', 'GB']
-    if n < 1024
-      return if u is 'B' then "#{n} B" else "#{n.toFixed(1)} #{u}"
-    n /= 1024
-  "#{n.toFixed(1)} TB"
-
-fmtDate = (ms) ->
-  d = new Date(ms)
-  mo = d.toLocaleString('en', { month: 'short' })
-  day = String(d.getDate()).padStart(2, '0')
-  year = d.getFullYear()
-  hour = d.getHours()
-  min = String(d.getMinutes()).padStart(2, '0')
-  ampm = if hour >= 12 then 'PM' else 'AM'
-  hour = hour % 12 or 12
-  "#{mo} #{day}, #{year} at #{hour}:#{min} #{ampm}"
-
-EXT_ICONS =
-  html: '🌐', htm: '🌐', css: '🎨', js: '📜', mjs: '📜', ts: '📜'
-  json: '📋', rip: '⚡', md: '📝', txt: '📝', pdf: '📕'
-  png: '🖼️', jpg: '🖼️', jpeg: '🖼️', gif: '🖼️', svg: '🖼️', webp: '🖼️', ico: '🖼️'
-  zip: '📦', gz: '📦', tar: '📦'
-  mp3: '🎵', ogg: '🎵', wav: '🎵', mp4: '🎬', webm: '🎬'
-  woff: '🔤', woff2: '🔤', ttf: '🔤', otf: '🔤'
-
-IMG_EXTS = new Set ['png', 'jpg', 'jpeg', 'gif', 'svg', 'webp', 'avif']
-
-fileIcon = (name) ->
-  EXT_ICONS[name.slice(name.lastIndexOf('.') + 1).toLowerCase()] or '📄'
-
-previewAttr = (name, href) ->
-  ext = name.slice(name.lastIndexOf('.') + 1).toLowerCase()
-  if IMG_EXTS.has(ext) then " data-pv=\"image\" data-src=\"#{esc href}\"" else ''
-
-row = (ic, href, label, size = '', date = '', extra = '') ->
-  "<tr><td class=\"ic\">#{ic}</td><td><a href=\"#{esc href}\"#{extra}>#{esc label}</a></td><td class=\"sz\">#{size}</td><td class=\"dt\">#{date}</td></tr>"
-
-breadcrumbs = (reqPath) ->
-  parts = reqPath.split('/').filter((p) -> p)
-  crumbs = "<a href=\"/\">#{esc rootName}</a>"
-  href = ''
-  for part in parts
-    href += "/#{part}"
-    crumbs += " <span class=\"sep\">/</span> <a href=\"#{href}/\">#{esc part}</a>"
-  crumbs
-
-# --- Directory Index ---
-
-renderIndex = (reqPath, fsPath) ->
-  entries = try readdirSync(fsPath, { withFileTypes: true }) catch then []
-  dirs = []
-  files = []
-  for e in entries
-    continue if e.name.startsWith('.')
-    if e.isDirectory() then dirs.push(e.name) else files.push(e.name)
-  dirs.sort()
-  files.sort()
-
-  rows = []
-  rows.push row('📁', '../', '..') if reqPath isnt '/'
-  for d in dirs
-    rows.push row('📁', "#{d}/", d)
-  for f in files
-    try
-      s = statSync(join(fsPath, f))
-      rows.push row(fileIcon(f), f, f, fmtSize(s.size), fmtDate(s.mtimeMs), previewAttr(f, f))
-    catch
-      rows.push row(fileIcon(f), f, f)
-
-  numDirs = dirs.length
-  numFiles = files.length
-  summary = []
-  summary.push "#{numDirs} folder#{if numDirs isnt 1 then 's' else ''}" if numDirs > 0
-  summary.push "#{numFiles} file#{if numFiles isnt 1 then 's' else ''}" if numFiles > 0
-
-  """
-  <!DOCTYPE html>
-  <html lang="en">
-  <head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Index of #{esc reqPath}</title>
-  <style>
-  :root {
-    --bg: #f3f6f7;
-    --card: #fff;
-    --border: #e5e7eb;
-    --border-row: #f0f0f0;
-    --text: #1f2937;
-    --muted: #6b7280;
-    --link: #2563eb;
-    --link-visited: #7c3aed;
-    --hover-bg: #f0f7ff;
-    --head-bg: #fafbfc;
-    --sep: #cbd5e1;
-  }
-  @media (prefers-color-scheme: dark) {
-    :root {
-      --bg: #0d1117;
-      --card: #161b22;
-      --border: #30363d;
-      --border-row: #21262d;
-      --text: #c9d1d9;
-      --muted: #8b949e;
-      --link: #58a6ff;
-      --link-visited: #bc8cff;
-      --hover-bg: #1c2129;
-      --head-bg: #1c2129;
-      --sep: #484f58;
-    }
-  }
-  *, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
-  body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
-    font-size: 15px;
-    line-height: 1.5;
-    color: var(--text);
-    background: var(--bg);
-    -webkit-font-smoothing: antialiased;
-  }
-  .wrap { max-width: 960px; margin: 2.5rem auto; padding: 0 1rem; }
-  .card {
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-radius: 8px;
-    overflow: hidden;
-    box-shadow: 0 1px 3px rgba(0,0,0,.06), 0 1px 2px rgba(0,0,0,.04);
-  }
-  .bar {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: .875rem 1.25rem;
-    border-bottom: 1px solid var(--border);
-    gap: 1rem;
-  }
-  .crumbs { font-size: .9375rem; font-weight: 500; }
-  .crumbs a { color: var(--link); text-decoration: none; }
-  .crumbs a:hover { text-decoration: underline; }
-  .sep { color: var(--sep); margin: 0 .3rem; font-weight: 400; }
-  .meta { font-size: .8125rem; color: var(--muted); white-space: nowrap; }
-  table { width: 100%; border-collapse: collapse; }
-  th {
-    position: sticky; top: 0;
-    background: var(--head-bg);
-    text-align: left;
-    padding: .625rem 1.25rem;
-    font-size: .6875rem;
-    font-weight: 600;
-    color: var(--muted);
-    text-transform: uppercase;
-    letter-spacing: .05em;
-    border-bottom: 1px solid var(--border);
-  }
-  td {
-    padding: .5rem 1.25rem;
-    border-bottom: 1px solid var(--border-row);
-    font-size: .875rem;
-    vertical-align: middle;
-  }
-  tr:last-child td { border-bottom: none; }
-  tbody tr:hover { background: var(--hover-bg); }
-  td a { color: var(--link); text-decoration: none; }
-  td a:hover { color: var(--link); text-decoration: underline; }
-  td a:visited { color: var(--link-visited); }
-  .ic { width: 2.5rem; text-align: center; font-size: 1.125rem; }
-  .sz { width: 6rem; text-align: right; color: var(--muted); white-space: nowrap; font-variant-numeric: tabular-nums; }
-  .dt { color: var(--muted); white-space: nowrap; }
-  th.sz { text-align: right; }
-  .pop {
-    position: fixed; z-index: 9999; pointer-events: none;
-    width: 320px; background: var(--card);
-    border: 1px solid var(--border); border-radius: 12px;
-    box-shadow: 0 10px 30px rgba(0,0,0,.12);
-    overflow: hidden; opacity: 0;
-    transform: translateY(6px) scale(.985);
-    transition: opacity 150ms ease, transform 150ms ease;
-  }
-  .pop.on { opacity: 1; transform: none; }
-  .pop-h {
-    padding: 8px 14px; font-size: .6875rem; font-weight: 700;
-    letter-spacing: .06em; color: var(--muted); text-transform: uppercase;
-    border-bottom: 1px solid var(--border-row); background: var(--head-bg);
-  }
-  .pop-b { display: flex; align-items: center; justify-content: center; min-height: 100px; }
-  .pop-b img { display: block; max-width: 100%; max-height: 240px; }
-  @media (max-width: 640px) {
-    .wrap { margin: 1rem auto; }
-    td, th { padding: .5rem .75rem; }
-    .dt, th.dt { display: none; }
-    .bar { padding: .75rem 1rem; }
-    .pop { display: none; }
-  }
-  </style>
-  </head>
-  <body>
-  <div class="wrap">
-  <div class="card">
-  <div class="bar">
-    <div class="crumbs">#{breadcrumbs reqPath}</div>
-    <div class="meta">#{summary.join(' &middot; ')}</div>
-  </div>
-  <table>
-  <thead><tr><th></th><th>Name</th><th class="sz">Size</th><th class="dt">Modified</th></tr></thead>
-  <tbody>
-  #{rows.join('\n')}
-  </tbody>
-  </table>
-  </div>
-  </div>
-  <script>
-  (function(){
-    var pop,cur,ox=16,oy=16;
-    function esc(s){return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;')}
-    function base(s){return decodeURIComponent(s.split('?')[0].split('/').pop())}
-    function mk(){
-      if(pop)return pop;
-      pop=document.createElement('div');pop.className='pop';
-      pop.innerHTML='<div class="pop-h"></div><div class="pop-b"></div>';
-      document.body.appendChild(pop);return pop;
-    }
-    function show(a,e){
-      var t=a.dataset.pv,s=a.dataset.src;if(!t||!s)return;
-      var el=mk(),h=el.firstChild,b=el.lastChild;
-      h.textContent='PREVIEW';b.innerHTML='';
-      var img=new Image();img.src=s;img.alt=base(s);b.appendChild(img);
-      cur=a;el.classList.add('on');place(e.clientX,e.clientY);
-    }
-    function hide(){cur=null;if(pop)pop.classList.remove('on')}
-    function place(x,y){
-      if(!pop)return;var r=pop.getBoundingClientRect(),p=12,l=x+ox,t=y+oy;
-      if(l+r.width>innerWidth-p)l=x-r.width-ox;
-      if(t+r.height>innerHeight-p)t=innerHeight-r.height-p;
-      if(l<p)l=p;if(t<p)t=p;
-      pop.style.left=l+'px';pop.style.top=t+'px';
-    }
-    document.addEventListener('mouseover',function(e){var a=e.target.closest('[data-pv]');if(a)show(a,e)});
-    document.addEventListener('mousemove',function(e){if(cur)place(e.clientX,e.clientY)});
-    document.addEventListener('mouseout',function(e){var a=e.target.closest('[data-pv]');if(a&&a===cur)hide()});
-    document.addEventListener('scroll',hide,{passive:true});
-    window.addEventListener('blur',hide);
-  })();
-  </script>
-  </body>
-  </html>
-  """
-
-renderMarkdown = (reqPath, fsPath) ->
-  md = readFileSync(fsPath, 'utf8')
-  body = Bun.markdown.html(md)
-  name = esc(basename(fsPath))
-  """
-  <!DOCTYPE html>
-  <html lang="en">
-  <head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>#{name}</title>
-  <style>
-  :root {
-    --bg: #f3f6f7; --card: #fff; --border: #d1d9e0; --border-subtle: #d1d9e0b3;
-    --text: #1f2328; --muted: #59636e; --link: #0969da;
-    --head-bg: #fafbfc; --sep: #cbd5e1;
-    --code-bg: #f6f8fa; --code-inline: #818b981f;
-    --table-alt: #f6f8fa; --hr: #d1d9e0;
-    --mark-bg: #fff8c5; --mark-text: #1f2328;
-  }
-  @media (prefers-color-scheme: dark) {
-    :root {
-      --bg: #0d1117; --card: #161b22; --border: #30363d; --border-subtle: #30363db3;
-      --text: #e6edf3; --muted: #8b949e; --link: #58a6ff;
-      --head-bg: #1c2129; --sep: #484f58;
-      --code-bg: #161b22; --code-inline: #b1bac41f;
-      --table-alt: #161b22; --hr: #3d444d;
-      --mark-bg: #bb800926; --mark-text: #e6edf3;
-    }
-  }
-  *, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
-  body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji';
-    font-size: 16px; line-height: 1.5; color: var(--text); background: var(--bg);
-    word-wrap: break-word;
-  }
-  .wrap { max-width: 820px; margin: 2.5rem auto; padding: 0 1rem; }
-  .card {
-    background: var(--card); border: 1px solid var(--border); border-radius: 8px;
-    overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,.06), 0 1px 2px rgba(0,0,0,.04);
-  }
-  .bar {
-    display: flex; align-items: center; justify-content: space-between;
-    padding: .875rem 1.25rem; border-bottom: 1px solid var(--border);
-  }
-  .crumbs { font-size: .9375rem; font-weight: 500; }
-  .crumbs a { color: var(--link); text-decoration: none; }
-  .crumbs a:hover { text-decoration: underline; }
-  .sep { color: var(--sep); margin: 0 .3rem; font-weight: 400; }
-  article { padding: 2rem 2.5rem; }
-  article > *:first-child { margin-top: 0 !important; }
-  article > *:last-child { margin-bottom: 0 !important; }
-  article h1, article h2, article h3, article h4, article h5, article h6 {
-    margin-top: 1.5rem; margin-bottom: 1rem; font-weight: 600; line-height: 1.25;
-  }
-  article h1 { font-size: 2em; padding-bottom: .3em; border-bottom: 1px solid var(--border-subtle); }
-  article h2 { font-size: 1.5em; padding-bottom: .3em; border-bottom: 1px solid var(--border-subtle); }
-  article h3 { font-size: 1.25em; }
-  article h4 { font-size: 1em; }
-  article h5 { font-size: .875em; }
-  article h6 { font-size: .85em; color: var(--muted); }
-  article p, article blockquote, article ul, article ol, article dl, article table, article pre, article details {
-    margin-top: 0; margin-bottom: 1rem;
-  }
-  article a { color: var(--link); text-decoration: none; }
-  article a:hover { text-decoration: underline; }
-  article strong { font-weight: 600; }
-  article img { max-width: 100%; box-sizing: content-box; border-style: none; }
-  article ul, article ol { padding-left: 2em; }
-  article ol ol, article ul ol { list-style-type: lower-roman; }
-  article ul ul ol, article ul ol ol, article ol ul ol, article ol ol ol { list-style-type: lower-alpha; }
-  article ul ul, article ul ol, article ol ol, article ol ul { margin-top: 0; margin-bottom: 0; }
-  article li + li { margin-top: .25em; }
-  article li > p { margin-top: 1rem; }
-  article li > input[type="checkbox"] { margin-right: .5rem; }
-  article blockquote { padding: 0 1em; color: var(--muted); border-left: .25em solid var(--border); }
-  article blockquote > :first-child { margin-top: 0; }
-  article blockquote > :last-child { margin-bottom: 0; }
-  article mark { background-color: var(--mark-bg); color: var(--mark-text); }
-  article code, article tt {
-    font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
-    font-size: 85%; padding: .2em .4em; margin: 0;
-    white-space: break-spaces; background-color: var(--code-inline); border-radius: 6px;
-  }
-  article pre {
-    font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
-    font-size: 85%; line-height: 1.45; padding: 1rem;
-    overflow: auto; background-color: var(--code-bg); border: 1px solid var(--border); border-radius: 6px;
-  }
-  article pre code, article pre tt {
-    display: inline; padding: 0; margin: 0; overflow: visible;
-    line-height: inherit; word-wrap: normal; background-color: transparent;
-    border: 0; font-size: 100%; white-space: pre;
-  }
-  article table { display: block; width: max-content; max-width: 100%; overflow: auto; border-spacing: 0; border-collapse: collapse; }
-  article table th { font-weight: 600; }
-  article table th, article table td { padding: 6px 13px; border: 1px solid var(--border); }
-  article table tr { background-color: var(--card); border-top: 1px solid var(--border-subtle); }
-  article table tr:nth-child(2n) { background-color: var(--table-alt); }
-  article table td > :last-child { margin-bottom: 0; }
-  article hr {
-    height: .25em; padding: 0; margin: 1.5rem 0;
-    background-color: var(--hr); border: 0; overflow: hidden;
-  }
-  article del { color: var(--muted); }
-  article dl dt { padding: 0; margin-top: 1rem; font-size: 1em; font-style: italic; font-weight: 600; }
-  article dl dd { padding: 0 1rem; margin-bottom: 1rem; }
-  @media (max-width: 640px) { article { padding: 1.25rem 1rem; } .wrap { margin: 1rem auto; } }
-  </style>
-  </head>
-  <body>
-  <div class="wrap">
-  <div class="card">
-  <div class="bar">
-    <div class="crumbs">#{breadcrumbs reqPath}</div>
-  </div>
-  <article>#{body}</article>
-  </div>
-  </div>
-  </body>
-  </html>
-  """
-
-# --- Request Handler ---
-
-notFound ->
-  reqPath = try decodeURIComponent(@req.path) catch then @req.path
-  path = resolve(root, reqPath.slice(1))
-
-  unless path is root or path.startsWith(rootSlash)
-    return new Response 'Not Found', { status: 404 }
-
-  try
-    stat = statSync(path)
-  catch
-    return new Response 'Not Found', { status: 404 }
-
-  if stat.isFile()
-    if path.endsWith('.md')
-      try
-        html = renderMarkdown(reqPath, path)
-        return new Response html, { headers: { 'Content-Type': 'text/html; charset=UTF-8' } }
-    return @send path
-
-  if stat.isDirectory()
-    return new Response(null, { status: 301, headers: { Location: "#{reqPath}/" } }) unless reqPath.endsWith('/')
-    indexPath = join(path, 'index.html')
-    if (try statSync(indexPath).isFile())
-      return @send indexPath, 'text/html; charset=UTF-8'
-    return new Response renderIndex(reqPath, path), { headers: { 'Content-Type': 'text/html; charset=UTF-8' } }
-
-  new Response 'Not Found', { status: 404 }
-
-start()

package/docs/edge/CONFIG_LIFECYCLE.md

@@ -1,111 +0,0 @@
-# Edge Config Lifecycle
-
-This document describes the implemented v1 lifecycle for `Edgefile.rip` changes.
-
-## Goal
-
-Config updates must be:
-
-- atomic
-- reversible
-- observable
-- safe for in-flight HTTP and websocket proxy traffic
-
-## Apply pipeline
-
-1. **Parse**
-   - Load `Edgefile.rip`.
-   - Evaluate it synchronously in config context.
-   - Reject on syntax or runtime errors.
-
-2. **Validate**
-   - Require `version: 1`.
-   - Validate only supported top-level keys:
-     - `version`
-     - `edge`
-     - `upstreams`
-     - `apps`
-     - `routes`
-     - `sites`
-   - Validate route references, wildcard hosts, websocket route requirements,
-     timeout shapes, and verification policy.
-
-3. **Normalize**
-   - Expand defaults from `CONTRACTS.md`.
-   - Normalize upstreams, managed apps, route rules, site groups, timeouts, and
-     verification policy.
-   - Compile the deterministic route table.
-
-4. **Stage**
-   - Build a new edge runtime generation:
-     - upstream pool
-     - route table
-     - config metadata
-     - verification policy
-   - Prepare managed app registry changes for the new config.
-   - Do not affect active traffic yet.
-
-5. **Activate**
-   - Swap the active edge runtime pointer atomically.
-   - Begin routing new requests through the new generation immediately.
-   - Keep the previous generation as a retired runtime for rollback or drain.
-
-6. **Post-activate verify**
-   - Run route-aware verification according to `edge.verify`.
-   - Check referenced upstreams, healthy target counts, and managed app worker readiness.
-   - Emit structured activation events.
-
-7. **Rollback (if needed)**
-   - Restore the previous app registry snapshot.
-   - Restore the previous active edge runtime.
-   - Mark the failed generation retired and let it drain if needed.
-   - Record structured rollback metadata including reason code and details.
-
-## Trigger modes
-
-- file watch (`Edgefile.rip`)
-- `SIGHUP`
-- control API: `POST /reload` on the control Unix socket
-
-All triggers use the same runtime reload path and the same safeguards.
-
-## Determinism rules
-
-- No async work while evaluating config.
-- No network I/O while evaluating config.
-- Validation must be repeatable for identical input.
-
-## Failure behavior
-
-- Parse/validate failure: keep serving with the existing config.
-- Stage failure: keep serving with the existing config.
-- Post-activate verification failure: rollback to the previous runtime automatically.
-
-## Draining behavior
-
-- Retired runtimes remain alive while:
-  - HTTP requests that started on them are still in flight
-  - websocket proxy connections that started on them are still open
-- Health checks are stopped only after a retired runtime finishes draining.
-
-## Observability
-
-Every reload attempt records:
-
-- attempt ID
-- source trigger (`startup`, `sighup`, `control_api`)
-- old version
-- new version
-- result (`loaded`, `applied`, `rejected`, `rolled_back`)
-- reason
-- reason code
-- reason details
-- timestamp
-
-`/diagnostics` exposes:
-
-- active config metadata
-- active runtime inflight and websocket counts
-- retired runtimes still draining
-- last reload attempt
-- bounded reload history

package/docs/edge/CONTRACTS.md

@@ -1,137 +0,0 @@
-# Edge Contracts
-
-This document describes the implemented core contracts for the unified
-edge/app runtime in `@rip-lang/server`.
-
-## Source of truth inputs
-
-- Runtime implementation: `packages/server/server.rip`
-- Edge config normalization: `packages/server/edge/config.rip`
-- Edge runtime lifecycle: `packages/server/edge/runtime.rip`
-- Verification policy: `packages/server/edge/verify.rip`
-- TLS findings: `packages/server/spikes/tls/FINDINGS.md`
-
-## AppDescriptor
-
-```ts
-type AppDescriptor = {
-  id: string
-  entry: string | null
-  appBaseDir: string | null
-  hosts: string[]
-  workers: number | null
-  maxQueue: number
-  queueTimeoutMs: number
-  readTimeoutMs: number
-  env: Record<string, string>
-}
-```
-
-## WorkerEndpoint
-
-```ts
-type WorkerEndpoint = {
-  appId: string
-  workerId: number
-  socketPath: string
-  inflight: number
-  version: number | null
-  startedAt: number
-}
-```
-
-## RouteRule
-
-```ts
-type RouteRule = {
-  id: string
-  host: string | "*" | "*.example.com"
-  path: string
-  methods: string[] | "*"
-  priority: number
-  upstream?: string | null
-  app?: string | null
-  static?: string | null
-  redirect?: { to: string, status: number } | null
-  headers?: { set?: Record<string, string>, remove?: string[] } | null
-  websocket?: boolean
-  timeouts?: Partial<TimeoutPolicy>
-}
-```
-
-## VerifyPolicy
-
-```ts
-type VerifyPolicy = {
-  requireHealthyUpstreams: boolean
-  requireReadyApps: boolean
-  includeUnroutedManagedApps: boolean
-  minHealthyTargetsPerUpstream: number
-}
-```
-
-Defaults:
-
-- `requireHealthyUpstreams: true`
-- `requireReadyApps: true`
-- `includeUnroutedManagedApps: true`
-- `minHealthyTargetsPerUpstream: 1`
-
-## EdgeRuntime
-
-```ts
-type EdgeRuntime = {
-  id: string
-  upstreamPool: UpstreamPool
-  routeTable: RouteTable
-  configInfo: ConfigInfo
-  verifyPolicy: VerifyPolicy | null
-  inflight: number
-  wsConnections: number
-  retiredAt: string | null
-}
-```
-
-## SchedulerDecision
-
-```ts
-type SchedulerDecision = {
-  appId: string
-  selectedWorker: WorkerEndpoint
-  algorithm: "least-inflight"
-  fallback: "queue" | "shed-503"
-  queuePosition: number | null
-}
-```
-
-Defaults:
-
-- `algorithm: "least-inflight"`
-- `fallback: "queue"` while queue `< maxQueue`, else `"shed-503"`
-- `queuePosition: null` when immediately assigned
-
-## TlsCertRecord
-
-```ts
-type TlsCertRecord = {
-  id: string
-  domains: string[]
-  notBefore: number
-  notAfter: number
-  fingerprint: string
-  certPath: string
-  keyPath: string
-  source: "acme" | "manual" | "shipped"
-  lastRenewAttempt: number | null
-  lastRenewResult: "success" | "failed" | null
-}
-```
-
-## TLS constraints
-
-From `packages/server/spikes/tls/FINDINGS.md`:
-
-- dynamic SNI selection was not observed
-- in-process cert hot reload was not observed
-- graceful restart cert activation works
-- ACME HTTP-01 is the reliable v1 baseline