chore: update content

.pre-commit-config.yaml

@@ -14,7 +14,7 @@ repos:
         language: system
         types: [rust]
         pass_filenames: false
-        stages: [pre-commit]
+        stages: [pre-push]
 
       - id: rust-clippy
         name: Rust linting (cargo clippy)
@@ -22,7 +22,7 @@ repos:
         language: system
         types: [rust]
         pass_filenames: false
-        stages: [pre-commit]
+        stages: [pre-push]
 
       - id: rust-test
         name: Rust tests
@@ -87,15 +87,28 @@ repos:
   #       stages: [commit]
 
   # ============================================================================
-  # Markdown Hooks (optional - enable if using Markdown)
+  # Markdown Hooks
   # ============================================================================
-  # - repo: local
-  #   hooks:
-  #     - id: markdownlint
-  #       name: Markdown linting (markdownlint-cli2)
-  #       entry: markdownlint-cli2
+  - repo: local
+    hooks:
+      - id: markdownlint
+        name: Markdown linting (markdownlint-cli2)
+        entry: markdownlint-cli2 --config .markdownlint-cli2.jsonc docs/
+        language: system
+        types: [markdown]
+        pass_filenames: false
+        stages: [pre-commit]
+
+      # NOTE: Malformed closing fences check disabled
+      # All 4,043 instances were fixed in 2025-01-09
+      # Markdownlint doesn't catch this natively (see config comments)
+      # Requires Python for proper state tracking, which is not desired
+      # - id: check-markdown-fences
+      #   name: Check malformed code fences
+      #   entry: .githooks/check-markdown-fences.sh
       #   language: system
       #   types: [markdown]
+      #   pass_filenames: true
       #   stages: [commit]
 
   # ============================================================================

README.md

@@ -25,9 +25,15 @@
 
 ## What is Provisioning?
 
-**Provisioning** is a comprehensive **Infrastructure as Code (IaC)** platform designed to manage complete infrastructure lifecycles: cloud providers, infrastructure services, clusters, and isolated workspaces across multiple cloud/local environments.
+**Provisioning** is a comprehensive **Infrastructure as Code (IaC)** platform designed to manage
+complete infrastructure lifecycles: cloud providers, infrastructure services, clusters,
+and isolated workspaces across multiple cloud/local environments.
 
-Extensible and customizable by design, it delivers type-safe, configuration-driven workflows with enterprise security (encrypted configuration, Cosmian KMS integration, Cedar policy engine, secrets management, authorization and permissions control, compliance checking, anomaly detection) and adaptable deployment modes (interactive UI, CLI automation, unattended CI/CD) suitable for any scale from development to production.
+Extensible and customizable by design, it delivers type-safe, configuration-driven workflows
+with enterprise security (encrypted configuration, Cosmian KMS integration, Cedar policy engine,
+secrets management, authorization and permissions control, compliance checking, anomaly detection)
+and adaptable deployment modes (interactive UI, CLI automation, unattended CI/CD)
+suitable for any scale from development to production.
 
 ### Technical Definition
 
@@ -116,7 +122,7 @@ Declarative Infrastructure as Code (IaC) platform providing:
 
 ```plaintext
 Defaults → User → Project → Infrastructure → Environment → Runtime
-```plaintext
+```
 
 #### 4. **Imperative Scripts**
 
@@ -209,13 +215,13 @@ workspace_librecloud/     # Production workspace
 workspace_dev/            # Development workspace
 ├── infra/
 └── config/
-```plaintext
+```
 
 Switch between workspaces with single command:
 
 ```bash
 provisioning workspace switch librecloud
-```plaintext
+```
 
 ### 5. **Workflows**
 
@@ -280,7 +286,7 @@ Coordinated sequences of operations with dependency management.
 │  • Kubernetes Clusters                                          │
 │  • Running Services                                             │
 └─────────────────────────────────────────────────────────────────┘
-```plaintext
+```
 
 ### Directory Structure
 
@@ -652,7 +658,7 @@ echo $NU_VERSION $PROVIDER_AWS_VERSION
 
 ```bash
 provisioning server create --infra my-cluster
-```plaintext
+```
 
 **Step 3**: Provisioning executes workflow
 
@@ -677,13 +683,13 @@ provisioning server create --infra my-cluster
 4. Checkpoint after each step
 5. Monitor health checks
 6. Report completion
-```plaintext
+```
 
 **Step 4**: Verify deployment
 
 ```bash
 provisioning cluster status my-cluster
-```plaintext
+```
 
 ### Configuration Hierarchy
 
@@ -701,7 +707,7 @@ Configuration values are resolved through a hierarchy:
 5. Environment Config (workspace/config/prod-defaults.toml)
    ↓ (overridden by)
 6. Runtime Flags (--flag value)
-```plaintext
+```
 
 **Example**:
 
@@ -720,7 +726,7 @@ default_plan = "large"   # Overrides user preference
 
 # Runtime
 provisioning server create --plan xlarge  # Overrides everything
-```plaintext
+```
 
 ---
 
@@ -736,7 +742,7 @@ provisioning cluster create k8s-prod --provider upcloud
 
 # AWS cluster (same config)
 provisioning cluster create k8s-prod --provider aws
-```plaintext
+```
 
 ### 2. **Development → Staging → Production Pipeline**
 
@@ -754,7 +760,7 @@ provisioning cluster create app-stack
 # Production (HA, larger resources)
 provisioning workspace switch prod
 provisioning cluster create app-stack
-```plaintext
+```
 
 ### 3. **Infrastructure as Code Testing**
 
@@ -770,7 +776,7 @@ provisioning test env run <env-id>
 
 # Cleanup
 provisioning test env cleanup <env-id>
-```plaintext
+```
 
 ### 4. **Batch Multi-Region Deployment**
 
@@ -822,7 +828,7 @@ provisioning workspace switch prod
 provisioning cluster create --infra backup-restore --wait
 
 # All services restored with same configuration
-```plaintext
+```
 
 ### 6. **CI/CD Integration**
 
@@ -846,7 +852,7 @@ deploy-production:
   script:
   - provisioning workspace switch prod
   - provisioning cluster create app-stack --yes
-```plaintext
+```
 
 ---