@pify/cli 0.2.2 → 0.3.0

package/README.md

@@ -24,6 +24,7 @@ pify setup --pi-version 0.84.4   # pin the version your team has tested
 pify setup --installer     # run pi's official interactive installer (ps1/sh)
 pify list                  # show the @pify catalog with install state
 pify install goal task     # short names resolve to @pify/goal, @pify/task
+pify install suite         # the whole suite in one go (also: core, agents)
 pify install goal -l -a    # project scope, pre-approved (CI-friendly)
 pify remove goal
 pify update                # update pi + every installed @pify package

package/catalog.json

@@ -1,5 +1,5 @@
 {
-  "version": 15,
+  "version": 16,
   "org": "pifydev",
   "scope": "@pify",
   "remote": "https://raw.githubusercontent.com/pifydev/cli/main/catalog.json",
@@ -102,5 +102,47 @@
       "description": "One toggle to auto-approve everything, with an undo trail: three-tier bash guard, file pre-images",
       "status": "published"
     }
+  ],
+  "bundles": [
+    {
+      "name": "suite",
+      "description": "Every published @pify extension",
+      "packages": [
+        "ask-question",
+        "btw",
+        "goal",
+        "memory",
+        "plan-mode",
+        "pretty",
+        "subagent",
+        "swarm",
+        "task",
+        "todo",
+        "usage",
+        "workflow",
+        "worktree",
+        "yolo"
+      ]
+    },
+    {
+      "name": "core",
+      "description": "The everyday four: task tracking, planning, memory, and a safety gate",
+      "packages": [
+        "todo",
+        "plan-mode",
+        "memory",
+        "yolo"
+      ]
+    },
+    {
+      "name": "agents",
+      "description": "The agent stack: subagents, parallel fan-out, scripted workflows, worktrees",
+      "packages": [
+        "subagent",
+        "swarm",
+        "workflow",
+        "worktree"
+      ]
+    }
   ]
 }

package/dist/cli.js

@@ -492,8 +492,38 @@ function validateCatalog(data) {
     if (typeof p.npm !== "string" || !p.npm.startsWith("@pify/")) return false;
     if (p.status !== "published" && p.status !== "planned") return false;
   }
+  if (c.bundles !== void 0) {
+    if (!Array.isArray(c.bundles)) return false;
+    const known = new Set(c.packages.map((p) => p.name));
+    for (const entry of c.bundles) {
+      if (typeof entry !== "object" || entry === null) return false;
+      const b = entry;
+      if (typeof b.name !== "string" || !/^[a-z0-9-]+$/.test(b.name)) return false;
+      if (typeof b.description !== "string") return false;
+      if (!Array.isArray(b.packages) || b.packages.length === 0) return false;
+      for (const member of b.packages) {
+        if (typeof member !== "string" || !known.has(member)) return false;
+      }
+    }
+  }
   return true;
 }
+function findBundle(catalog, name) {
+  const wanted = name.trim().toLowerCase();
+  if (catalog.packages.some((p) => p.name === wanted)) return null;
+  return catalog.bundles?.find((b) => b.name === wanted) ?? null;
+}
+function expandBundles(catalog, names) {
+  const expanded = [];
+  for (const name of names) {
+    const bundle = findBundle(catalog, name);
+    const members = bundle ? bundle.packages : [name];
+    for (const member of members) {
+      if (!expanded.includes(member)) expanded.push(member);
+    }
+  }
+  return expanded;
+}
 async function loadCatalog(opts = {}) {
   const bundled = loadBundledCatalog();
   const cached = readCache();
@@ -659,7 +689,12 @@ async function install(names, opts) {
     throw usageError("Missing package name.", "Usage: pify install <name...> [-l] [-a]");
   }
   const catalog = await loadCatalog();
-  const targets = names.map((name) => resolveInstallTarget(catalog, name));
+  for (const name of names) {
+    const bundle = findBundle(catalog, name);
+    if (bundle) step(`${bundle.name}: ${bundle.packages.length} packages \u2014 ${bundle.description}`);
+  }
+  const expanded = expandBundles(catalog, names);
+  const targets = expanded.map((name) => resolveInstallTarget(catalog, name));
   for (const target of targets) {
     if (target.explicit && (!target.inCatalog || target.status !== "published")) {
       warn(`${target.npm} is not in the catalog (or not marked published); installing anyway.`);
@@ -1288,7 +1323,11 @@ function parseArgsOptionsFor(spec) {
 
 // src/completions.ts
 function packageNames() {
-  return loadBundledCatalog().packages.map((p) => p.name);
+  const catalog = loadBundledCatalog();
+  return [
+    ...catalog.packages.map((p) => p.name),
+    ...(catalog.bundles ?? []).map((b) => b.name)
+  ];
 }
 function allNames(spec) {
   return [spec.name, ...spec.aliases];
@@ -1451,7 +1490,7 @@ Usage:
 
 Commands:
   setup                  Install the pi coding agent (safe to re-run)
-  install <name...>      Install @pify packages by short name
+  install <name...>      Install @pify packages, or a bundle (suite|core|agents)
   remove <name...>       Remove installed @pify packages
   update [pi|<name...>]  Update pi and installed @pify packages
   list                   Show the @pify catalog with install state
@@ -1526,6 +1565,11 @@ Install @pify packages by short name. Names resolve against the Pify catalog
 (goal -> npm:@pify/goal); the install itself is delegated to pi install.
 Exact version pins are accepted (goal@0.3.0); range specifiers are refused.
 
+A bundle name installs several at once \u2014 pify install suite (everything),
+core (todo, plan-mode, memory, yolo), or agents (subagent, swarm, workflow,
+worktree). Bundle members are resolved exactly like typed names, and a
+package name always wins over a bundle with the same name.
+
 Options:
   -l, --local            Project scope (.pi/settings.json, .pi/npm)
   -a, --approve          Forward --approve to pi (scripted -l installs)

package/dist/index.d.ts

@@ -11,6 +11,12 @@ interface CatalogPackage {
     /** "published" once it exists on the npm registry; "planned" before that. */
     status: "published" | "planned";
 }
+/** A named set of packages installable in one go, e.g. `pify install suite`. */
+interface CatalogBundle {
+    name: string;
+    description: string;
+    packages: string[];
+}
 interface Catalog {
     version: number;
     org: string;
@@ -18,6 +24,8 @@ interface Catalog {
     /** URL of the always-current catalog on the org's main branch. */
     remote: string;
     packages: CatalogPackage[];
+    /** Optional (v0.3): older CLIs ignore this key and keep working. */
+    bundles?: CatalogBundle[];
 }
 declare function loadBundledCatalog(): Catalog;
 /**
@@ -29,6 +37,13 @@ declare function loadBundledCatalog(): Catalog;
  * radius of a compromised remote to "packages the org itself published".
  */
 declare function validateCatalog(data: unknown): data is Catalog;
+/** The bundle by that name, or null. Package names always win over bundles. */
+declare function findBundle(catalog: Catalog, name: string): CatalogBundle | null;
+/**
+ * Expand bundle names into their members, keeping order and dropping
+ * duplicates — installing `suite goal` must not install goal twice.
+ */
+declare function expandBundles(catalog: Catalog, names: string[]): string[];
 /**
  * Load the catalog. Resolution chain, newest `version` wins:
  * bundled snapshot (offline floor) -> ~/.pify cache -> remote fetch.
@@ -244,4 +259,4 @@ declare class PifyError extends Error {
     constructor(message: string, code?: ExitCodeValue, hint?: string);
 }
 
-export { COMMAND_SPECS, COMPLETION_SHELLS, type Catalog, type CatalogPackage, type CommandSpec, type CompletionShell, ExitCode, type FlagSpec, GLOBAL_FLAGS, INDEX_TS, type InstallSpec, type InstallTarget, type InstalledPifyPackage, NODE_FLOOR, PI_PACKAGE, type PiSettings, type PiStatus, PifyError, README_MD, TESTED_PI_VERSION, type TemplateVars, VERSION, agentDir, assertSafeArg, compareSemver, fetchLatestPiVersion, generateCompletion, installPi, installedPifyPackages, installedVersionOnDisk, interpolate, isOffline, loadBundledCatalog, loadCatalog, npmInstallPiArgs, officialInstallerCommand, packageJsonTemplate, parseArgsOptionsFor, parseInstallSpec, piStatus, readSettings, refreshCatalog, resolveInstallTarget, resolvePifyName, updatePi, validateCatalog, which };
+export { COMMAND_SPECS, COMPLETION_SHELLS, type Catalog, type CatalogBundle, type CatalogPackage, type CommandSpec, type CompletionShell, ExitCode, type FlagSpec, GLOBAL_FLAGS, INDEX_TS, type InstallSpec, type InstallTarget, type InstalledPifyPackage, NODE_FLOOR, PI_PACKAGE, type PiSettings, type PiStatus, PifyError, README_MD, TESTED_PI_VERSION, type TemplateVars, VERSION, agentDir, assertSafeArg, compareSemver, expandBundles, fetchLatestPiVersion, findBundle, generateCompletion, installPi, installedPifyPackages, installedVersionOnDisk, interpolate, isOffline, loadBundledCatalog, loadCatalog, npmInstallPiArgs, officialInstallerCommand, packageJsonTemplate, parseArgsOptionsFor, parseInstallSpec, piStatus, readSettings, refreshCatalog, resolveInstallTarget, resolvePifyName, updatePi, validateCatalog, which };

package/dist/index.js

@@ -150,8 +150,38 @@ function validateCatalog(data) {
     if (typeof p.npm !== "string" || !p.npm.startsWith("@pify/")) return false;
     if (p.status !== "published" && p.status !== "planned") return false;
   }
+  if (c.bundles !== void 0) {
+    if (!Array.isArray(c.bundles)) return false;
+    const known = new Set(c.packages.map((p) => p.name));
+    for (const entry of c.bundles) {
+      if (typeof entry !== "object" || entry === null) return false;
+      const b = entry;
+      if (typeof b.name !== "string" || !/^[a-z0-9-]+$/.test(b.name)) return false;
+      if (typeof b.description !== "string") return false;
+      if (!Array.isArray(b.packages) || b.packages.length === 0) return false;
+      for (const member of b.packages) {
+        if (typeof member !== "string" || !known.has(member)) return false;
+      }
+    }
+  }
   return true;
 }
+function findBundle(catalog, name) {
+  const wanted = name.trim().toLowerCase();
+  if (catalog.packages.some((p) => p.name === wanted)) return null;
+  return catalog.bundles?.find((b) => b.name === wanted) ?? null;
+}
+function expandBundles(catalog, names) {
+  const expanded = [];
+  for (const name of names) {
+    const bundle = findBundle(catalog, name);
+    const members = bundle ? bundle.packages : [name];
+    for (const member of members) {
+      if (!expanded.includes(member)) expanded.push(member);
+    }
+  }
+  return expanded;
+}
 async function loadCatalog(opts = {}) {
   const bundled = loadBundledCatalog();
   const cached = readCache();
@@ -644,7 +674,11 @@ function parseArgsOptionsFor(spec) {
 
 // src/completions.ts
 function packageNames() {
-  return loadBundledCatalog().packages.map((p) => p.name);
+  const catalog = loadBundledCatalog();
+  return [
+    ...catalog.packages.map((p) => p.name),
+    ...(catalog.bundles ?? []).map((b) => b.name)
+  ];
 }
 function allNames(spec) {
   return [spec.name, ...spec.aliases];
@@ -921,7 +955,9 @@ export {
   agentDir,
   assertSafeArg,
   compareSemver,
+  expandBundles,
   fetchLatestPiVersion,
+  findBundle,
   generateCompletion,
   installPi,
   installedPifyPackages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pify/cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Front door for the Pify suite: install and update the pi coding agent, manage @pify packages, and scaffold Pi Packages",
   "keywords": [
     "pify",