@skill-map/spec 0.45.1 → 0.47.0

package/schemas/view-slots.schema.json

@@ -13,8 +13,8 @@
         { "const": "card.footer.left", "description": "Counter chip in the left footer of the card." },
         { "const": "card.footer.right", "description": "Counter chip in the right footer of the card." },
         { "const": "graph.node.alert", "description": "Reserved corner badge on the graph node, special-case signals only. No core analyzer emits here; routine \"this node has a problem\" findings belong in `card.footer.right`." },
-        { "const": "inspector.header.badge.counter", "description": "Counter chip in the inspector header badge cluster." },
-        { "const": "inspector.header.badge.tag", "description": "Qualitative tag chip in the inspector header badge cluster." },
+        { "const": "inspector.header.badge", "description": "Unified badge in the inspector header cluster: icon and/or label and/or count, optional severity. Multi-cardinality, priority order, modeled on card.footer.left. Replaces the retired inspector.header.badge.counter and inspector.header.badge.tag sub-slots." },
+        { "const": "inspector.action.button", "description": "Action button in the inspector. Click dispatches a kernel Action by qualified id via POST /api/actions/:id. Always emitted; the payload `enabled` flag carries the dynamic condition (e.g. isStale for the bump button)." },
         { "const": "inspector.body.panel.breakdown", "description": "Top-N labeled values rendered as a bar chart in the inspector body." },
         { "const": "inspector.body.panel.records", "description": "Tabular data (rows × columns ≤ 50 × 6) in the inspector body." },
         { "const": "inspector.body.panel.tree", "description": "Recursive label/children hierarchy (depth ≤ 6, total ≤ 200) in the inspector body." },
@@ -78,8 +78,7 @@
                 "enum": [
                   "card.subtitle.left",
                   "card.footer.left",
-                  "card.footer.right",
-                  "inspector.header.badge.counter"
+                  "card.footer.right"
                 ]
               }
             }
@@ -96,6 +95,7 @@
     "payloads": {
       "description": "Per-slot payload schemas. The kernel validates `ctx.emitContribution(id, payload)` calls against the entry corresponding to the declared slot before persisting to `scan_contributions`. Off-shape payloads emit an `extension.error` event and drop silently (mirror of `emitLink` off-contract drop pattern). Slots that share a renderer share a payload shape; the schema is defined inline at each slot to keep lookups direct (no internal indirection).",
       "card.title.right": {
+        "title": "IconMarkerPayload",
         "type": "object",
         "additionalProperties": false,
         "properties": {
@@ -111,8 +111,8 @@
       "card.subtitle.left": { "$ref": "#/$defs/payloads/_counter" },
       "card.footer.left": { "$ref": "#/$defs/payloads/_counter" },
       "card.footer.right": { "$ref": "#/$defs/payloads/_counter" },
-      "inspector.header.badge.counter": { "$ref": "#/$defs/payloads/_counter" },
       "_counter": {
+        "title": "CounterPayload",
         "type": "object",
         "additionalProperties": false,
         "required": ["value"],
@@ -130,23 +130,105 @@
         },
         "description": "Single icon + integer pair, modelled after the `.sm-gnode__stat` rows in the card footer. Manifest requires `icon` (enforced by `IViewContribution.allOf` for every counter slot); payload carries `value`, optionally `severity` and `tooltip`. The manifest `label` is metadata (docs / plugin-doctor / aria-label) and is NOT rendered inline."
       },
-      "inspector.header.badge.tag": { "$ref": "#/$defs/payloads/_tag" },
-      "_tag": {
+      "inspector.header.badge": {
+        "title": "BadgePayload",
         "type": "object",
         "additionalProperties": false,
-        "required": ["label"],
         "properties": {
-          "label": {
+          "icon": { "$ref": "#/$defs/IconString" },
+          "label": { "type": "string", "minLength": 1, "maxLength": 32 },
+          "count": { "type": "integer", "minimum": 0 },
+          "severity": { "$ref": "#/$defs/Severity" },
+          "tooltip": { "type": "string", "maxLength": 256 }
+        },
+        "anyOf": [
+          { "required": ["icon"] },
+          { "required": ["label"] },
+          { "required": ["count"] }
+        ],
+        "description": "Unified inspector header badge. At least one of `icon`, `label`, `count` is required; optional `severity` tint and `tooltip`. Multi-cardinality slot (priority order, modeled on card.footer.left); a plugin extension may emit several. 'Empty' for `emitWhenEmpty` is the absence of `icon` AND `label` AND `count`. Replaces the retired `_counter`/`_tag` header sub-slots: a counter-style badge sets `count` (+`icon`), a tag-style badge sets `label` (+`severity`), the stale clock sets `icon` + `tooltip`."
+      },
+      "inspector.action.button": {
+        "title": "ActionButtonPayload",
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["actionId", "label", "enabled"],
+        "properties": {
+          "actionId": {
             "type": "string",
-            "minLength": 1,
-            "maxLength": 32,
-            "description": "Tag text (e.g. 'fresh', 'stale', '7d ago'). 'Empty' for `emitWhenEmpty` is `label === ''`."
+            "pattern": "^[a-z][a-z0-9-]*/[a-z][a-z0-9-]*$",
+            "description": "Qualified Action id `<plugin>/<action>` the click dispatches via POST /api/actions/:id. Resolved by the kernel registry; an unknown id makes the BFF answer 404."
           },
+          "label": { "type": "string", "minLength": 1, "maxLength": 48 },
+          "icon": { "$ref": "#/$defs/IconString" },
           "severity": { "$ref": "#/$defs/Severity" },
-          "tooltip": { "type": "string", "maxLength": 256 }
-        }
+          "enabled": {
+            "type": "boolean",
+            "description": "Dynamic gate. The button is ALWAYS emitted (the persistence upsert refreshes the row each scan); `false` renders it disabled. e.g. `isStale` for the bump button."
+          },
+          "disabledReason": {
+            "type": "string",
+            "maxLength": 128,
+            "description": "Tooltip shown when `enabled` is false."
+          },
+          "input": {
+            "type": "object",
+            "description": "Reserved (Step 2+). Static input merged into the dispatch body for parametrized actions that need no user prompt."
+          },
+          "prompt": {
+            "$ref": "#/$defs/payloads/_ActionPrompt",
+            "description": "Reserved (Step 3+). Declares an input-type prompt the UI collects before dispatching (enum-pick for stability, single-string for tags)."
+          },
+          "confirm": {
+            "type": "boolean",
+            "default": false,
+            "description": "Reserved. Require an extra confirm step before dispatch (destructive actions)."
+          }
+        },
+        "description": "An action button rendered in the inspector. The manifest declares only `{ slot: 'inspector.action.button' }`; the per-node payload carries the action id, label, and the dynamic `enabled` flag. Click dispatches the Action via POST /api/actions/:id. `emitWhenEmpty` does not apply (a button is always meaningful)."
+      },
+      "_ActionPrompt": {
+        "title": "ActionPrompt",
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["inputType", "paramKey", "label"],
+        "properties": {
+          "inputType": {
+            "$ref": "input-types.schema.json#/$defs/InputTypeName",
+            "description": "Input-type id from the closed catalog. The UI renders the matching control before dispatch (`single-string`, `enum-pick` and `string-list` today; other types degrade to a graceful 'unsupported' notice)."
+          },
+          "paramKey": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 48,
+            "description": "Key under which the collected value is placed in the dispatch `input` body."
+          },
+          "label": { "type": "string", "minLength": 1, "maxLength": 64 },
+          "defaultValue": {
+            "oneOf": [
+              { "type": "string" },
+              { "type": "array", "items": { "type": "string" } }
+            ],
+            "description": "Optional pre-filled value the UI seeds the control with before the user edits (e.g. a node's current tags for a `string-list` edit). String for scalar input-types, string array for list input-types."
+          },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["value", "label"],
+              "properties": {
+                "value": { "type": "string" },
+                "label": { "type": "string" }
+              }
+            },
+            "description": "Choice list for `enum-pick` / `enum-multipick` input types."
+          }
+        },
+        "description": "Reserved (Steps 3+). Declares a parameter the UI prompts for before dispatching the Action, reusing the input-type catalog. Step 1 actions (bump) omit it."
       },
       "graph.node.alert": {
+        "title": "AlertPayload",
         "type": "object",
         "additionalProperties": false,
         "properties": {
@@ -163,11 +245,12 @@
         "description": "Decoration on the graph node (corner badge / pin). At least one of `icon`, `severity`, `count` is required. 'Empty' for `emitWhenEmpty` is the absence of `icon` AND `count`. Hard cap 1 marker per node per plugin extension (slot config enforces)."
       },
       "inspector.body.panel.breakdown": {
+        "title": "BreakdownPayload",
         "type": "object",
         "additionalProperties": false,
-        "required": ["entries"],
+        "required": ["bars"],
         "properties": {
-          "entries": {
+          "bars": {
             "type": "array",
             "maxItems": 20,
             "items": {
@@ -180,11 +263,12 @@
                 "tooltip": { "type": "string", "maxLength": 256 }
               }
             },
-            "description": "Top-N labeled values rendered as a horizontal bar chart. Hard cap 20 entries (overflow rejected at validation, plugin should pre-truncate). 'Empty' for `emitWhenEmpty` is `entries.length === 0`."
+            "description": "Top-N labeled values rendered as a horizontal bar chart. Hard cap 20 bars (overflow rejected at validation, plugin should pre-truncate). 'Empty' for `emitWhenEmpty` is `bars.length === 0`."
           }
         }
       },
       "inspector.body.panel.records": {
+        "title": "RecordsPayload",
         "type": "object",
         "additionalProperties": false,
         "required": ["columns", "rows"],
@@ -227,6 +311,7 @@
         "description": "Recursive tree rendered as an indented hierarchy. Hard caps: max depth 6, max 200 total nodes per tree (validator enforces). 'Empty' for `emitWhenEmpty` is the root having no `children`."
       },
       "_TreeNode": {
+        "title": "TreeNode",
         "type": "object",
         "additionalProperties": false,
         "required": ["label"],
@@ -241,11 +326,12 @@
         }
       },
       "inspector.body.panel.key-values": {
+        "title": "KeyValuesPayload",
         "type": "object",
         "additionalProperties": false,
-        "required": ["entries"],
+        "required": ["pairs"],
         "properties": {
-          "entries": {
+          "pairs": {
             "type": "array",
             "maxItems": 50,
             "items": {
@@ -265,16 +351,17 @@
                 "tooltip": { "type": "string", "maxLength": 256 }
               }
             },
-            "description": "Flat key/value pairs (max 50). Renders as a definition list. 'Empty' for `emitWhenEmpty` is `entries.length === 0`."
+            "description": "Flat key/value pairs (max 50). Renders as a definition list. 'Empty' for `emitWhenEmpty` is `pairs.length === 0`."
           }
         }
       },
       "inspector.body.panel.link-list": {
+        "title": "LinkListPayload",
         "type": "object",
         "additionalProperties": false,
-        "required": ["entries"],
+        "required": ["links"],
         "properties": {
-          "entries": {
+          "links": {
             "type": "array",
             "maxItems": 100,
             "items": {
@@ -297,11 +384,12 @@
                 }
               }
             },
-            "description": "List of in-scope node paths (max 100). 'Empty' for `emitWhenEmpty` is `entries.length === 0`."
+            "description": "List of in-scope node paths (max 100). 'Empty' for `emitWhenEmpty` is `links.length === 0`."
           }
         }
       },
       "inspector.body.panel.markdown": {
+        "title": "MarkdownPayload",
         "type": "object",
         "additionalProperties": false,
         "required": ["markdown"],
@@ -314,6 +402,7 @@
         }
       },
       "topbar.nav.start": {
+        "title": "ScopeStatPayload",
         "type": "object",
         "additionalProperties": false,
         "required": ["value"],