@rasmusengelbrecht/pi-semantic-query 0.1.3 → 0.1.4

package/README.md

@@ -8,14 +8,14 @@ It gives pi tools to discover metrics, inspect definitions, validate a model, an
 
 - pi coding agent
 - Node/npm for installing the pi package
-- `semantic-query-compiler` installed so the `semantic` CLI is on `PATH`
+- `semantic-query-compiler >= 0.1.2` installed so the `semantic` CLI is on `PATH`
 - a semantic model in the project, usually `semantic.yml`
 
 Install the Python compiler first:
 
 ```bash
-uv tool install 'semantic-query-compiler @ git+https://github.com/rasmusengelbrecht/semantic-query-compiler.git'
-semantic --help
+uv tool install 'semantic-query-compiler>=0.1.2'
+semantic --version
 ```
 
 ## Install in pi
@@ -50,7 +50,13 @@ The package registers a bundled `semantic-query` skill plus these pi tools:
 
 The skill teaches pi the default workflow: search before guessing metric IDs, describe ambiguous metrics, validate model changes, prefer `period`, and never present compiled SQL as executed results.
 
-All tools shell out to the local `semantic` CLI. By default they look for one of:
+All tools shell out to the local `semantic` CLI. If target relation flags fail with `unrecognized arguments`, upgrade the Python CLI:
+
+```bash
+uv tool install 'semantic-query-compiler>=0.1.2' --force
+```
+
+By default tools look for one of:
 
 - `semantic.yml`
 - `semantic.yaml`

package/extensions/semantic-query.ts

@@ -116,6 +116,13 @@ function runSemantic(
       const result = { stdout, stderr, command: [command, ...args] };
       if (error) {
         const message = stderr.trim() || error.message;
+        if (message.includes("unrecognized arguments") && (message.includes("--target-project") || message.includes("--target-schema"))) {
+          reject(new Error(
+            `${command} failed because targetProject/targetSchema require semantic-query-compiler >= 0.1.1. `
+              + `Upgrade the Python CLI with: uv tool install semantic-query-compiler>=0.1.2 --force. Original error: ${message}`,
+          ));
+          return;
+        }
         reject(new Error(`${command} failed: ${message}`));
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasmusengelbrecht/pi-semantic-query",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Compile and inspect governed semantic metrics from pi coding agent",
   "keywords": [
     "pi-package",

package/skills/semantic-query/SKILL.md

@@ -7,6 +7,8 @@ description: Compile and inspect governed semantic metrics with semantic-query-c
 
 Use the `semantic_*` tools from this package to discover governed metrics and compile inspectable SQL. These tools do **not** execute warehouse queries.
 
+This package shells out to the local `semantic` CLI and expects `semantic-query-compiler >= 0.1.2`. If a tool reports `unrecognized arguments` for target relation flags, tell the user to upgrade with `uv tool install 'semantic-query-compiler>=0.1.2' --force` and verify `semantic --version`.
+
 ## Default workflow
 
 1. Start with `semantic_search_metrics` when the user describes a metric in business language.