@enerlence/suntropy-cli 0.7.0 → 0.8.1

package/dist/bin/suntropy.js

@@ -7,7 +7,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/index.ts
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -139,6 +139,15 @@ function createUnauthClient(baseURL) {
     headers: { "Content-Type": "application/json" }
   });
 }
+function assertFound(data, entity, id) {
+  const isEmptyObject = data != null && typeof data === "object" && !Array.isArray(data) && Object.keys(data).length === 0;
+  if (data == null || typeof data !== "object" || Array.isArray(data) || isEmptyObject) {
+    throw new Error(
+      `${entity} not found: ${id}. The backend returned an empty response \u2014 verify the id is correct and belongs to your account and environment (the CLI and the app must point to the same backend).`
+    );
+  }
+  return data;
+}
 function handleApiError(err) {
   if (axios.isAxiosError(err)) {
     const ae = err;
@@ -1797,6 +1806,7 @@ function registerInventoryCommands(program2) {
 }
 
 // src/commands/studies/builder.ts
+import { Option } from "commander";
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync4, existsSync as existsSync2 } from "fs";
 
 // node_modules/uuid/dist/esm-node/rng.js
@@ -2183,7 +2193,7 @@ function registerStudyBuilderCommands(studies) {
       const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
-      const study = res.data;
+      const study = assertFound(res.data, "Solar study", studyId);
       const { stepsProgress, missing } = evaluateSteps(study);
       const progress = study.solarStudyProgress || {};
       progress.stepsProgress = stepsProgress;
@@ -3144,13 +3154,18 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
   });
   studies.command("comment <studyId>").description(
     'Add a comment to an existing study via API.\nExample: suntropy studies comment abc123 --content "Revisado por agente"'
-  ).requiredOption("--content <text>", "Comment text").action(async (studyId, opts) => {
+  ).requiredOption("--content <text>", "Comment text").addOption(new Option("--as-alexandria").hideHelp()).addOption(new Option("--reply-to-user <userUID>").hideHelp()).addOption(new Option("--reply-to-name <name>").hideHelp()).action(async (studyId, opts) => {
     try {
       const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
-      const comment = createComment("commented", opts.content);
+      const comment = createComment("commented", opts.content, {
+        asAlexandria: Boolean(opts.asAlexandria),
+        replyToUser: opts.replyToUser,
+        replyToName: opts.replyToName
+      });
       const res = await client.post(`/solar-study/addSolarStudyComment/${studyId}`, comment);
-      output(res.data, global);
+      const saved = assertFound(res.data, "Solar study", studyId);
+      output(saved, global);
     } catch (err) {
       outputError(handleApiError(err));
     }
@@ -3271,19 +3286,28 @@ async function fetchPeriodDistribution(study, global) {
     return null;
   }
 }
-function createComment(type, content) {
+function createComment(type, content, extra) {
   const config = loadConfig();
   const profile = getActiveProfile(config);
   const autoContent = {
     created: "Estudio creado via CLI",
     modified: "Estudio actualizado via CLI"
   };
-  return {
-    content: content || autoContent[type] || "",
+  let body = content || autoContent[type] || "";
+  if (extra?.replyToUser) {
+    const name = extra.replyToName || extra.replyToUser;
+    body = `@[${name}](${extra.replyToUser}) ${body}`.trim();
+  }
+  const comment = {
+    content: body,
     type,
     creationTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    creationUserUID: profile.userUID || "cli-agent"
+    creationUserUID: extra?.asAlexandria ? "alexandria" : profile.userUID || "cli-agent"
   };
+  if (extra?.asAlexandria) {
+    comment.aiGenerated = true;
+  }
+  return comment;
 }
 
 // src/commands/studies/index.ts
@@ -3456,7 +3480,7 @@ function registerStudiesCommands(program2) {
       const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
-      const study = res.data;
+      const study = assertFound(res.data, "Solar study", studyId);
       const filtered = global.fields ? study : filterStudy(study, opts.expand);
       if (global.fields) {
         const requested = global.fields.split(",").map((f) => f.trim());
@@ -3478,7 +3502,7 @@ function registerStudiesCommands(program2) {
       const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
-      const study = res.data;
+      const study = assertFound(res.data, "Solar study", studyId);
       let curveData;
       switch (curveName) {
         case "consumption":
@@ -4309,9 +4333,9 @@ function registerGeocodeCommands(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.7.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.8.1" : "0.0.0-dev";
 function createProgram() {
-  const program2 = new Command2();
+  const program2 = new Command3();
   program2.name("suntropy").description("Agent-first CLI for Suntropy solar platform. Optimized for programmatic data manipulation and progressive exploration.").version(CLI_VERSION).option("--format <format>", "Output format: json (default), human, csv", "json").option("--fields <fields>", "Comma-separated fields to include in output").option("--server <url>", "Override API server URL").option("--token <jwt>", "Override authentication token").option("--profile <name>", "Use a specific config profile").option("--verbose", "Show HTTP request/response details on stderr").option("--quiet", "Suppress non-data output").option("--save <file>", "Save output to file (also writes to stdout)");
   registerAuthCommands(program2);
   registerConfigCommands(program2);