@centia-io/mcp-server 1.0.16 → 1.0.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md ADDED
@@ -0,0 +1,74 @@
1
+ # AGENT.md - Centia BaaS Core Rules
2
+
3
+ > Last updated: 2026-02-22
4
+
5
+ This file only contains global hard rules.
6
+ Task-specific guidance has been moved into `skills/*/SKILL.md`.
7
+
8
+ ## 1) Prime Directive
9
+
10
+ - Prefer Centia MCP tools when available.
11
+ - Use `@centia-io/sdk` for all JS/TS runtime code.
12
+ - Use raw HTTP only for provisioning or SDK gaps.
13
+ - Never re-implement SDK functionality with `fetch`/`axios` in runtime app code.
14
+
15
+ ## 2) Tool Priority (Hard Rule)
16
+
17
+ Use this order:
18
+
19
+ 1. Centia MCP tools
20
+ 2. `@centia-io/sdk`
21
+ 3. OpenAPI-defined HTTP calls
22
+ 4. Docs-backed HTTP calls
23
+
24
+ Never invent endpoints or payloads.
25
+
26
+ ## 3) Runtime vs Provisioning (Hard Rule)
27
+
28
+ - Runtime application code must not perform schema provisioning.
29
+ - Schema changes are provisioning/codegen tasks only.
30
+ - Runtime apps must assume schema already exists.
31
+
32
+ ## 4) Security and Auth Baselines
33
+
34
+ - Never hardcode credentials or tokens.
35
+ - Never commit secrets in `.env`.
36
+ - Frontend/browser code must not embed service tokens.
37
+ - Browser auth must use SDK OAuth flows; do not implement OAuth manually.
38
+
39
+ ## 5) Destructive Operations Policy (Hard Rule)
40
+
41
+ Before destructive changes, present method/tool/purpose and require explicit user confirmation.
42
+
43
+ Destructive includes:
44
+
45
+ - `DROP`, `TRUNCATE`, destructive `DELETE`
46
+ - schema/table/column/constraint/index deletes
47
+ - policy overwrite operations
48
+
49
+ ## 6) Required Skill Routing
50
+
51
+ Use the minimal matching skill(s) below for each task:
52
+
53
+ - Runtime SDK patterns: `skills/centia-runtime-sdk/SKILL.md`
54
+ - Provisioning and migrations: `skills/centia-provisioning/SKILL.md`
55
+ - JSON-RPC lifecycle and typed API: `skills/centia-json-rpc/SKILL.md`
56
+ - Auth model by runtime context: `skills/centia-auth-model/SKILL.md`
57
+ - PostgreSQL types and output formats: `skills/centia-types-formats/SKILL.md`
58
+ - Map view config and layer styling (classes/styles/labels): `skills/centia-map-styling/SKILL.md`
59
+ - Sub-user privileges and rights inheritance: `skills/centia-privileges/SKILL.md`
60
+ - Key/value store (app state, flags, preferences): `skills/centia-keyvalue/SKILL.md`
61
+ - Feature CRUD as GeoJSON by primary key: `skills/centia-feature/SKILL.md`
62
+ - Realtime WebSocket events: `skills/centia-realtime/SKILL.md`
63
+ - File import workflow: `skills/centia-file-import/SKILL.md`
64
+ - OGC web services (WMS/WFS/WFS-T/MapCache): `skills/centia-ows/SKILL.md`
65
+ - OGC API Features and Maps (GeoJSON items, map images): `skills/centia-ogc/SKILL.md`
66
+ - OpenAPI and docs fallback: `skills/centia-openapi-docs/SKILL.md`
67
+ - Delivery checklist and MCP reference: `skills/centia-delivery/SKILL.md`
68
+ - Danish address/matrikel search component: `skills/danish-search/SKILL.md`
69
+
70
+ ## 7) Default Paths
71
+
72
+ - SDK client: `src/baas/client.ts`
73
+ - HTTP fallback layer: `src/baas/http.ts`
74
+ - Provisioning assets: `provision/`, `migrations/`, `schema/`
package/README.md CHANGED
@@ -135,6 +135,8 @@ To ensure your AI agent follows these rules while developing your application:
135
135
  - `centia-auth-model` — Auth across browser, backend, CLI, and provisioning
136
136
  - `centia-types-formats` — PostgreSQL types, casts, type hints, output formats
137
137
  - `centia-file-import` — File import workflow
138
+ - `centia-ows` — WMS/WFS/WFS-T and MapCache proxy endpoints and their access model
139
+ - `centia-ogc` — OGC API Features and Maps (GeoJSON items, map images)
138
140
  - `centia-openapi-docs` — OpenAPI and docs fallback policy
139
141
  - `centia-delivery` — Delivery checklist and quality gate
140
142