@datashow/super-visual-cli 0.1.0-rc.1 → 0.1.0-rc.3

package/bin/supervisual.mjs

@@ -1,9 +1,16 @@
 #!/usr/bin/env node
-import { main } from "../src/main.mjs";
+import { main, stopActiveProgress } from "../src/main.mjs";
 
 main().catch((error) => {
+  stopActiveProgress();
   const json = process.argv.includes("--json");
   const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`${json ? JSON.stringify({ ok: false, error: message }) : `supervisual: ${message}`}\n`);
+  const summary = error?.summary ?? "Super Visual could not complete the command.";
+  const guidance = error?.guidance;
+  if (json) {
+    process.stderr.write(`${JSON.stringify({ ok: false, message: summary, ...(guidance ? { guidance } : {}), error: message })}\n`);
+  } else {
+    process.stderr.write(`\n${summary}\n${guidance ? `${guidance}\n` : ""}\nTechnical details: ${message}\n`);
+  }
   process.exitCode = 1;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datashow/super-visual-cli",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.3",
   "description": "CLI for validating, compiling, packaging, verifying, and deploying Super Visual projects.",
   "type": "module",
   "bin": {
@@ -25,10 +25,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@datashow/super-visual-adapter-claude-dashboard": "0.1.0-rc.1",
-    "@datashow/super-visual-compiler": "0.1.0-rc.1",
-    "@datashow/super-visual-contracts": "0.1.0-rc.1",
-    "@datashow/super-visual-fabric": "0.1.0-rc.1",
+    "@datashow/super-visual-adapter-claude-dashboard": "0.1.0-rc.3",
+    "@datashow/super-visual-compiler": "0.1.0-rc.3",
+    "@datashow/super-visual-contracts": "0.1.0-rc.3",
+    "@datashow/super-visual-fabric": "0.1.0-rc.3",
     "@fontsource/source-serif-4": "5.3.1",
     "@nivo/bar": "0.99.0",
     "@nivo/line": "0.99.0",

package/src/main.mjs

@@ -15,7 +15,30 @@ import { resolveProjectTarget, targetUpdate, writeProjectTarget } from "./projec
 import { runSemanticPreviewTest, startSemanticPreview } from "./semantic-preview.mjs";
 
 const run = promisify(execFile);
-const VERSION = "0.1.0-rc.1";
+const VERSION = "0.1.0-rc.3";
+const FABRIC_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const SPINNER_FRAMES = ["|", "/", "-", "\\"];
+const progressStream = process.stderr;
+let activeProgress = null;
+
+export class CliUserError extends Error {
+  constructor(message, { summary, guidance } = {}) {
+    super(message);
+    this.name = "CliUserError";
+    this.summary = summary;
+    this.guidance = guidance;
+  }
+}
+
+export function validateFabricId(value, optionName) {
+  if (value === undefined) return;
+  if (FABRIC_ID_PATTERN.test(value)) return;
+  const target = optionName === "--workspace-id" ? "workspace" : "semantic model";
+  throw new CliUserError(`${optionName} must be a 36-character GUID in 8-4-4-4-12 format; received "${value}" (${String(value).length} characters).`, {
+    summary: `Super Visual could not initialize the project because the ${target} ID is not valid.`,
+    guidance: `Copy the complete ${target} ID from Fabric and run the command again.`,
+  });
+}
 
 function projectFile(input = ".") {
   const resolved = path.resolve(input);
@@ -26,9 +49,33 @@ function output(value, json) {
   process.stdout.write(`${json ? JSON.stringify(value) : typeof value === "string" ? value : JSON.stringify(value, null, 2)}\n`);
 }
 
-function writeInitProgress(event) {
-  const marker = event.status === "passed" ? "✓" : "…";
-  process.stdout.write(`${marker} ${event.message}\n`);
+export function stopActiveProgress() {
+  if (!activeProgress) return;
+  clearInterval(activeProgress.timer);
+  progressStream.write(`\r${" ".repeat(activeProgress.width)}\r`);
+  activeProgress = null;
+}
+
+export function writeInitProgress(event) {
+  if (event.status === "running") {
+    stopActiveProgress();
+    progressStream.write(`> ${event.message}\n`);
+    if (!progressStream.isTTY) return;
+    let frame = 0;
+    const render = () => {
+      const line = `${SPINNER_FRAMES[frame % SPINNER_FRAMES.length]} Working...`;
+      progressStream.write(`\r${line}`);
+      activeProgress.width = Math.max(activeProgress.width, line.length);
+      frame += 1;
+    };
+    activeProgress = { timer: null, width: 12 };
+    render();
+    activeProgress.timer = setInterval(render, 120);
+    return;
+  }
+  stopActiveProgress();
+  const marker = event.status === "passed" ? "✓" : "!";
+  progressStream.write(`${marker} ${event.message}\n`);
 }
 
 function semanticInventory(model) {
@@ -275,13 +322,23 @@ function createProgram() {
     .option("--force", "write into an existing empty directory")
     .action(async (directory, options, command) => {
       if ((options.workspaceName || options.semanticModelId || options.reportName || options.connectionId) && !options.workspaceId) throw new Error("--workspace-id is required when saving a Fabric binding");
+      validateFabricId(options.workspaceId, "--workspace-id");
+      validateFabricId(options.semanticModelId, "--semantic-model-id");
       const json = jsonEnabled(command);
-      if (!json) process.stdout.write(`\nSuper Visual init\n\n`);
+      if (!json) progressStream.write(`\nSuper Visual init\n\n`);
       let liveValidation = null;
       if (options.workspaceId && options.semanticModelId && !options.skipLiveValidation) {
         if (!json) writeInitProgress({ status: "running", message: "Verifying the Fabric workspace and Power BI semantic model (read-only)" });
-        const client = new FabricHttpClient({ timeoutSeconds: Number(options.timeout) });
-        const inspected = await inspectSemanticModel({ client, workspaceId: options.workspaceId, workspaceName: options.workspaceName, semanticModelId: options.semanticModelId });
+        let inspected;
+        try {
+          const client = new FabricHttpClient({ timeoutSeconds: Number(options.timeout) });
+          inspected = await inspectSemanticModel({ client, workspaceId: options.workspaceId, workspaceName: options.workspaceName, semanticModelId: options.semanticModelId });
+        } catch (error) {
+          throw new CliUserError(error instanceof Error ? error.message : String(error), {
+            summary: "Super Visual could not verify the Fabric workspace and semantic model.",
+            guidance: "Confirm that you are signed in, can access the workspace, and copied both IDs from the same Fabric workspace.",
+          });
+        }
         liveValidation = {
           ok: true,
           status: "passed",
@@ -292,9 +349,9 @@ function createProgram() {
         };
         if (!json) writeInitProgress({ status: "passed", message: `Verified workspace ${inspected.workspace.displayName} and semantic model ${inspected.semanticModel.displayName}` });
       } else if (!json && options.skipLiveValidation) {
-        process.stdout.write("! Live Fabric validation skipped by request\n");
+        progressStream.write("! Live Fabric validation skipped by request\n");
       } else if (!json) {
-        process.stdout.write("• No complete Fabric binding supplied; live validation was not run\n");
+        progressStream.write("! No complete Fabric binding supplied; live validation was not run\n");
       }
       const result = await initializeProject({
         directory,
@@ -306,6 +363,7 @@ function createProgram() {
         onProgress: json ? null : writeInitProgress,
       });
       if (options.workspaceId) {
+        if (!json) writeInitProgress({ status: "running", message: "Saving the reusable Fabric project binding" });
         const saved = await writeProjectTarget(result.directory, targetUpdate({
           ...options,
           workspaceName: options.workspaceName ?? liveValidation?.workspace.displayName,

package/src/project.mjs

@@ -286,9 +286,11 @@ export async function initializeProject({ directory, template = "blank", name, t
     await writeFile(path.join(target, "README.md"), blankReadme(projectTitle));
   }
   if (app) {
+    onProgress?.({ status: "running", step: "application", message: `Importing React application from ${path.resolve(app)}` });
     await installApplication(target, app, projectTitle);
     onProgress?.({ status: "passed", step: "application", message: `Imported React application from ${path.resolve(app)}` });
   }
+  onProgress?.({ status: "running", step: "source", message: "Synchronizing React source and report-source contract" });
   const style = await readFile(path.join(target, "source", "report-design.less"), "utf8");
   const designHash = createHash("sha256").update(style).digest("hex");
   await replaceTemplateTokens(target, { DESIGN_HASH: designHash });

package/templates/blank/package.json

@@ -10,6 +10,6 @@
     "verify": "supervisual verify ."
   },
   "devDependencies": {
-    "@datashow/super-visual-cli": "0.1.0-rc.1"
+    "@datashow/super-visual-cli": "0.1.0-rc.3"
   }
 }

package/templates/hello-world/package.json

@@ -10,6 +10,6 @@
     "verify": "supervisual verify ."
   },
   "devDependencies": {
-    "@datashow/super-visual-cli": "0.1.0-rc.1"
+    "@datashow/super-visual-cli": "0.1.0-rc.3"
   }
 }