@bussolabs/closeyourit-cli 0.0.9 → 0.0.11

package/README.md

@@ -72,6 +72,9 @@ organization are stored locally.
 | `servers tokens list` | List the fleet enrollment tokens. |
 | `servers tokens create <name>` | Create an enrollment token (secret shown once). |
 | `servers tokens revoke <id> --confirm` | Revoke an enrollment token. |
+| `alerts channels list` | List the external alert channels (webhook / Telegram). |
+| `alerts channels create <name> --kind telegram\|webhook …` | Create a channel (`--bot-token`/`--chat-id` or `--url`/`--secret`). |
+| `alerts channels delete <id> --confirm` | Delete a channel. |
 
 Every command accepts `--json` for machine-readable output and `--help` for usage details.
 `--project` accepts either a project UUID or its key (matched case-insensitively).

package/dist/commands/alerts/channels/create.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base';
+export default class AlertsChannelsCreate extends BaseCommand {
+    static args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        kind: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        url: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        secret: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'bot-token': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'chat-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/alerts/channels/create.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+const output_1 = require("../../../lib/output");
+class AlertsChannelsCreate extends base_1.BaseCommand {
+    static args = {
+        name: core_1.Args.string({ description: 'Channel name', required: true }),
+    };
+    static description = 'Create an external alert channel (webhook or Telegram)';
+    static examples = [
+        '<%= config.bin %> alerts channels create "Ops Telegram" --kind telegram --bot-token <token> --chat-id <id>',
+        '<%= config.bin %> alerts channels create "Ops hook" --kind webhook --url https://example.com/hook --secret s3cret',
+    ];
+    static flags = {
+        kind: core_1.Flags.string({ description: 'Channel kind', options: ['webhook', 'telegram'], required: true }),
+        url: core_1.Flags.string({ description: 'Webhook URL (kind webhook)' }),
+        secret: core_1.Flags.string({ description: 'Webhook signing secret (kind webhook, optional)' }),
+        'bot-token': core_1.Flags.string({ description: 'Telegram bot token from @BotFather (kind telegram)' }),
+        'chat-id': core_1.Flags.string({ description: 'Telegram chat id receiving the messages (kind telegram)' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AlertsChannelsCreate);
+        const body = { name: args.name, kind: flags.kind };
+        if (flags.url !== undefined)
+            body.webhook_url = flags.url;
+        if (flags.secret !== undefined)
+            body.webhook_secret = flags.secret;
+        if (flags['bot-token'] !== undefined)
+            body.telegram_bot_token = flags['bot-token'];
+        if (flags['chat-id'] !== undefined)
+            body.telegram_chat_id = flags['chat-id'];
+        const res = await this.api.post('/cli/v1/alert_channels', body);
+        if (!this.jsonEnabled()) {
+            this.log('Channel created:');
+            this.log((0, output_1.renderRecord)(res.data ?? {}));
+        }
+        return res;
+    }
+}
+exports.default = AlertsChannelsCreate;

package/dist/commands/alerts/channels/delete.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../base';
+export default class AlertsChannelsDelete extends BaseCommand {
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/alerts/channels/delete.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_1 = require("../../../base");
+class AlertsChannelsDelete extends base_1.BaseCommand {
+    static args = {
+        id: core_1.Args.string({ description: 'Channel id', required: true }),
+    };
+    static description = 'Delete an external alert channel (rules keep delivering in-app/email)';
+    static examples = ['<%= config.bin %> alerts channels delete <channel-id> --confirm'];
+    static flags = {
+        confirm: core_1.Flags.boolean({ description: 'Required: confirm the deletion' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AlertsChannelsDelete);
+        if (!flags.confirm) {
+            this.error('Refusing to delete without --confirm.', { exit: 2 });
+        }
+        await this.api.delete(`/cli/v1/alert_channels/${encodeURIComponent(args.id)}`);
+        if (!this.jsonEnabled())
+            this.log(`Deleted channel ${args.id}`);
+        return { deleted: args.id };
+    }
+}
+exports.default = AlertsChannelsDelete;

package/dist/commands/alerts/channels/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../../base';
+export default class AlertsChannelsList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}

package/dist/commands/alerts/channels/list.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_1 = require("../../../base");
+const output_1 = require("../../../lib/output");
+class AlertsChannelsList extends base_1.BaseCommand {
+    static description = 'List the external alert channels (webhook / Telegram)';
+    static examples = ['<%= config.bin %> alerts channels list'];
+    static flags = { ...base_1.pageFlag };
+    async run() {
+        const { flags } = await this.parse(AlertsChannelsList);
+        const res = await this.api.get(`/cli/v1/alert_channels?page=${flags.page}`);
+        const channels = res.data ?? [];
+        if (!this.jsonEnabled()) {
+            this.log((0, output_1.renderTable)(['NAME', 'KIND', 'TARGET', 'ENABLED', 'ID'], channels.map((channel) => [
+                String(channel.name ?? ''),
+                String(channel.kind ?? ''),
+                String(channel.target ?? '-'),
+                String(channel.enabled ?? ''),
+                String(channel.id ?? ''),
+            ])));
+        }
+        return res;
+    }
+}
+exports.default = AlertsChannelsList;

package/dist/commands/alerts/create.d.ts

@@ -9,6 +9,8 @@ export default class AlertsCreate extends BaseCommand {
         'event-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'min-level': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'threshold-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        threshold: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        channel: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'throttle-minutes': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         enabled: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/alerts/create.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const alert_events_1 = require("../../lib/alert-events");
 const output_1 = require("../../lib/output");
-const EVENT_TYPES = ['error_new', 'error_regression', 'uptime_down', 'uptime_up', 'metric_threshold'];
 class AlertsCreate extends base_1.BaseCommand {
     static args = {
         name: core_1.Args.string({ description: 'Rule name', required: true }),
@@ -14,9 +14,11 @@ class AlertsCreate extends base_1.BaseCommand {
         '<%= config.bin %> alerts create "API down" --event-type uptime_down --project acme-api --throttle-minutes 30',
     ];
     static flags = {
-        'event-type': core_1.Flags.string({ description: 'Event that triggers the rule', options: EVENT_TYPES, required: true }),
+        'event-type': core_1.Flags.string({ description: 'Event that triggers the rule', options: alert_events_1.ALERT_EVENT_TYPES, required: true }),
         'min-level': core_1.Flags.string({ description: 'Minimum error level that triggers the rule' }),
         'threshold-ms': core_1.Flags.integer({ description: 'Duration threshold in milliseconds (metric rules)' }),
+        threshold: core_1.Flags.integer({ description: 'Server threshold: percent for cpu/mem/disk, °C for temp' }),
+        channel: core_1.Flags.string({ description: 'External channel id to deliver to (repeatable; REPLACES the set)', multiple: true }),
         'throttle-minutes': core_1.Flags.integer({ description: 'Minimum minutes between notifications' }),
         enabled: core_1.Flags.boolean({ allowNo: true, description: 'Whether the rule is enabled' }),
         project: core_1.Flags.string({ description: 'Scope the rule to a project id (UUID)' }),
@@ -29,6 +31,10 @@ class AlertsCreate extends base_1.BaseCommand {
             body.min_level = flags['min-level'];
         if (flags['threshold-ms'] !== undefined)
             body.threshold_ms = flags['threshold-ms'];
+        if (flags.threshold !== undefined)
+            body.threshold = flags.threshold;
+        if (flags.channel !== undefined)
+            body.channel_ids = flags.channel;
         if (flags['throttle-minutes'] !== undefined)
             body.throttle_minutes = flags['throttle-minutes'];
         if (flags.enabled !== undefined)

package/dist/commands/alerts/update.d.ts

@@ -10,6 +10,8 @@ export default class AlertsUpdate extends BaseCommand {
         'event-type': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'min-level': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'threshold-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        threshold: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        channel: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'throttle-minutes': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         enabled: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         project: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/alerts/update.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const alert_events_1 = require("../../lib/alert-events");
 const output_1 = require("../../lib/output");
-const EVENT_TYPES = ['error_new', 'error_regression', 'uptime_down', 'uptime_up', 'metric_threshold'];
 class AlertsUpdate extends base_1.BaseCommand {
     static args = {
         id: core_1.Args.string({ description: 'Alert rule id', required: true }),
@@ -15,9 +15,11 @@ class AlertsUpdate extends base_1.BaseCommand {
     ];
     static flags = {
         name: core_1.Flags.string({ description: 'Rule name' }),
-        'event-type': core_1.Flags.string({ description: 'Event that triggers the rule', options: EVENT_TYPES }),
+        'event-type': core_1.Flags.string({ description: 'Event that triggers the rule', options: alert_events_1.ALERT_EVENT_TYPES }),
         'min-level': core_1.Flags.string({ description: 'Minimum error level that triggers the rule' }),
         'threshold-ms': core_1.Flags.integer({ description: 'Duration threshold in milliseconds (metric rules)' }),
+        threshold: core_1.Flags.integer({ description: 'Server threshold: percent for cpu/mem/disk, °C for temp' }),
+        channel: core_1.Flags.string({ description: 'External channel id to deliver to (repeatable; REPLACES the set)', multiple: true }),
         'throttle-minutes': core_1.Flags.integer({ description: 'Minimum minutes between notifications' }),
         enabled: core_1.Flags.boolean({ allowNo: true, description: 'Whether the rule is enabled' }),
         project: core_1.Flags.string({ description: 'Scope the rule to a project id (UUID)' }),
@@ -34,6 +36,10 @@ class AlertsUpdate extends base_1.BaseCommand {
             body.min_level = flags['min-level'];
         if (flags['threshold-ms'] !== undefined)
             body.threshold_ms = flags['threshold-ms'];
+        if (flags.threshold !== undefined)
+            body.threshold = flags.threshold;
+        if (flags.channel !== undefined)
+            body.channel_ids = flags.channel;
         if (flags['throttle-minutes'] !== undefined)
             body.throttle_minutes = flags['throttle-minutes'];
         if (flags.enabled !== undefined)

package/dist/commands/tickets/attachment-download.js

@@ -6,10 +6,10 @@ const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
 class TicketsAttachmentDownload extends base_1.BaseCommand {
     static args = {
-        id: core_1.Args.string({ description: 'Ticket id', required: true }),
-        attachment: core_1.Args.string({ description: 'Attachment id', required: true }),
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
+        attachment: core_1.Args.string({ description: 'Attachment id (ticket attachment or comment file)', required: true }),
     };
-    static description = 'Download a ticket attachment to disk';
+    static description = 'Download a ticket binary to disk: works for ticket attachments AND files attached to its comments';
     static examples = [
         '<%= config.bin %> tickets attachment-download <ticket-id> <attachment-id> --project acme-api',
         '<%= config.bin %> tickets attachment-download <ticket-id> <attachment-id> -p acme-api --out ./downloads',

package/dist/commands/tickets/comments.js

@@ -2,11 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
+const output_1 = require("../../lib/output");
 class TicketsComments extends base_1.BaseCommand {
     static args = {
-        id: core_1.Args.string({ description: 'Ticket id', required: true }),
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
     };
-    static description = 'List all comments of a ticket (oldest first)';
+    static description = 'List all comments of a ticket (oldest first), including attached files — download them with tickets attachment-download';
     static examples = [
         '<%= config.bin %> tickets comments <ticket-id> --project acme-api',
         '<%= config.bin %> tickets comments <ticket-id> -p acme-api --json',
@@ -33,8 +34,12 @@ class TicketsComments extends base_1.BaseCommand {
             }
             else {
                 for (const comment of all) {
-                    this.log(`\n── ${String(comment.author ?? '?')} · ${String(comment.created_at ?? '')} · ${String(comment.id ?? '')}`);
-                    this.log(String(comment.body ?? ''));
+                    this.log(`\n── ${(0, output_1.sanitize)(comment.author ?? '?')} · ${(0, output_1.sanitize)(comment.created_at ?? '')} · ${(0, output_1.sanitize)(comment.id ?? '')}`);
+                    this.log((0, output_1.sanitizeMultiline)(comment.body ?? ''));
+                    const files = Array.isArray(comment.files) ? comment.files : [];
+                    for (const file of files) {
+                        this.log(`   [file] ${(0, output_1.sanitize)(file.id)} · ${(0, output_1.sanitize)(file.filename)} · ${(0, output_1.sanitize)(file.content_type)} · ${(0, output_1.sanitize)(file.byte_size)} bytes`);
+                    }
                 }
             }
         }

package/dist/commands/tickets/show.d.ts

@@ -9,4 +9,9 @@ export default class TicketsShow extends BaseCommand {
         project: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<unknown>;
+    /** Read every page of a collection endpoint: the discussion must be complete, not just page 1. */
+    private fetchAllPages;
+    private renderAttachments;
+    private renderComments;
+    private renderTicket;
 }

package/dist/commands/tickets/show.js

@@ -4,20 +4,104 @@ const core_1 = require("@oclif/core");
 const base_1 = require("../../base");
 const output_1 = require("../../lib/output");
 class TicketsShow extends base_1.BaseCommand {
-    static description = 'Show a single ticket';
-    static examples = ['<%= config.bin %> tickets show <ticket-id> --project acme-api'];
+    static description = 'Show a single ticket in full: body (description + Given/When/Then/Expected), comments (with their files) and attachments';
+    static examples = [
+        '<%= config.bin %> tickets show <ticket-id> --project acme-api',
+        '<%= config.bin %> tickets show DRFL-3 --project driverone-flutter',
+        '<%= config.bin %> tickets show DRFL-3 -p driverone-flutter --json',
+    ];
     static args = {
-        id: core_1.Args.string({ description: 'Ticket id or code', required: true }),
+        id: core_1.Args.string({ description: 'Ticket id or code (e.g. DRFL-3)', required: true }),
     };
     static flags = { ...base_1.projectFlag };
     async run() {
         const { args, flags } = await this.parse(TicketsShow);
         const projectId = await this.resolveProjectId(flags.project);
-        const res = await this.api.get(`/cli/v1/projects/${projectId}/tickets/${args.id}`);
+        const base = `/cli/v1/projects/${encodeURIComponent(projectId)}/tickets/${encodeURIComponent(args.id)}`;
+        // The show is the analysis entry point: always the WHOLE ticket in one command
+        // (fields + full discussion + attachments), so nothing stays hidden behind extra calls.
+        const res = await this.api.get(base);
+        const ticket = res.data ?? {};
+        const comments = await this.fetchAllPages(`${base}/comments`);
+        const attachments = await this.fetchAllPages(`${base}/attachments`);
         if (!this.jsonEnabled()) {
-            this.log((0, output_1.renderRecord)(res.data ?? {}));
+            this.renderTicket(ticket);
+            this.renderComments(comments);
+            this.renderAttachments(attachments);
+        }
+        return { data: { ...ticket, comments, attachments } };
+    }
+    /** Read every page of a collection endpoint: the discussion must be complete, not just page 1. */
+    async fetchAllPages(path) {
+        const all = [];
+        let page = 1;
+        let totalPages = 1;
+        do {
+            // eslint-disable-next-line no-await-in-loop
+            const res = await this.api.get(`${path}?page=${page}&per=100`);
+            all.push(...(Array.isArray(res.data) ? res.data : []));
+            totalPages = Number(res.meta?.total_pages ?? 1);
+            page += 1;
+        } while (page <= totalPages);
+        return all;
+    }
+    renderAttachments(attachments) {
+        this.log(`\nAttachments (${attachments.length})`);
+        if (attachments.length === 0)
+            return;
+        this.log((0, output_1.renderTable)(['ID', 'FILENAME', 'CONTENT_TYPE', 'BYTE_SIZE', 'CREATED_AT'], attachments.map((attachment) => [
+            String(attachment.id ?? ''),
+            String(attachment.filename ?? ''),
+            String(attachment.content_type ?? ''),
+            String(attachment.byte_size ?? ''),
+            String(attachment.created_at ?? ''),
+        ])));
+    }
+    renderComments(comments) {
+        this.log(`\nComments (${comments.length})`);
+        for (const comment of comments) {
+            this.log(`\n── ${(0, output_1.sanitize)(comment.author ?? '?')} · ${(0, output_1.sanitize)(comment.created_at ?? '')} · ${(0, output_1.sanitize)(comment.id ?? '')}`);
+            this.log((0, output_1.sanitizeMultiline)(comment.body ?? ''));
+            const files = Array.isArray(comment.files) ? comment.files : [];
+            for (const file of files) {
+                this.log(`   [file] ${(0, output_1.sanitize)(file.id)} · ${(0, output_1.sanitize)(file.filename)} · ${(0, output_1.sanitize)(file.content_type)} · ${(0, output_1.sanitize)(file.byte_size)} bytes`);
+            }
+        }
+    }
+    renderTicket(ticket) {
+        const platforms = Array.isArray(ticket.platforms) ? ticket.platforms.map(String).join(', ') : null;
+        this.log((0, output_1.renderRecord)({
+            id: ticket.id,
+            code: ticket.code,
+            title: ticket.title,
+            kind: ticket.kind,
+            status: ticket.status,
+            priority: ticket.priority,
+            weight: ticket.weight,
+            votes_count: ticket.votes_count,
+            assignee: ticket.assignee,
+            reporter: ticket.reporter,
+            reviewer: ticket.reviewer,
+            milestone: ticket.milestone,
+            platforms: platforms || null,
+            project_id: ticket.project_id,
+            created_at: ticket.created_at,
+            updated_at: ticket.updated_at,
+        }));
+        // Multi-line body blocks: description first, then the 4 BDD clauses (only those present).
+        const blocks = [
+            ['Description', ticket.description],
+            ['Given', ticket.step_given],
+            ['When', ticket.step_when],
+            ['Then', ticket.step_then],
+            ['Expected', ticket.step_expected],
+        ];
+        for (const [label, value] of blocks) {
+            if (value === null || value === undefined || String(value).trim() === '')
+                continue;
+            this.log(`\n${label}\n${'-'.repeat(label.length)}`);
+            this.log((0, output_1.sanitizeMultiline)(value));
         }
-        return res;
     }
 }
 exports.default = TicketsShow;

package/dist/lib/alert-events.d.ts

@@ -0,0 +1,2 @@
+/** Event types accepted by alert rules — mirror of the backend enum (Alerting::Rule). */
+export declare const ALERT_EVENT_TYPES: string[];

package/dist/lib/alert-events.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALERT_EVENT_TYPES = void 0;
+/** Event types accepted by alert rules — mirror of the backend enum (Alerting::Rule). */
+exports.ALERT_EVENT_TYPES = [
+    'error_new',
+    'error_regression',
+    'uptime_down',
+    'uptime_up',
+    'metric_threshold',
+    'uptime_ssl_expiring',
+    'cron_missed',
+    'server_down',
+    'server_up',
+    'server_cpu',
+    'server_mem',
+    'server_disk',
+    'server_temp',
+    'server_service_failed',
+    'server_smart_failing',
+];

package/dist/lib/output.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Neutralize terminal control sequences (CWE-150) in server-supplied strings.
+ * Log/error/ticket text is attacker-influenceable; printing raw ESC (0x1B) & co.
+ * to a TTY allows cursor/color/title injection. Replace every C0/C1 control char
+ * (0x00–0x1F, 0x7F–0x9F) with a space — ANSI is defused, width is preserved.
+ */
+export declare function sanitize(value: unknown): string;
+/**
+ * Like `sanitize`, but preserves line breaks: for multi-line bodies (ticket description,
+ * BDD clauses, comment text) where collapsing `\n` to spaces would destroy readability.
+ * Every other C0/C1 control char is still defused per line.
+ */
+export declare function sanitizeMultiline(value: unknown): string;
 /** Minimal dependency-free table renderer for human output. */
 export declare function renderTable(headers: string[], rows: string[][]): string;
 /** Pretty-print the scalar fields of a record as `key: value` lines. */

package/dist/lib/output.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitize = sanitize;
+exports.sanitizeMultiline = sanitizeMultiline;
 exports.renderTable = renderTable;
 exports.renderRecord = renderRecord;
 /**
@@ -16,6 +18,17 @@ function sanitize(value) {
     }
     return out;
 }
+/**
+ * Like `sanitize`, but preserves line breaks: for multi-line bodies (ticket description,
+ * BDD clauses, comment text) where collapsing `\n` to spaces would destroy readability.
+ * Every other C0/C1 control char is still defused per line.
+ */
+function sanitizeMultiline(value) {
+    return String(value ?? '')
+        .split('\n')
+        .map((line) => sanitize(line))
+        .join('\n');
+}
 /** Minimal dependency-free table renderer for human output. */
 function renderTable(headers, rows) {
     const safeHeaders = headers.map(sanitize);