@niiiiiiile/iw-jira-cli 0.5.0

package/dist/load-dotenv.js

@@ -0,0 +1,24 @@
+import { config } from 'dotenv';
+import { basename, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * 1. カレントディレクトリの `.env`（上書きなし＝シェルや既存 env を尊重）
+ * 2. エントリと同じディレクトリの `.env`（`node dist/cli.js` なら `dist/.env`）を override で反映
+ * 3. `tsx src/cli.ts` のときは `dist/.env` をさらに override で読み、`dist` の値が最優先
+ */
+/** dotenv 後に、よくある typo `IRA_HOST` を `JIRA_HOST` に寄せる */
+function aliasIraHost() {
+    const j = process.env.JIRA_HOST?.trim();
+    const i = process.env.IRA_HOST?.trim();
+    if (!j && i)
+        process.env.JIRA_HOST = i;
+}
+export function loadDotenvFiles() {
+    const cliDir = dirname(fileURLToPath(import.meta.url));
+    config({ path: join(process.cwd(), '.env') });
+    config({ path: join(cliDir, '.env'), override: true });
+    if (basename(cliDir) === 'src') {
+        config({ path: join(cliDir, '..', 'dist', '.env'), override: true });
+    }
+    aliasIraHost();
+}

package/dist/output.d.ts

@@ -0,0 +1,7 @@
+type OutputContext = {
+    agent: boolean;
+    format: string;
+};
+export declare function finalizeOutput<T>(context: OutputContext, data: T): unknown;
+export declare function finalizeCompactOutput<T>(context: OutputContext, full: T, slim: (value: T) => unknown): unknown;
+export {};

package/dist/output.js

@@ -0,0 +1,9 @@
+import { wantCompact } from './agent-compact.js';
+import { outJsonlIfNeeded } from './jsonl-lines.js';
+export function finalizeOutput(context, data) {
+    return outJsonlIfNeeded(data, context.format);
+}
+export function finalizeCompactOutput(context, full, slim) {
+    const data = wantCompact(context.agent) ? slim(full) : full;
+    return finalizeOutput(context, data);
+}

package/dist/parse-jira-input.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 課題キー（WEC-41）または Jira の課題 URL から課題キーを得る。
+ * browse URL・selectedIssue・パス末尾のキーなどに対応。
+ */
+export declare function parseIssueKey(input: string): string;
+/**
+ * プロジェクトキー（WEC）・課題キー（WEC-41 なら WEC 部分）・ボード/プロジェクト URL からプロジェクトキーを得る。
+ */
+export declare function parseProjectRef(input: string): string;

package/dist/parse-jira-input.js

@@ -0,0 +1,97 @@
+/** /projects/KEY/ … からプロジェクトキーを取る */
+function projectKeyFromPath(pathname) {
+    const m = pathname.match(/\/projects\/([A-Za-z][A-Za-z0-9]*)(?:\/|$)/);
+    return m ? m[1].toUpperCase() : null;
+}
+function withHttpsIfHostLooksLikeAtlassian(s) {
+    const t = s.trim();
+    if (/^https?:\/\//i.test(t))
+        return t;
+    if (/\.atlassian\.net/i.test(t))
+        return `https://${t.replace(/^\/+/, '')}`;
+    return t;
+}
+/**
+ * 課題キー（WEC-41）または Jira の課題 URL から課題キーを得る。
+ * browse URL・selectedIssue・パス末尾のキーなどに対応。
+ */
+export function parseIssueKey(input) {
+    const raw = input.trim();
+    if (!raw) {
+        throw new Error('課題キーまたは URL が空です');
+    }
+    const fromSelected = raw.match(/[?&]selectedIssue=([A-Za-z][A-Za-z0-9]*-\d+)/i);
+    if (fromSelected) {
+        return normalizeIssueKey(fromSelected[1]);
+    }
+    const fromBrowse = raw.match(/\/browse\/([A-Za-z][A-Za-z0-9]*-\d+)/i);
+    if (fromBrowse) {
+        return normalizeIssueKey(fromBrowse[1]);
+    }
+    const bare = raw.match(/^([A-Za-z][A-Za-z0-9]*)-(\d+)$/);
+    if (bare) {
+        return `${bare[1].toUpperCase()}-${bare[2]}`;
+    }
+    const asUrl = withHttpsIfHostLooksLikeAtlassian(raw);
+    try {
+        const u = new URL(asUrl);
+        const browse = u.pathname.match(/\/browse\/([A-Za-z][A-Za-z0-9]*-\d+)/i);
+        if (browse) {
+            return normalizeIssueKey(browse[1]);
+        }
+        const sel = u.searchParams.get('selectedIssue');
+        if (sel && /^[A-Za-z][A-Za-z0-9]*-\d+$/i.test(sel)) {
+            return normalizeIssueKey(sel);
+        }
+        const seg = u.pathname.split('/').filter(Boolean);
+        const last = seg[seg.length - 1];
+        if (last && /^[A-Za-z][A-Za-z0-9]*-\d+$/i.test(last)) {
+            return normalizeIssueKey(last);
+        }
+    }
+    catch {
+        /* 相対パス等は下で失敗 */
+    }
+    throw new Error(`課題キー（例: WEC-41）または課題 URL（.../browse/WEC-41 等）として解釈できません: ${raw.slice(0, 120)}${raw.length > 120 ? '…' : ''}`);
+}
+function normalizeIssueKey(key) {
+    const m = key.match(/^([A-Za-z][A-Za-z0-9]*)-(\d+)$/i);
+    if (!m)
+        return key.toUpperCase();
+    return `${m[1].toUpperCase()}-${m[2]}`;
+}
+/**
+ * プロジェクトキー（WEC）・課題キー（WEC-41 なら WEC 部分）・ボード/プロジェクト URL からプロジェクトキーを得る。
+ */
+export function parseProjectRef(input) {
+    const raw = input.trim();
+    if (!raw) {
+        throw new Error('プロジェクトキーまたは URL が空です');
+    }
+    const asUrl = withHttpsIfHostLooksLikeAtlassian(raw);
+    try {
+        const u = new URL(asUrl);
+        const fromPath = projectKeyFromPath(u.pathname);
+        if (fromPath)
+            return fromPath;
+        const pk = u.searchParams.get('projectKey');
+        if (pk && /^[A-Za-z][A-Za-z0-9]*$/i.test(pk)) {
+            return pk.toUpperCase();
+        }
+    }
+    catch {
+        /* 続行 */
+    }
+    const fromPathLoose = projectKeyFromPath(raw);
+    if (fromPathLoose)
+        return fromPathLoose;
+    const fromIssue = raw.match(/^([A-Za-z][A-Za-z0-9]*)-\d+$/i);
+    if (fromIssue) {
+        return fromIssue[1].toUpperCase();
+    }
+    const bare = raw.match(/^([A-Za-z][A-Za-z0-9]*)$/i);
+    if (bare) {
+        return bare[1].toUpperCase();
+    }
+    throw new Error(`プロジェクトキー（例: WEC）またはプロジェクト URL（.../projects/WEC/...）として解釈できません: ${raw.slice(0, 120)}${raw.length > 120 ? '…' : ''}`);
+}

package/dist/profile-cli.d.ts

@@ -0,0 +1,2 @@
+import { Cli } from 'incur';
+export declare const profileCli: Cli.Cli<{}, undefined, undefined>;

package/dist/profile-cli.js

@@ -0,0 +1,105 @@
+import { Cli, z } from 'incur';
+import { readConfig, writeConfig } from './config.js';
+export const profileCli = Cli.create('profile', {
+    description: 'プロファイル管理（Jira サイト接続情報）',
+});
+profileCli.command('list', {
+    description: '設定済みプロファイルの一覧を表示',
+    examples: [{ description: '登録済みプロファイルとデフォルトを確認' }],
+    run() {
+        const config = readConfig();
+        const profiles = Object.entries(config.profiles).map(([name, profile]) => ({
+            name,
+            host: profile.host,
+            email: profile.email,
+            isDefault: name === config.default,
+        }));
+        return {
+            default: config.default ?? null,
+            profiles,
+        };
+    },
+});
+profileCli.command('add', {
+    description: 'プロファイルを追加・更新',
+    args: z.object({
+        name: z.string().describe('プロファイル名（例: work, personal）'),
+    }),
+    options: z.object({
+        host: z.string().describe('Jira サイトホストまたは URL'),
+        email: z.string().email().describe('Atlassian アカウントのメール'),
+        apiToken: z.string().describe('Jira API トークン'),
+        default: z.boolean().optional().describe('このプロファイルをデフォルトに設定'),
+    }),
+    examples: [
+        {
+            args: { name: 'work' },
+            options: {
+                host: 'your-company.atlassian.net',
+                email: 'user@example.com',
+                apiToken: 'YOUR_API_TOKEN',
+            },
+            description: 'work プロファイルを追加（初回登録時は自動でデフォルトになる）',
+        },
+    ],
+    run(c) {
+        const config = readConfig();
+        config.profiles[c.args.name] = {
+            host: c.options.host.trim(),
+            email: c.options.email.trim(),
+            apiToken: c.options.apiToken.trim(),
+        };
+        const isFirst = Object.keys(config.profiles).length === 1;
+        if (c.options.default || isFirst || !config.default) {
+            config.default = c.args.name;
+        }
+        writeConfig(config);
+        return {
+            added: c.args.name,
+            isDefault: config.default === c.args.name,
+        };
+    },
+});
+profileCli.command('remove', {
+    description: 'プロファイルを削除',
+    args: z.object({
+        name: z.string().describe('削除するプロファイル名'),
+    }),
+    run(c) {
+        const config = readConfig();
+        if (!config.profiles[c.args.name]) {
+            return c.error({
+                code: 'PROFILE_NOT_FOUND',
+                message: `プロファイル "${c.args.name}" が見つかりません`,
+                retryable: false,
+                cta: { commands: ['iw-jira-cli profile list'] },
+            });
+        }
+        delete config.profiles[c.args.name];
+        if (config.default === c.args.name) {
+            config.default = Object.keys(config.profiles)[0];
+        }
+        writeConfig(config);
+        return { removed: c.args.name, newDefault: config.default ?? null };
+    },
+});
+profileCli.command('use', {
+    description: 'デフォルトプロファイルを変更',
+    args: z.object({
+        name: z.string().describe('デフォルトに設定するプロファイル名'),
+    }),
+    run(c) {
+        const config = readConfig();
+        if (!config.profiles[c.args.name]) {
+            return c.error({
+                code: 'PROFILE_NOT_FOUND',
+                message: `プロファイル "${c.args.name}" が見つかりません`,
+                retryable: false,
+                cta: { commands: ['iw-jira-cli profile list'] },
+            });
+        }
+        config.default = c.args.name;
+        writeConfig(config);
+        return { default: c.args.name };
+    },
+});

package/dist/project-cli.d.ts

@@ -0,0 +1,14 @@
+import { Cli } from 'incur';
+export declare const projectCli: Cli.Cli<{
+    list: {
+        args: {};
+        options: {
+            limit: number;
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+            query?: string | undefined;
+        };
+    };
+}, undefined, undefined>;

package/dist/project-cli.js

@@ -0,0 +1,36 @@
+import { Cli, z } from 'incur';
+import { slimProjects } from './agent-compact.js';
+import { resolveCredentials } from './config.js';
+import { jiraRequest } from './jira-client.js';
+import { finalizeCompactOutput } from './output.js';
+import { authOptions } from './shared.js';
+export const projectCli = Cli.create('project', {
+    description: 'プロジェクトの検索・一覧（非TTY 時は圧縮出力）',
+}).command('list', {
+    description: 'アクセス可能なプロジェクトを検索',
+    options: z.object({
+        query: z.string().optional().describe('名前・キーに対する部分一致（省略時は広く取得）'),
+        limit: z.coerce.number().int().min(1).max(100).default(50).describe('最大件数'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const q = new URLSearchParams();
+        const creds = resolveCredentials(c.options);
+        q.set('maxResults', String(c.options.limit));
+        if (c.options.query !== undefined && c.options.query.length > 0) {
+            q.set('query', c.options.query);
+        }
+        const res = await jiraRequest(creds, `/project/search?${q.toString()}`);
+        const full = {
+            count: res.values.length,
+            projects: res.values.map((p) => ({
+                key: p.key,
+                id: p.id,
+                name: p.name,
+                projectTypeKey: p.projectTypeKey,
+            })),
+        };
+        return finalizeCompactOutput(c, full, (data) => slimProjects(data, true));
+    },
+});

package/dist/shared.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'incur';
+/** 全コマンド共通の認証オプション */
+export declare const authOptions: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    apiToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/shared.js

@@ -0,0 +1,8 @@
+import { z } from 'incur';
+/** 全コマンド共通の認証オプション */
+export const authOptions = z.object({
+    profile: z.string().optional().describe('使用するプロファイル名'),
+    host: z.string().optional().describe('Jira サイトホストまたは URL（上書き）'),
+    email: z.string().optional().describe('Atlassian アカウントのメール（上書き）'),
+    apiToken: z.string().optional().describe('Jira API トークン（上書き）'),
+});

package/dist/user-cli.d.ts

@@ -0,0 +1,15 @@
+import { Cli } from 'incur';
+export declare const userCli: Cli.Cli<{
+    search: {
+        args: {
+            query: string;
+        };
+        options: {
+            limit: number;
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+        };
+    };
+}, undefined, undefined>;

package/dist/user-cli.js

@@ -0,0 +1,37 @@
+import { Cli, z } from 'incur';
+import { slimUsers } from './agent-compact.js';
+import { resolveCredentials } from './config.js';
+import { jiraRequest } from './jira-client.js';
+import { finalizeCompactOutput } from './output.js';
+import { authOptions } from './shared.js';
+export const userCli = Cli.create('user', {
+    description: 'ユーザー検索（メンション用 accountId の確認など）',
+}).command('search', {
+    description: '表示名・メールの部分一致で検索（GET /user/search）',
+    args: z.object({
+        query: z.string().min(1).describe('検索語（メール・名前の一部）'),
+    }),
+    options: z.object({
+        limit: z.coerce.number().int().min(1).max(50).default(15).describe('最大件数'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const users = await jiraRequest(creds, `/user/search?query=${encodeURIComponent(c.args.query)}&maxResults=${c.options.limit}`);
+        const list = users.map((u) => ({
+            accountId: u.accountId,
+            displayName: u.displayName ?? '',
+            emailAddress: u.emailAddress ?? '',
+            active: u.active,
+            /** CLI メンション用プレースホルダー例 */
+            mention: `@[${u.accountId}]`,
+        }));
+        const data = {
+            count: list.length,
+            users: list,
+            hint: '本文では @[accountId] または @[email:mail@example.com] でメンションできます',
+        };
+        return finalizeCompactOutput(c, data, (value) => slimUsers(value, true));
+    },
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@niiiiiiile/iw-jira-cli",
+  "version": "0.5.0",
+  "description": "CLI for Jira Cloud issue management with setup, profiles, and compact agent output",
+  "type": "module",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md",
+    ".env.example"
+  ],
+  "bin": {
+    "iw-jira-cli": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "jira",
+    "atlassian",
+    "cli",
+    "issue-tracker",
+    "productivity"
+  ],
+  "author": "Teruaki Iwane",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Niiiiile/jira-cli.git"
+  },
+  "homepage": "https://github.com/Niiiiile/jira-cli#readme",
+  "bugs": {
+    "url": "https://github.com/Niiiiile/jira-cli/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "dotenv": "^16.4.7",
+    "incur": "^0.3.25"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}