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

package/README.md

@@ -22,6 +22,21 @@ For a project-local install, use `npx reximo`, `npm exec reximo`, or `./node_mod
 ```bash
 pnpm reximo:cli:dev -- info --json
 pnpm reximo:cli:dev -- login --email user@example.com --password 'secret' --organization-id 123
+pnpm reximo:cli:dev -- auth status --json
+pnpm reximo:cli:dev -- doctor
+pnpm reximo:cli:dev -- issues search --search restore --page-size 10
+pnpm reximo:cli:dev -- issues get 77
+pnpm reximo:cli:dev -- issues comment 77 --body-markdown "Looks good"
+pnpm reximo:cli:dev -- issues transition 77 --status done
+pnpm reximo:cli:dev -- issues link 77 --target-issue-id 88 --relation-type blocks
+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 -- content list --scope project --project-id 34
+pnpm reximo:cli:dev -- content create --title "Incident handbook" --content-markdown "# Incident handbook"
+pnpm reximo:cli:dev -- content update 51 --title "Updated handbook"
+pnpm reximo:cli:dev -- content delete 51
+pnpm reximo:cli:dev -- projects list --visibility public
 pnpm reximo:cli:dev -- me
 pnpm reximo:cli:dev -- logout
 pnpm reximo:cli:build
@@ -32,15 +47,49 @@ pnpm reximo:cli:pack
 - `pnpm reximo:cli:build` compiles the package into `dist/packages/reximo-cli` using the Nx build target.
 - `pnpm reximo:cli:pack` runs `npm pack --dry-run` against the built package in `dist/` so you can inspect the exact tarball contents that would be published to npm without actually publishing anything.
 
+## Local verification
+
+Use the package-local loop while changing the command surface:
+
+```bash
+pnpm --dir packages/reximo-cli lint
+pnpm --dir packages/reximo-cli typecheck
+pnpm --dir packages/reximo-cli test
+pnpm --dir packages/reximo-cli build
+pnpm --dir packages/reximo-cli pack:dry-run
+```
+
+When checking automation behavior, prefer `reximo doctor --json` and keep its structured capability report aligned with the real command surface. Issue capabilities currently include `search`, `list`, `get`, `create`, `update`, `delete`, `comment`, `transition`, and `link`.
+
 ## Commands
 
 - `reximo info`
+- `reximo auth status`
+- `reximo doctor`
 - `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 get <issueId>`
+- `reximo issues show <issueId>`
+- `reximo issues create --title <title>`
+- `reximo issues update <issueId>`
+- `reximo issues delete <issueId>`
+- `reximo issues comment <issueId> --body-markdown <markdown>`
+- `reximo issues transition <issueId> --status <status>`
+- `reximo issues link <issueId> --target-issue-id <issueId> --relation-type <type>`
+- `reximo content list`
+- `reximo content get <contentId>`
+- `reximo content create --title <title> --content-markdown <markdown>`
+- `reximo content update <contentId>`
+- `reximo content delete <contentId>`
+- `reximo content publish <contentId>`
+- `reximo content attach <contentId>`
+- `reximo projects list`
 - `reximo config show`
 - `reximo --help`
 
@@ -110,6 +159,119 @@ Behavior:
 - 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
 
+## Auth And Doctor
+
+Use these commands before agent-driven automation to verify profile readiness and the currently supported command surface.
+
+```bash
+reximo auth status
+reximo auth status --json
+reximo doctor
+reximo doctor --json
+```
+
+Behavior:
+
+- `auth status` reports whether the active profile has the access token, refresh token, organization, and base URL needed for authenticated operations
+- `doctor` reports whether the active profile is ready for authenticated commands and which issue or content capabilities are currently available in the installed CLI/API surface
+
+## 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
+reximo issues get 77
+```
+
+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
+```
+
+Comment, transition, and link an issue:
+
+```bash
+reximo issues comment 77 --body-markdown "Looks good"
+reximo issues transition 77 --status done
+reximo issues link 77 --target-issue-id 88 --relation-type blocks
+```
+
+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 get` fetches one issue by id
+- `issues update` requires at least one update flag
+- `issues transition` requires either `--status` or `--status-definition-id`
+- `issues create` requires `--title`
+- `issues comment` requires `--body-markdown`
+- `issues link` requires both `--target-issue-id` and `--relation-type`
+- `--json` is supported for scripting on all commands
+
+## Content
+
+Authenticated content commands require both an access token and an organization id in the active CLI profile or environment.
+
+```bash
+reximo content list --scope project --project-id 34
+reximo content get <contentId>
+reximo content create --title "Incident handbook" --content-markdown "# Incident handbook"
+reximo content update <contentId>
+reximo content delete <contentId>
+reximo content publish <contentId>
+reximo content attach <contentId>
+```
+
+Current behavior:
+
+- the current API exposes create and update for content entries but does not expose a separate publish endpoint
+- for now, creating or updating content is the publish action for remote knowledge entries
+- `content create` requires both `--title` and `--content-markdown`
+- `content update` requires at least one update field
+- `content list` supports `--scope`, `--project-id`, `--parent-id`, and `--slug`
+- `content publish` and `content attach` are explicit capability placeholders today and fail with a clear unsupported-capability error
+
+## 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`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reximo/cli",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.5",
   "description": "Command-line interface for Reximo.",
   "type": "commonjs",
   "license": "ISC",
@@ -48,8 +48,8 @@
     "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/run-cli.test.ts src/lib/config.test.ts",
+    "pack:dry-run": "pnpm run build && pnpm exec tsx scripts/verify-runtime-deps.ts && cd ../../dist/packages/reximo-cli && npm pack --dry-run",
+    "test": "pnpm exec tsx --test src/run-cli.test.ts src/lib/config.test.ts src/lib/runtime-deps.test.ts",
     "typecheck": "tsc --noEmit",
     "verify": "pnpm run lint && pnpm run typecheck && pnpm run test"
   },

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

@@ -1 +1 @@
-export { ReximoApiClient, ReximoApiError, type BaseResponseDto, type GetMeOptions, type GetMeResponse, type GetMyOrganizationsResponse, type LoginOptions, type LoginRequest, type LoginResponse, type LogoutOptions, type LogoutResponse, type GetMyOrganizationsOptions, type RefreshTokenOptions, type RefreshTokenRequest, type RefreshTokenResponse, type ReximoApiClientOptions, type UserOrganizationDto } from './reximo-api-client.generated';
+export * from './reximo-api-client.generated';

package/src/client/generated/index.js

@@ -1,7 +1,5 @@
 "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; } });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./reximo-api-client.generated"), exports);
 //# sourceMappingURL=index.js.map

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

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

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

@@ -46,6 +46,193 @@ export interface UserOrganizationDto {
     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 interface CreateIssueCommentDto {
+    bodyMarkdown: string;
+    parentCommentId?: number;
+}
+export interface CreateIssueRelationDto {
+    targetIssueId: number;
+    relationType: "blocks" | "blocked_by" | "related" | "duplicate_of";
+}
+export interface ContentEntryDto {
+    id: number;
+    organizationId: number;
+    projectId?: number | null;
+    parentId?: number | null;
+    title: string;
+    slug: string;
+    revision: string;
+    contentMarkdown: string;
+    position: number;
+    createdBy: number;
+    updatedBy: number;
+    updatedByDisplayName?: string | null;
+    updatedByPhotoUrl?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateContentEntryDto {
+    title: string;
+    contentMarkdown: string;
+    slug?: string;
+    projectId?: number;
+    parentId?: number;
+    position?: number;
+}
+export interface UpdateContentEntryDto {
+    title?: string;
+    contentMarkdown?: string;
+    slug?: string;
+    parentId?: number;
+    position?: number;
+    baseRevision?: string;
+}
 export type LoginRequest = LoginDto;
 export type LoginResponse = AuthResponseDto;
 export type RefreshTokenRequest = RefreshTokenDto;
@@ -74,6 +261,25 @@ export type GetMeResponse = {
 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 CreateIssueCommentRequest = CreateIssueCommentDto;
+export type CreateIssueCommentResponse = IssueDetailDto;
+export type CreateIssueRelationRequest = CreateIssueRelationDto;
+export type CreateIssueRelationResponse = IssueDetailDto;
+export type DeleteIssueResponse = void;
+export type ListProjectsResponse = unknown;
+export type ListContentResponse = Array<ContentEntryDto>;
+export type CreateContentRequest = CreateContentEntryDto;
+export type CreateContentResponse = ContentEntryDto;
+export type GetContentResponse = ContentEntryDto;
+export type UpdateContentRequest = UpdateContentEntryDto;
+export type UpdateContentResponse = ContentEntryDto;
+export type DeleteContentResponse = void;
 export declare class ReximoApiError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -106,6 +312,40 @@ export type LogoutOptions = {
     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 type ListContentOptions = AuthenticatedRequestOptions & {
+    scope?: string;
+    projectId?: number;
+    parentId?: number;
+    slug?: string;
+};
 export declare class ReximoApiClient {
     private readonly baseUrl;
     private readonly fetchFn;
@@ -115,4 +355,17 @@ export declare class ReximoApiClient {
     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>;
+    createIssueComment(issueId: string, body: CreateIssueCommentRequest, options: AuthenticatedRequestOptions): Promise<CreateIssueCommentResponse>;
+    createIssueRelation(issueId: string, body: CreateIssueRelationRequest, options: AuthenticatedRequestOptions): Promise<CreateIssueRelationResponse>;
+    deleteIssue(issueId: string, options: AuthenticatedRequestOptions): Promise<void>;
+    listProjects(options: ListProjectsOptions): Promise<ListProjectsResponse>;
+    listContent(options: ListContentOptions): Promise<ListContentResponse>;
+    createContent(body: CreateContentRequest, options: AuthenticatedRequestOptions): Promise<CreateContentResponse>;
+    getContent(contentId: string, options: AuthenticatedRequestOptions): Promise<GetContentResponse>;
+    updateContent(contentId: string, body: UpdateContentRequest, options: AuthenticatedRequestOptions): Promise<UpdateContentResponse>;
+    deleteContent(contentId: string, options: AuthenticatedRequestOptions): Promise<void>;
 }