@bridge_gpt/mcp-server 0.2.10 → 0.2.12

package/smoke-test/SMOKE-TEST.md

@@ -84,13 +84,12 @@ Ask the user for the following before making any tool calls:
    `BAPI_API_KEY` can read (used for the Tier 1 read-only checks). It only needs
    to be readable — comments, attachments, tracked state, and generated
    artifacts are all optional.
-2. **Optional:** a **config field name** (for `get_config_field`).
+2. **Optional:** a **config field name** (for `config_field` with operation `"get"`).
 3. **Optional:** a **pipeline name** (for `get_pipeline_recipe`) — either a
    no-variable pipeline name (e.g. `learn-repository`) or, for a
    variable-declaring pipeline, the variable values it needs (e.g. a
    `ticket_key`).
-4. **Optional:** an **attachment identifier or filename** (for
-   `download_attachment` / `list_attachments`).
+4. **Optional:** an **attachment identifier or filename** (for `attachment` with operation `"download"` or `"list"`).
 5. **Optional:** any **artifact or task IDs** (e.g. a `task_id`, `brainstorm_id`,
    or commit ref) for retriever and CI tools.
 6. **Required decision:** explicit **Tier 3 consent** (Tier 3 spends tokens and
@@ -186,7 +185,7 @@ all local writes:
 
 There are **five heavy-read tools** whose successful oversized output is saved to
 disk before a truncated inline preview is returned: `get_project_standards`,
-`get_tickets`, `get_ticket`, `get_comments`, and `list_attachments`.
+`get_tickets`, `get_ticket`, `get_comments`, and `attachment` (operation: `"list"`).
 
 - When a heavy-read response begins with `[Response truncated. Full response
   saved locally.]` and carries a `Saved to <path>` note, grade it **`PASS`** as
@@ -210,8 +209,7 @@ default plus the read-only ticket checks when a readable ticket was supplied.
 ### All Tier 0 tools run by default
 
 `ping`, `get_my_role`, `get_docs_dir`, `get_project_standards`,
-`list_config_fields`, `list_pipelines`, `get_parse_status`,
-`list_pipeline_runs`.
+`list_pipelines`, `get_parse_status`, `list_pipeline_runs`.
 
 (The "fast-pass" list is the minimum release-blocking subset; the tier
 definition is "always run", so do not exclude the other Tier 0 tools.)
@@ -221,7 +219,7 @@ definition is "always run", so do not exclude the other Tier 0 tools.)
 Run `get_ticket`, `get_comments`, and `get_plan` against the user-supplied
 ticket.
 
-- **`get_comments` is preferred**; **`list_attachments` is the fallback** if
+- **`get_comments` is preferred**; **`attachment` (operation: `"list"`) is the fallback** if
   comments are unavailable for the selected ticket.
 - **`get_plan` must be called with a real boolean `save_locally: false`** (a true
   JSON boolean, not the string `"false"`).
@@ -246,7 +244,7 @@ supplied the relevant input; otherwise record `SKIP_USER_INPUT`.
 - `get_tickets` — a query/filter (a default project query is acceptable).
 - `get_ticket_state`, `get_jira_transitions`, `resolve_target_status` — the
   ticket key.
-- `get_config_field` — the optional config field name.
+- `config_field` (operation: `"get"`) — the optional config field name.
 - `get_pipeline_recipe` — a pipeline name. When no variables are supplied, use a
   no-variable pipeline such as `learn-repository` as the smoke target. A
   variable-declaring pipeline (e.g. a ticket-based pipeline) requires a
@@ -254,7 +252,7 @@ supplied the relevant input; otherwise record `SKIP_USER_INPUT`.
   BAD_REQUEST` with `Missing required variable(s)` is **working as designed**, not
   a server fault — rerun with the required variables or pick a no-variable
   pipeline.
-- `list_attachments` / `download_attachment` — the optional attachment input.
+- `attachment` (operation: `"list"` or `"download"`) — the optional attachment input.
 - The clean-empty artifact retrievers `get_architecture`,
   `get_clarifying_questions`, `get_ticket_critique` — grade a clean empty result
   as `PASS_EXPECTED_404` and valid content as `PASS`.
@@ -489,12 +487,12 @@ and raw protocol noise.** Sensitive values are redacted.
 
 ---
 
-## Full 62-Tool Smoke Tier Matrix
+## Full 58-Tool Smoke Tier Matrix
 
 Every registered MCP tool appears **exactly once** below with its smoke tier.
 Tier 4 (mutating/hazardous) tools are **deferred in v1**.
 
-Coverage reconciliation: **8 + 22 + 1 + 12 + 19 = 62**.
+Coverage reconciliation: **7 + 19 + 1 + 12 + 19 = 58** (BAPI-443 Phase 3a: `list_config_fields` merged into `config_field`; `get_config_field`/`list_attachments`/`download_attachment` merged into `config_field`/`attachment`).
 
 | Tier | Tool | Default action / expected-empty / special handling |
 |---|---|---|
@@ -502,7 +500,6 @@ Coverage reconciliation: **8 + 22 + 1 + 12 + 19 = 62**.
 | Tier 0 | `get_my_role` | Zero-input read; always run. |
 | Tier 0 | `get_docs_dir` | Zero-input read; always run; call first to anchor writes. |
 | Tier 0 | `get_project_standards` | Zero-input heavy read; always run; may save/truncate oversized output under `project-standards/`. |
-| Tier 0 | `list_config_fields` | Zero-input read; always run. |
 | Tier 0 | `list_pipelines` | Zero-input read; always run. |
 | Tier 0 | `get_parse_status` | Zero-input read; always run. |
 | Tier 0 | `list_pipeline_runs` | Zero-input read; always run. |
@@ -523,9 +520,6 @@ Coverage reconciliation: **8 + 22 + 1 + 12 + 19 = 62**.
 | Tier 1 | `get_ticket_state` | Read-only; needs ticket key; v1 read-only reaches the clean "not tracked" 404; full state requires deferred Tier 4 `track_ticket`. |
 | Tier 1 | `get_jira_transitions` | Read-only; needs ticket key. |
 | Tier 1 | `resolve_target_status` | Read-only; needs ticket key. |
-| Tier 1 | `get_config_field` | Read-only; needs a config field name. |
-| Tier 1 | `list_attachments` | Read-only; needs ticket key; comments-fallback tool. |
-| Tier 1 | `download_attachment` | Tier 1 network read; secondary **path-canary** — saves locally only when an attachment input is supplied; omit `file_path` or keep any override under `get_docs_dir`. |
 | Tier 1 | `poll_ci_checks` | `available:true` with empty or populated checks is `PASS`; `SKIP_NOT_APPLICABLE` when disabled with `TOOL_DISABLED`/503, or when `resolve_ci_checks` has not populated CI configuration. |
 | Tier 1 | `get_pipeline_recipe` | Read-only; needs a pipeline name plus required variables for variable-declaring pipelines; use `learn-repository` as the no-variable smoke target. |
 | Tier 2 | `generate_decision_page` | Local-only file-write canary; always run with the verbatim payload above. |
@@ -544,11 +538,11 @@ Coverage reconciliation: **8 + 22 + 1 + 12 + 19 = 62**.
 | Tier 4 | `create_ticket` | Mutating; deferred in v1. |
 | Tier 4 | `add_comment` | Mutating; deferred in v1. |
 | Tier 4 | `update_ticket_description` | Mutating; deferred in v1. |
-| Tier 4 | `upload_attachment` | Mutating; deferred in v1. |
+| Tier 4 | `attachment` | Discriminated-union: `upload`/`download`/`list`; classified Tier 4 (upload is mutating); deferred in v1. |
 | Tier 4 | `track_ticket` | Mutating; deferred in v1. |
 | Tier 4 | `update_ticket_state` | Mutating; deferred in v1. |
 | Tier 4 | `update_jira_status` | Mutating; deferred in v1. |
-| Tier 4 | `update_config_field` | Mutating; deferred in v1. |
+| Tier 4 | `config_field` | Discriminated-union: `get`/`update`/`list`; classified Tier 4 (update is mutating); deferred in v1. |
 | Tier 4 | `create_pull_request` | Mutating; deferred in v1. |
 | Tier 4 | `resolve_ci_checks` | Cache-mutating/orchestration; deferred in v1. |
 | Tier 4 | `run_pipeline` | Orchestration (can dispatch mutating tools); deferred in v1. |