@vention/vention-skills 0.9.5 → 0.9.6

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "vention",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "author": {
     "name": "Vention"

package/README.md

@@ -1,6 +1,6 @@
 # Vention skills
 
-Version 0.9.5. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
+Version 0.9.6. Skills for coding agents that work with Vention machines, packaged as one plugin, `vention`, in the `vention-skills` marketplace.
 
 | Skill                       | What it does                                                                                                                         |
 | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vention/vention-skills",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "license": "MIT",
   "type": "module",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "vention",
-  "version": "0.9.5",
+  "version": "0.9.6",
   "description": "Vention skills for coding agents: write MachineLogic applications, build machine designs, and diagnose deployed machines.",
   "author": {
     "name": "Vention"

package/skills/vention-design/SKILL.md

@@ -3,7 +3,7 @@ name: vention-design
 description: Create, build and edit Vention machine designs and design graphs for agentic layout. Use when the user wants to start a new design, lay out an automation cell, add or reposition components in a Vention design, generate a machine layout from a description, add or place a floor plan image under a design, list a design's versions, or inspect an existing design graph. Trigger on MachineBuilder designs, design graphs, assembly graphs, extrusions, actuators, robot mounting, cell footprints, floor plans, or a machine-builder URL.
 license: MIT
 metadata:
-  version: "0.9.5"
+  version: "0.9.6"
   author: Vention
 ---
 

package/skills/vention-machine-logic/SKILL.md

@@ -3,7 +3,7 @@ name: vention-machine-logic
 description: Write, edit, validate, and deploy MachineLogic Python applications for Vention machines with the machine-logic-sdk and the Vention CLI. Use when the user wants to program a Vention machine or MachineMotion controller, drive actuators, conveyors, robots, pneumatics, or digital I/O from Python, build a state machine for a cell, debug a failing application from its logs, or pull, push, or link an application with the Vention CLI (vention or vn). Trigger on MachineLogic, machine-logic-sdk, MachineMotion, MachineBuilder applications, or the Vention CLI, including inside a directory that holds .machine-code-app-directory-info.json. Do not use when the user has asked for no program at all and only wants an existing machine, its parts, or its configuration explained back to them in words; a read-only script that prints what the machine reports is still a program.
 license: MIT
 metadata:
-  version: "0.9.5"
+  version: "0.9.6"
   machine-logic-sdk: ">=3.0,<4"
   author: Vention
 ---

package/skills/vention-machine-logic/scripts/vention-docs.py

@@ -24,6 +24,7 @@ from __future__ import annotations
 
 import argparse
 import http.client
+import os
 import re
 import sys
 import urllib.request
@@ -33,6 +34,7 @@ from typing import IO, NoReturn
 from urllib.parse import urljoin, urlsplit
 
 INDEX_URL = "https://docs.vention.com/llms.txt"
+INDEX_URL_ENV = "VENTION_DOCS_INDEX_URL"
 PACKAGE = "machine-logic-sdk"
 TIMEOUT = 20
 ALLOWED_SCHEMES = frozenset({"http", "https", "file"})
@@ -44,6 +46,7 @@ REQUIREMENT_PATTERN = re.compile(
     re.IGNORECASE | re.MULTILINE,
 )
 EXACT_VERSION_PATTERN = re.compile(r"^\d+(\.\d+)+[\w.+-]*$")
+SERIES_TITLE_PATTERN = re.compile(rf"^(?:{re.escape(PACKAGE)}\s+)?(v\d+\.\d+)", re.IGNORECASE)
 CATCH_ALL_PATTERN = re.compile(rf"^(?:{re.escape(PACKAGE)}\s+)?v(?P<bound>\d+(?:\.\d+)*)\s+and\s+lower\b", re.IGNORECASE)
 
 
@@ -126,7 +129,7 @@ def page_for_version(entries: list[tuple[str, str]], version: str) -> Page:
                 return Page(stripped, url, "v" + ".".join(bound.split(".")[:2]))
         elif titled.match(stripped):
             return Page(stripped, url, wanted)
-    published = sorted({found.group(0) for title, _ in entries if (found := re.search(r"v\d+\.\d+", title))})
+    published = sorted({found.group(1) for title, _ in entries if (found := SERIES_TITLE_PATTERN.match(title.strip()))})
     unavailable(
         f"the docs publish no {PACKAGE} page for {wanted} (published: {', '.join(published) or 'none'}); "
         f"refusing to answer from another version"
@@ -139,7 +142,11 @@ def main() -> int:
     source.add_argument("--version", help="the exact SDK version to document, e.g. 3.1.0")
     source.add_argument("--from-requirements", metavar="PATH", help="read an exact machine-logic-sdk== pin from a requirements file")
     source.add_argument("--from-uv-lock", metavar="PATH", help="read the resolved machine-logic-sdk version from a uv lock file")
-    parser.add_argument("--index-url", default=INDEX_URL, help=f"documentation index to read (default: {INDEX_URL})")
+    parser.add_argument(
+        "--index-url",
+        default=os.environ.get(INDEX_URL_ENV) or INDEX_URL,
+        help=f"documentation index to read (default: ${INDEX_URL_ENV}, else {INDEX_URL})",
+    )
     output = parser.add_mutually_exclusive_group()
     output.add_argument("--print-url", action="store_true", help="print only the page URL")
     output.add_argument("--print-page", action="store_true", help="fetch the page and print it verbatim")

package/skills/vention-machine-logic-hmi/SKILL.md

@@ -3,7 +3,7 @@ name: vention-machine-logic-hmi
 description: Build or edit the custom operator HMI of a MachineLogic application, the React touch screen in customui/ that runs in MachineBuilder and on the MachineMotion pendant, wired to the application's Python process through vention-communication. Use when the user asks for an operator screen, a custom HMI or UI, a touch panel, start and stop buttons, live machine state on screen, or recipes an operator picks, for a Vention machine or inside a directory holding .machine-code-app-directory-info.json. Uses @vention/machine-ui, @vention/machine-apps-components and @vention/machine-logic-ui-sdk. Do not use for the no-code HMI Builder, or for the Python motion logic alone (that is vention-machine-logic).
 license: MIT
 metadata:
-  version: "0.9.5"
+  version: "0.9.6"
   author: Vention
 ---
 

package/skills/vention-monitoring/SKILL.md

@@ -3,7 +3,7 @@ name: vention-monitoring
 description: Diagnose deployed Vention machines from controller state, history, health, and activity data. Use when the user reports a machine that is down, faulted, offline, slow, or underperforming, asks why a cycle time regressed, wants to interpret MachineMotion event data or drive and brake status, asks about OEE or uptime, or wants to know which machine in a fleet needs attention. Trigger on a MachineMotion serial number plus any complaint.
 license: MIT
 metadata:
-  version: "0.9.5"
+  version: "0.9.6"
   author: Vention
 ---