@shzlwio/windrunner-cli 1.0.0 → 1.1.0

package/dist/index.js

@@ -54,6 +54,22 @@ function queryString(parameters) {
 function collectOption(value, previous = []) {
     return [...previous, value];
 }
+function collectRequiredOption(values, optionName) {
+    if (!values || values.length === 0) {
+        throw new CliError(`At least one ${optionName} is required.`);
+    }
+    return values.map((value) => requireText(value, `--${optionName}`));
+}
+function parseEntityReference(value, optionName) {
+    const separator = value.indexOf(":");
+    if (separator <= 0 || separator === value.length - 1) {
+        throw new CliError(`Invalid ${optionName} '${value}'. Use TYPE:<id>.`);
+    }
+    return {
+        entityType: requireText(value.slice(0, separator), `--${optionName}`).toUpperCase(),
+        entityId: requireText(value.slice(separator + 1), `--${optionName}`),
+    };
+}
 function parseAssignees(values) {
     if (values === undefined)
         return undefined;
@@ -132,6 +148,11 @@ function addPagination(command) {
         .option("--size <number>", "Items per page; the server caps this at 100", "50")
         .option("--updated-after <timestamp>", "Only return records updated after an ISO-8601 timestamp (UTC recommended)");
 }
+function addPageOptions(command, defaultSize = "50") {
+    return command
+        .option("--page <number>", "Page number (zero-based)", "0")
+        .option("--size <number>", "Items per page; the server caps this at 100", defaultSize);
+}
 const sharedHelp = `
 Environment:
   WINDRUNNER_URL       Server URL (default: http://localhost:8080)
@@ -155,7 +176,7 @@ const program = new Command();
 program
     .name("windrunner")
     .description("Command-line interface for Windrunner")
-    .version("0.1.0")
+    .version("1.1.0")
     .option("--url <url>", "Windrunner server URL", process.env.WINDRUNNER_URL || "http://localhost:8080")
     .option("--json", "Print compact JSON output")
     .option("--dry-run", "Preview mutations without sending them")
@@ -167,7 +188,7 @@ addAgentHelp(program, `Quick start:
 
 Use '<command> --help' for command-specific arguments and examples.`);
 const projects = program.command("projects").description("Manage projects");
-addAgentHelp(projects, "Permissions: projects:read for both project commands.");
+addAgentHelp(projects, "Use command-specific help for the required API-key scope.");
 addAgentHelp(projects
     .command("list")
     .description("List projects visible to the API key")
@@ -195,6 +216,173 @@ Example:
     const client = new WindrunnerClient(globalOptions);
     printResponse(await client.get(`/projects/${encode(projectId)}`), globalOptions);
 });
+addAgentHelp(projects
+    .command("create")
+    .description("Create a project")
+    .requiredOption("--name <name>", "Project name")
+    .option("--owner-user <userId>", "Project owner user id; repeat for multiple owners", collectOption)
+    .option("--owner-team <teamId>", "Project owner team id; repeat for multiple owners", collectOption), `Permissions: projects:write
+At least one --owner-user or --owner-team is required.
+
+Examples:
+  windrunner projects create --name "Platform work" --owner-user user-1
+  windrunner projects create --name "Shared work" --owner-team team-1 --dry-run --json`).action(async (options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const ownerUserIds = options.ownerUser?.map((value) => requireText(value, "--owner-user")) ?? [];
+    const ownerTeamIds = options.ownerTeam?.map((value) => requireText(value, "--owner-team")) ?? [];
+    if (ownerUserIds.length === 0 && ownerTeamIds.length === 0) {
+        throw new CliError("At least one --owner-user or --owner-team is required.");
+    }
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.post("/projects", {
+        name: requireText(options.name, "--name"),
+        ownerUserIds,
+        ownerTeamIds,
+    }), globalOptions);
+});
+addAgentHelp(projects
+    .command("update")
+    .description("Update a project")
+    .argument("<projectId>", "Project id")
+    .requiredOption("--name <name>", "Project name"), `Permissions: projects:write
+
+Example:
+  windrunner projects update PROJECT_ID --name "Updated project"`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.put(`/projects/${encode(projectId)}`, {
+        name: requireText(options.name, "--name"),
+    }), globalOptions);
+});
+addAgentHelp(projects
+    .command("delete")
+    .description("Delete a project and all of its content")
+    .argument("<projectId>", "Project id"), `Permissions: projects:write
+This permanently deletes the project, work items, entries, relationships, and access links.
+Use --dry-run to preview the request. Use --yes only when deletion is explicitly intended.
+
+Example:
+  windrunner projects delete PROJECT_ID --yes`).action(async (projectId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Delete project ${projectId}? This cannot be undone.`, globalOptions);
+    }
+    printResponse(await client.delete(`/projects/${encode(projectId)}`), globalOptions);
+});
+const projectMembers = projects.command("members").description("Manage project user access");
+addAgentHelp(projectMembers, "Project membership changes require project owner access.");
+addAgentHelp(addPageOptions(projectMembers
+    .command("list")
+    .description("List users with access to a project")
+    .argument("<projectId>", "Project id")), `Permissions: project_access:read
+
+Example:
+  windrunner projects members list PROJECT_ID --json`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/projects/${encode(projectId)}/members${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
+addAgentHelp(projectMembers
+    .command("add")
+    .description("Add or update a project user")
+    .argument("<projectId>", "Project id")
+    .requiredOption("--user-id <userId>", "User id")
+    .option("--role <role>", "Project role: OWNER, EDITOR, or VIEWER", "VIEWER"), `Permissions: project_access:write
+
+Example:
+  windrunner projects members add PROJECT_ID --user-id USER_ID --role EDITOR`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.post(`/projects/${encode(projectId)}/members`, {
+        userId: requireText(options.userId, "--user-id"),
+        role: options.role,
+    }), globalOptions);
+});
+addAgentHelp(projectMembers
+    .command("remove")
+    .description("Remove a user from a project")
+    .argument("<projectId>", "Project id")
+    .argument("<userId>", "User id"), `Permissions: project_access:write
+
+Example:
+  windrunner projects members remove PROJECT_ID USER_ID --yes`).action(async (projectId, userId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Remove user ${userId} from project ${projectId}?`, globalOptions);
+    }
+    printResponse(await client.delete(`/projects/${encode(projectId)}/members/${encode(userId)}`), globalOptions);
+});
+const projectTeams = projects.command("teams").description("Manage project team access");
+addAgentHelp(projectTeams, "Project team links require project owner access.");
+addAgentHelp(addPageOptions(projectTeams
+    .command("list")
+    .description("List teams linked to a project")
+    .argument("<projectId>", "Project id")), `Permissions: project_access:read
+
+Example:
+  windrunner projects teams list PROJECT_ID --json`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/projects/${encode(projectId)}/teams${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
+addAgentHelp(projectTeams
+    .command("add")
+    .description("Add or update a project team")
+    .argument("<projectId>", "Project id")
+    .requiredOption("--team-id <teamId>", "Team id")
+    .option("--role <role>", "Project role: OWNER, EDITOR, or VIEWER", "VIEWER"), `Permissions: project_access:write
+
+Example:
+  windrunner projects teams add PROJECT_ID --team-id TEAM_ID --role EDITOR`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.post(`/projects/${encode(projectId)}/teams`, {
+        teamId: requireText(options.teamId, "--team-id"),
+        role: options.role,
+    }), globalOptions);
+});
+addAgentHelp(projectTeams
+    .command("remove")
+    .description("Unlink a team from a project")
+    .argument("<projectId>", "Project id")
+    .argument("<teamId>", "Team id"), `Permissions: project_access:write
+
+Example:
+  windrunner projects teams remove PROJECT_ID TEAM_ID --yes`).action(async (projectId, teamId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Unlink team ${teamId} from project ${projectId}?`, globalOptions);
+    }
+    printResponse(await client.delete(`/projects/${encode(projectId)}/teams/${encode(teamId)}`), globalOptions);
+});
+addAgentHelp(projects
+    .command("reorder")
+    .description("Reorder work items and entries in a project content stream")
+    .argument("<projectId>", "Project id")
+    .requiredOption("--item <type:id>", "Ordered item in WORK_ITEM:<id> or ENTRY:<id> format", collectOption)
+    .option("--parent-id <workItemId>", "Parent work item id; omit for the project root"), `Permissions: work_items:write and entries:write
+Repeat --item in the desired order.
+
+Example:
+  windrunner projects reorder PROJECT_ID \\
+    --item WORK_ITEM:item-1 --item ENTRY:entry-1 --item WORK_ITEM:item-2`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    const items = options.item.map((value) => parseEntityReference(value, "item"));
+    printResponse(await client.put(`/projects/${encode(projectId)}/content-order`, {
+        ...(options.parentId === undefined ? {} : { parentWorkItemId: options.parentId }),
+        items,
+    }), globalOptions);
+});
 const workItems = program.command("work-items").description("Manage work items");
 addAgentHelp(workItems, "Use --json for machine-readable results. Work item type and status values are validated by the server.");
 addAgentHelp(addPagination(workItems
@@ -309,6 +497,26 @@ Examples:
     }
     printResponse(await client.delete(`/work-items/${encode(workItemId)}`), globalOptions);
 });
+addAgentHelp(workItems
+    .command("move")
+    .description("Move a work item to a different content position")
+    .argument("<workItemId>", "Work item id")
+    .option("--parent-id <workItemId>", "Destination parent work item id; omit for the project root")
+    .option("--before <type:id>", "Place before WORK_ITEM:<id> or ENTRY:<id> in the destination stream"), `Permissions: work_items:write
+
+Examples:
+  windrunner work-items move WORK_ITEM_ID --parent-id PARENT_ID
+  windrunner work-items move WORK_ITEM_ID --before ENTRY:entry-1`).action(async (workItemId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    const before = options.before === undefined ? undefined : parseEntityReference(options.before, "before");
+    printResponse(await client.put(`/work-items/${encode(workItemId)}/move`, {
+        ...(options.parentId === undefined ? {} : { parentWorkItemId: options.parentId }),
+        ...(before === undefined
+            ? {}
+            : { beforeEntityType: before.entityType, beforeEntityId: before.entityId }),
+    }), globalOptions);
+});
 const entries = program.command("entries").description("Manage entries");
 addAgentHelp(entries, "Entries are attached to work items. Use --json for machine-readable results.");
 addAgentHelp(addPagination(entries
@@ -347,12 +555,56 @@ Examples:
     };
     printResponse(await client.post(`/work-items/${encode(workItemId)}/entries`, body), globalOptions);
 });
+addAgentHelp(entries
+    .command("get")
+    .description("Get an entry")
+    .argument("<entryId>", "Entry id"), `Permissions: entries:read
+
+Example:
+  windrunner entries get ENTRY_ID --json`).action(async (entryId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/entries/${encode(entryId)}`), globalOptions);
+});
+addAgentHelp(entries
+    .command("update")
+    .description("Update an entry")
+    .argument("<entryId>", "Entry id")
+    .requiredOption("--body <body>", "Entry body")
+    .option("--type <type>", "Entry type; defaults to COMMENT when omitted"), `Permissions: entries:write
+Required: --body. The API treats an omitted type as COMMENT.
+
+Example:
+  windrunner entries update ENTRY_ID --body "Updated context" --type EVIDENCE`).action(async (entryId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.put(`/entries/${encode(entryId)}`, {
+        body: requireText(options.body, "--body"),
+        ...(options.type === undefined ? {} : { type: options.type }),
+    }), globalOptions);
+});
+addAgentHelp(entries
+    .command("delete")
+    .description("Delete an entry")
+    .argument("<entryId>", "Entry id"), `Permissions: entries:write
+This permanently deletes the entry and its relationships.
+Use --dry-run to preview the request.
+
+Example:
+  windrunner entries delete ENTRY_ID --yes`).action(async (entryId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Delete entry ${entryId}? This cannot be undone.`, globalOptions);
+    }
+    printResponse(await client.delete(`/entries/${encode(entryId)}`), globalOptions);
+});
 addAgentHelp(program
     .command("search")
     .description("Search project work items, entries, and relationships")
     .argument("<projectId>", "Project id")
     .argument("<query>", "Search query")
-    .option("--limit <number>", "Maximum number of matches"), `Permissions: work_items:read
+    .option("--limit <number>", "Maximum number of matches"), `Permissions: work_items:read, entries:read, and relationships:read
 
 Example:
   windrunner search PROJECT_ID "login failure" --limit 20 --json`)
@@ -362,6 +614,264 @@ Example:
     const limit = numberValue(options.limit, "limit");
     printResponse(await client.get(`/projects/${encode(projectId)}/search${queryString({ q: query, limit })}`), globalOptions);
 });
+const relationships = program.command("relationships").description("Manage work item relationships");
+addAgentHelp(relationships, "Relationships connect work items and entries with a type and optional reason.");
+addAgentHelp(addPageOptions(relationships
+    .command("list")
+    .description("List relationships in a project")
+    .argument("<projectId>", "Project id")
+    .option("--type <type>", "Filter by relationship type")
+    .option("--created-after <timestamp>", "Only return relationships created after an ISO-8601 timestamp")), `Permissions: relationships:read
+
+Example:
+  windrunner relationships list PROJECT_ID --type BLOCKED_BY --json`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/projects/${encode(projectId)}/relationships${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+        type: options.type,
+        created_after: options.createdAfter,
+    })}`), globalOptions);
+});
+addAgentHelp(relationships
+    .command("create")
+    .description("Create a relationship")
+    .argument("<projectId>", "Project id")
+    .requiredOption("--from <type:id>", "Source entity in WORK_ITEM:<id> or ENTRY:<id> format")
+    .requiredOption("--to <type:id>", "Target entity in WORK_ITEM:<id> or ENTRY:<id> format")
+    .requiredOption("--type <type>", "Relationship type")
+    .option("--reason <reason>", "Relationship reason")
+    .option("--source-entry-id <entryId>", "Entry supporting the relationship"), `Permissions: relationships:write
+
+Example:
+  windrunner relationships create PROJECT_ID \\
+    --from WORK_ITEM:item-1 --to WORK_ITEM:item-2 --type BLOCKED_BY \\
+    --reason "Waiting on the database migration"`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    const from = parseEntityReference(options.from, "from");
+    const to = parseEntityReference(options.to, "to");
+    printResponse(await client.post(`/projects/${encode(projectId)}/relationships`, {
+        fromEntityType: from.entityType,
+        fromEntityId: from.entityId,
+        toEntityType: to.entityType,
+        toEntityId: to.entityId,
+        type: requireText(options.type, "--type"),
+        ...(options.reason === undefined ? {} : { reason: options.reason }),
+        ...(options.sourceEntryId === undefined ? {} : { sourceEntryId: options.sourceEntryId }),
+    }), globalOptions);
+});
+addAgentHelp(relationships
+    .command("update-reason")
+    .description("Update or clear a relationship reason")
+    .argument("<relationshipId>", "Relationship id")
+    .option("--reason <reason>", "New reason; omit to clear the reason"), `Permissions: relationships:write
+
+Examples:
+  windrunner relationships update-reason RELATIONSHIP_ID --reason "New explanation"
+  windrunner relationships update-reason RELATIONSHIP_ID --dry-run`).action(async (relationshipId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.put(`/relationships/${encode(relationshipId)}/reason`, {
+        reason: options.reason ?? null,
+    }), globalOptions);
+});
+addAgentHelp(relationships
+    .command("delete")
+    .description("Delete a relationship")
+    .argument("<relationshipId>", "Relationship id"), `Permissions: relationships:write
+Use --dry-run to preview the request.
+
+Example:
+  windrunner relationships delete RELATIONSHIP_ID --yes`).action(async (relationshipId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Delete relationship ${relationshipId}? This cannot be undone.`, globalOptions);
+    }
+    printResponse(await client.delete(`/relationships/${encode(relationshipId)}`), globalOptions);
+});
+const teams = program.command("teams").description("Manage teams");
+addAgentHelp(teams, "Team creation, updates, deletion, and membership changes require an admin-like API-key owner.");
+addAgentHelp(addPageOptions(teams
+    .command("list")
+    .description("List teams")), `Permissions: teams:read
+
+Example:
+  windrunner teams list --json`).action(async (options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/teams${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
+addAgentHelp(teams
+    .command("get")
+    .description("Get a team")
+    .argument("<teamId>", "Team id"), `Permissions: teams:read
+
+Example:
+  windrunner teams get TEAM_ID --json`).action(async (teamId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/teams/${encode(teamId)}`), globalOptions);
+});
+addAgentHelp(teams
+    .command("create")
+    .description("Create a team")
+    .requiredOption("--name <name>", "Team name")
+    .requiredOption("--owner-user <userId>", "Team owner user id; repeat for multiple owners", collectOption)
+    .option("--description <description>", "Team description"), `Permissions: teams:write
+At least one --owner-user is required.
+
+Example:
+  windrunner teams create --name "Platform" --owner-user user-1 --description "Platform team"`).action(async (options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.post("/teams", {
+        name: requireText(options.name, "--name"),
+        ownerUserIds: collectRequiredOption(options.ownerUser, "--owner-user"),
+        ...(options.description === undefined ? {} : { description: options.description }),
+    }), globalOptions);
+});
+addAgentHelp(teams
+    .command("update")
+    .description("Update a team")
+    .argument("<teamId>", "Team id")
+    .requiredOption("--name <name>", "Team name")
+    .requiredOption("--description <description>", "Team description; use an empty value to clear it"), `Permissions: teams:write
+Both fields are required because the API accepts a full team representation.
+
+Example:
+  windrunner teams update TEAM_ID --name "Platform engineering" --description "Owns platform services"`).action(async (teamId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.put(`/teams/${encode(teamId)}`, {
+        name: requireText(options.name, "--name"),
+        description: options.description,
+    }), globalOptions);
+});
+addAgentHelp(teams
+    .command("delete")
+    .description("Delete a team")
+    .argument("<teamId>", "Team id"), `Permissions: teams:write
+This permanently deletes the team and removes its memberships and project links.
+Use --dry-run to preview the request.
+
+Example:
+  windrunner teams delete TEAM_ID --yes`).action(async (teamId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Delete team ${teamId}? This cannot be undone.`, globalOptions);
+    }
+    printResponse(await client.delete(`/teams/${encode(teamId)}`), globalOptions);
+});
+const teamMembers = teams.command("members").description("Manage team membership");
+addAgentHelp(teamMembers, "Team membership changes require an admin-like API-key owner.");
+addAgentHelp(addPageOptions(teamMembers
+    .command("list")
+    .description("List team members")
+    .argument("<teamId>", "Team id")), `Permissions: team_members:read
+
+Example:
+  windrunner teams members list TEAM_ID --json`).action(async (teamId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/teams/${encode(teamId)}/members${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
+addAgentHelp(teamMembers
+    .command("add")
+    .description("Add a user to a team")
+    .argument("<teamId>", "Team id")
+    .requiredOption("--user-id <userId>", "User id")
+    .option("--role <role>", "Team role: TEAM_OWNER or TEAM_MEMBER", "TEAM_MEMBER"), `Permissions: team_members:write
+
+Example:
+  windrunner teams members add TEAM_ID --user-id USER_ID --role TEAM_MEMBER`).action(async (teamId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.post(`/teams/${encode(teamId)}/members`, {
+        userId: requireText(options.userId, "--user-id"),
+        role: options.role,
+    }), globalOptions);
+});
+addAgentHelp(teamMembers
+    .command("remove")
+    .description("Remove a user from a team")
+    .argument("<teamId>", "Team id")
+    .argument("<userId>", "User id"), `Permissions: team_members:write
+
+Example:
+  windrunner teams members remove TEAM_ID USER_ID --yes`).action(async (teamId, userId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    if (!globalOptions.dryRun) {
+        await confirmDelete(`Remove user ${userId} from team ${teamId}?`, globalOptions);
+    }
+    printResponse(await client.delete(`/teams/${encode(teamId)}/members/${encode(userId)}`), globalOptions);
+});
+addAgentHelp(addPageOptions(teams
+    .command("projects")
+    .description("List projects linked to a team")
+    .argument("<teamId>", "Team id")), `Permissions: team_projects:read
+
+Example:
+  windrunner teams projects TEAM_ID --json`).action(async (teamId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/teams/${encode(teamId)}/projects${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
+const users = program.command("users").description("Resolve users");
+addAgentHelp(users, "Only limited identity fields are returned by the external API.");
+addAgentHelp(users
+    .command("get")
+    .description("Get limited user identity information")
+    .argument("<userId>", "User id"), `Permissions: users:read
+
+Example:
+  windrunner users get USER_ID --json`).action(async (userId, _options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/users/${encode(userId)}`), globalOptions);
+});
+const auditLogs = program.command("audit-logs").description("Read audit logs");
+addAgentHelp(auditLogs, "Audit log access requires an administrator or superadministrator API-key owner.");
+addAgentHelp(addPageOptions(auditLogs
+    .command("list")
+    .description("List platform audit logs"), "20"), `Permissions: audit_logs:read
+
+Example:
+  windrunner audit-logs list --json`).action(async (options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/audit-logs${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
+addAgentHelp(addPageOptions(auditLogs
+    .command("project")
+    .description("List audit logs for a project")
+    .argument("<projectId>", "Project id"), "20"), `Permissions: audit_logs:read
+
+Example:
+  windrunner audit-logs project PROJECT_ID --json`).action(async (projectId, options, command) => {
+    const globalOptions = getGlobalOptions(command);
+    const client = new WindrunnerClient(globalOptions);
+    printResponse(await client.get(`/projects/${encode(projectId)}/audit-logs${queryString({
+        page: numberValue(options.page, "page"),
+        size: numberValue(options.size, "size"),
+    })}`), globalOptions);
+});
 try {
     await program.parseAsync(process.argv);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shzlwio/windrunner-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Command-line interface for Windrunner.",
   "type": "module",
   "publishConfig": {