Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
97 lines (72 loc) · 2.57 KB

CONTRIBUTING.md

File metadata and controls

97 lines (72 loc) · 2.57 KB
Raw

Contributing to opencode-windows-encoding

Thanks for your interest in contributing! This is a small, focused plugin — the bar for changes is intentionally high to keep things simple and reliable.

Before You Start

  • Open an issue first for any change beyond a typo fix. This lets us discuss whether the change aligns with the project's scope before you write code.
  • This plugin follows a "do one thing well" philosophy. Features that add configuration complexity will generally be rejected unless the use case is overwhelmingly common.

Development Setup

# Clone and install
git clone https://github.com/Cle2ment/opencode-windows-encoding.git
cd opencode-windows-encoding
npm install
# Type check
npm run typecheck

# Build
npm run build

# Watch mode (auto-rebuild on change)
npm run dev

Project Structure

src/
├── encoding-core.ts  # Shared core — encoding map / shell detection / prefix injection
└── index.ts          # V2 entry — default export { id, setup } (shell create.before hook)

The entry bundles the shared core inline and builds to a self-contained dist/index.js.

Code Style

  • Strict TypeScript — tsconfig.json enforces strict mode. No as any, no @ts-ignore.
  • Zero npm runtime dependencies — the plugin uses only Node.js built-ins (node:fs, node:os, node:path). @opencode/plugin is import type only (compile-time, erased from output).
  • Match existing patterns — follow the code already in src/index.ts.
  • Debug logging goes to $TMP/utf8-plugin.log and is gated behind OPENCODE_UTF8_DEBUG=1.

Commit Messages

Follow Conventional Commits:

  • feat: — new feature
  • fix: — bug fix
  • docs: — documentation only
  • ci: — CI/CD changes
  • chore: — maintenance

Local Testing

Reference the source file directly in your opencode.jsonc:

{
  "plugins": [
    "/path/to/opencode-windows-encoding/src/index.ts"
  ]
}

Then exercise the plugin by running shell commands in OpenCode. Enable debug logs to inspect behavior:

$env:OPENCODE_UTF8_DEBUG = "1"

Pull Request Process

  1. Fork the repo and create a branch.
  2. Make your changes, keeping them minimal and focused.
  3. Run npm run typecheck and npm run build — both must pass.
  4. Open a PR against main. Include:
    • What problem the change solves
    • How you tested it
    • Any breaking changes or considerations

License

By contributing, you agree that your contributions will be licensed under the AGPL-3.0.