formist-cli 0.1.0__tar.gz → 0.2.0__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 (175) hide show
  1. formist_cli-0.2.0/.claude-plugin/plugin.json +9 -0
  2. {formist_cli-0.1.0 → formist_cli-0.2.0}/PKG-INFO +4 -4
  3. {formist_cli-0.1.0 → formist_cli-0.2.0}/README.ar.md +3 -3
  4. {formist_cli-0.1.0 → formist_cli-0.2.0}/README.fr.md +5 -5
  5. {formist_cli-0.1.0 → formist_cli-0.2.0}/README.md +3 -3
  6. {formist_cli-0.1.0 → formist_cli-0.2.0}/README.zh-CN.md +7 -7
  7. formist_cli-0.2.0/hooks/hooks.json +10 -0
  8. formist_cli-0.2.0/monitors/monitors.json +7 -0
  9. {formist_cli-0.1.0 → formist_cli-0.2.0}/pyproject.toml +1 -1
  10. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/cli.py +398 -80
  11. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/cli_support.py +19 -0
  12. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/connectors.py +22 -5
  13. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/context.py +8 -1
  14. formist_cli-0.2.0/src/formist_cli/plugin_hooks.py +239 -0
  15. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/privileges.py +71 -51
  16. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/projects.py +7 -3
  17. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/skills.py +76 -12
  18. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/spaces.py +41 -2
  19. formist_cli-0.2.0/src/formist_cli/task_archive.py +277 -0
  20. formist_cli-0.2.0/src/formist_cli/task_assignee.py +34 -0
  21. formist_cli-0.2.0/src/formist_cli/task_attach.py +102 -0
  22. formist_cli-0.2.0/src/formist_cli/task_check.py +261 -0
  23. formist_cli-0.2.0/src/formist_cli/task_cloud.py +570 -0
  24. formist_cli-0.2.0/src/formist_cli/task_duration.py +73 -0
  25. formist_cli-0.2.0/src/formist_cli/task_filter.py +87 -0
  26. formist_cli-0.2.0/src/formist_cli/task_format.py +90 -0
  27. formist_cli-0.2.0/src/formist_cli/task_fuzzy_date.py +432 -0
  28. formist_cli-0.2.0/src/formist_cli/task_identity.py +63 -0
  29. formist_cli-0.2.0/src/formist_cli/task_import.py +301 -0
  30. formist_cli-0.2.0/src/formist_cli/task_intake.py +55 -0
  31. formist_cli-0.2.0/src/formist_cli/task_json.py +233 -0
  32. formist_cli-0.2.0/src/formist_cli/task_lock.py +65 -0
  33. formist_cli-0.2.0/src/formist_cli/task_mirror.py +158 -0
  34. formist_cli-0.2.0/src/formist_cli/task_model.py +230 -0
  35. formist_cli-0.2.0/src/formist_cli/task_monitor.py +353 -0
  36. formist_cli-0.2.0/src/formist_cli/task_parse.py +657 -0
  37. formist_cli-0.2.0/src/formist_cli/task_paths.py +191 -0
  38. formist_cli-0.2.0/src/formist_cli/task_project.py +78 -0
  39. formist_cli-0.2.0/src/formist_cli/task_questions.py +181 -0
  40. formist_cli-0.2.0/src/formist_cli/task_queue.py +95 -0
  41. formist_cli-0.2.0/src/formist_cli/task_ref.py +72 -0
  42. formist_cli-0.2.0/src/formist_cli/task_search.py +24 -0
  43. formist_cli-0.2.0/src/formist_cli/task_serialize.py +344 -0
  44. formist_cli-0.2.0/src/formist_cli/task_sessions.py +225 -0
  45. formist_cli-0.2.0/src/formist_cli/task_status.py +133 -0
  46. formist_cli-0.2.0/src/formist_cli/task_store.py +1370 -0
  47. formist_cli-0.2.0/src/formist_cli/task_title.py +29 -0
  48. formist_cli-0.2.0/src/formist_cli/task_views.py +418 -0
  49. formist_cli-0.2.0/src/formist_cli/task_width.py +21 -0
  50. formist_cli-0.2.0/src/formist_cli/task_yaml.py +361 -0
  51. formist_cli-0.2.0/src/formist_cli/tasks.py +1685 -0
  52. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/uploads.py +59 -0
  53. formist_cli-0.2.0/src/formist_cli/workflow_corpus.py +27 -0
  54. formist_cli-0.2.0/src/formist_cli/workflow_golden.json +41 -0
  55. formist_cli-0.2.0/tests/fixtures/task_decisions/active/1-plain-task-example.md +22 -0
  56. formist_cli-0.2.0/tests/fixtures/task_decisions/active/10-title-with-colon-and.md +22 -0
  57. formist_cli-0.2.0/tests/fixtures/task_decisions/active/2-decision-with-two-op.md +40 -0
  58. formist_cli-0.2.0/tests/fixtures/task_decisions/active/4-a-brief-for-ai.md +13 -0
  59. formist_cli-0.2.0/tests/fixtures/task_decisions/active/6-a-milestone.md +12 -0
  60. formist_cli-0.2.0/tests/fixtures/task_decisions/active/7-node-with-sub-questi.md +27 -0
  61. formist_cli-0.2.0/tests/fixtures/task_decisions/active/8-needs-acceptance.md +34 -0
  62. formist_cli-0.2.0/tests/fixtures/task_decisions/active/9-dependent-node.md +13 -0
  63. formist_cli-0.2.0/tests/fixtures/task_decisions/archived/3-fyi-entry.md +12 -0
  64. formist_cli-0.2.0/tests/fixtures/task_decisions/archived/5-for-the-owner.md +13 -0
  65. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_admin_flag_gate.py +76 -10
  66. formist_cli-0.2.0/tests/test_chat_group.py +99 -0
  67. formist_cli-0.2.0/tests/test_connector_group.py +94 -0
  68. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_context.py +71 -4
  69. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_login.py +12 -5
  70. formist_cli-0.2.0/tests/test_moved_to_fmdev.py +129 -0
  71. formist_cli-0.2.0/tests/test_plugin_hooks.py +195 -0
  72. formist_cli-0.2.0/tests/test_plugin_manifest.py +66 -0
  73. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_privileges.py +16 -7
  74. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_settings.py +21 -7
  75. formist_cli-0.2.0/tests/test_skill_group.py +126 -0
  76. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_skills.py +119 -0
  77. formist_cli-0.2.0/tests/test_spaces_set_logo.py +96 -0
  78. formist_cli-0.2.0/tests/test_task_archive_read_only.py +246 -0
  79. formist_cli-0.2.0/tests/test_task_check.py +289 -0
  80. formist_cli-0.2.0/tests/test_task_cli.py +724 -0
  81. formist_cli-0.2.0/tests/test_task_cloud.py +638 -0
  82. formist_cli-0.2.0/tests/test_task_fuzzy_date.py +84 -0
  83. formist_cli-0.2.0/tests/test_task_import.py +102 -0
  84. formist_cli-0.2.0/tests/test_task_import_archive.py +325 -0
  85. formist_cli-0.2.0/tests/test_task_mirror.py +83 -0
  86. formist_cli-0.2.0/tests/test_task_monitor.py +161 -0
  87. formist_cli-0.2.0/tests/test_task_nod_interop.py +289 -0
  88. formist_cli-0.2.0/tests/test_task_parse_serialize.py +130 -0
  89. formist_cli-0.2.0/tests/test_task_ref.py +17 -0
  90. formist_cli-0.2.0/tests/test_task_sessions.py +177 -0
  91. formist_cli-0.2.0/tests/test_task_store.py +399 -0
  92. formist_cli-0.2.0/tests/test_task_views.py +132 -0
  93. formist_cli-0.2.0/tests/test_task_workflow_parity.py +213 -0
  94. formist_cli-0.2.0/tests/test_task_yaml.py +84 -0
  95. {formist_cli-0.1.0 → formist_cli-0.2.0}/uv.lock +1 -1
  96. {formist_cli-0.1.0 → formist_cli-0.2.0}/.github/workflows/release.yml +0 -0
  97. {formist_cli-0.1.0 → formist_cli-0.2.0}/.github/workflows/test.yml +0 -0
  98. {formist_cli-0.1.0 → formist_cli-0.2.0}/.gitignore +0 -0
  99. {formist_cli-0.1.0 → formist_cli-0.2.0}/LICENSE +0 -0
  100. {formist_cli-0.1.0 → formist_cli-0.2.0}/docs/screenshot.png +0 -0
  101. {formist_cli-0.1.0 → formist_cli-0.2.0}/docs/screenshot.svg +0 -0
  102. {formist_cli-0.1.0 → formist_cli-0.2.0}/scripts/render_screenshot.py +0 -0
  103. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/__init__.py +0 -0
  104. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/__main__.py +0 -0
  105. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/airtable.py +0 -0
  106. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/alerts.py +0 -0
  107. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/api.py +0 -0
  108. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/chat.py +0 -0
  109. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/chats.py +0 -0
  110. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/diff.py +0 -0
  111. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/doctor.py +0 -0
  112. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/export.py +0 -0
  113. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/files.py +0 -0
  114. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/importer.py +0 -0
  115. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/kb.py +0 -0
  116. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/login.py +0 -0
  117. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/logs.py +0 -0
  118. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/meetings.py +0 -0
  119. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/messages.py +0 -0
  120. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/participants.py +0 -0
  121. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/prefs.py +0 -0
  122. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/resolve.py +0 -0
  123. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/settings.py +0 -0
  124. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/skill_library.py +0 -0
  125. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/space_plan.py +0 -0
  126. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/targets.py +0 -0
  127. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/textnorm.py +0 -0
  128. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/tokens.py +0 -0
  129. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/update.py +0 -0
  130. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/usage_tokens.py +0 -0
  131. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/users.py +0 -0
  132. {formist_cli-0.1.0 → formist_cli-0.2.0}/src/formist_cli/whatsapp.py +0 -0
  133. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_airtable.py +0 -0
  134. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_alerts.py +0 -0
  135. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_api_and_tokens.py +0 -0
  136. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_api_uploads_transport.py +0 -0
  137. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_audit_log_shows_the_newest.py +0 -0
  138. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_chat.py +0 -0
  139. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_chat_message.py +0 -0
  140. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_chats.py +0 -0
  141. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_cli_registration_is_unique.py +0 -0
  142. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_connector_ops.py +0 -0
  143. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_connectors.py +0 -0
  144. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_diff.py +0 -0
  145. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_doctor.py +0 -0
  146. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_export.py +0 -0
  147. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_files.py +0 -0
  148. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_files_download.py +0 -0
  149. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_files_merge.py +0 -0
  150. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_grants_render.py +0 -0
  151. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_help_matches_the_write_guard.py +0 -0
  152. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_importer.py +0 -0
  153. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_kb.py +0 -0
  154. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_logs.py +0 -0
  155. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_meetings.py +0 -0
  156. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_messages.py +0 -0
  157. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_participants.py +0 -0
  158. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_prefs.py +0 -0
  159. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_projects.py +0 -0
  160. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_proposals.py +0 -0
  161. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_render_screenshot.py +0 -0
  162. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_report_provenance.py +0 -0
  163. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_resolve.py +0 -0
  164. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_skill_library_install.py +0 -0
  165. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_space_plan.py +0 -0
  166. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_spaces.py +0 -0
  167. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_stream_transport.py +0 -0
  168. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_targets.py +0 -0
  169. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_update.py +0 -0
  170. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_upload_dir.py +0 -0
  171. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_uploads.py +0 -0
  172. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_usage_tokens.py +0 -0
  173. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_users.py +0 -0
  174. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_users_writes.py +0 -0
  175. {formist_cli-0.1.0 → formist_cli-0.2.0}/tests/test_whatsapp.py +0 -0
@@ -0,0 +1,9 @@
1
+ {
2
+ "name": "fm-task",
3
+ "displayName": "fm task",
4
+ "version": "0.1.0",
5
+ "description": "fm task is the AI's task and decision hub: injects usage rules and open work at session start, reminds the model to log the owner's words when they name a node, and keeps a monitor running against the current decisions/ directory (local mode) or Formist space (cloud mode, C1053/C1139).",
6
+ "author": { "name": "WeCarbon" },
7
+ "license": "MIT",
8
+ "repository": "https://github.com/WeCarbon/formist-cli"
9
+ }
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: formist-cli
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: Command-line client for Formist and Evane deployments
5
5
  Project-URL: Homepage, https://formist.ai
6
6
  Project-URL: Repository, https://github.com/WeCarbon/formist-cli
@@ -49,8 +49,8 @@ changes data always shows what it would do first; committing is a separate, expl
49
49
  and where each came from, a flag, a remembered default, or nothing, so a wrong target is caught
50
50
  by reading the screen, not by its effect.
51
51
  - **Dry run by default.** A command that changes data prints what it would do and waits for
52
- `--apply`. `fm update`, which applies a batch of changes at once, re-checks the plan still
53
- matches before committing, so a stale read can't turn into a wrong write.
52
+ `--apply`. `fm participants dedupe`, which merges a group of duplicate rows, re-checks the plan
53
+ still matches before committing, so a stale read can't turn into a wrong write.
54
54
  - **A credential per deployment.** `fm login` stores an OAuth credential at `0600`, one file per
55
55
  host, so signing in to a staging deployment never touches production. `FORMIST_TOKEN` supplies
56
56
  one for CI: used as-is, never written to disk, never refreshed.
@@ -116,7 +116,7 @@ remembered host: name it with `--host`, or the default (`formist`) is used.
116
116
  ### Writes
117
117
 
118
118
  Most commands that change data run as a dry run first and print what they would do; add
119
- `--apply` to commit. `fm update`, which applies a batch of changes transactionally, is slightly
119
+ `--apply` to commit. `fm participants dedupe`, which merges a group of duplicate rows, is slightly
120
120
  different: the dry run prints a plan token, and `--apply <token>` re-runs the dry run to confirm
121
121
  the plan still matches before committing. A handful of actions with no undo, such as `fm spaces
122
122
  --admin delete`, have no dry run at all and say so in their own `--help`.
@@ -35,8 +35,8 @@
35
35
  قيمة: خيار، أو قيمة افتراضية محفوظة، أو لا شيء. يُكتشف الهدف الخاطئ بقراءة الشاشة، لا
36
36
  بعد وقوع أثره.
37
37
  - **تشغيل تجريبي افتراضيًا.** يعرض الأمر الذي يغيّر البيانات أولًا ما سيفعله وينتظر
38
- `--apply`. أمر `fm update`، الذي يطبّق دفعة من التغييرات مرة واحدة، يعيد التحقق من أن
39
- الخطة ما زالت مطابقة قبل التثبيت، حتى لا تتحول قراءة قديمة إلى كتابة خاطئة.
38
+ `--apply`. أمر `fm participants dedupe`، الذي يدمج مجموعة من السجلات المكرّرة، يعيد
39
+ التحقق من أن الخطة ما زالت مطابقة قبل التثبيت، حتى لا تتحول قراءة قديمة إلى كتابة خاطئة.
40
40
  - **بيانات اعتماد لكل نشرة.** يخزّن `fm login` بيانات اعتماد OAuth بصلاحيات `0600`، ملف
41
41
  لكل نشرة، فتسجيل الدخول إلى نشرة تجريبية لا يمس أبدًا بيانات الإنتاج. يوفّر
42
42
  `FORMIST_TOKEN` بيانات اعتماد لبيئات التكامل المستمر: تُستخدم كما هي، ولا تُكتب على
@@ -105,7 +105,7 @@ fm kb search "venue contract" --space <space-id>
105
105
  ### الكتابة
106
106
 
107
107
  تعمل معظم الأوامر التي تغيّر البيانات كتشغيل تجريبي أولًا وتطبع ما ستفعله؛ أضف `--apply`
108
- للتثبيت. يختلف `fm update` قليلًا، فهو يطبّق دفعة من التغييرات ضمن معاملة واحدة: يطبع
108
+ للتثبيت. يختلف `fm participants dedupe` قليلًا، فهو يدمج مجموعة من السجلات المكرّرة: يطبع
109
109
  التشغيل التجريبي رمز خطة، ويعيد `--apply <الرمز>` تشغيل التجربة للتأكد من أن الخطة ما
110
110
  زالت مطابقة قبل التثبيت. بعض الإجراءات التي لا رجعة فيها، مثل
111
111
  `fm spaces --admin delete`، لا تشغيل تجريبي لها إطلاقًا، وتوضح ذلك في `--help` الخاصة بها.
@@ -36,9 +36,9 @@ données montre toujours d'abord ce qu'elle ferait ; valider est une étape à p
36
36
  a résolus, et d'où ils viennent : une option, une valeur par défaut mémorisée, ou rien du
37
37
  tout. Une mauvaise cible se repère en lisant l'écran, pas par ses conséquences.
38
38
  - **Simulation par défaut.** Une commande qui modifie des données affiche d'abord ce qu'elle
39
- ferait et attend `--apply`. `fm update`, qui applique un lot de changements en une fois,
40
- revérifie que le plan correspond toujours avant de valider, pour qu'une lecture périmée ne
41
- devienne jamais une écriture erronée.
39
+ ferait et attend `--apply`. `fm participants dedupe`, qui fusionne un groupe de lignes en
40
+ double, revérifie que le plan correspond toujours avant de valider, pour qu'une lecture
41
+ périmée ne devienne jamais une écriture erronée.
42
42
  - **Un identifiant par déploiement.** `fm login` enregistre un identifiant OAuth avec les
43
43
  droits `0600`, un fichier par déploiement, de sorte que se connecter à un environnement de
44
44
  test ne touche jamais la production. `FORMIST_TOKEN` en fournit un pour la CI : utilisé tel
@@ -109,8 +109,8 @@ valeur par défaut (`formist`) est utilisée.
109
109
  ### Écritures
110
110
 
111
111
  La plupart des commandes qui modifient des données s'exécutent d'abord en simulation et
112
- affichent ce qu'elles feraient ; ajoutez `--apply` pour valider. `fm update`, qui applique un
113
- lot de changements de façon transactionnelle, fonctionne un peu différemment : la simulation
112
+ affichent ce qu'elles feraient ; ajoutez `--apply` pour valider. `fm participants dedupe`, qui
113
+ fusionne un groupe de lignes en double, fonctionne un peu différemment : la simulation
114
114
  affiche un jeton de plan, et `--apply <jeton>` relance la simulation pour confirmer que le plan
115
115
  correspond toujours avant de valider. Quelques actions irréversibles, comme
116
116
  `fm spaces --admin delete`, n'ont aucune simulation et le précisent dans leur propre `--help`.
@@ -32,8 +32,8 @@ changes data always shows what it would do first; committing is a separate, expl
32
32
  and where each came from, a flag, a remembered default, or nothing, so a wrong target is caught
33
33
  by reading the screen, not by its effect.
34
34
  - **Dry run by default.** A command that changes data prints what it would do and waits for
35
- `--apply`. `fm update`, which applies a batch of changes at once, re-checks the plan still
36
- matches before committing, so a stale read can't turn into a wrong write.
35
+ `--apply`. `fm participants dedupe`, which merges a group of duplicate rows, re-checks the plan
36
+ still matches before committing, so a stale read can't turn into a wrong write.
37
37
  - **A credential per deployment.** `fm login` stores an OAuth credential at `0600`, one file per
38
38
  host, so signing in to a staging deployment never touches production. `FORMIST_TOKEN` supplies
39
39
  one for CI: used as-is, never written to disk, never refreshed.
@@ -99,7 +99,7 @@ remembered host: name it with `--host`, or the default (`formist`) is used.
99
99
  ### Writes
100
100
 
101
101
  Most commands that change data run as a dry run first and print what they would do; add
102
- `--apply` to commit. `fm update`, which applies a batch of changes transactionally, is slightly
102
+ `--apply` to commit. `fm participants dedupe`, which merges a group of duplicate rows, is slightly
103
103
  different: the dry run prints a plan token, and `--apply <token>` re-runs the dry run to confirm
104
104
  the plan still matches before committing. A handful of actions with no undo, such as `fm spaces
105
105
  --admin delete`, have no dry run at all and say so in their own `--help`.
@@ -30,9 +30,9 @@
30
30
  - **先说清楚来源,再动手。** 每条命令都会报告它解析出的部署和空间,以及这些值是
31
31
  从哪里来的:一个参数、一个记住的默认值,还是什么都没有。目标选错了,看屏幕就能
32
32
  发现,不用等出了事才知道。
33
- - **默认先试运行。** 会改数据的命令,先打印它会做什么,等着你传 `--apply`。批量
34
- 改动命令 `fm update` 更进一步:提交前会重新核对这份计划是否还和刚才的试运行一
35
- 致,防止一次过时的读取变成一次错误的写入。
33
+ - **默认先试运行。** 会改数据的命令,先打印它会做什么,等着你传 `--apply`。合并
34
+ 重复行的 `fm participants dedupe` 更进一步:提交前会重新核对这份计划是否还和刚
35
+ 才的试运行一致,防止一次过时的读取变成一次错误的写入。
36
36
  - **凭证按部署分开存。** `fm login` 把 OAuth 凭证存成 `0600` 权限的文件,每个部署
37
37
  一个文件,登录测试环境绝不会动到生产环境。CI 场景用 `FORMIST_TOKEN` 提供凭证:
38
38
  读到就用,不落盘,不自动刷新。
@@ -98,10 +98,10 @@ fm kb search "venue contract" --space <space-id>
98
98
  ### 写操作
99
99
 
100
100
  大多数会改数据的命令都会先试运行,打印出它会做什么;加上 `--apply` 才会真正提交。
101
- `fm update` 稍微不一样,它会批量提交一组改动:试运行会打印一个计划令牌(plan
102
- token),`--apply <令牌>` 会重新跑一次试运行,确认这份计划还和当初一致,然后才提
103
- 交。少数不可撤销的操作,比如 `fm spaces --admin delete`,根本没有试运行这一步,
104
- 各自的 `--help` 里会写清楚。
101
+ `fm participants dedupe` 稍微不一样,它会合并一组重复记录:试运行会打印一个计划
102
+ 令牌(plan token),`--apply <令牌>` 会重新跑一次试运行,确认这份计划还和当初一
103
+ 致,然后才提交。少数不可撤销的操作,比如 `fm spaces --admin delete`,根本没有试
104
+ 运行这一步,各自的 `--help` 里会写清楚。
105
105
 
106
106
  ### 命令
107
107
 
@@ -0,0 +1,10 @@
1
+ {
2
+ "hooks": {
3
+ "SessionStart": [
4
+ { "hooks": [ { "type": "command", "command": "fm task plugin-session-start" } ] }
5
+ ],
6
+ "UserPromptSubmit": [
7
+ { "hooks": [ { "type": "command", "command": "fm task plugin-prompt-refs" } ] }
8
+ ]
9
+ }
10
+ }
@@ -0,0 +1,7 @@
1
+ [
2
+ {
3
+ "name": "fm",
4
+ "command": "fm task monitor --here",
5
+ "description": "fm task: the owner's replies, briefs filed for this project/space"
6
+ }
7
+ ]
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "formist-cli"
7
- version = "0.1.0"
7
+ version = "0.2.0"
8
8
  description = "Command-line client for Formist and Evane deployments"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"