santree 0.0.16 → 0.1.0

package/README.md

@@ -32,15 +32,16 @@ npm install -g santree
 Add to your `.zshrc` or `.bashrc`:
 
 ```bash
-eval "$(santree shell-init zsh)"   # for zsh
-eval "$(santree shell-init bash)"  # for bash
+eval "$(santree helpers shell-init zsh)"   # for zsh
+eval "$(santree helpers shell-init bash)"  # for bash
 ```
 
-This enables automatic directory switching after `create` and `switch` commands.
+This enables automatic directory switching after `worktree create` and `worktree switch` commands.
 
 The shell integration also provides:
 - `st` - Alias for `santree`
-- `stw` - Quick create worktree with `--work --plan --tmux` (prompts for branch name)
+- `stw` - Alias for `santree worktree` (e.g., `stw list`, `stw create`)
+- `stn` - Quick create worktree with `--work --plan --tmux` (prompts for branch name)
 
 ### Verify Setup
 
@@ -56,36 +57,73 @@ This checks that all required tools are installed and configured correctly.
 
 ```bash
 # Create a new worktree and switch to it
-santree create feature/my-new-feature
+santree worktree create feature/TEAM-123-my-feature
 
 # List all worktrees with PR status
-santree list
+santree worktree list
+
+# Launch Claude AI to work on the current ticket
+santree worktree work
 
 # Switch to another worktree
-santree switch main
+santree worktree switch TEAM-456
+
+# Create a PR
+santree pr create
 
 # Clean up worktrees with merged PRs
-santree clean
+santree worktree clean
 ```
 
+With the `stw` alias: `stw create`, `stw list`, `stw switch`, `stw work`, `stw clean`.
+
 ---
 
 ## Commands
 
+### Worktree (`santree worktree`)
+
+| Command | Description |
+|---------|-------------|
+| `santree worktree create <branch>` | Create a new worktree from base branch |
+| `santree worktree list` | List all worktrees with PR status and commits ahead |
+| `santree worktree switch <branch>` | Switch to another worktree |
+| `santree worktree remove <branch>` | Remove a worktree and its branch |
+| `santree worktree clean` | Remove worktrees with merged/closed PRs |
+| `santree worktree sync` | Sync current worktree with base branch |
+| `santree worktree work` | Launch Claude AI to work on the current ticket |
+| `santree worktree open` | Open workspace in VSCode or Cursor |
+| `santree worktree setup` | Run the init script (`.santree/init.sh`) |
+| `santree worktree commit` | Stage and commit changes |
+
+### Pull Requests (`santree pr`)
+
+| Command | Description |
+|---------|-------------|
+| `santree pr create` | Create a GitHub pull request |
+| `santree pr open` | Open the current PR in the browser |
+| `santree pr fix` | Fix PR review comments with AI |
+| `santree pr review` | Review changes against ticket with AI |
+
+### Linear (`santree linear`)
+
+| Command | Description |
+|---------|-------------|
+| `santree linear auth` | Authenticate with Linear (OAuth) |
+| `santree linear open` | Open the current Linear ticket in the browser |
+
+### Helpers (`santree helpers`)
+
+| Command | Description |
+|---------|-------------|
+| `santree helpers shell-init` | Output shell integration script |
+| `santree helpers statusline` | Custom statusline for Claude Code |
+
+### Top-level
+
 | Command | Description |
 |---------|-------------|
-| `santree list` | List all worktrees with PR status and commits ahead |
-| `santree create <branch>` | Create a new worktree from base branch |
-| `santree switch <branch>` | Switch to another worktree |
-| `santree remove <branch>` | Remove a worktree and its branch |
-| `santree sync` | Sync current worktree with base branch |
-| `santree setup` | Run the init script (`.santree/init.sh`) |
-| `santree work` | Launch Claude AI to work on the current ticket |
-| `santree pr` | Create a GitHub pull request (opens in browser) |
-| `santree clean` | Remove worktrees with merged/closed PRs |
 | `santree doctor` | Check system requirements and integrations |
-| `santree editor` | Open workspace file in VSCode or Cursor |
-| `santree statusline` | Statusline wrapper for Claude Code |
 
 ---
 
@@ -97,11 +135,15 @@ Create isolated worktrees for each feature branch. No more stashing or committin
 ### GitHub Integration
 See PR status directly in your worktree list. Clean up worktrees automatically when PRs are merged or closed.
 
+### Linear Integration
+Santree fetches Linear ticket data (title, description, comments, images) and injects it into prompts when running `santree worktree work`. See [Linear Integration](#linear-integration-1) for setup.
+
 ### Claude AI Integration
-Launch Claude with full context about your current ticket using `santree work`. Supports different modes:
-- `--plan` - Create an implementation plan only
-- `--review` - Review changes against ticket requirements
-- `--fix-pr` - Address PR review comments
+Launch Claude with full context about your current ticket. Supports different modes:
+- `santree worktree work` - Implement the ticket
+- `santree worktree work --plan` - Create an implementation plan only
+- `santree pr review` - Review changes against ticket requirements
+- `santree pr fix` - Address PR review comments
 
 ### Init Scripts
 Run custom setup scripts when creating worktrees. Perfect for copying `.env` files, installing dependencies, or any project-specific setup.
@@ -129,12 +171,28 @@ user/TEAM-123-feature-description
 feature/PROJ-456-add-auth
 ```
 
-### Linear MCP (for Claude integration)
+### Linear Integration
+
+Santree fetches Linear ticket data (title, description, comments, images) and injects it into prompts when running `santree worktree work`.
 
 ```bash
-claude mcp add --transport http linear https://mcp.linear.app/mcp
+# Authenticate with Linear (opens browser for OAuth)
+santree linear auth
+
+# Check auth status
+santree linear auth --status
+
+# Verify a ticket is fetched correctly
+santree linear auth --test TEAM-123
+
+# Log out
+santree linear auth --logout
 ```
 
+On first run, `santree linear auth` opens your browser to authorize the app with your Linear workspace. Tokens are stored in `$XDG_CONFIG_HOME/santree/auth.json` (defaults to `~/.config/santree/auth.json`) and auto-refresh transparently.
+
+If you have multiple workspaces authenticated, running `santree linear auth` in a new repo will let you pick which one to link. Images from tickets are downloaded to a temp directory and cleaned up after Claude exits.
+
 ### Claude Code Statusline (Optional)
 
 Santree provides a custom statusline for Claude Code showing git info, model, context usage, and cost.
@@ -144,7 +202,7 @@ Add to `~/.claude/settings.json`:
 {
   "statusLine": {
     "type": "command",
-    "command": "santree statusline"
+    "command": "santree helpers statusline"
   }
 }
 ```
@@ -155,7 +213,7 @@ The statusline displays: `repo | branch | S: staged | U: unstaged | A: untracked
 
 ## Command Options
 
-### create
+### worktree create
 | Option | Description |
 |--------|-------------|
 | `--base <branch>` | Base branch to create from (default: main/master) |
@@ -163,36 +221,44 @@ The statusline displays: `repo | branch | S: staged | U: unstaged | A: untracked
 | `--plan` | With --work, only create implementation plan |
 | `--no-pull` | Skip pulling latest changes |
 | `--tmux` | Open worktree in new tmux window |
+| `--name <name>` | Custom tmux window name |
 
-### sync
+### worktree sync
 | Option | Description |
 |--------|-------------|
 | `--rebase` | Use rebase instead of merge |
 
-### remove
+### worktree remove
 Removes the worktree and deletes the branch. Uses force mode by default (removes even with uncommitted changes).
 
-### clean
+### worktree clean
 Shows worktrees with merged/closed PRs and prompts for confirmation before removing.
 
-### editor
+### worktree open
 | Option | Description |
 |--------|-------------|
 | `--editor <cmd>` | Editor command to use (default: `code`). Also configurable via `SANTREE_EDITOR` env var |
 
-### pr
+### worktree work
+| Option | Description |
+|--------|-------------|
+| `--plan` | Only create implementation plan |
+
+Automatically fetches Linear ticket data if authenticated. Degrades gracefully if not.
+
+### pr create
 | Option | Description |
 |--------|-------------|
 | `--fill` | Use AI to fill the PR template before opening |
 
 Automatically pushes, detects existing PRs, and uses the first commit message as the title. If a closed PR exists for the branch, prompts before creating a new one.
 
-### work
+### linear auth
 | Option | Description |
 |--------|-------------|
-| `--plan` | Only create implementation plan |
-| `--review` | Review changes against requirements |
-| `--fix-pr` | Fetch and fix PR comments |
+| `--status` | Show current auth status (org, token expiry) |
+| `--test <id>` | Fetch a ticket by ID to verify integration works |
+| `--logout` | Revoke tokens and log out |
 
 ---
 
@@ -205,3 +271,78 @@ Automatically pushes, detects existing PRs, and uses the first commit message as
 | GitHub CLI (`gh`) | PR integration |
 | tmux | Optional: new window support |
 | VSCode (`code`) or Cursor (`cursor`) | Optional: workspace editor |
+
+---
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/santiagotoscanini/santree.git
+cd santree
+npm install
+```
+
+### Build & Run
+
+```bash
+# Compile TypeScript
+npm run build
+
+# Run the local build
+node dist/cli.js <command>
+
+# Watch mode (recompiles on save)
+npm run dev
+```
+
+During development, use `node dist/cli.js` instead of `santree` to run the local version:
+
+```bash
+node dist/cli.js worktree list
+node dist/cli.js worktree work
+node dist/cli.js linear auth --test TEAM-123
+```
+
+### Link globally (optional)
+
+To use `santree` as a global command pointing to your local build:
+
+```bash
+npm link
+```
+
+Now `santree` runs your local `dist/cli.js`. Unlink with `npm unlink -g santree`.
+
+### Code Quality
+
+```bash
+npm run lint          # Check for lint + formatting errors
+npm run lint:fix      # Auto-fix lint + formatting errors
+npm run format        # Format all source files with Prettier
+```
+
+A pre-commit hook (via husky + lint-staged) automatically runs ESLint and Prettier on staged files.
+
+### Project Structure
+
+```
+source/
+├── cli.tsx              # Entry point (Pastel app runner)
+├── lib/
+│   ├── ai.ts            # Shared AI logic (context, prompt, launch)
+│   ├── git.ts           # Git helpers (worktrees, branches, metadata)
+│   ├── github.ts        # GitHub CLI wrapper (PR info, auth, push)
+│   ├── linear.ts        # Linear GraphQL API client (OAuth, tickets, images)
+│   ├── exec.ts          # Shell command helpers
+│   └── prompts.ts       # Nunjucks template renderer
+└── commands/            # One React (Ink) component per CLI command
+    ├── doctor.tsx        # Top-level: system check
+    ├── worktree/         # Worktree management (create, list, switch, etc.)
+    ├── pr/               # PR lifecycle (create, open, fix, review)
+    ├── linear/           # Linear integration (auth, open)
+    └── helpers/          # Shell init, statusline
+prompts/                 # Nunjucks templates: implement, plan, review, fix-pr, fill-pr, ticket
+shell/                   # Shell integration templates: init.zsh.njk, init.bash.njk
+```

package/dist/commands/doctor.js

@@ -6,7 +6,8 @@ import { exec, execSync } from "child_process";
 import { promisify } from "util";
 import * as fs from "fs";
 import * as path from "path";
-import { findMainRepoRoot, getSantreeDir, getInitScriptPath, } from "../lib/git.js";
+import { findMainRepoRoot, getSantreeDir, getInitScriptPath } from "../lib/git.js";
+import { getAuthStatus, getValidTokens } from "../lib/linear.js";
 const execAsync = promisify(exec);
 export const description = "Check system requirements and integrations";
 /**
@@ -103,51 +104,30 @@ async function checkGhAuth() {
     };
 }
 /**
- * Checks if Linear MCP is configured using `claude mcp list`.
- * Output formats:
- *   linear: https://mcp.linear.app/mcp (HTTP) - ✓ Connected
- *   linear: https://mcp.linear.app/mcp (HTTP) - ⚠ Needs authentication
+ * Checks Linear API authentication status.
  */
-async function checkLinearMcp() {
-    const output = await tryExec("claude mcp list 2>&1");
-    if (!output) {
+async function checkLinearAuth() {
+    const repoRoot = findMainRepoRoot();
+    const status = getAuthStatus(repoRoot);
+    if (!status.authenticated || !status.orgSlug) {
         return {
-            name: "Linear MCP",
-            configured: false,
-            hint: "Claude CLI not available to check MCP servers",
-        };
-    }
-    // Check if "No MCP servers configured"
-    if (output.includes("No MCP servers configured")) {
-        return {
-            name: "Linear MCP",
-            configured: false,
-            hint: "Run: claude mcp add --transport http linear https://mcp.linear.app/mcp",
-        };
-    }
-    // Look for a line containing "linear"
-    const lines = output.split("\n");
-    const linearLine = lines.find((line) => line.toLowerCase().includes("linear"));
-    if (linearLine) {
-        const urlMatch = linearLine.match(/:\s*(https?:\/\/[^\s]+)/);
-        // Extract status after " - " (e.g., "✓ Connected" or "⚠ Needs authentication")
-        const statusMatch = linearLine.match(/ - (.+)$/);
-        const status = statusMatch?.[1]?.trim();
-        const isConnected = status?.includes("✓") || status?.includes("Connected");
-        return {
-            name: "Linear MCP",
-            configured: true,
-            url: urlMatch?.[1],
-            status,
-            hint: isConnected
-                ? undefined
-                : "Open Linear MCP URL in browser to authenticate",
+            authenticated: false,
+            hint: "Run: santree linear auth",
         };
     }
+    // Try to validate/refresh tokens
+    const valid = await getValidTokens(status.orgSlug);
     return {
-        name: "Linear MCP",
-        configured: false,
-        hint: "Run: claude mcp add --transport http linear https://mcp.linear.app/mcp",
+        authenticated: true,
+        orgSlug: status.orgSlug,
+        orgName: status.orgName,
+        tokenValid: valid !== null,
+        repoLinked: status.repoLinked,
+        hint: !valid
+            ? "Token expired. Run: santree linear auth"
+            : !status.repoLinked
+                ? "Repo not linked. Run: santree linear auth"
+                : undefined,
     };
 }
 /**
@@ -156,11 +136,7 @@ async function checkLinearMcp() {
  */
 function checkShellIntegration() {
     const shell = process.env.SHELL || "";
-    const shellName = shell.includes("zsh")
-        ? "zsh"
-        : shell.includes("bash")
-            ? "bash"
-            : null;
+    const shellName = shell.includes("zsh") ? "zsh" : shell.includes("bash") ? "bash" : null;
     const configured = process.env.SANTREE_SHELL_INTEGRATION === "1";
     return { configured, shell: shellName };
 }
@@ -181,7 +157,8 @@ async function checkStatusline() {
                 currentCommand = String(settings.statusLine.command);
                 // Check if it points to santree statusline
                 claudeSettingsConfigured =
-                    currentCommand.includes("santree statusline");
+                    currentCommand.includes("santree statusline") ||
+                        currentCommand.includes("santree helpers statusline");
             }
         }
     }
@@ -191,7 +168,7 @@ async function checkStatusline() {
     let hint;
     if (!claudeSettingsConfigured) {
         hint =
-            'Add to ~/.claude/settings.json: "statusLine": { "type": "command", "command": "santree statusline" }';
+            'Add to ~/.claude/settings.json: "statusLine": { "type": "command", "command": "santree helpers statusline" }';
     }
     return {
         claudeSettingsConfigured,
@@ -280,13 +257,12 @@ function StatusIcon({ ok, required }) {
 function ToolRow({ tool }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: tool.installed && !tool.hint, required: tool.required }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: tool.name }), _jsxs(Text, { dimColor: true, children: [" - ", tool.description] }), !tool.required && _jsx(Text, { dimColor: true, children: " (optional)" })] }), tool.installed ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Version: ", tool.version] }), _jsxs(Text, { dimColor: true, children: ["Path: ", tool.path] }), tool.authStatus && _jsxs(Text, { dimColor: true, children: ["Auth: ", tool.authStatus] }), tool.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", tool.hint] }) }))] }));
 }
-function McpRow({ mcp }) {
-    const isOk = mcp.configured &&
-        Boolean(mcp.status?.includes("✓") || mcp.status?.includes("Connected"));
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: isOk, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: mcp.name }), _jsx(Text, { dimColor: true, children: " - Linear ticket integration for Claude" })] }), mcp.configured ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [mcp.url && _jsxs(Text, { dimColor: true, children: ["URL: ", mcp.url] }), mcp.status && _jsxs(Text, { dimColor: true, children: ["Status: ", mcp.status] }), mcp.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", mcp.hint] })] })) : (mcp.hint && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", mcp.hint] }) })))] }));
+function LinearRow({ linear }) {
+    const isOk = linear.authenticated && linear.tokenValid && linear.repoLinked;
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: !!isOk, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Linear API" }), _jsx(Text, { dimColor: true, children: " - Linear ticket integration" })] }), linear.authenticated ? (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["Organization: ", linear.orgName, " (", linear.orgSlug, ")"] }), _jsxs(Text, { dimColor: true, children: ["Token: ", linear.tokenValid ? "valid" : "expired"] }), _jsxs(Text, { dimColor: true, children: ["Repo linked: ", linear.repoLinked ? "yes" : "no"] }), linear.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", linear.hint] })] })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 ", linear.hint] }) }))] }));
 }
-function ShellRow({ configured, shell, }) {
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: configured, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Shell Integration" }), _jsx(Text, { dimColor: true, children: " - Enables directory switching" })] }), configured ? (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: ["Shell: ", shell] }) })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 Add to .", shell, "rc: eval \"$(santree shell-init ", shell, ")\""] }) }))] }));
+function ShellRow({ configured, shell }) {
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: configured, required: true }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Shell Integration" }), _jsx(Text, { dimColor: true, children: " - Enables directory switching" })] }), configured ? (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { dimColor: true, children: ["Shell: ", shell] }) })) : (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "yellow", children: ["\u21B3 Add to .", shell, "rc: eval \"$(santree helpers shell-init ", shell, ")\""] }) }))] }));
 }
 function StatuslineRow({ status }) {
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(StatusIcon, { ok: status.claudeSettingsConfigured, required: false }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Claude Statusline" }), _jsx(Text, { dimColor: true, children: " - Custom statusline in Claude Code" }), _jsx(Text, { dimColor: true, children: " (optional)" })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [status.currentCommand ? (_jsxs(Text, { dimColor: true, children: ["Command: ", status.currentCommand] })) : (_jsx(Text, { dimColor: true, children: "Command: not configured" })), status.hint && _jsxs(Text, { color: "yellow", children: ["\u21B3 ", status.hint] })] })] }));
@@ -304,11 +280,11 @@ function SantreeSetupRow({ status }) {
                                 ? status.initShExecutable
                                     ? "executable"
                                     : "not executable"
-                                : "missing"] })), _jsxs(Text, { dimColor: true, children: [".santree/worktrees ignored: ", status.worktreesIgnored ? "yes" : "no"] }), _jsxs(Text, { dimColor: true, children: [".santree/metadata.json ignored:", " ", status.metadataIgnored ? "yes" : "no"] }), status.hints.map((hint, i) => (_jsxs(Text, { color: "yellow", children: ["\u21B3 ", hint] }, i)))] })] }));
+                                : "missing"] })), _jsxs(Text, { dimColor: true, children: [".santree/worktrees ignored: ", status.worktreesIgnored ? "yes" : "no"] }), _jsxs(Text, { dimColor: true, children: [".santree/metadata.json ignored: ", status.metadataIgnored ? "yes" : "no"] }), status.hints.map((hint, i) => (_jsxs(Text, { color: "yellow", children: ["\u21B3 ", hint] }, i)))] })] }));
 }
 export default function Doctor() {
     const [tools, setTools] = useState([]);
-    const [mcp, setMcp] = useState(null);
+    const [linear, setLinear] = useState(null);
     const [shellStatus, setShellStatus] = useState(null);
     const [statusline, setStatusline] = useState(null);
     const [santreeSetup, setSantreeSetup] = useState(null);
@@ -342,10 +318,10 @@ export default function Doctor() {
                     hint: "Install VSCode (https://code.visualstudio.com) or Cursor (https://cursor.sh)",
                 });
             }
-            const mcpResult = await checkLinearMcp();
+            const linearResult = await checkLinearAuth();
             const statuslineResult = await checkStatusline();
             setTools(results);
-            setMcp(mcpResult);
+            setLinear(linearResult);
             setShellStatus(checkShellIntegration());
             setStatusline(statuslineResult);
             setSantreeSetup(checkSantreeSetup());
@@ -358,10 +334,7 @@ export default function Doctor() {
     }
     const requiredMissing = tools.filter((t) => t.required && (!t.installed || t.hint));
     const optionalMissing = tools.filter((t) => !t.required && !t.installed);
-    const mcpOk = mcp?.configured &&
-        (mcp?.status?.includes("✓") || mcp?.status?.includes("Connected"));
-    const allRequired = requiredMissing.length === 0 && mcpOk && shellStatus?.configured;
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Santree Doctor" }) }), _jsx(Box, { marginBottom: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "CLI Tools" }) }), tools.map((tool) => (_jsx(ToolRow, { tool: tool }, tool.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), mcp && _jsx(McpRow, { mcp: mcp }), shellStatus && (_jsx(ShellRow, { configured: shellStatus.configured, shell: shellStatus.shell })), santreeSetup && _jsx(SantreeSetupRow, { status: santreeSetup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Aesthetics" }) }), statusline && _jsx(StatuslineRow, { status: statusline }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All requirements satisfied! Santree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredMissing.length +
-                                    (mcpOk ? 0 : 1) +
-                                    (shellStatus?.configured ? 0 : 1), " ", "required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
+    const linearOk = linear?.authenticated && linear?.tokenValid && linear?.repoLinked;
+    const allRequired = requiredMissing.length === 0 && linearOk && shellStatus?.configured;
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "Santree Doctor" }) }), _jsx(Box, { marginBottom: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "CLI Tools" }) }), tools.map((tool) => (_jsx(ToolRow, { tool: tool }, tool.name))), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Integrations" }) }), linear && _jsx(LinearRow, { linear: linear }), shellStatus && _jsx(ShellRow, { configured: shellStatus.configured, shell: shellStatus.shell }), santreeSetup && _jsx(SantreeSetupRow, { status: santreeSetup }), _jsx(Box, { marginBottom: 1, marginTop: 1, flexDirection: "column", children: _jsx(Text, { bold: true, underline: true, children: "Aesthetics" }) }), statusline && _jsx(StatuslineRow, { status: statusline }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: allRequired ? "green" : "yellow", paddingX: 2, children: allRequired ? (_jsx(Text, { color: "green", children: "All requirements satisfied! Santree is ready to use." })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: [requiredMissing.length + (linearOk ? 0 : 1) + (shellStatus?.configured ? 0 : 1), " ", "required item(s) need attention"] }), optionalMissing.length > 0 && (_jsxs(Text, { dimColor: true, children: [optionalMissing.length, " optional item(s) not installed"] }))] })) })] }));
 }

package/dist/commands/helpers/index.d.ts

@@ -0,0 +1 @@
+export declare const description = "Setup and integration helpers";

package/dist/commands/helpers/index.js

@@ -0,0 +1 @@
+export const description = "Setup and integration helpers";

package/dist/commands/helpers/shell-init.js

@@ -0,0 +1,122 @@
+import { useEffect, useState, useRef } from "react";
+import { argument } from "pastel";
+import { z } from "zod/v4";
+import { readdirSync, statSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import nunjucks from "nunjucks";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const description = "Output shell integration script";
+export const args = z.tuple([
+    z
+        .enum(["zsh", "bash"])
+        .default("zsh")
+        .describe(argument({ name: "shell", description: "Shell type (zsh or bash)" })),
+]);
+const ARG_COMPLETIONS = {};
+function extractOptions(mod) {
+    const options = [];
+    if (mod.options) {
+        const shape = mod.options.shape ?? {};
+        for (const [key, value] of Object.entries(shape)) {
+            const schema = value;
+            const desc = schema.description ?? schema._zod?.def?.description ?? "";
+            options.push({
+                name: key,
+                description: desc,
+                completion: key === "base" ? "all_branches" : null,
+            });
+        }
+    }
+    return options;
+}
+/**
+ * Dynamically loads command modules and extracts their metadata.
+ * Handles both top-level files and directory-based command groups.
+ */
+async function getCommands() {
+    const commandsDir = join(__dirname, "..");
+    const entries = readdirSync(commandsDir);
+    const commands = [];
+    for (const entry of entries) {
+        const entryPath = join(commandsDir, entry);
+        const stat = statSync(entryPath);
+        if (stat.isDirectory()) {
+            // Directory-based command group — complete arg to subcommand names
+            const subFiles = readdirSync(entryPath).filter((f) => f.endsWith(".js") && f !== "index.js");
+            const subNames = subFiles.map((f) => f.replace(".js", ""));
+            if (subNames.length === 0)
+                continue;
+            let description = "";
+            const indexPath = join(entryPath, "index.js");
+            if (existsSync(indexPath)) {
+                try {
+                    const indexMod = await import(indexPath);
+                    description = indexMod.description ?? "";
+                }
+                catch {
+                    // no description
+                }
+            }
+            commands.push({
+                name: entry,
+                funcName: entry.replace(/-/g, "_"),
+                description,
+                hasArgs: true,
+                argCompletion: "static",
+                argCompletionValues: subNames.join(" "),
+                options: [],
+            });
+            continue;
+        }
+        if (!entry.endsWith(".js"))
+            continue;
+        const name = entry.replace(".js", "");
+        try {
+            const mod = await import(join(commandsDir, entry));
+            if (!mod.description)
+                continue;
+            commands.push({
+                name,
+                funcName: name.replace(/-/g, "_"),
+                description: mod.description,
+                hasArgs: !!mod.args,
+                argCompletion: ARG_COMPLETIONS[name] || null,
+                argCompletionValues: "",
+                options: extractOptions(mod),
+            });
+        }
+        catch {
+            // Skip files that can't be imported
+        }
+    }
+    return commands.sort((a, b) => a.name.localeCompare(b.name));
+}
+// Configure nunjucks
+const templatesDir = join(__dirname, "..", "..", "..", "shell");
+nunjucks.configure(templatesDir, { autoescape: false });
+export default function ShellInit({ args }) {
+    const [shell] = args;
+    const [done, setDone] = useState(false);
+    const hasOutputRef = useRef(false);
+    useEffect(() => {
+        async function run() {
+            if (hasOutputRef.current)
+                return;
+            hasOutputRef.current = true;
+            const commands = await getCommands();
+            const templateFile = `init.${shell}.njk`;
+            const output = nunjucks.render(templateFile, { commands });
+            process.stdout.write(output);
+            setDone(true);
+        }
+        run();
+    }, [shell]);
+    useEffect(() => {
+        if (done) {
+            process.exit(0);
+        }
+    }, [done]);
+    return null;
+}

package/dist/commands/linear/auth.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export declare const description = "Authenticate with Linear";
+export declare const options: z.ZodObject<{
+    logout: z.ZodOptional<z.ZodBoolean>;
+    status: z.ZodOptional<z.ZodBoolean>;
+    test: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Props = {
+    options: z.infer<typeof options>;
+};
+export default function LinearAuth({ options }: Props): import("react/jsx-runtime").JSX.Element;
+export {};