formist-cli 0.1.1__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.
- formist_cli-0.2.0/.claude-plugin/plugin.json +9 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/PKG-INFO +4 -4
- {formist_cli-0.1.1 → formist_cli-0.2.0}/README.ar.md +3 -3
- {formist_cli-0.1.1 → formist_cli-0.2.0}/README.fr.md +5 -5
- {formist_cli-0.1.1 → formist_cli-0.2.0}/README.md +3 -3
- {formist_cli-0.1.1 → formist_cli-0.2.0}/README.zh-CN.md +7 -7
- formist_cli-0.2.0/hooks/hooks.json +10 -0
- formist_cli-0.2.0/monitors/monitors.json +7 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/pyproject.toml +1 -1
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/cli.py +398 -80
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/cli_support.py +19 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/connectors.py +22 -5
- formist_cli-0.2.0/src/formist_cli/plugin_hooks.py +239 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/privileges.py +71 -51
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/projects.py +7 -3
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/skills.py +8 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/spaces.py +41 -2
- formist_cli-0.2.0/src/formist_cli/task_archive.py +277 -0
- formist_cli-0.2.0/src/formist_cli/task_assignee.py +34 -0
- formist_cli-0.2.0/src/formist_cli/task_attach.py +102 -0
- formist_cli-0.2.0/src/formist_cli/task_check.py +261 -0
- formist_cli-0.2.0/src/formist_cli/task_cloud.py +570 -0
- formist_cli-0.2.0/src/formist_cli/task_duration.py +73 -0
- formist_cli-0.2.0/src/formist_cli/task_filter.py +87 -0
- formist_cli-0.2.0/src/formist_cli/task_format.py +90 -0
- formist_cli-0.2.0/src/formist_cli/task_fuzzy_date.py +432 -0
- formist_cli-0.2.0/src/formist_cli/task_identity.py +63 -0
- formist_cli-0.2.0/src/formist_cli/task_import.py +301 -0
- formist_cli-0.2.0/src/formist_cli/task_intake.py +55 -0
- formist_cli-0.2.0/src/formist_cli/task_json.py +233 -0
- formist_cli-0.2.0/src/formist_cli/task_lock.py +65 -0
- formist_cli-0.2.0/src/formist_cli/task_mirror.py +158 -0
- formist_cli-0.2.0/src/formist_cli/task_model.py +230 -0
- formist_cli-0.2.0/src/formist_cli/task_monitor.py +353 -0
- formist_cli-0.2.0/src/formist_cli/task_parse.py +657 -0
- formist_cli-0.2.0/src/formist_cli/task_paths.py +191 -0
- formist_cli-0.2.0/src/formist_cli/task_project.py +78 -0
- formist_cli-0.2.0/src/formist_cli/task_questions.py +181 -0
- formist_cli-0.2.0/src/formist_cli/task_queue.py +95 -0
- formist_cli-0.2.0/src/formist_cli/task_ref.py +72 -0
- formist_cli-0.2.0/src/formist_cli/task_search.py +24 -0
- formist_cli-0.2.0/src/formist_cli/task_serialize.py +344 -0
- formist_cli-0.2.0/src/formist_cli/task_sessions.py +225 -0
- formist_cli-0.2.0/src/formist_cli/task_status.py +133 -0
- formist_cli-0.2.0/src/formist_cli/task_store.py +1370 -0
- formist_cli-0.2.0/src/formist_cli/task_title.py +29 -0
- formist_cli-0.2.0/src/formist_cli/task_views.py +418 -0
- formist_cli-0.2.0/src/formist_cli/task_width.py +21 -0
- formist_cli-0.2.0/src/formist_cli/task_yaml.py +361 -0
- formist_cli-0.2.0/src/formist_cli/tasks.py +1685 -0
- formist_cli-0.2.0/src/formist_cli/workflow_corpus.py +27 -0
- formist_cli-0.2.0/src/formist_cli/workflow_golden.json +41 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/1-plain-task-example.md +22 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/10-title-with-colon-and.md +22 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/2-decision-with-two-op.md +40 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/4-a-brief-for-ai.md +13 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/6-a-milestone.md +12 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/7-node-with-sub-questi.md +27 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/8-needs-acceptance.md +34 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/active/9-dependent-node.md +13 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/archived/3-fyi-entry.md +12 -0
- formist_cli-0.2.0/tests/fixtures/task_decisions/archived/5-for-the-owner.md +13 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_admin_flag_gate.py +76 -10
- formist_cli-0.2.0/tests/test_chat_group.py +99 -0
- formist_cli-0.2.0/tests/test_connector_group.py +94 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_context.py +8 -4
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_login.py +12 -5
- formist_cli-0.2.0/tests/test_moved_to_fmdev.py +129 -0
- formist_cli-0.2.0/tests/test_plugin_hooks.py +195 -0
- formist_cli-0.2.0/tests/test_plugin_manifest.py +66 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_privileges.py +16 -7
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_settings.py +21 -7
- formist_cli-0.2.0/tests/test_skill_group.py +126 -0
- formist_cli-0.2.0/tests/test_spaces_set_logo.py +96 -0
- formist_cli-0.2.0/tests/test_task_archive_read_only.py +246 -0
- formist_cli-0.2.0/tests/test_task_check.py +289 -0
- formist_cli-0.2.0/tests/test_task_cli.py +724 -0
- formist_cli-0.2.0/tests/test_task_cloud.py +638 -0
- formist_cli-0.2.0/tests/test_task_fuzzy_date.py +84 -0
- formist_cli-0.2.0/tests/test_task_import.py +102 -0
- formist_cli-0.2.0/tests/test_task_import_archive.py +325 -0
- formist_cli-0.2.0/tests/test_task_mirror.py +83 -0
- formist_cli-0.2.0/tests/test_task_monitor.py +161 -0
- formist_cli-0.2.0/tests/test_task_nod_interop.py +289 -0
- formist_cli-0.2.0/tests/test_task_parse_serialize.py +130 -0
- formist_cli-0.2.0/tests/test_task_ref.py +17 -0
- formist_cli-0.2.0/tests/test_task_sessions.py +177 -0
- formist_cli-0.2.0/tests/test_task_store.py +399 -0
- formist_cli-0.2.0/tests/test_task_views.py +132 -0
- formist_cli-0.2.0/tests/test_task_workflow_parity.py +213 -0
- formist_cli-0.2.0/tests/test_task_yaml.py +84 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/uv.lock +1 -1
- {formist_cli-0.1.1 → formist_cli-0.2.0}/.github/workflows/release.yml +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/.github/workflows/test.yml +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/.gitignore +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/LICENSE +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/docs/screenshot.png +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/docs/screenshot.svg +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/scripts/render_screenshot.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/__init__.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/__main__.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/airtable.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/alerts.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/api.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/chat.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/chats.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/context.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/diff.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/doctor.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/export.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/files.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/importer.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/kb.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/login.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/logs.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/meetings.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/messages.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/participants.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/prefs.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/resolve.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/settings.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/skill_library.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/space_plan.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/targets.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/textnorm.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/tokens.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/update.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/uploads.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/usage_tokens.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/users.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/src/formist_cli/whatsapp.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_airtable.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_alerts.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_api_and_tokens.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_api_uploads_transport.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_audit_log_shows_the_newest.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_chat.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_chat_message.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_chats.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_cli_registration_is_unique.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_connector_ops.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_connectors.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_diff.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_doctor.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_export.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_files.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_files_download.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_files_merge.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_grants_render.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_help_matches_the_write_guard.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_importer.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_kb.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_logs.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_meetings.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_messages.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_participants.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_prefs.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_projects.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_proposals.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_render_screenshot.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_report_provenance.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_resolve.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_skill_library_install.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_skills.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_space_plan.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_spaces.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_stream_transport.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_targets.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_update.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_upload_dir.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_uploads.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_usage_tokens.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_users.py +0 -0
- {formist_cli-0.1.1 → formist_cli-0.2.0}/tests/test_users_writes.py +0 -0
- {formist_cli-0.1.1 → 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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
40
|
-
revérifie que le plan correspond toujours avant de valider, pour qu'une lecture
|
|
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
|
|
113
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
102
|
-
token),`--apply <令牌>`
|
|
103
|
-
|
|
104
|
-
|
|
101
|
+
`fm participants dedupe` 稍微不一样,它会合并一组重复记录:试运行会打印一个计划
|
|
102
|
+
令牌(plan token),`--apply <令牌>` 会重新跑一次试运行,确认这份计划还和当初一
|
|
103
|
+
致,然后才提交。少数不可撤销的操作,比如 `fm spaces --admin delete`,根本没有试
|
|
104
|
+
运行这一步,各自的 `--help` 里会写清楚。
|
|
105
105
|
|
|
106
106
|
### 命令
|
|
107
107
|
|