docs: add LICENSE, CONTRIBUTING guide, and GitHub issue templates

* feat: expand tests, add ESLint, document env vars

- Add 17 new integration tests: CORS edge cases (disallowed origins,
  no-origin header, OPTIONS for disallowed origin), auth (401/pass-through),
  and error handling (400/502/404) for /v1/chat/completions
  Closes #14, closes #16
- Add ESLint with flat config, npm run lint script, and Lint job in CI
  Closes #15
- Improve README with quickstart section, npm install instructions, and
  corrected package name; add type column to env vars table
  Closes #17

* feat: implement SSE streaming and support all opencode providers

- Implement streaming for POST /v1/chat/completions (issue #11):
  subscribe to opencode event stream, pipe message.part.updated deltas
  as SSE chat.completion.chunk events, finish on session.idle
- Implement streaming for POST /v1/responses (issue #11):
  emit response.created / output_text.delta / response.completed events
- Fix provider-agnostic system prompt hint (issue #12): remove
  'OpenAI-compatible' wording so non-OpenAI models are not confused
- Add TextEncoder and ReadableStream to ESLint globals
- Add streaming integration tests (happy path, unknown model, session.error)

* feat: refactor SSE queue, expand test coverage, fix package metadata

- Extract createSseQueue() helper, eliminating duplicated SSE queue pattern
  in /v1/chat/completions and /v1/responses streaming branches (closes #34)
- Add tests for GET /v1/models happy path, empty providers, and error path (closes #33)
- Add tests for POST /v1/responses: happy path, validation, streaming, session.error (closes #32)
- Fix package.json description to be provider-agnostic (closes #35)
- Add engines field declaring bun >=1.0.0 requirement (closes #35)
- Line coverage: 55% -> 89%, function coverage: 83% -> 94%

* feat: add Anthropic Messages API and Google Gemini API endpoints

- POST /v1/messages — Anthropic Messages API with streaming (SSE)
- POST /v1beta/models/:model:generateContent — Gemini non-streaming
- POST /v1beta/models/:model:streamGenerateContent — Gemini NDJSON streaming
- New helpers: normalizeAnthropicMessages, normalizeGeminiContents,
  extractGeminiSystemInstruction, mapFinishReasonToAnthropic/Gemini
- 35 new tests (77 -> 112 total, all passing)
- Update README to document all supported API formats

Closes #38, #39

* docs: rewrite README and expand package keywords for discoverability

- Lead with value proposition, ASCII diagram, and feature table
- Quickstart reduced to 4 steps; works in under 60 seconds
- SDK examples for OpenAI, Anthropic, Gemini (JS+Python), LangChain
- UI integration guides: Open WebUI, Chatbox, Continue, Zed
- Reference section kept concise; full prose docs moved inline
- package.json: sharper description, 20 keywords covering all search terms
  (openai-compatible, anthropic, gemini, ollama, langchain, open-webui,
   llm-proxy, ai-gateway, local-llm, github-copilot, model-router, …)

* fix: remove pretty-printing from JSON responses to reduce payload size

* fix: reflect request Origin header in CORS allow-origin when a specific origin is configured

* docs: add LICENSE, CONTRIBUTING guide, and GitHub issue templates

Author: KochC

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,65 @@
+name: Bug report
+description: Something isn't working as expected
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please fill in as much detail as you can.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: A clear description of the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: How do we reproduce the issue?
+      placeholder: |
+        1. Start opencode with the plugin loaded
+        2. Send a request to POST /v1/chat/completions with ...
+        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: request
+    attributes:
+      label: Request / response (if applicable)
+      description: Paste the curl command or request body and the response you received.
+      render: bash
+
+  - type: input
+    id: version
+    attributes:
+      label: opencode-llm-proxy version
+      placeholder: "e.g. 1.6.1"
+    validations:
+      required: true
+
+  - type: input
+    id: runtime
+    attributes:
+      label: Runtime and OS
+      placeholder: "e.g. Node.js 22, macOS 14 / Bun 1.2, Ubuntu 24.04"
+    validations:
+      required: true
+
+  - type: input
+    id: provider
+    attributes:
+      label: Provider / model
+      placeholder: "e.g. github-copilot/claude-sonnet-4.6"

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,43 @@
+name: Feature request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion! Please describe the use case clearly so we can understand what you need.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the situation where this would be useful.
+      placeholder: "e.g. I use the Vercel AI SDK and currently have to..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What would you like to see added or changed?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives you've considered
+      description: Any workarounds you're using today?
+
+  - type: dropdown
+    id: api_format
+    attributes:
+      label: Which API format does this relate to? (if any)
+      options:
+        - OpenAI Chat Completions
+        - OpenAI Responses API
+        - Anthropic Messages API
+        - Google Gemini
+        - All / general
+        - Not API-format specific

CONTRIBUTING.md

@@ -0,0 +1,82 @@
+# Contributing
+
+Thanks for your interest in contributing to opencode-llm-proxy.
+
+## Getting started
+
+```bash
+git clone https://github.com/KochC/opencode-llm-proxy.git
+cd opencode-llm-proxy
+npm install
+```
+
+Run the tests:
+
+```bash
+npm test
+```
+
+Run the linter:
+
+```bash
+npm run lint
+```
+
+## How to contribute
+
+### Reporting bugs
+
+Open a [bug report](https://github.com/KochC/opencode-llm-proxy/issues/new?template=bug_report.yml). Include:
+
+- What you did
+- What you expected
+- What actually happened
+- Your Node.js / Bun version and OS
+
+### Suggesting features
+
+Open a [feature request](https://github.com/KochC/opencode-llm-proxy/issues/new?template=feature_request.yml) describing the use case.
+
+### Submitting a pull request
+
+1. Fork the repo and create a branch from `dev` (not `main`)
+2. Make your changes
+3. Add or update tests in `index.test.js` — all 112+ tests must pass
+4. Lint passes: `npm run lint`
+5. Commit using [Conventional Commits](https://www.conventionalcommits.org/):
+   - `fix:` for bug fixes (triggers a patch release)
+   - `feat:` for new features (triggers a minor release)
+   - `docs:` / `chore:` / `test:` for everything else (no release)
+6. Open a PR against the `dev` branch
+
+## Branch model
+
+```
+dev  ──►  main  ──►  npm (via Release Please)
+```
+
+- All work goes on `dev`
+- `main` is release-only — only Release Please PRs merge directly there
+- Do not open PRs against `main`
+
+## Tests
+
+Tests use the Node.js built-in test runner — no external framework needed.
+
+```bash
+node --test                          # run once
+node --test --watch                  # watch mode
+node --test --experimental-test-coverage  # with coverage
+```
+
+Tests mock the OpenCode SDK client entirely — no real LLM calls are made.
+
+## Code style
+
+ESLint enforces style. Run `npm run lint` before pushing. The config is in `eslint.config.js`.
+
+Key conventions in the codebase:
+
+- Pure functions are exported for testability (`normalizeMessages`, `buildPrompt`, etc.)
+- Each API format (OpenAI, Anthropic, Gemini) has its own section in `index.js`
+- Error responses mirror the format of the target API (OpenAI errors for `/v1/*`, Anthropic errors for `/v1/messages`, etc.)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KochC
+
+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.