jira-subtask-cli 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sayali
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# Jira Subtask CLI
+
+A lightweight **Node.js CLI utility** to automatically create standard **DEV / QA / UX Jira sub-tasks** for a parent Jira issue — without requiring Jira Automation or admin access.
+
+This tool is designed to save time for **developers and testers** by eliminating repetitive manual sub-task creation.
+
+---
+
+## ✨ Features
+
+- Create multiple Jira sub-tasks using **one command**
+- Works without **Jira Automation** or Jira admin permissions
+- Globally installable via `npm`
+- User-editable configuration and task templates
+- Cross-platform support (Windows / macOS / Linux)
+- Uses Jira **Cloud REST APIs**
+
+---
+
+## 📋 Default Sub-tasks Created
+
+By default, the utility creates the following sub-tasks:
+
+- DEV – Story Analysis
+- DEV – Code Changes
+- DEV – Unit Testing
+- DEV – Dev Testing
+- QA – Functional Testing
+- DEV – Buddy Testing *(unassigned)*
+- UX Review *(unassigned)*
+
+> Sub-tasks can be freely customized by editing `tasks.json`.
+
+---
+
+## 🧰 Prerequisites
+
+- **Node.js 18+**
+- **npm**
+- Jira **Cloud** account (`*.atlassian.net`)
+- Jira **API Token**
+
+Check versions:
+```bash
+node -v
+npm -v
+
+🚀 Installation (Global)
+
+Install directly fusing below command:
+npm install -g https://github.com/sayaligp/Jira_Subtask_Utility.git
+
+
+Verify installation:
+jira-subtask
+
+
+Expected output:
+❌ Usage: jira-subtask <ISSUE-KEY> [--dev-only | --qa-only | --skip-ux]
+
+⚙️ First-time Setup
+On first execution, the utility automatically creates user-specific files:
+
+jira-subtask ABC-1
+
+This creates:
+
+~/.jira-subtask/
+├── config.json
+└── tasks.json
+
+🔐 Configure Jira Credentials
+
+Open the config file:
+
+jira-subtask config
+
+Update it with your Jira details:
+
+{
+  "baseUrl": "https://yourcompany.atlassian.net",
+  "email": "your.email@company.com",
+  "apiToken": "YOUR_JIRA_API_TOKEN",
+  "projectId": "your project id"
+}
+
+Configuration notes
+
+email → Jira login email
+apiToken → Jira API token (NOT your password)
+projectId → Jira project ID (not project key)
+
+Create an API token here:
+https://id.atlassian.com/manage-profile/security/api-tokens
+
+📝 Customize Sub-tasks (Optional)
+Open task template file:
+jira-subtask tasks
+
+Each task entry looks like:
+
+{
+  "type": "DEV",
+  "summary": "[DEV] Code Changes",
+  "description": "Implement required code changes",
+  "assignee": "SELF"
+}
+
+Assignee behavior
+"SELF" → assigned to the current user
+"NONE" → created unassigned
+
+▶️ Usage
+Create all sub-tasks (DEV + QA + UX)
+jira-subtask ABC-123
+
+Create DEV + UX sub-tasks only
+jira-subtask ABC-123 --dev-only
+
+Create QA sub-tasks only
+jira-subtask ABC-123 --qa-only
+
+Create DEV sub-tasks only (without UX)
+jira-subtask ABC-123 --skip-ux
+
+
+⚠️ Only one flag at a time is supported.
+
+🧪 Sample Output
+Fetching Jira account...
+🚀 Creating 6 sub-tasks for ABC-123
+✅ ABC-201 → [DEV] Code Changes
+✅ ABC-202 → [QA] Functional Testing
+🎉 Done!
+
+
+🧯 Troubleshooting
+❌ 401 Unauthorized
+Ensure API token is correct
+Email must match Jira login email
+Verify credentials using:
+curl -u email:token https://yourcompany.atlassian.net/rest/api/3/myself
+
+🔐 Security
+No credentials are committed to the repository
+Each user uses their own Jira API token
+Tokens are stored locally on the user’s machine
+
+📌 Notes
+Works only with Jira Cloud
+No Jira admin permissions required
+Intended for internal team productivity

package/bin/jira-subtask.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+import { exec } from "child_process";
+import { ensureUserFiles, loadConfig, loadTasks, CONFIG_PATH, TASKS_PATH } from "../src/config.js";
+import { getMyAccountId, createSubtask } from "../src/jira.js";
+
+// Ensure user files exist
+ensureUserFiles();
+
+const args = process.argv.slice(2);
+
+/**
+ * ------------------------------------
+ * HELPER COMMANDS (NEW)
+ * ------------------------------------
+ */
+if (args[0] === "config") {
+const editor = process.env.EDITOR || "notepad";
+exec(`"${editor}" "${CONFIG_PATH}"`);
+process.exit(0);
+}
+
+if (args[0] === "tasks") {
+const editor = process.env.EDITOR || "notepad";
+exec(`"${editor}" "${TASKS_PATH}"`);
+process.exit(0);
+}
+
+
+const parentKey = args[0];
+
+const devOnly = args.includes("--dev-only");
+const qaOnly = args.includes("--qa-only");
+const skipUx = args.includes("--skip-ux");
+
+// Validate input
+if (!parentKey) {
+  console.error(
+    "Usage: jira-subtask <ISSUE-KEY> [--dev-only | --qa-only | --skip-ux]"
+  );
+  process.exit(1);
+}
+
+// Only one flag allowed
+const flagCount = [devOnly, qaOnly, skipUx].filter(Boolean).length;
+if (flagCount > 1) {
+  console.error(
+    "Only one flag is allowed: --dev-only OR --qa-only OR --skip-ux"
+  );
+  process.exit(1);
+}
+
+const config = loadConfig();
+const tasks = loadTasks();
+
+// --------------------
+// FINAL FILTER LOGIC
+// --------------------
+let filteredTasks;
+
+if (devOnly) {
+  // DEV + UX
+  filteredTasks = tasks.filter(
+    t => t.type === "DEV" || t.type === "UX"
+  );
+} else if (qaOnly) {
+  // QA only
+  filteredTasks = tasks.filter(t => t.type === "QA");
+} else if (skipUx) {
+  // DEV only
+  filteredTasks = tasks.filter(t => t.type === "DEV");
+} else {
+  // DEV + QA + UX
+  filteredTasks = tasks;
+}
+
+if (filteredTasks.length === 0) {
+  console.log("No tasks to create.");
+  process.exit(0);
+}
+
+// --------------------
+// Execute
+// --------------------
+(async () => {
+  try {
+    console.log("Fetching Jira account...");
+    const myAccountId = await getMyAccountId();
+
+    console.log(
+      `Creating ${filteredTasks.length} sub-tasks for ${parentKey}`
+    );
+
+    for (const task of filteredTasks) {
+      let assigneeId = null;
+      if(task.assignee === "SELF"){
+        assigneeId = myAccountId;
+      }
+         
+
+      const key = await createSubtask(parentKey, task, assigneeId);
+      console.log(`${key} → ${task.summary}`);
+    }
+
+    console.log("Done!");
+  } catch (err) {
+    console.error(
+      "Error:",
+      err.response?.data?.errorMessages || err.message
+    );
+    process.exit(1);
+  }
+})();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "jira-subtask-cli",
+  "version": "1.0.1",
+  "description": "CLI to auto-create Jira sub-tasks",
+  "bin": {
+    "jira-subtask": "./bin/jira-subtask.js"
+  },
+  "type": "module",
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates"
+  ],
+  "keywords": [
+    "jira",
+    "cli",
+    "automation"
+  ],
+  "author": "Sayali Pokharkar",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sayaligp/Jira_Subtask_Utility.git"
+  }
+}

package/src/config.js

@@ -0,0 +1,39 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const BASE_DIR = path.join(os.homedir(), ".jira-subtask");
+const CONFIG_PATH = path.join(BASE_DIR, "config.json");
+const TASKS_PATH = path.join(BASE_DIR, "tasks.json");
+
+const DEFAULT_CONFIG = path.join(__dirname, "../templates/config.default.json");
+const DEFAULT_TASKS = path.join(__dirname, "../templates/tasks.default.json");
+
+export function ensureUserFiles() {
+  if (!fs.existsSync(BASE_DIR)) {
+    fs.mkdirSync(BASE_DIR);
+  }
+
+  if (!fs.existsSync(CONFIG_PATH)) {
+    fs.copyFileSync(DEFAULT_CONFIG, CONFIG_PATH);
+    console.log("📄 config.json created at ~/.jira-subtask (please update it)");
+  }
+
+  if (!fs.existsSync(TASKS_PATH)) {
+    fs.copyFileSync(DEFAULT_TASKS, TASKS_PATH);
+    console.log("📄 tasks.json created at ~/.jira-subtask (editable)");
+  }
+}
+
+export function loadConfig() {
+  return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
+}
+
+export function loadTasks() {
+  return JSON.parse(fs.readFileSync(TASKS_PATH, "utf-8"));
+}
+
+export { CONFIG_PATH, TASKS_PATH };

package/src/jira.js

@@ -0,0 +1,57 @@
+import axios from "axios";
+import { loadConfig } from "./config.js";
+
+export async function getMyAccountId() {
+  const config = loadConfig();
+
+  const res = await axios.get(
+    `${config.baseUrl}/rest/api/3/myself`,
+    {
+      auth: {
+        username: config.email,
+        password: config.apiToken
+      }
+    }
+  );
+
+  return res.data.accountId;
+}
+
+export async function createSubtask(parentKey, task, assigneeId) {
+  const config = loadConfig();
+
+  
+  const fields= {
+    project: { id: config.projectId },
+    parent: { key: parentKey },
+    issuetype: { name: "Sub-task" },
+    summary: task.summary,
+    description: {
+      type: "doc",
+      version: 1,
+      content: [
+        {
+          type: "paragraph",
+          content: [{ type: "text", text: task.description }]
+        }
+      ]
+    },
+  }
+
+  if(assigneeId){
+    fields.assignee= { id: assigneeId }
+  }
+  const payload = {fields};
+  const res = await axios.post(
+    `${config.baseUrl}/rest/api/3/issue`,
+    payload,
+    {
+      auth: {
+        username: config.email,
+        password: config.apiToken
+      }
+    }
+  );
+
+  return res.data.key;
+}

package/templates/config.default.json

@@ -0,0 +1,7 @@
+{
+    "baseUrl": "https://yourcompany.atlassian.net",
+    "email": "your_email",
+    "apiToken": "your_api_token",
+    "projectId": "your_proj_id"
+  }
+  

package/templates/tasks.default.json

@@ -0,0 +1,45 @@
+[
+    {
+      "type": "DEV",
+      "summary": "[DEV] Story Analysis",
+      "description": "Analyze requirements and acceptance criteria",
+      "assignee": "SELF"
+    },
+    {
+      "type": "DEV",
+      "summary": "[DEV] Code Changes",
+      "description": "Implement and commit required code changes",
+      "assignee": "SELF"
+    },
+    {
+      "type": "DEV",
+      "summary": "[DEV] Unit Testing",
+      "description": "Write and execute unit tests",
+      "assignee": "SELF"
+    },
+    {
+      "type": "DEV",
+      "summary": "[DEV] Dev Testing",
+      "description": "Perform functional testing",
+      "assignee": "SELF"
+    },
+    {
+      "type": "DEV",
+      "summary": "[DEV] Buddy Testing",
+      "description": "Buddy testing of implemented changes",
+      "assignee": "NONE"
+    },
+    {
+      "type": "QA",
+      "summary": "[QA] Test cases preparation",
+      "description": "Test cases preparation",
+      "assignee": "QA"
+    },
+    {
+      "type": "UX",
+      "summary": "UX Review",
+      "description": "Final UX review and validation",
+      "assignee": "None"
+    }
+  ]
+