docs: add mdBook documentation site with skeleton and migrated content

Set up docs-site/ using mdBook with 233 content pages across 8 parts
(Preface, Tutorial, MDL Language, Project Tools, IDE Integration,
Go Library, Statement Reference, Architecture/Internals, Appendixes).

Migrated existing content from docs/ into the new structure:
- Preface from mxcli-overview.md and README.md
- Language reference from mdl-specification/ (17 pages)
- Go Library from GO_LIBRARY.md (6 pages)
- Internals from ARCHITECTURE.md and parser/BSON docs (7 pages)
- Appendixes from MDL_QUICK_REFERENCE.md and data-types.md (4 pages)

Remaining pages are stubs to be filled in (Tutorial, Tools, IDE,
Statement Reference). Includes GitHub Actions workflow for deploying
to GitHub Pages on merge to main.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ako

.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs-site/**'
+      - '.github/workflows/docs.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'docs-site/**'
+      - '.github/workflows/docs.yml'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install mdBook
+        run: |
+          MDBOOK_VERSION="0.5.2"
+          curl -sSL "https://github.com/rust-lang/mdBook/releases/download/v${MDBOOK_VERSION}/mdbook-v${MDBOOK_VERSION}-x86_64-unknown-linux-gnu.tar.gz" \
+            | tar -xz -C /usr/local/bin
+
+      - name: Build book
+        run: mdbook build docs-site
+
+      - name: Upload artifact
+        if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site/book
+
+  deploy:
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs-site/.gitignore

@@ -0,0 +1 @@
+book/

docs-site/book.toml

@@ -0,0 +1,26 @@
+[book]
+title = "mxcli Documentation"
+description = "Documentation for mxcli and the MDL (Mendix Definition Language)"
+authors = ["Mendix Labs"]
+language = "en"
+src = "src"
+
+[build]
+build-dir = "book"
+
+[output.html]
+default-theme = "light"
+preferred-dark-theme = "navy"
+git-repository-url = "https://github.com/mendixlabs/mxcli"
+edit-url-template = "https://github.com/mendixlabs/mxcli/edit/main/docs-site/src/{path}"
+site-url = "/mxcli/"
+additional-css = ["theme/custom.css"]
+
+[output.html.search]
+enable = true
+limit-results = 30
+boost-hierarchy = 2
+
+[output.html.fold]
+enable = true
+level = 1

docs-site/src/SUMMARY.md

@@ -0,0 +1,275 @@
+# Summary
+
+[Preface](preface/README.md)
+- [What is mxcli?](preface/what-is-mxcli.md)
+- [What is MDL?](preface/what-is-mdl.md)
+- [Mendix Concepts for Newcomers](preface/mendix-concepts.md)
+- [Document Conventions](preface/conventions.md)
+
+---
+
+# Part I: Tutorial
+
+- [Setting Up](tutorial/setup.md)
+  - [Installation](tutorial/installation.md)
+  - [Opening Your First Project](tutorial/opening-project.md)
+  - [The REPL](tutorial/repl.md)
+- [Exploring a Project](tutorial/exploring.md)
+  - [SHOW MODULES, SHOW ENTITIES](tutorial/show-commands.md)
+  - [DESCRIBE, SEARCH](tutorial/describe-search.md)
+  - [SHOW STRUCTURE](tutorial/show-structure.md)
+- [Your First Changes](tutorial/first-changes.md)
+  - [Creating an Entity](tutorial/create-entity.md)
+  - [Creating a Microflow](tutorial/create-microflow.md)
+  - [Creating a Page](tutorial/create-page.md)
+  - [Validating with mxcli check](tutorial/validation.md)
+- [Working with AI Assistants](tutorial/ai-assistants.md)
+  - [Claude Code Integration](tutorial/claude-code.md)
+  - [Cursor / Continue.dev / Windsurf](tutorial/other-ai-tools.md)
+  - [Skills and CLAUDE.md](tutorial/skills.md)
+  - [The MDL + AI Workflow](tutorial/mdl-ai-workflow.md)
+
+---
+
+# Part II: The MDL Language
+
+- [MDL Basics](language/basics.md)
+  - [Lexical Structure](language/lexical-structure.md)
+  - [Qualified Names](language/qualified-names.md)
+  - [Comments and Documentation](language/comments.md)
+  - [Script Files](language/script-files.md)
+- [Data Types](language/data-types.md)
+  - [Primitive Types](language/primitive-types.md)
+  - [Constraints](language/constraints.md)
+  - [Enumerations](language/enumerations.md)
+  - [Type Mapping](language/type-mapping.md)
+- [Domain Model](language/domain-model.md)
+  - [Entities](language/entities.md)
+  - [Attributes and Validation Rules](language/attributes.md)
+  - [Associations](language/associations.md)
+  - [Generalization](language/generalization.md)
+  - [Indexes](language/indexes.md)
+  - [ALTER ENTITY](language/alter-entity.md)
+- [Microflows and Nanoflows](language/microflows.md)
+  - [Structure](language/microflow-structure.md)
+  - [Activity Types](language/activity-types.md)
+  - [Control Flow](language/control-flow.md)
+  - [Expressions](language/expressions.md)
+  - [Nanoflows vs Microflows](language/nanoflows.md)
+  - [Common Patterns](language/microflow-patterns.md)
+- [Pages](language/pages.md)
+  - [Page Structure](language/page-structure.md)
+  - [Widget Types](language/widget-types.md)
+  - [Data Binding](language/data-binding.md)
+  - [Snippets](language/snippets.md)
+  - [ALTER PAGE / ALTER SNIPPET](language/alter-page.md)
+  - [Common Patterns](language/page-patterns.md)
+- [Security](language/security.md)
+  - [Module Roles and User Roles](language/roles.md)
+  - [Entity Access](language/entity-access.md)
+  - [Microflow, Page, and Nanoflow Access](language/document-access.md)
+  - [GRANT / REVOKE](language/grant-revoke.md)
+  - [Demo Users](language/demo-users.md)
+- [Navigation and Settings](language/navigation.md)
+  - [Navigation Profiles](language/navigation-profiles.md)
+  - [Home Pages and Menus](language/home-pages.md)
+  - [Project Settings](language/project-settings.md)
+- [Workflows](language/workflows.md)
+  - [Workflow Structure](language/workflow-structure.md)
+  - [Activity Types](language/workflow-activities.md)
+  - [Workflow vs Microflow](language/workflow-vs-microflow.md)
+- [Business Events](language/business-events.md)
+  - [Event Services](language/event-services.md)
+  - [Publishing and Consuming Events](language/pub-sub-events.md)
+
+---
+
+# Part III: Project Tools
+
+- [Code Navigation](tools/code-navigation.md)
+  - [SHOW CALLERS / CALLEES](tools/callers-callees.md)
+  - [SHOW REFERENCES / IMPACT](tools/references-impact.md)
+  - [SHOW CONTEXT](tools/show-context.md)
+  - [Full-Text Search](tools/search.md)
+- [Catalog Queries](tools/catalog.md)
+  - [REFRESH CATALOG](tools/refresh-catalog.md)
+  - [Available Tables](tools/catalog-tables.md)
+  - [SQL Queries](tools/catalog-sql.md)
+  - [Use Cases](tools/catalog-use-cases.md)
+- [Linting and Reports](tools/linting.md)
+  - [Built-in Rules](tools/builtin-rules.md)
+  - [Starlark Rules](tools/starlark-rules.md)
+  - [Writing Custom Rules](tools/custom-rules.md)
+  - [mxcli lint](tools/mxcli-lint.md)
+  - [mxcli report](tools/mxcli-report.md)
+- [Testing](tools/testing.md)
+  - [Test Formats](tools/test-formats.md)
+  - [Test Annotations](tools/test-annotations.md)
+  - [Running Tests](tools/running-tests.md)
+  - [Diff](tools/diff.md)
+- [External SQL](tools/external-sql.md)
+  - [SQL CONNECT](tools/sql-connect.md)
+  - [Querying External Databases](tools/sql-query.md)
+  - [IMPORT FROM](tools/import-from.md)
+  - [Credential Management](tools/credentials.md)
+  - [Database Connector Generation](tools/connector-generation.md)
+- [Docker Integration](tools/docker.md)
+  - [mxcli docker build](tools/docker-build.md)
+  - [mxcli docker run](tools/docker-run.md)
+  - [OQL Queries](tools/oql.md)
+  - [Dev Container Setup](tools/devcontainer.md)
+
+---
+
+# Part IV: IDE Integration
+
+- [VS Code Extension](ide/vscode.md)
+  - [Installation](ide/vscode-installation.md)
+  - [Syntax Highlighting and Diagnostics](ide/vscode-syntax.md)
+  - [Completion, Hover, Go-to-Definition](ide/vscode-intellisense.md)
+  - [Project Tree](ide/vscode-project-tree.md)
+  - [Context Menu Commands](ide/vscode-commands.md)
+- [LSP Server](ide/lsp.md)
+  - [Protocol](ide/lsp-protocol.md)
+  - [Capabilities](ide/lsp-capabilities.md)
+  - [Integration with Other Editors](ide/lsp-editors.md)
+- [mxcli init](ide/mxcli-init.md)
+  - [What Gets Created](ide/init-output.md)
+  - [Customizing Skills](ide/customizing-skills.md)
+  - [Syncing with Updates](ide/syncing.md)
+
+---
+
+# Part V: Go Library
+
+- [Quick Start](library/quickstart.md)
+  - [Installation](library/installation.md)
+  - [Reading a Project](library/reading.md)
+  - [Modifying a Project](library/modifying.md)
+- [Public API](library/public-api.md)
+  - [Open / OpenForWriting](library/open.md)
+  - [Reader Methods](library/reader-methods.md)
+  - [Writer Methods](library/writer-methods.md)
+- [Fluent API](library/fluent-api.md)
+  - [ModelAPI Entry Point](library/model-api.md)
+  - [Builders](library/builders.md)
+  - [Examples](library/fluent-examples.md)
+
+---
+
+# Part VI: MDL Statement Reference
+
+- [Connection Statements](reference/connection/README.md)
+  - [OPEN PROJECT](reference/connection/open-project.md)
+  - [CLOSE PROJECT](reference/connection/close-project.md)
+- [Query Statements](reference/query/README.md)
+  - [SHOW MODULES](reference/query/show-modules.md)
+  - [SHOW ENTITIES](reference/query/show-entities.md)
+  - [SHOW MICROFLOWS / NANOFLOWS](reference/query/show-microflows.md)
+  - [SHOW PAGES / SNIPPETS](reference/query/show-pages.md)
+  - [SHOW ENUMERATIONS](reference/query/show-enumerations.md)
+  - [SHOW ASSOCIATIONS](reference/query/show-associations.md)
+  - [SHOW CONSTANTS](reference/query/show-constants.md)
+  - [SHOW WORKFLOWS](reference/query/show-workflows.md)
+  - [SHOW BUSINESS EVENTS](reference/query/show-business-events.md)
+  - [SHOW STRUCTURE](reference/query/show-structure.md)
+  - [SHOW WIDGETS](reference/query/show-widgets.md)
+  - [DESCRIBE ENTITY](reference/query/describe-entity.md)
+  - [DESCRIBE MICROFLOW / NANOFLOW](reference/query/describe-microflow.md)
+  - [DESCRIBE PAGE / SNIPPET](reference/query/describe-page.md)
+  - [DESCRIBE ENUMERATION](reference/query/describe-enumeration.md)
+  - [DESCRIBE ASSOCIATION](reference/query/describe-association.md)
+  - [SEARCH](reference/query/search.md)
+- [Domain Model Statements](reference/domain-model/README.md)
+  - [CREATE ENTITY](reference/domain-model/create-entity.md)
+  - [ALTER ENTITY](reference/domain-model/alter-entity.md)
+  - [DROP ENTITY](reference/domain-model/drop-entity.md)
+  - [CREATE ENUMERATION](reference/domain-model/create-enumeration.md)
+  - [DROP ENUMERATION](reference/domain-model/drop-enumeration.md)
+  - [CREATE ASSOCIATION](reference/domain-model/create-association.md)
+  - [DROP ASSOCIATION](reference/domain-model/drop-association.md)
+  - [CREATE CONSTANT](reference/domain-model/create-constant.md)
+- [Microflow Statements](reference/microflow/README.md)
+  - [CREATE MICROFLOW](reference/microflow/create-microflow.md)
+  - [CREATE NANOFLOW](reference/microflow/create-nanoflow.md)
+  - [DROP MICROFLOW / NANOFLOW](reference/microflow/drop-microflow.md)
+  - [CREATE JAVA ACTION](reference/microflow/create-java-action.md)
+- [Page Statements](reference/page/README.md)
+  - [CREATE PAGE](reference/page/create-page.md)
+  - [CREATE SNIPPET](reference/page/create-snippet.md)
+  - [ALTER PAGE / ALTER SNIPPET](reference/page/alter-page.md)
+  - [DROP PAGE / SNIPPET](reference/page/drop-page.md)
+  - [CREATE LAYOUT](reference/page/create-layout.md)
+- [Security Statements](reference/security/README.md)
+  - [CREATE MODULE ROLE](reference/security/create-module-role.md)
+  - [CREATE USER ROLE](reference/security/create-user-role.md)
+  - [GRANT](reference/security/grant.md)
+  - [REVOKE](reference/security/revoke.md)
+  - [CREATE DEMO USER](reference/security/create-demo-user.md)
+- [Navigation Statements](reference/navigation/README.md)
+  - [ALTER NAVIGATION](reference/navigation/alter-navigation.md)
+  - [SHOW NAVIGATION](reference/navigation/show-navigation.md)
+- [Workflow Statements](reference/workflow/README.md)
+  - [CREATE WORKFLOW](reference/workflow/create-workflow.md)
+  - [DROP WORKFLOW](reference/workflow/drop-workflow.md)
+- [Business Event Statements](reference/business-event/README.md)
+  - [CREATE BUSINESS EVENT SERVICE](reference/business-event/create-business-event-service.md)
+  - [DROP BUSINESS EVENT SERVICE](reference/business-event/drop-business-event-service.md)
+- [Catalog Statements](reference/catalog/README.md)
+  - [REFRESH CATALOG](reference/catalog/refresh-catalog.md)
+  - [SELECT FROM CATALOG](reference/catalog/select-from-catalog.md)
+  - [SHOW CALLERS / CALLEES](reference/catalog/show-callers-callees.md)
+  - [SHOW REFERENCES / IMPACT / CONTEXT](reference/catalog/show-references-impact.md)
+  - [SHOW CATALOG TABLES](reference/catalog/show-catalog-tables.md)
+- [External SQL Statements](reference/external-sql/README.md)
+  - [SQL CONNECT](reference/external-sql/sql-connect.md)
+  - [SQL DISCONNECT](reference/external-sql/sql-disconnect.md)
+  - [SQL (query)](reference/external-sql/sql-query.md)
+  - [SQL GENERATE CONNECTOR](reference/external-sql/sql-generate-connector.md)
+  - [IMPORT FROM](reference/external-sql/import-from.md)
+- [Settings Statements](reference/settings/README.md)
+  - [SHOW SETTINGS](reference/settings/show-settings.md)
+  - [ALTER SETTINGS](reference/settings/alter-settings.md)
+- [Organization Statements](reference/organization/README.md)
+  - [CREATE MODULE](reference/organization/create-module.md)
+  - [CREATE FOLDER](reference/organization/create-folder.md)
+  - [MOVE](reference/organization/move.md)
+- [Session Statements](reference/session/README.md)
+  - [SET](reference/session/set.md)
+  - [SHOW STATUS](reference/session/show-status.md)
+
+---
+
+# Part VII: Architecture & Internals
+
+- [System Architecture](internals/architecture.md)
+  - [Layer Diagram](internals/layers.md)
+  - [Package Structure](internals/packages.md)
+  - [Design Decisions](internals/design-decisions.md)
+- [MPR File Format](internals/mpr-format.md)
+  - [v1 vs v2](internals/mpr-v1-v2.md)
+  - [BSON Document Structure](internals/bson-structure.md)
+  - [Storage Names vs Qualified Names](internals/storage-names.md)
+  - [Widget Template System](internals/widget-templates.md)
+- [MDL Parser](internals/parser.md)
+  - [ANTLR4 Grammar Design](internals/antlr4-grammar.md)
+  - [Lexer - Parser - AST - Executor Pipeline](internals/parser-pipeline.md)
+  - [Adding New Statements](internals/adding-statements.md)
+- [Catalog System](internals/catalog.md)
+  - [SQLite Schema](internals/catalog-schema.md)
+  - [FTS5 Full-Text Search](internals/fts5.md)
+  - [Reference Tracking](internals/reference-tracking.md)
+
+---
+
+# Part VIII: Appendixes
+
+- [MDL Quick Reference](appendixes/quick-reference.md)
+- [Data Type Mapping Table](appendixes/data-type-mapping.md)
+- [Reserved Words](appendixes/reserved-words.md)
+- [Mendix Version Compatibility](appendixes/version-compatibility.md)
+- [Common Mistakes and Anti-Patterns](appendixes/common-mistakes.md)
+- [Error Messages Reference](appendixes/error-messages.md)
+- [Glossary](appendixes/glossary.md)
+- [TypeScript SDK Equivalence](appendixes/sdk-equivalence.md)
+- [Changelog](appendixes/changelog.md)

docs-site/src/appendixes/changelog.md

@@ -0,0 +1,3 @@
+# Changelog
+
+Version history and release notes for ModelSDK Go and the mxcli tool.