build(deps): bump org.snakeyaml:snakeyaml-engine from 2.9 to 3.0.1

.editorconfig

@@ -0,0 +1,90 @@
+# EditorConfig — canonical configuration for all quarkloop repositories.
+#
+# Copy this file to the repo root as `.editorconfig` (no changes needed —
+# it is language-aware and works for all repos).
+#
+# @see https://github.com/quarkloop/guidelines/blob/main/github/SPEC.md
+# @see https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Go — gofmt requires tabs
+[*.go]
+indent_style = tab
+indent_size = 4
+
+# Rust — rustfmt default is tabs
+[*.rs]
+indent_style = tab
+indent_size = 4
+
+# Java — Maven/Java convention is 4 spaces
+[*.java]
+indent_style = space
+indent_size = 4
+
+# TypeScript, JavaScript, JSX, TSX — Prettier convention is 2 spaces
+[*.{ts,tsx,js,jsx,mjs,cjs}]
+indent_style = space
+indent_size = 2
+
+# CSS, SCSS, Less — 2 spaces
+[*.{css,scss,less,sass}]
+indent_style = space
+indent_size = 2
+
+# HTML — 2 spaces
+[*.html]
+indent_style = space
+indent_size = 2
+
+# YAML, JSON — 2 spaces
+[*.{yml,yaml,json,jsonc,json5}]
+indent_style = space
+indent_size = 2
+
+# TOML — 2 spaces
+[*.toml]
+indent_style = space
+indent_size = 2
+
+# Markdown, MDX — 2 spaces (but don't trim trailing whitespace —
+# markdown uses two trailing spaces for line breaks)
+[*.{md,mdx}]
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = false
+
+# Shell scripts — 2 spaces
+[*.sh]
+indent_style = space
+indent_size = 2
+
+# Makefile — MUST use tabs (make requires it)
+[Makefile]
+indent_style = tab
+
+# Proto — 2 spaces
+[*.proto]
+indent_style = space
+indent_size = 2
+
+# Properties files — 2 spaces
+[*.properties]
+indent_style = space
+indent_size = 2
+
+# Env files — 2 spaces
+[.env]
+indent_style = space
+indent_size = 2
+
+# Git submodules config — tabs (git convention)
+[.gitmodules]
+indent_style = tab

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,71 @@
+name: Bug Report
+description: Something isn't working as expected
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please fill out the sections below to help us reproduce and fix the issue.
+        The more detail you provide, the faster we can triage.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide a minimal reproducer. If possible, include the exact commands you ran.
+      placeholder: |
+        1. Run `...`
+        2. ...
+        3. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behaviour
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behaviour
+      description: What actually happened? Include error messages, logs, or screenshots if relevant.
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Project version
+      description: The version of the quarkloop project you're using.
+      placeholder: e.g. output of `quark version`, `npm ls @quarkloop/quark-js`, or commit SHA
+    validations:
+      required: true
+
+  - type: input
+    id: runtime-version
+    attributes:
+      label: Runtime version
+      description: The language runtime you're using.
+      placeholder: e.g. Go 1.26.2, Node 22.4.0, Bun 1.1.0, JDK 21.0.5
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: e.g. macOS 14, Ubuntu 24.04, Windows 11
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,32 @@
+name: Feature Request
+description: Propose a new feature or improvement
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to propose a feature! Please describe the
+        problem you're trying to solve — this helps us understand the
+        motivation before evaluating the solution.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve? What are you trying to do that currently isn't possible or is painful?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What would you like to happen? Be as specific as you can — API sketches, CLI examples, or pseudocode are helpful.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you tried any workarounds or alternative approaches? Why didn't they work?

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+## Description
+
+<!-- What does this PR do and why? Link related issues with "Closes #N". -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor
+- [ ] Documentation
+- [ ] Chore / dependency update
+
+## Checklist
+
+- [ ] `make build` passes (Go binaries + Java modules)
+- [ ] `make test` passes (Go + Java unit tests)
+- [ ] `make arch-check` passes when architecture or package ownership changes
+- [ ] Services do not call each other directly (communication via NATS only)
+- [ ] No TypeScript parsing added to the control plane (control plane treats `.quark.ts` as opaque)
+- [ ] GraalJS changes are scoped to the data plane only
+- [ ] Relevant documentation updated (README, AGENTS.md, `docs/*.mdx`)
+- [ ] Changes are scoped — no unrelated files in this PR

.github/dependabot.yml

@@ -0,0 +1,42 @@
+version: 2
+
+updates:
+  # Go modules (control plane, CLI, catalog)
+  - package-ecosystem: gomod
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 10
+    groups:
+      minor-and-patch:
+        update-types:
+          - minor
+          - patch
+    labels:
+      - dependencies
+
+  # Maven (Java runtime modules)
+  - package-ecosystem: maven
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 10
+    groups:
+      minor-and-patch:
+        update-types:
+          - minor
+          - patch
+    labels:
+      - dependencies
+
+  # GitHub Actions
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 10
+    labels:
+      - dependencies

.gitignore

@@ -2,9 +2,11 @@
 target/
 !.mvn/wrapper/maven-wrapper.jar
 
-# Go
-cli/quarkctl
-cli/dist/
+# Go build artifacts
+quark-cli/quarkctl
+quark-cli/dist/
+quark-server/quark-server
+quark-catalog/quark-catalog
 dist/
 
 # IDE
@@ -37,5 +39,3 @@ tool-results/
 worklog.md
 *.zip
 .env
-quark-catalog/quark-catalog
-cli/cli

.markdownlint.json

@@ -0,0 +1,11 @@
+{
+  "default": true,
+
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD024": { "siblings_only": true },
+
+  "MD007": { "indent": 2 },
+  "MD030": { "ul_single": 1, "ul_multi": 1, "ol_single": 1, "ol_multi": 1 }
+}

.markdownlintignore

@@ -0,0 +1,8 @@
+node_modules/
+.next/
+.vercel/
+target/
+bin/
+dist/
+docs/content/
+go.sum