@doist/comms-cli 0.0.1 → 1.0.0

package/dist/commands/doctor.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+interface DoctorOptions {
+    json?: boolean;
+    offline?: boolean;
+}
+export declare function doctorAction(options: DoctorOptions): Promise<void>;
+export declare function registerDoctorCommand(program: Command): void;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgBxC,UAAU,aAAa;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB;AAgWD,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO5D"}

package/dist/commands/doctor.js

@@ -0,0 +1,325 @@
+import { readFile } from 'node:fs/promises';
+import chalk from 'chalk';
+import pkg from '../../package.json' with { type: 'json' };
+import { createWrappedCommsClient } from '../lib/api.js';
+import { NoTokenError, TOKEN_ENV_VAR, probeApiToken } from '../lib/auth.js';
+import { getConfigPath, validateConfigForDoctor } from '../lib/config.js';
+import { formatJson } from '../lib/output.js';
+import { compareVersions, fetchLatestVersion, getConfiguredUpdateChannel, isNewer, parseVersion, } from '../lib/update.js';
+function summarize(checks) {
+    return checks.reduce((summary, check) => {
+        if (check.status === 'pass')
+            summary.passed += 1;
+        if (check.status === 'warn')
+            summary.warned += 1;
+        if (check.status === 'fail')
+            summary.failed += 1;
+        if (check.status === 'skip')
+            summary.skipped += 1;
+        return summary;
+    }, { passed: 0, warned: 0, failed: 0, skipped: 0 });
+}
+function buildSummaryLine(summary) {
+    const parts = [`${summary.passed} passed`];
+    if (summary.warned > 0)
+        parts.push(`${summary.warned} warning${summary.warned === 1 ? '' : 's'}`);
+    if (summary.failed > 0)
+        parts.push(`${summary.failed} failed`);
+    if (summary.skipped > 0)
+        parts.push(`${summary.skipped} skipped`);
+    return parts.join(', ');
+}
+function formatStatus(status) {
+    switch (status) {
+        case 'pass':
+            return chalk.green('PASS');
+        case 'warn':
+            return chalk.yellow('WARN');
+        case 'fail':
+            return chalk.red('FAIL');
+        case 'skip':
+            return chalk.gray('SKIP');
+        default:
+            return status;
+    }
+}
+function nextCaretUpperBound(version) {
+    const parsed = parseVersion(version);
+    if (parsed.major > 0) {
+        return `${parsed.major + 1}.0.0`;
+    }
+    if (parsed.minor > 0) {
+        return `0.${parsed.minor + 1}.0`;
+    }
+    return `0.0.${parsed.patch + 1}`;
+}
+function satisfiesComparator(currentVersion, comparator) {
+    const trimmed = comparator.trim();
+    if (!trimmed)
+        return true;
+    if (trimmed.startsWith('>=')) {
+        return compareVersions(currentVersion, trimmed.slice(2).trim()) >= 0;
+    }
+    if (trimmed.startsWith('^')) {
+        const baseVersion = trimmed.slice(1).trim();
+        return (compareVersions(currentVersion, baseVersion) >= 0 &&
+            compareVersions(currentVersion, nextCaretUpperBound(baseVersion)) < 0);
+    }
+    if (/^v?\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(trimmed)) {
+        return compareVersions(currentVersion, trimmed) === 0;
+    }
+    return null;
+}
+function satisfiesVersionRange(currentVersion, range) {
+    const clauses = range
+        .split('||')
+        .map((clause) => clause.trim())
+        .filter(Boolean);
+    let sawUnsupportedSyntax = false;
+    for (const clause of clauses) {
+        let clauseMatches = true;
+        for (const comparator of clause.split(/\s+/).filter(Boolean)) {
+            const result = satisfiesComparator(currentVersion, comparator);
+            if (result === null) {
+                sawUnsupportedSyntax = true;
+                clauseMatches = false;
+                break;
+            }
+            if (!result) {
+                clauseMatches = false;
+                break;
+            }
+        }
+        if (clauseMatches) {
+            return true;
+        }
+    }
+    return sawUnsupportedSyntax ? null : false;
+}
+function isNoTokenError(error) {
+    return (error instanceof NoTokenError ||
+        (error instanceof Error && error.message.includes('No API token found')));
+}
+function describeAuthSource(source) {
+    switch (source) {
+        case 'env':
+            return 'environment variable';
+        case 'config-file':
+            return 'plaintext config fallback';
+        case 'secure-store':
+            return 'secure-store';
+        default:
+            return source;
+    }
+}
+function checkNodeVersion() {
+    const requiredVersion = pkg.engines?.node;
+    if (typeof requiredVersion !== 'string' || !requiredVersion.trim()) {
+        return {
+            name: 'node',
+            status: 'warn',
+            message: 'Could not verify Node.js version because package.json has no engines.node range',
+            details: { currentVersion: process.version },
+        };
+    }
+    const currentVersion = process.version;
+    const isSupported = satisfiesVersionRange(currentVersion, requiredVersion);
+    if (isSupported === true) {
+        return null;
+    }
+    if (isSupported === null) {
+        return {
+            name: 'node',
+            status: 'warn',
+            message: `Could not verify Node.js version against unsupported engine range "${requiredVersion}"`,
+            details: { currentVersion, requiredVersion },
+        };
+    }
+    return {
+        name: 'node',
+        status: 'fail',
+        message: `Node.js ${currentVersion} does not satisfy ${requiredVersion}`,
+        details: { currentVersion, requiredVersion },
+    };
+}
+async function checkConfigFile() {
+    const configPath = getConfigPath();
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return {
+                name: 'config',
+                status: 'fail',
+                message: `Config file must contain a JSON object (${configPath})`,
+                details: { path: configPath },
+            };
+        }
+        const issues = validateConfigForDoctor(parsed);
+        return {
+            name: 'config',
+            status: issues.length > 0 ? 'warn' : 'pass',
+            message: issues.length > 0
+                ? `Config file is readable but ${issues.join('; ')} (${configPath})`
+                : `Config file is readable (${configPath})`,
+            details: { path: configPath, exists: true, issues },
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return null;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name: 'config',
+            status: 'fail',
+            message: `Could not read config file ${configPath}: ${message}`,
+            details: { path: configPath },
+        };
+    }
+}
+async function checkAuthentication(offline) {
+    let token;
+    let metadata;
+    try {
+        const probe = await probeApiToken();
+        token = probe.token;
+        metadata = probe.metadata;
+    }
+    catch (error) {
+        if (isNoTokenError(error)) {
+            return {
+                name: 'auth',
+                status: 'warn',
+                message: `No Comms credentials found. Set ${TOKEN_ENV_VAR} or run \`tdc auth login\``,
+            };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name: 'auth',
+            status: 'fail',
+            message: `Could not load saved credentials: ${message}`,
+        };
+    }
+    const details = {
+        source: metadata.source,
+        authMode: metadata.authMode,
+    };
+    if (metadata.authScope)
+        details.authScope = metadata.authScope;
+    if (offline) {
+        return {
+            name: 'auth',
+            status: metadata.source === 'config-file' ? 'warn' : 'skip',
+            message: metadata.source === 'config-file'
+                ? 'Token found in plaintext config fallback; skipped API validation (--offline)'
+                : `Auth validation skipped (--offline); credentials found via ${describeAuthSource(metadata.source)}`,
+            details,
+        };
+    }
+    try {
+        const api = createWrappedCommsClient(token);
+        const user = await api.users.getSessionUser();
+        details.email = user.email;
+        details.name = user.fullName;
+        return {
+            name: 'auth',
+            status: metadata.source === 'config-file' ? 'warn' : 'pass',
+            message: metadata.source === 'config-file'
+                ? `Authenticated as ${user.email}, but token is stored in plaintext config fallback`
+                : `Authenticated as ${user.email} via ${describeAuthSource(metadata.source)}`,
+            details,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name: 'auth',
+            status: 'fail',
+            message: `Stored credentials failed validation: ${message}`,
+            details,
+        };
+    }
+}
+async function checkForUpdates(offline) {
+    const currentVersion = pkg.version;
+    const channel = await getConfiguredUpdateChannel();
+    if (offline) {
+        return {
+            name: 'update',
+            status: 'skip',
+            message: `Skipped npm registry check (--offline); current version is v${currentVersion}`,
+            details: { currentVersion, channel },
+        };
+    }
+    try {
+        const latestVersion = await fetchLatestVersion(channel);
+        if (isNewer(currentVersion, latestVersion)) {
+            return {
+                name: 'update',
+                status: 'warn',
+                message: `Update available on ${channel}: v${currentVersion} -> v${latestVersion}`,
+                details: { currentVersion, latestVersion, channel },
+            };
+        }
+        if (currentVersion === latestVersion) {
+            return {
+                name: 'update',
+                status: 'pass',
+                message: `CLI is up to date on ${channel} (v${currentVersion})`,
+                details: { currentVersion, latestVersion, channel },
+            };
+        }
+        return {
+            name: 'update',
+            status: 'pass',
+            message: `CLI version v${currentVersion} is ahead of ${channel} tag v${latestVersion}`,
+            details: { currentVersion, latestVersion, channel },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name: 'update',
+            status: 'warn',
+            message: `Could not check npm registry for updates: ${message}`,
+            details: { currentVersion, channel },
+        };
+    }
+}
+async function runDoctorChecks(options) {
+    const checks = await Promise.all([
+        checkNodeVersion(),
+        checkConfigFile(),
+        checkAuthentication(Boolean(options.offline)),
+        checkForUpdates(Boolean(options.offline)),
+    ]);
+    return checks.filter((check) => check !== null);
+}
+export async function doctorAction(options) {
+    const checks = await runDoctorChecks(options);
+    const summary = summarize(checks);
+    const ok = summary.failed === 0;
+    if (options.json) {
+        console.log(formatJson({ ok, summary, checks }));
+    }
+    else {
+        for (const check of checks) {
+            console.log(`${formatStatus(check.status)} ${check.message}`);
+        }
+        const label = ok ? chalk.green('Doctor summary:') : chalk.red('Doctor summary:');
+        console.log(`${label} ${buildSummaryLine(summary)}`);
+    }
+    if (!ok) {
+        process.exitCode = 1;
+    }
+}
+export function registerDoctorCommand(program) {
+    program
+        .command('doctor')
+        .description('Diagnose common CLI setup and environment issues')
+        .option('--json', 'Output diagnostic results as JSON')
+        .option('--offline', 'Skip network checks against Comms and npm')
+        .action(doctorAction);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

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

@@ -0,0 +1,8 @@
+import type { MutationOptions } from '../../lib/options.js';
+type CreateGroupOptions = MutationOptions & {
+    workspace?: string;
+    users?: string;
+};
+export declare function createGroupCommand(name: string, options: CreateGroupOptions): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAK3D,KAAK,kBAAkB,GAAG,eAAe,GAAG;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BjG"}

package/dist/commands/groups/create.js

@@ -0,0 +1,27 @@
+import { createGroup, getCurrentWorkspaceId } from '../../lib/api.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveUserRefs, resolveWorkspaceRef } from '../../lib/refs.js';
+import { validateNonEmptyName } from '../../lib/validation.js';
+export async function createGroupCommand(name, options) {
+    validateNonEmptyName(name, 'Group');
+    const workspaceId = options.workspace
+        ? (await resolveWorkspaceRef(options.workspace)).id
+        : await getCurrentWorkspaceId();
+    const userIds = options.users ? await resolveUserRefs(options.users, workspaceId) : undefined;
+    if (options.dryRun) {
+        printDryRun('create group', {
+            Workspace: String(workspaceId),
+            Name: name,
+            Users: userIds && userIds.length > 0 ? userIds.join(', ') : undefined,
+        });
+        return;
+    }
+    const group = await createGroup({ workspaceId, name, userIds });
+    if (options.json) {
+        console.log(formatJson(group, 'group', options.full));
+        return;
+    }
+    const memberSuffix = userIds && userIds.length > 0 ? ` with ${userIds.length} member(s)` : '';
+    console.log(`Group "${group.name}" (id:${group.id}) created${memberSuffix}.`);
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAO9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAA2B;IAC9E,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS;QACjC,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QACnD,CAAC,CAAC,MAAM,qBAAqB,EAAE,CAAA;IAEnC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE7F,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,cAAc,EAAE;YACxB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;YAC9B,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SACxE,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAE/D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACrD,OAAM;IACV,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7F,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,YAAY,YAAY,GAAG,CAAC,CAAA;AACjF,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { MutationOptions } from '../../lib/options.js';
+type DeleteGroupOptions = MutationOptions & {
+    yes?: boolean;
+};
+export declare function deleteGroupCommand(ref: string, options: DeleteGroupOptions): Promise<void>;
+export {};
+//# sourceMappingURL=delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAI3D,KAAK,kBAAkB,GAAG,eAAe,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7D,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChG"}

package/dist/commands/groups/delete.js

@@ -0,0 +1,30 @@
+import { deleteGroup, getCurrentWorkspaceId } from '../../lib/api.js';
+import { CliError } from '../../lib/errors.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveGroupRef } from '../../lib/refs.js';
+export async function deleteGroupCommand(ref, options) {
+    const workspaceId = await getCurrentWorkspaceId();
+    const group = await resolveGroupRef(ref, workspaceId);
+    if (options.dryRun) {
+        printDryRun('delete group', {
+            Group: `${group.name} (id:${group.id})`,
+            Members: `${group.userIds.length}`,
+        });
+        return;
+    }
+    if (!options.yes) {
+        if (options.json) {
+            throw new CliError('MISSING_YES_FLAG', '--yes is required to execute deletion in --json mode.');
+        }
+        console.log(`Would delete: ${group.name} (id:${group.id}, ${group.userIds.length} members)`);
+        console.log('Use --yes to confirm.');
+        return;
+    }
+    await deleteGroup(group.id, workspaceId);
+    if (options.json) {
+        console.log(formatJson({ id: group.id, deleted: true }));
+        return;
+    }
+    console.log(`Group "${group.name}" (id:${group.id}) deleted.`);
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAInD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW,EAAE,OAA2B;IAC7E,MAAM,WAAW,GAAG,MAAM,qBAAqB,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAErD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,cAAc,EAAE;YACxB,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,GAAG;YACvC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;SACrC,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CACd,kBAAkB,EAClB,uDAAuD,CAC1D,CAAA;QACL,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAA;QAC5F,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QACpC,OAAM;IACV,CAAC;IAED,MAAM,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;IAExC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACxD,OAAM;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,YAAY,CAAC,CAAA;AAClE,CAAC"}

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

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

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

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

package/dist/commands/groups/index.js

@@ -0,0 +1,98 @@
+import { createGroupCommand } from './create.js';
+import { deleteGroupCommand } from './delete.js';
+import { listGroups } from './list.js';
+import { addUsersCommand, removeUsersCommand } from './members.js';
+import { renameGroup } from './rename.js';
+import { viewGroup } from './view.js';
+export function registerGroupsCommand(program) {
+    const groups = program.command('groups').description('Group operations');
+    groups
+        .command('list [workspace-ref]', { isDefault: true })
+        .description('List groups in a workspace')
+        .option('--workspace <ref>', 'Workspace ID or name')
+        .option('--search <text>', 'Filter by name')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups
+  tdc groups list --search front
+  tdc groups --workspace 123 --json`)
+        .action(listGroups);
+    groups
+        .command('view <group-ref>')
+        .description('Show a group with its members')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups view 12345
+  tdc groups view "Frontend"
+  tdc groups view id:12345 --json`)
+        .action(viewGroup);
+    groups
+        .command('create <name>')
+        .description('Create a new group')
+        .option('--workspace <ref>', 'Workspace ID or name')
+        .option('--users <refs>', 'Comma-separated user references to add (id:N, email, or name)')
+        .option('--dry-run', 'Show what would be created without creating')
+        .option('--json', 'Output created group as JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups create "Frontend"
+  tdc groups create "Backend" --users alice@doist.com,bob@doist.com
+  tdc groups create "Design" --users id:123,id:456 --json`)
+        .action(createGroupCommand);
+    groups
+        .command('rename <group-ref> <new-name>')
+        .description('Rename a group')
+        .option('--dry-run', 'Show what would be renamed without renaming')
+        .option('--json', 'Output updated group as JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups rename 12345 "Frontend Team"
+  tdc groups rename "Frontend" "Frontend Team" --json`)
+        .action(renameGroup);
+    groups
+        .command('delete <group-ref>')
+        .description('Permanently delete a group')
+        .option('--yes', 'Confirm deletion')
+        .option('--dry-run', 'Show what would happen without executing')
+        .option('--json', 'Output result as JSON')
+        .addHelpText('after', `
+Examples:
+  tdc groups delete 12345 --yes
+  tdc groups delete "Frontend" --dry-run`)
+        .action(deleteGroupCommand);
+    groups
+        .command('add-user <group-ref> [user-refs...]')
+        .description('Add one or more users to a group')
+        .option('--dry-run', 'Show what would change without changing')
+        .option('--json', 'Output result as JSON')
+        .option('--full', 'Include the full updated group in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups add-user 12345 alice@doist.com bob@doist.com
+  tdc groups add-user "Frontend" id:123,id:456
+  tdc groups add-user 12345 alice bob carol --json
+
+User references can be passed as space-separated args, comma-separated within a
+single arg, or any mix of the two.`)
+        .action(addUsersCommand);
+    groups
+        .command('remove-user <group-ref> [user-refs...]')
+        .description('Remove one or more users from a group')
+        .option('--dry-run', 'Show what would change without changing')
+        .option('--json', 'Output result as JSON')
+        .option('--full', 'Include the full updated group in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups remove-user 12345 alice@doist.com
+  tdc groups remove-user "Frontend" id:123,id:456`)
+        .action(removeUsersCommand);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { ViewOptions } from '../../lib/options.js';
+export type ListGroupsOptions = ViewOptions & {
+    workspace?: string;
+    search?: string;
+};
+export declare function listGroups(workspaceRef: string | undefined, options: ListGroupsOptions): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErF,wBAAsB,UAAU,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/commands/groups/list.js

@@ -0,0 +1,42 @@
+import { getCurrentWorkspaceId, getWorkspaceGroups } from '../../lib/api.js';
+import { CliError } from '../../lib/errors.js';
+import { colors, formatJson, formatNdjson, pluralize, printEmpty } from '../../lib/output.js';
+import { resolveWorkspaceRef } from '../../lib/refs.js';
+export async function listGroups(workspaceRef, options) {
+    if (workspaceRef && options.workspace) {
+        throw new CliError('CONFLICTING_OPTIONS', 'Cannot specify workspace both as argument and --workspace flag');
+    }
+    let workspaceId;
+    const ref = workspaceRef || options.workspace;
+    if (ref) {
+        const workspace = await resolveWorkspaceRef(ref);
+        workspaceId = workspace.id;
+    }
+    else {
+        workspaceId = await getCurrentWorkspaceId();
+    }
+    let groups = await getWorkspaceGroups(workspaceId);
+    if (options.search) {
+        const query = options.search.toLowerCase();
+        groups = groups.filter((g) => g.name.toLowerCase().includes(query));
+    }
+    if (groups.length === 0) {
+        printEmpty({ options, type: 'group', message: 'No groups found.' });
+        return;
+    }
+    if (options.json) {
+        console.log(formatJson(groups, 'group', options.full));
+        return;
+    }
+    if (options.ndjson) {
+        console.log(formatNdjson(groups, 'group', options.full));
+        return;
+    }
+    for (const g of groups) {
+        const id = colors.timestamp(`id:${g.id}`);
+        const name = colors.channel(g.name);
+        const members = colors.timestamp(`(${g.userIds.length} ${pluralize(g.userIds.length, 'member')})`);
+        console.log(`${id}  ${name}  ${members}`);
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/groups/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAIvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,YAAgC,EAChC,OAA0B;IAE1B,IAAI,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,QAAQ,CACd,qBAAqB,EACrB,gEAAgE,CACnE,CAAA;IACL,CAAC;IAED,IAAI,WAAmB,CAAA;IACvB,MAAM,GAAG,GAAG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAA;IAE7C,IAAI,GAAG,EAAE,CAAC;QACN,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAA;QAChD,WAAW,GAAG,SAAS,CAAC,EAAE,CAAA;IAC9B,CAAC;SAAM,CAAC;QACJ,WAAW,GAAG,MAAM,qBAAqB,EAAE,CAAA;IAC/C,CAAC;IAED,IAAI,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAElD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAA;QACnE,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACtD,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACxD,OAAM;IACV,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAC5B,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CACnE,CAAA;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;IAC7C,CAAC;AACL,CAAC"}

package/dist/commands/groups/members.d.ts

@@ -0,0 +1,4 @@
+import type { MutationOptions } from '../../lib/options.js';
+export declare function addUsersCommand(groupRef: string, userRefs: string[], options: MutationOptions): Promise<void>;
+export declare function removeUsersCommand(groupRef: string, userRefs: string[], options: MutationOptions): Promise<void>;
+//# sourceMappingURL=members.d.ts.map

package/dist/commands/groups/members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/members.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AA0G3D,wBAAsB,eAAe,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf"}