@numericoach/gskills-admin-cli 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -51,6 +51,8 @@ gskills-admin org-units-sync google --instance <instanceId> --yes --output json
51
51
  gskills-admin ambassadors label --instance <instanceId> --language fr --output json
52
52
  ```
53
53
 
54
+ Feedback reply bodies are file-based on purpose. Production replies are multi-line, and `send-reply` rejects inline body text to avoid shell parsing surprises.
55
+
54
56
  Raw project and analytics data can be read through resources such as `project-data`, `ticket-sla-rules`, `analytics`, `quiz-attempts`, `user-paths`, `chromebook-progress`, and `user-learning-paths`.
55
57
 
56
58
  ## Agent skill
@@ -907,12 +907,20 @@ var runFeedbackCommand = async (action, feedbackId, ctx) => {
907
907
  if (!hasFlag(ctx, "yes") && !hasFlag(ctx, "dry-run")) {
908
908
  throw new CliError("Sending feedback reply email requires --yes or --dry-run", 2);
909
909
  }
910
+ const bodyFilePath = getStringFlag(ctx, "body-file");
911
+ const translatedBodyFilePath = getStringFlag(ctx, "translated-body-file");
912
+ if (!bodyFilePath) {
913
+ throw new CliError("Feedback reply emails are multi-line. Use --body-file instead of inline --body.", 2);
914
+ }
915
+ if (getStringFlag(ctx, "translated-body") && !translatedBodyFilePath) {
916
+ throw new CliError("Translated feedback reply emails are multi-line. Use --translated-body-file instead of inline --translated-body.", 2);
917
+ }
910
918
  const subject = await getTextFlag(ctx, "subject", "subject-file");
911
919
  const body = await getTextFlag(ctx, "body", "body-file");
912
920
  const translatedSubject = await getTextFlag(ctx, "translated-subject", "translated-subject-file");
913
921
  const translatedBody = await getTextFlag(ctx, "translated-body", "translated-body-file");
914
922
  if (!subject || !body)
915
- throw new CliError("Missing --subject or --body", 2);
923
+ throw new CliError("Missing --subject or --body-file", 2);
916
924
  return requestApi("/api/cli/feedback/send-reply", {
917
925
  method: "POST",
918
926
  body: JSON.stringify({
@@ -1414,7 +1422,7 @@ var schemaHelp = () => ({
1414
1422
  { name: "cache invalidate", required: ["--instance"], flags: ["--scope", "--languages", "--yes", "--dry-run"], writes: true },
1415
1423
  { name: "feedback claim", args: ["feedbackId"], flags: ["--dry-run"], writes: true },
1416
1424
  { name: "feedback send-claim", args: ["feedbackId"], flags: ["--recipient-email", "--recipient-name", "--cc", "--subject", "--body", "--yes", "--dry-run"], writes: true },
1417
- { name: "feedback send-reply", args: ["feedbackId"], flags: ["--subject", "--subject-file", "--body", "--body-file", "--translated-subject", "--translated-subject-file", "--translated-body", "--translated-body-file", "--user-language", "--current-language", "--yes", "--dry-run"], writes: true },
1425
+ { name: "feedback send-reply", args: ["feedbackId"], flags: ["--subject", "--subject-file", "--body-file", "--translated-subject", "--translated-subject-file", "--translated-body-file", "--user-language", "--current-language", "--yes", "--dry-run"], writes: true },
1418
1426
  { name: "access grant", required: ["--user"], flags: ["--type", "--start-at", "--custom-duration-days", "--preferred-language", "--yes", "--dry-run"], writes: true },
1419
1427
  { name: "access revoke-active", required: ["--user"], flags: ["--yes", "--dry-run"], writes: true },
1420
1428
  { name: "instances create-plan", writes: false },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@numericoach/gskills-admin-cli",
3
- "version": "0.1.5",
3
+ "version": "0.1.6",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Admin-only CLI for GSkills super-admin operations.",
@@ -262,6 +262,8 @@ gskills-admin cache invalidate --instance <instanceId> --scope all --yes --outpu
262
262
 
263
263
  Use `send-reply` for the normal email available from the feedback detail dialog. It uses the `GSkillsEmail` template, sends to the feedback user, stores a `FeedbackReply`, updates `repliedAt`, and writes admin logs.
264
264
 
265
+ Production reality from the latest 50 `FeedbackReply` rows checked on 2026-05-13: all reply bodies were multi-line, usually 9-13 lines with paragraph breaks. Translated PT/ES replies were multi-line too. Therefore, real feedback replies must use `--body-file`; never put the body inline in the shell.
266
+
265
267
  ```bash
266
268
  gskills-admin feedback send-reply <feedbackId> --subject "GSkills - ..." --body-file ./reply.txt --dry-run --output json
267
269
  gskills-admin feedback send-reply <feedbackId> --subject "GSkills - ..." --body-file ./reply.txt --yes --output json
@@ -293,7 +295,7 @@ gskills-admin feedback send-claim <feedbackId> --recipient-email user@example.co
293
295
  Rules:
294
296
 
295
297
  - For normal feedback responses, use `send-reply`.
296
- - For multi-line email bodies, use `--body-file` and `--translated-body-file`; avoid inline shell strings for real sends.
298
+ - For feedback reply bodies, use `--body-file` and `--translated-body-file`; the CLI rejects inline body text for `send-reply`.
297
299
  - Dry-run claim first to inspect recipient, CC recipients and draft.
298
300
  - Send only after the ticket is claimed by the same CLI user.
299
301
  - CC recipients must be allowed by instance SLA flags.