@numericoach/gskills-admin-cli 0.1.28 → 0.1.30
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 +39 -3
- package/dist/gskills-admin.js +1420 -148
- package/package.json +1 -1
- package/skills/gskills-admin-cli/SKILL.md +43 -5
package/README.md
CHANGED
|
@@ -16,8 +16,8 @@ bun run gskills-admin pages list
|
|
|
16
16
|
bun run gskills-admin sync run --target <instanceId> --only pages,quizzes --yes
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
Content-like resources default to `instanceId = "global"` when `--instance` is omitted.
|
|
20
|
-
Delete commands are soft-only. They
|
|
19
|
+
Content-like resources default to `instanceId = "global"` when `--instance` is omitted. On `global`, create defaults to `disabled: true` for resources that support it unless the payload explicitly says otherwise.
|
|
20
|
+
Delete commands are soft-only. They archive rows when the resource supports `archived`, fall back only when that field does not exist, and refuse resources that cannot be safely hidden.
|
|
21
21
|
CLI writes are logged in the GSkills admin logs with the authenticated user and CLI metadata.
|
|
22
22
|
|
|
23
23
|
Sync dry-runs use the shared GSkills diff preview system:
|
|
@@ -55,7 +55,7 @@ gskills-admin pages create --data-file ./page.json --dry-run --output json
|
|
|
55
55
|
gskills-admin pages update <pageId> --data-file ./page-fields.json --yes --output json
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
Use the listed `cache.scopes` with `gskills-admin cache invalidate` after create, update, or
|
|
58
|
+
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. Delete flows should archive content first; after a real delete, re-read the row and verify `archived: true` when the resource supports it.
|
|
59
59
|
|
|
60
60
|
For page body edits, prefer the granular block helpers when a stable block id exists. Dry-run first, then write:
|
|
61
61
|
|
|
@@ -88,6 +88,28 @@ Block helpers read the full page content, find nested blocks by id, generate gua
|
|
|
88
88
|
|
|
89
89
|
`pages content-schema` is the machine-readable source of truth for supported EditorJS/GSkills blocks, nested child-block paths, immutable reference fields and examples. Agents should call it before generating or patching page content.
|
|
90
90
|
|
|
91
|
+
Content governance and page comments use the same data and write paths as the super-admin governance UI:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
gskills-admin governance list --instance global --output json
|
|
95
|
+
gskills-admin governance get <entryId> --instance global --output json
|
|
96
|
+
gskills-admin governance comments-board --instance global --mine --output json
|
|
97
|
+
gskills-admin governance open-comment-count --instance global --output json
|
|
98
|
+
gskills-admin governance search --instance global --query Gmail --output json
|
|
99
|
+
gskills-admin governance create-task --entity-type page --entity-id <pageId> --status CHANGES_REQUESTED --task-title "Relire la page" --dry-run --output json
|
|
100
|
+
gskills-admin governance upsert --entity-type page --entity-id <pageId> --status TO_REVIEW --dry-run --output json
|
|
101
|
+
gskills-admin governance update-task <entryId> --task-description-file ./details.md --dry-run --output json
|
|
102
|
+
gskills-admin governance set-assignees <entryId> --user-ids <userId,userId> --dry-run --output json
|
|
103
|
+
gskills-admin governance set-instance <entryId> --target-instance <instanceId> --dry-run --output json
|
|
104
|
+
gskills-admin governance comments add <entryId> --content-file ./comment.md --dry-run --output json
|
|
105
|
+
gskills-admin page-comments list <pageId> --output json
|
|
106
|
+
gskills-admin page-comments add <pageId> --content-file ./comment.md --block-id <blockId> --create-task --dry-run --output json
|
|
107
|
+
gskills-admin page-comments reply <parentCommentId> --content-file ./reply.md --dry-run --output json
|
|
108
|
+
gskills-admin page-comments resolve <commentId> --dry-run --output json
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Governance and page-comment writes require `--dry-run` or `--yes`. Task deletion also requires `--force --confirm-delete governance:<entryId>`.
|
|
112
|
+
|
|
91
113
|
Large local videos can be uploaded directly to GSkills storage before creating or updating internal knowledge and resources. The CLI asks the app for a signed upload URL, streams the local file directly to GCS, then writes the normal row with the returned URL. Use `--instance` for client-specific content.
|
|
92
114
|
|
|
93
115
|
```bash
|
|
@@ -99,6 +121,20 @@ gskills-admin resources update <resourceId> --upload-file ./webinar-v2.mp4 --dat
|
|
|
99
121
|
|
|
100
122
|
Use `--mime-type` when the extension is ambiguous, and `--upload-name` when the stored file name needs a cleaner label.
|
|
101
123
|
|
|
124
|
+
Learning path icons can use the same three sources as the super-admin editor:
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
gskills-admin learning-paths icons --query Gmail --output json
|
|
128
|
+
gskills-admin learning-paths set-icon <learningPathId> --app Gmail --dry-run --output json
|
|
129
|
+
gskills-admin learning-paths set-icon <learningPathId> --upload-file ./icon.png --instance <instanceId> --dry-run --output json
|
|
130
|
+
gskills-admin learning-paths generate-icon <learningPathId> --prompt "flat central handshake, transparent background" --dry-run --output json
|
|
131
|
+
gskills-admin learning-paths generate-icon <learningPathId> --prompt-file ./icon-prompt.txt --yes --output json
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
`icons` reads only French global category app icons. `set-icon --upload-file` streams the local image to storage with a signed URL and writes `LearningPath.iconUrl`. `generate-icon` calls the same server-side image generator used by the editor, then stores the generated URL on the learning path.
|
|
135
|
+
|
|
136
|
+
Do not pass `--use-app-icon` unless the user explicitly asks for the app logo to appear. It is off by default because most parcours icons should be symbolic. Repeating app logos across every learning path gets visually heavy and often produces cluttered, low-quality icons.
|
|
137
|
+
|
|
102
138
|
AI translation is available for content that has native AI translation in the editor:
|
|
103
139
|
|
|
104
140
|
Warning: `translate pages` rewrites each translated page from the source page. It is not a diff update. Recreating translated pages this way can lose activity-specific fields, quiz ids, embedded ids, or future custom block data if the translator does not preserve them. Prefer the app diff update flow for pages with activities or custom blocks.
|