@postman/postman-plugin 0.1.0 → 0.1.1-rc.0

package/README.md

@@ -21,7 +21,7 @@ dependencies, ownership, runtime behavior, and the likely impact of a change.
 Install Postman in every compatible coding agent detected on your machine:
 
 ```bash
-npx @postman/postman-plugin
+npx @postman/postman-plugin@next
 ```
 
 One command configures **Claude Code, Codex, Cursor, Kimi Code and OpenCode**.

package/dist/cli.js

@@ -20,13 +20,7 @@ Options:
   -y, --yes     Don't ask for confirmation (required when not in a terminal)
   --dry-run     Print what would change without changing anything
   -h, --help    Show this help
-  -v, --version Show the version
-
-Exit codes:
-  0  Done, or nothing needed doing
-  1  Something failed or was blocked, you cancelled, or install found no agent
-  2  Bad usage, or confirmation needed but no terminal (use --yes)
-  3  Done, except a step only you can do (printed as "next:")`;
+  -v, --version Show the version`;
 function version() {
     const manifest = new URL('../package.json', import.meta.url);
     return JSON.parse(fs.readFileSync(manifest, 'utf8')).version;

package/dist/hosts/kimi.js

@@ -46,13 +46,10 @@ export const kimi = {
             if (!(await system.which('npx'))) {
                 blocked('npx is not on PATH');
             }
-            // Only picks the verb: an unreadable store must not stop the install that could repair it.
-            const installed = await kimi.status(system).then((status) => status.installed, () => null);
-            // An explicit --package outranks the npm_config_package an outer `npx -p` exports to us.
-            await mustRun(system, 'npx', ['-y', `--package=${PLUGINS_CLI}`, 'plugins', 'add', REPO, '--target', 'kimi', '--yes'], {
+            await mustRun(system, 'npx', ['-y', PLUGINS_CLI, 'add', REPO, '--target', 'kimi', '--yes'], {
                 env: { DISABLE_TELEMETRY: '1', DO_NOT_TRACK: '1' }
             });
-            return result('done', `${installed ? 'updated' : 'installed'} ${PLUGIN_ID} in ${kimiHome(system)}`, NEXT);
+            return result('done', `installed ${PLUGIN_ID} into ${kimiHome(system)}`, NEXT);
         });
     },
     async remove(system) {

package/dist/run.js

@@ -1,5 +1,6 @@
-export const EXIT = { ok: 0, failed: 1, usage: 2, manual: 3 };
-const FAILED = ['failed', 'blocked'];
+export const EXIT = { ok: 0, failed: 1, usage: 2 };
+// `manual` counts: the command did not finish, and a script needs to know the user has a step left.
+const INCOMPLETE = ['failed', 'blocked', 'manual'];
 function padEnd(text, width) {
     return text + ' '.repeat(Math.max(1, width - text.length));
 }
@@ -75,15 +76,11 @@ export async function run(system, hosts, options) {
         }
     }
     if (!targets.length) {
-        system.log(options.agents.length ?
-            'None of the requested agents was found.' :
-            `No supported coding agent found. Supported: ${joinNames(requested)}.`);
+        system.log(`No supported coding agent found. Supported: ${joinNames(requested)}.`);
         reports.forEach((report) => system.log(`  ${report.result.message}`));
-        // Nothing to remove is a clean remove; nothing to install into is not a successful install.
-        return options.command === 'install' || (options.command === 'remove' && reports.length) ? EXIT.failed : EXIT.ok;
+        return reports.length && options.command !== 'status' ? EXIT.failed : EXIT.ok;
     }
-    // "Found:" over "not installed" read to agents as "not found"; the header says both things.
-    system.log(`Found ${targets.length} coding agent${targets.length === 1 ? '' : 's'}. Postman in each:`);
+    system.log('Found:');
     printStatuses(system, targets, width);
     reports.forEach((report) => system.log(`  ${padEnd(report.host.name, width)}${report.result.message}`));
     if (options.command === 'status') {
@@ -93,12 +90,12 @@ export async function run(system, hosts, options) {
     // remove also clears duplicates and half-finished installs that status doesn't count.
     const command = options.command;
     if (!options.yes && !system.dryRun) {
-        const verb = command === 'install' ? 'install or update Postman in' : 'remove Postman from', names = joinNames(targets.map((target) => target.host));
         if (!options.isTTY) {
-            system.log(`\nNothing changed: there is no terminal to confirm in. To ${verb} ${names}, re-run with --yes (add --agent <id> for only some).`);
+            system.log('\nNot running in a terminal, so there is no one to confirm. Re-run with --yes.');
             return EXIT.usage;
         }
-        if (!(await options.confirm(`\n${verb[0].toUpperCase()}${verb.slice(1)} ${names}? [Y/n] `))) {
+        const verb = command === 'install' ? 'Install or update Postman in' : 'Remove Postman from';
+        if (!(await options.confirm(`\n${verb} ${joinNames(targets.map((target) => target.host))}? [Y/n] `))) {
             system.log('Cancelled.');
             return EXIT.failed;
         }
@@ -113,8 +110,5 @@ export async function run(system, hosts, options) {
     for (const { host, result } of reports) {
         system.log(`  ${padEnd(host.name, width)}${padEnd(result.outcome, 9)}${result.message.split('\n')[0]}`);
     }
-    if (reports.some(({ result }) => FAILED.includes(result.outcome))) {
-        return EXIT.failed;
-    }
-    return reports.some(({ result }) => result.outcome === 'manual') ? EXIT.manual : EXIT.ok;
+    return reports.some(({ result }) => INCOMPLETE.includes(result.outcome)) ? EXIT.failed : EXIT.ok;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman/postman-plugin",
-  "version": "0.1.0",
+  "version": "0.1.1-rc.0",
   "description": "Installs the Postman plugin into every supported coding agent on this machine.",
   "type": "module",
   "license": "Apache-2.0",