Fix Gate plugin cache recovery and active project roots

.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "dukeabaddon-gate-mcp",
+  "interface": {
+    "displayName": "Gate MCP"
+  },
+  "plugins": [
+    {
+      "name": "gatemcp",
+      "source": {
+        "source": "local",
+        "path": "./plugins/gatemcp"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

.gate-mcp/proxy-servers.example.json

@@ -0,0 +1,37 @@
+{
+  "_comment": "Copy this file to .gate-mcp/proxy-servers.json and edit. gatemcp will read it on demand. Format mirrors the IDE's MCP server config — copy-paste from your Cursor/Claude/Windsurf config and it just works.",
+  "servers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_REPLACE_ME"
+      },
+      "description": "GitHub issues, PRs, code search"
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-filesystem",
+        "/path/to/your/project"
+      ],
+      "description": "Read/write project files"
+    },
+    "postgres": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-postgres",
+        "postgresql://user:pass@localhost:5432/db"
+      ],
+      "description": "Postgres query/schema"
+    },
+    "disabled_example": {
+      "command": "npx",
+      "args": ["-y", "some-other-mcp-server"],
+      "disabled": true,
+      "description": "Set disabled=true to hide a server without removing it"
+    }
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,62 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  platform:
+    name: Node ${{ matrix.node }} / ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node: [20, 22, 24, 26]
+        exclude:
+          - os: windows-latest
+            node: 20
+          - os: windows-latest
+            node: 24
+          - os: windows-latest
+            node: 26
+          - os: macos-latest
+            node: 20
+          - os: macos-latest
+            node: 24
+          - os: macos-latest
+            node: 26
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - run: npm run test:production
+      - run: npm run test:security
+      - run: npm run test:storage
+      - run: npm run test:doctor
+
+  acceptance:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 26
+          cache: npm
+      - name: Install npm 12 for acceptance
+        run: |
+          npm install --prefix "$RUNNER_TEMP/npm12" --ignore-scripts npm@12
+          echo "$RUNNER_TEMP/npm12/node_modules/.bin" >> "$GITHUB_PATH"
+      - name: Verify npm 12 install policy
+        run: node -e "const major=Number(require('child_process').execFileSync('npm',['--version'],{encoding:'utf8'}).trim().split('.')[0]); if(major!==12) throw new Error('Expected npm 12, got '+major)"
+      - run: npm ci
+      - run: npm run qa
+      - run: npm run test:plugin
+      - run: npm pack --dry-run

.gitignore

@@ -26,8 +26,15 @@ Thumbs.db
 protocols/
 GEMINI.md
 
-# Gate-MCP runtime data (user-specific)
+# Local npm pack artifacts
+*.tgz
+
+# Gate-MCP runtime data (user-specific) — but commit the proxy example so
+# users can copy it as a starting config without hunting through README.
 .gate-mcp/
+!.gate-mcp/
+.gate-mcp/*
+!.gate-mcp/proxy-servers.example.json
 
 # Gemini/Antigravity session data
 .gemini/
@@ -37,3 +44,22 @@ vendor/
 
 # Graphify output (regenerable via `graphify update .`)
 graphify-out/
+!test-fixtures/**/graphify-out/
+!test-fixtures/**/graphify-out/**
+
+# Internal docs — kept locally, not published to the public repo
+docs/
+documentation/
+
+# Video / pitch scripts (local only — not for public repo)
+DEMO_SCRIPT.md
+DEMO_SCRIPT.*.md
+
+# One-off dev / FAIROS experiment scripts (not part of the shipped product)
+src/exp2-semantic.ts
+src/exp3-toon.ts
+src/measure-schemas.ts
+src/scale-test.ts
+src/scripts/cursor-llm-test.ts
+
+# Last reviewed: 2026-05-17 — public repo = product + tests + documented scripts only.

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Gate-MCP Contributors
+Copyright (c) 2026 Aaron Mecate and Gate-MCP 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