@doist/comms-cli 0.0.1 → 1.0.0

package/dist/lib/completion.js

@@ -0,0 +1,173 @@
+/**
+ * Set argChoices on an option without enabling Commander's built-in
+ * validation. The choices are surfaced for shell completions but the
+ * option still accepts any value at parse time.
+ */
+export function withUnvalidatedChoices(opt, values) {
+    opt.argChoices = values;
+    return opt;
+}
+export function withCaseInsensitiveChoices(opt, values) {
+    opt.choices(values);
+    // choices() sets parseArg internally. Assert so we catch upstream changes.
+    const original = opt.parseArg;
+    if (!original) {
+        throw new Error('Expected Commander choices() to set parseArg');
+    }
+    opt.parseArg = (arg, prev) => original(arg.toLowerCase(), prev);
+    return opt;
+}
+/**
+ * Parse COMP_LINE into words, stripping the binary name and the
+ * 'completion-server' token that tabtab injects.
+ *
+ * FIXME: This splits on whitespace and does not handle quoted arguments.
+ * This is acceptable for command/flag traversal. It can be improved once
+ * tabtab exposes shell-provided tokenized words.
+ */
+export function parseCompLine(compLine) {
+    const words = compLine.split(/\s+/).slice(1); // remove binary name (tdc)
+    if (words[0] === 'completion-server')
+        words.shift();
+    return words;
+}
+/** Names to exclude from completion results (internal commands) */
+const HIDDEN_COMMAND_NAMES = new Set(['completion-server']);
+/**
+ * Check if a Commander Option expects a value argument (not a boolean flag).
+ */
+function optionExpectsValue(opt) {
+    // required means <value>, optional means [value] — both expect a value
+    return opt.required || opt.optional;
+}
+/**
+ * Find an option by its long or short flag in a command.
+ */
+function findOption(cmd, flag) {
+    return cmd.options.find((o) => o.long === flag || o.short === flag);
+}
+/**
+ * Get completions for the current command line context.
+ *
+ * @param program - The root Commander program with all commands registered
+ * @param words - The words on the command line (excluding the binary name)
+ * @param current - The current word being typed (may be empty string)
+ * @returns Array of completion items
+ */
+export function getCompletions(program, words, current) {
+    let activeCmd = program;
+    let seenDoubleDash = false;
+    const usedOptions = new Set();
+    // Walk the words to find the active command context
+    let i = 0;
+    while (i < words.length) {
+        const word = words[i];
+        // If we hit the current word (last position), stop walking
+        if (i === words.length - 1 && word === current) {
+            break;
+        }
+        if (word === '--') {
+            seenDoubleDash = true;
+            i++;
+            continue;
+        }
+        if (!seenDoubleDash && word.startsWith('-')) {
+            // Handle --flag=value syntax
+            const eqIdx = word.indexOf('=');
+            const flag = eqIdx > 0 ? word.slice(0, eqIdx) : word;
+            usedOptions.add(flag);
+            // If this option expects a value and no = was used, consume the next word
+            if (eqIdx < 0) {
+                const opt = findOption(activeCmd, flag);
+                if (opt && optionExpectsValue(opt)) {
+                    i++; // skip the value word
+                }
+            }
+            i++;
+            continue;
+        }
+        // Try to descend into a subcommand
+        const sub = activeCmd.commands.find((c) => c.name() === word || c.aliases().includes(word));
+        if (sub) {
+            activeCmd = sub;
+            usedOptions.clear();
+        }
+        i++;
+    }
+    // Check if previous word was an option expecting a value
+    if (words.length >= 2) {
+        const prevWord = words[words.length - 2];
+        if (prevWord?.startsWith('-') && prevWord !== '--') {
+            const eqIdx = prevWord.indexOf('=');
+            const flag = eqIdx > 0 ? prevWord.slice(0, eqIdx) : prevWord;
+            const opt = findOption(activeCmd, flag);
+            if (opt && optionExpectsValue(opt) && eqIdx < 0) {
+                const enumValues = opt.argChoices;
+                if (enumValues) {
+                    return enumValues.filter((v) => v.startsWith(current)).map((v) => ({ name: v }));
+                }
+                return [];
+            }
+        }
+    }
+    // Handle --flag=<TAB> — suggest values after =
+    if (current.includes('=')) {
+        const eqIdx = current.indexOf('=');
+        const flag = current.slice(0, eqIdx);
+        const partial = current.slice(eqIdx + 1);
+        const opt = findOption(activeCmd, flag);
+        if (opt) {
+            const enumValues = opt.argChoices;
+            if (enumValues) {
+                return enumValues
+                    .filter((v) => v.startsWith(partial))
+                    .map((v) => ({ name: `${flag}=${v}` }));
+            }
+        }
+        return [];
+    }
+    // After --, everything is positional — no more commands or options
+    if (seenDoubleDash) {
+        return [];
+    }
+    // If current word starts with -, suggest options
+    if (current.startsWith('-')) {
+        return getOptionCompletions(activeCmd, current, usedOptions);
+    }
+    // Suggest subcommands, and if there are none, suggest options instead
+    const subcommands = getSubcommandCompletions(activeCmd, current);
+    if (subcommands.length > 0) {
+        return subcommands;
+    }
+    return getOptionCompletions(activeCmd, current, usedOptions);
+}
+function getSubcommandCompletions(cmd, prefix) {
+    return cmd.commands
+        .filter((c) => !c._hidden &&
+        !HIDDEN_COMMAND_NAMES.has(c.name()))
+        .filter((c) => c.name().startsWith(prefix))
+        .map((c) => ({
+        name: c.name(),
+        description: c.description(),
+    }));
+}
+function getOptionCompletions(cmd, prefix, usedOptions) {
+    return cmd.options
+        .filter((o) => {
+        if (!o.long)
+            return false;
+        if (o.hidden)
+            return false;
+        // Exclude already-used options
+        if (usedOptions.has(o.long))
+            return false;
+        if (o.short && usedOptions.has(o.short))
+            return false;
+        return o.long.startsWith(prefix);
+    })
+        .map((o) => ({
+        name: o.long,
+        description: o.description,
+    }));
+}
+//# sourceMappingURL=completion.js.map

package/dist/lib/completion.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Resolve the canonical config path lazily. Computing on each call (instead of
+ * caching at module load) keeps the path responsive to vitest's `vi.doMock`
+ * for `node:os` — which only reliably reaches cli-core's compiled `homedir()`
+ * call after the mock has been set up by the test, not at import time.
+ */
+export declare function getConfigPath(): string;
+export type AuthMode = 'read-only' | 'read-write' | 'unknown';
+export type UpdateChannel = 'stable' | 'pre-release';
+export declare const UPDATE_CHANNELS: ReadonlySet<UpdateChannel>;
+export interface UserSettings {
+    unarchiveNewThreads?: boolean;
+}
+/**
+ * One row of the `users[]` array. `id` is the stringified numeric Comms user
+ * id. `token` is a plaintext fallback persisted only when the keyring is
+ * unavailable at write time.
+ */
+export type StoredUser = {
+    id: string;
+    name: string;
+    authMode?: AuthMode;
+    authScope?: string;
+    token?: string;
+};
+export interface Config {
+    users?: StoredUser[];
+    defaultUserId?: string;
+    currentWorkspace?: number;
+    updateChannel?: UpdateChannel;
+    userSettings?: UserSettings;
+}
+/**
+ * Thin wrapper around cli-core's lenient `readConfig`. Returns `{}` when the
+ * file is missing, unreadable, or invalid — runtime code paths treat "no
+ * config" and "empty config" the same. Use `readConfigStrict` for inspection
+ * commands that need to distinguish failure modes.
+ */
+export declare function getConfig(): Promise<Config>;
+export type StrictReadResult = {
+    state: 'missing';
+} | {
+    state: 'present';
+    config: Config;
+};
+/**
+ * Read and parse the config file strictly — for inspection commands that need
+ * to distinguish "missing" from "present but broken". `getConfig` deliberately
+ * swallows errors for runtime code paths; this one surfaces them.
+ */
+export declare function readConfigStrict(): Promise<StrictReadResult>;
+/** Thin wrapper around cli-core's `writeConfig`. */
+export declare function setConfig(config: Config): Promise<void>;
+/**
+ * Atomic partial-write wrapper around cli-core's `updateConfig`. Preserves
+ * cli-core's read-merge-write atomicity so two concurrent `tdc` processes
+ * can't lose each other's updates.
+ */
+export declare function updateConfig(updates: Partial<Config>): Promise<void>;
+export declare function validateConfigForDoctor(config: Record<string, unknown>): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAA;AAC7D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,aAAa,CAAA;AAuBpD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,aAAa,CAAsC,CAAA;AAE7F,MAAM,WAAW,YAAY;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,WAAW,MAAM;IACnB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAA;CAC9B;AAyBD;;;;;GAKG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAGjD;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1F;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAkClE;AAED,oDAAoD;AACpD,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAiGjF"}

package/dist/lib/config.js

@@ -0,0 +1,184 @@
+import { getConfigPath as getConfigPathCore, readConfig as readConfigCore, readConfigStrict as readConfigStrictCore, updateConfig as updateConfigCore, writeConfig as writeConfigCore, } from '@doist/cli-core';
+import { CliError } from './errors.js';
+const APP_NAME = 'comms-cli';
+/**
+ * Resolve the canonical config path lazily. Computing on each call (instead of
+ * caching at module load) keeps the path responsive to vitest's `vi.doMock`
+ * for `node:os` — which only reliably reaches cli-core's compiled `homedir()`
+ * call after the mock has been set up by the test, not at import time.
+ */
+export function getConfigPath() {
+    return getConfigPathCore(APP_NAME);
+}
+const KNOWN_CONFIG_KEYS = new Set([
+    'currentWorkspace',
+    // cli-core's update command writes the channel under `update_channel`;
+    // the in-memory `Config` exposes it as `updateChannel`.
+    'update_channel',
+    'userSettings',
+    'users',
+    'defaultUserId',
+]);
+const KNOWN_STORED_USER_KEYS = new Set([
+    'id',
+    'name',
+    'authMode',
+    'authScope',
+    'token',
+]);
+const KNOWN_USER_SETTINGS_KEYS = new Set(['unarchiveNewThreads']);
+const AUTH_MODES = new Set(['read-only', 'read-write', 'unknown']);
+export const UPDATE_CHANNELS = new Set(['stable', 'pre-release']);
+/**
+ * Read-seam translation: cli-core's update command writes the channel under
+ * `update_channel` (snake_case); we expose it as `updateChannel` (camelCase)
+ * to keep the in-memory shape idiomatic TS. Non-object inputs are returned
+ * untouched so the downstream cast doesn't blow up.
+ */
+function fromDiskShape(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {};
+    }
+    const record = raw;
+    if (!('update_channel' in record))
+        return record;
+    const { update_channel, ...rest } = record;
+    return update_channel === undefined ? rest : { ...rest, updateChannel: update_channel };
+}
+/** Write-seam translation: camelCase `updateChannel` → snake_case `update_channel` on disk. */
+function toDiskShape(config) {
+    const { updateChannel, ...rest } = config;
+    if (updateChannel === undefined)
+        return rest;
+    return { ...rest, update_channel: updateChannel };
+}
+/**
+ * Thin wrapper around cli-core's lenient `readConfig`. Returns `{}` when the
+ * file is missing, unreadable, or invalid — runtime code paths treat "no
+ * config" and "empty config" the same. Use `readConfigStrict` for inspection
+ * commands that need to distinguish failure modes.
+ */
+export async function getConfig() {
+    const raw = await readConfigCore(getConfigPath());
+    return fromDiskShape(raw);
+}
+/**
+ * Read and parse the config file strictly — for inspection commands that need
+ * to distinguish "missing" from "present but broken". `getConfig` deliberately
+ * swallows errors for runtime code paths; this one surfaces them.
+ */
+export async function readConfigStrict() {
+    const path = getConfigPath();
+    const result = await readConfigStrictCore(path);
+    switch (result.state) {
+        case 'missing':
+            return { state: 'missing' };
+        case 'present':
+            return {
+                state: 'present',
+                config: fromDiskShape(result.config),
+            };
+        case 'read-failed':
+            throw new CliError('CONFIG_READ_FAILED', `Could not read config file ${path}: ${result.error.message}`, ['Check file permissions, or run `tdc doctor` to diagnose']);
+        case 'invalid-json':
+            throw new CliError('CONFIG_INVALID_JSON', `Config file at ${path} is not valid JSON: ${result.error.message}`, [
+                'Fix the JSON by hand, or delete the file and re-authenticate with `tdc auth login`',
+            ]);
+        case 'invalid-shape':
+            throw new CliError('CONFIG_INVALID_SHAPE', `Config file at ${path} must contain a JSON object (got ${result.actual})`, [
+                'Fix the JSON by hand, or delete the file and re-authenticate with `tdc auth login`',
+            ]);
+    }
+}
+/** Thin wrapper around cli-core's `writeConfig`. */
+export async function setConfig(config) {
+    await writeConfigCore(getConfigPath(), toDiskShape(config));
+}
+/**
+ * Atomic partial-write wrapper around cli-core's `updateConfig`. Preserves
+ * cli-core's read-merge-write atomicity so two concurrent `tdc` processes
+ * can't lose each other's updates.
+ */
+export async function updateConfig(updates) {
+    await updateConfigCore(getConfigPath(), toDiskShape(updates));
+}
+export function validateConfigForDoctor(config) {
+    const issues = [];
+    for (const key of Object.keys(config)) {
+        if (!KNOWN_CONFIG_KEYS.has(key)) {
+            issues.push(`contains unrecognized key "${key}"`);
+        }
+    }
+    if (config.currentWorkspace !== undefined &&
+        (!Number.isInteger(config.currentWorkspace) || Number(config.currentWorkspace) <= 0)) {
+        issues.push('currentWorkspace must be a positive integer');
+    }
+    if (config.update_channel !== undefined &&
+        (typeof config.update_channel !== 'string' ||
+            !UPDATE_CHANNELS.has(config.update_channel))) {
+        issues.push('update_channel must be one of: stable, pre-release');
+    }
+    if (config.defaultUserId !== undefined && typeof config.defaultUserId !== 'string') {
+        issues.push('defaultUserId must be a string');
+    }
+    if (config.users !== undefined) {
+        if (!Array.isArray(config.users)) {
+            issues.push('users must be an array');
+        }
+        else {
+            for (let i = 0; i < config.users.length; i++) {
+                const user = config.users[i];
+                if (user === null || typeof user !== 'object' || Array.isArray(user)) {
+                    issues.push(`users[${i}] must be an object`);
+                    continue;
+                }
+                const userRecord = user;
+                for (const key of Object.keys(userRecord)) {
+                    if (!KNOWN_STORED_USER_KEYS.has(key)) {
+                        issues.push(`users[${i}] contains unrecognized key "${key}"`);
+                    }
+                }
+                if (typeof userRecord.id !== 'string') {
+                    issues.push(`users[${i}].id must be a string`);
+                }
+                if (typeof userRecord.name !== 'string') {
+                    issues.push(`users[${i}].name must be a string`);
+                }
+                if (userRecord.authMode !== undefined &&
+                    (typeof userRecord.authMode !== 'string' ||
+                        !AUTH_MODES.has(userRecord.authMode))) {
+                    issues.push(`users[${i}].authMode must be one of: read-only, read-write, unknown`);
+                }
+                if (userRecord.authScope !== undefined &&
+                    typeof userRecord.authScope !== 'string') {
+                    issues.push(`users[${i}].authScope must be a string`);
+                }
+                if (userRecord.token !== undefined && typeof userRecord.token !== 'string') {
+                    issues.push(`users[${i}].token must be a string`);
+                }
+            }
+        }
+    }
+    if (config.userSettings !== undefined) {
+        const userSettings = config.userSettings;
+        if (userSettings === null ||
+            typeof userSettings !== 'object' ||
+            Array.isArray(userSettings)) {
+            issues.push('userSettings must be an object');
+        }
+        else {
+            const settingsRecord = userSettings;
+            for (const key of Object.keys(settingsRecord)) {
+                if (!KNOWN_USER_SETTINGS_KEYS.has(key)) {
+                    issues.push(`userSettings contains unrecognized key "${key}"`);
+                }
+            }
+            if (settingsRecord.unarchiveNewThreads !== undefined &&
+                typeof settingsRecord.unarchiveNewThreads !== 'boolean') {
+                issues.push('userSettings.unarchiveNewThreads must be a boolean');
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/dates.d.ts

@@ -0,0 +1,3 @@
+export declare function formatRelativeDate(date: Date | string): string;
+export declare function parseDate(dateStr: string): Date | null;
+//# sourceMappingURL=dates.d.ts.map

package/dist/lib/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/lib/dates.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAiC9D;AAaD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAGtD"}

package/dist/lib/dates.js

@@ -0,0 +1,44 @@
+const SECOND = 1000;
+const MINUTE = 60 * SECOND;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+export function formatRelativeDate(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    const now = new Date();
+    const diff = now.getTime() - d.getTime();
+    if (diff < 0) {
+        return formatAbsoluteDate(d);
+    }
+    if (diff < MINUTE) {
+        return 'just now';
+    }
+    if (diff < HOUR) {
+        const mins = Math.floor(diff / MINUTE);
+        return `${mins} minute${mins === 1 ? '' : 's'} ago`;
+    }
+    if (diff < DAY) {
+        const hours = Math.floor(diff / HOUR);
+        return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+    }
+    if (diff < 2 * DAY) {
+        return 'yesterday';
+    }
+    if (diff < 7 * DAY) {
+        const days = Math.floor(diff / DAY);
+        return `${days} days ago`;
+    }
+    return formatAbsoluteDate(d);
+}
+function formatAbsoluteDate(date) {
+    const now = new Date();
+    const sameYear = date.getFullYear() === now.getFullYear();
+    if (sameYear) {
+        return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+    }
+    return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' });
+}
+export function parseDate(dateStr) {
+    const d = new Date(dateStr);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+//# sourceMappingURL=dates.js.map

package/dist/lib/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/lib/dates.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,IAAI,CAAA;AACnB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAA;AAC1B,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,CAAA;AACxB,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAA;AAErB,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IAClD,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;IAExC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACX,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC;IAED,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;QAChB,OAAO,UAAU,CAAA;IACrB,CAAC;IAED,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;QACtC,OAAO,GAAG,IAAI,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;IACvD,CAAC;IAED,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;QACrC,OAAO,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;IACvD,CAAC;IAED,IAAI,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACjB,OAAO,WAAW,CAAA;IACtB,CAAC;IAED,IAAI,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;QACnC,OAAO,GAAG,IAAI,WAAW,CAAA;IAC7B,CAAC;IAED,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAU;IAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAA;IAEzD,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;AAChG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACrC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/C,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,28 @@
+import { CliError as BaseCliError, type CliErrorCode, type ErrorType } from '@doist/cli-core';
+export { BaseCliError };
+export type { ErrorType } from '@doist/cli-core';
+/**
+ * Known error codes used across the CLI.
+ * This union provides intellisense suggestions while still accepting any string,
+ * allowing dynamic codes and future additions.
+ */
+export type ErrorCode = 'AUTH_FAILED' | 'INSUFFICIENT_SCOPE' | 'INVALID_TOKEN' | 'NO_TOKEN' | 'READ_ONLY' | 'CONFLICTING_OPTIONS' | 'INVALID_CURSOR' | 'INVALID_DATE' | 'INVALID_ID' | 'INVALID_MINUTES' | 'INVALID_REF' | 'INVALID_SCOPE' | 'INVALID_STATE' | 'INVALID_TYPE' | 'INVALID_URL' | 'INVALID_VALUE' | 'MISSING_CONTENT' | 'MISSING_YES_FLAG' | 'UNKNOWN_KEY' | 'INVALID_NAME' | 'MISSING_USERS' | 'ACCOUNT_NOT_FOUND' | 'CHANNEL_NOT_FOUND' | 'GROUP_NOT_FOUND' | 'NOT_FOUND' | 'USER_NOT_FOUND' | 'WORKSPACE_NOT_FOUND' | 'AMBIGUOUS_CHANNEL' | 'AMBIGUOUS_GROUP' | 'AMBIGUOUS_USER' | 'AMBIGUOUS_WORKSPACE' | 'ALREADY_INSTALLED' | 'BATCH_FAILED' | 'FILE_READ_ERROR' | 'NOT_CREATOR' | 'NOT_INSTALLED' | 'UNKNOWN_AGENT' | 'API_ERROR' | 'INTERNAL_ERROR' | 'CONFIG_READ_FAILED' | 'CONFIG_INVALID_JSON' | 'CONFIG_INVALID_SHAPE' | (string & {});
+/**
+ * Check whether an error is a Comms API 403 "Insufficient scope" response.
+ * Works with any error shaped like CommsRequestError (httpStatusCode + responseData).
+ */
+export declare function isInsufficientScope(error: unknown): boolean;
+/**
+ * Comms-flavoured CliError that preserves the historical positional
+ * `(code, message, hints?, type?)` signature used across hundreds of call
+ * sites. Internally it forwards to the cli-core options-object form.
+ *
+ * `code` accepts the local Comms `ErrorCode` union plus any cli-core
+ * canonical code (`CliErrorCode`), so call sites like
+ * `new CliError('CONFIG_READ_FAILED', …)` still type-check without
+ * `CONFIG_*` having to live in the local union.
+ */
+export declare class CliError extends BaseCliError<ErrorCode> {
+    constructor(code: ErrorCode | CliErrorCode, message: string, hints?: string[], type?: ErrorType);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE7F,OAAO,EAAE,YAAY,EAAE,CAAA;AACvB,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAEf,aAAa,GACb,oBAAoB,GACpB,eAAe,GACf,UAAU,GACV,WAAW,GAEX,qBAAqB,GACrB,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,eAAe,GACf,cAAc,GACd,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,eAAe,GAEf,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,WAAW,GACX,gBAAgB,GAChB,qBAAqB,GAErB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GAErB,mBAAmB,GACnB,cAAc,GACd,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,eAAe,GAEf,WAAW,GACX,gBAAgB,GAEhB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,GAEtB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkB3D;AAED;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,YAAY,CAAC,SAAS,CAAC;gBAE7C,IAAI,EAAE,SAAS,GAAG,YAAY,EAC9B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,IAAI,GAAE,SAAmB;CAIhC"}

package/dist/lib/errors.js

@@ -0,0 +1,34 @@
+import { CliError as BaseCliError } from '@doist/cli-core';
+export { BaseCliError };
+/**
+ * Check whether an error is a Comms API 403 "Insufficient scope" response.
+ * Works with any error shaped like CommsRequestError (httpStatusCode + responseData).
+ */
+export function isInsufficientScope(error) {
+    if (typeof error !== 'object' ||
+        error === null ||
+        !('httpStatusCode' in error) ||
+        !('responseData' in error)) {
+        return false;
+    }
+    const { httpStatusCode, responseData } = error;
+    return (httpStatusCode === 403 &&
+        typeof responseData?.error_string === 'string' &&
+        responseData.error_string.includes('Insufficient scope'));
+}
+/**
+ * Comms-flavoured CliError that preserves the historical positional
+ * `(code, message, hints?, type?)` signature used across hundreds of call
+ * sites. Internally it forwards to the cli-core options-object form.
+ *
+ * `code` accepts the local Comms `ErrorCode` union plus any cli-core
+ * canonical code (`CliErrorCode`), so call sites like
+ * `new CliError('CONFIG_READ_FAILED', …)` still type-check without
+ * `CONFIG_*` having to live in the local union.
+ */
+export class CliError extends BaseCliError {
+    constructor(code, message, hints, type = 'error') {
+        super(code, message, { hints, type });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAqC,MAAM,iBAAiB,CAAA;AAE7F,OAAO,EAAE,YAAY,EAAE,CAAA;AA6DvB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAC9C,IACI,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,gBAAgB,IAAI,KAAK,CAAC;QAC5B,CAAC,CAAC,cAAc,IAAI,KAAK,CAAC,EAC5B,CAAC;QACC,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,KAGxC,CAAA;IACD,OAAO,CACH,cAAc,KAAK,GAAG;QACtB,OAAO,YAAY,EAAE,YAAY,KAAK,QAAQ;QAC9C,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAC3D,CAAA;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAuB;IACjD,YACI,IAA8B,EAC9B,OAAe,EACf,KAAgB,EAChB,OAAkB,OAAO;QAEzB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,CAAC;CACJ"}

package/dist/lib/global-args.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Per-CLI extension of `@doist/cli-core`'s global-args parser.
+ *
+ * Layers comms's `--include-private-channels`, `--non-interactive`,
+ * `--interactive`, and the `--progress-jsonl <path>` space form on top of
+ * the subset of cli-core's canonical shape that comms actually registers
+ * with Commander (`--json`, `--ndjson`, `--accessible`, `--no-spinner`,
+ * `--progress-jsonl[=path]`).
+ *
+ * cli-core's parser also surfaces `quiet` and `verbose` from argv, but
+ * comms does not register `--quiet` or `--verbose` globally (Commander
+ * would reject them) — so we drop them from the exported shape to avoid
+ * the type/API leak where helpers believe the binary supports them.
+ */
+import { type GlobalArgs as CoreGlobalArgs } from '@doist/cli-core';
+type CommsSpecificFlags = {
+    /** Bare/string/false — see `CommsLocalFlags.progressJsonl` for semantics. */
+    progressJsonl: string | true | false;
+    /** Resolved path for `--progress-jsonl` (any form). `undefined` when bare or absent. */
+    progressJsonlPath: string | undefined;
+    includePrivateChannels: boolean;
+    nonInteractive: boolean;
+    interactive: boolean;
+};
+/**
+ * Public shape exposed to comms callers. Drops cli-core's `quiet` and
+ * `verbose` because comms does not register `--quiet` / `--verbose` with
+ * Commander — exposing them in the type would lie about what the binary
+ * supports.
+ */
+export type GlobalArgs = Pick<CoreGlobalArgs, 'json' | 'ndjson' | 'accessible' | 'noSpinner' | 'user'> & CommsSpecificFlags;
+/**
+ * Parse well-known global flags from an argv array. Pure — pass an explicit
+ * array for testing, or omit to read `process.argv`. Returns the narrowed
+ * comms surface; cli-core's `quiet` and `verbose` are intentionally
+ * dropped (see {@link GlobalArgs}).
+ */
+export declare function parseGlobalArgs(argv?: string[]): GlobalArgs;
+/** Clear the cached parse result. Call in test teardown. */
+export declare const resetGlobalArgs: () => void;
+export declare function isJsonMode(): boolean;
+export declare function isNdjsonMode(): boolean;
+/** Pre-subcommand `tdc --user <ref>` (see `stripUserFlag` in `src/index.ts`). */
+export declare function getRequestedUserRef(): string | undefined;
+export declare function isNonInteractive(): boolean;
+export declare function includePrivateChannels(): boolean;
+export declare function isProgressJsonlEnabled(): boolean;
+export declare function getProgressJsonlPath(): string | undefined;
+export declare const isAccessible: () => boolean;
+export declare const shouldDisableSpinner: () => boolean;
+export {};
+//# sourceMappingURL=global-args.d.ts.map

package/dist/lib/global-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-args.d.ts","sourceRoot":"","sources":["../../src/lib/global-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIH,KAAK,UAAU,IAAI,cAAc,EAEpC,MAAM,iBAAiB,CAAA;AAExB,KAAK,kBAAkB,GAAG;IACtB,6EAA6E;IAC7E,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;IACpC,wFAAwF;IACxF,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;CACvB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CACzB,cAAc,EACd,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAC1D,GACG,kBAAkB,CAAA;AA+EtB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAG3D;AAID,4DAA4D;AAC5D,eAAO,MAAM,eAAe,YAAc,CAAA;AAM1C,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAMhD;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAEzD;AAED,eAAO,MAAM,YAAY,eAGvB,CAAA;AAEF,eAAO,MAAM,oBAAoB,eAI/B,CAAA"}