Skip to content

new tools and prompts restucture - #14

Merged
AbdallahAHO merged 6 commits into
developfrom
feature/user-groups-tools
Aug 11, 2025
Merged

new tools and prompts restucture#14
AbdallahAHO merged 6 commits into
developfrom
feature/user-groups-tools

Conversation

@AbdallahAHO

Copy link
Copy Markdown
Owner

This pull request introduces a new "queuedprocesses" domain to monitor asynchronous operations in Lokalise, including CLI, controller, formatter, resource, and types integration. It also enhances the keys domain by adding support for filtering keys by filename. The most important changes are grouped below.

Queuedprocesses Domain Implementation

  • Added the full "queuedprocesses" domain, including CLI commands (list-queuedprocessess, get-queuedprocesses), controller logic, rich Markdown formatter for process details and lists, and MCP resource registration for project-level async process monitoring. [1] [2] [3] [4] [5]

Keys Domain Enhancements

  • Added support for filtering keys by specific filenames in the keys API, including updates to types, service parameters, controller logic, and request handling. [1] [2] [3] [4]

Code Quality and Import Order

  • Improved import order in several files for consistency and clarity. [1] [2]

Adjust export statements in the transport module to maintain consistent ordering and grouping.

Also tidy up import order in several modules for improved readability and alphabetical consistency,
such as reordering imports in the contributors service and keys controller.

These changes focus on code style and maintainability without affecting runtime behavior.
Implement full user groups management including CLI commands, MCP tools,
and MCP resources to enable listing, retrieving, creating, updating, deleting,
and managing members and projects within user groups.

- Introduce domain exports and types with comprehensive Zod validation schemas
- Add controller layer handling input validation, error processing, and formatting
- Build service layer interfacing with Lokalise User Groups API for actual data operations
- Create detailed Markdown formatters for human-readable output of API responses
- Provide CLI commands for seamless command-line interaction and automation
- Register MCP tools exposing user group operations to the MCP server
- Register MCP resources enabling resource-based access to user groups via URI schemes

This modular setup establishes a robust user groups domain supporting team-based
permission management and integration with Lokalise platform workflows.
… and MCP tools

Introduce a new domain for managing Lokalise team users including:
- CLI commands for listing, retrieving, updating, and deleting team users.
- Controller layer with validation and error handling.
- Service layer integrating Lokalise API for team user operations.
- Formatting of responses into readable markdown.
- MCP resource and tool registration supporting API and interactive usage.

Establishes a foundation for consistent and extensible team user management within the system.
Introduce a new queuedprocesses domain to support tracking and managing
background asynchronous processes within Lokalise projects. This includes:

- CLI commands for listing and retrieving queued process details with validation
- Controller layer for input validation, error handling, and response formatting
- Rich Markdown formatters presenting process status, details, and summaries
- Service layer encapsulating API communication with Lokalise SDK
- MCP resources enabling resource-based access to queued processes data
- Tools integration for MCP server with typed argument schemas and error handling
- Comprehensive TypeScript types and guards aligned with Lokalise SDK v9.0.0+

This domain provides a structured and user-friendly way to monitor various
async tasks such as file uploads, downloads, project imports/exports,
improving observability and operational control.

Closes #N/A
…chemas

Rebuilds the MCP prompt registration to provide comprehensive, structured
workflows for Lokalise operations using explicit, XML-like instructions
aligned with Claude 4 best practices.

- Replaces previous prompts with extensively detailed prompts covering
  project management, language localization, key management, tasks, workflows,
  team collaboration, compliance, and advanced workflows.
- Introduces strict Zod schemas defining argument validation and user-friendly
  parameter naming to improve usability and robustness.
- Enhances prompt guidance with stepwise instructions, context, and output
  formats to standardize responses and improve clarity.
- Enables parallel execution hints and comprehensive analysis steps for
  efficiency and thorough reporting.
- Adds new complex workflows including file upload review, team onboarding,
  automated review pipelines, process monitoring, and translation memory import.

This refactor significantly improves maintainability, clarity, and feature
coverage of prompts, setting a foundation for scalable, user-friendly
automation workflows within the MCP environment.
…reviews

Introduce two new review workflows to improve translation task management:

- Add post-upload review workflow enabling creation of language-specific
  review tasks for files already uploaded to the platform with flexible
  assignee mapping and optional confirmation prior to task creation.
- Add document extraction review workflow that parses raw document content
  into translation keys, creates them in bulk, and sets up translation
  tasks with language-based assignee assignments.

Additionally, enhance key listing functionality by supporting filename-based
filtering to precisely select keys associated with specific files, improving
task scope accuracy.

These additions streamline review and translation setup processes for files
and document content, reducing manual overhead and enhancing assignment
flexibility.
@AbdallahAHO
AbdallahAHO merged commit 8bbade5 into develop Aug 11, 2025
7 checks passed
@AbdallahAHO
AbdallahAHO deleted the feature/user-groups-tools branch August 11, 2025 12:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant