gsd-pi 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,39 @@
+Business Source License 1.1
+
+Licensor: Lex Christopherson
+Licensed Work: GSD (gsd-pi)
+Additional Use Grant: None
+Change Date: 2029-03-10
+Change License: MIT
+
+Parameters
+
+Licensor: Lex Christopherson
+Licensed Work: The Licensed Work is (c) 2026 Lex Christopherson
+
+Use Limitation: You may not use the Licensed Work for a Commercial Purpose.
+A "Commercial Purpose" means use in a commercial product or service, or use 
+on behalf of a for-profit entity, unless you have received a separate 
+commercial license from the Licensor.
+
+On the Change Date, or the fourth anniversary of the first publicly available 
+distribution of a specific version of the Licensed Work under this License, 
+whichever comes first, the Licensor grants you rights under the terms of the 
+Change License, and the rights granted in the paragraph above terminate.
+
+For purposes of this License:
+
+"Commercial Purpose" means use intended for or directed toward commercial 
+advantage or monetary compensation.
+
+The Licensor may make additional grants beyond those described above. Any 
+additional grants will be described in the Additional Use Grant above.
+
+Notice
+
+The Business Source License (this document, or the "License") is not an 
+Open Source license. However, the Licensed Work will eventually be made 
+available under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.

package/README.md

@@ -4,6 +4,11 @@
 
 **The evolution of [Get Shit Done](https://github.com/glittercowboy/get-shit-done) — now a real coding agent.**
 
+[![npm version](https://img.shields.io/npm/v/gsd-pi?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/gsd-pi)
+[![npm downloads](https://img.shields.io/npm/dm/gsd-pi?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/gsd-pi)
+[![GitHub stars](https://img.shields.io/github/stars/glittercowboy/gsd-pi?style=for-the-badge&logo=github&color=181717)](https://github.com/glittercowboy/gsd-pi)
+[![License](https://img.shields.io/badge/license-BSL%201.1-blue?style=for-the-badge)](LICENSE)
+
 The original GSD went viral as a prompt framework for Claude Code. It worked, but it was fighting the tool — injecting prompts through slash commands, hoping the LLM would follow instructions, with no actual control over context windows, sessions, or execution.
 
 This version is different. GSD is now a standalone CLI built on the [Pi SDK](https://github.com/nicholasgasior/pi-coding-agent), which gives it direct TypeScript access to the agent harness itself. That means GSD can actually *do* what v1 could only *ask* the LLM to do: clear context between tasks, inject exactly the right files at dispatch time, manage git branches, track cost and tokens, detect stuck loops, recover from crashes, and auto-advance through an entire milestone without human intervention.
@@ -11,7 +16,7 @@ This version is different. GSD is now a standalone CLI built on the [Pi SDK](htt
 One command. Walk away. Come back to a built project with clean git history.
 
 ```bash
-npm install -g @glittercowboy/gsd
+npm install -g gsd-pi
 gsd
 ```
 
@@ -113,49 +118,57 @@ The wizard is the on-ramp. Auto mode is the highway.
 
 ## Getting Started
 
-### Install
-
-```bash
-npm install -g @glittercowboy/gsd
-```
-
-Requires Node.js ≥ 20.6.0. Installs Chromium via Playwright for browser-based verification (non-fatal if it fails).
-
-### First Run
+### Install and run
 
 ```bash
+npm install -g gsd-pi
 cd your-project
 gsd
 ```
 
-On first launch, GSD prompts for optional API keys:
-- **Brave Search** — for web research during planning
-- **Context7** — for up-to-date library documentation
-- **Jina** — for web page content extraction
+That's it. GSD walks you through describing what you want to build, creates a roadmap, and starts working. When you're ready to let it run autonomously:
 
-All optional. Press Enter to skip any. Keys are stored in `~/.gsd/agent/auth.json` and loaded automatically on subsequent launches.
+```
+/gsd auto
+```
 
-### Start Building
+Walk away. Come back to a built project with clean git history.
 
-The wizard walks you through describing what you want to build. Once you approve the roadmap:
+### The two-terminal workflow
 
-```
+GSD is designed for you to keep working while it builds. Open two terminals in the same project:
+
+**Terminal 1 — auto mode (let it run)**
+```bash
+gsd
 /gsd auto
 ```
 
-Walk away. GSD will research, plan, execute, verify, commit, and advance through every slice until the milestone is complete.
+**Terminal 2 — steer while it works**
+```bash
+gsd
+/gsd discuss    # talk through architecture decisions
+/gsd status     # check progress
+/gsd queue      # queue the next milestone
+```
+
+Auto mode reads state from `.gsd/` files on disk. Your discussions and decisions in terminal 2 are picked up automatically at the next phase boundary. You don't need to stop auto mode to influence what it does next.
+
+### First launch
+
+On first run, GSD prompts for optional API keys (Brave Search, Context7, Jina) for web research and documentation tools. All optional — press Enter to skip. Keys are stored in `~/.gsd/agent/auth.json`.
 
 ### Commands
 
 | Command | What it does |
 |---------|-------------|
 | `/gsd` | Contextual wizard — reads state, shows what's next |
-| `/gsd auto` | Start auto mode (fresh session per unit, loops until done) |
+| `/gsd auto` | Autonomous mode — researches, plans, executes, commits, repeats |
 | `/gsd stop` | Stop auto mode gracefully |
-| `/gsd status` | Progress dashboard overlay |
+| `/gsd discuss` | Discuss architecture and decisions (works alongside auto mode) |
+| `/gsd status` | Progress dashboard |
 | `/gsd queue` | Queue future milestones (safe during auto mode) |
-| `/gsd discuss` | Discuss implementation decisions before planning |
-| `/gsd prefs` | Manage skill preferences (global/project) |
+| `/gsd prefs` | Model selection, timeouts, budget ceiling |
 | `/gsd doctor` | Validate `.gsd/` integrity, find and fix issues |
 | `Ctrl+Alt+G` | Toggle dashboard overlay |
 
@@ -315,8 +328,8 @@ gsd (CLI binary)
 
 ## Requirements
 
-- **Node.js** ≥ 20.6.0
-- **Anthropic API key** — handled by Pi's built-in auth flow on first launch
+- **Node.js** ≥ 20.6.0 (22+ recommended)
+- **An LLM provider** — any of the 20+ supported providers (see [Use Any Model](#use-any-model))
 - **Git** — initialized automatically if missing
 
 Optional:
@@ -326,9 +339,41 @@ Optional:
 
 ---
 
+## Use Any Model
+
+GSD isn't locked to one provider. It runs on the [Pi SDK](https://github.com/nicholasgasior/pi-coding-agent), which supports **20+ model providers** out of the box. Use different models for different phases — Opus for planning, Sonnet for execution, a fast model for research.
+
+### Built-in Providers
+
+Anthropic, OpenAI, Google (Gemini), OpenRouter, GitHub Copilot, Amazon Bedrock, Azure OpenAI, Google Vertex, Groq, Cerebras, Mistral, xAI, HuggingFace, Vercel AI Gateway, and more.
+
+### OAuth / Max Plans
+
+If you have a **Claude Max**, **Codex**, or **GitHub Copilot** subscription, you can use those directly — Pi handles the OAuth flow. No API key needed.
+
+### OpenRouter
+
+[OpenRouter](https://openrouter.ai) gives you access to hundreds of models through a single API key. Use it to run GSD with Llama, DeepSeek, Qwen, or anything else OpenRouter supports.
+
+### Per-Phase Model Selection
+
+In your preferences (`/gsd prefs`), assign different models to different phases:
+
+```yaml
+models:
+  research: openrouter/deepseek/deepseek-r1
+  planning: claude-opus-4-6
+  execution: claude-sonnet-4-6
+  completion: claude-sonnet-4-6
+```
+
+Use expensive models where quality matters (planning, complex execution) and cheaper/faster models where speed matters (research, simple completions). GSD tracks cost per-model so you can see exactly where your budget goes.
+
+---
+
 ## License
 
-MIT
+[Business Source License 1.1](LICENSE)
 
 ---
 
@@ -336,6 +381,6 @@ MIT
 
 **The original GSD showed what was possible. This version delivers it.**
 
-**`npm install -g @glittercowboy/gsd && gsd`**
+**`npm install -g gsd-pi && gsd`**
 
 </div>

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "gsd-pi",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "GSD — Get Stuff Done coding agent",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/glittercowboy/gsd-pi.git"
+  },
+  "homepage": "https://github.com/glittercowboy/gsd-pi#readme",
+  "bugs": {
+    "url": "https://github.com/glittercowboy/gsd-pi/issues"
+  },
   "type": "module",
   "bin": {
     "gsd": "dist/loader.js"
@@ -24,6 +33,7 @@
   "scripts": {
     "build": "tsc && npm run copy-themes",
     "copy-themes": "node -e \"const{mkdirSync,cpSync}=require('fs');const{resolve}=require('path');const src=resolve(__dirname,'node_modules/@mariozechner/pi-coding-agent/dist/modes/interactive/theme');mkdirSync('pkg/dist/modes/interactive/theme',{recursive:true});cpSync(src,'pkg/dist/modes/interactive/theme',{recursive:true})\"",
+    "test": "node --import ./src/resources/extensions/gsd/tests/resolve-ts.mjs --experimental-strip-types --test 'src/resources/extensions/gsd/tests/*.test.ts' 'src/resources/extensions/gsd/tests/*.test.mjs' 'src/tests/*.test.ts'",
     "dev": "tsc --watch",
     "postinstall": "node scripts/postinstall.js",
     "prepublishOnly": "npm run build"