refactor(mothership): reconcile canonical /mint contract, archive sprawl

CHARTER.md

@@ -62,13 +62,20 @@ ChittyID is the **authoritative identity management foundation** for the ChittyO
 ### Core Endpoints
 | Endpoint | Method | Purpose |
 |----------|--------|---------|
-| `/api/v2/chittyid/mint` | POST | Generate new ChittyID |
-| `/api/v2/chittyid/verify` | POST | Verify ChittyID validity |
-| `/api/v2/chittyid/audit` | POST | Get audit trail |
-| `/api/v2/chittyid/mint/batch` | POST | Batch generation |
-| `/api/v2/fallback/request` | POST | Fallback service |
+| `/mint` | POST | **Canonical** — generate a new ChittyID (body: `{entityType:"P"\|"L"\|"T"\|"E"\|"A"}`) |
+| `/api/validate` | POST | Verify ChittyID validity (body: `{id}`) |
+| `/api/spec` | GET | OpenAPI specification |
 | `/health` | GET | Service health |
 
+### Deprecated Aliases (sunset 2027-05-27)
+These remain for backward compatibility and 308-redirect / proxy to the canonical `POST /mint`. Do not build new integrations against them.
+
+| Endpoint | Method | Replacement |
+|----------|--------|-------------|
+| `/v1/mint` | POST | `POST /mint` |
+| `/generate` | GET | `POST /mint` with `{entityType:"P"}` |
+| `/api/get-chittyid` | GET | `POST /mint` |
+
 ### ChittyID Format
 ```
 VV-G-LLL-SSSS-T-YYMM-C-XX
@@ -131,4 +138,4 @@ This charter is part of a synchronized documentation triad. Changes to shared fi
 **Related docs**: [CHITTY.md](CHITTY.md) (badge/one-pager) | [CLAUDE.md](CLAUDE.md) (developer guide)
 
 ---
-*Charter Version: 1.0.0 | Last Updated: 2026-02-23*
+*Charter Version: 1.0.1 | Last Updated: 2026-05-28*

CHITTY.md

@@ -64,11 +64,10 @@ Version, Geographic region, Jurisdiction, Sequential ID, Entity Type (P/L/T/E/A)
 | Path | Method | Auth | Purpose |
 |------|--------|------|---------|
 | `/health` | GET | No | Health check |
-| `/api/v2/chittyid/mint` | POST | Yes | Generate new ChittyID |
-| `/api/v2/chittyid/verify` | POST | Yes | Verify ChittyID validity |
-| `/api/v2/chittyid/audit` | POST | Yes | Get audit trail |
-| `/api/v2/chittyid/mint/batch` | POST | Yes | Batch generation |
-| `/api/v2/fallback/request` | POST | Yes | Fallback service |
+| `/mint` | POST | Yes | **Canonical** — generate a new ChittyID |
+| `/api/validate` | POST | Yes | Verify ChittyID validity |
+| `/api/spec` | GET | No | OpenAPI specification |
+| `/v1/mint`, `/generate`, `/api/get-chittyid` | — | — | Deprecated aliases → `POST /mint` (sunset 2027-05-27) |
 
 ## Document Triad
 

README.md

@@ -27,12 +27,16 @@ This is the **authoritative ChittyID Foundation service** that defines HOW Chitt
 
 ## 🚀 API Endpoints
 
-### v2 API (Current)
-- `POST /api/v2/chittyid/mint` - Generate new ChittyID
-- `POST /api/v2/chittyid/verify` - Verify ChittyID validity
-- `POST /api/v2/chittyid/audit` - Get audit trail
-- `POST /api/v2/chittyid/mint/batch` - Batch generation
-- `POST /api/v2/fallback/request` - Fallback service
+### Canonical API
+- `POST /mint` - Generate a new ChittyID (body: `{entityType:"P"|"L"|"T"|"E"|"A"}`)
+- `POST /api/validate` - Verify ChittyID validity
+- `GET /api/spec` - OpenAPI specification
+- `GET /health` - Service health
+
+### Deprecated Aliases (sunset 2027-05-27)
+- `POST /v1/mint` → use `POST /mint`
+- `GET /generate` → use `POST /mint` with `{entityType:"P"}`
+- `GET /api/get-chittyid` → use `POST /mint`
 
 ### Authentication
 All endpoints require Bearer token authentication:
@@ -44,17 +48,13 @@ Authorization: Bearer your_chitty_id_token
 
 ### Request a ChittyID
 ```javascript
-const response = await fetch('https://id.chitty.cc/api/v2/chittyid/mint', {
+const response = await fetch('https://id.chitty.cc/mint', {
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
     'Authorization': 'Bearer your_chitty_id_token'
   },
-  body: JSON.stringify({
-    entity: 'PERSON',
-    name: 'John Doe',
-    format: 'official'
-  })
+  body: JSON.stringify({ entityType: 'P' })
 });
 
 const result = await response.json();
@@ -63,15 +63,13 @@ console.log(result.chitty_id); // CP-A-001-1234-P-2509-I-82
 
 ### Verify a ChittyID
 ```javascript
-const response = await fetch('https://id.chitty.cc/api/v2/chittyid/verify', {
+const response = await fetch('https://id.chitty.cc/api/validate', {
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
     'Authorization': 'Bearer your_chitty_id_token'
   },
-  body: JSON.stringify({
-    chittyId: 'CP-A-001-1234-P-2509-I-82'
-  })
+  body: JSON.stringify({ id: 'CP-A-001-1234-P-2509-I-82' })
 });
 
 const result = await response.json();

chittyid.js

@@ -47,19 +47,18 @@ class ChittyIDClient {
     }
 
     try {
-      const response = await fetch(`${this.serverUrl}/api/v2/chittyid/mint`, {
+      const response = await fetch(`${this.serverUrl}/mint`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
           Authorization: `Bearer ${this.apiKey}`,
           "X-ChittyOS-Pipeline": "Router→Intake→Trust→Authorization→Generation",
         },
         body: JSON.stringify({
+          entityType,
           region,
           jurisdiction,
-          entity: entityType,
           trustLevel,
-          format: "official",
         }),
       });
 
@@ -94,13 +93,13 @@ class ChittyIDClient {
     }
 
     try {
-      const response = await fetch(`${this.serverUrl}/api/v2/chittyid/verify`, {
+      const response = await fetch(`${this.serverUrl}/api/validate`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
           Authorization: `Bearer ${this.apiKey}`,
         },
-        body: JSON.stringify({ chittyId }),
+        body: JSON.stringify({ id: chittyId }),
       });
 
       if (!response.ok) {

eslint.config.js

@@ -9,7 +9,7 @@ export default [
       "_worker.js",
       "node_modules/**",
       "research/**",
-      "chitty-cli.js",
+      ".archive-2026-05-27/**",
       "coverage/**",
       ".nyc_output/**",
     ],

package.json

@@ -2,7 +2,7 @@
   "name": "@chittyfoundation/chittyid",
   "version": "2.0.0",
   "description": "Official ChittyID Foundation Service - Authoritative identity management for ChittyOS ecosystem",
-  "main": "chittyid-service-worker.js",
+  "main": "worker.js",
   "type": "module",
   "repository": {
     "type": "git",