@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 +2 -0
- package/dist/gskills-admin.js +10 -2
- package/package.json +1 -1
- package/skills/gskills-admin-cli/SKILL.md +3 -1
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
|
package/dist/gskills-admin.js
CHANGED
|
@@ -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
|
|
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
|
@@ -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
|
|
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.
|