prjct-cli 1.22.0 → 1.24.0

package/templates/commands/init.md

@@ -1,54 +0,0 @@
----
-allowed-tools: [Read, Write, Bash, AskUserQuestion]
----
-
-# p. init
-
-Check if already initialized (`.prjct/prjct.config.json` exists)
-
-Generate UUID: `crypto.randomUUID()`
-
-Create directories in `~/.prjct-cli/projects/{projectId}/`:
-- storage/ (state.json, queue.json, ideas.json, shipped.json)
-- context/
-- sync/
-- agents/
-- memory/
-
-Create `.prjct/prjct.config.json`:
-```json
-{"projectId": "{uuid}", "dataPath": "~/.prjct-cli/projects/{uuid}"}
-```
-
-Create `{globalPath}/project.json` with project name from package.json
-
-## Cursor IDE Detection
-
-If `.cursor/` directory exists in project:
-1. Ask: "Cursor IDE detected. Configure prjct for Cursor?"
-2. If yes:
-   - Get npm root: `npm root -g`
-   - Copy router: `{npmRoot}/prjct-cli/templates/cursor/router.mdc` → `.cursor/rules/prjct.mdc`
-   - Copy commands: `{npmRoot}/prjct-cli/templates/cursor/p.md` → `.cursor/commands/p.md`
-   - Add to `.gitignore`:
-     ```
-     # prjct Cursor routers (regenerated per-developer)
-     .cursor/rules/prjct.mdc
-     .cursor/commands/p.md
-     ```
-
-Optional: Ask about JIRA/Linear integration
-
-**Output**:
-```
-✅ Initialized prjct
-
-Project ID: {uuid}
-Data: ~/.prjct-cli/projects/{uuid}/
-Cursor: {configured/not detected}
-
-Next:
-- Analyze project → `p. sync`
-- Start first task → `p. task "description"`
-- See help → `p. help`
-```

package/templates/commands/jira.md

@@ -1,278 +0,0 @@
----
-allowed-tools: [Read, Write, Bash, AskUserQuestion]
-description: 'JIRA issue tracker integration via REST API'
----
-
-# p. jira - JIRA Integration
-
-**ARGUMENTS**: $ARGUMENTS
-
----
-
-Manage JIRA issues directly from prjct using the REST API for fast performance.
-
-## Context Variables
-
-- `{projectId}`: From `.prjct/prjct.config.json`
-- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
-- `{args}`: User-provided arguments (subcommand)
-
----
-
-## Subcommands
-
-| Command | Description |
-|---------|-------------|
-| `p. jira` | Show status + your assigned issues |
-| `p. jira setup` | Configure JIRA credentials (REQUIRED FIRST) |
-| `p. jira sync` | Fetch your assigned issues |
-| `p. jira start <KEY>` | Start working on issue (e.g., PROJ-123) |
-
----
-
-## Authentication
-
-JIRA uses API Token authentication for fast REST API access.
-
-**Required Environment Variables:**
-```bash
-export JIRA_BASE_URL="https://company.atlassian.net"
-export JIRA_EMAIL="you@company.com"
-export JIRA_API_TOKEN="your-token"
-```
-
-**Get API Token**: https://id.atlassian.com/manage-profile/security/api-tokens
-
----
-
-## Step 1: Validate Project
-
-```
-READ: .prjct/prjct.config.json
-EXTRACT: projectId
-SET: globalPath = ~/.prjct-cli/projects/{projectId}
-
-IF file not found:
-  OUTPUT: "No prjct project. Run `p. init` first."
-  STOP
-```
-
----
-
-## Step 2: Check Credentials
-
-```
-CHECK: Are JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN set?
-
-IF not all set:
-  ASK: "Enter your JIRA credentials"
-
-  PROMPT FOR:
-  - JIRA_BASE_URL: "Your JIRA instance URL (e.g., https://company.atlassian.net)"
-  - JIRA_EMAIL: "Your Atlassian account email"
-  - JIRA_API_TOKEN: "API token from https://id.atlassian.com/manage-profile/security/api-tokens"
-
-  OUTPUT: "Add to your shell profile:"
-  OUTPUT: "export JIRA_BASE_URL='https://company.atlassian.net'"
-  OUTPUT: "export JIRA_EMAIL='you@company.com'"
-  OUTPUT: "export JIRA_API_TOKEN='your-token'"
-```
-
----
-
-## Subcommand: setup
-
-### Flow
-
-1. **Check for credentials**
-   ```
-   IF any of JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN missing:
-     ASK: Collect missing credentials
-     PROVIDE: Link to https://id.atlassian.com/manage-profile/security/api-tokens
-   ```
-
-2. **Test REST API connection**
-   ```
-   IMPORT: jiraService from core/integrations/jira
-   CALL: jiraService.initializeFromCredentials(baseUrl, email, token)
-
-   # This will verify the connection
-   ```
-
-3. **Get available projects**
-   ```
-   CALL: jiraService.getProjects()
-   EXTRACT: List of projects with id, name, key
-   ```
-
-4. **Ask user to select default project**
-   ```
-   ASK: "Select your default project"
-   OPTIONS: List of projects
-   ```
-
-5. **Save config to project.json**
-   ```json
-   {
-     "integrations": {
-       "jira": {
-         "enabled": true,
-         "provider": "jira",
-         "authMode": "api-token",
-         "baseUrl": "{baseUrl}",
-         "projectKey": "{projectKey}",
-         "projectName": "{projectName}",
-         "setupAt": "{timestamp}"
-       }
-     }
-   }
-   ```
-
-### Output
-
-```
-JIRA configured
-
-Instance: {baseUrl}
-Project: {projectKey} - {projectName}
-Auth: API Token (REST)
-
-Next: `p. jira` to see your issues
-```
-
----
-
-## Subcommand: status (default, no args)
-
-```
-CALL: jiraService.fetchAssignedIssues({ limit: 10 })
-
-OUTPUT:
-JIRA: Connected
-Project: {projectKey}
-
-Your issues ({count}):
-  {PROJ-123} {title} ({status})
-  {PROJ-124} {title} ({status})
-...
-
-Next: `p. jira start PROJ-123` to begin work
-```
-
----
-
-## Subcommand: sync
-
-```
-1. Fetch all assigned issues
-   CALL: jiraService.fetchAssignedIssues({ limit: 50 })
-
-2. Save to {globalPath}/storage/issues.json
-
-3. Show summary
-
-OUTPUT:
-Synced {count} issues from JIRA.
-
-Next: `p. jira start <KEY>` to begin work
-```
-
----
-
-## Subcommand: start <KEY>
-
-```
-1. Fetch issue by key
-   CALL: jiraService.fetchIssue("{KEY}")
-   EXTRACT: id, title, description, status
-
-2. Transition to "In Progress" in JIRA
-   CALL: jiraService.markInProgress("{KEY}")
-
-3. Create prjct task from issue
-   - Use issue title as task description
-   - Link externalId to JIRA issue
-
-4. Create git branch
-   PATTERN: {type}/{KEY}-{slug}
-   EXAMPLE: feature/PROJ-123-add-user-auth
-
-OUTPUT:
-Started: {KEY} - {title}
-
-Branch: feature/PROJ-123-add-user-auth
-JIRA: In Progress
-
-Next: Work on the task, then `p. done`
-```
-
----
-
-## SDK Service Reference
-
-The `jiraService` from `core/integrations/jira` provides:
-
-| Operation | SDK Method |
-|-----------|------------|
-| Initialize | `jiraService.initializeFromCredentials(url, email, token, project?)` |
-| List assigned | `jiraService.fetchAssignedIssues(options?)` |
-| List project issues | `jiraService.fetchProjectIssues(projectKey, options?)` |
-| Get issue | `jiraService.fetchIssue(key)` |
-| Create issue | `jiraService.createIssue(input)` |
-| Update issue | `jiraService.updateIssue(key, input)` |
-| Mark in progress | `jiraService.markInProgress(key)` |
-| Mark done | `jiraService.markDone(key)` |
-| Get projects | `jiraService.getProjects()` |
-
-### Caching
-
-All read operations are cached for 5 minutes:
-- Issues are cached by ID and key (e.g., "PROJ-123")
-- Assigned issues list is cached per user
-- Projects are cached globally
-
-Cache is automatically invalidated on writes (create, update, status changes).
-
----
-
-## Credential Storage
-
-| What | Where |
-|------|-------|
-| Credentials | Environment variables: `JIRA_BASE_URL`, `JIRA_EMAIL`, `JIRA_API_TOKEN` |
-| Config | `{globalPath}/project.json` → `integrations.jira` |
-
----
-
-## Error Handling
-
-| Error | Action |
-|-------|--------|
-| Missing credentials | "Set JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN or run `p. jira setup`" |
-| Invalid credentials | "Check your credentials at https://id.atlassian.com/manage-profile/security" |
-| Issue not found | "Issue {KEY} not found in JIRA" |
-| Network error | "Check your internet connection" |
-
----
-
-## Output Format
-
-```
-{action}: {result}
-
-{details}
-
-Next: {suggested action}
-```
-
----
-
-## Performance
-
-REST API operations are fast and cached:
-
-| Operation | REST API |
-|-----------|----------|
-| Fetch issue | ~200ms |
-| List issues | ~300ms |
-| Transition | ~250ms |

package/templates/commands/linear.md

@@ -1,288 +0,0 @@
----
-allowed-tools: [Read, Write, Bash, AskUserQuestion]
-description: 'Linear issue tracker integration via SDK'
----
-
-# p. linear - Linear Integration
-
-**ARGUMENTS**: $ARGUMENTS
-
----
-
-## Quick Reference
-
-| Command | What it does |
-|---------|--------------|
-| `p. linear` | List my assigned issues |
-| `p. linear setup` | Configure API key (NOT MCP, just API key) |
-| `p. linear 123` | Get issue details |
-| `p. linear start 123` | Start working on issue |
-| `p. linear done 123` | Mark issue as done |
-
----
-
-## Execution Method: SDK CLI
-
-All commands use this CLI helper (NOT MCP tools):
-
-```bash
-PRJCT_CLI=$(npm root -g)/prjct-cli
-PROJECT_ID=$(cat .prjct/prjct.config.json | jq -r '.projectId')
-bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID <command> [args...]
-```
-
----
-
-## Step 1: Validate Project
-
-```
-READ: .prjct/prjct.config.json
-EXTRACT: projectId
-SET: globalPath = ~/.prjct-cli/projects/{projectId}
-
-IF file not found:
-  OUTPUT: "No prjct project. Run `p. init` first."
-  STOP
-```
-
----
-
-## Step 2: Parse User Intent
-
-Analyze $ARGUMENTS to determine what user wants:
-
-| 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` |
-
-**Identifier normalization**: If user types `123`, check project config for team key and expand to `PRJ-123`.
-
----
-
-## Subcommand: setup
-
-**Trigger**: `p. linear setup`
-
-### Flow
-
-1. **Ask for API key**
-   ```
-   ASK: "Enter your Linear API key"
-   HINT: "Get it from https://linear.app/settings/api"
-   ```
-
-2. **Store and test via CLI**
-   ```bash
-   RESULT=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID setup "$API_KEY")
-   ```
-
-3. **Parse result** - Contains `{ success, teams, defaultTeam }`
-
-4. **If multiple teams, ask user to select**
-   ```
-   ASK: "Select your default team"
-   OPTIONS: teams from result
-
-   # Re-run setup with team selection
-   bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID setup "$API_KEY" "$TEAM_ID"
-   ```
-
-### Output
-
-```
-✅ Linear configured
-
-Team: {teamName} ({teamKey})
-Credentials: Stored per-project
-
-Next: `p. linear` to see your issues
-```
-
----
-
-## Subcommand: list (default)
-
-**Trigger**: `p. linear` (no arguments)
-
-```bash
-RESULT=$(bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID list)
-```
-
-### Output
-
-```
-Linear: Connected
-
-Your issues (5):
-  PRJ-123  Add user authentication     In Progress
-  PRJ-124  Fix login redirect          Todo
-  PRJ-125  Update dependencies         Backlog
-  ...
-
-Next: `p. linear 123` for details, `p. linear start 123` to begin
-```
-
----
-
-## 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")
-```
-
-### Output
-
-```
-PRJ-123: Add user authentication
-
-Status: In Progress
-Priority: High
-Assignee: @user
-
-Description:
-{description text}
-
-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: done <ID>
-
-**Trigger**: `p. linear done 123`
-
-```bash
-bun $PRJCT_CLI/core/cli/linear.ts --project $PROJECT_ID done "PRJ-123"
-```
-
-### Output
-
-```
-✅ Completed: PRJ-123 - {title}
-
-Linear: Done
-```
-
----
-
-## Subcommand: create
-
-**Trigger**: `p. linear "add feature X"` or `p. linear create "title"`
-
-```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":"..."}')
-```
-
-### Output
-
-```
-✅ Created: PRJ-126 - {title}
-
-URL: https://linear.app/...
-
-Next: `p. linear start 126` to begin
-```
-
----
-
-## 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..."
-```
-
-### Output
-
-```
-✅ Comment added to PRJ-123
-```
-
----
-
-## Subcommand: update <ID>
-
-**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 | 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" |
-
----
-
-## Credential Storage
-
-Credentials are stored **per-project** to support multiple Linear workspaces:
-
-**Location**: `~/.prjct-cli/projects/{projectId}/config/credentials.json`
-
-**Fallback chain**:
-1. Project credentials (per-project)
-2. Global keychain (macOS)
-3. Environment variable (`LINEAR_API_KEY`)
-
----
-
-## Performance
-
-| Operation | Time |
-|-----------|------|
-| Fetch issue | ~150ms |
-| List issues | ~300ms |
-| Create issue | ~200ms |