@niiiiiiile/iw-jira-cli 0.5.0

package/dist/issue-cli.js

@@ -0,0 +1,407 @@
+import { Cli, z } from 'incur';
+import { plainTextFromAdf } from './adf.js';
+import { descriptionToAdf } from './adf-mentions.js';
+import { resolveCredentials } from './config.js';
+import { ISSUE_DETAIL_FIELDS, ISSUE_LIST_FIELDS } from './issue-fields.js';
+import { jiraRequest, toIssueSummary } from './jira-client.js';
+import { slimComments, slimCreate, slimIssueEnvelope, slimSearch, slimTransitions, slimUpdate, } from './agent-compact.js';
+import { finalizeCompactOutput } from './output.js';
+import { parseIssueKey, parseProjectRef } from './parse-jira-input.js';
+import { authOptions } from './shared.js';
+const DEFAULT_JQL = 'assignee = currentUser() AND resolution = Unresolved ORDER BY updated DESC';
+/**
+ * accountId または "email:user@example.com" 形式から accountId を解決する。
+ * "none" は null（割当解除）を意味するため呼び出し元で事前に除外すること。
+ */
+async function resolveAssigneeAccountId(jiraEnv, assignee) {
+    const emailPrefix = /^email:/i;
+    if (emailPrefix.test(assignee)) {
+        const email = assignee.replace(emailPrefix, '').trim();
+        if (!email)
+            throw new Error('--assignee email:... にメールアドレスがありません');
+        const users = await jiraRequest(jiraEnv, `/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 u.accountId;
+    }
+    return assignee;
+}
+export async function loadIssueSummary(env, ref) {
+    const key = parseIssueKey(ref);
+    const fields = [...ISSUE_DETAIL_FIELDS].join(',');
+    const raw = await jiraRequest(env, `/issue/${encodeURIComponent(key)}?fields=${encodeURIComponent(fields)}`);
+    return { issue: toIssueSummary(raw) };
+}
+function resolveSearchJql(opts) {
+    if (opts.jql !== undefined && opts.jql.length > 0)
+        return opts.jql;
+    const pRaw = opts.project?.trim() || opts.target?.trim();
+    if (pRaw) {
+        const p = parseProjectRef(pRaw);
+        return `project = ${p} ORDER BY updated DESC`;
+    }
+    return DEFAULT_JQL;
+}
+export const issueCli = Cli.create('issue', {
+    description: '課題の取得・検索・作成・コメント。説明・コメントで @[accountId] / @[email:...] メンション可。user search で accountId 確認',
+})
+    .command('get', {
+    description: '課題を1件取得（キー WEC-41 または browse URL など）',
+    args: z.object({
+        ref: z
+            .string()
+            .describe('課題キー（WEC-41）または URL（.../browse/WEC-41、selectedIssue= 付きボード URL 等）'),
+    }),
+    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('search', {
+    description: 'JQL enhanced search。第1引数にプロジェクトキーまたはボード URL も可',
+    args: z.object({
+        target: z
+            .string()
+            .optional()
+            .describe('プロジェクトキー（WEC）または .../projects/WEC/... の URL（--project 未指定時）'),
+    }),
+    options: z.object({
+        jql: z.string().optional().describe('JQL（最優先）'),
+        project: z
+            .string()
+            .optional()
+            .describe('プロジェクトキーまたは URL（第1引数より優先）'),
+        limit: z.coerce.number().int().min(1).max(100).default(20).describe('最大件数'),
+        nextPageToken: z
+            .string()
+            .optional()
+            .describe('前回レスポンスの nextPageToken（ページング）'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const jql = resolveSearchJql({
+            jql: c.options.jql,
+            project: c.options.project,
+            target: c.args.target,
+        });
+        const body = {
+            jql,
+            maxResults: c.options.limit,
+            fields: [...ISSUE_LIST_FIELDS],
+        };
+        if (c.options.nextPageToken) {
+            body.nextPageToken = c.options.nextPageToken;
+        }
+        const res = await jiraRequest(creds, '/search/jql', {
+            method: 'POST',
+            body: JSON.stringify(body),
+        });
+        const full = {
+            count: res.issues.length,
+            isLast: res.isLast,
+            nextPageToken: res.nextPageToken ?? null,
+            issues: res.issues.map((i) => toIssueSummary(i)),
+            jql,
+        };
+        return finalizeCompactOutput(c, full, (data) => slimSearch(data, true));
+    },
+})
+    .command('create', {
+    description: '課題を作成',
+    options: z.object({
+        project: z
+            .string()
+            .min(1)
+            .describe('プロジェクトキー（WEC）または .../projects/WEC/... の URL'),
+        summary: z.string().min(1).describe('要約'),
+        type: z.string().default('Task').describe('課題タイプ名（例: Task, Bug, Story）'),
+        description: z
+            .string()
+            .optional()
+            .describe('説明（改行可）。メンション: @[712020:uuid...] または @[email:user@example.com]（user search で確認）'),
+        parent: z
+            .string()
+            .optional()
+            .describe('親 Issue キー（INT1-110）または URL（Epic リンク・サブタスク親）'),
+        assignee: z
+            .string()
+            .optional()
+            .describe('担当者 accountId または email:user@example.com'),
+        labels: z
+            .string()
+            .optional()
+            .describe('ラベル（カンマ区切り、例: bug,backend）'),
+        priority: z
+            .string()
+            .optional()
+            .describe('優先度名（例: Highest, High, Medium, Low, Lowest）'),
+        'start-date': z
+            .string()
+            .optional()
+            .describe('開始日（YYYY-MM-DD）'),
+        'due-date': z
+            .string()
+            .optional()
+            .describe('期日（YYYY-MM-DD）'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const projectKey = parseProjectRef(c.options.project);
+        const fields = {
+            project: { key: projectKey },
+            summary: c.options.summary,
+            issuetype: { name: c.options.type },
+        };
+        if (c.options.description !== undefined && c.options.description.length > 0) {
+            fields.description = await descriptionToAdf(creds, c.options.description);
+        }
+        if (c.options.parent !== undefined && c.options.parent.length > 0) {
+            fields.parent = { key: parseIssueKey(c.options.parent) };
+        }
+        if (c.options.assignee !== undefined && c.options.assignee.length > 0) {
+            const accountId = await resolveAssigneeAccountId(creds, c.options.assignee);
+            fields.assignee = { accountId };
+        }
+        if (c.options.labels !== undefined && c.options.labels.length > 0) {
+            fields.labels = c.options.labels.split(',').map((s) => s.trim()).filter(Boolean);
+        }
+        if (c.options.priority !== undefined && c.options.priority.length > 0) {
+            fields.priority = { name: c.options.priority };
+        }
+        if (c.options['start-date'] !== undefined && c.options['start-date'].length > 0) {
+            fields.customfield_10015 = c.options['start-date'];
+        }
+        if (c.options['due-date'] !== undefined && c.options['due-date'].length > 0) {
+            fields.duedate = c.options['due-date'];
+        }
+        const created = await jiraRequest(creds, '/issue', {
+            method: 'POST',
+            body: JSON.stringify({ fields }),
+        });
+        const full = { key: created.key, id: created.id, self: created.self };
+        return finalizeCompactOutput(c, full, (data) => slimCreate(data, true));
+    },
+})
+    .command('update', {
+    description: 'Issue を更新（summary / description / assignee / parent / labels / priority）',
+    args: z.object({
+        ref: z.string().describe('課題キー（WEC-41）または URL'),
+    }),
+    options: z.object({
+        summary: z.string().optional().describe('新しい要約'),
+        description: z
+            .string()
+            .optional()
+            .describe('新しい説明（改行可・@[...] メンション可。空文字でクリア）'),
+        assignee: z
+            .string()
+            .optional()
+            .describe('担当者 accountId または email:user@example.com（"none" で未割当）'),
+        parent: z
+            .string()
+            .optional()
+            .describe('親 Issue キー（INT1-110）または URL（"none" でクリア）'),
+        labels: z
+            .string()
+            .optional()
+            .describe('ラベル（カンマ区切り。空文字でリセット）'),
+        priority: z
+            .string()
+            .optional()
+            .describe('優先度名（例: Highest, High, Medium, Low, Lowest）'),
+        'start-date': z
+            .string()
+            .optional()
+            .describe('開始日（YYYY-MM-DD。"none" でクリア）'),
+        'due-date': z
+            .string()
+            .optional()
+            .describe('期日（YYYY-MM-DD。"none" でクリア）'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const creds = resolveCredentials(c.options);
+        const key = parseIssueKey(c.args.ref);
+        const fields = {};
+        if (c.options.summary !== undefined) {
+            fields.summary = c.options.summary;
+        }
+        if (c.options.description !== undefined) {
+            fields.description =
+                c.options.description.length > 0
+                    ? await descriptionToAdf(creds, c.options.description)
+                    : null;
+        }
+        if (c.options.assignee !== undefined) {
+            if (c.options.assignee === 'none') {
+                fields.assignee = null;
+            }
+            else {
+                const accountId = await resolveAssigneeAccountId(creds, c.options.assignee);
+                fields.assignee = { accountId };
+            }
+        }
+        if (c.options.parent !== undefined) {
+            if (c.options.parent === 'none') {
+                fields.parent = null;
+            }
+            else {
+                fields.parent = { key: parseIssueKey(c.options.parent) };
+            }
+        }
+        if (c.options.labels !== undefined) {
+            fields.labels = c.options.labels
+                ? c.options.labels.split(',').map((s) => s.trim()).filter(Boolean)
+                : [];
+        }
+        if (c.options.priority !== undefined) {
+            fields.priority = c.options.priority === 'none' ? null : { name: c.options.priority };
+        }
+        if (c.options['start-date'] !== undefined) {
+            fields.customfield_10015 =
+                c.options['start-date'] === 'none' ? null : c.options['start-date'];
+        }
+        if (c.options['due-date'] !== undefined) {
+            fields.duedate = c.options['due-date'] === 'none' ? null : c.options['due-date'];
+        }
+        if (Object.keys(fields).length === 0) {
+            throw new Error('更新するフィールドを少なくとも1つ指定してください');
+        }
+        await jiraRequest(creds, `/issue/${encodeURIComponent(key)}`, {
+            method: 'PUT',
+            body: JSON.stringify({ fields }),
+        });
+        const full = { ok: true, key };
+        return finalizeCompactOutput(c, full, (data) => slimUpdate(data, true));
+    },
+})
+    .command('transitions', {
+    description: 'Issue の利用可能なステータス遷移一覧を取得',
+    args: z.object({
+        ref: z.string().describe('課題キー（WEC-41）または URL'),
+    }),
+    options: authOptions,
+    output: z.any(),
+    async run(c) {
+        const key = parseIssueKey(c.args.ref);
+        const creds = resolveCredentials(c.options);
+        const res = await jiraRequest(creds, `/issue/${encodeURIComponent(key)}/transitions`);
+        const full = {
+            key,
+            transitions: res.transitions.map((t) => ({
+                id: t.id,
+                name: t.name,
+                toStatus: t.to?.name ?? '',
+            })),
+        };
+        return finalizeCompactOutput(c, full, (data) => slimTransitions(data, true));
+    },
+})
+    .command('transition', {
+    description: 'Issue のステータスを遷移させる（transitions で id/名前を確認）',
+    args: z.object({
+        ref: z.string().describe('課題キー（WEC-41）または URL'),
+    }),
+    options: z.object({
+        id: z
+            .string()
+            .optional()
+            .describe('遷移 ID（transitions コマンドで確認）'),
+        name: z
+            .string()
+            .optional()
+            .describe('遷移名の部分一致（例: "In Progress", "完了"）。--id 未指定時に使用'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const key = parseIssueKey(c.args.ref);
+        const creds = resolveCredentials(c.options);
+        if (!c.options.id && !c.options.name) {
+            throw new Error('--id または --name を指定してください');
+        }
+        let transitionId = c.options.id;
+        if (!transitionId) {
+            const res = await jiraRequest(creds, `/issue/${encodeURIComponent(key)}/transitions`);
+            const nameLower = c.options.name.toLowerCase();
+            const found = res.transitions.find((t) => t.name.toLowerCase().includes(nameLower));
+            if (!found) {
+                const names = res.transitions.map((t) => `"${t.name}"(id=${t.id})`).join(', ');
+                throw new Error(`遷移が見つかりません: "${c.options.name}". 候補: ${names}`);
+            }
+            transitionId = found.id;
+        }
+        await jiraRequest(creds, `/issue/${encodeURIComponent(key)}/transitions`, {
+            method: 'POST',
+            body: JSON.stringify({ transition: { id: transitionId } }),
+        });
+        const full = { ok: true, key, transitionId };
+        return finalizeCompactOutput(c, full, (data) => ({
+            ok: true,
+            k: data.key,
+            tid: data.transitionId,
+        }));
+    },
+})
+    .command('comments', {
+    description: '課題のコメント一覧（キーまたは browse URL）',
+    args: z.object({
+        ref: z.string().describe('課題キー（WEC-41）または課題 URL'),
+    }),
+    options: z.object({
+        limit: z.coerce.number().int().min(1).max(100).default(50).describe('最大件数'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const key = parseIssueKey(c.args.ref);
+        const creds = resolveCredentials(c.options);
+        const res = await jiraRequest(creds, `/issue/${encodeURIComponent(key)}/comment?maxResults=${c.options.limit}`);
+        const full = {
+            key,
+            total: res.total,
+            comments: res.comments.map((co) => ({
+                id: co.id,
+                author: co.author?.displayName ?? '',
+                created: co.created,
+                body: typeof co.body === 'string'
+                    ? co.body.trim()
+                    : co.body != null && typeof co.body === 'object'
+                        ? plainTextFromAdf(co.body).trim()
+                        : '',
+            })),
+        };
+        return finalizeCompactOutput(c, full, (data) => slimComments(data, true));
+    },
+})
+    .command('comment', {
+    description: 'コメントを追加（メンション: @[accountId] または @[email:...]）',
+    args: z.object({
+        ref: z.string().describe('課題キーまたは URL'),
+    }),
+    options: z.object({
+        body: z.string().min(1).describe('本文（改行可・@[...] メンション可）'),
+        ...authOptions.shape,
+    }),
+    output: z.any(),
+    async run(c) {
+        const key = parseIssueKey(c.args.ref);
+        const creds = resolveCredentials(c.options);
+        const body = await descriptionToAdf(creds, c.options.body);
+        const created = await jiraRequest(creds, `/issue/${encodeURIComponent(key)}/comment`, {
+            method: 'POST',
+            body: JSON.stringify({ body }),
+        });
+        const full = { ok: true, key, id: created.id, self: created.self };
+        return finalizeCompactOutput(c, full, (data) => ({ ok: true, k: data.key, id: data.id }));
+    },
+});

package/dist/issue-fields.d.ts

@@ -0,0 +1,4 @@
+/** issue search でよく使う fields（一覧取得時） */
+export declare const ISSUE_LIST_FIELDS: readonly ["summary", "status", "assignee", "reporter", "issuetype", "priority", "created", "updated", "labels", "parent"];
+/** issue get で取得する fields（ISSUE_LIST_FIELDS + 詳細） */
+export declare const ISSUE_DETAIL_FIELDS: readonly ["summary", "status", "assignee", "reporter", "issuetype", "priority", "created", "updated", "labels", "parent", "description", "components", "duedate"];

package/dist/issue-fields.js

@@ -0,0 +1,20 @@
+/** issue search でよく使う fields（一覧取得時） */
+export const ISSUE_LIST_FIELDS = [
+    'summary',
+    'status',
+    'assignee',
+    'reporter',
+    'issuetype',
+    'priority',
+    'created',
+    'updated',
+    'labels',
+    'parent',
+];
+/** issue get で取得する fields（ISSUE_LIST_FIELDS + 詳細） */
+export const ISSUE_DETAIL_FIELDS = [
+    ...ISSUE_LIST_FIELDS,
+    'description',
+    'components',
+    'duedate',
+];

package/dist/jira-client.d.ts

@@ -0,0 +1,67 @@
+import type { JiraCredentials } from './config.js';
+export declare function jiraRequest<T = unknown>(env: JiraCredentials, path: string, init?: RequestInit): Promise<T>;
+type IssueFields = {
+    summary?: string;
+    status?: {
+        name?: string;
+    };
+    assignee?: {
+        displayName?: string;
+    } | null;
+    reporter?: {
+        displayName?: string;
+    } | null;
+    issuetype?: {
+        name?: string;
+    };
+    priority?: {
+        name?: string;
+    };
+    description?: unknown;
+    created?: string;
+    updated?: string;
+    labels?: string[];
+    components?: Array<{
+        name?: string;
+    }>;
+    duedate?: string | null;
+    parent?: {
+        key?: string;
+        fields?: {
+            summary?: string;
+            status?: {
+                name?: string;
+            };
+        };
+    } | null;
+};
+export type IssueSummary = {
+    key: string;
+    id: string;
+    self: string;
+    summary: string;
+    status: string;
+    assignee: string | null;
+    reporter: string | null;
+    issuetype: string;
+    priority: string | null;
+    /** description を ADF から抜いたテキスト（無ければ null） */
+    description: string | null;
+    created: string | null;
+    updated: string | null;
+    labels: string[];
+    components: string[];
+    duedate: string | null;
+    parent: {
+        key: string;
+        summary: string;
+        status: string;
+    } | null;
+};
+export declare function toIssueSummary(raw: {
+    key: string;
+    id: string;
+    self: string;
+    fields?: IssueFields;
+}): IssueSummary;
+export {};

package/dist/jira-client.js

@@ -0,0 +1,77 @@
+import { Buffer } from 'node:buffer';
+import { plainTextFromAdf } from './adf.js';
+import { normalizeJiraBaseUrl } from './jira-env.js';
+function formatJiraError(status, data) {
+    if (data && typeof data === 'object' && 'errorMessages' in data) {
+        const msgs = data.errorMessages;
+        if (Array.isArray(msgs) && msgs.length)
+            return msgs.join('; ');
+    }
+    if (data && typeof data === 'object' && 'errors' in data) {
+        const err = data.errors;
+        if (err && typeof err === 'object') {
+            return Object.entries(err)
+                .map(([k, v]) => `${k}: ${v}`)
+                .join('; ');
+        }
+    }
+    return `HTTP ${status}`;
+}
+export async function jiraRequest(env, path, init) {
+    const base = normalizeJiraBaseUrl(env.host);
+    const url = `${base}/rest/api/3${path.startsWith('/') ? path : `/${path}`}`;
+    const token = Buffer.from(`${env.email}:${env.apiToken}`).toString('base64');
+    const headers = new Headers(init?.headers);
+    headers.set('Authorization', `Basic ${token}`);
+    headers.set('Accept', 'application/json');
+    if (init?.body !== undefined && !headers.has('Content-Type')) {
+        headers.set('Content-Type', 'application/json');
+    }
+    const res = await fetch(url, { ...init, headers });
+    const text = await res.text();
+    let data = null;
+    if (text) {
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            data = { raw: text };
+        }
+    }
+    if (!res.ok) {
+        throw new Error(`Jira API ${res.status}: ${formatJiraError(res.status, data)}`);
+    }
+    return data;
+}
+export function toIssueSummary(raw) {
+    const f = raw.fields ?? {};
+    const descRaw = f.description;
+    const description = descRaw != null && typeof descRaw === 'object'
+        ? plainTextFromAdf(descRaw).trim() || null
+        : null;
+    const parent = f.parent?.key != null
+        ? {
+            key: f.parent.key,
+            summary: f.parent.fields?.summary ?? '',
+            status: f.parent.fields?.status?.name ?? '',
+        }
+        : null;
+    return {
+        key: raw.key,
+        id: raw.id,
+        self: raw.self,
+        summary: f.summary ?? '',
+        status: f.status?.name ?? '',
+        assignee: f.assignee?.displayName ?? null,
+        reporter: f.reporter?.displayName ?? null,
+        issuetype: f.issuetype?.name ?? '',
+        priority: f.priority?.name ?? null,
+        description,
+        created: f.created ?? null,
+        updated: f.updated ?? null,
+        labels: f.labels ?? [],
+        components: (f.components ?? []).map((c) => c.name ?? '').filter(Boolean),
+        duedate: f.duedate ?? null,
+        parent,
+    };
+}

package/dist/jira-env.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'incur';
+/** 環境変数スキーマ（各コマンドで共有） */
+export declare const jiraEnvSchema: z.ZodObject<{
+    JIRA_HOST: z.ZodString;
+    JIRA_EMAIL: z.ZodString;
+    JIRA_API_TOKEN: z.ZodString;
+    JIRA_CLI_COMPACT: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JiraEnv = z.infer<typeof jiraEnvSchema>;
+export declare function normalizeJiraBaseUrl(host: string): string;

package/dist/jira-env.js

@@ -0,0 +1,23 @@
+import { z } from 'incur';
+/** 環境変数スキーマ（各コマンドで共有） */
+export const jiraEnvSchema = z.object({
+    JIRA_HOST: z
+        .string()
+        .min(1)
+        .describe('Jira サイトホスト（例: your-company.atlassian.net、https は不要）'),
+    JIRA_EMAIL: z.string().email().describe('Atlassian アカウントのメール'),
+    JIRA_API_TOKEN: z.string().min(1).describe('API トークン（Atlassian アカウント設定から発行）'),
+    JIRA_CLI_COMPACT: z
+        .string()
+        .optional()
+        .describe('1/true=常に圧縮出力、0/false=常にフル、未設定=パイプ/非TTY のときだけ圧縮（エージェント向けトークン削減）'),
+});
+export function normalizeJiraBaseUrl(host) {
+    let h = host.trim();
+    if (h.startsWith('https://'))
+        h = h.slice('https://'.length);
+    else if (h.startsWith('http://'))
+        h = h.slice('http://'.length);
+    h = h.replace(/\/$/, '');
+    return `https://${h}`;
+}

package/dist/jsonl-lines.d.ts

@@ -0,0 +1,3 @@
+export declare function valueToJsonlLines(data: unknown): string;
+/** `--format jsonl` のとき NDJSON 文字列を返す（incur はスカラー文字列をそのまま stdout へ出す） */
+export declare function outJsonlIfNeeded(data: unknown, format: string): unknown;

package/dist/jsonl-lines.js

@@ -0,0 +1,57 @@
+/**
+ * コマンド結果を NDJSON（1 行 1 JSON）にする。
+ * 配列系は 1 行ずつ、先頭にメタ行（`_: "meta"`）を付ける場合あり。
+ */
+function collectionToJsonl(object, collectionKey, rows) {
+    const meta = { ...object };
+    delete meta[collectionKey];
+    const lines = [];
+    if (Object.keys(meta).length > 0) {
+        lines.push(JSON.stringify({ _: 'meta', ...meta }));
+    }
+    for (const row of rows) {
+        lines.push(JSON.stringify(row));
+    }
+    return `${lines.join('\n')}\n`;
+}
+export function valueToJsonlLines(data) {
+    if (data == null)
+        return '\n';
+    if (typeof data !== 'object') {
+        return `${JSON.stringify(data)}\n`;
+    }
+    const o = data;
+    if ('issue' in o && o.issue != null && typeof o.issue === 'object') {
+        return `${JSON.stringify(o.issue)}\n`;
+    }
+    const issuesKey = 'issues' in o ? 'issues' : 'i' in o ? 'i' : null;
+    if (issuesKey && Array.isArray(o[issuesKey])) {
+        return collectionToJsonl(o, issuesKey, o[issuesKey]);
+    }
+    if ('comments' in o && Array.isArray(o.comments)) {
+        return collectionToJsonl(o, 'comments', o.comments);
+    }
+    if ('c' in o && Array.isArray(o.c)) {
+        return collectionToJsonl(o, 'c', o.c);
+    }
+    if ('projects' in o && Array.isArray(o.projects)) {
+        return collectionToJsonl(o, 'projects', o.projects);
+    }
+    if ('p' in o && Array.isArray(o.p)) {
+        return collectionToJsonl(o, 'p', o.p);
+    }
+    if ('users' in o && Array.isArray(o.users)) {
+        return collectionToJsonl(o, 'users', o.users);
+    }
+    if ('u' in o && Array.isArray(o.u)) {
+        return collectionToJsonl(o, 'u', o.u);
+    }
+    if (Array.isArray(data)) {
+        return `${data.map((x) => JSON.stringify(x)).join('\n')}\n`;
+    }
+    return `${JSON.stringify(data)}\n`;
+}
+/** `--format jsonl` のとき NDJSON 文字列を返す（incur はスカラー文字列をそのまま stdout へ出す） */
+export function outJsonlIfNeeded(data, format) {
+    return format === 'jsonl' ? valueToJsonlLines(data) : data;
+}

package/dist/load-dotenv.d.ts

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