@plasmickit/cli 0.0.57 → 0.0.59

package/package.json

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

package/skill/plasmic/SKILL.md

@@ -1,23 +1,24 @@
 ---
 name: plasmic
-description: Design, revise, and verify editable product prototypes in self-hosted Plasmic, or read Plasmic pages and generate native React project code under maintained engineering standards. Use for Plasmic product prototyping and design-to-code development.
+description: Explain or review self-hosted Plasmic pages, components and templates; create or revise editable prototypes; implement or update native React project code from Plasmic designs. Use for Plasmic model/template inspection, prototype design and design-to-code work.
 ---
 
 # Plasmic
 
 This is a bootstrap skill. Workflows, component guidance and verification scripts live in a versioned resource bundle on the NAS, outside this installed skill.
 
-At the start of each task, choose `prototype` for product design or `codegen` for code generation and integration. Run:
+Choose the task mode before work: `inspect` for read-only page/template explanation or design review, `prototype` for design edits, or `codegen` for native React implementation and updates. Run the matching command:
 
 ```sh
+npx -y @plasmickit/cli@latest context resolve --mode inspect
 npx -y @plasmickit/cli@latest context resolve --mode prototype
-# Or: npx -y @plasmickit/cli@latest context resolve --mode codegen
+npx -y @plasmickit/cli@latest context resolve --mode codegen
 ```
 
-In `codegen` mode, read page models, component contracts and interactions through Desktop MCP, then implement code in the target project's architecture. Generation follows the returned standards; it does not use `export_code` or the official Plasmic CLI.
+Inspect uses accessible Desktop MCP reads and does not require edit permission or save/change designs. Prototype mutations require edit permission. Codegen reads models/contracts through MCP and writes code in the target architecture; it does not use `export_code` or official Plasmic sync. For explicitly requested official `@plasmicapp/cli` integration, resolve inspect and follow the guide's official-CLI reference instead of replacing that request with native coding.
 
-The command checks the NAS release manifest every time, downloads changed resources and verifies their hashes before returning absolute paths. Read all returned `mustRead` files, starting with `referencePath`; resolve subsequent links relative to the reference file. Use the returned `resourceRoot` for verification scripts. For a task spanning both modes, resolve and read each mode before its work begins.
+The command checks the NAS release manifest every time, downloads changed resources and verifies their hashes before returning absolute paths. Read all returned `mustRead` files, starting with `referencePath`; resolve subsequent links relative to the reference file. Use the returned `resourceRoot` for verification scripts. For a task spanning multiple modes, resolve and read each mode before its work begins.
 
-The runner uses the latest published Plasmic CLI. Later commands can use `npx -y @plasmickit/cli@<cliVersion>` from the result to keep the task on that CLI version, or the global `plasmickit` after checking `plasmickit version check`.
+The runner uses the latest published `@plasmickit/cli`, distinct from official `@plasmicapp/cli`. Later commands can use `npx -y @plasmickit/cli@<cliVersion>` from the result to keep the task on that CLI version, or the global `plasmickit` after checking `plasmickit version check`.
 
 If the command fails, stop dependent work and report the error. Do not silently use cached references. If it requires a newer CLI before npm has that version, install the returned `cliUrl` with `npm install -g <cliUrl>` and rerun. Do not copy the resource bundle into this skill or treat an old transcript as the current component contract.

package/src/index.mjs

@@ -11,7 +11,7 @@ const usage = `plasmickit commands:
   skill install [--dry-run]
   version check [--feed HTTPS_URL]
   references check|update|path [--feed HTTPS_URL] [--home CACHE_ROOT]
-  context resolve --mode prototype|codegen [--feed HTTPS_URL] [--home CACHE_ROOT]
+  context resolve --mode inspect|prototype|codegen [--feed HTTPS_URL] [--home CACHE_ROOT]
   --version
 `;
 export async function main(argv) {

package/src/protocol.mjs

@@ -4,13 +4,12 @@ import { createRequire } from "node:module";
 
 export const DEFAULT_FEED = "https://studio.plasmic.shiguanglab.com/desktop-updates/plasmic";
 export const CLI_VERSION = createRequire(import.meta.url)("../package.json").version;
-export const MIN_CLI_VERSION = "0.0.34";
-export const CODEGEN_REFERENCES = [
-  "references/codegen/page-reading.md",
-  "references/codegen/project-code.md",
-  "references/codegen/interactions.md",
-  "references/codegen/acceptance.md",
-];
+export const MIN_CLI_VERSION = "0.0.59";
+export const MODE_REFERENCES = {
+  inspect: ["references/model-reading.md"],
+  prototype: [],
+  codegen: ["references/model-reading.md", "references/codegen/project-code.md", "references/codegen/acceptance.md"],
+};
 export function compareVersions(a, b) {
   const parse = (version) => {
     if (typeof version !== "string" || !/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.test(version)) throw new Error(`Invalid stable version: ${version}`);
@@ -53,13 +52,13 @@ export function validateManifest(manifest) {
     }
     files.set(file.path, file);
   }
-  for (const mode of ["guide", "prototype", "codegen"]) {
+  for (const mode of ["guide", ...Object.keys(MODE_REFERENCES)]) {
     const entry = manifest.entrypoints?.[mode];
     if (!files.has(entry) || !entry.startsWith("references/") || !entry.endsWith(".md")) throw new Error(`Missing ${mode} entrypoint`);
   }
   if (!files.has("references/desktop-mcp.md")) throw new Error("Missing Desktop MCP reference");
-  for (const reference of CODEGEN_REFERENCES) {
-    if (!files.has(reference)) throw new Error(`Missing code-generation standard: ${reference}`);
+  for (const reference of new Set(Object.values(MODE_REFERENCES).flat())) {
+    if (!files.has(reference)) throw new Error(`Missing task reference: ${reference}`);
   }
   for (const [kind, name] of [["resources", "resources.json.gz"], ["cli", "plasmic-cli.tgz"]]) {
     const artifact = manifest.artifacts?.[kind];

package/src/references.mjs

@@ -1,7 +1,7 @@
 import { lstat, mkdir, mkdtemp, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import path from "node:path";
-import { artifactUrl, CLI_VERSION, CODEGEN_REFERENCES, feedUrl, MAX_BYTES, requiresNewCli, sha256, unpackResources, validateManifest } from "./protocol.mjs";
+import { artifactUrl, CLI_VERSION, MODE_REFERENCES, feedUrl, MAX_BYTES, requiresNewCli, sha256, unpackResources, validateManifest } from "./protocol.mjs";
 
 const cacheRoot = (options) => path.resolve(options.home || process.env.PLASMIC_RESOURCE_HOME || path.join(homedir(), ".cache", "plasmic"));
 async function download(url) {
@@ -139,8 +139,8 @@ export async function referencePath(options = {}) {
   return result(root, { manifest, cliUrl: artifactUrl(feedUrl(state.feed), manifest, "cli") }, { freshness: "unchecked" });
 }
 export async function resolveContext(mode, options = {}) {
-  if (!["prototype", "codegen"].includes(mode)) throw new Error("--mode must be prototype or codegen");
+  if (!Object.hasOwn(MODE_REFERENCES, mode)) throw new Error("--mode must be inspect, prototype or codegen");
   const { manifest, ...resources } = await updateReferences(options);
-  const references = [manifest.entrypoints.guide, "references/desktop-mcp.md", manifest.entrypoints[mode], ...(mode === "codegen" ? CODEGEN_REFERENCES : [])];
+  const references = [manifest.entrypoints.guide, "references/desktop-mcp.md", manifest.entrypoints[mode], ...MODE_REFERENCES[mode]];
   return { ...resources, mode, mustRead: references.map((reference) => path.join(resources.resourceRoot, reference)) };
 }