@doist/todoist-cli 1.49.0 → 1.51.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.51.0](https://github.com/Doist/todoist-cli/compare/v1.50.0...v1.51.0) (2026-04-20)
+
+### Features
+
+* add folder command group ([#248](https://github.com/Doist/todoist-cli/issues/248)) ([4a17765](https://github.com/Doist/todoist-cli/commit/4a17765e15a45c370fac00810b1a6a7ebabfceb0))
+
+## [1.50.0](https://github.com/Doist/todoist-cli/compare/v1.49.0...v1.50.0) (2026-04-20)
+
+### Features
+
+* Add Help Center CLI commands ([#279](https://github.com/Doist/todoist-cli/issues/279)) ([10d836f](https://github.com/Doist/todoist-cli/commit/10d836fa955e89e1c711338af3cce96cd71c67e5))
+
 ## [1.49.0](https://github.com/Doist/todoist-cli/compare/v1.48.0...v1.49.0) (2026-04-19)
 
 ### Features

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

@@ -0,0 +1,11 @@
+interface CreateFolderOptions {
+    name: string;
+    workspace?: string;
+    defaultOrder?: number;
+    childOrder?: number;
+    json?: boolean;
+    dryRun?: boolean;
+}
+export declare function createFolder(workspaceRef: string, options: CreateFolderOptions): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/folder/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/create.ts"],"names":[],"mappings":"AAMA,UAAU,mBAAmB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAsB,YAAY,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/commands/folder/create.js

@@ -0,0 +1,35 @@
+import chalk from 'chalk';
+import { getApi } from '../../lib/api/core.js';
+import { isQuiet } from '../../lib/global-args.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveWorkspaceRef } from '../../lib/refs.js';
+export async function createFolder(workspaceRef, options) {
+    if (options.dryRun) {
+        printDryRun('create folder', {
+            Name: options.name,
+            Workspace: workspaceRef,
+            'Default order': options.defaultOrder !== undefined ? String(options.defaultOrder) : undefined,
+            'Child order': options.childOrder !== undefined ? String(options.childOrder) : undefined,
+        });
+        return;
+    }
+    const workspace = await resolveWorkspaceRef(workspaceRef);
+    const api = await getApi();
+    const folder = await api.addFolder({
+        name: options.name,
+        workspaceId: workspace.id,
+        defaultOrder: options.defaultOrder,
+        childOrder: options.childOrder,
+    });
+    if (options.json) {
+        console.log(formatJson(folder, 'folder'));
+        return;
+    }
+    if (isQuiet()) {
+        console.log(folder.id);
+        return;
+    }
+    console.log(`Created: ${folder.name}`);
+    console.log(chalk.dim(`ID: ${folder.id}`));
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/folder/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/folder/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAWvD,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,YAAoB,EACpB,OAA4B;IAE5B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,eAAe,EAAE;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,YAAY;YACvB,eAAe,EACX,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;YACjF,aAAa,EACT,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;SAChF,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAA;IACzD,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAA;IAE1B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,SAAS,CAAC,EAAE;QACzB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU;KACjC,CAAC,CAAA;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;QACzC,OAAM;IACV,CAAC;IAED,IAAI,OAAO,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACtB,OAAM;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AAC9C,CAAC"}

package/dist/commands/folder/delete.d.ts

@@ -0,0 +1,6 @@
+export declare function deleteFolder(ref: string, options: {
+    workspace?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/folder/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/delete.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACjE,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/commands/folder/delete.js

@@ -0,0 +1,21 @@
+import { getApi } from '../../lib/api/core.js';
+import { isQuiet } from '../../lib/global-args.js';
+import { printDryRun } from '../../lib/output.js';
+import { resolveFolderByRef } from './helpers.js';
+export async function deleteFolder(ref, options) {
+    const folder = await resolveFolderByRef(ref, options);
+    if (options.dryRun) {
+        printDryRun('delete folder', { Folder: folder.name });
+        return;
+    }
+    if (!options.yes) {
+        console.log(`Would delete folder: ${folder.name}`);
+        console.log('Use --yes to confirm.');
+        return;
+    }
+    const api = await getApi();
+    await api.deleteFolder(folder.id);
+    if (!isQuiet())
+        console.log(`Deleted: ${folder.name} (id:${folder.id})`);
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/folder/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/folder/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,GAAW,EACX,OAAgE;IAEhE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAErD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACrD,OAAM;IACV,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QACpC,OAAM;IACV,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAA;IAC1B,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACjC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,EAAE,GAAG,CAAC,CAAA;AAC5E,CAAC"}

package/dist/commands/folder/helpers.d.ts

@@ -0,0 +1,9 @@
+import type { Folder } from '@doist/todoist-sdk';
+import { type Workspace } from '../../lib/api/workspaces.js';
+export declare function resolveWorkspaceForFolder(options: {
+    workspace?: string;
+}): Promise<Workspace>;
+export declare function resolveFolderByRef(ref: string, options: {
+    workspace?: string;
+}): Promise<Folder>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/commands/folder/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAI7E,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,OAAO,CAAC,SAAS,CAAC,CAkBrB;AAED,wBAAsB,kBAAkB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/commands/folder/helpers.js

@@ -0,0 +1,34 @@
+import { getApi } from '../../lib/api/core.js';
+import { fetchWorkspaces } from '../../lib/api/workspaces.js';
+import { CliError } from '../../lib/errors.js';
+import { resolveFolderRef, resolveWorkspaceRef } from '../../lib/refs.js';
+export async function resolveWorkspaceForFolder(options) {
+    if (options.workspace) {
+        return resolveWorkspaceRef(options.workspace);
+    }
+    const workspaces = await fetchWorkspaces();
+    if (workspaces.length === 0) {
+        throw new CliError('WORKSPACE_NOT_FOUND', 'No workspaces found. Folders require a workspace.');
+    }
+    if (workspaces.length === 1) {
+        return workspaces[0];
+    }
+    throw new CliError('WORKSPACE_NOT_FOUND', 'Multiple workspaces found. Specify --workspace.', [
+        'Available workspaces:',
+        ...workspaces.map((w) => `  "${w.name}" (id:${w.id})`),
+    ]);
+}
+export async function resolveFolderByRef(ref, options) {
+    const api = await getApi();
+    // id:xxx reference — fetch directly, no workspace needed
+    if (ref.startsWith('id:')) {
+        const id = ref.slice(3);
+        return api.getFolder(id);
+    }
+    // Otherwise resolve via workspace-scoped folder list
+    const workspace = await resolveWorkspaceForFolder(options);
+    const folder = await resolveFolderRef(ref, workspace.id);
+    // Fetch the full Folder object from the REST API
+    return api.getFolder(folder.id);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/folder/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/commands/folder/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAkB,MAAM,6BAA6B,CAAA;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAE/C;IACG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACjD,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,eAAe,EAAE,CAAA;IAC1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CACd,qBAAqB,EACrB,mDAAmD,CACtD,CAAA;IACL,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IACD,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,iDAAiD,EAAE;QACzF,uBAAuB;QACvB,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;KACzD,CAAC,CAAA;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,GAAW,EACX,OAA+B;IAE/B,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAA;IAE1B,yDAAyD;IACzD,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACvB,OAAO,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IAC5B,CAAC;IAED,qDAAqD;IACrD,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,CAAA;IAExD,iDAAiD;IACjD,OAAO,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACnC,CAAC"}

package/dist/commands/folder/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerFolderCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/folder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBnC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0H5D"}

package/dist/commands/folder/index.js

@@ -0,0 +1,109 @@
+import { CURSOR_DESCRIPTION } from '../../lib/constants.js';
+import { CliError } from '../../lib/errors.js';
+import { createFolder } from './create.js';
+import { deleteFolder } from './delete.js';
+import { listFolders } from './list.js';
+import { updateFolder } from './update.js';
+import { viewFolder } from './view.js';
+function parseOrderArg(val) {
+    const n = Number(val);
+    if (!Number.isInteger(n) || n < 0) {
+        throw new CliError('INVALID_ORDER', `Invalid order value: "${val}"`, [
+            'Order must be a non-negative integer (e.g., 0 for top of list)',
+        ]);
+    }
+    return n;
+}
+export function registerFolderCommand(program) {
+    const folder = program
+        .command('folder')
+        .description('Manage workspace folders')
+        .addHelpText('after', `
+Examples:
+  td folder list "Acme"
+  td folder view "Engineering"
+  td folder create "Acme" --name "Engineering"
+  td folder delete "Engineering" --workspace "Acme" --yes`);
+    const listCmd = folder
+        .command('list [workspace]')
+        .description('List folders in a workspace')
+        .option('--workspace <ref>', 'Workspace name or id:xxx')
+        .option('--limit <n>', 'Limit number of results')
+        .option('--cursor <cursor>', CURSOR_DESCRIPTION)
+        .option('--all', 'Fetch all results (no limit)')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .action((refArg, options) => {
+        if (refArg && options.workspace) {
+            throw new CliError('CONFLICTING_OPTIONS', 'Cannot specify workspace both as argument and --workspace flag');
+        }
+        const ref = refArg || options.workspace;
+        if (!ref) {
+            listCmd.help();
+            return;
+        }
+        return listFolders(ref, options);
+    });
+    folder
+        .command('view [ref]', { isDefault: true })
+        .description('View folder details and contained projects')
+        .option('--workspace <ref>', 'Workspace name or id:xxx (for name-based lookup)')
+        .option('--json', 'Output as JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .action((ref, options) => {
+        if (!ref) {
+            folder.help();
+            return;
+        }
+        return viewFolder(ref, options);
+    });
+    const createCmd = folder
+        .command('create [workspace]')
+        .description('Create a folder')
+        .option('--workspace <ref>', 'Workspace name or id:xxx')
+        .option('--name <name>', 'Folder name (required)')
+        .option('--default-order <n>', 'Default order for projects in the folder', parseOrderArg)
+        .option('--child-order <n>', 'Order position of the folder', parseOrderArg)
+        .option('--json', 'Output the created folder as JSON')
+        .option('--dry-run', 'Preview what would happen without executing')
+        .action((refArg, options) => {
+        if (refArg && options.workspace) {
+            throw new CliError('CONFLICTING_OPTIONS', 'Cannot specify workspace both as argument and --workspace flag');
+        }
+        const ref = refArg || options.workspace;
+        if (!ref || !options.name) {
+            createCmd.help();
+            return;
+        }
+        return createFolder(ref, options);
+    });
+    const updateCmd = folder
+        .command('update [ref]')
+        .description('Update a folder')
+        .option('--workspace <ref>', 'Workspace name or id:xxx (for name-based lookup)')
+        .option('--name <name>', 'New folder name')
+        .option('--default-order <n>', 'New default order for projects', parseOrderArg)
+        .option('--json', 'Output the updated folder as JSON')
+        .option('--dry-run', 'Preview what would happen without executing')
+        .action((ref, options) => {
+        if (!ref) {
+            updateCmd.help();
+            return;
+        }
+        return updateFolder(ref, options);
+    });
+    const deleteCmd = folder
+        .command('delete [ref]')
+        .description('Delete a folder')
+        .option('--workspace <ref>', 'Workspace name or id:xxx (for name-based lookup)')
+        .option('--yes', 'Confirm deletion')
+        .option('--dry-run', 'Preview what would happen without executing')
+        .action((ref, options) => {
+        if (!ref) {
+            deleteCmd.help();
+            return;
+        }
+        return deleteFolder(ref, options);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/folder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/folder/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/folder/list.d.ts

@@ -0,0 +1,3 @@
+import type { PaginatedViewOptions } from '../../lib/options.js';
+export declare function listFolders(ref: string, options: PaginatedViewOptions): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/folder/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAKhE,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C3F"}

package/dist/commands/folder/list.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+import { getApi } from '../../lib/api/core.js';
+import { formatNextCursorFooter } from '../../lib/output.js';
+import { paginate } from '../../lib/pagination.js';
+import { resolveWorkspaceRef } from '../../lib/refs.js';
+export async function listFolders(ref, options) {
+    const workspace = await resolveWorkspaceRef(ref);
+    const api = await getApi();
+    const targetLimit = options.all
+        ? Number.MAX_SAFE_INTEGER
+        : options.limit
+            ? parseInt(options.limit, 10)
+            : 300;
+    const { results: folders, nextCursor } = await paginate((cursor, limit) => api.getFolders({
+        workspaceId: workspace.id,
+        cursor: cursor ?? undefined,
+        limit,
+    }), { limit: targetLimit, startCursor: options.cursor });
+    if (options.json) {
+        console.log(JSON.stringify({ results: folders, nextCursor }, null, 2));
+        return;
+    }
+    if (options.ndjson) {
+        for (const folder of folders) {
+            console.log(JSON.stringify(folder));
+        }
+        if (nextCursor) {
+            console.log(JSON.stringify({ _meta: true, nextCursor }));
+        }
+        return;
+    }
+    if (folders.length === 0) {
+        console.log('No folders found.');
+        return;
+    }
+    for (const folder of folders) {
+        const id = chalk.dim(folder.id);
+        console.log(`${id}  ${folder.name}`);
+    }
+    console.log(formatNextCursorFooter(nextCursor));
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/folder/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/folder/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEvD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,OAA6B;IACxE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAA;IAChD,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAA;IAE1B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG;QAC3B,CAAC,CAAC,MAAM,CAAC,gBAAgB;QACzB,CAAC,CAAC,OAAO,CAAC,KAAK;YACb,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAC7B,CAAC,CAAC,GAAG,CAAA;IAEX,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,CACnD,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CACd,GAAG,CAAC,UAAU,CAAC;QACX,WAAW,EAAE,SAAS,CAAC,EAAE;QACzB,MAAM,EAAE,MAAM,IAAI,SAAS;QAC3B,KAAK;KACR,CAAC,EACN,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,CACtD,CAAA;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACtE,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;QACvC,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAC5D,CAAC;QACD,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;QAChC,OAAM;IACV,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAA;AACnD,CAAC"}

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

@@ -0,0 +1,10 @@
+interface UpdateFolderOptions {
+    name?: string;
+    defaultOrder?: number;
+    workspace?: string;
+    json?: boolean;
+    dryRun?: boolean;
+}
+export declare function updateFolder(ref: string, options: UpdateFolderOptions): Promise<void>;
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/folder/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/update.ts"],"names":[],"mappings":"AAMA,UAAU,mBAAmB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3F"}

package/dist/commands/folder/update.js

@@ -0,0 +1,33 @@
+import { getApi } from '../../lib/api/core.js';
+import { CliError } from '../../lib/errors.js';
+import { isQuiet } from '../../lib/global-args.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveFolderByRef } from './helpers.js';
+export async function updateFolder(ref, options) {
+    const folder = await resolveFolderByRef(ref, options);
+    const args = {};
+    if (options.name)
+        args.name = options.name;
+    if (options.defaultOrder !== undefined)
+        args.defaultOrder = options.defaultOrder;
+    if (Object.keys(args).length === 0) {
+        throw new CliError('NO_CHANGES', 'No changes specified.');
+    }
+    if (options.dryRun) {
+        printDryRun('update folder', {
+            Folder: folder.name,
+            Name: args.name,
+            'Default order': args.defaultOrder !== undefined ? String(args.defaultOrder) : undefined,
+        });
+        return;
+    }
+    const api = await getApi();
+    const updated = await api.updateFolder(folder.id, args);
+    if (options.json) {
+        console.log(formatJson(updated, 'folder'));
+        return;
+    }
+    if (!isQuiet())
+        console.log(`Updated: ${folder.name}${options.name ? ` → ${updated.name}` : ''} (id:${folder.id})`);
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/folder/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/folder/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAUjD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,OAA4B;IACxE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAErD,MAAM,IAAI,GAGN,EAAE,CAAA;IACN,IAAI,OAAO,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IAC1C,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;IAEhF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;IAC7D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,eAAe,EAAE;YACzB,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EACX,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9E,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAEvD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC1C,OAAM;IACV,CAAC;IAED,IAAI,CAAC,OAAO,EAAE;QACV,OAAO,CAAC,GAAG,CACP,YAAY,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,MAAM,CAAC,EAAE,GAAG,CACzF,CAAA;AACT,CAAC"}

package/dist/commands/folder/view.d.ts

@@ -0,0 +1,8 @@
+interface ViewFolderOptions {
+    workspace?: string;
+    json?: boolean;
+    full?: boolean;
+}
+export declare function viewFolder(ref: string, options: ViewFolderOptions): Promise<void>;
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/commands/folder/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/commands/folder/view.ts"],"names":[],"mappings":"AAMA,UAAU,iBAAiB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDvF"}

package/dist/commands/folder/view.js

@@ -0,0 +1,52 @@
+import chalk from 'chalk';
+import { getApi } from '../../lib/api/core.js';
+import { paginate } from '../../lib/pagination.js';
+import { resolveWorkspaceRef } from '../../lib/refs.js';
+import { resolveFolderByRef } from './helpers.js';
+export async function viewFolder(ref, options) {
+    const folder = await resolveFolderByRef(ref, options);
+    const api = await getApi();
+    const { results: projects } = await paginate((cursor, limit) => api.getProjects({ folderId: folder.id, cursor: cursor ?? undefined, limit }), { limit: Number.MAX_SAFE_INTEGER });
+    if (options.json) {
+        const output = options.full
+            ? { folder, projects }
+            : {
+                folder: {
+                    id: folder.id,
+                    name: folder.name,
+                    workspaceId: folder.workspaceId,
+                },
+                projects: projects.map((p) => ({
+                    id: p.id,
+                    name: p.name,
+                })),
+            };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Resolve workspace name for display
+    let workspaceName;
+    try {
+        const workspace = await resolveWorkspaceRef(`id:${folder.workspaceId}`);
+        workspaceName = workspace.name;
+    }
+    catch {
+        // workspace lookup is best-effort for display
+    }
+    console.log(chalk.bold(folder.name));
+    console.log(chalk.dim(`ID:        ${folder.id}`));
+    if (workspaceName) {
+        console.log(chalk.dim(`Workspace: ${workspaceName}`));
+    }
+    console.log('');
+    if (projects.length === 0) {
+        console.log('No projects in this folder.');
+        return;
+    }
+    console.log(chalk.dim(`Projects (${projects.length}):`));
+    for (const project of projects) {
+        const id = chalk.dim(project.id);
+        console.log(`  ${id}  ${project.name}`);
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/folder/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/commands/folder/view.ts"],"names":[],"mappings":"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"}

package/dist/commands/hc/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerHelpCenterCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/hc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsDhE"}

package/dist/commands/hc/index.js

@@ -0,0 +1,54 @@
+import { listHelpCenterLocales } from './locales.js';
+import { searchHelpCenterArticles } from './search.js';
+import { viewHelpCenterArticle } from './view.js';
+const LOCALE_OPTION_DESCRIPTION = 'Help Center locale (default: en-us)';
+export function registerHelpCenterCommand(program) {
+    const hc = program
+        .command('hc')
+        .description('Search Todoist Help Center articles')
+        .addHelpText('after', `
+Examples:
+  td hc locales
+  td hc locales --json
+  td hc search "notifications"
+  td hc search "reminders" --locale pt-br --json
+  td hc view id:360000269065
+  td hc view 360000269065
+  td hc view https://get.todoist.help/hc/en-us/articles/360000269065
+
+Notes:
+  search prints real Help Center article IDs
+  view accepts id:N, raw article IDs, and Help Center URLs`);
+    hc.command('locales')
+        .description('List supported Help Center locales')
+        .option('--json', 'Output as JSON')
+        .action(listHelpCenterLocales);
+    const searchCmd = hc
+        .command('search [query]')
+        .description('Search Todoist Help Center articles')
+        .option('--locale <locale>', LOCALE_OPTION_DESCRIPTION)
+        .option('--limit <n>', 'Number of results to return (default: 10, max: 25)')
+        .option('--json', 'Output as JSON')
+        .action((query, options) => {
+        if (!query) {
+            searchCmd.help();
+            return;
+        }
+        return searchHelpCenterArticles(query, options);
+    });
+    const viewCmd = hc
+        .command('view [ref]', { isDefault: true })
+        .description('View a Help Center article by id:N, raw article ID, or URL')
+        .option('--locale <locale>', LOCALE_OPTION_DESCRIPTION)
+        .option('--browser', 'Open the article in your browser')
+        .option('--json', 'Output as JSON')
+        .option('--html', 'Output the raw HTML article body')
+        .action((ref, options) => {
+        if (!ref) {
+            viewCmd.help();
+            return;
+        }
+        return viewHelpCenterArticle(ref, options);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/hc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/hc/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAEjD,MAAM,yBAAyB,GAAG,qCAAqC,CAAA;AAEvE,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACtD,MAAM,EAAE,GAAG,OAAO;SACb,OAAO,CAAC,IAAI,CAAC;SACb,WAAW,CAAC,qCAAqC,CAAC;SAClD,WAAW,CACR,OAAO,EACP;;;;;;;;;;;;2DAY+C,CAClD,CAAA;IAEL,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;SAChB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAElC,MAAM,SAAS,GAAG,EAAE;SACf,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,aAAa,EAAE,oDAAoD,CAAC;SAC3E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,SAAS,CAAC,IAAI,EAAE,CAAA;YAChB,OAAM;QACV,CAAC;QACD,OAAO,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEN,MAAM,OAAO,GAAG,EAAE;SACb,OAAO,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SAC1C,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC;SACpD,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACrB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,EAAE,CAAA;YACd,OAAM;QACV,CAAC;QACD,OAAO,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACV,CAAC"}

package/dist/commands/hc/locales.d.ts

@@ -0,0 +1,5 @@
+export interface ListHelpCenterLocalesOptions {
+    json?: boolean;
+}
+export declare function listHelpCenterLocales(options?: ListHelpCenterLocalesOptions): Promise<void>;
+//# sourceMappingURL=locales.d.ts.map

package/dist/commands/hc/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/commands/hc/locales.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,4BAA4B;IACzC,IAAI,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAsB,qBAAqB,CACvC,OAAO,GAAE,4BAAiC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/commands/hc/locales.js

@@ -0,0 +1,18 @@
+import chalk from 'chalk';
+import { getHelpCenterLocales } from '../../lib/help-center.js';
+import { withSpinner } from '../../lib/spinner.js';
+export async function listHelpCenterLocales(options = {}) {
+    const result = await withSpinner({ text: 'Loading Help Center locales...', color: 'blue' }, () => getHelpCenterLocales());
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`Default locale: ${result.defaultLocale}`);
+    console.log('');
+    console.log('Supported locales:');
+    for (const locale of result.locales) {
+        const defaultTag = locale.isDefault ? ` ${chalk.dim('[default]')}` : '';
+        console.log(`  ${locale.locale}  ${locale.name}${defaultTag}`);
+    }
+}
+//# sourceMappingURL=locales.js.map

package/dist/commands/hc/locales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.js","sourceRoot":"","sources":["../../../src/commands/hc/locales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAMlD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,UAAwC,EAAE;IAE1C,MAAM,MAAM,GAAG,MAAM,WAAW,CAC5B,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,MAAM,EAAE,EACzD,GAAG,EAAE,CAAC,oBAAoB,EAAE,CAC/B,CAAA;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC5C,OAAM;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAA;IACtD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACf,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IAEjC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACvE,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC,CAAA;IAClE,CAAC;AACL,CAAC"}

package/dist/commands/hc/search.d.ts

@@ -0,0 +1,7 @@
+export interface SearchHelpCenterOptions {
+    json?: boolean;
+    limit?: string;
+    locale?: string;
+}
+export declare function searchHelpCenterArticles(query: string, options?: SearchHelpCenterOptions): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/hc/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/hc/search.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACpC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,wBAAwB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/commands/hc/search.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { normalizeHelpCenterLocale, searchHelpCenter } from '../../lib/help-center.js';
+import { withSpinner } from '../../lib/spinner.js';
+export async function searchHelpCenterArticles(query, options = {}) {
+    const trimmedQuery = query.trim();
+    const locale = normalizeHelpCenterLocale(options.locale);
+    const results = await withSpinner({ text: 'Searching Help Center...', color: 'blue' }, () => searchHelpCenter(trimmedQuery, { locale, limit: options.limit }));
+    if (options.json) {
+        console.log(JSON.stringify(results, null, 2));
+        return;
+    }
+    if (results.length === 0) {
+        console.log(`No Help Center articles found for "${trimmedQuery}".`);
+        return;
+    }
+    for (const [index, result] of results.entries()) {
+        console.log(result.title);
+        console.log(`   ${chalk.dim(`id:${result.id}`)}`);
+        console.log(`   ${chalk.dim(result.htmlUrl)}`);
+        if (result.snippet) {
+            console.log(`   ${result.snippet}`);
+        }
+        if (index < results.length - 1) {
+            console.log('');
+        }
+    }
+}
+//# sourceMappingURL=search.js.map