gitspace 0.2.0-rc.2 → 0.2.0-rc.21

package/README.md

@@ -20,7 +20,6 @@ The following tools must be installed and available in your PATH:
 - [GitHub CLI (`gh`)](https://cli.github.com/) - for listing repositories
 - [Git](https://git-scm.com/) - for worktree management
 - [jq](https://stedolan.github.io/jq/) - for JSON processing
-- [Bun](https://bun.sh) - runtime for the CLI
 
 **GitHub Authentication**: You must authenticate the GitHub CLI before using GitSpace:
 
@@ -31,7 +30,17 @@ gh auth login
 ## Installation
 
 ```bash
-bun install -g https://github.com/inkibra/gitspace.sh
+# npm
+npm install -g gitspace
+
+# bun
+bun install -g gitspace
+
+# pnpm
+pnpm install -g gitspace
+
+# yarn
+yarn global add gitspace
 
 # Verify installation
 gssh --version
@@ -97,6 +106,22 @@ gssh switch
 gssh switch my-feature
 ```
 
+### Workspace Session Mode (`space`)
+
+When GitSpace opens a workspace-scoped terminal session, it injects a `space` shell function (bash/zsh).
+
+- Use `space ...` for workspace operations without repeating `--project` and `--workspace`
+- `gssh` commands are restricted in this mode to avoid cross-workspace mistakes
+- `gssh tmux ...` is blocked inside workspace sessions
+
+Examples:
+
+```bash
+space context --json
+space review hunks src/app.ts --format json
+space review add-hunk src/app.ts --index 1 --approve --body "Looks good"
+```
+
 ## Repo Config Bundles
 
 Repo config bundles allow repository owners to share onboarding configurations with their team. When someone clones a project that contains a bundle, they'll be guided through setup steps and have scripts automatically installed.
@@ -108,14 +133,15 @@ A bundle is a directory (typically `.gitspace/`) containing:
 ```
 .gitspace/
 ├── bundle.json           # Bundle manifest with onboarding steps
-├── pre/                  # Scripts to run before setup
-│   └── 01-copy-env.sh
-├── setup/                # Scripts to run on first workspace creation
-│   └── 01-install-deps.sh
-├── select/               # Scripts to run every time workspace is opened
-│   └── 01-status.sh
-└── remove/               # Scripts to run before workspace deletion
-    └── 01-cleanup.sh
+└── scripts/
+    ├── pre/              # Deprecated: migrate scripts into ordered setup/
+    │   └── 01-copy-env.sh
+    ├── setup/            # Scripts for setup runs (when bundle/value state changes)
+    │   └── 01-install-deps.sh
+    ├── select/           # Scripts to run on each new terminal attach
+    │   └── 01-status.sh
+    └── remove/           # Scripts to run before workspace deletion
+        └── 01-cleanup.sh
 ```
 
 ### Bundle Manifest (`bundle.json`)
@@ -170,27 +196,27 @@ A bundle is a directory (typically `.gitspace/`) containing:
 
 ### Using Bundle Values in Scripts
 
-Bundle values are passed to scripts as environment variables:
+Bundle values are passed to scripts as environment variables using the configured bundle keys:
 
-- `SPACE_VALUE_<KEY>` - Regular values from input steps
-- `SPACE_SECRET_<KEY>` - Secret values from secret steps (fetched from OS keychain)
+- `<KEY>` - Regular or secret value using the exact `configKey` from `bundle.json`
+- `<NORMALIZED_KEY>` - Uppercase snake-case alias (for example, `teamName` -> `TEAM_NAME`)
 
 **Example script:**
 
 ```bash
 #!/bin/bash
-# .gitspace/select/01-status.sh
+# .gitspace/scripts/select/01-status.sh
 
 WORKSPACE_NAME=$1
 REPOSITORY=$2
 
 # Access bundle values
-if [ -n "$SPACE_VALUE_TEAMNAME" ]; then
-  echo "Welcome, $SPACE_VALUE_TEAMNAME team!"
+if [ -n "$TEAM_NAME" ]; then
+  echo "Welcome, $TEAM_NAME team!"
 fi
 
 # Access secrets (stored securely in OS keychain)
-if [ -n "$SPACE_SECRET_APIKEY" ]; then
+if [ -n "$API_KEY" ]; then
   echo "API Key configured"
 fi
 ```
@@ -199,7 +225,7 @@ fi
 
 Bundles can be loaded from:
 
-1. **In-repo** (automatic): `.gitspace/`, `.gitspace-config/`, `.spaces-config/`, or `.spaces/` in the cloned repository
+1. **In-repo** (automatic): `.gitspace/` directory in the cloned repository
 2. **Local path**: `gssh add project --bundle-path /path/to/bundle/`
 3. **Remote URL**: `gssh add project --bundle-url https://example.com/bundle.zip`
 
@@ -347,14 +373,16 @@ Located at `~/gitspace/<project-name>/.config.json`:
 
 ### Custom Scripts
 
-GitSpace uses **convention over configuration** for custom scripts:
+GitSpace uses **convention over configuration** for custom scripts. Scripts live
+inside each workspace so they can vary by branch:
 
 ```
-~/gitspace/<project-name>/scripts/
-├── pre/           # Run before setup (terminal)
-├── setup/         # Run once on workspace creation
-├── select/        # Run every time workspace is opened
-└── remove/        # Run before workspace deletion
+~/gitspace/<project-name>/workspaces/<workspace-name>/.gitspace/
+└── scripts/
+    ├── pre/       # Deprecated: run before setup (migrate to setup/)
+    ├── setup/     # Run when setup state requires refresh
+    ├── select/    # Run on each new terminal attach
+    └── remove/    # Run before workspace deletion
 ```
 
 #### Script Execution Rules
@@ -363,15 +391,15 @@ GitSpace uses **convention over configuration** for custom scripts:
 2. Scripts run **alphabetically** (use `01-`, `02-` prefixes)
 3. **Working directory**: The workspace directory
 4. **Arguments**: `$1` = workspace name, `$2` = repository name
-5. **Environment**: Bundle values available as `SPACE_VALUE_*` and `SPACE_SECRET_*`
+5. **Environment**: Bundle values available by key name (for example `REGION`, `PULUMI_ACCESS_TOKEN`)
 
 #### Script Phases
 
 | Phase | When | Use Case |
 |-------|------|----------|
-| `pre/` | Once, before setup | Copy .env files, create directories |
-| `setup/` | Once, on workspace creation | Install dependencies, initial build |
-| `select/` | Every workspace open | Git fetch, status checks |
+| `pre/` | Deprecated | Move scripts into ordered `setup/` files |
+| `setup/` | When setup state changes | Install dependencies, initial build |
+| `select/` | Every new terminal attach | Git fetch, status checks |
 | `remove/` | Before deletion | Cleanup, notifications |
 
 ### Environment Variables
@@ -381,8 +409,8 @@ GitSpace uses **convention over configuration** for custom scripts:
 export SPACES_CURRENT_PROJECT="my-app"
 
 # Available in scripts (from bundle onboarding):
-# SPACE_VALUE_<KEY>    - Regular values
-# SPACE_SECRET_<KEY>   - Secret values (from OS keychain)
+# <KEY>                - Value by exact bundle config key name
+# <NORMALIZED_KEY>     - Uppercase snake-case alias (e.g. teamName -> TEAM_NAME)
 ```
 
 ## Directory Structure
@@ -396,13 +424,15 @@ export SPACES_CURRENT_PROJECT="my-app"
 │   ├── workspaces/              # Git worktrees
 │   │   └── <workspace-name>/
 │   │       ├── gitspace.lock    # Setup completion marker
-│   │       └── .prompt/         # Linear issue details (if applicable)
-│   │           └── issue.md
-│   └── scripts/                 # Custom scripts
-│       ├── pre/
-│       ├── setup/
-│       ├── select/
-│       └── remove/
+│   │       ├── .prompt/         # Linear issue details (if applicable)
+│   │       │   └── issue.md
+│   │       └── .gitspace/
+│   │           ├── bundle.json
+│   │           └── scripts/     # Custom scripts (per worktree)
+│   │               ├── pre/
+│   │               ├── setup/
+│   │               ├── select/
+│   │               └── remove/
 ```
 
 ## Remote Access
@@ -578,7 +608,7 @@ Error: GitHub CLI is not authenticated
 
 ### Bundle secrets not available
 
-If `SPACE_SECRET_*` variables are empty, ensure:
+If expected bundle key environment variables are empty, ensure:
 1. You completed the onboarding secret steps
 2. Your OS keychain service is running (libsecret on Linux, Keychain on macOS)
 

package/package.json

@@ -1,26 +1,31 @@
 {
   "name": "gitspace",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.0-rc.21",
   "description": "CLI for managing GitHub workspaces with git worktrees and secure remote terminal access",
   "bin": {
     "gssh": "./bin/gssh"
   },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
   "type": "module",
   "scripts": {
     "dev": "bun src/index.ts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
-    "build:web": "cd src/web && bun install && bun run build",
+    "build:web": "cd web && bun install && bun run build",
     "build": "bun scripts/build.ts",
     "build:all": "bun scripts/build.ts --all",
     "build:npm": "bun scripts/build.ts --npm",
     "relay": "bun src/relay/index.ts"
   },
   "optionalDependencies": {
-    "@gitspace/darwin-arm64": "0.2.0-rc.2",
-    "@gitspace/darwin-x64": "0.2.0-rc.2",
-    "@gitspace/linux-x64": "0.2.0-rc.2",
-    "@gitspace/linux-arm64": "0.2.0-rc.2"
+    "@gitspace/darwin-arm64": "0.2.0-rc.21",
+    "@gitspace/darwin-x64": "0.2.0-rc.21",
+    "@gitspace/linux-x64": "0.2.0-rc.21",
+    "@gitspace/linux-arm64": "0.2.0-rc.21"
   },
   "keywords": [
     "cli",
@@ -35,40 +40,46 @@
   "homepage": "https://gitspace.sh",
   "repository": {
     "type": "git",
-    "url": "https://github.com/inkibra/gitspace.sh.git"
+    "url": "https://github.com/inKibra/gitspace.sh.git"
   },
   "author": "inKibra, Inc.",
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
-    "@inquirer/prompts": "^7.2.0",
+    "@inquirer/prompts": "^7.10.1",
     "@linear/sdk": "^29.0.0",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
-    "@opentui/core": "^0.1.60",
-    "@opentui/react": "^0.1.60",
+    "@opentui-ui/toast": "^0.0.5",
+    "@opentui/core": "^0.1.77",
+    "@opentui/react": "^0.1.77",
     "@types/ws": "^8.18.1",
     "@xterm/addon-serialize": "^0.13.0",
     "@xterm/headless": "^5.5.0",
-    "ansi-escapes": "^7.2.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
+    "ansi-escapes": "^7.3.0",
+    "chalk": "^5.6.2",
+    "clipboardy": "^5.2.1",
+    "commander": "^12.1.0",
     "conf": "^12.0.0",
-    "ghostty-opentui": "^1.3.11",
+    "ghostty-opentui": "^1.3.13",
     "open": "^11.0.0",
-    "ora": "^8.0.1",
-    "react": "^19.2.3",
-    "simple-git": "^3.23.0",
-    "ws": "^8.18.3"
+    "ora": "^8.2.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "simple-git": "^3.30.0",
+    "ws": "^8.19.0"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.4",
-    "@types/node": "^20.11.20",
-    "@types/react": "^19.2.7",
+    "@testing-library/react": "^16.3.2",
+    "@types/bun": "^1.3.8",
+    "@types/node": "^20.19.32",
+    "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
-    "eslint": "^8.57.0",
-    "typescript": "^5.3.3"
+    "eslint": "^8.57.1",
+    "happy-dom": "^20.5.0",
+    "typescript": "^5.9.3"
   },
   "engines": {
-    "bun": ">=1.3.5"
-  }
+    "bun": ">=1.3.8"
+  },
+  "packageManager": "pnpm@10.12.1+sha512.f0dda8580f0ee9481c5c79a1d927b9164f2c478e90992ad268bbb2465a736984391d6333d2c327913578b2804af33474ca554ba29c04a8b13060a717675ae3ac"
 }

package/.claude/settings.local.json

@@ -1,21 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(bun test:*)",
-      "Bash(xargs ls:*)",
-      "Bash(bun pm:*)",
-      "Bash(node -e:*)",
-      "Bash(bun run typecheck:*)",
-      "Bash(bun -e:*)",
-      "Bash(bun:*)",
-      "Bash(xargs:*)",
-      "Bash(timeout 2 bash -c 'echo \"\"invalid-base64\"\" | bun src/index.ts access add \"\"not-valid-base64-data\"\" 2>&1')",
-      "Bash(wc:*)",
-      "WebFetch(domain:ghostty.org)",
-      "Bash(xxd:*)",
-      "WebFetch(domain:ast-grep.github.io)",
-      "WebFetch(domain:developers.cloudflare.com)",
-      "WebFetch(domain:gitspace.sh)"
-    ]
-  }
-}

package/.gitspace/bundle.json

@@ -1,50 +0,0 @@
-{
-  "version": "1.0",
-  "name": "gitspace-dev",
-  "description": "Development setup for the GitSpace CLI project",
-  "onboarding": [
-    {
-      "id": "welcome",
-      "type": "info",
-      "title": "Welcome to GitSpace CLI Development",
-      "description": "This onboarding will help you set up your development environment.\n\nYou'll need:\n- Bun runtime installed\n- GitHub CLI (gh) authenticated\n\nLet's verify your setup!"
-    },
-    {
-      "id": "bun",
-      "type": "confirm",
-      "title": "Bun Runtime",
-      "description": "Bun is required to run and build the CLI.",
-      "checkCommand": "bun",
-      "installUrl": "https://bun.sh"
-    },
-    {
-      "id": "gh",
-      "type": "confirm",
-      "title": "GitHub CLI",
-      "description": "The GitHub CLI is used for repository operations. Make sure you're logged in with 'gh auth login'.",
-      "checkCommand": "gh",
-      "installUrl": "https://cli.github.com"
-    },
-    {
-      "id": "dev-name",
-      "type": "input",
-      "title": "Your Name",
-      "description": "Enter your name for the development environment (used in example scripts).",
-      "configKey": "developerName",
-      "defaultValue": "Developer"
-    },
-    {
-      "id": "api-token",
-      "type": "secret",
-      "title": "Example API Token",
-      "description": "Enter a sample API token. This demonstrates how secrets are stored securely in your OS keychain.\n\nYou can enter any value - this is just for demonstration.",
-      "configKey": "exampleApiToken"
-    },
-    {
-      "id": "ready",
-      "type": "info",
-      "title": "You're All Set!",
-      "description": "Your development environment is configured.\n\nNext steps:\n1. Run 'bun install' to install dependencies\n2. Run 'bun run dev' to start the CLI in dev mode\n3. Run 'bun run typecheck' to check types\n\nHappy coding!"
-    }
-  ]
-}

package/.gitspace/select/01-status.sh

@@ -1,40 +0,0 @@
-#!/bin/bash
-# Show workspace status when switching
-#
-# This runs every time you switch to an existing workspace.
-#
-# Bundle values are available as environment variables:
-#   SPACE_VALUE_<KEY> - Regular values from input steps
-#   SPACE_SECRET_<KEY> - Secret values from secret steps
-
-WORKSPACE_NAME=$1
-REPOSITORY=$2
-
-echo ""
-echo "=== Workspace: $WORKSPACE_NAME ==="
-echo ""
-
-# Show bundle values (proof of concept)
-if [ -n "$SPACE_VALUE_DEVELOPERNAME" ]; then
-  echo "Welcome back, $SPACE_VALUE_DEVELOPERNAME!"
-fi
-
-# Show that we have access to the secret (masked)
-if [ -n "$SPACE_SECRET_EXAMPLEAPITOKEN" ]; then
-  # Only show first 4 characters to prove we have access
-  TOKEN_PREVIEW="${SPACE_SECRET_EXAMPLEAPITOKEN:0:4}..."
-  echo "API Token available: $TOKEN_PREVIEW (stored in OS keychain)"
-fi
-
-echo ""
-
-# Show git status summary
-echo "Git Status:"
-git status --short
-
-# Show branch info
-echo ""
-echo "Branch:"
-git branch --show-current
-
-echo ""

package/.gitspace/setup/01-install-deps.sh

@@ -1,12 +0,0 @@
-#!/bin/bash
-# Install dependencies for gitspace development
-#
-# This runs once when the workspace is first created.
-
-WORKSPACE_NAME=$1
-REPOSITORY=$2
-
-echo "Installing dependencies for $WORKSPACE_NAME..."
-bun install
-
-echo "Dependencies installed!"

package/.gitspace/setup/02-typecheck.sh

@@ -1,16 +0,0 @@
-#!/bin/bash
-# Run initial typecheck to verify setup
-#
-# This runs once when the workspace is first created.
-
-WORKSPACE_NAME=$1
-REPOSITORY=$2
-
-echo "Running typecheck..."
-bun run typecheck
-
-if [ $? -eq 0 ]; then
-  echo "Typecheck passed!"
-else
-  echo "Typecheck had issues - you may need to fix some things."
-fi