haitask 0.1.6 → 0.3.3

package/.env.example

@@ -1,24 +1,27 @@
-# HAITASK — copy to .env and fill in
-# Set only the key for the provider you use in .haitaskrc (ai.provider)
-
-# Groq (FREE, fast): https://console.groq.com/keys
-GROQ_API_KEY=your-groq-api-key
-
-# Deepseek (FREE): https://platform.deepseek.com/
-DEEPSEEK_API_KEY=your-deepseek-api-key
-
-# OpenAI (paid): https://platform.openai.com/api-keys
-OPENAI_API_KEY=your-openai-api-key
-
-# Jira (required for creating issues)
-JIRA_BASE_URL=https://your-domain.atlassian.net
-JIRA_EMAIL=your@email.com
-JIRA_API_TOKEN=your-jira-api-token
-# Optional: assign new issues to you. Jira Cloud account ID: Profile → Account ID, or admin.atlassian.com → Directory → Users. If value contains ":", use quotes: JIRA_ACCOUNT_ID="id:uuid"
-JIRA_ACCOUNT_ID=your-account-id
-
-# Trello (when target is trello in .haitaskrc). Get key + token: https://trello.com/app-key
-TRELLO_API_KEY=your-trello-api-key
-TRELLO_TOKEN=your-trello-token
-# Optional: assign new cards to you (Trello member ID)
-TRELLO_MEMBER_ID=your-member-id
+# HAITASK — copy to .env and fill in
+# Set only the key for the provider you use in .haitaskrc (ai.provider)
+
+# Groq (FREE, fast): https://console.groq.com/keys
+GROQ_API_KEY=your-groq-api-key
+
+# Deepseek (FREE): https://platform.deepseek.com/
+DEEPSEEK_API_KEY=your-deepseek-api-key
+
+# OpenAI (paid): https://platform.openai.com/api-keys
+OPENAI_API_KEY=your-openai-api-key
+
+# Jira (required for creating issues)
+JIRA_BASE_URL=https://your-domain.atlassian.net
+JIRA_EMAIL=your@email.com
+JIRA_API_TOKEN=your-jira-api-token
+# Optional: assign new issues to you. Jira Cloud account ID: Profile → Account ID, or admin.atlassian.com → Directory → Users. If value contains ":", use quotes: JIRA_ACCOUNT_ID="id:uuid"
+JIRA_ACCOUNT_ID=your-account-id
+
+# Trello (when target is trello in .haitaskrc). Get key + token: https://trello.com/app-key
+TRELLO_API_KEY=your-trello-api-key
+TRELLO_TOKEN=your-trello-token
+# Optional: assign new cards to you (Trello member ID)
+TRELLO_MEMBER_ID=your-member-id
+
+# Linear (when target is linear in .haitaskrc). Get key: https://linear.app/settings/api
+LINEAR_API_KEY=your-linear-api-key

package/README.md

@@ -1,100 +1,119 @@
-# HAITASK
-
-Generate tasks from your latest Git commit using AI — in **Jira** or **Trello**. Reads commit message and branch, produces a structured task (title, description, labels) via an AI provider, and creates the issue/card in your chosen target. Framework- and language-agnostic: works with any Git repo.
-
-**Requirements:** Node.js >= 18
-
----
-
-## Install
-
-```bash
-npm install -g haitask
-```
-
-Or run without installing:
-
-```bash
-npx haitask
-```
-
-From source (clone then link):
-
-```bash
-git clone https://github.com/HidayetHidayetov/haitask.git && cd haitask && npm install && npm link
-```
-
----
-
-## Quick start
-
-1. **Per project (one-time)**  
-   In the Git repo where you want to create tasks:
-   ```bash
-   cd /path/to/your/repo
-   haitask init
-   ```
-   **Interactive setup:** choose **target** (1 = Jira, 2 = Trello), then target-specific options (Jira: base URL, project key, issue type, status; Trello: list ID, optional label IDs, member ID). You’ll also set AI provider (groq / deepseek / openai), allowed branches, and commit prefixes. A `.haitaskrc` file is created. Choose where to store API keys: **this project** (`.env`) or **global** (`~/.haitask/.env`). A template `.env` is created — add your keys there (never commit real keys).
-
-2. **Add your API keys**  
-   Edit the `.env` that was created:
-   - **AI:** one of `GROQ_API_KEY`, `DEEPSEEK_API_KEY`, `OPENAI_API_KEY`.
-   - **Jira** (when target is jira): `JIRA_BASE_URL`, `JIRA_EMAIL`, `JIRA_API_TOKEN`. Optional: `JIRA_ACCOUNT_ID`.
-   - **Trello** (when target is trello): `TRELLO_API_KEY`, `TRELLO_TOKEN`. Optional: `TRELLO_MEMBER_ID`. Get key + token at https://trello.com/app-key.
-
-3. **Create a task from the latest commit**  
-   After committing:
-   ```bash
-   haitask run
-   ```
-   Pipeline: read latest commit → validate branch/prefix → call AI → create task in Jira or Trello.  
-   To test without creating: `haitask run --dry`.
-
----
-
-## Commands
-
-| Command | Description |
-|--------|-------------|
-| `haitask init` | Interactive setup: target (Jira/Trello), then target + AI + rules → writes `.haitaskrc`, optional `.env`. |
-| `haitask run` | Run pipeline: Git → AI → target (create Jira issue or Trello card). |
-| `haitask run --dry` | Same as above but skips creating the task. |
-| `haitask run --type <type>` | (Jira only) Override issue type for this run (e.g. `Task`, `Bug`, `Story`). |
-| `haitask run --status <status>` | (Jira only) Override transition-to status after create (e.g. `Done`, `To Do`, `In Progress`). |
-
----
-
-## Configuration
-
-- **`.haitaskrc`** (project root): **`target`** (`jira` or `trello`); target-specific section (`jira` or `trello`); **`ai`** (`provider`, `model`); **`rules`** (`allowedBranches`, `commitPrefixes`). Single source of truth.
-- **`.env`**: API keys only. Loaded: **project** `.env`, then **global** `~/.haitask/.env`.
-
-**Target: Jira** — `jira.baseUrl`, `jira.projectKey`, `jira.issueType`, `jira.transitionToStatus`. Override issue type/status for one run: `haitask run --type Bug`, `haitask run --status "To Do"`. Optional assignee: `JIRA_ACCOUNT_ID` in `.env` (Jira Cloud account ID; use quotes if value contains `:`).
-
-**Target: Trello** — `trello.listId` (required: the list where new cards go; get from board URL or API). Optional: `trello.labelIds` (array of label IDs), `trello.memberId` or `TRELLO_MEMBER_ID` in `.env` for assignee. Get API key + token at https://trello.com/app-key.
-
-**AI providers** (`ai.provider`): `groq` (default, free), `deepseek` (free), `openai` (paid). Set the matching key in `.env`.
-
-**Rules:** If `allowedBranches` is non-empty, the current branch must be in the list. If `commitPrefixes` is non-empty, the commit message must start with one of them (e.g. `feat:`, `fix:`).
-
-**Task title:** The AI is instructed not to include commit-type prefixes (e.g. `feat:`) in the task title; the code strips them so the summary stays clean.
-
----
-
-## Usage patterns
-
-- **Global install:** `npm install -g haitask` → in any repo: `haitask init` once, then `haitask run` after commits.
-- **Per-project dev dependency:** `npm install haitask --save-dev` → `npx haitask run`.
-- **CI / scripts:** Run `npx haitask run` (or `haitask run` if installed) from the repo root; ensure `.haitaskrc` and env vars are available in that environment.
-
-No framework-specific setup (e.g. Laravel, React, etc.); the tool only depends on Git and the config files above.
-
----
-
-## Troubleshooting
-
-**Jira — assignee not set / still unassigned**  
-In Jira Cloud, the user in `JIRA_ACCOUNT_ID` must be an **Assignable user** in that project. Fix: **Project → Space settings → People** — add yourself (team-managed). For company-managed projects, ensure the permission scheme grants **Assignable user**. You can still assign manually in Jira.
-
-**Trello — list ID**  
-List ID is the ID of the list (column) where new cards are created. In Trello: open the board, click the list menu (⋯), “Copy list link” or “Copy link” — the URL contains the list ID. Or use the API: `GET https://api.trello.com/1/boards/{boardId}/lists?key=...&token=...` to list all list IDs.
+# HAITASK
+
+> Turn a Git commit into a task in Jira, Trello, or Linear — one command.
+
+HAITASK reads your latest commit message and branch, uses AI to shape a clear title and description, and creates the issue or card in the tool you use. No framework lock-in: works in any Git repo.
+
+**Requires:** Node.js 18+
+
+---
+
+## Install
+
+```bash
+npm install -g haitask
+```
+
+Run without installing:
+
+```bash
+npx haitask
+```
+
+---
+
+## Quick start
+
+**1. Configure (once)**  
+In your project root:
+
+```bash
+haitask init
+```
+
+Pick a target (1 = Jira, 2 = Trello, 3 = Linear) and answer the prompts. You get a `.haitaskrc` and an optional `.env` template.  
+**Quick mode:** `haitask init --quick` — fewer questions, sensible defaults.
+
+**2. Add API keys**  
+In the generated `.env`, set the keys for your target and AI provider:
+
+| Target  | Keys |
+|---------|------|
+| **Jira**  | `JIRA_BASE_URL`, `JIRA_EMAIL`, `JIRA_API_TOKEN` — [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens) |
+| **Trello** | `TRELLO_API_KEY`, `TRELLO_TOKEN` — [trello.com/app-key](https://trello.com/app-key) |
+| **Linear** | `LINEAR_API_KEY` — [linear.app/settings/api](https://linear.app/settings/api) |
+
+For AI, set one of: `GROQ_API_KEY`, `DEEPSEEK_API_KEY`, or `OPENAI_API_KEY` (default is Groq).
+
+**3. Create a task**  
+After you commit:
+
+```bash
+haitask run
+```
+
+To try without creating a task: `haitask run --dry`.
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `haitask init` | Interactive setup: target, AI, rules → writes `.haitaskrc` and optional `.env` |
+| `haitask init --quick` | Minimal prompts: target + required fields only; defaults for AI, branches, prefixes |
+| `haitask check` | Validate `.haitaskrc` + required env keys without running the pipeline |
+| `haitask run` | Creates a task from the latest commit (Jira / Trello / Linear) |
+| `haitask run --dry` | Same flow, but does not create a task |
+| `haitask run --commits N` | Combine the last N commits into one task (e.g. `--commits 3`) |
+| `haitask run --type <type>` | (Jira only) Override issue type for this run (Task, Bug, Story) |
+| `haitask run --status <status>` | (Jira only) Override status after create (Done, "To Do", etc.) |
+
+---
+
+## Configuration
+
+- **`.haitaskrc`** — `target` (jira / trello / linear), target-specific options, `ai` (provider, model), `rules` (allowedBranches, commitPrefixes).
+- **`.env`** — API keys only. Load order: project `.env` then `~/.haitask/.env`.
+
+**Security:** Keys live only in `.env` (do not commit it). They are sent only to the services you use: your target (Jira/Trello/Linear) and your chosen AI provider.
+
+**Jira:** `jira.baseUrl`, `jira.projectKey`, `jira.issueType`, `jira.transitionToStatus`. Optional assignee: `JIRA_ACCOUNT_ID` in `.env`.
+
+**Trello:** `trello.listId` (required — the list where new cards go). To get the list ID: open the board → **⋯** on the list header → “Copy list link” → the 24-character ID is in the URL. From the haitask repo you can run `node scripts/get-trello-list.js` (with Trello keys in `.env`) to print the first list ID.
+
+**Linear:** `linear.teamId` (required). In Linear: Team → Settings → copy Team ID.
+
+**AI:** `groq` (free), `deepseek` (free), `openai` (paid). Set the matching key in `.env`.
+
+**Rules:** If `allowedBranches` or `commitPrefixes` are set, the current branch and commit message are checked. If the commit message contains an issue key (e.g. `PROJ-123`, `ENG-42`), haitask adds a comment to that issue instead of creating a new task; set `rules.linkToExistingIssue: false` in `.haitaskrc` to always create new tasks.
+
+---
+
+## Usage
+
+- **Global:** `npm install -g haitask` → run `haitask init` once per repo, then `haitask run` after commits.
+- **Per project:** `npm install haitask --save-dev` → `npx haitask run`.
+- **CI / scripts:** Run `npx haitask run` from the repo root; ensure `.haitaskrc` and env vars are available.
+
+---
+
+## Roadmap
+
+- ✅ **Batch** — `haitask run --commits N`
+- ✅ **Link to existing issue** — commit message with issue key (e.g. PROJ-123) → comment on that issue
+- ✅ **Linear** — target `linear`, `linear.teamId`, `LINEAR_API_KEY`
+- 🔜 More targets (same adapter pattern)
+
+---
+
+## Troubleshooting
+
+**Jira — assignee not set**  
+The user in `JIRA_ACCOUNT_ID` must be an assignable user in that project. In Jira: Project → Space settings → People, or assign manually.
+
+**Trello — list ID**  
+You need the 24-character hex list ID. Open the board → **⋯** on the list → “Copy list link” → use the ID from the URL as `trello.listId`. Or run `node scripts/get-trello-list.js` from the haitask repo (Trello keys in `.env`).
+
+**Linear — team ID or API key**  
+Copy Team ID from Linear → Team → Settings. Create an API key at [linear.app/settings/api](https://linear.app/settings/api) and set `LINEAR_API_KEY` in `.env`.

package/package.json

@@ -1,44 +1,47 @@
-{
-  "name": "haitask",
-  "version": "0.1.6",
-  "description": "HAITASK — AI-powered task creation from Git commits. Creates issues in Jira or Trello from your latest commit message and branch.",
-  "type": "module",
-  "main": "src/index.js",
-  "bin": {
-    "haitask": "src/index.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "src",
-    "README.md",
-    ".env.example"
-  ],
-  "scripts": {
-    "start": "node src/index.js",
-    "init": "node src/index.js init",
-    "run": "node src/index.js run"
-  },
-  "keywords": [
-    "cli",
-    "jira",
-    "git",
-    "ai",
-    "automation",
-    "commit",
-    "task"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/HidayetHidayetov/haitask.git"
-  },
-  "homepage": "https://github.com/HidayetHidayetov/haitask#readme",
-  "bugs": "https://github.com/HidayetHidayetov/haitask/issues",
-  "dependencies": {
-    "commander": "^12.0.0",
-    "dotenv": "^16.4.5",
-    "execa": "^9.5.2"
-  }
-}
+{
+  "name": "haitask",
+  "version": "0.3.3",
+  "description": "HAITASK — AI-powered task creation from Git commits. Creates issues in Jira, Trello, or Linear from your latest commit message and branch.",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "haitask": "src/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "src",
+    "README.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "init": "node src/index.js init",
+    "run": "node src/index.js run",
+    "test": "node --test test/*.test.js"
+  },
+  "keywords": [
+    "cli",
+    "jira",
+    "trello",
+    "linear",
+    "git",
+    "ai",
+    "automation",
+    "commit",
+    "task"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HidayetHidayetov/haitask.git"
+  },
+  "homepage": "https://github.com/HidayetHidayetov/haitask#readme",
+  "bugs": "https://github.com/HidayetHidayetov/haitask/issues",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "dotenv": "^16.4.5",
+    "execa": "^9.5.2"
+  }
+}

package/src/ai/deepseek.js

@@ -1,54 +1,54 @@
-/**
- * Deepseek Chat provider (free tier, JSON mode supported).
- * API: https://api.deepseek.com/v1/chat/completions
- * Docs: https://platform.deepseek.com/api-docs/
- */
-
-import { buildPrompt, parseTaskPayload } from './utils.js';
-
-const DEEPSEEK_API_URL = 'https://api.deepseek.com/v1/chat/completions';
-
-/**
- * Call Deepseek and return task payload for Jira.
- * @param {{ message: string, branch: string, repoName: string }} commitData
- * @param {{ ai: { model?: string } }} config
- * @returns {Promise<{ title: string, description: string, labels: string[] }>}
- */
-export async function generateDeepseek(commitData, config) {
-  const apiKey = process.env.DEEPSEEK_API_KEY;
-  if (!apiKey?.trim()) {
-    throw new Error('DEEPSEEK_API_KEY is not set. Add it to .env. Get free key at https://platform.deepseek.com/');
-  }
-
-  const model = config?.ai?.model || 'deepseek-chat';
-  const { system, user } = buildPrompt(commitData);
-
-  const response = await fetch(DEEPSEEK_API_URL, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${apiKey}`,
-    },
-    body: JSON.stringify({
-      model,
-      messages: [
-        { role: 'system', content: system },
-        { role: 'user', content: user },
-      ],
-      response_format: { type: 'json_object' },
-    }),
-  });
-
-  if (!response.ok) {
-    const body = await response.text();
-    throw new Error(`Deepseek API error ${response.status}: ${body || response.statusText}`);
-  }
-
-  const data = await response.json();
-  const content = data?.choices?.[0]?.message?.content;
-  if (typeof content !== 'string') {
-    throw new Error('Deepseek response missing choices[0].message.content');
-  }
-
-  return parseTaskPayload(content.trim());
-}
+/**
+ * Deepseek Chat provider (free tier, JSON mode supported).
+ * API: https://api.deepseek.com/v1/chat/completions
+ * Docs: https://platform.deepseek.com/api-docs/
+ */
+
+import { buildPrompt, parseTaskPayload } from './utils.js';
+
+const DEEPSEEK_API_URL = 'https://api.deepseek.com/v1/chat/completions';
+
+/**
+ * Call Deepseek and return task payload for Jira.
+ * @param {{ message: string, branch: string, repoName: string }} commitData
+ * @param {{ ai: { model?: string } }} config
+ * @returns {Promise<{ title: string, description: string, labels: string[] }>}
+ */
+export async function generateDeepseek(commitData, config) {
+  const apiKey = process.env.DEEPSEEK_API_KEY;
+  if (!apiKey?.trim()) {
+    throw new Error('DEEPSEEK_API_KEY is not set. Add it to .env. Get free key at https://platform.deepseek.com/');
+  }
+
+  const model = config?.ai?.model || 'deepseek-chat';
+  const { system, user } = buildPrompt(commitData);
+
+  const response = await fetch(DEEPSEEK_API_URL, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({
+      model,
+      messages: [
+        { role: 'system', content: system },
+        { role: 'user', content: user },
+      ],
+      response_format: { type: 'json_object' },
+    }),
+  });
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Deepseek API error ${response.status}: ${body || response.statusText}`);
+  }
+
+  const data = await response.json();
+  const content = data?.choices?.[0]?.message?.content;
+  if (typeof content !== 'string') {
+    throw new Error('Deepseek response missing choices[0].message.content');
+  }
+
+  return parseTaskPayload(content.trim());
+}

package/src/ai/groq.js

@@ -1,56 +1,56 @@
-/**
- * Groq provider (free tier, fast inference).
- * API: https://api.groq.com/openai/v1/chat/completions (OpenAI-compatible)
- * Docs: https://console.groq.com/docs
- */
-
-import { buildPrompt, parseTaskPayload } from './utils.js';
-
-const GROQ_API_URL = 'https://api.groq.com/openai/v1/chat/completions';
-
-/**
- * Call Groq and return task payload for Jira.
- * @param {{ message: string, branch: string, repoName: string }} commitData
- * @param {{ ai: { model?: string } }} config
- * @returns {Promise<{ title: string, description: string, labels: string[] }>}
- */
-export async function generateGroq(commitData, config) {
-  const apiKey = process.env.GROQ_API_KEY;
-  if (!apiKey?.trim()) {
-    throw new Error(
-      'GROQ_API_KEY is not set. Add it to .env. Get free key at https://console.groq.com/keys'
-    );
-  }
-
-  const model = config?.ai?.model || 'llama-3.1-8b-instant';
-  const { system, user } = buildPrompt(commitData);
-
-  const response = await fetch(GROQ_API_URL, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${apiKey}`,
-    },
-    body: JSON.stringify({
-      model,
-      messages: [
-        { role: 'system', content: system },
-        { role: 'user', content: user },
-      ],
-      response_format: { type: 'json_object' },
-    }),
-  });
-
-  if (!response.ok) {
-    const body = await response.text();
-    throw new Error(`Groq API error ${response.status}: ${body || response.statusText}`);
-  }
-
-  const data = await response.json();
-  const content = data?.choices?.[0]?.message?.content;
-  if (typeof content !== 'string') {
-    throw new Error('Groq response missing choices[0].message.content');
-  }
-
-  return parseTaskPayload(content.trim());
-}
+/**
+ * Groq provider (free tier, fast inference).
+ * API: https://api.groq.com/openai/v1/chat/completions (OpenAI-compatible)
+ * Docs: https://console.groq.com/docs
+ */
+
+import { buildPrompt, parseTaskPayload } from './utils.js';
+
+const GROQ_API_URL = 'https://api.groq.com/openai/v1/chat/completions';
+
+/**
+ * Call Groq and return task payload for Jira.
+ * @param {{ message: string, branch: string, repoName: string }} commitData
+ * @param {{ ai: { model?: string } }} config
+ * @returns {Promise<{ title: string, description: string, labels: string[] }>}
+ */
+export async function generateGroq(commitData, config) {
+  const apiKey = process.env.GROQ_API_KEY;
+  if (!apiKey?.trim()) {
+    throw new Error(
+      'GROQ_API_KEY is not set. Add it to .env. Get free key at https://console.groq.com/keys'
+    );
+  }
+
+  const model = config?.ai?.model || 'llama-3.1-8b-instant';
+  const { system, user } = buildPrompt(commitData);
+
+  const response = await fetch(GROQ_API_URL, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({
+      model,
+      messages: [
+        { role: 'system', content: system },
+        { role: 'user', content: user },
+      ],
+      response_format: { type: 'json_object' },
+    }),
+  });
+
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Groq API error ${response.status}: ${body || response.statusText}`);
+  }
+
+  const data = await response.json();
+  const content = data?.choices?.[0]?.message?.content;
+  if (typeof content !== 'string') {
+    throw new Error('Groq response missing choices[0].message.content');
+  }
+
+  return parseTaskPayload(content.trim());
+}