mammoth-cli 1.0.0__py3-none-any.whl

spec/manifests/commands/folder.yaml

@@ -0,0 +1,334 @@
+manifest_schema_version: 1
+commands:
+- command_id: folder.bulk-delete
+  command_path: folder bulk-delete
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - DeleteFolders
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.bulk_delete
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.bulk_delete with validated request fields.
+  request_model: FolderBulkDeleteRequest
+  result_model: FolderBulkDeleteResult
+  mutation_class: destructive
+  confirmation: prompt_or_yes
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-FOLDER-BULK-DELETE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder bulk-delete --help
+  agent_example: mammoth folder bulk-delete --output json --no-input
+  unit_tests:
+  - UT-FOLDER-BULK-DELETE
+  contract_tests:
+  - CT-FOLDER-BULK-DELETE-HUMAN
+  - CT-FOLDER-BULK-DELETE-JSON
+  - CT-FOLDER-BULK-DELETE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: folder.create
+  command_path: folder create
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - CreateFolder
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.create
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.create with validated request fields.
+  request_model: FolderCreateRequest
+  result_model: FolderCreateResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-FOLDER-CREATE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder create --help
+  agent_example: 'mammoth folder create --input ''{"name": "example"}'' --output json --no-input'
+  unit_tests:
+  - UT-FOLDER-CREATE
+  contract_tests:
+  - CT-FOLDER-CREATE-HUMAN
+  - CT-FOLDER-CREATE-JSON
+  - CT-FOLDER-CREATE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: folder.delete
+  command_path: folder delete
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - DeleteFolder
+  positionals:
+  - name: folder_id
+    type: int
+    required: true
+    metavar: FOLDER_ID
+    falls_back_to_field: null
+    help: ID of the folder to delete.
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.delete
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.delete with validated request fields.
+  request_model: FolderDeleteRequest
+  result_model: FolderDeleteResult
+  mutation_class: destructive
+  confirmation: prompt_or_yes
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-FOLDER-DELETE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder delete FOLDER_ID --help
+  agent_example: mammoth folder delete 123 --output json --no-input
+  unit_tests:
+  - UT-FOLDER-DELETE
+  contract_tests:
+  - CT-FOLDER-DELETE-HUMAN
+  - CT-FOLDER-DELETE-JSON
+  - CT-FOLDER-DELETE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: Sorted ID-set confirmation, plus exact project ID and phrase DELETE FOLDER CONTENTS
+    when removing contents.
+  reviewed_by: primary
+- command_id: folder.get
+  command_path: folder get
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetFolder
+  positionals:
+  - name: folder_id
+    type: int
+    required: true
+    metavar: FOLDER_ID
+    falls_back_to_field: null
+    help: ID of the folder.
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.get
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.get with validated request fields.
+  request_model: FolderGetRequest
+  result_model: FolderGetResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-FOLDER-GET
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder get FOLDER_ID --help
+  agent_example: mammoth folder get 123 --output json --no-input
+  unit_tests:
+  - UT-FOLDER-GET
+  contract_tests:
+  - CT-FOLDER-GET-HUMAN
+  - CT-FOLDER-GET-JSON
+  - CT-FOLDER-GET-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: folder.list
+  command_path: folder list
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - ListFolders
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.list
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.list with validated request fields.
+  request_model: FolderListRequest
+  result_model: FolderListResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: offset
+  acceptance_evidence: live_read_only
+  live_test: LT-FOLDER-LIST
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder list --help
+  agent_example: mammoth folder list --output json --no-input
+  unit_tests:
+  - UT-FOLDER-LIST
+  contract_tests:
+  - CT-FOLDER-LIST-HUMAN
+  - CT-FOLDER-LIST-JSON
+  - CT-FOLDER-LIST-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: folder.move
+  command_path: folder move
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - UpdateFolderResources
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.move
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.move with validated request fields.
+  request_model: FolderMoveRequest
+  result_model: FolderMoveResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: returns_job
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-FOLDER-MOVE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder move --help
+  agent_example: 'mammoth folder move --input ''{"resource_ids": ["example"]}'' --output json --no-input'
+  unit_tests:
+  - UT-FOLDER-MOVE
+  contract_tests:
+  - CT-FOLDER-MOVE-HUMAN
+  - CT-FOLDER-MOVE-JSON
+  - CT-FOLDER-MOVE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'B05 FOLDER_MOVE_NO_WAIT: SDK returns ObjectJobSchema but exposes no public wait
+    method; do not advertise --wait/--no-wait.'
+  reviewed_by: primary
+- command_id: folder.root
+  command_path: folder root
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - ListFolders
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.get_project_root
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.get_project_root with validated request fields.
+  request_model: FolderRootRequest
+  result_model: FolderRootResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-FOLDER-ROOT
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder root --help
+  agent_example: mammoth folder root --output json --no-input
+  unit_tests:
+  - UT-FOLDER-ROOT
+  contract_tests:
+  - CT-FOLDER-ROOT-HUMAN
+  - CT-FOLDER-ROOT-JSON
+  - CT-FOLDER-ROOT-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: folder.trash
+  command_path: folder trash
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - TrashFolder
+  positionals:
+  - name: folder_id
+    type: int
+    required: true
+    metavar: FOLDER_ID
+    falls_back_to_field: null
+    help: ID of the folder.
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.trash
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.trash with validated request fields.
+  request_model: FolderTrashRequest
+  result_model: FolderTrashResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-FOLDER-TRASH
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder trash FOLDER_ID --help
+  agent_example: mammoth folder trash 123 --output json --no-input
+  unit_tests:
+  - UT-FOLDER-TRASH
+  contract_tests:
+  - CT-FOLDER-TRASH-HUMAN
+  - CT-FOLDER-TRASH-JSON
+  - CT-FOLDER-TRASH-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: folder.update
+  command_path: folder update
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - UpdateFolderDetails
+  positionals:
+  - name: folder_id
+    type: int
+    required: true
+    metavar: FOLDER_ID
+    falls_back_to_field: null
+    help: ID of the folder.
+  options: []
+  sdk_symbol: mammoth.api.folders.FoldersAPI.update
+  sdk_conversion: Call mammoth.api.folders.FoldersAPI.update with validated request fields.
+  request_model: FolderUpdateRequest
+  result_model: FolderUpdateResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-FOLDER-UPDATE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth folder update FOLDER_ID --help
+  agent_example: 'mammoth folder update 123 --input ''{"name": "example"}'' --output json --no-input'
+  unit_tests:
+  - UT-FOLDER-UPDATE
+  contract_tests:
+  - CT-FOLDER-UPDATE-HUMAN
+  - CT-FOLDER-UPDATE-JSON
+  - CT-FOLDER-UPDATE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary

spec/manifests/commands/job.yaml

@@ -0,0 +1,151 @@
+manifest_schema_version: 1
+commands:
+- command_id: job.get
+  command_path: job get
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetJob
+  positionals:
+  - name: job_id
+    type: int
+    required: true
+    metavar: JOB_ID
+    falls_back_to_field: null
+    help: ID of the job.
+  options: []
+  sdk_symbol: mammoth.api.jobs.JobsAPI.get_job
+  sdk_conversion: Call mammoth.api.jobs.JobsAPI.get_job with validated request fields.
+  request_model: JobGetRequest
+  result_model: JobGetResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-JOB-GET
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth job get JOB_ID --help
+  agent_example: mammoth job get 123 --output json --no-input
+  unit_tests:
+  - UT-JOB-GET
+  contract_tests:
+  - CT-JOB-GET-HUMAN
+  - CT-JOB-GET-JSON
+  - CT-JOB-GET-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: timeout parameter on current get_job is unused and stays visible only for public
+    compatibility.
+  reviewed_by: primary
+- command_id: job.get-many
+  command_path: job get-many
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetJobs
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.jobs.JobsAPI.get_jobs
+  sdk_conversion: Call mammoth.api.jobs.JobsAPI.get_jobs with validated request fields.
+  request_model: JobGetManyRequest
+  result_model: JobGetManyResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-JOB-GET-MANY
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth job get-many --help
+  agent_example: 'mammoth job get-many --input ''{"job_ids": [1]}'' --output json --no-input'
+  unit_tests:
+  - UT-JOB-GET-MANY
+  contract_tests:
+  - CT-JOB-GET-MANY-HUMAN
+  - CT-JOB-GET-MANY-JSON
+  - CT-JOB-GET-MANY-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: CLI accepts repeatable positive integers, not comma strings.
+  reviewed_by: primary
+- command_id: job.wait
+  command_path: job wait
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetJob
+  positionals:
+  - name: job_id
+    type: int
+    required: true
+    metavar: JOB_ID
+    falls_back_to_field: null
+    help: ID of the job.
+  options: []
+  sdk_symbol: mammoth.api.jobs.JobsAPI.wait_for_job
+  sdk_conversion: Call mammoth.api.jobs.JobsAPI.wait_for_job with validated request fields.
+  request_model: JobWaitRequest
+  result_model: JobWaitResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: always_wait
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-JOB-WAIT
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth job wait JOB_ID --help
+  agent_example: mammoth job wait 123 --output json --no-input
+  unit_tests:
+  - UT-JOB-WAIT
+  contract_tests:
+  - CT-JOB-WAIT-HUMAN
+  - CT-JOB-WAIT-JSON
+  - CT-JOB-WAIT-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: job.wait-many
+  command_path: job wait-many
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetJobs
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.jobs.JobsAPI.wait_for_jobs
+  sdk_conversion: Call mammoth.api.jobs.JobsAPI.wait_for_jobs with validated request fields.
+  request_model: JobWaitManyRequest
+  result_model: JobWaitManyResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: always_wait
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-JOB-WAIT-MANY
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth job wait-many --help
+  agent_example: 'mammoth job wait-many --input ''{"job_ids": [1]}'' --output json --no-input'
+  unit_tests:
+  - UT-JOB-WAIT-MANY
+  contract_tests:
+  - CT-JOB-WAIT-MANY-HUMAN
+  - CT-JOB-WAIT-MANY-JSON
+  - CT-JOB-WAIT-MANY-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: Reject empty IDs; do not succeed when the server omits a requested job.
+  reviewed_by: primary

spec/manifests/commands/notification.yaml

@@ -0,0 +1,188 @@
+manifest_schema_version: 1
+commands:
+- command_id: notification.delete
+  command_path: notification delete
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - DeleteNotification
+  positionals:
+  - name: notification_id
+    type: int
+    required: true
+    metavar: NOTIFICATION_ID
+    falls_back_to_field: null
+    help: ID of the notification.
+  options: []
+  sdk_symbol: mammoth.api.notifications.NotificationsAPI.delete
+  sdk_conversion: Call mammoth.api.notifications.NotificationsAPI.delete with validated request fields.
+  request_model: NotificationDeleteRequest
+  result_model: NotificationDeleteResult
+  mutation_class: destructive
+  confirmation: prompt_or_yes
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-NOTIFICATION-DELETE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth notification delete NOTIFICATION_ID --help
+  agent_example: mammoth notification delete 123 --output json --no-input
+  unit_tests:
+  - UT-NOTIFICATION-DELETE
+  contract_tests:
+  - CT-NOTIFICATION-DELETE-HUMAN
+  - CT-NOTIFICATION-DELETE-JSON
+  - CT-NOTIFICATION-DELETE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: notification.delete-batch
+  command_path: notification delete-batch
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - DeleteNotifications
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.notifications.NotificationsAPI.delete_batch
+  sdk_conversion: Call mammoth.api.notifications.NotificationsAPI.delete_batch with validated request
+    fields.
+  request_model: NotificationDeleteBatchRequest
+  result_model: NotificationDeleteBatchResult
+  mutation_class: destructive
+  confirmation: prompt_or_yes
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-NOTIFICATION-DELETE-BATCH
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth notification delete-batch --help
+  agent_example: mammoth notification delete-batch --output json --no-input
+  unit_tests:
+  - UT-NOTIFICATION-DELETE-BATCH
+  contract_tests:
+  - CT-NOTIFICATION-DELETE-BATCH-HUMAN
+  - CT-NOTIFICATION-DELETE-BATCH-JSON
+  - CT-NOTIFICATION-DELETE-BATCH-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: notification.list
+  command_path: notification list
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetAllNotifications
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.notifications.NotificationsAPI.list
+  sdk_conversion: Call mammoth.api.notifications.NotificationsAPI.list with validated request fields.
+  request_model: NotificationListRequest
+  result_model: NotificationListResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: single_page
+  acceptance_evidence: live_read_only
+  live_test: LT-NOTIFICATION-LIST
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth notification list --help
+  agent_example: mammoth notification list --output json --no-input
+  unit_tests:
+  - UT-NOTIFICATION-LIST
+  contract_tests:
+  - CT-NOTIFICATION-LIST-HUMAN
+  - CT-NOTIFICATION-LIST-JSON
+  - CT-NOTIFICATION-LIST-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: notification.update
+  command_path: notification update
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - EditNotification
+  positionals:
+  - name: notification_id
+    type: int
+    required: true
+    metavar: NOTIFICATION_ID
+    falls_back_to_field: null
+    help: ID of the notification.
+  options: []
+  sdk_symbol: mammoth.api.notifications.NotificationsAPI.update
+  sdk_conversion: Call mammoth.api.notifications.NotificationsAPI.update with validated request fields.
+  request_model: NotificationUpdateRequest
+  result_model: NotificationUpdateResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-NOTIFICATION-UPDATE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth notification update NOTIFICATION_ID --help
+  agent_example: 'mammoth notification update 123 --input ''{"patch": [{"example": "example"}]}'' --output
+    json --no-input'
+  unit_tests:
+  - UT-NOTIFICATION-UPDATE
+  contract_tests:
+  - CT-NOTIFICATION-UPDATE-HUMAN
+  - CT-NOTIFICATION-UPDATE-JSON
+  - CT-NOTIFICATION-UPDATE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary
+- command_id: notification.update-batch
+  command_path: notification update-batch
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - EditNotifications
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.notifications.NotificationsAPI.update_batch
+  sdk_conversion: Call mammoth.api.notifications.NotificationsAPI.update_batch with validated request
+    fields.
+  request_model: NotificationUpdateBatchRequest
+  result_model: NotificationUpdateBatchResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-NOTIFICATION-UPDATE-BATCH
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth notification update-batch --help
+  agent_example: 'mammoth notification update-batch --input ''{"patch": [{"example": "example"}]}'' --output
+    json --no-input'
+  unit_tests:
+  - UT-NOTIFICATION-UPDATE-BATCH
+  contract_tests:
+  - CT-NOTIFICATION-UPDATE-BATCH-HUMAN
+  - CT-NOTIFICATION-UPDATE-BATCH-JSON
+  - CT-NOTIFICATION-UPDATE-BATCH-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: null
+  reviewed_by: primary