@plasmickit/cli 0.2.6 → 0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasmickit/cli",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Plasmic skill bootstrap and NAS workflow resource manager",
   "license": "MIT",
   "repository": {

package/skill/plasmic/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: plasmic
-description: Inspect self-hosted Plasmic pages and templates, create or revise editable prototypes, and implement native React code from Plasmic designs.
+compatibility: Requires Node.js >=22.12, Python >=3.9 available as python3, and signed-in Plasmic Desktop MCP for design inspection or editing.
+description: Inspect self-hosted Plasmic pages and templates, create or revise editable Plasmic prototypes, and implement native React code from Plasmic designs. Use for Plasmic Studio/Desktop MCP work such as 原型设计, 后台页面原型 (list/form/detail pages), 按需求或线框/设计稿生成页面, 解读模板或页面, and 根据 Plasmic 设计生成代码. Not for generic React pages without a Plasmic design, or for developing the Plasmic platform itself.
 ---
 
 # Plasmic
@@ -23,7 +24,7 @@ npx -y @plasmickit/cli@latest context resolve --mode codegen
 
 Read every returned `mustRead` file, starting with `referencePath`. Resolve linked documents from the returned `resourceRoot`; follow the workflow's scenario-specific reading and evidence requirements. Resource readiness does not mean the documents have been read. For a task spanning modes, resolve and read each workflow before its work begins.
 
-The published resolver checks the NAS release manifest and verifies resource hashes. Stop dependent work on failure; do not silently use stale references. If it requires a newer CLI before npm has that version, install its returned `cliUrl` and rerun. Relay meaningful preparation progress from stderr; stdout contains the result. Report local versus published resources accurately.
+Both resolvers verify that Python 3.9+ is available as `python3` for reference readers and gates. The published resolver also checks the NAS release manifest and verifies resource hashes. Stop dependent work on failure; do not silently use stale references. If it requires a newer CLI before npm has that version, install its returned `cliUrl` and rerun. Relay meaningful preparation progress from stderr; stdout contains the result. Report local versus published resources accurately.
 
 ## Ensure Desktop MCP access
 

package/src/progress.mjs

@@ -1,4 +1,5 @@
 const labels = {
+  runtime: ["运行环境", "正在检查运行环境", "运行环境检查通过"],
   manifest: ["版本检查", "正在检查版本", "版本检查完成"],
   download: ["资源下载", "正在下载资源", "下载完成"],
   verify: ["资源校验", "正在校验资源", "校验通过"],

package/src/references.mjs

@@ -10,6 +10,7 @@ import {
 import { homedir } from "node:os";
 import path from "node:path";
 import { withProgress } from "./progress.mjs";
+import { verifyRuntime } from "./runtime.mjs";
 import {
   CLI_VERSION,
   MAX_BYTES,
@@ -341,6 +342,7 @@ export async function resolveContext(mode, options = {}) {
   if (!Object.hasOwn(MODE_REFERENCES, mode)) {
     throw new Error("--mode must be inspect, prototype or codegen");
   }
+  const runtime = await withProgress(options, "runtime", verifyRuntime);
   const { manifest, ...resources } = await updateReferences(options);
   return withProgress(options, "workflow", (progress) => {
     const references = [
@@ -353,6 +355,6 @@ export async function resolveContext(mode, options = {}) {
       path.join(resources.resourceRoot, reference),
     );
     progress({ mode, mustRead });
-    return { ...resources, mode, mustRead };
+    return { ...resources, mode, mustRead, runtime };
   });
 }

package/src/runtime.mjs

@@ -0,0 +1,22 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execute = promisify(execFile);
+
+/** The bundled reference readers and verification scripts require Python 3.9+. */
+export async function verifyRuntime() {
+  let version;
+  try {
+    const { stdout } = await execute("python3", [
+      "-c", "import json,sys; print(json.dumps(list(sys.version_info[:3])))",
+    ], { timeout: 10000, maxBuffer: 4096 });
+    version = JSON.parse(stdout);
+  } catch (error) {
+    throw new Error("Plasmic workflows require Python 3.9+ available as python3. Install it or make it available on this client's PATH, then resolve context again.", { cause: error });
+  }
+  if (!Array.isArray(version) || version.length !== 3 || !version.every(Number.isInteger) ||
+      version[0] < 3 || (version[0] === 3 && version[1] < 9)) {
+    throw new Error("Plasmic workflows require Python 3.9+ available as python3; the detected version is unsupported. Update it, then resolve context again.");
+  }
+  return { node: process.versions.node, python: { command: "python3", version: version.join(".") } };
+}