Version Packages (#208)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+	"$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+	"changelog": ["@svitejs/changesets-changelog-github-compact", { "repo": "sveltejs/ai-tools" }],
+	"commit": false,
+	"fixed": [],
+	"linked": [],
+	"access": "public",
+	"baseBranch": "main",
+	"updateInternalDependencies": "patch",
+	"ignore": ["!@sveltejs/mcp", "!@sveltejs/opencode"]
+}

.claude-plugin/marketplace.json

@@ -0,0 +1,22 @@
+{
+	"name": "svelte",
+	"owner": {
+		"name": "Svelte"
+	},
+	"plugins": [
+		{
+			"name": "svelte",
+			"source": "./plugins/claude/svelte",
+			"description": "A plugin for all things Svelte development, MCP, skills, and more.",
+			"lspServers": {
+				"svelte": {
+					"command": "svelteserver",
+					"args": ["--stdio"],
+					"extensionToLanguage": {
+						".svelte": "svelte"
+					}
+				}
+			}
+		}
+	]
+}

.cocoignore

@@ -0,0 +1,3 @@
+.claude
+.github
+.vscode

.cocominify

@@ -0,0 +1 @@
+packages/mcp-server/src/use_cases.json

.cursor-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+	"name": "svelte",
+	"owner": {
+		"name": "Svelte"
+	},
+	"plugins": [
+		{
+			"name": "svelte",
+			"source": "./plugins/cursor/svelte",
+			"description": "A plugin for all things Svelte development, MCP, skills, and more."
+		}
+	]
+}

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = tab
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true

.gitattributes

@@ -0,0 +1,3 @@
+* text=auto eol=lf
+/packages/**/test/** -linguist-detectable
+/packages/**/fixtures/** -linguist-detectable

.github/FUNDING.yml

@@ -0,0 +1 @@
+open_collective: svelte

.github/ISSUE_TEMPLATE/autofixer_request.yml

@@ -0,0 +1,36 @@
+name: 'Autofixer Request'
+description: Request a new Autofixer for the MCP
+title: '[Autofixer Request] '
+labels: [enhancement, autofixer]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to request A new autofixer!
+  - type: textarea
+    id: problem
+    attributes:
+      label: Describe the problematic code
+      description: Please provide a clear and concise description the problem. Is much better if you can provide a code snippet the AI constantly get's wrong.
+      placeholder: The AI keeps messing with...
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Describe what the autofixer should suggest
+      description: If you were looking at this code, what would you suggest to the AI for it to fix it?
+      placeholder: You should never do this, instead do that...
+    validations:
+      required: true
+  - type: dropdown
+    id: importance
+    attributes:
+      label: Importance
+      description: How important is this feature to you?
+      options:
+        - nice to have
+        - would make my life easier
+        - the MCP is useless to me without it
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,52 @@
+name: "\U0001F41E Bug report"
+description: Report an issue with Svelte
+title: '[Bug] '
+labels: ['triage: bug']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us in the description. Thanks!
+      placeholder: Bug description
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Please provide a link to a repo or REPL that can reproduce the problem you ran into. If a report is vague (e.g. just a generic error message) and has no reproduction, it will receive a "need reproduction" label. If no reproduction is provided within a reasonable time-frame, the issue will be closed.
+      placeholder: Reproduction
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: 'Please provide some logs or screenshot of the agentic workflow failing.'
+      render: shell
+  - type: input
+    id: mcp-client
+    attributes:
+      label: MCP Client
+      description: Which MCP client are you using?
+      render: shell
+      placeholder: claude-code, codex, opencode
+    validations:
+      required: true
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: Select the severity of this issue
+      options:
+        - annoyance
+        - minor functionality loss
+        - major functionality loss
+        - blocking all usage of the mcp
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,36 @@
+name: 'Feature Request'
+description: Request a new MCP feature
+title: '[Feature Request] '
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to request this feature! If your feature request is complex or substantial enough to warrant in-depth discussion, maintainers may close the issue and ask you to open an [RFC](https://github.com/sveltejs/rfcs).
+  - type: textarea
+    id: problem
+    attributes:
+      label: Describe the problem
+      description: Please provide a clear and concise description the problem this feature would solve. The more information you can provide here, the better.
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the proposed solution
+      description: Please provide a clear and concise description of what you would like to happen.
+      placeholder: I would like to see...
+    validations:
+      required: true
+  - type: dropdown
+    id: importance
+    attributes:
+      label: Importance
+      description: How important is this feature to you?
+      options:
+        - nice to have
+        - would make my life easier
+        - the MCP is useless to me without it
+    validations:
+      required: true

.github/workflows/check.yml

@@ -13,17 +13,15 @@ jobs:
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v5
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -32,5 +30,4 @@ jobs:
       - name: Run type check
         run: pnpm run check
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key

.github/workflows/lint.yml

@@ -13,17 +13,15 @@ jobs:
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v5
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -32,5 +30,4 @@ jobs:
       - name: Run linting
         run: pnpm run lint
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key

.github/workflows/publish-mcp.yml

@@ -0,0 +1,41 @@
+name: Publish to MCP Registry
+
+on:
+  workflow_call:
+    secrets:
+      MCP_KEY:
+        required: true
+  workflow_dispatch:
+
+jobs:
+  publish-mcp:
+    name: Publish to MCP Registry
+    runs-on: ubuntu-latest
+    steps:
+      - name: checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Publish to MCP Registry
+        working-directory: packages/mcp-stdio
+        env:
+          MCP_KEY: ${{ secrets.MCP_KEY }}
+        run: |
+          NAME=mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz
+          # Download MCP Publisher pinned to v1.4.0 using latest https for security and save it to a file named mcp-publisher.tar.gz
+          curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fL "https://github.com/modelcontextprotocol/registry/releases/download/v1.4.0/$NAME" -O
+
+          # Verify the SHA256 checksum of the downloaded file
+          sha256sum --ignore-missing -c ./checksums/registry_1.4.0_checksums.txt
+
+          # Extract the tarball
+          mkdir tmp
+          tar -xzf $NAME --no-same-owner --no-same-permissions -C tmp
+
+          # Install the MCP Publisher binary
+          install -m 0755  tmp/mcp-publisher .
+
+          # Login using DNS
+          ./mcp-publisher login dns --domain svelte.dev --private-key "${MCP_KEY}"
+
+          # Publish to MCP Registry
+          ./mcp-publisher publish

.github/workflows/release-svelte-skill.yml

@@ -0,0 +1,66 @@
+name: Release Svelte Skills
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'tools/skills/**'
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+  detect-skills:
+    permissions:
+      contents: read
+    if: github.repository == 'sveltejs/ai-tools'
+    name: Detect changed skills
+    runs-on: ubuntu-latest
+    outputs:
+      skills: ${{ steps.find-skills.outputs.skills }}
+    steps:
+      - name: checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Find all skills
+        id: find-skills
+        run: |
+          skills=$(ls -d tools/skills/*/ | xargs -I {} basename {} | jq -R -s -c 'split("\n") | map(select(length > 0))')
+          echo "skills=$skills" >> $GITHUB_OUTPUT
+
+  release:
+    needs: detect-skills
+    if: needs.detect-skills.outputs.skills != '[]'
+    permissions:
+      contents: write
+    name: Release ${{ matrix.skill }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        skill: ${{ fromJson(needs.detect-skills.outputs.skills) }}
+    steps:
+      - name: checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Get version from date
+        id: version
+        run: echo "version=$(date +'%Y.%m.%d-%H%M%S')" >> $GITHUB_OUTPUT
+
+      - name: Create zip
+        run: |
+          cd tools/skills
+          zip -r ${{ matrix.skill }}.zip ${{ matrix.skill }}/
+
+      - name: Create Release
+        uses: softprops/action-gh-release@3bb12739c298aeb8a4eeaf626c5b8d85266b0e65 # v2
+        with:
+          tag_name: ${{ matrix.skill }}-v${{ steps.version.outputs.version }}
+          name: ${{ matrix.skill }} v${{ steps.version.outputs.version }}
+          body: |
+            Automated release of the ${{ matrix.skill }} skill.
+
+            This release was triggered by changes to the `tools/skills/${{ matrix.skill }}/` directory.
+          files: tools/skills/${{ matrix.skill }}.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,70 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+permissions: {}
+
+jobs:
+  release:
+    permissions:
+      contents: write # to create release (changesets/action)
+      id-token: write # OpenID Connect token needed for provenance
+      pull-requests: write # to create pull request (changesets/action)
+    # prevents this action from running on forks
+    if: github.repository == 'sveltejs/ai-tools'
+    name: Release
+    runs-on: ${{ matrix.os }}
+    outputs:
+      publishedPackages: ${{ steps.changesets.outputs.publishedPackages }}
+    strategy:
+      matrix:
+        # pseudo-matrix for convenience, NEVER use more than a single combination
+        node: [24]
+        os: [ubuntu-latest]
+    steps:
+      - name: checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          # This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
+          fetch-depth: 0
+      - uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: ${{ matrix.node }}
+          package-manager-cache: false # pnpm is not installed yet
+      - name: install pnpm
+        shell: bash
+        run: |
+          PNPM_VER=$(jq -r '.packageManager | if .[0:5] == "pnpm@" then .[5:] else "packageManager in package.json does not start with pnpm@\n" | halt_error(1)  end' package.json)
+          echo installing pnpm version $PNPM_VER
+          npm i -g pnpm@$PNPM_VER
+      - uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: ${{ matrix.node }}
+          package-manager-cache: true # caches pnpm via packageManager field in package.json
+          cache: 'pnpm'
+      - name: install
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
+      - name: build
+        run: pnpm run --filter ./packages/mcp-stdio/ build
+
+      - name: Create Release Pull Request or Publish to npm
+        id: changesets
+        # pinned for security, always review third party action code before updating
+        uses: changesets/action@c48e67d110a68bc90ccf1098e9646092baacaa87 # v1.6.0
+        with:
+          # This expects you to have a script called changeset:version version that calls changeset version and updated what it needs to be updated
+          version: pnpm changeset:version
+          # This expects you to have a script called release which does a build for your packages and calls changeset publish
+          publish: pnpm release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true
+
+  publish-mcp:
+    needs: release
+    if: contains(needs.release.outputs.publishedPackages, '"@sveltejs/mcp"')
+    uses: ./.github/workflows/publish-mcp.yml
+    secrets:
+      MCP_KEY: ${{ secrets.MCP_KEY }}

.github/workflows/sync-docs-skills.yml

@@ -0,0 +1,116 @@
+name: Sync Skills
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+  actions: write
+
+jobs:
+  sync-skills:
+    if: github.repository == 'sveltejs/ai-tools'
+    name: Sync skills from svelte.dev
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: false # pnpm is not installed yet
+
+      - name: Install pnpm
+        shell: bash
+        run: |
+          PNPM_VER=$(jq -r '.packageManager | if .[0:5] == "pnpm@" then .[5:] else "packageManager in package.json does not start with pnpm@\n" | halt_error(1) end' package.json)
+          echo installing pnpm version "$PNPM_VER"
+          npm i -g "pnpm@$PNPM_VER"
+
+      - name: Setup Node.js with pnpm cache
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: true # caches pnpm via packageManager field in package.json
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
+
+      - name: Clone svelte.dev
+        run: git clone --depth 2 https://github.com/sveltejs/svelte.dev.git "${{ runner.temp }}/svelte.dev"
+
+      - name: Discover changed skill files
+        id: discover
+        env:
+          SVELTE_DEV_ROOT: ${{ runner.temp }}/svelte.dev
+        run: |
+          skill_files=$(git -C "$SVELTE_DEV_ROOT" diff --name-only --diff-filter=ACMR HEAD~1 HEAD | grep '^apps/svelte.dev/content/docs/.*\.md$' | xargs -I{} grep -l '^skill: *true' "$SVELTE_DEV_ROOT/{}" || true)
+          echo "skill_files=$skill_files" >> "$GITHUB_OUTPUT"
+
+      - name: Sync skills
+        if: steps.discover.outputs.skill_files != ''
+        env:
+          SVELTE_DEV_ROOT: ${{ runner.temp }}/svelte.dev
+          DOCS_PREFIX: apps/svelte.dev/content/docs/
+        run: |
+          for full_path in ${{ steps.discover.outputs.skill_files }}; do
+            file="${full_path#$SVELTE_DEV_ROOT/}"
+            name=$(grep '^name: ' "$full_path" | head -1 | sed 's/^name: *//')
+            repo="${file#$DOCS_PREFIX}"
+            repo="${repo#/}"
+            repo="${repo%%/*}"
+
+            output_dir="tools/skills/$name"
+            rm -rf "$output_dir"
+            mkdir -p "$output_dir"
+
+            pnpm resolve-references --file "$full_path" --repo "$repo" --output "$output_dir"
+          done
+
+      - name: Sync plugins
+        if: steps.discover.outputs.skill_files != ''
+        run: |
+          pnpm sync-claude-plugin
+          pnpm sync-cursor-plugin
+          pnpm sync-opencode-plugin
+          pnpm generate-skill-docs
+          pnpm bump-plugin-versions
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          git diff --exit-code -- tools/skills/ plugins/ packages/opencode/ documentation/docs/ || echo "changed=true" >> "$GITHUB_OUTPUT"
+
+      - name: Create Pull Request
+        if: steps.git-check.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'chore: sync skills from svelte.dev'
+          branch: chore/sync-skills
+          delete-branch: true
+          title: 'chore: sync skills from svelte.dev'
+          body: |
+            ## Summary
+            Automatically synced skill markdown from `sveltejs/svelte.dev` into `tools/skills/`.
+
+            ## Changes
+            - Cloned `sveltejs/svelte.dev`
+            - Filtered markdown files with `skill: true` frontmatter
+            - Rebuilt synced skill folders with `scripts/resolve-references.ts`
+            - Synced `plugins/claude/svelte/` (skills, agents)
+            - Synced `plugins/cursor/svelte/` (skills, agents, rules)
+            - Synced `packages/opencode/` (skills, instructions)
+            - Updated documentation
+
+            ## Generated by
+            GitHub Action: Sync Skills
+          labels: |
+            chore
+            automated

.github/workflows/sync-plugins.yml

@@ -0,0 +1,95 @@
+name: Sync Plugins
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'tools/**'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  sync-plugins:
+    # prevents this action from running on forks
+    if: github.repository == 'sveltejs/ai-tools'
+    name: Sync Plugins from tools/
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: false # pnpm is not installed yet
+
+      - name: Install pnpm
+        shell: bash
+        run: |
+          PNPM_VER=$(jq -r '.packageManager | if .[0:5] == "pnpm@" then .[5:] else "packageManager in package.json does not start with pnpm@\n" | halt_error(1)  end' package.json)
+          echo installing pnpm version $PNPM_VER
+          npm i -g pnpm@$PNPM_VER
+
+      - name: Setup Node.js with pnpm cache
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: true # caches pnpm via packageManager field in package.json
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
+
+      - name: Sync plugins
+        run: pnpm sync-plugins
+
+      - name: Generate skills documentation
+        run: pnpm generate-skill-docs
+
+      - name: Generate subagent documentation
+        run: pnpm generate-subagent-docs
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          git diff --exit-code \
+            plugins/claude/svelte/ \
+            plugins/cursor/svelte/ \
+            packages/opencode/skills/ \
+            packages/opencode/instructions/ \
+            packages/opencode/schema.json \
+            documentation/docs/ \
+            || echo "changed=true" >> $GITHUB_OUTPUT
+
+      - name: Create Pull Request
+        if: steps.git-check.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'chore: sync plugins from tools/'
+          branch: chore/sync-plugins
+          delete-branch: true
+          title: 'chore: sync plugins from tools/'
+          body: |
+            ## Summary
+            Automatically synced all plugins from the `tools/` source of truth.
+
+            This PR was triggered by changes to `tools/**`.
+
+            ## Changes
+            - Synced `plugins/claude/svelte/` (skills, agents with `permissionMode`)
+            - Synced `plugins/cursor/svelte/` (skills, agents, rules)
+            - Synced `packages/opencode/` (skills, instructions, schema)
+            - Updated documentation
+
+            ## Generated by
+            GitHub Action: Sync Plugins
+          labels: |
+            chore
+            automated

.github/workflows/test.yml

@@ -13,17 +13,15 @@ jobs:
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
+        uses: pnpm/action-setup@fc06bc1257f339d1d5d8b3a19a8cae5388b55320 # v5
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'pnpm'
 
       - name: Install dependencies
@@ -32,11 +30,9 @@ jobs:
       - name: Build project
         run: pnpm run build
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key
 
       - name: Run tests
         run: pnpm run test
         env:
-          DATABASE_URL: file:test.db
           VOYAGE_API_KEY: dummy-key

.github/workflows/update-opencode-jsonschema.yml

@@ -0,0 +1,78 @@
+name: Update OpenCode JSON Schema
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'packages/opencode/config.ts'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-docs:
+    # prevents this action from running on forks
+    if: github.repository == 'sveltejs/ai-tools'
+    name: Update OpenCode JSON Schema
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: false # pnpm is not installed yet
+
+      - name: Install pnpm
+        shell: bash
+        run: |
+          PNPM_VER=$(jq -r '.packageManager | if .[0:5] == "pnpm@" then .[5:] else "packageManager in package.json does not start with pnpm@\n" | halt_error(1)  end' package.json)
+          echo installing pnpm version $PNPM_VER
+          npm i -g pnpm@$PNPM_VER
+
+      - name: Setup Node.js with pnpm cache
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: true # caches pnpm via packageManager field in package.json
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
+
+      - name: Generate opencode JSON schema
+        run: pnpm generate-opencode-jsonschema
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          git diff --exit-code packages/opencode/schema.json || echo "changed=true" >> $GITHUB_OUTPUT
+
+      - name: Create Pull Request
+        if: steps.git-check.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'docs: update opencode JSON schema'
+          branch: docs/update-opencode-jsonschema
+          delete-branch: true
+          title: 'docs: update opencode JSON schema'
+          body: |
+            ## Summary
+            Automatically generated update for OpenCode JSON schema.
+
+            This PR was triggered by changes to the OpenCode configuration file `packages/opencode/config.ts`.
+
+            ## Changes
+            - Updated `packages/opencode/schema.json` with latest JSON schema
+
+            ## Generated by
+            GitHub Action: Update OpenCode JSON Schema
+          labels: |
+            automated

.github/workflows/update-prompt-docs.yml

@@ -0,0 +1,79 @@
+name: Update Prompt Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'packages/mcp-server/src/mcp/handlers/prompts/**'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-docs:
+    # prevents this action from running on forks
+    if: github.repository == 'sveltejs/ai-tools'
+    name: Update Prompt Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: false # pnpm is not installed yet
+
+      - name: Install pnpm
+        shell: bash
+        run: |
+          PNPM_VER=$(jq -r '.packageManager | if .[0:5] == "pnpm@" then .[5:] else "packageManager in package.json does not start with pnpm@\n" | halt_error(1)  end' package.json)
+          echo installing pnpm version $PNPM_VER
+          npm i -g pnpm@$PNPM_VER
+
+      - name: Setup Node.js with pnpm cache
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 24
+          package-manager-cache: true # caches pnpm via packageManager field in package.json
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts
+
+      - name: Generate prompt documentation
+        run: pnpm generate-prompt-docs
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          git diff --exit-code documentation/docs/30-capabilities/30-prompts.md || echo "changed=true" >> $GITHUB_OUTPUT
+
+      - name: Create Pull Request
+        if: steps.git-check.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'docs: update prompts documentation'
+          branch: docs/update-prompt-docs
+          delete-branch: true
+          title: 'docs: update prompt documentation'
+          body: |
+            ## Summary
+            Automatically generated documentation update for MCP prompts.
+
+            This PR was triggered by changes to the prompts folder in `packages/mcp-server/src/mcp/handlers/prompts/`.
+
+            ## Changes
+            - Updated `documentation/docs/30-capabilities/30-prompts.md` with latest prompt definitions
+
+            ## Generated by
+            GitHub Action: Update Prompt Documentation
+          labels: |
+            documentation
+            automated

.gitignore

@@ -1,12 +1,16 @@
 node_modules
+/apps/**/node_modules
+/packages/**/node_modules
 
 # Output
-.output
-.vercel
-.netlify
-.wrangler
-/.svelte-kit
-/build
+/apps/**/.output
+/apps/**/.vercel
+/apps/**/.netlify
+/apps/**/.wrangler
+/**/.svelte-kit
+/apps/**/build
+/apps/**/dist
+/packages/**/dist
 
 # OS
 .DS_Store
@@ -14,14 +18,25 @@ Thumbs.db
 
 # Env
 .env
+/apps/**/.env
+/packages/**/.env
 .env.*
+/apps/**/.env.*
+/packages/**/.env.*
 !.env.example
+/apps/**/!.env.example
+/packages/**/!.env.example
 !.env.test
+/apps/**/!.env.test
+/packages/**/!.env.test
 
 # Vite
 vite.config.js.timestamp-*
 vite.config.ts.timestamp-*
+/apps/**/vite.config.js.timestamp-*
+/apps/**/vite.config.ts.timestamp-*
 
 # SQLite
 *.db
-dist
+/apps/**/*.db
+/packages/**/*.db

.mcp.json

@@ -1,8 +1,9 @@
 {
 	"mcpServers": {
-		"svelte-llm": {
-			"type": "http",
-			"url": "https://svelte-llm.stanislav.garden/mcp/mcp"
+		"svelte": {
+			"type": "stdio",
+			"command": "node",
+			"args": ["packages/mcp-stdio/dist/index.js"]
 		}
 	}
 }

.npmrc

@@ -1 +0,0 @@
-engine-strict=true

.prettierignore

@@ -8,3 +8,10 @@ bun.lockb
 # Miscellaneous
 /static/
 /drizzle/
+/**/.svelte-kit/*
+
+# Claude Code
+.claude/
+.changeset/
+
+/packages/opencode/schema.json

.prettierrc

@@ -10,6 +10,12 @@
 			"options": {
 				"parser": "svelte"
 			}
+		},
+		{
+			"files": "**/references/*.md",
+			"options": {
+				"embeddedLanguageFormatting": "off"
+			}
 		}
 	]
 }

.vscode/mcp-snippets.code-snippets

@@ -0,0 +1,94 @@
+{
+	// Place your svelte-mcp workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
+	// Placeholders with the same ids are connected.
+	// Example:
+	"Setup Function": {
+		"scope": "javascript,typescript",
+		"prefix": "!setup-mcp",
+		"body": [
+			"import type { SvelteMcp } from '../../index.js';",
+			"import * as v from 'valibot';",
+			"import { icons } from '../../icons/index.js';",
+			"",
+			"export function ${1:function_name}(server: SvelteMcp) {",
+			"\t$0",
+			"}",
+		],
+		"description": "Create a setup function for a tool/resource/prompt handler",
+	},
+	"Autofixer": {
+		"scope": "javascript,typescript",
+		"prefix": "!autofixer",
+		"body": [
+			"import type { Autofixer } from './index.js';",
+			"export const ${1:autofixer_name}: Autofixer = {",
+			"\t$0",
+			"};",
+		],
+		"description": "Create a setup export for an autofixer",
+	},
+	"Prompt Generator": {
+		"scope": "javascript,typescript",
+		"prefix": "!prompt",
+		"body": [
+			"import type { SvelteMcp } from '../../index.js';",
+			"import { icons } from '../../icons/index.js';",
+			"",
+			"/**",
+			" *  Function that actually generates the prompt string. You can use this in the MCP server handler to generate the prompt, it can accept arguments",
+			" *  if needed (it will always be invoked manually so it's up to you to provide the arguments).",
+			" */",
+			"function ${1:prompt_name}() {",
+			"\treturn `$0`;",
+			"}",
+			"",
+			"/**",
+			" * This function is used to generate the prompt to update the docs in the script `/scripts/update-docs-prompts.ts` it should use the default export",
+			" * function and pass in the arguments. Since it will be included in the documentation if it's an argument that the MCP will expose it should",
+			" * be in the format [NAME_OF_THE_ARGUMENT] to signal the user that it can substitute it.",
+			" * ",
+			" * The name NEEDS to be `generate_for_docs`.",
+			" */",
+			"export async function generate_for_docs() {",
+			"\treturn ${1:prompt_name}();",
+			"}",
+			"",
+			"/**",
+			" * Human readable description of what the prompt does. It will be included in the documentation.",
+			" * ",
+			" * The name NEEDS to be `docs_description`.",
+			" */",
+			"export const docs_description = '';",
+			"",
+			"export function setup_${1:prompt_name}(server: SvelteMcp) {",
+			"\tserver.prompt(",
+			"\t\t{",
+			"\t\t\tname: '${1:prompt_name}',",
+			"\t\t\ttitle: '${2:title}',",
+			"\t\t\tdescription:",
+			"\t\t\t\t'${3:llm_description}',",
+			"\t\t\ticons,",
+			"\t\t},",
+			"\t\tasync () => {",
+			"\t\t\treturn {",
+			"\t\t\t\tmessages: [",
+			"\t\t\t\t\t{",
+			"\t\t\t\t\t\trole: 'assistant',",
+			"\t\t\t\t\t\tcontent: {",
+			"\t\t\t\t\t\t\ttype: 'text',",
+			"\t\t\t\t\t\t\ttext: ${1:prompt_name}(),",
+			"\t\t\t\t\t\t},",
+			"\t\t\t\t\t},",
+			"\t\t\t\t],",
+			"\t\t\t};",
+			"\t\t},",
+			"\t);",
+			"}",
+		],
+		"description": "Create a setup export for a prompt generator",
+	},
+}

.vscode/mcp.json

@@ -3,7 +3,7 @@
 		"Svelte MCP": {
 			"type": "stdio",
 			"command": "node",
-			"args": ["dist/lib/stdio.js"]
+			"args": ["packages/mcp-stdio/dist/index.js"]
 		}
 	},
 	"inputs": []

CLAUDE.md

@@ -83,19 +83,18 @@ Located in `src/lib/server/analyze/`:
 
 Required environment variables:
 
-- `DATABASE_URL`: SQLite database path (default: `file:test.db`)
 - `VOYAGE_API_KEY`: API key for embeddings support (optional)
 
 When connected to the svelte-llm MCP server, you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:
 
 ## Available MCP Tools:
 
-### 1. list_sections
+### 1. list-sections
 
 Use this FIRST to discover all available documentation sections. Returns a structured list with titles and paths.
 When asked about Svelte or SvelteKit topics, ALWAYS use this tool at the start of the chat to find relevant sections.
 
-### 2. get_documentation
+### 2. get-documentation
 
 Retrieves full documentation content for specific sections. Accepts single or multiple sections.
-After calling the list_sections tool, you MUST analyze the returned documentation sections and then use the get_documentation tool to fetch ALL documentation sections that are relevant for the users task.
+After calling the list-sections tool, you MUST analyze the returned documentation sections and then use the get_documentation tool to fetch ALL documentation sections that are relevant for the users task.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Svelte Contributors](https://github.com/sveltejs/ai-tools/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -6,12 +6,15 @@ Repo for the official Svelte MCP server.
 
 ```
 pnpm i
-cp .env.example .env
+cp apps/mcp-remote/.env.example apps/mcp-remote/.env
 pnpm dev
 ```
 
 1. Set the VOYAGE_API_KEY for embeddings support
 
+> [!NOTE]
+> Currently to prevent having a bunch of Timeout logs on vercel we shut down the SSE channel immediately. This means that we can't use `server.log` and we are not sending `list-changed` notifications. We can use elicitation and sampling since those are sent on the same stream of the POST request
+
 ### Local dev tools
 
 #### MCP inspector

apps/mcp-remote/.env.example

@@ -1,2 +1 @@
-DATABASE_URL=file:test.db
 VOYAGE_API_KEY=your_actual_api_key_here

apps/mcp-remote/package.json

@@ -0,0 +1,63 @@
+{
+	"name": "@sveltejs/mcp-remote",
+	"version": "0.0.1",
+	"description": "The official Svelte MCP server implementation",
+	"type": "module",
+	"main": "src/index.js",
+	"bin": {
+		"svelte-mcp": "./dist/lib/stdio.js"
+	},
+	"scripts": {
+		"start": "node src/index.js",
+		"dev": "vite dev",
+		"build": "vite build",
+		"build:mcp": "tsc --project tsconfig.build.json",
+		"prepublishOnly": "pnpm build:mcp",
+		"preview": "vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"format": "prettier --write .",
+		"lint": "prettier --check . && eslint .",
+		"lint:fix": "prettier --write . && eslint . --fix",
+		"test:unit": "vitest",
+		"test": "npm run test:unit -- --run",
+		"test:watch": "npm run test:unit -- --watch",
+		"inspect": "pnpm mcp-inspector"
+	},
+	"keywords": [
+		"svelte",
+		"tmcp",
+		"mcp",
+		"server"
+	],
+	"private": true,
+	"devDependencies": {
+		"@eslint/compat": "catalog:lint",
+		"@eslint/js": "catalog:lint",
+		"@modelcontextprotocol/inspector": "catalog:ai",
+		"@sveltejs/adapter-vercel": "catalog:svelte",
+		"@sveltejs/kit": "catalog:svelte",
+		"@sveltejs/vite-plugin-svelte": "catalog:svelte",
+		"@types/node": "catalog:tooling",
+		"@typescript-eslint/parser": "catalog:lint",
+		"eslint-config-prettier": "catalog:lint",
+		"eslint-plugin-svelte": "catalog:lint",
+		"globals": "catalog:lint",
+		"prettier": "catalog:lint",
+		"prettier-plugin-svelte": "catalog:lint",
+		"svelte": "catalog:svelte",
+		"svelte-check": "catalog:svelte",
+		"svelte-eslint-parser": "catalog:lint",
+		"typescript": "catalog:tooling",
+		"vite": "catalog:tooling",
+		"vite-plugin-devtools-json": "catalog:tooling",