branches and pull requests. Uses Cobra for commands, bubbletea/lipgloss for TUI, and `stretchr/testify` for tests.
## Build and validate
```sh
go mod download # install deps
go build -o gh-stack . # build
always a bug; changes to `SessionSource` require coordinated updates in the registry, fixtures, and tests
## Code Quality
- Biome handles all formatting and style — do not introduce ESLint, Prettier, or TSLint
Having fallbacks creates very confusing program behavior.
When you want to run a test - always run the most specific test you want to run. Don't run all or other
PICT Repository Development Guidelines
Comprehensive instructions for developing in the PICT (Pairwise Independent Combinatorial Testing) repository
## Project Overview
PICT (Pairwise Independent Combinatorial Testing) is a Microsoft open-source command-line
from names.
- Follow any matching file-scoped instructions under `.github/instructions/`.
- Inspect nearby code and tests before editing. Reuse existing abstractions and error types.
- Do not hand-edit generated files
code is DRY, and doesn't replicate the same or similar code
- for test cases, ensure a data-driven approach is being used rather than lots of repetitive test code
Packages
- Functions and methods
- Types and interfaces
- Exported variables and constants
- Write unit tests for core functionality
- Keep functions focused and manageable (generally under 50 lines)
- Use error handling patterns
this **once** at the start of any session before `go build`, `go test`, or `golangci-lint run`.
### 2. Never restage a regenerated `web/dist/index.html`
`web/dist/assets/*` is gitignored but `web/dist/index.html` **is tracked
Vert.x-based messaging and event handling infrastructure
- `sample/` - Example usage and sample applications
- `IT/` - Integration tests
- `gclogs/` - Test data and sample GC logs
## Key Technologies
- **Java 21+** with module system (module-info.java
documentation is up to date
- Check if examples are up to date
- Check if tests are comprehensive and cover all critical paths
## Repository Overview
@../AGENTS.md
Notebooks. The project uses a modern Python build system with hatch, and includes comprehensive testing, linting, and documentation.
## Working Effectively
### Environment Setup
- **Python Requirements**: Python 3.10 or higher (tested with
SpellCheck.ps1`. Use: `"Use the code-creator agent to create a new function"`
- **pester-test** — Creates Pester tests following repo patterns and performance rules. Use: `"Use the pester-test agent
yarn --version` should show 4.3.1)
- Uses Nx monorepo for task orchestration
### Bootstrap, Build, and Test
**CRITICAL: NEVER CANCEL long-running commands. Set timeouts appropriately.**
```bash
# Install dependencies - takes ~2 minutes
import VERSION
from ...core.types import Message
from ..openai.executor import _build_options, _message_to_wire
```
- **Tests use absolute imports** from the package:
```python
from prompty.core.types import Message, TextPart
from prompty.providers.openai.executor import