mammoth-cli 2.0.36__tar.gz → 2.0.38__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/PKG-INFO +8 -6
  2. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/README.md +6 -4
  3. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/__init__.py +1 -1
  4. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md +73 -2
  5. mammoth_cli-2.0.38/mammoth_cli/bundled_skill/mammoth-cli/references/about-mammoth.md +155 -0
  6. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities.md +1 -1
  7. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md +2 -2
  8. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md +20 -0
  9. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/task-start.md +10 -7
  10. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/registry.py +2 -0
  11. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/schema.py +182 -46
  12. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/view.py +25 -1
  13. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/view_ops.py +34 -3
  14. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/input_fields.py +3 -0
  15. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/skills/steering.py +3 -1
  16. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/pyproject.toml +2 -2
  17. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/view.yaml +82 -0
  18. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/sdk-catalog.source.yaml +14 -0
  19. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/sdk-methods.yaml +24 -0
  20. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/.gitignore +0 -0
  21. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/LICENSE +0 -0
  22. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/__main__.py +0 -0
  23. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/app.py +0 -0
  24. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/auth.md +0 -0
  25. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities-misc.md +0 -0
  26. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/activity.md +0 -0
  27. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/addon.md +0 -0
  28. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/agent.md +0 -0
  29. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/ai.md +0 -0
  30. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/annotation.md +0 -0
  31. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/auth.md +0 -0
  32. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/automation.md +0 -0
  33. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/batch.md +0 -0
  34. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/billing.md +0 -0
  35. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/browse.md +0 -0
  36. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/capability.md +0 -0
  37. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/client-app.md +0 -0
  38. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/completion.md +0 -0
  39. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/config.md +0 -0
  40. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/connector.md +0 -0
  41. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/context.md +0 -0
  42. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard.md +0 -0
  43. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/data-app.md +0 -0
  44. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dataset.md +0 -0
  45. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/doctor.md +0 -0
  46. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/external-key.md +0 -0
  47. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/file.md +0 -0
  48. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/folder.md +0 -0
  49. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/job.md +0 -0
  50. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/log.md +0 -0
  51. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/notification.md +0 -0
  52. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/parameter.md +0 -0
  53. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/project.md +0 -0
  54. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/report.md +0 -0
  55. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/schedule.md +0 -0
  56. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/schema.md +0 -0
  57. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/skill.md +0 -0
  58. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/snippet.md +0 -0
  59. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/support.md +0 -0
  60. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/template.md +0 -0
  61. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/trash.md +0 -0
  62. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/upgrade.md +0 -0
  63. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/user.md +0 -0
  64. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/version.md +0 -0
  65. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/webhook.md +0 -0
  66. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workflow.md +0 -0
  67. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workspace.md +0 -0
  68. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/handoff.md +0 -0
  69. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/input.md +0 -0
  70. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/jobs-drafts.md +0 -0
  71. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/machine-output.md +0 -0
  72. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/operations.md +0 -0
  73. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/auth-scope.md +0 -0
  74. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/cleanup.md +0 -0
  75. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/dashboards.md +0 -0
  76. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/end-to-end.md +0 -0
  77. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/exports.md +0 -0
  78. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/index.md +0 -0
  79. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/need-action.md +0 -0
  80. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/resources.md +0 -0
  81. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/transforms.md +0 -0
  82. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/typed-etl-discovery.md +0 -0
  83. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/recovery.md +0 -0
  84. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/report-checklist.md +0 -0
  85. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/retention.md +0 -0
  86. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/safety.md +0 -0
  87. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/__init__.py +0 -0
  88. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/activity.py +0 -0
  89. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/addon.py +0 -0
  90. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/agent.py +0 -0
  91. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/ai.py +0 -0
  92. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/annotation.py +0 -0
  93. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/auth.py +0 -0
  94. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/automation.py +0 -0
  95. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/batch.py +0 -0
  96. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/billing.py +0 -0
  97. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/browse.py +0 -0
  98. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/capability.py +0 -0
  99. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/client_app.py +0 -0
  100. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/completion.py +0 -0
  101. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/config.py +0 -0
  102. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/connector.py +0 -0
  103. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/context.py +0 -0
  104. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/dashboard.py +0 -0
  105. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/data_app.py +0 -0
  106. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/dataset.py +0 -0
  107. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/doctor.py +0 -0
  108. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/external_key.py +0 -0
  109. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/file.py +0 -0
  110. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/folder.py +0 -0
  111. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/job.py +0 -0
  112. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/notification.py +0 -0
  113. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/parameter.py +0 -0
  114. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/project.py +0 -0
  115. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/report.py +0 -0
  116. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/schedule.py +0 -0
  117. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/skill.py +0 -0
  118. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/snippet.py +0 -0
  119. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/support.py +0 -0
  120. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/template.py +0 -0
  121. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/trash.py +0 -0
  122. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/upgrade.py +0 -0
  123. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/user.py +0 -0
  124. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/webhook.py +0 -0
  125. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/workflow.py +0 -0
  126. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/commands/workspace.py +0 -0
  127. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/context/__init__.py +0 -0
  128. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/context/credentials.py +0 -0
  129. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/context/endpoint.py +0 -0
  130. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/context/profiles.py +0 -0
  131. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/context/resolver.py +0 -0
  132. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/contracts/__init__.py +0 -0
  133. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/contracts/auth.py +0 -0
  134. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/errors/__init__.py +0 -0
  135. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/errors/envelope.py +0 -0
  136. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/manifest/__init__.py +0 -0
  137. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/manifest/loader.py +0 -0
  138. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/messages/__init__.py +0 -0
  139. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/output/__init__.py +0 -0
  140. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/output/envelope.py +0 -0
  141. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/output/normalize.py +0 -0
  142. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/output/policy.py +0 -0
  143. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/output/progress.py +0 -0
  144. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/output/render.py +0 -0
  145. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/py.typed +0 -0
  146. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/__init__.py +0 -0
  147. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/confirm.py +0 -0
  148. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/dryrun.py +0 -0
  149. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/executor.py +0 -0
  150. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/input_loader.py +0 -0
  151. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/invocation.py +0 -0
  152. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/options.py +0 -0
  153. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/parents.py +0 -0
  154. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/runlog.py +0 -0
  155. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/session.py +0 -0
  156. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/strict.py +0 -0
  157. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/updates.py +0 -0
  158. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/runtime/validate.py +0 -0
  159. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/__init__.py +0 -0
  160. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/argspec.py +0 -0
  161. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/coerce.py +0 -0
  162. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/command_contract.py +0 -0
  163. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/conditions.py +0 -0
  164. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/dispatch.py +0 -0
  165. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/factory.py +0 -0
  166. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/mapping.py +0 -0
  167. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/openapi_types.py +0 -0
  168. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/positionals.py +0 -0
  169. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/protocol.py +0 -0
  170. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/sdk_service.py +0 -0
  171. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/testing.py +0 -0
  172. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/services/type_system.py +0 -0
  173. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/skills/__init__.py +0 -0
  174. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/skills/installer.py +0 -0
  175. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/mammoth_cli/testing.py +0 -0
  176. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/activity.yaml +0 -0
  177. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/addon.yaml +0 -0
  178. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/agent.yaml +0 -0
  179. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/ai.yaml +0 -0
  180. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/annotation.yaml +0 -0
  181. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/auth.yaml +0 -0
  182. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/automation.yaml +0 -0
  183. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/batch.yaml +0 -0
  184. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/billing.yaml +0 -0
  185. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/browse.yaml +0 -0
  186. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/capability.yaml +0 -0
  187. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/client-app.yaml +0 -0
  188. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/completion.yaml +0 -0
  189. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/config.yaml +0 -0
  190. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/connector.yaml +0 -0
  191. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/context.yaml +0 -0
  192. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/dashboard.yaml +0 -0
  193. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/data-app.yaml +0 -0
  194. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/dataset.yaml +0 -0
  195. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/doctor.yaml +0 -0
  196. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/external-key.yaml +0 -0
  197. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/file.yaml +0 -0
  198. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/folder.yaml +0 -0
  199. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/job.yaml +0 -0
  200. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/log.yaml +0 -0
  201. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/notification.yaml +0 -0
  202. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/parameter.yaml +0 -0
  203. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/project.yaml +0 -0
  204. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/report.yaml +0 -0
  205. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/schedule.yaml +0 -0
  206. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/schema.yaml +0 -0
  207. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/skill.yaml +0 -0
  208. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/snippet.yaml +0 -0
  209. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/support.yaml +0 -0
  210. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/template.yaml +0 -0
  211. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/trash.yaml +0 -0
  212. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/upgrade.yaml +0 -0
  213. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/user.yaml +0 -0
  214. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/version.yaml +0 -0
  215. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/webhook.yaml +0 -0
  216. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/workflow.yaml +0 -0
  217. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/commands/workspace.yaml +0 -0
  218. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/openapi-operations.yaml +0 -0
  219. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/manifests/schema-v1.json +0 -0
  220. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/openapi/metadata.json +0 -0
  221. {mammoth_cli-2.0.36 → mammoth_cli-2.0.38}/spec/openapi/openapi.json +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mammoth-cli
3
- Version: 2.0.36
3
+ Version: 2.0.38
4
4
  Summary: Command-line interface for the Mammoth Analytics platform
5
5
  Project-URL: homepage, https://mammoth.io
6
6
  Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,7 +17,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
17
17
  Requires-Python: <3.15,>=3.12
18
18
  Requires-Dist: jsonschema>=4.20
19
19
  Requires-Dist: keyring<26,>=25.7
20
- Requires-Dist: mammoth-io<0.8,>=0.7.16
20
+ Requires-Dist: mammoth-io<0.8,>=0.7.17
21
21
  Requires-Dist: platformdirs<5,>=4.10
22
22
  Requires-Dist: pydantic<3,>=2.13
23
23
  Requires-Dist: pyyaml<7,>=6
@@ -203,8 +203,9 @@ one-time login, and works from the shipped skill. The long form is
203
203
  [docs/agent-prompt.md](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/agent-prompt.md).
204
204
 
205
205
  ```text
206
- Use Mammoth Analytics only through the `mammoth` CLI in bash; run
207
- `export MAMMOTH_OUTPUT=json MAMMOTH_NO_INPUT=1` once. Onboard me first:
206
+ Use Mammoth Analytics only through the `mammoth` CLI in bash, never the web
207
+ app in a browser; run `export MAMMOTH_OUTPUT=json MAMMOTH_NO_INPUT=1` once.
208
+ Onboard me first:
208
209
  1. If `mammoth --version` fails, install, then re-check (new shell if needed):
209
210
  curl -fsSL https://raw.githubusercontent.com/EdgeMetric/mammothsdk/main/mammoth-cli/installers/mammoth-install.sh | bash
210
211
  2. Run `mammoth auth status`. If it shows no credentials or a
@@ -217,8 +218,9 @@ Use Mammoth Analytics only through the `mammoth` CLI in bash; run
217
218
  3. Require `mammoth doctor` to pass, then run `mammoth skill show` and
218
219
  follow the guide it prints.
219
220
  Work inside `mammoth project ensure 'PROJECT NAME'` unless I name a project;
220
- take ids only from reads; `schema get COMMAND_ID` before a new command; read
221
- results back before reporting.
221
+ take ids only from reads; find a command with `schema find "GOAL IN PLAIN
222
+ WORDS"` or `view transform --help`, and `schema get COMMAND_ID` before a new
223
+ command; read results back before reporting.
222
224
  TASK: <what to achieve, and how you will know it is done>
223
225
  ```
224
226
 
@@ -175,8 +175,9 @@ one-time login, and works from the shipped skill. The long form is
175
175
  [docs/agent-prompt.md](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/agent-prompt.md).
176
176
 
177
177
  ```text
178
- Use Mammoth Analytics only through the `mammoth` CLI in bash; run
179
- `export MAMMOTH_OUTPUT=json MAMMOTH_NO_INPUT=1` once. Onboard me first:
178
+ Use Mammoth Analytics only through the `mammoth` CLI in bash, never the web
179
+ app in a browser; run `export MAMMOTH_OUTPUT=json MAMMOTH_NO_INPUT=1` once.
180
+ Onboard me first:
180
181
  1. If `mammoth --version` fails, install, then re-check (new shell if needed):
181
182
  curl -fsSL https://raw.githubusercontent.com/EdgeMetric/mammothsdk/main/mammoth-cli/installers/mammoth-install.sh | bash
182
183
  2. Run `mammoth auth status`. If it shows no credentials or a
@@ -189,8 +190,9 @@ Use Mammoth Analytics only through the `mammoth` CLI in bash; run
189
190
  3. Require `mammoth doctor` to pass, then run `mammoth skill show` and
190
191
  follow the guide it prints.
191
192
  Work inside `mammoth project ensure 'PROJECT NAME'` unless I name a project;
192
- take ids only from reads; `schema get COMMAND_ID` before a new command; read
193
- results back before reporting.
193
+ take ids only from reads; find a command with `schema find "GOAL IN PLAIN
194
+ WORDS"` or `view transform --help`, and `schema get COMMAND_ID` before a new
195
+ command; read results back before reporting.
194
196
  TASK: <what to achieve, and how you will know it is done>
195
197
  ```
196
198
 
@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
6
6
 
7
7
  from __future__ import annotations
8
8
 
9
- __version__ = "2.0.36"
9
+ __version__ = "2.0.38"
10
10
 
11
11
  # The versioned machine output envelope contract.
12
12
  SCHEMA_VERSION = 1
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: mammoth-cli
3
- version: 2.0.36
4
- description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines, dashboards, exports, and handoffs."
3
+ version: 2.0.38
4
+ description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
5
5
  ---
6
6
 
7
7
  # Mammoth CLI
@@ -10,6 +10,19 @@ Use this skill for Mammoth shell work, not for Python SDK integration. The
10
10
  CLI is the contract: it validates every request locally, returns one JSON
11
11
  envelope, and needs no flag for that when you pipe its output.
12
12
 
13
+ ## What Mammoth is
14
+
15
+ Mammoth Analytics is a no-code data platform. Data comes in from files, URLs
16
+ or connectors and lands in a **dataset**. It is cleaned, joined, reshaped and
17
+ calculated in a **pipeline** of tasks on a **view**, and the result is
18
+ published as a dashboard or delivered as a CSV, a database table, a BI feed
19
+ or another dataset. The pipeline re-runs when new data arrives, so build the
20
+ steps in Mammoth rather than computing a result locally. The web app and
21
+ this CLI call the same API: every task in the web app's Transform menu is a
22
+ `mammoth view transform` command. The data model, the high-level
23
+ capabilities and the full web-to-CLI map are in
24
+ [about Mammoth](references/about-mammoth.md).
25
+
13
26
  ## Start
14
27
 
15
28
  ```bash
@@ -42,6 +55,62 @@ before the next step.
42
55
  - Commands that start platform work wait up to 300 s for the job; on
43
56
  `timeout` use the `job get` recovery command printed, do not resubmit.
44
57
 
58
+ ## Find the command for a goal
59
+
60
+ State the goal in plain words; the search knows common phrasing, and
61
+ `view transform --help` is the Transform menu with one line per task:
62
+
63
+ ```bash
64
+ mammoth schema find "merge two datasets" # -> view.transform.join
65
+ mammoth view transform --help # every data transformation
66
+ ```
67
+
68
+ | Goal | Command |
69
+ |---|---|
70
+ | Combine two datasets on a key (merge, VLOOKUP) | `view transform join`; one value per key: `view transform lookup` |
71
+ | Add rows to an existing dataset | `file upload FILE --input '{"append_to_ds_id": DATASET_ID}'` |
72
+ | Keep or remove rows | `view transform filter` |
73
+ | Remove duplicate rows | `view transform discard-duplicates` |
74
+ | Totals, counts, averages per group | `view transform pivot` |
75
+ | A calculated column | `view transform math` |
76
+ | Blanks to a constant, or to the previous row's value | `view transform set-values` (`IS_EMPTY`), `view transform fill-missing` |
77
+ | Clean text | `view transform text`, `replace`, `bulk-replace` |
78
+ | Change a column's type | `view transform convert-type` |
79
+ | Rename a column, sort the rows (view settings, not tasks) | `view transform rename-columns`, `view transform sort` |
80
+ | Rank, running total, previous row | `view transform window` |
81
+ | A dashboard | `dashboard create-blank` ([dashboards](references/recipes/dashboards.md)) |
82
+ | Deliver the rows | `view export csv`, `view export postgres` (and other destinations), `view export dataset` |
83
+
84
+ A search with no full match returns `suggestions` and a `hint`. Before you
85
+ conclude the CLI cannot do something the web app does, check
86
+ `view transform --help` and "View settings, and what has no command" in
87
+ [about Mammoth](references/about-mammoth.md). Do not switch to the web app
88
+ in a browser, or compute the result locally, for work the CLI covers;
89
+ report a real gap with the command you tried.
90
+
91
+ ## Several files, one deliverable
92
+
93
+ Users often upload related files without saying how they relate ("make a
94
+ dashboard from t_a and t_b"). Work it out from the data before you build:
95
+
96
+ 1. Read every view first: `view get VIEW_ID` (columns, types, row count) and
97
+ `view data get VIEW_ID --input '{"limit": 20}'`.
98
+ 2. Find the keys. A column in one view whose values appear in a column of
99
+ the other (`customer_id` and `id`, `order_ref` and `order_no`) is a
100
+ foreign key; the view with many rows per key is the main one.
101
+ 3. Make the keys match before the join: same type (`convert-type`), same
102
+ case and padding (`text`), no blanks (`set-values`, `filter`).
103
+ 4. Fix what the deliverable needs: numbers stored as text (`convert-type`
104
+ to `NUMERIC`), dates stored as text (`convert-type` to `DATE`), blanks.
105
+ 5. `view transform join` the lookup view into the main view (`LEFT`), then
106
+ read back and check the match rate
107
+ ([worked example](references/recipes/end-to-end.md), step 5).
108
+ 6. Build the dashboard from the joined view
109
+ ([dashboards](references/recipes/dashboards.md)).
110
+
111
+ Say what you inferred (which columns you joined on, what you converted) in
112
+ your report. If no column links the files, ask before you combine them.
113
+
45
114
  ## Calling a command
46
115
 
47
116
  - Ids are positionals; request fields are one `--input '{...}'` document;
@@ -89,6 +158,8 @@ before the next step.
89
158
 
90
159
  ## Route only what the task needs
91
160
 
161
+ - **What Mammoth is, its data model, which feature fits a business goal, or
162
+ a web-app task you cannot find in the CLI:** [about Mammoth](references/about-mammoth.md)
92
163
  - **Cold start, task plan, or unsupported route:** [task start](references/task-start.md)
93
164
  - **Login, profiles, and authorized scope:** [auth](references/auth.md)
94
165
  - **Nested input, output envelopes, confirmations, jobs, or recovery:**
@@ -0,0 +1,155 @@
1
+ # What Mammoth is, and what it can do
2
+
3
+ Read this when the task is stated as a business goal ("combine these files",
4
+ "a monthly summary per region", "feed this to Power BI") and you need to know
5
+ which Mammoth feature does it, or when you think the CLI cannot do something
6
+ the web app can.
7
+
8
+ ## Why Mammoth exists
9
+
10
+ Mammoth Analytics is a cloud platform that turns raw business data into
11
+ output people can trust and that stays current, without code. It has two
12
+ layers:
13
+
14
+ - **Preparation (the engine).** Data comes in from files, URLs or
15
+ connectors. It is cleaned, reshaped, joined and calculated in a
16
+ **pipeline**: an ordered list of tasks on a **view**. The pipeline re-runs
17
+ when new data arrives, so a monthly report is built once and refreshed,
18
+ not rebuilt.
19
+ - **Output.** Dashboards (and presentations, documents and Q&A pages) are
20
+ built from a prepared view. Data is also delivered: CSV downloads,
21
+ databases, cloud storage, BI tools, or another Mammoth dataset. Every
22
+ number is computed from the prepared data, never written by a model.
23
+
24
+ People use it to replace manual spreadsheet work: an analyst automating a
25
+ recurring report, a small practice producing client deliverables, a team
26
+ feeding clean data to Tableau or Power BI. Every step is visible and
27
+ repeatable, which is the point: someone else can inspect, re-run or take
28
+ over the work. So, as an agent, build the steps **in Mammoth** (as pipeline
29
+ tasks, dashboards and exports) rather than computing a result locally and
30
+ uploading it; a local result does not refresh and cannot be inspected.
31
+
32
+ ## How Mammoth organises data
33
+
34
+ ```
35
+ workspace account and billing; an API token belongs to one workspace
36
+ └─ project a container with its own members; work stays inside one
37
+ └─ dataset data from an upload, URL or connector; each import is a batch
38
+ └─ view a working copy of the dataset's rows; a dataset can have several
39
+ ├─ pipeline tasks run top to bottom; each `view transform` adds one at the end
40
+ ├─ exports CSV, databases, cloud storage, BI tools, another dataset
41
+ └─ dashboards built from the view's prepared rows
42
+ ```
43
+
44
+ - An upload returns a **dataset** id. Transforms, joins, exports and
45
+ dashboards take a **view** id (`view list DATASET_ID`).
46
+ - Columns have a **display name** (what people see, and what every CLI
47
+ input uses) and an internal name (`column_7`), which you never type.
48
+ - A task that ran is part of the view: later data refreshes run it again.
49
+ Draft mode (`view draft enter` / `submit`) holds several tasks and runs
50
+ them together.
51
+
52
+ ## What it can do, and where that is in the CLI
53
+
54
+ | Goal | Web app | CLI |
55
+ |---|---|---|
56
+ | Bring data in | Data → new dataset | `file upload`, `dataset create` (URL), `connector ...` |
57
+ | Add rows to existing data | a new batch on the dataset | `file upload FILE --input '{"append_to_ds_id": DATASET_ID}'` |
58
+ | Clean and reshape | View → Transform menu | `view transform OPERATION` (table below) |
59
+ | Combine two sources | Transform → Join, Lookup | `view transform join`, `view transform lookup` |
60
+ | Summarise | Transform → Group & Pivot | `view transform pivot`, `view transform crosstab` |
61
+ | Check data quality in the pipeline | Data Check, Checkpoint Alert | `view data-check create`, `view checkpoint create` |
62
+ | Reuse a value or a SQL block | Parameters, Snippets | `parameter ...`, `snippet ...` |
63
+ | Inspect or restore pipeline history | Version history | `view version list`, `view version apply` |
64
+ | Build a dashboard | Publish | `dashboard create-blank`, `dashboard v3 generate`, `dashboard canvas ...` |
65
+ | Deliver data | Export, Send to dataset | `view export csv`, `view export postgres` (and other destinations), `view export dataset` |
66
+ | Automate | Automations | `automation ...`, `workflow ...` |
67
+ | Undo a delete | Trash | `trash list`, `trash restore` |
68
+
69
+ Whether a route ran on release is in [capabilities](capabilities.md); read
70
+ it before you promise a deliverable. `schedule` is not implemented on
71
+ release.
72
+
73
+ ## The Transform menu, command by command
74
+
75
+ The web app groups its pipeline tasks in a Transform menu. Each data task is
76
+ a `mammoth view transform` command; `mammoth view transform --help` lists
77
+ them with one line each, and `mammoth schema get view.transform.join` (or
78
+ any other operation) gives the input. Send to Dataset is `view export dataset`; Data Check and
79
+ Checkpoint Alert are the `view data-check` and `view checkpoint` families.
80
+
81
+ | You want to | Web app task | Command |
82
+ |---|---|---|
83
+ | Keep or remove rows that match a condition | Conditional Filter | `filter` (`filter_type` `SHOW` or `REMOVE`) |
84
+ | Remove duplicate rows | Remove Duplicate Rows | `discard-duplicates` |
85
+ | Keep the first or last N rows by an order | Show Top/Bottom Rows | `limit-rows` (`n`, `order_by`, `bottom`) |
86
+ | Write a value where a condition holds, or a label or bucket column | Label & Insert Values | `set-values` |
87
+ | Fill blanks with the previous or next row's value | Fill Missing Values | `fill-missing` |
88
+ | Find and replace one value | Find & Replace | `replace` |
89
+ | Map many spellings to one value | Bulk Replace | `bulk-replace` |
90
+ | Change case or trim spaces | Text Formatting | `text` |
91
+ | Take part of a text value (characters or regex) | Extract Text | `substring` |
92
+ | Split one column into several | Split Into Multiple Columns | `split` |
93
+ | Join several columns into one text column | Combine Columns & Text | `combine-columns` |
94
+ | Change a column's type | Convert Column Type | `convert-type` |
95
+ | Calculate a column from others | Math Function | `math` |
96
+ | Rank, running total, previous or next row | Window function | `window` |
97
+ | Nth smallest or largest across columns | Obtain Large or Small Values | `small-large` |
98
+ | Take a year, month, weekday from a date | Extract Date Part | `extract-date` |
99
+ | Days (or months, ...) between two dates | Calculate Date Difference | `date-diff` |
100
+ | Shift a date by an interval | Add / Subtract Date Values | `increment-date` |
101
+ | Add an empty column | Add Column | `add-column` |
102
+ | Copy a column under a new name | Copy Columns | `copy-columns` |
103
+ | Rename a column | Rename (column header) | `rename-columns` (a view setting, not a task) |
104
+ | Sort the rows | Sort (grid) | `sort` (a view setting, not a task) |
105
+ | Remove columns | Remove Column | `delete-columns` |
106
+ | Add columns from another view by matching keys | Join | `join` (`INNER`, `LEFT`, `RIGHT`, `OUTER`) |
107
+ | Bring one value per key from another view | Lookup | `lookup` |
108
+ | Totals, counts, averages per group | Group & Pivot | `pivot` (replaces the view's columns) |
109
+ | A rows-by-columns summary table | Group & Pivot (crosstab) | `crosstab` (writes a new dataset) |
110
+ | Turn wide columns into label/value rows | Unpivot | `unnest` |
111
+ | Read fields out of a JSON column | Extract JSON | `json-extract` |
112
+ | Classify, tag or summarise rows with AI | Generative AI | `ai` |
113
+ | One SQL query over the view | AI SQL Query | `add-sql` (replaces the view's columns), `generate-sql` (from plain words) |
114
+ | Copy rows into another dataset, refreshed with the pipeline | Send to Dataset | `view export dataset` (not a `view transform`) |
115
+
116
+ `join` or `lookup`: `join` adds the chosen columns from every matching row
117
+ (a key that repeats on the other side repeats rows); `lookup` brings one
118
+ value per key into one new column. Before either, confirm the key columns
119
+ in both views have the same type and values; recipes/transforms.md has the
120
+ read-back.
121
+
122
+ ## View settings, and what has no command
123
+
124
+ Two commands change how the view shows its rows, not the rows. They add no
125
+ pipeline task, like their web counterparts (a column-header rename, a grid
126
+ sort):
127
+
128
+ - **Rename a column:** `view transform rename-columns` with `{"renames":
129
+ {"cust_id": "Customer ID"}}`. The column keeps its internal name, so
130
+ earlier tasks keep working; later commands, data reads, exports and
131
+ dashboards use the new name. To name a column you create, use its
132
+ `new_column` or `as_name` field instead.
133
+ - **Sort the rows:** `view transform sort` with `{"order_by": [["Revenue",
134
+ "DESC"]]}` (up to three columns; `[]` clears it). Data reads and exports
135
+ return rows in this order. To keep only the top N rows, use `limit-rows`
136
+ with `order_by`; for a rank column, `window` (`RANK`, `ROW_NUMBER`).
137
+
138
+ No command:
139
+
140
+ - **Union or append two views.** There is no union task. Upload a file into
141
+ an existing dataset with `append_to_ds_id`, or send a view's rows into an
142
+ existing dataset with `view export dataset` (`target_ds_id` and
143
+ `save_as_mode` `APPEND_TO_DS`; that mode is untried on release).
144
+ - **Hide or reorder columns.** Display changes in the web app; they do not
145
+ change the data.
146
+
147
+ ## The web app and the CLI
148
+
149
+ Both call the same API. Do not switch to the web app in a browser for a
150
+ task the CLI covers. Before you conclude that the CLI cannot do something,
151
+ run `mammoth view transform --help`, search in plain words (`mammoth schema
152
+ find "merge two datasets"` finds `join`; a search with no full match lists
153
+ `suggestions`), and read "View settings, and what has no command" above.
154
+ If it is still missing, report the gap with the command you tried; do not
155
+ work around it in the browser or by computing the result locally.
@@ -1,7 +1,7 @@
1
1
  # What is proven on release
2
2
 
3
3
  Generated from `docs/release-capability-matrix.json`; do not edit by hand.
4
- The CLI publishes 554 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (every `view transform *` command submits through `view.task.add`). 262 bound commands ran once successfully on release, 2 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer.
4
+ The CLI publishes 556 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 262 bound commands ran once successfully on release, 2 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer.
5
5
 
6
6
  Status meanings:
7
7
 
@@ -1,6 +1,6 @@
1
1
  # Published CLI command catalog
2
2
 
3
- This generated catalog is a lookup table for every command in the published CLI manifest, currently 554; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
3
+ This generated catalog is a lookup table for every command in the published CLI manifest, currently 556; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
4
4
 
5
5
  Load only the applicable domain file:
6
6
 
@@ -43,7 +43,7 @@ Load only the applicable domain file:
43
43
  - [upgrade](commands/upgrade.md) — 1 published commands
44
44
  - [user](commands/user.md) — 8 published commands
45
45
  - [version](commands/version.md) — 1 published commands
46
- - [view](commands/view.md) — 116 published commands
46
+ - [view](commands/view.md) — 118 published commands
47
47
  - [webhook](commands/webhook.md) — 7 published commands
48
48
  - [workflow](commands/workflow.md) — 16 published commands
49
49
  - [workspace](commands/workspace.md) — 20 published commands
@@ -1034,6 +1034,16 @@ Result: `ViewTransformPivotResult`; mutation `reversible_pipeline`, confirmation
1034
1034
 
1035
1035
  Status on release: ran once on CLI 2.0.18 through `view.task.add` and was read back with `view data get`; other inputs for this transform are untried.
1036
1036
 
1037
+ ### `view.transform.rename-columns`
1038
+
1039
+ Run: `mammoth view transform rename-columns`. Exact input fields: `mammoth schema get view.transform.rename-columns`.
1040
+
1041
+ Example: `mammoth view transform rename-columns 123 --input '{"renames": {"cust_id": "Customer ID"}, "dataset_id": 456}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
1042
+
1043
+ Result: `ViewTransformRenameColumnsResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
1044
+
1045
+ Status on release: untried; it submits through `view.task.add`, but this transform was not among those run.
1046
+
1037
1047
  ### `view.transform.replace`
1038
1048
 
1039
1049
  Run: `mammoth view transform replace`. Exact input fields: `mammoth schema get view.transform.replace`.
@@ -1064,6 +1074,16 @@ Result: `ViewTransformSmallLargeResult`; mutation `reversible_pipeline`, confirm
1064
1074
 
1065
1075
  Status on release: untried; it submits through `view.task.add`, but this transform was not among those run.
1066
1076
 
1077
+ ### `view.transform.sort`
1078
+
1079
+ Run: `mammoth view transform sort`. Exact input fields: `mammoth schema get view.transform.sort`.
1080
+
1081
+ Example: `mammoth view transform sort 123 --input '{"order_by": [["Revenue", "DESC"]], "dataset_id": 456}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
1082
+
1083
+ Result: `ViewTransformSortResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
1084
+
1085
+ Status on release: untried; it submits through `view.task.add`, but this transform was not among those run.
1086
+
1067
1087
  ### `view.transform.split`
1068
1088
 
1069
1089
  Run: `mammoth view transform split`. Exact input fields: `mammoth schema get view.transform.split`.
@@ -46,14 +46,17 @@ or secrets in an argument, prompt, transcript, or checkpoint.
46
46
 
47
47
  Do not print, echo, or copy secret-bearing inputs. A failed status, login,
48
48
  or doctor check stops the task before discovery and business commands.
49
- 4. Discover instead of guessing. Run `mammoth schema list/find/get --output
50
- json --no-input` for local CLI routes; `mammoth capability list --output
51
- json --no-input` is an API-binding inventory and can omit typed/local
52
- routes. Check [capabilities](capabilities.md) for whether a route is
53
- proven, not supported, or untried on release before building a plan on
54
- it. Then resolve workspace/project/dataset/view
49
+ 4. Discover instead of guessing. Search with the goal in plain words
50
+ (`mammoth schema find "merge two datasets"` finds the join), then run
51
+ `mammoth schema get COMMAND_ID` for local CLI routes; `mammoth view transform
52
+ --help` lists every data transformation; `mammoth schema list` is the
53
+ complete inventory. `mammoth capability list` is an API-binding inventory
54
+ and can omit typed/local routes. Check [capabilities](capabilities.md)
55
+ for whether a route is proven, not supported, or untried on release
56
+ before building a plan on it. Then resolve workspace/project/dataset/view
55
57
  parents with reads. Use display names returned by the exact view schema.
56
- 5. Translate the business intent into a plan the agent chooses. Submit only
58
+ 5. Translate the business intent into a plan the agent chooses;
59
+ [about Mammoth](about-mammoth.md) maps goals to features. Submit only
57
60
  supported operations against the active project (`project ensure` sets it;
58
61
  `--project` overrides) with structured `--input`. Do not use private
59
62
  HTTP/SDK escape hatches or local data processing as a substitute.
@@ -684,9 +684,11 @@ HANDLERS: dict[str, Handler] = {
684
684
  "view.transform.lookup": view_ops_cmd.view_transform_lookup,
685
685
  "view.transform.math": view_ops_cmd.view_transform_math,
686
686
  "view.transform.pivot": view_ops_cmd.view_transform_pivot,
687
+ "view.transform.rename-columns": view_ops_cmd.view_transform_rename_columns,
687
688
  "view.transform.replace": view_ops_cmd.view_transform_replace,
688
689
  "view.transform.set-values": view_ops_cmd.view_transform_set_values,
689
690
  "view.transform.small-large": view_ops_cmd.view_transform_small_large,
691
+ "view.transform.sort": view_ops_cmd.view_transform_sort,
690
692
  "view.transform.split": view_ops_cmd.view_transform_split,
691
693
  "view.transform.substring": view_ops_cmd.view_transform_substring,
692
694
  "view.transform.text": view_ops_cmd.view_transform_text,