@kiva/kv-components 8.21.0 → 8.21.1

package/docs/code-connect.md

@@ -144,6 +144,11 @@ case exactly, and the **`label` is a nested TEXT layer** read with `findText(...
 
 ## Publishing
 
+> **Publishing workflow (agents & humans):** for the step-by-step detect →
+> validate → reconcile → publish → verify flow, plus token setup, use the
+> **`publish-code-connect`** skill in `@kiva/kv-skills` (`kiva-design-to-code`
+> plugin). This section is the reference it defers to for authoring/reconciling.
+
 Publish writes the mapping to the **shared Figma org library** — every designer and
 engineer with access to that library sees the result. Do this deliberately, not as a
 side effect of another task:
@@ -197,9 +202,7 @@ to touch it to map a component — it's here for maintenance.
 - **Figma plan**: Org or Enterprise (Code Connect publish is gated on this).
 - **A published component** in a Figma team library — Code Connect maps to a published
   component's `node-id`, not a local/unpublished frame.
-- **`FIGMA_ACCESS_TOKEN`** with Code Connect write scope, as a local/CI environment
-  variable. **Never commit this token.** It's only required for `publish`; `parse` needs
-  no token.
+- **`FIGMA_ACCESS_TOKEN`** with Code Connect write scope, as a local environment variable (Code Connect write can't run in CI — see the `publish-code-connect` skill for why). **Never commit this token.** It's only required for `publish`; `parse` needs no token.
 - **A way to read the component's real property names/values** before writing or
   reconciling a mapping — the **Figma MCP server** (`get_context_for_code_connect` /
   `get_code_connect_suggestions`) preferred, or the `figma connect create <node-url>` CLI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiva/kv-components",
-  "version": "8.21.0",
+  "version": "8.21.1",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -113,5 +113,5 @@
   "dependencies": {
     "fuse.js": "^7.1.0"
   },
-  "gitHead": "13131d8cc45d84ab1bfe6b370feffb9d6c09a635"
+  "gitHead": "4a6cdd82691d5045a4a728788200bc1980898558"
 }