spine-framework 0.4.4 → 0.5.0-rc.4

package/README.md

@@ -1,223 +1,182 @@
 # Spine Framework
 
-A complete enterprise application platform built on Supabase + Netlify + React for building scalable multi-tenant SaaS applications with an extensible app ecosystem.
+Spine Framework is a multi-tenant application platform that gives you the
+boring 80% of a SaaS product — auth and tenancy, RBAC, typed runtime records,
+pipelines/triggers/timers, integrations, a schema-driven admin UI, and
+observability — so you and your AI coding agent build only the 20% that makes
+your app unique. It is designed to be developed on with agentic IDEs: `init`
+writes an `AGENTS.md` rules file, a set of `.devin/skills/spine-*` procedures,
+and ships a complete instruction book that your agent reads while it works.
 
----
+The stack is deliberately conventional: React + Vite frontend, Netlify
+Functions as the API layer, Supabase (Postgres + Auth) as the database.
 
-## Quick Start
-
-### Prerequisites
-
-- Node.js 22+
-- A [Supabase](https://supabase.com) project
-- A [Netlify](https://netlify.com) account
-
-### Start with an app
-
-The fastest way to a running system is an app package that scaffolds the framework plus itself:
-
-```bash
-npm create @spine-framework/answer-once my-app
-```
-
-### Or scaffold the framework alone
+## Quick start
 
 ```bash
 mkdir my-app && cd my-app
-npm install spine-framework@latest
+npm install spine-framework
 npx spine-framework init
 ```
 
-This copies the framework files, writes `package.json` with an exact `spine-framework` pin, a verified `package-lock.json`, a neutral `spine.config.json`, `.env.example`, and a frozen `.spine-manifest.json` integrity manifest.
+Installing a local tarball or pre-release? `npm i ./spine-framework-<ver>.tgz`
+works too — `init` preserves the `file:` spec in `package.json` instead of
+stamping a registry version.
 
-### 2. Configure your environment
+`init` copies the framework file set (`.framework/`, `config/`, `scripts/`,
+`bin/`), writes `package.json` / `netlify.toml` / `spine.config.json` /
+`.env.example`, creates an empty `custom/` workspace for your code, and
+freezes a `.spine-manifest.json` integrity manifest. It does **not** run
+`npm install`, write `.env`, or touch your database.
 
-Edit `.env` with your Supabase credentials:
+### 1. Configure `.env`
 
-```env
-SUPABASE_URL=https://your-project.supabase.co
-SUPABASE_ANON_KEY=your-anon-key
-SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
-SUPABASE_DB_PASSWORD=your-database-password
+```bash
+cp .env.example .env
 ```
 
-Get these from your [Supabase dashboard](https://supabase.com/dashboard/project/_/settings/api).  
-`SUPABASE_DB_PASSWORD` is under **Settings → Database**.
+Required for a working install (full list:
+[`.framework/src/instructions/reference/env-vars.md`](.framework/src/instructions/reference/env-vars.md)):
 
-### 3. Apply database migrations
+| Variable | Used by |
+|---|---|
+| `VITE_SUPABASE_URL`, `VITE_SUPABASE_ANON_KEY` | the browser app |
+| `SUPABASE_URL`, `SUPABASE_ANON_KEY`, `SUPABASE_SERVICE_ROLE_KEY` | Netlify functions + CLI |
+| `SUPABASE_DB_PASSWORD` | `npx spine-framework migrate` (direct Postgres) |
+| `APP_BASE_URL` | invite links and auth redirects (`http://localhost:8888` in dev) |
 
-```bash
-npx spine-framework migrate
-```
+The Supabase URL and both keys are under **Project Settings → API Keys**
+(dashboard "Publishable key" = anon, "Secret key" = service-role);
+`SUPABASE_DB_PASSWORD` is under **Project Settings → Database**.
 
-This creates all tables, RLS policies, functions, and seeds system data. Safe to re-run on an existing project — migrations are idempotent.
+Worth setting early: `INTERNAL_INVOKE_SECRET` — required for
+trigger-dispatched pipelines (`openssl rand -hex 32`).
 
-### 4. Start the development server
+### 2. Install, verify, migrate
 
 ```bash
-npm install && npm run assemble && netlify dev
+npm install
+npm run verify                  # integrity-checks the tree against .spine-manifest.json
+npx spine-framework migrate     # creates tables, RLS, seeds system data (idempotent)
 ```
 
-Your app is now running at `http://localhost:8888`.
-
----
-
-## CLI Reference
-
-All commands run via `npx spine-framework <command>`.
-
-| Command | Description |
-|---------|-------------|
-| `init` | Scaffold a new project in the current directory |
-| `migrate` | Apply framework SQL migrations to your Supabase project |
-| `migrate --dry-run` | Preview pending migrations without applying |
-| `migrate --db-password <pw>` | Pass DB password directly instead of reading from `.env` |
-| `status` | Show installed apps and framework version |
-| `upgrade` | Sync framework-owned files to the installed `spine-framework` version |
-
----
-
-## Upgrading
-
-`.framework/`, `config/`, `scripts/` and `bin/` are a managed copy of the
-`spine-framework` package — don't edit them (the frozen `.spine-manifest.json`
-integrity check will fail). To move to a newer release:
+### 3. Run it
 
 ```bash
-npm install spine-framework@latest
-npx spine-framework upgrade --dry-run   # review what would change
-npx spine-framework upgrade
-npm install
-npm run verify
-npx spine-framework migrate             # apply any new migrations
+npm run dev:netlify             # Netlify dev server on http://localhost:8888 (functions + UI)
 ```
 
-Upgrade refuses to overwrite locally modified framework files (rerun with
-`--force` to accept the overwrite), preserves your `custom/` code and app-owned
-`netlify.toml` sections, and lists new migrations before you apply them.
-App packages upgrade themselves the same way — see the app's own docs.
+`npm run dev` starts only the Vite dev server on port 3001 — fine for
+frontend work, but `/api/*` calls still proxy to 8888, so functions need
+`netlify dev` running.
 
----
+### 4. First login
 
-## Project Structure
+Browser path: open `http://localhost:8888`, go to `/register`, and create an
+account — **the first registrant becomes `system_admin`** via a database
+trigger, and lands on `/spine-framework/admin`, the schema-driven admin app.
+Later signups get no account or role until an invite or an admin places
+them. Requires **Supabase email confirmation OFF** (Auth → Providers) or a
+real inbox for the confirm link.
 
-After `init`, your project looks like this:
-
-```
-my-app/
-├── .env                        # Your credentials (never commit this)
-├── .framework/                 # Framework core (do not edit)
-│   ├── cli/                    # CLI commands
-│   ├── functions/              # Serverless API functions
-│   ├── migrations/             # SQL migrations
-│   ├── src/                    # React frontend core
-│   └── scripts/                # Build scripts
-├── custom/                     # Your custom apps and extensions
-│   └── apps/                   # App packages go here
-├── config/                     # Vite, TypeScript, Tailwind config
-├── scripts/                    # Project-level build scripts
-├── netlify.toml                # Netlify configuration
-└── package.json
-```
+Headless path (scriptable): `npx spine-framework bootstrap --email
+you@example.com --password '<pick-one>'` creates the first `system_admin`,
+a confirmed auth user, and a `sk_` API key — no browser or email
+confirmation needed. See
+[`guide/01-install-and-first-run.md`](.framework/src/instructions/guide/01-install-and-first-run.md).
 
----
+## Where's the documentation
 
-## Architecture
+The package ships a complete instruction book at
+[`.framework/src/instructions/README.md`](.framework/src/instructions/README.md):
 
-- **Multi-tenant**: Account hierarchy with inherited access and RLS-enforced isolation
-- **Role-based access control**: Fine-grained permissions via database-enforced policies
-- **App ecosystem**: Install, manage, and build custom applications on the framework
-- **Serverless API**: Netlify Functions handle all backend logic
-- **Real-time**: Supabase Realtime for live updates
-- **AI integration**: Native support for AI agents and pipeline automation
+- **`guide/`** — install, project map, domain model, build your first app.
+- **`concepts/`** — tenancy, permissions, design schema, automation,
+  observability.
+- **`tasks/`** — single-goal procedures (add a type, a pipeline, a trigger,
+  an AI agent; package and install an app; write a function or migration).
+- **`reference/`** — env vars, CLI, API endpoints, design-schema spec.
+- **`operations/`** — deployment, migrations, security checklist,
+  troubleshooting playbook.
+- **Root entity files** — one per entity (`types`, `apps`, `roles`,
+  `pipelines`, `triggers`, `ai-agents`, …), all in the same 7-section format.
 
-### Database Schema
+The same files render inside the admin UI: every admin page has an
+**Instructions** button that opens the relevant doc as a sheet.
 
-| Table group | Tables |
-|-------------|--------|
-| Identity | `accounts`, `people`, `roles` |
-| Runtime | `items`, `threads`, `messages`, `links`, `attachments`, `watchers` |
-| Apps | `apps`, `types`, `pipelines`, `triggers` |
-| AI | `ai_agents`, `embeddings`, `prompt_configs` |
-| System | `api_keys`, `logs`, `integrations`, `timers` |
+## For AI agents
 
----
+After `init`, your repo contains everything an agent needs:
 
-## Building Custom Apps
+- **`AGENTS.md`** — the standing rules for working in a Spine project.
+- **`.devin/skills/spine-*`** — 13 procedures (`spine-new-type`,
+  `spine-new-app`, `spine-add-automation`, `spine-troubleshoot`, …).
+- **`.framework/src/instructions/`** — the instruction book above.
 
-Create your own applications and place them in `custom/apps/`:
+Useful CLI for agents:
 
-```tsx
-// custom/apps/my-app/index.tsx
-export default function MyApp() {
-  return <div>Hello from My App</div>
-}
+```bash
+npx spine-framework validate-schema <file.json>   # check a design_schema file
+npx spine-framework validate-app custom/apps/<slug>   # check an app package
 ```
 
-Add custom database migrations in `custom/migrations/`:
-
-```sql
--- custom/migrations/001_my_app.sql
-CREATE TABLE IF NOT EXISTS my_app_records (
-  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
-  account_id uuid NOT NULL REFERENCES public.accounts(id),
-  title text NOT NULL,
-  created_at timestamptz DEFAULT now()
-);
+Point your agent at `guide/03-domain-model.md` and `concepts/` first — it
+explains the primitives and how they compose.
 
-ALTER TABLE my_app_records ENABLE ROW LEVEL SECURITY;
-```
+## CLI quick reference
 
-Custom migrations are picked up automatically by `npx spine-framework migrate`.
+All commands run as `npx spine-framework <command>`. Full reference:
+[`.framework/src/instructions/reference/cli.md`](.framework/src/instructions/reference/cli.md).
 
----
+| Command | What it does |
+|---|---|
+| `init [dir]` | Scaffold a project (refuses to run over an existing `.framework/`) |
+| `migrate` | Apply pending SQL migrations; `--dry-run`, `--framework-only` |
+| `status` | Show installed apps and framework version |
+| `install-app <pkg>` | Install an app package into `custom/apps/` + register/seed it |
+| `validate-schema <file>` | Validate a `design_schema` JSON file |
+| `validate-app [path]` | Validate an app package's structure and manifest |
+| `doctor` | Check installation health (env, files, DB reachability) |
+| `bootstrap` | Create the first `system_admin` + confirmed auth user + `sk_` key, no browser |
+| `upgrade` | Sync framework files to the installed package version; `--dry-run`, `--force` |
 
-## Environment Variables
+## Requirements
 
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `SUPABASE_URL` | Yes | Your Supabase project URL |
-| `SUPABASE_ANON_KEY` | Yes | Supabase anon/public key |
-| `SUPABASE_SERVICE_ROLE_KEY` | Yes | Supabase service role key (server-side only) |
-| `SUPABASE_DB_PASSWORD` | Yes (migrate) | Postgres database password |
+- Node.js ≥ 22.13, npm ≥ 10
+- A [Supabase](https://supabase.com) project (URL + anon/service keys + DB password)
+- Netlify CLI for local dev — pinned as a devDependency, so `npm install`
+  provides it. A Netlify account/site is only needed to deploy to production.
 
----
+## Upgrading
 
-## Deployment
+`.framework/`, `config/`, `scripts/`, and `bin/` are a managed copy — do not
+edit them (`.spine-manifest.json` will flag it). To move to a newer release:
 
 ```bash
-# Build and deploy to Netlify
-npm run assemble
-netlify deploy --prod
+npm install spine-framework@latest
+npx spine-framework upgrade --dry-run   # review what would change
+npx spine-framework upgrade
+npx spine-framework migrate             # apply any new migrations
 ```
 
----
-
-## Contributing
-
-```bash
-git clone https://github.com/spine-framework/spine-framework.git
-cd spine-framework
-npm install
-npm run dev
-```
+Your code in `custom/` is never touched.
 
-See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for internals and [docs/APPS.md](docs/APPS.md) for the app development guide.
+## Known issues
 
----
+- **`npx spine-framework generate` was removed** — it wrote stubs to a dead
+  `v2-custom/` tree and emitted a legacy `design_schema` shape. It now prints
+  migration guidance and exits 1: use `npx spine-framework create-app` for
+  apps, and author types in the admin UI or via `POST /api/types` (check the
+  schema with `npx spine-framework validate-schema`). See "Removed commands"
+  in [`reference/cli.md`](.framework/src/instructions/reference/cli.md).
+- `npx spine-framework dev` runs the real dev flow: `scripts/assemble.sh`,
+  integrity check, then Vite (`--netlify` for the full `netlify dev` stack on
+  :8888). `npm run dev` / `npm run dev:netlify` remain equivalent.
+- There is no MCP server — agent integration is via `AGENTS.md`, skills, and
+  the instruction book.
 
 ## License
 
-Licensed under the [Spine Framework Internal Use License](LICENSE.md).
-
-- Free for internal business use
-- Commercial redistribution requires a separate license
-- Contact [spine-framework.com](https://spine-framework.com) for commercial licensing
-
----
-
-## Support
-
-- Documentation: [docs.spine-framework.com](https://docs.spine-framework.com)
-- Issues: [GitHub Issues](https://github.com/spine-framework/spine-framework/issues)
-- Commercial: [spine-framework.com](https://spine-framework.com)
+Licensed under the [Spine Framework Internal Use License](LICENSE.md) — free
+for internal business use; commercial redistribution requires a separate
+license.

package/config/tsconfig.cli.json

@@ -8,8 +8,8 @@
     "noEmit": true
   },
   "include": [
-    "cli/**/*",
-    "functions/_shared/**/*"
+    "../.framework/cli/**/*",
+    "../.framework/functions/_shared/**/*"
   ],
   "exclude": [
     "node_modules",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.4.4",
+  "version": "0.5.0-rc.4",
   "description": "Multi-tenant, modular application platform for modern SaaS systems",
   "type": "module",
   "bin": {
@@ -20,19 +20,31 @@
     "scripts/verify-manifest.mts",
     "scripts/boundary-check.sh",
     "scripts/verify-install.ts",
+    "templates/project/",
     "config/",
     "!config/*.tsbuildinfo",
     "!config/deno.lock",
     "!config/package-lock.json",
-    "templates/project/",
     "vitest.config.ts",
     "netlify.toml",
     ".env.example",
     ".framework/",
+    "!.framework/mcp/",
     "!.framework/migrations/archive/",
     "!.framework/functions/_quarantine/",
     "!.framework/tests/integration/",
     "!.framework/public/spine.config.json",
+    "!.framework/docs/admin-routes.md",
+    "!.framework/docs/api-docs-progress.md",
+    "!.framework/docs/api-governance.md",
+    "!.framework/docs/api-testing-results.md",
+    "!.framework/docs/assembly-launch-guide.md",
+    "!.framework/docs/audit-results.md",
+    "!.framework/docs/db-api-inventory.md",
+    "!.framework/docs/gap-remediation-backlog.md",
+    "!.framework/docs/ui-adoption-verification.md",
+    "!.framework/docs/ui-api-coverage.md",
+    "!.framework/docs/v2-compatibility-audit.md",
     "!**/*.tsbuildinfo",
     "!**/.DS_Store",
     "!**/.env",
@@ -85,8 +97,7 @@
     "test:integration": "vitest run .framework/tests/integration",
     "test:boundary": "bash scripts/boundary-check.sh",
     "docs": "typedoc --entryPoints .framework/functions/_shared/index.ts --out docs/generated",
-    "mcp": "tsx --env-file=.env .framework/mcp/index.ts",
-    "mcp:spine-framework": "tsx --env-file=.env .framework/mcp/index.ts",
+    "docs:lint": "tsx scripts/docs-lint.mts",
     "prepack": "node custom/npm/scripts/prepack-framework.mjs stage",
     "postpack": "node custom/npm/scripts/prepack-framework.mjs clean",
     "cil:migrate-markers": "tsx .framework/scripts/cil-migrate-markers.ts",

package/templates/project/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "spine-framework",
-  "version": "0.4.4",
+  "version": "0.5.0-rc.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "spine-framework",
-      "version": "0.4.4",
+      "version": "0.5.0-rc.4",
       "license": "SEE LICENSE IN LICENSE.md",
       "dependencies": {
         "@base-ui/react": "^1.4.1",

package/.framework/docs/admin-routes.md

@@ -1,76 +0,0 @@
-# Admin Route Inventory (v2-core)
-
-## Data Management Routes (admin/data/*)
-
-| Route | Purpose | Page Component | Entity | Notes |
-|-------|---------|----------------|--------|-------|
-| `/admin/data/accounts` | List accounts | AccountsPage | Account records | Runtime account management |
-| `/admin/data/accounts/new` | Create account | AccountCreatePage | Account records | |
-| `/admin/data/accounts/:id` | Account detail/edit | AccountDetailPage | Account records | |
-| `/admin/data/people` | List people | PeoplePage | Person records | |
-| `/admin/data/people/new` | Create person | PersonCreatePage | Person records | |
-| `/admin/data/people/:id` | Person detail/edit | PersonDetailPage | Person records | |
-| `/admin/data/items` | List items | ItemsPage | Item records | |
-| `/admin/data/items/new` | Create item | ItemCreatePage | Item records | |
-| `/admin/data/items/:id` | Item detail/edit | ItemDetailPage | Item records | |
-
-## Configuration Management Routes (admin/configs/*)
-
-| Route | Purpose | Page Component | Entity | Notes |
-|-------|---------|----------------|--------|-------|
-| `/admin/configs/types` | List item types | TypesPage | Type definitions | kind='item' |
-| `/admin/configs/types/new` | Create item type | TypeDetailPage | Type definitions | |
-| `/admin/configs/types/:id` | Item type detail/edit | TypeDetailPage | Type definitions | |
-| `/admin/configs/accounts` | List account types | AccountTypesPage | Type definitions | kind='account' |
-| `/admin/configs/accounts/new` | Create account type | AccountTypeDetailPage | Type definitions | |
-| `/admin/configs/accounts/:id` | Account type detail/edit | AccountTypeDetailPage | Type definitions | |
-| `/admin/configs/people` | List person types | PersonTypesPage | Type definitions | kind='person' |
-| `/admin/configs/people/new` | Create person type | PersonTypeDetailPage | Type definitions | |
-| `/admin/configs/people/:id` | Person type detail/edit | PersonTypeDetailPage | Type definitions | |
-| `/admin/configs/apps` | List apps | AppsPage | App definitions | |
-| `/admin/configs/apps/new` | Create app | AppDetailPage | App definitions | |
-| `/admin/configs/apps/:id` | App detail/edit | AppDetailPage | App definitions | |
-| `/admin/configs/pipelines` | List pipelines | PipelinesPage | Pipeline definitions | |
-| `/admin/configs/pipelines/new` | Create pipeline | PipelineDetailPage | Pipeline definitions | |
-| `/admin/configs/pipelines/:id` | Pipeline detail/edit | PipelineDetailPage | Pipeline definitions | |
-| `/admin/configs/triggers` | List triggers | TriggersPage | Trigger definitions | |
-| `/admin/configs/triggers/new` | Create trigger | TriggerDetailPage | Trigger definitions | |
-| `/admin/configs/triggers/:id` | Trigger detail/edit | TriggerDetailPage | Trigger definitions | |
-| `/admin/configs/ai-agents` | List AI agents | AIAgentsPage | AI agent definitions | |
-| `/admin/configs/ai-agents/new` | Create AI agent | AIAgentDetailPage | AI agent definitions | |
-| `/admin/configs/ai-agents/:id` | AI agent detail/edit | AIAgentDetailPage | AI agent definitions | |
-| `/admin/configs/embeddings` | List embeddings | EmbeddingsPage | Embedding definitions | |
-| `/admin/configs/embeddings/new` | Create embedding | EmbeddingDetailPage | Embedding definitions | |
-| `/admin/configs/embeddings/:id` | Embedding detail/edit | EmbeddingDetailPage | Embedding definitions | |
-| `/admin/configs/timers` | List timers | TimersPage | Timer definitions | |
-| `/admin/configs/timers/new` | Create timer | TimerDetailPage | Timer definitions | |
-| `/admin/configs/timers/:id` | Timer detail/edit | TimerDetailPage | Timer definitions | |
-| `/admin/configs/integrations` | List integrations | IntegrationsPage | Integration definitions | |
-| `/admin/configs/integrations/new` | Create integration | IntegrationDetailPage | Integration definitions | |
-| `/admin/configs/integrations/:id` | Integration detail/edit | IntegrationDetailPage | Integration definitions | |
-
-## Legacy Routes (Deprecated)
-
-| Route | Purpose | Page Component | Entity | Notes |
-|-------|---------|----------------|--------|-------|
-| `/admin/accounts` | Accounts (legacy) | AccountsPage | Account records | Use /admin/data/accounts |
-| `/admin/accounts/:id` | Account detail (legacy) | AccountDetailPage | Account records | Use /admin/data/accounts/:id |
-| `/admin/people` | People (legacy) | PeoplePage | Person records | Use /admin/data/people |
-| `/admin/people/:id` | Person detail (legacy) | PersonDetailPage | Person records | Use /admin/data/people/:id |
-| `/admin/types` | Types (legacy) | TypesPage | Type definitions | Use /admin/configs/types |
-| `/admin/types/:id` | Type detail (legacy) | TypeDetailPage | Type definitions | Use /admin/configs/types/:id |
-| `/admin/apps` | Apps (legacy) | AppsPage | App definitions | Use /admin/configs/apps |
-| `/admin/pipelines` | Pipelines (legacy) | PipelinesPage | Pipeline definitions | Use /admin/configs/pipelines |
-| `/admin/triggers` | Triggers (legacy) | TriggersPage | Trigger definitions | Use /admin/configs/triggers |
-| `/admin/ai-agents` | AI agents (legacy) | AIAgentsPage | AI agent definitions | Use /admin/configs/ai-agents |
-| `/admin/embeddings` | Embeddings (legacy) | EmbeddingsPage | Embedding definitions | Use /admin/configs/embeddings |
-| `/admin/timers` | Timers (legacy) | TimersPage | Timer definitions | Use /admin/configs/timers |
-
-## Summary
-
-- **Total routes**: 43 active routes (25 data/config + 10 legacy)
-- **Data routes**: 9 (accounts, people, items)
-- **Config routes**: 34 (types, apps, pipelines, triggers, ai-agents, embeddings, timers, integrations)
-- **Legacy routes**: 10 (deprecated but still active)
-
-All routes are defined in `v2-core/src/App.tsx` and use lazy-loaded components from `v2-core/src/pages/`.

package/.framework/docs/api-docs-progress.md

@@ -1,38 +0,0 @@
-# API Documentation Progress
-
-## Completed Inline Documentation
-
-### accounts.ts
-- Added comprehensive header documentation
-- Documented all CRUD operations
-- Fixed lint warnings (unused imports/parameters)
-- Status: COMPLETE
-
-### Next Files to Document
-1. people.ts
-2. items.ts
-3. types.ts
-4. apps.ts
-5. pipelines.ts
-6. triggers.ts
-7. ai-agents.ts
-8. embeddings.ts
-9. timers.ts
-10. integrations.ts
-11. All remaining runtime endpoints
-
-## Documentation Template Applied
-
-Each endpoint file now includes:
-- Domain classification (admin-data/admin-configs/runtime/internal)
-- Auth requirements
-- Account scoping rules
-- v2 schema dependencies
-- Soft delete behavior
-- Audit logging requirements
-- Request/response contracts
-- Error handling
-
-## Progress: 1/18 endpoints documented
-
-Continuing with remaining endpoints...