oc-pilot 0.0.0-stage → 0.5.1

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+## 0.5.1
+
+- `setup` теперь поддерживает **ZCode** (Z.ai): project `.zcode/config.json` и global `~/.zcode/cli/config.json`, ключ `mcp.servers`.
+- Добавлен универсальный клиент `agents`: project `.agents/mcp.json` и global `~/.agents/mcp.json`, ключ `mcpServers`. Этот формат читает ZCode как fallback и другие MCP-клиенты.
+- `doctor` распознаёт ZCode и `.agents` конфиги.
+- README EN/RU и `docs/integrations.md` обновлены: Claude Code, DeepSeek Harness, ZCode, `.agents`, generic MCP.
+- 112 тестов; версия 0.5.1.
+
+## 0.5.0
+
+- Добавлен движок `openai`: любой OpenAI-совместимый `/chat/completions` (OpenAI, DeepSeek, Groq, OpenRouter, Ollama). OpenCode больше не обязателен.
+- Новые флаги `--engine`, `--base-url`, `--api-key-env`; конфиг `engine`, `baseUrl`, `apiKeyEnv`; env `OC_PILOT_ENGINE`, `OC_PILOT_BASE_URL`, `OC_PILOT_API_KEY_ENV`. Ключ читается из `OC_PILOT_API_KEY`/`OPENAI_API_KEY` и не попадает в ошибки.
+- Для движка `openai` автоматически включается `FULL_FILE_CONTEXT`, а инструменты репозитория отключаются.
+- Добавлена команда `oc-pilot doctor`: проверяет Node, движок, ключ, git, тестовую команду, MCP-конфиги и правила; `--json`, exit 1 при ошибках, `--strict` для предупреждений.
+- `oc-pilot setup` без `--client` сам находит установленные Claude Code, Codex, Cursor, Gemini CLI, OpenCode, VS Code и Windsurf.
+- Добавлен composite GitHub Action `action.yml` для PR-гейта в три строки.
+- README EN/RU и `docs/integrations.md` обновлены: движки, doctor, авто-настройка, Action.
+- 111 тестов; версия 0.5.0.
+
+## 0.4.3
+
+- Fixed remote MCP config shapes: Gemini uses `httpUrl`, Windsurf uses `serverUrl`.
+- `setup --http --token` for Gemini now stops with an explanation instead of writing a header that Gemini does not expand.
+- 103 теста; версия 0.4.3.
+
+## 0.4.2
+
+- `fix` scans only added lines in the proposed patch. A patch that removes a leaked secret is no longer rejected as if it added one.
+- `setup` no longer writes the unsupported `enabled` field into OpenCode MCP config; servers are enabled by default in OpenCode V2.
+- `setup --http --token` now writes an `OC_PILOT_MCP_TOKEN` reference instead of the secret itself.
+- User-journey verification: GitHub install, `scan`, real `review`, `test-fix`, `fix --apply` with tests, MCP stdio, Claude/Codex/OpenCode setup.
+- 101 тест; версия 0.4.2.
+
+## 0.4.1
+
+- MCP-сервер теперь **read-only по умолчанию** и для stdio, и для HTTP: `fix` с `apply:true` и `test_fix`, запускающий новую команду, требуют явного `--allow-write`.
+- `oc-pilot setup --allow-write` добавляет этот флаг в конфиг клиента; без него агент получает только анализ и предложение патча.
+- Уточнены SECURITY.md, README и `docs/integrations.md`: безопасные значения по умолчанию, доверенный локальный клиент, TLS и токен для HTTP.
+- 100 тестов; версия 0.4.1.
+
+## 0.4.0
+
+- Добавлена команда `oc-pilot setup` для Claude Code, Codex, Cursor, Gemini CLI и OpenCode: `--local/--global`, `--print`, `--json`, `--http/--token`, сохранение чужих серверов и настроек.
+- `oc-pilot-mcp` получил Streamable HTTP транспорт (`--http`, `--host`, `--port`, `--path`, `--token`, `/health`, `Mcp-Session-Id`) для контейнеров и удалённых агентов.
+- Добавлена команда `fix`: модель предлагает unified diff, патч проверяется через `git apply --check`, применяется с `--apply`, тесты запускаются автоматически, при падении патч откатывается; `--keep-on-test-failure`, `--no-tests`, `--rounds`.
+- MCP-инструмент `fix` с `apply`, `command`, `no_tests`, `rounds`.
+- `--github` печатает inline-аннотации GitHub Actions (`::error` / `::warning`) для `review` и `fix`.
+- Добавлены `Dockerfile`, `docker-compose.yml`, `.dockerignore`; образ включает OpenCode и запускает HTTP MCP на порту 8787.
+- Добавлен Agent Skill `skills/oc-pilot/SKILL.md` и `server.json` для MCP Registry.
+- Добавлены `oc-pilot mcp`, read-only HTTP по умолчанию, `--allow-write`, проверка токена и ограничение путей; CI/CodeQL/release workflows, `SECURITY.md`, поддержка DeepSeek Harness.
+- `dist` коммитится в репозиторий, поэтому установка из GitHub-тега не требует devDependencies: `npm install -g https://github.com/MyNameIsNikki/oc-pilot/archive/refs/tags/v0.4.0.tar.gz`. Docker runtime использует `--ignore-scripts`.
+- Обновлены README, `README.ru.md`, `docs/integrations.md`; 99 тестов.
+
+## 0.3.0
+
+- Английский системный промпт стал языком по умолчанию для глобальной аудитории; добавлены `--lang en|ru`, `OC_PILOT_LANG` и `lang` в конфиге. Русский промпт сохранён.
+- Добавлен MCP-сервер `oc-pilot-mcp` (stdio, JSON-RPC 2.0) с инструментами `review`, `test_fix`, `docgen`, `custom`, `scan` для Claude Code, Codex, Cursor, Gemini CLI и OpenCode.
+- Добавлена интеграционная документация `docs/integrations.md` и разделы MCP в README.
+- README переведён на английский как основной; русская версия — `README.ru.md`.
+- Промпты разделены на `prompts/oc-pilot.en.md` и `prompts/oc-pilot.ru.md`; `.opencode/agents/oc-pilot.md` использует английский промпт.
+- `--no-secret-scan` теперь также отключает сканирование `PROJECT_RULES` и `FULL_FILE_CONTEXT`.
+- Добавлены тесты MCP и двуязычных промптов; версия 0.3.0.
+
+## 0.2.0
+
+- Встроенный агент `oc-pilot` теперь работает с read-only контекстом репозитория: `read`, `glob`, `grep`; изменение файлов, shell, web и внешние директории запрещены.
+- Добавлен `--no-repo-context` для изолированного diff-only режима. В нём изменённые файлы передаются как `FULL_FILE_CONTEXT` с redaction.
+- Добавлены структурированные `findings` в JSON и флаг `--fail-on critical|warning|style` для CI.
+- Добавлены правила проекта `.oc-pilot/rules.md` (автопоиск вверх по дереву, `--rules`, `rules` в конфиге).
+- Расширен сканер секретов: Hugging Face, Groq, Discord, SendGrid, DigitalOcean, PyPI, Azure Storage, `.env`-присваивания.
+- Новые настройки: `repoContext`, `failOn`, `rules` и переменные `OC_PILOT_REPO_CONTEXT`, `OC_PILOT_FAIL_ON`, `OC_PILOT_RULES`.
+- Обновлены README, промпт и конфигурация агента.
+
+## 0.1.0
+
+- Первый релиз: `review`, `test-fix`, `docgen`, `custom`, `scan`, `init`.

package/CONTRIBUTING.md

@@ -0,0 +1,43 @@
+# Contributing
+
+## Development
+
+```bash
+git clone https://github.com/MyNameIsNikki/oc-pilot.git
+cd oc-pilot
+npm install
+npm run check
+npm test
+```
+
+Requirements: Node.js 22+, Git, and OpenCode 2.x for live model calls. The test suite uses a fake `opencode` executable and does not need credentials.
+
+## Pull requests
+
+- Keep the CLI and MCP behavior in sync. A new command option usually needs an MCP tool argument.
+- Add a regression test for every bug fix. Tests live next to the code in `src/**/*.test.ts`.
+- Do not add runtime dependencies without a security and size justification. The package intentionally ships with none.
+- Do not log prompts, diffs, tokens, or provider responses in production paths. Use the existing `log` helpers.
+- Preserve the bilingual prompt contract. Model-facing English is the default; Russian is selected with `--lang ru`.
+- Run `npm run prompt:export` after changing `src/core/prompt.ts`.
+
+## Security-sensitive changes
+
+Changes to secret detection, redaction, the read-only agent permissions, patch application, MCP HTTP authentication, or path confinement need:
+
+- negative tests (what must be rejected);
+- updates to `SECURITY.md` when the trust model changes;
+- a note in `CHANGELOG.md`.
+
+## Release
+
+Releases are tag-driven. Set `NPM_TOKEN` in GitHub Actions secrets, then:
+
+```bash
+npm version patch --no-git-tag-version
+git commit -am "release: vX.Y.Z"
+git tag vX.Y.Z
+git push origin main --tags
+```
+
+The release workflow checks that the tag matches `package.json`, runs the full suite, and publishes with npm provenance.

package/Dockerfile

@@ -0,0 +1,32 @@
+FROM node:22-bookworm-slim AS build
+WORKDIR /app
+COPY package.json package-lock.json tsconfig.json ./
+COPY src ./src
+RUN npm ci
+RUN npm run build
+
+FROM node:22-bookworm-slim
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends git ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+RUN npm install -g opencode-ai
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev --ignore-scripts
+COPY --from=build /app/dist ./dist
+COPY prompts ./prompts
+COPY docs ./docs
+COPY skills ./skills
+COPY README.md README.ru.md LICENSE server.json ./
+
+ENV NODE_ENV=production \
+    OC_PILOT_MCP_HOST=0.0.0.0 \
+    OC_PILOT_MCP_PORT=8787 \
+    OC_PILOT_MCP_PATH=/mcp
+
+WORKDIR /workspace
+EXPOSE 8787
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD node -e "fetch('http://127.0.0.1:8787/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
+
+CMD ["node", "/app/dist/mcp.js", "--http", "--host", "0.0.0.0", "--port", "8787", "--path", "/mcp", "--cwd", "/workspace"]

package/LICENSE

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