# gstack upgrade — v0.16.2.0 → v1.39.2.0

Date: 2026-05-17
Install: global git at `~/.claude/skills/gstack`

## Highlights (spans ~100 releases)

- **Conductor env shim** — `GSTACK_ANTHROPIC_API_KEY` / `GSTACK_OPENAI_API_KEY` flow through to embeddings, paid evals, agent SDK. No more sourcing keys per workspace.
- **Plan-mode ExitPlanMode gate** — `/plan-eng-review`, `/plan-ceo-review`, `/plan-design-review`, `/plan-devex-review`, `/codex review` enforce terminal `## GSTACK REVIEW REPORT` before exit.
- **`/document-generate`** — new Diataxis-based doc generator (tutorial / how-to / reference / explanation). `/document-release` adds Step 1.5 coverage map, diagram-drift detection, CHANGELOG sell-test rubric, `### Documentation Debt` in PR body.
- **Split-engine gbrain** — Path 4 remote MCP + local PGLite. `/setup-gbrain` Steps 1.5/4.5, `/sync-gbrain` Step 1.5 status gates, broken-config rollback.
- **Implementation Tasks + JSONL handoff** — all four review skills end with build-actionable task checklists. `/autoplan` Phase 4 aggregates, dedupes, surfaces near-duplicates.
- **Windows install fix** — 42 `ln -snf` sites routed through `_link_or_copy` helper (`cp -R` on MSYS2/Git Bash). Static invariant test prevents regression.
- **`buildFetchHandler` factory** — browse daemon dispatch composable for gbrowser phoenix overlay. `beforeRoute` hook wired.
- **Surrogate sanitization** — page scrapes survive lone UTF-16 surrogates across HTTP / batch / SSE egress.
- **Linux CI on `ubicloud-standard-8`** everywhere.

## New skills since 0.16.2.0

| Command | Purpose |
|---------|---------|
| `/sync-gbrain` | Keep gbrain current with repo code; refresh CLAUDE.md search guidance |
| `/setup-gbrain` | Install gbrain CLI; init local PGLite or Supabase brain; register MCP |
| `/scrape` | Pull data from a web page; prototypes via `$B` primitives then codifies |
| `/skillify` | Codify last successful `/scrape` into permanent browser-skill |
| `/automate` | Mutating browser flows (form fills, clicks, submissions) |
| `/plan-tune` | Self-tuning question sensitivity + developer psychographic |
| `/context-save` | Save working state across Conductor workspace handoffs |
| `/context-restore` | Restore working context saved earlier (renamed from `/checkpoint resume`) |
| `/document-generate` | Diataxis-based docs from scratch |
| `/landing-report` | Landing page report |
| `/make-pdf` | PDF generation |
| `/benchmark-models` | Model benchmarking |
| `/autoplan` | Auto-review pipeline (CEO + design + eng + DX) |
| `/cso` | Chief Security Officer audit mode |

## Migrations run

- v1.0.0.0 — V1 writing style (glossed jargon, outcome framing)
- v1.1.3.0
- v1.17.0.0
- v1.27.0.0 — `gbrain_sync_mode` → `artifacts_sync_mode` config-key rename
- v1.37.0.0 — Path 4 local-PGLite discoverability notice
- v1.38.1.0 — `.brain-allowlist`, `.brain-privacy-map.json`, `.gitattributes` patch

## Tips

- Run `/plan-tune` to set per-question preferences if any prompts feel noisy.
- New TS entry points that hit Anthropic / OpenAI APIs should add `import "../lib/conductor-env-shim";` as first import.
- Plan-review skills now write per-skill `Implementation Tasks` markdown + `~/.gstack/projects/$SLUG/tasks-{phase}-{datetime}.jsonl` for `/autoplan` handoff.
