@enerlence/suntropy-cli 0.6.0 → 0.8.0

package/README.md

@@ -20,6 +20,10 @@ npx @enerlence/suntropy-cli <command>
 # API key (preferred for agents)
 suntropy auth set-key --key <jwt-api-key>
 
+# Target a specific server / profile (global options — see "Global Options")
+suntropy --server https://api-dev.example.cloud --profile dev auth set-key --key <jwt>
+suntropy --profile dev auth status
+
 # Email/password login
 suntropy auth login --email user@co.com --password pass
 
@@ -27,6 +31,10 @@ suntropy auth login --email user@co.com --password pass
 suntropy auth status
 ```
 
+> `--server`, `--profile` and `--token` are **global** options: pass them on the
+> root command (e.g. `suntropy --profile dev auth status`). They apply to every
+> subcommand, including `auth`.
+
 ## Global Options
 
 | Option | Default | Description |
@@ -254,6 +262,30 @@ suntropy shareables create --element-id <studyId> --data '{"customLayout":true}'
 `--element-type` (default `solarStudy`): `solarStudy | colectiveSolarStudy | veChargerStudy | heatpumpStudy | billing`.
 `--shareable-type` (default `TEMPLATE`): `TEMPLATE | CONTRACT`. The response includes the public `url` and `uid`.
 
+### `suntropy templates` - Document Templates
+
+List the client document templates (budget/document templates from the sharing
+service), proxied via solar under `GET /api/templates`. Returns only `_id` and
+`templateName`.
+
+```bash
+# Solar study templates (default --type solarStudy)
+suntropy templates list
+
+# Other template types
+suntropy templates list --type colectiveSolarStudy
+suntropy templates list --type veChargerStudy
+
+# Generic (untyped) templates
+suntropy templates list --type generic
+
+# Pick fields / change format
+suntropy templates list --fields _id,templateName --format csv
+```
+
+`--type` (default `solarStudy`): `solarStudy | colectiveSolarStudy | veChargerStudy | generic`.
+`generic` lists the untyped templates (sends no `templateIdentifier` filter).
+
 ### `suntropy config` - Configuration
 
 ```bash

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";
@@ -275,17 +275,18 @@ function getGlobalOpts(cmd) {
 }
 function registerAuthCommands(program2) {
   const auth = program2.command("auth").description("Authentication management");
-  auth.command("set-key").description("Set an API key (JWT) for authentication. Preferred method for agents.").requiredOption("--key <jwt>", "JWT API key").option("--server <url>", "API server URL").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("set-key").description("Set an API key (JWT) for authentication. Preferred method for agents.").requiredOption("--key <jwt>", "JWT API key").action(async (opts) => {
     try {
+      const global = getGlobalOpts(auth);
       const config = loadConfig();
-      const profileName = opts.profile || config.activeProfile;
+      const profileName = global.profile || config.activeProfile;
       if (!config.profiles[profileName]) {
         config.profiles[profileName] = { server: "https://api.enerlence.com" };
       }
       const profile = config.profiles[profileName];
       profile.token = opts.key;
       profile.authMethod = "api-key";
-      if (opts.server) profile.server = opts.server;
+      if (global.server) profile.server = global.server;
       try {
         const payload = JSON.parse(Buffer.from(opts.key.split(".")[1], "base64").toString());
         profile.clientUID = payload.clientUID;
@@ -298,15 +299,16 @@ function registerAuthCommands(program2) {
       outputError(err);
     }
   });
-  auth.command("login").description("Login with email and password").requiredOption("--email <email>", "User email").requiredOption("--password <password>", "User password").option("--server <url>", "API server URL").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("login").description("Login with email and password").requiredOption("--email <email>", "User email").requiredOption("--password <password>", "User password").action(async (opts) => {
     try {
+      const global = getGlobalOpts(auth);
       const config = loadConfig();
-      const profileName = opts.profile || config.activeProfile;
+      const profileName = global.profile || config.activeProfile;
       if (!config.profiles[profileName]) {
         config.profiles[profileName] = { server: "https://api.enerlence.com" };
       }
       const profile = config.profiles[profileName];
-      if (opts.server) profile.server = opts.server;
+      if (global.server) profile.server = global.server;
       const securityUrl = getServiceUrl(profile.server, "security");
       const client = createUnauthClient(securityUrl);
       const res = await client.post("/auth/login", { email: opts.email, password: opts.password });
@@ -334,10 +336,11 @@ function registerAuthCommands(program2) {
       outputError(handleApiError(err));
     }
   });
-  auth.command("status").description("Show current authentication status").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("status").description("Show current authentication status").action(async () => {
     try {
+      const global = getGlobalOpts(auth);
       const config = loadConfig();
-      const profile = getActiveProfile(config, opts.profile);
+      const profile = getActiveProfile(config, global.profile);
       if (!profile.token) {
         output({ authenticated: false, message: "No token configured" }, getGlobalOpts(auth));
         return;
@@ -367,11 +370,11 @@ function registerAuthCommands(program2) {
       outputError(err);
     }
   });
-  auth.command("refresh").description("Refresh the current JWT token").option("--profile <name>", "Profile name").action(async (opts) => {
+  auth.command("refresh").description("Refresh the current JWT token").action(async () => {
     try {
+      const globalOpts = getGlobalOpts(auth);
       const config = loadConfig();
-      const profileName = opts.profile || config.activeProfile;
-      const globalOpts = program2.opts();
+      const profileName = globalOpts.profile || config.activeProfile;
       const client = createServiceClient("security", { ...globalOpts, profile: profileName });
       const res = await client.get("/auth/jwt/refreshToken");
       if (res.data?.access_token || res.data?.token?.access_token) {
@@ -1794,6 +1797,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
@@ -3141,11 +3145,15 @@ 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);
     } catch (err) {
@@ -3268,19 +3276,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
@@ -4206,12 +4223,44 @@ function registerShareableCommands(program2) {
   });
 }
 
-// src/commands/geocode/index.ts
+// src/commands/templates/index.ts
 function getGlobalOpts14(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
 }
+function registerTemplatesCommands(program2) {
+  const templates = program2.command("templates").description(
+    "Read client document templates (id + name), proxied via solar from the sharing service."
+  );
+  templates.command("list").description(
+    "List templates returning only _id and templateName (GET /api/templates).\nDefaults to the solar study templates (--type solarStudy).\n\nTypes: solarStudy (default) | colectiveSolarStudy | veChargerStudy.\nUse --type generic for the generic (untyped) templates.\n\nExamples:\n  suntropy templates list\n  suntropy templates list --type colectiveSolarStudy\n  suntropy templates list --type generic --fields _id,templateName --format csv"
+  ).option(
+    "--type <identifier>",
+    "solarStudy (default) | colectiveSolarStudy | veChargerStudy | generic",
+    "solarStudy"
+  ).action(async (opts) => {
+    try {
+      const global = getGlobalOpts14(templates);
+      const client = createServiceClient("solar", global);
+      const params = {};
+      if (opts.type && opts.type !== "generic") {
+        params.templateIdentifier = opts.type;
+      }
+      const res = await client.get("/api/templates", { params });
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+}
+
+// src/commands/geocode/index.ts
+function getGlobalOpts15(cmd) {
+  let root = cmd;
+  while (root.parent) root = root.parent;
+  return root.opts();
+}
 function emit(envelope, all, query, global) {
   if (envelope.error) {
     outputError({
@@ -4245,7 +4294,7 @@ function registerGeocodeCommands(program2) {
     'Resolve an address into coordinates (lat/lng + formatted address).\nExamples:\n  suntropy geocode resolve --address "Calle Mayor 1, Madrid"\n  suntropy geocode resolve --address "Gran V\xEDa, Madrid" --country es --all'
   ).requiredOption("--address <string>", "Address to geocode (quote it)").option("--country <code>", "Bias results to a country (ISO code, e.g. es, pt, it)").option("--all", "Return all candidate matches instead of only the best one").action(async (opts) => {
     try {
-      const global = getGlobalOpts14(geocode);
+      const global = getGlobalOpts15(geocode);
       const client = createServiceClient("solar", global);
       const res = await client.get(
         "/api/geocode",
@@ -4260,7 +4309,7 @@ function registerGeocodeCommands(program2) {
     "Resolve coordinates into an address (reverse geocoding).\nExample:\n  suntropy geocode reverse --lat 40.4168 --lng -3.7038"
   ).requiredOption("--lat <number>", "Latitude").requiredOption("--lng <number>", "Longitude").option("--all", "Return all candidate matches instead of only the best one").action(async (opts) => {
     try {
-      const global = getGlobalOpts14(geocode);
+      const global = getGlobalOpts15(geocode);
       const client = createServiceClient("solar", global);
       const res = await client.get(
         "/api/reverse-geocode",
@@ -4274,9 +4323,9 @@ function registerGeocodeCommands(program2) {
 }
 
 // src/index.ts
-var CLI_VERSION = true ? "0.6.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.8.0" : "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);
@@ -4287,6 +4336,7 @@ function createProgram() {
   registerSolarformCommands(program2);
   registerPPACommands(program2);
   registerShareableCommands(program2);
+  registerTemplatesCommands(program2);
   registerGeocodeCommands(program2);
   return program2;
 }