@niiiiiiile/iw-jira-cli 0.5.0

package/dist/agent-compact.js

@@ -0,0 +1,132 @@
+const DESC_MAX = 800;
+const COMMENT_BODY_MAX = 600;
+/** `JIRA_CLI_COMPACT`: 1/true=常に圧縮、0/false=常にフル、未設定=非TTY のときだけ圧縮 */
+export function wantCompact(agent) {
+    const v = process.env.JIRA_CLI_COMPACT?.trim().toLowerCase();
+    if (v === '1' || v === 'true' || v === 'yes' || v === 'on')
+        return true;
+    if (v === '0' || v === 'false' || v === 'no' || v === 'off')
+        return false;
+    return agent;
+}
+export function truncateText(s, max) {
+    const t = s.trim();
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, max - 1)}…`;
+}
+/** エージェント向け: id/self を落とし、空フィールド省略、説明は切り詰め */
+export function slimIssue(i) {
+    const o = {
+        key: i.key,
+        summary: i.summary,
+        status: i.status,
+        issuetype: i.issuetype,
+    };
+    if (i.assignee)
+        o.assignee = i.assignee;
+    if (i.reporter)
+        o.reporter = i.reporter;
+    if (i.priority)
+        o.priority = i.priority;
+    if (i.created)
+        o.created = i.created;
+    if (i.updated)
+        o.updated = i.updated;
+    if (i.labels?.length)
+        o.labels = i.labels;
+    if (i.components?.length)
+        o.components = i.components;
+    if (i.duedate)
+        o.duedate = i.duedate;
+    if (i.parent)
+        o.parent = i.parent;
+    const d = i.description?.trim();
+    if (d)
+        o.description = truncateText(d, DESC_MAX);
+    return o;
+}
+export function slimIssueEnvelope(issue, compact) {
+    if (!compact)
+        return { issue };
+    return { issue: slimIssue(issue) };
+}
+export function slimSearch(data, compact) {
+    if (!compact)
+        return data;
+    return {
+        n: data.count,
+        ...(data.isLast !== undefined ? { last: data.isLast } : {}),
+        ...(data.nextPageToken ? { next: data.nextPageToken } : {}),
+        /** issues（短縮キー i） */
+        i: data.issues.map(slimIssue),
+    };
+}
+export function slimMyself(data, compact) {
+    if (!compact)
+        return data;
+    const o = {
+        id: data.accountId,
+        n: data.displayName,
+    };
+    if (data.emailAddress)
+        o.m = data.emailAddress;
+    return o;
+}
+export function slimComments(data, compact) {
+    if (!compact)
+        return data;
+    return {
+        k: data.key,
+        n: data.total,
+        c: data.comments.map((x) => ({
+            id: x.id,
+            a: x.author || undefined,
+            t: x.created,
+            b: x.body ? truncateText(x.body, COMMENT_BODY_MAX) : undefined,
+        })),
+    };
+}
+export function slimProjects(data, compact) {
+    if (!compact)
+        return data;
+    return {
+        n: data.count,
+        p: data.projects.map((x) => ({
+            k: x.key,
+            name: x.name,
+            type: x.projectTypeKey,
+        })),
+    };
+}
+export function slimUsers(data, compact) {
+    if (!compact)
+        return data;
+    return {
+        n: data.count,
+        u: data.users.map((x) => ({
+            id: x.accountId,
+            n: x.displayName,
+            m: x.emailAddress || undefined,
+            ph: x.mention,
+        })),
+    };
+}
+export function slimCreate(data, compact) {
+    if (!compact)
+        return data;
+    return { k: data.key, id: data.id };
+}
+export function slimUpdate(data, compact) {
+    if (!compact)
+        return data;
+    return { ok: data.ok, k: data.key };
+}
+export function slimTransitions(data, compact) {
+    if (!compact)
+        return data;
+    return {
+        k: data.key,
+        t: data.transitions.map((x) => ({ id: x.id, n: x.name, s: x.toStatus })),
+    };
+}

package/dist/bootstrap.d.ts

@@ -0,0 +1 @@
+export declare function bootstrapCli(): void;

package/dist/bootstrap.js

@@ -0,0 +1,4 @@
+import { loadDotenvFiles } from './load-dotenv.js';
+export function bootstrapCli() {
+    loadDotenvFiles();
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import { Cli, z } from 'incur';
+import { slimIssueEnvelope, slimMyself } from './agent-compact.js';
+import { bootstrapCli } from './bootstrap.js';
+import { DEFAULT_PROFILE_NAME, readConfig, resolveCredentials, writeConfig } from './config.js';
+import { jiraRequest } from './jira-client.js';
+import { finalizeCompactOutput } from './output.js';
+import { issueCli, loadIssueSummary } from './issue-cli.js';
+import { profileCli } from './profile-cli.js';
+import { projectCli } from './project-cli.js';
+import { authOptions } from './shared.js';
+import { userCli } from './user-cli.js';
+bootstrapCli();
+async function loadMyself(opts) {
+    const creds = resolveCredentials(opts);
+    return jiraRequest(creds, '/myself');
+}
+Cli.create('iw-jira-cli', {
+    description: 'Jira Cloud REST API v3 用 CLI。setup/profile、キー／URL、メンション（@[accountId] / @[email:...]）、JIRA_CLI_COMPACT 対応。出力は TOON（--format jsonl で NDJSON に切替）',
+    version: '0.5.0',
+    format: 'toon',
+})
+    .command('show', {
+    description: '課題を1件表示（`issue get` の短縮。キーまたは browse URL）',
+    args: z.object({
+        ref: z.string().describe('WEC-41 または .../browse/WEC-41 等'),
+    }),
+    options: authOptions,
+    output: z.any(),
+    async run(c) {
+        const full = await loadIssueSummary(resolveCredentials(c.options), c.args.ref);
+        return finalizeCompactOutput(c, full.issue, (issue) => slimIssueEnvelope(issue, true));
+    },
+})
+    .command('setup', {
+    description: '初回セットアップ向けにプロファイルを保存',
+    options: z.object({
+        profile: z
+            .string()
+            .optional()
+            .describe(`保存先プロファイル名（省略時: ${DEFAULT_PROFILE_NAME}）`),
+        host: z.string().describe('Jira サイトホストまたは URL'),
+        email: z.string().email().describe('Atlassian アカウントのメール'),
+        apiToken: z.string().describe('Jira API トークン'),
+        default: z.boolean().optional().describe('このプロファイルをデフォルトに設定'),
+    }),
+    run(c) {
+        const config = readConfig();
+        const name = c.options.profile ?? DEFAULT_PROFILE_NAME;
+        config.profiles[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 = name;
+        }
+        writeConfig(config);
+        return {
+            saved: name,
+            isDefault: config.default === name,
+            hint: '接続確認は `iw-jira-cli whoami` を実行してください',
+        };
+    },
+})
+    .command(issueCli)
+    .command(projectCli)
+    .command(profileCli)
+    .command(userCli)
+    .command('myself', {
+    description: '認証ユーザー情報を取得',
+    options: authOptions,
+    output: z.any(),
+    async run(c) {
+        const me = await loadMyself(c.options);
+        const full = {
+            accountId: me.accountId,
+            displayName: me.displayName,
+            emailAddress: me.emailAddress,
+            active: me.active,
+        };
+        return finalizeCompactOutput(c, full, (data) => slimMyself(data, true));
+    },
+})
+    .command('whoami', {
+    description: '認証ユーザー情報を取得（`myself` の別名）',
+    options: authOptions,
+    output: z.any(),
+    async run(c) {
+        const me = await loadMyself(c.options);
+        const full = {
+            accountId: me.accountId,
+            displayName: me.displayName,
+            emailAddress: me.emailAddress,
+            active: me.active,
+        };
+        return finalizeCompactOutput(c, full, (data) => slimMyself(data, true));
+    },
+})
+    .serve();

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export interface Profile {
+    host: string;
+    email: string;
+    apiToken: string;
+}
+export interface Config {
+    default?: string;
+    profiles: Record<string, Profile>;
+}
+export interface JiraCredentials {
+    host: string;
+    email: string;
+    apiToken: string;
+}
+export interface ResolveOptions {
+    profile?: string;
+    host?: string;
+    email?: string;
+    apiToken?: string;
+}
+export declare const DEFAULT_PROFILE_NAME = "default";
+export declare function readConfig(): Config;
+export declare function writeConfig(config: Config): void;
+/**
+ * 認証情報を以下の優先順位で解決する:
+ * 1. コマンドフラグ (--host / --email / --api-token)
+ * 2. 設定ファイルのプロファイル (--profile または default)
+ * 3. 環境変数 / .env (JIRA_HOST / JIRA_EMAIL / JIRA_API_TOKEN)
+ */
+export declare function resolveCredentials(opts: ResolveOptions): JiraCredentials;

package/dist/config.js

@@ -0,0 +1,47 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export const DEFAULT_PROFILE_NAME = 'default';
+const CONFIG_PATH = join(homedir(), '.config', 'jira-cli', 'config.json');
+export function readConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return { profiles: {} };
+    try {
+        return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return { profiles: {} };
+    }
+}
+export function writeConfig(config) {
+    mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * 認証情報を以下の優先順位で解決する:
+ * 1. コマンドフラグ (--host / --email / --api-token)
+ * 2. 設定ファイルのプロファイル (--profile または default)
+ * 3. 環境変数 / .env (JIRA_HOST / JIRA_EMAIL / JIRA_API_TOKEN)
+ */
+export function resolveCredentials(opts) {
+    const config = readConfig();
+    const profileName = opts.profile ?? config.default;
+    const profileData = profileName ? config.profiles[profileName] : undefined;
+    const host = opts.host ?? profileData?.host ?? process.env.JIRA_HOST;
+    const email = opts.email ?? profileData?.email ?? process.env.JIRA_EMAIL;
+    const apiToken = opts.apiToken ?? profileData?.apiToken ?? process.env.JIRA_API_TOKEN;
+    if (!host) {
+        throw new Error('Jira host が未設定です。--host フラグ、プロファイル、または JIRA_HOST 環境変数を設定してください。');
+    }
+    if (!email) {
+        throw new Error('Jira email が未設定です。--email フラグ、プロファイル、または JIRA_EMAIL 環境変数を設定してください。');
+    }
+    if (!apiToken) {
+        throw new Error('Jira API token が未設定です。--api-token フラグ、プロファイル、または JIRA_API_TOKEN 環境変数を設定してください。');
+    }
+    return {
+        host: host.trim(),
+        email: email.trim(),
+        apiToken: apiToken.trim(),
+    };
+}

package/dist/issue-cli.d.ts

@@ -0,0 +1,127 @@
+import { Cli } from 'incur';
+import { type JiraCredentials } from './config.js';
+import { type IssueSummary } from './jira-client.js';
+export declare function loadIssueSummary(env: JiraCredentials, ref: string): Promise<{
+    issue: IssueSummary;
+}>;
+export declare const issueCli: Cli.Cli<{
+    get: {
+        args: {
+            ref: string;
+        };
+        options: {
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+        };
+    };
+} & {
+    search: {
+        args: {
+            target?: string | undefined;
+        };
+        options: {
+            limit: number;
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+            jql?: string | undefined;
+            project?: string | undefined;
+            nextPageToken?: string | undefined;
+        };
+    };
+} & {
+    create: {
+        args: {};
+        options: {
+            project: string;
+            summary: string;
+            type: string;
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+            description?: string | undefined;
+            parent?: string | undefined;
+            assignee?: string | undefined;
+            labels?: string | undefined;
+            priority?: string | undefined;
+            'start-date'?: string | undefined;
+            'due-date'?: string | undefined;
+        };
+    };
+} & {
+    update: {
+        args: {
+            ref: string;
+        };
+        options: {
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            assignee?: string | undefined;
+            parent?: string | undefined;
+            labels?: string | undefined;
+            priority?: string | undefined;
+            'start-date'?: string | undefined;
+            'due-date'?: string | undefined;
+        };
+    };
+} & {
+    transitions: {
+        args: {
+            ref: string;
+        };
+        options: {
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+        };
+    };
+} & {
+    transition: {
+        args: {
+            ref: string;
+        };
+        options: {
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+            id?: string | undefined;
+            name?: string | undefined;
+        };
+    };
+} & {
+    comments: {
+        args: {
+            ref: string;
+        };
+        options: {
+            limit: number;
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+        };
+    };
+} & {
+    comment: {
+        args: {
+            ref: string;
+        };
+        options: {
+            body: string;
+            profile?: string | undefined;
+            host?: string | undefined;
+            email?: string | undefined;
+            apiToken?: string | undefined;
+        };
+    };
+}, undefined, undefined>;