@doist/cli-core 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.6.0](https://github.com/Doist/cli-core/compare/v0.5.0...v0.6.0) (2026-05-09)
+
+### Features
+
+* add ./markdown and ./commands subpaths (optional peer-dep extractions) ([#8](https://github.com/Doist/cli-core/issues/8)) ([6b2ad9d](https://github.com/Doist/cli-core/commit/6b2ad9d5a23b5d1d9ae83a2272e959e927a82d40))
+
 ## [0.5.0](https://github.com/Doist/cli-core/compare/v0.4.0...v0.5.0) (2026-05-08)
 
 ### Features

package/README.md

@@ -2,7 +2,7 @@
 
 Shared core utilities for Doist CLI projects ([todoist-cli](https://github.com/Doist/todoist-cli), [twist-cli](https://github.com/Doist/twist-cli), [outline-cli](https://github.com/Doist/outline-cli)).
 
-> **Status:** scaffolding only. No exports yet — extraction work is in progress.
+TypeScript, ESM-only, Node ≥ 20.18.1.
 
 ## Install
 
@@ -10,17 +10,107 @@ Shared core utilities for Doist CLI projects ([todoist-cli](https://github.com/D
 npm install @doist/cli-core
 ```
 
+## What's in it
+
+| Module               | Key exports                                                                                                                               | Purpose                                                                                                                                                           |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `commands` (subpath) | `registerChangelogCommand` (more to come)                                                                                                 | Commander wiring for cli-core's standard commands (e.g. `<cli> changelog`). **Requires** `commander` as an optional peer-dep.                                     |
+| `config`             | `getConfigPath`, `readConfig`, `readConfigStrict`, `writeConfig`, `updateConfig`                                                          | Read / write a per-CLI JSON config file with typed error codes for broken or missing state.                                                                       |
+| `empty`              | `printEmpty`                                                                                                                              | Print an empty-state message gated on `--json` / `--ndjson` so machine consumers never see human strings on stdout.                                               |
+| `errors`             | `CliError`                                                                                                                                | Typed CLI error class with `code` and exit-code mapping.                                                                                                          |
+| `global-args`        | `parseGlobalArgs`, `createGlobalArgsStore`, `createAccessibleGate`, `createSpinnerGate`, `getProgressJsonlPath`, `isProgressJsonlEnabled` | Parse well-known global flags (`--json`, `--ndjson`, `--quiet`, `--verbose`, `--accessible`, `--no-spinner`, `--progress-jsonl`) and derive predicates from them. |
+| `json`               | `formatJson`, `formatNdjson`                                                                                                              | Stable JSON / newline-delimited JSON formatting for stdout.                                                                                                       |
+| `markdown` (subpath) | `preloadMarkdown`, `renderMarkdown`, `TerminalRendererOptions`                                                                            | Lazy-init terminal markdown renderer. **Requires** `marked` and `marked-terminal-renderer` as peer-deps — install only if your CLI uses this subpath.             |
+| `options`            | `ViewOptions`                                                                                                                             | Type contract for `{ json?, ndjson? }` per-command options that machine-output gates derive from.                                                                 |
+| `spinner`            | `createSpinner`                                                                                                                           | Loading spinner factory wrapping `yocto-spinner` with disable gates.                                                                                              |
+| `terminal`           | `isCI`, `isStderrTTY`, `isStdinTTY`, `isStdoutTTY`                                                                                        | TTY / CI detection helpers.                                                                                                                                       |
+| `testing` (subpath)  | `describeEmptyMachineOutput`                                                                                                              | Vitest helpers reusable by consuming CLIs (e.g. parametrised empty-state suite covering `--json` / `--ndjson` / human modes).                                     |
+
+## Usage
+
+### Global args + spinner gate
+
+```ts
+import { createGlobalArgsStore, createSpinnerGate, createSpinner } from '@doist/cli-core'
+
+const store = createGlobalArgsStore()
+export const isJsonMode = () => store.get().json
+
+const shouldDisableSpinner = createSpinnerGate({
+    envVar: 'TD_SPINNER',
+    getArgs: store.get,
+})
+const { withSpinner } = createSpinner({ isDisabled: shouldDisableSpinner })
+```
+
+### Empty-state print
+
+```ts
+import { printEmpty } from '@doist/cli-core'
+
+if (tasks.length === 0) {
+    printEmpty({ options, message: 'No tasks found.' })
+    return
+}
+```
+
+### Markdown rendering (optional subpath)
+
+Install the peer-deps in the consuming CLI:
+
+```bash
+npm install marked marked-terminal-renderer
+```
+
+Then:
+
+```ts
+import { preloadMarkdown, renderMarkdown } from '@doist/cli-core/markdown'
+
+if (!options.json && !options.raw) {
+    await preloadMarkdown()
+}
+console.log(await renderMarkdown(comment.body))
+```
+
+If the peer-deps are missing, `preloadMarkdown` throws a clear error pointing to the install command. TypeScript will also fail to resolve the subpath's types until the peers are installed.
+
+### Standard commands (optional subpath)
+
+Install the peer-dep in the consuming CLI:
+
+```bash
+npm install commander
+```
+
+Then wire `<cli> changelog` in one call:
+
+```ts
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { registerChangelogCommand } from '@doist/cli-core/commands'
+import packageJson from '../package.json' with { type: 'json' }
+
+registerChangelogCommand(program, {
+    path: join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'CHANGELOG.md'),
+    repoUrl: 'https://github.com/Doist/todoist-cli',
+    version: packageJson.version,
+})
+```
+
+The helper throws `CliError` (`INVALID_TYPE` for a bad `--count`, `FILE_READ_ERROR` if the file can't be read) so the CLI's top-level error handler formats and exits.
+
 ## Development
 
 ```bash
 npm install
 npm run build
 npm test
-npm run check   # lint + format
-npm run fix     # auto-fix lint + format
+npm run check   # oxlint + oxfmt --check (PR gate)
+npm run fix     # oxlint --fix + oxfmt
 ```
 
-Requires Node `>=20.18.1`.
+See [AGENTS.md](AGENTS.md) for project conventions, including the rule that this README is kept in sync with public API changes.
 
 ## License
 

package/dist/commands/changelog.d.ts

@@ -0,0 +1,56 @@
+import type { Command } from 'commander';
+export type ChangelogHeadingLevel = 1 | 2 | 'flexible';
+export type ChangelogBulletMarker = '*' | '-';
+export type ChangelogCommandOptions = {
+    /**
+     * Absolute path to the consuming CLI's `CHANGELOG.md`. Resolve from the
+     * caller's `import.meta.url` so it works in both `src/` and built `dist/`.
+     */
+    path: string;
+    /** Repo URL with no trailing slash; the `/blob/v<version>/CHANGELOG.md` suffix is appended. */
+    repoUrl: string;
+    /** Package version embedded in the "View full changelog" link. */
+    version: string;
+    /** Default value for the `-n/--count` flag. Default: `5`. */
+    defaultCount?: number;
+    /** Heading level used for version rows. Default: `2` (i.e. `## 1.2.3`). */
+    headingLevel?: ChangelogHeadingLevel;
+    /** Bullet markers parsed and rendered. Default: `['*']`. */
+    bulletMarkers?: ReadonlyArray<ChangelogBulletMarker>;
+    /** Indent continuation lines after a bullet (twist-style wrapped bullets). Default: `false`. */
+    continuationIndent?: boolean;
+    /** Drop versions empty after cleaning (e.g. deps-only releases). Default: `false`. */
+    filterEmptyVersions?: boolean;
+};
+export declare function formatInline(text: string): string;
+export declare function formatForTerminal(text: string, options: ChangelogCommandOptions): string;
+export declare function cleanChangelog(text: string, options: ChangelogCommandOptions): string;
+export declare function parseChangelog(content: string, count: number, options: ChangelogCommandOptions): {
+    text: string;
+    hasMore: boolean;
+};
+/**
+ * Register the standard `<cli> changelog` command on a Commander program. The
+ * command reads `options.path`, prints the latest `--count` versions with
+ * conventional-commit boilerplate stripped, and appends a "View full
+ * changelog" link to the matching tag on GitHub.
+ *
+ * Errors as `CliError`: `INVALID_TYPE` for a non-positive `--count`,
+ * `FILE_READ_ERROR` if the file cannot be read. The consumer's top-level
+ * error handler is expected to format and exit.
+ *
+ * ```ts
+ * import { dirname, join } from 'node:path'
+ * import { fileURLToPath } from 'node:url'
+ * import { registerChangelogCommand } from '@doist/cli-core/commands'
+ * import packageJson from '../package.json' with { type: 'json' }
+ *
+ * registerChangelogCommand(program, {
+ *     path: join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'CHANGELOG.md'),
+ *     repoUrl: 'https://github.com/Doist/todoist-cli',
+ *     version: packageJson.version,
+ * })
+ * ```
+ */
+export declare function registerChangelogCommand(program: Command, options: ChangelogCommandOptions): void;
+//# sourceMappingURL=changelog.d.ts.map

package/dist/commands/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/commands/changelog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAA;AACtD,MAAM,MAAM,qBAAqB,GAAG,GAAG,GAAG,GAAG,CAAA;AAE7C,MAAM,MAAM,uBAAuB,GAAG;IAClC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAA;IACpD,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AA6BD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CA8BxF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAwBrF;AASD,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uBAAuB,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAoBpC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CA2BjG"}

package/dist/commands/changelog.js

@@ -0,0 +1,159 @@
+import { readFile } from 'node:fs/promises';
+import chalk from 'chalk';
+import { CliError } from '../errors.js';
+function resolve(options) {
+    return {
+        path: options.path,
+        repoUrl: options.repoUrl,
+        version: options.version,
+        defaultCount: options.defaultCount ?? 5,
+        headingLevel: options.headingLevel ?? 2,
+        bulletMarkers: options.bulletMarkers ?? ['*'],
+        continuationIndent: options.continuationIndent ?? false,
+        filterEmptyVersions: options.filterEmptyVersions ?? false,
+    };
+}
+function headingPrefixSrc(level) {
+    if (level === 1)
+        return '#';
+    if (level === 2)
+        return '##';
+    return '#{1,2}';
+}
+function bulletCharClass(markers) {
+    if (markers.length === 1)
+        return markers[0] === '*' ? '\\*' : '-';
+    return '[*-]';
+}
+export function formatInline(text) {
+    return text
+        .replace(/\*\*([^*]+)\*\*/g, (_, content) => chalk.bold(content))
+        .replace(/`([^`]+)`/g, (_, code) => chalk.cyan(code));
+}
+export function formatForTerminal(text, options) {
+    const { headingLevel, bulletMarkers, continuationIndent } = resolve(options);
+    const headerRe = new RegExp(`^${headingPrefixSrc(headingLevel)} `);
+    const isBulletLine = (line) => bulletMarkers.some((m) => line.startsWith(`${m} `));
+    let inBullet = false;
+    return text
+        .split('\n')
+        .map((line) => {
+        if (headerRe.test(line)) {
+            inBullet = false;
+            return chalk.green.bold(line.replace(headerRe, ''));
+        }
+        if (line.startsWith('### ')) {
+            inBullet = false;
+            return chalk.bold(line.slice(4));
+        }
+        if (isBulletLine(line)) {
+            inBullet = true;
+            return `  ${chalk.dim('•')} ${formatInline(line.slice(2))}`;
+        }
+        if (continuationIndent && inBullet && line.length > 0) {
+            return `    ${formatInline(line)}`;
+        }
+        if (line.length === 0) {
+            inBullet = false;
+        }
+        return formatInline(line);
+    })
+        .join('\n');
+}
+export function cleanChangelog(text, options) {
+    const { headingLevel, bulletMarkers } = resolve(options);
+    const bullets = bulletCharClass(bulletMarkers);
+    const headerSrc = headingPrefixSrc(headingLevel);
+    return (text
+        // Version headers: `## [1.2.3](url)` → `## 1.2.3` (heading level honoured).
+        .replace(new RegExp(`(${headerSrc}) \\[([^\\]]+)\\]\\([^)]*\\)`, 'g'), '$1 $2')
+        // Plain commit-hash parens: ` (abc1234)` and ` ([abc1234](url))`.
+        .replace(/ \([a-f0-9]{7}\)/g, '')
+        .replace(/ \(\[[a-f0-9]{7}\]\([^)]*\)\)/g, '')
+        // Issue / PR links: `[#nnn](url)` → `#nnn`.
+        .replace(/\[#(\d+)\]\([^)]*\)/g, '#$1')
+        // Drop `**deps:**` lines wholesale; not useful to end users.
+        .replace(new RegExp(`^${bullets} \\*\\*deps:\\*\\*.*$`, 'gm'), '')
+        // Drop `**scope:**` prefixes, keep the content: `**task:** foo` → `foo`.
+        .replace(/\*\*[\w-]+:\*\* /g, '')
+        // Collapse blank-line runs left by removed deps lines.
+        .replace(/\n{3,}/g, '\n\n')
+        // Drop now-empty section headers (e.g. `### Bug Fixes` with no items).
+        // The lookahead includes `### ` so consecutive empty sections all peel
+        // away, not just the last one before a version row.
+        .replace(new RegExp(`### [\\w ]+\\n\\n(?=${headerSrc} |### |$)`, 'gm'), ''));
+}
+function isEmptyAfterClean(section, options) {
+    const { headingLevel } = resolve(options);
+    const cleaned = cleanChangelog(section, options);
+    const headerRe = new RegExp(`^${headingPrefixSrc(headingLevel)} .+$`, 'm');
+    return cleaned.replace(headerRe, '').trim().length === 0;
+}
+export function parseChangelog(content, count, options) {
+    const { headingLevel, filterEmptyVersions } = resolve(options);
+    const versionHeaderSrc = `${headingPrefixSrc(headingLevel)} (?:\\d|\\[)`;
+    const splitRe = new RegExp(`\\n(?=${versionHeaderSrc})`);
+    const matchRe = new RegExp(`^${versionHeaderSrc}`);
+    const allVersions = content.split(splitRe).filter((s) => matchRe.test(s));
+    const versionSections = filterEmptyVersions
+        ? allVersions.filter((s) => !isEmptyAfterClean(s, options))
+        : allVersions;
+    const selected = versionSections.slice(0, count);
+    if (selected.length === 0) {
+        return { text: 'No changelog entries found.', hasMore: false };
+    }
+    return {
+        text: cleanChangelog(selected.join('\n').trimEnd(), options),
+        hasMore: versionSections.length > count,
+    };
+}
+/**
+ * Register the standard `<cli> changelog` command on a Commander program. The
+ * command reads `options.path`, prints the latest `--count` versions with
+ * conventional-commit boilerplate stripped, and appends a "View full
+ * changelog" link to the matching tag on GitHub.
+ *
+ * Errors as `CliError`: `INVALID_TYPE` for a non-positive `--count`,
+ * `FILE_READ_ERROR` if the file cannot be read. The consumer's top-level
+ * error handler is expected to format and exit.
+ *
+ * ```ts
+ * import { dirname, join } from 'node:path'
+ * import { fileURLToPath } from 'node:url'
+ * import { registerChangelogCommand } from '@doist/cli-core/commands'
+ * import packageJson from '../package.json' with { type: 'json' }
+ *
+ * registerChangelogCommand(program, {
+ *     path: join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'CHANGELOG.md'),
+ *     repoUrl: 'https://github.com/Doist/todoist-cli',
+ *     version: packageJson.version,
+ * })
+ * ```
+ */
+export function registerChangelogCommand(program, options) {
+    const resolved = resolve(options);
+    program
+        .command('changelog')
+        .description('Show recent changelog entries')
+        .option('-n, --count <number>', 'Number of versions to show', String(resolved.defaultCount))
+        .action(async (commandOptions) => {
+        const count = Number(commandOptions.count);
+        if (!Number.isInteger(count) || count < 1) {
+            throw new CliError('INVALID_TYPE', 'Count must be a positive integer');
+        }
+        let content;
+        try {
+            content = await readFile(options.path, 'utf-8');
+        }
+        catch {
+            throw new CliError('FILE_READ_ERROR', 'Could not read changelog file');
+        }
+        const { text, hasMore } = parseChangelog(content, count, options);
+        console.log(formatForTerminal(text, options));
+        if (hasMore) {
+            const url = `${options.repoUrl}/blob/v${options.version}/CHANGELOG.md`;
+            console.log(chalk.dim(`\nView full changelog: ${url}`));
+        }
+    });
+}
+//# sourceMappingURL=changelog.js.map

package/dist/commands/changelog.js.map

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

package/dist/commands/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error codes thrown by `@doist/cli-core/commands` registration helpers. Folded
+ * into the `CliErrorCode` aggregator in `../errors.ts` so consumers don't have
+ * to redeclare them in their own `TCode` union when catching.
+ */
+export type CommandErrorCode = 'INVALID_TYPE' | 'FILE_READ_ERROR';
+//# sourceMappingURL=errors.d.ts.map

package/dist/commands/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/commands/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,iBAAiB,CAAA"}

package/dist/commands/errors.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/commands/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/commands/errors.ts"],"names":[],"mappings":""}

package/dist/commands/index.d.ts

@@ -0,0 +1,4 @@
+export { registerChangelogCommand } from './changelog.js';
+export type { ChangelogBulletMarker, ChangelogCommandOptions, ChangelogHeadingLevel, } from './changelog.js';
+export type { CommandErrorCode } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EACR,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/commands/index.js

@@ -0,0 +1,2 @@
+export { registerChangelogCommand } from './changelog.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/errors.d.ts

@@ -1,3 +1,4 @@
+import type { CommandErrorCode } from './commands/errors.js';
 import type { ConfigErrorCode } from './config.js';
 export type ErrorType = 'error' | 'info';
 export type CliErrorOptions = {
@@ -15,7 +16,7 @@ export type CliErrorOptions = {
  * export type CliErrorCode = ConfigErrorCode | SpinnerErrorCode | …
  * ```
  */
-export type CliErrorCode = ConfigErrorCode;
+export type CliErrorCode = CommandErrorCode | ConfigErrorCode;
 /**
  * Generic CLI error carrying a structured code, optional hints, and a severity
  * type.

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAExC,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAC9D,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;gBAEZ,IAAI,EAAE,KAAK,GAAG,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;CAOzF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAExC,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,eAAe,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAC9D,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;gBAEZ,IAAI,EAAE,KAAK,GAAG,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;CAOzF"}

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,QAAwC,SAAQ,KAAK;IACrD,IAAI,CAAsB;IAC1B,KAAK,CAAW;IAChB,IAAI,CAAW;IAExB,YAAY,IAA0B,EAAE,OAAe,EAAE,UAA2B,EAAE;QAClF,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAA;IACvC,CAAC;CACJ"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,QAAwC,SAAQ,KAAK;IACrD,IAAI,CAAsB;IAC1B,KAAK,CAAW;IAChB,IAAI,CAAW;IAExB,YAAY,IAA0B,EAAE,OAAe,EAAE,UAA2B,EAAE;QAClF,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAA;IACvC,CAAC;CACJ"}

package/dist/markdown.d.ts

@@ -0,0 +1,53 @@
+import type { TerminalRendererOptions } from 'marked-terminal-renderer';
+export type { TerminalRendererOptions } from 'marked-terminal-renderer';
+export type PreloadMarkdownOptions = {
+    /** Theme to drive the renderer; defaults to `darkTheme()`. */
+    theme?: TerminalRendererOptions;
+};
+/**
+ * Lazy-init a shared `marked` renderer for terminal output. Idempotent — safe
+ * to call multiple times; later calls are no-ops once initialised, so the
+ * `theme` from the first call wins.
+ *
+ * Defer the dynamic import to the call site so CLIs that never render
+ * markdown (e.g. `--json` / `--ndjson` runs) don't pay the load cost. The
+ * peer-dep packages (`marked`, `marked-terminal-renderer`) are loaded only
+ * inside this function — a missing peer surfaces here as a friendly error,
+ * never as a module-link crash on `import`.
+ *
+ * ```ts
+ * import { preloadMarkdown, renderMarkdown } from '@doist/cli-core/markdown'
+ *
+ * if (!options.json && !options.raw) {
+ *     await preloadMarkdown()
+ * }
+ * console.log(await renderMarkdown(comment.body))
+ * ```
+ *
+ * Custom theme — import directly from the renderer package, which the
+ * consumer already has installed as a peer-dep:
+ *
+ * ```ts
+ * import { preloadMarkdown } from '@doist/cli-core/markdown'
+ * import { lightTheme } from 'marked-terminal-renderer'
+ * await preloadMarkdown({ theme: lightTheme() })
+ * ```
+ */
+export declare function preloadMarkdown(options?: PreloadMarkdownOptions): Promise<void>;
+/**
+ * Render a markdown string to ANSI-styled terminal output.
+ *
+ * Returns the input unchanged if `preloadMarkdown` has not yet run — keeps
+ * call sites simple in code paths that may execute before init (e.g. early
+ * errors). Trailing whitespace from the renderer is trimmed so callers can
+ * `console.log` the result without a stray blank line.
+ *
+ * ```ts
+ * import { preloadMarkdown, renderMarkdown } from '@doist/cli-core/markdown'
+ *
+ * await preloadMarkdown()
+ * console.log(await renderMarkdown('# Title\n\n- one\n- two'))
+ * ```
+ */
+export declare function renderMarkdown(text: string): Promise<string>;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAEvE,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAEvE,MAAM,MAAM,sBAAsB,GAAG;IACjC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,uBAAuB,CAAA;CAClC,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlE"}

package/dist/markdown.js

@@ -0,0 +1,71 @@
+let markedInstance = null;
+/**
+ * Lazy-init a shared `marked` renderer for terminal output. Idempotent — safe
+ * to call multiple times; later calls are no-ops once initialised, so the
+ * `theme` from the first call wins.
+ *
+ * Defer the dynamic import to the call site so CLIs that never render
+ * markdown (e.g. `--json` / `--ndjson` runs) don't pay the load cost. The
+ * peer-dep packages (`marked`, `marked-terminal-renderer`) are loaded only
+ * inside this function — a missing peer surfaces here as a friendly error,
+ * never as a module-link crash on `import`.
+ *
+ * ```ts
+ * import { preloadMarkdown, renderMarkdown } from '@doist/cli-core/markdown'
+ *
+ * if (!options.json && !options.raw) {
+ *     await preloadMarkdown()
+ * }
+ * console.log(await renderMarkdown(comment.body))
+ * ```
+ *
+ * Custom theme — import directly from the renderer package, which the
+ * consumer already has installed as a peer-dep:
+ *
+ * ```ts
+ * import { preloadMarkdown } from '@doist/cli-core/markdown'
+ * import { lightTheme } from 'marked-terminal-renderer'
+ * await preloadMarkdown({ theme: lightTheme() })
+ * ```
+ */
+export async function preloadMarkdown(options) {
+    if (markedInstance)
+        return;
+    let modules;
+    try {
+        modules = await Promise.all([import('marked'), import('marked-terminal-renderer')]);
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ERR_MODULE_NOT_FOUND') {
+            throw new Error("@doist/cli-core/markdown requires 'marked' and 'marked-terminal-renderer' as peer dependencies. " +
+                'Install them with: npm install marked marked-terminal-renderer', { cause: err });
+        }
+        throw err;
+    }
+    const [{ Marked }, { createTerminalRenderer, darkTheme }] = modules;
+    const instance = new Marked();
+    instance.use(createTerminalRenderer(options?.theme ?? darkTheme()));
+    markedInstance = instance;
+}
+/**
+ * Render a markdown string to ANSI-styled terminal output.
+ *
+ * Returns the input unchanged if `preloadMarkdown` has not yet run — keeps
+ * call sites simple in code paths that may execute before init (e.g. early
+ * errors). Trailing whitespace from the renderer is trimmed so callers can
+ * `console.log` the result without a stray blank line.
+ *
+ * ```ts
+ * import { preloadMarkdown, renderMarkdown } from '@doist/cli-core/markdown'
+ *
+ * await preloadMarkdown()
+ * console.log(await renderMarkdown('# Title\n\n- one\n- two'))
+ * ```
+ */
+export async function renderMarkdown(text) {
+    if (!markedInstance)
+        return text;
+    const rendered = await markedInstance.parse(text);
+    return typeof rendered === 'string' ? rendered.trimEnd() : text;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAUA,IAAI,cAAc,GAAkB,IAAI,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgC;IAClE,IAAI,cAAc;QAAE,OAAM;IAC1B,IAAI,OAA6E,CAAA;IACjF,IAAI,CAAC;QACD,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAA;IACvF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CACX,kGAAkG;gBAC9F,gEAAgE,EACpE,EAAE,KAAK,EAAE,GAAG,EAAE,CACjB,CAAA;QACL,CAAC;QACD,MAAM,GAAG,CAAA;IACb,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO,CAAA;IACnE,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC,CAAA;IACnE,cAAc,GAAG,QAAQ,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC7C,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAA;IAChC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACjD,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACnE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/cli-core",
-    "version": "0.5.0",
+    "version": "0.6.0",
     "description": "Shared core utilities for Doist CLI projects",
     "type": "module",
     "main": "dist/index.js",
@@ -10,6 +10,14 @@
             "types": "./dist/index.d.ts",
             "import": "./dist/index.js"
         },
+        "./commands": {
+            "types": "./dist/commands/index.d.ts",
+            "import": "./dist/commands/index.js"
+        },
+        "./markdown": {
+            "types": "./dist/markdown.d.ts",
+            "import": "./dist/markdown.js"
+        },
         "./testing": {
             "types": "./dist/testing.d.ts",
             "import": "./dist/testing.js"
@@ -55,8 +63,11 @@
         "@semantic-release/exec": "7.1.0",
         "@semantic-release/git": "10.0.1",
         "@types/node": "25.6.0",
+        "commander": "14.0.3",
         "conventional-changelog-conventionalcommits": "9.3.1",
         "lefthook": "2.1.6",
+        "marked": "18.0.3",
+        "marked-terminal-renderer": "2.2.0",
         "oxfmt": "0.46.0",
         "oxlint": "1.61.0",
         "semantic-release": "25.0.3",
@@ -68,9 +79,21 @@
         "yocto-spinner": "1.1.0"
     },
     "peerDependencies": {
+        "commander": ">=14",
+        "marked": ">=18",
+        "marked-terminal-renderer": ">=2",
         "vitest": ">=4.1"
     },
     "peerDependenciesMeta": {
+        "commander": {
+            "optional": true
+        },
+        "marked": {
+            "optional": true
+        },
+        "marked-terminal-renderer": {
+            "optional": true
+        },
         "vitest": {
             "optional": true
         }