@niiiiiiile/iw-jira-cli 0.5.0

package/.env.example

@@ -0,0 +1,14 @@
+# Jira サイトのホスト名（https:// は不要）
+JIRA_HOST=your-company.atlassian.net
+
+# Atlassian アカウントのメールアドレス
+JIRA_EMAIL=your-email@example.com
+
+# Atlassian API トークン
+# 発行: https://id.atlassian.com/manage-profile/security/api-tokens
+JIRA_API_TOKEN=your-api-token-here
+
+# 出力モード（省略可）
+# 1/true=常にコンパクト出力、0/false=常にフル出力
+# 未設定=パイプ/非TTY のときだけコンパクト（エージェント向けトークン削減）
+# JIRA_CLI_COMPACT=1

package/README.md

@@ -0,0 +1,277 @@
+# iw-jira-cli
+
+`iw-jira-cli` は Jira Cloud REST API v3 を操作する CLI ツールです。`setup` / `profile` による接続情報管理、課題操作、メンション対応コメント、`whoami` による接続確認を一貫した CLI フローで提供します。AI エージェント連携向けのコンパクト出力にも対応しています。
+
+![Node.js](https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white)
+![CLI](https://img.shields.io/badge/interface-CLI-4D4D4D)
+![License](https://img.shields.io/badge/license-MIT-blue)
+
+## Table of contents
+
+* [Overview](#overview)
+* [Features](#features)
+* [Installation](#installation)
+  + [Run with npx](#run-with-npx)
+  + [Install globally](#install-globally)
+  + [Run from source](#run-from-source)
+* [Quick start](#quick-start)
+* [Profiles](#profiles)
+* [Environment variables](#environment-variables)
+* [Authentication check](#authentication-check)
+* [Credential precedence](#credential-precedence)
+* [Usage](#usage)
+  + [Show an issue](#show-an-issue)
+  + [Search issues](#search-issues)
+  + [Create an issue](#create-an-issue)
+  + [Update an issue](#update-an-issue)
+  + [Transition an issue](#transition-an-issue)
+  + [Comments](#comments)
+  + [User search](#user-search)
+  + [Project list](#project-list)
+* [Output format](#output-format)
+* [Mention syntax](#mention-syntax)
+* [Development](#development)
+* [License](#license)
+
+## Overview
+
+`iw-jira-cli` は Jira 課題の取得、検索、更新、コメント、ステータス遷移を行うための CLI です。初回は `iw-jira-cli setup` で資格情報を保存し、その後は `issue` / `project` / `user` / `whoami` をそのまま使えます。
+
+## Features
+
+- 課題の取得・検索（JQL 対応）・作成・更新
+- ステータス遷移（`issue transitions` / `issue transition`）
+- コメントの取得・追加
+- ユーザー検索（メンション用 accountId の確認）
+- プロジェクト一覧
+- `setup` / `profile` による接続情報管理
+- 認証ユーザー情報の取得（`whoami`, `myself`）
+- メンション記法: `@[accountId]` または `@[email:user@example.com]`
+- パイプ・非 TTY 時の自動コンパクト出力（`JIRA_CLI_COMPACT` で制御可能）
+
+## Installation
+
+### Run with npx
+
+```bash
+npx @niiiiiiile/iw-jira-cli@latest
+```
+
+### Install globally
+
+```bash
+npm install -g @niiiiiiile/iw-jira-cli
+```
+
+### Run from source
+
+```bash
+git clone https://github.com/Niiiiile/jira-cli.git
+cd iw-jira-cli
+npm install
+npm run build
+```
+
+## Quick start
+
+```bash
+iw-jira-cli setup \
+  --host your-company.atlassian.net \
+  --email your-email@example.com \
+  --api-token your-api-token-here
+```
+
+初回登録時は `default` プロファイルに保存され、自動でデフォルトになります。
+
+API トークンは [Atlassian アカウント設定](https://id.atlassian.com/manage-profile/security/api-tokens) から発行できます。
+
+## Profiles
+
+```bash
+# work プロファイルを追加
+iw-jira-cli profile add work \
+  --host your-company.atlassian.net \
+  --email your-email@example.com \
+  --api-token your-api-token-here
+
+# プロファイル一覧
+iw-jira-cli profile list
+
+# デフォルト切り替え
+iw-jira-cli profile use work
+```
+
+## Environment variables
+
+`.env.example` をコピーして `.env` を作成し、各値を設定してください。
+
+```bash
+cp .env.example .env
+```
+
+```env
+JIRA_HOST=your-company.atlassian.net
+JIRA_EMAIL=your-email@example.com
+JIRA_API_TOKEN=your-api-token-here
+```
+
+環境変数はシェルに直接設定することも可能です:
+
+```bash
+export JIRA_HOST=your-company.atlassian.net
+export JIRA_EMAIL=your-email@example.com
+export JIRA_API_TOKEN=your-api-token-here
+```
+
+## Authentication check
+
+```bash
+iw-jira-cli whoami
+```
+
+既存の `iw-jira-cli myself` も引き続き利用できます。
+
+## Credential precedence
+
+1. コマンドフラグ（`--host`, `--email`, `--api-token`）
+2. 設定ファイルのプロファイル（`--profile` または default）
+3. 環境変数 / `.env`（`JIRA_HOST`, `JIRA_EMAIL`, `JIRA_API_TOKEN`）
+
+## Usage
+
+```bash
+npx @niiiiiiile/iw-jira-cli@latest --help
+```
+
+### Show an issue
+
+```bash
+# キーで取得（show は issue get の短縮）
+npx @niiiiiiile/iw-jira-cli@latest show PROJECT-123
+
+# URL でも指定可
+npx @niiiiiiile/iw-jira-cli@latest show https://your-company.atlassian.net/browse/PROJECT-123
+```
+
+グローバルインストール済みの場合は `iw-jira-cli` コマンドとして呼び出せます。
+
+### Search issues
+
+```bash
+# 自分にアサインされた未解決の課題（デフォルト）
+iw-jira-cli issue search
+
+# プロジェクトを指定
+iw-jira-cli issue search PROJECT
+
+# JQL で検索
+iw-jira-cli issue search --jql "project = PROJECT AND status = 'In Progress'"
+
+# 件数を指定
+iw-jira-cli issue search PROJECT --limit 50
+```
+
+### Create an issue
+
+```bash
+iw-jira-cli issue create \
+  --project PROJECT \
+  --summary "バグ修正: ログイン画面のエラー" \
+  --type Bug \
+  --description "再現手順: ..." \
+  --assignee email:user@example.com
+```
+
+### Update an issue
+
+```bash
+iw-jira-cli issue update PROJECT-123 \
+  --summary "新しいタイトル" \
+  --assignee email:user@example.com \
+  --due-date 2026-04-30
+```
+
+### Transition an issue
+
+```bash
+# 利用可能な遷移を確認
+iw-jira-cli issue transitions PROJECT-123
+
+# 遷移名で変更（部分一致）
+iw-jira-cli issue transition PROJECT-123 --name "In Progress"
+
+# 遷移 ID で変更
+iw-jira-cli issue transition PROJECT-123 --id 21
+```
+
+### Comments
+
+```bash
+# コメント一覧
+iw-jira-cli issue comments PROJECT-123
+
+# コメントを追加（メンション可）
+iw-jira-cli issue comment PROJECT-123 --body "確認しました @[email:user@example.com]"
+```
+
+### User search
+
+```bash
+# メンション用 accountId を確認
+iw-jira-cli user search "田中"
+```
+
+### Project list
+
+```bash
+iw-jira-cli project list
+iw-jira-cli project list --query "my project"
+```
+
+## Output format
+
+デフォルトは TOON 形式（人間向け）。NDJSON に切り替えるには `--format jsonl` を指定します。
+
+```bash
+jira-cli issue search PROJECT --format jsonl
+```
+
+### コンパクト出力
+
+パイプや非 TTY 環境では自動的にコンパクト出力になります（AI エージェント向けのトークン削減）。
+
+```bash
+# 強制的にコンパクト出力
+JIRA_CLI_COMPACT=1 iw-jira-cli issue search PROJECT
+
+# 強制的にフル出力
+JIRA_CLI_COMPACT=0 iw-jira-cli issue search PROJECT
+```
+
+## Mention syntax
+
+説明文・コメントで以下の記法でメンションを指定できます。
+
+| 記法 | 説明 |
+|------|------|
+| `@[712020:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx]` | accountId で直接指定 |
+| `@[email:user@example.com]` | メールアドレスで指定（内部で accountId に解決） |
+
+accountId は `iw-jira-cli user search <名前>` で確認できます。
+
+## Development
+
+```bash
+# 依存関係のインストール
+npm install
+
+# TypeScript のビルド
+npm run build
+
+# ビルドなしで直接実行（開発時）
+npm run dev -- issue search
+```
+
+## ライセンス
+
+MIT

package/dist/adf-mentions.d.ts

@@ -0,0 +1,3 @@
+import type { JiraCredentials } from './config.js';
+/** `@[...]` を含むときだけ API で解決。含まなければ同期の plainTextToAdfBody。 */
+export declare function descriptionToAdf(env: JiraCredentials, text: string): Promise<Record<string, unknown>>;

package/dist/adf-mentions.js

@@ -0,0 +1,103 @@
+import { jiraRequest } from './jira-client.js';
+import { plainTextToAdfBody } from './adf.js';
+/**
+ * テキスト内の `@[accountId]` または `@[email:user@example.com]` を Jira Cloud ADF の mention ノードに変換する。
+ * accountId は Atlassian の形式（例: 712020:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）。
+ */
+const MENTION_PATTERN = /@\[([^\]]+)\]/g;
+function containsMentionPlaceholder(text) {
+    return /@\[([^\]]+)\]/.test(text);
+}
+function splitLineWithMentions(line) {
+    const segments = [];
+    let last = 0;
+    let m;
+    const re = new RegExp(MENTION_PATTERN.source, 'g');
+    while ((m = re.exec(line)) !== null) {
+        if (m.index > last) {
+            segments.push({ kind: 'text', value: line.slice(last, m.index) });
+        }
+        segments.push({ kind: 'mention', value: m[1].trim() });
+        last = m.index + m[0].length;
+    }
+    if (last < line.length) {
+        segments.push({ kind: 'text', value: line.slice(last) });
+    }
+    return segments;
+}
+async function resolveMentionInner(inner, env) {
+    const emailPrefix = /^email:/i;
+    if (emailPrefix.test(inner)) {
+        const email = inner.replace(emailPrefix, '').trim();
+        if (!email) {
+            throw new Error('@[email:...] にメールアドレスがありません');
+        }
+        const users = await jiraRequest(env, `/user/search?query=${encodeURIComponent(email)}&maxResults=25`);
+        const exact = users.find((u) => u.emailAddress?.toLowerCase() === email.toLowerCase());
+        const u = exact ?? users[0];
+        if (!u) {
+            throw new Error(`ユーザーが見つかりません: ${email}`);
+        }
+        return {
+            accountId: u.accountId,
+            label: u.displayName ?? u.emailAddress ?? email,
+        };
+    }
+    const accountId = inner;
+    try {
+        const u = await jiraRequest(env, `/user?accountId=${encodeURIComponent(accountId)}`);
+        return {
+            accountId: u.accountId,
+            label: u.displayName ?? accountId,
+        };
+    }
+    catch {
+        return { accountId, label: accountId };
+    }
+}
+async function lineToParagraphContent(line, env) {
+    const segments = splitLineWithMentions(line);
+    if (segments.length === 0) {
+        return [];
+    }
+    const content = [];
+    for (const seg of segments) {
+        if (seg.kind === 'text') {
+            if (seg.value.length > 0) {
+                content.push({ type: 'text', text: seg.value });
+            }
+        }
+        else {
+            const { accountId, label } = await resolveMentionInner(seg.value, env);
+            content.push({
+                type: 'mention',
+                attrs: {
+                    id: accountId,
+                    text: `@${label}`,
+                    accessLevel: '',
+                },
+            });
+        }
+    }
+    return content;
+}
+/** `@[...]` を含むときだけ API で解決。含まなければ同期の plainTextToAdfBody。 */
+export async function descriptionToAdf(env, text) {
+    if (!containsMentionPlaceholder(text)) {
+        return plainTextToAdfBody(text);
+    }
+    const lines = text.split(/\r?\n/);
+    const content = [];
+    for (const line of lines) {
+        const paraContent = await lineToParagraphContent(line, env);
+        content.push({
+            type: 'paragraph',
+            content: paraContent.length ? paraContent : [],
+        });
+    }
+    return {
+        type: 'doc',
+        version: 1,
+        content: content.length ? content : [{ type: 'paragraph', content: [] }],
+    };
+}

package/dist/adf.d.ts

@@ -0,0 +1,4 @@
+/** Atlassian Document Format からプレーンテキストを抽出（簡易） */
+export declare function plainTextFromAdf(node: unknown): string;
+/** 1 行でも複数行でも ADF doc に変換（課題の description 用） */
+export declare function plainTextToAdfBody(text: string): Record<string, unknown>;

package/dist/adf.js

@@ -0,0 +1,38 @@
+/** Atlassian Document Format からプレーンテキストを抽出（簡易） */
+export function plainTextFromAdf(node) {
+    if (node == null)
+        return '';
+    if (typeof node !== 'object')
+        return '';
+    const n = node;
+    if (n.type === 'text' && typeof n.text === 'string')
+        return n.text;
+    if (n.type === 'mention') {
+        const a = n.attrs;
+        if (a && typeof a.text === 'string')
+            return a.text;
+        if (a && typeof a.id === 'string')
+            return `@[${a.id}]`;
+        return '';
+    }
+    if (!Array.isArray(n.content))
+        return '';
+    const inner = n.content.map((c) => plainTextFromAdf(c)).filter(Boolean);
+    if (n.type === 'paragraph' || n.type === 'heading') {
+        return inner.join('') + '\n';
+    }
+    return inner.join('\n');
+}
+/** 1 行でも複数行でも ADF doc に変換（課題の description 用） */
+export function plainTextToAdfBody(text) {
+    const lines = text.split(/\r?\n/);
+    const content = lines.map((line) => ({
+        type: 'paragraph',
+        content: line.length ? [{ type: 'text', text: line }] : [],
+    }));
+    return {
+        type: 'doc',
+        version: 1,
+        content: content.length ? content : [{ type: 'paragraph', content: [] }],
+    };
+}

package/dist/agent-compact.d.ts

@@ -0,0 +1,164 @@
+import type { IssueSummary } from './jira-client.js';
+/** `JIRA_CLI_COMPACT`: 1/true=常に圧縮、0/false=常にフル、未設定=非TTY のときだけ圧縮 */
+export declare function wantCompact(agent: boolean): boolean;
+export declare function truncateText(s: string, max: number): string;
+/** エージェント向け: id/self を落とし、空フィールド省略、説明は切り詰め */
+export declare function slimIssue(i: IssueSummary): Record<string, unknown>;
+export declare function slimIssueEnvelope(issue: IssueSummary, compact: boolean): {
+    issue: IssueSummary;
+} | {
+    issue: Record<string, unknown>;
+};
+export declare function slimSearch(data: {
+    count: number;
+    isLast?: boolean;
+    nextPageToken: string | null | undefined;
+    issues: IssueSummary[];
+    jql: string;
+}, compact: boolean): {
+    count: number;
+    isLast?: boolean;
+    nextPageToken: string | null | undefined;
+    issues: IssueSummary[];
+    jql: string;
+} | {
+    /** issues（短縮キー i） */
+    i: Record<string, unknown>[];
+    next?: string | undefined;
+    last?: boolean | undefined;
+    n: number;
+};
+export declare function slimMyself(data: {
+    accountId: string;
+    displayName: string;
+    emailAddress?: string;
+    active?: boolean;
+}, compact: boolean): Record<string, unknown> | {
+    accountId: string;
+    displayName: string;
+    emailAddress?: string;
+    active?: boolean;
+};
+export declare function slimComments(data: {
+    key: string;
+    total: number;
+    comments: Array<{
+        id: string;
+        author: string;
+        created: string;
+        body: string;
+    }>;
+}, compact: boolean): {
+    key: string;
+    total: number;
+    comments: Array<{
+        id: string;
+        author: string;
+        created: string;
+        body: string;
+    }>;
+} | {
+    k: string;
+    n: number;
+    c: {
+        id: string;
+        a: string | undefined;
+        t: string;
+        b: string | undefined;
+    }[];
+};
+export declare function slimProjects(data: {
+    count: number;
+    projects: Array<{
+        key: string;
+        id: string;
+        name: string;
+        projectTypeKey: string;
+    }>;
+}, compact: boolean): {
+    count: number;
+    projects: Array<{
+        key: string;
+        id: string;
+        name: string;
+        projectTypeKey: string;
+    }>;
+} | {
+    n: number;
+    p: {
+        k: string;
+        name: string;
+        type: string;
+    }[];
+};
+export declare function slimUsers(data: {
+    count: number;
+    users: Array<{
+        accountId: string;
+        displayName: string;
+        emailAddress: string;
+        mention: string;
+    }>;
+    hint: string;
+}, compact: boolean): {
+    count: number;
+    users: Array<{
+        accountId: string;
+        displayName: string;
+        emailAddress: string;
+        mention: string;
+    }>;
+    hint: string;
+} | {
+    n: number;
+    u: {
+        id: string;
+        n: string;
+        m: string | undefined;
+        ph: string;
+    }[];
+};
+export declare function slimCreate(data: {
+    key: string;
+    id: string;
+    self: string;
+}, compact: boolean): {
+    key: string;
+    id: string;
+    self: string;
+} | {
+    k: string;
+    id: string;
+};
+export declare function slimUpdate(data: {
+    ok: boolean;
+    key: string;
+}, compact: boolean): {
+    ok: boolean;
+    key: string;
+} | {
+    ok: boolean;
+    k: string;
+};
+export declare function slimTransitions(data: {
+    key: string;
+    transitions: Array<{
+        id: string;
+        name: string;
+        toStatus: string;
+    }>;
+}, compact: boolean): {
+    key: string;
+    transitions: Array<{
+        id: string;
+        name: string;
+        toStatus: string;
+    }>;
+} | {
+    k: string;
+    t: {
+        id: string;
+        n: string;
+        s: string;
+    }[];
+};