@reximo/cli 0.1.0-alpha.2 → 0.1.0-alpha.4

package/README.md

@@ -20,8 +20,15 @@ For a project-local install, use `npx reximo`, `npm exec reximo`, or `./node_mod
 ## Local usage
 
 ```bash
-pnpm reximo:cli:dev -- hello
 pnpm reximo:cli:dev -- info --json
+pnpm reximo:cli:dev -- login --email user@example.com --password 'secret' --organization-id 123
+pnpm reximo:cli:dev -- issues search --search restore --page-size 10
+pnpm reximo:cli:dev -- issues create --title "Restore CLI issue workflow" --project-id 34
+pnpm reximo:cli:dev -- issues update 77 --priority high --clear-due-at
+pnpm reximo:cli:dev -- issues delete 77
+pnpm reximo:cli:dev -- projects list --visibility public
+pnpm reximo:cli:dev -- me
+pnpm reximo:cli:dev -- logout
 pnpm reximo:cli:build
 pnpm reximo:cli:pack
 ```
@@ -32,9 +39,19 @@ pnpm reximo:cli:pack
 
 ## Commands
 
-- `reximo hello`
-- `reximo hello --name <name>`
 - `reximo info`
+- `reximo login`
+- `reximo login --email <email> --password <password>`
+- `reximo login --organization-id <organizationId>`
+- `reximo me`
+- `reximo profile`
+- `reximo logout`
+- `reximo issues search`
+- `reximo issues list`
+- `reximo issues create --title <title>`
+- `reximo issues update <issueId>`
+- `reximo issues delete <issueId>`
+- `reximo projects list`
 - `reximo config show`
 - `reximo --help`
 
@@ -50,6 +67,8 @@ Supported environment variables:
 
 - `REXIMO_API_BASE_URL`
 - `REXIMO_TOKEN`
+- `REXIMO_REFRESH_TOKEN`
+- `REXIMO_ORGANIZATION_ID`
 - `REXIMO_PROFILE`
 - `REXIMO_CONFIG`
 
@@ -66,13 +85,113 @@ Example config file:
   "profile": "default",
   "profiles": {
     "default": {
-      "apiBaseUrl": "https://api.reximo.example",
-      "token": "redacted"
+      "apiBaseUrl": "https://api.reximo.app",
+      "accessToken": "redacted-access-token",
+      "refreshToken": "redacted-refresh-token",
+      "organizationId": "123"
     }
   }
 }
 ```
 
+The CLI stores persisted auth state in `~/.reximo/config.json` by default. Environment variables still override the file at runtime.
+
+`REXIMO_TOKEN` remains the access-token override for compatibility.
+
+## Login
+
+`reximo login` supports both flag-driven and interactive use.
+
+Flag-driven:
+
+```bash
+reximo login --email user@example.com --password 'secret' --organization-id 123
+```
+
+Interactive:
+
+```bash
+reximo login
+```
+
+Behavior:
+
+- the CLI authenticates against `https://api.reximo.app/api/v1/auth/login` by default
+- it persists the access token, refresh token, and selected organization ID to the active profile
+- if multiple active organizations are available, it prompts for selection in an interactive terminal
+- in non-interactive use, pass `--organization-id` when multiple organizations are possible
+
+## Issues
+
+Authenticated issue commands require both an access token and an organization id in the active CLI profile or environment.
+
+Search issues:
+
+```bash
+reximo issues search --search restore --project-id 34 --status in_progress --page-size 25
+reximo issues list --json
+```
+
+Create an issue:
+
+```bash
+reximo issues create \
+  --title "Restore CLI issue workflow" \
+  --description-markdown "Bring issue management to the CLI." \
+  --project-id 34 \
+  --status backlog \
+  --priority high
+```
+
+Update an issue by numeric id:
+
+```bash
+reximo issues update 77 --title "Restore CLI issue workflow" --priority low
+reximo issues update 77 --clear-estimate --clear-due-at
+```
+
+Delete an issue by numeric id:
+
+```bash
+reximo issues delete 77
+```
+
+Notes:
+
+- `issues search` and `issues list` are the same command surface
+- by default, `issues search` and `issues list` exclude issues with status `done`
+- pass `--status done` or `--statuses ...` to override the default status filter
+- `issues update` requires at least one update flag
+- `issues create` requires `--title`
+- `--json` is supported for scripting on all commands
+
+## Projects
+
+`reximo projects list` returns projects visible to the current user in the configured organization.
+
+Visibility behavior:
+
+- public projects are listed for the organization
+- private projects are listed only when the current user is a member
+
+Examples:
+
+```bash
+reximo projects list
+reximo projects list --visibility private --page-size 50
+reximo projects list --json
+```
+
+## Generated Client
+
+The CLI API client is generated from the API OpenAPI spec emitted at `.agentic/docs/reference/api/openapi-v1.json`.
+
+Regenerate it with:
+
+```bash
+pnpm --dir packages/reximo-cli generate:client
+```
+
 ## Release checks
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reximo/cli",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "Command-line interface for Reximo.",
   "type": "commonjs",
   "license": "ISC",
@@ -46,9 +46,10 @@
   "scripts": {
     "build": "pnpm -C ../.. exec nx build reximo-cli",
     "dev": "pnpm exec tsx src/cli.ts",
+    "generate:client": "pnpm -C ../.. docs:openapi && pnpm exec tsx scripts/generate-client.ts",
     "lint": "ESLINT_USE_FLAT_CONFIG=false pnpm exec eslint src --ext .ts",
     "pack:dry-run": "pnpm run build && cd ../../dist/packages/reximo-cli && npm pack --dry-run",
-    "test": "pnpm exec tsx --test src/**/*.test.ts",
+    "test": "pnpm exec tsx --test src/run-cli.test.ts src/lib/config.test.ts",
     "typecheck": "tsc --noEmit",
     "verify": "pnpm run lint && pnpm run typecheck && pnpm run test"
   },

package/src/client/generated/index.d.ts

@@ -0,0 +1 @@
+export { ReximoApiClient, ReximoApiError, type AuthenticatedRequestOptions, type BaseResponseDto, type CreateIssueRequest, type CreateIssueResponse, type DeleteIssueResponse, type GetMeOptions, type GetMeResponse, type GetMyOrganizationsResponse, type GetIssueResponse, type IssueDetailDto, type IssueListItemDto, type LoginOptions, type LoginRequest, type LoginResponse, type ListIssuesOptions, type ListIssuesResponse, type ListProjectsOptions, type ListProjectsResponse, type LogoutOptions, type LogoutResponse, type GetMyOrganizationsOptions, type RefreshTokenOptions, type RefreshTokenRequest, type RefreshTokenResponse, type ReximoApiClientOptions, type UpdateIssueRequest, type UpdateIssueResponse, type UserOrganizationDto } from './reximo-api-client.generated';

package/src/client/generated/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReximoApiError = exports.ReximoApiClient = void 0;
+var reximo_api_client_generated_1 = require("./reximo-api-client.generated");
+Object.defineProperty(exports, "ReximoApiClient", { enumerable: true, get: function () { return reximo_api_client_generated_1.ReximoApiClient; } });
+Object.defineProperty(exports, "ReximoApiError", { enumerable: true, get: function () { return reximo_api_client_generated_1.ReximoApiError; } });
+//# sourceMappingURL=index.js.map

package/src/client/generated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/reximo-cli/src/client/generated/index.ts"],"names":[],"mappings":";;;AAAA,6EA+BuC;AA9BrC,8HAAA,eAAe,OAAA;AACf,6HAAA,cAAc,OAAA"}

package/src/client/generated/reximo-api-client.generated.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Generated from .agentic/docs/reference/api/openapi-v1.json.
+ * Do not edit manually. Regenerate with:
+ * pnpm --dir packages/reximo-cli generate:client
+ */
+export interface BaseResponseDto<T> {
+    data: T;
+    metadata?: {
+        timestamp?: string;
+        version?: string;
+        requestId?: string;
+        error?: Record<string, unknown>;
+    };
+}
+export interface LoginDto {
+    email: string;
+    password: string;
+}
+export interface RefreshTokenDto {
+    refreshToken: string;
+}
+export interface AuthResponseDto {
+    accessToken: string;
+    refreshToken: string;
+    idToken: string;
+    expiresIn: number;
+    refreshExpiresIn: number;
+    user: {
+        "userId"?: string;
+        "username"?: string;
+        "email"?: string;
+        "emailVerified"?: boolean;
+        "roles"?: Array<string>;
+        "permissions"?: Array<string>;
+        "tenantId"?: string;
+    };
+    isNewUser: boolean;
+}
+export interface UserOrganizationDto {
+    organizationId: string;
+    tenantId: string;
+    name: string;
+    displayName?: string;
+    slug: string;
+    role: string;
+    isDefault: boolean;
+    isActive: boolean;
+}
+export interface CreateIssueDto {
+    title: string;
+    descriptionMarkdown?: string;
+    status?: "backlog" | "in_progress" | "blocked" | "done";
+    statusDefinitionId?: number | null;
+    priority?: "urgent" | "high" | "medium" | "low";
+    projectId?: number;
+    parentIssueId?: number;
+    position?: number;
+    estimate?: number;
+    dueAt?: string;
+}
+export interface UpdateIssueDto {
+    title?: string;
+    descriptionMarkdown?: string;
+    status?: "backlog" | "in_progress" | "blocked" | "done";
+    statusDefinitionId?: number | null;
+    priority?: "urgent" | "high" | "medium" | "low";
+    parentIssueId?: number;
+    position?: number;
+    estimate?: number | null;
+    dueAt?: string | null;
+    baseRevision?: string;
+}
+export interface IssueListItemDto {
+    id: number;
+    organizationId: number;
+    projectId?: number | null;
+    project?: IssueProjectDto;
+    parentIssueId?: number | null;
+    parentIssue?: IssueParentSummaryDto;
+    issueNumber: number;
+    title: string;
+    descriptionMarkdown: string;
+    status: string;
+    statusDefinition: IssueStatusDefinitionDto;
+    priority: string;
+    position: number;
+    estimate?: number | null;
+    dueAt?: string | null;
+    resolvedAt?: Record<string, unknown> | null;
+    createdBy: number;
+    updatedBy: number;
+    createdAt: string;
+    updatedAt: string;
+    assignees: Array<IssueParticipantDto>;
+    labels: Array<IssueLabelDto>;
+    commentsCount: number;
+    attachmentsCount: number;
+    watchersCount: number;
+    subtaskCount: number;
+    completedSubtaskCount: number;
+    activity?: Array<IssueActivityDto>;
+}
+export interface IssueProjectDto {
+    id: number;
+    key: string;
+    name: string;
+    visibility: string;
+}
+export interface IssueParentSummaryDto {
+    id: number;
+    identifier: string;
+    title: string;
+}
+export interface IssueStatusDefinitionDto {
+    id?: number | null;
+    key: string;
+    name: string;
+    color?: string | null;
+    description?: string | null;
+    baseStatus: string;
+    projectId?: number | null;
+    position?: number | null;
+}
+export interface IssueParticipantDto {
+    userId: number;
+    displayName?: string | null;
+    photoUrl?: string | null;
+}
+export interface IssueLabelDto {
+    id: number;
+    name: string;
+    color?: string | null;
+    description?: string | null;
+    projectId?: number | null;
+}
+export interface IssueActivityDto {
+    id: number;
+    activityType: string;
+    actorUserId?: number | null;
+    actorDisplayName?: string | null;
+    actorPhotoUrl?: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export interface IssueDetailDto {
+    id: number;
+    organizationId: number;
+    projectId?: number | null;
+    project?: IssueProjectDto;
+    parentIssueId?: number | null;
+    parentIssue?: IssueParentSummaryDto;
+    issueNumber: number;
+    title: string;
+    descriptionMarkdown: string;
+    status: string;
+    statusDefinition: IssueStatusDefinitionDto;
+    priority: string;
+    position: number;
+    estimate?: number | null;
+    dueAt?: string | null;
+    resolvedAt?: Record<string, unknown> | null;
+    createdBy: number;
+    updatedBy: number;
+    createdAt: string;
+    updatedAt: string;
+    assignees: Array<IssueParticipantDto>;
+    labels: Array<IssueLabelDto>;
+    commentsCount: number;
+    attachmentsCount: number;
+    watchersCount: number;
+    subtaskCount: number;
+    completedSubtaskCount: number;
+    activity?: Array<IssueActivityDto>;
+    watchers: Array<IssueParticipantDto>;
+    comments: Array<IssueCommentDto>;
+    relations: Array<IssueRelationDto>;
+    subtasks: Array<IssueListItemDto>;
+}
+export interface IssueCommentDto {
+    id: number;
+    authorUserId: number;
+    authorDisplayName?: string | null;
+    authorPhotoUrl?: string | null;
+    bodyMarkdown: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface IssueRelationDto {
+    id: number;
+    relationType: string;
+    relatedIssueId: number;
+    relatedIssueTitle: string;
+    relatedIssueNumber: number;
+}
+export type LoginRequest = LoginDto;
+export type LoginResponse = AuthResponseDto;
+export type RefreshTokenRequest = RefreshTokenDto;
+export type RefreshTokenResponse = AuthResponseDto;
+export type GetMyOrganizationsResponse = BaseResponseDto<Array<UserOrganizationDto>>;
+export type GetMeResponse = {
+    "data"?: {
+        "userId"?: string;
+        "tenantId"?: string;
+        "actorId"?: string;
+        "email"?: string;
+        "name"?: string;
+        "displayName"?: string;
+        "photoUrl"?: string;
+        "isActive"?: boolean;
+        "isVerified"?: boolean;
+        "emailVerified"?: boolean;
+        "roles"?: Array<string>;
+        "permissions"?: Array<string>;
+    };
+    "metadata"?: {
+        "timestamp"?: string;
+        "version"?: string;
+    };
+};
+export type LogoutResponse = {
+    "message": string;
+};
+export type ListIssuesResponse = Array<IssueListItemDto>;
+export type CreateIssueRequest = CreateIssueDto;
+export type CreateIssueResponse = IssueDetailDto;
+export type GetIssueResponse = IssueDetailDto;
+export type UpdateIssueRequest = UpdateIssueDto;
+export type UpdateIssueResponse = IssueDetailDto;
+export type DeleteIssueResponse = void;
+export type ListProjectsResponse = unknown;
+export declare class ReximoApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown, message: string);
+}
+export type ReximoApiClientOptions = {
+    baseUrl: string;
+    fetchFn?: typeof fetch;
+};
+export type LoginOptions = {
+    signal?: AbortSignal;
+    tenantId?: string | null;
+};
+export type GetMyOrganizationsOptions = {
+    signal?: AbortSignal;
+    accessToken: string;
+    tenantId?: string | null;
+};
+export type GetMeOptions = {
+    signal?: AbortSignal;
+    accessToken: string;
+    tenantId?: string | null;
+};
+export type RefreshTokenOptions = {
+    signal?: AbortSignal;
+    tenantId?: string | null;
+};
+export type LogoutOptions = {
+    signal?: AbortSignal;
+    accessToken: string;
+    tenantId: string;
+};
+export type AuthenticatedRequestOptions = {
+    signal?: AbortSignal;
+    accessToken: string;
+    tenantId?: string | null;
+};
+export type ListIssuesOptions = AuthenticatedRequestOptions & {
+    page?: number;
+    pageSize?: number;
+    projectId?: number;
+    labelId?: number;
+    assigneeUserId?: number;
+    watcherUserId?: number;
+    activityActorUserId?: number;
+    search?: string;
+    status?: 'backlog' | 'in_progress' | 'blocked' | 'done';
+    statuses?: Array<'backlog' | 'in_progress' | 'blocked' | 'done'>;
+    priority?: 'urgent' | 'high' | 'medium' | 'low';
+    sortBy?: 'updatedAt' | 'createdAt' | 'priority' | 'dueAt' | 'position';
+    sortOrder?: 'asc' | 'desc';
+};
+export type ListProjectsOptions = AuthenticatedRequestOptions & {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+    visibility?: 'public' | 'private';
+    sortBy?: 'name' | 'createdAt' | 'updatedAt' | 'visibility';
+    sortOrder?: 'asc' | 'desc';
+};
+export declare class ReximoApiClient {
+    private readonly baseUrl;
+    private readonly fetchFn;
+    constructor(options: ReximoApiClientOptions);
+    login(body: LoginRequest, options?: LoginOptions): Promise<LoginResponse>;
+    getMyOrganizations(options: GetMyOrganizationsOptions): Promise<GetMyOrganizationsResponse>;
+    getMe(options: GetMeOptions): Promise<GetMeResponse>;
+    refreshToken(body: RefreshTokenRequest, options?: RefreshTokenOptions): Promise<RefreshTokenResponse>;
+    logout(body: RefreshTokenRequest, options: LogoutOptions): Promise<LogoutResponse>;
+    listIssues(options: ListIssuesOptions): Promise<ListIssuesResponse>;
+    createIssue(body: CreateIssueRequest, options: AuthenticatedRequestOptions): Promise<CreateIssueResponse>;
+    getIssue(issueId: string, options: AuthenticatedRequestOptions): Promise<GetIssueResponse>;
+    updateIssue(issueId: string, body: UpdateIssueRequest, options: AuthenticatedRequestOptions): Promise<UpdateIssueResponse>;
+    deleteIssue(issueId: string, options: AuthenticatedRequestOptions): Promise<void>;
+    listProjects(options: ListProjectsOptions): Promise<ListProjectsResponse>;
+}