@numericoach/gskills-admin-cli 0.1.8 → 0.1.9
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
|
@@ -38,6 +38,15 @@ gskills-admin cache invalidate --instance <instanceId> --scope pages --languages
|
|
|
38
38
|
gskills-admin cache invalidate --instance <instanceId> --scope menu-bundle --yes --output json
|
|
39
39
|
```
|
|
40
40
|
|
|
41
|
+
CRUD help includes cache hints for resources that can leave deploy views stale after a raw write:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
gskills-admin pages help --output json
|
|
45
|
+
gskills-admin topics help --output json
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Use the listed `cache.scopes` with `gskills-admin cache invalidate` after create, update, or delete when the end-user view must reflect the change immediately.
|
|
49
|
+
|
|
41
50
|
Operational helpers are available for the admin-only flows agents should not improvise:
|
|
42
51
|
|
|
43
52
|
```bash
|
|
@@ -53,14 +62,16 @@ gskills-admin ambassadors label --instance <instanceId> --language fr --output j
|
|
|
53
62
|
|
|
54
63
|
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
64
|
|
|
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-
|
|
65
|
+
Raw project and analytics data can be read or adjusted through resources such as `project-data`, `ticket-sla-rules`, `analytics`, `quiz-attempts`, `user-paths`, `chromebook-progress`, `user-badges`, `user-learning-paths`, and `user-learning-path-item-completions`.
|
|
57
66
|
|
|
58
67
|
## Agent skill
|
|
59
68
|
|
|
60
|
-
Install the bundled skills so AI agents know the auth model, resource map, output modes, sync workflow, content-authoring standards,
|
|
69
|
+
Install the bundled skills so AI agents know the auth model, resource map, output modes, sync workflow, content-authoring standards, recurring DB-backed ops runbooks, GSkills vocabulary, and recurring customer playbooks.
|
|
61
70
|
|
|
62
71
|
```bash
|
|
63
72
|
gskills-admin skills install --target ~/.codex/skills
|
|
73
|
+
gskills-admin skills install --name gskills-vocabulary --target ~/.codex/skills
|
|
74
|
+
gskills-admin skills install --name gskills-customer-playbooks --target ~/.codex/skills
|
|
64
75
|
gskills-admin skills install --name gskills-feedback-db-ops --target ~/.codex/skills
|
|
65
76
|
```
|
|
66
77
|
|
package/dist/gskills-admin.js
CHANGED
|
@@ -334,7 +334,8 @@ var resources = [
|
|
|
334
334
|
aliases: ["page", "content"],
|
|
335
335
|
defaultFields: ["id", "name", "slug", "language", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
336
336
|
syncable: true,
|
|
337
|
-
dangerousDelete: true
|
|
337
|
+
dangerousDelete: true,
|
|
338
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
338
339
|
},
|
|
339
340
|
{
|
|
340
341
|
name: "topics",
|
|
@@ -343,7 +344,8 @@ var resources = [
|
|
|
343
344
|
aliases: ["topic", "applications", "category-apps", "categories", "thematics", "thematic"],
|
|
344
345
|
defaultFields: ["id", "name", "slug", "language", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
345
346
|
syncable: true,
|
|
346
|
-
dangerousDelete: true
|
|
347
|
+
dangerousDelete: true,
|
|
348
|
+
cacheScopes: ["applications", "pages", "pages-knowledge"]
|
|
347
349
|
},
|
|
348
350
|
{
|
|
349
351
|
name: "resources",
|
|
@@ -352,7 +354,8 @@ var resources = [
|
|
|
352
354
|
aliases: ["resource", "ebooks", "e-books", "webinars", "magazines"],
|
|
353
355
|
defaultFields: ["id", "title", "type", "language", "instanceId", "isActive", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
354
356
|
syncable: true,
|
|
355
|
-
dangerousDelete: true
|
|
357
|
+
dangerousDelete: true,
|
|
358
|
+
cacheScopes: ["pages-knowledge"]
|
|
356
359
|
},
|
|
357
360
|
{
|
|
358
361
|
name: "internal-knowledge",
|
|
@@ -361,7 +364,8 @@ var resources = [
|
|
|
361
364
|
aliases: ["knowledge", "knowledges"],
|
|
362
365
|
defaultFields: ["id", "title", "language", "instanceId", "isActive", "isAIAllowed", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
363
366
|
syncable: true,
|
|
364
|
-
dangerousDelete: true
|
|
367
|
+
dangerousDelete: true,
|
|
368
|
+
cacheScopes: ["pages-knowledge"]
|
|
365
369
|
},
|
|
366
370
|
{
|
|
367
371
|
name: "learning-paths",
|
|
@@ -370,7 +374,8 @@ var resources = [
|
|
|
370
374
|
aliases: ["learning-path", "paths", "path"],
|
|
371
375
|
defaultFields: ["id", "name", "slug", "language", "instanceId", "isActive", "mandatory", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
372
376
|
syncable: true,
|
|
373
|
-
dangerousDelete: true
|
|
377
|
+
dangerousDelete: true,
|
|
378
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
374
379
|
},
|
|
375
380
|
{
|
|
376
381
|
name: "changelogs",
|
|
@@ -387,7 +392,8 @@ var resources = [
|
|
|
387
392
|
aliases: ["chromebook", "chromebook-game", "chromebook-exercise", "chromebook-games"],
|
|
388
393
|
defaultFields: ["id", "title", "language", "instanceId", "type", "order", "isActive", "parentId", "sourceExerciseId", "updatedAt"],
|
|
389
394
|
instanceField: "instanceId",
|
|
390
|
-
dangerousDelete: true
|
|
395
|
+
dangerousDelete: true,
|
|
396
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
391
397
|
},
|
|
392
398
|
{
|
|
393
399
|
name: "chromebook-steps",
|
|
@@ -396,7 +402,8 @@ var resources = [
|
|
|
396
402
|
aliases: ["chromebook-step", "chromebook-exercise-steps"],
|
|
397
403
|
defaultFields: ["id", "exerciseId", "stepNumber", "title", "language", "contentType", "order", "updatedAt"],
|
|
398
404
|
instanceField: null,
|
|
399
|
-
dangerousDelete: true
|
|
405
|
+
dangerousDelete: true,
|
|
406
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
400
407
|
},
|
|
401
408
|
{
|
|
402
409
|
name: "project-data",
|
|
@@ -438,7 +445,8 @@ var resources = [
|
|
|
438
445
|
label: "Instances",
|
|
439
446
|
aliases: ["instance"],
|
|
440
447
|
defaultFields: ["id", "name", "URL", "licenceType", "alphaProgramKeys", "createdAt", "updatedAt"],
|
|
441
|
-
dangerousDelete: true
|
|
448
|
+
dangerousDelete: true,
|
|
449
|
+
cacheScopes: ["all"]
|
|
442
450
|
},
|
|
443
451
|
{
|
|
444
452
|
name: "alpha-programs",
|
|
@@ -454,7 +462,8 @@ var resources = [
|
|
|
454
462
|
aliases: ["quiz"],
|
|
455
463
|
defaultFields: ["id", "title", "language", "instanceId", "mandatory", "isActive", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
456
464
|
syncable: true,
|
|
457
|
-
dangerousDelete: true
|
|
465
|
+
dangerousDelete: true,
|
|
466
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
458
467
|
},
|
|
459
468
|
{
|
|
460
469
|
name: "badges",
|
|
@@ -463,7 +472,8 @@ var resources = [
|
|
|
463
472
|
aliases: ["badge"],
|
|
464
473
|
defaultFields: ["id", "name", "language", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
465
474
|
syncable: true,
|
|
466
|
-
dangerousDelete: true
|
|
475
|
+
dangerousDelete: true,
|
|
476
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
467
477
|
},
|
|
468
478
|
{
|
|
469
479
|
name: "feedbacks",
|
|
@@ -505,7 +515,8 @@ var resources = [
|
|
|
505
515
|
aliases: ["ambassador", "champions", "champion", "experts", "expert"],
|
|
506
516
|
defaultFields: ["id", "userId", "active", "descriptionAmbassador", "contactContent", "createdOn"],
|
|
507
517
|
instanceField: null,
|
|
508
|
-
dangerousDelete: true
|
|
518
|
+
dangerousDelete: true,
|
|
519
|
+
cacheScopes: ["pages"]
|
|
509
520
|
},
|
|
510
521
|
{
|
|
511
522
|
name: "tags",
|
|
@@ -514,7 +525,8 @@ var resources = [
|
|
|
514
525
|
aliases: ["tag"],
|
|
515
526
|
defaultFields: ["id", "name", "normalizedName", "color", "scope", "ownerInstanceId", "createdAt", "updatedAt"],
|
|
516
527
|
instanceField: "ownerInstanceId",
|
|
517
|
-
dangerousDelete: true
|
|
528
|
+
dangerousDelete: true,
|
|
529
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
518
530
|
},
|
|
519
531
|
{
|
|
520
532
|
name: "tag-assignments",
|
|
@@ -522,7 +534,8 @@ var resources = [
|
|
|
522
534
|
label: "Tag assignments",
|
|
523
535
|
aliases: ["tag-assignment"],
|
|
524
536
|
defaultFields: ["id", "tagId", "instanceId", "entityType", "entityId", "createdAt", "updatedAt"],
|
|
525
|
-
dangerousDelete: true
|
|
537
|
+
dangerousDelete: true,
|
|
538
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
526
539
|
},
|
|
527
540
|
{
|
|
528
541
|
name: "menus",
|
|
@@ -531,7 +544,8 @@ var resources = [
|
|
|
531
544
|
aliases: ["menu", "menu-items"],
|
|
532
545
|
defaultFields: ["id", "name", "url", "pageId", "parentId", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
533
546
|
syncable: true,
|
|
534
|
-
dangerousDelete: true
|
|
547
|
+
dangerousDelete: true,
|
|
548
|
+
cacheScopes: ["menu-bundle"]
|
|
535
549
|
},
|
|
536
550
|
{
|
|
537
551
|
name: "menu-sections",
|
|
@@ -540,7 +554,8 @@ var resources = [
|
|
|
540
554
|
aliases: ["menu-instances"],
|
|
541
555
|
defaultFields: ["id", "name", "order", "instanceId", "disabled", "archived", "alphaProgramIds"],
|
|
542
556
|
syncable: true,
|
|
543
|
-
dangerousDelete: true
|
|
557
|
+
dangerousDelete: true,
|
|
558
|
+
cacheScopes: ["menu-bundle"]
|
|
544
559
|
},
|
|
545
560
|
{
|
|
546
561
|
name: "workflows",
|
|
@@ -549,14 +564,16 @@ var resources = [
|
|
|
549
564
|
aliases: ["workflow"],
|
|
550
565
|
defaultFields: ["id", "name", "triggerType", "isActive", "instanceId", "disabled", "archived", "alphaProgramIds", "updatedAt"],
|
|
551
566
|
syncable: true,
|
|
552
|
-
dangerousDelete: true
|
|
567
|
+
dangerousDelete: true,
|
|
568
|
+
cacheScopes: ["pages", "pages-knowledge"]
|
|
553
569
|
},
|
|
554
570
|
{
|
|
555
571
|
name: "feature-flags",
|
|
556
572
|
delegate: "featureFlagAssignment",
|
|
557
573
|
label: "Feature flags",
|
|
558
574
|
aliases: ["feature-flag", "flags"],
|
|
559
|
-
defaultFields: ["id", "featureKey", "targetType", "targetId", "active", "variant", "updatedAt"]
|
|
575
|
+
defaultFields: ["id", "featureKey", "targetType", "targetId", "active", "variant", "updatedAt"],
|
|
576
|
+
cacheScopes: ["all"]
|
|
560
577
|
},
|
|
561
578
|
{
|
|
562
579
|
name: "groups",
|
|
@@ -564,7 +581,8 @@ var resources = [
|
|
|
564
581
|
label: "Manual groups",
|
|
565
582
|
aliases: ["group", "manual-groups", "manual-group"],
|
|
566
583
|
defaultFields: ["id", "name", "description", "instanceId", "isRevert", "createdAt", "updatedAt"],
|
|
567
|
-
dangerousDelete: true
|
|
584
|
+
dangerousDelete: true,
|
|
585
|
+
cacheScopes: ["menu-bundle"]
|
|
568
586
|
},
|
|
569
587
|
{
|
|
570
588
|
name: "org-units",
|
|
@@ -572,7 +590,8 @@ var resources = [
|
|
|
572
590
|
label: "Org units",
|
|
573
591
|
aliases: ["org-unit", "ou", "ous"],
|
|
574
592
|
defaultFields: ["id", "name", "code", "type", "googleOuId", "parentId", "instanceId", "instanceCountryParentId", "createdAt", "updatedAt"],
|
|
575
|
-
dangerousDelete: true
|
|
593
|
+
dangerousDelete: true,
|
|
594
|
+
cacheScopes: ["menu-bundle"]
|
|
576
595
|
},
|
|
577
596
|
{
|
|
578
597
|
name: "user-org-units",
|
|
@@ -581,7 +600,8 @@ var resources = [
|
|
|
581
600
|
aliases: ["user-org-unit", "ou-memberships"],
|
|
582
601
|
defaultFields: ["userId", "orgUnitId", "primary", "assignedAt"],
|
|
583
602
|
instanceField: null,
|
|
584
|
-
dangerousDelete: true
|
|
603
|
+
dangerousDelete: true,
|
|
604
|
+
cacheScopes: ["menu-bundle"]
|
|
585
605
|
},
|
|
586
606
|
{
|
|
587
607
|
name: "ou-admin-scopes",
|
|
@@ -598,7 +618,8 @@ var resources = [
|
|
|
598
618
|
label: "Entity restriction rules",
|
|
599
619
|
aliases: ["entity-rules", "content-restriction-rules", "restrictions"],
|
|
600
620
|
defaultFields: ["id", "instanceId", "entityId", "restrictionMode", "categoryIds", "learningPathRestrictionMode", "learningPathIds", "alphaAllPrograms", "alphaProgramIds", "updatedAt"],
|
|
601
|
-
dangerousDelete: true
|
|
621
|
+
dangerousDelete: true,
|
|
622
|
+
cacheScopes: ["menu-bundle", "pages", "pages-knowledge", "applications"]
|
|
602
623
|
},
|
|
603
624
|
{
|
|
604
625
|
name: "users",
|
|
@@ -615,7 +636,8 @@ var resources = [
|
|
|
615
636
|
aliases: ["access-pass", "passes"],
|
|
616
637
|
defaultFields: ["id", "userId", "type", "startAt", "expireAt", "givenAt", "createdAt", "updatedAt"],
|
|
617
638
|
instanceField: "user.instanceID",
|
|
618
|
-
dangerousDelete: true
|
|
639
|
+
dangerousDelete: true,
|
|
640
|
+
cacheScopes: ["menu-bundle"]
|
|
619
641
|
},
|
|
620
642
|
{
|
|
621
643
|
name: "analytics",
|
|
@@ -687,6 +709,7 @@ var resourceHelpRows = () => resources.map((resource) => ({
|
|
|
687
709
|
resource: resource.name,
|
|
688
710
|
db: resource.delegate,
|
|
689
711
|
sync: resource.syncable ? "yes" : "no",
|
|
712
|
+
cacheScopes: resource.cacheScopes?.join(", ") || "",
|
|
690
713
|
aliases: resource.aliases.join(", ")
|
|
691
714
|
}));
|
|
692
715
|
// ../../src/cli/commands.ts
|
|
@@ -1469,7 +1492,9 @@ var schemaHelp = () => ({
|
|
|
1469
1492
|
name: resource.name,
|
|
1470
1493
|
aliases: resource.aliases,
|
|
1471
1494
|
defaultFields: resource.defaultFields,
|
|
1472
|
-
syncable: Boolean(resource.syncable)
|
|
1495
|
+
syncable: Boolean(resource.syncable),
|
|
1496
|
+
cacheScopes: resource.cacheScopes ?? [],
|
|
1497
|
+
cacheNote: resource.cacheScopes?.length ? "After create/update/delete, visible deploy content may stay stale until these cache scopes are invalidated." : "No deploy-cache scope is listed for this raw resource. Still verify visible product state after writes."
|
|
1473
1498
|
}))
|
|
1474
1499
|
});
|
|
1475
1500
|
var authHelp = () => ({
|
|
@@ -1484,6 +1509,8 @@ var skillsHelp = () => ({
|
|
|
1484
1509
|
usage: [
|
|
1485
1510
|
"gskills-admin skills install",
|
|
1486
1511
|
"gskills-admin skills install --target ~/.codex/skills",
|
|
1512
|
+
"gskills-admin skills install --name gskills-vocabulary",
|
|
1513
|
+
"gskills-admin skills install --name gskills-customer-playbooks",
|
|
1487
1514
|
"gskills-admin skills install --name gskills-feedback-db-ops",
|
|
1488
1515
|
"gskills-admin skills path"
|
|
1489
1516
|
],
|
|
@@ -1593,6 +1620,11 @@ var resourceHelp = (resource) => ({
|
|
|
1593
1620
|
`gskills-admin ${resource.name} delete <id> --force --confirm-delete ${resource.name}:<id>`
|
|
1594
1621
|
],
|
|
1595
1622
|
defaultFields: resource.defaultFields,
|
|
1623
|
+
cache: {
|
|
1624
|
+
scopes: resource.cacheScopes ?? [],
|
|
1625
|
+
invalidate: resource.cacheScopes?.length ? `gskills-admin cache invalidate --instance <instanceId> --scope ${resource.cacheScopes[0]} --dry-run` : null,
|
|
1626
|
+
note: resource.cacheScopes?.length ? "After create/update/delete, deploy views may still show cached content. Dry-run and invalidate the relevant scope, then verify the visible page." : "No deploy-cache scope is listed for this raw resource. If the write affects visible content indirectly, use cache scopes to choose a broader invalidation."
|
|
1627
|
+
},
|
|
1596
1628
|
deleteWarning: "Delete permanently removes production data and requires an exact --confirm-delete token."
|
|
1597
1629
|
});
|
|
1598
1630
|
|
package/package.json
CHANGED
|
@@ -9,6 +9,11 @@ Use this skill when you need to operate GSkills as a super admin from an agent.
|
|
|
9
9
|
|
|
10
10
|
The CLI is intentionally boring. It logs in through GSkills Auth, calls GSkills API routes, and never asks an agent for a database URL.
|
|
11
11
|
|
|
12
|
+
Also install and use the companion skills:
|
|
13
|
+
|
|
14
|
+
- `gskills-vocabulary` when explaining work to admins or writing user-facing summaries.
|
|
15
|
+
- `gskills-customer-playbooks` when the task names a recurring GSkills customer.
|
|
16
|
+
|
|
12
17
|
## Install
|
|
13
18
|
|
|
14
19
|
```bash
|
|
@@ -54,6 +59,16 @@ gskills-admin pages update <id> --data '{"disabled":false}' --dry-run --output j
|
|
|
54
59
|
|
|
55
60
|
5. Apply the exact same command without `--dry-run` only after the payload is correct.
|
|
56
61
|
|
|
62
|
+
6. For visible content changes, check the resource cache hint and refresh cache when needed.
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
gskills-admin pages help --output json
|
|
66
|
+
gskills-admin cache invalidate --instance <instanceId> --scope pages --dry-run --output json
|
|
67
|
+
gskills-admin cache invalidate --instance <instanceId> --scope pages --yes --output json
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
CRUD help exposes `cache.scopes` for resources that are known to feed deploy caches. After create, update, or delete, the database can be correct while the end-user view is still stale. Use the narrowest listed scope first. Use `all` only when the changed setting affects many deploy surfaces or when the narrow scope did not clear the visible stale state.
|
|
71
|
+
|
|
57
72
|
Deletes are stricter than other writes. They require both `--force` and an exact confirmation token.
|
|
58
73
|
|
|
59
74
|
```bash
|
|
@@ -258,6 +273,17 @@ gskills-admin cache invalidate --instance <instanceId> --scope menu-bundle --yes
|
|
|
258
273
|
gskills-admin cache invalidate --instance <instanceId> --scope all --yes --output json
|
|
259
274
|
```
|
|
260
275
|
|
|
276
|
+
CRUD resources that expose `cache.scopes` in `gskills-admin <resource> help --output json` should be treated as cached. After a raw write on one of those resources, dry-run the cache invalidation plan, apply it with `--yes`, then re-check the visible product surface.
|
|
277
|
+
|
|
278
|
+
Typical mapping:
|
|
279
|
+
|
|
280
|
+
- courses, tutorials, granules, modules, quizzes, badges, parcours, Chromebook content: `pages`
|
|
281
|
+
- base de connaissance pages and knowledge-facing resources: `pages-knowledge`
|
|
282
|
+
- applications: `applications`, often with `pages` or `pages-knowledge`
|
|
283
|
+
- menus: `menu-bundle`
|
|
284
|
+
- content restrictions and group visibility: usually `menu-bundle`, sometimes `pages`, `pages-knowledge`, or `applications`
|
|
285
|
+
- broad instance settings or feature flags: `all`
|
|
286
|
+
|
|
261
287
|
## Feedback Emails
|
|
262
288
|
|
|
263
289
|
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.
|
|
@@ -415,6 +441,36 @@ gskills-admin quiz-attempts list --where '{"user":{"instanceID":"<instanceId>"}}
|
|
|
415
441
|
|
|
416
442
|
Prefer these read paths for analytics investigation. They are intentionally raw enough to match UI analytics data without giving the agent a DB URL.
|
|
417
443
|
|
|
444
|
+
## User Activity Raw Ops
|
|
445
|
+
|
|
446
|
+
The CLI intentionally exposes user activity as raw authenticated resources, not as a magic repair wizard.
|
|
447
|
+
|
|
448
|
+
Supported raw activity surfaces:
|
|
449
|
+
|
|
450
|
+
- `user-paths`: course, tutorial, granule, or module completion rows.
|
|
451
|
+
- `quiz-attempts`: quiz attempts and completion state.
|
|
452
|
+
- `user-badges`: awarded badges.
|
|
453
|
+
- `user-learning-paths`: parcours progress and completion.
|
|
454
|
+
- `user-learning-path-item-completions`: completed items inside a parcours.
|
|
455
|
+
- `chromebook-progress`: Chromebook game exercise progress.
|
|
456
|
+
- `analytics`: raw activity events used by analytics surfaces.
|
|
457
|
+
|
|
458
|
+
When a super admin asks whether an agent can inspect or fix activity, the answer is yes through these raw resources. Read the user, instance, content row, and existing activity rows first. Use `--dry-run` before writes, then re-read the changed rows.
|
|
459
|
+
|
|
460
|
+
Examples:
|
|
461
|
+
|
|
462
|
+
```bash
|
|
463
|
+
gskills-admin users list --where '{"email":"user@example.com"}' --fields id,email,name,instanceID --output json
|
|
464
|
+
gskills-admin user-paths list --where '{"userId":"<userId>"}' --output json
|
|
465
|
+
gskills-admin quiz-attempts list --where '{"userId":"<userId>"}' --output json
|
|
466
|
+
gskills-admin user-badges list --where '{"userId":"<userId>"}' --output json
|
|
467
|
+
gskills-admin user-learning-paths list --where '{"userId":"<userId>"}' --output json
|
|
468
|
+
gskills-admin user-learning-path-item-completions list --where '{"userId":"<userId>"}' --output json
|
|
469
|
+
gskills-admin chromebook-progress list --where '{"userId":"<userId>"}' --output json
|
|
470
|
+
```
|
|
471
|
+
|
|
472
|
+
Raw fixes are allowed, but do not pretend a single row always covers the whole product behavior. For example, a quiz completion can also matter for a parcours, a badge, a workflow, points, or analytics. If the user asked for a visible result, verify the visible result after the raw write.
|
|
473
|
+
|
|
418
474
|
## Cache Scope Choice
|
|
419
475
|
|
|
420
476
|
Prefer the narrowest scope:
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: gskills-customer-playbooks
|
|
3
|
+
description: Use when a GSkills task names a recurring customer and the agent needs operational memory about that customer, common requests, likely checks, sync patterns, access quirks, or communication sources.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# GSkills Customer Playbooks
|
|
7
|
+
|
|
8
|
+
Use this skill when the user names a recurring GSkills customer. This is operational memory, not live proof. If the answer or action matters in production, re-check current DB rows, admin logs, sync logs, Slack, Gmail, Google Chat, or the app before acting.
|
|
9
|
+
|
|
10
|
+
## General Defaults
|
|
11
|
+
|
|
12
|
+
- Start from the customer instance, not from a generic global theory.
|
|
13
|
+
- For broken syncs, compare the target instance against global and against a working synced sibling when useful.
|
|
14
|
+
- For feedbacks, inspect the feedback row, user, instance, and admin logs before explaining the cause.
|
|
15
|
+
- For access issues, check user instance, access passes, auth mode, domain or account allowlists, then logs.
|
|
16
|
+
- For client wording, use the real thread or channel when available.
|
|
17
|
+
- Use `gskills-vocabulary` before writing human-facing summaries.
|
|
18
|
+
|
|
19
|
+
## Air Liquide
|
|
20
|
+
|
|
21
|
+
Air Liquide is the heavy recurring customer. Expect large content volume, customized content, language constraints, and auth or Google Admin setup work.
|
|
22
|
+
|
|
23
|
+
Common work:
|
|
24
|
+
|
|
25
|
+
- Broad content synchronisation from global, often with thousands of items.
|
|
26
|
+
- Large diffs with many `SKIPPED_CUSTOMIZED` items. This is normal, not automatically a failure.
|
|
27
|
+
- Page, quiz, parcours, menu, resource, badge, and internal knowledge parity checks after sync.
|
|
28
|
+
- Feedback instance attribution and page-family parity repairs.
|
|
29
|
+
- Access-denied work around expired access passes or domain allowlists.
|
|
30
|
+
- Okta setup and auth callback checks.
|
|
31
|
+
- Google Admin users, groups, and OU checks. Users and groups have worked before while OU access required scope/config follow-up.
|
|
32
|
+
- Locale and wording work, especially Quebec French.
|
|
33
|
+
- Short natural client-facing email drafts from the actual thread.
|
|
34
|
+
|
|
35
|
+
Known context:
|
|
36
|
+
|
|
37
|
+
- Customer id used during Google Admin checks: `C028v0b9g`.
|
|
38
|
+
- Known Google Chat space: `Air Liquide x Numericoach - GSkills`, `spaces/AAQAc2CT1qI`.
|
|
39
|
+
- Harold OUSSET was a known user whose display name required surname-first parsing.
|
|
40
|
+
- Air Liquide syncs should usually start with `sync logs`, then `sync diff`, then a narrow or preset run.
|
|
41
|
+
|
|
42
|
+
## HASAP
|
|
43
|
+
|
|
44
|
+
HASAP often appears in feedback and content visibility work.
|
|
45
|
+
|
|
46
|
+
Common work:
|
|
47
|
+
|
|
48
|
+
- Webinar content, parcours updates, invitations, user imports, and client-side launch follow-up.
|
|
49
|
+
- Badge visibility and badge delivery repairs.
|
|
50
|
+
- Google Forms badge issues where the page trigger stayed the same but the badge target changed.
|
|
51
|
+
- Quiz completion and answer submission investigations.
|
|
52
|
+
- Page sync visibility issues where disabled or archived state and sync logs mattered.
|
|
53
|
+
|
|
54
|
+
Known context:
|
|
55
|
+
|
|
56
|
+
- Known Google Chat space: `GSkills_Hasap_x_Numericoach`, `spaces/AAQAxJEETeI`.
|
|
57
|
+
- The recurring badge pitfall is workflow deduplication. A same-page `QUIZ_COMPLETED` execution can block a new badge action if only the badge target changed.
|
|
58
|
+
- Do not explain HASAP sync issues from the URL alone. Use prod data, the exact sync run, `LogsUser`, and the page or parcours family.
|
|
59
|
+
|
|
60
|
+
## FM LOGISTIC Google & Co
|
|
61
|
+
|
|
62
|
+
FM Logistic work is usually about resources, webinars, and visibility rules.
|
|
63
|
+
|
|
64
|
+
Known fixed facts:
|
|
65
|
+
|
|
66
|
+
- Instance name: `FM LOGISTIC Google & Co`.
|
|
67
|
+
- Instance id: `cmgtgrz02000t04l501wbp459`.
|
|
68
|
+
- Instance slug: `fm-logistic`.
|
|
69
|
+
- Main language: `fr`.
|
|
70
|
+
|
|
71
|
+
Common work:
|
|
72
|
+
|
|
73
|
+
- Add or audit webinar replays.
|
|
74
|
+
- Upload Drive recordings to GCS-backed GSkills resources.
|
|
75
|
+
- Keep AI webinars restricted to the right audience.
|
|
76
|
+
- Verify the end-user webinar page and custom video player.
|
|
77
|
+
|
|
78
|
+
Important rule:
|
|
79
|
+
|
|
80
|
+
- AI webinars should keep the French `IA` application/category attached.
|
|
81
|
+
- FM has a manual group named `Groupe AVEC IA` with inverted visibility. Do not add a broad active application like Google Workspace unless the user explicitly wants broader access.
|
|
82
|
+
|
|
83
|
+
Use the `fm-logistic-webinar-ingestion` skill for detailed webinar work.
|
|
84
|
+
|
|
85
|
+
## LGCF
|
|
86
|
+
|
|
87
|
+
LGCF often appears in technical rollout, Google Group access, feedback, and success-story work.
|
|
88
|
+
|
|
89
|
+
Common work:
|
|
90
|
+
|
|
91
|
+
- Google Chat and Gmail context checks before drafting client replies.
|
|
92
|
+
- Security group or Google Group behavior.
|
|
93
|
+
- Progression quiz feedback.
|
|
94
|
+
- Leaderboard and adjusted-points investigations, especially when unavailable quiz history changes visible ranking.
|
|
95
|
+
- Success-story outreach drafts.
|
|
96
|
+
|
|
97
|
+
Known context:
|
|
98
|
+
|
|
99
|
+
- Known Google Chat space: `LGCF & Numericoach | GSkills Technique IT`, `spaces/AAQACgXH1kQ`.
|
|
100
|
+
- A known feedback case involved leaderboard ordering versus raw points. Verify whether the complaint is raw progress, visible ranking, adjusted points, or course activity before digging.
|
|
101
|
+
|
|
102
|
+
## V&B
|
|
103
|
+
|
|
104
|
+
V&B has appeared in feedback triage around evaluation quiz behavior.
|
|
105
|
+
|
|
106
|
+
Common work:
|
|
107
|
+
|
|
108
|
+
- Quiz or evaluation feedback checks.
|
|
109
|
+
- Treat as a feedback-backed investigation. Verify the exact feedback row and current quiz state before describing the issue.
|
|
110
|
+
|
|
111
|
+
## Seine Yonne
|
|
112
|
+
|
|
113
|
+
Seine Yonne has appeared in access/login diagnosis.
|
|
114
|
+
|
|
115
|
+
Common work:
|
|
116
|
+
|
|
117
|
+
- Granular account allowlist checks.
|
|
118
|
+
- Login denial troubleshooting.
|
|
119
|
+
|
|
120
|
+
Known context:
|
|
121
|
+
|
|
122
|
+
- One prior issue was that `dmoindrot@farmidable.fr` was not in `accountGranular`, while `dmoindrot@seineyonne.fr` was.
|
|
123
|
+
- Do not collapse similar emails into one access story.
|
|
124
|
+
|
|
125
|
+
## Euromaster
|
|
126
|
+
|
|
127
|
+
Euromaster has appeared in sync and broad repair work.
|
|
128
|
+
|
|
129
|
+
Common work:
|
|
130
|
+
|
|
131
|
+
- Page-only or pages plus parcours synchronisation.
|
|
132
|
+
- Post-sync verification.
|
|
133
|
+
- Data repair blast-radius checks.
|
|
134
|
+
|
|
135
|
+
## Commune de Divonne-les-Bains, AS de Pic, 360 Courtage
|
|
136
|
+
|
|
137
|
+
These have appeared as new-client style pushes.
|
|
138
|
+
|
|
139
|
+
Common work:
|
|
140
|
+
|
|
141
|
+
- Broad first synchronisation from global.
|
|
142
|
+
- High created counts are expected.
|
|
143
|
+
- Run `client-content` diff first, then apply, then verify menus and deploy cache.
|
|
144
|
+
|
|
145
|
+
## Nickel Banque
|
|
146
|
+
|
|
147
|
+
Nickel Banque has appeared in feedback instance selection and page-family parity context.
|
|
148
|
+
|
|
149
|
+
Common work:
|
|
150
|
+
|
|
151
|
+
- Feedback routing or instance attribution checks.
|
|
152
|
+
- Verify the actual route context, target instance, and content family before repairing.
|
|
153
|
+
|
|
154
|
+
## Terega
|
|
155
|
+
|
|
156
|
+
Terega has appeared as a one-off client synchronisation target.
|
|
157
|
+
|
|
158
|
+
Common work:
|
|
159
|
+
|
|
160
|
+
- Treat as normal client-content sync unless the live logs say otherwise.
|
|
161
|
+
- Resolve the instance id and check recent sync logs before applying.
|
|
162
|
+
|
|
163
|
+
## Euralis, Orqual, Groupe Kiosque, UTT Yarns
|
|
164
|
+
|
|
165
|
+
These have appeared in broad data repair blast-radius checks.
|
|
166
|
+
|
|
167
|
+
Common work:
|
|
168
|
+
|
|
169
|
+
- Verify current state before touching anything.
|
|
170
|
+
- Do not infer a recurring product rule only because they were touched by a previous multi-instance repair.
|
|
171
|
+
|
|
172
|
+
## Instance Mere And Global
|
|
173
|
+
|
|
174
|
+
Global is the source of truth for shared content.
|
|
175
|
+
|
|
176
|
+
Common work:
|
|
177
|
+
|
|
178
|
+
- Create or update global courses, tutorials, granules, modules, quizzes, parcours, badges, menus, resources, and base de connaissance content.
|
|
179
|
+
- Compare global to a client instance before sync.
|
|
180
|
+
- Keep client customizations intact unless the user explicitly wants to overwrite or repair them.
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: gskills-vocabulary
|
|
3
|
+
description: Use when an agent explains GSkills operations to admins, writes summaries after CLI work, drafts messages about GSkills entities, or translates raw CLI/database concepts into the product vocabulary.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# GSkills Vocabulary
|
|
7
|
+
|
|
8
|
+
Use this skill whenever you talk to a human about GSkills operations. The CLI is not the story. It is just a way for an authorized agent to contact GSkills servers.
|
|
9
|
+
|
|
10
|
+
## Core Rule
|
|
11
|
+
|
|
12
|
+
Never make the conversation sound technical unless the user explicitly asks for implementation details.
|
|
13
|
+
|
|
14
|
+
Good:
|
|
15
|
+
|
|
16
|
+
- "J'ai demandé a GSkills de mettre a jour le parcours."
|
|
17
|
+
- "Je vais verifier les feedbacks et l'activite de l'utilisateur."
|
|
18
|
+
- "Le contenu est pret a etre pousse vers Air Liquide."
|
|
19
|
+
|
|
20
|
+
Avoid with non-dev admins:
|
|
21
|
+
|
|
22
|
+
- "J'ai appele l'API."
|
|
23
|
+
- "J'ai modifie une ressource CRUD."
|
|
24
|
+
- "La table Prisma a ete update."
|
|
25
|
+
- "Le payload JSON a ete envoye."
|
|
26
|
+
- "Le CLI a mute la row."
|
|
27
|
+
|
|
28
|
+
Commands, ids, JSON, and table names are fine in command blocks or agent notes. Translate them before speaking to admins.
|
|
29
|
+
|
|
30
|
+
## Product Vocabulary
|
|
31
|
+
|
|
32
|
+
- `learning path` means `parcours` in French.
|
|
33
|
+
- `category app`, `category application`, and `thematic` are spoken as `application`.
|
|
34
|
+
- `page` is usually not spoken as `page`. Prefer the pedagogical word that fits the context: `cours`, `tutoriel`, `granule`, or `module`.
|
|
35
|
+
- `tickets` are `feedbacks`.
|
|
36
|
+
- `base de co` and `base de connaissance` mean the end-user internal knowledge area. It regroups tutorial content, internal knowledge videos, webinars, documents, guides, and other resources.
|
|
37
|
+
- `internal knowledge` is `base de connaissance` or `contenu de base de connaissance` depending on the sentence.
|
|
38
|
+
- `resources` are `ressources`, such as webinars, replays, guides, documents, magazines, or useful links.
|
|
39
|
+
- `access pass` is an `acces`.
|
|
40
|
+
- `entity`, `group`, `org unit`, and `Google group` should become `groupe`, `groupe Google`, or `OU` depending on the real object.
|
|
41
|
+
- `feature flag` should usually become `parametre`, `option`, or `activation`.
|
|
42
|
+
- `workflow` should usually become `automatisation`.
|
|
43
|
+
- `cache invalidate` should become `rafraichir le cache` or `rafraichir le contenu`.
|
|
44
|
+
- `sync` should become `synchronisation` or `pousser le contenu`.
|
|
45
|
+
- `global` is the source instance or `instance mere`, not a customer.
|
|
46
|
+
- `instance` can stay `instance` with internal admins, but for clients prefer `espace client` or the client name.
|
|
47
|
+
|
|
48
|
+
## Speaking About Activity
|
|
49
|
+
|
|
50
|
+
Use product words:
|
|
51
|
+
|
|
52
|
+
- `user-paths` means completed courses, tutorials, granules, or modules.
|
|
53
|
+
- `quiz-attempts` means quiz attempts and quiz completion.
|
|
54
|
+
- `user-badges` means badges obtained by the user.
|
|
55
|
+
- `user-learning-paths` means parcours progress.
|
|
56
|
+
- `user-learning-path-item-completions` means completed steps inside a parcours.
|
|
57
|
+
- `chromebook-progress` means Chromebook game progress.
|
|
58
|
+
|
|
59
|
+
Do not tell a non-dev admin "I updated user-paths". Say the user is now marked as having completed the course, then mention the technical row only if the user asks for proof.
|
|
60
|
+
|
|
61
|
+
## Examples
|
|
62
|
+
|
|
63
|
+
Technical note:
|
|
64
|
+
|
|
65
|
+
```text
|
|
66
|
+
Updated user-paths row cm... with isAchieved=true.
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Admin-facing wording:
|
|
70
|
+
|
|
71
|
+
```text
|
|
72
|
+
J'ai marque le cours comme termine pour l'utilisateur et j'ai reverifie son activite.
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Technical note:
|
|
76
|
+
|
|
77
|
+
```text
|
|
78
|
+
Ran sync diff with preset client-content.
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Admin-facing wording:
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
J'ai compare le contenu a pousser avant de lancer la synchronisation.
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Technical note:
|
|
88
|
+
|
|
89
|
+
```text
|
|
90
|
+
Invalidated pages cache.
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Admin-facing wording:
|
|
94
|
+
|
|
95
|
+
```text
|
|
96
|
+
J'ai rafraichi le contenu pour que les changements remontent cote utilisateur.
|
|
97
|
+
```
|