@platless/axom-cli 0.1.0 → 0.3.13

package/skills/axom/SKILL.md

@@ -1,31 +1,31 @@
 ---
 name: axom
-description: "Work with Axomwork applications: inspect structures, query and mutate records, execute operations and services via Axomwork MCP tools"
+description: "Work with Axomwork applications: inspect structures, query and mutate records, execute operations and services, manage projects and tasks, and read or update your own account via Axomwork MCP tools"
 ---
 
 # Axomwork
 
-Use this skill when an Axomwork MCP server is connected and you need to inspect application structure, read or change business records, or execute model operations and services.
+Use this skill when an Axomwork MCP server is connected and you need to inspect application structure, read or change business records, execute model operations and services, manage projects and tasks, or read or update your own account.
 
 ## Workflow
 
-Start by discovering structure before changing records. Use `axom__struct__list_applications()` to find applications, then `axom__struct__get_model({ applicationName, modelName })` to inspect fields, operations, and record shape. Only then query, create, update, delete, upsert, or execute.
+Start by discovering structure before changing records. Use `axom__app_struct__list_applications()` to find applications, then `axom__app_struct__get_model({ applicationName, modelName })` to inspect fields, operations, and record shape. Only then query, create, update, delete, upsert, or execute.
 
 ## Core Tools
 
 - `axom__system__whoami()` - returns the current authenticated user and role.
-- `axom__struct__list_applications()` - lists available applications.
-- `axom__struct__get_application({ applicationName })` - reads one application definition.
-- `axom__struct__list_models({ applicationName })` - lists models in an application.
-- `axom__struct__get_model({ applicationName, modelName })` - reads one model definition, including attributes and operations.
-- `axom__record__query({ applicationName, modelName, criteria?, page? })` - queries records using REST-compatible filters and sorts in `criteria`.
-- `axom__record__get({ applicationName, modelName, id })` - reads one record by id.
-- `axom__record__create({ applicationName, modelName, record })` - creates a record; `record` contains model field values.
-- `axom__record__update({ applicationName, modelName, id, changes })` - updates one record; `changes` contains only the fields to modify.
-- `axom__record__upsert({ applicationName, modelName, identityField, record })` - creates or updates a record matched by `identityField`; `record` must include that field. The model must declare a `unique` validation on `identityField`, or the call throws — check `get_model` for that before calling upsert on an unfamiliar model.
-- `axom__record__delete({ applicationName, modelName, id })` - deletes one record by id.
-- `axom__operation__execute({ applicationName, modelName, operationName, input })` - executes a model operation and waits for the result. Use `axom__operation__execute_async` with the same arguments when asynchronous continuation is intended; it returns a running status and a child run id.
-- `axom__service__execute({ applicationName?, serviceName, input })` - executes a reusable platform or application-scoped service, with `axom__service__execute_async` as its non-waiting counterpart.
+- `axom__app_struct__list_applications()` - lists available applications.
+- `axom__app_struct__get_application({ applicationName })` - reads one application definition.
+- `axom__app_struct__list_models({ applicationName })` - lists models in an application.
+- `axom__app_struct__get_model({ applicationName, modelName })` - reads one model definition, including attributes and operations.
+- `axom__record_query__query_records({ applicationName, modelName, criteria?, page? })` - queries records using REST-compatible filters and sorts in `criteria`.
+- `axom__record_query__get_record({ applicationName, modelName, id })` - reads one record by id.
+- `axom__record_write__create_record({ applicationName, modelName, record })` - creates a record; `record` contains model field values.
+- `axom__record_write__update_record({ applicationName, modelName, id, changes })` - updates one record; `changes` contains only the fields to modify.
+- `axom__record_write__upsert_record({ applicationName, modelName, identityField, record })` - creates or updates a record matched by `identityField`; `record` must include that field. The model must declare a `unique` validation on `identityField`, or the call throws — check `get_model` for that before calling upsert on an unfamiliar model.
+- `axom__record_write__delete_record({ applicationName, modelName, id })` - deletes one record by id.
+- `axom__execute__run_operation({ applicationName, modelName, operationName, input })` - executes a model operation and waits for the result. Use `axom__execute__run_operation_async` with the same arguments when asynchronous continuation is intended; it returns a running status and a child run id.
+- `axom__execute__run_service({ applicationName?, serviceName, input })` - executes a reusable platform or application-scoped service, with `axom__execute__run_service_async` as its non-waiting counterpart.
 
 ## Query Criteria
 
@@ -50,7 +50,7 @@ Filter `op` values are `eq|gt|lt|like|in|and|or`. Use nested `filters` for `and`
 
 ## Upserting a Record
 
-Use `axom__record__upsert` when a stable external identifier should select an existing record or create a new one. Supply the canonical fields in this order, and include the identity value inside `record`:
+Use `axom__record_write__upsert_record` when a stable external identifier should select an existing record or create a new one. Supply the canonical fields in this order, and include the identity value inside `record`:
 For create/update/upsert safety, load guide
 `agent-integration/operating-patterns/safe-record-mutations.md`; before deletion, load
 `agent-integration/operating-patterns/destructive-actions.md`.
@@ -69,11 +69,49 @@ For create/update/upsert safety, load guide
 
 ## Execution Results
 
-`axom__operation__execute` and `axom__service__execute` return an OperationResult-style payload. Interpret `success` as the primary outcome, `text` as user-facing output, `data` as structured result data, `message` as diagnostic detail, `processing` as whether work continues asynchronously, and `runId` as the related run identifier when one is started.
+`axom__execute__run_operation` and `axom__execute__run_service` return an OperationResult-style payload. Interpret `success` as the primary outcome, `text` as user-facing output, `data` as structured result data, `message` as diagnostic detail, `processing` as whether work continues asynchronously, and `runId` as the related run identifier when one is started.
 For asynchronous continuation, load guides
 `concepts/execution/synchronous-and-task-execution.md` and
 `agent-integration/operating-patterns/following-runs.md`.
 
+## Tasks
+
+Requires the `task` scope. The acting user is always the authenticated account; never pass a user id to act as someone else.
+
+- `axom__task__list_projects({ limit?, offset? })` - lists projects you can see.
+- `axom__task__get_project({ projectId })` - reads one project.
+- `axom__task__create_project({ name, description?, prompts? })` - creates a project owned by you; `prompts` is `[{ type, content }]` with `type` one of `brainstorm`, `execute`, `validate`, `archive` (at most one each).
+- `axom__task__update_project({ projectId, name, description?, prompts? })` - renames or re-describes a project; other project settings are kept, and so are its prompts unless you pass `prompts`, which replaces them all.
+- `axom__task__delete_project({ projectId })` - deletes a project. Confirm with the user first.
+- `axom__task__list_project_members({ projectId })` - lists members and their roles.
+- `axom__task__add_project_member({ projectId, userId, type })` - adds a member; `type` is `owner` or `member`.
+- `axom__task__update_project_member({ projectId, userId, type })` - changes a member's role.
+- `axom__task__remove_project_member({ projectId, userId })` - removes a member.
+- `axom__task__list_tasks({ projectId?, parentTaskId?, status?, assigneeId?, limit?, offset? })` - lists tasks by filter.
+- `axom__task__get_task({ taskId })` - reads one task.
+- `axom__task__create_task({ projectId?, parentTaskId?, title, proposal?, status?, assigneeId? })` - creates a task; `proposal` is Markdown.
+- `axom__task__update_task({ taskId, projectId?, parentTaskId?, title, proposal?, status, assigneeId? })` - replaces a task's fields; read it first and send every field you want to keep.
+- `axom__task__delete_task({ taskId })` - deletes a task. Confirm with the user first.
+- `axom__task__list_artifacts({ taskId, kind?, status?, limit?, offset? })` - lists one page (at most 50) of a task's artifacts (insights, decisions, specs, plans), newest first, without content; `summary` is a 100-character preview. Continue with `offset: nextOffset` until `nextOffset` is null.
+- `axom__task__get_artifact({ artifactId, offset?, length? })` - reads one artifact; long content comes in windows of at most 12000 characters, continue from `nextContentOffset`.
+- `axom__task__search_artifacts({ query, taskId?, projectId?, scope?, limit? })` - searches one task's artifacts (`scope: task`) or every task in a project (`scope: project`); without `scope`, passing only `projectId` searches the project, otherwise the task.
+- `axom__task__create_artifact({ taskId, kind, title, summary, content, status? })` - records an artifact; a `final` `plan` moves a `brainstorming` task to `planned`.
+- `axom__task__update_artifact({ artifactId, kind?, title?, summary?, content?, status? })` - changes only the fields you pass.
+- `axom__task__delete_artifact({ artifactId })` - deletes an artifact; the task's status does not change. Confirm with the user first.
+- `axom__task__import_artifact({ taskId, path, kind, title, summary, status? })` - imports a Markdown file from the task's worktree (`path` is relative to it); importing the same path again updates the same artifact.
+- `axom__task__list_agent_members({ taskId })` - lists the task's live agent team.
+- `axom__task__execute_plan({ taskId })` - starts a `planned` task (`planned` becomes `in_progress`).
+
+## Your account
+
+Requires the `setting_user` scope. These tools only ever act on the authenticated user. Passwords, sessions, and access tokens are deliberately not available over MCP; manage them in Settings → Security.
+
+- `axom__setting_user__get_profile()` - gets the calling user's profile.
+- `axom__setting_user__update_profile({ displayName?, email? })` - replaces the calling user's display name and email; omitted or null fields are cleared.
+- `axom__setting_user__list_memories({ limit?, offset? })` - lists the calling user's memory facts (deleted ones excluded), newest first; `limit` defaults to 50.
+- `axom__setting_user__delete_memory({ factId })` - deletes one of the calling user's memory facts; another user's fact id answers not-found.
+- `axom__setting_user__list_workstations()` - lists the calling user's personal workstations and their status.
+
 ## Guide
 
 Axomwork ships an AI-first manual. Call `axom__guide__load` with no arguments for the table of

package/skills/axom-definition/SKILL.md

@@ -5,7 +5,7 @@ description: "Develop Axomwork application definitions with independently callab
 
 # Axomwork Definition
 
-Use this skill to edit application definitions with the canonical `axom__definition__*` MCP tools. These tools require an ADMIN token. Check `tools/list` for the specific tool before calling it.
+Use this skill to edit application definitions with the canonical `axom__app_studio__*` MCP tools. These tools require the `app_studio` scope and an administrator account. Check `tools/list` for the specific tool before calling it.
 
 Call each tool directly with camelCase arguments:
 
@@ -21,49 +21,49 @@ Load guides `agent-integration/operating-patterns/etag-write-workflow.md` and
 
 ## Applications
 
-- `axom__definition__list_applications`
-- `axom__definition__get_application` — `applicationName`
-- `axom__definition__create_application` — `application`, `expectedEtag`
-- `axom__definition__update_application` — `applicationName`, `application`, `expectedEtag`
-- `axom__definition__delete_application` — `applicationName`, `expectedEtag`
+- `axom__app_studio__list_applications`
+- `axom__app_studio__get_application` — `applicationName`
+- `axom__app_studio__create_application` — `application`, `expectedEtag`
+- `axom__app_studio__update_application` — `applicationName`, `application`, `expectedEtag`
+- `axom__app_studio__delete_application` — `applicationName`, `expectedEtag`
 
 ## Models
 
-- `axom__definition__list_models` — `applicationName`
-- `axom__definition__get_model` — `applicationName`, `modelName`
-- `axom__definition__create_model` — `applicationName`, `model`, `expectedEtag`
-- `axom__definition__update_model` — `applicationName`, `modelName`, `model`, `expectedEtag`
-- `axom__definition__delete_model` — `applicationName`, `modelName`, `expectedEtag`
+- `axom__app_studio__list_models` — `applicationName`
+- `axom__app_studio__get_model` — `applicationName`, `modelName`
+- `axom__app_studio__create_model` — `applicationName`, `model`, `expectedEtag`
+- `axom__app_studio__update_model` — `applicationName`, `modelName`, `model`, `expectedEtag`
+- `axom__app_studio__delete_model` — `applicationName`, `modelName`, `expectedEtag`
 
 ## Attributes and operations
 
-- `axom__definition__get_attribute` — `applicationName`, `modelName`, `attributeName`
-- `axom__definition__create_attribute` — `applicationName`, `modelName`, `attribute`, `expectedEtag`
-- `axom__definition__update_attribute` — `applicationName`, `modelName`, `attributeName`, `attribute`, `expectedEtag`
-- `axom__definition__delete_attribute` — `applicationName`, `modelName`, `attributeName`, `expectedEtag`
-- `axom__definition__get_operation` — `applicationName`, `modelName`, `operationName`
-- `axom__definition__create_operation` — `applicationName`, `modelName`, `operation`, `expectedEtag`
-- `axom__definition__update_operation` — `applicationName`, `modelName`, `operationName`, `operation`, `expectedEtag`
-- `axom__definition__delete_operation` — `applicationName`, `modelName`, `operationName`, `expectedEtag`
-- `axom__definition__get_operation_body` — `applicationName`, `modelName`, `operationName`
-- `axom__definition__update_operation_body` — `applicationName`, `modelName`, `operationName`, `content`, `expectedBodyEtag`
+- `axom__app_studio__get_attribute` — `applicationName`, `modelName`, `attributeName`
+- `axom__app_studio__create_attribute` — `applicationName`, `modelName`, `attribute`, `expectedEtag`
+- `axom__app_studio__update_attribute` — `applicationName`, `modelName`, `attributeName`, `attribute`, `expectedEtag`
+- `axom__app_studio__delete_attribute` — `applicationName`, `modelName`, `attributeName`, `expectedEtag`
+- `axom__app_studio__get_operation` — `applicationName`, `modelName`, `operationName`
+- `axom__app_studio__create_operation` — `applicationName`, `modelName`, `operation`, `expectedEtag`
+- `axom__app_studio__update_operation` — `applicationName`, `modelName`, `operationName`, `operation`, `expectedEtag`
+- `axom__app_studio__delete_operation` — `applicationName`, `modelName`, `operationName`, `expectedEtag`
+- `axom__app_studio__get_operation_body` — `applicationName`, `modelName`, `operationName`
+- `axom__app_studio__update_operation_body` — `applicationName`, `modelName`, `operationName`, `content`, `expectedBodyEtag`
 
 ## Triggers and lifecycle
 
-- `axom__definition__update_triggers` — `applicationName`, `modelName`, `triggers`, `expectedEtag`
-- `axom__definition__get_lifecycle` — `applicationName`, `modelName`
-- `axom__definition__update_lifecycle` — `applicationName`, `modelName`, `lifecycle`, `expectedEtag`
-- `axom__definition__delete_lifecycle` — `applicationName`, `modelName`, `expectedEtag`
+- `axom__app_studio__update_triggers` — `applicationName`, `modelName`, `triggers`, `expectedEtag`
+- `axom__app_studio__get_lifecycle` — `applicationName`, `modelName`
+- `axom__app_studio__update_lifecycle` — `applicationName`, `modelName`, `lifecycle`, `expectedEtag`
+- `axom__app_studio__delete_lifecycle` — `applicationName`, `modelName`, `expectedEtag`
 
 ## Workflows
 
-- `axom__definition__list_workflows` — `applicationName`, `modelName`
-- `axom__definition__get_workflow` — `applicationName`, `modelName`, `workflowName`
-- `axom__definition__create_workflow` — `applicationName`, `modelName`, `workflow`, `expectedEtag`
-- `axom__definition__update_workflow` — `applicationName`, `modelName`, `workflowName`, `workflow`, `expectedEtag`
-- `axom__definition__delete_workflow` — `applicationName`, `modelName`, `workflowName`, `expectedEtag`
-- `axom__definition__get_workflow_body` — `applicationName`, `modelName`, `workflowName`
-- `axom__definition__update_workflow_body` — `applicationName`, `modelName`, `workflowName`, `content`, `expectedBodyEtag`
+- `axom__app_studio__list_workflows` — `applicationName`, `modelName`
+- `axom__app_studio__get_workflow` — `applicationName`, `modelName`, `workflowName`
+- `axom__app_studio__create_workflow` — `applicationName`, `modelName`, `workflow`, `expectedEtag`
+- `axom__app_studio__update_workflow` — `applicationName`, `modelName`, `workflowName`, `workflow`, `expectedEtag`
+- `axom__app_studio__delete_workflow` — `applicationName`, `modelName`, `workflowName`, `expectedEtag`
+- `axom__app_studio__get_workflow_body` — `applicationName`, `modelName`, `workflowName`
+- `axom__app_studio__update_workflow_body` — `applicationName`, `modelName`, `workflowName`, `content`, `expectedBodyEtag`
 
 ## Guide
 

package/skills/axom-platform/SKILL.md

@@ -5,7 +5,7 @@ description: "Operate Axomwork platform configuration with independently callabl
 
 # Axomwork Platform
 
-Use the canonical `axom__platform__*` MCP tools (platform skills, AI configuration, cowork agents, data sources, and platform settings). These tools require an ADMIN token. Check `tools/list` for the specific tool before calling it.
+Use the canonical `axom__setting_platform__*` MCP tools (platform skills, AI configuration, cowork agents, data sources, and platform settings). These tools require the `setting_platform` scope and an administrator account. Check `tools/list` for the specific tool before calling it.
 
 Call each tool directly with camelCase arguments:
 
@@ -21,57 +21,57 @@ For the full concurrency workflow, load guide
 
 ## Platform skills
 
-- `axom__platform__list_skills`
-- `axom__platform__get_skill`
-- `axom__platform__create_skill`
-- `axom__platform__update_skill`
-- `axom__platform__delete_skill`
+- `axom__setting_platform__list_skills`
+- `axom__setting_platform__get_skill`
+- `axom__setting_platform__create_skill`
+- `axom__setting_platform__update_skill`
+- `axom__setting_platform__delete_skill`
 
 ## AI configuration
 
-- `axom__platform__get_ai_config`
-- `axom__platform__upsert_ai_vendor`
-- `axom__platform__delete_ai_vendor`
-- `axom__platform__upsert_ai_profile`
-- `axom__platform__delete_ai_profile`
-- `axom__platform__update_ai_memory`
+- `axom__setting_platform__get_ai_config`
+- `axom__setting_platform__upsert_ai_provider`
+- `axom__setting_platform__delete_ai_provider`
+- `axom__setting_platform__upsert_ai_profile`
+- `axom__setting_platform__delete_ai_profile`
+- `axom__setting_platform__update_ai_memory`
 
 ## Cowork agents
 
-- `axom__platform__list_cowork_agents`
-- `axom__platform__get_cowork_agent`
-- `axom__platform__create_cowork_agent`
-- `axom__platform__update_cowork_agent`
-- `axom__platform__delete_cowork_agent`
-- `axom__platform__get_cowork_agent_prompt`
-- `axom__platform__update_cowork_agent_prompt`
-- `axom__platform__list_cowork_agent_skills`
-- `axom__platform__get_cowork_agent_skill`
-- `axom__platform__create_cowork_agent_skill`
-- `axom__platform__update_cowork_agent_skill`
-- `axom__platform__delete_cowork_agent_skill`
-- `axom__platform__list_cowork_agent_workflows`
-- `axom__platform__get_cowork_agent_workflow`
-- `axom__platform__create_cowork_agent_workflow`
-- `axom__platform__update_cowork_agent_workflow`
-- `axom__platform__delete_cowork_agent_workflow`
-- `axom__platform__get_cowork_agent_workflow_body`
-- `axom__platform__update_cowork_agent_workflow_body`
+- `axom__setting_platform__list_cowork_agents`
+- `axom__setting_platform__get_cowork_agent`
+- `axom__setting_platform__create_cowork_agent`
+- `axom__setting_platform__update_cowork_agent`
+- `axom__setting_platform__delete_cowork_agent`
+- `axom__setting_platform__get_cowork_agent_prompt`
+- `axom__setting_platform__update_cowork_agent_prompt`
+- `axom__setting_platform__list_cowork_agent_skills`
+- `axom__setting_platform__get_cowork_agent_skill`
+- `axom__setting_platform__create_cowork_agent_skill`
+- `axom__setting_platform__update_cowork_agent_skill`
+- `axom__setting_platform__delete_cowork_agent_skill`
+- `axom__setting_platform__list_cowork_agent_workflows`
+- `axom__setting_platform__get_cowork_agent_workflow`
+- `axom__setting_platform__create_cowork_agent_workflow`
+- `axom__setting_platform__update_cowork_agent_workflow`
+- `axom__setting_platform__delete_cowork_agent_workflow`
+- `axom__setting_platform__get_cowork_agent_workflow_body`
+- `axom__setting_platform__update_cowork_agent_workflow_body`
 
 ## Datasources and platform settings
 
-- `axom__platform__list_data_sources`
-- `axom__platform__get_data_source`
-- `axom__platform__create_data_source`
-- `axom__platform__update_data_source`
-- `axom__platform__delete_data_source`
-- `axom__platform__get_settings`
-- `axom__platform__update_settings`
+- `axom__setting_platform__list_data_sources`
+- `axom__setting_platform__get_data_source`
+- `axom__setting_platform__create_data_source`
+- `axom__setting_platform__update_data_source`
+- `axom__setting_platform__delete_data_source`
+- `axom__setting_platform__get_settings`
+- `axom__setting_platform__update_settings`
 
 ## Guide
 
 Before editing, load the matching guide with `axom__guide__load`:
-`platform-operations/ai-vendors-and-profiles.md`,
+`platform-operations/ai-providers-and-profiles.md`,
 `platform-operations/cowork-agent-configuration.md`,
 `platform-operations/datasource-configuration.md`,
 `platform-operations/service-configuration.md`, or