tabwright 1.0.1 → 2.0.0

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.
@@ -1,141 +0,0 @@
1
- ---
2
- name: conan-config
3
- description: Search, read, inspect history and schemas, validate edits, manage drafts, publish, create, copy, and roll back domestic Conan/Buff Space_Enhanced_Config configs through the unified Tabwright conan-config capability. Use immediately for exact config URLs, config keywords, draft or history questions, and explicit config changes in cn-prod or cn-test. Run read operations autonomously; require a prepared immutable report, a structured semantic diff or definition preview, and explicit user confirmation for every write operation.
4
- ---
5
-
6
- # Conan Config
7
-
8
- Use `tabwright capability run conan-config`; never execute `conan-config` as a shell command.
9
-
10
- ## Select the environment
11
-
12
- Infer the environment from an exact URL:
13
-
14
- - `cn-prod`: `conan.zhenguanyu.com`, `buff.zhenguanyu.com`
15
- - `cn-test`: `ytkconan.zhenguanyu.com`, `buff-test.zhenguanyu.com`
16
-
17
- Pass `environment` explicitly when no URL is available. For a write, stop and resolve an ambiguous environment before preparing the change. Do not use this capability for overseas hosts.
18
-
19
- Capability runs write local run logs and artifacts under `~/.tabwright/capabilities/conan-config/`; use escalated execution in a Codex sandbox. If cookie auth is missing or expired, report the blocker and obtain approval before running:
20
-
21
- ```bash
22
- tabwright capability refresh-auth conan-config --browser user --json
23
- ```
24
-
25
- ## Run read operations directly
26
-
27
- Run these operations without confirmation:
28
-
29
- ```bash
30
- tabwright capability run conan-config --input-json '{"action":"list-spaces","environment":"cn-prod"}' --json
31
- tabwright capability run conan-config --input-json '{"action":"search","environment":"cn-test","query":"会员订单"}' --json
32
- tabwright capability run conan-config --input-json '{"action":"history","url":"<config-url>"}' --json
33
- tabwright capability run conan-config --input-json '{"action":"get-schema","url":"<config-url>"}' --json
34
- ```
35
-
36
- For an exact `Space_Enhanced_Config` URL, route or get it immediately:
37
-
38
- ```bash
39
- tabwright capability route "<config-url>" --json
40
- tabwright capability run conan-config --input-json '{"action":"get","url":"<config-url>"}' --json
41
- ```
42
-
43
- Use `historyIds` with `history` only when full historical values are needed. Keep large values out of chat and point to saved artifacts. Production artifacts retain the legacy path `artifacts/conan-config/<namespace>/<key>/`; test artifacts use `artifacts/conan-config/cn-test/<namespace>/<key>/`.
44
-
45
- ## Validate values
46
-
47
- Validate the complete target value, not only changed fields. Check:
48
-
49
- - Formily field types, required fields, enums, defaults, `x-validator`, and `x-reactions`
50
- - component semantics and nested array/object shapes
51
- - unchanged legacy fields that the schema may not expose
52
- - every path in the structured semantic Diff
53
- - suspicious test markers such as `ytk`, `.biz`, or `test` when targeting `cn-prod`
54
-
55
- Return a report with `passed`, `errors`, `warnings`, `warningsAccepted`, `environment`, the hashes and version fields returned by the prepare operation, and `summary`. Never mark warnings accepted unless the user explicitly accepts them.
56
-
57
- ## Change content
58
-
59
- Prepare the complete target value:
60
-
61
- ```bash
62
- tabwright capability run conan-config --input-json '{"action":"prepare-change","url":"<config-url>","value":<complete-target-json>,"changeSummary":"<summary>"}' --json
63
- ```
64
-
65
- Show `environment`, field paths, before/after values, warnings, and whether a draft exists. Then choose exactly one confirmed write:
66
-
67
- - Save without publishing: `save-draft` with `--confirm conan-config:save-draft`
68
- - Update and publish atomically: `apply-change` with `--confirm conan-config:apply-change`
69
-
70
- Pass the unchanged complete target value, summary, and validation report. Both operations recheck `environment`, `schemaId`, `updatedTime`, `sourceSha256`, and `targetSha256`. Do not overwrite an existing draft.
71
-
72
- ## Publish or discard a draft
73
-
74
- Prepare an existing draft:
75
-
76
- ```bash
77
- tabwright capability run conan-config --input-json '{"action":"prepare-publish-draft","url":"<config-url>"}' --json
78
- ```
79
-
80
- Validate `draftValue`, show the Diff against `currentValue`, the draft operator, environment, and warnings, then:
81
-
82
- - Publish with the unchanged validation report and `--confirm conan-config:publish-draft`.
83
- - Discard only after showing `configDraftId`, operator, environment, and Diff; pass the prepared `configDraftId` and `draftSha256` with `--confirm conan-config:discard-draft`.
84
-
85
- Treat discarding as destructive. Never retry a failed or partially completed draft write automatically.
86
-
87
- ## Create a config
88
-
89
- Resolve the target `groupingId` with `list-spaces` or `search`, then prepare:
90
-
91
- ```bash
92
- tabwright capability run conan-config --input-json '{"action":"prepare-create","environment":"cn-test","groupingId":123,"key":"CONFIG_KEY","name":"配置名称","desc":"配置描述","schemaId":456}' --json
93
- ```
94
-
95
- Show the complete definition, target root grouping, environment, Schema summary, and warnings. After confirmation, pass `environment`, `targetSha256`, and `groupingUpdatedTime` unchanged in `preparationReport`, then run `create` with `--confirm conan-config:create`.
96
-
97
- Creating a config does not create or edit a Schema. A `schemaId` of `0` means no Formily Schema and must be shown as a warning.
98
-
99
- ## Copy a config definition
100
-
101
- Prepare the source and target:
102
-
103
- ```bash
104
- tabwright capability run conan-config --input-json '{"action":"prepare-copy","sourceUrl":"<source-config-url>","groupingId":123,"targetKey":"CONFIG_KEY_COPY"}' --json
105
- ```
106
-
107
- Show the source, target, environment, target grouping, and `contentCopied: false`. The B-side copy flow copies metadata and reuses the source `schemaId`; it does not copy the source value. After confirmation, pass the unchanged preparation fields and run `copy` with `--confirm conan-config:copy`.
108
-
109
- If the user also wants content copied, create the target definition first, then run the normal `prepare-change` and `save-draft` or `apply-change` workflow on the new target.
110
-
111
- ## Roll back
112
-
113
- List history, choose one `historyId`, then prepare:
114
-
115
- ```bash
116
- tabwright capability run conan-config --input-json '{"action":"prepare-rollback","url":"<config-url>","historyId":123}' --json
117
- ```
118
-
119
- Validate the full historical value against its historical Schema. Show the environment, history record, Schema change, and semantic Diff. Stop if a draft exists. After confirmation, pass the unchanged report fields and run `rollback` with `--confirm conan-config:rollback`.
120
-
121
- Rollback creates and publishes a draft with operation type `backtrace`, then reads the live config back. Never retry it automatically.
122
-
123
- ## Confirmation discipline
124
-
125
- Never call a write operation directly from a raw user request. Always run its read-only prepare operation first, display the concrete target and side effect, and obtain confirmation for that exact prepared state.
126
-
127
- Use only these write confirmations:
128
-
129
- - `conan-config:save-draft`
130
- - `conan-config:apply-change`
131
- - `conan-config:publish-draft`
132
- - `conan-config:discard-draft`
133
- - `conan-config:create`
134
- - `conan-config:copy`
135
- - `conan-config:rollback`
136
-
137
- Do not use this capability to delete configs, manage groupings, create or edit Schemas, change favourites, or operate overseas environments.
138
-
139
- ## Report results
140
-
141
- Keep answers compact. Always report `environment`, `namespace`, `key`, `configId`, operation status, and verification result. For writes, also report `configDraftId` when present and state whether the change was published. Do not create extra export files unless requested.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: 'Conan 文案配置'
3
- short_description: '查询并安全管理国内正式与测试环境的 Conan 文案配置'
4
- default_prompt: 'Use $conan-config to inspect or safely change this domestic Conan copywriting config.'