prjct-cli 0.40.0 → 0.42.0

package/templates/commands/linear.md

@@ -1,51 +1,44 @@
 ---
 allowed-tools: [Read, Write, Bash, AskUserQuestion]
-description: 'Linear issue tracker integration via MCP'
+description: 'Linear issue tracker integration via SDK'
 extends: '_bases/tracker-base.md'
 ---
 
 # p. linear - Linear Integration
 
-**EXTENDS**: `_bases/tracker-base.md` - See base template for common flows.
-
 **ARGUMENTS**: $ARGUMENTS
 
-Manage Linear issues directly from prjct using MCP (no SDK needed).
-
-## Tracker-Specific Config
+Manage Linear issues directly from prjct using natural language.
 
-- `{mcpServerName}`: "linear"
-- `{mcpPrefix}`: "mcp__linear__"
-- `{projectKey}`: "teamId"
+## How This Works
 
-## Context Variables
+User types natural commands → Claude interprets → Executes SDK → Shows formatted result
 
-- `{projectId}`: From `.prjct/prjct.config.json`
-- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
-- `{agentName}`: Name of the AI agent (Claude Code, Gemini CLI)
-- `{agentSettingsPath}`: Path to agent settings (settings.json)
-- `{args}`: User-provided arguments (subcommand)
+**Examples**:
+- `p. linear` → List my assigned issues
+- `p. linear 123` or `p. linear PRJ-123` → Get issue details
+- `p. linear start 123` → Start working on issue
+- `p. linear done 123` → Mark issue as done
+- `p. linear setup` → Configure API key
+- `p. linear "add auth feature"` → Create new issue
 
 ---
 
-## Subcommands
+## CRITICAL - Execution Pattern
 
-| Command | Description |
-|---------|-------------|
-| `p. linear` | Show your assigned issues |
-| `p. linear setup` | Configure Linear (first time) |
-| `p. linear start <ID>` | Start working on issue (e.g., PRJ-59) |
-| `p. linear comment <ID> <text>` | Add comment to issue |
+**NEVER use MCP tools** (`mcp__linear__*`, `mcp__claude_ai_Linear__*`).
+**ALWAYS use SDK via CLI helper** (much faster, per-project credentials).
 
----
+### CLI Helper (Internal Use)
 
-## Authentication
+```bash
+# Setup paths first
+PRJCT_CLI=$(npm root -g)/prjct-cli
+PROJECT_ID=$(cat .prjct/prjct.config.json | jq -r '.projectId')
 
-Linear uses MCP with OAuth - **no API key needed**.
-
-**MCP Server**: `https://mcp.linear.app/mcp`
-**Auth**: Browser-based OAuth (first use opens browser)
-**Tools prefix**: `mcp__linear__*`
+# Then run commands with --project flag
+bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID <command> [args...]
+```
 
 ---
 
@@ -63,98 +56,52 @@ IF file not found:
 
 ---
 
-## Step 2: Install MCP Server (if needed)
-
-```
-READ: {agentSettingsPath} (create {} if not exists)
-CHECK: Does mcpServers.linear exist?
-
-IF not exists:
-  READ: templates/mcp-config.json
-  EXTRACT: mcpServers.linear
-
-  MERGE into {agentSettingsPath}:
-  {
-    "mcpServers": {
-      "linear": {
-        "command": "npx",
-        "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
-      }
-    }
-  }
-
-  WRITE: {agentSettingsPath}
-
-  OUTPUT: "✅ Installed Linear MCP server"
-  OUTPUT: ""
-  OUTPUT: "⚠️ Restart {agentName} to activate the MCP server."
-  OUTPUT: "Then run `p. linear setup` again to complete configuration."
-  STOP
-```
-
----
+## Step 2: Parse User Intent
 
-## Step 3: Check MCP Tools Available
+Analyze $ARGUMENTS to determine what user wants:
 
-```
-CHECK: Are mcp__linear__* tools available?
+| User Input | Intent | CLI Command |
+|------------|--------|-------------|
+| (empty) | List my issues | `list` |
+| `setup` | Configure API key | `setup <apiKey>` |
+| `123` or `PRJ-123` | Get issue details | `get PRJ-123` |
+| `start 123` | Start working | `start PRJ-123` |
+| `done 123` | Mark complete | `done PRJ-123` |
+| `comment 123 text...` | Add comment | `comment PRJ-123 "text"` |
+| `"create something"` | Create issue | `create '{"title":"..."}'` |
+| `teams` | List teams | `teams` |
+| `status` | Check connection | `status` |
 
-IF not available:
-  OUTPUT: "Linear MCP is installed but not yet active."
-  OUTPUT: "Restart {agentName}, then run `p. linear setup` again."
-  STOP
-```
+**Identifier normalization**: If user types `123`, check project config for team key and expand to `PRJ-123`.
 
 ---
 
 ## Subcommand: setup
 
-### Flow
+**Trigger**: `p. linear setup`
 
-1. **Install MCP + Verify tools available**
-   ```
-   Execute Step 2 (auto-install if needed)
-   Execute Step 3 (verify tools active)
-   IF not available: Prompt restart and STOP
-   ```
+### Flow
 
-2. **Test connection (triggers OAuth if needed)**
+1. **Ask for API key**
    ```
-   USE TOOL: mcp__linear__list_issues
-   PARAMS: { "limit": 1 }
-
-   # First use will open browser for OAuth
+   ASK: "Enter your Linear API key"
+   HINT: "Get it from https://linear.app/settings/api"
    ```
 
-3. **Get user info and teams**
+2. **Store and test via CLI**
+   ```bash
+   RESULT=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID setup "$API_KEY")
    ```
-   USE TOOL: mcp__linear__get_viewer
-   EXTRACT: userId, name, email
 
-   USE TOOL: mcp__linear__list_teams
-   ```
+3. **Parse result** - Contains `{ success, teams, defaultTeam }`
 
-4. **Ask user to select team**
+4. **If multiple teams, ask user to select**
    ```
    ASK: "Select your default team"
-   OPTIONS: List of teams
-   ```
+   OPTIONS: teams from result
 
-5. **Save config to project.json**
-   ```json
-   {
-     "integrations": {
-       "linear": {
-         "enabled": true,
-         "authMode": "mcp",
-         "teamId": "{teamId}",
-         "teamName": "{teamName}",
-         "teamKey": "{teamKey}",
-         "userId": "{userId}",
-         "setupAt": "{timestamp}"
-       }
-     }
-   }
+   # Re-run setup with team selection
+   bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID setup "$API_KEY" "$TEAM_ID"
    ```
 
 ### Output
@@ -162,151 +109,189 @@ IF not available:
 ```
 ✅ Linear configured
 
-Connected as: {name} ({email})
 Team: {teamName} ({teamKey})
-Auth: MCP (OAuth)
+Credentials: Stored per-project
 
 Next: `p. linear` to see your issues
 ```
 
 ---
 
-## Subcommand: status (default, no args)
+## Subcommand: list (default)
 
+**Trigger**: `p. linear` (no arguments)
+
+```bash
+RESULT=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID list)
 ```
-USE TOOL: mcp__linear__list_issues
-PARAMS:
-  assignedToMe: true
-  limit: 10
 
-OUTPUT:
-Linear: Connected ✓
-Team: {teamName} ({teamKey})
+### Output
+
+```
+Linear: Connected
 
-Your issues ({count}):
-• {PRJ-123} {title} ({status})
-• {PRJ-124} {title} ({status})
-...
+Your issues (5):
+  PRJ-123  Add user authentication     In Progress
+  PRJ-124  Fix login redirect          Todo
+  PRJ-125  Update dependencies         Backlog
+  ...
 
-Next: `p. linear start PRJ-123` to begin work
+Next: `p. linear 123` for details, `p. linear start 123` to begin
 ```
 
 ---
 
-## Subcommand: start <ID>
+## Subcommand: get <ID>
 
+**Trigger**: `p. linear 123` or `p. linear PRJ-123`
+
+```bash
+RESULT=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID get "PRJ-123")
 ```
-1. Get issue
-   USE TOOL: mcp__linear__get_issue
-   PARAMS: { "issueId": "{ID}" }
 
-2. Update status to In Progress
-   USE TOOL: mcp__linear__update_issue
-   PARAMS:
-     issueId: "{uuid}"
-     stateId: "{in_progress_state_id}"
+### Output
 
-3. Create prjct task from issue
+```
+PRJ-123: Add user authentication
 
-4. Create git branch: feature/{ID}-{slug}
+Status: In Progress
+Priority: High
+Assignee: @user
 
-OUTPUT:
-Started: {ID} - {title}
+Description:
+{description text}
 
-Branch: feature/PRJ-59-add-user-auth
-Linear: In Progress ✓
+URL: https://linear.app/team/issue/PRJ-123
+
+Next: `p. linear start 123` to begin, `p. task "PRJ-123"` to track in prjct
+```
+
+---
+
+## Subcommand: start <ID>
+
+**Trigger**: `p. linear start 123`
+
+```bash
+# 1. Get issue info
+ISSUE=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID get "PRJ-123")
+
+# 2. Mark in progress
+bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID start "PRJ-123"
+
+# 3. Create git branch
+git checkout -b "feature/PRJ-123-{slug}"
+```
+
+### Output
+
+```
+Started: PRJ-123 - {title}
+
+Branch: feature/PRJ-123-add-user-auth
+Linear: In Progress
 
 Next: Work on the task, then `p. done`
 ```
 
 ---
 
-## Subcommand: comment <ID> <text>
+## Subcommand: done <ID>
+
+**Trigger**: `p. linear done 123`
 
+```bash
+bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID done "PRJ-123"
 ```
-1. Get issue UUID
-   USE TOOL: mcp__linear__get_issue
-   PARAMS: { "issueId": "{ID}" }
-
-2. Add comment
-   USE TOOL: mcp__linear__create_comment
-   PARAMS:
-     issueId: "{uuid}"
-     body: "{text}"
-
-OUTPUT:
-Comment added to {ID}
+
+### Output
+
+```
+✅ Completed: PRJ-123 - {title}
+
+Linear: Done
 ```
 
 ---
 
-## MCP Tool Reference
+## Subcommand: create
 
-| Operation | MCP Tool |
-|-----------|----------|
-| List issues | `mcp__linear__list_issues` |
-| Get issue | `mcp__linear__get_issue` |
-| Update issue | `mcp__linear__update_issue` |
-| Create issue | `mcp__linear__create_issue` |
-| Add comment | `mcp__linear__create_comment` |
-| Get viewer | `mcp__linear__get_viewer` |
-| List teams | `mcp__linear__list_teams` |
+**Trigger**: `p. linear "add feature X"` or `p. linear create "title"`
 
-### Example: List My Issues
+```bash
+# Get default team from credentials
+TEAMS=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID teams)
 
+# Create issue
+RESULT=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID create '{"title":"...","teamId":"..."}')
 ```
-USE TOOL: mcp__linear__list_issues
-PARAMS:
-  assignedToMe: true
-  includeArchived: false
-  limit: 20
+
+### Output
+
 ```
+✅ Created: PRJ-126 - {title}
 
-### Example: Get Issue by ID
+URL: https://linear.app/...
 
+Next: `p. linear start 126` to begin
 ```
-USE TOOL: mcp__linear__get_issue
-PARAMS:
-  issueId: "PRJ-59"
+
+---
+
+## Subcommand: comment <ID> <text>
+
+**Trigger**: `p. linear comment 123 "Progress update..."`
+
+```bash
+bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID comment "PRJ-123" "Progress update..."
 ```
 
-### Example: Add Comment
+### Output
 
 ```
-USE TOOL: mcp__linear__create_comment
-PARAMS:
-  issueId: "{uuid}"
-  body: "Implementation complete. Used MCP instead of SDK."
+✅ Comment added to PRJ-123
 ```
 
 ---
 
-## Config Storage
+## Subcommand: update <ID>
 
-| What | Where |
-|------|-------|
-| Auth | MCP OAuth (managed by Linear) |
-| Config | `{globalPath}/project.json` → `integrations.linear` |
-| Issue cache | `{globalPath}/storage/issues.json` |
+**Trigger**: `p. linear update 123` (then ask what to update)
+
+```bash
+bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID update "PRJ-123" '{"description":"..."}'
+```
 
 ---
 
 ## Error Handling
 
-| Error | Action |
-|-------|--------|
-| MCP tools not found | "Add Linear MCP to settings, restart {agentName}" |
-| OAuth failed | "Re-authenticate via browser" |
-| Issue not found | "Issue {ID} not found in Linear" |
+| Error | Response |
+|-------|----------|
+| Not configured | "Run `p. linear setup` to configure your API key" |
+| Invalid API key | "Invalid API key. Get a new one at https://linear.app/settings/api" |
+| Issue not found | "Issue PRJ-123 not found" |
+| No project | "Run `p. init` first" |
 
 ---
 
-## Output Format
+## Credential Storage
 
-```
-{action}: {result}
+Credentials are stored **per-project** to support multiple Linear workspaces:
 
-{details}
+**Location**: `~/.prjct-cli/projects/{projectId}/config/credentials.json`
 
-Next: {suggested action}
-```
+**Fallback chain**:
+1. Project credentials (per-project)
+2. Global keychain (macOS)
+3. Environment variable (`LINEAR_API_KEY`)
+
+---
+
+## Performance
+
+| Operation | SDK | MCP (deprecated) |
+|-----------|-----|------------------|
+| Fetch issue | ~150ms | ~600ms |
+| List issues | ~300ms | ~1200ms |
+| Create issue | ~200ms | ~800ms |

package/templates/commands/task.md

@@ -8,6 +8,56 @@ allowed-tools: [Read, Write, Bash, Task, Glob, Grep, AskUserQuestion]
 prjct context task $ARGUMENTS
 ```
 
+## Step 0: Detect Issue Tracker Reference
+
+IF `$ARGUMENTS` matches pattern `/^[A-Z]+-\d+$/` (e.g., PRJ-123, PROJ-456):
+
+```
+READ: {globalPath}/project.json
+CHECK: integrations.linear OR integrations.jira
+
+IF integrations.linear.enabled:
+  # Linear issue detected
+  IMPORT: linearService from core/integrations/linear
+  CALL: linearService.fetchIssue("$ARGUMENTS")
+
+  IF issue found:
+    SET: task.externalId = issue.externalId
+    SET: task.externalProvider = "linear"
+    SET: task.description = issue.title
+    SET: $ARGUMENTS = issue.title  # Use title for task
+
+    # Mark issue as In Progress in Linear
+    CALL: linearService.markInProgress(issue.id)
+
+    OUTPUT: "Linked to Linear: {issue.externalId} - {issue.title}"
+    OUTPUT: "Linear: In Progress"
+
+ELSE IF integrations.jira.enabled:
+  # JIRA issue detected
+  IMPORT: jiraService from core/integrations/jira
+  CALL: jiraService.fetchIssue("$ARGUMENTS")
+
+  IF issue found:
+    SET: task.externalId = issue.externalId
+    SET: task.externalProvider = "jira"
+    SET: task.description = issue.title
+    SET: $ARGUMENTS = issue.title  # Use title for task
+
+    # Mark issue as In Progress in JIRA
+    CALL: jiraService.markInProgress(issue.externalId)
+
+    OUTPUT: "Linked to JIRA: {issue.externalId} - {issue.title}"
+    OUTPUT: "JIRA: In Progress"
+
+ELSE:
+  OUTPUT: "Issue tracker not configured. Run `p. linear setup` or `p. jira setup`"
+```
+
+---
+
+## Main Flow
+
 IF `currentTask` active → Ask: complete, pause, or cancel?
 
 USE Task(Explore) → find similar code, affected files
@@ -23,14 +73,28 @@ prjct work "$ARGUMENTS"
 
 WRITE `{globalPath}/storage/state.json`:
 ```json
-{"currentTask":{"id":"{uuid}","description":"{subtask}","type":"{type}","status":"active","startedAt":"{now}","subtasks":[...],"currentSubtaskIndex":0,"parentDescription":"$ARGUMENTS"}}
+{
+  "currentTask": {
+    "id": "{uuid}",
+    "description": "{subtask}",
+    "type": "{type}",
+    "status": "active",
+    "startedAt": "{now}",
+    "subtasks": [...],
+    "currentSubtaskIndex": 0,
+    "parentDescription": "$ARGUMENTS",
+    "externalId": "{externalId or null}",
+    "externalProvider": "{linear|jira|null}"
+  }
+}
 ```
 
 **Output**:
 ```
-✅ {type}: $ARGUMENTS
+{type}: $ARGUMENTS
 
 Branch: {branch} | Subtasks: {count}
+{externalId ? "Linked: {externalProvider} {externalId}" : ""}
 
 Next: Work on subtask, then `p. done`
 ```

package/templates/mcp-config.json

@@ -5,16 +5,6 @@
       "args": ["-y", "@upstash/context7-mcp@latest"],
       "description": "Library documentation lookup"
     },
-    "linear": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"],
-      "description": "Linear issue tracking via OAuth"
-    },
-    "Atlassian": {
-      "command": "npx",
-      "args": ["-y", "mcp-remote@latest", "https://mcp.atlassian.com/v1/sse"],
-      "description": "JIRA/Confluence via OAuth (SSO compatible)"
-    },
     "monday": {
       "command": "npx",
       "args": ["-y", "@mondaydotcomorg/monday-api-mcp"],
@@ -34,16 +24,6 @@
       "when": ["Looking up library/framework documentation"],
       "tools": ["resolve-library-id", "get-library-docs"]
     },
-    "linear": {
-      "when": ["Working with Linear issues (p. linear)"],
-      "tools": ["list_issues", "get_issue", "create_issue", "update_issue", "create_comment"],
-      "setup": ["OAuth via browser on first use"]
-    },
-    "Atlassian": {
-      "when": ["Working with JIRA issues (p. jira)", "Corporate SSO environments"],
-      "tools": ["jira_search_issues", "jira_get_issue", "jira_transition_issue", "jira_update_issue"],
-      "setup": ["OAuth via browser on first use"]
-    },
     "monday": {
       "when": ["Working with Monday.com boards (p. monday)"],
       "tools": ["create_item", "delete_item", "get_board_items_by_name", "change_item_column_values"],
@@ -54,5 +34,9 @@
       "tools": ["search_issues", "get_issue", "create_issue", "update_issue", "list_issues"],
       "setup": ["Set GITHUB_TOKEN env var with repo scope"]
     }
+  },
+  "deprecated": {
+    "linear": "Use SDK instead. Set LINEAR_API_KEY env var.",
+    "Atlassian": "Use SDK instead. Set JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN env vars."
   }
 }