OSS Diff

.claude/CLAUDE.md

@@ -100,7 +100,6 @@ The `db-controller.js` is a facade that imports from specialized controller modu
 - `controllers/release.js`: Object release (immutability)
 - `controllers/bulk.js`: Bulk create and update operations
 - `controllers/search.js`: MongoDB text search (searchAsWords, searchAsPhrase)
-- `controllers/gog.js`: Gallery of Glosses specific operations (fragments, glosses, expand)
 - `controllers/utils.js`: Shared utilities (ID generation, slug handling, agent claims)
 
 **4. Authentication & Authorization:**
@@ -113,7 +112,6 @@ The `db-controller.js` is a facade that imports from specialized controller modu
 **5. Special Features:**
 - **Slug IDs:** Optional human-readable IDs via Slug header (e.g., "my-annotation")
 - **PATCH Override:** X-HTTP-Method-Override header allows POST to emulate PATCH for clients without PATCH support
-- **GOG Routes:** Specialized endpoints for Gallery of Glosses project (`/gog/fragmentsInManuscript`, `/gog/glossesInManuscript`)
 - **Content Negotiation:** Handles both `@id`/`@context` (JSON-LD) and `id` (plain JSON) patterns
 
 ### Directory Structure

.github/copilot-instructions.md

@@ -125,7 +125,7 @@ After making changes, ALWAYS validate these scenarios:
 
 ### Key Directories
 - `/routes/` - Route handlers and API endpoints (Express routes)
-- `/controllers/` - Business logic controllers (CRUD operations, GOG-specific controllers)
+- `/controllers/` - Business logic controllers (CRUD operations, history, release, bulk operations)
 - `/database/` - Database connection and utilities (MongoDB integration)
 - `/auth/` - Authentication middleware (Auth0 JWT handling)
 - `/public/` - Static files (API.html, context.json, etc.)
@@ -145,7 +145,6 @@ After making changes, ALWAYS validate these scenarios:
 - **Database**: MongoDB for persistent storage, versioned objects
 - **Static Files**: Served directly from `/public` directory
 - **CORS**: Fully open ("*") for cross-origin requests
-- **Specialized Routes**: Gallery of Glosses (GOG) specific endpoints in `_gog_*.js` files
 
 ### Coding Style Guidelines
 - **Semicolons**: Avoid unnecessary semicolons (e.g., at the end of most lines)

.npmignore

@@ -0,0 +1,30 @@
+# Documentation
+docs/
+*.md
+!README.md
+CODEOWNERS
+
+# Test and mock files
+__tests__/
+__mocks__/
+**/__tests__/
+**/__mocks__/
+coverage/
+jest.config.js
+
+# Backup folders / artifacts
+backups/
+*.backup
+*.bak
+*.swp
+*.tgz
+
+# Local configuration files
+.env
+.env.*
+config.local.js
+*.local.js
+
+# Tooling and CI
+.github/
+.claude/

LICENSE

@@ -1 +1,21 @@
-There is no license.
+MIT License
+
+Copyright (c) 2026 Open Source with SLU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -26,6 +26,27 @@ Stores important bits of knowledge in structured JSON-LD objects:
 1. **Open and Free**—expose all contributions immediately without charge to write or read;
 1. **Attributed and Versioned**—always include asserted ownership and transaction metadata so consumers can evaluate trustworthiness and relevance.
 
+### Programmatic usage
+This project exposes a single public entry point at the package root (`index.js`).  Only a few
+functions are exported – everything else lives in internal modules and is intentionally
+kept private.  Example:
+
+```js
+import { app, createServer, start } from 'rerum_server_nodejs'
+
+// `app` is the configured Express application; you can pass it to Supertest or reuse it
+// inside another HTTP stack.
+
+const server = createServer(8080)   // returns a http.Server but does not listen
+server.listen()
+
+// or simply
+start(8080) // convenience helper that both creates and listens
+```
+
+Consumers no longer need to reach into `./app.js` or other deep paths – if it isn't
+exported here it isn't part of the stable API.
+
 ## What we add
 You will find a `__rerum` property on anything you read from this repository. This is written onto
 all objects by the server and is not editable by the client applications. While applications may assert