divhunt 2.0.0 → 2.0.1

package/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git diff --staged)",
+      "Bash(git status)",
+      "Bash(git push git@github-iamdejan:tomic-d/framework.git main)",
+      "Bash(node:*)"
+    ]
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,132 @@
+# CLAUDE.md — Divhunt Framework
+
+## PURPOSE
+
+AI project guardian. Maintains full context, protects scope, tracks every decision, and keeps all project files synchronized. This file is the operating system of this project.
+
+---
+
+## STATUS
+
+Phase: 3 — Maintenance
+Focus: Stability, bugfixes, optimization
+Blocker: None
+Last session: 2026-02-19 — Added DivhuntError (divhunt.Error(code, message, context)), emit on error, removed copyright headers
+
+---
+
+## PHASES
+
+### Phase 1: V2 Build (completed)
+- Core rebuilt from scratch — Proxy reactivity, mixin composition, addon abstraction
+- PostgreSQL ORM, HTTP/gRPC servers, command system, render engine
+- 40+ UI components, SPA router, directive system, asset bundler
+- **Gate:** Framework powers a real application end-to-end.
+
+### Phase 2: Open Source Launch (completed)
+- Published on npm as `divhunt`
+- MIT license
+- Full documentation (6 docs covering all subsystems)
+- Working example (basic-api)
+- Public GitHub repo
+- **Gate:** Published, documented, usable by external developers.
+
+### Phase 3: Maintenance (current)
+- Bugfixes, stability improvements, performance optimization
+- No new major features without explicit approval
+- Documentation kept up to date
+- **Gate:** Stable, battle-tested, zero critical bugs.
+
+### Phase 4: Growth
+- Community adoption, contributions
+- New addons, integrations
+- Plugin system, ecosystem
+
+---
+
+## MODES
+
+### Work Mode (default)
+Normal development. Follow tasks, fix bugs, optimize code.
+
+### Vision Mode
+**Trigger:** "let's talk about the vision", "let's change the vision", "let's discuss strategy", "let's talk about the framework direction"
+
+Behavior:
+1. Read brief.md and current STATUS
+2. Discuss with user — ask questions, challenge assumptions, propose alternatives
+3. After alignment, update ALL affected files:
+   - brief.md — product definition changes
+   - architecture.md — if technical direction changes
+   - decisions.md — log what changed and why
+   - tasks.md — add/remove/reprioritize
+   - progress.md — adjust milestones if needed
+4. Update STATUS in CLAUDE.md
+5. Print a summary of all changes made
+
+### Review Mode
+**Trigger:** "where are we?", "status?", "overview", "what's done?"
+
+Behavior:
+1. Read all files
+2. Give a concise report: phase, focus, blockers, recent progress, next steps
+
+### Decision Mode
+**Trigger:** "I need to decide", "what do you think I should choose", "I have a dilemma"
+
+Behavior:
+1. Listen to the options
+2. Analyze pros and cons of each
+3. Give a recommendation with reasoning
+4. After the decision — log in decisions.md with full context
+
+---
+
+## RULES
+
+### Scope Protection
+- Phase 3 = maintenance. No new features without explicit approval.
+- If user proposes a new feature → "Is this maintenance or Phase 4? Logging in tasks.md as future."
+- Bugfix and optimization PRs are always welcome
+- Breaking changes require a decision logged in decisions.md
+
+### Decision Tracking
+- Every non-trivial decision MUST be logged in decisions.md BEFORE implementation
+- Format: decision + reason + rejected alternatives + context
+
+### Session Management
+- Start of session: read STATUS and tasks.md to know where you are
+- End of session: update STATUS (phase, focus, blocker, last session summary)
+- If session was a vision/strategy discussion — update all affected files
+
+### Auto-Update Rules
+- **brief.md** — Changes ONLY in Vision Mode with explicit approval.
+- **architecture.md** — Updated when code or technical direction changes.
+- **decisions.md** — Every decision, immediately, no exceptions.
+- **tasks.md** — Updated when a task is completed, added, or reprioritized.
+- **progress.md** — Updated when a milestone is reached.
+
+### Git
+- Never add Co-Authored-By or any co-author lines to commit messages
+- All commits are authored solely by Dejan Tomic
+- Use SSH remote: git@github-iamdejan:tomic-d/framework.git
+- Commit style: short, lowercase, imperative, no period
+
+### Communication
+- Serbian or English, match the user
+- Direct, no fluff
+- When user is wrong — say it
+- When user is right — confirm it
+- Code style: follow existing conventions with maximum precision
+
+---
+
+## FILES
+
+| File | Purpose | When it changes |
+|---|---|---|
+| brief.md | What, for whom, why, vision, competition | Vision Mode, with approval |
+| architecture.md | Living technical overview of the system | When code/tech stack changes |
+| decisions.md | Decision + why + rejected alternatives | Every decision, immediately |
+| tasks.md | Active tasks, granular | When task is added/completed/changed |
+| progress.md | Milestones, what's done | When a milestone is reached |

package/addons/core/clients/back/grpc/addon.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 
 const clientsGRPC = divhunt.Addon('clients.grpc', (addon) =>

package/addons/core/clients/back/grpc/item/catch/add.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clientsGRPC from '#clients/grpc/addon.js';
 
 clientsGRPC.ItemOn('add', function(item)

package/addons/core/clients/back/grpc/item/functions/connect.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
 

package/addons/core/clients/back/grpc/item/functions/resolve.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clientsGRPC from '#clients/grpc/addon.js';
 
 const promises = {};

package/addons/core/clients/back/grpc/item/functions/stream.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clientsGRPC from '#clients/grpc/addon.js';
 import divhunt from '#framework/load.js';
 

package/addons/core/clients/back/grpc/load.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clientsGRPC from '#clients/grpc/addon.js';
 
 import '#clients/grpc/item/catch/add.js';

package/addons/core/clients/back/http/addon.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 
 const clients = divhunt.Addon('clients', (addon) =>

package/addons/core/clients/back/http/item/catch/add.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.ItemOn('add', function(item)

package/addons/core/clients/back/http/item/functions/gRPC/create.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import * as grpc from '@grpc/grpc-js'
 import * as protoLoader from '@grpc/proto-loader'
 import { fileURLToPath } from 'url'

package/addons/core/clients/back/http/item/functions/gRPC/execute.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.Fn('item.grpc.execute', function(item, name, data = {}, requestTimeout)

package/addons/core/clients/back/http/item/functions/http/create.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 import clients from '#clients/addon.js';
 

package/addons/core/clients/back/http/item/functions/http/delete.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.Fn('item.http.delete', function(item, path, data = {}, requestTimeout)

package/addons/core/clients/back/http/item/functions/http/get.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.Fn('item.http.get', function(item, path, data = {}, requestTimeout)

package/addons/core/clients/back/http/item/functions/http/post.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.Fn('item.http.post', function(item, path, data = {}, requestTimeout)

package/addons/core/clients/back/http/item/functions/http/put.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.Fn('item.http.put', function(item, path, data = {}, requestTimeout)

package/addons/core/clients/back/http/item/functions/http/request.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 clients.Fn('item.http.request', function(item, path, method = 'GET', data = {}, requestTimeout)

package/addons/core/clients/back/http/load.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import clients from '#clients/addon.js';
 
 import '#clients/item/catch/add.js';

package/addons/core/commands/back/addon.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 
 const commands = divhunt.Addon('commands', (addon) =>

package/addons/core/commands/back/functions/find.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import commands from '../addon.js';
 
 commands.Fn('find', function(method, pathname)

package/addons/core/commands/back/functions/grpc/server.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import commands from '../../addon.js';
 
 commands.Fn('grpc.server', async function(port = 50000, callbacks = {})

package/addons/core/commands/back/functions/http/server.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 import commands from '../../addon.js';
 

package/addons/core/commands/back/item/functions/run.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 import commands from '../../addon.js';
 

package/addons/core/commands/back/items/many.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 import commands from '../addon.js';
 

package/addons/core/commands/back/items/one.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 import commands from '../addon.js';
 

package/addons/core/commands/back/items/run.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import commands from '../addon.js';
 
 commands.Item({
@@ -45,7 +43,7 @@ commands.Item({
         }
         catch(error)
         {
-            resolve(null, error.message, 500);
+            resolve(null, error.message, typeof error.code === 'number' ? error.code : 500);
         }
     }
 });

package/addons/core/commands/back/load.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import commands from './addon.js';
 
 import './functions/find.js';

package/addons/core/commands/front/#register/addon.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 const commands = divhunt.Addon('commands', (addon) =>
 {
     addon.Field('id', ['string']);

package/addons/core/commands/front/functions/find.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 commands.Fn('find', function(method, pathname)
 {
     const items = Object.values(this.Items());

package/addons/core/commands/front/item/functions/run.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 commands.Fn('item.run', function(item, properties = {}, context = {})
 {
     this.methods.resolve = null;

package/addons/core/servers/back/grpc/addon.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 
 const serversGRPC = divhunt.Addon('servers.grpc', (addon) =>

package/addons/core/servers/back/grpc/item/functions/resolve.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import serversGRPC from '#servers/grpc/addon.js';
 
 const promises = {};

package/addons/core/servers/back/grpc/item/functions/start.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
 

package/addons/core/servers/back/grpc/item/functions/stream.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 import serversGRPC from '#servers/grpc/addon.js';
 

package/addons/core/servers/back/http/item/functions/start.js

@@ -70,14 +70,16 @@ serversHTTP.Fn('item.start', function(item)
 
         if(http.error)
         {
-            response.writeHead(500, { 'Content-Type': 'application/json' });
+            const code = http.errorCode || 500;
+
+            response.writeHead(code, { 'Content-Type': 'application/json' });
             response.end(JSON.stringify({
-                data: {},
+                data: http.errorContext || {},
                 message: http.error,
-                code: 500,
+                code: code,
                 time: http.time
             }));
-            
+
             return;
         }
 
@@ -111,7 +113,11 @@ serversHTTP.Fn('item.start', function(item)
             }
             catch(error)
             {
+                const code = typeof error.code === 'number' ? error.code : 500;
+
                 http.error = error.message || 'Internal server error';
+                http.errorCode = code;
+                http.errorContext = error.context || {};
 
                 item.Get('onError') && item.Get('onError')(http.error);
 

package/addons/render/assets/back/addon.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from '#framework/load.js';
 
 const assets = divhunt.Addon('assets', (addon) =>

package/addons/render/assets/back/functions/css.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from '../addon.js';
 
 assets.Fn('css', function()

package/addons/render/assets/back/functions/js.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from '../addon.js';
 
 assets.Fn('js', function(context = {})

package/addons/render/assets/back/functions/scan/directories.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from '../../addon.js';
 import fs from 'fs';
 import path from 'path';

package/addons/render/assets/back/functions/scan/files.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from '../../addon.js';
 import fs from 'fs';
 import path from 'path';

package/addons/render/assets/back/functions/utils/read.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from '../../addon.js';
 import fs from 'fs';
 

package/addons/render/assets/back/functions/utils/transform.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from '../../addon.js';
 
 assets.Fn('utils.transform', function(contents, type = 'js')

package/addons/render/assets/back/items/commands/css.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from "#framework/load.js";
 import assets from "#assets/load.js";
 

package/addons/render/assets/back/items/commands/js.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from "#framework/load.js";
 import assets from "#assets/addon.js";
 

package/addons/render/assets/back/items/html/css.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from "#framework/load.js";
 
 divhunt.AddonReady('html', (html) => 

package/addons/render/assets/back/items/html/js.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import divhunt from "#framework/load.js";
 
 divhunt.AddonReady('html', (html) => 

package/addons/render/assets/back/load.js

@@ -1,5 +1,3 @@
-// © 2025 Divhunt GmbH — Licensed under the Divhunt Framework License. See LICENSE for terms.
-
 import assets from './addon.js';
 
 /* Functions */

package/architecture.md

@@ -0,0 +1,138 @@
+# ARCHITECTURE — Divhunt Framework
+
+*Living technical overview. Updated alongside the code.*
+
+---
+
+## Status: Stable — V2 complete, in maintenance
+
+## Stack
+
+- **Language:** JavaScript (ES Modules, `"type": "module"`)
+- **Runtime:** Node.js >= 18 (backend), Browser (frontend bundle)
+- **Database:** PostgreSQL via Knex
+- **Transport:** HTTP + gRPC
+- **Bundling:** Convention-based (terser for minification)
+- **SSR:** linkedom for server-side DOM
+- **No TypeScript, no test framework, no linter, no build step**
+
+## Project Structure
+
+```
+lib/                         Core Divhunt class + 17 mixins
+  load.js                    Node.js entry point (creates instance, handles signals)
+  browser.js                 Browser entry point (attaches to window, mounts body)
+  src/
+    divhunt.js               Main class (mixin-composed)
+    mixins/                  addons, emitter, middleware, data, dom, route,
+                             function, generate, binaries, helper, validate,
+                             string, request, logger, dependencies, overrides, error
+    classes/
+      addon/                 DivhuntAddon + mixins (fields, items, functions, find, render, store)
+        classes/
+          item/              DivhuntAddonItem + mixins (get, set, crud, functions, store)
+          render/            DivhuntAddonRender + mixins (compile, dom, process, events)
+      error/                 DivhuntError class (extends Error — code, message, context)
+
+addons/                      Built-in addon library
+  core/
+    database/                PostgreSQL ORM (Knex, fluent query builder, 17+ operators)
+    servers/                 HTTP + gRPC servers
+    clients/                 HTTP + gRPC clients
+    commands/                Typed API command system
+    queue/                   Concurrency task queue
+  render/
+    directives/              dh-if, dh-for, dh-click, dh-fetch, dh-show, dh-html, dh-text
+    pages/                   SPA page router with CSS Grid layouts + async data loading
+    elements/                40+ pre-built UI components
+    assets/                  Convention-based asset bundler (terser)
+    html/                    HTML document builder
+    tags/                    HTML tag system
+    transforms/              Data transforms
+  modules/
+    variables/               Named variable registry
+    actions/                 Action triggers
+    events/                  Event bindings
+    schedules/               Cron-like scheduling
+    shortcuts/               Keyboard shortcut bindings
+    sources/                 Data source registry
+  float/
+    modals/                  Modal dialogs
+    toasts/                  Toast notifications
+    tooltips/                Tooltip system
+    popups/                  Popup menus
+    overlays/                Overlay backdrops
+
+docs/                        Full documentation (6 files)
+examples/basic-api/          Minimal working example
+```
+
+## Key Classes
+
+| Class | Mixins | Purpose |
+|---|---|---|
+| Divhunt | 17 | Core engine — addon registry, emitter, middleware, routing, DOM, error |
+| DivhuntAddon | 9 | Addon abstraction — fields, items, functions, find, render, store |
+| DivhuntAddonItem | 6 | Single record — get, set, CRUD, functions, store |
+| DivhuntAddonRender | 7 | Frontend component — compile, DOM diffing, events, lifecycle |
+| DivhuntError | — | Structured error (extends Error) — code, message, context |
+
+## Import Aliases
+
+Defined in `package.json` under `imports`:
+
+| Alias | Maps to |
+|---|---|
+| `#framework/*` | `./lib/*` |
+| `#database/*` | `./addons/core/database/back/*` |
+| `#servers/*` | `./addons/core/servers/back/*` |
+| `#clients/*` | `./addons/core/clients/back/*` |
+| `#commands/*` | `./addons/core/commands/back/*` |
+| `#queue/*` | `./addons/core/queue/back/*` |
+| `#assets/*` | `./addons/render/assets/back/*` |
+| `#html/*` | `./addons/render/html/*` |
+| `#directives/*` | `./addons/render/directives/*` |
+| `#elements/*` | `./addons/render/elements/*` |
+| `#tags/*` | `./addons/render/tags/*` |
+| `#sources/*` | `./addons/modules/sources/*` |
+| `#variables/*` | `./addons/modules/variables/*` |
+
+## Design Decisions
+
+### Mixin composition over inheritance
+`Object.assign(Class.prototype, mixin)`. No class hierarchies. Each mixin is a plain object of methods merged onto the prototype.
+
+### Middleware as the extension point
+CRUD operations are async middleware chains. Database addon intercepts for SQL. Without database — everything works in-memory. Storage is swappable.
+
+### Self-registering imports
+Importing `load.js` registers the addon. No manual wiring, no DI container. `AddonReady` handles async dependency resolution regardless of import order.
+
+### Field transforms
+Every field has `get[]` and `set[]` transform arrays plus a `define` schema. Type coercion, validation, and computed fields are declared at the field level.
+
+### Proxy-driven reactivity (frontend)
+Property assignment triggers Proxy trap → schedules 16ms debounced `Update()` → re-compile → DOM diff → patch. No virtual DOM.
+
+### Binary transport over gRPC
+Buffer instances extracted to separate `map<string, bytes>` before sending. Re-injected on receive. Transparent binary transport over JSON-based gRPC.
+
+### Structured error handling
+`divhunt.Error(code, message, context)` returns a `DivhuntError` (extends `Error`). HTTP-compatible codes (400, 404, 500). Emits `'error'` event on creation. HTTP server and command system read `error.code` instead of hardcoding 500. `LogError` includes code and context in meta.
+
+### Convention-based bundling
+No webpack. Scans directories, prioritizes `addon.js`, strips ES module syntax, concatenates by order, minifies via terser.
+
+## Dependencies
+
+| Package | Purpose |
+|---|---|
+| knex | SQL query builder |
+| pg | PostgreSQL driver |
+| @grpc/grpc-js | gRPC server/client |
+| @grpc/proto-loader | gRPC proto loading |
+| bcrypt | Password hashing |
+| busboy | Multipart/file upload parsing |
+| dotenv | Environment config |
+| linkedom | Server-side DOM |
+| terser | JS minification |