@aotter/mantle 0.1.5-alpha.1 → 0.2.0-alpha.10

package/docs/handbook/navigation.json

@@ -4,91 +4,212 @@
     {
       "text": "Start here",
       "items": [
-        { "text": "Handbook overview", "link": "/start/overview" },
-        { "text": "Generate a project and use the CLI", "link": "/start/project-and-cli" },
-        { "text": "Quickstart: a minimal Worker", "link": "/start/quickstart-worker" },
-        { "text": "Quickstart: authored Worker Admin", "link": "/start/quickstart-admin" },
-        { "text": "When the host is ChatGPT Sites", "link": "/chatgpt-sites/index" }
+        {
+          "text": "Build with an agent",
+          "link": "/start/agents"
+        },
+        {
+          "text": "Handbook overview",
+          "link": "/start/overview"
+        },
+        {
+          "text": "Quickstart: a service on Workers",
+          "link": "/start/quickstart-worker"
+        },
+        {
+          "text": "Project layout and CLI",
+          "link": "/start/project-and-cli"
+        }
       ]
     },
     {
       "text": "Task guides",
       "items": [
-        { "text": "Agent installation and handoff", "link": "/guides/agent-setup" },
-        { "text": "Typed queries and internal Views", "link": "/guides/typed-queries" },
-        { "text": "Customize Admin from manifests", "link": "/guides/admin-ui" }
+        {
+          "text": "Agent installation and handoff",
+          "link": "/guides/agent-setup"
+        },
+        {
+          "text": "Query from TypeScript",
+          "link": "/guides/typed-queries"
+        },
+        {
+          "text": "Public pages: SEO, AEO and languages",
+          "link": "/guides/public-pages"
+        },
+        {
+          "text": "Local HTTP checks",
+          "link": "/guides/local-testing"
+        },
+        {
+          "text": "SQL patterns",
+          "link": "/guides/sql-patterns"
+        },
+        {
+          "text": "Native Admin",
+          "link": "/guides/native-admin"
+        },
+        {
+          "text": "Customize Admin",
+          "link": "/guides/admin-ui"
+        },
+        {
+          "text": "Another host or engine",
+          "link": "/guides/adapter-guide"
+        },
+        {
+          "text": "Native execution",
+          "link": "/guides/native-execution"
+        },
+        {
+          "text": "PostgreSQL adapters",
+          "link": "/guides/postgres-adapters"
+        },
+        {
+          "text": "OAuth and consent",
+          "link": "/guides/oauth"
+        },
+        {
+          "text": "Transactional email",
+          "link": "/guides/email"
+        },
+        {
+          "text": "MCP Apps",
+          "link": "/guides/mcp-apps"
+        },
+        {
+          "text": "Size and startup",
+          "link": "/guides/size-and-startup"
+        }
       ]
     },
     {
       "text": "Concepts",
       "items": [
-        { "text": "The four atoms", "link": "/concepts/four-atoms" },
-        { "text": "Lifecycle and locales", "link": "/concepts/lifecycle-and-locales" },
-        { "text": "Reads: Views, REST and MCP", "link": "/concepts/views" },
-        { "text": "Writes: Procedures, Triggers and hooks", "link": "/concepts/procedures-and-triggers" },
-        { "text": "Authorization", "link": "/concepts/authorization" },
-        { "text": "MCP and agents", "link": "/concepts/mcp-and-agents" },
-        { "text": "Runtime pipeline and adapters", "link": "/concepts/runtime-and-adapters" }
+        {
+          "text": "The four atoms",
+          "link": "/concepts/four-atoms"
+        },
+        {
+          "text": "Lifecycle and locales",
+          "link": "/concepts/lifecycle-and-locales"
+        },
+        {
+          "text": "Reads: Views, REST and MCP",
+          "link": "/concepts/views"
+        },
+        {
+          "text": "Writes: Procedures and Triggers",
+          "link": "/concepts/procedures-and-triggers"
+        },
+        {
+          "text": "Authorization",
+          "link": "/concepts/authorization"
+        },
+        {
+          "text": "MCP and agents",
+          "link": "/concepts/mcp-and-agents"
+        },
+        {
+          "text": "Runtime, Store and dialects",
+          "link": "/concepts/runtime-and-adapters"
+        }
       ]
     },
     {
       "text": "Reference",
       "items": [
-        { "text": "Manifest feature table", "link": "/reference/features" },
-        { "text": "Manifest envelope", "link": "/reference/manifest" },
-        { "text": "Schema", "link": "/reference/schema" },
-        { "text": "View", "link": "/reference/view" },
-        { "text": "Procedure", "link": "/reference/procedure" },
-        { "text": "Trigger", "link": "/reference/trigger" },
-        { "text": "Authorization requirements", "link": "/reference/authorization" },
-        { "text": "Site defaults and site_config", "link": "/reference/site-config" },
-        { "text": "Diagnostic codes", "link": "/reference/diagnostics" },
-        { "text": "HTTP, MCP, CLI and packages", "link": "/reference/surface" }
-      ]
-    },
-    {
-      "text": "ChatGPT Sites",
-      "items": [
-        { "text": "Get started", "link": "/chatgpt-sites/index" },
-        { "text": "Generate a blank app", "link": "/chatgpt-sites/generated-app" },
-        { "text": "Host reference", "link": "/chatgpt-sites/host-reference" },
-        { "text": "Equipment checkout and external APIs", "link": "/chatgpt-sites/equipment-checkout" },
-        { "text": "Earlier guide URL", "link": "/cloudflare/chatgpt-sites" }
+        {
+          "text": "Manifest feature table",
+          "link": "/reference/features"
+        },
+        {
+          "text": "Manifest envelope",
+          "link": "/reference/manifest"
+        },
+        {
+          "text": "Schema",
+          "link": "/reference/schema"
+        },
+        {
+          "text": "View",
+          "link": "/reference/view"
+        },
+        {
+          "text": "Procedure",
+          "link": "/reference/procedure"
+        },
+        {
+          "text": "Trigger",
+          "link": "/reference/trigger"
+        },
+        {
+          "text": "SQL accepted by each dialect",
+          "link": "/reference/sql"
+        },
+        {
+          "text": "Authorization requirements",
+          "link": "/reference/authorization"
+        },
+        {
+          "text": "Site defaults and site_config",
+          "link": "/reference/site-config"
+        },
+        {
+          "text": "Diagnostic codes",
+          "link": "/reference/diagnostics"
+        },
+        {
+          "text": "HTTP, MCP, CLI and packages",
+          "link": "/reference/surface"
+        },
+        {
+          "text": "Generated Admin descriptors",
+          "link": "/reference/admin-descriptors"
+        }
       ]
     },
     {
       "text": "Cloudflare",
       "items": [
-        { "text": "The conventional Worker", "link": "/cloudflare/conventional-worker" },
-        { "text": "Bindings and primitives", "link": "/cloudflare/bindings" },
-        { "text": "Authentication", "link": "/cloudflare/authentication" },
-        { "text": "Public web, SEO and cache", "link": "/cloudflare/public-web" },
-        { "text": "Site chrome", "link": "/cloudflare/site-chrome" },
-        { "text": "Deferred hooks with Queues", "link": "/cloudflare/deferred-hooks-queues" },
-        { "text": "Media uploads with R2", "link": "/cloudflare/media-r2" },
-        { "text": "Deploy and operate", "link": "/cloudflare/deploy-and-operate" },
-        { "text": "Low-level composition", "link": "/cloudflare/low-level-composition" }
+        {
+          "text": "The service and its entry",
+          "link": "/cloudflare/service-entry"
+        },
+        {
+          "text": "Authentication",
+          "link": "/cloudflare/authentication"
+        },
+        {
+          "text": "Media uploads with R2",
+          "link": "/cloudflare/media-r2"
+        },
+        {
+          "text": "Deploy and operate",
+          "link": "/cloudflare/deploy-and-operate"
+        },
+        {
+          "text": "Mantle on ChatGPT Sites",
+          "link": "/cloudflare/chatgpt-sites"
+        }
       ]
     },
     {
       "text": "Examples",
       "items": [
-        { "text": "Examples hub", "link": "/examples/hub" },
-        { "text": "Intake form (builtin)", "link": "/examples/intake-form" },
-        { "text": "Intake Turnstile and email hooks", "link": "/examples/intake-hooks" },
-        { "text": "Publication", "link": "/examples/publication" },
-        { "text": "Legal documents and consent", "link": "/examples/legal-documents" },
-        { "text": "Reservation requests", "link": "/examples/reservation" },
-        { "text": "Procurement approvals", "link": "/examples/procurement-approvals" },
-        { "text": "Commerce catalog (builtin)", "link": "/examples/commerce" },
-        { "text": "Commerce inventory (DO/Queue)", "link": "/examples/commerce-transaction" },
-        { "text": "Guarded API access", "link": "/examples/guarded-api" }
+        {
+          "text": "Examples",
+          "link": "/examples/hub"
+        }
       ]
     },
     {
       "text": "Releases",
       "items": [
-        { "text": "Stable releases", "link": "/releases/index" }
+        {
+          "text": "Releases",
+          "link": "/releases/index"
+        }
       ]
     }
   ]

package/docs/handbook/reference/admin-descriptors.md

@@ -0,0 +1,53 @@
+# Generated Admin descriptors
+
+Experimental native preview; use the matching installed SDK/Admin versions.
+[Native Admin](../guides/native-admin.md) explains execution and mounting
+with `entries(bindings.schemas, bindings.adapter)`. Descriptors remain static
+data, not runtime authorization or a storage interpreter.
+
+`mantle generate` emits `admin-descriptors.ts`. Its exports are static data;
+importing a query does not import them. Selecting only `collections` also drops
+the developer snapshot and MCP catalogues from a bundle. No request-time parser,
+execution plan or SQL AST, storage access or execution observer is included.
+
+- `collections` matches the 0.2 navigation projection: translation Schemas fold
+  into their parents; composition, parent picker, media fields, indexed sorts,
+  enum filters and list presentation retain their declared field names.
+- `allCollections` includes translation and child editor descriptors by name.
+  `scopeField` identifies the private scope field; `exportFields` lists only
+  declared, exportable data fields (excluding scope/geo). CSV uses these facts
+  instead of guessing from row keys. `fieldNames` maps storage column names to authored names; `viewNames` does the
+  same for admin View outputs whose fields are read unchanged.
+- `views` and `operations` preserve the 0.2 admin descriptor shapes. Generated
+  publishing transitions stay out of Admin operations and WebMCP, preserving
+  the SPA's native Publish/Unpublish buttons. Operation
+  bindings use declared targets and version inputs; `preconditions` contains
+  necessary string (including enum) and boolean equality/IN predicates from one
+  target-row write. Numeric, temporal and JSON fields are skipped; these hints
+  do not authorize execution.
+- `authorizations` is a separate View/Procedure lookup for the generated Admin
+  handler to filter descriptors by the resolved Caller. These constants do not
+  authorize a request; session/admin gates and execution checks remain required.
+- `developerConsole` is the 0.2 data-model, logic, interface, relationship and
+  operations snapshot, derived once during generation. SQL logic is display
+  data, not executable IR. Observations remain unavailable and run history empty.
+- `mcpAppCatalogues` contains public/admin App catalogues. Row actions require
+  the same single-table, unchanged-id provenance as 0.2. Publishing transitions
+  use the actual `<schema>.<verb>` Procedures and canonical `<verb>_<schema>`
+  admin tool names. A conflicting declared admin tool is refused.
+- `webmcp` carries static tool declarations and Admin page routes. `bootstrap`
+  combines `collections`, `operations`, `views` and `webmcp`; the handler adds
+  request-owned `me`, `site` and any selected entries page.
+
+Generation reuses the 0.2 projection and SQL-logic helpers. View columns come
+from the compiled plan (Core's `viewOutputs` provenance, including aliases,
+stars, CTEs and subqueries). Translation
+metadata and selected execution share the generated translation policy. Child
+fields win; private scope fields cannot be overlaid by inherited parent fields.
+
+`adminBindings()` provides the selected adapter and checked entry/View/operation
+bindings. The server shares native read templates across collections; descriptors
+carry compiler-verified policy/field fragments and generated validators, not a
+copy of full SQL for every order/direction. Metadata endpoints perform no storage
+read of their own; caller resolution and optional site/user enrichment may query.
+Statistics capability is advertised only when its native route is mounted.