niranzwp 0.8.3 → 0.8.4

package/bin/niranzwp.js

@@ -164,7 +164,7 @@ const out = (flags, value, pretty) => {
 
 async function main() {
 	const { _: pos, flags } = parseArgs(process.argv.slice(2));
-	const [cmd, sub, ...rest] = pos;
+	let [cmd, sub, ...rest] = pos;
 
 	if (flags.version || cmd === 'version') {
 		console.log(`NiranzWP CLI v${VERSION}`);
@@ -174,6 +174,11 @@ async function main() {
 
 	if (!cmd || flags.help || cmd === 'help') { console.log(USAGE); return; }
 
+	// The first outside user's first command was "posts list". Plurals are
+	// what people type; refusing them over one letter is a papercut with no
+	// upside, so both forms work and the docs keep showing the singular.
+	cmd = { posts: 'post', pages: 'page', users: 'user', medias: 'media', setting: 'settings', site: 'sites' }[cmd] ?? cmd;
+
 	if (cmd === 'auth' && sub === 'login') {
 		const url = rest[0];
 		if (!url) die('usage: niranzwp auth login <url>');

package/lib/errors.js

@@ -68,8 +68,13 @@ export function fromRest(status, body, fallback = 'usage_error') {
 		// capability failure, so keep the two hints apart.
 		const scoped = /route|scope/i.test(String(body?.message ?? ''));
 		return new CliError('insufficient_scope', body?.message || 'Not permitted.', {
+			// The first outside session hit this and the old hint only
+			// explained the problem. A hint that names no way forward is a
+			// dead end wearing a helpful tone.
 			hint: scoped
-				? 'This token is scoped to a different endpoint. Novamira OAuth tokens work against its MCP endpoint, not the core abilities run route.'
+				? 'This profile\'s OAuth token only covers its provider\'s own routes (abilities, MCP), not core REST. ' +
+				  'For core commands (post, page, media, settings), connect the same site with an application password: ' +
+				  'niranzwp auth login <site> --app-password --name <new-profile> (add --manual if the browser is on another machine).'
 				: 'This credential belongs to a user without the required capability.',
 		});
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niranzwp",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "A CLI for WordPress. Works on any site via Application Passwords, and unlocks Abilities where a site provides them.",
   "type": "module",
   "bin": {