@genrtl/grtl 0.4.0 → 0.4.1

package/README.md

@@ -32,9 +32,18 @@ grtl setup --mcp --codex
 grtl setup --mcp --cursor --project
 ```
 
-Without `--cli` or `--mcp`, setup asks which mode to install.
-
-For Codex, Skills are installed under `.agents/skills` for project setup or
+Without `--cli` or `--mcp`, setup asks which mode to install.
+
+Installing a newer npm package does not modify Skills already written to an
+agent configuration directory. Run the matching setup command again after an
+upgrade to refresh the Skill. For example:
+
+```bash
+grtl setup --cli --cursor
+grtl setup --cli --cursor --project
+```
+
+For Codex, Skills are installed under `.agents/skills` for project setup or
 `~/.agents/skills` for global setup. MCP mode also updates
 `.codex/config.toml` or `~/.codex/config.toml`.
 

package/dist/index.js

@@ -381,15 +381,19 @@ Choose one tool:
 - \`genrtl_debug_search\` for lint, CDC, compile, synthesis, and RTL bugs
 
 Pass the complete engineering question in \`query\`. Add filters only when useful.`;
-var FALLBACK_CLI = `Use the \`grtl\` CLI for grounded RTL engineering knowledge.
+var FALLBACK_CLI = `Use the \`grtl\` CLI for grounded RTL engineering knowledge and reusable CBB installation.
 
-Choose one command:
+For knowledge retrieval, choose one command:
 - \`npx @genrtl/grtl@latest knowledge-search "<query>"\`
 - \`npx @genrtl/grtl@latest spec2rtl-search "<query>"\`
 - \`npx @genrtl/grtl@latest spec2plan-search "<query>"\`
 - \`npx @genrtl/grtl@latest verification-search "<query>"\`
 - \`npx @genrtl/grtl@latest debug-search "<query>"\`
 
+To install a reusable RTL block into the current project:
+- \`npx @genrtl/grtl@latest cbb install <cbb_id>@<version>\`
+- Add \`--target <relative-dir>\` only when a non-default install path is needed.
+
 Pass the complete engineering question. Add filters such as \`--tool\`,
 \`--tool-version\`, \`--target\`, \`--interface\`, or \`--tag\` when known.
 If authentication fails, set \`GRTL_API_KEY\` or \`GENRTL_API_KEY\` in the
@@ -422,15 +426,15 @@ Pass the complete engineering question in \`query\`. Add \`filters\`, \`top_k\`,
 `;
 var CLI_SKILL = `---
 name: genrtl-cli
-description: Use the grtl CLI for grounded RTL design, verification, lint, CDC, synthesis, compile, and debugging knowledge.
+description: Use the grtl CLI for grounded RTL design, verification, debugging knowledge, and secure installation of reusable RTL CBBs.
 ---
 
 # GenRTL CLI
 
-Use this skill when an RTL engineering task needs grounded GenRTL knowledge and
-the GenRTL MCP server is not configured.
+Use this skill when an RTL engineering task needs grounded GenRTL knowledge or
+a reusable CBB must be installed into the user's local project.
 
-Choose exactly one command:
+For knowledge retrieval, choose exactly one command:
 
 - \`grtl knowledge-search "<query>" --json\` for cross-domain RTL questions.
 - \`grtl spec2rtl-search "<query>" --json\` for requirements, protocols, control logic, or algorithm-to-RTL work.
@@ -438,6 +442,12 @@ Choose exactly one command:
 - \`grtl verification-search "<query>" --json\` for testbenches and verification.
 - \`grtl debug-search "<query>" --json\` for lint, CDC, compile, synthesis, or RTL bugs.
 
+For a CBB selected from GenRTL search results:
+
+- \`grtl cbb install <cbb_id>@<version>\` downloads, verifies, and safely extracts it.
+- Add \`--target <relative-dir>\` only when the user requests a specific project path.
+- Do not download or extract the artifact manually; the CLI verifies SHA-256 and prevents unsafe ZIP paths.
+
 Pass the complete engineering question. Add filters such as \`--tool\`,
 \`--tool-version\`, \`--target\`, \`--interface\`, or \`--tag\` only when useful.
 The CLI requires \`GRTL_API_KEY\` or \`GENRTL_API_KEY\` in its environment.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genrtl/grtl",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "CLI, MCP, and coding-agent Skills for GenRTL RTL engineering knowledge",
   "type": "module",
   "bin": {