rip-lang 3.10.4 → 3.10.6

package/CHANGELOG.md

@@ -7,6 +7,17 @@ All notable changes to Rip will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.10.6] - 2026-02-20
+
+### CLI — Fix Multiline Argument Corruption
+
+- **`execSync` → `spawnSync` in `bin/rip`** — The CLI runner was passing script arguments through a shell via `execSync` with string interpolation. Any argument containing a newline (JSON payloads, heredoc content, multiline strings) was silently split into separate shell commands. Replaced all three `execSync` call sites (`.rip` file execution, compiled temp file execution, and `bin/` script fallback) with `spawnSync` using argument arrays, bypassing the shell entirely. Exit codes use `?? 1` (nullish coalescing) instead of `|| 0` for correct signal-kill handling.
+
+### Utilities — `curl.rip` Improvements
+
+- **Stdin TTY guard** — `curl.rip` no longer hangs when run interactively without a payload argument. Added `process.stdin.isTTY` check to only read from stdin when piped or heredoc'd.
+- **Documented inline and heredoc modes** — Updated header comments to clearly show both usage patterns.
+
 ## [3.9.1] - 2026-02-18
 
 ### Runtime — Reactivity & Reconciliation

package/README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.9.1-blue.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.10.6-blue.svg" alt="Version"></a>
   <a href="#zero-dependencies"><img src="https://img.shields.io/badge/dependencies-ZERO-brightgreen.svg" alt="Dependencies"></a>
   <a href="#"><img src="https://img.shields.io/badge/tests-1%2C243%2F1%2C243-brightgreen.svg" alt="Tests"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
@@ -290,8 +290,8 @@ See [@rip-lang/ui](packages/ui/) for the full framework: file-based router, reac
 | **Dependencies** | Multiple | Zero |
 | **Self-hosting** | No | Yes |
 | **Lexer** | 3,558 LOC | 2,024 LOC |
-| **Compiler** | 10,346 LOC | 3,289 LOC |
-| **Total** | 17,760 LOC | ~9,500 LOC |
+| **Compiler** | 10,346 LOC | 3,293 LOC |
+| **Total** | 17,760 LOC | ~11,100 LOC |
 
 Smaller codebase, modern output, built-in reactivity.
 
@@ -326,7 +326,7 @@ await rip("res = fetch! 'https://api.example.com/todos/1'; res.json!")  // → {
 
 ```
 Source  ->  Lexer  ->  emitTypes  ->  Parser  ->  S-Expressions  ->  Codegen  ->  JavaScript
-           (1,761)    (types.js)     (359)       ["=", "x", 42]     (3,291)      + source map
+           (1,761)    (types.js)     (359)       ["=", "x", 42]     (3,293)      + source map
 ```
 
 Simple arrays (with `.loc`) instead of AST node classes. The compiler is self-hosting — `bun run parser` rebuilds from source.
@@ -334,17 +334,17 @@ Simple arrays (with `.loc`) instead of AST node classes. The compiler is self-ho
 | Component | File | Lines |
 |-----------|------|-------|
 | Lexer + Rewriter | `src/lexer.js` | 1,761 |
-| Compiler + Codegen | `src/compiler.js` | 3,291 |
+| Compiler + Codegen | `src/compiler.js` | 3,293 |
 | Type System | `src/types.js` | 1,099 |
-| Component System | `src/components.js` | 1,645 |
-| Source Maps | `src/sourcemaps.js` | 121 |
+| Component System | `src/components.js` | 1,750 |
+| Source Maps | `src/sourcemaps.js` | 189 |
 | Parser (generated) | `src/parser.js` | 359 |
 | Grammar | `src/grammar/grammar.rip` | 944 |
 | Parser Generator | `src/grammar/solar.rip` | 929 |
 | REPL | `src/repl.js` | 601 |
-| Browser Entry | `src/browser.js` | 150 |
+| Browser Entry | `src/browser.js` | 151 |
 | Tags | `src/tags.js` | 62 |
-| **Total** | | **~10,962** |
+| **Total** | | **~11,138** |
 
 ---
 
@@ -354,15 +354,15 @@ Rip includes optional packages for full-stack development:
 
 | Package | Version | Purpose |
 |---------|---------|---------|
-| [rip-lang](https://www.npmjs.com/package/rip-lang) | 3.9.1 | Core language compiler |
-| [@rip-lang/api](packages/api/) | 1.1.6 | HTTP framework (Sinatra-style routing, 37 validators) |
-| [@rip-lang/server](packages/server/) | 1.1.5 | Multi-worker app server (hot reload, HTTPS, mDNS) |
-| [@rip-lang/db](packages/db/) | 1.1.5 | DuckDB server with official UI (pure Bun FFI) |
-| [@rip-lang/ui](packages/ui/) | 0.3.2 | Zero-build reactive web framework (stash, router, hash routing) |
-| [@rip-lang/swarm](packages/swarm/) | 1.1.3 | Parallel job runner with worker pool |
-| [@rip-lang/csv](packages/csv/) | 1.1.3 | CSV parser + writer |
-| [@rip-lang/schema](packages/schema/) | 0.2.0 | Unified schema → TypeScript types, SQL DDL, validation, ORM |
-| [VS Code Extension](packages/vscode/) | 0.3.2 | Syntax highlighting, type intelligence, source maps |
+| [rip-lang](https://www.npmjs.com/package/rip-lang) | 3.10.6 | Core language compiler |
+| [@rip-lang/api](packages/api/) | 1.1.10 | HTTP framework (Sinatra-style routing, 37 validators) |
+| [@rip-lang/server](packages/server/) | 1.1.19 | Multi-worker app server (hot reload, HTTPS, mDNS) |
+| [@rip-lang/db](packages/db/) | 1.2.0 | DuckDB server with official UI + ActiveRecord-style client |
+| [@rip-lang/ui](packages/ui/) | 0.3.14 | Zero-build reactive web framework (stash, router, hash routing) |
+| [@rip-lang/swarm](packages/swarm/) | 1.1.4 | Parallel job runner with worker pool |
+| [@rip-lang/csv](packages/csv/) | 1.1.4 | CSV parser + writer |
+| [@rip-lang/schema](packages/schema/) | 0.2.1 | Unified schema → TypeScript types, SQL DDL, validation, ORM |
+| [VS Code Extension](packages/vscode/) | 0.5.0 | Syntax highlighting, type intelligence, source maps |
 
 ```bash
 bun add -g @rip-lang/db    # Installs everything (rip-lang + api + db)

package/bin/rip

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 
 import { readFileSync, writeFileSync, existsSync, statSync, unlinkSync } from 'fs';
-import { execSync, spawn } from 'child_process';
+import { execSync, spawnSync, spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { dirname, basename, join } from 'path';
 import { Compiler } from '../src/compiler.js';
@@ -180,25 +180,19 @@ async function main() {
     }
   }
 
-  // If no compile flags → execute the script instead of compiling it
-  const hasCompileFlag = showCompiled || showTokens || showSExpr || generateDts || generateMap || outputFile;
-  if (inputFile && !hasCompileFlag) {
-    if (!existsSync(inputFile)) {
-      console.error(`Error: File not found: ${inputFile}`);
-      process.exit(1);
-    }
+  // Helper to check if path is a regular file (not a directory)
+  const isFile = (path) => existsSync(path) && statSync(path).isFile();
 
+  // If no compile flags and file exists → execute the script instead of compiling it
+  const hasCompileFlag = showCompiled || showTokens || showSExpr || generateDts || generateMap || outputFile;
+  if (inputFile && !hasCompileFlag && isFile(inputFile)) {
     const loaderPath = join(__dirname, '../rip-loader.js');
 
     if (inputFile.endsWith('.rip')) {
-      try {
-        execSync(`bun --preload ${loaderPath} ${inputFile} ${scriptArgs.join(' ')}`, {
-          stdio: 'inherit'
-        });
-        process.exit(0);
-      } catch (error) {
-        process.exit(error.status || 1);
-      }
+      const result = spawnSync('bun', ['--preload', loaderPath, inputFile, ...scriptArgs], {
+        stdio: 'inherit'
+      });
+      process.exit(result.status ?? 1);
     } else {
       // Non-.rip files (e.g. shebang scripts): compile, write temp file, execute
       const source = readFileSync(inputFile, 'utf-8');
@@ -208,7 +202,8 @@ async function main() {
       let exitCode = 0;
       try {
         writeFileSync(tmp, result.code);
-        execSync(`bun --preload ${loaderPath} "${tmp}" ${scriptArgs.join(' ')}`, { stdio: 'inherit' });
+        const r = spawnSync('bun', ['--preload', loaderPath, tmp, ...scriptArgs], { stdio: 'inherit' });
+        exitCode = r.status ?? 1;
       } catch (error) {
         exitCode = error.status || 1;
       }
@@ -217,9 +212,6 @@ async function main() {
     }
   }
 
-  // Helper to check if path is a regular file (not a directory)
-  const isFile = (path) => existsSync(path) && statSync(path).isFile();
-
   // Fallback: Check for bin/ script in git repo root
   // Allows `rip migrate --status` to find and run {repo}/bin/migrate
   // Also triggers if inputFile is a directory (not a compilable file)
@@ -235,16 +227,8 @@ async function main() {
       const binScript = join(repoRoot, 'bin', inputFile);
 
       if (existsSync(binScript)) {
-        // Found it! Execute with remaining args
-        try {
-          execSync(`"${binScript}" ${scriptArgs.join(' ')}`, {
-            stdio: 'inherit',
-            shell: true
-          });
-          process.exit(0);
-        } catch (error) {
-          process.exit(error.status || 1);
-        }
+        const r = spawnSync(binScript, scriptArgs, { stdio: 'inherit' });
+        process.exit(r.status ?? 1);
       }
     } catch {
       // Not in a git repo, or git not available - fall through to normal error

package/docs/RIP-INTERNALS.md

@@ -45,7 +45,7 @@ class BinaryOp {
 ["+", left, right]  // That's it!
 ```
 
-**Result:** CoffeeScript's compiler is 17,760 LOC. Rip's is ~10,800 LOC — smaller, yet includes a complete reactive runtime, type system, component system, and source maps.
+**Result:** CoffeeScript's compiler is 17,760 LOC. Rip's is ~10,400 LOC — smaller, yet includes a complete reactive runtime, type system, component system, and source maps.
 
 > **Transform the IR (s-expressions), not the output (strings).**
 
@@ -77,7 +77,7 @@ console.log(code);
 | Dependencies | Multiple | **Zero** |
 | Parser generator | External (Jison) | **Built-in (Solar)** |
 | Self-hosting | No | **Yes** |
-| Total LOC | 17,760 | ~10,800 |
+| Total LOC | 17,760 | ~10,400 |
 
 ## Design Principles
 
@@ -93,7 +93,7 @@ console.log(code);
 
 ```
 Source Code  →  Lexer  →  emitTypes  →  Parser  →  S-Expressions  →  Codegen  →  JavaScript
-                (1,958)    (types.js)    (359)       (arrays + .loc)     (3,378)      + source map
+                (1,761)    (types.js)    (359)       (arrays + .loc)     (3,293)      + source map
                               ↓
                            file.d.ts (when types: "emit")
 ```
@@ -102,15 +102,15 @@ Source Code  →  Lexer  →  emitTypes  →  Parser  →  S-Expressions  →  C
 
 | File | Purpose | Lines | Modify? |
 |------|---------|-------|---------|
-| `src/lexer.js` | Lexer + Rewriter | 1,958 | Yes |
-| `src/compiler.js` | Compiler + Code Generator | 3,378 | Yes |
+| `src/lexer.js` | Lexer + Rewriter | 1,761 | Yes |
+| `src/compiler.js` | Compiler + Code Generator | 3,293 | Yes |
 | `src/types.js` | Type System (lexer sidecar) | 1,099 | Yes |
-| `src/components.js` | Component System (compiler sidecar) | 1,240 | Yes |
-| `src/sourcemaps.js` | Source Map V3 Generator | 122 | Yes |
-| `src/tags.js` | HTML Tag Classification | 63 | Yes |
-| `src/parser.js` | Generated parser | 357 | No (auto-gen) |
-| `src/grammar/grammar.rip` | Grammar specification | 945 | Yes (carefully) |
-| `src/grammar/solar.rip` | Parser generator | 916 | No |
+| `src/components.js` | Component System (compiler sidecar) | 1,750 | Yes |
+| `src/sourcemaps.js` | Source Map V3 Generator | 189 | Yes |
+| `src/tags.js` | HTML Tag Classification | 62 | Yes |
+| `src/parser.js` | Generated parser | 359 | No (auto-gen) |
+| `src/grammar/grammar.rip` | Grammar specification | 944 | Yes (carefully) |
+| `src/grammar/solar.rip` | Parser generator | 929 | No |
 
 ## Example Flow
 
@@ -275,7 +275,7 @@ S-expressions are simple arrays that serve as Rip's intermediate representation
 
 # 4. Lexer & Rewriter
 
-The lexer (`src/lexer.js`) is a clean reimplementation that replaces the old lexer (3,260 lines) with ~1,870 lines producing the same token vocabulary the parser expects.
+The lexer (`src/lexer.js`) is a clean reimplementation that replaces the old lexer (3,260 lines) with ~1,760 lines producing the same token vocabulary the parser expects.
 
 ## Architecture
 
@@ -439,7 +439,7 @@ REGEX tokens store `delimiter` and optional `heregex` flags in `token.data`.
 
 # 6. Compiler
 
-The compiler (`src/compiler.js`) is a clean reimplementation replacing the old compiler (6,016 lines) with ~3,290 lines producing identical JavaScript output.
+The compiler (`src/compiler.js`) is a clean reimplementation replacing the old compiler (6,016 lines) with ~3,293 lines producing identical JavaScript output.
 
 ## Structure
 
@@ -577,4 +577,4 @@ rip> .js      # Toggle JS display
 
 ---
 
-*Rip 3.8 — 1,241 tests passing — Zero dependencies — Self-hosting — ~11,000 LOC*
+*Rip 3.10 — 1,243 tests — Zero dependencies — Self-hosting — ~13,500 LOC*

package/docs/RIP-LANG.md

@@ -2,7 +2,7 @@
 
 # Rip Language Reference
 
-Rip is a modern reactive language that compiles to ES2022 JavaScript. It combines CoffeeScript's elegant syntax with built-in reactivity primitives. Zero dependencies, self-hosting, ~10,800 LOC.
+Rip is a modern reactive language that compiles to ES2022 JavaScript. It combines CoffeeScript's elegant syntax with built-in reactivity primitives. Zero dependencies, self-hosting, ~13,500 LOC.
 
 ---
 
@@ -17,7 +17,7 @@ Rip is a modern reactive language that compiles to ES2022 JavaScript. It combine
 7. [Async Patterns](#7-async-patterns)
 8. [Modules & Imports](#8-modules--imports)
 9. [Regex Features](#9-regex-features)
-10. [Server-Side Development](#10-server-side-development)
+10. [Packages](#10-packages)
 11. [CLI Tools & Scripts](#11-cli-tools--scripts)
 12. [Types](#12-types)
 13. [JavaScript Interop](#13-javascript-interop)
@@ -663,6 +663,19 @@ counter = Counter.new(initial: 5)
 # Same as: new Counter({initial: 5})
 ```
 
+## Implicit Commas
+
+When a literal value is followed by an arrow function, Rip inserts a comma automatically:
+
+```coffee
+# Clean route handlers
+get '/users' -> User.all!
+get '/users/:id' -> User.find params.id
+post '/users' -> User.create body
+```
+
+This enables Sinatra-style routing and other DSLs where functions take a value and a callback.
+
 ---
 
 # 5. Classes
@@ -1087,98 +1100,218 @@ text =~ /line2/m        # Works with /m flag
 
 ---
 
-# 10. Server-Side Development
+# 10. Packages
+
+Rip includes optional packages for full-stack development. All are written in Rip, have zero dependencies, and run on Bun.
+
+```bash
+bun add @rip-lang/api            # Web framework
+bun add @rip-lang/server         # Production server
+bun add @rip-lang/ui             # Reactive web UI
+bun add @rip-lang/db             # DuckDB server + client
+bun add @rip-lang/schema         # ORM + validation
+bun add @rip-lang/swarm          # Parallel job runner
+bun add @rip-lang/csv            # CSV parser + writer
+```
 
-## HTTP Server
+## @rip-lang/api — Web Framework
+
+Sinatra-style routing with `@` context magic and built-in validators.
 
 ```coffee
-import { serve } from "bun"
+import { get, post, use, read, start, notFound } from '@rip-lang/api'
 
-serve
-  port: 3000
-  fetch: (req) ->
-    url = new URL(req.url)
-    switch url.pathname
-      when "/"
-        new Response("Hello from Rip!")
-      when "/api/users"
-        Response.json([{id: 1, name: "Alice"}])
-      else
-        new Response("Not Found", status: 404)
+# Routes — return data directly
+get '/' -> { message: 'Hello!' }
+get '/users/:id' -> User.find!(read 'id', 'id!')
+
+# Form validation with read()
+post '/signup' ->
+  email = read 'email', 'email!'           # required email
+  age   = read 'age', 'int', [18, 120]     # integer between 18-120
+  role  = read 'role', ['admin', 'user']   # enum
+  { success: true, email, age, role }
+
+# File serving
+get '/css/*' -> @send "public/#{@req.path.slice(5)}"
+notFound -> @send 'index.html', 'text/html; charset=UTF-8'
+
+# Middleware
+import { cors, logger, sessions } from '@rip-lang/api/middleware'
+
+use logger()
+use cors origin: '*'
+use sessions secret: process.env.SECRET
 
-console.log "Server running on http://localhost:3000"
+# Lifecycle hooks
+before -> @start = Date.now()
+after -> console.log "#{@req.method} #{@req.path} - #{Date.now() - @start}ms"
+
+start port: 3000
 ```
 
-## REST API
+### read() Validators
 
 ```coffee
-import { serve } from "bun"
+id    = read 'id', 'id!'        # positive integer (required)
+count = read 'count', 'whole'   # non-negative integer
+price = read 'price', 'money'   # cents (multiplies by 100)
+name  = read 'name', 'string'   # collapses whitespace
+email = read 'email', 'email'   # valid email format
+phone = read 'phone', 'phone'   # US phone → (555) 123-4567
+state = read 'state', 'state'   # two-letter → uppercase
+zip   = read 'zip', 'zip'       # 5-digit zip
+url   = read 'url', 'url'       # valid URL
+uuid  = read 'id', 'uuid'       # UUID format
+date  = read 'date', 'date'     # YYYY-MM-DD
+time  = read 'time', 'time'     # HH:MM or HH:MM:SS
+flag  = read 'flag', 'bool'     # boolean
+tags  = read 'tags', 'array'    # must be array
+ids   = read 'ids', 'ids'       # "1,2,3" → [1, 2, 3]
+slug  = read 'slug', 'slug'     # URL-safe slug
+```
+
+## @rip-lang/server — Production Server
+
+Multi-worker process manager with hot reload, automatic HTTPS, and mDNS.
 
-db = {
-  users: [
-    {id: 1, name: "Alice", email: "alice@example.com"}
-    {id: 2, name: "Bob", email: "bob@example.com"}
-  ]
-  nextId: 3
-}
+```bash
+rip-server                # Start (uses ./index.rip)
+rip-server -w             # With file watching + hot-reload
+rip-server myapp          # Named (accessible at myapp.local)
+rip-server http:3000      # HTTP on specific port
+```
 
-def parseBody(req)
-  try
-    req.json!
-  catch
-    null
+## @rip-lang/ui — Reactive Web Framework
 
-serve
-  port: 3000
-  fetch: (req) ->
-    {pathname} = new URL(req.url)
-    method = req.method
+Zero-build reactive framework. Ships the compiler to the browser and compiles `.rip` components on demand. File-based routing, unified reactive stash, and SSE hot reload.
+
+```coffee
+# Server setup (index.rip)
+import { get, use, start, notFound } from '@rip-lang/api'
+import { ripUI } from '@rip-lang/ui/serve'
+
+dir = import.meta.dir
+use ripUI dir: dir, components: 'routes', includes: ['ui'], watch: true
+get '/css/*' -> @send "#{dir}/css/#{@req.path.slice(5)}"
+notFound -> @send "#{dir}/index.html", 'text/html; charset=UTF-8'
+start port: 3000
+```
+
+```coffee
+# Component (routes/counter.rip)
+Counter = component
+  @count := 0
+  doubled ~= @count * 2
+
+  increment: -> @count += 1
+
+  render
+    div.counter
+      h1 "Count: #{@count}"
+      p "Doubled: #{doubled}"
+      button @click: @increment, "+"
+```
+
+## @rip-lang/db — DuckDB Server + Client
+
+HTTP server for DuckDB with the official DuckDB UI built in, plus an ActiveRecord-style client library.
+
+```bash
+rip-db                          # In-memory database
+rip-db mydata.duckdb            # File-based database
+```
 
-    switch "#{method} #{pathname}"
-      when "GET /api/users"
-        Response.json(db.users)
+```coffee
+# Client library
+import { connect, query, findAll, Model } from '@rip-lang/db/client'
 
-      when /^GET \/api\/users\/(\d+)$/
-        id = parseInt(_[1])
-        user = db.users.find (u) -> u.id is id
-        if user then Response.json(user)
-        else Response.json({error: "Not found"}, status: 404)
+connect 'http://localhost:4213'
 
-      when "POST /api/users"
-        body = parseBody!(req)
-        user = {id: db.nextId++, ...body}
-        db.users.push(user)
-        Response.json(user, status: 201)
+users = findAll! "SELECT * FROM users WHERE role = $1", ['admin']
 
-      else
-        Response.json({error: "Not found"}, status: 404)
+User = Model 'users'
+user = User.find! 42
+User.where(active: true).order('name').limit(10).all!
 ```
 
-## WebSocket Server
+## @rip-lang/swarm — Parallel Job Runner
 
 ```coffee
-import { serve } from "bun"
+import { swarm, init, retry, todo } from '@rip-lang/swarm'
 
-clients = new Set()
+setup = ->
+  unless retry()
+    init()
+    for i in [1..100] then todo(i)
 
-serve
-  port: 3000
-  fetch: (req, server) ->
-    if server.upgrade(req)
-      return
-    new Response("WebSocket server")
+perform = (task, ctx) ->
+  await Bun.sleep(Math.random() * 1000)
 
-  websocket:
-    open: (ws) ->
-      clients.add(ws)
-      console.log "Client connected (#{clients.size} total)"
+swarm { setup, perform }
+```
+
+## @rip-lang/csv — CSV Parser + Writer
 
-    message: (ws, message) ->
-      for client in clients
-        client.send(message) unless client is ws
+```coffee
+import { CSV } from '@rip-lang/csv'
 
-    close: (ws) ->
-      clients.delete(ws)
+# Parse
+rows = CSV.read "name,age\nAlice,30\nBob,25\n", headers: true
+# [{name: 'Alice', age: '30'}, {name: 'Bob', age: '25'}]
+
+# Write
+CSV.save! 'output.csv', rows
+```
+
+## @rip-lang/schema — ORM + Validation
+
+```coffee
+import { Model } from '@rip-lang/schema'
+
+class User extends Model
+  @table = 'users'
+  @schema
+    name:  { type: 'string', required: true }
+    email: { type: 'email', unique: true }
+
+user = User.find!(25)
+user.name = 'Alice'
+user.save!()
+```
+
+## Full-Stack Example
+
+A complete API server in Rip:
+
+```coffee
+import { get, post, use, read, start, notFound } from '@rip-lang/api'
+import { cors, logger } from '@rip-lang/api/middleware'
+
+use logger()
+use cors origin: '*'
+
+# In-memory store
+users = []
+nextId = 1
+
+get '/api/users' -> users
+
+get '/api/users/:id' ->
+  id = read 'id', 'id!'
+  user = users.find (u) -> u.id is id
+  user or throw { status: 404, message: 'Not found' }
+
+post '/api/users' ->
+  name = read 'name', 'string!'
+  email = read 'email', 'email!'
+  user = { id: nextId++, name, email }
+  users.push user
+  user
+
+notFound -> { error: 'Not found' }
+
+start port: 3000
 ```
 
 ---
@@ -1539,4 +1672,19 @@ Each would need design discussion before building.
 
 ---
 
-*Rip 3.9 — 1,241 tests passing — Zero dependencies — Self-hosting — ~11,000 LOC*
+## Resources
+
+- [Rip Playground](https://shreeve.github.io/rip-lang/) — Try Rip in the browser
+- [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=rip-lang.rip) — IDE support
+- [GitHub](https://github.com/shreeve/rip-lang) — Source code
+
+| Document | Purpose |
+|----------|---------|
+| **[RIP-LANG.md](RIP-LANG.md)** | Full language reference (this file) |
+| **[RIP-TYPES.md](RIP-TYPES.md)** | Type system specification |
+| **[RIP-INTERNALS.md](RIP-INTERNALS.md)** | Compiler architecture & design decisions |
+| **[AGENT.md](../AGENT.md)** | AI agent guide for working on the compiler |
+
+---
+
+*Rip 3.10 — 1,243 tests — Zero dependencies — Self-hosting — ~13,500 LOC*