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

package/README.md

@@ -21,10 +21,12 @@ dependencies, ownership, runtime behavior, and the likely impact of a change.
 Install Postman in every compatible coding agent detected on your machine:
 
 ```bash
-npx plugins add postmanlabs/postman-plugin
+npx @postman/postman-plugin
 ```
 
-One command configures **Claude Code, Cursor, Codex**.
+One command configures **Claude Code, Codex, Cursor, Kimi Code and OpenCode**.
+Run it again to update, `status` to see what's installed, and `remove` to
+uninstall; `--agent <id>` limits any of them to one agent.
 
 You can also use the following commands to install individually:
 

package/dist/cli.js

@@ -20,7 +20,13 @@ 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`;
+  -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:")`;
 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,10 +46,13 @@ export const kimi = {
             if (!(await system.which('npx'))) {
                 blocked('npx is not on PATH');
             }
-            await mustRun(system, 'npx', ['-y', PLUGINS_CLI, 'add', REPO, '--target', 'kimi', '--yes'], {
+            // 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'], {
                 env: { DISABLE_TELEMETRY: '1', DO_NOT_TRACK: '1' }
             });
-            return result('done', `installed ${PLUGIN_ID} into ${kimiHome(system)}`, NEXT);
+            return result('done', `${installed ? 'updated' : 'installed'} ${PLUGIN_ID} in ${kimiHome(system)}`, NEXT);
         });
     },
     async remove(system) {

package/dist/run.js

@@ -1,6 +1,5 @@
-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'];
+export const EXIT = { ok: 0, failed: 1, usage: 2, manual: 3 };
+const FAILED = ['failed', 'blocked'];
 function padEnd(text, width) {
     return text + ' '.repeat(Math.max(1, width - text.length));
 }
@@ -76,11 +75,15 @@ export async function run(system, hosts, options) {
         }
     }
     if (!targets.length) {
-        system.log(`No supported coding agent found. Supported: ${joinNames(requested)}.`);
+        system.log(options.agents.length ?
+            'None of the requested agents was found.' :
+            `No supported coding agent found. Supported: ${joinNames(requested)}.`);
         reports.forEach((report) => system.log(`  ${report.result.message}`));
-        return reports.length && options.command !== 'status' ? EXIT.failed : EXIT.ok;
+        // 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;
     }
-    system.log('Found:');
+    // "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:`);
     printStatuses(system, targets, width);
     reports.forEach((report) => system.log(`  ${padEnd(report.host.name, width)}${report.result.message}`));
     if (options.command === 'status') {
@@ -90,12 +93,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('\nNot running in a terminal, so there is no one to confirm. Re-run with --yes.');
+            system.log(`\nNothing changed: there is no terminal to confirm in. To ${verb} ${names}, re-run with --yes (add --agent <id> for only some).`);
             return EXIT.usage;
         }
-        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] `))) {
+        if (!(await options.confirm(`\n${verb[0].toUpperCase()}${verb.slice(1)} ${names}? [Y/n] `))) {
             system.log('Cancelled.');
             return EXIT.failed;
         }
@@ -110,5 +113,8 @@ 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]}`);
     }
-    return reports.some(({ result }) => INCOMPLETE.includes(result.outcome)) ? EXIT.failed : EXIT.ok;
+    if (reports.some(({ result }) => FAILED.includes(result.outcome))) {
+        return EXIT.failed;
+    }
+    return reports.some(({ result }) => result.outcome === 'manual') ? EXIT.manual : EXIT.ok;
 }

package/package.json

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