@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 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 disable or deactivate rows when the resource supports it, and refuse resources that cannot be safely disabled.
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 soft-delete when the end-user view must reflect the change immediately.
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.