@reximo/cli 0.1.0-alpha.3 → 0.1.0-alpha.5

package/src/lib/run-cli.js

@@ -33,6 +33,12 @@ function getOutputMode(command) {
     const opts = command.optsWithGlobals();
     return opts.json ? "json" /* OutputMode.Json */ : "text" /* OutputMode.Text */;
 }
+function parseCsvOption(value) {
+    return value
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
 function renderConfigSummary(config, includeSensitive) {
     return {
         profile: config.profile,
@@ -69,6 +75,15 @@ function requireConfiguredOrganization(config) {
     }
     return config.organizationId;
 }
+function createAuthenticatedContext(dependencies, configOptions) {
+    const config = (0, config_1.loadResolvedConfig)(configOptions);
+    return {
+        config,
+        client: dependencies.clientFactory(config),
+        accessToken: requireConfiguredToken(config, "accessToken" /* ConfiguredTokenField.AccessToken */),
+        organizationId: requireConfiguredOrganization(config)
+    };
+}
 async function resolveRequiredValue(currentValue, label, prompt) {
     if (currentValue?.trim()) {
         return currentValue.trim();
@@ -124,6 +139,214 @@ async function resolveOrganizationContext(promptAdapter, organizations, organiza
     const selectedOrganizationId = await promptAdapter.select('Select organization', choices);
     return (activeOrganizations.find((organization) => organization.organizationId === selectedOrganizationId) ?? null);
 }
+function formatIssueIdentifier(issue) {
+    if (issue.project?.key) {
+        return `${issue.project.key}-${issue.issueNumber}`;
+    }
+    return `#${issue.issueNumber}`;
+}
+function formatIssueLines(result) {
+    if (result.data.length === 0) {
+        return ['No issues found.'];
+    }
+    const lines = [
+        `Issues: ${result.metadata.pagination.total} total (page ${result.metadata.pagination.page}/${Math.max(result.metadata.pagination.totalPages, 1)})`
+    ];
+    for (const issue of result.data) {
+        lines.push(`${formatIssueIdentifier(issue)} [id:${issue.id}] ${issue.title} (${issue.status}, ${issue.priority})`);
+    }
+    return lines;
+}
+function formatIssueDetailLines(issue) {
+    return [
+        `Issue: ${formatIssueIdentifier(issue)} [id:${issue.id}]`,
+        `Title: ${issue.title}`,
+        `Status: ${issue.status}`,
+        `Priority: ${issue.priority}`,
+        `Project: ${issue.project?.name ?? '(none)'}`,
+        `Updated: ${issue.updatedAt}`
+    ];
+}
+function formatProjectAccess(project) {
+    if (project.visibility === 'public') {
+        return 'public';
+    }
+    return project.isMember ? 'private member' : 'private';
+}
+function formatProjectLines(result) {
+    if (result.data.length === 0) {
+        return ['No projects found.'];
+    }
+    const lines = [
+        `Projects: ${result.metadata.pagination.total} total (page ${result.metadata.pagination.page}/${Math.max(result.metadata.pagination.totalPages, 1)})`
+    ];
+    for (const project of result.data) {
+        lines.push(`${project.key} [id:${project.id}] ${project.name} (${formatProjectAccess(project)})`);
+    }
+    return lines;
+}
+function formatContentLines(result) {
+    if (result.data.length === 0) {
+        return ['No content entries found.'];
+    }
+    return [
+        `Content entries: ${result.data.length}`,
+        ...result.data.map((content) => `${content.slug} [id:${content.id}] ${content.title} (revision ${content.revision})`)
+    ];
+}
+function formatContentDetailLines(content) {
+    return [
+        `Content: ${content.slug} [id:${content.id}]`,
+        `Title: ${content.title}`,
+        `Revision: ${content.revision}`,
+        `Project: ${content.projectId ?? '(none)'}`,
+        `Parent: ${content.parentId ?? '(none)'}`,
+        `Updated: ${content.updatedAt}`
+    ];
+}
+function buildUpdateIssuePayload(options) {
+    const payload = {};
+    if (options.title !== undefined) {
+        payload['title'] = options.title;
+    }
+    if (options.descriptionMarkdown !== undefined) {
+        payload['descriptionMarkdown'] = options.descriptionMarkdown;
+    }
+    if (options.status !== undefined) {
+        payload['status'] = options.status;
+    }
+    if (options.statusDefinitionId !== undefined) {
+        payload['statusDefinitionId'] = options.statusDefinitionId;
+    }
+    if (options.priority !== undefined) {
+        payload['priority'] = options.priority;
+    }
+    if (options.position !== undefined) {
+        payload['position'] = options.position;
+    }
+    if (options.baseRevision !== undefined) {
+        payload['baseRevision'] = options.baseRevision;
+    }
+    if (options.clearParentIssue) {
+        payload['parentIssueId'] = null;
+    }
+    else if (options.parentIssueId !== undefined) {
+        payload['parentIssueId'] = options.parentIssueId;
+    }
+    if (options.clearEstimate) {
+        payload['estimate'] = null;
+    }
+    else if (options.estimate !== undefined) {
+        payload['estimate'] = options.estimate;
+    }
+    if (options.clearDueAt) {
+        payload['dueAt'] = null;
+    }
+    else if (options.dueAt !== undefined) {
+        payload['dueAt'] = options.dueAt;
+    }
+    if (Object.keys(payload).length === 0) {
+        throw new Error('At least one update field is required.');
+    }
+    return payload;
+}
+function buildUpdateContentPayload(options) {
+    const payload = {};
+    if (options.title !== undefined) {
+        payload['title'] = options.title;
+    }
+    if (options.contentMarkdown !== undefined) {
+        payload['contentMarkdown'] = options.contentMarkdown;
+    }
+    if (options.slug !== undefined) {
+        payload['slug'] = options.slug;
+    }
+    if (options.position !== undefined) {
+        payload['position'] = options.position;
+    }
+    if (options.baseRevision !== undefined) {
+        payload['baseRevision'] = options.baseRevision;
+    }
+    if (options.clearParent) {
+        payload['parentId'] = null;
+    }
+    else if (options.parentId !== undefined) {
+        payload['parentId'] = options.parentId;
+    }
+    if (Object.keys(payload).length === 0) {
+        throw new Error('At least one content update field is required.');
+    }
+    return payload;
+}
+function buildIssuesSearchInput(options) {
+    if (options.status !== undefined || options.statuses !== undefined) {
+        return options;
+    }
+    return {
+        ...options,
+        statuses: ["backlog" /* IssueStatusOption.Backlog */, "in_progress" /* IssueStatusOption.InProgress */, "blocked" /* IssueStatusOption.Blocked */]
+    };
+}
+function buildAuthStatus(config, client) {
+    const target = client.describeTarget();
+    return {
+        profile: config.profile,
+        configPath: config.configPath,
+        configFileFound: config.configFileFound,
+        apiBaseUrl: config.apiBaseUrl ?? config_1.DEFAULT_API_BASE_URL,
+        isConfigured: client.isConfigured(),
+        hasAccessToken: target.hasAccessToken,
+        hasRefreshToken: target.hasRefreshToken,
+        organizationId: target.organizationId
+    };
+}
+function buildDoctorReport(config, client) {
+    const auth = buildAuthStatus(config, client);
+    return {
+        command: 'doctor',
+        auth,
+        checks: {
+            apiBaseUrlConfigured: auth.isConfigured,
+            accessTokenConfigured: auth.hasAccessToken,
+            refreshTokenConfigured: auth.hasRefreshToken,
+            organizationConfigured: Boolean(auth.organizationId),
+            readyForAuthenticatedCommands: auth.isConfigured && auth.hasAccessToken && Boolean(auth.organizationId)
+        },
+        capabilities: {
+            issues: {
+                search: true,
+                list: true,
+                get: true,
+                create: true,
+                update: true,
+                delete: true,
+                comment: true,
+                transition: true,
+                link: true
+            },
+            projects: {
+                list: true
+            },
+            content: {
+                list: true,
+                get: true,
+                create: true,
+                update: true,
+                delete: true,
+                publish: false,
+                attach: false
+            }
+        },
+        notes: [
+            'Issue search, get, create, update, delete, comment, transition, and link are currently supported.',
+            'Project listing and content list, get, create, update, and delete are currently supported.',
+            'The current API surface does not expose a separate content publish endpoint.'
+        ]
+    };
+}
+function unsupportedContentError(subcommand) {
+    return new Error(`Content command "${subcommand}" is not yet supported by the installed Reximo CLI/API surface. Run \`reximo doctor --json\` to inspect current capabilities.`);
+}
 function createProgram(dependencies) {
     const configOptions = {
         env: dependencies.env,
@@ -180,6 +403,393 @@ function createProgram(dependencies) {
             }
         });
     });
+    const authCommand = program.command('auth').description('Inspect Reximo authentication state.');
+    authCommand
+        .command('status')
+        .description('Show whether the current CLI profile is ready for authenticated API commands.')
+        .action(function action() {
+        const config = (0, config_1.loadResolvedConfig)(configOptions);
+        const client = dependencies.clientFactory(config);
+        const status = buildAuthStatus(config, client);
+        writeResult(this, dependencies, [
+            `Profile: ${status.profile}`,
+            `Config path: ${status.configPath}`,
+            `Config file found: ${status.configFileFound ? 'yes' : 'no'}`,
+            `API base URL: ${status.apiBaseUrl}`,
+            `Configured for API: ${status.isConfigured ? 'yes' : 'no'}`,
+            `Access token configured: ${status.hasAccessToken ? 'yes' : 'no'}`,
+            `Refresh token configured: ${status.hasRefreshToken ? 'yes' : 'no'}`,
+            `Organization: ${status.organizationId ?? '(not configured)'}`
+        ], {
+            command: 'auth.status',
+            status
+        });
+    });
+    program
+        .command('doctor')
+        .description('Report Reximo CLI readiness and command-surface capabilities for automation.')
+        .action(function action() {
+        const config = (0, config_1.loadResolvedConfig)(configOptions);
+        const client = dependencies.clientFactory(config);
+        const report = buildDoctorReport(config, client);
+        writeResult(this, dependencies, [
+            `Profile: ${report.auth.profile}`,
+            `Configured for API: ${report.auth.isConfigured ? 'yes' : 'no'}`,
+            `Access token configured: ${report.auth.hasAccessToken ? 'yes' : 'no'}`,
+            `Refresh token configured: ${report.auth.hasRefreshToken ? 'yes' : 'no'}`,
+            `Organization: ${report.auth.organizationId ?? '(not configured)'}`,
+            `Ready for authenticated commands: ${report.auth.isConfigured && report.auth.hasAccessToken && Boolean(report.auth.organizationId) ? 'yes' : 'no'}`,
+            `Issue commands: search, list, get, create, update, delete, comment, transition, link`,
+            `Content commands: list, get, create, update, delete`,
+            `Unsupported content commands: publish, attach`
+        ], report);
+    });
+    const issuesCommand = program.command('issues').description('Manage issues.');
+    issuesCommand
+        .command('search')
+        .alias('list')
+        .description('Search visible issues within the configured organization.')
+        .option('--page <page>', 'Page number (1-based)', Number)
+        .option('--page-size <pageSize>', 'Items per page', Number)
+        .option('--project-id <projectId>', 'Restrict to one project id', Number)
+        .option('--label-id <labelId>', 'Restrict to one label id', Number)
+        .option('--assignee-user-id <assigneeUserId>', 'Restrict to one assignee user id', Number)
+        .option('--watcher-user-id <watcherUserId>', 'Restrict to one watcher user id', Number)
+        .option('--activity-actor-user-id <activityActorUserId>', 'Restrict to issues with activity authored by one user', Number)
+        .option('--search <search>', 'Search by issue identifier, title, or description')
+        .option('--status <status>', 'Restrict to one status')
+        .option('--statuses <statuses>', 'Comma-separated list of statuses', parseCsvOption)
+        .option('--priority <priority>', 'Restrict to one priority')
+        .option('--sort-by <sortBy>', 'Sort field')
+        .option('--sort-order <sortOrder>', 'Sort direction')
+        .action(async function action(options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const result = await client.listIssues({
+            accessToken,
+            organizationId,
+            ...buildIssuesSearchInput(options)
+        });
+        writeResult(this, dependencies, formatIssueLines(result), {
+            command: 'issues.search',
+            result
+        });
+    });
+    issuesCommand
+        .command('get <issueId>')
+        .alias('show')
+        .description('Get one issue by id in the configured organization.')
+        .action(async function action(issueId) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const issue = await client.getIssue({
+            accessToken,
+            organizationId,
+            issueId
+        });
+        writeResult(this, dependencies, formatIssueDetailLines(issue), {
+            command: 'issues.get',
+            issue
+        });
+    });
+    issuesCommand
+        .command('create')
+        .description('Create one issue in the configured organization.')
+        .option('--title <title>', 'Issue title')
+        .option('--description-markdown <descriptionMarkdown>', 'Issue description in markdown')
+        .option('--status <status>', 'Issue status')
+        .option('--status-definition-id <statusDefinitionId>', 'Issue status definition id', Number)
+        .option('--priority <priority>', 'Issue priority')
+        .option('--project-id <projectId>', 'Project id', Number)
+        .option('--parent-issue-id <parentIssueId>', 'Parent issue id', Number)
+        .option('--position <position>', 'Issue position', Number)
+        .option('--estimate <estimate>', 'Issue estimate', Number)
+        .option('--due-at <dueAt>', 'Issue due date as an ISO-8601 string')
+        .action(async function action(options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        if (!options.title?.trim()) {
+            throw new Error('Title is required');
+        }
+        const issue = await client.createIssue({
+            accessToken,
+            organizationId,
+            issue: {
+                ...options,
+                title: options.title.trim()
+            }
+        });
+        writeResult(this, dependencies, formatIssueDetailLines(issue), {
+            command: 'issues.create',
+            issue
+        });
+    });
+    issuesCommand
+        .command('update <issueId>')
+        .description('Update one issue by id in the configured organization.')
+        .option('--title <title>', 'Issue title')
+        .option('--description-markdown <descriptionMarkdown>', 'Issue description in markdown')
+        .option('--status <status>', 'Issue status')
+        .option('--status-definition-id <statusDefinitionId>', 'Issue status definition id', Number)
+        .option('--priority <priority>', 'Issue priority')
+        .option('--parent-issue-id <parentIssueId>', 'Parent issue id', Number)
+        .option('--position <position>', 'Issue position', Number)
+        .option('--estimate <estimate>', 'Issue estimate', Number)
+        .option('--due-at <dueAt>', 'Issue due date as an ISO-8601 string')
+        .option('--clear-parent-issue', 'Clear the current parent issue')
+        .option('--clear-estimate', 'Clear the current estimate')
+        .option('--clear-due-at', 'Clear the current due date')
+        .option('--base-revision <baseRevision>', 'Optimistic concurrency token from the last issue read')
+        .action(async function action(issueId, options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const issue = await client.updateIssue({
+            accessToken,
+            organizationId,
+            issueId,
+            issue: buildUpdateIssuePayload(options)
+        });
+        writeResult(this, dependencies, formatIssueDetailLines(issue), {
+            command: 'issues.update',
+            issue
+        });
+    });
+    issuesCommand
+        .command('transition <issueId>')
+        .description('Transition one issue by updating its status or status definition.')
+        .option('--status <status>', 'Issue status')
+        .option('--status-definition-id <statusDefinitionId>', 'Issue status definition id', Number)
+        .option('--base-revision <baseRevision>', 'Optimistic concurrency token from the last issue read')
+        .action(async function action(issueId, options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        if (options.status === undefined && options.statusDefinitionId === undefined) {
+            throw new Error('Either --status or --status-definition-id is required.');
+        }
+        const issue = await client.updateIssue({
+            accessToken,
+            organizationId,
+            issueId,
+            issue: {
+                ...(options.status !== undefined ? { status: options.status } : {}),
+                ...(options.statusDefinitionId !== undefined
+                    ? { statusDefinitionId: options.statusDefinitionId }
+                    : {}),
+                ...(options.baseRevision !== undefined ? { baseRevision: options.baseRevision } : {})
+            }
+        });
+        writeResult(this, dependencies, formatIssueDetailLines(issue), {
+            command: 'issues.transition',
+            issue
+        });
+    });
+    issuesCommand
+        .command('comment <issueId>')
+        .description('Create one issue comment in the configured organization.')
+        .option('--body-markdown <bodyMarkdown>', 'Issue comment body in markdown')
+        .option('--parent-comment-id <parentCommentId>', 'Optional parent comment id', Number)
+        .action(async function action(issueId, options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        if (!options.bodyMarkdown?.trim()) {
+            throw new Error('Comment body is required');
+        }
+        const issue = await client.createIssueComment({
+            accessToken,
+            organizationId,
+            issueId,
+            comment: {
+                bodyMarkdown: options.bodyMarkdown.trim(),
+                ...(options.parentCommentId !== undefined
+                    ? { parentCommentId: options.parentCommentId }
+                    : {})
+            }
+        });
+        writeResult(this, dependencies, formatIssueDetailLines(issue), {
+            command: 'issues.comment',
+            issue
+        });
+    });
+    issuesCommand
+        .command('link <issueId>')
+        .description('Create one issue relation from the selected issue to another issue.')
+        .option('--target-issue-id <targetIssueId>', 'Target issue id', Number)
+        .option('--relation-type <relationType>', 'Relation type key')
+        .action(async function action(issueId, options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        if (options.targetIssueId === undefined) {
+            throw new Error('Target issue id is required');
+        }
+        if (!options.relationType?.trim()) {
+            throw new Error('Relation type is required');
+        }
+        const issue = await client.createIssueRelation({
+            accessToken,
+            organizationId,
+            issueId,
+            relation: {
+                targetIssueId: options.targetIssueId,
+                relationType: options.relationType
+            }
+        });
+        writeResult(this, dependencies, formatIssueDetailLines(issue), {
+            command: 'issues.link',
+            issue
+        });
+    });
+    issuesCommand
+        .command('delete <issueId>')
+        .description('Delete one issue by id in the configured organization.')
+        .action(async function action(issueId) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        await client.deleteIssue({
+            accessToken,
+            organizationId,
+            issueId
+        });
+        writeResult(this, dependencies, [`Issue ${issueId} deleted.`], {
+            command: 'issues.delete',
+            issueId,
+            deleted: true
+        });
+    });
+    const projectsCommand = program.command('projects').description('Manage projects.');
+    projectsCommand
+        .command('list')
+        .description('List projects visible to the current user in the configured organization.')
+        .option('--page <page>', 'Page number (1-based)', Number)
+        .option('--page-size <pageSize>', 'Items per page', Number)
+        .option('--search <search>', 'Search by project name')
+        .option('--visibility <visibility>', 'Restrict to one visibility')
+        .option('--sort-by <sortBy>', 'Sort field')
+        .option('--sort-order <sortOrder>', 'Sort direction')
+        .action(async function action(options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const result = await client.listProjects({
+            accessToken,
+            organizationId,
+            ...options
+        });
+        writeResult(this, dependencies, formatProjectLines(result), {
+            command: 'projects.list',
+            result
+        });
+    });
+    const contentCommand = program.command('content').description('Manage content entries.');
+    contentCommand
+        .command('list')
+        .description('List content entries visible to the current user in the configured organization.')
+        .option('--scope <scope>', 'Content scope filter')
+        .option('--project-id <projectId>', 'Project id filter', Number)
+        .option('--parent-id <parentId>', 'Parent content id filter', Number)
+        .option('--slug <slug>', 'Slug filter')
+        .action(async function action(options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const result = await client.listContent({
+            accessToken,
+            organizationId,
+            ...options
+        });
+        writeResult(this, dependencies, formatContentLines(result), {
+            command: 'content.list',
+            result
+        });
+    });
+    contentCommand
+        .command('get <contentId>')
+        .alias('show')
+        .description('Get one content entry by id in the configured organization.')
+        .action(async function action(contentId) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const content = await client.getContent({
+            accessToken,
+            organizationId,
+            contentId
+        });
+        writeResult(this, dependencies, formatContentDetailLines(content), {
+            command: 'content.get',
+            content
+        });
+    });
+    contentCommand
+        .command('create')
+        .description('Create one content entry in the configured organization.')
+        .option('--title <title>', 'Content title')
+        .option('--content-markdown <contentMarkdown>', 'Content body in markdown')
+        .option('--slug <slug>', 'Content slug')
+        .option('--project-id <projectId>', 'Project id', Number)
+        .option('--parent-id <parentId>', 'Parent content id', Number)
+        .option('--position <position>', 'Content position', Number)
+        .action(async function action(options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        if (!options.title?.trim()) {
+            throw new Error('Title is required');
+        }
+        if (!options.contentMarkdown?.trim()) {
+            throw new Error('Content markdown is required');
+        }
+        const content = await client.createContent({
+            accessToken,
+            organizationId,
+            content: {
+                title: options.title.trim(),
+                contentMarkdown: options.contentMarkdown,
+                ...(options.slug !== undefined ? { slug: options.slug } : {}),
+                ...(options.projectId !== undefined ? { projectId: options.projectId } : {}),
+                ...(options.parentId !== undefined ? { parentId: options.parentId } : {}),
+                ...(options.position !== undefined ? { position: options.position } : {})
+            }
+        });
+        writeResult(this, dependencies, formatContentDetailLines(content), {
+            command: 'content.create',
+            content
+        });
+    });
+    contentCommand
+        .command('update <contentId>')
+        .description('Update one content entry by id in the configured organization.')
+        .option('--title <title>', 'Content title')
+        .option('--content-markdown <contentMarkdown>', 'Content body in markdown')
+        .option('--slug <slug>', 'Content slug')
+        .option('--parent-id <parentId>', 'Parent content id', Number)
+        .option('--position <position>', 'Content position', Number)
+        .option('--clear-parent', 'Clear the current parent content id')
+        .option('--base-revision <baseRevision>', 'Optimistic concurrency token from the last content read')
+        .action(async function action(contentId, options) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        const content = await client.updateContent({
+            accessToken,
+            organizationId,
+            contentId,
+            content: buildUpdateContentPayload(options)
+        });
+        writeResult(this, dependencies, formatContentDetailLines(content), {
+            command: 'content.update',
+            content
+        });
+    });
+    contentCommand
+        .command('delete <contentId>')
+        .description('Delete one content entry by id in the configured organization.')
+        .action(async function action(contentId) {
+        const { client, accessToken, organizationId } = createAuthenticatedContext(dependencies, configOptions);
+        await client.deleteContent({
+            accessToken,
+            organizationId,
+            contentId
+        });
+        writeResult(this, dependencies, [`Content ${contentId} deleted.`], {
+            command: 'content.delete',
+            contentId,
+            deleted: true
+        });
+    });
+    contentCommand
+        .command('publish <contentId>')
+        .description('Publish one content artifact when supported by the installed CLI/API surface.')
+        .action(async () => {
+        throw unsupportedContentError("publish" /* UnsupportedContentCommand.Publish */);
+    });
+    contentCommand
+        .command('attach <contentId>')
+        .description('Attach an artifact to content when supported by the installed CLI/API surface.')
+        .action(async () => {
+        throw unsupportedContentError("attach" /* UnsupportedContentCommand.Attach */);
+    });
     const configCommand = program
         .command('config')
         .description('Inspect resolved CLI configuration.');