@passioncode-ai/passioncode 0.2.56 → 0.2.58

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.2.58 - 2026-11-03
+
+### Fixed
+
+- `help` says that exit code 0 also means only a plan was shown, and `docs/reference/cli.md` says
+  when a run without a terminal and without `--yes` is a plan: only when it would change something;
+  otherwise it exits by its checks (PC-100). The setup and doctor variant of "unsupported
+  arguments" is in the string registry. The help test now reads the flags setup parses by pattern
+  and the command aliases from the parser itself, and the string registry test requires each
+  location to hold the longest literal run of its text.
+
+## 0.2.57 - 2026-11-03
+
+### Fixed
+
+- A terminal `setup` that declined every offer (PC-91) exits by its checks, 1 when a check still
+  fails, whether or not it named a release train (PC-93). Before, naming a train other than the
+  saved one made it exit 0 as a plan does, and otherwise it exited by its checks, though in both
+  the person changed nothing. A run that only returns a plan (`--dry-run`, or no terminal and no
+  `--yes` when it would change something) still exits 0.
+
 ## 0.2.56 - 2026-11-03
 
 ### Fixed

package/README.md

@@ -108,8 +108,8 @@ does not answer is started through launchd (`launchctl kickstart`, never a kill)
 
 `doctor` changes nothing. It reads prerequisites, the skill set, each app's version, signature
 and team, each agent's MCP entries with one proving call per server, and the Fabric services of
-the family; each line names its state and its fix. Exit codes: **0** no check failed, **1** a
-check (or a setup step) failed, **2** bad arguments. `doctor --fix` runs setup's repairs without
+the family; each line names its state and its fix. Exit codes: **0** no check failed (or `setup`
+only showed its plan), **1** a check (or a setup step) failed, **2** bad arguments. `doctor --fix` runs setup's repairs without
 installing new apps. Details: the [CLI contract](docs/reference/cli.md#setup-and-doctor).
 
 **Release trains.** An organization's machines install one set of pinned app versions instead of

package/bin/passioncode.js

@@ -30,9 +30,10 @@ const HELP = `passioncode sets up and checks PassionCode.ai on this machine: the
 
 onboard is another name for setup, install for update. --offline skips the check for newer app
 releases; --quiet prints nothing when an update succeeds. App ids: switchboard, dashboards,
-observatory, inbox, fabric. Exit codes: 0 nothing failed, 1 a check or a step failed, 2 bad
-arguments. Claude Code gets plugins from the local "passioncode" marketplace; other agents get
-the same skills through ~/.agents/skills. Restart your agent after a change.`;
+observatory, inbox, fabric. Exit codes: 0 nothing failed (or only a plan was shown), 1 a check
+or a step failed, 2 bad arguments. Claude Code gets plugins from the local "passioncode"
+marketplace; other agents get the same skills through ~/.agents/skills. Restart your agent after
+a change.`;
 
 const IDS = ['switchboard', 'dashboards', 'observatory', 'inbox', 'fabric'];
 
@@ -93,7 +94,7 @@ async function setupOrDoctor(cmd, rest) {
     noOpen: o.flags.has('--no-open'), dryRun: o.flags.has('--dry-run'), repairOnly, online, ask: json ? null : asker(), log, train: o.train,
   });
   process.stdout.write(json ? JSON.stringify(r, null, 2) + '\n' : S.render(r, { repairOnly }) + '\n');
-  return r.planOnly ? 0 : r.ok ? 0 : 1;
+  return S.exitCode(r);
 }
 
 async function main(argv) {

package/lib/setup.js

@@ -283,6 +283,11 @@ function finish(result, home, checks) {
   return result;
 }
 
+// The exit code of a setup or doctor --fix run. A plan exits 0 (nothing was agreed, nothing ran);
+// a declined run (PC-91) is not a plan but the person's answer, so it exits by its checks like any
+// run that changed nothing (PC-93): 1 when a check still fails, with or without a named train.
+const exitCode = (r) => (r.planOnly && !r.declined ? 0 : r.ok ? 0 : 1);
+
 const DECLINED = 'You declined every offer; nothing was changed. The checks below still stand.';
 const notTaken = (names) => `Nothing was changed: ${names.join(' and ')} ${names.length > 1 ? 'were' : 'was'} offered and not installed. The checks below still stand.`;
 
@@ -331,4 +336,4 @@ function render(result, { repairOnly = false } = {}) {
   return lines.join('\n');
 }
 
-module.exports = { setup, plan, render };
+module.exports = { setup, plan, render, exitCode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@passioncode-ai/passioncode",
-  "version": "0.2.56",
+  "version": "0.2.58",
   "description": "Set up PassionCode.ai on a computer with one command: the apps from their verified releases, their MCP servers for every coding agent and the PassionCode.ai skills. Check and repair it with the same command or `doctor`.",
   "bin": {
     "passioncode": "bin/passioncode.js"

package/payload/.claude-plugin/marketplace.json

@@ -35,7 +35,7 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "source": "./plugins/passioncode",
-      "version": "0.2.56",
+      "version": "0.2.58",
       "description": "Set up and check PassionCode.ai on a computer with one command (setting-up-passioncode), the organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
       "author": {
         "name": "PassionCode.ai",

package/payload/manifest.json

@@ -1,6 +1,6 @@
 {
   "family": "passioncode",
-  "version": "0.2.56",
+  "version": "0.2.58",
   "release": true,
   "members": [
     {
@@ -62,9 +62,9 @@
       "name": "passioncode",
       "displayName": "PassionCode.ai",
       "repo": "passioncode-ai/passioncode",
-      "ref": "v0.2.56",
+      "ref": "v0.2.58",
       "commit": null,
-      "version": "0.2.56",
+      "version": "0.2.58",
       "via": "this repository",
       "skills": [
         "setting-up-passioncode",
@@ -72,7 +72,7 @@
       ],
       "legacyPluginIds": [],
       "legacyMarketplaces": [],
-      "contentHash": "sha256:74cc82e781ba9b34e48e223ad2cb87c0e2d512d486cf1a204fbf08a2a95571cc",
+      "contentHash": "sha256:91ec6c72329e954bd6857f6759dd5fdaf062d686dcd7e5ef6571155589be3d22",
       "description": "Set up and check PassionCode.ai on a computer with one command (setting-up-passioncode), the organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check that keeps the PassionCode.ai set current.",
       "author": {
         "name": "PassionCode.ai",

package/payload/plugins/passioncode/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "passioncode",
   "displayName": "PassionCode.ai",
-  "version": "0.2.56",
+  "version": "0.2.58",
   "description": "Set up and check PassionCode.ai on a computer with one command (setting-up-passioncode), the organisation's working rules for every contributor's agent (working-in-passioncode), and a once-a-day check at session start that keeps the PassionCode.ai skill set current.",
   "author": {
     "name": "PassionCode.ai",