@nuxtseo/cli 0.2.0 → 0.2.1

package/dist/cli.js

@@ -126,7 +126,7 @@ async function switchSite(runtime, globals) {
         output: runtime.error,
         signal: runtime.signal,
     });
-    if (prompts.isCancel(selected))
+    if (typeof selected === 'symbol')
         return fail(EXIT_CODE.interrupted, 'interrupted: Site selection cancelled.');
     const saved = await updateConfig({ siteId: selected }, { paths: runtime.paths });
     if (saved._tag === 'Err')
@@ -143,7 +143,7 @@ async function promptPageUrl(runtime, action) {
         signal: runtime.signal,
         validate: value => typeof value === 'string' && URL.canParse(value) ? undefined : 'Enter an absolute URL.',
     });
-    return prompts.isCancel(url)
+    return typeof url === 'symbol'
         ? fail(EXIT_CODE.interrupted, `interrupted: ${action} cancelled.`)
         : ok(url);
 }
@@ -158,7 +158,7 @@ async function promptTextValue(runtime, options) {
             ? undefined
             : `${options.label} is required.`,
     });
-    return prompts.isCancel(value)
+    return typeof value === 'symbol'
         ? fail(EXIT_CODE.interrupted, `interrupted: ${options.label} entry cancelled.`)
         : ok(value.trim());
 }
@@ -219,7 +219,7 @@ async function interactiveBare(runtime, globals) {
         output: runtime.error,
         signal: runtime.signal,
     });
-    if (prompts.isCancel(group) || group === 'exit')
+    if (typeof group === 'symbol' || group === 'exit')
         return ok(undefined);
     if (group === 'login')
         return runInteractiveCommand(['login'], runtime, globals);
@@ -239,7 +239,7 @@ async function interactiveBare(runtime, globals) {
             output: runtime.error,
             signal: runtime.signal,
         });
-        if (prompts.isCancel(task))
+        if (typeof task === 'symbol')
             return ok(undefined);
         if (task === 'inspect' || task === 'scan') {
             const url = await promptPageUrl(runtime, task === 'inspect' ? 'Inspect' : 'Scan');
@@ -278,7 +278,7 @@ async function interactiveBare(runtime, globals) {
             output: runtime.error,
             signal: runtime.signal,
         });
-        if (prompts.isCancel(task))
+        if (typeof task === 'symbol')
             return ok(undefined);
         const command = task === 'performance'
             ? ['performance']
@@ -318,7 +318,7 @@ async function interactiveBare(runtime, globals) {
             output: runtime.error,
             signal: runtime.signal,
         });
-        if (prompts.isCancel(task))
+        if (typeof task === 'symbol')
             return ok(undefined);
         if (task === 'overview')
             return runInteractiveCommand(['research', 'overview'], runtime, globals);
@@ -362,7 +362,7 @@ async function interactiveBare(runtime, globals) {
             output: runtime.error,
             signal: runtime.signal,
         });
-        if (prompts.isCancel(task))
+        if (typeof task === 'symbol')
             return ok(undefined);
         if (task === 'briefs')
             return runInteractiveCommand(['content', 'briefs', 'list'], runtime, globals);
@@ -394,7 +394,7 @@ async function interactiveBare(runtime, globals) {
         output: runtime.error,
         signal: runtime.signal,
     });
-    if (prompts.isCancel(task))
+    if (typeof task === 'symbol')
         return ok(undefined);
     if (task === 'site')
         return switchSite(runtime, globals);

package/dist/commands.js

@@ -1,4 +1,5 @@
 import * as prompts from '@clack/prompts';
+import { accountFeedbackBodySchema } from '@nuxtseo/protocol/v1/account';
 import { publicV1BooleanFlagValue } from '@nuxtseo/protocol/v1/core';
 import { defineCommand } from 'citty';
 import { dirname } from 'pathe';
@@ -97,7 +98,7 @@ async function confirmMutation(runtime, globals, message) {
         signal: runtime.signal,
         initialValue: false,
     });
-    if (prompts.isCancel(confirmed))
+    if (typeof confirmed === 'symbol')
         return fail(EXIT_CODE.interrupted, 'interrupted: Mutation cancelled.');
     return ok(confirmed);
 }
@@ -111,7 +112,7 @@ async function readLoginToken(runtime) {
             signal: runtime.signal,
             validate: value => typeof value === 'string' && value.trim() ? undefined : 'Token is required.',
         });
-        if (prompts.isCancel(token))
+        if (typeof token === 'symbol')
             return fail(EXIT_CODE.interrupted, 'interrupted: Login cancelled.');
         return ok(token.trim());
     }
@@ -277,7 +278,7 @@ async function config(runtime, globals) {
         output: runtime.error,
         signal: runtime.signal,
     });
-    if (prompts.isCancel(action) || action === 'done')
+    if (typeof action === 'symbol' || action === 'done')
         return ok(undefined);
     if (action === 'api') {
         const next = await prompts.text({
@@ -287,7 +288,7 @@ async function config(runtime, globals) {
             output: runtime.error,
             signal: runtime.signal,
         });
-        if (prompts.isCancel(next))
+        if (typeof next === 'symbol')
             return fail(EXIT_CODE.interrupted, 'interrupted: Configuration cancelled.');
         const written = await updateConfig({ apiUrl: next }, { paths: runtime.paths });
         if (written._tag === 'Err')
@@ -345,6 +346,25 @@ async function usage(runtime, globals, group) {
     const response = await withSpinner(runtime, 'Loading usage', () => api.value.client.account.usage({ query: { group } }, { signal: runtime.requestSignal }));
     return present(runtime, globals, response, renderUsage);
 }
+async function feedbackSubmit(runtime, globals, args) {
+    const body = accountFeedbackBodySchema.safeParse({ ...args, cliVersion: VERSION });
+    if (!body.success)
+        return fail(EXIT_CODE.invalidInput, 'Pass valid --command, --comment, and --agent values. Read feedback submit --help for limits.', undefined, 'invalid_cli_input');
+    const confirmed = await confirmMutation(runtime, globals, 'Submit this agent report to NuxtSEO feedback?');
+    if (confirmed._tag === 'Err')
+        return confirmed;
+    if (!confirmed.value) {
+        writeDiagnostic(runtime, 'Feedback cancelled.');
+        return ok(undefined);
+    }
+    const api = await loadApiContext(runtime, globals);
+    if (api._tag === 'Err')
+        return api;
+    const response = await withSpinner(runtime, 'Submitting feedback', () => api.value.client.account.feedback({
+        body: body.data,
+    }, { signal: runtime.requestSignal }));
+    return present(runtime, globals, response, value => `Feedback saved: ${value.data.id} (${value.data.status})`);
+}
 async function actionsList(runtime, globals, args) {
     const limit = parseInteger(args.limit, { name: '--limit', minimum: 1, maximum: 25, defaultValue: 10 });
     if (limit._tag === 'Err')
@@ -1877,8 +1897,8 @@ export function createRootCommand(runtime, globals, execution) {
             'changes': defineCommand({
                 meta: { name: 'changes', description: 'Compare the latest crawl with its baseline' },
                 args: {
-                    from: { type: 'string', description: 'Baseline crawl generation' },
-                    to: { type: 'string', description: 'Comparison crawl generation' },
+                    from: { type: 'string', description: 'Baseline crawl number' },
+                    to: { type: 'string', description: 'Comparison crawl number' },
                 },
                 run: ({ args }) => capture(execution, () => auditChanges(runtime, globals, {
                     from: args.from,
@@ -2155,6 +2175,28 @@ export function createRootCommand(runtime, globals, execution) {
                 run: ({ args }) => capture(execution, () => config(runtime, globals), args._, 0)(),
             }),
             sites,
+            feedback: defineCommand({
+                meta: { name: 'feedback', description: 'Report CLI problems to NuxtSEO' },
+                subCommands: {
+                    submit: defineCommand({
+                        meta: { name: 'submit', description: 'Submit sanitized agent feedback without selecting a Site' },
+                        args: {
+                            'command': { type: 'string', required: true, description: 'Affected command without secrets or private arguments, maximum 200 characters' },
+                            'comment': { type: 'string', required: true, description: 'Agent disclosure, reproduction steps, expected result, actual result, and workaround, maximum 2000 characters' },
+                            'agent': { type: 'string', required: true, description: 'Reporting agent name, maximum 100 characters' },
+                            'intent': { type: 'enum', options: ['bug', 'improvement'], description: 'Feedback intent, default bug' },
+                            'request-id': { type: 'string', description: 'Request ID from the affected response, maximum 128 characters' },
+                        },
+                        run: ({ args }) => capture(execution, () => feedbackSubmit(runtime, globals, {
+                            command: args.command,
+                            comment: args.comment,
+                            agent: args.agent,
+                            intent: args.intent,
+                            requestId: args['request-id'],
+                        }), args._, 0)(),
+                    }),
+                },
+            }),
             usage: defineCommand({
                 meta: { name: 'usage', description: 'Read account usage' },
                 args: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuxtseo/cli",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Command line interface for the NuxtSEO public API.",
   "license": "MIT",
   "homepage": "https://nuxtseo.com/pro",
@@ -32,8 +32,9 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@clack/prompts": "^1.7.0",
-    "@nuxtseo/sdk": "^0.2.0",
+    "@clack/prompts": "^1.8.0",
+    "@nuxtseo/protocol": "^0.2.1",
+    "@nuxtseo/sdk": "^0.2.1",
     "citty": "^0.2.2",
     "pathe": "^2.0.3"
   },
@@ -42,10 +43,9 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@nuxtseo/protocol": "0.2.0",
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.5.1",
     "publint": "^0.3.24",
-    "typescript": "npm:typescript-native-bridge@6.0.3-bridge.15.tsgo.7.0.2"
+    "typescript": "npm:typescript-native-bridge@6.0.3-bridge.16.tsgo.7.0.2"
   },
   "publishConfig": {
     "access": "public"

package/skills/nuxtseo-cli/SKILL.md

@@ -71,7 +71,8 @@ accessible Site with its ID.
 
 ## How to call it as an agent
 
-Always pass `--json` and `--site <site-id>`.
+Always pass `--json`. Pass `--site <site-id>` for Site commands.
+`feedback submit` needs no Site.
 
 ```sh
 nuxtseo actions list --site site_123 --json
@@ -267,6 +268,41 @@ merge them.
 `analysed: false` means there is no completed crawl, or no Google index state
 to join against. That is a coverage gap, not healthy indexing. Say which.
 
+## Report CLI feedback
+
+If CLI behavior blocks or slows your work, submit feedback once per distinct problem during the task.
+Report confusing output, missing context, incorrect help, unexpected failures, and useful workarounds.
+Continue the user's task after reporting.
+
+```sh
+nuxtseo feedback submit --command "search cohorts" --agent "Codex" \
+  --comment "Agent report by Codex. Expected a reason for missing data. Received an empty list. Used search status instead." \
+  --yes --json
+```
+
+Use your actual agent name. Start the comment with an agent disclosure.
+Include reproduction steps, expected behavior, actual behavior, and any workaround.
+Use `--intent improvement` for suggestions. The default is `bug`.
+If the affected response has a request ID, pass it with `--request-id`.
+The CLI adds its version automatically.
+
+Send sanitized details only. Remove tokens, cookies, personal data, private URLs, and customer content.
+Use command names and placeholder arguments. Never paste raw logs or full response bodies.
+
+Self-reporting sanitized CLI feedback is authorized by this skill. No separate confirmation is needed.
+This permission covers feedback only. Respect any user instruction that forbids reporting.
+The endpoint requires a working credential with `feedback:write`, available to every Team role.
+It uses no paid limit and allows ten reports per credential each hour.
+
+Success returns `data.id` and `data.status: "new"`. Keep the ID with your task notes.
+If reporting fails, mention the failure and continue. Never retry uncertain submissions or report failures recursively.
+If authentication is broken, describe the feedback to the user. Do not invent another endpoint.
+
+Reports use the existing feedback queue through `POST /api/v1/account/feedback`.
+Health checks show unresolved reports across all dates.
+Operators use **Pro feedback** in admin to record a fix reference and set `fixed` after verification.
+Fixed, replied, closed, and ignored reports leave the health check list. Reopening restores them.
+
 ## Guardrails
 
 - **Get consent before a mutation.** `actions resolve`, `actions dismiss`,

package/skills/nuxtseo-cli/references/commands.md

@@ -37,6 +37,7 @@ indexing urls`, `sitemaps urls` and `content briefs list`.
 | Command | What it returns, and its flags |
 | --- | --- |
 | `whoami` | Credential, Team, role, granted scopes, token expiry. The cheapest health check. Reads no Site |
+| `feedback submit` | Submit sanitized agent feedback. Requires `--command` (1..200 characters), `--comment` (1..2000), `--agent` (1..100), and `--yes`. Optional `--intent bug\|improvement` (default `bug`) and `--request-id` (1..128). Adds the CLI version. Needs no Site. Returns the feedback ID and status |
 | `login` | Pairs the CLI with a Team through the browser. A person must approve the pairing, so ask the user to run it. `--with-token` reads a token from a hidden prompt or stdin. `--no-browser` skips opening the browser |
 | `logout` | Discards the stored credential. Returns a `CliLogout` value |
 | `sites list` | Every accessible Site. The source of Site IDs |